HI,
i use wwwoffle with SuSE 7.0 Linux. Under KDE wwwoffle often
didn't cached pages when used with netscape. With kfm file browser
everything seemed to be ok. , but kfm don't know javascript, so
i had to get pages with javascript with netscape each time new.
Now with KDE2 and its browser konqueror it's even worse. It
seems not to cache pages at all and get everything from the net.
wwwwoffled is surely stared and i surely put http proxy to
localhost 8080 in the browser. I excluded only localhost:6711,
which is for htdig, or man.
Is there anybody with Linux KDE2 using succeffuly wwwoffle ?
I attach my config file
Thanks in advance
Zbyszek
-- 
to support e-mail voting see http://www.evot.org



-- 
 
#
# WWWOFFLE - World Wide Web Offline Explorer - Version 2.5e.
#
# WWWOFFLE Configuration file /etc/wwwoffle/wwwoffle.conf
#
# Derived from the example configuration file written by Andrew M. Bishop
#
# WWWOFFLE and example configuration file Copyright 1997,98,99,2000
# Andrew M. Bishop
# They may be distributed under the GNU Public License, version 2, or
# any higher version.  See section COPYING of the GNU Public license
# for conditions under which this file may be redistributed.
#

#
# Lines beginning with a '#' are comments and ignored.
#

#
# Program startup configuration.
#
# This can not be changed without restarting the program.
#
# Header : StartUp
# Options: http-port         = <integer>
#               The port number to use for the proxy http server (default=8080).
#          wwwoffle-port     = <integer>
#               The port number to use for wwwoffle control (default=8081).
#          spool-dir         = <directory name>
#               The directory to use as the spool directory
#               (default=/var/spool/wwwoffle).
#          run-uid           = <username> | <uid>
#               The username or numeric uid to run the wwwoffled server as
#               (default=none).
#          run-gid           = <groupname> | <gid>
#               The groupname or numeric gid to run the wwwoffled server as
#               (default=none).
#          use-syslog        = yes | no
#               If true then log all important messages using syslog
#               (default=yes).
#          password          = <word> | none |
#               The authorisation password for demon configuration by wwwoffle
#               (default=none).
#          max-servers       = <integer>
#               The maximum number of server processes that are ever started,
#               must be less than MAX_SERVERS (=64) (default=8).
#          max-fetch-servers = <integer>
#               The maximum number of server processes that are started to
#               fetch pages that were requested in offline mode, must be less
#               than MAX_FETCH_SERVERS (=48). (default=4).
#          dir-perm          = <octal integer>
#               The permissions to use when creating spool directories
#               (default=0755).
#          file-perm         = <octal integer>
#               The permissions to use when creating spool files (default=0644).
#          run-online        = <filename>
#               The name of a program to run when switched to online mode
#               (default=none).
#          run-offline       = <filename>
#               The name of a program to run when switched to offline mode
#               (default=none).
#          run-autodial      = <filename>
#               The name of a program to run when switched to autodial mode
#               (default=none).
#
# Notes 1: For the password to work the configuration file must be set so that
#          only authorised users can read it.
#       2: The run-uid/run-gid options are not applicable to win32 (Win95/98).
#       3: To use the run-uid/run-gid options server must be started as root.
#       4: The max-fetch-servers value must be less than max-servers or you will
#          not be able to use wwwoffle interactively online while fetching.
#       5: The dir-perm and file-perm options override the umask settings and
#          must be in octal starting with a '0' character.
#       6: The programs run using the run-online, run-offline and run-autodial
#          options are started with a single parameter set to the current mode.
#

StartUp
{
 http-port         = 8080
 wwwoffle-port     = 8081

 spool-dir         = /var/spool/wwwoffle

 run-uid           = wwwrun
 run-gid           = nogroup

 use-syslog        = yes

 password          = none

 max-servers       = 8
 max-fetch-servers = 4

 dir-perm          = 0755
 file-perm         = 0644
}


