Just regenerating to get fresh version in place of very dated versions.
[privoxy.git] / doc / webserver / user-manual / config.html
index 1e7d197..06b0042 100644 (file)
@@ -4,9 +4,10 @@
 >The Main Configuration File</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
+"><LINK
 REL="HOME"
-TITLE="Privoxy User Manual"
+TITLE="Privoxy 3.1.1 User Manual"
 HREF="index.html"><LINK
 REL="PREVIOUS"
 TITLE="Privoxy Configuration"
@@ -27,6 +28,7 @@ ALINK="#0000FF"
 ><DIV
 CLASS="NAVHEADER"
 ><TABLE
+SUMMARY="Header navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -35,7 +37,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy User Manual</TH
+>Privoxy 3.1.1 User Manual</TH
 ></TR
 ><TR
 ><TD
@@ -44,6 +46,7 @@ ALIGN="left"
 VALIGN="bottom"
 ><A
 HREF="configuration.html"
+ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -57,6 +60,7 @@ ALIGN="right"
 VALIGN="bottom"
 ><A
 HREF="actions-file.html"
+ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR
@@ -69,9 +73,7 @@ CLASS="SECT1"
 ><H1
 CLASS="SECT1"
 ><A
-NAME="CONFIG"
->7. The Main Configuration File</A
-></H1
+NAME="CONFIG">7. The Main Configuration File</H1
 ><P
 > Again, the main configuration file is named <TT
 CLASS="FILENAME"
@@ -89,9 +91,12 @@ CLASS="FILENAME"
 CLASS="LITERAL"
 >  <P
 CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;<I
+>&nbsp;&nbsp;<SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >confdir /etc/privoxy</I
+></SPAN
 ></P
 >
  </TT
@@ -131,9 +136,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="CONF-LOG-LOC"
->7.1. Configuration and Log File Locations</A
-></H2
+NAME="CONF-LOG-LOC">7.1. Configuration and Log File Locations</H2
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -146,17 +149,18 @@ CLASS="APPLICATION"
 >
  where to find those other files. </P
 ><P
-> The user running Privoxy, must have read permission for all 
- configuration files, and write permission to any files that would 
- be modified, such as log files.</P
+> The user running <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>, must have read
+ permission for all configuration files, and write permission to any files
+ that would be modified, such as log files and actions files.</P
 ><DIV
 CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="CONFDIR"
->7.1.1. confdir</A
-></H4
+NAME="CONFDIR">7.1.1. confdir</H4
 ><P
 ></P
 ><DIV
@@ -178,9 +182,12 @@ CLASS="VARIABLELIST"
 >Default value:</DT
 ><DD
 ><P
->/etc/privoxy (Unix) <I
+>/etc/privoxy (Unix) <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >or</I
+></SPAN
 > <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -190,9 +197,12 @@ CLASS="APPLICATION"
 >Effect if unset:</DT
 ><DD
 ><P
+><SPAN
+CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >Mandatory</I
+></SPAN
 ></P
 ></DD
 ><DT
@@ -232,9 +242,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="LOGDIR"
->7.1.2. logdir</A
-></H4
+NAME="LOGDIR">7.1.2. logdir</H4
 ><P
 ></P
 ><DIV
@@ -264,9 +272,12 @@ CLASS="FILENAME"
 >Default value:</DT
 ><DD
 ><P
->/var/log/privoxy (Unix) <I
+>/var/log/privoxy (Unix) <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >or</I
+></SPAN
 > <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -276,9 +287,12 @@ CLASS="APPLICATION"
 >Effect if unset:</DT
 ><DD
 ><P
+><SPAN
+CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >Mandatory</I
+></SPAN
 ></P
 ></DD
 ><DT
@@ -302,9 +316,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="ACTIONSFILE"
->7.1.3. actionsfile</A
-></H4
+NAME="ACTIONSFILE">7.1.3. actionsfile</H4
 ><A
 NAME="DEFAULT.ACTION"
 ></A
