CHANGES.CONF
上传用户:seven77cht
上传日期:2007-01-04
资源大小:486k
文件大小:13k
源码类别:

浏览器

开发平台:

Unix_Linux

  1.           WWWOFFLE - World Wide Web Offline Explorer - Version 2.5
  2.           ========================================================
  3. The configuration file 'wwwoffle.conf' has had a number of changes made to it in
  4. recent versions.  This file lists the conversion that you need to apply to
  5. convert existing configuration files (from version 1.3 onwards) to make them
  6. work with the current version.
  7. More details about any of the sections in the configuration file can be found in
  8. the README.CONF file.
  9. Automatic Configuration File Upgrading [Requires Perl]
  10. ======================================
  11. The configuration file can be automatically changed by using the supplied perl
  12. script upgrade-config.pl.  This makes any changes from version 2.x to version
  13. 2.4c, it cannot make changes from a version 1.x config file.
  14.   Usage: upgrade-config.pl <conf-dir>/wwwoffle.conf
  15. The named configuration file is moved to wwwoffle.conf.old in the same directory
  16. and a new file of the same name is created that contains the updated
  17. configuration options.  If there is a file called wwwoffle.conf.install in
  18. either the current directory or in the configuration directory (as there will be
  19. if you do a make install) then the comments from that file are used in the new
  20. file, otherwise no comments are used as they would be wrong and confusing.
  21. Changes From Version 2.4c to Version 2.5
  22. ========================================
  23. Note: The URL-SPECIFICATION has changed slightly to allow matching of URLs with
  24.       arguments following a '?' character see the version 2.5 README.CONF file.
  25. StartUp
  26. -------
  27.         New in version 2.5
  28.         ------------------
  29.         dir-perm  = <octal mode>
  30.         file-perm = <octal mode>
  31.         run-online   = <filename>
  32.         run-offline  = <filename>
  33.         run-autodial = <filename>
  34. Options
  35. -------
  36.         New in version 2.5
  37.         ------------------
  38.         request-expired  = yes | no
  39.         request-no-cache = yes | no
  40.         connect-timeout = <time>
  41.         intr-download-keep    = yes | no
  42.         intr-download-size    = <integer>
  43.         intr-download-percent = <integer>
  44.         timeout-download-keep = yes | no
  45. DontGet
  46. -------
  47.         Version 2.4 Was                         Version 2.5 Is
  48.         ---------------                         --------------
  49.         URL-SPECIFICATION                       URL-SPECIFICATION [ = <URL> ]
  50. ModifyHTML
  51. ----------
  52.         New in version 2.5
  53.         ------------------
  54.         disable-script  = yes | no
  55.         disable-blink   = yes | no
  56.         disable-animated-gif = yes | no
  57. Changes From Version 2.4 to Version 2.4c
  58. ========================================
  59. Options
  60. -------
  61.         New in version 2.4c
  62.         -------------------
  63.         no-lasttime-index = yes | no
  64. ModifyHTML
  65. ----------
  66.         New in version 2.4c
  67.         -------------------
  68.         anchor-requested-begin  = <HTML code>
  69.         anchor-requested-end    = <HTML code>
  70. Purge
  71. -----
  72. Note: The meaning of the max-size parameter has changed.  It now includes the
  73.       size of hosts that are never purged but will not purge them.
  74.         New in version 2.4c
  75.         -------------------
  76.         min-free = <integer>
  77. Changes From Version 2.3 to Version 2.4
  78. =======================================
  79. Note: The URL-SPECIFICATION has changed slightly to allow wildcard matches using
  80.       '*' and is described in the version 2.4 README.CONF file.
  81. Options
  82. -------
  83.         Version 2.3 Was                         Version 2.4 Is
  84.         ---------------                         --------------
  85.         offline-requests = yes | no             [Replaced by DontRequestOffline
  86.                                                  section]
  87.                                                 request-changed-once = yes | no
  88.                                                 ssl-allow-port = <integer>
  89.                                                 [Use 443 to allow https]
  90.         monitor-interval = <integer>            [Removed due to the new
  91.                                                  improved monitor options]
  92.         add-info-refresh = yes | no             [Renamed add-cache-info in the
  93.                                                  ModifyHTML section]
  94. ModifyHTML
  95. ----------
  96. New section specifying how the cached HTML pages are modified before display.
  97.         New in version 2.4
  98.         ------------------
  99.         enable-modify-html = yes | no
  100.         add-cache-info = yes | no
  101.         anchor-cached-begin     = <HTML code>
  102.         anchor-cached-end       = <HTML code>
  103.         anchor-not-cached-begin = <HTML code>
  104.         anchor-not-cached-end   = <HTML code>
  105. AllowedConnect
  106. --------------
  107. Renamed to AllowedConnectHosts.
  108. In this version the hostnames match using wildcards and not just using matching
  109. from the left or right as they did before.  See README.CONF for details.
  110. LocalNet
  111. --------
  112. In this version the hostnames match using wildcards and not just using matching
  113. from the left or right as they did before.  See README.CONF for details.
  114. AllowedConnectUsers
  115. -------------------
  116. New section that users authentication of users before access to cache is allowed.
  117.         New in version 2.4
  118.         ------------------
  119.         username:password
  120. DontRequestOffline
  121. ------------------
  122. New section, same format as DontCache, DontGet, DontGetRecursive.
  123. CensorHeader
  124. ------------
  125.         Version 2.3 Was                         Version 2.4 Is
  126.         ---------------                         --------------
  127.                                                 referer-self = yes | no
  128.                                                 referer-self-dir = yes | no
  129. DontIndex
  130. ---------
  131.         New in version 2.4
  132.         ------------------
  133.         outgoing = URL-SPECIFICATION
  134.         latest   = URL-SPECIFICATION
  135.         monitor  = URL-SPECIFICATION
  136.         host     = URL-SPECIFICATION
  137. Proxy
  138. -----
  139.         Version 2.3 Was                         Version 2.4 Is
  140.         ---------------                         --------------
  141.                                                 ssl = <hostname[:integer]>
  142. Changes From Version 2.2 to Version 2.3
  143. =======================================
  144. Note: HOST-SPECIFICATION and FILE-SPECIFICATION are described in the version
  145.       2.1/2.2 README.CONF file.
  146.       URL-SPECIFICATION is described in the version 2.3 README.CONF file.
  147. Options
  148. -------
  149.         New in Version 2.3
  150.         ------------------
  151.         connect-retry = yes | no
  152.         confirm-requests = yes | no
  153. DontIndex
  154. ---------
  155. New section, same format as DontCache, DontGet, DontGetRecursive.
  156. DontCache, DontGetRecursive
  157. ---------------------------
  158.         Version 2.2 Was                         Version 2.3 Is
  159.         ---------------                         --------------
  160. HOST-SPECIFICATION = FILE-SPECIFICATION         URL-SPECIFICATION
  161. DontGet
  162. -------
  163.         Version 2.2 Was                         Version 2.3 Is
  164.         ---------------                         --------------
  165. HOST-SPECIFICATION = FILE-SPECIFICATION         URL-SPECIFICATION
  166.                                                 replacement = <URL>
  167. Proxy
  168. -----
  169.         Version 2.2 Was                         Version 2.3 Is
  170.         ---------------                         --------------
  171. HOST-SPECIFICATION = <hostname[:integer]>
  172.                                        URL-SPECIFICATION = <hostname[:integer]>
  173. Alias (was Mirror)
  174. ------------------
  175.         Version 2.2 Was                         Version 2.3 Is
  176.         ---------------                         --------------
  177. HOST-SPECIFICATION = HOST-SPECIFICATION
  178.                                         URL-SPECIFICATION = URL-SPECIFICATION
  179. Purge
  180. -----
  181.         Version 2.2 Was                         Version 2.3 Is
  182.         ---------------                         --------------
  183. HOST-SPECIFICATION = <integer>                  URL-SPECIFICATION = <integer>
  184.                                                 del-dontget   = yes | no
  185.                                                 del-dontcache = yes | no
  186.                                                 use-url       = yes | no
  187. Changes From Version 2.1 to Version 2.2
  188. =======================================
  189. Note: The 'fetch-images' and 'fetch-frames' options are moved from the Options
  190.       section to the FetchOptions section and renamed 'images' and 'frames'.
  191. Options
  192. -------
  193.         New in Version 2.2                      Removed in Version 2.2
  194.         ------------------                      ----------------------
  195.         socket-timeout = <time>                 fetch-images = yes | no
  196.         (default=120)                           fetch-frames = yes | no
  197. FetchOptions
  198. ------------
  199.         New in Version 2.2
  200.         ------------------
  201.         stylesheets = yes | no
  202.         images      = yes | no
  203.         frames      = yes | no
  204.         scripts     = yes | no
  205.         objects     = yes | no
  206. CensorHeader
  207. ------------
  208.         Version 2.1 Was                         Version 2.2 Is
  209.         ---------------                         --------------
  210.         <header>                                <header> =
  211.                                                 <header> = replacement-string
  212. Changes From Version 2.0 to Version 2.1
  213. =======================================
  214. Note: The configuration parser is more fussy about having the correct types,
  215.       previously a non-integer was allowed where an integer was expected etc.
  216. Note: In the DontCache, DontGet, DontGetRecursive, Proxy and Purge sections the
  217.       presence of a port number ( proto/host:port ) must match, a ':' with no
  218.       port number is a wildcard and matches any port.  See the README.CONF file
  219.       in the HOST-SPECIFICATION section for more details.
  220. Options
  221. -------
  222.         Version 2.0 Was                         Version 2.1 Is
  223.         ---------------                         --------------
  224.         request-changed = yes | no              request-changed = <time>
  225.                                                 (use 600 for yes and -1 for no).
  226.         New in version 2.1
  227.         ------------------
  228.         offline-requests = yes | no
  229.         monitor-interval = <age>
  230. FTPOptions
  231. ----------
  232.         New in version 2.1
  233.         ------------------
  234.         auth-hostname = <host:[port]>
  235.         auth-username = <username>
  236.         auth-password = <password>
  237. Proxy
  238. -----
  239.         New in version 2.1
  240.         ------------------
  241.         auth-hostname = <host:[port]>
  242.         auth-username = <username>
  243.         auth-password = <password>
  244. Changes From Version 1.3 to Version 2.0
  245. =======================================
  246. StartUp, Options
  247. ----------------
  248. Unchanged
  249. LocalHost, LocalNet, AllowedConnect
  250. -----------------------------------
  251. Unchanged
  252. DontCache, DontGet, DontGetRecursive
  253. ------------------------------------
  254.         Version 1.3 Was                         Version 2.0 Is
  255.         ---------------                         --------------
  256.         host = <host>                           http/<host> = /
  257.         file-ext = <ext>                        default     = .<ext>
  258.         <host> = <path>                         http/<host> = <path>
  259.                                                 <proto>/       = ...
  260.                                                 <proto>/<host> = ...
  261.                                                 <host>         = ...
  262.                                                 ...            = .<file-ext>
  263.                                                 ...            = /<path>
  264. CensorHeader
  265. ------------
  266. Unchanged
  267. Proxy
  268. -----
  269.         Version 1.3 Was                         Version 2.0 Is
  270.         ---------------                         --------------
  271. default = <hostname[:integer]>          http/       = <hostname[:integer]>
  272. <host>  = <hostname[:integer]>          http/<host> = <hostname[:integer]>
  273.                                         <proto>/       = <hostname[:integer]>
  274.                                         <proto>/<host> = <hostname[:integer]>
  275.                                         <host>         = <hostname[:integer]>
  276. (Where '<hostname[:integer]>' can also be 'none' or left blank.)
  277. Purge
  278. -----
  279.         Version 1.3 Was                         Version 2.0 Is
  280.         ---------------                         --------------
  281.         use-mtime   = yes | no                  use-mtime   = yes | no
  282.         max-size    = <integer>                 max-size    = <integer>
  283.         default     = <integer>                 default     = <integer>
  284.         <host>      = <integer>                 http/<host> = <integer>
  285.                                                 <proto>/       = <integer>
  286.                                                 <proto>/<host> = <integer>
  287.                                                 <host>         = <integer>
  288. FTPOptions, MIMETypes, Mirror
  289. -----------------------------
  290. All New