#
# Other configuration options.
#
# Header : Options
# Options: log-level         = debug | info | important | warning | fatal
#               Log messages with this or higher priority (default=important).
#          index-latest-days = <age>
#               The age in days of pages to show in the index of latest pages
#               (default=7).
#          request-changed   = <time>
#               While online pages will only be fetched if the cached version
#               is older than this specified time in seconds (default=600).
#          request-changed-once = yes | no
#               While online pages will only be fetched if the cached version
#               has not already been fetched once this session (default=yes).
#          request-expired = yes | no
#               While online pages that have expired will always be requested
#               again (default=no). 
#          request-no-cache = yes | no
#               While online pages that ask not to be cached will always be
#               requested again (default=no).
#          pragma-no-cache   = yes | no
#               Whether to request a new copy of a page if the request from the
#               browser has 'Pragma: no-cache' (default=yes).
#          confirm-requests  = yes | no
#               Whether to return a page requiring user confirmation instead of
#               automatically recording requests made while offline
#               (default=no).
#          connect-timeout   = <time>
#               The time in seconds that WWWOFFLE will wait for the socket
#               connection (default=30).
#          socket-timeout    = <time>
#               The time in seconds that wwwoffle will wait for data before
#               giving up on a socket connection (default=120).
#          connect-retry     = yes | no
#               If a connection cannot be made to a remote server
#               then try again after a short delay (default=no).
#          ssl-allow-port    = <integer>
#               A port number that can be used for Secure Socket Layer (SSL)
#               connections, e.g. https.
#          no-lasttime-index = yes | no
#               Disables creation of the lasttime/prevtime indexes (default=no).
#          intr-download-keep = yes | no
#               If the browser closes the connection while online the currently
#               downloaded partial page should be kept (default=no).
#          intr-download-size = <integer>
#               If the browser closes the connection while online the page
#               should continue to download if smaller than this size in kB
#               (default=1).
#          intr-download-percent = <integer>
#               If the browser closes the connection while online the page
#               should continue to download if more than this amount complete
#               (default=80).
#          timeout-download-keep = yes | no
#               If the server connection timeouts while reading then the
#               currently downloaded partial page should be kept (default=no).
#
#  Notes 1: The request-changed option can be set negative to indicate that
#           cached pages are always used while online.
#        2: The request-changed-once option takes precedence over the
#           request-changed option.
#        3: The request-expired and request-no-cache options takes precedence
#           over the request-changed-once and request-changed options.
#        3: The pragma-no-cache option should be set to 'no' if when browsing
#           offline all pages are re-requested by a 'broken' browser.
#        4: The ssl-allow-port should be set to 443 to allow https, there can be
#           more than one ssl-allow-port entry for other ports as required.
#

Options
{
 log-level            = debug

 index-latest-days    = 14

 request-changed      = 600

 request-changed-once = yes

 request-expired      = no

 pragma-no-cache      = yes

 confirm-requests     = no

#connect-timeout      = 30
 connect-timeout      = 120
#socket-timeout       = 120
 socket-timeout       = 360

 connect-retry        = no

 ssl-allow-port       = 443

 no-lasttime-index    = no

 intr-download-keep    = no
 intr-download-size    = 1
 intr-download-percent = 80

 timeout-download-keep = yes
}


#
# Automatic Fetch options.
#
# Header : FetchOptions
# Options: stylesheets = yes | no
#               If style sheets are to be fetched.
#          images       = yes | no
#               If images are to be fetched.
#          frames       = yes | no
#               If frames are to be fetched.
#          scripts      = yes | no
#               If scripts are to be fetched.
#          objects      = yes | no
#               If objects (e.g. Java class files ) are to be fetched.
#
# Notes 1: These options all default to 'no' if nothing is specified.
#

FetchOptions
{
 stylesheets = yes

 images      = yes

 frames      = yes

 scripts     = yes

 objects     = yes
}


