Rebuild to catch up with recent changes.
[privoxy.git] / doc / webserver / user-manual / config.html
index 05f183a..b34f636 100644 (file)
@@ -1,11 +1,11 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
 <HTML
 ><HEAD
 ><TITLE
 >The Main Configuration File</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
 REL="HOME"
 TITLE="Privoxy 3.0.7 User Manual"
 HREF="index.html"><LINK
@@ -76,8 +76,8 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="CONFIG"
-></A
->7. The Main Configuration File</H1
+>7. The Main Configuration File</A
+></H1
 ><P
 > Again, the main configuration file is named <TT
 CLASS="FILENAME"
@@ -141,8 +141,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="LOCAL-SET-UP"
-></A
->7.1. Local Set-up Documentation</H2
+>7.1. Local Set-up Documentation</A
+></H2
 ><P
 >    If you intend to operate <SPAN
 CLASS="APPLICATION"
@@ -157,8 +157,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="USER-MANUAL"
-></A
->7.1.1. user-manual</H4
+>7.1.1. user-manual</A
+></H4
 ><P
 ></P
 ><DIV
@@ -260,8 +260,12 @@ CLASS="SCREEN"
 >
   </P
 ><P
->   The User Manual is then available to anyone with access to the proxy, by 
-   following the built-in URL: <TT
+>   The User Manual is then available to anyone with access to
+   <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>, by following the built-in URL:
+   <TT
 CLASS="LITERAL"
 >http://config.privoxy.org/user-manual/</TT
 >
@@ -332,8 +336,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="TRUST-INFO-URL"
-></A
->7.1.2. trust-info-url</H4
+>7.1.2. trust-info-url</A
+></H4
 ><P
 ></P
 ><DIV
@@ -356,7 +360,7 @@ CLASS="VARIABLELIST"
 >Default value:</DT
 ><DD
 ><P
->Two example URL are provided</P
+>Two example URLs are provided</P
 ></DD
 ><DT
 >Effect if unset:</DT
@@ -379,7 +383,7 @@ CLASS="EMPHASIS"
 >trustfile</I
 ></SPAN
 ></A
-> above.)
+> below.)
    </P
 ><P
 >    If you use the trust mechanism, it is a good idea to write up some on-line
@@ -400,8 +404,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ADMIN-ADDRESS"
-></A
->7.1.3. admin-address</H4
+>7.1.3. admin-address</A
+></H4
 ><P
 ></P
 ><DIV
@@ -411,7 +415,10 @@ CLASS="VARIABLELIST"
 >Specifies:</DT
 ><DD
 ><P
->    An email address to reach the proxy administrator.
+>    An email address to reach the <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> administrator.
    </P
 ></DD
 ><DT
@@ -463,8 +470,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="PROXY-INFO-URL"
-></A
->7.1.4. proxy-info-url</H4
+>7.1.4. proxy-info-url</A
+></H4
 ><P
 ></P
 ><DIV
@@ -534,8 +541,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONF-LOG-LOC"
-></A
->7.2. Configuration and Log File Locations</H2
+>7.2. Configuration and Log File Locations</A
+></H2
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -560,8 +567,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="CONFDIR"
-></A
->7.2.1. confdir</H4
+>7.2.1. confdir</A
+></H4
 ><P
 ></P
 ><DIV
@@ -571,7 +578,7 @@ CLASS="VARIABLELIST"
 >Specifies:</DT
 ><DD
 ><P
->The directory where the other configuration files are located</P
+>The directory where the other configuration files are located.</P
 ></DD
 ><DT
 >Type of value:</DT
@@ -616,7 +623,7 @@ CLASS="QUOTE"
 CLASS="LITERAL"
 >/</TT
 >"</SPAN
->, please
+>, please.
    </P
 ></DD
 ></DL
@@ -628,8 +635,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="TEMPLDIR"
-></A
->7.2.2. templdir</H4
+>7.2.2. templdir</A
+></H4
 ><P
 ></P
 ><DIV
