          WWWOFFLE - World Wide Web Offline Explorer - Version 1.1
          ========================================================

The following nine steps should be sufficient to demonstrate wwwoffle running.

1) Edit the Makefile to set the path for installation (INSTDIR), the spool
   directory (SPOOLDIR), and the compiler options (CC,CFLAGS).

2) Compile the programs
     make all

3) Install the programs and create the spool directory
     make install

        **** Important * If you have installed version 1.0 ****
    This version does not have the wwwoffles program in $(INSTDIR)/sbin
    that version 1.0 had.  You *must* remove that file before installing
    this version.
        **** Important * If you have installed version 1.0  ****

4) Start the wwwoffle demon running.
   $(INSTDIR)/sbin/wwwoffled -c $(SPOOLDIR)/wwwoffle.conf

        **** Important * If you must use an external HTTP proxy ****
    You will need to add the name of the proxy and the port number to the
    configuration file $(SPOOLDIR)/wwwoffle.conf, read it for instructions.
        **** Important * If you must use an external HTTP proxy ****

        **** Important * If have used a previous version of wwwoffle ****
    The configuration file $(SPOOLDIR)/wwwoffle.conf now contains all the
    parameters that were command line options to wwwoffled in earlier versions.
        **** Important * If have used a previous version of wwwoffle ****

5) Start your WWW Browser and set up localhost:8080 as the proxy.
   Disable caching between sessions within the browser.

6) a) Connect to the internet
   b) Tell the wwwoffle demon that you are online
        wwwoffle -online
   c) Start browsing
   d) Tell the wwwoffle demon that you are offline
        wwwoffle -offline
   e) Disconnect from the internet

7) Go back and browse the pages again while not connected, follow some different
   links this time (you will see a wwwoffle server message in the browser).

8) a) Connect to the internet
   b) Tell the wwwoffle demon that you are online
        wwwoffle -online
   c) Tell the wwwoffle demon to fetch the new pages
        wwwoffle -fetch
   d) Tell the wwwoffle demon that you are offline
        wwwoffle -offline
   e) Disconnect from the internet

9) a) Go to http://localhost:8080/ and find the newly downloaded pages.
   b) Browse the new pages that have just been fetched.


The README and manual pages give more detail on how to use the programs.

This program has been tested by me on Linux 2.0.29 with Netscape version 1.12,
Mosaic version 2.6, Lynx version 2.5, Arena version Beta 3b and Emacs W3-mode
version 3.  Other people have tested previous versions of the program on
different Linux versions with different browsers.

If you wish to submit bug reports or other comments about the programs then
email me at amb@gedanken.demon.co.uk and put wwwoffle in the subject line.