#
# HTML modifications that are made to the spooled pages.
#
# Options that control how the HTML that is provided from the cache is modified.
#
# Header : ModifyHTML
# Options: enable-modify-html = yes | no
#               Enable the HTML modifications in this section (has a speed
#               penalty) (default=no).
#          add-cache-info = yes | no
#               At the bottom of all of the spooled pages the date that the page
#               was cached and some buttons are to be added (default=no).
#          anchor-cached-begin = <HTML code>
#               Anchors (links) that are cached are to have the specified HTML
#               inserted at the beginning (default="").
#          anchor-cached-end = <HTML code>
#               Anchors (links) that are cached are to have the specified HTML
#               inserted at the end (default="").
#          anchor-requested-begin  = <HTML code>
#               Anchors (links) that have been requested are to have the
#               specified HTML inserted at the beginning (default="").
#          anchor-requested-end = <HTML code>
#               Anchors (links) that have been requested are to have the
#               specified HTML inserted at the end (default="").
#          anchor-not-cached-begin = <HTML code>
#               Anchors (links) that are not cached or requested are to have the
#               specified HTML inserted at the beginning (default="").
#          anchor-not-cached-end = <HTML code>
#               Anchors (links) that are not cached or requested are to have the
#               specified HTML inserted at the end (default="").
#          disable-script = yes | no
#               Removes all scripts and scripted events (default=no).
#          disable-blink = yes | no
#               Removes the <blink> tag (default=no).
#          disable-animated-gif = yes | no
#               Disables the animation of GIF files (default=no).
#
# Notes 1: These options all rely on the HTML being syntactically correct, if it
#          is not then the result is undefined.
#

ModifyHTML
{
 enable-modify-html = no

 add-cache-info = no

#anchor-cached-begin     = <font color="#00B000">
#anchor-cached-end       = </font>
#anchor-requested-begin  = <font color="#B0B000">
#anchor-requested-end    = </font>
#anchor-not-cached-begin = <font color="#B00000">
#anchor-not-cached-end   = </font>

 disable-script          = no
 disable-blink           = no

 disable-animated-gif    = no
}


#
# WWWOFFLE server host name specification.
#
# The possible names that the server that wwwoffles is on may be known by.
#
# Header : LocalHost
# Options: <host>
#               One of the possible hostnames or IP addresses.
#
# Notes 1: The host names must match exactly, no wildcard matches.
#       2: All entries in here are also used the same way as those in the
#          LocalNet and AllowedConnectHosts sections.
#       3: The first named host is used as the server name for several features
#          so must be a name that will work from any client host on the network.
#       4: None of the entries here or in LocalNet are fetched via a proxy.
#

LocalHost
{
 localhost
 127.0.0.1

#### Example ####
# The server is on www.foo.com, with IP address
# 11.22.33.44.
# www.foo.com
# 11.22.33.44
}


#
# Local Network non-cached host name specification
#
# The names of hosts that are not cached because they are on the local network.
#
# Header : LocalNet
# Options: <host>
#               A hostname or IP address.
#
# Notes 1: The host name matching uses wildcards (see the WILDCARD section).
#       2: A host can be excluded by appending a '!' to the start of the name,
#          all possible aliases and IP addresses for the host are also required.
#       3: All entries here are assumed to be reachable even when offline.
#       4: All entries in the LocalHost section are used as if they were here.
#       5: None of the entries here or in LocalHost are fetched via a proxy.
#

LocalNet
{

#### Example ####
# The local domain is foo.com so don't cache any hosts in it.
# *.foo.com
}


#
# Allowed client host name specification
#
# The names of client hosts that are allowed to connect to the server.
#
# Header : AllowedConnectHosts
# Options: <host>
#               A hostname or IP address.
#
# Notes 1: The host name matching uses wildcards (see the WILDCARD section).
#       2: A host can be excluded by appending a '!' to the start of the name,
#          all possible aliases and IP addresses for the host are also required.
#       3: All entries in the LocalHost section are used as if they were here.
#

AllowedConnectHosts
{

#### Example ####
# Only allow connections from hosts in the foo.com domain.
# *.foo.com
}


