  _________________________________________________________________

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

       OttoSoft         VERSION : 3.10           DATE: 01/11/1997
  _________________________________________________________________

SUMMARY:
1.     INTRODUCTION
       1.1   Description & Purpose
       1.2   Hardware & other requirements
       1.3   Installation Guide
2.     USING THE PROGRAM TO SCAN CACHE
       2.1   Limitations
       2.2   Troubleshooting
3.     OPTIONS
4.     USING THE PROGRAM TO SCAN BOOKMARKS
5.     USING THE PROGRAM TO SAVE PAGES
6.     LEGAL
7.     ORDER FORM - REGISTRATION
8.     ACKNOWLEDGEMENTS
9.     MESSAGE DIALOGUES
10.    REVISIONS HISTORY
  _________________________________________________________________

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 is the sorted list of all http, gopher and ftp
       addresses of files which exist in local cache.

       While Navigator 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.

       While CACHE.HTM is just an index of what is currently there in cache,
       complete pages (with pictures) may be saved permanently on local disk.
       Once saved, pages may be copied to other disk/ diskette/ computer.
       This is done with WebCache Go | Save option.

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

       WebCache has 3 menus: Go, Options and Help. Functions Scan Cache,
       Scan Bookmarks and Save pages may be accessed through Go menu or
       using buttons on main screen. Only difference is that when using
       buttons WebCache will close itself after performing function.
       Options apply to all 3 functions. Functions are independent and
       there is no particular order in which they are used.

       1.2     Hardware & other requirements
       -------------------------------------
       IBM-PC 386 or better running Windows 3.10, 3.11 or Windows 95,
       VGA card with 256 or more colors, 250 kByte hard disk space
       and Netscape Navigator ver. 2.0x or 3.0x (regular or Gold).


       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.
       CACHE.HTM list is sorted alphabetically by page addresses.

       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 2000 addresses extracted, or if length of
       an address is longer than 150 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.
       - clicking on context sensitive maps do not work off-line.

       b) IT WORKS BUT THERE ARE ADDRESSES IN CACHE.HTM WHICH SEEM NOT TO
         EXIST 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.
       - WebCache does not change cache contents in any way. It just show
         what there is according to Cache bookkeeping file.

3.     OPTIONS
--------------
       All options apply to Scan Cache, Scan Bookmarks and Save pages
       except Server separation which do not apply to Scan Bookmarks.

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

       Check option 'Filter| List Pictures' before 'Scan Cache',
       'Scan Bookmarks' or 'Save Pages' if you wish to have .gif and .jpg
       pictures listed in CACHE.HTM, BOOKLIST.HTM or _INDEX0?.HTM.
       In case of Cache scanning or Saving pages, 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
       or _INDEX0?.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 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 options apply to Scan Bookmark except Server separation.


5.    USING THE PROGRAM TO SAVE PAGES
-------------------------------------
       As you know, cache contents is of temporary nature. If one wants to
       save page(s) permanently, selected pages and its pictures must be
       copied into separate directory and then addresses on those pages must
       be changed (localized) to point to local files instead of remote sites.
       Always close Navigator before saving pages.

       Use Go | Save pages to save complete pages. Type address of the
       page you want to save or only server address if you want all pages
       from this server to be saved. Any unique part of the address may be
       entered.
       If you don't know exact address, or what is available, first use
       WebCache to Scan cache. Then in Navigator, click on desired address
       with right mouse button and choose: Copy this link location. Close
       Navigator and open Save pages in WebCache. When cursor is on address
       field press Shift-Ins key to paste address. Then you may edit this
       address to leave only server name, if you wish to save all the pages
       from this server.

       For example:
       assume the web site (server) name is http://www.mapworld.com
       and the pages you viewed were:
                http://www.mapworld.com/GreeceMap.htm
                http://www.mapworld.com/IndonesiaMap.htm  and
                http://www.mapworld.com/CroatiaMap.htm

       a) To save all pages at this server - type:  mapworld
       b) To save a single page - type: mapworld.com/CroatiaMap
          (or mapworld.com/GreeceMap or mapworld.com/IndonesiaMap)
       c) To save GreeceMap AND CroatiaMap - type: GreeceMap,CroatiaMap
          
       You may save all or some visited pages from several servers,
       for example typing:
           www.yahoo.com,ftp.borland.com,www.tel.fer.hr/index.html
       NOTE: a comma is used to separate entries. Number of entries is not
       limited but total length of addresses is 250 characters.

       A shortcut address which will save EVERYTHING in the cache is '/'
       (without the quote marks). Check free disk space first.

       Next type-in name of local directory to be used to copy those files.
       If this directory exist and is not empty, user will be asked if he
       wishes to delete existing files or to use it as is. If old files had
       index _INDEX0a.HTM and files are not deleted, new index will be
       _INDEX0b.HTM. It is not recommended to put too many files in a single
       directory (more than 1000): saving will take longer and there may be
       problems with naming local files or DOS file system.

       There are two Save options:
       [] follow other links  - to copy also pages which addresses are
                                contained on desired (found) pages
                                (if those pages are also in cache),
       [] delete exist. files - if desired local directory exists and contains
                                files, using this option will delete it first
                                without asking.

       Before saving files you might want to alter appearance of _INDEX0?.HTM
       file which will be found in Localization directory. Do it by changing
       Options | Filter and Options | Show.

       SAVING REMARKS
       - Localized addresses are marked on pages with *.
       - Original (home) address of the page is saved under "reload" link on
         the end of localized page (if Show| addresses is checked).
       - It is best to save pages immediately after closing Navigator because
         on next Navigator session some items might be deleted.
       - Since there are many pages which do not follow strictly HTML standard,
         there is no guaranty that all pages or all pictures on a page will be
         completely localized.
       - When you save all that is worth your attention, it is recommended to
         "Clear disk cache" in Navigator: Network preferences| Cache menu.
         Working with small cache is quicker and more accurate.


