New html version of user manual.
[privoxy.git] / doc / webserver / user-manual / configuration.html
index 0c039ea..d75573b 100644 (file)
@@ -1,13 +1,13 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
 <HTML
 ><HEAD
 ><TITLE
 >Privoxy Configuration</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.1.1 User Manual"
+TITLE="Privoxy 3.0.7 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"
@@ -37,7 +39,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy 3.1.1 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
 ></TR
 ><TR
 ><TD
@@ -73,10 +75,9 @@ CLASS="SECT1"
 ><H1
 CLASS="SECT1"
 ><A
-NAME="CONFIGURATION">6. <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> Configuration</H1
+NAME="CONFIGURATION"
+>6. Privoxy Configuration</A
+></H1
 ><P
 >  All <SPAN
 CLASS="APPLICATION"
@@ -94,10 +95,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN582">6.1. Controlling <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> with Your Web Browser</H2
+NAME="AEN790"
+>6.1. Controlling Privoxy with Your Web Browser</A
+></H2
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -126,7 +126,9 @@ CLASS="SCREEN"
 > <H2
 CLASS="BRIDGEHEAD"
 ><A
-NAME="AEN591">    Privoxy Menu</H2
+NAME="AEN798"
+></A
+>    Privoxy Menu</H2
 ><P
 ></P
 ><TABLE
@@ -180,7 +182,7 @@ TARGET="_top"
 ><TR
 ><TD
 >          &#9642;  <A
-HREF="http://www.privoxy.org/3.1.1/user-manual/"
+HREF="http://www.privoxy.org/   3.0.7/user-manual/"
 TARGET="_top"
 >Documentation</A
 >
@@ -238,13 +240,28 @@ CLASS="APPLICATION"
 >Privoxy</SPAN
 > with one click from
  your browser.</P
+><P
+> Note that several of the features described above are disabled by default
+ in <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> 3.0.7 beta and later.
+ Check the
+ <A
+HREF="config.html"
+TARGET="_top"
+>configuration file</A
+> to learn why
+ and in which cases it's safe to enable them again.</P
 ></DIV
 ><DIV
 CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="CONFOVERVIEW">6.2. Configuration Files Overview</H2
+NAME="CONFOVERVIEW"
+>6.2. Configuration Files Overview</A
+></H2
 ><P
 > For Unix, *BSD and Linux, all configuration files are located in
  <TT
@@ -322,7 +339,7 @@ CLASS="FILENAME"
     upgrades. <TT
 CLASS="FILENAME"
 >standard.action</TT
-> is for
+> is only for
     <SPAN
 CLASS="APPLICATION"
 >Privoxy's</SPAN
@@ -346,9 +363,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
@@ -356,12 +373,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 the configuration and filter files may change between different
+ Privoxy versions, unfortunately some enhancements cost backwards compatibility.
+ </P
+><P
 > All files use the <SPAN
 CLASS="QUOTE"
 >"<TT
@@ -383,12 +419,9 @@ CLASS="LITERAL"
 >#</TT
 > in front of an otherwise
  valid configuration line to prevent it from being interpreted is called "commenting
- out" that line.</P
+ out" that line. Blank lines are ignored.</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
@@ -474,10 +507,7 @@ ACCESSKEY="N"
 WIDTH="33%"
 ALIGN="left"
 VALIGN="top"
->Starting <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-></TD
+>Starting Privoxy</TD
 ><TD
 WIDTH="34%"
 ALIGN="center"