#
# Allowed client username specification
#
# A list of the users that are allowed to connect to the server.
#
# Header : AllowedConnectUsers
# Options: <username>:<password>
#               The username and password of the users that are allowed to
#               connect to the server.
#
# Notes 1: If this section is left empty then no user authentication is done.
#       2: The username and password are both stored in plaintext format.
#       3: This requires the use of browsers that handle the HTTP/1.1 standard.
#

AllowedConnectUsers
{

#### Example ####
# Only allow connections from this one user.
# andrew:password
}


#
# A list of ways of recognising a URL not to cache.
#
# Header : DontCache
# Options: URL-SPECIFICATION
#               Do not cache any URLs that match this.
#
# Notes 1: See the bottom of this file for the description of URL-SPECIFICATION.
#       2: The URL-SPECIFICATION can be negated, see URL-SPECIFICATION below.
#       3: The URL will still be cached if fetched non-interactively.
#

DontCache
{

#### Example ####
# Don't cache any hosts in the barfoo.com domain.
# *://*.barfoo.com/
# Don't cache any gzipped or tar files.
# *://*/*.gz
# *://*/*.tar
# Don't cache any files from /volatile in the foo.com domain.
# *://*.foo.com/volatile/*
}


#
# A list of ways of recognising a URL not to get.
#
# Header : DontGet
# Options: URL-SPECIFICATION [ = <URL> ]
#               Do not get any URLs that match this [ with the option to specify
#               a replacement URL ].
#          replacement = <URL>
#               The default URL to replace any URLs that match the
#               URL-SPECIFICATIONs instead of using the standard error message
#               (default=none).
#
# Notes 1: See the bottom of this file for the description of URL-SPECIFICATION.
#       2: The URL-SPECIFICATION can be negated, see URL-SPECIFICATION below.
#       3: The URL /local/images/trans-1x1.gif is a suggested replacement
#          (a 1x1 pixel transparent gif).
#

DontGet
{

#replacement = /local/images/trans-1x1.gif

#### Example ####
# Don't get from any hosts in the barfoo.com domain.
# *://*.barfoo.com/
# Don't get any gzipped or tar files.
# *://*/*.gz
# *://*/*.tar
# Don't get any files from /adverts in the foo.com domain.
# *://*.foo.com/adverts*
}


#
# A list of ways of recognising a URL not to get when fetching recursively.
#
# Header : DontGetRecursive
# Options: URL-SPECIFICATION
#               Do not get any URLs that match this.
#
# Notes 1: See the bottom of this file for the description of URL-SPECIFICATION.
#       2: The URL-SPECIFICATION can be negated, see URL-SPECIFICATION below.
#

DontGetRecursive
{

#### Example ####
# Dont get any gzipped or tar files when getting recursively.
# *://*/*.gz
# *://*/*.tar
}


#
# A list of URLs that cannot be requested by users when offline.
#
# Header : DontRequestOffline
# Options: URL-SPECIFICATION
#               Do not request any URLs that match this.
#
# Notes 1: See the bottom of this file for the description of URL-SPECIFICATION.
#       2: The URL-SPECIFICATION can be negated, see URL-SPECIFICATION below.
#

DontRequestOffline
{

#### Example ####
# Dont request any URLs at all when offline.
# *://*/
}


#
# Censorship of information in HTTP headers
#
# A list of HTTP header lines that are to be removed from the requests sent or
# replies received from the servers, or fake headers to be used instead.
#
# Header : CensorHeader
# Options: <header> = <string> | none |
#               A header field name, (e.g. From, Cookie, Set-Cookie, User-Agent)
#               and the string to replace the header value with.
#          referer-self = yes | no
#               Sets the Referer header to the same as the URL (default = no).
#          referer-self-dir = yes | no
#               Sets the Referer header to the URL directory name (default = no).
#
# Notes 1: The header is case sensitive, and does not have a ':' at the end.
#       2: The value of none or no string can be used to remove the header.
#       3: This only replaces headers it finds, it does not add any new ones.
#       4: The referer-self-dir option takes precedence over referer-self.
#

CensorHeader
{

### Example ###
# Don't send the username.
# From =
# Don't accept Cookies
# Set-Cookie =
# Don't send Cookies back
# Cookie =
# Lie about the Browser type.
User-Agent = WWWOFFLE/2.6
}