@@ -639,7 +646,7 @@ CLASS="VARIABLELIST"
 >Specifies:</DT
 ><DD
 ><P
->An alternative directory where the templates are loaded from</P
+>An alternative directory where the templates are loaded from.</P
 ></DD
 ><DT
 >Type of value:</DT
@@ -663,10 +670,18 @@ CLASS="VARIABLELIST"
 >Notes:</DT
 ><DD
 ><P
->    Privoxy's original templates are usually overwritten
-    with each update. Use this option to relocate customized templates
-    that should be kept. Note that you might be missing new features
-    if you use outdated templates.
+>    <SPAN
+CLASS="APPLICATION"
+>Privoxy's</SPAN
+> original templates are usually
+    overwritten with each update. Use this option to relocate customized
+    templates that should be kept. As template variables might change
+    between updates, you shouldn't expect templates to work with
+    <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> releases other than the one
+    they were part of, though.
    </P
 ></DD
 ></DL
@@ -678,8 +693,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="LOGDIR"
-></A
->7.2.3. logdir</H4
+>7.2.3. logdir</A
+></H4
 ><P
 ></P
 ><DIV
@@ -689,14 +704,15 @@ CLASS="VARIABLELIST"
 >Specifies:</DT
 ><DD
 ><P
->    The directory where all logging takes place (i.e. where <TT
+>    The directory where all logging takes place
+    (i.e. where <TT
 CLASS="FILENAME"
 >logfile</TT
-> and 
+> and
     <TT
 CLASS="FILENAME"
 >jarfile</TT
-> are located) 
+> are located).
    </P
 ></DD
 ><DT
@@ -742,7 +758,7 @@ CLASS="QUOTE"
 CLASS="LITERAL"
 >/</TT
 >"</SPAN
->, please
+>, please.
    </P
 ></DD
 ></DL
@@ -754,8 +770,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ACTIONSFILE"
-></A
->7.2.4. actionsfile</H4
+>7.2.4. actionsfile</A
+></H4
 ><A
 NAME="DEFAULT.ACTION"
 ></A
@@ -844,9 +860,15 @@ CLASS="LITERAL"
    </P
 ><P
 > 
-    The default values include standard.action, which is used for internal
-    purposes and should be loaded, default.action, which is the
-    <SPAN
+    The default values include <TT
+CLASS="FILENAME"
+>standard.action</TT
+>, which is used
+    for internal purposes and should be loaded, <TT
+CLASS="FILENAME"
+>default.action</TT
+>,
+    which is the <SPAN
 CLASS="QUOTE"
 >"main"</SPAN
 > actions file maintained by the developers, and
@@ -857,7 +879,7 @@ CLASS="FILENAME"
    </P
 ><P
 > 
-    Actions files are where all the per site and per URL configuration is done for 
+    Actions files contain all the per site and per URL configuration for 
     ad blocking, cookie management, privacy considerations, etc.
     There is no point in using <SPAN
 CLASS="APPLICATION"
@@ -883,8 +905,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="FILTERFILE"
-></A
->7.2.5. filterfile</H4
+>7.2.5. filterfile</A
+></H4
 ><A
 NAME="DEFAULT.FILTER"
 ></A
@@ -963,7 +985,7 @@ HREF="appendix.html#REGEX"
 >regular expressions</A
 >. These rules permit
     powerful changes on the content of Web pages, and optionally the headers
-    as well, e.g., you could disable your favorite JavaScript annoyances,
+    as well, e.g., you could try to disable your favorite JavaScript annoyances,
     re-write the actual displayed text, or just have some fun 
     playing buzzword bingo with web pages.
    </P
@@ -1021,8 +1043,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="LOGFILE"
-></A
->7.2.6. logfile</H4
+>7.2.6. logfile</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1048,22 +1070,28 @@ CLASS="LITERAL"
 >Default value:</DT
 ><DD
 ><P
->logfile (Unix) <SPAN
+><SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Unset (commented out)</I
+></SPAN
+>. When activated: logfile (Unix) <SPAN
 CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >or</I
 ></SPAN
