logo       

current/doc/source announce.sgml, 2.2, 2.3 authors.sgml, 2.2, 2.3 buildsour: msg#00005

web.privoxy.cvs

Subject: current/doc/source announce.sgml, 2.2, 2.3 authors.sgml, 2.2, 2.3 buildsource.sgml, 2.4, 2.5 config.sgml, 2.2, 2.3 contacting.sgml, 2.2, 2.3 copyright.sgml, 2.2, 2.3 developer-manual.sgml, 2.6, 2.7 faq.sgml, 2.10, 2.11 history.sgml, 2.3, 2.4 install.sgml, 2.1, 2.2 license.sgml, 2.2, 2.3 newfeatures.sgml, 2.2, 2.3 p-authors.sgml, 2.8, 2.9 p-config.sgml, 2.4, 2.5 privoxy-man-page.sgml, 2.4, 2.5 privoxy.sgml, 2.2, 2.3 readme.sgml, 2.4, 2.5 seealso.sgml, 2.2, 2.3 supported.sgml, 2.4, 2.5 user-manual.sgml, 2.10, 2.11 GNUmakefile.in, 1.9, NONE

Update of /cvsroot/ijbswa/current/doc/source
In directory sc8-pr-cvs2.sourceforge.net:/tmp/cvs-serv26899/doc/source

Modified Files:
announce.sgml authors.sgml buildsource.sgml config.sgml
contacting.sgml copyright.sgml developer-manual.sgml faq.sgml
history.sgml install.sgml license.sgml newfeatures.sgml
p-authors.sgml p-config.sgml privoxy-man-page.sgml
privoxy.sgml readme.sgml seealso.sgml supported.sgml
user-manual.sgml
Removed Files:
GNUmakefile.in
Log Message:
Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch)
with what was really the latest development (the v_3_0_branch branch)


Index: announce.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/announce.sgml,v
retrieving revision 2.2
retrieving revision 2.3
diff -u -d -r2.2 -r2.3
--- announce.sgml 5 Sep 2002 05:45:30 -0000 2.2
+++ announce.sgml 18 Jul 2006 14:48:50 -0000 2.3
@@ -5,10 +5,10 @@
<!entity contacting SYSTEM "../contacting.sgml">
<!entity history SYSTEM "../history.sgml">
<!entity newfeatures SYSTEM "../newfeatures.sgml">
-<!entity p-version SYSTEM "doc_version.tmp">
-<!entity p-status SYSTEM "doc_status.tmp">
+<!entity p-version "3.0.0">
+<!entity p-status "stable">
<!entity % p-not-stable "IGNORE">
-<!entity % p-stable "IGNORE">
+<!entity % p-stable "INCLUDE">
<!entity % p-supp-userman "IGNORE">
<!entity % p-text "INCLUDE"> <!-- define we are a text only doc -->
<!entity % p-doc "IGNORE"> <!-- and never a text doc -->

Index: authors.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/authors.sgml,v
retrieving revision 2.2
retrieving revision 2.3
diff -u -d -r2.2 -r2.3
--- authors.sgml 5 Sep 2002 05:45:30 -0000 2.2
+++ authors.sgml 18 Jul 2006 14:48:50 -0000 2.3
@@ -26,9 +26,9 @@
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
<!entity % dummy "IGNORE">
<!entity authors SYSTEM "p-authors.sgml">
-<!entity p-version SYSTEM "doc_version.tmp">
-<!entity p-status SYSTEM "doc_status.tmp">
-<!entity % p-not-stable "IGNORE">
+<!entity p-version "2.9.15">
+<!entity p-status "beta">
+<!entity % p-not-stable "INCLUDE">
<!entity % p-stable "IGNORE">
<!entity % p-text "INCLUDE"> <!-- define we are a text only doc -->
<!entity % p-authors-formal "INCLUDE"> <!-- include additional text, etc -->

Index: buildsource.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/buildsource.sgml,v
retrieving revision 2.4
retrieving revision 2.5
diff -u -d -r2.4 -r2.5
--- buildsource.sgml 25 Sep 2002 01:31:36 -0000 2.4
+++ buildsource.sgml 18 Jul 2006 14:48:50 -0000 2.5
@@ -18,7 +18,7 @@
This file is included into:

user-manual
- INSTALL
+ README

-->

@@ -34,7 +34,7 @@
<para>
When building from a source tarball (either release version or
<ulink
- url="http://cvs.sourceforge.net/cvstarballs/ijbswa-cvsroot.tar.gz";>nightly CVS
+ url="http://cvs.sourceforge.net/cvstarballs/ijbswa-cvsroot.tar.bz2";>nightly
CVS
tarball</ulink>), first unpack the source:
</para>

@@ -65,40 +65,7 @@
</para>

<para>
- You can also check out any <application>Privoxy</application>
- <quote>branch</quote>, just exchange the <application>current</application>
- name with the wanted branch name (Example: v_3_0_branch for the 3.0 cvs
- tree).
-</para>
-
-<para>
- It is also recommended to not run <application>Privoxy</application> as
- root, and instead it is suggested to create a <quote>privoxy</quote> user for
- this purpose.
-</para>
-
-<para>
- <filename>/etc/passwd</filename> might then look like:
-</para>
-
-<para>
- <screen> privoxy:*:7777:7777:privoxy proxy:/no/home:/no/shell</screen>
-</para>
-
-<para>
- And then <filename>/etc/group</filename>, like:
-</para>
-
-<para>
- <screen> privoxy:*:7777:privoxy</screen>
-</para>
-
-<para>
- Some binary packages may do this for you.
-</para>
-
-<para>
- Then, to build from either unpacked tarball or CVS source:
+ Then, in either case, to build from unpacked tarball or CVS source:
</para>

<para>
@@ -112,18 +79,9 @@
make install # (to really install)
</screen>
</para>
-<!--
-/we hope this is fixed! 09/24/02
-<warning>
- <para>
- The <quote>make install</quote> target is temporary quite broken! It is
- recommended to use a binary package, or do a source build, and manually
- install the components. Sorry.
- </para>
-</warning>
--->
+
<para>
- If you have GNU <command>make</command>, you can have the first four steps
+ If you have gnu make, you can have the first four steps
automatically done for you by just typing:
</para>

@@ -138,48 +96,6 @@
</para>

<para>
- The default installation path for <command>make install</command> is
- <filename>/usr/local</filename>. This may of course be customized with
- the various <command>./configure</command> path options.
- <command>configure</command> also accepts a <literal>--with-user</literal> and
- <literal>--with-group</literal> options for setting user and group
- ownership.
-</para>
-
-<para>
- If you do install to <filename>/usr/local</filename>, the install will use
- <literal>sysconfdir=$prefix/etc/privoxy</literal> by default. All other
- destinations, and the direct usage of <literal>--sysconfdir</literal> flag
- behave like normal, i.e. will not add the extra <filename>privoxy</filename>
- directory. This is for a safer install, as there may already exist another
- program that uses a file with the <quote>config</quote> name, and thus makes
- <filename>/usr/local/etc</filename> cleaner.
-</para>
-
-<para>
- If installing to <filename>/usr/local</filename>, the docs will go by default
- to <filename>$prefix/share/doc</filename>. But if this directory doesn't
- exist, it will then try <filename>$prefix/doc</filename> and install there
before
- creating a new <filename>$prefix/share/doc</filename> just for
- <application>Privoxy</application>.
-</para>
-
-<para>
- Again, if the installs goes to <filename>/usr/local</filename>, the
- <literal>localstatedir</literal> (ie: var/) will default to
- <filename>/var</filename> instead of <literal>$prefix/var</literal> so the
- logs will go to <filename>/var/log/privoxy/</filename>, and the pid file will
- be created in <filename>/var/run/privoxy.pid</filename>.
-</para>
-
-<para>
- <command>make install</command> will attempt to set the correct values
- in <filename>config</filename> (main configuration file). If appropriate,
- an init script will be installed, but it is up to the user to determine
- how and where to start <application>Privoxy</application>.
-</para>
-
-<para>
For more detailed instructions on how to build Redhat and SuSE RPMs,
Windows self-extracting installers, building on platforms with
special requirements etc, please consult the <ulink
@@ -187,10 +103,9 @@
</para>

