  _________________________________________________________________

                        (c) by Davor Zorc, Zagreb, Croatia, 1996.
      
            
              
              PROGRAM : WebCache
           
                  DOCUMENT: USER'S GUIDE

       OttoSoft         VERSION : 2.20           DATE: 17.10.1996.
  _________________________________________________________________


1.     INTRODUCTION
-------------------

       1.1     Description & Purpose
       -----------------------------
       The Internet provides a huge selection of web sites for "surfers".
       These sites  contain pages brimming with rich graphical content
       and informative text. Netscape's File|Save provides a way to save
       a page in the computer for later viewing - unfortunately it doesn't
       save the graphics that would add much more enjoyment to our off-line
       browsing.

       WebCache to the rescue!... Making use of a little known or understood
       Navigator resource called the cache, WebCache recaptures both the text
       and graphics and saves it in a way that permits Netscape to revisit
       the web site off-line and at your convenience. Click a link and then
       navigate the web site reliving the excitement, saving pages or making
       bookmarks.

       WebCache can be used with Netscape Navigator ver. 2.0x and 3.0 as a
       utility for off-line browsing. When activated it will make CACHE.HTM
       Web page. This page lists all http, gopher and ftp addresses of files
       which exist in local cache.

       While Navigator also saves and displays only the last 10 addresses,
       the number of addresses WebCache displays is unlimited. The CACHE.HTM
       list may also be used while surfing on-line (when connected to Internet).
       Pages displayed from the cache may be named and saved using Navigator.

       Other uses of WebCache include filtering of BOOKMARK.HTM and make it
       printable with visible addresses.

       1.2     Hardware & other requirements
       -------------------------------------
       IBM-PC 386 or better running Windows 3.10, 3.11 or Windows 95
       and Netscape Navigator ver. 2.0x or 3.0.


       1.3     Installation Guide
       ---------------------------

       Win 3.1x Installation
       ---------------------
       First unzip distribution file webcaXXX.zip to any directory. Then
       copy WEBCACHE.EXE and WEBCACHE.HLP to Navigator main directory
       (this is directory which contains CACHE subdirectory, usually
       named NETSCAPE). Do this using File manager.

       In Windows 3.1x program manager click on Netscape group to open it.
       Make File manager window small to be able to see Netscape group.
       Then Drag and Drop WEBCACHE.EXE from File manager file list to
       Netscape group.

       Alternatively, you may use Program manager File|New|Program_Item to
       add this program to Netscape group. In Command_line type WEBCACHE.EXE
       for example:
                "c:\netscape\webcache.exe".
       As working directory type-in Navigator main directory name, for example:
                "c:\netscape".

       Win 95 Installation
       -------------------
       First unzip distribution file webcaXXX.zip to any directory. Then
       copy WEBCACHE.EXE and WEBCACHE.HLP to Navigator main directory
       (this is directory which contains CACHE subdirectory, usually
       named NETSCAPE\NAVIGATOR). Do this using Explorer.
       Then Drag and Drop WEBCACHE.EXE from Explorer file list to Desktop
       main screen to create shortcut, or add this file to Navigator group.


2.     USING THE PROGRAM TO SCAN CACHE
--------------------------------------
       1. Run WebCache before you want to browse pages off-line. Click on
       'Go' then 'Scan Cache' and wait for message. Click on 'Ok'.

       2. Run Netscape Navigator. In Navigator use File|Open file to view
       CACHE.HTM file. Then click on desired address, then you may click
       further on colored (visited) addresses. Return to CACHE.HTM file
       using menu: Go|* Local cache *. You may wish to add CACHE file to
       bookmarks to access it later as any other location.

       To avoid messages saying that connection is not
       established, change Navigator NETWORK PREFERENCES. Option should be:

       - CACHE | Verify documents: NEVER

       When you want to use Navigator on-line again, restore this option
       to what it was before.


       Tips
       ----
       A good on-line browsing technique would be to quickly visit all pages
       at a web site. Navigator will place a copy of each page in the cache
       where it will be readily available for later cache browsing.

       Set a large Cache size (5 or 10 MBytes), in Netscape's Network Options.

       If you "forgot" to make a bookmark while on-line make one while cache
       surfing. (Bookmarks | Add a Bookmark)


       2.1     Limitations
       -------------------
       If there are more than 500 addresses extracted, or if length of an
       address is longer than 120 characters then address checking for
       duplicates and address sorting is skipped (for those addresses).
       Those addresses appear on top of the listing.

       2.2   Troubleshooting
       ---------------------
       a) What if it does not work?
       - maybe you used WebCache while Navigator was active. You should
         quit Navigator first, wait 15 seconds for Navigator to update
         cache in background and then start Webcache. If Navigator was
         active, at best you get incomplete CACHE.HTM or Webcache report
         unaccessible input file. Do not turn-off computer while Navigator
         is running.
       - maybe the cache is empty or size is set to zero.
       - make sure WEBCACHE.EXE is in Navigator main directory.
       - make sure Navigator main directory has subdirectory named CACHE,
         in Navigator check this in: Network preferences | Cache menu.
       - new Navigator version should be installed over old one in same
         directory. Same goes for WebCache updates.
       - Working directory for Webcache should be correctly declared in
         Program manager.

       b) It works but there are addresses in CACHE.HTM which seem not to
         be in local cache ?
       - CACHE.HTM may be old. On each run of Navigator some pages are
         added and many may be deleted. Rerun WebCache!
       - Pages were partially loaded. Even if page was complete and then
         it is reloaded partially, it seems that some contents is lost.
       - Try "Clear disk cache" button in Network preferences| Cache menu
         to start new cache.