-> privoxy.log (Windows)</P
+> privoxy.log (Windows).</P
 ></DD
 ><DT
 >Effect if unset:</DT
 ><DD
 ><P
->    No log file is used, all log messages go to the console (<TT
+>    Logging is disabled unless <TT
 CLASS="LITERAL"
->STDERR</TT
->).
+>--no-daemon</TT
+> mode is used.
    </P
 ></DD
 ><DT
@@ -1080,7 +1108,22 @@ CLASS="LITERAL"
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > (e.g., it's not blocking an ad you
-    think it should block) but in most cases you probably will never look at it.
+    think it should block) and it can help you to monitor what your browser
+    is doing.
+   </P
+><P
+>    Many users will never look at it, however, and it's a privacy risk
+    if third parties can get access to it. It is therefore disabled by
+    default in <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> 3.0.7 and later.
+  </P
+><P
+>    For troubleshooting purposes, you will have to explicitly enable it.
+    Please don't file any support requests without trying to reproduce
+    the problem with logging enabled first. Once you read the log messages,
+    you may even be able to solve the problem on your own.
    </P
 ><P
 >    Your logfile will grow indefinitely, and you will probably want to
@@ -1088,30 +1131,18 @@ CLASS="APPLICATION"
     (see <SPAN
 CLASS="QUOTE"
 >"man cron"</SPAN
->). For Red Hat, a <B
+>). For Red Hat based Linux distributions, a
+    <B
 CLASS="COMMAND"
 >logrotate</B
-> 
-    script has been included.
-   </P
-><P
->    On SuSE Linux systems, you can place a line like <SPAN
-CLASS="QUOTE"
->"/var/log/privoxy.*
-    +1024k 644 nobody.nogroup"</SPAN
-> in <TT
-CLASS="FILENAME"
->/etc/logfiles</TT
->, with
-    the effect that cron.daily will automatically archive, gzip, and empty the
-    log, when it exceeds 1M size.
+> script has been included.
    </P
 ><P
 >    Any log files must be writable by whatever user <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 >