<!-- print for README only -->
-<!-- Actually this is now in INSTALL -->
<![%p-readme;[
<para>
- For binary RPM installation, and other platforms, see the User Manual
+ For binary RPM installation, and other platforms, see the user-manual
as well.
</para>
]]>

Index: config.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/config.sgml,v
retrieving revision 2.2
retrieving revision 2.3
diff -u -d -r2.2 -r2.3
--- config.sgml 5 Sep 2002 05:45:30 -0000 2.2
+++ config.sgml 18 Jul 2006 14:48:50 -0000 2.3
@@ -1,9 +1,9 @@
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[
<!entity % dummy "IGNORE">
<!entity config SYSTEM "p-config.sgml">
-<!entity p-version SYSTEM "doc_version.tmp">
-<!entity p-status SYSTEM "doc_status.tmp">
-<!entity % p-not-stable "IGNORE">
+<!entity p-version "2.9.15">
+<!entity p-status "beta">
+<!entity % p-not-stable "INCLUDE">
<!entity % user-man "IGNORE">
<!entity % config-file "IGNORE">
]>

Index: contacting.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/contacting.sgml,v
retrieving revision 2.2
retrieving revision 2.3
diff -u -d -r2.2 -r2.3
--- contacting.sgml 4 Sep 2002 01:55:44 -0000 2.2
+++ contacting.sgml 18 Jul 2006 14:48:50 -0000 2.3
@@ -5,7 +5,7 @@

$Id$

- Copyright (C) 2001, 2002 Privoxy Developers <developers@xxxxxxxxxxx>
+ Copyright (C) 2001 - 2004 Privoxy Developers <developers@xxxxxxxxxxx>
See LICENSE.

======================================================================
@@ -35,8 +35,8 @@

<sect2 id="contact-support"><title>Get Support</title>
<para>
- For casual users, our support forum at
- <ulink url="http://sourceforge.net/";>SourceForge</ulink>
+ For casual users, our
+ <ulink
url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118";>support
forum at SourceForge</ulink>
is probably best suited:
<ulink
url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118";>http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118</ulink>
</para>

Index: copyright.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/copyright.sgml,v
retrieving revision 2.2
retrieving revision 2.3
diff -u -d -r2.2 -r2.3
--- copyright.sgml 4 Sep 2002 01:55:44 -0000 2.2
+++ copyright.sgml 18 Jul 2006 14:48:50 -0000 2.3
@@ -5,7 +5,7 @@

$Id$

- Copyright (C) 2001, 2002 Privoxy Developers <developers@xxxxxxxxxxx>
+ Copyright (C) 2001-2004 Privoxy Developers <developers@xxxxxxxxxxx>
See LICENSE.

======================================================================
@@ -36,7 +36,7 @@
-->

<para>
- Copyright &my-copy; 2001, 2002 by Privoxy Developers
<email>developers@xxxxxxxxxxx</email>
+ Copyright &my-copy; 2001 - 2004 by Privoxy Developers
<email>developers@xxxxxxxxxxx</email>
</para>

<para>

Index: developer-manual.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/developer-manual.sgml,v
retrieving revision 2.6
retrieving revision 2.7
diff -u -d -r2.6 -r2.7
--- developer-manual.sgml 11 Dec 2002 13:13:32 -0000 2.6
+++ developer-manual.sgml 18 Jul 2006 14:48:50 -0000 2.7
@@ -8,10 +8,10 @@
<!entity contacting SYSTEM "contacting.sgml">
<!entity copyright SYSTEM "copyright.sgml">
<!entity license SYSTEM "license.sgml">
-<!entity p-version SYSTEM "doc_version.tmp">
-<!entity p-status SYSTEM "doc_status.tmp">
+<!entity p-version "3.0.0">
+<!entity p-status "stable">
<!entity % p-not-stable "IGNORE">
-<!entity % p-stable "IGNORE">
+<!entity % p-stable "INCLUDE">
<!entity % p-text "IGNORE"> <!-- define we are not a text only doc -->
<!entity % p-doc "INCLUDE"> <!-- and we are a formal doc -->
<!entity my-copy "&copy;"> <!-- kludge for docbook2man -->
@@ -30,7 +30,9 @@

========================================================================
NOTE: Please read developer-manual/documentation.html before touching
- anything in this, or other Privoxy documentation.
+ anything in this, or other Privoxy documentation. You have been warned!
+ Failure to abide by this rule will result in the revocation of your license
+ to live a peaceful existence!
========================================================================

-->
@@ -93,9 +95,8 @@
<!-- end boilerplate -->

<para>
- <![%p-stable;[
Please note that this document is constantly evolving. This copy represents
- the state at the release of version &p-version;. ]]>
+ the state at the release of version &p-version;.
You can find the latest version of the this manual at <ulink

url="http://www.privoxy.org/developer-manual/";>http://www.privoxy.org/developer-manual/</ulink>.
Please see <link linkend="contact">the Contact section</link>
@@ -201,12 +202,11 @@
is always at least one <quote>branch</quote> from the main trunk
devoted to a stable release series. The main trunk is where active
development takes place for the next stable series (e.g. 3.2.x).
- And for testing bugfixes for the stable series. Just prior to each
- stable series (e.g. 3.0.x), a branch is created just for stable series
- releases (e.g. 3.0.0 -> 3.0.1 -> 3.0.2, etc). Once the initial stable
- release of any stable branch has taken place, this branch is
- <emphasis>only used for bugfixes</emphasis>, which have had prior
- testing before being committed to CVS. (See <link
+ So just prior to each stable series (e.g. 3.0.x), a branch is created
+ just for stable series releases (e.g. 3.0.0 -> 3.0.1 -> 3.0.2, etc).
+ Once the initial stable release of any stable branch has taken place,
+ this branch is <emphasis>only used for bugfixes</emphasis>, which have
+ had prior testing before being committed to CVS. (See <link
linkend="versionnumbers">Version Numbers</link> below for details on
versioning.)
</para>
@@ -272,10 +272,10 @@
</para>

<para>
- Stable branches are handled with decidedly more care, especially after
- the initial *.*.0 release, and we are just in bugfix mode. In addition
- to the above, the below applies only to the stable branch (currently
- the <literal>v_3_0_branch</literal> branch):
+ Stable branches are handled with more care, especially after the
+ initial *.*.0 release, and we are just in bugfix mode. In addition to
+ the above, the below applies only to the stable branch (currently the
+ <literal>v_3_0_branch</literal> branch):
</para>

<para>
@@ -2095,7 +2095,7 @@
<para>
First you need to determine which version number the release will have.
<application>Privoxy</application> version numbers consist of three
numbers,
- separated by dots, like in X.Y.Z (e.g. <literal>3.0.0</literal>), where:
+ separated by dots, like in X.Y.Z (e.g. 3.0.0), where:
<itemizedlist>
<listitem>
<para>
@@ -3029,25 +3029,20 @@
Temple Place - Suite 330, Boston, MA 02111-1307, USA.

$Log$
- Revision 2.6 2002/12/11 13:13:32 hal9
- Rewrite cvs write access section.
+ Revision 2.7 2006/07/18 14:48:50 david__schmidt
+ Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch)
+ with what was really the latest development (the v_3_0_branch branch)

- Revision 2.5 2002/09/26 21:50:39 hal9
+ Revision 1.46.2.11 2002/12/11 13:12:15 hal9
+ Rewrite cvs write access give-away section.
+
+ Revision 1.46.2.10 2002/09/26 21:53:45 hal9
Changes to reflect recent change in stable branch commit policy (hopefully
clearer now).

- Revision 2.4 2002/09/26 05:57:14 hal9
- Conditionally exclude 'this doc is evolving' comment in intro for non release
- situations.
-
- Revision 2.3 2002/09/05 02:27:59 hal9
- Mention tested stable branch fixes in main trunk, as alternate to posting
- patches.
-
- Revision 2.2 2002/09/04 01:55:44 hal9
- Migrating developer manual, and related sgml files from 3.0. Add additional
- commentary on cvs, versioning, stable branches, and how to handle stable
- branches in cvs.
+ Revision 1.46.2.9 2002/09/26 01:21:40 hal9
+ Porting 3.1.1 changes: more on cvs and branches, more on versions and
+ releases.

Revision 1.46.2.8 2002/08/17 00:16:10 hal9
Add note on updating webserver for User-manual/CGI editor, which is version