@@ -426,9 +438,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="FILTERFILE"
->7.1.4. filterfile</A
-></H4
+NAME="FILTERFILE">7.1.4. filterfile</H4
 ><A
 NAME="DEFAULT.FILTER"
 ></A
@@ -460,9 +470,12 @@ CLASS="LITERAL"
 >Default value:</DT
 ><DD
 ><P
->default.filter (Unix) <I
+>default.filter (Unix) <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >or</I
+></SPAN
 > default.filter.txt (Windows)</P
 ></DD
 ><DT
@@ -554,9 +567,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="LOGFILE"
->7.1.5. logfile</A
-></H4
+NAME="LOGFILE">7.1.5. logfile</H4
 ><P
 ></P
 ><DIV
@@ -582,9 +593,12 @@ CLASS="LITERAL"
 >Default value:</DT
 ><DD
 ><P
->logfile (Unix) <I
+>logfile (Unix) <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >or</I
+></SPAN
 > privoxy.log (Windows)</P
 ></DD
 ><DT
@@ -593,7 +607,7 @@ CLASS="EMPHASIS"
 ><P
 >    No log file is used, all log messages go to the console (<TT
 CLASS="LITERAL"
->stderr</TT
+>STDERR</TT
 >).
    </P
 ></DD
@@ -659,9 +673,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="JARFILE"
->7.1.6. jarfile</A
-></H4
+NAME="JARFILE">7.1.6. jarfile</H4
 ><P
 ></P
 ><DIV
@@ -687,9 +699,12 @@ CLASS="LITERAL"
 >Default value:</DT
 ><DD
 ><P
->jarfile (Unix) <I
+>jarfile (Unix) <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >or</I
+></SPAN
 > privoxy.jar (Windows)</P
 ></DD
 ><DT
@@ -714,9 +729,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="TRUSTFILE"
->7.1.7. trustfile</A
-></H4
+NAME="TRUSTFILE">7.1.7. trustfile</H4
 ><P
 ></P
 ><DIV
@@ -742,12 +755,18 @@ CLASS="LITERAL"
 >Default value:</DT
 ><DD
 ><P
+><SPAN
+CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >Unset (commented out)</I
->. When activated: trust (Unix) <I
+></SPAN
+>. When activated: trust (Unix) <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >or</I
+></SPAN
 > trust.txt (Windows)</P
 ></DD
 ><DT
@@ -762,9 +781,12 @@ CLASS="EMPHASIS"
 ><DD
 ><P
 >    The trust mechanism is an experimental feature for building white-lists and should
-    be used with care. It is <I
+    be used with care. It is <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >NOT</I
+></SPAN
 > recommended for the casual user.
    </P
 ><P
@@ -801,9 +823,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="LOCAL-SET-UP"
->7.2. Local Set-up Documentation</A
-></H2
+NAME="LOCAL-SET-UP">7.2. Local Set-up Documentation</H2
 ><P
 >    If you intend to operate <SPAN
 CLASS="APPLICATION"
@@ -817,9 +837,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="USER-MANUAL"
->7.2.1. user-manual</A
-></H4
+NAME="USER-MANUAL">7.2.1. user-manual</H4
 ><P
 ></P
 ><DIV
@@ -845,9 +863,12 @@ CLASS="APPLICATION"
 >Default value:</DT
 ><DD
 ><P
+><SPAN
+CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >Unset</I
+></SPAN
 ></P
 ></DD
 ><DT
@@ -899,7 +920,7 @@ WIDTH="90%"
 ><TD
 ><PRE
 CLASS="SCREEN"
->user-manual  file:///usr/share/doc/privoxy-2.9.15/user-manual/</PRE
+>user-manual  file:///usr/share/doc/privoxy-3.1.1/user-manual/</PRE
 ></TD
 ></TR
 ></TABLE
@@ -945,11 +966,14 @@ ALIGN="CENTER"
 ><TD
 ALIGN="LEFT"
 ><P
->     If set, this option should be <I
+>     If set, this option should be <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
->the first option in the config file</I
->, because
-     it is used while the config file is being read.
+>the first option in the config
+     file</I
+></SPAN
+>, because it is used while the config file is being read.
    </P
 ></TD
 ></TR
@@ -964,9 +988,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="TRUST-INFO-URL"
->7.2.2. trust-info-url</A
-></H4
+NAME="TRUST-INFO-URL">7.2.2. trust-info-url</H4
 ><P
 ></P
 ><DIV
@@ -1005,9 +1027,12 @@ CLASS="VARIABLELIST"
 >    The value of this option only matters if the experimental trust mechanism has been
     activated. (See <A
 HREF="config.html#TRUSTFILE"
+><SPAN
+CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >trustfile</I
+></SPAN
 ></A
 > above.)
    </P
@@ -1029,9 +1054,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="ADMIN-ADDRESS"
->7.2.3. admin-address</A
-></H4
+NAME="ADMIN-ADDRESS">7.2.3. admin-address</H4
 ><P
 ></P
 ><DIV
@@ -1054,9 +1077,12 @@ CLASS="VARIABLELIST"
 >Default value:</DT
 ><DD
 ><P
+><SPAN
+CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >Unset</I
+></SPAN
 ></P
 ></DD
 ><DT
@@ -1089,9 +1115,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="PROXY-INFO-URL"
->7.2.4. proxy-info-url</A
-></H4
+NAME="PROXY-INFO-URL">7.2.4. proxy-info-url</H4
 ><P
 ></P
 ><DIV
@@ -1118,9 +1142,12 @@ CLASS="APPLICATION"
 >Default value:</DT
 ><DD
 ><P
+><SPAN
+CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >Unset</I
+></SPAN
 ></P
 ></DD
 ><DT
@@ -1157,9 +1184,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="DEBUGGING"
->7.3. Debugging</A
-></H2
+NAME="DEBUGGING">7.3. Debugging</H2
 ><P
 >  These options are mainly useful when tracing a problem.
   Note that you might also want to invoke
@@ -1177,9 +1202,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="DEBUG"
->7.3.1. debug</A
-></H4
+NAME="DEBUG">7.3.1. debug</H4
 ><P
 ></P
 ><DIV
@@ -1192,9 +1215,12 @@ CLASS="VARIABLELIST"
 >    Key values that determine what information gets logged to the 
     <A
 HREF="config.html#LOGFILE"
+><SPAN
+CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >logfile</I
+></SPAN
 ></A
 >.
    </P
@@ -1239,11 +1265,12 @@ CLASS="PROGRAMLISTING"
   debug         8 # show header parsing
   debug        16 # log all data into the logfile
   debug        32 # debug force feature
-  debug        64 # debug regular expression filter 
+  debug        64 # debug regular expression filter
   debug       128 # debug fast redirects
   debug       256 # debug GIF de-animation
   debug       512 # Common Log Format
   debug      1024 # debug kill pop-ups
+  debug      2048 # CGI user interface
   debug      4096 # Startup banner and warnings.
   debug      8192 # Non-fatal errors</PRE
 ></TD
@@ -1260,9 +1287,12 @@ CLASS="LITERAL"
    </P
 ><P
 >    A debug level of 1 is informative because it will show you each request
-    as it happens. <I
+    as it happens. <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >1, 4096 and 8192 are highly recommended</I
+></SPAN
 >
     so that you will notice when things go wrong. The other levels are probably
     only of interest if you are hunting down a specific problem. They can produce
@@ -1270,9 +1300,12 @@ CLASS="EMPHASIS"
     
    </P
 ><P