-    is being run as (default on UNIX, user id is <SPAN
+    is being run as (on Unix, default user id is <SPAN
 CLASS="QUOTE"
 >"privoxy"</SPAN
 >).
@@ -1126,8 +1157,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="JARFILE"
-></A
->7.2.7. jarfile</H4
+>7.2.7. jarfile</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1153,13 +1184,19 @@ CLASS="LITERAL"
 >Default value:</DT
 ><DD
 ><P
->Unset (commented out). When activated: jarfile (Unix) <SPAN
+><SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Unset (commented out)</I
+></SPAN
+>. When activated: jarfile (Unix) <SPAN
 CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >or</I
 ></SPAN
-> privoxy.jar (Windows)</P
+> privoxy.jar (Windows).</P
 ></DD
 ><DT
 >Effect if unset:</DT
@@ -1176,7 +1213,10 @@ CLASS="EMPHASIS"
    </P
 ><P
 >    If debug 8 (show header parsing) is enabled, cookies are
-    written to the logfile with the rest of the headers.
+    also written to the logfile with the rest of the headers.
+    Therefore this option isn't very useful and may be removed
+    in future releases. Please report to the developers if you
+    are still using it.
    </P
 ></DD
 ></DL
@@ -1188,8 +1228,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="TRUSTFILE"
-></A
->7.2.8. trustfile</H4
+>7.2.8. trustfile</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1337,8 +1377,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="DEBUGGING"
-></A
->7.3. Debugging</H2
+>7.3. Debugging</A
+></H2
 ><P
 >  These options are mainly useful when tracing a problem.
   Note that you might also want to invoke
@@ -1357,8 +1397,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="DEBUG"
-></A
->7.3.1. debug</H4
+>7.3.1. debug</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1456,19 +1496,6 @@ CLASS="EMPHASIS"
     
    </P
 ><P
->    The reporting of <SPAN
-CLASS="emphasis"
-><I
-CLASS="EMPHASIS"
->fatal</I
-></SPAN
-> errors (i.e. ones which causes 
-    <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> to exit) is always on and cannot be disabled.
-   </P
-><P
 >    If you want to use CLF (Common Log Format), you should set <SPAN
 CLASS="QUOTE"
 >"debug
@@ -1502,8 +1529,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="SINGLE-THREADED"
-></A
->7.3.2. single-threaded</H4
+>7.3.2. single-threaded</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1513,7 +1540,7 @@ CLASS="VARIABLELIST"
 >Specifies:</DT
 ><DD
 ><P
->    Whether to run only one server thread
+>    Whether to run only one server thread.
    </P
 ></DD
 ><DT
@@ -1552,8 +1579,8 @@ CLASS="EMPHASIS"
 >Notes:</DT
 ><DD
 ><P
->    This option is only there for debug purposes and you should never
-    need to use it. <SPAN
+>    This option is only there for debugging purposes.
+    <SPAN
 CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
@@ -1572,8 +1599,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="ACCESS-CONTROL"
-></A
->7.4. Access Control and Security</H2
+>7.4. Access Control and Security</A
+></H2
 ><P
 >  This section of the config file controls the security-relevant aspects
   of <SPAN
@@ -1587,8 +1614,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="LISTEN-ADDRESS"
-></A
->7.4.1. listen-address</H4
+>7.4.1. listen-address</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1667,7 +1694,7 @@ HREF="config.html#ACLS"
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > to untrusted users, you will
-    also want to turn off the <TT
+    also want to make sure that the following actions are disabled:  <TT
 CLASS="LITERAL"
 ><A
 HREF="config.html#ENABLE-EDIT-ACTIONS"
@@ -1681,7 +1708,6 @@ HREF="config.html#ENABLE-REMOTE-TOGGLE"
 >enable-remote-toggle</A
 ></TT
 >
-    options!
    </P
 ></DD
 ><DT
@@ -1721,8 +1747,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="TOGGLE"
-></A
->7.4.2. toggle</H4
+>7.4.2. toggle</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1766,20 +1792,11 @@ CLASS="APPLICATION"
 CLASS="QUOTE"
 >"toggled off"</SPAN
 > mode, i.e. mostly behave like a normal,
-    content-neutral proxy where all ad blocking, filtering, etc are disabled. See
-    <TT
+    content-neutral proxy with both ad blocking and content filtering
+    disabled. See <TT
 CLASS="LITERAL"
 >enable-remote-toggle</TT
-> below. This is not really useful
-    anymore, since toggling is much easier via <A
-HREF="http://config.privoxy.org/toggle"
-TARGET="_top"
->the web interface</A
-> than via
-    editing the <TT
-CLASS="FILENAME"
->conf</TT
-> file.
+> below.
    </P
 ><P
 >    The windows version will only display the toggle icon in the system tray
@@ -1795,8 +1812,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ENABLE-REMOTE-TOGGLE"
-></A
->7.4.3. enable-remote-toggle</H4
+>7.4.3. enable-remote-toggle</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1824,7 +1841,7 @@ TARGET="_top"
 >Default value:</DT
 ><DD
 ><P
->1</P
+>0</P
 ></DD
 ><DT
 >Effect if unset:</DT
@@ -1841,11 +1858,10 @@ TARGET="_top"
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > mostly acts like a normal,
-    content-neutral proxy, i.e. it acts as if none of the actions applied to
-    any URL.
+    content-neutral proxy, i.e. doesn't block ads or filter content.
    </P
 ><P
->    For the time being, access to the toggle feature can <SPAN
+>    Access to the toggle feature can <SPAN
 CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
@@ -1877,6 +1893,17 @@ CLASS="EMPHASIS"
     for multi-user environments with untrusted users.
    </P
 ><P
+>    Note that malicious client side code (e.g Java) is also
+    capable of using this option.
+   </P
+><P
+>    As a lot of <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> users don't read
+    documentation, this feature is disabled by default.
+   </P
+><P
 >    Note that you must have compiled <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -1893,8 +1920,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ENABLE-REMOTE-HTTP-TOGGLE"
-></A
->7.4.4. enable-remote-http-toggle</H4
+>7.4.4. enable-remote-http-toggle</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1917,7 +1944,7 @@ CLASS="VARIABLELIST"
 >Default value:</DT
 ><DD
 ><P
->1</P
+>0</P
 ></DD
 ><DT
 >Effect if unset:</DT
@@ -1942,13 +1969,17 @@ CLASS="QUOTE"
     the ongoing request, even if it is enabled in one of the action files.
    </P
 ><P
->    If you are using <SPAN
+>    This feature is disabled by default. If you are using
+    <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> in a
-    multi-user environment or with untrustworthy clients and want to
-    enforce filtering, you will have to disable this option,
-    otherwise you can ignore it. 
+> in a environment with trusted clients,
+    you may enable this feature at your discretion. Note that malicious client
+    side code (e.g Java) is also capable of using this feature.
+   </P
+><P
+>    This option will be removed in future releases as it has been obsoleted
+    by the more general header taggers.
    </P
 ></DD
 ></DL
@@ -1960,8 +1991,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ENABLE-EDIT-ACTIONS"
-></A
->7.4.5. enable-edit-actions</H4
+>7.4.5. enable-edit-actions</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1989,7 +2020,7 @@ TARGET="_top"
 >Default value:</DT
 ><DD
 ><P
->1</P
+>0</P
 ></DD
 ><DT
 >Effect if unset:</DT
@@ -2002,7 +2033,7 @@ TARGET="_top"
 >Notes:</DT
 ><DD
 ><P
->    For the time being, access to the editor can <SPAN
+>    Access to the editor can <SPAN
 CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
@@ -2024,14 +2055,27 @@ CLASS="QUOTE"
 CLASS="LITERAL"
 >listen-address</TT
 > above) can