Index: faq.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/faq.sgml,v
retrieving revision 2.10
retrieving revision 2.11
diff -u -d -r2.10 -r2.11
--- faq.sgml 1 Dec 2002 06:31:27 -0000 2.10
+++ faq.sgml 18 Jul 2006 14:48:50 -0000 2.11
@@ -8,10 +8,10 @@
<!entity history SYSTEM "history.sgml">
<!entity copyright SYSTEM "copyright.sgml">
<!entity license SYSTEM "license.sgml">
-<!entity p-version SYSTEM "doc_version.tmp">
-<!entity p-status SYSTEM "doc_status.tmp">
+<!entity p-version "3.0.3">
+<!entity p-status "stable">
<!entity % p-not-stable "IGNORE">
-<!entity % p-stable "IGNORE">
+<!entity % p-stable "INCLUDE">
<!entity % p-text "IGNORE"> <!-- define we are not a text only doc -->
<!entity % p-doc "INCLUDE"> <!-- and we are a formal doc -->
<!entity % p-supp-userman "INCLUDE"> <!-- Include all from supported.sgml -->
@@ -26,7 +26,7 @@

$Id$

- Copyright (C) 2001, 2002 Privoxy Developers <developers@xxxxxxxxxxx>
+ Copyright (C) 2001-2004 Privoxy Developers <developers@xxxxxxxxxxx>
See LICENSE.

Based partially on the Internet Junkbuster FAQ originally written by and
@@ -50,9 +50,12 @@

========================================================================
NOTE: Please read developer-manual/documentation.html before touching
- anything in this, or other Privoxy documentation. You have been warned!
- Failure to abide by this rule will result in the revocation of your license
- to live a peaceful existence!
+ this file!
+
+ Please we keep the info in this file as version independent as possible
+ so we only have to maintain one FAQ. Where significant changes are
+ made to Privoxy configuration, please note the change in such a way that
+ it makes sense to both users of older and newer versions.
========================================================================


@@ -67,7 +70,7 @@
<subscript>
<!-- Completely the wrong markup, but very little is allowed -->
<!-- in this part of an article. FIXME -->
- <link linkend="copyright">Copyright</link> &my-copy; 2001, 2002 by
+ <link linkend="copyright">Copyright</link> &my-copy; 2001-2004 by
<ulink url="http://www.privoxy.org";>Privoxy Developers</ulink>
</subscript>
</pubdate>
@@ -126,9 +129,8 @@
<!-- end boilerplate -->

<para>
- <![%p-stable;[
Please note that this document is constantly evolving. This copy represents
- the state at the release of version &p-version;. ]]>
+ the state at the release of version &p-version;.
You can find the latest version of the document at <ulink
url="http://www.privoxy.org/faq/";>http://www.privoxy.org/faq/</ulink>.
Please see the <link linkend="contact">Contact section</link> if you want to
@@ -274,8 +276,8 @@
This does not sound very scientific.</title>
<para>
Actually, it's a black art ;-) And yes, it is always possible to have a broad
- rule accidentally block or change something by mistake. There is a good chance
- you may run into such a situation at some point. It is tricky writing rules to
+ rule accidentally block or change something by mistake. You will almost surely
+ run into such situations at some point. It is tricky writing rules to
cover every conceivable possibility, and not occasionally get false positives.
</para>

@@ -290,6 +292,24 @@
</sect2>


+<sect2 renderas="sect3">
+<title id="configornot">Will I have to configure
<application>Privoxy</application>
+ before I can use it?</title>
+<para>
+ No, not really. The default installation should give you a good starting
+ point, and block <emphasis>most</emphasis> unwanted content.
+</para>
+<para>
+ But you will certainly run into situations where there are false positives,
+ or ads not being blocked that you may not want to see. In these cases, you
+ would certainly benefit by customizing <application>Privoxy's</application>
+ configuration to more closely match your individual situation. And we would
+ encourage you to do this. This is where the real power of
+ <application>Privoxy</application> lies!
+</para>
+
+</sect2>
+
<sect2 renderas="sect3" id="browsers2"><title>My browser does the same things
as
<application>Privoxy</application>. Why should I use
<application>Privoxy</application> at all?</title>
@@ -397,12 +417,13 @@
<sect2 renderas="sect3" id="email-client">
<title>Can I use <application>Privoxy</application> with my email
client?</title>
<para>
- As long as there is some way to set a HTTP proxy for the client, then yes,
+ As long as there is some way to set a HTTP proxy for the client, then yes,
any application can be used, whether it is strictly speaking a
<quote>browser</quote> or not. Though this may not be the best approach for
dealing with some of the common abuses of HTML in email. See <link
- linkend="outlook">How can I configure <application>Privoxy</application> with
- <application>Outlook Express</application>?</link> below for more on this.
+ linkend="outlook">How can I configure <application>Privoxy</application>
+ with <application>Outlook Express</application>?</link> below for more on
+ this.
</para>
<para>
Be aware that HTML email presents a number of unique security and privacy
@@ -440,7 +461,7 @@
as a proxy by specifying the correct proxy address and port number
in the appropriate configuration area for the browser. See below.
You should also flush your browser's memory and disk cache to get rid of any
- cached junk items, and any stored cookies.
+ cached junk items, and remove any stored cookies.

</para>

@@ -476,8 +497,7 @@
</para>
<para>
<application>Privoxy</application> does not currently handle
- protocols such as FTP, SMTP, IM, IRC, ICQ, or other Internet
- protocols.
+ any other protocols such as FTP, SMTP, IM, IRC, ICQ, etc.
</para>
</sect2>

@@ -491,7 +511,9 @@
the browser's caches to force a full re-reading of pages. You can verify
that <application>Privoxy</application> is running, and your browser
is correctly configured by entering the special URL:
- <ulink url="http://config.privoxy.org/";>http://config.privoxy.org/</ulink>.
+ <ulink url="http://p.p/";>http://p.p/</ulink>.
+ <!-- Use http://p.p/ instead of http://config.privoxy.org/ here because
+ of potential redirect caching problem (see next Q). -->
This should take you to a page titled <quote>This is Privoxy..</quote> with
access to <application>Privoxy's</application> internal configuration.
If you see this, then you are good to go. If you receive a page saying
@@ -500,9 +522,45 @@
If you receive anything else (probably nothing at all), it could either
be that the browser is not set up correctly, or that
<application>Privoxy</application> is not running at all. Check the <ulink
- url="../user-manual/config.html#LOGFILE">log file</ulink>.
+ url="../user-manual/config.html#LOGFILE">log file</ulink>. For instructions
+ on starting <application>Privoxy</application> and browser configuration,
+ see the <ulink url="http://www.privoxy.org/user-manual/startup.html";>chapter
+ on starting <application>Privoxy</application></ulink> in the
+ <ulink url="http://www.privoxy.org/user-manual/";>user manual</ulink>.
+</para>
+
+</sect2>
+
+<sect2 renderas="sect3" id="notused">
+<title>I get a <quote>Privoxy is not being used</quote> dummy page although
+<application>Privoxy</application> is running and being used.</title>
+
+<para>
+ First, make sure that Privoxy is <emphasis>really</emphasis> running and
+ being used by visiting <ulink url="http://p.p/";>http://p.p/</ulink>. You
+ should see the <application>Privoxy</application> main page. If not, see
+ the <ulink url="http://www.privoxy.org/user-manual/startup.html";>chapter
+ on starting <application>Privoxy</application></ulink> in the
+ <ulink url="http://www.privoxy.org/user-manual/";>user manual</ulink>.
+</para>
+
+<para>
+ Now if <ulink url="http://p.p/";>http://p.p/</ulink> works for you, but
+ other parts of <application>Privoxy</application>'s web interface show
+ the dummy page, your browser has cached a redirection it encountered before
+ <application>Privoxy</application> was being used. You need to clear your
+ browser's cache. Note that shift-reloading the dummy page won't help, since
+ that'll only refresh the dummy page, not the redirection that lead you there.
</para>

+<para>
+ The procedure for clearing the cache varies from browser to browser. As an
+ example, <application>Mozilla</application> users would click
+ <guibutton>Edit</guibutton> --> <guibutton>Preferences</guibutton> -->
+ <guibutton>Advanced</guibutton> --> <guibutton>Cache</guibutton> and
+ then click both <quote><guibutton>Clear Memory Cache</guibutton></quote>
+ and <quote><guibutton>Clear Disk Cache</guibutton></quote>.
+</para>
</sect2>

