home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Java / Java.zip / wjcp010.zip / readme.txt
Text File  |  1998-02-18  |  4KB  |  96 lines
  1.                            WebJavaCopy 0.10
  2.                            ================
  3.  
  4. Description:
  5. ------------
  6.  
  7. WebJavaCopy is a Java application designed to copy files from the
  8. internet to your hard drive.  You are in complete control of which
  9. web pages are scanned and which pages (and other files) are simply
  10. downloaded.
  11.  
  12. Requirements:
  13. -------------
  14.  
  15. Java 1.1 runtime environment
  16.  
  17. This is NOT an applet - your web browser cannot run this Java
  18. application.
  19.  
  20. Installation:
  21. -------------
  22.  
  23. If you've unzipped this (keeping the directory structure), it's
  24. installed.  Just run "java wjcp.App" from this directory.  If you add
  25. this directory to your CLASSPATH, you can run it from any directory. 
  26. There are currently no parameters.
  27.  
  28. Note: To keep the directory structure, be sure to use infozip's unzip,
  29. or pkunzip with the -d parameter.  Other unzips (i.e., WinZip) have
  30. similar options, be sure to use them.
  31.  
  32. Usage:
  33. ------
  34.  
  35. Type in the URL you wish to scan into the URL entry field.  Currently
  36. this has to be a web page address.  In the future, this should be
  37. permitted to go straight to a download.  To complete this, press enter
  38. in this field.
  39.  
  40. Immediately, the HTML Engine will start downloading the page.  As it
  41. finds files to download, it will start putting them in the "Links
  42. Found" list.  This happens in the background so you can type in another
  43. URL - if you type in a new URL before the previous one is finished, it
  44. will merely be queued up in the HTML Queue.
  45.  
  46. * Feature: If a link is found more than once, it will not be put in the
  47. Links Found list a second time.  In fact, this feature works whether
  48. the original link is still in the list - if you have removed, saved, or
  49. loaded that link already, it will not reappear!  This is saved in the
  50. configuration file.  Currently, the only way to allow a link to
  51. reappear is to shut down WebJavaCopy, delete the configuration file,
  52. and restart.
  53.  
  54. When you select one or more links, you may choose to load, save, or
  55. remove them.
  56.  
  57. - Load will only highlight if all selected links are themselves HTML,
  58. HTM, or TXT files.  This will remove each link from the found-links
  59. list and place them, in the same order, in the HTML queue.  If the
  60. engine is not active, this will activate it.
  61.  
  62. - Save will allow you to save each selected link.  For each link being
  63. saved, a dialog will pop up asking where to save the link as, and what
  64. filename to save as.  This will default to the last used directory and
  65. the filename in the URL.
  66.  
  67. - Remove will simply remove the URL.  As above, the URL will not
  68. reappear should it be found again later.  (Can be useful to get rid of
  69. banner advertisments and the such.)
  70.  
  71. * Feature: If there are any links showing in the "Links Found" list
  72. when you shut down WebJavaCopy, they will be restored when starting up.
  73. The HTML and File Save queues are saved/restored as well.
  74.  
  75. NOTES (read: known BUGS):
  76. -------------------------
  77.  
  78. - Settings menu doesn't do anything yet.  You can trigger this setting
  79. all you want - won't make any difference.  On the other hand, the
  80. "Crawl Other Sites" setting IS saved between runs.
  81.  
  82. - The configuration file will most likely NOT be upgradable to newer
  83. versions.
  84.  
  85. Future:
  86. -------
  87.  
  88. - URL field should allow Files as well as HTML.
  89. - Settings menu will do something useful
  90. - # of engines will be configurable (minimum of 1 each)
  91. - Let the user bring up a dialog box with the seen list to scan them,
  92. save them, or merely remove them from the seen list.
  93. - command-line parameter to start downloading/scanning.
  94. - command-line parameter to shut down when done
  95. - automatically determining a description for each link
  96.