-    modify its configuration for all users. So this option is <SPAN
+    modify its configuration for all users.
+   </P
+><P
+>    This option is <SPAN
 CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
->not
-    recommended</I
+>not recommended</I
 ></SPAN
-> for multi-user environments with untrusted users.
+> for environments
+    with untrusted users and as a lot of <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>
+    users don't read documentation, this feature is disabled by default.
+   </P
+><P
+>    Note that malicious client side code (e.g Java) is also
+    capable of using the actions editor and you shouldn't enable
+    this options unless you understand the consequences and are
+    sure your browser is configured correctly.
    </P
 ><P
 >    Note that you must have compiled <SPAN
@@ -2050,8 +2094,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ENFORCE-BLOCKS"
-></A
->7.4.6. enforce-blocks</H4
+>7.4.6. enforce-blocks</A
+></H4
 ><P
 ></P
 ><DIV
@@ -2175,8 +2219,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ACLS"
-></A
->7.4.7. ACLs: permit-access and deny-access</H4
+>7.4.7. ACLs: permit-access and deny-access</A
+></H4
 ><A
 NAME="PERMIT-ACCESS"
 ></A
@@ -2304,9 +2348,12 @@ CLASS="EMPHASIS"
     option. 
    </P
 ><P
->    Please see the warnings in the FAQ that this proxy is not intended to be a substitute
-    for a firewall or to encourage anyone to defer addressing basic security
-    weaknesses.
+>    Please see the warnings in the FAQ that <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>
+    is not intended to be a substitute for a firewall or to encourage anyone
+    to defer addressing basic security weaknesses.
    </P
 ><P
 >    Multiple ACL lines are OK.
@@ -2467,8 +2514,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="BUFFER-LIMIT"
-></A
->7.4.8. buffer-limit</H4
+>7.4.8. buffer-limit</A
+></H4
 ><P
 ></P
 ><DIV
@@ -2554,8 +2601,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="FORWARDING"
-></A
->7.5. Forwarding</H2
+>7.5. Forwarding</A
+></H2
 ><P
 > This feature allows routing of HTTP requests through a chain of
  multiple proxies.</P
@@ -2589,8 +2636,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="FORWARD"
-></A
->7.5.1. forward</H4
+>7.5.1. forward</A
+></H4
 ><P
 ></P
 ><DIV
