home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / LOOK100 / README.TXT < prev   
Text File  |  1997-07-31  |  7KB  |  218 lines
  1. ====================================================================
  2.  Lookout for OS/2 - Version 1.00
  3. ====================================================================
  4.  
  5.  
  6. Table of Contents:
  7.  
  8. 0. What's new in this version?
  9.  
  10. 1. What is Lookout for OS/2?
  11.  
  12. 2. How do I install it?
  13.  
  14. 3. How do I use it?
  15.  
  16. 4. How does it work?
  17.  
  18. 5. Where do I send bug reports & suggestions?
  19.  
  20. 6. Known bugs & what's planned?
  21.  
  22. 7. How do I register?
  23.  
  24. ====================================================================
  25.  
  26.  
  27. 0. What's new in this version?
  28.  
  29.  
  30. Version 1.00 - First GA release.  Everything's new!
  31.  
  32.  
  33. ====================================================================
  34.  
  35.  
  36. 1. What is Lookout for OS/2?
  37.  
  38. Lookout for OS/2 is a internet notifier.  It will watch Web, FTP and
  39. Gopher sites, and tell you if they have changed.  A "Lookout" is
  40. also known as a "bot", an "agent" or an "informant".  In this
  41. document, we refer to them as "Lookout"s.
  42.  
  43. ====================================================================
  44.  
  45.  
  46. 2. How do I install it?
  47.  
  48.  
  49. The file lko*.zip should unzip into 2 files, this read.me, and
  50. lookout.zip.  Unzip lookout.zip with the -d option into the
  51. directory where you want it to stay.  The -d option is needed to
  52. create the "cache" directory.
  53.  
  54. ====================================================================
  55.  
  56.  
  57. 3. How do I use it?
  58.  
  59.  
  60. Start by running lookout.exe.  Program settings are saved in lookout.ini,
  61. and information about the various sites is stored in lookout.dat.  There
  62. should be a lookout.dat included with this distribution.  It will start
  63. you off watching one site, the "Lookout for OS/2 Home Page".
  64.  
  65. The main window of Lookout contains a list box, where information
  66. about each Lookout is displayed and updated.  You can right-click
  67. on a Lookout's line to display a popup menu, with choices of actions
  68. to perform on that Lookout.  Here's a list of what you can do:
  69.  
  70.     Create - create a new Web, FTP or Gopher Lookout
  71.     Edit - change the settings and parameters for a Lookout
  72.     Delete - self-explanatory
  73.     Check - have the Lookout check right now if the site has been changed
  74.     Reset - change the Lookout's status to "Idle"
  75.     Start watching - if the selected Lookout is suspended, start watching it
  76.     Stop watching - stop checking the selected Lookout
  77.  
  78. If the selected Lookout watches an FTP site, you also get the choice:
  79.  
  80.     Details - if an FTP site has changed, this will display a
  81.     dialog that lists what files have been added, removed or changed.
  82.  
  83. To create a new Lookout, select "Lookout|New|Web", or "FTP" or "Gopher".
  84. Most of the fields on the Create & Edit dialogs are obvious.  Here are
  85. the not-so-obvious ones:
  86.  
  87.     Gopher:
  88.         Selection string - the selection string of the Gopher item
  89.         you want to watch.  If left blank, will default to a new-line,
  90.         which is the Gopher default.
  91.  
  92.     Web:
  93.         URL - the "Universal Resource Locator(?)".  Basically,
  94.         this is what you see in the URL field on a browser.
  95.         More... - displays another dialog, where you can enter words
  96.         and strings that the program will ignore when comparing two HTML
  97.         files to see if a site has changed.
  98.  
  99.     FTP:
  100.         Directory - defaults to "/".
  101.         More... - displays another dialog, where you can enter file names
  102.         and parts of file names that the program will ignore when checking
  103.         if an FTP site has changed.  "index" is a good one to add here.
  104.  
  105.  
  106. Select "Settings|Program settings..." to bring up the settings notebook.  Web, FTP
  107. and Gopher each have a notebook page where you can select and enter the client program
  108. used to "view" a Lookout.  Also, there is a field to format the command line of the
  109. client program.
  110.  
  111. For FTP Lookouts, place the following in the "FTP Client Parameters"
  112. field in the order your FTP client needs them:  %host %user %password %port %dir
  113.  
  114. Web Lookouts only recognize one parameter:  %URL
  115.  
  116. Gopher Lookouts recognize %host, %port and %selector
  117.  
  118. For example, if you want to use the IBM WebExplorer as your Web client, and you normally
  119. start it from the command line with the "-q -t 6" options, in the "Web Client Parameters"
  120. field, you would enter "%URI -q -t 6".
  121.  
  122. For another example, if you use VXFTP for your FTP client, you could enter the following
  123. command line in "FTP Client Parameters":  "%host %user %password %dir".
  124.  
  125. If a client program that you select is not in your PATH, you must enter the full path to
  126. the program in the "Client" entry field.
  127.  
  128.  
  129. ====================================================================
  130.  
  131.  
  132. 4.  How does it work?
  133.  
  134.  
  135. Each Lookout has a thread that does the checking.  Every 30 seconds, the main thread goes
  136. through the list of Lookouts, and sees if it's time for any of them to be checked.  If it
  137. is, that Lookout's thread is started, and it does the checking.
  138.  
  139. ====================================================================
  140.  
  141.  
  142. 5.  Where do I send bug reports & suggestions?
  143.  
  144.  
  145. Obviously, I need bug reports.  But, I am very interested in any ideas you have for improving
  146. the performance and usability of this program.  If you have any problems, suggestions or
  147. enhancements, please send them to:
  148.  
  149.     ckennedy@primenet.com
  150.  
  151. Also, use Lookout to watch the Lookout for OS/2 home page, at
  152.  
  153.     http://www.primenet.com/~ckennedy/software/lookout
  154.  
  155. This distribution contains a lookout.dat file with the information for this site.
  156.  
  157.  
  158. ====================================================================
  159.  
  160.  
  161. 6.  Known bugs & what's planned?
  162.  
  163.  
  164. If the program is interrupted/exitted while one of the Lookouts is in the "Checking"
  165. state, the next time you run the program, it may crash.  If you suffer a crash,
  166. delete the contents of the "cache" directory, then start the program again.
  167.  
  168.  
  169. What's not implemented yet?
  170.  
  171. *POSTPONED - Applying temporary overrides permanently, on the "Global Overrides" page of the settings notebook.
  172.  
  173.  
  174. What's planned?
  175.  
  176. Near-term ( before general availability )
  177. *SORTA DONE - fix the interrupt/cache bug
  178. *UNDOCUMENTED FEATURE! - add intelligence about the command line formats of different clients
  179.  
  180. *OOPS, PROBLEM, POSTPONED NOT DONE - add a toolbar
  181.  
  182. *POSTPONED - applying the overrides
  183. *POSTPONED - Re-package Visual Age C++ dll's to reduce size.
  184.  
  185.  
  186. Mid-term ( version 1.1? )
  187. - ability to kill off a "hung" socket
  188. - modularize the code
  189. - allow adding files to ignore list from the "Details" dialog
  190. - allow FTP'ing of files from the "Details" dialog
  191. - applying temporary overrides.
  192.  
  193. Long-term ( version 2.0 )
  194. - bring down entire web pages, for offline browsing
  195. - ability to watch more than one page/directory/selection at a site
  196. - use notebook as main user interface, with Lookout as one page
  197. - add pages for mail checker, ping, finger, webster
  198.  
  199.  
  200. ====================================================================
  201.  
  202.  
  203. 7.  How do I register?
  204.  
  205.  
  206. Please see the file "register.txt" included with this distribution.
  207.  
  208.  
  209. ====================================================================
  210.  
  211.  
  212. Chris Kennedy
  213. July 31, 1997
  214.  
  215. Frugal Software
  216. ckennedy@primenet.com
  217. http://www.primenet.com/~ckennedy/software/lookout
  218.