Various changes:
[privoxy.git] / doc / webserver / user-manual / configuration.html
index ecba3d6..df623b5 100644 (file)
@@ -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.0.4 User Manual"
 HREF="index.html"><LINK
 REL="PREVIOUS"
 TITLE="Starting Privoxy"
@@ -17,7 +17,9 @@ TITLE="The Main Configuration File"
 HREF="config.html"><LINK
 REL="STYLESHEET"
 TYPE="text/css"
-HREF="../p_doc.css"></HEAD
+HREF="../p_doc.css">
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
+</head
 ><BODY
 CLASS="SECT1"
 BGCOLOR="#EEEEEE"
@@ -28,6 +30,7 @@ ALINK="#0000FF"
 ><DIV
 CLASS="NAVHEADER"
 ><TABLE
+SUMMARY="Header navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -36,7 +39,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy User Manual</TH
+>Privoxy 3.0.4 User Manual</TH
 ></TR
 ><TR
 ><TD
@@ -45,6 +48,7 @@ ALIGN="left"
 VALIGN="bottom"
 ><A
 HREF="startup.html"
+ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -58,6 +62,7 @@ ALIGN="right"
 VALIGN="bottom"
 ><A
 HREF="config.html"
+ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR
@@ -71,11 +76,11 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="CONFIGURATION"
+></A
 >6. <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> Configuration</A
-></H1
+> Configuration</H1
 ><P
 >  All <SPAN
 CLASS="APPLICATION"
@@ -93,12 +98,12 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN481"
+NAME="AEN766"
+></A
 >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 +129,12 @@ WIDTH="100%"
 ><TD
 ><PRE
 CLASS="SCREEN"
-> <H3
+> <H2
 CLASS="BRIDGEHEAD"
->Privoxy Menu</H3
+><A
+NAME="AEN775"
+></A
+>    Privoxy Menu</H2
 ><P
 ></P
 ><TABLE
@@ -177,6 +185,15 @@ TARGET="_top"
 >
  </TD
 ></TR
+><TR
+><TD
+>          &#9642;  <A
+HREF="http://www.privoxy.org/   3.0.4/user-manual/"
+TARGET="_top"
+>Documentation</A
+>
+ </TD
+></TR
 ></TBODY
 ></TABLE
 ><P
@@ -236,8 +253,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONFOVERVIEW"
->6.2. Configuration Files Overview</A
-></H2
+></A
+>6.2. Configuration Files Overview</H2
 ><P
 > For Unix, *BSD and Linux, all configuration files are located in
  <TT
@@ -339,9 +356,9 @@ TARGET="_top"
 ></LI
 ><LI
 ><P
->    <TT
-CLASS="FILENAME"
->default.filter</TT
+>    <SPAN
+CLASS="QUOTE"
+>"Filter files"</SPAN
 > (the <A
 HREF="filter-file.html"
 >filter
@@ -349,12 +366,31 @@ HREF="filter-file.html"
 >) can be used to re-write the raw page content, including
     viewable text as well as embedded HTML and JavaScript, and whatever else
     lurks on any given web page. The filtering jobs are only pre-defined here;
-    whether to apply them or not is up to the actions files.
+    whether to apply them or not is up to the actions files. 
+    <TT
+CLASS="FILENAME"
+>default.filter</TT
+> includes various filters made 
+    available for use by the developers. Some are much more intrusive than 
+    others, and all should be used with caution. You may define additional 
+    filter files in <TT
+CLASS="FILENAME"
+>config</TT
+> as you can with 
+    actions files. We suggest <TT
+CLASS="FILENAME"
+>user.filter</TT
+> for any 
+    locally defined filters or customizations.
    </P
 ></LI
 ></UL
 ></P
 ><P
+> The syntax of all configuration files has remained the same throughout the
+ 3.x series. There have been enhancements, but no changes that would preclude
+ the use of any configuration file from one version to the next.</P
+><P
 > All files use the <SPAN
 CLASS="QUOTE"
 >"<TT
@@ -378,10 +414,7 @@ CLASS="LITERAL"
  valid configuration line to prevent it from being interpreted is called "commenting
  out" that line.</P
 ><P
-> The actions files and <TT
-CLASS="FILENAME"
->default.filter</TT
-> 
+> The actions files and filter files  
  can use Perl style <A
 HREF="appendix.html#REGEX"
 >regular expressions</A
@@ -406,9 +439,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. 
@@ -425,6 +461,7 @@ CLASS="NAVFOOTER"
 ><HR
 ALIGN="LEFT"
 WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -436,6 +473,7 @@ ALIGN="left"
 VALIGN="top"
 ><A
 HREF="startup.html"
+ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -444,6 +482,7 @@ ALIGN="center"
 VALIGN="top"
 ><A
 HREF="index.html"
+ACCESSKEY="H"
 >Home</A
 ></TD
 ><TD
@@ -452,6 +491,7 @@ ALIGN="right"
 VALIGN="top"
 ><A
 HREF="config.html"
+ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR