CHANGES.CONF
上传用户:seven77cht
上传日期:2007-01-04
资源大小:486k
文件大小:13k
- 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