</sect1>
@@ -597,7 +655,6 @@
</sect2>


-<!-- ~~~~~ New section ~~~~~ -->
<sect2 renderas="sect3">
<title>There are several different <quote>actions</quote> files. What are
the differences?</title>
@@ -643,152 +700,29 @@
</sect2>

<sect2 renderas="sect3" id="configfiles"> <title>What's the difference between
the
-<quote>Cautious</quote>, <quote>Medium</quote> and <quote>Radical</quote>
defaults?</title>
+<quote>Cautious</quote>, <quote>Medium</quote> and
<quote>Adventuresome</quote> defaults?</title>
<para>
Configuring <application>Privoxy</application> is not entirely trivial. To
help you get started, we provide you with three different default action
<quote>profiles</quote> in the web based actions file editor at <ulink

url="http://config.privoxy.org/show-status";>http://config.privoxy.org/show-status</ulink>.
- The following table shows you, which of the most important features are
- enabled in each configuration:
+ See the <ulink url="../user-manual/actions-file.html"><citetitle>User
+ Manual</citetitle></ulink> for a list of actions, and how the default
+ profiles are set.
</para>
- <para>
-<table frame=all><title>Default Configurations</title>
-<tgroup cols=4 align=left colsep=1 rowsep=1>
-<colspec colname=c1>
-<colspec colname=c2>
-<colspec colname=c3>
-<colspec colname=c4>
-<thead>
-<row>
- <entry>Feature</entry>
- <entry>Cautious</entry>
- <entry>Intermadiate</entry>
- <entry>Radical</entry>
-</row>
-</thead>
-<!-- <tfoot> -->
-<!-- <row> -->
-<!-- <entry>f1</entry> -->
-<!-- <entry>f2</entry> -->
-<!-- <entry>f3</entry> -->
-<!-- <entry>f4</entry> -->
-<!-- </row> -->
-<!-- </tfoot> -->
-<tbody>
-
-<row>
- <entry>Ad-blocking by URL</entry>
- <entry>yes</entry>
- <entry>yes</entry>
- <entry>yes</entry>
-</row>
-
-<row>
- <entry>Ad-filtering by size</entry>
- <entry>yes</entry>
- <entry>yes</entry>
- <entry>yes</entry>
-</row>
-
-<row>
- <entry>GIF de-animation</entry>
- <entry>no</entry>
- <entry>yes</entry>
- <entry>yes</entry>
-</row>
-
-<row>
- <entry>Referer forging</entry>
- <entry>no</entry>
- <entry>yes</entry>
- <entry>yes</entry>
-</row>
-
-<row>
- <entry>Cookie handling</entry>
- <entry>none</entry>
- <entry>session-only</entry>
- <entry>kill</entry>
-</row>
-
-<row>
- <entry>Pop-up killing</entry>
- <entry>no</entry>
- <entry>yes</entry>
- <entry>yes</entry>
-</row>
-
-<row>
- <entry>Fast redirects</entry>
- <entry>no</entry>
- <entry>no</entry>
- <entry>yes</entry>
-</row>
-
-<row>
- <entry>HTML taming</entry>
- <entry>yes</entry>
- <entry>yes</entry>
- <entry>yes</entry>
-</row>
-
-<row>
- <entry>JavaScript taming</entry>
- <entry>yes</entry>
- <entry>yes</entry>
- <entry>yes</entry>
-</row>
-
-<row>
- <entry>Web-bug killing</entry>
- <entry>yes</entry>
- <entry>yes</entry>
- <entry>yes</entry>
-</row>
-
-<row>
- <entry>Fun text replacements</entry>
- <entry>no</entry>
- <entry>no</entry>
- <entry>yes</entry>
-</row>
-
-<row>
- <entry>Image tag reordering</entry>
- <entry>no</entry>
- <entry>no</entry>
- <entry>yes</entry>
-</row>
-
-<row>
- <entry>Ad-filtering by link</entry>
- <entry>no</entry>
- <entry>no</entry>
- <entry>yes</entry>
-</row>
-
-<row>
- <entry>Demoronizer</entry>
- <entry>no</entry>
- <entry>no</entry>
- <entry>yes</entry>
-</row>

-</tbody>
-</tgroup>
-</table>
-</para>
<para>
Where the defaults are likely to break some sites, exceptions for
known popular <quote>problem</quote> sites are included, but in
- general, the more aggressive your default settings are, the more
- exceptions you will have to make later. See the <ulink
- url="../user-manual/index.html">user manual</ulink> for a more
- deatiled discussion.
+ general, the more aggressive your default settings are, the more exceptions
+ you will have to make later. See the <ulink
+ url="../user-manual/index.html"><citetitle>User Manual</citetitle></ulink>
+ for a more deatiled discussion.
</para>
+
<para>
- It should be noted that the <quote>Radical</quote> profile is not only more
+ It should be noted that the <quote>Adventuresome</quote> profile (formerly
known
+ as the <quote>Advanced</quote> profile) is not only more
aggressive, but also includes fun and, extreme usage of most of
<application>Privoxy's</application> features. Use at your own risk!
</para>
@@ -868,7 +802,7 @@

url="../user-manual/config.html#LISTEN-ADDRESS">listen-address</ulink></literal>
option, which may be commented out with a <quote>#</quote> symbol. Make sure
it is uncommented, and assign it the address of the LAN gateway interface,
- and port number to use. Assuming your server's LAN address is 192.168.1.1 and
you
+ and port number to use. Assuming your LAN address is 192.168.1.1 and you
wish to run <application>Privoxy</application> on port 8118, this line
should look like:
</para>
@@ -908,7 +842,7 @@

<para>
If you run <application>Privoxy</application> on a LAN with untrusted users,
- we recommend that you double-check all <ulink
+ we recommend that you double-check the <ulink
url="../user-manual/config.html#ACCESS-CONTROL">access control and
security</ulink>
options!
</para>
@@ -1073,6 +1007,7 @@
</para>
</sect2>

+
<sect2 renderas="sect3" id="otherproxy">
<title>How can I make <application>Privoxy</application> work with other
proxies like <application>Squid</application>?</title>
@@ -1139,8 +1074,8 @@
<application>Privoxy</application> just blindly proxies all requests. In the
case of <application>Outlook Express</application> (see above), OE uses
IE anyway, and there is no way for <application>Privoxy</application> to ever
- be able to distinguish between them (nor could any other proxy type
- application for that matter).
+ be able to distinguish between them (nor could any other proxy type
application for
+ that matter).
</para>
<para>
For a good discussion of some of the issues involved (including privacy and
@@ -1172,7 +1107,7 @@
be off by default anyway, so this might be redundant, but there is no harm
being explicit in what you want to happen. <filename>user.action</filename>
includes an alias for this situation, called
- <literal>allow-cookies</literal>.
+ <literal>allow-all-cookies</literal>.
</para>
</sect2>

@@ -1226,7 +1161,12 @@
noticeable on slow dialup connections.
</para>
<para>
- Filtering is automatically disabled for inappropriate MIME types.
+ Filtering is automatically disabled for inappropriate MIME types. But note
+ that if the web server mis-reports the MIME type, then content that should
+ not be filtered, could be. <application>Privoxy</application> only knows how
+ to differentiate filterable content because of the MIME type as reported by
+ the server, or because of some configuration setting that enables/disables
+ filtering.

</para>
</sect2>
@@ -1577,24 +1517,65 @@
viewing a document (i.e. a page), and downloading a file. The same is true of
<application>Privoxy</application>. If there is a match for a <literal><ulink
url="../user-manual/actions-file.html#BLOCK">block</ulink></literal> pattern,
- it will still be blocked, and of course this is obvious. Filtering is
- potentially more of a concern since the results are not always so obvious.
+ it will still be blocked, and of course this is obvious.
+ </para>
+ <para>
+ Filtering is potentially more of a concern since the results are not always
+ so obvious, and the effects of filtering are there whether the file is simply
+ viewed, or downloaded. And potentially whether the content is some obnoxious
+ advertizement, or Mr. Jimmy's latest/greatest source code jewel. Of course,
+ one of these presumably is <quote>bad</quote> content that we don't want, and
+ the other is <quote>good</quote> content that we do want.
+ <application>Privoxy</application> is blind to the differences, and can only
+ distinguish <quote>good from bad</quote> by the configuration parameters
+ <emphasis>we</emphasis> give it.
</para>
<para>
<application>Privoxy</application> knows the differences in files according
to the <quote>Document Type</quote> as reported by the webserver. If this is
reported accurately (e.g. <quote>application/zip</quote> for a zip archive),
then <application>Privoxy</application> knows to ignore these where
- appropriate. It is possible, however, that documents that are of an unknown
- type (generally assumed to be <quote>text/plain</quote>) will be filtered, as
- will those that might be incorrectly reported by the webserver. If such a
- file is a downloaded file that is intended to be saved to disk, then any
- content that might have been altered by filtering, will be saved too, for
- these (probably very rare) cases.
+ appropriate. <application>Privoxy</application> potentially can filter HTML
+ as well as plain text documents, subject to configuration parameters of
+ course. Also, documents that are of an unknown type (generally assumed to be
+ <quote>text/plain</quote>) can be filtered, as will those that might be
+ incorrectly reported by the webserver. If such a file is a downloaded file
+ that is intended to be saved to disk, then any content that might have been
+ altered by filtering, will be saved too, for these (probably rare) cases.
+</para>
+<para>
+ Note that versions later than 3.0.2 do NOT filter document types of
+ <quote>text/plain</quote>. Prior to this, <application>Privoxy</application>
+ did filter this document type.
+</para>
+<para>
+ In short, filtering is <quote>ON</quote> if a) the Document Type as reported
+ by the webserver is appropriate <emphasis>and</emphasis> b) the configuration
+ allows it (or at least does not disallow it). That's it. There is no magic
+ cookie anywhere to say this is <quote>good</quote> and this is
+ <quote>bad</quote>. It's the configuration that let's it all happen or not.
+</para>
+<para>
+ If you download text files, you probably do not want these to be filtered,
+ particularly if the content is source code, or other critical content. Source
+ code sometimes might be mistaken for Javascript (i.e. the kind that might
+ open a pop-up window). It is recommended to turn off filtering for download
+ sites (particularly if the content may be plain text files and you are using
+ version 3.0.2 or earlier) in your <filename>user.action</filename> file. And
+ also, for any site or page where making <emphasis>any</emphasis> changes at
+ all to the content is to be avoided.
</para>
<para>
<application>Privoxy</application> does not do FTP at all, only HTTP
- protocols.
+ protocols, so please don't even try.
+</para>
+</sect2>
+
+<sect2 renderas="sect3" id="downloads2">
+<title>I just downloaded a Perl script, and <application>Privoxy</application>
+altered it! Yikes, what is wrong!</title>
+<para>
+ Please read above.
</para>
</sect2>

@@ -1625,7 +1606,8 @@
activated the <quote><literal>fun</literal></quote> filter which
is clearly labeled <quote>Text replacements for subversive browsing
fun!</quote> or you have implicitly activated it by choosing the
- <quote>Radical</quote> profile in the web-based editor.
+ <quote>Adventuresome</quote> profile in the web-based editor (formerly known
+ as the <application>Advanced</application> profile).
</para>
</sect2>

@@ -1787,7 +1769,8 @@
<para>
<application>Privoxy</application> cannot act as a proxy for FTP traffic,
so do not configure your browser to use <application>Privoxy</application>
- as an FTP proxy. The same is true for any protocol other than HTTP or HTTPS.
+ as an FTP proxy. The same is true for <emphasis>any protocol other than HTTP
+ or HTTPS</emphasis>.
</para>
<para>
Most browsers understand FTP as well as HTTP. If you connect to a site, with
@@ -1796,6 +1779,18 @@
speak FTP, <application>Privoxy</application> does not, and cannot proxy
such traffic.
</para>
+ <para>
+ To complicate matters, some systems may have a generic <quote>proxy</quote>
+ setting, which will silently enable <emphasis>both</emphasis> HTTP and FTP
+ proxying! So it is possible to accidentally enable FTP proxying in these
+ cases. And of course, if this happens, <application>Privoxy</application>
+ will indeed cause problems since it does not know FTP.
+ </para>
+ <para>
+ Will <application>Privoxy</application> ever proxy FTP traffic? Unlikely.
+ There just is not much reason, and the work to make this happen is more than
+ it may seem.
+ </para>
</sect2>

<!-- ~~~~~ New section ~~~~~ -->
@@ -1834,6 +1829,19 @@


<!-- ~~~~~ New section ~~~~~ -->
+<sect2 renderas="sect3" id="osximages">
+<title>In Mac OSX Panther (10.3), images often fail to load and/or I
+ experience random delays in page loading. I'm using
+ <literal>localhost</literal> as my browser's proxy setting.</title>
+ <para>
+ We believe this is due to an IPv6-related bug in OSX, but don't fully
+ understand the issue yet. In any case, changing the proxy setting to
+ <literal>127.0.0.1</literal> instead of <literal>localhost</literal>
+ works around the problem.
+ </para>
+</sect2>
+
+<!-- ~~~~~ New section ~~~~~ -->
<sect2 renderas="sect3" id="blankpage">
<title>I get a completely blank page at one site. <quote>View Source</quote>
shows only: <markup><![CDATA[<html><body></body></html>]]></markup>. Without
@@ -1875,20 +1883,123 @@
</para>
</sect2>

-</sect1>
-<!--
-</sect1>
--->
+<sect2 renderas="sect3" id="nohostname">
+<title>My logs show many <quote>Unable to get my own hostname</quote> lines.
+Why?</title>
+<para>
+ <application>Privoxy</application> tries to get the hostname of the system
+ its running on from the IP address of the system interface it is bound to
+ (from the <filename>config</filename> file
+ <emphasis>listen-address</emphasis> setting). If the system cannot supply
+ this information, <application>Privoxy</application> logs this condition.
+</para>
+<para>
+ Typically, this would be considered a system configuration error. It is not a
+ fatal error to <application>Privoxy</application> however, but may result in
+ a much slower response from <application>Privoxy</application> due to DNS
+ timeouts.
+</para>
+</sect2>

-<!-- ~~~~~ New section ~~~~~ -->
-<!--
-FIXME: Commented out until we have something to put here. HB 03/18/02.
-<sect1 id="knownissues"><title>Known Issues</title>
+<sect2 renderas="sect3" id="inuse">
+<title>When I try to launch <application>Privoxy</application>, I get an
+error message <quote>port 8118 is already in use</quote> (or similar wording).
+Why?</title>
<para>
- Fill me.
+ Port 8118 is <application>Privoxy's</application> default TCP
+ <quote>listening</quote> port. Typically this message would mean that there
+ is already one instance of <application>Privoxy</application> running, and
+ you are actually trying to start a second <application>Privoxy</application>
+ on the same port, which will not work. How and why this might happen varies
+ from platform to platform, but you need to check your installation and
+ start-up procedures.
</para>
+</sect2>
+
+<sect2 renderas="sect3" id="demoronizer">
+<title>
+ Pages with UTF-8 fonts are garbled.
+</title>
+<para>
+ This is caused by the <quote>demoronizer</quote> filter, which was introduced
+ in version 3.0.2, and was inappropriately turned on by default. You should
+ either upgrade <application>Privoxy</application>, or at least upgrade to the
most
+ recent <filename>default.action</filename> file available from
+ <ulink
url="http://sourceforge.net/project/showfiles.php?group_id=11118";>SourceForge</ulink>.
+ Or you can simply disable the demoronizer filter.
+</para>
+</sect2>
+
+<sect2 renderas="sect3" id="demoronizer2">
+<title>
+ Why are binary files (such as images) corrupted when
<application>Privoxy</application>
+ is used?
+</title>
+<para>
+ This may also be caused by the <quote>demoronizer</quote> filter,
+ in conjunction with a web server that is misreporting a file type. Binary
+ files are exempted from <application>Privoxy's</application> filtering
+ (unless the web server by mistake says the file is a plain text file). Either
+ upgrade <application>Privoxy</application>, or go to the most recent
+ <filename>default.action</filename> file available from <ulink
+
url="http://sourceforge.net/project/showfiles.php?group_id=11118";>SourceForge</ulink>.
+</para>
+</sect2>
+
+<sect2 renderas="sect3" id="demoronizer3">
+<title>
+ What is the <quote>demoronizer</quote> and why is it there?
+</title>
+<para>
+ The original demoronizer was a Perl script that cleaned up HTML pages which
+ were created with certain Microsoft products. MS has used proprietary
extensions
+ to standardized font encodings (ISO 8859-1), which has caused problems for
pages
+ that are viewed with non-Microsoft products (and are expecting to see a
+ standard set of fonts). The demoronizer corrected these errors so the pages
+ displayed correctly. <application>Privoxy</application> borrowed from this
+ script, introducing a filter based on the original demoronizer, which in turn
could
+ correct these errors on the fly.
+</para>
+<para>
+ But this is only needed in some situations, and will cause serious problems
in some
+ other situations.
+</para>
+<para>
+ If you are using Microsoft products, you do not need it. If you need to view
+ pages with UTF-8 characters (such as Cyrillic or Chinese), then it will
+ cause corruption of the fonts, and thus <emphasis>should not be on</emphasis>.
+</para>
+<para>
+ On the other hand, if you use non-Microsoft products, and you occasionally
+ notice wierd characters on pages, you might want to try it.
+</para>
+<para>
+ This filter was introduced with version 3.0.2 of
<application>Privoxy</application>,
+ and was on by default in that version. It is off in all subsequent versions
+ (unless turned on by the user).
+</para>
+</sect2>
+
+<sect2 renderas="sect3" id="windowopen">
+<title>
+ Why do I keep seeing <quote>PrivoxyWindowOpen()</quote> in raw source code?
+</title>
+<para>
+ <application>Privoxy</application> is attempting to disable malicious
+ Javascript in this case, with the <literal>unsolicited-popups</literal>
+ filter. <application>Privoxy</application> cannot tell very well
+ <quote>good</quote> code snippets from <quote>bad</quote> code snippets.
+</para>
+<para>
+ If you see this in HTML source, and the page displays without problems, then
+ this is good, and likely some pop-up window was disabled. If you see this
+ where it is causing a problem, such as a downloaded program source code file,
+ then you should set an exception for this site or page such that the
+ integrity of the page stays in tact by disabling all filtering.
+</para>
+</sect2>
+
</sect1>
--->