3.     OPTIONS
--------------
       Check option 'Filter| http' or 'ftp' or 'gopher' before
       'Go | Scan Cache' or 'Scan Bookmarks' if you wish to include
       only checked type of service. You may check more than one.

       Check option 'Filter| Add Pictures' before 'Go | Scan Cache' or
       'Scan Bookmarks' if you wish to have .gif and .jpg pictures listed
       in CACHE.HTM or BOOKLIST.HTM. In case of Cache scanning, those
       pictures are already specified in html pages but here you may view
       them separately.

       Check option 'Show| titles' if you want page titles listed.

       Check option 'Show| addresses' if you want addresses visible
       in output list.

       Check option 'Show| server separation' if you wish that CACHE.HTM
       list have addresses separated for each server.

       Click option 'Echo address' if you wish to see URL addresses
       while scanning.


4.     USING THE PROGRAM TO SCAN BOOKMARKS
------------------------------------------
       Navigator keep bookmarks in the file BOOKMARK.HTM.
       Menu Go | Scan Bookmark enables filtering of BOOKMARK.HTM and also
       it can make make bookmarks printable with visible addresses. It
       produces BOOKLIST.HTM file,  which you may view by Navigator menu
       File | Open file or print by File | Print.
       All other options also apply to Scan Bookmark.


5.     LEGAL
------------
       This program is tested and believed to be free of bugs. There is
       however no guarantee that this program will perform expected duty,
       and that will not harm your machine, data or user in any way.

       Mentioned hardware and software products are (C) of their producers.


6.     ORDER FORM - REGISTRATION
--------------------------------
       This program is SHAREWARE and requires payment to the author.
       It is the full feature version and free to test for 1 month.
       After 1 month you will have to register to have full version.

       Feel free to write me comments using e-mail or picture-card.
       You may re-distribute unmodified package to BBS, Internet,
       CD-ROM. Commercial use requires license by the author.

       PRICE PER USER:  10 US$ or equivalent in convertible currency.

       Add 5 US$ if you want to get new/ registered version on diskette.

       If you find this program useful please send cash in opaque letter
       or check payable to:
       Davor Zorc
       Istarska 51
       10 000 Zagreb
       Croatia

       e-mail: davor.zorc@fsb.hr

       According to your satisfaction with program, state of your finances
       or state of your country, do modify above sum. Money you send will
       be used for future program improvements.

       Registered version and also new versions will be sent to registered
       users as encoded e-mail or to ftp address you supply or on diskette.

       New version may be found on SimTel repository:
       ftp://oak.oakland.edu/pub/simtelnet/win3/inet/webcaXXX.zip

       When you send Registration form by mail or e-mail and the money,
       you will receive Registration Name and Registration Code which you
       may enter in menu Go | Register to make unlimited registered copy.
       Once registered, the same menu item will show your name.

       If you are now in Windows Help program you may click on
       Edit menu, use mouse to highlight order form, then click
       Copy. Open Notepad and click Edit | Paste. Fill in form
       and print it.

<-------------------------- cut here order form -------------------------->
___________________________________________________________________

Registration form for : WebCache
___________________________________________________________________

Name:____________________________ Address: ________________________


City, State: ____________________________ Country: ________________

Zip:__________________  E-mail/ftp: _______________________________


Windows version:_____   Navigator ver.:______   WebCache ver.:_____

Delivery:  3 1/2" diskette [ ]    e-mail [ ]

Included US$:_____________          cash [ ]     check [ ]


Comments, suggestions for future updates, bugs, complaints:

___________________________________________________________________

___________________________________________________________________

___________________________________________________________________

Where did you get this file:

___________________________________________________________________

<-------------------------- cut here order form -------------------------->


7.      ACKNOWLEDGEMENTS
------------------------
        Many thanks to Peter Rader for his suggestions and help on making
        help file.
        I also want to thank many users from USA, Germany, Pakistan,
        Britain, Brasil, Spain and other countries for their comments and
        support.

8.     MESSAGE DIALOGUES
----------------------
Here is the list of all message dialogues:
1  XXX Addresses found                     (happy you!)
2  Input file not accessible!              (Navigator is running-quit first)
3  Input file not found!                   (wrong installation)
4  Cache is empty!                         (cache cleared or no
                                            addresses for given
                                            filtering options)
5  Unable to write output file!            (no space on hard disk or
                                            run on CD-ROM)
6  Error during processing                 (Not Enough memory)!
7  This program is UNREGISTERED shareware  (1 month expired-Register now!)
8  List without Titles and Addresses       (check Titles, Addresses or both)
   would be empty. Addresses will be shown!



8.     REVISIONS HISTORY
-------------------------
       0.96     initial release
       0.99     larger sorting array, /n option (registered version)
       1.00     update for win95/ navigator 3.0
       1.01     registered version 1.00
       2.00     windows menu and windows help
       2.10     show titles option, user registration, filtering options