->    The reporting of <I
+>    The reporting of <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >fatal</I
+></SPAN
 > errors (i.e. ones which crash 
     <SPAN
 CLASS="APPLICATION"
@@ -1284,9 +1317,12 @@ CLASS="APPLICATION"
 CLASS="QUOTE"
 >"debug
     512"</SPAN
-> <I
+> <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >ONLY</I
+></SPAN
 > and not enable anything else.
    </P
 ></DD
@@ -1298,9 +1334,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="SINGLE-THREADED"
->7.3.2. single-threaded</A
-></H4
+NAME="SINGLE-THREADED">7.3.2. single-threaded</H4
 ><P
 ></P
 ><DIV
@@ -1317,18 +1351,24 @@ CLASS="VARIABLELIST"
 >Type of value:</DT
 ><DD
 ><P
+><SPAN
+CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >None</I
+></SPAN
 ></P
 ></DD
 ><DT
 >Default value:</DT
 ><DD
 ><P
+><SPAN
+CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >Unset</I
+></SPAN
 ></P
 ></DD
 ><DT
@@ -1344,9 +1384,12 @@ CLASS="EMPHASIS"
 ><DD
 ><P
 >    This option is only there for debug purposes and you should never
-    need to use it. <I
+    need to use it. <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >It will drastically reduce performance.</I
+></SPAN
 >
    </P
 ></DD
@@ -1359,9 +1402,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="ACCESS-CONTROL"
->7.4. Access Control and Security</A
-></H2
+NAME="ACCESS-CONTROL">7.4. Access Control and Security</H2
 ><P
 >  This section of the config file controls the security-relevant aspects
   of <SPAN
@@ -1374,9 +1415,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="LISTEN-ADDRESS"
->7.4.1. listen-address</A
-></H4
+NAME="LISTEN-ADDRESS">7.4.1. listen-address</H4
 ><P
 ></P
 ><DIV
@@ -1508,9 +1547,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="TOGGLE"
->7.4.2. toggle</A
-></H4
+NAME="TOGGLE">7.4.2. toggle</H4
 ><P
 ></P
 ><DIV
@@ -1582,9 +1619,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="ENABLE-REMOTE-TOGGLE"
->7.4.3. enable-remote-toggle</A
-></H4
+NAME="ENABLE-REMOTE-TOGGLE">7.4.3. enable-remote-toggle</H4
 ><P
 ></P
 ><DIV
@@ -1633,9 +1668,12 @@ CLASS="APPLICATION"
     any URL.
    </P
 ><P
->    For the time being, access to the toggle feature can <I
+>    For the time being, access to the toggle feature can <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >not</I
+></SPAN
 > be
     controlled separately by <SPAN
 CLASS="QUOTE"
@@ -1652,9 +1690,12 @@ CLASS="QUOTE"
 CLASS="LITERAL"
 >listen-address</TT
 > above) can
-    toggle it for all users. So this option is <I
+    toggle it for all users. So this option is <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >not recommended</I
+></SPAN
 >
     for multi-user environments with untrusted users.
    </P
@@ -1674,9 +1715,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="ENABLE-EDIT-ACTIONS"
->7.4.4. enable-edit-actions</A
-></H4
+NAME="ENABLE-EDIT-ACTIONS">7.4.4. enable-edit-actions</H4
 ><P
 ></P
 ><DIV
@@ -1717,9 +1756,12 @@ TARGET="_top"
 >Notes:</DT
 ><DD
 ><P
->    For the time being, access to the editor can <I
+>    For the time being, access to the editor can <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >not</I
+></SPAN
 > be
     controlled separately by <SPAN
 CLASS="QUOTE"
@@ -1736,10 +1778,13 @@ CLASS="QUOTE"
 CLASS="LITERAL"
 >listen-address</TT
 > above) can
-    modify its configuration for all users. So this option is <I
+    modify its configuration for all users. So this option is <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >not
     recommended</I
+></SPAN
 > for multi-user environments with untrusted users.
    </P
 ><P
