home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / nlok224.zip / readme.txt < prev    next >
Text File  |  1999-05-02  |  14KB  |  405 lines
  1. ====================================================================
  2.  NetLookout - Version 2.24
  3. ====================================================================
  4.  
  5.  
  6.  
  7.  
  8. Table of Contents:
  9.  
  10. 1. What is NetLookout?
  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. Version History
  23.  
  24. 8. How do I register?
  25.  
  26.  
  27. ====================================================================
  28.  
  29.  
  30.  
  31. 1. What is NetLookout?
  32.  
  33. NetLookout is an internet notifier.  It will watch Web, FTP and
  34. Gopher sites, and tell you if they have changed.  A "Lookout" is
  35. also known as a "bot", an "agent" or an "informant".  In this
  36. document, we refer to them as "Lookout"s.
  37.  
  38. ====================================================================
  39.  
  40.  
  41. 2. How do I install it?
  42.  
  43.  
  44. Please note:  The OS/2 and Windows versions of NetLookout can
  45. peacefully co-exist in the same directory.  They will share data
  46. and cache files.  Just specify the same installation directory
  47. for both platforms.
  48.  
  49.  
  50. For OS/2:
  51.  
  52. The file nlookxxx.zip should unzip into several files.
  53.  
  54. Just unzip nlookxxx.zip into a directory, then type "install".
  55.  
  56.  
  57. For Windows:
  58.  
  59. If the distribution is in a .zip file, unzip that file into
  60. a temporary directory.  If it came in an .exe file, move that
  61. file to a temporary directory and run it.
  62. After that, change to the temporary directory and type "setup".
  63.  
  64.  
  65. ====================================================================
  66.  
  67.  
  68. 3. How do I use it?
  69.  
  70.  
  71. Start by running netlook.exe.  Program settings are saved in lk.ini,
  72. and information about the various sites is stored in lookout.dat.
  73.  
  74. To run NetLookout in "batch" or "unattended" mode, add the "/batch"
  75. parameter after "netlook".  This causes NetLookout to run minimized,
  76. check all of the sites in it's list, then exit.  To have NetLookout
  77. write the results to a text file, add the "/text <text file name>"
  78. parameter to the command line, and replace "<text file name>" with the
  79. full path to the text file you want created.  To have NetLookout write
  80. the results to an HTML file, add the "/html <html file name>" parameter
  81. to the command line, and replace "<html file name>" with the full path
  82. to the HTML file you want created.  To have NetLookout notify you that
  83. it's finished by playing a WAV file, instead of displaying a message box,
  84. add the "/wav <wav file name>" parameter to the command line, and replace
  85. "<wav file name>" with the full path of the WAV file you want played.
  86.  
  87. Here is a sample command line using all of the above switches:
  88.  
  89. netlook.exe /batch /text c:\output.txt /html d:\netscape\home.htm /wav i:\sounds\groovy.wav
  90.  
  91.  
  92. The main window of NetLookout contains a "details" view, where information
  93. about each Lookout is displayed and updated.  You can right-click
  94. on a Lookout's line to display a popup menu, with choices of actions
  95. to perform on that Lookout.  Here's a list of what you can do:
  96.  
  97.     Create - create a new Web, FTP or Gopher Lookout
  98.     Edit - change the settings and parameters for a Lookout
  99.     Delete - self-explanatory
  100.     Check - have the Lookout check right now if the site has been changed
  101.     Reset - change the Lookout's status to "Idle"
  102.     Start watching - if the selected Lookout is suspended, start watching it
  103.     Stop watching - stop checking the selected Lookout
  104.  
  105. If the selected Lookout watches an FTP site, you also get the choice:
  106.  
  107.     Details - if an FTP site has changed, this will display a
  108.     dialog that lists what files have been added, removed or changed.
  109.  
  110. To create a new Lookout, select "Lookout|New|Web", or "FTP" or "Gopher".
  111. Most of the fields on the Create & Edit dialogs are obvious.  Here are
  112. the not-so-obvious ones:
  113.  
  114.     Gopher:
  115.         Selection string - the selection string of the Gopher item
  116.         you want to watch.  If left blank, will default to a new-line,
  117.         which is the Gopher default.
  118.  
  119.     Web:
  120.         URL - the "Universal Resource Locator(?)".  Basically,
  121.         this is what you see in the URL field on a browser.
  122.         More... - displays another dialog, where you can enter words
  123.         and strings that the program will ignore when comparing two HTML
  124.         files to see if a site has changed.
  125.  
  126.     FTP:
  127.         Directory - defaults to "/".
  128.         More... - displays another dialog, where you can enter file names
  129.         and parts of file names that the program will ignore when checking
  130.         if an FTP site has changed.  "index" is a good one to add here.
  131.  
  132.  
  133. Select "Settings|Program settings..." to bring up the settings notebook.  Web, FTP
  134. and Gopher each have a notebook page where you can select and enter the client program
  135. used to "view" a Lookout.  Also, there is a field to format the command line of the
  136. client program.
  137.  
  138. For FTP Lookouts, place the following in the "FTP Client Parameters"
  139. field in the order your FTP client needs them:  %host %user %password %port %dir %desc
  140.  
  141. Web Lookouts only recognize two parameters:  %URL %desc
  142.  
  143. Gopher Lookouts recognize %host, %port, %selector and %desc
  144.  
  145. For example, if you want to use the IBM WebExplorer as your Web client, and you normally
  146. start it from the command line with the "-q -t 6" options, in the "Web Client Parameters"
  147. field, you would enter "%URI -q -t 6".
  148.  
  149. For another example, if you use VXFTP for your FTP client, you could enter the following
  150. command line in "FTP Client Parameters":  "%host %user %password %dir".
  151.  
  152. If a client program that you select is not in your PATH, you must enter the full path to
  153. the program in the "Client" entry field.
  154.  
  155. The %desc parameter outputs the description of this Lookout to the specified program.
  156.  
  157. ====================================================================
  158.  
  159.  
  160. 4.  How does it work?
  161.  
  162.  
  163. Each Lookout has a thread that does the checking.  Every 60 seconds, the main thread goes
  164. through the list of Lookouts, and sees if it's time for any of them to be checked.  If it
  165. is, that Lookout's thread is signalled, and it does the checking.
  166.  
  167. ====================================================================
  168.  
  169.  
  170. 5.  Where do I send bug reports & suggestions?
  171.  
  172.  
  173. Obviously, I need bug reports.  But, I am very interested in any ideas you have for improving
  174. the performance and usability of this program.  If you have any problems, suggestions or
  175. enhancements, please send them to:
  176.  
  177.     ckennedy@frugalsoft.com
  178.  
  179. Also, use NetLookout to watch the NetLookout for OS/2 home page, at
  180.  
  181.     http://www.frugalsoft.com/lookout
  182.  
  183.  
  184. ***NOTE***
  185. This distribution DOES NOT contain a lookout.dat file with the information for this site.
  186. Users didn't like the fact that their previous lookout.dat file was getting overwritten.
  187.  
  188.  
  189.  
  190. ====================================================================
  191.  
  192.  
  193. 6.  Known bugs & what's planned?
  194.  
  195.  
  196. Known bugs?
  197. - Occasionally, an FTP Lookout will get stuck waiting on a directory listing.  The site will say "Checking...",
  198. and the program will become sluggish.  Close the program and restart.  I'm working on this one very hard!
  199. *** This should be fixed.  If you see this, please let me know. ***
  200.  
  201. What's not implemented yet?
  202.  
  203. *POSTPONED - Applying temporary overrides permanently, on the "Global Overrides" page of the settings notebook.
  204.  
  205.  
  206. What's planned?
  207.  
  208. - Folders, folders, folders!  I plan to implement an "Explorer" style main window, with
  209.   folders on the left side, and groups of Lookouts on the right.
  210. - Interface to BackTalk speech synthesizer *POSTPONED - can now launch ".cmd" files, like "spchstr.cmd"
  211. - Import from Internet Adventurer and NetExtra
  212. - Support dragging from the main window
  213.  
  214.  
  215. ====================================================================
  216.  
  217.  
  218. 7. Version History
  219.  
  220.  
  221. Version 2.24 - May 2, 1999
  222.  
  223. - All - fixed bug in importing from Netscape
  224. - All - made settings dialog more pretty
  225. - All - fixed problems with determining if a connection timed out
  226.  
  227.  
  228. Version 2.23d - April 17, 1999
  229.  
  230. - All - fixed problems with watching Wit Capital's IPO page
  231. - All - fixed some programming errors that may or may not have shown up as program crashes & lock-ups
  232. - All - if an FTP site has an "Unknown error", it's status is now set to "Error"
  233. - All - better detection when a connection times out & NetLookout doesn't get all of the page
  234. - All - fixed problem with checking certain sites through a proxy, they would return "Doc not found"
  235. - All - registration info is now saved when the OK button on the registration dialog is pressed
  236.  
  237.  
  238. Version 2.23b - March 24, 1999
  239.  
  240. - All - fixed bug that caused false notifications for ETrade IPOCenter
  241. - All - increased maximum length of text entry fields to 2048 characters
  242. - All - allow monitoring of sites that have "|" in the URL
  243. - All - decreased timer interval to 1 minute
  244.  
  245.  
  246. Version 2.23 - March 4, 1999
  247.  
  248. - All - fixed a bug in the email notification.  Mail was not being sent to certain mail hosts.
  249.  
  250.  
  251. Version 2.22 - March 3, 1999
  252.  
  253. - This is a full release that includes both 2.21a patches.
  254.  
  255.  
  256. Version 2.21a - February 28, 1999
  257.  
  258. - All - remember email address when new site created
  259. - All - default new Web sites to "Ignore all tags"
  260. - All - add "quiet" mode to batch: /quiet
  261.  
  262.  
  263. Version 2.21 - February 20, 1999
  264.  
  265. - All - added notification by email.
  266. - All - added option to automatically check sites even when they changed the last time
  267. - All - added option to save contents of the FTP Details window.
  268.  
  269.  
  270. Version 2.20 - Februrary 15, 1999
  271.  
  272. - All - fixed some bugs with importing from Netscape
  273. - All - added batch mode execution.  In batch or unattended mode,
  274.         NetLookout will check all sites, then produce a text file
  275.         or an HTML file listing what changed, what didn't, and which
  276.         sites had problems.
  277.         
  278.  
  279. Version 2.10 - December 14, 1998
  280.  
  281. - All - now supports password-protected URL's.  The browser will still
  282.         ask you for user name and password if you double-click or "launch"
  283.         the URL from NetLookout.  This is because not all browsers handle
  284.         getting the user name and password passed to them.
  285. - All - now handles '#' in a URL.  Will send browser to that anchor.
  286.  
  287.  
  288. Version 2.09b - November 10, 1998
  289.  
  290. - All - fixed bug that would cause NetLookout to hang while checking
  291. - All - fixed bug where setting a site to "Stop Watching", or "Inactive",
  292.         would reduce the number of simultaneous connections each time that
  293.         site was checked ( or attempted, anyhow ).
  294.  
  295.  
  296. Version 2.09 - October 1, 1998
  297.  
  298. - All - fixed a huge bug.  If the settings allowed more than one
  299.         connection, and connections started timing out, the program
  300.         would crash.  This bug would show up if you had a less than
  301.         fast connection to the internet.
  302. - All - moved more processing off into separate threads.  This bug
  303.         showed up as the main window "freezing" while checking sites.
  304. - All - fixed a couple of bugs that occurred at startup.
  305. - All - fixed importing from Opera 3.x
  306. - All - added "View in new window" option to popup list, so you can
  307.         open a new browser window if you want to.
  308.  
  309.  
  310. Version 2.08 - July 28, 1998
  311.  
  312. - All - force browser to reload page from internet
  313. - OS/2 - fixed problem with remembering fonts
  314. - All - added multiple selection to main list
  315. - All - removed 256 char restriction on URL's
  316. - All - cleaned up pull-down menus and help file
  317. - Win32 - fixed problem with upper/lower case in viewer command line
  318.  
  319.  
  320. Version 2.06 - July 7, 1998
  321.  
  322. - Win32 version now gets default Web, FTP and Gopher viewers
  323.   from the registry ( uses the default HTTP shell open command )
  324. - fix problem with cache file names
  325.  
  326.  
  327. Version 2.05 - July 6, 1998
  328.  
  329. - Welcome, Windows!  The Win32 version of NetLookout is now available.
  330. - fixed some problems with the FTP code
  331. - added jump to NetLookout home page from the help menu
  332. - added help descriptions of status icons
  333. - OS/2 - make it compatible with the Windows version
  334.   ( values in the lookout.dat file )
  335. - Windows - get IE bookmark location from registry
  336.  
  337.  
  338. Version 2.04 - May 6, 1998
  339.  
  340. - changed distribution to be a small .exe and several .dll files
  341. - fixed problems with importing from FTP Browser
  342. - import from Microsoft Internet Explorer
  343. - improved code for launching other programs, now VIO programs work.
  344.   Also, if you run NetLookout from a command window, then launch
  345.   a viewer program, then close NetLookout, the command window will
  346.   come back, without having to close the viewer program.
  347. - updated help file to describe how to launch ".cmd" files
  348. - fixed problems with "Look for file" feature on FTP Lookouts
  349. - improved memory management
  350. - on changes, message boxes now display after beeps and .wav files
  351. - reworked the threading model, so threads are only created when
  352.   needed.  Should cut down on NetLookout's use of system resources.
  353.  
  354.  
  355. Version 2.03
  356.  
  357. - user can now select max number of connections
  358. - intro dialog displayed when data file is empty
  359. - fixed problem with "Ignore all tags" selection
  360. - fixed problem with saving timeout value
  361.  
  362.  
  363. Version 2.02
  364.  
  365. - proxy support fixed
  366. - pull-down menus & hot keys to copy/paste URLs to/from clipboard
  367. - install script ( thanks Don Hawkinson - DH-Grep-PM )
  368.  
  369.  
  370. Version 2.01
  371.  
  372. - change to .zip file - now only one .zip file, not two
  373. - More improvements to the FTP code
  374. - Option to ignore all HTML tags for Web Lookouts
  375. - Option to not display the Settings dialog when creating a site
  376.   by dropping a URL on the main window.
  377.  
  378.  
  379. Version 2.00
  380.  
  381. - much improved user interface
  382. - HTTP proxy support
  383. - drag'n'drop support for creating Lookouts
  384. - importing Lookouts from other OS/2 and Windows internet apps
  385. - improved communication code
  386.  
  387. ====================================================================
  388.  
  389.  
  390. 8.  How do I register?
  391.  
  392.  
  393. Please see the file "register.txt" included with this distribution.
  394.  
  395.  
  396. ====================================================================
  397.  
  398.  
  399. Chris Kennedy
  400. May 2, 1999
  401.  
  402. Frugal Software
  403. ckennedy@frugalsoft.com
  404. http://www.frugalsoft.com/lookout
  405.