<!-- ~~~~~ New section ~~~~~ -->
<sect1 id="contact"><title>Contacting the developers, Bug Reporting and
Feature Requests</title>
@@ -1904,6 +2015,7 @@
&copyright;
<!-- end -->

+
<para>
Portions of this document are <quote>borrowed</quote> from the original
<application>Junkbuster</application> (tm) FAQ, and modified as
@@ -1946,8 +2058,6 @@
<!--
Tue 09/11/01 06:38:14 PM EST: Test SGML doc by Hal Burgiss.

- Last modified: Mon Sep 10 19:22:09 CEST 2001
-
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General
Public License as published by the Free Software
@@ -1967,35 +2077,82 @@
Temple Place - Suite 330, Boston, MA 02111-1307, USA.

$Log$
-Revision 2.10 2002/12/01 06:31:27 hal9
-Add FAQ on error 503 win32.
+Revision 2.11 2006/07/18 14:48:50 david__schmidt
+Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch)
+with what was really the latest development (the v_3_0_branch branch)

-Revision 2.9 2002/10/29 03:22:22 hal9
-Add 3 FAQs relating to HTML in email. Other minor touch ups.
+Revision 1.61.2.41 2004/04/05 13:44:05 oes
+Fixed allow-all-cookies alias name; closes SR #929746

-Revision 2.8 2002/10/15 12:47:23 oes
-Added Microsuck faq; more detail for PHP problem
+Revision 1.61.2.40 2004/01/30 17:00:33 oes
+Added OSX Panther problem

-Revision 2.7 2002/10/12 01:14:42 hal9
-Updates for demoronizer filter, Radical profile, and the srvany.exe/icon
-win32 fix.
+Revision 1.61.2.39 2004/01/29 22:53:08 hal9
+Minor changes for exempting docs of text/plain. Change copyright date.

-Revision 2.6 2002/10/10 04:10:38 hal9
-s/Advanced/Radical/ for standard.action change.
+Revision 1.61.2.38 2003/12/10 03:39:45 hal9
+Added FAQs for: demoronizer, related problems and why its included. Also,
+port 8118 already in use questions, and PrivoxyWindowOpen() questions. All in
+troubleshooting section.

-Revision 2.5 2002/09/26 05:57:14 hal9
-Conditionally exclude 'this doc is evolving' comment in intro for non release
-situations.
+Revision 1.61.2.37 2003/10/17 11:01:50 oes
+Added Q&A for "not being used" page problem

-Revision 2.4 2002/09/26 00:14:42 hal9
-Small additions for content-cookies/SSL, LAN configuration, and FTP (non)
-support.
+Revision 1.61.2.36 2003/06/26 23:49:20 hal9
+More on the filter/source code problem.

-Revision 2.3 2002/09/13 11:50:55 oes
-Added MicroSuck topic; Updated PHP bug topic
+Revision 1.61.2.35 2003/06/26 13:38:08 hal9
+Add FAQ on whether configuring Privoxy is necessary or not.

-Revision 2.2 2002/09/05 04:25:05 hal9
-Sync with 3.0 branch. No new content.
+Revision 1.61.2.34 2003/06/26 03:00:03 hal9
+Sorry, found another copyright date.
+
+Revision 1.61.2.33 2003/06/26 02:57:05 hal9
+Fix typo (finally!) and very minor modifications.
+
+Revision 1.61.2.32 2003/06/26 02:52:04 hal9
+Test, no changes.
+
+Revision 1.61.2.31 2003/06/25 01:27:51 hal9
+Fix copyright, and a few nits.
+
+Revision 1.61.2.30 2003/06/25 01:13:52 hal9
+Add:
+
+ - FAQ on "Unable to get my own hostname"
+ - Another one on filtering effects on text files.
+
+Revision 1.61.2.29 2003/06/15 21:32:58 hal9
+Add to the 4.17 (filtering effects on downloaded files).
+
+Revision 1.61.2.28 2003/03/18 19:37:21 oes
+s/Advanced|Radical/Adventuresome/g to avoid complaints re fun filter
+
+Revision 1.61.2.27 2002/12/01 06:31:58 hal9
+Add faq on win32 error 503 due to ZoneAlarm.
+
+Revision 1.61.2.26 2002/11/17 06:41:06 hal9
+Move default profiles table from FAQ to U-M, and other minor related changes.
+Add faq on cookies.
+
+Revision 1.61.2.25 2002/10/29 03:21:50 hal9
+Add 3 Q/A's relating to HTML in email. Other minor touchups.
+
+Revision 1.61.2.24 2002/10/15 12:50:22 oes
+s/Advanced/Radical/ (stupid me)
+
+Revision 1.61.2.23 2002/10/15 12:38:56 oes
+Added Microsuck faq; more detail for PHP problem
+
+Revision 1.61.2.22 2002/10/12 01:13:13 hal9
+Updates for demoronizer, more commentary on Radical profile, and update on
+the srvany.exe/icon fix.
+
+Revision 1.61.2.21 2002/10/10 04:09:35 hal9
+s/Advanced/Radical/ and added very brief note.
+
+Revision 1.61.2.20 2002/09/26 01:22:45 hal9
+Small additions for LAN setup, content-cookies/SSL, and FTP non-support.

Revision 1.61.2.19 2002/08/25 23:31:56 hal9
Fix one grammatical error. Add brief FAQ relating to tranparent proxies (ie

Index: history.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/history.sgml,v
retrieving revision 2.3
retrieving revision 2.4
diff -u -d -r2.3 -r2.4
--- history.sgml 4 Sep 2002 01:55:44 -0000 2.3
+++ history.sgml 18 Jul 2006 14:48:50 -0000 2.4
@@ -67,7 +67,7 @@

<para>
The result of this is <application>Privoxy</application>, whose first
- stable release, 3.0, was released August, 2002.
+ stable version, 3.0, was released August, 2002.
<!-- Cautious!!!!!!!!! ;) -->
</para>