@@ -1758,9 +1803,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="ACLS"
->7.4.5. ACLs: permit-access and deny-access</A
-></H4
+NAME="ACLS">7.4.5. ACLs: permit-access and deny-access</H4
 ><A
 NAME="PERMIT-ACCESS"
 ></A
@@ -1839,9 +1882,12 @@ CLASS="REPLACEABLE"
 >Default value:</DT
 ><DD
 ><P
+><SPAN
+CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >Unset</I
+></SPAN
 ></P
 ></DD
 ><DT
@@ -1859,9 +1905,12 @@ CLASS="LITERAL"
 ><DD
 ><P
 >    Access controls are included at the request of ISPs and systems
-    administrators, and <I
+    administrators, and <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >are not usually needed by individual users</I
+></SPAN
 >.
     For a typical home user, it will normally suffice to ensure that 
     <SPAN
@@ -1871,9 +1920,12 @@ CLASS="APPLICATION"
     (127.0.0.1) or internal (home) network address by means of the
     <A
 HREF="config.html#LISTEN-ADDRESS"
+><SPAN
+CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >listen-address</I
+></SPAN
 ></A
 >
     option. 
@@ -1916,9 +1968,12 @@ CLASS="REPLACEABLE"
 >dst_addr</I
 ></TT
 >
-    that is examined is the address of the forwarder and <I
+    that is examined is the address of the forwarder and <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >NOT</I
+></SPAN
 > the address
     of the ultimate target. This is necessary because it may be impossible for the local
     <SPAN
@@ -1929,9 +1984,12 @@ CLASS="APPLICATION"
    </P
 ><P
 >    You should prefer using IP addresses over DNS names, because the address lookups take
-    time. All DNS names must resolve! You can <I
+    time. All DNS names must resolve! You can <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >not</I
+></SPAN
 > use domain patterns
     like <SPAN
 CLASS="QUOTE"
@@ -1962,9 +2020,12 @@ CLASS="REPLACEABLE"
 >dst_addr</I
 ></TT
 > implies that
-    <I
+    <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >all</I
+></SPAN
 > destination addresses are OK:
    </P
 ><P
@@ -2030,9 +2091,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="BUFFER-LIMIT"
->7.4.6. buffer-limit</A
-></H4
+NAME="BUFFER-LIMIT">7.4.6. buffer-limit</H4
 ><P
 ></P
 ><DIV
@@ -2095,9 +2154,12 @@ CLASS="LITERAL"
 CLASS="LITERAL"
 >buffer-limit</TT
 > Kbytes
-    <I
+    <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >each</I
+></SPAN
 >, unless you have enabled <SPAN
 CLASS="QUOTE"
 >"single-threaded"</SPAN
@@ -2114,9 +2176,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="FORWARDING"
->7.5. Forwarding</A
-></H2
+NAME="FORWARDING">7.5. Forwarding</H2
 ><P
 > This feature allows routing of HTTP requests through a chain of
  multiple proxies.
@@ -2144,9 +2204,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="FORWARD"
->7.5.1. forward</A
-></H4
+NAME="FORWARD">7.5.1. forward</H4
 ><P
 ></P
 ><DIV
@@ -2166,20 +2224,15 @@ CLASS="VARIABLELIST"
 >    <TT
 CLASS="REPLACEABLE"
 ><I
->target_domain</I
-></TT
->[:<TT
-CLASS="REPLACEABLE"
-><I
->port</I
+>target_pattern</I
 ></TT
->]
+>
     <TT
 CLASS="REPLACEABLE"
 ><I
 >http_parent</I
 ></TT
