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

The configuration file 'wwwoffle.conf' has had a number of changes made to it in
recent versions.  This file lists the conversion that you need to apply to
convert existing configuration files (from version 1.3 onwards) to make them
work with the current version.

More details about any of the sections in the configuration file can be found in
the README.CONF file.


Automatic Configuration File Upgrading [Requires Perl]
======================================

The configuration file can be automatically changed by using the supplied perl
script upgrade-config.pl.  This makes any changes from version 2.x to version
2.4c, it cannot make changes from a version 1.x config file.

  Usage: upgrade-config.pl <conf-dir>/wwwoffle.conf

The named configuration file is moved to wwwoffle.conf.old in the same directory
and a new file of the same name is created that contains the updated
configuration options.  If there is a file called wwwoffle.conf.install in
either the current directory or in the configuration directory (as there will be
if you do a make install) then the comments from that file are used in the new
file, otherwise no comments are used as they would be wrong and confusing.


Changes From Version 2.4c to Version 2.5
========================================

Note: The URL-SPECIFICATION has changed slightly to allow matching of URLs with
      arguments following a '?' character see the version 2.5 README.CONF file.

StartUp
-------

        New in version 2.5
        ------------------

        dir-perm  = <octal mode>
        file-perm = <octal mode>

        run-online   = <filename>
        run-offline  = <filename>
        run-autodial = <filename>


Options
-------

        New in version 2.5
        ------------------

        request-expired  = yes | no
        request-no-cache = yes | no

        connect-timeout = <time>

        intr-download-keep    = yes | no
        intr-download-size    = <integer>
        intr-download-percent = <integer>

        timeout-download-keep = yes | no


DontGet
-------

        Version 2.4 Was                         Version 2.5 Is
        ---------------                         --------------

        URL-SPECIFICATION                       URL-SPECIFICATION [ = <URL> ]


ModifyHTML
----------

        New in version 2.5
        ------------------

        disable-script  = yes | no
        disable-blink   = yes | no

        disable-animated-gif = yes | no


Changes From Version 2.4 to Version 2.4c
========================================

Options
-------

        New in version 2.4c
        -------------------

        no-lasttime-index = yes | no


ModifyHTML
----------

        New in version 2.4c
        -------------------

        anchor-requested-begin  = <HTML code>
        anchor-requested-end    = <HTML code>


Purge
-----

Note: The meaning of the max-size parameter has changed.  It now includes the
      size of hosts that are never purged but will not purge them.

        New in version 2.4c
        -------------------

        min-free = <integer>



Changes From Version 2.3 to Version 2.4
=======================================

Note: The URL-SPECIFICATION has changed slightly to allow wildcard matches using
      '*' and is described in the version 2.4 README.CONF file.


Options
-------

        Version 2.3 Was                         Version 2.4 Is
        ---------------                         --------------

        offline-requests = yes | no             [Replaced by DontRequestOffline
                                                 section]

                                                request-changed-once = yes | no

                                                ssl-allow-port = <integer>
                                                [Use 443 to allow https]

        monitor-interval = <integer>            [Removed due to the new
                                                 improved monitor options]

        add-info-refresh = yes | no             [Renamed add-cache-info in the
                                                 ModifyHTML section]


ModifyHTML
----------

New section specifying how the cached HTML pages are modified before display.

        New in version 2.4
        ------------------

        enable-modify-html = yes | no

        add-cache-info = yes | no

        anchor-cached-begin     = <HTML code>
        anchor-cached-end       = <HTML code>

        anchor-not-cached-begin = <HTML code>
        anchor-not-cached-end   = <HTML code>


AllowedConnect
--------------

Renamed to AllowedConnectHosts.

In this version the hostnames match using wildcards and not just using matching
from the left or right as they did before.  See README.CONF for details.


LocalNet
--------

In this version the hostnames match using wildcards and not just using matching
from the left or right as they did before.  See README.CONF for details.


AllowedConnectUsers
-------------------

New section that users authentication of users before access to cache is allowed.

        New in version 2.4
        ------------------

        username:password



DontRequestOffline
------------------

New section, same format as DontCache, DontGet, DontGetRecursive.


CensorHeader
------------

        Version 2.3 Was                         Version 2.4 Is
        ---------------                         --------------

                                                referer-self = yes | no
                                                referer-self-dir = yes | no


DontIndex
---------

        New in version 2.4
        ------------------

        outgoing = URL-SPECIFICATION
        latest   = URL-SPECIFICATION
        monitor  = URL-SPECIFICATION
        host     = URL-SPECIFICATION


Proxy
-----

        Version 2.3 Was                         Version 2.4 Is
        ---------------                         --------------

                                                ssl = <hostname[:integer]>



Changes From Version 2.2 to Version 2.3
=======================================

Note: HOST-SPECIFICATION and FILE-SPECIFICATION are described in the version
      2.1/2.2 README.CONF file.
      URL-SPECIFICATION is described in the version 2.3 README.CONF file.