6.     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.
       This program is SHAREWARE and requires payment to the author.
       Commercial use requires license by the author.

       You may re-distribute unmodified package to BBS, Internet,
       CD-ROM, providing:
       - no money is charged for this program
       - you must email the author what version you are going to publish
         and in what product (so the author is able to send new version).

7.     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.

       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 bankers check payable to:
       Davor Zorc
       Istarska 51
       10 000 Zagreb
       Croatia

       e-mail: davor.zorc@fsb.hr

       Experience shows that personal checks from USA and European Union
       banks are accepted.
       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.

       BETTER YET, send music CD or cassette of popular/ethnic/jazz/rock
       music of YOUR country! (instead of money, to the above address).

       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.

       Latest version may be found on SimTel repository:
                ftp://oak.oakland.edu/pub/simtelnet/win3/inet/webcaXXX.zip
       or WinSite (CICA):
                ftp://ftp.winsite.com/pub/pc/win3/winsock/webcaXXX.zip
       or using browser at http://www.winsite.com  and search for: webca.
       There are many mirror sites of those archives around the world.

       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. There is also ORDERFRM.TXT in original archive.

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

Registration form for : WebCache
webca310.zip    View and save pages from Navigator local cache
___________________________________________________________________

Name:____________________________ Address: ________________________


City, State: ____________________________ Country: ________________

Zip:__________________  E-mail/ftp: _______________________________


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

Delivery: 3 1/2" diskette (price US$ 15) [ ]    e-mail (US$ 10) [ ]

Included US$:_____________          cash [ ]    check [ ]


Comments, suggestions for future updates, bugs, complaints:

___________________________________________________________________

___________________________________________________________________

___________________________________________________________________

Where did you get this file:

___________________________________________________________________

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


8.      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, France and other countries for their
        comments and support.

9.     MESSAGE DIALOGUES
------------------------
Here is the list of all message dialogues:

1  XXX Addresses found                     (successful Scan Cache - happy you!)
   In Navigator use: File/ Open CACHE.HTM
2  XXX files copied,                       (successful SAVE Cache - happy you!)
   Index of saved pages is : LOCAL
3  XXX addresses in output file,        (successful Scan Bookmark - happy you!)
   In Navigator use: File/ Open BOOKLIST.HTM

4  Input file not accessible!              (Navigator is running-quit it first)
5  Input file not found!                   (wrong installation)
6  Cache is empty!                         (cache cleared or no addresses for
                                            given filtering options)
7  Booklist is empty!                      (no bookmark made or no addresses
                                            for given filtering options)
8  Unable to write output file!            (no space on hard disk or
                                            run from CD-ROM)
9  Error during processing                 (Not Enough memory)!
10 Unable to create local directory        (invalid DOS name or run from CD-ROM)
11 Incomplete entry!                       (to Save you must Fill Address field)
12 This program is UNREGISTERED shareware  (1 month expired-Register now!)
13 List without Titles and Addresses       (check [x] Titles, Addresses or both)
14 Duplicate file names                    (use another Local directory)
15 Delete existing files,
   if you press No, directory will be used as is

10.    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
*      2.20     scan bookmarks, Show and Filter dialogues
       2.30     cosmetic changes, relaxed expire limitation, 1500 max sorting
*      3.00     save pages, run Navigator from WebCache
       3.10     AND Save, better tolerance to page and FAT.DB errors, 2000 max

*  =   published