->[/<TT
+>[:<TT
 CLASS="REPLACEABLE"
 ><I
 >port</I
@@ -2187,46 +2240,55 @@ CLASS="REPLACEABLE"
 >]
    </P
 ><P
->    Where <TT
+>    where <TT
 CLASS="REPLACEABLE"
 ><I
->target_domain</I
+>target_pattern</I
 ></TT
-> is a domain name pattern (see the
-    chapter on domain matching in the <TT
-CLASS="FILENAME"
->default.action</TT
-> file),
+> is a <A
+HREF="actions-file.html#AF-PATTERNS"
+>URL pattern</A
+> 
+    that specifies to which requests (i.e. URLs) this forward rule shall apply. Use <TT
+CLASS="LITERAL"
+>/</TT
+> to
+    denote <SPAN
+CLASS="QUOTE"
+>"all URLs"</SPAN
+>.
     <TT
 CLASS="REPLACEABLE"
 ><I
 >http_parent</I
 ></TT
-> is the address of the parent HTTP proxy
-    as an IP addresses in dotted decimal notation or as a valid DNS name (or <SPAN
-CLASS="QUOTE"
->"."</SPAN
-> to denote
-    <SPAN
-CLASS="QUOTE"
->"no forwarding"</SPAN
->, and the optional 
-    <TT
+>[:<TT
 CLASS="REPLACEABLE"
 ><I
 >port</I
 ></TT
-> parameters are TCP ports, i.e. integer
-    values from 1 to 64535
+>]
+    is the DNS name or IP address of the parent HTTP proxy through which the requests should be forwarded,
+    optionally followed by its listening port (default: 8080).
+    Use a single dot (<TT
+CLASS="LITERAL"
+>.</TT
+>) to denote <SPAN
+CLASS="QUOTE"
+>"no forwarding"</SPAN
+>.
    </P
 ></DD
 ><DT
 >Default value:</DT
 ><DD
 ><P
+><SPAN
+CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >Unset</I
+></SPAN
 ></P
 ></DD
 ><DT
@@ -2270,7 +2332,7 @@ WIDTH="90%"
 ><TD
 ><PRE
 CLASS="SCREEN"
->  forward   .*     anon-proxy.example.org:8080
+>  forward        anon-proxy.example.org:8080
   forward   :443   .</PRE
 ></TD
 ></TR
@@ -2290,7 +2352,7 @@ WIDTH="90%"
 ><TD
 ><PRE
 CLASS="SCREEN"
->  forward   .*.                caching-proxy.example-isp.net:8000
+>  forward   /                  caching-proxy.example-isp.net:8000
   forward   .example-isp.net   .</PRE
 ></TD
 ></TR
@@ -2306,9 +2368,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="SOCKS"
->7.5.2. forward-socks4 and forward-socks4a</A
-></H4
+NAME="SOCKS">7.5.2. forward-socks4 and forward-socks4a</H4
 ><A
 NAME="FORWARD-SOCKS4"
 ></A
@@ -2334,20 +2394,15 @@ CLASS="VARIABLELIST"
 >    <TT
 CLASS="REPLACEABLE"
 ><I
->target_domain</I
-></TT
->[:<TT
-CLASS="REPLACEABLE"
-><I
->port</I
+>target_pattern</I
 ></TT
->]
+>
     <TT
 CLASS="REPLACEABLE"
 ><I
 >socks_proxy</I
 ></TT
->[/<TT
+>[:<TT
 CLASS="REPLACEABLE"
 ><I
 >port</I
@@ -2358,7 +2413,7 @@ CLASS="REPLACEABLE"
 ><I
 >http_parent</I
 ></TT
->[/<TT
+>[:<TT
 CLASS="REPLACEABLE"
 ><I
 >port</I
@@ -2366,16 +2421,23 @@ CLASS="REPLACEABLE"
 >]
    </P
 ><P
->    Where <TT
+>    where <TT
 CLASS="REPLACEABLE"
 ><I
->target_domain</I
+>target_pattern</I
 ></TT
-> is a domain name pattern (see the
-    chapter on domain matching in the <TT
-CLASS="FILENAME"
->default.action</TT
-> file),
+> is a <A
+HREF="actions-file.html#AF-PATTERNS"
+>URL pattern</A
+> 
+    that specifies to which requests (i.e. URLs) this forward rule shall apply. Use <TT
+CLASS="LITERAL"
+>/</TT
+> to
+    denote <SPAN
+CLASS="QUOTE"
+>"all URLs"</SPAN
+>.
     <TT
 CLASS="REPLACEABLE"
 ><I
@@ -2412,9 +2474,12 @@ CLASS="REPLACEABLE"
 >Default value:</DT
 ><DD
 ><P
+><SPAN
+CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >Unset</I
+></SPAN
 ></P
 ></DD
 ><DT
@@ -2476,7 +2541,7 @@ WIDTH="90%"
 ><TD
 ><PRE
 CLASS="SCREEN"
->  forward-socks4a   .*.            socks-gw.example.com:1080  www-cache.example-isp.net:8080
+>  forward-socks4a   /              socks-gw.example.com:1080  www-cache.example-isp.net:8080
   forward           .example.com   .</PRE
 ></TD
 ></TR
@@ -2495,7 +2560,7 @@ WIDTH="90%"
 ><TD
 ><PRE
 CLASS="SCREEN"
->  forward-socks4   .*.            socks-gw.example.com:1080  .</PRE
+>  forward-socks4   /               socks-gw.example.com:1080  .</PRE
 ></TD
 ></TR
 ></TABLE
@@ -2510,9 +2575,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="ADVANCED-FORWARDING-EXAMPLES"
->7.5.3. Advanced Forwarding Examples</A
-></H4
+NAME="ADVANCED-FORWARDING-EXAMPLES">7.5.3. Advanced Forwarding Examples</H4
 ><P
 > If you have links to multiple ISPs that provide various special content 
  only to their subscribers, you can configure multiple <SPAN
@@ -2520,9 +2583,12 @@ CLASS="APPLICATION"
 >Privoxies</SPAN
 >
  which have connections to the respective ISPs to act as forwarders to each other, so that
- <I
+ <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >your</I
+></SPAN
 > users can see the internal content of all ISPs.</P
 ><P
 > Assume that host-a has a PPP connection to isp-a.net. And host-b has a PPP connection to
@@ -2542,7 +2608,7 @@ WIDTH="100%"
 ><TD
 ><PRE
 CLASS="SCREEN"
->  forward    .*.         .
+>  forward    /           .
   forward    .isp-b.net  host-b:8118</PRE
 ></TD
 ></TR
@@ -2559,7 +2625,7 @@ WIDTH="100%"
 ><TD
 ><PRE
 CLASS="SCREEN"
->  forward    .*.         .
+>  forward    /           .
   forward    .isp-a.net  host-a:8118</PRE
 ></TD
 ></TR
@@ -2590,7 +2656,10 @@ CLASS="APPLICATION"
 CLASS="APPLICATION"
 >squid</SPAN
 >
- run on the same box, your squid configuration could then look like this:</P
+ run on the same box, your <SPAN
+CLASS="APPLICATION"
+>squid</SPAN
+> configuration could then look like this:</P
 ><P
 > <TABLE
 BORDER="0"
@@ -2627,6 +2696,27 @@ CLASS="LITERAL"
 CLASS="FILENAME"
 >squid.conf</TT
 >.</P
+><P
+> You could just as well decide to only forward requests for Windows executables through
+ a virus-scanning parent proxy, say, on <TT
+CLASS="LITERAL"
+>antivir.example.com</TT
+>, port 8010:</P
+><P
+> <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>  forward   /                          .
+  forward   /.*\.(exe|com|dll|zip)$    antivir.example.com:8010</PRE
+></TD
+></TR
+></TABLE
+> </P
 ></DIV
 ></DIV
 ><DIV
@@ -2634,9 +2724,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="WINDOWS-GUI"
->7.6. Windows GUI Options</A
-></H2
+NAME="WINDOWS-GUI">7.6. Windows GUI Options</H2
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -2664,9 +2752,12 @@ CLASS="QUOTE"
 CLASS="LITERAL"
 >  <P
 CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;<I
+>&nbsp;&nbsp;<SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >activity-animation   1</I
+></SPAN
 ><br>
 &nbsp;&nbsp;&nbsp;</P
 > 
@@ -2690,9 +2781,12 @@ CLASS="APPLICATION"
 CLASS="LITERAL"
 >  <P
 CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;<I
+>&nbsp;&nbsp;<SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >log-messages       1</I
+></SPAN
 ><br>
 &nbsp;&nbsp;&nbsp;</P
 > 
@@ -2720,9 +2814,12 @@ CLASS="QUOTE"
 CLASS="LITERAL"
 >  <P
 CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;<I
+>&nbsp;&nbsp;<SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >log-buffer-size      1</I
+></SPAN
 ><br>
 &nbsp;&nbsp;&nbsp;</P
 > 
@@ -2742,9 +2839,12 @@ CLASS="APPLICATION"
 CLASS="LITERAL"
 >  <P
 CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;<I
+>&nbsp;&nbsp;<SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >log-max-lines      200</I
+></SPAN
 ><br>
 &nbsp;&nbsp;&nbsp;</P
 > 
@@ -2768,9 +2868,12 @@ CLASS="APPLICATION"
 CLASS="LITERAL"
 >  <P
 CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;<I
+>&nbsp;&nbsp;<SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >log-highlight-messages   1</I
+></SPAN
 ><br>
 &nbsp;&nbsp;&nbsp;</P
 > 
@@ -2786,9 +2889,12 @@ NAME="LOG-FONT-NAME"
 CLASS="LITERAL"
 >  <P
 CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;<I
+>&nbsp;&nbsp;<SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >log-font-name        Comic Sans MS</I
+></SPAN
 ><br>
 &nbsp;&nbsp;&nbsp;</P
 > 
@@ -2804,9 +2910,12 @@ NAME="LOG-FONT-SIZE"
 CLASS="LITERAL"
 >  <P
 CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;<I
+>&nbsp;&nbsp;<SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >log-font-size        8</I
+></SPAN
 ><br>
 &nbsp;&nbsp;&nbsp;</P
 > 
@@ -2831,9 +2940,12 @@ CLASS="APPLICATION"
 CLASS="LITERAL"
 >  <P
 CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;<I
+>&nbsp;&nbsp;<SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >show-on-task-bar     0</I
+></SPAN
 ><br>
 &nbsp;&nbsp;&nbsp;</P
 > 
@@ -2857,9 +2969,12 @@ CLASS="APPLICATION"
 CLASS="LITERAL"
 >  <P
 CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;<I
+>&nbsp;&nbsp;<SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >close-button-minimizes  1</I
+></SPAN
 ><br>
 &nbsp;&nbsp;&nbsp;</P
 > 
@@ -2887,9 +3002,12 @@ CLASS="APPLICATION"
 CLASS="LITERAL"
 >  <P
 CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;#<I
+>&nbsp;&nbsp;#<SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >hide-console</I
+></SPAN
 ><br>
 &nbsp;&nbsp;&nbsp;</P
 > 
@@ -2902,6 +3020,7 @@ CLASS="NAVFOOTER"
 ><HR
 ALIGN="LEFT"
 WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -2913,6 +3032,7 @@ ALIGN="left"
 VALIGN="top"
 ><A
 HREF="configuration.html"
+ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -2921,6 +3041,7 @@ ALIGN="center"
 VALIGN="top"
 ><A
 HREF="index.html"
+ACCESSKEY="H"
 >Home</A
 ></TD
 ><TD
@@ -2929,6 +3050,7 @@ ALIGN="right"
 VALIGN="top"
 ><A
 HREF="actions-file.html"
+ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR