Regenerate docs for Privoxy 3.0.23 stable
[privoxy.git] / doc / webserver / user-manual / config.html
index f7a1e77..9fecd2f 100644 (file)
@@ -6,7 +6,7 @@
   <title>The Main Configuration File</title>
   <meta name="GENERATOR" content=
   "Modular DocBook HTML Stylesheet Version 1.79">
-  <link rel="HOME" title="Privoxy 3.0.22 User Manual" href="index.html">
+  <link rel="HOME" title="Privoxy 3.0.23 User Manual" href="index.html">
   <link rel="PREVIOUS" title="Privoxy Configuration" href=
   "configuration.html">
   <link rel="NEXT" title="Actions Files" href="actions-file.html">
@@ -21,7 +21,7 @@
     <table summary="Header navigation table" width="100%" border="0"
     cellpadding="0" cellspacing="0">
       <tr>
-        <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th>
+        <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
       </tr>
 
       <tr>
 
               <p>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">Privoxy</span> without at least one actions
-              file.</p>
-
-              <p>Note that since Privoxy 3.0.7, the complete filename,
-              including the <span class="QUOTE">".action"</span> extension
-              has to be specified. The syntax change was necessary to be
-              consistent with the other file options and to allow previously
-              forbidden characters.</p>
+              considerations, etc.</p>
             </dd>
           </dl>
         </div>
               <p>Depending on the debug options below, the logfile may be a
               privacy risk if third parties can get access to it. As most
               users will never look at it, <span class=
-              "APPLICATION">Privoxy</span> 3.0.7 and later only log fatal
-              errors by default.</p>
+              "APPLICATION">Privoxy</span> only logs fatal errors by
+              default.</p>
 
               <p>For most troubleshooting purposes, you will have to change
               that, please refer to the debugging section for details.</p>
 
-              <p>Your logfile will grow indefinitely, and you will probably
-              want to periodically remove it. On Unix systems, you can do
-              this with a cron job (see <span class="QUOTE">"man
-              cron"</span>).</p>
-
               <p>Any log files must be writable by whatever user <span class=
               "APPLICATION">Privoxy</span> is being run as (on Unix, default
               user id is <span class="QUOTE">"privoxy"</span>).</p>
+
+              <p>To prevent the logfile from growing indefinitely, it is
+              recommended to periodically rotate or shorten it. Many
+              operating systems support log rotation out of the box, some
+              require additional software to do it. For details, please refer
+              to the documentation for your operating system.</p>
             </dd>
           </dl>
         </div>
               problem. They can produce a hell of an output (especially
               16).</p>
 
-              <p><span class="APPLICATION">Privoxy</span> used to ship with
-              the debug levels recommended above enabled by default, but due
-              to privacy concerns 3.0.7 and later are configured to only log
-              fatal errors.</p>
-
               <p>If you are used to the more verbose settings, simply enable
               the debug lines below again.</p>
 
                 </tr>
               </table>
 
+              <p>Note that if you got Tor through one of the bundles, you may
+              have to change the port from 9050 to 9150 (or even another
+              one). For details, please check the documentation on the
+              <a href="https://torproject.org/" target="_top">Tor
+              website</a>.</p>
+
               <p>The public <span class="APPLICATION">Tor</span> network
               can't be used to reach your local network, if you need to
               access local servers you therefore might want to make some
             <dt>Notes:</dt>
 
             <dd>
-              <p>This is a work-around for Firefox bug 492459: <span class=
-              "QUOTE">" Websites are no longer rendered if SSL requests for
-              JavaScripts are blocked by a proxy. "</span> (<a href=
-              "https://bugzilla.mozilla.org/show_bug.cgi?id=492459" target=
-              "_top">https://bugzilla.mozilla.org/show_bug.cgi?id=492459</a>)
-              As the bug has been fixed for quite some time this option
-              should no longer be needed and will be removed in a future
-              release. Please speak up if you have a reason why the option
-              should be kept around.</p>
+              <p>This directive was added as a work-around for Firefox bug
+              492459: <span class="QUOTE">"Websites are no longer rendered if
+              SSL requests for JavaScripts are blocked by a proxy."</span>
+              (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=492459"
+              target=
+              "_top">https://bugzilla.mozilla.org/show_bug.cgi?id=492459</a>),
+              the bug has been fixed for quite some time, but this directive
+              is also useful to make it harder for websites to detect whether
+              or not resources are being blocked.</p>
             </dd>
           </dl>
         </div>