#
# Options to use when fetching files using ftp.
#
# Header : FTPOptions
# Options: anon-username = <string>
#               The username to use for anonymous ftp (default=anonymous).
#          anon-password = <string>
#               The password to use for anonymous ftp (default=<user>@<host>).
#          auth-hostname = <host[:port]>
#               A host to use a different username and password.
#          auth-username = <string>
#               The username to use on the above host.
#          auth-password = <string>
#               The password to use on the above host.
#
# Notes 1: The anon-password should be set to a sensible value especially if you
#          are behind a firewall.
#       2: The auth-hostname, auth-username and auth-password options must come
#          together as a triplet.
#       3: The auth-hostname must be exact, it is not used as a WILDCARD match.
#

FTPOptions
{
 anon-username = anonymous
#anon-password = 
}


#
# MIME Types to use when fetching files not using HTTP.
#
# Header : MIMETypes
# Options: default     = <mime-type>/<subtype>
#               The default MIME type (default=text/plain).
#          .<file-ext> = <mime-type>/<subtype>
#               The MIME type to associate with a file extension.
#
# Notes 1: You must include the '.' in the file extension.
#       2: If more than one of the extensions match then the longest is used.
#

MIMETypes
{
 default  = text/plain

 .pdf     = application/pdf
 .eps     = application/postscript
 .ps      = application/postscript
 .rtf     = application/rtf
 .dvi     = application/x-dvi
 .latex   = application/x-latex
 .tcl     = application/x-tcl
 .tex     = application/x-tex
 .texinfo = application/x-texinfo
 .texi    = application/x-texinfo
 .tr      = application/x-troff
 .man     = application/x-troff-man
 .me      = application/x-troff-me
 .ms      = application/x-troff-ms
 .zip     = application/zip
 .cpio    = application/x-cpio
 .tar     = application/x-tar
 .Z       = application/x-compress
 .gz      = application/x-gzip
 .js      = application/x-javascript
 .au      = audio/basic
 .snd     = audio/basic
 .wav     = audio/x-wav
 .gif     = image/gif
 .jpeg    = image/jpeg
 .jpg     = image/jpeg
 .tif     = image/tiff
 .tiff    = image/tiff
 .ras     = image/x-cmu-raster
 .pnm     = image/x-portable-anymap
 .pbm     = image/x-portable-bitmap
 .pgm     = image/x-portable-graymap
 .ppm     = image/x-portable-pixmap
 .png     = image/png
 .rgb     = image/x-rgb
 .xbm     = image/x-xbitmap
 .xpm     = image/x-xpixmap
 .xwd     = image/x-xwindowdump
 .html    = text/html
 .htm     = text/html
 .txt     = text/plain
 .mpeg    = video/mpeg
 .mpg     = video/mpeg
 .mov     = video/quicktime
 .avi     = video/x-msvideo
 .pac     = application/x-ns-proxy-autoconfig
 .class   = application/java
 .wrl     = model/vrml
 .vr      = model/vrml
 .css     = text/css
 .xml     = application/xml
 .dtd     = application/xml
}


#
# Remote proxy configuration.
#
# The name and port number of machines to use as proxies.
#
# Header : Proxy
# Options: default            = <hostname[:integer]> | none |
#               The hostname (+ optionally a port number separated by a colon)
#               to use as the default proxy.
#          URL-SPECIFICATION  = <hostname[:integer]> | none |
#               The hostname (+ optionally a port number separated by a colon)
#               to use as the proxy for URLs that match URL-SPECIFICATION.
#          auth-hostname = <host[:port]>
#               A proxy server that uses proxy authentication, this is where the
#               user must enter a username and password in the browser to use
#               the proxy.
#          auth-username = <string>
#               The username to use on the above host.
#          auth-password = <string>
#               The password to use on the above host.
#          ssl           = <host[:port]>
#               A proxy server that should be used for Secure Socket Layer (SSL)
#               connections e.g. https.
#
# Notes 1: See the bottom of this file for the description of URL-SPECIFICATION.
#       2: A hostname that matches more than one entry here uses the proxy of
#          the longest matching one (protocol is included in assessing length).
#       3: Leave the hostname empty or use 'none' for no proxy.
#       4: None of the hosts in LocalNet/LocalHost will be fetched via a proxy.
#       5: The auth-hostname, auth-username and auth-password options must come
#          together as a triplet.
#       6: The auth-hostname must be exact, it is not used as a WILDCARD match.
#