@@ -2738,8 +2785,8 @@ WIDTH="90%"
 ><TD
 ><PRE
 CLASS="SCREEN"
->  forward   /                  caching-proxy.example-isp.net:8000
-  forward   .example-isp.net   .</PRE
+>  forward   /                  caching-proxy.isp.example.net:8000
+  forward   .isp.example.net   .</PRE
 ></TD
 ></TR
 ></TABLE
@@ -2755,8 +2802,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="SOCKS"
-></A
->7.5.2. forward-socks4 and forward-socks4a</H4
+>7.5.2. forward-socks4 and forward-socks4a</A
+></H4
 ><A
 NAME="FORWARD-SOCKS4"
 ></A
@@ -2929,7 +2976,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.isp.example.net:8080
   forward           .example.com   .</PRE
 ></TD
 ></TR
@@ -2955,8 +3002,8 @@ CLASS="SCREEN"
 >
    </P
 ><P
->    To chain Privoxy and Tor, both running on the same system, you should use 
-    the rule:
+>    To chain Privoxy and Tor, both running on the same system, you would use 
+    something like:
    </P
 ><P
 >    <TABLE
@@ -2967,7 +3014,7 @@ WIDTH="90%"
 ><TD
 ><PRE
 CLASS="SCREEN"
->  forward-socks4   /               127.0.0.1:9050 .</PRE
+>  forward-socks4a   /               127.0.0.1:9050 .</PRE
 ></TD
 ></TR
 ></TABLE
@@ -2977,8 +3024,9 @@ CLASS="SCREEN"
 >    The public <SPAN
 CLASS="APPLICATION"
 >Tor</SPAN
-> network can't be used to reach your local network,
-    therefore it's a good idea to make some exceptions:
+> network can't be used to
+    reach your local network, if you need to access local servers you
+    therefore might want to make some exceptions:
    </P
 ><P
 >    <TABLE
@@ -3000,7 +3048,12 @@ CLASS="SCREEN"
 ><P
 >    Unencrypted connections to systems in these address ranges will
     be as (un)secure as the local network is, but the alternative is that you
-    can't reach the network at all.
+    can't reach the local network through <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>
+    at all. Of course this may actually be desired and there is no reason
+    to make these exceptions if you aren't sure you need them.
    </P
 ><P
 >    If you also want to be able to reach servers in your local network by
@@ -3032,8 +3085,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ADVANCED-FORWARDING-EXAMPLES"
-></A
->7.5.3. Advanced Forwarding Examples</H4
+>7.5.3. Advanced Forwarding Examples</A
+></H4
 ><P
 > If you have links to multiple ISPs that provide various special content 
  only to their subscribers, you can configure multiple <SPAN
@@ -3049,8 +3102,8 @@ CLASS="EMPHASIS"
 ></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
- isp-b.net. Both run <SPAN
+> Assume that host-a has a PPP connection to isp-a.example.net. And host-b has a PPP connection to
+ isp-b.example.org. Both run <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 >. Their forwarding
@@ -3067,7 +3120,7 @@ WIDTH="100%"
 ><PRE
 CLASS="SCREEN"
 >  forward    /           .
-  forward    .isp-b.net  host-b:8118</PRE
+  forward    .isp-b.example.net  host-b:8118</PRE
 ></TD
 ></TR
 ></TABLE
@@ -3084,7 +3137,7 @@ WIDTH="100%"
 ><PRE
 CLASS="SCREEN"
 >  forward    /           .
-  forward    .isp-a.net  host-a:8118</PRE
+  forward    .isp-a.example.org  host-a:8118</PRE
 ></TD
 ></TR
 ></TABLE
@@ -3101,7 +3154,7 @@ CLASS="APPLICATION"
  <SPAN
 CLASS="APPLICATION"
 >squid</SPAN
-> locally, then chain as 
+> locally, then chaining as 
  <TT
 CLASS="LITERAL"
 >browser -&#62; squid -&#62; privoxy</TT