Options
-------

        New in Version 2.3
        ------------------

        connect-retry = yes | no

        confirm-requests = yes | no


DontIndex
---------

New section, same format as DontCache, DontGet, DontGetRecursive.


DontCache, DontGetRecursive
---------------------------

        Version 2.2 Was                         Version 2.3 Is
        ---------------                         --------------

HOST-SPECIFICATION = FILE-SPECIFICATION         URL-SPECIFICATION


DontGet
-------

        Version 2.2 Was                         Version 2.3 Is
        ---------------                         --------------

HOST-SPECIFICATION = FILE-SPECIFICATION         URL-SPECIFICATION

                                                replacement = <URL>


Proxy
-----

        Version 2.2 Was                         Version 2.3 Is
        ---------------                         --------------

HOST-SPECIFICATION = <hostname[:integer]>
                                       URL-SPECIFICATION = <hostname[:integer]>


Alias (was Mirror)
------------------

        Version 2.2 Was                         Version 2.3 Is
        ---------------                         --------------

HOST-SPECIFICATION = HOST-SPECIFICATION
                                        URL-SPECIFICATION = URL-SPECIFICATION


Purge
-----

        Version 2.2 Was                         Version 2.3 Is
        ---------------                         --------------

HOST-SPECIFICATION = <integer>                  URL-SPECIFICATION = <integer>

                                                del-dontget   = yes | no
                                                del-dontcache = yes | no
                                                use-url       = yes | no



Changes From Version 2.1 to Version 2.2
=======================================

Note: The 'fetch-images' and 'fetch-frames' options are moved from the Options
      section to the FetchOptions section and renamed 'images' and 'frames'.

Options
-------

        New in Version 2.2                      Removed in Version 2.2
        ------------------                      ----------------------

        socket-timeout = <time>                 fetch-images = yes | no
        (default=120)                           fetch-frames = yes | no


FetchOptions
------------

        New in Version 2.2
        ------------------

        stylesheets = yes | no
        images      = yes | no
        frames      = yes | no
        scripts     = yes | no
        objects     = yes | no


CensorHeader
------------

        Version 2.1 Was                         Version 2.2 Is
        ---------------                         --------------

        <header>                                <header> =
                                                <header> = replacement-string



Changes From Version 2.0 to Version 2.1
=======================================

Note: The configuration parser is more fussy about having the correct types,
      previously a non-integer was allowed where an integer was expected etc.

Note: In the DontCache, DontGet, DontGetRecursive, Proxy and Purge sections the
      presence of a port number ( proto/host:port ) must match, a ':' with no
      port number is a wildcard and matches any port.  See the README.CONF file
      in the HOST-SPECIFICATION section for more details.


Options
-------

        Version 2.0 Was                         Version 2.1 Is
        ---------------                         --------------

        request-changed = yes | no              request-changed = <time>
                                                (use 600 for yes and -1 for no).


        New in version 2.1
        ------------------

        offline-requests = yes | no
        monitor-interval = <age>


FTPOptions
----------

        New in version 2.1
        ------------------

        auth-hostname = <host:[port]>
        auth-username = <username>
        auth-password = <password>


Proxy
-----

        New in version 2.1
        ------------------

        auth-hostname = <host:[port]>
        auth-username = <username>
        auth-password = <password>



Changes From Version 1.3 to Version 2.0
=======================================

StartUp, Options
----------------

Unchanged


LocalHost, LocalNet, AllowedConnect
-----------------------------------

Unchanged


DontCache, DontGet, DontGetRecursive
------------------------------------

        Version 1.3 Was                         Version 2.0 Is
        ---------------                         --------------

        host = <host>                           http/<host> = /
        file-ext = <ext>                        default     = .<ext>
        <host> = <path>                         http/<host> = <path>

                                                <proto>/       = ...
                                                <proto>/<host> = ...
                                                <host>         = ...
                                                ...            = .<file-ext>
                                                ...            = /<path>


CensorHeader
------------

Unchanged


Proxy
-----

        Version 1.3 Was                         Version 2.0 Is
        ---------------                         --------------

default = <hostname[:integer]>          http/       = <hostname[:integer]>
<host>  = <hostname[:integer]>          http/<host> = <hostname[:integer]>

                                        <proto>/       = <hostname[:integer]>
                                        <proto>/<host> = <hostname[:integer]>
                                        <host>         = <hostname[:integer]>

(Where '<hostname[:integer]>' can also be 'none' or left blank.)


Purge
-----

        Version 1.3 Was                         Version 2.0 Is
        ---------------                         --------------

        use-mtime   = yes | no                  use-mtime   = yes | no
        max-size    = <integer>                 max-size    = <integer>
        default     = <integer>                 default     = <integer>
        <host>      = <integer>                 http/<host> = <integer>

                                                <proto>/       = <integer>
                                                <proto>/<host> = <integer>
                                                <host>         = <integer>

FTPOptions, MIMETypes, Mirror
-----------------------------

All New