Index: install.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/install.sgml,v
retrieving revision 2.1
retrieving revision 2.2
diff -u -d -r2.1 -r2.2
--- install.sgml 6 Sep 2002 01:58:28 -0000 2.1
+++ install.sgml 18 Jul 2006 14:48:50 -0000 2.2
@@ -1,10 +1,10 @@
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
<!entity % dummy "IGNORE">
<!entity buildsource SYSTEM "buildsource.sgml">
-<!entity p-version SYSTEM "doc_version.tmp">
-<!entity p-status SYSTEM "doc_status.tmp">
+<!entity p-version "0.0.0">
+<!entity p-status "UNRELEASED">
<!entity % p-stable "IGNORE">
-<!entity % p-not-stable "IGNORE"> <!-- beta or alpha -->
+<!entity % p-not-stable "INCLUDE">
<!entity % p-alpha "IGNORE">
<!entity % p-beta "IGNORE">
<!entity % p-text "INCLUDE"> <!-- define we are a text only doc -->
@@ -35,27 +35,6 @@
dok-readme'.
===================================================================

- READ:
-
- ======================================================================
- NOTE: The left margin spacing is *important* when using 'literallayout'
- WYSISWYG!!! Don't mess this up!!! Careful with linebreaks too, ie
- the para tag forces a linebreak. Tags need to be carefully placed as a result
- to avoid extra blank lines, etc.
- ======================================================================
-
- For stable releases, change
-
- entity % p-not-stable "INCLUDE"
-
- to
-
- entity % p-not-stable "IGNORE"
-
- in the DTD at the top. This will toggle various text 'off'. BOTH
- MUST be toggled in this case or you will get both text referencing
- stable and unstable versions. You only want one or the other!
-
-->
<article id="index">
<artheader>



Index: p-authors.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/p-authors.sgml,v
retrieving revision 2.8
retrieving revision 2.9
diff -u -d -r2.8 -r2.9
--- p-authors.sgml 25 Mar 2003 00:48:44 -0000 2.8
+++ p-authors.sgml 18 Jul 2006 14:48:51 -0000 2.9
@@ -30,7 +30,6 @@

