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:
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
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
-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
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 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
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
><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
> 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
> <DIV
CLASS="TABLE"
><A
-NAME="AEN2167"
+NAME="AEN2171"
></A
><P
><B
><H2
CLASS="SECT2"
><A
-NAME="AEN2266"
+NAME="AEN2270"
>8.1. Finding the Right Mix</A
></H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN2273"
+NAME="AEN2277"
>8.2. How to Edit</A
></H2
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN2364"
+NAME="AEN2368"
>8.4.1. The Domain Pattern</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN2435"
+NAME="AEN2439"
>8.4.2. The Path Pattern</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN4247"
+NAME="AEN4251"
>8.5.39. Summary</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN4312"
+NAME="AEN4316"
>8.7.1. default.action</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN4448"
+NAME="AEN4452"
>8.7.2. user.action</A
></H3
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN5333"
+NAME="AEN5337"
>14.2. Privoxy's Internal Pages</A
></H2
><P
Privoxy main page:
</P
><A
-NAME="AEN5347"
+NAME="AEN5351"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
editing of actions files:
</P
><A
-NAME="AEN5355"
+NAME="AEN5359"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show the source code version numbers:
</P
><A
-NAME="AEN5360"
+NAME="AEN5364"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show the browser's request headers:
</P
><A
-NAME="AEN5365"
+NAME="AEN5369"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show which actions apply to a URL and why:
</P
><A
-NAME="AEN5370"
+NAME="AEN5374"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
place:
</P
><A
-NAME="AEN5378"
+NAME="AEN5382"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
> Short cuts. Turn off, then on:
</P
><A
-NAME="AEN5382"
+NAME="AEN5386"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
</P
></BLOCKQUOTE
><A
-NAME="AEN5385"
+NAME="AEN5389"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><H2
CLASS="SECT2"
><A
-NAME="AEN814"
+NAME="AEN816"
>6.1. Controlling Privoxy with Your Web Browser</A
></H2
><P
> <H2
CLASS="BRIDGEHEAD"
><A
-NAME="AEN822"
+NAME="AEN824"
></A
> Privoxy Menu</H2
><P
<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
>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
><H2
CLASS="SECT2"
><A
-NAME="AEN5076"
+NAME="AEN5080"
>12.1. License</A
></H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN4603"
+NAME="AEN4607"
>9.1. Filter File Tutorial</A
></H2
><P
><DL
><DT
>6.1. <A
-HREF="configuration.html#AEN814"
+HREF="configuration.html#AEN816"
>Controlling Privoxy with Your Web Browser</A
></DT
><DT
><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
-HREF="actions-file.html#AEN2273"
+HREF="actions-file.html#AEN2277"
>How to Edit</A
></DT
><DT
><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
-HREF="actions-file.html#AEN2435"
+HREF="actions-file.html#AEN2439"
>The Path Pattern</A
></DT
><DT
></DT
><DT
>8.5.39. <A
-HREF="actions-file.html#AEN4247"
+HREF="actions-file.html#AEN4251"
>Summary</A
></DT
></DL
><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
-HREF="actions-file.html#AEN4448"
+HREF="actions-file.html#AEN4452"
>user.action</A
></DT
></DL
><DL
><DT
>9.1. <A
-HREF="filter-file.html#AEN4603"
+HREF="filter-file.html#AEN4607"
>Filter File Tutorial</A
></DT
><DT
><DL
><DT
>12.1. <A
-HREF="copyright.html#AEN5076"
+HREF="copyright.html#AEN5080"
>License</A
></DT
><DT
></DT
><DT
>14.2. <A
-HREF="appendix.html#AEN5333"
+HREF="appendix.html#AEN5337"
>Privoxy's Internal Pages</A
></DT
><DD
><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
>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
->, 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
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
> <DIV
CLASS="FIGURE"
><A
-NAME="AEN567"
+NAME="AEN569"
></A
><P
><B
> <DIV
CLASS="FIGURE"
><A
-NAME="AEN622"
+NAME="AEN624"
></A
><P
><B
> <DIV
CLASS="FIGURE"
><A
-NAME="AEN666"
+NAME="AEN668"
></A
><P
><B