@@ -3155,8 +3208,9 @@ 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
+> You could just as well decide to only forward requests you suspect
+ of leading to Windows executables through a virus-scanning parent proxy,
+ say, on <TT
 CLASS="LITERAL"
 >antivir.example.com</TT
 >, port 8010:</P
@@ -3182,8 +3236,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="FORWARDED-CONNECT-RETRIES"
-></A
->7.5.4. forwarded-connect-retries</H4
+>7.5.4. forwarded-connect-retries</A
+></H4
 ><P
 ></P
 ><DIV
@@ -3253,7 +3307,7 @@ CLASS="QUOTE"
     that Privoxy forwards through other proxies. This option is not limited to the HTTP CONNECT method.
    </P
 ><P
->    Only use this option, if you are getting many forwarding related error messages,
+>    Only use this option, if you are getting lots of forwarding-related error messages
     that go away when you try again manually. Start with a small value and check Privoxy's
     logfile from time to time, to see how many retries are usually needed.
    </P
@@ -3274,8 +3328,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ACCEPT-INTERCEPTED-REQUESTS"
-></A
->7.5.5. accept-intercepted-requests</H4
+>7.5.5. accept-intercepted-requests</A
+></H4
 ><P
 ></P
 ><DIV
@@ -3367,9 +3421,92 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
+NAME="ALLOW-CGI-REQUEST-CRUNCHING"
+>7.5.6. allow-cgi-request-crunching</A
+></H4
+><P
+></P
+><DIV
+CLASS="VARIABLELIST"
+><DL
+><DT
+>Specifies:</DT
+><DD
+><P
+>    Whether requests to <SPAN
+CLASS="APPLICATION"
+>Privoxy's</SPAN
+> CGI pages can be blocked or redirected.
+   </P
+></DD
+><DT
+>Type of value:</DT
+><DD
+><P
+>    <TT
+CLASS="REPLACEABLE"
+><I
+>0 or 1</I
+></TT
+>
+   </P
+></DD
+><DT
+>Default value:</DT
+><DD
+><P
+><SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>0</I
+></SPAN
+></P
+></DD
+><DT
+>Effect if unset:</DT
+><DD
+><P
+>    <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> ignores block and redirect actions for its CGI pages.
+   </P
+></DD
+><DT
+>Notes:</DT
+><DD
+><P
+>    By default <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> ignores block or redirect actions
+    for its CGI pages. Intercepting these requests can be useful in multi-user
+    setups to implement fine-grained access control, but it can also render the complete
+    web interface useless and make debugging problems painful if done without care.
+   </P
+><P
+>    Don't enable this option unless you're sure that you really need it.
+   </P
+></DD
+><DT
+>Examples:</DT
+><DD
+><P
+>    allow-cgi-request-crunching 1
+   </P
+></DD
+></DL
+></DIV
+></DIV
+><DIV
+CLASS="SECT3"
+><H4
+CLASS="SECT3"
+><A
 NAME="SPLIT-LARGE-FORMS"
-></A
->7.5.6. split-large-forms</H4
+>7.5.7. split-large-forms</A
+></H4
 ><P
 ></P
 ><DIV
@@ -3423,14 +3560,14 @@ CLASS="APPLICATION"
 > CGI forms can lead to
     rather long URLs. This isn't a problem as far as the HTTP
     standard is concerned, but it can confuse clients with arbitrary
-    URL lenght limitations.
+    URL length limitations.
    </P
 ><P
 >    Enabling split-large-forms causes <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 >
-    to devide big forms into smaller ones to keep the URL length down.
+    to divide big forms into smaller ones to keep the URL length down.
     It makes editing a lot less convenient and you can no longer
     submit all changes at once, but at least it works around this
     browser bug.
@@ -3458,8 +3595,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="WINDOWS-GUI"
-></A
->7.6. Windows GUI Options</H2
+>7.6. Windows GUI Options</A
+></H2
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -3730,7 +3867,7 @@ CLASS="APPLICATION"
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> will disconnect from and hide  the
+> will disconnect from and hide the
  command console.</P
 ><P
 > <TT