<literallayout>
Hal Burgiss (docs)
- Jon Foster
Andreas Oesterhelt
David Schmidt (OS/2, Mac OSX ports)
<![%p-authors-formal;[
@@ -48,7 +47,9 @@
Johny Agotnes
Rodrigo Barbosa (RPM specfiles)
Moritz Barsnick
+ Brian Dessent
Mattes Dolak
+ Jon Foster
Karsten Hopp (Red Hat)
Alexander Lazic
Daniel Leite

Index: p-config.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/p-config.sgml,v
retrieving revision 2.4
retrieving revision 2.5
diff -u -d -r2.4 -r2.5
--- p-config.sgml 20 Feb 2003 13:53:25 -0000 2.4
+++ p-config.sgml 18 Jul 2006 14:48:51 -0000 2.5
@@ -468,12 +468,13 @@
<varlistentry>
<term>Notes:</term>
<listitem>
-<!-- HB removed per bug report 688728 02/20/03
-
+ <!--
+ removed per bug report 688728 02/20/03 HB
+
<para>
The windows version will additionally log to the console.
</para>
--->
+ -->
<para>
The logfile is where all logging and error messages are written. The level
of detail and number of messages are set with the <literal>debug</literal>
@@ -578,7 +579,7 @@
<term>Effect if unset:</term>
<listitem>
<para>
- The whole trust mechanism is turned off.
+ The entire trust mechanism is turned off.
</para>
</listitem>
</varlistentry>
@@ -621,6 +622,7 @@
<para>
Possible applications include limiting Internet access for children.
</para>
+
</listitem>
</varlistentry>
</variablelist>
@@ -687,31 +689,29 @@
<para>
Examples:
</para>
- <!-- The below needs checking after a rebuild due to long file names -->
<para>
Unix, in local filesystem:
</para>
<para>
-
<screen>&nbsp;user-manual&nbsp;&nbsp;file:///usr/share/doc/privoxy-&p-version;/user-manual/index.html</screen>
+
<screen>&nbsp;&nbsp;user-manual&nbsp;&nbsp;file:///usr/share/doc/privoxy-&p-version;/user-manual/</screen>
</para>
<para>
- Windows, in local filesystem, <emphasis>must</emphasis> use forward slash
notation, and <literal>%20</literal> to denote
- spaces in path names:
+ Windows, in local filesystem, <emphasis>must</emphasis> use forward slash
notation:
</para>
<para>
-
<screen>&nbsp;user-manual&nbsp;&nbsp;file:///c:/some%20dir/privoxy/user-manual/index.html</screen>
+
<screen>&nbsp;&nbsp;user-manual&nbsp;&nbsp;file:/c:/some-dir/privoxy-&p-version;/user-manual/</screen>
</para>
<para>
- Windows, UNC notation (forward slashes required again):
+ Windows, UNC notation (with forward slashes):
</para>
<para>
-
<screen>&nbsp;user-manual&nbsp;&nbsp;file://///some-server/some-path/privoxy/user-manual/index.html</screen>
+
<screen>&nbsp;&nbsp;user-manual&nbsp;&nbsp;file://///some-server/some-path/privoxy-&p-version;/user-manual/</screen>
</para>
<para>
Any platform, on local webserver (called <quote>local-webserver</quote>):
</para>
<para>
-
<screen>&nbsp;user-manual&nbsp;&nbsp;http://local-webserver/privoxy-user-manual/</screen>
+
<screen>&nbsp;&nbsp;user-manual&nbsp;&nbsp;http://local-webserver/privoxy-user-manual/</screen>
</para>
<![%user-man;[
<!-- this gets hammered in conversion to config. Text repeated below. -->

Index: privoxy-man-page.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/privoxy-man-page.sgml,v
retrieving revision 2.4
retrieving revision 2.5
diff -u -d -r2.4 -r2.5
--- privoxy-man-page.sgml 5 Sep 2002 23:12:04 -0000 2.4
+++ privoxy-man-page.sgml 18 Jul 2006 14:48:51 -0000 2.5
@@ -24,6 +24,12 @@
The 'replaceable' and 'command' tags are used here somewhat unconventionally,
since it seems to generate the proper formatting (at least for me :).

+ Create man page: 'make man'
+
+ Requires docbook2man (short perl script), see CVS
+ http://sources.redhat.com/docbook-tools/. Also requires openjade and SGMLSpm
+ perl module.
+
For man page references, see:
http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/using.html
http://docbook.org/tdg/en/html/ch02.html#making-refentry
@@ -36,12 +42,10 @@
<!entity copyright SYSTEM "copyright.sgml">
<!entity license SYSTEM "license.sgml">
<!entity authors SYSTEM "p-authors.sgml">
-<!entity p-version SYSTEM "doc_version.tmp">
-<!entity p-status SYSTEM "doc_status.tmp">
+<!entity p-version "3.0.2">
+<!entity p-status "stable">
<!entity % p-not-stable "IGNORE">
-<!entity % p-stable "IGNORE">
-<!entity % p-alpha "IGNORE">
-<!entity % p-beta "IGNORE">
+<!entity % p-stable "INCLUDE">
<!entity % p-text "IGNORE"> <!-- define we are not a text only doc
-->
<!entity % p-authors-formal "IGNORE"> <!-- exclude additional formating
-->
<!entity my-copy "(C)"> <!-- db2man barfs on copyright symbol
-->
@@ -72,6 +76,7 @@
<arg><option>--no-daemon</option></arg>
<arg><option>--pidfile </option><replaceable
class="parameter">pidfile</replaceable></arg>
<arg><option>--user </option><replaceable
class="parameter">user[.group]</replaceable></arg>
+ <arg><option>--chroot</option></arg>
<arg><replaceable class="parameter">configfile</replaceable></arg>
<command>&nbsp;(UNIX)</command>
</cmdsynopsis>
@@ -147,8 +152,21 @@
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term>--chroot</term>
+ <listitem>
+ <para>
+ Before changing to the user ID given in the --user option, chroot to
+ that user's home directory, i.e. make the kernel pretend to the
+ <command>Privoxy</command> process that the directory tree starts
+ there. If set up carefully, this can limit the impact of possible
+ vulnerabilities in <command>Privoxy</command> to the files contained in
+ that hierarchy.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
-
+
<para>
If the <filename>configfile</filename> is not specified on the command
line,
<command>Privoxy</command> will look for a file named

Index: privoxy.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/privoxy.sgml,v
retrieving revision 2.2
retrieving revision 2.3
diff -u -d -r2.2 -r2.3
--- privoxy.sgml 4 Sep 2002 01:55:44 -0000 2.2
+++ privoxy.sgml 18 Jul 2006 14:48:51 -0000 2.3
@@ -5,7 +5,7 @@

$Id$

- Copyright (C) 2001, 2002 Privoxy Developers <developers@xxxxxxxxxxx>
+ Copyright (C) 2001 - 2004 Privoxy Developers <developers@xxxxxxxxxxx>
See LICENSE.

======================================================================
@@ -28,7 +28,7 @@

<para>
<application>Privoxy</application> is a web proxy with advanced filtering
- capabilities for protecting privacy, filtering web page content, managing
+ capabilities for protecting privacy, modifying web page content, managing
cookies, controlling access, and removing ads, banners, pop-ups and other
obnoxious Internet junk. <application>Privoxy</application> has a very
flexible configuration and can be customized to suit individual needs and

Index: readme.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/readme.sgml,v
retrieving revision 2.4
retrieving revision 2.5
diff -u -d -r2.4 -r2.5
--- readme.sgml 6 Sep 2002 01:58:28 -0000 2.4
+++ readme.sgml 18 Jul 2006 14:48:51 -0000 2.5
@@ -4,12 +4,10 @@
<!entity p-intro SYSTEM "privoxy.sgml">
<!entity contacting SYSTEM "contacting.sgml">
<!entity buildsource SYSTEM "buildsource.sgml">
-<!entity p-version SYSTEM "doc_version.tmp">
-<!entity p-status SYSTEM "doc_status.tmp">
-<!entity % p-stable "IGNORE">
-<!entity % p-not-stable "IGNORE"> <!-- beta or alpha -->
-<!entity % p-alpha "IGNORE">
-<!entity % p-beta "IGNORE">
+<!entity p-version "3.0.3">
+<!entity p-status "stable">
+<!entity % p-not-stable "IGNORE">
+<!entity % p-stable "INCLUDE">
<!entity % p-text "INCLUDE"> <!-- define we are a text only doc -->
<!entity % p-doc "IGNORE"> <!-- and never a text doc -->
<!entity % p-readme "INCLUDE"> <!-- all your README belong to us -->
@@ -21,7 +19,7 @@

$Id$

- Copyright (C) 2001, 2002 Privoxy Developers <developers@xxxxxxxxxxx>
+ Copyright (C) 2001 - 2004 Privoxy Developers <developers@xxxxxxxxxxx>
See LICENSE.

========================================================================
@@ -82,7 +80,7 @@
*
* Purpose : README file to give a short intro.
*
- * Copyright : Written by and Copyright (C) 2001,2002 the SourceForge
+ * Copyright : Written by and Copyright (C) 2001 - 2004 the SourceForge
* Privoxy team. http://www.privoxy.org/
*
* Based on the Internet Junkbuster originally written
@@ -116,10 +114,9 @@
<para>
<!-- include some conditional text -->
This README is included with <![%p-not-stable;[ the development version of]]>
- Privoxy &p-version;<![%p-not-stable;[, which will someday become Privoxy
- v3.2]]>. See http://www.privoxy.org/ for more information. The current code
- level is technically &p-status;<![%p-not-stable;[, but is not yet
- significantly different from the 3.0.0 stable branch at this time.]]>.
+ Privoxy &p-version;<![%p-not-stable;[, which will eventually become Privoxy
v3.0 (and soon we
+ hope!)]]>. See http://www.privoxy.org/ for more information. The current code
maturity
+ level is <quote>&p-status;</quote><![%p-not-stable;[, and seems stable to us
:)]]>.
</para>
</abstract>
</artheader>
@@ -131,6 +128,18 @@
<!-- ~~~~~ New section ~~~~~ -->
<sect1 id="importantchanges" ><title>IMPORTANT CHANGES</title>
<para>
+ MORE NEWS! January 2004, Privoxy 3.0.3 is released. This is the another
+ maintenance release of Privoxy which fixes more bugs, further refines
+ the configuration and works around some known third-party problems. See the
+ ChangeLog for complete details. Upgrading from 3.0.2 is recommended.
+</para>
+<para>
+ NEWS! March 2003, Privoxy 3.0.2 is released. This is the first maintenance
+ release of Privoxy. There are no significant new features in this release.
+ Some bugs are fixed, and some existing features have been enhanced. See
+ ChangeLog for details. Upgrading from 3.0.0 is recommended.
+</para>
+<para>
REALLY BIG NEWS! August 2002: The long-awaited, oft-delayed stable version
of Privoxy 3.0 is finally released! This is way behind schedule, but better
late than never. The developers all hope the wait was worth it.
@@ -153,10 +162,10 @@

<!-- ~~~~~ New section ~~~~~ -->
<sect1 id="install" ><title>INSTALL</title>
-<!-- Install instructions are now in INSTALL -->
-<para>
- See the INSTALL file in this directory, for installing from source, and
- the User Manual, for other installation types.
+<para>
+ See the <filename>INSTALL</filename> file in this directory, for installing
+ from source, and the <citetitle>User Manual</citetitle>, for other
+ installation types.
</para>
</sect1>

@@ -165,7 +174,7 @@
<para>
privoxy [&mdash;&mdash;help] [&mdash;&mdash;version]
[&mdash;&mdash;no-daemon] [&mdash;&mdash;pidfile PIDFILE] [&mdash;&mdash;user
- USER[.GROUP]] [config_file]
+ USER[.GROUP]] [&mdash;&mdash;chroot] [config_file]
</para>
<para>
See the man page or User Manual for an explanation of each option, and


Index: supported.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/supported.sgml,v
retrieving revision 2.4
retrieving revision 2.5
diff -u -d -r2.4 -r2.5
--- supported.sgml 14 Dec 2002 04:05:06 -0000 2.4
+++ supported.sgml 18 Jul 2006 14:48:51 -0000 2.5
@@ -25,9 +25,9 @@
-->
<para>
At present, <application>Privoxy</application> is known to run on
- Windows(95, 98, ME, 2000, XP), Linux (RedHat, SuSE, Debian, Conectiva, Gentoo,
+ Windows(95, 98, ME, 2000, XP), Linux (RedHat, SuSE, Debian, Conectiva,
Gentoo,
Slackware), Mac OSX, OS/2, AmigaOS, BeOS, FreeBSD, NetBSD, OpenBSD, Solaris,
- and more flavors of Unix.
+ and many more flavors of Unix.
</para>

<![%p-supp-userman;[

Index: user-manual.sgml
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/source/user-manual.sgml,v
retrieving revision 2.10
retrieving revision 2.11
diff -u -d -r2.10 -r2.11
--- user-manual.sgml 8 May 2003 18:19:36 -0000 2.10
+++ user-manual.sgml 18 Jul 2006 14:48:51 -0000 2.11
@@ -11,11 +11,11 @@
<!entity license SYSTEM "license.sgml">
<!entity p-authors SYSTEM "p-authors.sgml">
<!entity config SYSTEM "p-config.sgml">
-<!entity p-version SYSTEM "doc_version.tmp">
-<!entity p-status SYSTEM "doc_status.tmp">
+<!entity p-version "3.0.3">
+<!entity p-status "stable">
<!entity % p-authors-formal "INCLUDE"> <!-- include additional text, etc -->
<!entity % p-not-stable "IGNORE">
-<!entity % p-stable "IGNORE">
+<!entity % p-stable "INCLUDE">
[...1365 lines suppressed...]
+ Add faq on cookies.
+
+ Revision 1.123.2.23 2002/10/21 02:32:01 hal9
+ Updates to the user.action examples section. A few new ones.
+
+ Revision 1.123.2.22 2002/10/12 00:51:53 hal9
+ Add demoronizer to filter section.
+
+ Revision 1.123.2.21 2002/10/10 04:09:35 hal9
+ s/Advanced/Radical/ and added very brief note.
+
+ Revision 1.123.2.20 2002/10/10 03:49:21 hal9
+ Add notes to session-cookies-only and Quickstart about pre-existing
+ cookies. Also, note content-cookies work differently.
+
+ Revision 1.123.2.19 2002/09/26 01:25:36 hal9
+ More explanation on Privoxy patterns, more on content-cookies and SSL.

Revision 1.123.2.18 2002/08/22 23:47:58 hal9
Add 'Documentation' to Privoxy Menu shot in Configuration section to match

--- GNUmakefile.in DELETED ---


-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys -- and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV


<Prev in Thread] Current Thread [Next in Thread>
Google Custom Search

News | FAQ | advertise