Just regenerating to get fresh version in place of very dated versions.

[privoxy.git] / doc / webserver / user-manual / configuration.html

diff --git a/doc/webserver/user-manual/configuration.html b/doc/webserver/user-manual/configuration.html
index 7b77fcd..0c039ea 100644 (file)
--- a/doc/webserver/user-manual/configuration.html
+++ b/doc/webserver/user-manual/configuration.html
@@ -4,10 +4,10 @@
 >Privoxy Configuration</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+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="Starting Privoxy"
@@ -28,6 +28,7 @@ ALINK="#0000FF"
 ><DIV
 CLASS="NAVHEADER"
 ><TABLE
+SUMMARY="Header navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -36,7 +37,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy User Manual</TH
+>Privoxy 3.1.1 User Manual</TH
 ></TR
 ><TR
 ><TD
@@ -45,6 +46,7 @@ ALIGN="left"
 VALIGN="bottom"
 ><A
 HREF="startup.html"
+ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -58,6 +60,7 @@ ALIGN="right"
 VALIGN="bottom"
 ><A
 HREF="config.html"
+ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR
@@ -70,12 +73,10 @@ CLASS="SECT1"
 ><H1
 CLASS="SECT1"
 ><A
-NAME="CONFIGURATION"
->7. <SPAN
+NAME="CONFIGURATION">6. <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> Configuration</A
-></H1
+> Configuration</H1
 ><P
 >  All <SPAN
 CLASS="APPLICATION"
@@ -93,12 +94,10 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN305"
->7.1. Controlling <SPAN
+NAME="AEN582">6.1. Controlling <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> with Your Web Browser</A
-></H2
+> with Your Web Browser</H2
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -124,9 +123,10 @@ WIDTH="100%"
 ><TD
 ><PRE
 CLASS="SCREEN"
-> <H3
+> <H2
 CLASS="BRIDGEHEAD"
->Privoxy Menu</H3
+><A
+NAME="AEN591">    Privoxy Menu</H2
 ><P
 ></P
 ><TABLE
@@ -177,6 +177,15 @@ TARGET="_top"
 >
  </TD
 ></TR
+><TR
+><TD
+>          &#9642;  <A
+HREF="http://www.privoxy.org/3.1.1/user-manual/"
+TARGET="_top"
+>Documentation</A
+>
+ </TD
+></TR
 ></TBODY
 ></TABLE
 ><P
@@ -187,11 +196,11 @@ TARGET="_top"
 ></TABLE
 ><P
 > This should be self-explanatory. Note the first item leads to an editor for the
- <SPAN
-CLASS="QUOTE"
->"actions list"</SPAN
->, which is where the ad, banner, cookie,
- and URL blocking magic is configured as well as other advanced features of
+ <A
+HREF="actions-file.html"
+>actions files</A
+>, which is where the ad, banner,
+ cookie, and URL blocking magic is configured as well as other advanced features of
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -215,7 +224,11 @@ CLASS="APPLICATION"
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > continues 
- to run as a proxy in this case, but all filtering is disabled. There
+ to run as a proxy in this case, but all manipulation is disabled, i.e.
+ <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> acts like a normal forwarding proxy. There
  is even a toggle <A
 HREF="appendix.html#BOOKMARKLETS"
 >Bookmarklet</A
@@ -231,9 +244,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="CONFOVERVIEW"
->7.2. Configuration Files Overview</A
-></H2
+NAME="CONFOVERVIEW">6.2. Configuration Files Overview</H2
 ><P
 > For Unix, *BSD and Linux, all configuration files are located in
  <TT
@@ -257,9 +268,12 @@ CLASS="APPLICATION"
 ><UL
 ><LI
 ><P
->     The main configuration file is named <A
+>     The <A
 HREF="config.html"
->config</A
+>main configuration file</A
+> is named <TT
+CLASS="FILENAME"
+>config</TT
 >
      on Linux, Unix, BSD, OS/2, and AmigaOS and <TT
 CLASS="FILENAME"
@@ -276,12 +290,18 @@ CLASS="FILENAME"
 > (the main <A
 HREF="actions-file.html"
 >actions file</A
->) is used to define
-    the default settings for various <SPAN
+>)
+    is used to define which <SPAN
 CLASS="QUOTE"
 >"actions"</SPAN
-> relating to images, banners, 
-    pop-ups, access restrictions, banners and cookies.
+> relating to banner-blocking, images, pop-ups,
+    content modification, cookie handling etc should be applied by default. It also defines many
+    exceptions (both positive and negative) from this default set of actions that enable 
+    <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> to selectively eliminate the junk, and only the junk, on
+    as many websites as possible.
    </P
 ><P
 >    Multiple actions files may be defined in <TT
@@ -289,20 +309,21 @@ CLASS="FILENAME"
 >config</TT
 >. These 
     are processed in the order they are defined. Local customizations and locally 
-    preferred exceptions to the default policies as defined in
+    preferred exceptions to the default policies  as defined in
     <TT
 CLASS="FILENAME"
 >default.action</TT
-> are probably best applied in
+> (which you will most probably want
+    to define sooner or later) are probably best applied in
     <TT
 CLASS="FILENAME"
 >user.action</TT
->, which should be preserved across
+>, where you can preserve them across
     upgrades. <TT
 CLASS="FILENAME"
 >standard.action</TT
-> is also included. This is mostly 
-    for <SPAN
+> is for
+    <SPAN
 CLASS="APPLICATION"
 >Privoxy's</SPAN
 > internal use.
@@ -311,14 +332,14 @@ CLASS="APPLICATION"
 >    
     There is also a web based editor that can be accessed from
     <A
-HREF="http://config.privoxy.org/show-status/"
+HREF="http://config.privoxy.org/show-status"
 TARGET="_top"
->http://config.privoxy.org/show-status/</A
+>http://config.privoxy.org/show-status</A
 >
     (Shortcut: <A
-HREF="http://p.p/show-status/"
+HREF="http://p.p/show-status"
 TARGET="_top"
->http://p.p/show-status/</A
+>http://p.p/show-status</A
 >) for the
     various actions files. 
    </P
@@ -348,7 +369,7 @@ CLASS="LITERAL"
 >#</TT
 >"</SPAN
 > character to denote a
- comment (the rest of the line will be ignored) angd understand line continuation
+ comment (the rest of the line will be ignored) and understand line continuation
  through placing a backslash ("<TT
 CLASS="LITERAL"
 >\</TT
@@ -392,9 +413,12 @@ CLASS="APPLICATION"
 CLASS="QUOTE"
 >"wake up"</SPAN
 > requests
- must obviously be sent to the <I
+ must obviously be sent to the <SPAN
+CLASS="emphasis"
+><I
 CLASS="EMPHASIS"
 >old</I
+></SPAN
 > listening address.</P
 ><P
 > While under development, the configuration content is subject to change. 
@@ -411,6 +435,7 @@ CLASS="NAVFOOTER"
 ><HR
 ALIGN="LEFT"
 WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -422,6 +447,7 @@ ALIGN="left"
 VALIGN="top"
 ><A
 HREF="startup.html"
+ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -430,6 +456,7 @@ ALIGN="center"
 VALIGN="top"
 ><A
 HREF="index.html"
+ACCESSKEY="H"
 >Home</A
 ></TD
 ><TD
@@ -438,6 +465,7 @@ ALIGN="right"
 VALIGN="top"
 ><A
 HREF="config.html"
+ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR