Updated for 3.0.7 beta
authorhal9 <hal9@users.sourceforge.net>
Sat, 8 Dec 2007 14:40:18 +0000 (14:40 +0000)
committerhal9 <hal9@users.sourceforge.net>
Sat, 8 Dec 2007 14:40:18 +0000 (14:40 +0000)
16 files changed:
doc/pdf/privoxy-developer-manual.pdf
doc/pdf/privoxy-faq.pdf
doc/pdf/privoxy-user-manual.pdf
doc/text/developer-manual.txt
doc/text/user-manual.txt
doc/webserver/developer-manual/newrelease.html
doc/webserver/user-manual/actions-file.html
doc/webserver/user-manual/appendix.html
doc/webserver/user-manual/configuration.html
doc/webserver/user-manual/copyright.html
doc/webserver/user-manual/filter-file.html
doc/webserver/user-manual/index.html
doc/webserver/user-manual/installation.html
doc/webserver/user-manual/introduction.html
doc/webserver/user-manual/quickstart.html
doc/webserver/user-manual/startup.html

index eff4d88..c628010 100644 (file)
Binary files a/doc/pdf/privoxy-developer-manual.pdf and b/doc/pdf/privoxy-developer-manual.pdf differ
index c0984ad..7091189 100644 (file)
Binary files a/doc/pdf/privoxy-faq.pdf and b/doc/pdf/privoxy-faq.pdf differ
index 466e0e3..831d23c 100644 (file)
Binary files a/doc/pdf/privoxy-user-manual.pdf and b/doc/pdf/privoxy-user-manual.pdf differ
index 563b488..cf49d41 100644 (file)
@@ -2043,7 +2043,7 @@ First, make sure that you have freshly exported the right version into an empty
 directory. (See "Building and releasing packages" above). Then add a log entry
 to debian/changelog, if it is not already there, for example by running:
 
 directory. (See "Building and releasing packages" above). Then add a log entry
 to debian/changelog, if it is not already there, for example by running:
 
-  debchange -v 3.0.7-stable-1 "New upstream version"
+  debchange -v 3.0.7-beta-1 "New upstream version"
 
 
 Then, run:
 
 
 Then, run:
@@ -2051,7 +2051,7 @@ Then, run:
   dpkg-buildpackage -rfakeroot -us -uc -b
 
 
   dpkg-buildpackage -rfakeroot -us -uc -b
 
 
-This will create ../privoxy_3.0.7-stable-1_i386.deb which can be uploaded. To
+This will create ../privoxy_3.0.7-beta-1_i386.deb which can be uploaded. To
 upload the package to Sourceforge, simply issue
 
   make debian-upload
 upload the package to Sourceforge, simply issue
 
   make debian-upload
index d513759..aa815b6 100644 (file)
@@ -212,16 +212,24 @@ Table of Contents
 
 1. Introduction
 
 
 1. Introduction
 
-This documentation is included with the current stable version of Privoxy,
-v.3.0.7.
+This documentation is included with the current beta version of Privoxy,
+v.3.0.7, and is mostly complete at this point. The most up to date reference
+for the time being is still the comments in the source files and in the
+individual configuration files. Development of a new version is currently
+nearing completion, and includes significant changes and enhancements over
+earlier versions. .
+
+Since this is a beta version, not all new features are well tested. This
+documentation may be slightly out of sync as a result (especially with CVS
+sources). And there may be bugs, though hopefully not many!
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 1.1. Features
 
 In addition to the core features of ad blocking and cookie management, Privoxy
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 1.1. Features
 
 In addition to the core features of ad blocking and cookie management, Privoxy
-provides many supplemental features, that give the end-user more control, more
-privacy and more freedom:
+provides many supplemental features, some of them currently under development,
+that give the end-user more control, more privacy and more freedom:
 
   • Integrated browser based configuration and control utility at http://
     config.privoxy.org/ (shortcut: http://p.p/). Browser-based tracing of rule
 
   • Integrated browser based configuration and control utility at http://
     config.privoxy.org/ (shortcut: http://p.p/). Browser-based tracing of rule
@@ -427,8 +435,8 @@ compiler like gcc are required.
 
 When building from a source tarball, first unpack the source:
 
 
 When building from a source tarball, first unpack the source:
 
- tar xzvf privoxy-3.0.7-src* [.tgz or .tar.gz]
- cd privoxy-3.0.7
+ tar xzvf privoxy-3.0.7-beta-src* [.tgz or .tar.gz]
+ cd privoxy-3.0.7-beta
 
 
 For retrieving the current CVS sources, you'll need a CVS client installed.
 
 
 For retrieving the current CVS sources, you'll need a CVS client installed.
@@ -1144,7 +1152,9 @@ which cases it's safe to enable them again.
 
 For Unix, *BSD and Linux, all configuration files are located in /etc/privoxy/
 by default. For MS Windows, OS/2, and AmigaOS these are all in the same
 
 For Unix, *BSD and Linux, all configuration files are located in /etc/privoxy/
 by default. For MS Windows, OS/2, and AmigaOS these are all in the same
-directory as the Privoxy executable.
+directory as the Privoxy executable. The name and number of configuration files
+has changed from previous versions, and is subject to change as development
+progresses.
 
 The installed defaults provide a reasonable starting point, though some
 settings may be aggressive by some standards. For the time being, the principle
 
 The installed defaults provide a reasonable starting point, though some
 settings may be aggressive by some standards. For the time being, the principle
@@ -1200,6 +1210,11 @@ however, that it may take one or two additional requests for the change to take
 effect. When changing the listening address of Privoxy, these "wake up"
 requests must obviously be sent to the old listening address.
 
 effect. When changing the listening address of Privoxy, these "wake up"
 requests must obviously be sent to the old listening address.
 
+While under development, the configuration content is subject to change. The
+below documentation may not be accurate by the time you read this. Also, what
+constitutes a "default" setting, may change, so please check all your
+configuration files on important issues.
+
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 7. The Main Configuration File
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 7. The Main Configuration File
index ee8accc..d864018 100644 (file)
@@ -1352,7 +1352,7 @@ WIDTH="100%"
 ><TD
 ><PRE
 CLASS="PROGRAMLISTING"
 ><TD
 ><PRE
 CLASS="PROGRAMLISTING"
->  debchange -v 3.0.7-stable-1 "New upstream version"</PRE
+>  debchange -v 3.0.7-beta-1 "New upstream version"</PRE
 ></TD
 ></TR
 ></TABLE
 ></TD
 ></TR
 ></TABLE
@@ -1380,7 +1380,7 @@ CLASS="PROGRAMLISTING"
 >        This will create
         <TT
 CLASS="FILENAME"
 >        This will create
         <TT
 CLASS="FILENAME"
->../privoxy_3.0.7-stable-1_i386.deb</TT
+>../privoxy_3.0.7-beta-1_i386.deb</TT
 >
         which can be uploaded.  To upload the package to Sourceforge, simply
        issue
 >
         which can be uploaded.  To upload the package to Sourceforge, simply
        issue
index 2128e6f..b667328 100644 (file)
@@ -259,7 +259,7 @@ CLASS="FILENAME"
 >    <DIV
 CLASS="TABLE"
 ><A
 >    <DIV
 CLASS="TABLE"
 ><A
-NAME="AEN2167"
+NAME="AEN2171"
 ></A
 ><P
 ><B
 ></A
 ><P
 ><B
@@ -528,7 +528,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2266"
+NAME="AEN2270"
 >8.1. Finding the Right Mix</A
 ></H2
 ><P
 >8.1. Finding the Right Mix</A
 ></H2
 ><P
@@ -563,7 +563,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2273"
+NAME="AEN2277"
 >8.2. How to Edit</A
 ></H2
 ><P
 >8.2. How to Edit</A
 ></H2
 ><P
@@ -893,7 +893,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN2364"
+NAME="AEN2368"
 >8.4.1. The Domain Pattern</A
 ></H3
 ><P
 >8.4.1. The Domain Pattern</A
 ></H3
 ><P
@@ -1117,7 +1117,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN2435"
+NAME="AEN2439"
 >8.4.2. The Path Pattern</A
 ></H3
 ><P
 >8.4.2. The Path Pattern</A
 ></H3
 ><P
@@ -7183,7 +7183,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN4247"
+NAME="AEN4251"
 >8.5.39. Summary</A
 ></H3
 ><P
 >8.5.39. Summary</A
 ></H3
 ><P
@@ -7488,7 +7488,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN4312"
+NAME="AEN4316"
 >8.7.1. default.action</A
 ></H3
 ><P
 >8.7.1. default.action</A
 ></H3
 ><P
@@ -8209,7 +8209,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN4448"
+NAME="AEN4452"
 >8.7.2. user.action</A
 ></H3
 ><P
 >8.7.2. user.action</A
 ></H3
 ><P
index 2c21e47..91ad73c 100644 (file)
@@ -745,7 +745,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN5333"
+NAME="AEN5337"
 >14.2. Privoxy's Internal Pages</A
 ></H2
 ><P
 >14.2. Privoxy's Internal Pages</A
 ></H2
 ><P
@@ -791,7 +791,7 @@ CLASS="APPLICATION"
    Privoxy main page: 
   </P
 ><A
    Privoxy main page: 
   </P
 ><A
-NAME="AEN5347"
+NAME="AEN5351"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -824,7 +824,7 @@ CLASS="APPLICATION"
     editing of actions files:
   </P
 ><A
     editing of actions files:
   </P
 ><A
-NAME="AEN5355"
+NAME="AEN5359"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -844,7 +844,7 @@ TARGET="_top"
     Show the source code version numbers:
   </P
 ><A
     Show the source code version numbers:
   </P
 ><A
-NAME="AEN5360"
+NAME="AEN5364"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -864,7 +864,7 @@ TARGET="_top"
    Show the browser's request headers:
   </P
 ><A
    Show the browser's request headers:
   </P
 ><A
-NAME="AEN5365"
+NAME="AEN5369"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -884,7 +884,7 @@ TARGET="_top"
    Show which actions apply to a URL and why:
   </P
 ><A
    Show which actions apply to a URL and why:
   </P
 ><A
-NAME="AEN5370"
+NAME="AEN5374"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -916,7 +916,7 @@ CLASS="QUOTE"
    place:
   </P
 ><A
    place:
   </P
 ><A
-NAME="AEN5378"
+NAME="AEN5382"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -933,7 +933,7 @@ TARGET="_top"
 >   Short cuts. Turn off, then on: 
   </P
 ><A
 >   Short cuts. Turn off, then on: 
   </P
 ><A
-NAME="AEN5382"
+NAME="AEN5386"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -947,7 +947,7 @@ TARGET="_top"
    </P
 ></BLOCKQUOTE
 ><A
    </P
 ></BLOCKQUOTE
 ><A
-NAME="AEN5385"
+NAME="AEN5389"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
index 4e8570f..0437bf3 100644 (file)
@@ -95,7 +95,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN814"
+NAME="AEN816"
 >6.1. Controlling Privoxy with Your Web Browser</A
 ></H2
 ><P
 >6.1. Controlling Privoxy with Your Web Browser</A
 ></H2
 ><P
@@ -126,7 +126,7 @@ CLASS="SCREEN"
 > <H2
 CLASS="BRIDGEHEAD"
 ><A
 > <H2
 CLASS="BRIDGEHEAD"
 ><A
-NAME="AEN822"
+NAME="AEN824"
 ></A
 >    Privoxy Menu</H2
 ><P
 ></A
 >    Privoxy Menu</H2
 ><P
@@ -272,7 +272,9 @@ CLASS="FILENAME"
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> executable. </P
+> executable.  The name
+ and number of configuration files has changed from previous versions, and is
+ subject to change as development progresses.</P
 ><P
 > The installed defaults provide a reasonable starting point, though 
  some settings may be aggressive by some standards. For the time being, the
 ><P
 > The installed defaults provide a reasonable starting point, though 
  some settings may be aggressive by some standards. For the time being, the
@@ -451,6 +453,14 @@ CLASS="EMPHASIS"
 >old</I
 ></SPAN
 > listening address.</P
 >old</I
 ></SPAN
 > listening address.</P
+><P
+> While under development, the configuration content is subject to change. 
+ The below documentation may not be accurate by the time you read this. 
+ Also, what constitutes a <SPAN
+CLASS="QUOTE"
+>"default"</SPAN
+> setting, may change, so 
+ please check all your configuration files on important issues.</P
 ></DIV
 ></DIV
 ><DIV
 ></DIV
 ></DIV
 ><DIV
index 38cf005..60f80f1 100644 (file)
@@ -99,7 +99,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN5076"
+NAME="AEN5080"
 >12.1. License</A
 ></H2
 ><P
 >12.1. License</A
 ></H2
 ><P
index d225df1..37fe071 100644 (file)
@@ -363,7 +363,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN4603"
+NAME="AEN4607"
 >9.1. Filter File Tutorial</A
 ></H2
 ><P
 >9.1. Filter File Tutorial</A
 ></H2
 ><P
index f7b05f1..2d30388 100644 (file)
@@ -292,7 +292,7 @@ HREF="configuration.html"
 ><DL
 ><DT
 >6.1. <A
 ><DL
 ><DT
 >6.1. <A
-HREF="configuration.html#AEN814"
+HREF="configuration.html#AEN816"
 >Controlling Privoxy with Your Web Browser</A
 ></DT
 ><DT
 >Controlling Privoxy with Your Web Browser</A
 ></DT
 ><DT
@@ -515,12 +515,12 @@ HREF="actions-file.html"
 ><DL
 ><DT
 >8.1. <A
 ><DL
 ><DT
 >8.1. <A
-HREF="actions-file.html#AEN2266"
+HREF="actions-file.html#AEN2270"
 >Finding the Right Mix</A
 ></DT
 ><DT
 >8.2. <A
 >Finding the Right Mix</A
 ></DT
 ><DT
 >8.2. <A
-HREF="actions-file.html#AEN2273"
+HREF="actions-file.html#AEN2277"
 >How to Edit</A
 ></DT
 ><DT
 >How to Edit</A
 ></DT
 ><DT
@@ -537,12 +537,12 @@ HREF="actions-file.html#AF-PATTERNS"
 ><DL
 ><DT
 >8.4.1. <A
 ><DL
 ><DT
 >8.4.1. <A
-HREF="actions-file.html#AEN2364"
+HREF="actions-file.html#AEN2368"
 >The Domain Pattern</A
 ></DT
 ><DT
 >8.4.2. <A
 >The Domain Pattern</A
 ></DT
 ><DT
 >8.4.2. <A
-HREF="actions-file.html#AEN2435"
+HREF="actions-file.html#AEN2439"
 >The Path Pattern</A
 ></DT
 ><DT
 >The Path Pattern</A
 ></DT
 ><DT
@@ -754,7 +754,7 @@ HREF="actions-file.html#TREAT-FORBIDDEN-CONNECTS-LIKE-BLOCKS"
 ></DT
 ><DT
 >8.5.39. <A
 ></DT
 ><DT
 >8.5.39. <A
-HREF="actions-file.html#AEN4247"
+HREF="actions-file.html#AEN4251"
 >Summary</A
 ></DT
 ></DL
 >Summary</A
 ></DT
 ></DL
@@ -773,12 +773,12 @@ HREF="actions-file.html#ACT-EXAMPLES"
 ><DL
 ><DT
 >8.7.1. <A
 ><DL
 ><DT
 >8.7.1. <A
-HREF="actions-file.html#AEN4312"
+HREF="actions-file.html#AEN4316"
 >default.action</A
 ></DT
 ><DT
 >8.7.2. <A
 >default.action</A
 ></DT
 ><DT
 >8.7.2. <A
-HREF="actions-file.html#AEN4448"
+HREF="actions-file.html#AEN4452"
 >user.action</A
 ></DT
 ></DL
 >user.action</A
 ></DT
 ></DL
@@ -794,7 +794,7 @@ HREF="filter-file.html"
 ><DL
 ><DT
 >9.1. <A
 ><DL
 ><DT
 >9.1. <A
-HREF="filter-file.html#AEN4603"
+HREF="filter-file.html#AEN4607"
 >Filter File Tutorial</A
 ></DT
 ><DT
 >Filter File Tutorial</A
 ></DT
 ><DT
@@ -862,7 +862,7 @@ HREF="copyright.html"
 ><DL
 ><DT
 >12.1. <A
 ><DL
 ><DT
 >12.1. <A
-HREF="copyright.html#AEN5076"
+HREF="copyright.html#AEN5080"
 >License</A
 ></DT
 ><DT
 >License</A
 ></DT
 ><DT
@@ -896,7 +896,7 @@ HREF="appendix.html#REGEX"
 ></DT
 ><DT
 >14.2. <A
 ></DT
 ><DT
 >14.2. <A
-HREF="appendix.html#AEN5333"
+HREF="appendix.html#AEN5337"
 >Privoxy's Internal Pages</A
 ></DT
 ><DD
 >Privoxy's Internal Pages</A
 ></DT
 ><DD
index 6bc0675..d0167c8 100644 (file)
@@ -577,8 +577,8 @@ WIDTH="100%"
 ><TD
 ><PRE
 CLASS="SCREEN"
 ><TD
 ><PRE
 CLASS="SCREEN"
-> tar xzvf privoxy-3.0.7-src* [.tgz or .tar.gz]
- cd privoxy-3.0.7</PRE
+> tar xzvf privoxy-3.0.7-beta-src* [.tgz or .tar.gz]
+ cd privoxy-3.0.7-beta</PRE
 ></TD
 ></TR
 ></TABLE
 ></TD
 ></TR
 ></TABLE
index 68448ea..a776a63 100644 (file)
@@ -79,11 +79,27 @@ NAME="INTRODUCTION"
 >1. Introduction</A
 ></H1
 ><P
 >1. Introduction</A
 ></H1
 ><P
-> This documentation is included with the current stable version of
+> This documentation is included with the current beta version of
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
->, v.3.0.7.</P
+>, v.3.0.7, 
+ and is mostly complete at this point. The most up to date reference for the
+ time being is still the comments in the source files and in the individual
+ configuration files. Development of a new version is currently nearing
+ completion, and includes significant changes and enhancements over
+ earlier versions. .</P
+><P
+> Since this is a beta version, not all new features are well tested. This
+ documentation may be slightly out of sync as a result (especially with 
+ CVS sources). And there <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>may be</I
+></SPAN
+> bugs, though hopefully
+ not many! </P
 ><DIV
 CLASS="SECT2"
 ><H2
 ><DIV
 CLASS="SECT2"
 ><H2
@@ -104,7 +120,7 @@ TARGET="_top"
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > provides many supplemental
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > provides many supplemental
- features, 
+ features, some of them currently under development, 
  that give the end-user more control, more privacy and more freedom:</P
 ><P
 > <P
  that give the end-user more control, more privacy and more freedom:</P
 ><P
 > <P
index 68a40fb..4dd055a 100644 (file)
@@ -724,7 +724,7 @@ CLASS="GUIBUTTON"
 >  <DIV
 CLASS="FIGURE"
 ><A
 >  <DIV
 CLASS="FIGURE"
 ><A
-NAME="AEN567"
+NAME="AEN569"
 ></A
 ><P
 ><B
 ></A
 ><P
 ><B
index eb7551a..172b1c2 100644 (file)
@@ -111,7 +111,7 @@ CLASS="APPLICATION"
 >  <DIV
 CLASS="FIGURE"
 ><A
 >  <DIV
 CLASS="FIGURE"
 ><A
-NAME="AEN622"
+NAME="AEN624"
 ></A
 ><P
 ><B
 ></A
 ><P
 ><B
@@ -245,7 +245,7 @@ CLASS="EMPHASIS"
 >  <DIV
 CLASS="FIGURE"
 ><A
 >  <DIV
 CLASS="FIGURE"
 ><A
-NAME="AEN666"
+NAME="AEN668"
 ></A
 ><P
 ><B
 ></A
 ><P
 ><B