Rebuild for 3.0.17 stable
[privoxy.git] / doc / webserver / user-manual / configuration.html
index a3a50eb..f8a58c1 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.0.7 User Manual"
+TITLE="Privoxy 3.0.17 User Manual"
 HREF="index.html"><LINK
 REL="PREVIOUS"
 TITLE="Starting Privoxy"
@@ -17,7 +17,10 @@ TITLE="The Main Configuration File"
 HREF="config.html"><LINK
 REL="STYLESHEET"
 TYPE="text/css"
-HREF="../p_doc.css">
+HREF="../p_doc.css"><META
+HTTP-EQUIV="Content-Type"
+CONTENT="text/html;
+charset=ISO-8859-1">
 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
 </head
 ><BODY
@@ -39,7 +42,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy 3.0.7 User Manual</TH
+>Privoxy 3.0.17 User Manual</TH
 ></TR
 ><TR
 ><TD
@@ -76,8 +79,8 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="CONFIGURATION"
-></A
->6. Privoxy Configuration</H1
+>6. Privoxy Configuration</A
+></H1
 ><P
 >  All <SPAN
 CLASS="APPLICATION"
@@ -95,9 +98,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN755"
-></A
->6.1. Controlling Privoxy with Your Web Browser</H2
+NAME="AEN921"
+>6.1. Controlling Privoxy with Your Web Browser</A
+></H2
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -126,7 +129,7 @@ CLASS="SCREEN"
 > <H2
 CLASS="BRIDGEHEAD"
 ><A
-NAME="AEN763"
+NAME="AEN929"
 ></A
 >    Privoxy Menu</H2
 ><P
@@ -182,7 +185,7 @@ TARGET="_top"
 ><TR
 ><TD
 >          &#9642;  <A
-HREF="http://www.privoxy.org/   3.0.7/user-manual/"
+HREF="http://www.privoxy.org/3.0.17/user-manual/"
 TARGET="_top"
 >Documentation</A
 >
@@ -240,6 +243,19 @@ 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"
@@ -247,8 +263,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONFOVERVIEW"
-></A
->6.2. Configuration Files Overview</H2
+>6.2. Configuration Files Overview</A
+></H2
 ><P
 > For Unix, *BSD and Linux, all configuration files are located in
  <TT
@@ -288,22 +304,24 @@ CLASS="FILENAME"
 ><P
 >    <TT
 CLASS="FILENAME"
->default.action</TT
-> (the main <A
-HREF="actions-file.html"
->actions file</A
->)
-    is used to define which <SPAN
+>match-all.action</TT
+> is used to define which <SPAN
 CLASS="QUOTE"
 >"actions"</SPAN
-> 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.
+>
+    relating to banner-blocking, images, pop-ups, content modification, cookie handling
+    etc should be applied by default. It should be the first actions file loaded.
+   </P
+><P
+>    <TT
+CLASS="FILENAME"
+>default.action</TT
+> defines many exceptions (both positive and negative)
+    from the default set of actions that's configured in <TT
+CLASS="FILENAME"
+>match-all.action</TT
+>.
+    It should be the second actions file loaded and shouldn't be edited by the user.
    </P
 ><P
 >    Multiple actions files may be defined in <TT
@@ -311,24 +329,17 @@ 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
+>match-all.action</TT
 > (which you will most probably want
-    to define sooner or later) are probably best applied in
-    <TT
+    to define sooner or later) are best applied in <TT
 CLASS="FILENAME"
 >user.action</TT
->, where you can preserve them across
-    upgrades. <TT
-CLASS="FILENAME"
->standard.action</TT
-> is only for
-    <SPAN
-CLASS="APPLICATION"
->Privoxy's</SPAN
-> internal use.
+>,
+    where you can preserve them across upgrades. The file isn't installed by all
+    installers, but you can easily create it yourself with a text editor.
    </P
 ><P
 >    
@@ -379,15 +390,9 @@ CLASS="FILENAME"
 ></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. (There is 
- one exception: <A
-HREF="actions-file.html#FAST-REDIRECTS"
->+fast-redirects</A
-> which 
- has enhanced syntax and will require updating any local configs from earlier 
- versions.)</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"
@@ -506,4 +511,4 @@ VALIGN="top"
 ></DIV
 ></BODY
 ></HTML
->
\ No newline at end of file
+>