Proxy
{
 http://* = none

#### Example ####
# Use www.foo.com as a default http proxy server on port 8080
# Except for the foo.com domain which has no proxy.
# http://*    = www.foo.com:8080
# *://foo.com = none
}


#
# A list of ways of recognising a URL not to display in the indexes.
#
# Header : DontIndex
# Options: outgoing = URL-SPECIFICATION
#               Do not index any URLs that match this in the outgoing index.
#          latest   = URL-SPECIFICATION
#               Do not index any URLs that match this in the
#               lasttime/prevtime/latest indexes.
#          monitor  = URL-SPECIFICATION
#               Do not index any URLs that match this in the monitor index.
#          host     = URL-SPECIFICATION
#               Do not index any URLs that match this in the host indexes.
#          URL-SPECIFICATION
#               Do not index any URLs that match this in any of the indexes.
#
# Notes 1: See the bottom of this file for the description of URL-SPECIFICATION
#

DontIndex
{

#### Example ####
# Don't index any hosts in the barfoo.com domain.
# *://*.barfoo.com/
# Don't index any gif or jpg files in the lasttime index.
# latest = *://*/*.gif
# latest = *://*/*.jpg
}


#
# Aliases specification
#
# A list of aliases that are used to replace the server name and path with
# another server name and path.  Also for servers known by two names.
#
# Header : Alias
# Options: URL-SPECIFICATION = URL-SPECIFICATION
#               Any requests for the first URL-SPECIFICATION are replaced by the
#               second URL-SPECIFICATION.
#
# Notes 1: See the bottom of this file for the description of URL-SPECIFICATION
#       2: The URL-SPECIFICATIONs must match exactly, no WILDCARDs are used and
#          the URL arguments are ignored.
#

Alias
{

#### Example ####
# The http server www.bar.com is mirrored locally at www.bar-mirror.foo.com
# http://www.bar.com/ = http://www.bar-mirror.foo.com/
# The wwwoffle homepage can be aliased
# http://wwwoffle/ = http://www.gedanken.demon.co.uk/wwwoffle/
}


#
# Purge method and maximum ages specification.
#
# The method to determine which pages to purge, the default age, the host
# specific maximum age of the pages in days, and the maximum cache size.
#
# Header : Purge
# Options: use-mtime          = yes | no
#               The decision of which pages to purge can be made on last access
#               time (atime) or last modification time (mtime) (default=no).
#          max-size           = <integer>
#               The maximum allowed size of the cache in MB after purging
#               (default=0).
#          min-free            = <integer>
#               The minimum amount of free disk space in MB after purging
#               (default=0).
#          use-url            = yes | no
#               If true then use the URL to decide on the purge age, otherwise
#               use the protocol and host only (default=no).
#          del-dontget        = yes | no
#               If true then delete the files from hosts that are in the DontGet
#               section (default=no).
#          del-dontcache      = yes | no
#               If true then delete the files from hosts that are in the
#               DontCache section (default=no).
#          default            = <integer>
#               The default maximum age for pages on hosts (default=14).
#          URL-SPECIFICATION  = <integer>
#               The maximum age for pages on hosts that match the
#               URL-SPECIFICATION.
#
# Notes 1: See the bottom of this file for the description of URL-SPECIFICATION
#       2: A hostname that matches more than one entry here uses the age of the
#          longest matching one (the protocol is counted in assessing length).
#       3: A zero age means always delete on purge, negative means never purge.
#       4: A maximum cache size of 0 means there is no limit to the size.
#       5: A minimum disk free of 0 means there is no limit to the free space.
#       6: If the max-size and min-free options are both used the smaller cache
#          size is chosen.
#       7: The max-size and min-free options take into account the hosts that
#          are never purged when measuring the cache size but do not purge them.
#       8: The URL-SPECIFICATION matches only the protocol and host unless
#          use-url is set to true.
#

Purge
{
 use-mtime     = no

 max-size      = 0
 min-free      = 0

 use-url       = no

 del-dontget   = yes
 del-dontcache = yes

 default       = 30

 default       = 28

#### Example ####
# Expire hosts in the domain foo.com at 1 week except bar.foo.com at 2 weeks.
# *://foo.com/ = 7
# *://bar.foo.com/ = 14
# Never keep anything in the domain bar.com except foo.bar.com is always kept.
# *://bar.com/ = 0
# *://foo.bar.com/ = -1
#
# Keep ftp files for 7 days and http for 14.
# ftp://* = 7
# http://* = 14
#
# Purge files to keep the cache below 10 MB
# max-size = 10
}


#
# WILDCARD
#
# A WILDCARD match is one that uses the '*' character to represent any group of
# characters.
#
# This is basically the same as the command line file matching expressions in
# DOS or the UNIX shell, except that the '*' can match the '/' character.  A
# maximum of 2 '*' characters can be used in any WILDCARD.
#
# For example
#
# *.gif      matches  foo.gif and bar.gif
# *.foo.com  matches  www.foo.com and ftp.foo.com
# /foo/*     matches  /foo/bar.html and /foo/bar/foobar.html
#

#
# URL-SPECIFICATION
#
# When specifying a host and protocol and pathname in many of the sections a
# URL-SPECIFICATION can be used, this is a way of recognising a URL.
#
# For the purposes of this explanation a URL is considered to be made up of five
# parts.
#
# proto          The protocol that is used (e.g. 'http', 'ftp')
# host           The server hostname (e.g. 'www.gedanken.demon.co.uk').
# port           The port number on the host (e.g. default of 80 for HTTP).
# path           The pathname on the host (e.g. '/bar.html') or a directory name
#                (e.g. '/foo/').
# args           Optional arguments with the URL used for CGI scripts etc.
#                (e.g. 'search=foo').
#
# For example the WWWOFFLE homepage: http://www.gedanken.demon.co.uk/wwwoffle/
# The protocol is 'http', the host is 'www.gedanken.demon.co.uk', the port is
# the default (in this case 80), and the pathname is '/wwwoffle/'.
#
# In general this is written as <proto>://<host>[:<port>]/<path>[?<args>]
#
# Where [] indicates an optional feature, and <> indicate a user supplied name
# or number.
#
# Some example URL-SPECIFICATION options are the following:
#
# *://*              Any protocol, Any host, Any port, Any path, Any args
#                    (This is that same as saying 'default').
#
# *://*/<path>       Any protocol, Any host, Any port, Named path, Any args
# 
# *://*/*.<ext>      Any protocol, Any host, Any port, Named path, Any args
# 
# *://*/*?           Any protocol, Any host, Any port, Any path, No args
# 
# *://<path>?*       Any protocol, Any host, Any port, Named path, Any args
# 
# *://<host>         Any protocol, Named host, Any port, Any path, Any args
# 
# <proto>://         Named protocol, Any host, Any port, Any path, Any args
# 
# <proto>://<host>   Named protocol, Named host, Any port, Any path, Any args
#
# <proto>://<host>:  Named protocol, Named host, Default port, Any path Any args
#
# *://<host>:<port>  Any protocol, Named host, Named port, Any path, Any args
#
# The matching of the host, the path and the args use the wildcard matching that
# is described above.
#
# 
# In some sections that accept URL-SPECIFICATIONs they can be negated by
# appending the '!' character to the start.  This will mean that the comparison
# of a URL with the URL-SPECIFICATION will return the logically opposite value
# to what would be returned without the '!'.  If all of the URL-SPECIFICATIONs
# in a section are negated and '*://*/*' is added to the end then the sense of
# the whole section is negated.
#

Reply via email to