Renerate for 3.0.21 UNRELEASED
[privoxy.git] / doc / webserver / user-manual / index.html
index deb2429..77a0fd5 100644 (file)
@@ -3,90 +3,80 @@
 
 <html>
 <head>
-  <meta name="generator" content=
-  "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org">
-
-  <title>Privoxy 3.0.18 User Manual</title>
+  <title>Privoxy 3.0.21 User Manual</title>
   <meta name="GENERATOR" content=
   "Modular DocBook HTML Stylesheet Version 1.79">
   <link rel="NEXT" title="Introduction" href="introduction.html">
   <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
   <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
   <link rel="STYLESHEET" type="text/css" href="p_doc.css">
-  <style type="text/css">
-body {
-  background-color: #EEEEEE;
-  color: #000000;
-  }
-  :link { color: #0000FF }
-  :visited { color: #840084 }
-  :active { color: #0000FF }
-  hr.c2 {text-align: left}
-  dt.c1 {font-weight: bold}
-  </style>
 </head>
 
-<body class="ARTICLE">
+<body class="ARTICLE" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
+"#840084" alink="#0000FF">
   <div class="ARTICLE">
     <div class="TITLEPAGE">
-      <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.18 User
+      <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.21 User
       Manual</a></h1>
 
       <p class="PUBDATE"><sub><a href="copyright.html">Copyright</a> &copy;
-      2001-2011 by <a href="http://www.privoxy.org/" target="_top">Privoxy
+      2001-2013 by <a href="http://www.privoxy.org/" target="_top">Privoxy
       Developers</a></sub><br></p>
 
-      <p class="PUBDATE">$Id: user-manual.sgml,v 2.139 2011/11/18 16:49:29
+      <p class="PUBDATE">$Id: user-manual.sgml,v 2.167 2013/01/25 14:19:27
       fabiankeil Exp $<br></p>
 
-      <div class="ABSTRACT">
-        <a name="AEN9" id="AEN9"></a>
-
-        <p>The <i class="CITETITLE">Privoxy User Manual</i> gives users
-        information on how to install, configure and use <a href=
-        "http://www.privoxy.org/" target="_top">Privoxy</a>.</p>
-
-        <p>Privoxy is a non-caching web proxy with advanced filtering
-        capabilities for enhancing privacy, modifying web page data and HTTP
-        headers, controlling access, and removing ads and other obnoxious
-        Internet junk. Privoxy has a flexible configuration and can be
-        customized to suit individual needs and tastes. It has application
-        for both stand-alone systems and multi-user networks.</p>
-
-        <p>Privoxy is Free Software and licensed under the GNU GPLv2.</p>
-
-        <p>Privoxy is an associated project of Software in the Public
-        Interest (SPI).</p>
-
-        <p>Helping hands and donations are welcome:</p>
-
-        <ul>
-          <li>
-            <p><a href="http://www.privoxy.org/faq/general.html#PARTICIPATE"
-            target=
-            "_top">http://www.privoxy.org/faq/general.html#PARTICIPATE</a></p>
-          </li>
-
-          <li>
-            <p><a href="http://www.privoxy.org/faq/general.html#DONATE"
-            target=
-            "_top">http://www.privoxy.org/faq/general.html#DONATE</a></p>
-          </li>
-        </ul>
-
-        <p>You can find the latest version of the <i class=
-        "CITETITLE">Privoxy User Manual</i> at <a href=
-        "http://www.privoxy.org/user-manual/" target=
-        "_top">http://www.privoxy.org/user-manual/</a>. Please see the
-        <a href="contact.html">Contact section</a> on how to contact the
-        developers.</p>
+      <div>
+        <div class="ABSTRACT">
+          <a name="AEN9" id="AEN9"></a>
+
+          <p>The <i class="CITETITLE">Privoxy User Manual</i> gives users
+          information on how to install, configure and use <a href=
+          "http://www.privoxy.org/" target="_top">Privoxy</a>.</p>
+
+          <p>Privoxy is a non-caching web proxy with advanced filtering
+          capabilities for enhancing privacy, modifying web page data and
+          HTTP headers, controlling access, and removing ads and other
+          obnoxious Internet junk. Privoxy has a flexible configuration and
+          can be customized to suit individual needs and tastes. It has
+          application for both stand-alone systems and multi-user
+          networks.</p>
+
+          <p>Privoxy is Free Software and licensed under the GNU GPLv2.</p>
+
+          <p>Privoxy is an associated project of Software in the Public
+          Interest (SPI).</p>
+
+          <p>Helping hands and donations are welcome:</p>
+
+          <ul>
+            <li>
+              <p><a href=
+              "http://www.privoxy.org/faq/general.html#PARTICIPATE" target=
+              "_top">http://www.privoxy.org/faq/general.html#PARTICIPATE</a></p>
+            </li>
+
+            <li>
+              <p><a href="http://www.privoxy.org/faq/general.html#DONATE"
+              target=
+              "_top">http://www.privoxy.org/faq/general.html#DONATE</a></p>
+            </li>
+          </ul>
+
+          <p>You can find the latest version of the <i class=
+          "CITETITLE">Privoxy User Manual</i> at <a href=
+          "http://www.privoxy.org/user-manual/" target=
+          "_top">http://www.privoxy.org/user-manual/</a>. Please see the
+          <a href="contact.html">Contact section</a> on how to contact the
+          developers.</p>
+        </div>
       </div>
       <hr>
     </div>
 
     <div class="TOC">
       <dl>
-        <dt class="c1">Table of Contents</dt>
+        <dt><b>Table of Contents</b></dt>
 
         <dt>1. <a href="introduction.html">Introduction</a></dt>
 
@@ -106,33 +96,28 @@ body {
             <dd>
               <dl>
                 <dt>2.1.1. <a href=
-                "installation.html#INSTALLATION-PACK-RPM">Red Hat and Fedora
-                RPMs</a></dt>
-
-                <dt>2.1.2. <a href=
                 "installation.html#INSTALLATION-DEB">Debian and
                 Ubuntu</a></dt>
 
-                <dt>2.1.3. <a href=
+                <dt>2.1.2. <a href=
                 "installation.html#INSTALLATION-PACK-WIN">Windows</a></dt>
 
-                <dt>2.1.4. <a href=
-                "installation.html#INSTALLATION-PACK-BINTGZ">Solaris</a></dt>
-
-                <dt>2.1.5. <a href=
+                <dt>2.1.3. <a href=
                 "installation.html#INSTALLATION-OS2">OS/2</a></dt>
 
-                <dt>2.1.6. <a href="installation.html#INSTALLATION-MAC">Mac
+                <dt>2.1.4. <a href="installation.html#INSTALLATION-MAC">Mac
                 OS X</a></dt>
 
-                <dt>2.1.7. <a href=
-                "installation.html#INSTALLATION-AMIGA">AmigaOS</a></dt>
+                <dt>2.1.5. <a href=
+                "installation.html#OS-X-INSTALL-FROM-PACKAGE">Installation
+                from ready-built package</a></dt>
 
-                <dt>2.1.8. <a href=
-                "installation.html#INSTALLATION-TBZ">FreeBSD</a></dt>
+                <dt>2.1.6. <a href=
+                "installation.html#OS-X-INSTALL-FROM-SOURCE">Installation
+                from source</a></dt>
 
-                <dt>2.1.9. <a href=
-                "installation.html#INSTALLATTION-GENTOO">Gentoo</a></dt>
+                <dt>2.1.7. <a href=
+                "installation.html#INSTALLATION-TBZ">FreeBSD</a></dt>
               </dl>
             </dd>
 
@@ -168,25 +153,18 @@ body {
 
         <dd>
           <dl>
-            <dt>5.1. <a href="startup.html#START-REDHAT">Red Hat and
-            Fedora</a></dt>
-
-            <dt>5.2. <a href="startup.html#START-DEBIAN">Debian</a></dt>
+            <dt>5.1. <a href="startup.html#START-DEBIAN">Debian</a></dt>
 
-            <dt>5.3. <a href="startup.html#START-WINDOWS">Windows</a></dt>
+            <dt>5.2. <a href="startup.html#START-WINDOWS">Windows</a></dt>
 
-            <dt>5.4. <a href="startup.html#START-UNICES">Solaris, NetBSD,
+            <dt>5.3. <a href="startup.html#START-UNICES">Solaris, NetBSD,
             FreeBSD, HP-UX and others</a></dt>
 
-            <dt>5.5. <a href="startup.html#START-OS2">OS/2</a></dt>
-
-            <dt>5.6. <a href="startup.html#START-MACOSX">Mac OS X</a></dt>
+            <dt>5.4. <a href="startup.html#START-OS2">OS/2</a></dt>
 
-            <dt>5.7. <a href="startup.html#START-AMIGAOS">AmigaOS</a></dt>
+            <dt>5.5. <a href="startup.html#START-MACOSX">Mac OS X</a></dt>
 
-            <dt>5.8. <a href="startup.html#START-GENTOO">Gentoo</a></dt>
-
-            <dt>5.9. <a href="startup.html#CMDOPTIONS">Command Line
+            <dt>5.6. <a href="startup.html#CMDOPTIONS">Command Line
             Options</a></dt>
           </dl>
         </dd>
@@ -195,7 +173,7 @@ body {
 
         <dd>
           <dl>
-            <dt>6.1. <a href="configuration.html#AEN1071">Controlling Privoxy
+            <dt>6.1. <a href="configuration.html#AEN1023">Controlling Privoxy
             with Your Web Browser</a></dt>
 
             <dt>6.2. <a href="configuration.html#CONFOVERVIEW">Configuration
@@ -299,7 +277,7 @@ body {
                 <dt>7.5.1. <a href="config.html#FORWARD">forward</a></dt>
 
                 <dt>7.5.2. <a href="config.html#SOCKS">forward-socks4,
-                forward-socks4a and forward-socks5</a></dt>
+                forward-socks4a, forward-socks5 and forward-socks5t</a></dt>
 
                 <dt>7.5.3. <a href=
                 "config.html#ADVANCED-FORWARDING-EXAMPLES">Advanced
@@ -327,25 +305,31 @@ body {
                 "config.html#KEEP-ALIVE-TIMEOUT">keep-alive-timeout</a></dt>
 
                 <dt>7.6.5. <a href=
-                "config.html#DEFAULT-SERVER-TIMEOUT">default-server-timeout</a></dt>
+                "config.html#TOLERATE-PIPELINING">tolerate-pipelining</a></dt>
 
                 <dt>7.6.6. <a href=
-                "config.html#CONNECTION-SHARING">connection-sharing</a></dt>
+                "config.html#DEFAULT-SERVER-TIMEOUT">default-server-timeout</a></dt>
 
                 <dt>7.6.7. <a href=
-                "config.html#SOCKET-TIMEOUT">socket-timeout</a></dt>
+                "config.html#CONNECTION-SHARING">connection-sharing</a></dt>
 
                 <dt>7.6.8. <a href=
-                "config.html#MAX-CLIENT-CONNECTIONS">max-client-connections</a></dt>
+                "config.html#SOCKET-TIMEOUT">socket-timeout</a></dt>
 
                 <dt>7.6.9. <a href=
-                "config.html#HANDLE-AS-EMPTY-DOC-RETURNS-OK">handle-as-empty-doc-returns-ok</a></dt>
+                "config.html#MAX-CLIENT-CONNECTIONS">max-client-connections</a></dt>
 
                 <dt>7.6.10. <a href=
-                "config.html#ENABLE-COMPRESSION">enable-compression</a></dt>
+                "config.html#HANDLE-AS-EMPTY-DOC-RETURNS-OK">handle-as-empty-doc-returns-ok</a></dt>
 
                 <dt>7.6.11. <a href=
+                "config.html#ENABLE-COMPRESSION">enable-compression</a></dt>
+
+                <dt>7.6.12. <a href=
                 "config.html#COMPRESSION-LEVEL">compression-level</a></dt>
+
+                <dt>7.6.13. <a href=
+                "config.html#CLIENT-HEADER-ORDER">client-header-order</a></dt>
               </dl>
             </dd>
 
@@ -358,10 +342,10 @@ body {
 
         <dd>
           <dl>
-            <dt>8.1. <a href="actions-file.html#AEN2860">Finding the Right
+            <dt>8.1. <a href="actions-file.html#AEN2876">Finding the Right
             Mix</a></dt>
 
-            <dt>8.2. <a href="actions-file.html#AEN2867">How to Edit</a></dt>
+            <dt>8.2. <a href="actions-file.html#AEN2883">How to Edit</a></dt>
 
             <dt>8.3. <a href="actions-file.html#ACTIONS-APPLY">How Actions
             are Applied to Requests</a></dt>
@@ -371,10 +355,10 @@ body {
 
             <dd>
               <dl>
-                <dt>8.4.1. <a href="actions-file.html#AEN2979">The Domain
+                <dt>8.4.1. <a href="actions-file.html#AEN2995">The Domain
                 Pattern</a></dt>
 
-                <dt>8.4.2. <a href="actions-file.html#AEN3055">The Path
+                <dt>8.4.2. <a href="actions-file.html#AEN3071">The Path
                 Pattern</a></dt>
 
                 <dt>8.4.3. <a href="actions-file.html#TAG-PATTERN">The Tag
@@ -464,28 +448,31 @@ body {
                 "actions-file.html#LIMIT-CONNECT">limit-connect</a></dt>
 
                 <dt>8.5.27. <a href=
-                "actions-file.html#PREVENT-COMPRESSION">prevent-compression</a></dt>
+                "actions-file.html#LIMIT-COOKIE-LIFETIME">limit-cookie-lifetime</a></dt>
 
                 <dt>8.5.28. <a href=
-                "actions-file.html#OVERWRITE-LAST-MODIFIED">overwrite-last-modified</a></dt>
+                "actions-file.html#PREVENT-COMPRESSION">prevent-compression</a></dt>
 
                 <dt>8.5.29. <a href=
-                "actions-file.html#REDIRECT">redirect</a></dt>
+                "actions-file.html#OVERWRITE-LAST-MODIFIED">overwrite-last-modified</a></dt>
 
                 <dt>8.5.30. <a href=
-                "actions-file.html#SERVER-HEADER-FILTER">server-header-filter</a></dt>
+                "actions-file.html#REDIRECT">redirect</a></dt>
 
                 <dt>8.5.31. <a href=
-                "actions-file.html#SERVER-HEADER-TAGGER">server-header-tagger</a></dt>
+                "actions-file.html#SERVER-HEADER-FILTER">server-header-filter</a></dt>
 
                 <dt>8.5.32. <a href=
-                "actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a></dt>
+                "actions-file.html#SERVER-HEADER-TAGGER">server-header-tagger</a></dt>
 
                 <dt>8.5.33. <a href=
-                "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt>
+                "actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a></dt>
 
                 <dt>8.5.34. <a href=
-                "actions-file.html#AEN4684">Summary</a></dt>
+                "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt>
+
+                <dt>8.5.35. <a href=
+                "actions-file.html#AEN4743">Summary</a></dt>
               </dl>
             </dd>
 
@@ -497,13 +484,13 @@ body {
             <dd>
               <dl>
                 <dt>8.7.1. <a href=
-                "actions-file.html#AEN4748">match-all.action</a></dt>
+                "actions-file.html#AEN4807">match-all.action</a></dt>
 
                 <dt>8.7.2. <a href=
-                "actions-file.html#AEN4770">default.action</a></dt>
+                "actions-file.html#AEN4829">default.action</a></dt>
 
                 <dt>8.7.3. <a href=
-                "actions-file.html#AEN4883">user.action</a></dt>
+                "actions-file.html#AEN4942">user.action</a></dt>
               </dl>
             </dd>
           </dl>
@@ -513,7 +500,7 @@ body {
 
         <dd>
           <dl>
-            <dt>9.1. <a href="filter-file.html#AEN5038">Filter File
+            <dt>9.1. <a href="filter-file.html#AEN5097">Filter File
             Tutorial</a></dt>
 
             <dt>9.2. <a href="filter-file.html#PREDEFINED-FILTERS">The
@@ -528,26 +515,29 @@ body {
 
         <dd>
           <dl>
-            <dt>11.1. <a href="contact.html#CONTACT-SUPPORT">Get
+            <dt>11.1. <a href="contact.html#SUFFICIENT-INFORMATION">Please
+            provide sufficient information</a></dt>
+
+            <dt>11.2. <a href="contact.html#CONTACT-SUPPORT">Get
             Support</a></dt>
 
-            <dt>11.2. <a href="contact.html#REPORTING">Reporting
+            <dt>11.3. <a href="contact.html#REPORTING">Reporting
             Problems</a></dt>
 
             <dd>
               <dl>
-                <dt>11.2.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
+                <dt>11.3.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
                 or Other Configuration Problems</a></dt>
 
-                <dt>11.2.2. <a href="contact.html#CONTACT-BUGS">Reporting
+                <dt>11.3.2. <a href="contact.html#CONTACT-BUGS">Reporting
                 Bugs</a></dt>
               </dl>
             </dd>
 
-            <dt>11.3. <a href="contact.html#CONTACT-FEATURE">Request New
+            <dt>11.4. <a href="contact.html#CONTACT-FEATURE">Request New
             Features</a></dt>
 
-            <dt>11.4. <a href="contact.html#MAILING-LISTS">Mailing
+            <dt>11.5. <a href="contact.html#MAILING-LISTS">Mailing
             Lists</a></dt>
           </dl>
         </dd>
@@ -557,7 +547,7 @@ body {
 
         <dd>
           <dl>
-            <dt>12.1. <a href="copyright.html#AEN5520">License</a></dt>
+            <dt>12.1. <a href="copyright.html#AEN5586">License</a></dt>
 
             <dt>12.2. <a href="copyright.html#HISTORY">History</a></dt>
 
@@ -574,7 +564,7 @@ body {
             <dt>14.1. <a href="appendix.html#REGEX">Regular
             Expressions</a></dt>
 
-            <dt>14.2. <a href="appendix.html#AEN5773">Privoxy's Internal
+            <dt>14.2. <a href="appendix.html#AEN5818">Privoxy's Internal
             Pages</a></dt>
 
             <dd>
@@ -595,7 +585,7 @@ body {
   </div>
 
   <div class="NAVFOOTER">
-    <hr class="c2" width="100%">
+    <hr align="left" width="100%">
 
     <table summary="Footer navigation table" width="100%" border="0"
     cellpadding="0" cellspacing="0">