Re-commit to solve various last minute issues for charsets, etc.
authorhal9 <hal9@users.sourceforge.net>
Sat, 19 Jan 2008 21:41:39 +0000 (21:41 +0000)
committerhal9 <hal9@users.sourceforge.net>
Sat, 19 Jan 2008 21:41:39 +0000 (21:41 +0000)
41 files changed:
AUTHORS
doc/text/developer-manual.txt
doc/text/faq.txt
doc/text/user-manual.txt
doc/webserver/developer-manual/coding.html
doc/webserver/developer-manual/contact.html
doc/webserver/developer-manual/copyright.html
doc/webserver/developer-manual/cvs.html
doc/webserver/developer-manual/documentation.html
doc/webserver/developer-manual/index.html
doc/webserver/developer-manual/introduction.html
doc/webserver/developer-manual/newrelease.html
doc/webserver/developer-manual/seealso.html
doc/webserver/developer-manual/testing.html
doc/webserver/developer-manual/webserver-update.html
doc/webserver/faq/configuration.html
doc/webserver/faq/contact.html
doc/webserver/faq/copyright.html
doc/webserver/faq/general.html
doc/webserver/faq/index.html
doc/webserver/faq/installation.html
doc/webserver/faq/misc.html
doc/webserver/faq/trouble.html
doc/webserver/index.html
doc/webserver/privoxy-index.html
doc/webserver/user-manual/actions-file.html
doc/webserver/user-manual/appendix.html
doc/webserver/user-manual/config.html
doc/webserver/user-manual/configuration.html
doc/webserver/user-manual/contact.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/seealso.html
doc/webserver/user-manual/startup.html
doc/webserver/user-manual/templates.html
doc/webserver/user-manual/whatsnew.html
privoxy.1

diff --git a/AUTHORS b/AUTHORS
index d295723..2393ab0 100644 (file)
--- a/AUTHORS
+++ b/AUTHORS
@@ -9,7 +9,7 @@
     Hal Burgiss
     Gerry Murphy
     Roland Rosenfeld
-    Jörg Strohmayer
+    Jörg Strohmayer
 
    Former Privoxy Team Members:
 
@@ -22,7 +22,7 @@
     Karsten Hopp
     Alexander Lazic
     Daniel Leite
-    Gábor Lipták
+    Gábor Lipták
     Adam Lock
     Guy Laroche
     Mark Martinec
@@ -46,7 +46,7 @@
     Reiner Buehl
     Andrew J. Caines
     Clifford Caoile
-    Frédéric Crozat
+    Frédéric Crozat
     Michael T. Davis
     Mattes Dolak
     Peter E.
@@ -55,7 +55,7 @@
     Dean Gaudet
     Stephen Gildea
     Daniel Griscom
-    Felix Gröbert
+    Felix Gröbert
     Aaron Hamid
     Darel Henman
     Magnus Holmgren
@@ -78,7 +78,7 @@
     Dan Price
     Lee R.
     Roberto Ragusa
-    Félix Rauch
+    Félix Rauch
     Maynard Riley
     Chung-chieh Shan
     Spinor S.
@@ -87,7 +87,7 @@
     Peter Thoenen
     Martin Thomas
     Song Weijia
-    Jörg Weinmann
+    Jörg Weinmann
     Darren Wiebe
     Bobby G. Vinyard
     Anduin Withers
index eeb17e3..31a5faf 100644 (file)
-Privoxy Developer Manual
+                            Privoxy Developer Manual
 
-[ Copyright   2001-2008 by Privoxy Developers ]
+   [Copyright[ © 2001-2008 by Privoxy Developers]]
 
-$Id: developer-manual.sgml,v 2.15 2008/01/19 15:03:05 hal9 Exp $
+   $Id: developer-manual.sgml,v 2.16 2008/01/19 17:52:38 hal9 Exp $
 
-The developer manual provides guidance on coding, testing, packaging,
-documentation and other issues of importance to those involved with Privoxy
-development. It is mandatory (and helpful!) reading for anyone who wants to
-join the team. Note that it's currently out of date and may not be entirely
-correct. As always, patches are welcome.
+   The developer manual provides guidance on coding, testing, packaging,
+   documentation and other issues of importance to those involved with
+   Privoxy development. It is mandatory (and helpful!) reading for anyone who
+   wants to join the team. Note that it's currently out of date and may not
+   be entirely correct. As always, patches are welcome.
 
-Please note that this document is constantly evolving. This copy represents the
-state at the release of version 3.0.8. You can find the latest version of the
-this manual at http://www.privoxy.org/developer-manual/. Please see the Contact
-section on how to contact the developers.
+   Please note that this document is constantly evolving. This copy
+   represents the state at the release of version 3.0.8. You can find the
+   latest version of the this manual at
+   http://www.privoxy.org/developer-manual/. Please see the Contact section
+   on how to contact the developers.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-Table of Contents
-1. Introduction
+   Table of Contents
 
-    1.1. Quickstart to Privoxy Development
+   1. Introduction
 
-2. The CVS Repository
+                1.1. Quickstart to Privoxy Development
 
-    2.1. Access to CVS
-    2.2. Branches
-    2.3. CVS Commit Guidelines
+   2. The CVS Repository
 
-3. Documentation Guidelines
+                2.1. Access to CVS
 
-    3.1. Quickstart to Docbook and SGML
-    3.2. Privoxy Documentation Style
-    3.3. Privoxy Custom Entities
+                2.2. Branches
 
-4. Coding Guidelines
+                2.3. CVS Commit Guidelines
 
-    4.1. Introduction
-    4.2. Using Comments
-
-        4.2.1. Comment, Comment, Comment
-        4.2.2. Use blocks for comments
-        4.2.3. Keep Comments on their own line
-        4.2.4. Comment each logical step
-        4.2.5. Comment All Functions Thoroughly
-        4.2.6. Comment at the end of braces if the content is more than one
-            screen length
-
-    4.3. Naming Conventions
-
-        4.3.1. Variable Names
-        4.3.2. Function Names
-        4.3.3. Header file prototypes
-        4.3.4. Enumerations, and #defines
-        4.3.5. Constants
-
-    4.4. Using Space
-
-        4.4.1. Put braces on a line by themselves.
-        4.4.2. ALL control statements should have a block
-        4.4.3. Do not belabor/blow-up boolean expressions
-        4.4.4. Use white space freely because it is free
-        4.4.5. Don't use white space around structure operators
-        4.4.6. Make the last brace of a function stand out
-        4.4.7. Use 3 character indentions
-
-    4.5. Initializing
-
-        4.5.1. Initialize all variables
-
-    4.6. Functions
-
-        4.6.1. Name functions that return a boolean as a question.
-        4.6.2. Always specify a return type for a function.
-        4.6.3. Minimize function calls when iterating by using variables
-        4.6.4. Pass and Return by Const Reference
-        4.6.5. Pass and Return by Value
-        4.6.6. Names of include files
-        4.6.7. Provide multiple inclusion protection
-        4.6.8. Use `extern "C"` when appropriate
-        4.6.9. Where Possible, Use Forward Struct Declaration Instead of
-            Includes
-
-    4.7. General Coding Practices
-
-        4.7.1. Turn on warnings
-        4.7.2. Provide a default case for all switch statements
-        4.7.3. Try to avoid falling through cases in a switch statement.
-        4.7.4. Use 'long' or 'short' Instead of 'int'
-        4.7.5. Don't mix size_t and other types
-        4.7.6. Declare each variable and struct on its own line.
-        4.7.7. Use malloc/zalloc sparingly
-        4.7.8. The Programmer Who Uses 'malloc' is Responsible for Ensuring
-            'free'
-        4.7.9. Add loaders to the `file_list' structure and in order
-        4.7.10. "Uncertain" new code and/or changes to existing code, use FIXME
-            or XXX
-
-    4.8. Addendum: Template for files and function comment blocks:
+   3. Documentation Guidelines
 
-5. Testing Guidelines
+                3.1. Quickstart to Docbook and SGML
 
-    5.1. Testplan for releases
-    5.2. Test reports
+                3.2. Privoxy Documentation Style
 
-6. Releasing a New Version
+                3.3. Privoxy Custom Entities
 
-    6.1. Version numbers
-    6.2. Before the Release: Freeze
-    6.3. Building and Releasing the Packages
-
-        6.3.1. Note on Privoxy Packaging
-        6.3.2. Source Tarball
-        6.3.3. SuSE, Conectiva or Red Hat RPM
-        6.3.4. OS/2
-        6.3.5. Solaris
-        6.3.6. Windows
-        6.3.7. Debian
-        6.3.8. Mac OSX
-        6.3.9. FreeBSD
-        6.3.10. HP-UX 11
-        6.3.11. Amiga OS
-        6.3.12. AIX
-
-    6.4. Uploading and Releasing Your Package
-    6.5. After the Release
+   4. Coding Guidelines
 
-7. Update the Webserver
-8. Contacting the developers, Bug Reporting and Feature Requests
+                4.1. Introduction
 
-    8.1. Get Support
-    8.2. Reporting Problems
+                4.2. Using Comments
 
-        8.2.1. Reporting Ads or Other Configuration Problems
-        8.2.2. Reporting Bugs
+                             4.2.1. Comment, Comment, Comment
 
-    8.3. Request New Features
-    8.4. Other
+                             4.2.2. Use blocks for comments
 
-9. Privoxy Copyright, License and History
+                             4.2.3. Keep Comments on their own line
 
-    9.1. License
-    9.2. History
+                             4.2.4. Comment each logical step
 
-10. See also
+                             4.2.5. Comment All Functions Thoroughly
 
-1. Introduction
+                             4.2.6. Comment at the end of braces if the
+                             content is more than one screen length
 
-Privoxy, as an heir to Junkbuster, is a Free Software project and the code is
-licensed under the GPL. As such, Privoxy development is potentially open to
-anyone who has the time, knowledge, and desire to contribute in any capacity.
-Our goals are simply to continue the mission, to improve Privoxy, and to make
-it available to as wide an audience as possible.
+                4.3. Naming Conventions
 
-One does not have to be a programmer to contribute. Packaging, testing,
-documenting and porting, are all important jobs as well.
+                             4.3.1. Variable Names
 
--------------------------------------------------------------------------------
+                             4.3.2. Function Names
 
-1.1. Quickstart to Privoxy Development
+                             4.3.3. Header file prototypes
 
-The first step is to join the developer's mailing list. You can submit your
-ideas, or even better patches. Patches are best submitted to the Sourceforge
-tracker set up for this purpose, but can be sent to the list for review too.
+                             4.3.4. Enumerations, and #defines
 
-You will also need to have a cvs package installed, which will entail having
-ssh installed as well (which seems to be a requirement of SourceForge), in
-order to access the cvs repository. Having the GNU build tools is also going to
-be important (particularly, autoconf and gmake).
+                             4.3.5. Constants
 
-For the time being (read, this section is under construction), you can also
-refer to the extensive comments in the source code. In fact, reading the code
-is recommended in any case.
+                4.4. Using Space
 
--------------------------------------------------------------------------------
+                             4.4.1. Put braces on a line by themselves.
 
-2. The CVS Repository
+                             4.4.2. ALL control statements should have a
+                             block
 
-If you become part of the active development team, you will eventually need
-write access to our holy grail, the CVS repository. One of the team members
-will need to set this up for you. Please read this chapter completely before
-accessing via CVS.
+                             4.4.3. Do not belabor/blow-up boolean
+                             expressions
 
--------------------------------------------------------------------------------
+                             4.4.4. Use white space freely because it is free
 
-2.1. Access to CVS
+                             4.4.5. Don't use white space around structure
+                             operators
 
-The project's CVS repository is hosted on SourceForge. Please refer to the
-chapters 6 and 7 in SF's site documentation for the technical access details
-for your operating system. For historical reasons, the CVS server is called
-ijbswa.cvs.sourceforge.net, the repository is called ijbswa, and the source
-tree module is called current.
+                             4.4.6. Make the last brace of a function stand
+                             out
 
--------------------------------------------------------------------------------
+                             4.4.7. Use 3 character indentions
 
-2.2. Branches
+                4.5. Initializing
 
-Within the CVS repository, there are modules and branches. As mentioned, the
-sources are in the current "module". Other modules are present for platform
-specific issues. There is a webview of the CVS hierarchy at http://
-ijbswa.cvs.sourceforge.net/ijbswa/, which might help with visualizing how these
-pieces fit together.
+                             4.5.1. Initialize all variables
 
-Branches are used to fork a sub-development path from the main trunk. Within
-the current module where the sources are, there is always at least one "branch"
-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). 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 only used for
-bugfixes, which have had prior testing before being committed to CVS. (See
-Version Numbers below for details on versioning.)
+                4.6. Functions
 
-At one time there were two distinct branches: stable and unstable. The more
-drastic changes were to be in the unstable branch. These branches have now been
-merged to minimize time and effort of maintaining two branches.
+                             4.6.1. Name functions that return a boolean as a
+                             question.
 
--------------------------------------------------------------------------------
+                             4.6.2. Always specify a return type for a
+                             function.
 
-2.3. CVS Commit Guidelines
+                             4.6.3. Minimize function calls when iterating by
+                             using variables
 
-The source tree is the heart of every software project. Every effort must be
-made to ensure that it is readable, compilable and consistent at all times.
-There are differing guidelines for the stable branch and the main development
-trunk, and we ask anyone with CVS access to strictly adhere to the following
-guidelines:
+                             4.6.4. Pass and Return by Const Reference
 
-Basic Guidelines, for all branches:
+                             4.6.5. Pass and Return by Value
 
-  * Please don't commit even a small change without testing it thoroughly
-    first. When we're close to a public release, ask a fellow developer to
-    review your changes.
+                             4.6.6. Names of include files
 
-  * Your commit message should give a concise overview of what you changed (no
-    big details) and why you changed it Just check previous messages for good
-    examples.
+                             4.6.7. Provide multiple inclusion protection
 
-  * Don't use the same message on multiple files, unless it equally applies to
-    all those files.
+                             4.6.8. Use `extern "C"` when appropriate
 
-  * If your changes span multiple files, and the code won't recompile unless
-    all changes are committed (e.g. when changing the signature of a function),
-    then commit all files one after another, without long delays in between. If
-    necessary, prepare the commit messages in advance.
+                             4.6.9. Where Possible, Use Forward Struct
+                             Declaration Instead of Includes
 
-  * Before changing things on CVS, make sure that your changes are in line with
-    the team's general consensus on what should be done.
+                4.7. General Coding Practices
 
-  * Note that near a major public release, we get more cautious. There is
-    always the possibility to submit a patch to the patch tracker instead.
+                             4.7.1. Turn on warnings
 
--------------------------------------------------------------------------------
+                             4.7.2. Provide a default case for all switch
+                             statements
 
-3. Documentation Guidelines
+                             4.7.3. Try to avoid falling through cases in a
+                             switch statement.
 
-All formal documents are maintained in Docbook SGML and located in the doc/
-source/* directory. You will need Docbook, the Docbook DTD's and the Docbook
-modular stylesheets (or comparable alternatives), and either jade or openjade
-(recommended) installed in order to build docs from source. Currently there is
-user-manual, FAQ, and, of course this, the developer-manual in this format. The
-README, AUTHORS, INSTALL, privoxy.1 (man page), and config files are also now
-maintained as Docbook SGML. These files, when built, in the top-level source
-directory are generated files! Also, the Privoxy index.html (and a variation on
-this file, privoxy-index.html, meant for inclusion with doc packages), are
-maintained as SGML as well. DO NOT edit these directly. Edit the SGML source,
-or contact someone involved in the documentation.
-
-config requires some special handling. The reason it is maintained this way is
-so that the extensive comments in the file mirror those in user-manual. But the
-conversion process requires going from SGML to HTML to text to special
-formatting required for the embedded comments. Some of this does not survive so
-well. Especially some of the examples that are longer than 80 characters. The
-build process for this file outputs to config.new, which should be reviewed for
-errors and mis-formatting. Once satisfied that it is correct, then it should be
-hand copied to config.
-
-Other, less formal documents (e.g. LICENSE) are maintained as plain text files
-in the top-level source directory.
-
-Packagers are encouraged to include this documentation. For those without the
-ability to build the docs locally, text versions of each are kept in CVS. HTML
-versions are also being kept in CVS under doc/webserver/*. And PDF version are
-kept in doc/pdf/*.
-
-Formal documents are built with the Makefile targets of make dok, or
-alternately make redhat-dok. If you have problems, try both. The build process
-uses the document SGML sources in doc/source/*/* to update all text files in
-doc/text/ and to update all HTML documents in doc/webserver/.
-
-Documentation writers should please make sure documents build successfully
-before committing to CVS, if possible.
-
-How do you update the webserver (i.e. the pages on privoxy.org)?
-
- 1. First, build the docs by running make dok (or alternately make redhat-dok).
-    For PDF docs, do make dok-pdf.
-
- 2. Run make webserver which copies all files from doc/webserver to the
-    sourceforge webserver via scp.
-
-Finished docs should be occasionally submitted to CVS (doc/webserver/*/*.html)
-so that those without the ability to build them locally, have access to them if
-needed. This is especially important just prior to a new release! Please do
-this after the $VERSION and other release specific data in configure.in has
-been updated (this is done just prior to a new release).
-
--------------------------------------------------------------------------------
-
-3.1. Quickstart to Docbook and SGML
-
-If you are not familiar with SGML, it is a markup language similar to HTML.
-Actually, not a mark up language per se, but a language used to define markup
-languages. In fact, HTML is an SGML application. Both will use "tags" to format
-text and other content. SGML tags can be much more varied, and flexible, but do
-much of the same kinds of things. The tags, or "elements", are definable in
-SGML. There is no set "standards". Since we are using Docbook, our tags are
-those that are defined by Docbook. Much of how the finish document is rendered
-is determined by the "stylesheets". The stylesheets determine how each tag gets
-translated to HTML, or other formats.
-
-Tags in Docbook SGML need to be always "closed". If not, you will likely
-generate errors. Example: <title>My Title</title>. They are also
-case-insensitive, but we strongly suggest using all lower case. This keeps
-compatibility with [Docbook] XML.
+                             4.7.4. Use 'long' or 'short' Instead of 'int'
 
-Our documents use "sections" for the most part. Sections will be processed into
-HTML headers (e.g. h1 for sect1). The Docbook stylesheets will use these to
-also generate the Table of Contents for each doc. Our TOC's are set to a depth
-of three. Meaning sect1, sect2, and sect3 will have TOC entries, but sect4 will
-not. Each section requires a <title> element, and at least one <para>. There is
-a limit of five section levels in Docbook, but generally three should be
-sufficient for our purposes.
+                             4.7.5. Don't mix size_t and other types
 
-Some common elements that you likely will use:
-
-<para></para>, paragraph delimiter. Most text needs to be within paragraph
-elements (there are some exceptions).
-<emphasis></emphasis>, the stylesheets make this italics.
-<filename></filename>, files and directories.
-<command></command>, command examples.
-<literallayout></literallayout>, like <pre>, more or less.
-<itemizedlist></itemizedlist>, list with bullets.
-<listitem></listitem>, member of the above.
-<screen></screen>, screen output, implies <literallayout>.
-<ulink url="example.com"></ulink>, like HTML <a> tag.
-<quote></quote>, for, doh, quoting text.
+                             4.7.6. Declare each variable and struct on its
+                             own line.
 
-Look at any of the existing docs for examples of all these and more.
+                             4.7.7. Use malloc/zalloc sparingly
 
-You might also find "Writing Documentation Using DocBook - A Crash Course"
-useful.
-
--------------------------------------------------------------------------------
-
-3.2. Privoxy Documentation Style
-
-It will be easier if everyone follows a similar writing style. This just makes
-it easier to read what someone else has written if it is all done in a similar
-fashion.
-
-Here it is:
+                             4.7.8. The Programmer Who Uses 'malloc' is
+                             Responsible for Ensuring 'free'
 
-  * All tags should be lower case.
+                             4.7.9. Add loaders to the `file_list' structure
+                             and in order
 
-  * Tags delimiting a block of text (even small blocks) should be on their own
-    line. Like:
+                             4.7.10. "Uncertain" new code and/or changes to
+                             existing code, use FIXME or XXX
 
-     <para>
-      Some text goes here.
-     </para>
-           
+                4.8. Addendum: Template for files and function comment
+                blocks:
 
-    Tags marking individual words, or few words, should be in-line:
+   5. Testing Guidelines
 
-      Just to <emphasis>emphasize</emphasis>, some text goes here.
-           
+                5.1. Testplan for releases
 
-  * Tags should be nested and step indented for block text like: (except
-    in-line tags)
+                5.2. Test reports
 
-     <para>
-      <itemizedlist>
-       <para>
-        <listitem>
-          Some text goes here in our list example.
-         </listitem>
-       </para>
-      </itemizedlist>
-     </para>
-           
+   6. Releasing a New Version
 
-    This makes it easier to find the text amongst the tags ;-)
+                6.1. Version numbers
 
-  * Use white space to separate logical divisions within a document, like
-    between sections. Running everything together consistently makes it harder
-    to read and work on.
+                6.2. Before the Release: Freeze
 
-  * Do not hesitate to make comments. Comments can either use the <comment>
-    element, or the <!-- --> style comment familiar from HTML. (Note in Docbook
-    v4.x <comment> is replaced by <remark>.)
+                6.3. Building and Releasing the Packages
 
-  * We have an international audience. Refrain from slang, or English
-    idiosyncrasies (too many to list :). Humor also does not translate well
-    sometimes.
+                             6.3.1. Note on Privoxy Packaging
 
-  * Try to keep overall line lengths in source files to 80 characters or less
-    for obvious reasons. This is not always possible, with lengthy URLs for
-    instance.
+                             6.3.2. Source Tarball
 
-  * Our documents are available in differing formats. Right now, they are just
-    plain text, HTML, and PDF, but others are always a future possibility. Be
-    careful with URLs (<ulink>), and avoid this mistake:
+                             6.3.3. SuSE, Conectiva or Red Hat RPM
 
-    My favorite site is <ulink url="http://example.com">here</ulink>.
+                             6.3.4. OS/2
 
-    This will render as "My favorite site is here", which is not real helpful
-    in a text doc. Better like this:
+                             6.3.5. Solaris
 
-    My favorite site is <ulink url="http://example.com">example.com</ulink>.
+                             6.3.6. Windows
 
-  * All documents should be spell checked occasionally. aspell can check SGML
-    with the -H option. (ispell I think too.)
+                             6.3.7. Debian
 
--------------------------------------------------------------------------------
+                             6.3.8. Mac OSX
 
-3.3. Privoxy Custom Entities
+                             6.3.9. FreeBSD
 
-Privoxy documentation is using a number of customized "entities" to facilitate
-documentation maintenance.
+                             6.3.10. HP-UX 11
 
-We are using a set of "boilerplate" files with generic text, that is used by
-multiple docs. This way we can write something once, and use it repeatedly
-without having to re-write the same content over and over again. If editing
-such a file, keep in mind that it should be generic. That is the purpose; so it
-can be used in varying contexts without additional modifications.
+                             6.3.11. Amiga OS
 
-We are also using what Docbook calls "internal entities". These are like
-variables in programming. Well, sort of. For instance, we have the p-version
-entity that contains the current Privoxy version string. You are strongly
-encouraged to use these where possible. Some of these obviously require
-re-setting with each release (done by the Makefile). A sampling of custom
-entities are listed below. See any of the main docs for examples.
+                             6.3.12. AIX
 
-  * Re- "boilerplate" text entities are defined like:
+                6.4. Uploading and Releasing Your Package
 
-    <!entity supported SYSTEM "supported.sgml">
+                6.5. After the Release
 
-    In this example, the contents of the file, supported.sgml is available for
-    inclusion anywhere in the doc. To make this happen, just reference the now
-    defined entity: &supported; (starts with an ampersand and ends with a
-    semi-colon), and the contents will be dumped into the finished doc at that
-    point.
+   7. Update the Webserver
 
-  * Commonly used "internal entities":
+   8. Contacting the developers, Bug Reporting and Feature Requests
 
-    p-version: the Privoxy version string, e.g. "3.0.8".
-    p-status: the project status, either "alpha", "beta", or "stable".
-    p-not-stable: use to conditionally include text in "not stable" releases
-    (e.g. "beta").
-    p-stable: just the opposite.
-    p-text: this doc is only generated as text.
+                8.1. Get Support
 
-There are others in various places that are defined for a specific purpose.
-Read the source!
+                8.2. Reporting Problems
 
--------------------------------------------------------------------------------
+                             8.2.1. Reporting Ads or Other Configuration
+                             Problems
 
-4. Coding Guidelines
+                             8.2.2. Reporting Bugs
 
-4.1. Introduction
+                8.3. Request New Features
 
-This set of standards is designed to make our lives easier. It is developed
-with the simple goal of helping us keep the "new and improved Privoxy"
-consistent and reliable. Thus making maintenance easier and increasing chances
-of success of the project.
+                8.4. Other
 
-And that of course comes back to us as individuals. If we can increase our
-development and product efficiencies then we can solve more of the request for
-changes/improvements and in general feel good about ourselves. ;->
+   9. Privoxy Copyright, License and History
 
--------------------------------------------------------------------------------
+                9.1. License
 
-4.2. Using Comments
+                9.2. History
 
-4.2.1. Comment, Comment, Comment
+   10. See also
 
-Explanation:
+1. Introduction
 
-Comment as much as possible without commenting the obvious. For example do not
-comment "variable_a is equal to variable_b". Instead explain why variable_a
-should be equal to the variable_b. Just because a person can read code does not
-mean they will understand why or what is being done. A reader may spend a lot
-more time figuring out what is going on when a simple comment or explanation
-would have prevented the extra research. Please help your brother IJB'ers out!
+   Privoxy, as an heir to Junkbuster, is a Free Software project and the code
+   is licensed under the GPL. As such, Privoxy development is potentially
+   open to anyone who has the time, knowledge, and desire to contribute in
+   any capacity. Our goals are simply to continue the mission, to improve
+   Privoxy, and to make it available to as wide an audience as possible.
 
-The comments will also help justify the intent of the code. If the comment
-describes something different than what the code is doing then maybe a
-programming error is occurring.
+   One does not have to be a programmer to contribute. Packaging, testing,
+   documenting and porting, are all important jobs as well.
 
-Example:
+   --------------------------------------------------------------------------
 
-/* if page size greater than 1k ... */
-if ( page_length() > 1024 )
-{
-    ... "block" the page up ...
-}
+  1.1. Quickstart to Privoxy Development
 
-/* if page size is small, send it in blocks */
-if ( page_length() > 1024 )
-{
-    ... "block" the page up ...
-}
+   The first step is to join the developer's mailing list. You can submit
+   your ideas, or even better patches. Patches are best submitted to the
+   Sourceforge tracker set up for this purpose, but can be sent to the list
+   for review too.
 
-This demonstrates 2 cases of "what not to do".  The first is a
-"syntax comment".  The second is a comment that does not fit what
-is actually being done.
+   You will also need to have a cvs package installed, which will entail
+   having ssh installed as well (which seems to be a requirement of
+   SourceForge), in order to access the cvs repository. Having the GNU build
+   tools is also going to be important (particularly, autoconf and gmake).
 
+   For the time being (read, this section is under construction), you can
+   also refer to the extensive comments in the source code. In fact, reading
+   the code is recommended in any case.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-4.2.2. Use blocks for comments
+2. The CVS Repository
 
-Explanation:
+   If you become part of the active development team, you will eventually
+   need write access to our holy grail, the CVS repository. One of the team
+   members will need to set this up for you. Please read this chapter
+   completely before accessing via CVS.
 
-Comments can help or they can clutter. They help when they are differentiated
-from the code they describe. One line comments do not offer effective
-separation between the comment and the code. Block identifiers do, by
-surrounding the code with a clear, definable pattern.
+   --------------------------------------------------------------------------
 
-Example:
+  2.1. Access to CVS
 
-/*********************************************************************
- * This will stand out clearly in your code!
- *********************************************************************/
-if ( this_variable == that_variable )
-{
-   do_something_very_important();
-}
+   The project's CVS repository is hosted on SourceForge. Please refer to the
+   chapters 6 and 7 in SF's site documentation for the technical access
+   details for your operating system. For historical reasons, the CVS server
+   is called ijbswa.cvs.sourceforge.net, the repository is called ijbswa, and
+   the source tree module is called current.
 
+   --------------------------------------------------------------------------
 
-/* unfortunately, this may not */
-if ( this_variable == that_variable )
-{
-   do_something_very_important();
-}
+  2.2. Branches
 
+   Within the CVS repository, there are modules and branches. As mentioned,
+   the sources are in the current "module". Other modules are present for
+   platform specific issues. There is a webview of the CVS hierarchy at
+   http://ijbswa.cvs.sourceforge.net/ijbswa/, which might help with
+   visualizing how these pieces fit together.
 
-if ( this_variable == that_variable ) /* this may not either */
-{
-   do_something_very_important();
-}
+   Branches are used to fork a sub-development path from the main trunk.
+   Within the current module where the sources are, there is always at least
+   one "branch" 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). 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 only used for bugfixes, which have had prior
+   testing before being committed to CVS. (See Version Numbers below for
+   details on versioning.)
 
+   At one time there were two distinct branches: stable and unstable. The
+   more drastic changes were to be in the unstable branch. These branches
+   have now been merged to minimize time and effort of maintaining two
+   branches.
 
-Exception:
+   --------------------------------------------------------------------------
 
-If you are trying to add a small logic comment and do not wish to "disrupt" the
-flow of the code, feel free to use a 1 line comment which is NOT on the same
-line as the code.
+  2.3. CVS Commit Guidelines
 
--------------------------------------------------------------------------------
+   The source tree is the heart of every software project. Every effort must
+   be made to ensure that it is readable, compilable and consistent at all
+   times. There are differing guidelines for the stable branch and the main
+   development trunk, and we ask anyone with CVS access to strictly adhere to
+   the following guidelines:
 
-4.2.3. Keep Comments on their own line
+   Basic Guidelines, for all branches:
 
-Explanation:
+     * Please don't commit even a small change without testing it thoroughly
+       first. When we're close to a public release, ask a fellow developer to
+       review your changes.
 
-It goes back to the question of readability. If the comment is on the same line
-as the code it will be harder to read than the comment that is on its own line.
+     * Your commit message should give a concise overview of what you changed
+       (no big details) and why you changed it Just check previous messages
+       for good examples.
 
-There are three exceptions to this rule, which should be violated freely and
-often: during the definition of variables, at the end of closing braces, when
-used to comment parameters.
+     * Don't use the same message on multiple files, unless it equally
+       applies to all those files.
 
-Example:
+     * If your changes span multiple files, and the code won't recompile
+       unless all changes are committed (e.g. when changing the signature of
+       a function), then commit all files one after another, without long
+       delays in between. If necessary, prepare the commit messages in
+       advance.
 
-/*********************************************************************
- * This will stand out clearly in your code,
- * But the second example won't.
- *********************************************************************/
-if ( this_variable == this_variable )
-{
-   do_something_very_important();
-}
+     * Before changing things on CVS, make sure that your changes are in line
+       with the team's general consensus on what should be done.
 
-if ( this_variable == this_variable ) /*can you see me?*/
-{
-   do_something_very_important(); /*not easily*/
-}
+     * Note that near a major public release, we get more cautious. There is
+       always the possibility to submit a patch to the patch tracker instead.
 
+   --------------------------------------------------------------------------
 
-/*********************************************************************
- * But, the encouraged exceptions:
- *********************************************************************/
-int urls_read     = 0;     /* # of urls read + rejected */
-int urls_rejected = 0;     /* # of urls rejected */
+3. Documentation Guidelines
+
+   All formal documents are maintained in Docbook SGML and located in the
+   doc/source/* directory. You will need Docbook, the Docbook DTD's and the
+   Docbook modular stylesheets (or comparable alternatives), and either jade
+   or openjade (recommended) installed in order to build docs from source.
+   Currently there is user-manual, FAQ, and, of course this, the
+   developer-manual in this format. The README, AUTHORS, INSTALL, privoxy.1
+   (man page), and config files are also now maintained as Docbook SGML.
+   These files, when built, in the top-level source directory are generated
+   files! Also, the Privoxy index.html (and a variation on this file,
+   privoxy-index.html, meant for inclusion with doc packages), are maintained
+   as SGML as well. DO NOT edit these directly. Edit the SGML source, or
+   contact someone involved in the documentation.
+
+   config requires some special handling. The reason it is maintained this
+   way is so that the extensive comments in the file mirror those in
+   user-manual. But the conversion process requires going from SGML to HTML
+   to text to special formatting required for the embedded comments. Some of
+   this does not survive so well. Especially some of the examples that are
+   longer than 80 characters. The build process for this file outputs to
+   config.new, which should be reviewed for errors and mis-formatting. Once
+   satisfied that it is correct, then it should be hand copied to config.
+
+   Other, less formal documents (e.g. LICENSE) are maintained as plain text
+   files in the top-level source directory.
+
+   Packagers are encouraged to include this documentation. For those without
+   the ability to build the docs locally, text versions of each are kept in
+   CVS. HTML versions are also being kept in CVS under doc/webserver/*. And
+   PDF version are kept in doc/pdf/*.
 
-if ( 1 == X )
-{
-   do_something_very_important();
-}
+   Formal documents are built with the Makefile targets of make dok, or
+   alternately make redhat-dok. If you have problems, try both. The build
+   process uses the document SGML sources in doc/source/*/* to update all
+   text files in doc/text/ and to update all HTML documents in
+   doc/webserver/.
+
+   Documentation writers should please make sure documents build successfully
+   before committing to CVS, if possible.
+
+   How do you update the webserver (i.e. the pages on privoxy.org)?
+
+    1. First, build the docs by running make dok (or alternately make
+       redhat-dok). For PDF docs, do make dok-pdf.
+
+    2. Run make webserver which copies all files from doc/webserver to the
+       sourceforge webserver via scp.
+
+   Finished docs should be occasionally submitted to CVS
+   (doc/webserver/*/*.html) so that those without the ability to build them
+   locally, have access to them if needed. This is especially important just
+   prior to a new release! Please do this after the $VERSION and other
+   release specific data in configure.in has been updated (this is done just
+   prior to a new release).
+
+   --------------------------------------------------------------------------
+
+  3.1. Quickstart to Docbook and SGML
+
+   If you are not familiar with SGML, it is a markup language similar to
+   HTML. Actually, not a mark up language per se, but a language used to
+   define markup languages. In fact, HTML is an SGML application. Both will
+   use "tags" to format text and other content. SGML tags can be much more
+   varied, and flexible, but do much of the same kinds of things. The tags,
+   or "elements", are definable in SGML. There is no set "standards". Since
+   we are using Docbook, our tags are those that are defined by Docbook. Much
+   of how the finish document is rendered is determined by the "stylesheets".
+   The stylesheets determine how each tag gets translated to HTML, or other
+   formats.
 
+   Tags in Docbook SGML need to be always "closed". If not, you will likely
+   generate errors. Example: <title>My Title</title>. They are also
+   case-insensitive, but we strongly suggest using all lower case. This keeps
+   compatibility with [Docbook] XML.
 
-short do_something_very_important(
-   short firstparam,   /* represents something */
-   short nextparam     /* represents something else */ )
-{
-   ...code here...
+   Our documents use "sections" for the most part. Sections will be processed
+   into HTML headers (e.g. h1 for sect1). The Docbook stylesheets will use
+   these to also generate the Table of Contents for each doc. Our TOC's are
+   set to a depth of three. Meaning sect1, sect2, and sect3 will have TOC
+   entries, but sect4 will not. Each section requires a <title> element, and
+   at least one <para>. There is a limit of five section levels in Docbook,
+   but generally three should be sufficient for our purposes.
 
-}   /* -END- do_something_very_important */
+   Some common elements that you likely will use:
 
+   <para></para>, paragraph delimiter. Most text needs to be within paragraph
+   elements (there are some exceptions).
+   <emphasis></emphasis>, the stylesheets make this italics.
+   <filename></filename>, files and directories.
+   <command></command>, command examples.
+   <literallayout></literallayout>, like <pre>, more or less.
+   <itemizedlist></itemizedlist>, list with bullets.
+   <listitem></listitem>, member of the above.
+   <screen></screen>, screen output, implies <literallayout>.
+   <ulink url="example.com"></ulink>, like HTML <a> tag.
+   <quote></quote>, for, doh, quoting text.
 
--------------------------------------------------------------------------------
+   Look at any of the existing docs for examples of all these and more.
 
-4.2.4. Comment each logical step
+   You might also find "Writing Documentation Using DocBook - A Crash Course"
+   useful.
+
+   --------------------------------------------------------------------------
 
-Explanation:
+  3.2. Privoxy Documentation Style
 
-Logical steps should be commented to help others follow the intent of the
-written code and comments will make the code more readable.
+   It will be easier if everyone follows a similar writing style. This just
+   makes it easier to read what someone else has written if it is all done in
+   a similar fashion.
 
-If you have 25 lines of code without a comment, you should probably go back
-into it to see where you forgot to put one.
+   Here it is:
 
-Most "for", "while", "do", etc... loops _probably_ need a comment. After all,
-these are usually major logic containers.
+     * All tags should be lower case.
 
--------------------------------------------------------------------------------
+     * Tags delimiting a block of text (even small blocks) should be on their
+       own line. Like:
 
-4.2.5. Comment All Functions Thoroughly
+        <para>
+         Some text goes here.
+        </para>
 
-Explanation:
 
-A reader of the code should be able to look at the comments just prior to the
-beginning of a function and discern the reason for its existence and the
-consequences of using it. The reader should not have to read through the code
-to determine if a given function is safe for a desired use. The proper
-information thoroughly presented at the introduction of a function not only
-saves time for subsequent maintenance or debugging, it more importantly aids in
-code reuse by allowing a user to determine the safety and applicability of any
-function for the problem at hand. As a result of such benefits, all functions
-should contain the information presented in the addendum section of this
-document.
+       Tags marking individual words, or few words, should be in-line:
 
--------------------------------------------------------------------------------
+         Just to <emphasis>emphasize</emphasis>, some text goes here.
 
-4.2.6. Comment at the end of braces if the content is more than one screen
-length
 
-Explanation:
+     * Tags should be nested and step indented for block text like: (except
+       in-line tags)
 
-Each closing brace should be followed on the same line by a comment that
-describes the origination of the brace if the original brace is off of the
-screen, or otherwise far away from the closing brace. This will simplify the
-debugging, maintenance, and readability of the code.
+        <para>
+         <itemizedlist>
+          <para>
+           <listitem>
+             Some text goes here in our list example.
+            </listitem>
+          </para>
+         </itemizedlist>
+        </para>
 
-As a suggestion , use the following flags to make the comment and its brace
-more readable:
 
-use following a closing brace: } /* -END- if() or while () or etc... */
+       This makes it easier to find the text amongst the tags ;-)
+     * Use white space to separate logical divisions within a document, like
+       between sections. Running everything together consistently makes it
+       harder to read and work on.
 
-Example:
+     * Do not hesitate to make comments. Comments can either use the
+       <comment> element, or the <!-- --> style comment familiar from HTML.
+       (Note in Docbook v4.x <comment> is replaced by <remark>.)
 
-if ( 1 == X )
-{
-   do_something_very_important();
-   ...some long list of commands...
-} /* -END- if x is 1 */
+     * We have an international audience. Refrain from slang, or English
+       idiosyncrasies (too many to list :). Humor also does not translate
+       well sometimes.
 
-or:
+     * Try to keep overall line lengths in source files to 80 characters or
+       less for obvious reasons. This is not always possible, with lengthy
+       URLs for instance.
 
-if ( 1 == X )
-{
-   do_something_very_important();
-   ...some long list of commands...
-} /* -END- if ( 1 == X ) */
+     * Our documents are available in differing formats. Right now, they are
+       just plain text, HTML, and PDF, but others are always a future
+       possibility. Be careful with URLs (<ulink>), and avoid this mistake:
 
+       My favorite site is <ulink url="http://example.com">here</ulink>.
 
--------------------------------------------------------------------------------
+       This will render as "My favorite site is here", which is not real
+       helpful in a text doc. Better like this:
 
-4.3. Naming Conventions
+       My favorite site is <ulink
+       url="http://example.com">example.com</ulink>.
 
-4.3.1. Variable Names
+     * All documents should be spell checked occasionally. aspell can check
+       SGML with the -H option. (ispell I think too.)
 
-Explanation:
+   --------------------------------------------------------------------------
 
-Use all lowercase, and separate words via an underscore ('_'). Do not start an
-identifier with an underscore. (ANSI C reserves these for use by the compiler
-and system headers.) Do not use identifiers which are reserved in ANSI C++.
-(E.g. template, class, true, false, ...). This is in case we ever decide to
-port Privoxy to C++.
+  3.3. Privoxy Custom Entities
 
-Example:
+   Privoxy documentation is using a number of customized "entities" to
+   facilitate documentation maintenance.
 
-int ms_iis5_hack = 0;
+   We are using a set of "boilerplate" files with generic text, that is used
+   by multiple docs. This way we can write something once, and use it
+   repeatedly without having to re-write the same content over and over
+   again. If editing such a file, keep in mind that it should be generic.
+   That is the purpose; so it can be used in varying contexts without
+   additional modifications.
 
+   We are also using what Docbook calls "internal entities". These are like
+   variables in programming. Well, sort of. For instance, we have the
+   p-version entity that contains the current Privoxy version string. You are
+   strongly encouraged to use these where possible. Some of these obviously
+   require re-setting with each release (done by the Makefile). A sampling of
+   custom entities are listed below. See any of the main docs for examples.
 
-Instead of:
+     * Re- "boilerplate" text entities are defined like:
 
-int msiis5hack = 0; int msIis5Hack = 0;
+       <!entity supported SYSTEM "supported.sgml">
 
+       In this example, the contents of the file, supported.sgml is available
+       for inclusion anywhere in the doc. To make this happen, just reference
+       the now defined entity: &supported; (starts with an ampersand and ends
+       with a semi-colon), and the contents will be dumped into the finished
+       doc at that point.
 
--------------------------------------------------------------------------------
+     * Commonly used "internal entities":
 
-4.3.2. Function Names
+       p-version: the Privoxy version string, e.g. "3.0.8".
+       p-status: the project status, either "alpha", "beta", or "stable".
+       p-not-stable: use to conditionally include text in "not stable"
+       releases (e.g. "beta").
+       p-stable: just the opposite.
+       p-text: this doc is only generated as text.
 
-Explanation:
+   There are others in various places that are defined for a specific
+   purpose. Read the source!
 
-Use all lowercase, and separate words via an underscore ('_'). Do not start an
-identifier with an underscore. (ANSI C reserves these for use by the compiler
-and system headers.) Do not use identifiers which are reserved in ANSI C++.
-(E.g. template, class, true, false, ...). This is in case we ever decide to
-port Privoxy to C++.
+   --------------------------------------------------------------------------
 
-Example:
+4. Coding Guidelines
 
-int load_some_file( struct client_state *csp )
+  4.1. Introduction
 
+   This set of standards is designed to make our lives easier. It is
+   developed with the simple goal of helping us keep the "new and improved
+   Privoxy" consistent and reliable. Thus making maintenance easier and
+   increasing chances of success of the project.
 
-Instead of:
+   And that of course comes back to us as individuals. If we can increase our
+   development and product efficiencies then we can solve more of the request
+   for changes/improvements and in general feel good about ourselves. ;->
 
-int loadsomefile( struct client_state *csp )
-int loadSomeFile( struct client_state *csp )
+   --------------------------------------------------------------------------
 
+  4.2. Using Comments
 
--------------------------------------------------------------------------------
+    4.2.1. Comment, Comment, Comment
 
-4.3.3. Header file prototypes
+   Explanation:
 
-Explanation:
+   Comment as much as possible without commenting the obvious. For example do
+   not comment "variable_a is equal to variable_b". Instead explain why
+   variable_a should be equal to the variable_b. Just because a person can
+   read code does not mean they will understand why or what is being done. A
+   reader may spend a lot more time figuring out what is going on when a
+   simple comment or explanation would have prevented the extra research.
+   Please help your brother IJB'ers out!
 
-Use a descriptive parameter name in the function prototype in header files. Use
-the same parameter name in the header file that you use in the c file.
+   The comments will also help justify the intent of the code. If the comment
+   describes something different than what the code is doing then maybe a
+   programming error is occurring.
 
-Example:
+   Example:
 
-(.h) extern int load_aclfile( struct client_state *csp );
-(.c) int load_aclfile( struct client_state *csp )
+   /* if page size greater than 1k ... */
+   if ( page_length() > 1024 )
+   {
+       ... "block" the page up ...
+   }
 
+   /* if page size is small, send it in blocks */
+   if ( page_length() > 1024 )
+   {
+       ... "block" the page up ...
+   }
 
-Instead of:
+   This demonstrates 2 cases of "what not to do".  The first is a
+   "syntax comment".  The second is a comment that does not fit what
+   is actually being done.
 
-(.h) extern int load_aclfile( struct client_state * ); or
-(.h) extern int load_aclfile();
-(.c) int load_aclfile( struct client_state *csp )
+   --------------------------------------------------------------------------
 
+    4.2.2. Use blocks for comments
 
--------------------------------------------------------------------------------
+   Explanation:
 
-4.3.4. Enumerations, and #defines
+   Comments can help or they can clutter. They help when they are
+   differentiated from the code they describe. One line comments do not offer
+   effective separation between the comment and the code. Block identifiers
+   do, by surrounding the code with a clear, definable pattern.
 
-Explanation:
+   Example:
 
-Use all capital letters, with underscores between words. Do not start an
-identifier with an underscore. (ANSI C reserves these for use by the compiler
-and system headers.)
+   /*********************************************************************
+    * This will stand out clearly in your code!
+    *********************************************************************/
+   if ( this_variable == that_variable )
+   {
+      do_something_very_important();
+   }
+
+
+   /* unfortunately, this may not */
+   if ( this_variable == that_variable )
+   {
+      do_something_very_important();
+   }
+
+
+   if ( this_variable == that_variable ) /* this may not either */
+   {
+      do_something_very_important();
+   }
 
-Example:
+   Exception:
 
-(enumeration) : enum Boolean { FALSE, TRUE };
-(#define) : #define DEFAULT_SIZE 100;
+   If you are trying to add a small logic comment and do not wish to
+   "disrupt" the flow of the code, feel free to use a 1 line comment which is
+   NOT on the same line as the code.
 
+   --------------------------------------------------------------------------
 
-Note: We have a standard naming scheme for #defines that toggle a feature in
-the preprocessor: FEATURE_>, where > is a short (preferably 1 or 2 word)
-description.
+    4.2.3. Keep Comments on their own line
 
-Example:
+   Explanation:
 
-#define FEATURE_FORCE 1
+   It goes back to the question of readability. If the comment is on the same
+   line as the code it will be harder to read than the comment that is on its
+   own line.
 
-#ifdef FEATURE_FORCE
-#define FORCE_PREFIX blah
-#endif /* def FEATURE_FORCE */
+   There are three exceptions to this rule, which should be violated freely
+   and often: during the definition of variables, at the end of closing
+   braces, when used to comment parameters.
 
+   Example:
 
--------------------------------------------------------------------------------
+   /*********************************************************************
+    * This will stand out clearly in your code,
+    * But the second example won't.
+    *********************************************************************/
+   if ( this_variable == this_variable )
+   {
+      do_something_very_important();
+   }
 
-4.3.5. Constants
+   if ( this_variable == this_variable ) /*can you see me?*/
+   {
+      do_something_very_important(); /*not easily*/
+   }
 
-Explanation:
 
-Spell common words out entirely (do not remove vowels).
+   /*********************************************************************
+    * But, the encouraged exceptions:
+    *********************************************************************/
+   int urls_read     = 0;     /* # of urls read + rejected */
+   int urls_rejected = 0;     /* # of urls rejected */
 
-Use only widely-known domain acronyms and abbreviations. Capitalize all letters
-of an acronym.
+   if ( 1 == X )
+   {
+      do_something_very_important();
+   }
 
-Use underscore (_) to separate adjacent acronyms and abbreviations. Never
-terminate a name with an underscore.
 
-Example:
+   short do_something_very_important(
+      short firstparam,   /* represents something */
+      short nextparam     /* represents something else */ )
+   {
+      ...code here...
 
-#define USE_IMAGE_LIST 1
+   }   /* -END- do_something_very_important */
 
+   --------------------------------------------------------------------------
 
-Instead of:
+    4.2.4. Comment each logical step
 
-#define USE_IMG_LST 1 or
-#define _USE_IMAGE_LIST 1 or
-#define USE_IMAGE_LIST_ 1 or
-#define use_image_list 1 or
-#define UseImageList 1
+   Explanation:
 
+   Logical steps should be commented to help others follow the intent of the
+   written code and comments will make the code more readable.
 
--------------------------------------------------------------------------------
+   If you have 25 lines of code without a comment, you should probably go
+   back into it to see where you forgot to put one.
 
-4.4. Using Space
+   Most "for", "while", "do", etc... loops _probably_ need a comment. After
+   all, these are usually major logic containers.
 
-4.4.1. Put braces on a line by themselves.
+   --------------------------------------------------------------------------
 
-Explanation:
+    4.2.5. Comment All Functions Thoroughly
 
-The brace needs to be on a line all by itself, not at the end of the statement.
-Curly braces should line up with the construct that they're associated with.
-This practice makes it easier to identify the opening and closing braces for a
-block.
+   Explanation:
 
-Example:
+   A reader of the code should be able to look at the comments just prior to
+   the beginning of a function and discern the reason for its existence and
+   the consequences of using it. The reader should not have to read through
+   the code to determine if a given function is safe for a desired use. The
+   proper information thoroughly presented at the introduction of a function
+   not only saves time for subsequent maintenance or debugging, it more
+   importantly aids in code reuse by allowing a user to determine the safety
+   and applicability of any function for the problem at hand. As a result of
+   such benefits, all functions should contain the information presented in
+   the addendum section of this document.
 
-if ( this == that )
-{
-   ...
-}
+   --------------------------------------------------------------------------
 
+    4.2.6. Comment at the end of braces if the content is more than one screen
+    length
 
-Instead of:
+   Explanation:
 
-if ( this == that ) { ... }
+   Each closing brace should be followed on the same line by a comment that
+   describes the origination of the brace if the original brace is off of the
+   screen, or otherwise far away from the closing brace. This will simplify
+   the debugging, maintenance, and readability of the code.
 
-or
+   As a suggestion , use the following flags to make the comment and its
+   brace more readable:
 
-if ( this == that ) { ... }
+   use following a closing brace: } /* -END- if() or while () or etc... */
 
-Note: In the special case that the if-statement is inside a loop, and it is
-trivial, i.e. it tests for a condition that is obvious from the purpose of the
-block, one-liners as above may optically preserve the loop structure and make
-it easier to read.
+   Example:
 
-Status: developer-discretion.
+   if ( 1 == X )
+   {
+      do_something_very_important();
+      ...some long list of commands...
+   } /* -END- if x is 1 */
 
-Example exception:
+   or:
 
-while ( more lines are read )
-{
-   /* Please document what is/is not a comment line here */
-   if ( it's a comment ) continue;
+   if ( 1 == X )
+   {
+      do_something_very_important();
+      ...some long list of commands...
+   } /* -END- if ( 1 == X ) */
 
-   do_something( line );
-}
+   --------------------------------------------------------------------------
 
+  4.3. Naming Conventions
 
--------------------------------------------------------------------------------
+    4.3.1. Variable Names
 
-4.4.2. ALL control statements should have a block
+   Explanation:
 
-Explanation:
+   Use all lowercase, and separate words via an underscore ('_'). Do not
+   start an identifier with an underscore. (ANSI C reserves these for use by
+   the compiler and system headers.) Do not use identifiers which are
+   reserved in ANSI C++. (E.g. template, class, true, false, ...). This is in
+   case we ever decide to port Privoxy to C++.
 
-Using braces to make a block will make your code more readable and less prone
-to error. All control statements should have a block defined.
+   Example:
 
-Example:
+   int ms_iis5_hack = 0;
 
-if ( this == that )
-{
-   do_something();
-   do_something_else();
-}
+   Instead of:
 
+   int msiis5hack = 0; int msIis5Hack = 0;
 
-Instead of:
+   --------------------------------------------------------------------------
 
-if ( this == that ) do_something(); do_something_else();
+    4.3.2. Function Names
 
-or
+   Explanation:
 
-if ( this == that ) do_something();
+   Use all lowercase, and separate words via an underscore ('_'). Do not
+   start an identifier with an underscore. (ANSI C reserves these for use by
+   the compiler and system headers.) Do not use identifiers which are
+   reserved in ANSI C++. (E.g. template, class, true, false, ...). This is in
+   case we ever decide to port Privoxy to C++.
 
-Note: The first example in "Instead of" will execute in a manner other than
-that which the developer desired (per indentation). Using code braces would
-have prevented this "feature". The "explanation" and "exception" from the point
-above also applies.
+   Example:
 
--------------------------------------------------------------------------------
+   int load_some_file( struct client_state *csp )
 
-4.4.3. Do not belabor/blow-up boolean expressions
+   Instead of:
 
-Example:
+   int loadsomefile( struct client_state *csp )
+   int loadSomeFile( struct client_state *csp )
 
-structure->flag = ( condition );
+   --------------------------------------------------------------------------
 
+    4.3.3. Header file prototypes
 
-Instead of:
+   Explanation:
 
-if ( condition ) { structure->flag = 1; } else { structure->flag = 0; }
+   Use a descriptive parameter name in the function prototype in header
+   files. Use the same parameter name in the header file that you use in the
+   c file.
 
-Note: The former is readable and concise. The later is wordy and inefficient.
-Please assume that any developer new to the project has at least a "good"
-knowledge of C/C++. (Hope I do not offend by that last comment ... 8-)
+   Example:
 
--------------------------------------------------------------------------------
+   (.h) extern int load_aclfile( struct client_state *csp );
+   (.c) int load_aclfile( struct client_state *csp )
 
-4.4.4. Use white space freely because it is free
+   Instead of:
 
-Explanation:
+   (.h) extern int load_aclfile( struct client_state * ); or
+   (.h) extern int load_aclfile();
+   (.c) int load_aclfile( struct client_state *csp )
 
-Make it readable. The notable exception to using white space freely is listed
-in the next guideline.
+   --------------------------------------------------------------------------
 
-Example:
+    4.3.4. Enumerations, and #defines
 
-int first_value   = 0;
-int some_value    = 0;
-int another_value = 0;
-int this_variable = 0;
+   Explanation:
 
-if ( this_variable == this_variable )
+   Use all capital letters, with underscores between words. Do not start an
+   identifier with an underscore. (ANSI C reserves these for use by the
+   compiler and system headers.)
 
-first_value = old_value + ( ( some_value - another_value ) - whatever )
+   Example:
 
+   (enumeration) : enum Boolean { FALSE, TRUE };
+   (#define) : #define DEFAULT_SIZE 100;
 
--------------------------------------------------------------------------------
+   Note: We have a standard naming scheme for #defines that toggle a feature
+   in the preprocessor: FEATURE_>, where > is a short (preferably 1 or 2
+   word) description.
 
-4.4.5. Don't use white space around structure operators
+   Example:
 
-Explanation:
+   #define FEATURE_FORCE 1
 
-- structure pointer operator ( "->" ) - member operator ( "." ) - functions and
-parentheses
+   #ifdef FEATURE_FORCE
+   #define FORCE_PREFIX blah
+   #endif /* def FEATURE_FORCE */
 
-It is a general coding practice to put pointers, references, and function
-parentheses next to names. With spaces, the connection between the object and
-variable/function name is not as clear.
+   --------------------------------------------------------------------------
 
-Example:
+    4.3.5. Constants
 
-a_struct->a_member;
-a_struct.a_member;
-function_name();
+   Explanation:
 
+   Spell common words out entirely (do not remove vowels).
 
-Instead of: a_struct -> a_member; a_struct . a_member; function_name ();
+   Use only widely-known domain acronyms and abbreviations. Capitalize all
+   letters of an acronym.
 
--------------------------------------------------------------------------------
+   Use underscore (_) to separate adjacent acronyms and abbreviations. Never
+   terminate a name with an underscore.
 
-4.4.6. Make the last brace of a function stand out
+   Example:
 
-Example:
+   #define USE_IMAGE_LIST 1
 
-int function1( ... )
-{
-   ...code...
-   return( ret_code );
+   Instead of:
 
-}   /* -END- function1 */
+   #define USE_IMG_LST 1 or
+   #define _USE_IMAGE_LIST 1 or
+   #define USE_IMAGE_LIST_ 1 or
+   #define use_image_list 1 or
+   #define UseImageList 1
 
+   --------------------------------------------------------------------------
 
-int function2( ... )
-{
-}   /* -END- function2 */
+  4.4. Using Space
 
+    4.4.1. Put braces on a line by themselves.
 
-Instead of:
+   Explanation:
 
-int function1( ... ) { ...code... return( ret_code ); } int function2( ... ) {
-}
+   The brace needs to be on a line all by itself, not at the end of the
+   statement. Curly braces should line up with the construct that they're
+   associated with. This practice makes it easier to identify the opening and
+   closing braces for a block.
 
-Note: Use 1 blank line before the closing brace and 2 lines afterward. This
-makes the end of function standout to the most casual viewer. Although function
-comments help separate functions, this is still a good coding practice. In
-fact, I follow these rules when using blocks in "for", "while", "do" loops, and
-long if {} statements too. After all whitespace is free!
+   Example:
 
-Status: developer-discretion on the number of blank lines. Enforced is the end
-of function comments.
+   if ( this == that )
+   {
+      ...
+   }
 
--------------------------------------------------------------------------------
+   Instead of:
 
-4.4.7. Use 3 character indentions
+   if ( this == that ) { ... }
 
-Explanation:
+   or
 
-If some use 8 character TABs and some use 3 character TABs, the code can look
-*very* ragged. So use 3 character indentions only. If you like to use TABs,
-pass your code through a filter such as "expand -t3" before checking in your
-code.
+   if ( this == that ) { ... }
 
-Example:
+   Note: In the special case that the if-statement is inside a loop, and it
+   is trivial, i.e. it tests for a condition that is obvious from the purpose
+   of the block, one-liners as above may optically preserve the loop
+   structure and make it easier to read.
 
-static const char * const url_code_map[256] =
-{
-   NULL, ...
-};
+   Status: developer-discretion.
 
+   Example exception:
 
-int function1( ... )
-{
-   if ( 1 )
+   while ( more lines are read )
    {
-      return( ALWAYS_TRUE );
+      /* Please document what is/is not a comment line here */
+      if ( it's a comment ) continue;
+
+      do_something( line );
    }
-   else
+
+   --------------------------------------------------------------------------
+
+    4.4.2. ALL control statements should have a block
+
+   Explanation:
+
+   Using braces to make a block will make your code more readable and less
+   prone to error. All control statements should have a block defined.
+
+   Example:
+
+   if ( this == that )
    {
-      return( HOW_DID_YOU_GET_HERE );
+      do_something();
+      do_something_else();
    }
 
-   return( NEVER_GETS_HERE );
+   Instead of:
 
-}
+   if ( this == that ) do_something(); do_something_else();
 
+   or
 
--------------------------------------------------------------------------------
+   if ( this == that ) do_something();
 
-4.5. Initializing
+   Note: The first example in "Instead of" will execute in a manner other
+   than that which the developer desired (per indentation). Using code braces
+   would have prevented this "feature". The "explanation" and "exception"
+   from the point above also applies.
 
-4.5.1. Initialize all variables
+   --------------------------------------------------------------------------
 
-Explanation:
+    4.4.3. Do not belabor/blow-up boolean expressions
 
-Do not assume that the variables declared will not be used until after they
-have been assigned a value somewhere else in the code. Remove the chance of
-accidentally using an unassigned variable.
+   Example:
 
-Example:
+   structure->flag = ( condition );
 
-short a_short = 0;
-float a_float  = 0;
-struct *ptr = NULL;
+   Instead of:
 
+   if ( condition ) { structure->flag = 1; } else { structure->flag = 0; }
 
-Note: It is much easier to debug a SIGSEGV if the message says you are trying
-to access memory address 00000000 and not 129FA012; or array_ptr[20] causes a
-SIGSEV vs. array_ptr[0].
+   Note: The former is readable and concise. The later is wordy and
+   inefficient. Please assume that any developer new to the project has at
+   least a "good" knowledge of C/C++. (Hope I do not offend by that last
+   comment ... 8-)
 
-Status: developer-discretion if and only if the variable is assigned a value
-"shortly after" declaration.
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    4.4.4. Use white space freely because it is free
 
-4.6. Functions
+   Explanation:
 
-4.6.1. Name functions that return a boolean as a question.
+   Make it readable. The notable exception to using white space freely is
+   listed in the next guideline.
 
-Explanation:
+   Example:
 
-Value should be phrased as a question that would logically be answered as a
-true or false statement
+   int first_value   = 0;
+   int some_value    = 0;
+   int another_value = 0;
+   int this_variable = 0;
 
-Example:
+   if ( this_variable == this_variable )
 
-should_we_block_this();
-contains_an_image();
-is_web_page_blank();
+   first_value = old_value + ( ( some_value - another_value ) - whatever )
 
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    4.4.5. Don't use white space around structure operators
 
-4.6.2. Always specify a return type for a function.
+   Explanation:
 
-Explanation:
+   - structure pointer operator ( "->" ) - member operator ( "." ) -
+   functions and parentheses
 
-The default return for a function is an int. To avoid ambiguity, create a
-return for a function when the return has a purpose, and create a void return
-type if the function does not need to return anything.
+   It is a general coding practice to put pointers, references, and function
+   parentheses next to names. With spaces, the connection between the object
+   and variable/function name is not as clear.
 
--------------------------------------------------------------------------------
+   Example:
 
-4.6.3. Minimize function calls when iterating by using variables
+   a_struct->a_member;
+   a_struct.a_member;
+   function_name();
 
-Explanation:
+   Instead of: a_struct -> a_member; a_struct . a_member; function_name ();
 
-It is easy to write the following code, and a clear argument can be made that
-the code is easy to understand:
+   --------------------------------------------------------------------------
 
-Example:
+    4.4.6. Make the last brace of a function stand out
 
-for ( size_t cnt = 0; cnt < block_list_length(); cnt++ )
-{
-   ....
-}
+   Example:
 
+   int function1( ... )
+   {
+      ...code...
+      return( ret_code );
 
-Note: Unfortunately, this makes a function call for each and every iteration.
-This increases the overhead in the program, because the compiler has to look up
-the function each time, call it, and return a value. Depending on what occurs
-in the block_list_length() call, it might even be creating and destroying
-structures with each iteration, even though in each case it is comparing "cnt"
-to the same value, over and over. Remember too - even a call to
-block_list_length() is a function call, with the same overhead.
+   }   /* -END- function1 */
 
-Instead of using a function call during the iterations, assign the value to a
-variable, and evaluate using the variable.
 
-Example:
+   int function2( ... )
+   {
+   }   /* -END- function2 */
 
-size_t len = block_list_length();
+   Instead of:
 
-for ( size_t cnt = 0; cnt < len; cnt++ )
-{
-   ....
-}
+   int function1( ... ) { ...code... return( ret_code ); } int function2( ...
+   ) { }
 
+   Note: Use 1 blank line before the closing brace and 2 lines afterward.
+   This makes the end of function standout to the most casual viewer.
+   Although function comments help separate functions, this is still a good
+   coding practice. In fact, I follow these rules when using blocks in "for",
+   "while", "do" loops, and long if {} statements too. After all whitespace
+   is free!
 
-Exceptions: if the value of block_list_length() *may* change or could
-*potentially* change, then you must code the function call in the for/while
-loop.
+   Status: developer-discretion on the number of blank lines. Enforced is the
+   end of function comments.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-4.6.4. Pass and Return by Const Reference
+    4.4.7. Use 3 character indentions
 
-Explanation:
+   Explanation:
 
-This allows a developer to define a const pointer and call your function. If
-your function does not have the const keyword, we may not be able to use your
-function. Consider strcmp, if it were defined as: extern int strcmp( char *s1,
-char *s2 );
+   If some use 8 character TABs and some use 3 character TABs, the code can
+   look *very* ragged. So use 3 character indentions only. If you like to use
+   TABs, pass your code through a filter such as "expand -t3" before checking
+   in your code.
 
-I could then not use it to compare argv's in main: int main( int argc, const
-char *argv[] ) { strcmp( argv[0], "privoxy" ); }
+   Example:
 
-Both these pointers are *const*! If the c runtime library maintainers do it, we
-should too.
+   static const char * const url_code_map[256] =
+   {
+      NULL, ...
+   };
 
--------------------------------------------------------------------------------
 
-4.6.5. Pass and Return by Value
+   int function1( ... )
+   {
+      if ( 1 )
+      {
+         return( ALWAYS_TRUE );
+      }
+      else
+      {
+         return( HOW_DID_YOU_GET_HERE );
+      }
 
-Explanation:
+      return( NEVER_GETS_HERE );
 
-Most structures cannot fit onto a normal stack entry (i.e. they are not 4 bytes
-or less). Aka, a function declaration like: int load_aclfile( struct
-client_state csp )
+   }
 
-would not work. So, to be consistent, we should declare all prototypes with
-"pass by value": int load_aclfile( struct client_state *csp )
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+  4.5. Initializing
 
-4.6.6. Names of include files
+    4.5.1. Initialize all variables
 
-Explanation:
+   Explanation:
 
-Your include statements should contain the file name without a path. The path
-should be listed in the Makefile, using -I as processor directive to search the
-indicated paths. An exception to this would be for some proprietary software
-that utilizes a partial path to distinguish their header files from system or
-other header files.
+   Do not assume that the variables declared will not be used until after
+   they have been assigned a value somewhere else in the code. Remove the
+   chance of accidentally using an unassigned variable.
 
-Example:
+   Example:
 
-#include <iostream.h>     /* This is not a local include */
-#include "config.h"       /* This IS a local include */
+   short a_short = 0;
+   float a_float  = 0;
+   struct *ptr = NULL;
 
+   Note: It is much easier to debug a SIGSEGV if the message says you are
+   trying to access memory address 00000000 and not 129FA012; or
+   array_ptr[20] causes a SIGSEV vs. array_ptr[0].
 
-Exception:
+   Status: developer-discretion if and only if the variable is assigned a
+   value "shortly after" declaration.
 
-/* This is not a local include, but requires a path element. */
-#include <sys/fileName.h>
+   --------------------------------------------------------------------------
 
+  4.6. Functions
 
-Note: Please! do not add "-I." to the Makefile without a _very_ good reason.
-This duplicates the #include "file.h" behavior.
+    4.6.1. Name functions that return a boolean as a question.
 
--------------------------------------------------------------------------------
+   Explanation:
 
-4.6.7. Provide multiple inclusion protection
+   Value should be phrased as a question that would logically be answered as
+   a true or false statement
 
-Explanation:
+   Example:
 
-Prevents compiler and linker errors resulting from redefinition of items.
+   should_we_block_this();
+   contains_an_image();
+   is_web_page_blank();
 
-Wrap each header file with the following syntax to prevent multiple inclusions
-of the file. Of course, replace PROJECT_H with your file name, with "." Changed
-to "_", and make it uppercase.
+   --------------------------------------------------------------------------
 
-Example:
+    4.6.2. Always specify a return type for a function.
 
-#ifndef PROJECT_H_INCLUDED
-#define PROJECT_H_INCLUDED
- ...
-#endif /* ndef PROJECT_H_INCLUDED */
+   Explanation:
 
+   The default return for a function is an int. To avoid ambiguity, create a
+   return for a function when the return has a purpose, and create a void
+   return type if the function does not need to return anything.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-4.6.8. Use `extern "C"` when appropriate
+    4.6.3. Minimize function calls when iterating by using variables
 
-Explanation:
+   Explanation:
 
-If our headers are included from C++, they must declare our functions as
-`extern "C"`. This has no cost in C, but increases the potential re-usability
-of our code.
+   It is easy to write the following code, and a clear argument can be made
+   that the code is easy to understand:
 
-Example:
+   Example:
 
-#ifdef __cplusplus
-extern "C"
-{
-#endif /* def __cplusplus */
+   for ( size_t cnt = 0; cnt < block_list_length(); cnt++ )
+   {
+      ....
+   }
 
-... function definitions here ...
+   Note: Unfortunately, this makes a function call for each and every
+   iteration. This increases the overhead in the program, because the
+   compiler has to look up the function each time, call it, and return a
+   value. Depending on what occurs in the block_list_length() call, it might
+   even be creating and destroying structures with each iteration, even
+   though in each case it is comparing "cnt" to the same value, over and
+   over. Remember too - even a call to block_list_length() is a function
+   call, with the same overhead.
 
-#ifdef __cplusplus
-}
-#endif /* def __cplusplus */
+   Instead of using a function call during the iterations, assign the value
+   to a variable, and evaluate using the variable.
 
+   Example:
 
--------------------------------------------------------------------------------
+   size_t len = block_list_length();
 
-4.6.9. Where Possible, Use Forward Struct Declaration Instead of Includes
+   for ( size_t cnt = 0; cnt < len; cnt++ )
+   {
+      ....
+   }
 
-Explanation:
+   Exceptions: if the value of block_list_length() *may* change or could
+   *potentially* change, then you must code the function call in the
+   for/while loop.
 
-Useful in headers that include pointers to other struct's. Modifications to
-excess header files may cause needless compiles.
+   --------------------------------------------------------------------------
 
-Example:
+    4.6.4. Pass and Return by Const Reference
 
-/*********************************************************************
- * We're avoiding an include statement here!
- *********************************************************************/
-struct file_list;
-extern file_list *xyz;
+   Explanation:
+
+   This allows a developer to define a const pointer and call your function.
+   If your function does not have the const keyword, we may not be able to
+   use your function. Consider strcmp, if it were defined as: extern int
+   strcmp( char *s1, char *s2 );
+
+   I could then not use it to compare argv's in main: int main( int argc,
+   const char *argv[] ) { strcmp( argv[0], "privoxy" ); }
+
+   Both these pointers are *const*! If the c runtime library maintainers do
+   it, we should too.
+
+   --------------------------------------------------------------------------
+
+    4.6.5. Pass and Return by Value
+
+   Explanation:
 
+   Most structures cannot fit onto a normal stack entry (i.e. they are not 4
+   bytes or less). Aka, a function declaration like: int load_aclfile( struct
+   client_state csp )
 
-Note: If you declare "file_list xyz;" (without the pointer), then including the
-proper header file is necessary. If you only want to prototype a pointer,
-however, the header file is unnecessary.
+   would not work. So, to be consistent, we should declare all prototypes
+   with "pass by value": int load_aclfile( struct client_state *csp )
 
-Status: Use with discretion.
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    4.6.6. Names of include files
 
-4.7. General Coding Practices
+   Explanation:
 
-4.7.1. Turn on warnings
+   Your include statements should contain the file name without a path. The
+   path should be listed in the Makefile, using -I as processor directive to
+   search the indicated paths. An exception to this would be for some
+   proprietary software that utilizes a partial path to distinguish their
+   header files from system or other header files.
 
-Explanation
+   Example:
 
-Compiler warnings are meant to help you find bugs. You should turn on as many
-as possible. With GCC, the switch is "-Wall". Try and fix as many warnings as
-possible.
+   #include <iostream.h>     /* This is not a local include */
+   #include "config.h"       /* This IS a local include */
 
--------------------------------------------------------------------------------
+   Exception:
 
-4.7.2. Provide a default case for all switch statements
+   /* This is not a local include, but requires a path element. */
+   #include <sys/fileName.h>
 
-Explanation:
+   Note: Please! do not add "-I." to the Makefile without a _very_ good
+   reason. This duplicates the #include "file.h" behavior.
 
-What you think is guaranteed is never really guaranteed. The value that you
-don't think you need to check is the one that someday will be passed. So, to
-protect yourself from the unknown, always have a default step in a switch
-statement.
+   --------------------------------------------------------------------------
 
-Example:
+    4.6.7. Provide multiple inclusion protection
 
-switch( hash_string( cmd ) )
-{
-   case hash_actions_file :
-      ... code ...
-      break;
+   Explanation:
 
-   case hash_confdir :
-      ... code ...
-      break;
+   Prevents compiler and linker errors resulting from redefinition of items.
 
-   default :
-      log_error( ... );
-      ... anomaly code goes here ...
-      continue; / break; / exit( 1 ); / etc ...
+   Wrap each header file with the following syntax to prevent multiple
+   inclusions of the file. Of course, replace PROJECT_H with your file name,
+   with "." Changed to "_", and make it uppercase.
 
-} /* end switch( hash_string( cmd ) ) */
+   Example:
 
+   #ifndef PROJECT_H_INCLUDED
+   #define PROJECT_H_INCLUDED
+    ...
+   #endif /* ndef PROJECT_H_INCLUDED */
 
-Note: If you already have a default condition, you are obviously exempt from
-this point. Of note, most of the WIN32 code calls `DefWindowProc' after the
-switch statement. This API call *should* be included in a default statement.
+   --------------------------------------------------------------------------
 
-Another Note: This is not so much a readability issue as a robust programming
-issue. The "anomaly code goes here" may be no more than a print to the STDERR
-stream (as in load_config). Or it may really be an abort condition.
+    4.6.8. Use `extern "C"` when appropriate
 
-Status: Programmer discretion is advised.
+   Explanation:
 
--------------------------------------------------------------------------------
+   If our headers are included from C++, they must declare our functions as
+   `extern "C"`. This has no cost in C, but increases the potential
+   re-usability of our code.
 
-4.7.3. Try to avoid falling through cases in a switch statement.
+   Example:
 
-Explanation:
+   #ifdef __cplusplus
+   extern "C"
+   {
+   #endif /* def __cplusplus */
+
+   ... function definitions here ...
+
+   #ifdef __cplusplus
+   }
+   #endif /* def __cplusplus */
+
+   --------------------------------------------------------------------------
+
+    4.6.9. Where Possible, Use Forward Struct Declaration Instead of Includes
+
+   Explanation:
+
+   Useful in headers that include pointers to other struct's. Modifications
+   to excess header files may cause needless compiles.
+
+   Example:
+
+   /*********************************************************************
+    * We're avoiding an include statement here!
+    *********************************************************************/
+   struct file_list;
+   extern file_list *xyz;
+
+   Note: If you declare "file_list xyz;" (without the pointer), then
+   including the proper header file is necessary. If you only want to
+   prototype a pointer, however, the header file is unnecessary.
+
+   Status: Use with discretion.
+
+   --------------------------------------------------------------------------
+
+  4.7. General Coding Practices
+
+    4.7.1. Turn on warnings
+
+   Explanation
+
+   Compiler warnings are meant to help you find bugs. You should turn on as
+   many as possible. With GCC, the switch is "-Wall". Try and fix as many
+   warnings as possible.
+
+   --------------------------------------------------------------------------
+
+    4.7.2. Provide a default case for all switch statements
 
-In general, you will want to have a 'break' statement within each 'case' of a
-switch statement. This allows for the code to be more readable and
-understandable, and furthermore can prevent unwanted surprises if someone else
-later gets creative and moves the code around.
+   Explanation:
 
-The language allows you to plan the fall through from one case statement to
-another simply by omitting the break statement within the case statement. This
-feature does have benefits, but should only be used in rare cases. In general,
-use a break statement for each case statement.
+   What you think is guaranteed is never really guaranteed. The value that
+   you don't think you need to check is the one that someday will be passed.
+   So, to protect yourself from the unknown, always have a default step in a
+   switch statement.
 
-If you choose to allow fall through, you should comment both the fact of the
-fall through and reason why you felt it was necessary.
+   Example:
 
--------------------------------------------------------------------------------
+   switch( hash_string( cmd ) )
+   {
+      case hash_actions_file :
+         ... code ...
+         break;
+
+      case hash_confdir :
+         ... code ...
+         break;
+
+      default :
+         log_error( ... );
+         ... anomaly code goes here ...
+         continue; / break; / exit( 1 ); / etc ...
+
+   } /* end switch( hash_string( cmd ) ) */
+
+   Note: If you already have a default condition, you are obviously exempt
+   from this point. Of note, most of the WIN32 code calls `DefWindowProc'
+   after the switch statement. This API call *should* be included in a
+   default statement.
+
+   Another Note: This is not so much a readability issue as a robust
+   programming issue. The "anomaly code goes here" may be no more than a
+   print to the STDERR stream (as in load_config). Or it may really be an
+   abort condition.
+
+   Status: Programmer discretion is advised.
+
+   --------------------------------------------------------------------------
+
+    4.7.3. Try to avoid falling through cases in a switch statement.
+
+   Explanation:
 
-4.7.4. Use 'long' or 'short' Instead of 'int'
+   In general, you will want to have a 'break' statement within each 'case'
+   of a switch statement. This allows for the code to be more readable and
+   understandable, and furthermore can prevent unwanted surprises if someone
+   else later gets creative and moves the code around.
 
-Explanation:
+   The language allows you to plan the fall through from one case statement
+   to another simply by omitting the break statement within the case
+   statement. This feature does have benefits, but should only be used in
+   rare cases. In general, use a break statement for each case statement.
 
-On 32-bit platforms, int usually has the range of long. On 16-bit platforms,
-int has the range of short.
+   If you choose to allow fall through, you should comment both the fact of
+   the fall through and reason why you felt it was necessary.
 
-Status: open-to-debate. In the case of most FSF projects (including X/
-GNU-Emacs), there are typedefs to int4, int8, int16, (or equivalence ... I
-forget the exact typedefs now). Should we add these to IJB now that we have a
-"configure" script?
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    4.7.4. Use 'long' or 'short' Instead of 'int'
 
-4.7.5. Don't mix size_t and other types
+   Explanation:
 
-Explanation:
+   On 32-bit platforms, int usually has the range of long. On 16-bit
+   platforms, int has the range of short.
 
-The type of size_t varies across platforms. Do not make assumptions about
-whether it is signed or unsigned, or about how long it is. Do not compare a
-size_t against another variable of a different type (or even against a
-constant) without casting one of the values.
+   Status: open-to-debate. In the case of most FSF projects (including
+   X/GNU-Emacs), there are typedefs to int4, int8, int16, (or equivalence ...
+   I forget the exact typedefs now). Should we add these to IJB now that we
+   have a "configure" script?
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-4.7.6. Declare each variable and struct on its own line.
+    4.7.5. Don't mix size_t and other types
 
-Explanation:
+   Explanation:
 
-It can be tempting to declare a series of variables all on one line. Don't.
+   The type of size_t varies across platforms. Do not make assumptions about
+   whether it is signed or unsigned, or about how long it is. Do not compare
+   a size_t against another variable of a different type (or even against a
+   constant) without casting one of the values.
 
-Example:
+   --------------------------------------------------------------------------
 
-long a = 0;
-long b = 0;
-long c = 0;
+    4.7.6. Declare each variable and struct on its own line.
 
+   Explanation:
 
-Instead of:
+   It can be tempting to declare a series of variables all on one line.
+   Don't.
 
-long a, b, c;
+   Example:
 
-Explanation: - there is more room for comments on the individual variables -
-easier to add new variables without messing up the original ones - when
-searching on a variable to find its type, there is less clutter to "visually"
-eliminate
+   long a = 0;
+   long b = 0;
+   long c = 0;
 
-Exceptions: when you want to declare a bunch of loop variables or other trivial
-variables; feel free to declare them on one line. You should, although, provide
-a good comment on their functions.
+   Instead of:
 
-Status: developer-discretion.
+   long a, b, c;
 
--------------------------------------------------------------------------------
+   Explanation: - there is more room for comments on the individual variables
+   - easier to add new variables without messing up the original ones - when
+   searching on a variable to find its type, there is less clutter to
+   "visually" eliminate
 
-4.7.7. Use malloc/zalloc sparingly
+   Exceptions: when you want to declare a bunch of loop variables or other
+   trivial variables; feel free to declare them on one line. You should,
+   although, provide a good comment on their functions.
 
-Explanation:
+   Status: developer-discretion.
 
-Create a local struct (on the stack) if the variable will live and die within
-the context of one function call.
+   --------------------------------------------------------------------------
 
-Only "malloc" a struct (on the heap) if the variable's life will extend beyond
-the context of one function call.
+    4.7.7. Use malloc/zalloc sparingly
 
-Example:
+   Explanation:
 
-If a function creates a struct and stores a pointer to it in a
-list, then it should definitely be allocated via `malloc'.
+   Create a local struct (on the stack) if the variable will live and die
+   within the context of one function call.
 
+   Only "malloc" a struct (on the heap) if the variable's life will extend
+   beyond the context of one function call.
 
--------------------------------------------------------------------------------
+   Example:
 
-4.7.8. The Programmer Who Uses 'malloc' is Responsible for Ensuring 'free'
+   If a function creates a struct and stores a pointer to it in a
+   list, then it should definitely be allocated via `malloc'.
 
-Explanation:
+   --------------------------------------------------------------------------
 
-If you have to "malloc" an instance, you are responsible for insuring that the
-instance is `free'd, even if the deallocation event falls within some other
-programmer's code. You are also responsible for ensuring that deletion is
-timely (i.e. not too soon, not too late). This is known as "low-coupling" and
-is a "good thing (tm)". You may need to offer a free/unload/destructor type
-function to accommodate this.
+    4.7.8. The Programmer Who Uses 'malloc' is Responsible for Ensuring 'free'
 
-Example:
+   Explanation:
 
-int load_re_filterfile( struct client_state *csp ) { ... }
-static void unload_re_filterfile( void *f ) { ... }
+   If you have to "malloc" an instance, you are responsible for insuring that
+   the instance is `free'd, even if the deallocation event falls within some
+   other programmer's code. You are also responsible for ensuring that
+   deletion is timely (i.e. not too soon, not too late). This is known as
+   "low-coupling" and is a "good thing (tm)". You may need to offer a
+   free/unload/destructor type function to accommodate this.
 
+   Example:
 
-Exceptions:
+   int load_re_filterfile( struct client_state *csp ) { ... }
+   static void unload_re_filterfile( void *f ) { ... }
 
-The developer cannot be expected to provide `free'ing functions for C run-time
-library functions ... such as `strdup'.
+   Exceptions:
 
-Status: developer-discretion. The "main" use of this standard is for allocating
-and freeing data structures (complex or nested).
+   The developer cannot be expected to provide `free'ing functions for C
+   run-time library functions ... such as `strdup'.
 
--------------------------------------------------------------------------------
+   Status: developer-discretion. The "main" use of this standard is for
+   allocating and freeing data structures (complex or nested).
 
-4.7.9. Add loaders to the `file_list' structure and in order
+   --------------------------------------------------------------------------
 
-Explanation:
+    4.7.9. Add loaders to the `file_list' structure and in order
 
-I have ordered all of the "blocker" file code to be in alpha order. It is
-easier to add/read new blockers when you expect a certain order.
+   Explanation:
 
-Note: It may appear that the alpha order is broken in places by POPUP tests
-coming before PCRS tests. But since POPUPs can also be referred to as
-KILLPOPUPs, it is clear that it should come first.
+   I have ordered all of the "blocker" file code to be in alpha order. It is
+   easier to add/read new blockers when you expect a certain order.
 
--------------------------------------------------------------------------------
+   Note: It may appear that the alpha order is broken in places by POPUP
+   tests coming before PCRS tests. But since POPUPs can also be referred to
+   as KILLPOPUPs, it is clear that it should come first.
 
-4.7.10. "Uncertain" new code and/or changes to existing code, use FIXME or XXX
+   --------------------------------------------------------------------------
 
-Explanation:
+    4.7.10. "Uncertain" new code and/or changes to existing code, use FIXME or
+    XXX
 
-If you have enough confidence in new code or confidence in your changes, but
-are not *quite* sure of the repercussions, add this:
+   Explanation:
 
-/* FIXME: this code has a logic error on platform XYZ, * attempting to fix */ #
-ifdef PLATFORM ...changed code here... #endif
+   If you have enough confidence in new code or confidence in your changes,
+   but are not *quite* sure of the repercussions, add this:
 
-or:
+   /* FIXME: this code has a logic error on platform XYZ, * attempting to fix
+   */ #ifdef PLATFORM ...changed code here... #endif
 
-/* FIXME: I think the original author really meant this... */ ...changed code
-here...
+   or:
 
-or:
+   /* FIXME: I think the original author really meant this... */ ...changed
+   code here...
 
-/* FIXME: new code that *may* break something else... */ ...new code here...
+   or:
 
-Note: If you make it clear that this may or may not be a "good thing (tm)", it
-will be easier to identify and include in the project (or conversely exclude
-from the project).
+   /* FIXME: new code that *may* break something else... */ ...new code
+   here...
 
--------------------------------------------------------------------------------
+   Note: If you make it clear that this may or may not be a "good thing
+   (tm)", it will be easier to identify and include in the project (or
+   conversely exclude from the project).
 
-4.8. Addendum: Template for files and function comment blocks:
+   --------------------------------------------------------------------------
 
-Example for file comments:
+  4.8. Addendum: Template for files and function comment blocks:
 
-const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 2.15 2008/01/19 15:03:05 hal9 Exp $";
+   Example for file comments:
+
+const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 2.16 2008/01/19 17:52:38 hal9 Exp $";
 /*********************************************************************
  *
  * File        :  $Source$
@@ -1489,21 +1546,21 @@ const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 2.15 2008/01/19 15:03:
 
 const char FILENAME_h_rcs[] = FILENAME_H_VERSION;
 
+   Note: This declares the rcs variables that should be added to the
+   "show-proxy-args" page. If this is a brand new creation by you, you are
+   free to change the "Copyright" section to represent the rights you wish to
+   maintain.
 
-Note: This declares the rcs variables that should be added to the
-"show-proxy-args" page. If this is a brand new creation by you, you are free to
-change the "Copyright" section to represent the rights you wish to maintain.
-
-Note: The formfeed character that is present right after the comment flower box
-is handy for (X|GNU)Emacs users to skip the verbiage and get to the heart of
-the code (via `forward-page' and `backward-page'). Please include it if you
-can.
+   Note: The formfeed character that is present right after the comment
+   flower box is handy for (X|GNU)Emacs users to skip the verbiage and get to
+   the heart of the code (via `forward-page' and `backward-page'). Please
+   include it if you can.
 
-Example for file header comments:
+   Example for file header comments:
 
 #ifndef _FILENAME_H
 #define _FILENAME_H
-#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 2.15 2008/01/19 15:03:05 hal9 Exp $"
+#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 2.16 2008/01/19 17:52:38 hal9 Exp $"
 /*********************************************************************
  *
  * File        :  $Source$
@@ -1568,928 +1625,921 @@ extern const char FILENAME_h_rcs[];
   end:
 */
 
+   Example for function comments:
+
+   /*********************************************************************
+    *
+    * Function    :  FUNCTION_NAME
+    *
+    * Description :  (Fill me in with a good description!)
+    *
+    * parameters  :
+    *          1  :  param1 = pointer to an important thing
+    *          2  :  x      = pointer to something else
+    *
+    * Returns     :  0 => Ok, everything else is an error.
+    *
+    *********************************************************************/
+   int FUNCTION_NAME( void *param1, const char *x )
+   {
+      ...
+      return( 0 );
 
-Example for function comments:
-
-/*********************************************************************
- *
- * Function    :  FUNCTION_NAME
- *
- * Description :  (Fill me in with a good description!)
- *
- * parameters  :
- *          1  :  param1 = pointer to an important thing
- *          2  :  x      = pointer to something else
- *
- * Returns     :  0 => Ok, everything else is an error.
- *
- *********************************************************************/
-int FUNCTION_NAME( void *param1, const char *x )
-{
-   ...
-   return( 0 );
-
-}
-
+   }
 
-Note: If we all follow this practice, we should be able to parse our code to
-create a "self-documenting" web page.
+   Note: If we all follow this practice, we should be able to parse our code
+   to create a "self-documenting" web page.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
 5. Testing Guidelines
 
-To be filled.
+   To be filled.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-5.1. Testplan for releases
+  5.1. Testplan for releases
 
-Explain release numbers. major, minor. developer releases. etc.
+   Explain release numbers. major, minor. developer releases. etc.
 
- 1. Remove any existing rpm with rpm -e
   1. Remove any existing rpm with rpm -e
 
- 2. Remove any file that was left over. This includes (but is not limited to)
+    2. Remove any file that was left over. This includes (but is not limited
+       to)
 
-      + /var/log/privoxy
+          * /var/log/privoxy
 
-      + /etc/privoxy
+          * /etc/privoxy
 
-      + /usr/sbin/privoxy
+          * /usr/sbin/privoxy
 
-      + /etc/init.d/privoxy
+          * /etc/init.d/privoxy
 
-      + /usr/doc/privoxy*
+          * /usr/doc/privoxy*
 
- 3. Install the rpm. Any error messages?
   3. Install the rpm. Any error messages?
 
- 4. start,stop,status Privoxy with the specific script (e.g. /etc/rc.d/init/
-    privoxy stop). Reboot your machine. Does autostart work?
+    4. start,stop,status Privoxy with the specific script (e.g.
+       /etc/rc.d/init/privoxy stop). Reboot your machine. Does autostart
+       work?
 
- 5. Start browsing. Does Privoxy work? Logfile written?
   5. Start browsing. Does Privoxy work? Logfile written?
 
- 6. Remove the rpm. Any error messages? All files removed?
   6. Remove the rpm. Any error messages? All files removed?
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-5.2. Test reports
+  5.2. Test reports
 
-Please submit test reports only with the test form at sourceforge. Three simple
-steps:
+   Please submit test reports only with the test form at sourceforge. Three
+   simple steps:
 
-  * Select category: the distribution you test on.
+     * Select category: the distribution you test on.
 
-  * Select group: the version of Privoxy that we are about to release.
+     * Select group: the version of Privoxy that we are about to release.
 
-  * Fill the Summary and Detailed Description with something intelligent (keep
-    it short and precise).
+     * Fill the Summary and Detailed Description with something intelligent
+       (keep it short and precise).
 
-Do not mail to the mailing list (we cannot keep track on issues there).
+   Do not mail to the mailing list (we cannot keep track on issues there).
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
 6. Releasing a New Version
 
-When we release versions of Privoxy, our work leaves our cozy secret lab and
-has to work in the cold RealWorld[tm]. Once it is released, there is no way to
-call it back, so it is very important that great care is taken to ensure that
-everything runs fine, and not to introduce problems in the very last minute.
-
-So when releasing a new version, please adhere exactly to the procedure
-outlined in this chapter.
-
-The following programs are required to follow this process: ncftpput (ncftp),
-scp, ssh (ssh), gmake (GNU's version of make), autoconf, cvs.
-
--------------------------------------------------------------------------------
-
-6.1. Version numbers
-
-First you need to determine which version number the release will have. Privoxy
-version numbers consist of three numbers, separated by dots, like in X.Y.Z
-(e.g. 3.0.0), where:
-
-  * X, the version major, is rarely ever changed. It is increased by one if
-    turning a development branch into stable substantially changes the
-    functionality, user interface or configuration syntax. Majors 1 and 2 were
-    Junkbuster, and 3 will be the first stable Privoxy release.
-
-  * Y, the version minor, represents the branch within the major version. At
-    any point in time, there are two branches being maintained: The stable
-    branch, with an even minor, say, 2N, in which no functionality is being
-    added and only bug-fixes are made, and 2N+1, the development branch, in
-    which the further development of Privoxy takes place. This enables us to
-    turn the code upside down and inside out, while at the same time providing
-    and maintaining a stable version. The minor is reset to zero (and one) when
-    the major is incremented. When a development branch has matured to the
-    point where it can be turned into stable, the old stable branch 2N is given
-    up (i.e. no longer maintained), the former development branch 2N+1 becomes
-    the new stable branch 2N+2, and a new development branch 2N+3 is opened.
-
-  * Z, the point or sub version, represents a release of the software within a
-    branch. It is therefore incremented immediately before each code freeze. In
-    development branches, only the even point versions correspond to actual
-    releases, while the odd ones denote the evolving state of the sources on
-    CVS in between. It follows that Z is odd on CVS in development branches
-    most of the time. There, it gets increased to an even number immediately
-    before a code freeze, and is increased to an odd number again immediately
-    thereafter. This ensures that builds from CVS snapshots are easily
-    distinguished from released versions. The point version is reset to zero
-    when the minor changes.
-
-    Stable branches work a little differently, since there should be little to
-    no development happening in such branches. Remember, only bugfixes, which
-    presumably should have had some testing before being committed. Stable
-    branches will then have their version reported as 0.0.0, during that period
-    between releases when changes are being added. This is to denote that this
-    code is not for release. Then as the release nears, the version is bumped
-    according: e.g. 3.0.1 -> 0.0.0 -> 3.0.2.
-
-In summary, the main CVS trunk is the development branch where new features are
-being worked on for the next stable series. This should almost always be where
-the most activity takes place. There is always at least one stable branch from
-the trunk, e.g now it is 3.0, which is only used to release stable versions.
-Once the initial *.0 release of the stable branch has been done, then as a
-rule, only bugfixes that have had prior testing should be committed to the
-stable branch. Once there are enough bugfixes to justify a new release, the
-version of this branch is again incremented Example: 3.0.0 -> 3.0.1 -> 3.0.2,
-etc are all stable releases from within the stable branch. 3.1.x is currently
-the main trunk, and where work on 3.2.x is taking place. If any questions,
-please post to the devel list before committing to a stable branch!
-
-Developers should remember too that if they commit a bugfix to the stable
-branch, this will more than likely require a separate submission to the main
-trunk, since these are separate development trees within CVS. If you are
-working on both, then this would require at least two separate check outs (i.e
-main trunk, and the stable release branch, which is v_3_0_branch at the
-moment).
-
--------------------------------------------------------------------------------
-
-6.2. Before the Release: Freeze
-
-The following must be done by one of the developers prior to each new release.
-
-  * Make sure that everybody who has worked on the code in the last couple of
-    days has had a chance to yell "no!" in case they have pending changes/fixes
-    in their pipelines. Announce the freeze so that nobody will interfere with
-    last minute changes.
-
-  * Increment the version number (point from odd to even in development
-    branches!) in configure.in. (RPM spec files will need to be incremented as
-    well.)
-
-  * If default.action has changed since last release (i.e. software release or
-    standalone actions file release), bump up its version info to A.B in this
-    line:
-
-      {+add-header{X-Actions-File-Version: A.B} -filter -no-popups}
-
-
-    Then change the version info in doc/webserver/actions/index.php, line:
-    '$required_actions_file_version = "A.B";'
-
-  * All documentation should be rebuild after the version bump. Finished docs
-    should be then be committed to CVS (for those without the ability to build
-    these). Some docs may require rather obscure processing tools. config, the
-    man page (and the html version of the man page), and the PDF docs fall in
-    this category. REAMDE, the man page, AUTHORS, and config should all also be
-    committed to CVS for other packagers. The formal docs should be uploaded to
-    the webserver. See the Section "Updating the webserver" in this manual for
-    details.
-
-  * The User Manual is also used for context sensitive help for the CGI editor.
-    This is version sensitive, so that the user will get appropriate help for
-    his/her release. So with each release a fresh version should be uploaded to
-    the webserver (this is in addition to the main User Manual link from the
-    main page since we need to keep manuals for various versions available).
-    The CGI pages will link to something like http://privoxy.org/$(VERSION)/
-    user-manual/. This will need to be updated for each new release. There is
-    no Makefile target for this at this time!!! It needs to be done manually.
-
-  * All developers should look at the ChangeLog and make sure noteworthy
-    changes are referenced.
-
-  * Commit all files that were changed in the above steps!
-
-  * Tag all files in CVS with the version number with "cvs tag v_X_Y_Z". Don't
-    use vX_Y_Z, ver_X_Y_Z, v_X.Y.Z (won't work) etc.
-
-  * If the release was in a development branch, increase the point version from
-    even to odd (X.Y.(Z+1)) again in configure.in and commit your change.
-
-  * On the webserver, copy the user manual to a new top-level directory called
-    X.Y.Z. This ensures that help links from the CGI pages, which have the
-    version as a prefix, will go into the right version of the manual. If this
-    is a development branch release, also symlink X.Y.(Z-1) to X.Y.Z and X.Y.
-    (Z+1) to . (i.e. dot).
-
--------------------------------------------------------------------------------
-
-6.3. Building and Releasing the Packages
-
-Now the individual packages can be built and released. Note that for GPL
-reasons the first package to be released is always the source tarball.
-
-For all types of packages, including the source tarball, you must make sure
-that you build from clean sources by exporting the right version from CVS into
-an empty directory (just press return when asked for a password):
+   When we release versions of Privoxy, our work leaves our cozy secret lab
+   and has to work in the cold RealWorld[tm]. Once it is released, there is
+   no way to call it back, so it is very important that great care is taken
+   to ensure that everything runs fine, and not to introduce problems in the
+   very last minute.
+
+   So when releasing a new version, please adhere exactly to the procedure
+   outlined in this chapter.
+
+   The following programs are required to follow this process: ncftpput
+   (ncftp), scp, ssh (ssh), gmake (GNU's version of make), autoconf, cvs.
+
+   --------------------------------------------------------------------------
+
+  6.1. Version numbers
+
+   First you need to determine which version number the release will have.
+   Privoxy version numbers consist of three numbers, separated by dots, like
+   in X.Y.Z (e.g. 3.0.0), where:
+
+     * X, the version major, is rarely ever changed. It is increased by one
+       if turning a development branch into stable substantially changes the
+       functionality, user interface or configuration syntax. Majors 1 and 2
+       were Junkbuster, and 3 will be the first stable Privoxy release.
+
+     * Y, the version minor, represents the branch within the major version.
+       At any point in time, there are two branches being maintained: The
+       stable branch, with an even minor, say, 2N, in which no functionality
+       is being added and only bug-fixes are made, and 2N+1, the development
+       branch, in which the further development of Privoxy takes place. This
+       enables us to turn the code upside down and inside out, while at the
+       same time providing and maintaining a stable version. The minor is
+       reset to zero (and one) when the major is incremented. When a
+       development branch has matured to the point where it can be turned
+       into stable, the old stable branch 2N is given up (i.e. no longer
+       maintained), the former development branch 2N+1 becomes the new stable
+       branch 2N+2, and a new development branch 2N+3 is opened.
+
+     * Z, the point or sub version, represents a release of the software
+       within a branch. It is therefore incremented immediately before each
+       code freeze. In development branches, only the even point versions
+       correspond to actual releases, while the odd ones denote the evolving
+       state of the sources on CVS in between. It follows that Z is odd on
+       CVS in development branches most of the time. There, it gets increased
+       to an even number immediately before a code freeze, and is increased
+       to an odd number again immediately thereafter. This ensures that
+       builds from CVS snapshots are easily distinguished from released
+       versions. The point version is reset to zero when the minor changes.
+
+       Stable branches work a little differently, since there should be
+       little to no development happening in such branches. Remember, only
+       bugfixes, which presumably should have had some testing before being
+       committed. Stable branches will then have their version reported as
+       0.0.0, during that period between releases when changes are being
+       added. This is to denote that this code is not for release. Then as
+       the release nears, the version is bumped according: e.g. 3.0.1 ->
+       0.0.0 -> 3.0.2.
+
+   In summary, the main CVS trunk is the development branch where new
+   features are being worked on for the next stable series. This should
+   almost always be where the most activity takes place. There is always at
+   least one stable branch from the trunk, e.g now it is 3.0, which is only
+   used to release stable versions. Once the initial *.0 release of the
+   stable branch has been done, then as a rule, only bugfixes that have had
+   prior testing should be committed to the stable branch. Once there are
+   enough bugfixes to justify a new release, the version of this branch is
+   again incremented Example: 3.0.0 -> 3.0.1 -> 3.0.2, etc are all stable
+   releases from within the stable branch. 3.1.x is currently the main trunk,
+   and where work on 3.2.x is taking place. If any questions, please post to
+   the devel list before committing to a stable branch!
+
+   Developers should remember too that if they commit a bugfix to the stable
+   branch, this will more than likely require a separate submission to the
+   main trunk, since these are separate development trees within CVS. If you
+   are working on both, then this would require at least two separate check
+   outs (i.e main trunk, and the stable release branch, which is v_3_0_branch
+   at the moment).
+
+   --------------------------------------------------------------------------
+
+  6.2. Before the Release: Freeze
+
+   The following must be done by one of the developers prior to each new
+   release.
+
+     * Make sure that everybody who has worked on the code in the last couple
+       of days has had a chance to yell "no!" in case they have pending
+       changes/fixes in their pipelines. Announce the freeze so that nobody
+       will interfere with last minute changes.
+
+     * Increment the version number (point from odd to even in development
+       branches!) in configure.in. (RPM spec files will need to be
+       incremented as well.)
+
+     * If default.action has changed since last release (i.e. software
+       release or standalone actions file release), bump up its version info
+       to A.B in this line:
+
+         {+add-header{X-Actions-File-Version: A.B} -filter -no-popups}
+
+       Then change the version info in doc/webserver/actions/index.php, line:
+       '$required_actions_file_version = "A.B";'
+
+     * All documentation should be rebuild after the version bump. Finished
+       docs should be then be committed to CVS (for those without the ability
+       to build these). Some docs may require rather obscure processing
+       tools. config, the man page (and the html version of the man page),
+       and the PDF docs fall in this category. REAMDE, the man page, AUTHORS,
+       and config should all also be committed to CVS for other packagers.
+       The formal docs should be uploaded to the webserver. See the Section
+       "Updating the webserver" in this manual for details.
+
+     * The User Manual is also used for context sensitive help for the CGI
+       editor. This is version sensitive, so that the user will get
+       appropriate help for his/her release. So with each release a fresh
+       version should be uploaded to the webserver (this is in addition to
+       the main User Manual link from the main page since we need to keep
+       manuals for various versions available). The CGI pages will link to
+       something like http://privoxy.org/$(VERSION)/user-manual/. This will
+       need to be updated for each new release. There is no Makefile target
+       for this at this time!!! It needs to be done manually.
+
+     * All developers should look at the ChangeLog and make sure noteworthy
+       changes are referenced.
+
+     * Commit all files that were changed in the above steps!
+
+     * Tag all files in CVS with the version number with "cvs tag v_X_Y_Z".
+       Don't use vX_Y_Z, ver_X_Y_Z, v_X.Y.Z (won't work) etc.
+
+     * If the release was in a development branch, increase the point version
+       from even to odd (X.Y.(Z+1)) again in configure.in and commit your
+       change.
+
+     * On the webserver, copy the user manual to a new top-level directory
+       called X.Y.Z. This ensures that help links from the CGI pages, which
+       have the version as a prefix, will go into the right version of the
+       manual. If this is a development branch release, also symlink
+       X.Y.(Z-1) to X.Y.Z and X.Y.(Z+1) to . (i.e. dot).
+
+   --------------------------------------------------------------------------
+
+  6.3. Building and Releasing the Packages
+
+   Now the individual packages can be built and released. Note that for GPL
+   reasons the first package to be released is always the source tarball.
+
+   For all types of packages, including the source tarball, you must make
+   sure that you build from clean sources by exporting the right version from
+   CVS into an empty directory (just press return when asked for a password):
 
   mkdir dist # delete or choose different name if it already exists
   cd dist
   cvs -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa login
   cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa export -r v_X_Y_Z current
 
+   Do NOT change a single bit, including, but not limited to version
+   information after export from CVS. This is to make sure that all release
+   packages, and with them, all future bug reports, are based on exactly the
+   same code.
 
-Do NOT change a single bit, including, but not limited to version information
-after export from CVS. This is to make sure that all release packages, and with
-them, all future bug reports, are based on exactly the same code.
-
-+-----------------------------------------------------------------------------+
-|                                   Warning                                   |
-|-----------------------------------------------------------------------------|
-|Every significant release of Privoxy has included at least one package that  |
-|either had incorrect versions of files, missing files, or incidental         |
-|leftovers from a previous build process that gave unknown numbers of users   |
-|headaches to try to figure out what was wrong. PLEASE, make sure you are     |
-|using pristene sources, and are following the prescribed process!            |
-+-----------------------------------------------------------------------------+
-
-Please find additional instructions for the source tarball and the individual
-platform dependent binary packages below. And details on the Sourceforge
-release process below that.
-
--------------------------------------------------------------------------------
-
-6.3.1. Note on Privoxy Packaging
-
-Please keep these general guidelines in mind when putting together your
-package. These apply to all platforms!
+   +------------------------------------------------------------------------+
+   |                                Warning                                 |
+   |------------------------------------------------------------------------|
+   | Every significant release of Privoxy has included at least one package |
+   | that either had incorrect versions of files, missing files, or         |
+   | incidental leftovers from a previous build process that gave unknown   |
+   | numbers of users headaches to try to figure out what was wrong.        |
+   | PLEASE, make sure you are using pristene sources, and are following    |
+   | the prescribed process!                                                |
+   +------------------------------------------------------------------------+
 
-  * Privoxy requires write access to: all *.action files, all logfiles, and the
-    trust file. You will need to determine the best way to do this for your
-    platform.
+   Please find additional instructions for the source tarball and the
+   individual platform dependent binary packages below. And details on the
+   Sourceforge release process below that.
 
-  * Please include up to date documentation. At a bare minimum:
+   --------------------------------------------------------------------------
 
-    LICENSE (top-level directory)
+    6.3.1. Note on Privoxy Packaging
 
-    README (top-level directory)
+   Please keep these general guidelines in mind when putting together your
+   package. These apply to all platforms!
 
-    AUTHORS (top-level directory)
+     * Privoxy requires write access to: all *.action files, all logfiles,
+       and the trust file. You will need to determine the best way to do this
+       for your platform.
 
-    man page (top-level directory, Unix-like platforms only)
+     * Please include up to date documentation. At a bare minimum:
 
-    The User Manual (doc/webserver/user-manual/)
+       LICENSE (top-level directory)
 
-    FAQ (doc/webserver/faq/)
+       README (top-level directory)
 
-    Also suggested: Developer Manual (doc/webserver/developer-manual) and
-    ChangeLog (top-level directory). FAQ and the manuals are HTML docs. There
-    are also text versions in doc/text/ which could conceivably also be
-    included.
+       AUTHORS (top-level directory)
 
-    The documentation has been designed such that the manuals are linked to
-    each other from parallel directories, and should be packaged that way.
-    privoxy-index.html can also be included and can serve as a focal point for
-    docs and other links of interest (and possibly renamed to index.html). This
-    should be one level up from the manuals. There is a link also on this page
-    to an HTMLized version of the man page. To avoid 404 for this, it is in CVS
-    as doc/webserver/man-page/privoxy-man-page.html, and should be included
-    along with the manuals. There is also a css stylesheets that can be
-    included for better presentation: p_doc.css. This should be in the same
-    directory with privoxy-index.html, (i.e. one level up from the manual
-    directories).
+       man page (top-level directory, Unix-like platforms only)
 
-  * user.action and user.filter are designed for local preferences. Make sure
-    these do not get overwritten! config should not be overwritten either. This
-    has especially important configuration data in it. trust should be left in
-    tact as well.
+       The User Manual (doc/webserver/user-manual/)
 
-  * Other configuration files (default.action, default.filter and
-    standard.action) should be installed as the new defaults, but all
-    previously installed configuration files should be preserved as backups.
-    This is just good manners :-) These files are likely to change between
-    releases and contain important new features and bug fixes.
+       FAQ (doc/webserver/faq/)
 
-  * Please check platform specific notes in this doc, if you haven't done
-    "Privoxy" packaging before for other platform specific issues. Conversely,
-    please add any notes that you know are important for your platform (or
-    contact one of the doc maintainers to do this if you can't).
+       Also suggested: Developer Manual (doc/webserver/developer-manual) and
+       ChangeLog (top-level directory). FAQ and the manuals are HTML docs.
+       There are also text versions in doc/text/ which could conceivably also
+       be included.
 
-  * Packagers should do a "clean" install of their package after building it.
-    So any previous installs should be removed first to ensure the integrity of
-    the newly built package. Then run the package for a while to make sure
-    there are no obvious problems, before uploading.
+       The documentation has been designed such that the manuals are linked
+       to each other from parallel directories, and should be packaged that
+       way. privoxy-index.html can also be included and can serve as a focal
+       point for docs and other links of interest (and possibly renamed to
+       index.html). This should be one level up from the manuals. There is a
+       link also on this page to an HTMLized version of the man page. To
+       avoid 404 for this, it is in CVS as
+       doc/webserver/man-page/privoxy-man-page.html, and should be included
+       along with the manuals. There is also a css stylesheets that can be
+       included for better presentation: p_doc.css. This should be in the
+       same directory with privoxy-index.html, (i.e. one level up from the
+       manual directories).
 
--------------------------------------------------------------------------------
+     * user.action and user.filter are designed for local preferences. Make
+       sure these do not get overwritten! config should not be overwritten
+       either. This has especially important configuration data in it. trust
+       should be left in tact as well.
 
-6.3.2. Source Tarball
+     * Other configuration files (default.action, default.filter and
+       standard.action) should be installed as the new defaults, but all
+       previously installed configuration files should be preserved as
+       backups. This is just good manners :-) These files are likely to
+       change between releases and contain important new features and bug
+       fixes.
 
-First, make sure that you have freshly exported the right version into an empty
-directory. (See "Building and releasing packages" above). Then run:
+     * Please check platform specific notes in this doc, if you haven't done
+       "Privoxy" packaging before for other platform specific issues.
+       Conversely, please add any notes that you know are important for your
+       platform (or contact one of the doc maintainers to do this if you
+       can't).
 
-  cd current
-  autoheader && autoconf && ./configure
+     * Packagers should do a "clean" install of their package after building
+       it. So any previous installs should be removed first to ensure the
+       integrity of the newly built package. Then run the package for a while
+       to make sure there are no obvious problems, before uploading.
 
+   --------------------------------------------------------------------------
 
-Then do:
+    6.3.2. Source Tarball
 
-  make tarball-dist
+   First, make sure that you have freshly exported the right version into an
+   empty directory. (See "Building and releasing packages" above). Then run:
 
+     cd current
+     autoheader && autoconf && ./configure
 
-To upload the package to Sourceforge, simply issue
+   Then do:
 
-  make tarball-upload
+     make tarball-dist
 
+   To upload the package to Sourceforge, simply issue
 
-Go to the displayed URL and release the file publicly on Sourceforge. For the
-change log field, use the relevant section of the ChangeLog file.
+     make tarball-upload
 
--------------------------------------------------------------------------------
+   Go to the displayed URL and release the file publicly on Sourceforge. For
+   the change log field, use the relevant section of the ChangeLog file.
 
-6.3.3. SuSE, Conectiva or Red Hat RPM
+   --------------------------------------------------------------------------
 
-In following text, replace dist with either "rh" for Red Hat or "suse" for
-SuSE.
+    6.3.3. SuSE, Conectiva or Red Hat RPM
 
-First, make sure that you have freshly exported the right version into an empty
-directory. (See "Building and releasing packages" above).
+   In following text, replace dist with either "rh" for Red Hat or "suse" for
+   SuSE.
 
-As the only exception to not changing anything after export from CVS, now
-examine the file privoxy-dist.spec and make sure that the version information
-and the RPM release number are correct. The RPM release numbers for each
-version start at one. Hence it must be reset to one if this is the first RPM
-for dist which is built from version X.Y.Z. Check the file list if unsure.
-Else, it must be set to the highest already available RPM release number for
-that version plus one.
+   First, make sure that you have freshly exported the right version into an
+   empty directory. (See "Building and releasing packages" above).
 
-Then run:
+   As the only exception to not changing anything after export from CVS, now
+   examine the file privoxy-dist.spec and make sure that the version
+   information and the RPM release number are correct. The RPM release
+   numbers for each version start at one. Hence it must be reset to one if
+   this is the first RPM for dist which is built from version X.Y.Z. Check
+   the file list if unsure. Else, it must be set to the highest already
+   available RPM release number for that version plus one.
 
-  cd current
-  autoheader && autoconf && ./configure
+   Then run:
 
+     cd current
+     autoheader && autoconf && ./configure
 
-Then do
+   Then do
 
-  make dist-dist
+     make dist-dist
 
+   To upload the package to Sourceforge, simply issue
 
-To upload the package to Sourceforge, simply issue
+     make dist-upload rpm_packagerev
 
-  make dist-upload rpm_packagerev
+   where rpm_packagerev is the RPM release number as determined above. Go to
+   the displayed URL and release the file publicly on Sourceforge. Use the
+   release notes and change log from the source tarball package.
 
+   --------------------------------------------------------------------------
 
-where rpm_packagerev is the RPM release number as determined above. Go to the
-displayed URL and release the file publicly on Sourceforge. Use the release
-notes and change log from the source tarball package.
+    6.3.4. OS/2
 
--------------------------------------------------------------------------------
-
-6.3.4. OS/2
-
-First, make sure that you have freshly exported the right version into an empty
-directory. (See "Building and releasing packages" above). Then get the OS/2
-Setup module:
+   First, make sure that you have freshly exported the right version into an
+   empty directory. (See "Building and releasing packages" above). Then get
+   the OS/2 Setup module:
 
   cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co os2setup
 
+   You will need a mix of development tools. The main compilation takes place
+   with IBM Visual Age C++. Some ancillary work takes place with GNU tools,
+   available from various sources like hobbes.nmsu.edu. Specificially, you
+   will need autoheader, autoconf and sh tools. The packaging takes place
+   with WarpIN, available from various sources, including its home page:
+   xworkplace.
 
-You will need a mix of development tools. The main compilation takes place with
-IBM Visual Age C++. Some ancillary work takes place with GNU tools, available
-from various sources like hobbes.nmsu.edu. Specificially, you will need
-autoheader, autoconf and sh tools. The packaging takes place with WarpIN,
-available from various sources, including its home page: xworkplace.
-
-Change directory to the os2setup directory. Edit the os2build.cmd file to set
-the final executable filename. For example,
-
-  installExeName='privoxyos2_setup_X.Y.Z.exe'
-
-
-Next, edit the IJB.wis file so the release number matches in the PACKAGEID
-section:
-
-  PACKAGEID="Privoxy Team\Privoxy\Privoxy Package\X\Y\Z"
-
-
-You're now ready to build. Run:
+   Change directory to the os2setup directory. Edit the os2build.cmd file to
+   set the final executable filename. For example,
 
-  os2build
+     installExeName='privoxyos2_setup_X.Y.Z.exe'
 
+   Next, edit the IJB.wis file so the release number matches in the PACKAGEID
+   section:
 
-You will find the WarpIN-installable executable in the ./files directory.
-Upload this anonymously to uploads.sourceforge.net/incoming, create a release
-for it, and you're done. Use the release notes and Change Log from the source
-tarball package.
+     PACKAGEID="Privoxy Team\Privoxy\Privoxy Package\X\Y\Z"
 
--------------------------------------------------------------------------------
+   You're now ready to build. Run:
 
-6.3.5. Solaris
+     os2build
 
-Login to Sourceforge's compilefarm via ssh:
+   You will find the WarpIN-installable executable in the ./files directory.
+   Upload this anonymously to uploads.sourceforge.net/incoming, create a
+   release for it, and you're done. Use the release notes and Change Log from
+   the source tarball package.
 
-  ssh cf.sourceforge.net
+   --------------------------------------------------------------------------
 
+    6.3.5. Solaris
 
-Choose the right operating system (not the Debian one). When logged in, make
-sure that you have freshly exported the right version into an empty directory.
-(See "Building and releasing packages" above). Then run:
+   Login to Sourceforge's compilefarm via ssh:
 
-  cd current
-  autoheader && autoconf && ./configure
+     ssh cf.sourceforge.net
 
+   Choose the right operating system (not the Debian one). When logged in,
+   make sure that you have freshly exported the right version into an empty
+   directory. (See "Building and releasing packages" above). Then run:
 
-Then run
+     cd current
+     autoheader && autoconf && ./configure
 
-  gmake solaris-dist
+   Then run
 
+     gmake solaris-dist
 
-which creates a gzip'ed tar archive. Sadly, you cannot use make solaris-upload
-on the Sourceforge machine (no ncftpput). You now have to manually upload the
-archive to Sourceforge's ftp server and release the file publicly. Use the
-release notes and Change Log from the source tarball package.
+   which creates a gzip'ed tar archive. Sadly, you cannot use make
+   solaris-upload on the Sourceforge machine (no ncftpput). You now have to
+   manually upload the archive to Sourceforge's ftp server and release the
+   file publicly. Use the release notes and Change Log from the source
+   tarball package.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-6.3.6. Windows
+    6.3.6. Windows
 
-You should ensure you have the latest version of Cygwin (from http://
-www.cygwin.com/). Run the following commands from within a Cygwin bash shell.
+   You should ensure you have the latest version of Cygwin (from
+   http://www.cygwin.com/). Run the following commands from within a Cygwin
+   bash shell.
 
-First, make sure that you have freshly exported the right version into an empty
-directory. (See "Building and releasing packages" above). Then get the Windows
-setup module:
+   First, make sure that you have freshly exported the right version into an
+   empty directory. (See "Building and releasing packages" above). Then get
+   the Windows setup module:
 
   cvs -z3  -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co winsetup
 
+   Then you can build the package. This is fully automated, and is controlled
+   by winsetup/GNUmakefile. All you need to do is:
 
-Then you can build the package. This is fully automated, and is controlled by
-winsetup/GNUmakefile. All you need to do is:
+     cd winsetup
+     make
 
-  cd winsetup
-  make
+   Now you can manually rename privoxy_setup.exe to privoxy_setup_X_Y_Z.exe,
+   and upload it to SourceForge. When releasing the package on SourceForge,
+   use the release notes and Change Log from the source tarball package.
 
+   --------------------------------------------------------------------------
 
-Now you can manually rename privoxy_setup.exe to privoxy_setup_X_Y_Z.exe, and
-upload it to SourceForge. When releasing the package on SourceForge, use the
-release notes and Change Log from the source tarball package.
+    6.3.7. Debian
 
--------------------------------------------------------------------------------
+   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:
 
-6.3.7. Debian
+     debchange -v 3.0.8-stable-1 "New upstream version"
 
-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:
+   Then, run:
 
-  debchange -v 3.0.8-stable-1 "New upstream version"
+     dpkg-buildpackage -rfakeroot -us -uc -b
 
+   This will create ../privoxy_3.0.8-stable-1_i386.deb which can be uploaded.
+   To upload the package to Sourceforge, simply issue
 
-Then, run:
+     make debian-upload
 
-  dpkg-buildpackage -rfakeroot -us -uc -b
+   --------------------------------------------------------------------------
 
+    6.3.8. Mac OSX
 
-This will create ../privoxy_3.0.8-stable-1_i386.deb which can be uploaded. To
-upload the package to Sourceforge, simply issue
-
-  make debian-upload
-
-
--------------------------------------------------------------------------------
-
-6.3.8. Mac OSX
-
-First, make sure that you have freshly exported the right version into an empty
-directory. (See "Building and releasing packages" above). Then get the Mac OSX
-setup module:
+   First, make sure that you have freshly exported the right version into an
+   empty directory. (See "Building and releasing packages" above). Then get
+   the Mac OSX setup module:
 
   cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co osxsetup
 
+   Then run:
 
-Then run:
-
-  cd osxsetup
-  build
-
-
-This will run autoheader, autoconf and configure as well as make. Finally, it
-will copy over the necessary files to the ./osxsetup/files directory for
-further processing by PackageMaker.
-
-Bring up PackageMaker with the PrivoxyPackage.pmsp definition file, modify the
-package name to match the release, and hit the "Create package" button. If you
-specify ./Privoxy.pkg as the output package name, you can then create the
-distributable zip file with the command:
-
-  zip -r privoxyosx_setup_x.y.z.zip Privoxy.pkg
+     cd osxsetup
+     build
 
+   This will run autoheader, autoconf and configure as well as make. Finally,
+   it will copy over the necessary files to the ./osxsetup/files directory
+   for further processing by PackageMaker.
 
-You can then upload privoxyosx_setup_x.y.z.zip anonymously to
-uploads.sourceforge.net/incoming, create a release for it, and you're done. Use
-the release notes and Change Log from the source tarball package.
+   Bring up PackageMaker with the PrivoxyPackage.pmsp definition file, modify
+   the package name to match the release, and hit the "Create package"
+   button. If you specify ./Privoxy.pkg as the output package name, you can
+   then create the distributable zip file with the command:
 
--------------------------------------------------------------------------------
+     zip -r privoxyosx_setup_x.y.z.zip Privoxy.pkg
 
-6.3.9. FreeBSD
+   You can then upload privoxyosx_setup_x.y.z.zip anonymously to
+   uploads.sourceforge.net/incoming, create a release for it, and you're
+   done. Use the release notes and Change Log from the source tarball
+   package.
 
-Login to Sourceforge's compile-farm via ssh:
+   --------------------------------------------------------------------------
 
-  ssh cf.sourceforge.net
+    6.3.9. FreeBSD
 
+   Login to Sourceforge's compile-farm via ssh:
 
-Choose the right operating system. When logged in, make sure that you have
-freshly exported the right version into an empty directory. (See "Building and
-releasing packages" above). Then run:
+     ssh cf.sourceforge.net
 
-  cd current
-  autoheader && autoconf && ./configure
+   Choose the right operating system. When logged in, make sure that you have
+   freshly exported the right version into an empty directory. (See "Building
+   and releasing packages" above). Then run:
 
+     cd current
+     autoheader && autoconf && ./configure
 
-Then run:
+   Then run:
 
-  gmake freebsd-dist
+     gmake freebsd-dist
 
+   which creates a gzip'ed tar archive. Sadly, you cannot use make
+   freebsd-upload on the Sourceforge machine (no ncftpput). You now have to
+   manually upload the archive to Sourceforge's ftp server and release the
+   file publicly. Use the release notes and Change Log from the source
+   tarball package.
 
-which creates a gzip'ed tar archive. Sadly, you cannot use make freebsd-upload
-on the Sourceforge machine (no ncftpput). You now have to manually upload the
-archive to Sourceforge's ftp server and release the file publicly. Use the
-release notes and Change Log from the source tarball package.
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    6.3.10. HP-UX 11
 
-6.3.10. HP-UX 11
+   First, make sure that you have freshly exported the right version into an
+   empty directory. (See "Building and releasing packages" above). Then run:
 
-First, make sure that you have freshly exported the right version into an empty
-directory. (See "Building and releasing packages" above). Then run:
+     cd current
+     autoheader && autoconf && ./configure
 
-  cd current
-  autoheader && autoconf && ./configure
+   Then do FIXME.
 
+   --------------------------------------------------------------------------
 
-Then do FIXME.
+    6.3.11. Amiga OS
 
--------------------------------------------------------------------------------
+   First, make sure that you have freshly exported the right version into an
+   empty directory. (See "Building and releasing packages" above). Then run:
 
-6.3.11. Amiga OS
+     cd current
+     autoheader && autoconf && ./configure
 
-First, make sure that you have freshly exported the right version into an empty
-directory. (See "Building and releasing packages" above). Then run:
+   Then do FIXME.
 
-  cd current
-  autoheader && autoconf && ./configure
+   --------------------------------------------------------------------------
 
+    6.3.12. AIX
 
-Then do FIXME.
+   Login to Sourceforge's compilefarm via ssh:
 
--------------------------------------------------------------------------------
+     ssh cf.sourceforge.net
 
-6.3.12. AIX
+   Choose the right operating system. When logged in, make sure that you have
+   freshly exported the right version into an empty directory. (See "Building
+   and releasing packages" above). Then run:
 
-Login to Sourceforge's compilefarm via ssh:
+     cd current
+     autoheader && autoconf && ./configure
 
-  ssh cf.sourceforge.net
+   Then run:
 
+     make aix-dist
 
-Choose the right operating system. When logged in, make sure that you have
-freshly exported the right version into an empty directory. (See "Building and
-releasing packages" above). Then run:
+   which creates a gzip'ed tar archive. Sadly, you cannot use make aix-upload
+   on the Sourceforge machine (no ncftpput). You now have to manually upload
+   the archive to Sourceforge's ftp server and release the file publicly. Use
+   the release notes and Change Log from the source tarball package.
 
-  cd current
-  autoheader && autoconf && ./configure
+   --------------------------------------------------------------------------
 
+  6.4. Uploading and Releasing Your Package
 
-Then run:
+   After the package is ready, it is time to upload it to SourceForge, and go
+   through the release steps. The upload is done via FTP:
 
-  make aix-dist
+     * Upload to: ftp://upload.sourceforge.net/incoming
 
+     * user: anonymous
 
-which creates a gzip'ed tar archive. Sadly, you cannot use make aix-upload on
-the Sourceforge machine (no ncftpput). You now have to manually upload the
-archive to Sourceforge's ftp server and release the file publicly. Use the
-release notes and Change Log from the source tarball package.
+     * password: ijbswa-developers@lists.sourceforge.net
 
--------------------------------------------------------------------------------
+   Or use the make targets as described above.
 
-6.4. Uploading and Releasing Your Package
+   Once this done go to
+   http://sourceforge.net/project/admin/editpackages.php?group_id=11118,
+   making sure you are logged in. Find your target platform in the second
+   column, and click Add Release. You will then need to create a new release
+   for your package, using the format of $VERSION ($CODE_STATUS), e.g. 3.0.8
+   (beta).
 
-After the package is ready, it is time to upload it to SourceForge, and go
-through the release steps. The upload is done via FTP:
+   Now just follow the prompts. Be sure to add any appropriate Release notes.
+   You should see your freshly uploaded packages in "Step 2. Add Files To
+   This Release". Check the appropriate box(es). Remember at each step to hit
+   the "Refresh/Submit" buttons! You should now see your file(s) listed in
+   Step 3. Fill out the forms with the appropriate information for your
+   platform, being sure to hit "Update" for each file. If anyone is
+   monitoring your platform, check the "email" box at the very bottom to
+   notify them of the new package. This should do it!
 
-  * Upload to: ftp://upload.sourceforge.net/incoming
+   If you have made errors, or need to make changes, you can go through
+   essentially the same steps, but select Edit Release, instead of Add
+   Release.
 
-  * user: anonymous
+   --------------------------------------------------------------------------
 
-  * password: ijbswa-developers@lists.sourceforge.net
+  6.5. After the Release
 
-Or use the make targets as described above.
+   When all (or: most of the) packages have been uploaded and made available,
+   send an email to the announce mailing list, Subject: "Version X.Y.Z
+   available for download". Be sure to include the download location, the
+   release notes and the Changelog. Also, post an updated News item on the
+   project page Sourceforge, and update the Home page and docs linked from
+   the Home page (see below). Other news sites and release oriented sites,
+   such as Freshmeat, should also be notified.
 
-Once this done go to http://sourceforge.net/project/admin/editpackages.php?
-group_id=11118, making sure you are logged in. Find your target platform in the
-second column, and click Add Release. You will then need to create a new
-release for your package, using the format of $VERSION ($CODE_STATUS), e.g.
-3.0.8 (beta).
-
-Now just follow the prompts. Be sure to add any appropriate Release notes. You
-should see your freshly uploaded packages in "Step 2. Add Files To This
-Release". Check the appropriate box(es). Remember at each step to hit the
-"Refresh/Submit" buttons! You should now see your file(s) listed in Step 3.
-Fill out the forms with the appropriate information for your platform, being
-sure to hit "Update" for each file. If anyone is monitoring your platform,
-check the "email" box at the very bottom to notify them of the new package.
-This should do it!
-
-If you have made errors, or need to make changes, you can go through
-essentially the same steps, but select Edit Release, instead of Add Release.
-
--------------------------------------------------------------------------------
-
-6.5. After the Release
-
-When all (or: most of the) packages have been uploaded and made available, send
-an email to the announce mailing list, Subject: "Version X.Y.Z available for
-download". Be sure to include the download location, the release notes and the
-Changelog. Also, post an updated News item on the project page Sourceforge, and
-update the Home page and docs linked from the Home page (see below). Other news
-sites and release oriented sites, such as Freshmeat, should also be notified.
-
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
 7. Update the Webserver
 
-The webserver should be updated at least with each stable release. When
-updating, please follow these steps to make sure that no broken links,
-inconsistent contents or permission problems will occur (as it has many times
-in the past!):
+   The webserver should be updated at least with each stable release. When
+   updating, please follow these steps to make sure that no broken links,
+   inconsistent contents or permission problems will occur (as it has many
+   times in the past!):
 
-If you have changed anything in the stable-branch documentation source SGML
-files, do:
+   If you have changed anything in the stable-branch documentation source
+   SGML files, do:
 
   make dok dok-pdf # (or 'make redhat-dok dok-pdf' if 'make dok' doesn't work for you)
 
+   That will generate doc/webserver/user-manual,
+   doc/webserver/developer-manual, doc/webserver/faq, doc/pdf/*.pdf and
+   doc/webserver/index.html automatically.
 
-That will generate doc/webserver/user-manual, doc/webserver/developer-manual,
-doc/webserver/faq, doc/pdf/*.pdf and doc/webserver/index.html automatically.
-
-If you changed the manual page sources, generate doc/webserver/man-page/
-privoxy-man-page.html by running "make man". (This is a separate target due to
-dependencies on some obscure perl scripts [now in CVS, but not well tested].
-See comments in GNUmakefile.)
+   If you changed the manual page sources, generate
+   doc/webserver/man-page/privoxy-man-page.html by running "make man". (This
+   is a separate target due to dependencies on some obscure perl scripts [now
+   in CVS, but not well tested]. See comments in GNUmakefile.)
 
-If you want to add new files to the webserver, create them locally in the doc/
-webserver/* directory (or create new directories under doc/webserver).
+   If you want to add new files to the webserver, create them locally in the
+   doc/webserver/* directory (or create new directories under doc/webserver).
 
-Next, commit any changes from the above steps to CVS. All set? If these are
-docs in the stable branch, then do:
+   Next, commit any changes from the above steps to CVS. All set? If these
+   are docs in the stable branch, then do:
 
-  make webserver
+     make webserver
 
+   This will do the upload to the webserver (www.privoxy.org) and ensure all
+   files and directories there are group writable.
 
-This will do the upload to the webserver (www.privoxy.org) and ensure all files
-and directories there are group writable.
+   Please do NOT use any other means of transferring files to the webserver
+   to avoid permission problems. Also, please do not upload docs from
+   development branches or versions. The publicly posted docs should be in
+   sync with the last official release.
 
-Please do NOT use any other means of transferring files to the webserver to
-avoid permission problems. Also, please do not upload docs from development
-branches or versions. The publicly posted docs should be in sync with the last
-official release.
-
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
 8. Contacting the developers, Bug Reporting and Feature Requests
 
-We value your feedback. In fact, we rely on it to improve Privoxy and its
-configuration. However, please note the following hints, so we can provide you
-with the best support:
+   We value your feedback. In fact, we rely on it to improve Privoxy and its
+   configuration. However, please note the following hints, so we can provide
+   you with the best support:
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-8.1. Get Support
+  8.1. Get Support
 
-For casual users, our support forum at SourceForge is probably best suited:
-http://sourceforge.net/tracker/?group_id=11118&atid=211118
+   For casual users, our support forum at SourceForge is probably best
+   suited: http://sourceforge.net/tracker/?group_id=11118&atid=211118
 
-All users are of course welcome to discuss their issues on the users mailing
-list, where the developers also hang around.
+   All users are of course welcome to discuss their issues on the users
+   mailing list, where the developers also hang around.
 
-Note that the Privoxy mailing lists are moderated. Posts from unsubscribed
-addresses have to be accepted manually by a moderator. This may cause a delay
-of several days and if you use a subject that doesn't clearly mention Privoxy
-or one of its features, your message may be accidentally discarded as spam.
+   Note that the Privoxy mailing lists are moderated. Posts from unsubscribed
+   addresses have to be accepted manually by a moderator. This may cause a
+   delay of several days and if you use a subject that doesn't clearly
+   mention Privoxy or one of its features, your message may be accidentally
+   discarded as spam.
 
-If you aren't subscribed, you should therefore spend a few seconds to come up
-with a proper subject. Additionally you should make it clear that you want to
-get CC'd. Otherwise some responses will be directed to the mailing list only,
-and you won't see them.
+   If you aren't subscribed, you should therefore spend a few seconds to come
+   up with a proper subject. Additionally you should make it clear that you
+   want to get CC'd. Otherwise some responses will be directed to the mailing
+   list only, and you won't see them.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-8.2. Reporting Problems
+  8.2. Reporting Problems
 
-"Problems" for our purposes, come in two forms:
+   "Problems" for our purposes, come in two forms:
 
-  * Configuration issues, such as ads that slip through, or sites that don't
-    function properly due to one Privoxy "action" or another being turned "on".
+     * Configuration issues, such as ads that slip through, or sites that
+       don't function properly due to one Privoxy "action" or another being
+       turned "on".
 
-  * "Bugs" in the programming code that makes up Privoxy, such as that might
-    cause a crash.
+     * "Bugs" in the programming code that makes up Privoxy, such as that
+       might cause a crash.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-8.2.1. Reporting Ads or Other Configuration Problems
+    8.2.1. Reporting Ads or Other Configuration Problems
 
-Please send feedback on ads that slipped through, innocent images that were
-blocked, sites that don't work properly, and other configuration related
-problem of default.action file, to http://sourceforge.net/tracker/?group_id=
-11118&atid=460288, the Actions File Tracker.
+   Please send feedback on ads that slipped through, innocent images that
+   were blocked, sites that don't work properly, and other configuration
+   related problem of default.action file, to
+   http://sourceforge.net/tracker/?group_id=11118&atid=460288, the Actions
+   File Tracker.
 
-New, improved default.action files may occasionally be made available based on
-your feedback. These will be announced on the ijbswa-announce list and
-available from our the files section of our project page.
+   New, improved default.action files may occasionally be made available
+   based on your feedback. These will be announced on the ijbswa-announce
+   list and available from our the files section of our project page.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-8.2.2. Reporting Bugs
+    8.2.2. Reporting Bugs
 
-Please report all bugs through our bug tracker: http://sourceforge.net/tracker
-/?group_id=11118&atid=111118.
+   Please report all bugs through our bug tracker:
+   http://sourceforge.net/tracker/?group_id=11118&atid=111118.
 
-Before doing so, please make sure that the bug has not already been submitted
-and observe the additional hints at the top of the submit form. If already
-submitted, please feel free to add any info to the original report that might
-help to solve the issue.
+   Before doing so, please make sure that the bug has not already been
+   submitted and observe the additional hints at the top of the submit form.
+   If already submitted, please feel free to add any info to the original
+   report that might help to solve the issue.
 
-Please try to verify that it is a Privoxy bug, and not a browser or site bug or
-documented behaviour that just happens to be different than what you expected.
-If unsure, try toggling off Privoxy, and see if the problem persists.
+   Please try to verify that it is a Privoxy bug, and not a browser or site
+   bug or documented behaviour that just happens to be different than what
+   you expected. If unsure, try toggling off Privoxy, and see if the problem
+   persists.
 
-If you are using your own custom configuration, please try the stock configs to
-see if the problem is configuration related. If you're having problems with a
-feature that is disabled by default, please ask around on the mailing list if
-others can reproduce the problem.
+   If you are using your own custom configuration, please try the stock
+   configs to see if the problem is configuration related. If you're having
+   problems with a feature that is disabled by default, please ask around on
+   the mailing list if others can reproduce the problem.
 
-If you aren't using the latest Privoxy version, the bug may have been found and
-fixed in the meantime. We would appreciate if you could take the time to
-upgrade to the latest version (or even the latest CVS snapshot) and verify that
-your bug still exists.
+   If you aren't using the latest Privoxy version, the bug may have been
+   found and fixed in the meantime. We would appreciate if you could take the
+   time to upgrade to the latest version (or even the latest CVS snapshot)
+   and verify that your bug still exists.
 
-Please be sure to provide the following information:
+   Please be sure to provide the following information:
 
-  * The exact Privoxy version you are using (if you got the source from CVS,
-    please also provide the source code revisions as shown in http://
-    config.privoxy.org/show-version).
+     * The exact Privoxy version you are using (if you got the source from
+       CVS, please also provide the source code revisions as shown in
+       http://config.privoxy.org/show-version).
 
-  * The operating system and versions you run Privoxy on, (e.g. Windows XP
-    SP2), if you are using a Unix flavor, sending the output of "uname -a"
-    should do, in case of GNU/Linux, please also name the distribution.
+     * The operating system and versions you run Privoxy on, (e.g. Windows XP
+       SP2), if you are using a Unix flavor, sending the output of "uname -a"
+       should do, in case of GNU/Linux, please also name the distribution.
 
-  * The name, platform, and version of the browser you were using (e.g.
-    Internet Explorer v5.5 for Mac).
+     * The name, platform, and version of the browser you were using (e.g.
+       Internet Explorer v5.5 for Mac).
 
-  * The URL where the problem occurred, or some way for us to duplicate the
-    problem (e.g. http://somesite.example.com/?somethingelse=123).
+     * The URL where the problem occurred, or some way for us to duplicate
+       the problem (e.g. http://somesite.example.com/?somethingelse=123).
 
-  * Whether your version of Privoxy is one supplied by the Privoxy developers
-    via SourceForge, or if you got your copy somewhere else.
+     * Whether your version of Privoxy is one supplied by the Privoxy
+       developers via SourceForge, or if you got your copy somewhere else.
 
-  * Whether you are using Privoxy in tandem with another proxy such as Tor. If
-    so, please temporary disable the other proxy to see if the symptoms change.
+     * Whether you are using Privoxy in tandem with another proxy such as
+       Tor. If so, please temporary disable the other proxy to see if the
+       symptoms change.
 
-  * Whether you are using a personal firewall product. If so, does Privoxy work
-    without it?
+     * Whether you are using a personal firewall product. If so, does Privoxy
+       work without it?
 
-  * Any other pertinent information to help identify the problem such as config
-    or log file excerpts (yes, you should have log file entries for each action
-    taken).
+     * Any other pertinent information to help identify the problem such as
+       config or log file excerpts (yes, you should have log file entries for
+       each action taken).
 
-You don't have to tell us your actual name when filing a problem report, but
-please use a nickname so we can differentiate between your messages and the
-ones entered by other "anonymous" users that may respond to your request if
-they have the same problem or already found a solution.
+   You don't have to tell us your actual name when filing a problem report,
+   but please use a nickname so we can differentiate between your messages
+   and the ones entered by other "anonymous" users that may respond to your
+   request if they have the same problem or already found a solution.
 
-Please also check the status of your request a few days after submitting it, as
-we may request additional information. If you use a SF id, you should
-automatically get a mail when someone responds to your request.
+   Please also check the status of your request a few days after submitting
+   it, as we may request additional information. If you use a SF id, you
+   should automatically get a mail when someone responds to your request.
 
-The appendix of the Privoxy User Manual also has helpful information on
-understanding actions, and action debugging.
+   The appendix of the Privoxy User Manual also has helpful information on
+   understanding actions, and action debugging.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-8.3. Request New Features
+  8.3. Request New Features
 
-You are welcome to submit ideas on new features or other proposals for
-improvement through our feature request tracker at http://sourceforge.net/
-tracker/?atid=361118&group_id=11118.
+   You are welcome to submit ideas on new features or other proposals for
+   improvement through our feature request tracker at
+   http://sourceforge.net/tracker/?atid=361118&group_id=11118.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-8.4. Other
+  8.4. Other
 
-For any other issues, feel free to use the mailing lists. Technically
-interested users and people who wish to contribute to the project are also
-welcome on the developers list! You can find an overview of all Privoxy-related
-mailing lists, including list archives, at: http://sourceforge.net/mail/?
-group_id=11118.
+   For any other issues, feel free to use the mailing lists. Technically
+   interested users and people who wish to contribute to the project are also
+   welcome on the developers list! You can find an overview of all
+   Privoxy-related mailing lists, including list archives, at:
+   http://sourceforge.net/mail/?group_id=11118.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
 9. Privoxy Copyright, License and History
 
-Copyright   2001-2008 by Privoxy Developers <
-ijbswa-developers@lists.sourceforge.net>
+   Copyright © 2001-2008 by Privoxy Developers
+   <ijbswa-developers@lists.sourceforge.net>
 
-Some source code is based on code Copyright   1997 by Anonymous Coders and
-Junkbusters, Inc. and licensed under the GNU General Public License.
+   Some source code is based on code Copyright © 1997 by Anonymous Coders
+   and Junkbusters, Inc. and licensed under the GNU General Public License.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-9.1. License
+  9.1. License
 
-Privoxy is free software; you can redistribute it and/or modify it under the
-terms of the GNU General Public License, version 2, as published by the Free
-Software Foundation.
+   Privoxy is free software; you can redistribute it and/or modify it under
+   the terms of the GNU General Public License, version 2, as published by
+   the Free Software Foundation.
 
-This program is distributed in the hope that it will be useful, but WITHOUT ANY
-WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
-PARTICULAR PURPOSE. See the GNU General Public License for more details, which
-is available from the Free Software Foundation, Inc, 51 Franklin Street, Fifth
-Floor, Boston, MA 02110-1301, USA
+   This program is distributed in the hope that it will be useful, but
+   WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+   or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+   for more details, which is available from the Free Software Foundation,
+   Inc, 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
 
-You should have received a copy of the GNU General Public License along with
-this program; if not, write to the
+   You should have received a copy of the GNU General Public License along
+   with this program; if not, write to the
 
- Free Software
- Foundation, Inc. 51 Franklin Street, Fifth Floor
- Boston, MA 02110-1301
- USA 
   Free Software
   Foundation, Inc. 51 Franklin Street, Fifth Floor
   Boston, MA 02110-1301
+    USA
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-9.2. History
+  9.2. History
 
-A long time ago, there was the Internet Junkbuster, by Anonymous Coders and
-Junkbusters Corporation. This saved many users a lot of pain in the early days
-of web advertising and user tracking.
+   A long time ago, there was the Internet Junkbuster, by Anonymous Coders
+   and Junkbusters Corporation. This saved many users a lot of pain in the
+   early days of web advertising and user tracking.
 
-But the web, its protocols and standards, and with it, the techniques for
-forcing ads on users, give up autonomy over their browsing, and for tracking
-them, keeps evolving. Unfortunately, the Internet Junkbuster did not. Version
-2.0.2, published in 1998, was (and is) the last official release available from
-Junkbusters Corporation. Fortunately, it had been released under the GNU GPL,
-which allowed further development by others.
+   But the web, its protocols and standards, and with it, the techniques for
+   forcing ads on users, give up autonomy over their browsing, and for
+   tracking them, keeps evolving. Unfortunately, the Internet Junkbuster did
+   not. Version 2.0.2, published in 1998, was (and is) the last official
+   release available from Junkbusters Corporation. Fortunately, it had been
+   released under the GNU GPL, which allowed further development by others.
 
-So Stefan Waldherr started maintaining an improved version of the software, to
-which eventually a number of people contributed patches. It could already
-replace banners with a transparent image, and had a first version of pop-up
-killing, but it was still very closely based on the original, with all its
-limitations, such as the lack of HTTP/1.1 support, flexible per-site
-configuration, or content modification. The last release from this effort was
-version 2.0.2-10, published in 2000.
+   So Stefan Waldherr started maintaining an improved version of the
+   software, to which eventually a number of people contributed patches. It
+   could already replace banners with a transparent image, and had a first
+   version of pop-up killing, but it was still very closely based on the
+   original, with all its limitations, such as the lack of HTTP/1.1 support,
+   flexible per-site configuration, or content modification. The last release
+   from this effort was version 2.0.2-10, published in 2000.
 
-Then, some developers picked up the thread, and started turning the software
-inside out, upside down, and then reassembled it, adding many new features
-along the way.
+   Then, some developers picked up the thread, and started turning the
+   software inside out, upside down, and then reassembled it, adding many new
+   features along the way.
 
-The result of this is Privoxy, whose first stable version, 3.0, was released
-August, 2002.
+   The result of this is Privoxy, whose first stable version, 3.0, was
+   released August, 2002.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
 10. See also
 
-Other references and sites of interest to Privoxy users:
-
-http://www.privoxy.org/, the Privoxy Home page.
+   Other references and sites of interest to Privoxy users:
 
-http://www.privoxy.org/faq/, the Privoxy FAQ.
+   http://www.privoxy.org/, the Privoxy Home page.
 
-http://sourceforge.net/projects/ijbswa/, the Project Page for Privoxy on
-SourceForge.
+   http://www.privoxy.org/faq/, the Privoxy FAQ.
 
-http://config.privoxy.org/, the web-based user interface. Privoxy must be
-running for this to work. Shortcut: http://p.p/
+   http://sourceforge.net/projects/ijbswa/, the Project Page for Privoxy on
+   SourceForge.
 
-http://sourceforge.net/tracker/?group_id=11118&atid=460288, to submit "misses"
-and other configuration related suggestions to the developers.
+   http://config.privoxy.org/, the web-based user interface. Privoxy must be
+   running for this to work. Shortcut: http://p.p/
 
-http://www.junkbusters.com/ht/en/cookies.html, an explanation how cookies are
-used to track web users.
+   http://sourceforge.net/tracker/?group_id=11118&atid=460288, to submit
+   "misses" and other configuration related suggestions to the developers.
 
-http://www.junkbusters.com/ijb.html, the original Internet Junkbuster.
+   http://www.junkbusters.com/ht/en/cookies.html, an explanation how cookies
+   are used to track web users.
 
-http://privacy.net/, a useful site to check what information about you is
-leaked while you browse the web.
+   http://www.junkbusters.com/ijb.html, the original Internet Junkbuster.
 
-http://www.squid-cache.org/, a popular caching proxy, which is often used
-together with Privoxy.
+   http://privacy.net/, a useful site to check what information about you is
+   leaked while you browse the web.
 
-http://www.pps.jussieu.fr/~jch/software/polipo/, Polipo is a caching proxy with
-advanced features like pipelining, multiplexing and caching of partial
-instances. In many setups it can be used as Squid replacement.
+   http://www.squid-cache.org/, a popular caching proxy, which is often used
+   together with Privoxy.
 
-http://tor.eff.org/, Tor can help anonymize web browsing, web publishing,
-instant messaging, IRC, SSH, and other applications.
+   http://www.pps.jussieu.fr/~jch/software/polipo/, Polipo is a caching proxy
+   with advanced features like pipelining, multiplexing and caching of
+   partial instances. In many setups it can be used as Squid replacement.
 
-http://www.privoxy.org/developer-manual/, the Privoxy developer manual.
+   http://tor.eff.org/, Tor can help anonymize web browsing, web publishing,
+   instant messaging, IRC, SSH, and other applications.
 
+   http://www.privoxy.org/developer-manual/, the Privoxy developer manual.
index e263cc2..b5ae732 100644 (file)
-Privoxy Frequently Asked Questions
+                       Privoxy Frequently Asked Questions
 
-[ Copyright   2001-2008 by Privoxy Developers ]
+   [Copyright[ © 2001-2008 by Privoxy Developers]]
 
-$Id: faq.sgml,v 2.37 2008/01/19 15:03:05 hal9 Exp $
+   $Id: faq.sgml,v 2.38 2008/01/19 17:52:39 hal9 Exp $
 
-This FAQ gives quick answers to frequently asked questions about Privoxy. It is
-not a substitute for the Privoxy User Manual.
+   This FAQ gives quick answers to frequently asked questions about Privoxy.
+   It is not a substitute for the Privoxy User Manual.
 
-What is Privoxy?
+   What is Privoxy?
 
-Privoxy is a non-caching web proxy with advanced filtering capabilities for
-enhancing privacy, modifying web page data, managing HTTP cookies, controlling
-access, and removing ads, banners, pop-ups and other obnoxious Internet junk.
-Privoxy has a flexible configuration and can be customized to suit individual
-needs and tastes. Privoxy has application for both stand-alone systems and
-multi-user networks.
+   Privoxy is a non-caching web proxy with advanced filtering capabilities
+   for enhancing privacy, modifying web page data, managing HTTP cookies,
+   controlling access, and removing ads, banners, pop-ups and other obnoxious
+   Internet junk. Privoxy has a flexible configuration and can be customized
+   to suit individual needs and tastes. Privoxy has application for both
+   stand-alone systems and multi-user networks.
 
-Privoxy is based on Internet Junkbuster (tm).
+   Privoxy is based on Internet Junkbuster (tm).
 
-Please note that this document is a work in progress. This copy represents the
-state at the release of version 3.0.8. You can find the latest version of the
-document at http://www.privoxy.org/faq/. Please see the Contact section if you
-want to contact the developers.
+   Please note that this document is a work in progress. This copy represents
+   the state at the release of version 3.0.8. You can find the latest version
+   of the document at http://www.privoxy.org/faq/. Please see the Contact
+   section if you want to contact the developers.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-Table of Contents
-1. General Information
+   Table of Contents
 
-    1.1. Who should give Privoxy a try?
-    1.2. Is Privoxy the best choice for me?
-    1.3. What is a "proxy"? How does Privoxy work?
-    1.4. Does Privoxy do anything more than ad blocking?
-    1.5. What is this new version of "Junkbuster"?
-    1.6. Why "Privoxy"? Why change the name from Junkbuster at all?
-    1.7. How does Privoxy differ from the old Junkbuster?
-    1.8. How does Privoxy know what is an ad, and what is not?
-    1.9. Can Privoxy make mistakes? This does not sound very scientific.
-    1.10. Will I have to configure Privoxy before I can use it?
-    1.11. Can Privoxy run as a server on a network?
-    1.12. My browser does the same things as Privoxy. Why should I use Privoxy
-        at all?
-    1.13. Why should I trust Privoxy?
-    1.14. Is there is a license or fee? What about a warranty? Registration?
-    1.15. Can Privoxy remove spyware? Adware? Viruses?
-    1.16. Can I use Privoxy with other ad-blocking software?
-    1.17. I would like to help you, what can I do?
+   1. General Information
 
-        1.17.1. Would you like to participate?
-        1.17.2. Contribute!
-        1.17.3. Software
+                1.1. Who should give Privoxy a try?
 
-2. Installation
+                1.2. Is Privoxy the best choice for me?
 
-    2.1. Which browsers are supported by Privoxy?
-    2.2. Which operating systems are supported?
-    2.3. Can I use Privoxy with my email client?
-    2.4. I just installed Privoxy. Is there anything special I have to do now?
-    2.5. What is the proxy address of Privoxy?
-    2.6. I just installed Privoxy, and nothing is happening. All the ads are
-        there. What's wrong?
-    2.7. I get a "Privoxy is not being used" dummy page although Privoxy is
-        running and being used.
+                1.3. What is a "proxy"? How does Privoxy work?
 
-3. Configuration
+                1.4. Does Privoxy do anything more than ad blocking?
 
-    3.1. What exactly is an "actions" file?
-    3.2. The "actions" concept confuses me. Please list some of these
-        "actions".
-    3.3. How are actions files configured? What is the easiest way to do this?
-    3.4. There are several different "actions" files. What are the differences?
-    3.5. Where can I get updated Actions Files?
-    3.6. Can I use my old config files?
-    3.7. Why is the configuration so complicated?
-    3.8. How can I make my Yahoo/Hotmail/Gmail account work?
-    3.9. What's the difference between the "Cautious", "Medium" and "Advanced"
-        defaults?
-    3.10. Why can I change the configuration with a browser? Does that not
-        raise security issues?
-    3.11. What is the default.filter file? What is a "filter"?
-    3.12. How can I set up Privoxy to act as a proxy for my LAN?
-    3.13. Instead of ads, now I get a checkerboard pattern. I don't want to see
-        anything.
-    3.14. Why would anybody want to see a checkerboard pattern?
-    3.15. I see some images being replaced with text instead of the
-        checkerboard image. Why and how do I get rid of this?
-    3.16. Can Privoxy run as a service on Win2K/NT/XP?
-    3.17. How can I make Privoxy work with other proxies like Squid or Tor?
-    3.18. Can I just set Privoxy to use port 80 and thus avoid individual
-        browser configuration?
-    3.19. Can Privoxy run as a "transparent" proxy?
-    3.20. Can Privoxy run as a "intercepting" proxy?
-    3.21. How can I configure Privoxy for use with Outlook Express?
-    3.22. How can I have separate rules just for HTML mail?
-    3.23. I sometimes notice cookies sneaking through. How?
-    3.24. Are all cookies bad? Why?
-    3.25. How can I allow permanent cookies for my trusted sites?
-    3.26. Can I have separate configurations for different users?
-    3.27. Can I set-up Privoxy as a whitelist of "good" sites?
-    3.28. How can I turn off ad-blocking?
-    3.29. How can I have custom template pages, like the BLOCKED page?
-    3.30. How can I remove the "Go There Anyway" link from the BLOCKED page?
+                1.5. What is this new version of "Junkbuster"?
 
-4. Miscellaneous
+                1.6. Why "Privoxy"? Why change the name from Junkbuster at
+                all?
 
-    4.1. How much does Privoxy slow my browsing down? This has to add extra
-        time to browsing.
-    4.2. I notice considerable delays in page requests. What's wrong?
-    4.3. What are "http://config.privoxy.org/" and "http://p.p/"?
-    4.4. How can I submit new ads, or report problems?
-    4.5. If I do submit missed ads, will they be included in future updates?
-    4.6. Why doesn't anyone answer my support request?
-    4.7. How can I hide my IP address?
-    4.8. Can Privoxy guarantee I am anonymous?
-    4.9. A test site says I am not using a Proxy.
-    4.10. How do I use Privoxy together with Tor?
-    4.11. Might some things break because header information or content is
-        being altered?
-    4.12. Can Privoxy act as a "caching" proxy to speed up web browsing?
-    4.13. What about as a firewall? Can Privoxy protect me?
-    4.14. I have large empty spaces / a checkerboard pattern now where ads used
-        to be. Why?
-    4.15. How can Privoxy filter Secure (HTTPS) URLs?
-    4.16. Privoxy runs as a "server". How secure is it? Do I need to take any
-        special precautions?
-    4.17. Can I temporarily disable Privoxy?
-    4.18. When "disabled" is Privoxy totally out of the picture?
-    4.19. How can I tell Privoxy to totally ignore certain sites?
-    4.20. My logs show Privoxy "crunches" ads, but also its own internal CGI
-        pages. What is a "crunch"?
-    4.21. Can Privoxy effect files that I download from a webserver? FTP
-        server?
-    4.22. I just downloaded a Perl script, and Privoxy altered it! Yikes, what
-        is wrong!
-    4.23. Should I continue to use a "HOSTS" file for ad-blocking?
-    4.24. Where can I find more information about Privoxy and related issues?
-    4.25. I've noticed that Privoxy changes "Microsoft" to "MicroSuck"! Why are
-        you manipulating my browsing?
-    4.26. Does Privoxy produce "valid" HTML (or XHTML)?
+                1.7. How does Privoxy differ from the old Junkbuster?
 
-5. Troubleshooting
+                1.8. How does Privoxy know what is an ad, and what is not?
 
-    5.1. I cannot connect to any websites. Or, I am getting "connection
-        refused" message with every web page. Why?
-    5.2. Why am I getting a 503 Error (WSAECONNREFUSED) on every page?
-    5.3. I just added a new rule, but the steenkin ad is still getting through.
-        How?
-    5.4. One of my favorite sites does not work with Privoxy. What can I do?
-    5.5. After installing Privoxy, I have to log in every time I start IE. What
-        gives?
-    5.6. I cannot connect to any FTP sites. Privoxy is blocking me.
-    5.7. In Mac OSX, I can't configure Microsoft Internet Explorer to use
-        Privoxy as the HTTP proxy.
-    5.8. In Mac OSX, I dragged the Privoxy folder to the trash in order to
-        uninstall it. Now the finder tells me I don't have sufficient
-        privileges to empty the trash.
-    5.9. In Mac OSX Panther (10.3), images often fail to load and/or I
-        experience random delays in page loading. I'm using localhost as my
-        browser's proxy setting.
-    5.10. I get a completely blank page at one site. "View Source" shows only:
-        <html><body></body></html>. Without Privoxy the page loads fine.
-    5.11. My logs show many "Unable to get my own hostname" lines. Why?
-    5.12. When I try to launch Privoxy, I get an error message "port 8118 is
-        already in use" (or similar wording). Why?
-    5.13. Pages with UTF-8 fonts are garbled.
-    5.14. Why are binary files (such as images) corrupted when Privoxy is used?
-    5.15. What is the "demoronizer" and why is it there?
-    5.16. Why do I keep seeing "PrivoxyWindowOpen()" in raw source code?
-    5.17. I am getting too many DNS errors like "404 No Such Domain". Why can't
-        Privoxy do this better?
-    5.18. At one site Privoxy just hangs, and starts taking all CPU. Why is
-        this?
-    5.19. I just installed Privoxy, and all my browsing has slowed to a crawl.
-        What gives?
-    5.20. Why do my filters work on some sites but not on others?
+                1.9. Can Privoxy make mistakes? This does not sound very
+                scientific.
 
-6. Contacting the developers, Bug Reporting and Feature Requests
+                1.10. Will I have to configure Privoxy before I can use it?
 
-    6.1. Get Support
-    6.2. Reporting Problems
+                1.11. Can Privoxy run as a server on a network?
 
-        6.2.1. Reporting Ads or Other Configuration Problems
-        6.2.2. Reporting Bugs
+                1.12. My browser does the same things as Privoxy. Why should
+                I use Privoxy at all?
 
-    6.3. Request New Features
-    6.4. Other
+                1.13. Why should I trust Privoxy?
 
-7. Privoxy Copyright, License and History
+                1.14. Is there is a license or fee? What about a warranty?
+                Registration?
 
-    7.1. License
-    7.2. History
+                1.15. Can Privoxy remove spyware? Adware? Viruses?
 
-1. General Information
+                1.16. Can I use Privoxy with other ad-blocking software?
 
-1.1. Who should give Privoxy a try?
+                1.17. I would like to help you, what can I do?
 
-Anyone who is interested in security, privacy, or in finer-grained control over
-their web and Internet experience.
+                             1.17.1. Would you like to participate?
 
--------------------------------------------------------------------------------
+                             1.17.2. Contribute!
 
-1.2. Is Privoxy the best choice for me?
+                             1.17.3. Software
 
-Privoxy is certainly a good choice, especially for those who want more control
-and security. Those with the willingness to read the documentation and the
-ability to fine-tune their installation will benefit the most.
+   2. Installation
 
-One of Privoxy's strengths is that it is highly configurable giving you the
-ability to completely personalize your installation. Being familiar with, or at
-least having an interest in learning about HTTP and other networking protocols,
-HTML, and "Regular Expressions" will be a big plus and will help you get the
-most out of Privoxy. A new installation just includes a very basic
-configuration. The user should take this as a starting point only, and enhance
-it as he or she sees fit. In fact, the user is encouraged, and expected to,
-fine-tune the configuration.
+                2.1. Which browsers are supported by Privoxy?
 
-Much of Privoxy's configuration can be done with a Web browser. But there are
-areas where configuration is done using a text editor to edit configuration
-files. Also note that the web-based action editor doesn't use authentication
-and should only be enabled in environments where all clients with access to
-Privoxy listening port can be trusted.
+                2.2. Which operating systems are supported?
 
--------------------------------------------------------------------------------
+                2.3. Can I use Privoxy with my email client?
 
-1.3. What is a "proxy"? How does Privoxy work?
+                2.4. I just installed Privoxy. Is there anything special I
+                have to do now?
 
-A web proxy is a service, based on a software such as Privoxy, that clients
-(i.e. browsers) can use instead of connecting directly to web servers on the
-Internet. The clients then ask the proxy to fetch the objects they need (web
-pages, images, movies etc) on their behalf, and when the proxy has done so, it
-hands the results back to the client. It is a "go-between". See the Wikipedia
-proxy definition for more.
+                2.5. What is the proxy address of Privoxy?
 
-There are many reasons to use web proxies, such as security (firewalling),
-efficiency (caching) and others, and there are any number of proxies to
-accommodate those needs.
+                2.6. I just installed Privoxy, and nothing is happening. All
+                the ads are there. What's wrong?
 
-Privoxy is a proxy that is primarily focused on privacy protection, ad and junk
-elimination and freeing the user from restrictions placed on his activities.
-Sitting between your browser(s) and the Internet, it is in a perfect position
-to filter outbound personal information that your browser is leaking, as well
-as inbound junk. It uses a variety of techniques to do this, all of which are
-under your complete control via the various configuration files and options.
-Being a proxy also makes it easier to share configurations among multiple
-browsers and/or users.
+                2.7. I get a "Privoxy is not being used" dummy page although
+                Privoxy is running and being used.
 
--------------------------------------------------------------------------------
+   3. Configuration
 
-1.4. Does Privoxy do anything more than ad blocking?
+                3.1. What exactly is an "actions" file?
 
-Yes, ad blocking is but one possible use. There are many, many ways Privoxy can
-be used to sanitize and customize web browsing.
+                3.2. The "actions" concept confuses me. Please list some of
+                these "actions".
 
--------------------------------------------------------------------------------
+                3.3. How are actions files configured? What is the easiest
+                way to do this?
 
-1.5. What is this new version of "Junkbuster"?
+                3.4. There are several different "actions" files. What are
+                the differences?
 
-A long time ago, there was the Internet Junkbuster, by Anonymous Coders and
-Junkbusters Corporation. This saved many users a lot of pain in the early days
-of web advertising and user tracking.
+                3.5. Where can I get updated Actions Files?
 
-But the web, its protocols and standards, and with it, the techniques for
-forcing ads on users, give up autonomy over their browsing, and for tracking
-them, keeps evolving. Unfortunately, the Internet Junkbuster did not. Version
-2.0.2, published in 1998, was (and is) the last official release available from
-Junkbusters Corporation. Fortunately, it had been released under the GNU GPL,
-which allowed further development by others.
+                3.6. Can I use my old config files?
 
-So Stefan Waldherr started maintaining an improved version of the software, to
-which eventually a number of people contributed patches. It could already
-replace banners with a transparent image, and had a first version of pop-up
-killing, but it was still very closely based on the original, with all its
-limitations, such as the lack of HTTP/1.1 support, flexible per-site
-configuration, or content modification. The last release from this effort was
-version 2.0.2-10, published in 2000.
+                3.7. Why is the configuration so complicated?
 
-Then, some developers picked up the thread, and started turning the software
-inside out, upside down, and then reassembled it, adding many new features
-along the way.
+                3.8. How can I make my Yahoo/Hotmail/Gmail account work?
 
-The result of this is Privoxy, whose first stable version, 3.0, was released
-August, 2002.
+                3.9. What's the difference between the "Cautious", "Medium"
+                and "Advanced" defaults?
 
--------------------------------------------------------------------------------
+                3.10. Why can I change the configuration with a browser? Does
+                that not raise security issues?
 
-1.6. Why "Privoxy"? Why change the name from Junkbuster at all?
+                3.11. What is the default.filter file? What is a "filter"?
 
-Though outdated, Junkbusters Corporation continues to offer their original
-version of the Internet Junkbuster, so publishing our Junkbuster-derived
-software under the same name led to confusion.
+                3.12. How can I set up Privoxy to act as a proxy for my LAN?
 
-There are also potential legal complications from our use of the Junkbuster
-name, which is a registered trademark of Junkbusters Corporation. There are,
-however, no objections from Junkbusters Corporation to the Privoxy project
-itself, and they, in fact, still share our ideals and goals.
+                3.13. Instead of ads, now I get a checkerboard pattern. I
+                don't want to see anything.
 
-The developers also believed that there are so many improvements over the
-original code, that it was time to make a clean break from the past and make a
-name in their own right.
+                3.14. Why would anybody want to see a checkerboard pattern?
 
-Privoxy is the "Privacy Enhancing Proxy". Also, its content modification and
-junk suppression gives you, the user, more control, more freedom, and allows
-you to browse your personal and "private edition" of the web.
+                3.15. I see some images being replaced with text instead of
+                the checkerboard image. Why and how do I get rid of this?
 
--------------------------------------------------------------------------------
+                3.16. Can Privoxy run as a service on Win2K/NT/XP?
 
-1.7. How does Privoxy differ from the old Junkbuster?
+                3.17. How can I make Privoxy work with other proxies like
+                Squid or Tor?
 
-Privoxy picks up where Junkbuster left off. All the old features remain. The
-new Privoxy still blocks ads and banners, still manages cookies, and still
-helps protect your privacy. But, most of these features have been enhanced, and
-many new ones have been added, all in the same vein.
+                3.18. Can I just set Privoxy to use port 80 and thus avoid
+                individual browser configuration?
 
-Privoxy's new features include:
+                3.19. Can Privoxy run as a "transparent" proxy?
 
-  * Can be run as an "intercepting" proxy, which obviates the need to configure
-    browsers individually.
+                3.20. Can Privoxy run as a "intercepting" proxy?
 
-  * Sophisticated actions and filters for manipulating both server and client
-    headers.
+                3.21. How can I configure Privoxy for use with Outlook
+                Express?
 
-  * Can be chained with other proxies.
+                3.22. How can I have separate rules just for HTML mail?
 
-  * Integrated browser based configuration and control utility at http://
-    config.privoxy.org/ (shortcut: http://p.p/). Browser-based tracing of rule
-    and filter effects. Remote toggling.
+                3.23. I sometimes notice cookies sneaking through. How?
 
-  * Web page filtering (text replacements, removes banners based on size,
-    invisible "web-bugs", JavaScript and HTML annoyances, pop-up windows, etc.)
+                3.24. Are all cookies bad? Why?
 
-  * Modularized configuration that allows for standard settings and user
-    settings to reside in separate files, so that installing updated actions
-    files won't overwrite individual user settings.
+                3.25. How can I allow permanent cookies for my trusted sites?
 
-  * Support for Perl Compatible Regular Expressions in the configuration files,
-    and a more sophisticated and flexible configuration syntax.
+                3.26. Can I have separate configurations for different users?
 
-  * Improved cookie management features (e.g. session based cookies).
+                3.27. Can I set-up Privoxy as a whitelist of "good" sites?
 
-  * GIF de-animation.
+                3.28. How can I turn off ad-blocking?
 
-  * Bypass many click-tracking scripts (avoids script redirection).
+                3.29. How can I have custom template pages, like the BLOCKED
+                page?
 
-  * Multi-threaded (POSIX and native threads).
+                3.30. How can I remove the "Go There Anyway" link from the
+                BLOCKED page?
 
-  * User-customizable HTML templates for all proxy-generated pages (e.g.
-    "blocked" page).
+   4. Miscellaneous
 
-  * Auto-detection and re-reading of config file changes.
+                4.1. How much does Privoxy slow my browsing down? This has to
+                add extra time to browsing.
 
-  * Improved signal handling, and a true daemon mode (Unix).
+                4.2. I notice considerable delays in page requests. What's
+                wrong?
 
-  * Every feature now controllable on a per-site or per-location basis,
-    configuration more powerful and versatile over-all.
+                4.3. What are "http://config.privoxy.org/" and "http://p.p/"?
 
-  * Many smaller new features added, limitations and bugs removed, and security
-    holes fixed.
+                4.4. How can I submit new ads, or report problems?
 
--------------------------------------------------------------------------------
+                4.5. If I do submit missed ads, will they be included in
+                future updates?
 
-1.8. How does Privoxy know what is an ad, and what is not?
+                4.6. Why doesn't anyone answer my support request?
 
-Privoxy's approach to blocking ads is twofold:
+                4.7. How can I hide my IP address?
 
-First, there are certain patterns in the locations (URLs) of banner images.
-This applies to both the path (you wouldn't guess how many web sites serve
-their banners from a directory called "banners"!) and the host (blocking the
-big banner hosting services like doublecklick.net already helps a lot). Privoxy
-takes advantage of this fact by using URL patterns to sort out and block the
-requests for things that sound like they would be ads or banners.
+                4.8. Can Privoxy guarantee I am anonymous?
 
-Second, banners tend to come in certain sizes. But you can't tell the size of
-an image by its URL without downloading it, and if you do, it's too late to
-save bandwidth. Therefore, Privoxy also inspects the HTML sources of web pages
-while they are loaded, and replaces references to images with standard banner
-sizes by dummy references, so that your browser doesn't request them anymore in
-the first place.
+                4.9. A test site says I am not using a Proxy.
 
-Both of this involves a certain amount of guesswork and is, of course, freely
-and readily configurable.
+                4.10. How do I use Privoxy together with Tor?
 
--------------------------------------------------------------------------------
+                4.11. Might some things break because header information or
+                content is being altered?
 
-1.9. Can Privoxy make mistakes? This does not sound very scientific.
+                4.12. Can Privoxy act as a "caching" proxy to speed up web
+                browsing?
 
-Actually, it's a black art ;-) And yes, it is always possible to have a broad
-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.
+                4.13. What about as a firewall? Can Privoxy protect me?
 
-But this should not be a big concern since the Privoxy configuration is very
-flexible, and includes tools to help identify these types of situations so they
-can be addressed as needed, allowing you to customize your installation. (See
-the Troubleshooting section below.)
+                4.14. I have large empty spaces / a checkerboard pattern now
+                where ads used to be. Why?
 
--------------------------------------------------------------------------------
+                4.15. How can Privoxy filter Secure (HTTPS) URLs?
 
-1.10. Will I have to configure Privoxy before I can use it?
+                4.16. Privoxy runs as a "server". How secure is it? Do I need
+                to take any special precautions?
 
-That depends on your expectations. The default installation should give you a
-good starting point, and block most ads and unwanted content, but many of the
-more advanced features are off by default, and require you to activate them.
+                4.17. Can I temporarily disable Privoxy?
 
-You do have to set up your browser to use Privoxy (see the Installation section
-below).
+                4.18. When "disabled" is Privoxy totally out of the picture?
 
-And 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 Privoxy's configuration to more closely match
-your individual situation. And we encourage you to do this. This is where the
-real power of Privoxy lies!
+                4.19. How can I tell Privoxy to totally ignore certain sites?
 
--------------------------------------------------------------------------------
+                4.20. My logs show Privoxy "crunches" ads, but also its own
+                internal CGI pages. What is a "crunch"?
 
-1.11. Can Privoxy run as a server on a network?
+                4.21. Can Privoxy effect files that I download from a
+                webserver? FTP server?
 
-Yes, Privoxy runs as a server already, and can easily be configured to "serve"
-more than one client. See How can I set up Privoxy to act as a proxy for my LAN
-below.
+                4.22. I just downloaded a Perl script, and Privoxy altered
+                it! Yikes, what is wrong!
 
--------------------------------------------------------------------------------
+                4.23. Should I continue to use a "HOSTS" file for
+                ad-blocking?
 
-1.12. My browser does the same things as Privoxy. Why should I use Privoxy at
-all?
+                4.24. Where can I find more information about Privoxy and
+                related issues?
 
-Modern browsers do indeed have some of the same functionality as Privoxy. Maybe
-this is adequate for you. But Privoxy is very versatile and powerful, and can
-probably do a number of things your browser just can't.
+                4.25. I've noticed that Privoxy changes "Microsoft" to
+                "MicroSuck"! Why are you manipulating my browsing?
 
-In addition, a proxy is good choice if you use multiple browsers, or have a LAN
-with multiple computers since Privoxy can run as a server application. This way
-all the configuration is in one place, and you don't have to maintain a similar
-configuration for possibly many browsers or users.
+                4.26. Does Privoxy produce "valid" HTML (or XHTML)?
 
-Note, however, that it's recommended to leverage both your browser's and
-Privoxy's privacy enhancing features at the same time. While your browser
-probably lacks some features Privoxy offers, it should also be able to do some
-things more reliable, for example restricting and suppressing JavaScript.
+   5. Troubleshooting
 
--------------------------------------------------------------------------------
+                5.1. I cannot connect to any websites. Or, I am getting
+                "connection refused" message with every web page. Why?
 
-1.13. Why should I trust Privoxy?
+                5.2. Why am I getting a 503 Error (WSAECONNREFUSED) on every
+                page?
 
-The most important reason is because you have access to everything, and you can
-control everything. You can check every line of every configuration file
-yourself. You can check every last bit of source code should you desire. And
-even if you can't read code, there should be some comfort in knowing that other
-people can, and do read it. You can build the software from scratch, if you
-want, so that you know the executable is clean, and that it is yours. In fact,
-we encourage this level of scrutiny. It is one reason we use Privoxy ourselves.
+                5.3. I just added a new rule, but the steenkin ad is still
+                getting through. How?
 
--------------------------------------------------------------------------------
+                5.4. One of my favorite sites does not work with Privoxy.
+                What can I do?
 
-1.14. Is there is a license or fee? What about a warranty? Registration?
+                5.5. After installing Privoxy, I have to log in every time I
+                start IE. What gives?
 
-Privoxy is free software and licensed under the GNU General Public License
-(GPL) version 2. It is free to use, copy, modify or distribute as you wish
-under the terms of this license. Please see the Copyright section for more
-information on the license and copyright. Or the LICENSE file that should be
-included.
+                5.6. I cannot connect to any FTP sites. Privoxy is blocking
+                me.
 
-There is no warranty of any kind, expressed, implied or otherwise. That is
-something that would cost real money ;-) There is no registration either.
+                5.7. In Mac OSX, I can't configure Microsoft Internet
+                Explorer to use Privoxy as the HTTP proxy.
 
--------------------------------------------------------------------------------
+                5.8. In Mac OSX, I dragged the Privoxy folder to the trash in
+                order to uninstall it. Now the finder tells me I don't have
+                sufficient privileges to empty the trash.
 
-1.15. Can Privoxy remove spyware? Adware? Viruses?
+                5.9. In Mac OSX Panther (10.3), images often fail to load
+                and/or I experience random delays in page loading. I'm using
+                localhost as my browser's proxy setting.
 
-No, at least not reliably enough to trust it. Privoxy is not designed to be a
-malware removal tool and the default configuration doesn't even try to filter
-out any malware.
+                5.10. I get a completely blank page at one site. "View
+                Source" shows only: <html><body></body></html>. Without
+                Privoxy the page loads fine.
 
-Privoxy could help prevent contact from (known) sites that use such tactics
-with appropriate configuration rules, and thus could conceivably prevent
-contamination from such sites. However, keeping such a configuration up to date
-would require a lot of time and effort that would be better spend on keeping
-your software itself up to date so it doesn't have known vulnerabilities.
+                5.11. My logs show many "Unable to get my own hostname"
+                lines. Why?
 
--------------------------------------------------------------------------------
+                5.12. When I try to launch Privoxy, I get an error message
+                "port 8118 is already in use" (or similar wording). Why?
 
-1.16. Can I use Privoxy with other ad-blocking software?
+                5.13. Pages with UTF-8 fonts are garbled.
 
-Privoxy should work fine with other proxies and other software in general.
+                5.14. Why are binary files (such as images) corrupted when
+                Privoxy is used?
 
-But it is probably not necessary to use Privoxy in conjunction with other
-ad-blocking products, and this could conceivably cause undesirable results. It
-might be better to choose one software or the other and work a little to tweak
-its configuration to your liking.
+                5.15. What is the "demoronizer" and why is it there?
 
-Note that this is an advice specific to ad blocking.
+                5.16. Why do I keep seeing "PrivoxyWindowOpen()" in raw
+                source code?
 
--------------------------------------------------------------------------------
+                5.17. I am getting too many DNS errors like "404 No Such
+                Domain". Why can't Privoxy do this better?
 
-1.17. I would like to help you, what can I do?
+                5.18. At one site Privoxy just hangs, and starts taking all
+                CPU. Why is this?
 
-1.17.1. Would you like to participate?
+                5.19. I just installed Privoxy, and all my browsing has
+                slowed to a crawl. What gives?
 
-Well, we always need help. There is something for everybody who wants to help
-us. We welcome new developers, packagers, testers, documentation writers or
-really anyone with a desire to help in any way. You DO NOT need to be a
-"programmer". There are many other tasks available. In fact, the programmers
-often can't spend as much time programming because of some of the other, more
-mundane things that need to be done, like checking the Tracker feedback
-sections.
+                5.20. Why do my filters work on some sites but not on others?
 
-So first thing, get an account on SourceForge.net and mail your id to the
-developers mailing list. Then, please read the Developer's Manual, at least the
-pertinent sections.
+   6. Contacting the developers, Bug Reporting and Feature Requests
 
-You can also start helping out without SourceForge.net account, simply by
-showing up on the mailing list, helping out other users, providing general
-feedback or reporting problems you noticed.
+                6.1. Get Support
 
--------------------------------------------------------------------------------
+                6.2. Reporting Problems
 
-1.17.2. Contribute!
+                             6.2.1. Reporting Ads or Other Configuration
+                             Problems
 
-We, of course, welcome donations and could use money for domain registering,
-buying software to test Privoxy with, and, of course, for regular world-wide
-get-togethers (hahaha). If you enjoy the software and feel like helping us with
-a donation, just drop us a note and get your name on the list of contributors.
+                             6.2.2. Reporting Bugs
 
--------------------------------------------------------------------------------
+                6.3. Request New Features
 
-1.17.3. Software
+                6.4. Other
 
-If you are a vendor of a web-related software like a browser, web server or
-proxy, and would like us to ensure that Privoxy runs smoothly with your
-product, you might consider supplying us with a copy or license. We can't,
-however, guarantee that we will fix all potential compatibility issues as a
-result.
+   7. Privoxy Copyright, License and History
 
--------------------------------------------------------------------------------
+                7.1. License
 
-2. Installation
+                7.2. History
 
-2.1. Which browsers are supported by Privoxy?
+1. General Information
 
-Any browser that can be configured to use a proxy, which should be virtually
-all browsers, including Firefox, Internet Explorer, Opera, and Safari among
-others. Direct browser support is not an absolute requirement since Privoxy
-runs as a separate application and talks to the browser in the standardized
-HTTP protocol, just like a web server does.
+    1.1. Who should give Privoxy a try?
 
--------------------------------------------------------------------------------
+   Anyone who is interested in security, privacy, or in finer-grained control
+   over their web and Internet experience.
 
-2.2. Which operating systems are supported?
+   --------------------------------------------------------------------------
 
-At present, Privoxy is known to run on Windows(95, 98, ME, 2000, XP, Vista),
-GNU/Linux (RedHat, SuSE, Debian, Fedora, Gentoo, Slackware and others), Mac
-OSX, OS/2, AmigaOS, FreeBSD, NetBSD, OpenBSD, Solaris, and various other
-flavors of Unix.
+    1.2. Is Privoxy the best choice for me?
 
-But any operating system that runs TCP/IP, can conceivably take advantage of
-Privoxy in a networked situation where Privoxy would run as a server on a LAN
-gateway. Then only the "gateway" needs to be running one of the above operating
-systems.
+   Privoxy is certainly a good choice, especially for those who want more
+   control and security. Those with the willingness to read the documentation
+   and the ability to fine-tune their installation will benefit the most.
 
-Source code is freely available, so porting to other operating systems is
-always a possibility.
+   One of Privoxy's strengths is that it is highly configurable giving you
+   the ability to completely personalize your installation. Being familiar
+   with, or at least having an interest in learning about HTTP and other
+   networking protocols, HTML, and "Regular Expressions" will be a big plus
+   and will help you get the most out of Privoxy. A new installation just
+   includes a very basic configuration. The user should take this as a
+   starting point only, and enhance it as he or she sees fit. In fact, the
+   user is encouraged, and expected to, fine-tune the configuration.
 
--------------------------------------------------------------------------------
+   Much of Privoxy's configuration can be done with a Web browser. But there
+   are areas where configuration is done using a text editor to edit
+   configuration files. Also note that the web-based action editor doesn't
+   use authentication and should only be enabled in environments where all
+   clients with access to Privoxy listening port can be trusted.
 
-2.3. Can I use Privoxy with my email client?
+   --------------------------------------------------------------------------
 
-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 "browser" or not.
-Though this may not be the best approach for dealing with some of the common
-abuses of HTML in email. See How can I configure Privoxy with Outlook Express?
-below for more on this.
+    1.3. What is a "proxy"? How does Privoxy work?
 
-Be aware that HTML email presents a number of unique security and privacy
-related issues, that can require advanced skills to overcome. The developers
-recommend using email clients that can be configured to convert HTML to plain
-text for these reasons.
+   A web proxy is a service, based on a software such as Privoxy, that
+   clients (i.e. browsers) can use instead of connecting directly to web
+   servers on the Internet. The clients then ask the proxy to fetch the
+   objects they need (web pages, images, movies etc) on their behalf, and
+   when the proxy has done so, it hands the results back to the client. It is
+   a "go-between". See the Wikipedia proxy definition for more.
 
--------------------------------------------------------------------------------
+   There are many reasons to use web proxies, such as security (firewalling),
+   efficiency (caching) and others, and there are any number of proxies to
+   accommodate those needs.
 
-2.4. I just installed Privoxy. Is there anything special I have to do now?
+   Privoxy is a proxy that is primarily focused on privacy protection, ad and
+   junk elimination and freeing the user from restrictions placed on his
+   activities. Sitting between your browser(s) and the Internet, it is in a
+   perfect position to filter outbound personal information that your browser
+   is leaking, as well as inbound junk. It uses a variety of techniques to do
+   this, all of which are under your complete control via the various
+   configuration files and options. Being a proxy also makes it easier to
+   share configurations among multiple browsers and/or users.
 
-All browsers should be told to use Privoxy as a proxy by specifying the correct
-proxy address and port number in the appropriate configuration area for the
-browser. It's possible to combine Privoxy with a packet filter to intercept
-HTTP requests even if the client isn't explicitly configured to use Privoxy,
-but where possible, configuring the client is recommended. See the User Manual
-for more details. You should also flush your browser's memory and disk cache to
-get rid of any cached junk items, and remove any stored cookies. 
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    1.4. Does Privoxy do anything more than ad blocking?
 
-2.5. What is the proxy address of Privoxy?
+   Yes, ad blocking is but one possible use. There are many, many ways
+   Privoxy can be used to sanitize and customize web browsing.
 
-If you set up the Privoxy to run on the computer you browse from (rather than
-your ISP's server or some networked computer on a LAN), the proxy will be on
-127.0.0.1 (sometimes referred to as "localhost", which is the special name used
-by every computer on the Internet to refer to itself) and the port will be 8118
-(unless you used the listen-address config option to tell Privoxy to run on a
-different port).
+   --------------------------------------------------------------------------
 
-When configuring your browser's proxy settings you typically enter the word
-"localhost" or the IP address "127.0.0.1" in the boxes next to "HTTP" and
-"Secure" (HTTPS) and then the number "8118" for "port". This tells your browser
-to send all web requests to Privoxy instead of directly to the Internet.
+    1.5. What is this new version of "Junkbuster"?
 
-Privoxy can also be used to proxy for a Local Area Network. In this case, your
-would enter either the IP address of the LAN host where Privoxy is running, or
-the equivalent hostname, e.g. 192.168.1.1. Port assignment would be same as
-above. Note that Privoxy doesn't listen on any LAN interfaces by default.
+   A long time ago, there was the Internet Junkbuster, by Anonymous Coders
+   and Junkbusters Corporation. This saved many users a lot of pain in the
+   early days of web advertising and user tracking.
 
-Privoxy does not currently handle any other protocols such as FTP, SMTP, IM,
-IRC, ICQ, etc.
+   But the web, its protocols and standards, and with it, the techniques for
+   forcing ads on users, give up autonomy over their browsing, and for
+   tracking them, keeps evolving. Unfortunately, the Internet Junkbuster did
+   not. Version 2.0.2, published in 1998, was (and is) the last official
+   release available from Junkbusters Corporation. Fortunately, it had been
+   released under the GNU GPL, which allowed further development by others.
 
--------------------------------------------------------------------------------
+   So Stefan Waldherr started maintaining an improved version of the
+   software, to which eventually a number of people contributed patches. It
+   could already replace banners with a transparent image, and had a first
+   version of pop-up killing, but it was still very closely based on the
+   original, with all its limitations, such as the lack of HTTP/1.1 support,
+   flexible per-site configuration, or content modification. The last release
+   from this effort was version 2.0.2-10, published in 2000.
 
-2.6. I just installed Privoxy, and nothing is happening. All the ads are there.
-What's wrong?
+   Then, some developers picked up the thread, and started turning the
+   software inside out, upside down, and then reassembled it, adding many new
+   features along the way.
 
-Did you configure your browser to use Privoxy as a proxy? It does not sound
-like it. See above. You might also try flushing the browser's caches to force a
-full re-reading of pages. You can verify that Privoxy is running, and your
-browser is correctly configured by entering the special URL: http://p.p/. This
-should take you to a page titled "This is Privoxy.." with access to Privoxy's
-internal configuration. If you see this, then you are good to go. If you
-receive a page saying "Privoxy is not running", then the browser is not set up
-to use your Privoxy installation. If you receive anything else (probably
-nothing at all), it could either be that the browser is not set up correctly,
-or that Privoxy is not running at all. Check the log file. For instructions on
-starting Privoxy and browser configuration, see the chapter on starting Privoxy
-in the User Manual.
+   The result of this is Privoxy, whose first stable version, 3.0, was
+   released August, 2002.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-2.7. I get a "Privoxy is not being used" dummy page although Privoxy is running
-and being used.
+    1.6. Why "Privoxy"? Why change the name from Junkbuster at all?
 
-First, make sure that Privoxy is really running and being used by visiting
-http://p.p/. You should see the Privoxy main page. If not, see the chapter on
-starting Privoxy in the User Manual.
+   Though outdated, Junkbusters Corporation continues to offer their original
+   version of the Internet Junkbuster, so publishing our Junkbuster-derived
+   software under the same name led to confusion.
 
-Now if http://p.p/ works for you, but other parts of Privoxy's web interface
-show the dummy page, your browser has cached a redirection it encountered
-before Privoxy 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.
+   There are also potential legal complications from our use of the
+   Junkbuster name, which is a registered trademark of Junkbusters
+   Corporation. There are, however, no objections from Junkbusters
+   Corporation to the Privoxy project itself, and they, in fact, still share
+   our ideals and goals.
 
-The procedure for clearing the cache varies from browser to browser. For
-example, Mozilla/Netscape users would click Edit --> Preferences --> Advanced
---> Cache and then click both "Clear Memory Cache" and "Clear Disk Cache". In
-some Firefox versions it's Tools --> Options --> Privacy --> Cache and then
-click "Clear Cache Now".
+   The developers also believed that there are so many improvements over the
+   original code, that it was time to make a clean break from the past and
+   make a name in their own right.
 
--------------------------------------------------------------------------------
+   Privoxy is the "Privacy Enhancing Proxy". Also, its content modification
+   and junk suppression gives you, the user, more control, more freedom, and
+   allows you to browse your personal and "private edition" of the web.
 
-3. Configuration
+   --------------------------------------------------------------------------
 
-3.1. What exactly is an "actions" file?
+    1.7. How does Privoxy differ from the old Junkbuster?
 
-Privoxy utilizes the concept of " actions" that are used to manipulate and
-control web page data. Actions files are where these actions that Privoxy could
-take while processing a certain request, are configured. Typically, you would
-define a set of default actions that apply globally to all URLs, then add
-exceptions to these defaults where needed. There is a wide array of actions
-available that give the user a high degree of control and flexibility on how to
-process each and every web page.
+   Privoxy picks up where Junkbuster left off. All the old features remain.
+   The new Privoxy still blocks ads and banners, still manages cookies, and
+   still helps protect your privacy. But, most of these features have been
+   enhanced, and many new ones have been added, all in the same vein.
 
-Actions can be defined on a URL pattern basis, i.e. for single URLs, whole web
-sites, groups or parts thereof etc. Actions can also be grouped together and
-then applied to requests matching one or more patterns. There are many possible
-actions that might apply to any given site. As an example, if you are blocking
-cookies as one of your default actions, but need to accept cookies from a given
-site, you would need to define an exception for this site in one of your
-actions files, preferably in user.action.
+   Privoxy's new features include:
 
--------------------------------------------------------------------------------
+     * Can be run as an "intercepting" proxy, which obviates the need to
+       configure browsers individually.
 
-3.2. The "actions" concept confuses me. Please list some of these "actions".
+     * Sophisticated actions and filters for manipulating both server and
+       client headers.
 
-For a comprehensive discussion of the actions concept, please refer to the
-actions file chapter in the User Manual. It includes a list of all actions and
-an actions file tutorial to get you started.
+     * Can be chained with other proxies.
 
--------------------------------------------------------------------------------
+     * Integrated browser based configuration and control utility at
+       http://config.privoxy.org/ (shortcut: http://p.p/). Browser-based
+       tracing of rule and filter effects. Remote toggling.
 
-3.3. How are actions files configured? What is the easiest way to do this?
+     * Web page filtering (text replacements, removes banners based on size,
+       invisible "web-bugs", JavaScript and HTML annoyances, pop-up windows,
+       etc.)
 
-Actions files are just text files in a special syntax and can be edited with a
-text editor. But probably the easiest way is to access Privoxy's user interface
-with your web browser at http://config.privoxy.org/ (Shortcut: http://p.p/) and
-then select "View & change the current configuration" from the menu. Note that
-this feature must be explicitly enabled in the main config file (see
-enable-edit-actions).
+     * Modularized configuration that allows for standard settings and user
+       settings to reside in separate files, so that installing updated
+       actions files won't overwrite individual user settings.
 
--------------------------------------------------------------------------------
+     * Support for Perl Compatible Regular Expressions in the configuration
+       files, and a more sophisticated and flexible configuration syntax.
 
-3.4. There are several different "actions" files. What are the differences?
+     * Improved cookie management features (e.g. session based cookies).
 
-Three actions files are being included by the developers, to be used for
-different purposes: These are default.action, the "main" actions file which is
-actively maintained by the Privoxy developers and typically sets the default
-policies, user.action, where users are encouraged to make their private
-customizations, and standard.action, which is for internal Privoxy use only.
-Please see the actions chapter in the User Manual for a more detailed
-explanation.
+     * GIF de-animation.
 
-Earlier versions included three different versions of the default.action file.
-The new scheme allows for greater flexibility of local configuration, and for
-browser based selection of pre-defined "aggressiveness" levels.
+     * Bypass many click-tracking scripts (avoids script redirection).
 
--------------------------------------------------------------------------------
+     * Multi-threaded (POSIX and native threads).
 
-3.5. Where can I get updated Actions Files?
+     * User-customizable HTML templates for all proxy-generated pages (e.g.
+       "blocked" page).
 
-Based on your feedback and the continuing development, updates of
-default.action will be made available from time to time on the files section of
-our project page.
+     * Auto-detection and re-reading of config file changes.
 
-If you wish to receive an email notification whenever we release updates of
-Privoxy or the actions file, subscribe to our announce mailing list,
-ijbswa-announce@lists.sourceforge.net.
+     * Improved signal handling, and a true daemon mode (Unix).
 
--------------------------------------------------------------------------------
+     * Every feature now controllable on a per-site or per-location basis,
+       configuration more powerful and versatile over-all.
 
-3.6. Can I use my old config files?
+     * Many smaller new features added, limitations and bugs removed, and
+       security holes fixed.
 
-The syntax and purpose of configuration files has remained roughly the same
-throughout the 3.x series, but backwards compatibility is not guaranteed. Also
-each release contains updated, "improved" versions and it is therefore strongly
-recommended to install the newer configuration files and merge back your
-modifications.
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    1.8. How does Privoxy know what is an ad, and what is not?
 
-3.7. Why is the configuration so complicated?
+   Privoxy's approach to blocking ads is twofold:
 
-"Complicated" is in the eye of the beholder. Those that are familiar with some
-of the underlying concepts, such as regular expression syntax, take to it like
-a fish takes to water. Also, software that tries hard to be "user friendly",
-often lacks sophistication and flexibility. There is always that trade-off
-there between power vs. easy-of-use. Furthermore, anyone is welcome to
-contribute ideas and implementations to enhance Privoxy.
+   First, there are certain patterns in the locations (URLs) of banner
+   images. This applies to both the path (you wouldn't guess how many web
+   sites serve their banners from a directory called "banners"!) and the host
+   (blocking the big banner hosting services like doublecklick.net already
+   helps a lot). Privoxy takes advantage of this fact by using URL patterns
+   to sort out and block the requests for things that sound like they would
+   be ads or banners.
 
--------------------------------------------------------------------------------
+   Second, banners tend to come in certain sizes. But you can't tell the size
+   of an image by its URL without downloading it, and if you do, it's too
+   late to save bandwidth. Therefore, Privoxy also inspects the HTML sources
+   of web pages while they are loaded, and replaces references to images with
+   standard banner sizes by dummy references, so that your browser doesn't
+   request them anymore in the first place.
 
-3.8. How can I make my Yahoo/Hotmail/Gmail account work?
+   Both of this involves a certain amount of guesswork and is, of course,
+   freely and readily configurable.
 
-The default configuration shouldn't impact the usability of any of these
-services. It may, however, make all cookies temporary, so that your browser
-will forget your login credentials in between browser sessions. If you would
-like not to have to log in manually each time you access those websites, simply
-turn off all cookie handling for them in the user.action file. An example for
-yahoo might look like:
+   --------------------------------------------------------------------------
 
-# Allow all cookies for Yahoo login:
-#
-{ -crunch-incoming-cookies -crunch-outgoing-cookies -session-cookies-only }
-.login.yahoo.com
+    1.9. Can Privoxy make mistakes? This does not sound very scientific.
 
+   Actually, it's a black art ;-) And yes, it is always possible to have a
+   broad 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.
 
-These kinds of sites are often quite complex and heavy with Javascript and thus
-"fragile". So if still a problem, we have an alias just for such sticky
-situations:
+   But this should not be a big concern since the Privoxy configuration is
+   very flexible, and includes tools to help identify these types of
+   situations so they can be addressed as needed, allowing you to customize
+   your installation. (See the Troubleshooting section below.)
 
-# Gmail is a _fragile_ site:
-#
-{ fragile }
- # Gmail is ...
- mail.google.com
+   --------------------------------------------------------------------------
 
+    1.10. Will I have to configure Privoxy before I can use it?
 
-Be sure to flush your browser's caches whenever making these kinds of changes,
-just to make sure the changes "take".
+   That depends on your expectations. The default installation should give
+   you a good starting point, and block most ads and unwanted content, but
+   many of the more advanced features are off by default, and require you to
+   activate them.
 
-Make sure the domain, host and path are appropriate as well. Your browser can
-tell you where you are specifically and you should use that information for
-your configuration settings. Note that above it is not referenced as gmail.com,
-which is a valid domain name.
+   You do have to set up your browser to use Privoxy (see the Installation
+   section below).
 
--------------------------------------------------------------------------------
+   And 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 Privoxy's configuration
+   to more closely match your individual situation. And we encourage you to
+   do this. This is where the real power of Privoxy lies!
 
-3.9. What's the difference between the "Cautious", "Medium" and "Advanced"
-defaults?
+   --------------------------------------------------------------------------
 
-Configuring Privoxy is not entirely trivial. To help you get started, we
-provide you with three different default action "profiles" in the web based
-actions file editor at http://config.privoxy.org/show-status. See the User
-Manual for a list of actions, and how the default profiles are set.
+    1.11. Can Privoxy run as a server on a network?
 
-Where the defaults are likely to break some sites, exceptions for known popular
-"problem" sites are included, but in general, the more aggressive your default
-settings are, the more exceptions you will have to make later. New users are
-best to start off in "Cautious" setting. This is safest and will have the
-fewest problems. See the User Manual for a more detailed discussion.
+   Yes, Privoxy runs as a server already, and can easily be configured to
+   "serve" more than one client. See How can I set up Privoxy to act as a
+   proxy for my LAN below.
 
-It should be noted that the "Advanced" profile (formerly known as the
-"Adventuresome" profile) is more aggressive, and will make use of some of
-Privoxy's advanced features. Use at your own risk!
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    1.12. My browser does the same things as Privoxy. Why should I use Privoxy
+    at all?
 
-3.10. Why can I change the configuration with a browser? Does that not raise
-security issues?
+   Modern browsers do indeed have some of the same functionality as Privoxy.
+   Maybe this is adequate for you. But Privoxy is very versatile and
+   powerful, and can probably do a number of things your browser just can't.
 
-It may seem strange that regular users can edit the config files with their
-browsers, although the whole /etc/privoxy hierarchy belongs to the user
-"privoxy", with only 644 permissions.
+   In addition, a proxy is good choice if you use multiple browsers, or have
+   a LAN with multiple computers since Privoxy can run as a server
+   application. This way all the configuration is in one place, and you don't
+   have to maintain a similar configuration for possibly many browsers or
+   users.
 
-When you use the browser-based editor, Privoxy itself is writing to the config
-files. Because Privoxy is running as the user "privoxy", it can update its own
-config files.
+   Note, however, that it's recommended to leverage both your browser's and
+   Privoxy's privacy enhancing features at the same time. While your browser
+   probably lacks some features Privoxy offers, it should also be able to do
+   some things more reliable, for example restricting and suppressing
+   JavaScript.
 
-If you run Privoxy for multiple untrusted users (e.g. in a LAN) or aren't
-entirely in control of your own browser, you will probably want to make sure
-that the the web-based editor and remote toggle features are "off" by setting "
-enable-edit-actions 0" and "enable-remote-toggle 0" in the main configuration
-file.
+   --------------------------------------------------------------------------
 
-As of Privoxy 3.0.7 these options are disabled by default.
+    1.13. Why should I trust Privoxy?
+
+   The most important reason is because you have access to everything, and
+   you can control everything. You can check every line of every
+   configuration file yourself. You can check every last bit of source code
+   should you desire. And even if you can't read code, there should be some
+   comfort in knowing that other people can, and do read it. You can build
+   the software from scratch, if you want, so that you know the executable is
+   clean, and that it is yours. In fact, we encourage this level of scrutiny.
+   It is one reason we use Privoxy ourselves.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
+
+    1.14. Is there is a license or fee? What about a warranty? Registration?
 
-3.11. What is the default.filter file? What is a "filter"?
+   Privoxy is free software and licensed under the GNU General Public License
+   (GPL) version 2. It is free to use, copy, modify or distribute as you wish
+   under the terms of this license. Please see the Copyright section for more
+   information on the license and copyright. Or the LICENSE file that should
+   be included.
 
-The default.filter file is where filters as supplied by the developers are
-defined. Filters are a special subset of actions that can be used to modify or
-remove web page content or headers on the fly. Content filters can be applied
-to anything in the page source, header filters can be applied to either server
-or client headers. Regular expressions are used to accomplish this.
+   There is no warranty of any kind, expressed, implied or otherwise. That is
+   something that would cost real money ;-) There is no registration either.
 
-There are a number of pre-defined filters to deal with common annoyances. The
-filters are only defined here, to invoke them, you need to use the filter
-action in one of the actions files. Content filtering is automatically disabled
-for inappropriate MIME types, but if you now better than Privoxy what should or
-should not be filtered you can filter any content you like.
+   --------------------------------------------------------------------------
 
-Filters should not be confused with blocks, which is a completely different
-action, and is more typically used to block ads and unwanted sites.
+    1.15. Can Privoxy remove spyware? Adware? Viruses?
 
-If you are familiar with regular expressions, and HTML, you can look at the
-provided default.filter with a text editor and define your own filters. This is
-potentially a very powerful feature, but requires some expertise in both
-regular expressions and HTML/HTTP. You should place any modifications to the
-default filters, or any new ones you create in a separate file, such as
-user.filter, so they won't be overwritten during upgrades. The ability to
-define multiple filter files in config is a new feature as of v. 3.0.5.
+   No, at least not reliably enough to trust it. Privoxy is not designed to
+   be a malware removal tool and the default configuration doesn't even try
+   to filter out any malware.
 
-There is no GUI editor option for this part of the configuration, but you can
-disable/enable the various pre-defined filters of the included default.filter
-file with the web-based actions file editor. Note that the custom actions
-editor must be explicitly enabled in the main config file (see
-enable-edit-actions).
+   Privoxy could help prevent contact from (known) sites that use such
+   tactics with appropriate configuration rules, and thus could conceivably
+   prevent contamination from such sites. However, keeping such a
+   configuration up to date would require a lot of time and effort that would
+   be better spend on keeping your software itself up to date so it doesn't
+   have known vulnerabilities.
 
-If you intend to develop your own filters, you might want to have a look at
-Privoxy-Filter-Test.
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    1.16. Can I use Privoxy with other ad-blocking software?
 
-3.12. How can I set up Privoxy to act as a proxy for my LAN?
+   Privoxy should work fine with other proxies and other software in general.
 
-By default, Privoxy only responds to requests from 127.0.0.1 (localhost). To
-have it act as a server for a network, this needs to be changed in the main
-configuration file. Look for the listen-address option, which may be commented
-out with a "#" symbol. Make sure it is uncommented, and assign it the address
-of the LAN gateway interface, and port number to use. Assuming your LAN address
-is 192.168.1.1 and you wish to run Privoxy on port 8118, this line should look
-like:
+   But it is probably not necessary to use Privoxy in conjunction with other
+   ad-blocking products, and this could conceivably cause undesirable
+   results. It might be better to choose one software or the other and work a
+   little to tweak its configuration to your liking.
 
-  listen-address  192.168.1.1:8118
+   Note that this is an advice specific to ad blocking.
 
+   --------------------------------------------------------------------------
 
-Save the file, and restart Privoxy. Configure all browsers on the network then
-to use this address and port number.
+    1.17. I would like to help you, what can I do?
 
-Alternately, you can have Privoxy listen on all available interfaces:
+      1.17.1. Would you like to participate?
 
-  listen-address    :8118
+   Well, we always need help. There is something for everybody who wants to
+   help us. We welcome new developers, packagers, testers, documentation
+   writers or really anyone with a desire to help in any way. You DO NOT need
+   to be a "programmer". There are many other tasks available. In fact, the
+   programmers often can't spend as much time programming because of some of
+   the other, more mundane things that need to be done, like checking the
+   Tracker feedback sections.
 
+   So first thing, get an account on SourceForge.net and mail your id to the
+   developers mailing list. Then, please read the Developer's Manual, at
+   least the pertinent sections.
 
-And then use Privoxy's permit-access feature to limit connections. A firewall
-in this situation is recommended as well.
+   You can also start helping out without SourceForge.net account, simply by
+   showing up on the mailing list, helping out other users, providing general
+   feedback or reporting problems you noticed.
 
-The above steps should be the same for any TCP network, regardless of operating
-system.
+   --------------------------------------------------------------------------
 
-If you run Privoxy on a LAN with untrusted users, we recommend that you
-double-check the access control and security options!
+      1.17.2. Contribute!
 
--------------------------------------------------------------------------------
+   We, of course, welcome donations and could use money for domain
+   registering, buying software to test Privoxy with, and, of course, for
+   regular world-wide get-togethers (hahaha). If you enjoy the software and
+   feel like helping us with a donation, just drop us a note and get your
+   name on the list of contributors.
 
-3.13. Instead of ads, now I get a checkerboard pattern. I don't want to see
-anything.
+   --------------------------------------------------------------------------
 
-The replacement for blocked images can be controlled with the set-image-blocker
-action. You have the choice of a checkerboard pattern, a transparent 1x1 GIF
-image (aka "blank"), or a redirect to a custom image of your choice. Note that
-this choice only has effect for images which are blocked as images, i.e. whose
-URLs match both a handle-as-image and block action.
+      1.17.3. Software
 
-If you want to see nothing, then change the set-image-blocker action to
-"blank". This can be done by editing the user.action file, or through the
-web-based actions file editor.
+   If you are a vendor of a web-related software like a browser, web server
+   or proxy, and would like us to ensure that Privoxy runs smoothly with your
+   product, you might consider supplying us with a copy or license. We can't,
+   however, guarantee that we will fix all potential compatibility issues as
+   a result.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-3.14. Why would anybody want to see a checkerboard pattern?
+2. Installation
 
-Remember that telling which image is an ad and which isn't, is an educated
-guess. While we hope that the standard configuration is rather smart, it will
-make occasional mistakes. The checkerboard image is visually decent, and it
-shows you where images have been blocked, which can be very helpful in case
-some navigation aid or otherwise innocent image was erroneously blocked. It is
-recommended for new users so they can "see" what is happening. Some people
-might also enjoy seeing how many banners they don't have to see.
+    2.1. Which browsers are supported by Privoxy?
 
--------------------------------------------------------------------------------
+   Any browser that can be configured to use a proxy, which should be
+   virtually all browsers, including Firefox, Internet Explorer, Opera, and
+   Safari among others. Direct browser support is not an absolute requirement
+   since Privoxy runs as a separate application and talks to the browser in
+   the standardized HTTP protocol, just like a web server does.
 
-3.15. I see some images being replaced with text instead of the checkerboard
-image. Why and how do I get rid of this?
+   --------------------------------------------------------------------------
 
-This happens when the banners are not embedded in the HTML code of the page
-itself, but in separate HTML (sub)documents that are loaded into (i)frames or
-(i)layers, and these external HTML documents are blocked. Being non-images they
-get replaced by a substitute HTML page rather than a substitute image, which
-wouldn't work out technically, since the browser expects and accepts only HTML
-when it has requested an HTML document.
+    2.2. Which operating systems are supported?
 
-The substitute page adapts to the available space and shows itself as a
-miniature two-liner if loaded into small frames, or full-blown with a large red
-"BLOCKED" banner if space allows.
+   At present, Privoxy is known to run on Windows(95, 98, ME, 2000, XP,
+   Vista), GNU/Linux (RedHat, SuSE, Debian, Fedora, Gentoo, Slackware and
+   others), Mac OSX, OS/2, AmigaOS, FreeBSD, NetBSD, OpenBSD, Solaris, and
+   various other flavors of Unix.
 
-If you prefer the banners to be blocked by images, you must see to it that the
-HTML documents in which they are embedded are not blocked. Clicking the "See
-why" link offered in the substitute page will show you which rule blocked the
-page. After changing the rule and un-blocking the HTML documents, the browser
-will try to load the actual banner images and the usual image blocking will
-(hopefully!) kick in.
+   But any operating system that runs TCP/IP, can conceivably take advantage
+   of Privoxy in a networked situation where Privoxy would run as a server on
+   a LAN gateway. Then only the "gateway" needs to be running one of the
+   above operating systems.
 
--------------------------------------------------------------------------------
+   Source code is freely available, so porting to other operating systems is
+   always a possibility.
 
-3.16. Can Privoxy run as a service on Win2K/NT/XP?
+   --------------------------------------------------------------------------
 
-Yes. Version 3.0.5 introduces full Windows service functionality. See the User
-Manual for details on how to install and configure Privoxy as a service.
+    2.3. Can I use Privoxy with my email client?
 
-Earlier 3.x versions could run as a system service using srvany.exe. See the
-discussion at http://sourceforge.net/tracker/?func=detail&atid=361118&aid=
-485617&group_id=11118, for details, and a sample configuration.
+   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 "browser"
+   or not. Though this may not be the best approach for dealing with some of
+   the common abuses of HTML in email. See How can I configure Privoxy with
+   Outlook Express? below for more on this.
 
--------------------------------------------------------------------------------
+   Be aware that HTML email presents a number of unique security and privacy
+   related issues, that can require advanced skills to overcome. The
+   developers recommend using email clients that can be configured to convert
+   HTML to plain text for these reasons.
 
-3.17. How can I make Privoxy work with other proxies like Squid or Tor?
+   --------------------------------------------------------------------------
 
-This can be done and is often useful to combine the benefits of Privoxy with
-those of a another proxy. See the forwarding chapter in the User Manual which
-describes how to do this, and the How do I use Privoxy together with Tor
-section below.
+    2.4. I just installed Privoxy. Is there anything special I have to do now?
 
--------------------------------------------------------------------------------
+   All browsers should be told to use Privoxy as a proxy by specifying the
+   correct proxy address and port number in the appropriate configuration
+   area for the browser. It's possible to combine Privoxy with a packet
+   filter to intercept HTTP requests even if the client isn't explicitly
+   configured to use Privoxy, but where possible, configuring the client is
+   recommended. See the User Manual for more details. You should also flush
+   your browser's memory and disk cache to get rid of any cached junk items,
+   and remove any stored cookies.
 
-3.18. Can I just set Privoxy to use port 80 and thus avoid individual browser
-configuration?
+   --------------------------------------------------------------------------
 
-No, its more complicated than that. This only works with special kinds of
-proxies known as "intercepting" proxies (see below).
+    2.5. What is the proxy address of Privoxy?
 
--------------------------------------------------------------------------------
+   If you set up the Privoxy to run on the computer you browse from (rather
+   than your ISP's server or some networked computer on a LAN), the proxy
+   will be on 127.0.0.1 (sometimes referred to as "localhost", which is the
+   special name used by every computer on the Internet to refer to itself)
+   and the port will be 8118 (unless you used the listen-address config
+   option to tell Privoxy to run on a different port).
 
-3.19. Can Privoxy run as a "transparent" proxy?
+   When configuring your browser's proxy settings you typically enter the
+   word "localhost" or the IP address "127.0.0.1" in the boxes next to "HTTP"
+   and "Secure" (HTTPS) and then the number "8118" for "port". This tells
+   your browser to send all web requests to Privoxy instead of directly to
+   the Internet.
 
-The whole idea of Privoxy is to modify client requests and server responses in
-all sorts of ways and therefore it's not a transparent proxy as described in
-RFC 2616.
+   Privoxy can also be used to proxy for a Local Area Network. In this case,
+   your would enter either the IP address of the LAN host where Privoxy is
+   running, or the equivalent hostname, e.g. 192.168.1.1. Port assignment
+   would be same as above. Note that Privoxy doesn't listen on any LAN
+   interfaces by default.
 
-However, some people say "transparent proxy" when they mean "intercepting
-proxy". If you are one of them, please read the next entry.
+   Privoxy does not currently handle any other protocols such as FTP, SMTP,
+   IM, IRC, ICQ, etc.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-3.20. Can Privoxy run as a "intercepting" proxy?
+    2.6. I just installed Privoxy, and nothing is happening. All the ads are
+    there. What's wrong?
+
+   Did you configure your browser to use Privoxy as a proxy? It does not
+   sound like it. See above. You might also try flushing the browser's caches
+   to force a full re-reading of pages. You can verify that Privoxy is
+   running, and your browser is correctly configured by entering the special
+   URL: http://p.p/. This should take you to a page titled "This is
+   Privoxy.." with access to Privoxy's internal configuration. If you see
+   this, then you are good to go. If you receive a page saying "Privoxy is
+   not running", then the browser is not set up to use your Privoxy
+   installation. If you receive anything else (probably nothing at all), it
+   could either be that the browser is not set up correctly, or that Privoxy
+   is not running at all. Check the log file. For instructions on starting
+   Privoxy and browser configuration, see the chapter on starting Privoxy in
+   the User Manual.
+
+   --------------------------------------------------------------------------
 
-Privoxy can't intercept traffic itself, but it can handle requests that where
-intercepted and redirected with a packet filter (like PF or iptables), as long
-as the Host header is present.
+    2.7. I get a "Privoxy is not being used" dummy page although Privoxy is
+    running and being used.
 
-As the Host header is required by HTTP/1.1 and as most web sites rely on it
-anyway, this limitation shouldn't be a problem.
+   First, make sure that Privoxy is really running and being used by visiting
+   http://p.p/. You should see the Privoxy main page. If not, see the chapter
+   on starting Privoxy in the User Manual.
 
-Please refer to your packet filter's documentation to learn how to intercept
-and redirect traffic into Privoxy. Afterward you just have to configure Privoxy
-to accept intercepted requests.
+   Now if http://p.p/ works for you, but other parts of Privoxy's web
+   interface show the dummy page, your browser has cached a redirection it
+   encountered before Privoxy 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.
 
--------------------------------------------------------------------------------
+   The procedure for clearing the cache varies from browser to browser. For
+   example, Mozilla/Netscape users would click Edit --> Preferences -->
+   Advanced --> Cache and then click both "Clear Memory Cache" and "Clear
+   Disk Cache". In some Firefox versions it's Tools --> Options --> Privacy
+   --> Cache and then click "Clear Cache Now".
 
-3.21. How can I configure Privoxy for use with Outlook Express?
+   --------------------------------------------------------------------------
 
-Outlook Express uses Internet Explorer components to both render HTML, and
-fetch any HTTP requests that may be embedded in an HTML email. So however you
-have Privoxy configured to work with IE, this configuration should
-automatically be shared.
+3. Configuration
 
--------------------------------------------------------------------------------
+    3.1. What exactly is an "actions" file?
 
-3.22. How can I have separate rules just for HTML mail?
+   Privoxy utilizes the concept of " actions" that are used to manipulate and
+   control web page data. Actions files are where these actions that Privoxy
+   could take while processing a certain request, are configured. Typically,
+   you would define a set of default actions that apply globally to all URLs,
+   then add exceptions to these defaults where needed. There is a wide array
+   of actions available that give the user a high degree of control and
+   flexibility on how to process each and every web page.
 
-The short answer is, you can't. Privoxy has no way of knowing which particular
-application makes a request, so there is no way to distinguish between web
-pages and HTML mail. Privoxy just blindly proxies all requests. In the case of
-Outlook Express (see above), OE uses IE anyway, and there is no way for Privoxy
-to ever be able to distinguish between them (nor could any other proxy type
-application for that matter).
+   Actions can be defined on a URL pattern basis, i.e. for single URLs, whole
+   web sites, groups or parts thereof etc. Actions can also be grouped
+   together and then applied to requests matching one or more patterns. There
+   are many possible actions that might apply to any given site. As an
+   example, if you are blocking cookies as one of your default actions, but
+   need to accept cookies from a given site, you would need to define an
+   exception for this site in one of your actions files, preferably in
+   user.action.
 
-For a good discussion of some of the issues involved (including privacy and
-security issues), see http://sourceforge.net/tracker/?func=detail&atid=211118&
-aid=629518&group_id=11118.
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    3.2. The "actions" concept confuses me. Please list some of these "actions".
 
-3.23. I sometimes notice cookies sneaking through. How?
+   For a comprehensive discussion of the actions concept, please refer to the
+   actions file chapter in the User Manual. It includes a list of all actions
+   and an actions file tutorial to get you started.
 
-Cookies can be set in several ways. The classic method is via the Set-Cookie
-HTTP header. This is straightforward, and an easy one to manipulate, such as
-the Privoxy concept of session-cookies-only. There is also the possibility of
-using Javascript to set cookies (Privoxy calls these content-cookies). This is
-trickier because the syntax can vary widely, and thus requires a certain amount
-of guesswork. It is not realistic to catch all of these short of disabling
-Javascript, which would break many sites. And lastly, if the cookies are
-embedded in a HTTPS/SSL secure session via Javascript, they are beyond
-Privoxy's reach.
+   --------------------------------------------------------------------------
 
-All in all, Privoxy can help manage cookies in general, can help minimize the
-loss of privacy posed by cookies, but can't realistically stop all cookies.
+    3.3. How are actions files configured? What is the easiest way to do this?
 
--------------------------------------------------------------------------------
+   Actions files are just text files in a special syntax and can be edited
+   with a text editor. But probably the easiest way is to access Privoxy's
+   user interface with your web browser at http://config.privoxy.org/
+   (Shortcut: http://p.p/) and then select "View & change the current
+   configuration" from the menu. Note that this feature must be explicitly
+   enabled in the main config file (see enable-edit-actions).
 
-3.24. Are all cookies bad? Why?
+   --------------------------------------------------------------------------
 
-No, in fact there are many beneficial uses of cookies. Cookies are just a
-method that browsers can use to store data between pages, or between browser
-sessions. Sometimes there is a good reason for this, and the user's life is a
-bit easier as a result. But there is a long history of some websites taking
-advantage of this layer of trust, and using the data they glean from you and
-your browsing habits for their own purposes, and maybe to your potential
-detriment. Such sites are using you and storing their data on your system. That
-is why the privacy conscious watch from whom those cookies come, and why they
-really need to be there.
+    3.4. There are several different "actions" files. What are the differences?
 
-See the Wikipedia cookie definition for more.
+   Three actions files are being included by the developers, to be used for
+   different purposes: These are default.action, the "main" actions file
+   which is actively maintained by the Privoxy developers and typically sets
+   the default policies, user.action, where users are encouraged to make
+   their private customizations, and standard.action, which is for internal
+   Privoxy use only. Please see the actions chapter in the User Manual for a
+   more detailed explanation.
 
--------------------------------------------------------------------------------
+   Earlier versions included three different versions of the default.action
+   file. The new scheme allows for greater flexibility of local
+   configuration, and for browser based selection of pre-defined
+   "aggressiveness" levels.
 
-3.25. How can I allow permanent cookies for my trusted sites?
+   --------------------------------------------------------------------------
 
-There are several actions that relate to cookies. The default behavior is to
-allow only "session cookies", which means the cookies only last for the current
-browser session. This eliminates most kinds of abuse related to cookies. But
-there may be cases where you want cookies to last.
+    3.5. Where can I get updated Actions Files?
 
-To disable all cookie actions, so that cookies are allowed unrestricted, both
-in and out, for example.com:
+   Based on your feedback and the continuing development, updates of
+   default.action will be made available from time to time on the files
+   section of our project page.
 
- { -crunch-incoming-cookies -crunch-outgoing-cookies -session-cookies-only -filter{content-cookies} }
-  .example.com
+   If you wish to receive an email notification whenever we release updates
+   of Privoxy or the actions file, subscribe to our announce mailing list,
+   ijbswa-announce@lists.sourceforge.net.
 
+   --------------------------------------------------------------------------
 
-Place the above in user.action. Note that some of these may be off by default
-anyway, so this might be redundant, but there is no harm being explicit in what
-you want to happen. user.action includes an alias for this situation, called
-allow-all-cookies.
+    3.6. Can I use my old config files?
 
--------------------------------------------------------------------------------
+   The syntax and purpose of configuration files has remained roughly the
+   same throughout the 3.x series, but backwards compatibility is not
+   guaranteed. Also each release contains updated, "improved" versions and it
+   is therefore strongly recommended to install the newer configuration files
+   and merge back your modifications.
 
-3.26. Can I have separate configurations for different users?
+   --------------------------------------------------------------------------
 
-Each instance of Privoxy has its own configuration, including such attributes
-as the TCP port that it listens on. What you can do is run multiple instances
-of Privoxy, each with a unique listen-address configuration setting, and
-configuration path, and then each of these can have their own configurations.
-Think of it as per-port configuration.
+    3.7. Why is the configuration so complicated?
 
-Simple enough for a few users, but for large installations, consider having
-groups of users that might share like configurations.
+   "Complicated" is in the eye of the beholder. Those that are familiar with
+   some of the underlying concepts, such as regular expression syntax, take
+   to it like a fish takes to water. Also, software that tries hard to be
+   "user friendly", often lacks sophistication and flexibility. There is
+   always that trade-off there between power vs. easy-of-use. Furthermore,
+   anyone is welcome to contribute ideas and implementations to enhance
+   Privoxy.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-3.27. Can I set-up Privoxy as a whitelist of "good" sites?
+    3.8. How can I make my Yahoo/Hotmail/Gmail account work?
 
-Sure. There are a couple of things you can do for simple white-listing. Here's
-one real easy one:
+   The default configuration shouldn't impact the usability of any of these
+   services. It may, however, make all cookies temporary, so that your
+   browser will forget your login credentials in between browser sessions. If
+   you would like not to have to log in manually each time you access those
+   websites, simply turn off all cookie handling for them in the user.action
+   file. An example for yahoo might look like:
 
- ############################################################
- # Blacklist
- ############################################################
- { +block }
- / # Block *all* URLs
+   # Allow all cookies for Yahoo login:
+   #
+   { -crunch-incoming-cookies -crunch-outgoing-cookies -session-cookies-only }
+   .login.yahoo.com
 
- ############################################################
- # Whitelist
- ############################################################
- { -block }
-  kids.example.com
-  toys.example.com
-  games.example.com
+   These kinds of sites are often quite complex and heavy with Javascript and
+   thus "fragile". So if still a problem, we have an alias just for such
+   sticky situations:
 
+   # Gmail is a _fragile_ site:
+   #
+   { fragile }
+    # Gmail is ...
+    mail.google.com
 
-This allows access to only those three sites by first blocking all URLs, and
-then subsequently allowing three specific exceptions.
+   Be sure to flush your browser's caches whenever making these kinds of
+   changes, just to make sure the changes "take".
 
-Another approach is Privoxy's trustfile concept, which incorporates the notion
-of "trusted referrers". See the Trust documentation for details.
+   Make sure the domain, host and path are appropriate as well. Your browser
+   can tell you where you are specifically and you should use that
+   information for your configuration settings. Note that above it is not
+   referenced as gmail.com, which is a valid domain name.
 
-These are fairly simple approaches and are not completely foolproof. There are
-various other configuration options that should be disabled (described
-elsewhere here and in the User Manual) so that users can't modify their own
-configuration and easily circumvent the whitelist.
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    3.9. What's the difference between the "Cautious", "Medium" and "Advanced"
+    defaults?
 
-3.28. How can I turn off ad-blocking?
+   Configuring Privoxy is not entirely trivial. To help you get started, we
+   provide you with three different default action "profiles" in the web
+   based actions file editor at http://config.privoxy.org/show-status. See
+   the User Manual for a list of actions, and how the default profiles are
+   set.
 
-Ad blocking is achieved through a complex application of various Privoxy
-actions. These actions are deployed against simple images, banners, flash
-animations, text pages, JavaScript, pop-ups and pop-unders, etc., so its not as
-simple as just turning one or two actions off. The various actions that make up
-Privoxy ad blocking are hard-coded into the default configuration files. It has
-been assumed that everyone using Privoxy is interested in this particular
-feature.
+   Where the defaults are likely to break some sites, exceptions for known
+   popular "problem" sites are included, but in general, the more aggressive
+   your default settings are, the more exceptions you will have to make
+   later. New users are best to start off in "Cautious" setting. This is
+   safest and will have the fewest problems. See the User Manual for a more
+   detailed discussion.
 
-If you want to do without this, there are several approaches you can take: You
-can manually undo the many block rules in default.action. Or even easier, just
-create your own default.action file from scratch without the many ad blocking
-rules, and corresponding exceptions. Or lastly, if you are not concerned about
-the additional blocks that are done for privacy reasons, you can very easily
-over-ride all blocking with the following very simple rule in your user.action:
+   It should be noted that the "Advanced" profile (formerly known as the
+   "Adventuresome" profile) is more aggressive, and will make use of some of
+   Privoxy's advanced features. Use at your own risk!
 
- # Unblock everybody, everywhere
- { -block }
- / # UN-Block *all* URLs
+   --------------------------------------------------------------------------
 
+    3.10. Why can I change the configuration with a browser? Does that not raise
+    security issues?
 
-Or even a more comprehensive reversing of various ad related actions:
+   It may seem strange that regular users can edit the config files with
+   their browsers, although the whole /etc/privoxy hierarchy belongs to the
+   user "privoxy", with only 644 permissions.
 
- # Unblock everybody, everywhere, and turn off appropriate filtering, etc
- { -block \
-  -filter{banners-by-size} \
-  -filter{banners-by-link} \
-  allow-popups \
- }
- / # UN-Block *all* URLs and allow ads
+   When you use the browser-based editor, Privoxy itself is writing to the
+   config files. Because Privoxy is running as the user "privoxy", it can
+   update its own config files.
 
+   If you run Privoxy for multiple untrusted users (e.g. in a LAN) or aren't
+   entirely in control of your own browser, you will probably want to make
+   sure that the the web-based editor and remote toggle features are "off" by
+   setting "enable-edit-actions 0" and "enable-remote-toggle 0" in the main
+   configuration file.
 
-This last "action" in this compound statement, allow-popups, is an alias that
-disables various pop-up blocking features.
+   As of Privoxy 3.0.7 these options are disabled by default.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-3.29. How can I have custom template pages, like the BLOCKED page?
+    3.11. What is the default.filter file? What is a "filter"?
 
-Privoxy "templates" are specialized text files utilized by Privoxy for various
-purposes and can easily be modified using any text editor. All the template
-pages are installed in a sub-directory appropriately named: templates. Knowing
-something about HTML syntax will of course be helpful.
+   The default.filter file is where filters as supplied by the developers are
+   defined. Filters are a special subset of actions that can be used to
+   modify or remove web page content or headers on the fly. Content filters
+   can be applied to anything in the page source, header filters can be
+   applied to either server or client headers. Regular expressions are used
+   to accomplish this.
+
+   There are a number of pre-defined filters to deal with common annoyances.
+   The filters are only defined here, to invoke them, you need to use the
+   filter action in one of the actions files. Content filtering is
+   automatically disabled for inappropriate MIME types, but if you now better
+   than Privoxy what should or should not be filtered you can filter any
+   content you like.
+
+   Filters should not be confused with blocks, which is a completely
+   different action, and is more typically used to block ads and unwanted
+   sites.
+
+   If you are familiar with regular expressions, and HTML, you can look at
+   the provided default.filter with a text editor and define your own
+   filters. This is potentially a very powerful feature, but requires some
+   expertise in both regular expressions and HTML/HTTP. You should place any
+   modifications to the default filters, or any new ones you create in a
+   separate file, such as user.filter, so they won't be overwritten during
+   upgrades. The ability to define multiple filter files in config is a new
+   feature as of v. 3.0.5.
+
+   There is no GUI editor option for this part of the configuration, but you
+   can disable/enable the various pre-defined filters of the included
+   default.filter file with the web-based actions file editor. Note that the
+   custom actions editor must be explicitly enabled in the main config file
+   (see enable-edit-actions).
+
+   If you intend to develop your own filters, you might want to have a look
+   at Privoxy-Filter-Test.
+
+   --------------------------------------------------------------------------
 
-Be forewarned that the default templates are subject to being overwritten
-during upgrades. You can, however, create completely new templates, place them
-in another directory and specify the alternate path in the main config. For
-details, have a look at the templdir option.
+    3.12. How can I set up Privoxy to act as a proxy for my LAN?
 
--------------------------------------------------------------------------------
+   By default, Privoxy only responds to requests from 127.0.0.1 (localhost).
+   To have it act as a server for a network, this needs to be changed in the
+   main configuration file. Look for the listen-address option, which may be
+   commented out with a "#" symbol. Make sure it is uncommented, and assign
+   it the address of the LAN gateway interface, and port number to use.
+   Assuming your LAN address is 192.168.1.1 and you wish to run Privoxy on
+   port 8118, this line should look like:
 
-3.30. How can I remove the "Go There Anyway" link from the BLOCKED page?
+     listen-address  192.168.1.1:8118
 
-There is more than one way to do it (although Perl is not involved).
+   Save the file, and restart Privoxy. Configure all browsers on the network
+   then to use this address and port number.
 
-Editing the BLOCKED template page (see above) may dissuade some users, but this
-method is easily circumvented. Where you need this level of control, you might
-want to build Privoxy from source, and disable various features that are
-available as compile-time options. You should configure the sources as follows:
+   Alternately, you can have Privoxy listen on all available interfaces:
 
- ./configure  --disable-toggle  --disable-editor  --disable-force
+     listen-address    :8118
 
+   And then use Privoxy's permit-access feature to limit connections. A
+   firewall in this situation is recommended as well.
 
-This will create an executable with hard-coded security features so that
-Privoxy does not allow easy bypassing of blocked sites, or changing the current
-configuration via any connected user's web browser.
+   The above steps should be the same for any TCP network, regardless of
+   operating system.
 
-Finally, all of these features can also be toggled on/off via options in
-Privoxy's main config file which means you don't have to recompile anything.
+   If you run Privoxy on a LAN with untrusted users, we recommend that you
+   double-check the access control and security options!
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-4. Miscellaneous
+    3.13. Instead of ads, now I get a checkerboard pattern. I don't want to see
+    anything.
+
+   The replacement for blocked images can be controlled with the
+   set-image-blocker action. You have the choice of a checkerboard pattern, a
+   transparent 1x1 GIF image (aka "blank"), or a redirect to a custom image
+   of your choice. Note that this choice only has effect for images which are
+   blocked as images, i.e. whose URLs match both a handle-as-image and block
+   action.
+
+   If you want to see nothing, then change the set-image-blocker action to
+   "blank". This can be done by editing the user.action file, or through the
+   web-based actions file editor.
+
+   --------------------------------------------------------------------------
+
+    3.14. Why would anybody want to see a checkerboard pattern?
+
+   Remember that telling which image is an ad and which isn't, is an educated
+   guess. While we hope that the standard configuration is rather smart, it
+   will make occasional mistakes. The checkerboard image is visually decent,
+   and it shows you where images have been blocked, which can be very helpful
+   in case some navigation aid or otherwise innocent image was erroneously
+   blocked. It is recommended for new users so they can "see" what is
+   happening. Some people might also enjoy seeing how many banners they don't
+   have to see.
+
+   --------------------------------------------------------------------------
+
+    3.15. I see some images being replaced with text instead of the checkerboard
+    image. Why and how do I get rid of this?
+
+   This happens when the banners are not embedded in the HTML code of the
+   page itself, but in separate HTML (sub)documents that are loaded into
+   (i)frames or (i)layers, and these external HTML documents are blocked.
+   Being non-images they get replaced by a substitute HTML page rather than a
+   substitute image, which wouldn't work out technically, since the browser
+   expects and accepts only HTML when it has requested an HTML document.
+
+   The substitute page adapts to the available space and shows itself as a
+   miniature two-liner if loaded into small frames, or full-blown with a
+   large red "BLOCKED" banner if space allows.
+
+   If you prefer the banners to be blocked by images, you must see to it that
+   the HTML documents in which they are embedded are not blocked. Clicking
+   the "See why" link offered in the substitute page will show you which rule
+   blocked the page. After changing the rule and un-blocking the HTML
+   documents, the browser will try to load the actual banner images and the
+   usual image blocking will (hopefully!) kick in.
+
+   --------------------------------------------------------------------------
+
+    3.16. Can Privoxy run as a service on Win2K/NT/XP?
+
+   Yes. Version 3.0.5 introduces full Windows service functionality. See the
+   User Manual for details on how to install and configure Privoxy as a
+   service.
+
+   Earlier 3.x versions could run as a system service using srvany.exe. See
+   the discussion at
+   http://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&group_id=11118,
+   for details, and a sample configuration.
+
+   --------------------------------------------------------------------------
+
+    3.17. How can I make Privoxy work with other proxies like Squid or Tor?
+
+   This can be done and is often useful to combine the benefits of Privoxy
+   with those of a another proxy. See the forwarding chapter in the User
+   Manual which describes how to do this, and the How do I use Privoxy
+   together with Tor section below.
+
+   --------------------------------------------------------------------------
+
+    3.18. Can I just set Privoxy to use port 80 and thus avoid individual
+    browser configuration?
+
+   No, its more complicated than that. This only works with special kinds of
+   proxies known as "intercepting" proxies (see below).
+
+   --------------------------------------------------------------------------
+
+    3.19. Can Privoxy run as a "transparent" proxy?
+
+   The whole idea of Privoxy is to modify client requests and server
+   responses in all sorts of ways and therefore it's not a transparent proxy
+   as described in RFC 2616.
+
+   However, some people say "transparent proxy" when they mean "intercepting
+   proxy". If you are one of them, please read the next entry.
+
+   --------------------------------------------------------------------------
+
+    3.20. Can Privoxy run as a "intercepting" proxy?
+
+   Privoxy can't intercept traffic itself, but it can handle requests that
+   where intercepted and redirected with a packet filter (like PF or
+   iptables), as long as the Host header is present.
+
+   As the Host header is required by HTTP/1.1 and as most web sites rely on
+   it anyway, this limitation shouldn't be a problem.
+
+   Please refer to your packet filter's documentation to learn how to
+   intercept and redirect traffic into Privoxy. Afterward you just have to
+   configure Privoxy to accept intercepted requests.
+
+   --------------------------------------------------------------------------
 
-4.1. How much does Privoxy slow my browsing down? This has to add extra time to
-browsing.
+    3.21. How can I configure Privoxy for use with Outlook Express?
 
-How much of an impact depends on many things, including the CPU of the host
-system, how aggressive the configuration is, which specific actions are being
-triggered, the size of the page, the bandwidth of the connection, etc.
+   Outlook Express uses Internet Explorer components to both render HTML, and
+   fetch any HTTP requests that may be embedded in an HTML email. So however
+   you have Privoxy configured to work with IE, this configuration should
+   automatically be shared.
 
-Overall, it should not slow you down any in real terms, and may actually help
-speed things up since ads, banners and other junk are not typically being
-retrieved and displayed. The actual processing time required by Privoxy itself
-for each page, is relatively small in the overall scheme of things, and happens
-very quickly. This is typically more than offset by time saved not downloading
-and rendering ad images and other junk content (if ad blocking is being used).
+   --------------------------------------------------------------------------
 
-"Filtering" content via the filter or deanimate-gifs actions may cause a
-perceived slowdown, since the entire document needs to be buffered before
-displaying. And on very large documents, filtering may have some measurable
-impact. How much depends on the page size, the actual definition of the filter
-(s), etc. See below. Most other actions have little to no impact on speed.
+    3.22. How can I have separate rules just for HTML mail?
 
-Also, when filtering is enabled but zlib support isn't available, compression
-is often disabled (see prevent-compression). This can have an impact on speed
-as well, although it's probably smaller than you might think. Again, the page
-size, etc. will determine how much of an impact.
+   The short answer is, you can't. Privoxy has no way of knowing which
+   particular application makes a request, so there is no way to distinguish
+   between web pages and HTML mail. Privoxy just blindly proxies all
+   requests. In the case of Outlook Express (see above), OE uses IE anyway,
+   and there is no way for Privoxy to ever be able to distinguish between
+   them (nor could any other proxy type application for that matter).
 
--------------------------------------------------------------------------------
+   For a good discussion of some of the issues involved (including privacy
+   and security issues), see
+   http://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&group_id=11118.
 
-4.2. I notice considerable delays in page requests. What's wrong?
+   --------------------------------------------------------------------------
 
-If you use any filter action, such as filtering banners by size, web-bugs etc,
-or the deanimate-gifs action, the entire document must be loaded into memory in
-order for the filtering mechanism to work, and nothing is sent to the browser
-during this time.
+    3.23. I sometimes notice cookies sneaking through. How?
 
-The loading time typically does not really change much in real numbers, but the
-feeling is different, because most browsers are able to start rendering
-incomplete content, giving the user a feeling of "it works". This effect is
-more noticeable on slower dialup connections. Extremely large documents may
-have some impact on the time to load the page where there is filtering being
-done. But overall, the difference should be very minimal. If there is a big
-impact, then probably some other situation is contributing (like anti-virus
-software).
+   Cookies can be set in several ways. The classic method is via the
+   Set-Cookie HTTP header. This is straightforward, and an easy one to
+   manipulate, such as the Privoxy concept of session-cookies-only. There is
+   also the possibility of using Javascript to set cookies (Privoxy calls
+   these content-cookies). This is trickier because the syntax can vary
+   widely, and thus requires a certain amount of guesswork. It is not
+   realistic to catch all of these short of disabling Javascript, which would
+   break many sites. And lastly, if the cookies are embedded in a HTTPS/SSL
+   secure session via Javascript, they are beyond Privoxy's reach.
 
-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. Privoxy 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.
+   All in all, Privoxy can help manage cookies in general, can help minimize
+   the loss of privacy posed by cookies, but can't realistically stop all
+   cookies.
 
--------------------------------------------------------------------------------
-
-4.3. What are "http://config.privoxy.org/" and "http://p.p/"?
-
-http://config.privoxy.org/ is the address of Privoxy's built-in user interface,
-and http://p.p/ is a shortcut for it.
+   --------------------------------------------------------------------------
 
-Since Privoxy sits between your web browser and the Internet, it can simply
-intercept requests for these addresses and answer them with its built-in "web
-server".
+    3.24. Are all cookies bad? Why?
 
-This also makes for a good test for your browser configuration: If entering the
-URL http://config.privoxy.org/ takes you to a page saying "This is Privoxy
-...", everything is OK. If you get a page saying "Privoxy is not working"
-instead, then your browser didn't use Privoxy for the request, hence it could
-not be intercepted, and you have accessed the real web site at
-config.privoxy.org.
+   No, in fact there are many beneficial uses of cookies. Cookies are just a
+   method that browsers can use to store data between pages, or between
+   browser sessions. Sometimes there is a good reason for this, and the
+   user's life is a bit easier as a result. But there is a long history of
+   some websites taking advantage of this layer of trust, and using the data
+   they glean from you and your browsing habits for their own purposes, and
+   maybe to your potential detriment. Such sites are using you and storing
+   their data on your system. That is why the privacy conscious watch from
+   whom those cookies come, and why they really need to be there.
 
--------------------------------------------------------------------------------
+   See the Wikipedia cookie definition for more.
 
-4.4. How can I submit new ads, or report problems?
+   --------------------------------------------------------------------------
 
-Please see the Contact section for various ways to interact with the
-developers.
+    3.25. How can I allow permanent cookies for my trusted sites?
 
--------------------------------------------------------------------------------
+   There are several actions that relate to cookies. The default behavior is
+   to allow only "session cookies", which means the cookies only last for the
+   current browser session. This eliminates most kinds of abuse related to
+   cookies. But there may be cases where you want cookies to last.
 
-4.5. If I do submit missed ads, will they be included in future updates?
+   To disable all cookie actions, so that cookies are allowed unrestricted,
+   both in and out, for example.com:
 
-Whether such submissions are eventually included in the default.action
-configuration file depends on how significant the issue is. We of course want
-to address any potential problem with major, high-profile sites such as Google,
-Yahoo, etc. Any site with global or regional reach, has a good chance of being
-a candidate. But at the other end of the spectrum are any number of smaller,
-low-profile sites such as for local clubs or schools. Since their reach and
-impact are much less, they are best handled by inclusion in the user's
-user.action, and thus would be unlikely to be included.
+ { -crunch-incoming-cookies -crunch-outgoing-cookies -session-cookies-only -filter{content-cookies} }
+  .example.com
 
--------------------------------------------------------------------------------
+   Place the above in user.action. Note that some of these may be off by
+   default anyway, so this might be redundant, but there is no harm being
+   explicit in what you want to happen. user.action includes an alias for
+   this situation, called allow-all-cookies.
 
-4.6. Why doesn't anyone answer my support request?
+   --------------------------------------------------------------------------
 
-Rest assured that it has been read and considered. Why it is not answered,
-could be for various reasons, including no one has a good answer for it, no one
-has had time to yet investigate it thoroughly, it has been reported numerous
-times already, or because not enough information was provided to help us help
-you. Your efforts are not wasted, and we do appreciate them.
+    3.26. Can I have separate configurations for different users?
 
--------------------------------------------------------------------------------
+   Each instance of Privoxy has its own configuration, including such
+   attributes as the TCP port that it listens on. What you can do is run
+   multiple instances of Privoxy, each with a unique listen-address
+   configuration setting, and configuration path, and then each of these can
+   have their own configurations. Think of it as per-port configuration.
 
-4.7. How can I hide my IP address?
+   Simple enough for a few users, but for large installations, consider
+   having groups of users that might share like configurations.
 
-If you run both the browser and Privoxy locally, you cannot hide your IP
-address with Privoxy or ultimately any other software alone. The server needs
-to know your IP address so that it knows where to send the responses back.
+   --------------------------------------------------------------------------
 
-There are many publicly usable "anonymous" proxies out there, which provide a
-further level of indirection between you and the web server.
+    3.27. Can I set-up Privoxy as a whitelist of "good" sites?
 
-However, these proxies are called "anonymous" because you don't need to
-authenticate, not because they would offer any real anonymity. Most of them
-will log your IP address and make it available to the authorities in case you
-violate the law of the country they run in. In fact you can't even rule out
-that some of them only exist to *collect* information on (those suspicious)
-people with a more than average preference for privacy.
+   Sure. There are a couple of things you can do for simple white-listing.
+   Here's one real easy one:
 
-If you want to hide your IP address from most adversaries, you should consider
-chaining Privoxy with Tor. The configuration details can be found in How do I
-use Privoxy together with Tor section just below.
+    ############################################################
+    # Blacklist
+    ############################################################
+    { +block }
+    / # Block *all* URLs
 
--------------------------------------------------------------------------------
+    ############################################################
+    # Whitelist
+    ############################################################
+    { -block }
+     kids.example.com
+     toys.example.com
+     games.example.com
 
-4.8. Can Privoxy guarantee I am anonymous?
+   This allows access to only those three sites by first blocking all URLs,
+   and then subsequently allowing three specific exceptions.
 
-No. Your chances of remaining anonymous are improved, but unless you chain
-Privoxy with Tor or a similar proxy and know what you're doing when it comes to
-configuring the rest of your system, you should assume that everything you do
-on the Web can be traced back to you.
+   Another approach is Privoxy's trustfile concept, which incorporates the
+   notion of "trusted referrers". See the Trust documentation for details.
 
-Privoxy can remove various information about you, and allows you more freedom
-to decide which sites you can trust, and what details you want to reveal. But
-it neither hides your IP address, nor can it guarantee that the rest of the
-system behaves correctly. There are several possibilities how a web sites can
-find out who you are, even if you are using a strict Privoxy configuration and
-chained it with Tor.
+   These are fairly simple approaches and are not completely foolproof. There
+   are various other configuration options that should be disabled (described
+   elsewhere here and in the User Manual) so that users can't modify their
+   own configuration and easily circumvent the whitelist.
 
-Most of Privoxy's privacy-enhancing features can be easily subverted by an
-insecure browser configuration, therefore you should use a browser that can be
-configured to only execute code from trusted sites, and be careful which sites
-you trust. For example there is no point in having Privoxy modify the
-User-Agent header, if websites can get all the information they want through
-JavaScript, ActiveX, Flash, Java etc.
+   --------------------------------------------------------------------------
 
-A few browsers disclose the user's email address in certain situations, such as
-when transferring a file by FTP. Privoxy does not filter FTP. If you need this
-feature, or are concerned about the mail handler of your browser disclosing
-your email address, you might consider products such as NSClean.
+    3.28. How can I turn off ad-blocking?
 
-Browsers available only as binaries could use non-standard headers to give out
-any information they can have access to: see the manufacturer's license
-agreement. It's impossible to anticipate and prevent every breach of privacy
-that might occur. The professionally paranoid prefer browsers available as
-source code, because anticipating their behavior is easier. Trust the source,
-Luke!
+   Ad blocking is achieved through a complex application of various Privoxy
+   actions. These actions are deployed against simple images, banners, flash
+   animations, text pages, JavaScript, pop-ups and pop-unders, etc., so its
+   not as simple as just turning one or two actions off. The various actions
+   that make up Privoxy ad blocking are hard-coded into the default
+   configuration files. It has been assumed that everyone using Privoxy is
+   interested in this particular feature.
+
+   If you want to do without this, there are several approaches you can take:
+   You can manually undo the many block rules in default.action. Or even
+   easier, just create your own default.action file from scratch without the
+   many ad blocking rules, and corresponding exceptions. Or lastly, if you
+   are not concerned about the additional blocks that are done for privacy
+   reasons, you can very easily over-ride all blocking with the following
+   very simple rule in your user.action:
+
+    # Unblock everybody, everywhere
+    { -block }
+    / # UN-Block *all* URLs
+
+   Or even a more comprehensive reversing of various ad related actions:
+
+    # Unblock everybody, everywhere, and turn off appropriate filtering, etc
+    { -block \
+     -filter{banners-by-size} \
+     -filter{banners-by-link} \
+     allow-popups \
+    }
+    / # UN-Block *all* URLs and allow ads
+
+   This last "action" in this compound statement, allow-popups, is an alias
+   that disables various pop-up blocking features.
+
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    3.29. How can I have custom template pages, like the BLOCKED page?
 
-4.9. A test site says I am not using a Proxy.
+   Privoxy "templates" are specialized text files utilized by Privoxy for
+   various purposes and can easily be modified using any text editor. All the
+   template pages are installed in a sub-directory appropriately named:
+   templates. Knowing something about HTML syntax will of course be helpful.
 
-Good! Actually, they are probably testing for some other kinds of proxies.
-Hiding yourself completely would require additional steps.
+   Be forewarned that the default templates are subject to being overwritten
+   during upgrades. You can, however, create completely new templates, place
+   them in another directory and specify the alternate path in the main
+   config. For details, have a look at the templdir option.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-4.10. How do I use Privoxy together with Tor?
+    3.30. How can I remove the "Go There Anyway" link from the BLOCKED page?
 
-Before you configure Privoxy to use Tor, please follow the User Manual chapters
-2. Installation and 5. Startup to make sure Privoxy itself is setup correctly.
+   There is more than one way to do it (although Perl is not involved).
 
-If it is, refer to Tor's extensive documentation to learn how to install Tor,
-and make sure Tor's logfile says that "Tor has successfully opened a circuit"
-and it "looks like client functionality is working".
+   Editing the BLOCKED template page (see above) may dissuade some users, but
+   this method is easily circumvented. Where you need this level of control,
+   you might want to build Privoxy from source, and disable various features
+   that are available as compile-time options. You should configure the
+   sources as follows:
 
-If either Tor or Privoxy isn't working, their combination most likely will
-neither. Testing them on their own will also help you to direct problem reports
-to the right audience. If Privoxy isn't working, don't bother the Tor
-developers. If Tor isn't working, don't send bug reports to the Privoxy Team.
+    ./configure  --disable-toggle  --disable-editor  --disable-force
 
-If you verified that Privoxy and Tor are working, it is time to connect them.
-As far as Privoxy is concerned, Tor is just another proxy that can be reached
-by socks4 or socks4a. Most likely you are interested in Tor to increase your
-anonymity level, therefore you should use socks4a, to make sure DNS requests
-are done through Tor and thus invisible to your local network.
+   This will create an executable with hard-coded security features so that
+   Privoxy does not allow easy bypassing of blocked sites, or changing the
+   current configuration via any connected user's web browser.
 
-Since Privoxy 3.0.5, its main configuration file is already prepared for Tor,
-if you are using a default Tor configuration and run it on the same system as
-Privoxy, you just have to edit the forwarding section and uncomment the line:
+   Finally, all of these features can also be toggled on/off via options in
+   Privoxy's main config file which means you don't have to recompile
+   anything.
 
-#        forward-socks4a             /     127.0.0.1:9050 .
+   --------------------------------------------------------------------------
 
+4. Miscellaneous
 
+    4.1. How much does Privoxy slow my browsing down? This has to add extra time
+    to browsing.
 
-This is enough to reach the Internet, but additionally you might want to
-uncomment the following forward rules, to make sure your local network is still
-reachable through Privoxy:
+   How much of an impact depends on many things, including the CPU of the
+   host system, how aggressive the configuration is, which specific actions
+   are being triggered, the size of the page, the bandwidth of the
+   connection, etc.
 
-#        forward         192.168.*.*/     .
-#        forward            10.*.*.*/     .
-#        forward           127.*.*.*/     .
+   Overall, it should not slow you down any in real terms, and may actually
+   help speed things up since ads, banners and other junk are not typically
+   being retrieved and displayed. The actual processing time required by
+   Privoxy itself for each page, is relatively small in the overall scheme of
+   things, and happens very quickly. This is typically more than offset by
+   time saved not downloading and rendering ad images and other junk content
+   (if ad blocking is being used).
 
+   "Filtering" content via the filter or deanimate-gifs actions may cause a
+   perceived slowdown, since the entire document needs to be buffered before
+   displaying. And on very large documents, filtering may have some
+   measurable impact. How much depends on the page size, the actual
+   definition of the filter(s), etc. See below. Most other actions have
+   little to no impact on speed.
 
+   Also, when filtering is enabled but zlib support isn't available,
+   compression is often disabled (see prevent-compression). This can have an
+   impact on speed as well, although it's probably smaller than you might
+   think. Again, the page size, etc. will determine how much of an impact.
 
-Unencrypted connections to systems in these address ranges will be as (un)
-secure as the local network is, but the alternative is that your browser can't
-reach the network at all. Then again, that may actually be desired and if you
-don't know for sure that your browser has to be able to reach the local
-network, there's no reason to allow it.
+   --------------------------------------------------------------------------
 
-If you want your browser to be able to reach servers in your local network by
-using their names, you will need additional exceptions that look like this:
+    4.2. I notice considerable delays in page requests. What's wrong?
 
-#        forward           localhost/     .
+   If you use any filter action, such as filtering banners by size, web-bugs
+   etc, or the deanimate-gifs action, the entire document must be loaded into
+   memory in order for the filtering mechanism to work, and nothing is sent
+   to the browser during this time.
 
+   The loading time typically does not really change much in real numbers,
+   but the feeling is different, because most browsers are able to start
+   rendering incomplete content, giving the user a feeling of "it works".
+   This effect is more noticeable on slower dialup connections. Extremely
+   large documents may have some impact on the time to load the page where
+   there is filtering being done. But overall, the difference should be very
+   minimal. If there is a big impact, then probably some other situation is
+   contributing (like anti-virus software).
 
+   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. Privoxy 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.
 
-Save the modified configuration file and open http://config.privoxy.org/
-show-status/ in your browser, confirm that Privoxy has reloaded its
-configuration and that there are no other forward lines, unless you know that
-you need them. If everything looks good, refer to Tor Faq 4.2 to learn how to
-verify that you are really using Tor.
+   --------------------------------------------------------------------------
 
-Afterward, please take the time to at least skim through the rest of Tor's
-documentation. Make sure you understand what Tor does, why it is no replacement
-for application level security, and why you probably don't want to use it for
-unencrypted logins.
+    4.3. What are "http://config.privoxy.org/" and "http://p.p/"?
 
--------------------------------------------------------------------------------
+   http://config.privoxy.org/ is the address of Privoxy's built-in user
+   interface, and http://p.p/ is a shortcut for it.
 
-4.11. Might some things break because header information or content is being
-altered?
+   Since Privoxy sits between your web browser and the Internet, it can
+   simply intercept requests for these addresses and answer them with its
+   built-in "web server".
 
-Definitely. It is common for sites to use browser type, browser version, HTTP
-header content, and various other techniques in order to dynamically decide
-what to display and how to display it. What you see, and what I see, might be
-very different. There are many, many ways that this can be handled, so having
-hard and fast rules, is tricky.
+   This also makes for a good test for your browser configuration: If
+   entering the URL http://config.privoxy.org/ takes you to a page saying
+   "This is Privoxy ...", everything is OK. If you get a page saying "Privoxy
+   is not working" instead, then your browser didn't use Privoxy for the
+   request, hence it could not be intercepted, and you have accessed the real
+   web site at config.privoxy.org.
 
-The "User-Agent" is sometimes used in this way to identify the browser, and
-adjust content accordingly.
+   --------------------------------------------------------------------------
 
-Also, different browsers use different encodings of non-English characters,
-certain web servers convert pages on-the-fly according to the User Agent
-header. Giving a "User Agent" with the wrong operating system or browser
-manufacturer causes some sites in these languages to be garbled; Surfers to
-Eastern European sites should change it to something closer. And then some page
-access counters work by looking at the "Referer" header; they may fail or break
-if unavailable. The weather maps of Intellicast have been blocked by their
-server when no "Referer" or cookie is provided, is another example. (But you
-can forge both headers without giving information away). There are many other
-ways things can go wrong when trying to fool a web server. The results of which
-could inadvertently cause pages to load incorrectly, partially, or even not at
-all. And there may be no obvious clues as to just what went wrong, or why.
-Nowhere will there be a message that says "Turn off fast-redirects or else! "
+    4.4. How can I submit new ads, or report problems?
 
-Similar thoughts apply to modifying JavaScript, and, to a lesser degree, HTML
-elements.
+   Please see the Contact section for various ways to interact with the
+   developers.
 
-If you have problems with a site, you will have to adjust your configuration
-accordingly. Cookies are probably the most likely adjustment that may be
-required, but by no means the only one.
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    4.5. If I do submit missed ads, will they be included in future updates?
 
-4.12. Can Privoxy act as a "caching" proxy to speed up web browsing?
+   Whether such submissions are eventually included in the default.action
+   configuration file depends on how significant the issue is. We of course
+   want to address any potential problem with major, high-profile sites such
+   as Google, Yahoo, etc. Any site with global or regional reach, has a good
+   chance of being a candidate. But at the other end of the spectrum are any
+   number of smaller, low-profile sites such as for local clubs or schools.
+   Since their reach and impact are much less, they are best handled by
+   inclusion in the user's user.action, and thus would be unlikely to be
+   included.
 
-No, it does not have this ability at all. You want something like Squid or
-Polipo for this. And, yes, before you ask, Privoxy can co-exist with other
-kinds of proxies like Squid. See the forwarding chapter in the user manual for
-details.
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    4.6. Why doesn't anyone answer my support request?
 
-4.13. What about as a firewall? Can Privoxy protect me?
+   Rest assured that it has been read and considered. Why it is not answered,
+   could be for various reasons, including no one has a good answer for it,
+   no one has had time to yet investigate it thoroughly, it has been reported
+   numerous times already, or because not enough information was provided to
+   help us help you. Your efforts are not wasted, and we do appreciate them.
 
-Not in the way you mean, or in the way some firewall vendors claim they can.
-Privoxy can help protect your privacy, but can't protect your system from
-intrusion attempts. It is, of course, perfectly possible to use both.
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    4.7. How can I hide my IP address?
 
-4.14. I have large empty spaces / a checkerboard pattern now where ads used to
-be. Why?
+   If you run both the browser and Privoxy locally, you cannot hide your IP
+   address with Privoxy or ultimately any other software alone. The server
+   needs to know your IP address so that it knows where to send the responses
+   back.
 
-It is technically possible to eliminate banners and ads in a way that frees
-their allocated page space. This could easily be done by blocking with
-Privoxy's filters, and eliminating the entire image references from the HTML
-page source.
+   There are many publicly usable "anonymous" proxies out there, which
+   provide a further level of indirection between you and the web server.
 
-But, this would consume considerably more CPU resources (IOW, slow things
-down), would likely destroy the layout of some web pages which rely on the
-banners utilizing a certain amount of page space, and might fail in other
-cases, where the screen space is reserved (e.g. by HTML tables for instance).
-Also, making ads and banners disappear without any trace complicates
-troubleshooting, and would sooner or later be problematic.
+   However, these proxies are called "anonymous" because you don't need to
+   authenticate, not because they would offer any real anonymity. Most of
+   them will log your IP address and make it available to the authorities in
+   case you violate the law of the country they run in. In fact you can't
+   even rule out that some of them only exist to *collect* information on
+   (those suspicious) people with a more than average preference for privacy.
 
-The better alternative is to instead let them stay, and block the resulting
-requests for the banners themselves as is now the case. This leaves either
-empty space, or the familiar checkerboard pattern.
+   If you want to hide your IP address from most adversaries, you should
+   consider chaining Privoxy with Tor. The configuration details can be found
+   in How do I use Privoxy together with Tor section just below.
 
-So the developers won't support this in the default configuration, but you can
-of course define appropriate filters yourself to achieve this.
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    4.8. Can Privoxy guarantee I am anonymous?
 
-4.15. How can Privoxy filter Secure (HTTPS) URLs?
+   No. Your chances of remaining anonymous are improved, but unless you chain
+   Privoxy with Tor or a similar proxy and know what you're doing when it
+   comes to configuring the rest of your system, you should assume that
+   everything you do on the Web can be traced back to you.
+
+   Privoxy can remove various information about you, and allows you more
+   freedom to decide which sites you can trust, and what details you want to
+   reveal. But it neither hides your IP address, nor can it guarantee that
+   the rest of the system behaves correctly. There are several possibilities
+   how a web sites can find out who you are, even if you are using a strict
+   Privoxy configuration and chained it with Tor.
+
+   Most of Privoxy's privacy-enhancing features can be easily subverted by an
+   insecure browser configuration, therefore you should use a browser that
+   can be configured to only execute code from trusted sites, and be careful
+   which sites you trust. For example there is no point in having Privoxy
+   modify the User-Agent header, if websites can get all the information they
+   want through JavaScript, ActiveX, Flash, Java etc.
+
+   A few browsers disclose the user's email address in certain situations,
+   such as when transferring a file by FTP. Privoxy does not filter FTP. If
+   you need this feature, or are concerned about the mail handler of your
+   browser disclosing your email address, you might consider products such as
+   NSClean.
+
+   Browsers available only as binaries could use non-standard headers to give
+   out any information they can have access to: see the manufacturer's
+   license agreement. It's impossible to anticipate and prevent every breach
+   of privacy that might occur. The professionally paranoid prefer browsers
+   available as source code, because anticipating their behavior is easier.
+   Trust the source, Luke!
+
+   --------------------------------------------------------------------------
 
-Since secure HTTP connections are encrypted SSL sessions between your browser
-and the secure site, and are meant to be reliably secure, there is little that
-Privoxy can do but hand the raw gibberish data though from one end to the other
-unprocessed.
+    4.9. A test site says I am not using a Proxy.
 
-The only exception to this is blocking by host patterns, as the client needs to
-tell Privoxy the name of the remote server, so that Privoxy can establish the
-connection. If that name matches a host-only pattern, the connection will be
-blocked.
+   Good! Actually, they are probably testing for some other kinds of proxies.
+   Hiding yourself completely would require additional steps.
 
-As far as ad blocking is concerned, this is less of a restriction than it may
-seem, since ad sources are often identifiable by the host name, and often the
-banners to be placed in an encrypted page come unencrypted nonetheless for
-efficiency reasons, which exposes them to the full power of Privoxy's ad
-blocking.
+   --------------------------------------------------------------------------
 
-"Content cookies" (those that are embedded in the actual HTML or JS page
-content, see filter{content-cookies}), in an SSL transaction will be impossible
-to block under these conditions. Fortunately, this does not seem to be a very
-common scenario since most cookies come by traditional means.
+    4.10. How do I use Privoxy together with Tor?
 
--------------------------------------------------------------------------------
+   Before you configure Privoxy to use Tor, please follow the User Manual
+   chapters 2. Installation and 5. Startup to make sure Privoxy itself is
+   setup correctly.
 
-4.16. Privoxy runs as a "server". How secure is it? Do I need to take any
-special precautions?
-
-On Unix-like systems, Privoxy can run as a non-privileged user, which is how we
-recommend it be run. Also, by default Privoxy listens to requests from
-"localhost" only.
+   If it is, refer to Tor's extensive documentation to learn how to install
+   Tor, and make sure Tor's logfile says that "Tor has successfully opened a
+   circuit" and it "looks like client functionality is working".
 
-The server aspect of Privoxy is not itself directly exposed to the Internet in
-this configuration. If you want to have Privoxy serve as a LAN proxy, this will
-have to be opened up to allow for LAN requests. In this case, we'd recommend
-you specify only the LAN gateway address, e.g. 192.168.1.1, in the main Privoxy
-configuration file and check all access control and security options. All LAN
-hosts can then use this as their proxy address in the browser proxy
-configuration, but Privoxy will not listen on any external interfaces. ACLs can
-be defined in addition, and using a firewall is always good too. Better safe
-than sorry.
+   If either Tor or Privoxy isn't working, their combination most likely will
+   neither. Testing them on their own will also help you to direct problem
+   reports to the right audience. If Privoxy isn't working, don't bother the
+   Tor developers. If Tor isn't working, don't send bug reports to the
+   Privoxy Team.
 
--------------------------------------------------------------------------------
+   If you verified that Privoxy and Tor are working, it is time to connect
+   them. As far as Privoxy is concerned, Tor is just another proxy that can
+   be reached by socks4 or socks4a. Most likely you are interested in Tor to
+   increase your anonymity level, therefore you should use socks4a, to make
+   sure DNS requests are done through Tor and thus invisible to your local
+   network.
 
-4.17. Can I temporarily disable Privoxy?
+   Since Privoxy 3.0.5, its main configuration file is already prepared for
+   Tor, if you are using a default Tor configuration and run it on the same
+   system as Privoxy, you just have to edit the forwarding section and
+   uncomment the line:
 
-Privoxy doesn't have a transparent proxy mode, but you can toggle off blocking
-and content filtering.
+   #        forward-socks4a             /     127.0.0.1:9050 .
 
-The easiest way to do that is to point your browser to the remote toggle URL:
-http://config.privoxy.org/toggle.
 
-See the Bookmarklets section of the User Manual for an easy way to access this
-feature. Note that this is a feature that may need to be enabled in the main
-config file.
+   This is enough to reach the Internet, but additionally you might want to
+   uncomment the following forward rules, to make sure your local network is
+   still reachable through Privoxy:
 
--------------------------------------------------------------------------------
+   #        forward         192.168.*.*/     .
+   #        forward            10.*.*.*/     .
+   #        forward           127.*.*.*/     .
 
-4.18. When "disabled" is Privoxy totally out of the picture?
 
-No, this just means all optional filtering and actions are disabled. Privoxy is
-still acting as a proxy, but just doing less of the things that Privoxy would
-normally be expected to do. It is still a "middle-man" in the interaction
-between your browser and web sites. See below to bypass the proxy.
+   Unencrypted connections to systems in these address ranges will be as
+   (un)secure as the local network is, but the alternative is that your
+   browser can't reach the network at all. Then again, that may actually be
+   desired and if you don't know for sure that your browser has to be able to
+   reach the local network, there's no reason to allow it.
 
--------------------------------------------------------------------------------
+   If you want your browser to be able to reach servers in your local network
+   by using their names, you will need additional exceptions that look like
+   this:
 
-4.19. How can I tell Privoxy to totally ignore certain sites?
+   #        forward           localhost/     .
 
-Bypassing a proxy, or proxying based on arbitrary criteria, is purely a browser
-configuration issue, not a Privoxy issue. Modern browsers typically do have
-settings for not proxying certain sites. Check your browser's help files.
 
--------------------------------------------------------------------------------
+   Save the modified configuration file and open
+   http://config.privoxy.org/show-status/ in your browser, confirm that
+   Privoxy has reloaded its configuration and that there are no other forward
+   lines, unless you know that you need them. If everything looks good, refer
+   to Tor Faq 4.2 to learn how to verify that you are really using Tor.
 
-4.20. My logs show Privoxy "crunches" ads, but also its own internal CGI pages.
-What is a "crunch"?
+   Afterward, please take the time to at least skim through the rest of Tor's
+   documentation. Make sure you understand what Tor does, why it is no
+   replacement for application level security, and why you probably don't
+   want to use it for unencrypted logins.
 
-A "crunch" simply means Privoxy intercepted something, nothing more. Often this
-is indeed ads or banners, but Privoxy uses the same mechanism for trapping
-requests for its own internal pages. For instance, a request for Privoxy's
-configuration page at: http://config.privoxy.org, is intercepted (i.e. it does
-not go out to the 'net), and the familiar CGI configuration is returned to the
-browser, and the log consequently will show a "crunch".
+   --------------------------------------------------------------------------
 
-Since version 3.0.7, Privoxy will also log the crunch reason. If you are using
-an older version you might want to upgrade.
+    4.11. Might some things break because header information or content is being
+    altered?
 
--------------------------------------------------------------------------------
+   Definitely. It is common for sites to use browser type, browser version,
+   HTTP header content, and various other techniques in order to dynamically
+   decide what to display and how to display it. What you see, and what I
+   see, might be very different. There are many, many ways that this can be
+   handled, so having hard and fast rules, is tricky.
 
-4.21. Can Privoxy effect files that I download from a webserver? FTP server?
+   The "User-Agent" is sometimes used in this way to identify the browser,
+   and adjust content accordingly.
 
-From the webserver's perspective, there is no difference between viewing a
-document (i.e. a page), and downloading a file. The same is true of Privoxy. If
-there is a match for a block pattern, it will still be blocked, and of course
-this is obvious.
+   Also, different browsers use different encodings of non-English
+   characters, certain web servers convert pages on-the-fly according to the
+   User Agent header. Giving a "User Agent" with the wrong operating system
+   or browser manufacturer causes some sites in these languages to be
+   garbled; Surfers to Eastern European sites should change it to something
+   closer. And then some page access counters work by looking at the
+   "Referer" header; they may fail or break if unavailable. The weather maps
+   of Intellicast have been blocked by their server when no "Referer" or
+   cookie is provided, is another example. (But you can forge both headers
+   without giving information away). There are many other ways things can go
+   wrong when trying to fool a web server. The results of which could
+   inadvertently cause pages to load incorrectly, partially, or even not at
+   all. And there may be no obvious clues as to just what went wrong, or why.
+   Nowhere will there be a message that says "Turn off fast-redirects or
+   else! "
 
-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
-advertisement, or Mr. Jimmy's latest/greatest source code jewel. Of course, one
-of these presumably is "bad" content that we don't want, and the other is
-"good" content that we do want. Privoxy is blind to the differences, and can
-only distinguish "good from bad" by the configuration parameters we give it.
+   Similar thoughts apply to modifying JavaScript, and, to a lesser degree,
+   HTML elements.
 
-Privoxy knows the differences in files according to the "Content Type" as
-reported by the webserver. If this is reported accurately (e.g. "application/
-zip" for a zip archive), then Privoxy knows to ignore these where appropriate.
-Privoxy 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 "text/plain") 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.
+   If you have problems with a site, you will have to adjust your
+   configuration accordingly. Cookies are probably the most likely adjustment
+   that may be required, but by no means the only one.
 
-Note that versions later than 3.0.2 do NOT filter document types reported as
-"text/plain". Prior to this, Privoxy did filter this document type.
+   --------------------------------------------------------------------------
+
+    4.12. Can Privoxy act as a "caching" proxy to speed up web browsing?
+
+   No, it does not have this ability at all. You want something like Squid or
+   Polipo for this. And, yes, before you ask, Privoxy can co-exist with other
+   kinds of proxies like Squid. See the forwarding chapter in the user manual
+   for details.
+
+   --------------------------------------------------------------------------
+
+    4.13. What about as a firewall? Can Privoxy protect me?
 
-In short, filtering is "ON" if a) the content type as reported by the webserver
-is appropriate and 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
-"good" and this is "bad". It's the configuration that lets it all happen or
-not.
+   Not in the way you mean, or in the way some firewall vendors claim they
+   can. Privoxy can help protect your privacy, but can't protect your system
+   from intrusion attempts. It is, of course, perfectly possible to use both.
 
-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 user.action file. And also, for any site or page
-where making any changes at all to the content is to be avoided.
+   --------------------------------------------------------------------------
 
-Privoxy does not do FTP at all, only HTTP and HTTPS (SSL) protocols, so please
-don't try.
+    4.14. I have large empty spaces / a checkerboard pattern now where ads used
+    to be. Why?
 
--------------------------------------------------------------------------------
+   It is technically possible to eliminate banners and ads in a way that
+   frees their allocated page space. This could easily be done by blocking
+   with Privoxy's filters, and eliminating the entire image references from
+   the HTML page source.
 
-4.22. I just downloaded a Perl script, and Privoxy altered it! Yikes, what is
-wrong!
+   But, this would consume considerably more CPU resources (IOW, slow things
+   down), would likely destroy the layout of some web pages which rely on the
+   banners utilizing a certain amount of page space, and might fail in other
+   cases, where the screen space is reserved (e.g. by HTML tables for
+   instance). Also, making ads and banners disappear without any trace
+   complicates troubleshooting, and would sooner or later be problematic.
 
-Please read above.
+   The better alternative is to instead let them stay, and block the
+   resulting requests for the banners themselves as is now the case. This
+   leaves either empty space, or the familiar checkerboard pattern.
 
--------------------------------------------------------------------------------
+   So the developers won't support this in the default configuration, but you
+   can of course define appropriate filters yourself to achieve this.
 
-4.23. Should I continue to use a "HOSTS" file for ad-blocking?
+   --------------------------------------------------------------------------
 
-One time-tested technique to defeat common ads is to trick the local DNS system
-by giving a phony IP address for the ad generator in the local HOSTS file,
-typically using 127.0.0.1, aka localhost. This effectively blocks the ad.
+    4.15. How can Privoxy filter Secure (HTTPS) URLs?
 
-There is no reason to use this technique in conjunction with Privoxy. Privoxy
-does essentially the same thing, much more elegantly and with much more
-flexibility. A large HOSTS file, in fact, not only duplicates effort, but may
-get in the way and seriously slow down your system. It is recommended to remove
-such entries from your HOSTS file. If you think your hosts list is neglected by
-Privoxy's configuration, consider adding your list to your user.action file:
+   Since secure HTTP connections are encrypted SSL sessions between your
+   browser and the secure site, and are meant to be reliably secure, there is
+   little that Privoxy can do but hand the raw gibberish data though from one
+   end to the other unprocessed.
 
-  { +block }
-   www.ad.example1.com
-   ad.example2.com
-   ads.galore.example.com
-   etc.example.com
+   The only exception to this is blocking by host patterns, as the client
+   needs to tell Privoxy the name of the remote server, so that Privoxy can
+   establish the connection. If that name matches a host-only pattern, the
+   connection will be blocked.
 
+   As far as ad blocking is concerned, this is less of a restriction than it
+   may seem, since ad sources are often identifiable by the host name, and
+   often the banners to be placed in an encrypted page come unencrypted
+   nonetheless for efficiency reasons, which exposes them to the full power
+   of Privoxy's ad blocking.
 
--------------------------------------------------------------------------------
+   "Content cookies" (those that are embedded in the actual HTML or JS page
+   content, see filter{content-cookies}), in an SSL transaction will be
+   impossible to block under these conditions. Fortunately, this does not
+   seem to be a very common scenario since most cookies come by traditional
+   means.
 
-4.24. Where can I find more information about Privoxy and related issues?
+   --------------------------------------------------------------------------
 
-Other references and sites of interest to Privoxy users:
+    4.16. Privoxy runs as a "server". How secure is it? Do I need to take any
+    special precautions?
 
-http://www.privoxy.org/, the Privoxy Home page.
+   On Unix-like systems, Privoxy can run as a non-privileged user, which is
+   how we recommend it be run. Also, by default Privoxy listens to requests
+   from "localhost" only.
 
-http://www.privoxy.org/faq/, the Privoxy FAQ.
+   The server aspect of Privoxy is not itself directly exposed to the
+   Internet in this configuration. If you want to have Privoxy serve as a LAN
+   proxy, this will have to be opened up to allow for LAN requests. In this
+   case, we'd recommend you specify only the LAN gateway address, e.g.
+   192.168.1.1, in the main Privoxy configuration file and check all access
+   control and security options. All LAN hosts can then use this as their
+   proxy address in the browser proxy configuration, but Privoxy will not
+   listen on any external interfaces. ACLs can be defined in addition, and
+   using a firewall is always good too. Better safe than sorry.
 
-http://sourceforge.net/projects/ijbswa/, the Project Page for Privoxy on
-SourceForge.
+   --------------------------------------------------------------------------
 
-http://config.privoxy.org/, the web-based user interface. Privoxy must be
-running for this to work. Shortcut: http://p.p/
+    4.17. Can I temporarily disable Privoxy?
 
-http://sourceforge.net/tracker/?group_id=11118&atid=460288, to submit "misses"
-and other configuration related suggestions to the developers.
+   Privoxy doesn't have a transparent proxy mode, but you can toggle off
+   blocking and content filtering.
 
-http://www.junkbusters.com/ht/en/cookies.html, an explanation how cookies are
-used to track web users.
+   The easiest way to do that is to point your browser to the remote toggle
+   URL: http://config.privoxy.org/toggle.
 
-http://www.junkbusters.com/ijb.html, the original Internet Junkbuster.
+   See the Bookmarklets section of the User Manual for an easy way to access
+   this feature. Note that this is a feature that may need to be enabled in
+   the main config file.
 
-http://privacy.net/, a useful site to check what information about you is
-leaked while you browse the web.
+   --------------------------------------------------------------------------
 
-http://www.squid-cache.org/, a popular caching proxy, which is often used
-together with Privoxy.
+    4.18. When "disabled" is Privoxy totally out of the picture?
 
-http://www.pps.jussieu.fr/~jch/software/polipo/, Polipo is a caching proxy with
-advanced features like pipelining, multiplexing and caching of partial
-instances. In many setups it can be used as Squid replacement.
+   No, this just means all optional filtering and actions are disabled.
+   Privoxy is still acting as a proxy, but just doing less of the things that
+   Privoxy would normally be expected to do. It is still a "middle-man" in
+   the interaction between your browser and web sites. See below to bypass
+   the proxy.
 
-http://tor.eff.org/, Tor can help anonymize web browsing, web publishing,
-instant messaging, IRC, SSH, and other applications.
+   --------------------------------------------------------------------------
 
-http://www.privoxy.org/developer-manual/, the Privoxy developer manual.
+    4.19. How can I tell Privoxy to totally ignore certain sites?
 
--------------------------------------------------------------------------------
+   Bypassing a proxy, or proxying based on arbitrary criteria, is purely a
+   browser configuration issue, not a Privoxy issue. Modern browsers
+   typically do have settings for not proxying certain sites. Check your
+   browser's help files.
 
-4.25. I've noticed that Privoxy changes "Microsoft" to "MicroSuck"! Why are you
-manipulating my browsing?
+   --------------------------------------------------------------------------
 
-We're not. The text substitutions that you are seeing are disabled in the
-default configuration as shipped. You have either manually activated the "fun"
-filter which is clearly labeled "Text replacements for subversive browsing fun!
-" or you are using an older Privoxy version and have implicitly activated it by
-choosing the "Adventuresome" profile in the web-based editor. Please upgrade.
+    4.20. My logs show Privoxy "crunches" ads, but also its own internal CGI
+    pages. What is a "crunch"?
+
+   A "crunch" simply means Privoxy intercepted something, nothing more. Often
+   this is indeed ads or banners, but Privoxy uses the same mechanism for
+   trapping requests for its own internal pages. For instance, a request for
+   Privoxy's configuration page at: http://config.privoxy.org, is intercepted
+   (i.e. it does not go out to the 'net), and the familiar CGI configuration
+   is returned to the browser, and the log consequently will show a "crunch".
+
+   Since version 3.0.7, Privoxy will also log the crunch reason. If you are
+   using an older version you might want to upgrade.
+
+   --------------------------------------------------------------------------
+
+    4.21. Can Privoxy effect files that I download from a webserver? FTP server?
+
+   From the webserver's perspective, there is no difference between viewing a
+   document (i.e. a page), and downloading a file. The same is true of
+   Privoxy. If there is a match for a block 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, and the effects of filtering are there whether the file
+   is simply viewed, or downloaded. And potentially whether the content is
+   some obnoxious advertisement, or Mr. Jimmy's latest/greatest source code
+   jewel. Of course, one of these presumably is "bad" content that we don't
+   want, and the other is "good" content that we do want. Privoxy is blind to
+   the differences, and can only distinguish "good from bad" by the
+   configuration parameters we give it.
+
+   Privoxy knows the differences in files according to the "Content Type" as
+   reported by the webserver. If this is reported accurately (e.g.
+   "application/zip" for a zip archive), then Privoxy knows to ignore these
+   where appropriate. Privoxy 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
+   "text/plain") 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.
+
+   Note that versions later than 3.0.2 do NOT filter document types reported
+   as "text/plain". Prior to this, Privoxy did filter this document type.
+
+   In short, filtering is "ON" if a) the content type as reported by the
+   webserver is appropriate and 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 "good" and this is "bad". It's the configuration that lets it all
+   happen or not.
+
+   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 user.action file. And
+   also, for any site or page where making any changes at all to the content
+   is to be avoided.
+
+   Privoxy does not do FTP at all, only HTTP and HTTPS (SSL) protocols, so
+   please don't try.
+
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    4.22. I just downloaded a Perl script, and Privoxy altered it! Yikes, what
+    is wrong!
 
-4.26. Does Privoxy produce "valid" HTML (or XHTML)?
+   Please read above.
 
-Privoxy generates HTML in both its own "templates", and possibly whenever there
-are text substitutions via a Privoxy filter. While this should always conform
-to the HTML 4.01 specifications, it has not been validated against this or any
-other standard.
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    4.23. Should I continue to use a "HOSTS" file for ad-blocking?
+
+   One time-tested technique to defeat common ads is to trick the local DNS
+   system by giving a phony IP address for the ad generator in the local
+   HOSTS file, typically using 127.0.0.1, aka localhost. This effectively
+   blocks the ad.
+
+   There is no reason to use this technique in conjunction with Privoxy.
+   Privoxy does essentially the same thing, much more elegantly and with much
+   more flexibility. A large HOSTS file, in fact, not only duplicates effort,
+   but may get in the way and seriously slow down your system. It is
+   recommended to remove such entries from your HOSTS file. If you think your
+   hosts list is neglected by Privoxy's configuration, consider adding your
+   list to your user.action file:
+
+     { +block }
+      www.ad.example1.com
+      ad.example2.com
+      ads.galore.example.com
+      etc.example.com
+
+   --------------------------------------------------------------------------
+
+    4.24. Where can I find more information about Privoxy and related issues?
+
+   Other references and sites of interest to Privoxy users:
+
+   http://www.privoxy.org/, the Privoxy Home page.
+
+   http://www.privoxy.org/faq/, the Privoxy FAQ.
+
+   http://sourceforge.net/projects/ijbswa/, the Project Page for Privoxy on
+   SourceForge.
+
+   http://config.privoxy.org/, the web-based user interface. Privoxy must be
+   running for this to work. Shortcut: http://p.p/
+
+   http://sourceforge.net/tracker/?group_id=11118&atid=460288, to submit
+   "misses" and other configuration related suggestions to the developers.
+
+   http://www.junkbusters.com/ht/en/cookies.html, an explanation how cookies
+   are used to track web users.
+
+   http://www.junkbusters.com/ijb.html, the original Internet Junkbuster.
+
+   http://privacy.net/, a useful site to check what information about you is
+   leaked while you browse the web.
+
+   http://www.squid-cache.org/, a popular caching proxy, which is often used
+   together with Privoxy.
+
+   http://www.pps.jussieu.fr/~jch/software/polipo/, Polipo is a caching proxy
+   with advanced features like pipelining, multiplexing and caching of
+   partial instances. In many setups it can be used as Squid replacement.
+
+   http://tor.eff.org/, Tor can help anonymize web browsing, web publishing,
+   instant messaging, IRC, SSH, and other applications.
+
+   http://www.privoxy.org/developer-manual/, the Privoxy developer manual.
+
+   --------------------------------------------------------------------------
+
+    4.25. I've noticed that Privoxy changes "Microsoft" to "MicroSuck"! Why are
+    you manipulating my browsing?
+
+   We're not. The text substitutions that you are seeing are disabled in the
+   default configuration as shipped. You have either manually activated the
+   "fun" filter which is clearly labeled "Text replacements for subversive
+   browsing fun!" or you are using an older Privoxy version and have
+   implicitly activated it by choosing the "Adventuresome" profile in the
+   web-based editor. Please upgrade.
+
+   --------------------------------------------------------------------------
+
+    4.26. Does Privoxy produce "valid" HTML (or XHTML)?
+
+   Privoxy generates HTML in both its own "templates", and possibly whenever
+   there are text substitutions via a Privoxy filter. While this should
+   always conform to the HTML 4.01 specifications, it has not been validated
+   against this or any other standard.
+
+   --------------------------------------------------------------------------
 
 5. Troubleshooting
 
-5.1. I cannot connect to any websites. Or, I am getting "connection refused"
-message with every web page. Why?
-
-There are several possibilities:
-
-  * Privoxy is not running. Solution: verify that Privoxy is installed
-    correctly, has not crashed, and is indeed running. Turn on Privoxy's
-    logging, and look at the logs to see what they say.
-
-  * Or your browser is configured for a different port than what Privoxy is
-    using. Solution: verify that Privoxy and your browser are set to the same
-    port (listen-address).
-
-  * Or if using a forwarding rule, you have a configuration problem or a
-    problem with a host in the forwarding chain. Solution: temporarily alter
-    your configuration and take the forwarders out of the equation.
-
-  * Or you have a firewall that is interfering and blocking you. Solution: try
-    disabling or removing the firewall as a simple test.
-
--------------------------------------------------------------------------------
-
-5.2. Why am I getting a 503 Error (WSAECONNREFUSED) on every page?
-
-More than likely this is a problem with your TCP/IP networking. ZoneAlarm has
-been reported to cause this symptom -- even if not running! The solution is to
-either fight the ZA configuration, or uninstall ZoneAlarm, and then find
-something better behaved in its place. Other personal firewall type products
-may cause similar type problems if not configured correctly.
-
--------------------------------------------------------------------------------
-
-5.3. I just added a new rule, but the steenkin ad is still getting through.
-How?
-
-If the ad had been displayed before you added its URL, it will probably be held
-in the browser's cache for some time, so it will be displayed without the need
-for any request to the server, and Privoxy will not be involved. Flush the
-browser's caches, and then try again.
-
-If this doesn't help, you probably have an error in the rule you applied. Try
-pasting the full URL of the offending ad into http://config.privoxy.org/
-show-url-info and see if it really matches your new rule. Blocking ads is like
-blocking spam: a lot of tinkering is required to stay ahead of the game. And
-remember you need to block the URL of the ad in question, which may be entirely
-different from the site URL itself. Most ads are hosted on different servers
-than the main site itself. If you right-click on the ad, you should be able to
-get all the relevant information you need. Alternately, you can find the
-correct URL by looking at Privoxy's logs (you may need to enable logging in the
-main config file if its disabled).
-
-Below is a slightly modified real-life log snippet that originates with one
-requested URL: www.example.com (name of site was changed for this example, the
-number of requests is real). You can see in this the complexity of what goes
-into making up this one "page". There are eight different domains involved
-here, with thirty two separate URLs requested in all, making up all manner of
-images, Shockwave Flash, JavaScript, CSS stylesheets, scripts, and other
-related content. Some of this content is obviously "good" or "bad", but not
-all. Many of the more questionable looking requests, are going to outside
-domains that seem to be identifying themselves with suspicious looking names,
-making our job a little easier. Privoxy has "crunched" (meaning caught and
-BLOCKED) quite a few items in this example, but perhaps missed a few as well.
+    5.1. I cannot connect to any websites. Or, I am getting "connection refused"
+    message with every web page. Why?
+
+   There are several possibilities:
+
+     * Privoxy is not running. Solution: verify that Privoxy is installed
+       correctly, has not crashed, and is indeed running. Turn on Privoxy's
+       logging, and look at the logs to see what they say.
+
+     * Or your browser is configured for a different port than what Privoxy
+       is using. Solution: verify that Privoxy and your browser are set to
+       the same port (listen-address).
+
+     * Or if using a forwarding rule, you have a configuration problem or a
+       problem with a host in the forwarding chain. Solution: temporarily
+       alter your configuration and take the forwarders out of the equation.
+
+     * Or you have a firewall that is interfering and blocking you. Solution:
+       try disabling or removing the firewall as a simple test.
+
+   --------------------------------------------------------------------------
+
+    5.2. Why am I getting a 503 Error (WSAECONNREFUSED) on every page?
+
+   More than likely this is a problem with your TCP/IP networking. ZoneAlarm
+   has been reported to cause this symptom -- even if not running! The
+   solution is to either fight the ZA configuration, or uninstall ZoneAlarm,
+   and then find something better behaved in its place. Other personal
+   firewall type products may cause similar type problems if not configured
+   correctly.
+
+   --------------------------------------------------------------------------
+
+    5.3. I just added a new rule, but the steenkin ad is still getting through.
+    How?
+
+   If the ad had been displayed before you added its URL, it will probably be
+   held in the browser's cache for some time, so it will be displayed without
+   the need for any request to the server, and Privoxy will not be involved.
+   Flush the browser's caches, and then try again.
+
+   If this doesn't help, you probably have an error in the rule you applied.
+   Try pasting the full URL of the offending ad into
+   http://config.privoxy.org/show-url-info and see if it really matches your
+   new rule. Blocking ads is like blocking spam: a lot of tinkering is
+   required to stay ahead of the game. And remember you need to block the URL
+   of the ad in question, which may be entirely different from the site URL
+   itself. Most ads are hosted on different servers than the main site
+   itself. If you right-click on the ad, you should be able to get all the
+   relevant information you need. Alternately, you can find the correct URL
+   by looking at Privoxy's logs (you may need to enable logging in the main
+   config file if its disabled).
+
+   Below is a slightly modified real-life log snippet that originates with
+   one requested URL: www.example.com (name of site was changed for this
+   example, the number of requests is real). You can see in this the
+   complexity of what goes into making up this one "page". There are eight
+   different domains involved here, with thirty two separate URLs requested
+   in all, making up all manner of images, Shockwave Flash, JavaScript, CSS
+   stylesheets, scripts, and other related content. Some of this content is
+   obviously "good" or "bad", but not all. Many of the more questionable
+   looking requests, are going to outside domains that seem to be identifying
+   themselves with suspicious looking names, making our job a little easier.
+   Privoxy has "crunched" (meaning caught and BLOCKED) quite a few items in
+   this example, but perhaps missed a few as well.
 
 Request: www.example.com/
 Request: www.example.com/favicon.ico
@@ -1817,513 +1986,525 @@ Request: 66.70.21.80/img/pixel.gif
 Request: www.adtrak.net/adlog.php?bannerid=1309&clientid=439&zoneid=58&source=Ua&block=86400 crunch! (Blocked)
 Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua
 
+   Despite 12 out of 32 requests being blocked, the page looked, and seemed
+   to behave perfectly "normal" (minus some ads, of course).
+
+   --------------------------------------------------------------------------
+
+    5.4. One of my favorite sites does not work with Privoxy. What can I do?
+
+   First verify that it is indeed a Privoxy problem, by toggling off Privoxy
+   through http://config.privoxy.org/toggle (the toggle feature may need to
+   be enabled in the main config), and then shift-reloading the problem page
+   (i.e. holding down the shift key while clicking reload. Alternatively,
+   flush your browser's disk and memory caches).
+
+   If the problem went away, we know we have a configuration related problem.
+   Now go to http://config.privoxy.org/show-url-info and paste the full URL
+   of the page in question into the prompt. See which actions are being
+   applied to the URL, and which matches in which actions files are
+   responsible for that. It might be helpful also to look at your logs for
+   this site too, to see what else might be happening (note: logging may need
+   to be enabled in the main config file). Many sites are complex and require
+   a number of related pages to help present their content. Look at what else
+   might be used by the page in question, and what of that might be required.
+   Now, armed with this information, go to
+   http://config.privoxy.org/show-status and select the appropriate actions
+   files for editing.
+
+   You can now either look for a section which disables the actions that you
+   suspect to cause the problem and add a pattern for your site there, or
+   make up a completely new section for your site. In any case, the
+   recommended way is to disable only the prime suspect, reload the problem
+   page, and only if the problem persists, disable more and more actions
+   until you have identified the culprit. You may or may not want to turn the
+   other actions on again. Remember to flush your browser's caches in between
+   any such changes!
+
+   Alternately, if you are comfortable with a text editor, you can accomplish
+   the same thing by editing the appropriate actions file. Probably the
+   easiest way to deal with such problems when editing by hand is to add your
+   site to a { fragile } section in user.action, which is an alias that turns
+   off most "dangerous" actions, but is also likely to turn off more actions
+   then needed, and thus lower your privacy and protection more than
+   necessary,
+
+   Troubleshooting actions is discussed in more detail in the User Manual
+   appendix, Troubleshooting: the Anatomy of an Action. There is also an
+   actions tutorial with general configuration information and examples.
+
+   As a last resort, you can always see if your browser has a setting that
+   will bypass the proxy setting for selective sites. Modern browsers can do
+   this.
+
+   --------------------------------------------------------------------------
+
+    5.5. After installing Privoxy, I have to log in every time I start IE. What
+    gives?
+
+   This is a quirk that effects the installation of Privoxy, in conjunction
+   with Internet Explorer and Internet Connection Sharing on Windows 2000 and
+   Windows XP. The symptoms may appear to be corrupted or invalid DUN
+   settings, or passwords.
+
+   When setting up an NT based Windows system with Privoxy you may find that
+   things do not seem to be doing what you expect. When you set your system
+   up you will probably have set up Internet Connection Sharing (ICS) with
+   Dial up Networking (DUN) when logged in with administrator privileges. You
+   will probably have made this DUN connection available to other accounts
+   that you may have set-up on your system. E.g. Mum or Dad sets up the
+   system and makes accounts suitably configured for the kids.
+
+   When setting up Privoxy in this environment you will have to alter the
+   proxy set-up of Internet Explorer (IE) for the specific DUN connection on
+   which you wish to use Privoxy. When you do this the ICS DUN set-up becomes
+   user specific. In this instance you will see no difference if you change
+   the DUN connection under the account used to set-up the connection.
+   However when you do this from another user you will notice that the DUN
+   connection changes to make available to "Me only". You will also find that
+   you have to store the password under each different user!
+
+   The reason for this is that each user's set-up for IE is user specific.
+   Each set-up DUN connection and each LAN connection in IE store the
+   settings for each user individually. As such this enforces individual
+   configurations rather than common ones. Hence the first time you use a DUN
+   connection after re-booting your system it may not perform as you expect,
+   and prompt you for the password. Just set and save the password again and
+   all should be OK.
+
+   [Thanks to Ray Griffith for this submission.]
+
+   --------------------------------------------------------------------------
+
+    5.6. I cannot connect to any FTP sites. Privoxy is blocking me.
+
+   Privoxy cannot act as a proxy for FTP traffic, so do not configure your
+   browser to use Privoxy as an FTP proxy. The same is true for any protocol
+   other than HTTP or HTTPS (SSL).
+
+   Most browsers understand FTP as well as HTTP. If you connect to a site,
+   with a URL like ftp://ftp.example.com, your browser is making an FTP
+   connection, and not a HTTP connection. So while your browser may speak
+   FTP, Privoxy does not, and cannot proxy such traffic.
+
+   To complicate matters, some systems may have a generic "proxy" setting,
+   which will enable various protocols, including both HTTP and FTP proxying!
+   So it is possible to accidentally enable FTP proxying in these cases. And
+   of course, if this happens, Privoxy will indeed cause problems since it
+   does not know FTP. Newer version will give a sane error message if a FTP
+   connection is attempted. Just disable the FTP setting and all will be well
+   again.
+
+   Will Privoxy ever proxy FTP traffic? Unlikely. There just is not much
+   reason, and the work to make this happen is more than it may seem.
+
+   --------------------------------------------------------------------------
+
+    5.7. In Mac OSX, I can't configure Microsoft Internet Explorer to use
+    Privoxy as the HTTP proxy.
+
+   Microsoft Internet Explorer (in versions like 5.1) respects system-wide
+   network settings. In order to change the HTTP proxy, open System
+   Preferences, and click on the Network icon. In the settings pane that
+   comes up, click on the Proxies tab. Ensure the "Web Proxy (HTTP)" checkbox
+   is checked and enter 127.0.0.1 in the entry field. Enter 8118 in the Port
+   field. The next time you start IE, it should reflect these values.
 
-Despite 12 out of 32 requests being blocked, the page looked, and seemed to
-behave perfectly "normal" (minus some ads, of course).
-
--------------------------------------------------------------------------------
-
-5.4. One of my favorite sites does not work with Privoxy. What can I do?
-
-First verify that it is indeed a Privoxy problem, by toggling off Privoxy
-through http://config.privoxy.org/toggle (the toggle feature may need to be
-enabled in the main config), and then shift-reloading the problem page (i.e.
-holding down the shift key while clicking reload. Alternatively, flush your
-browser's disk and memory caches).
-
-If the problem went away, we know we have a configuration related problem. Now
-go to http://config.privoxy.org/show-url-info and paste the full URL of the
-page in question into the prompt. See which actions are being applied to the
-URL, and which matches in which actions files are responsible for that. It
-might be helpful also to look at your logs for this site too, to see what else
-might be happening (note: logging may need to be enabled in the main config
-file). Many sites are complex and require a number of related pages to help
-present their content. Look at what else might be used by the page in question,
-and what of that might be required. Now, armed with this information, go to
-http://config.privoxy.org/show-status and select the appropriate actions files
-for editing.
-
-You can now either look for a section which disables the actions that you
-suspect to cause the problem and add a pattern for your site there, or make up
-a completely new section for your site. In any case, the recommended way is to
-disable only the prime suspect, reload the problem page, and only if the
-problem persists, disable more and more actions until you have identified the
-culprit. You may or may not want to turn the other actions on again. Remember
-to flush your browser's caches in between any such changes!
-
-Alternately, if you are comfortable with a text editor, you can accomplish the
-same thing by editing the appropriate actions file. Probably the easiest way to
-deal with such problems when editing by hand is to add your site to a { fragile
-} section in user.action, which is an alias that turns off most "dangerous"
-actions, but is also likely to turn off more actions then needed, and thus
-lower your privacy and protection more than necessary,
-
-Troubleshooting actions is discussed in more detail in the User Manual
-appendix, Troubleshooting: the Anatomy of an Action. There is also an actions
-tutorial with general configuration information and examples.
-
-As a last resort, you can always see if your browser has a setting that will
-bypass the proxy setting for selective sites. Modern browsers can do this.
-
--------------------------------------------------------------------------------
-
-5.5. After installing Privoxy, I have to log in every time I start IE. What
-gives?
-
-This is a quirk that effects the installation of Privoxy, in conjunction with
-Internet Explorer and Internet Connection Sharing on Windows 2000 and Windows
-XP. The symptoms may appear to be corrupted or invalid DUN settings, or
-passwords.
-
-When setting up an NT based Windows system with Privoxy you may find that
-things do not seem to be doing what you expect. When you set your system up you
-will probably have set up Internet Connection Sharing (ICS) with Dial up
-Networking (DUN) when logged in with administrator privileges. You will
-probably have made this DUN connection available to other accounts that you may
-have set-up on your system. E.g. Mum or Dad sets up the system and makes
-accounts suitably configured for the kids.
-
-When setting up Privoxy in this environment you will have to alter the proxy
-set-up of Internet Explorer (IE) for the specific DUN connection on which you
-wish to use Privoxy. When you do this the ICS DUN set-up becomes user specific.
-In this instance you will see no difference if you change the DUN connection
-under the account used to set-up the connection. However when you do this from
-another user you will notice that the DUN connection changes to make available
-to "Me only". You will also find that you have to store the password under each
-different user!
-
-The reason for this is that each user's set-up for IE is user specific. Each
-set-up DUN connection and each LAN connection in IE store the settings for each
-user individually. As such this enforces individual configurations rather than
-common ones. Hence the first time you use a DUN connection after re-booting
-your system it may not perform as you expect, and prompt you for the password.
-Just set and save the password again and all should be OK.
-
-[Thanks to Ray Griffith for this submission.]
-
--------------------------------------------------------------------------------
-
-5.6. I cannot connect to any FTP sites. Privoxy is blocking me.
-
-Privoxy cannot act as a proxy for FTP traffic, so do not configure your browser
-to use Privoxy as an FTP proxy. The same is true for any protocol other than
-HTTP or HTTPS (SSL).
-
-Most browsers understand FTP as well as HTTP. If you connect to a site, with a
-URL like ftp://ftp.example.com, your browser is making an FTP connection, and
-not a HTTP connection. So while your browser may speak FTP, Privoxy does not,
-and cannot proxy such traffic.
-
-To complicate matters, some systems may have a generic "proxy" setting, which
-will enable various protocols, including both HTTP and FTP proxying! So it is
-possible to accidentally enable FTP proxying in these cases. And of course, if
-this happens, Privoxy will indeed cause problems since it does not know FTP.
-Newer version will give a sane error message if a FTP connection is attempted.
-Just disable the FTP setting and all will be well again.
-
-Will Privoxy ever proxy FTP traffic? Unlikely. There just is not much reason,
-and the work to make this happen is more than it may seem.
-
--------------------------------------------------------------------------------
-
-5.7. In Mac OSX, I can't configure Microsoft Internet Explorer to use Privoxy
-as the HTTP proxy.
-
-Microsoft Internet Explorer (in versions like 5.1) respects system-wide network
-settings. In order to change the HTTP proxy, open System Preferences, and click
-on the Network icon. In the settings pane that comes up, click on the Proxies
-tab. Ensure the "Web Proxy (HTTP)" checkbox is checked and enter 127.0.0.1 in
-the entry field. Enter 8118 in the Port field. The next time you start IE, it
-should reflect these values.
-
--------------------------------------------------------------------------------
-
-5.8. In Mac OSX, I dragged the Privoxy folder to the trash in order to
-uninstall it. Now the finder tells me I don't have sufficient privileges to
-empty the trash.
-
-Just dragging the Privoxy folder to the trash is not enough to delete it.
-Privoxy supplies an uninstall.command file that takes care of these details.
-Open the trash, drag the uninstall.command file out of the trash and
-double-click on it. You will be prompted for confirmation and the
-administration password.
+   --------------------------------------------------------------------------
 
-The trash may still appear full after this command; emptying the trash from the
-desktop should make it appear empty again.
+    5.8. In Mac OSX, I dragged the Privoxy folder to the trash in order to
+    uninstall it. Now the finder tells me I don't have sufficient privileges to
+    empty the trash.
 
--------------------------------------------------------------------------------
+   Just dragging the Privoxy folder to the trash is not enough to delete it.
+   Privoxy supplies an uninstall.command file that takes care of these
+   details. Open the trash, drag the uninstall.command file out of the trash
+   and double-click on it. You will be prompted for confirmation and the
+   administration password.
 
-5.9. In Mac OSX Panther (10.3), images often fail to load and/or I experience
-random delays in page loading. I'm using localhost as my browser's proxy
-setting.
+   The trash may still appear full after this command; emptying the trash
+   from the desktop should make it appear empty again.
 
-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 127.0.0.1
-instead of localhost works around the problem.
+   --------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
+    5.9. In Mac OSX Panther (10.3), images often fail to load and/or I
+    experience random delays in page loading. I'm using localhost as my
+    browser's proxy setting.
 
-5.10. I get a completely blank page at one site. "View Source" shows only:
-<html><body></body></html>. Without Privoxy the page loads fine.
+   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
+   127.0.0.1 instead of localhost works around the problem.
 
-Chances are that the site suffers from a bug in PHP, which results in empty
-pages being sent if the client explicitly requests an uncompressed page, like
-Privoxy does. This bug has been fixed in PHP 4.2.3.
+   --------------------------------------------------------------------------
+
+    5.10. I get a completely blank page at one site. "View Source" shows only:
+    <html><body></body></html>. Without Privoxy the page loads fine.
 
-To find out if this is in fact the source of the problem, try adding the site
-to a -prevent-compression section in user.action:
+   Chances are that the site suffers from a bug in PHP, which results in
+   empty pages being sent if the client explicitly requests an uncompressed
+   page, like Privoxy does. This bug has been fixed in PHP 4.2.3.
+
+   To find out if this is in fact the source of the problem, try adding the
+   site to a -prevent-compression section in user.action:
 
    # Make exceptions for ill-behaved sites:
    #
    {-prevent-compression}
     .example.com
 
+   If that works, you may also want to report the problem to the site's
+   webmasters, telling them to use zlib.output_compression instead of
+   ob_gzhandler in their PHP applications (workaround) or upgrade to PHP
+   4.2.3 or later (fix).
 
-If that works, you may also want to report the problem to the site's
-webmasters, telling them to use zlib.output_compression instead of ob_gzhandler
-in their PHP applications (workaround) or upgrade to PHP 4.2.3 or later (fix).
-
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-5.11. My logs show many "Unable to get my own hostname" lines. Why?
+    5.11. My logs show many "Unable to get my own hostname" lines. Why?
 
-Privoxy 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 config file
-listen-address setting). If the system cannot supply this information, Privoxy
-logs this condition.
+   Privoxy 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 config file
+   listen-address setting). If the system cannot supply this information,
+   Privoxy logs this condition.
 
-Typically, this would be considered a minor system configuration error. It is
-not a fatal error to Privoxy however, but may result in a much slower response
-from Privoxy on some platforms due to DNS timeouts.
+   Typically, this would be considered a minor system configuration error. It
+   is not a fatal error to Privoxy however, but may result in a much slower
+   response from Privoxy on some platforms due to DNS timeouts.
 
-This can be caused by a problem with the local HOSTS file. If this file has
-been changed from the original, try reverting it to see if that helps. Make
-sure whatever name(s) are used for the local system, that they resolve both
-ways.
+   This can be caused by a problem with the local HOSTS file. If this file
+   has been changed from the original, try reverting it to see if that helps.
+   Make sure whatever name(s) are used for the local system, that they
+   resolve both ways.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-5.12. When I try to launch Privoxy, I get an error message "port 8118 is
-already in use" (or similar wording). Why?
+    5.12. When I try to launch Privoxy, I get an error message "port 8118 is
+    already in use" (or similar wording). Why?
 
-Port 8118 is Privoxy's default TCP "listening" port. Typically this message
-would mean that there is already one instance of Privoxy running, and your
-system is actually trying to start a second Privoxy on the same port, which
-will not work. (You can have multiple instances but they must be assigned
-different ports.) How and why this might happen varies from platform to
-platform, but you need to check your installation and start-up procedures.
+   Port 8118 is Privoxy's default TCP "listening" port. Typically this
+   message would mean that there is already one instance of Privoxy running,
+   and your system is actually trying to start a second Privoxy on the same
+   port, which will not work. (You can have multiple instances but they must
+   be assigned different ports.) How and why this might happen varies from
+   platform to platform, but you need to check your installation and start-up
+   procedures.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-5.13. Pages with UTF-8 fonts are garbled.
+    5.13. Pages with UTF-8 fonts are garbled.
 
-This is caused by the "demoronizer" filter. You should either upgrade Privoxy,
-or at least upgrade to the most recent default.action file available from
-SourceForge. Or you can simply disable the demoronizer filter.
+   This is caused by the "demoronizer" filter. You should either upgrade
+   Privoxy, or at least upgrade to the most recent default.action file
+   available from SourceForge. Or you can simply disable the demoronizer
+   filter.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-5.14. Why are binary files (such as images) corrupted when Privoxy is used?
+    5.14. Why are binary files (such as images) corrupted when Privoxy is used?
 
-This may also be caused by the "demoronizer" filter, in conjunction with a web
-server that is misreporting the content type. Binary files are exempted from
-Privoxy's filtering (unless the web server by mistake says the file is
-something else). Either upgrade Privoxy, or go to the most recent
-default.action file available from SourceForge.
+   This may also be caused by the "demoronizer" filter, in conjunction with a
+   web server that is misreporting the content type. Binary files are
+   exempted from Privoxy's filtering (unless the web server by mistake says
+   the file is something else). Either upgrade Privoxy, or go to the most
+   recent default.action file available from SourceForge.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-5.15. What is the "demoronizer" and why is it there?
+    5.15. What is the "demoronizer" and why is it there?
 
-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. Privoxy borrowed from this script,
-introducing a filter based on the original demoronizer, which in turn could
-correct these errors on the fly.
+   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. Privoxy borrowed
+   from this script, introducing a filter based on the original demoronizer,
+   which in turn could correct these errors on the fly.
 
-But this is only needed in some situations, and will cause serious problems in
-some other situations.
+   But this is only needed in some situations, and will cause serious
+   problems in some other situations.
 
-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 should not be on.
+   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 should not be on.
 
-On the other hand, if you use non-Microsoft products, and you occasionally
-notice weird characters on pages, you might want to try it.
+   On the other hand, if you use non-Microsoft products, and you occasionally
+   notice weird characters on pages, you might want to try it.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-5.16. Why do I keep seeing "PrivoxyWindowOpen()" in raw source code?
+    5.16. Why do I keep seeing "PrivoxyWindowOpen()" in raw source code?
 
-Privoxy is attempting to disable malicious Javascript in this case, with the
-unsolicited-popups filter. Privoxy cannot tell very well "good" code snippets
-from "bad" code snippets.
+   Privoxy is attempting to disable malicious Javascript in this case, with
+   the unsolicited-popups filter. Privoxy cannot tell very well "good" code
+   snippets from "bad" code snippets.
 
-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.
+   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.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-5.17. I am getting too many DNS errors like "404 No Such Domain". Why can't
-Privoxy do this better?
+    5.17. I am getting too many DNS errors like "404 No Such Domain". Why can't
+    Privoxy do this better?
 
-There are potentially several factors here. First of all, the DNS resolution is
-done by the underlying operating system -- not Privoxy itself. Privoxy merely
-initiates the process and hands it off, and then later reports whatever the
-outcome was. And tries to give a coherent message if there seems to be a
-problem. In some cases, this might otherwise be mitigated by the browser itself
-which might try some work-arounds and alternate approaches (e.g adding "www."
-to the URL).
+   There are potentially several factors here. First of all, the DNS
+   resolution is done by the underlying operating system -- not Privoxy
+   itself. Privoxy merely initiates the process and hands it off, and then
+   later reports whatever the outcome was. And tries to give a coherent
+   message if there seems to be a problem. In some cases, this might
+   otherwise be mitigated by the browser itself which might try some
+   work-arounds and alternate approaches (e.g adding "www." to the URL).
 
-In other cases, if Privoxy is being chained with another proxy, this could
-complicate the issue, and cause undue delays and timeouts. In the case of a
-"socks4a" proxy, the socks server handles all the DNS. Privoxy would just be
-the "messenger" which is reporting whatever problem occurred downstream, and
-not the root cause of the error.
+   In other cases, if Privoxy is being chained with another proxy, this could
+   complicate the issue, and cause undue delays and timeouts. In the case of
+   a "socks4a" proxy, the socks server handles all the DNS. Privoxy would
+   just be the "messenger" which is reporting whatever problem occurred
+   downstream, and not the root cause of the error.
 
-In any case, versions newer than 3.0.3 include various improvements to help
-Privoxy better handle these cases.
+   In any case, versions newer than 3.0.3 include various improvements to
+   help Privoxy better handle these cases.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-5.18. At one site Privoxy just hangs, and starts taking all CPU. Why is this?
+    5.18. At one site Privoxy just hangs, and starts taking all CPU. Why is
+    this?
 
-This is probably a manifestation of the "100% cpu" problem that occurs on pages
-containing many (thousands upon thousands) of blank lines. The blank lines are
-in the raw HTML source of the page, and the browser just ignores them. But the
-pattern matching in Privoxy's page filtering mechanism is trying to match
-against absurdly long strings and this becomes very CPU-intensive, taking a
-long, long time to complete. Until a better solution comes along, disable
-filtering on these pages, particularly the js-annoyances and unsolicited-popups
-filters.
+   This is probably a manifestation of the "100% cpu" problem that occurs on
+   pages containing many (thousands upon thousands) of blank lines. The blank
+   lines are in the raw HTML source of the page, and the browser just ignores
+   them. But the pattern matching in Privoxy's page filtering mechanism is
+   trying to match against absurdly long strings and this becomes very
+   CPU-intensive, taking a long, long time to complete. Until a better
+   solution comes along, disable filtering on these pages, particularly the
+   js-annoyances and unsolicited-popups filters.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-5.19. I just installed Privoxy, and all my browsing has slowed to a crawl. What
-gives?
+    5.19. I just installed Privoxy, and all my browsing has slowed to a crawl.
+    What gives?
 
-This should not happen, and for the overwhelming number of users world-wide, it
-does not happen. I would suspect some inadvertent interaction of software
-components such as anti-virus software, spyware protectors, personal firewalls
-or similar components. Try disabling (or uninstalling) these one at a time and
-see if that helps.
+   This should not happen, and for the overwhelming number of users
+   world-wide, it does not happen. I would suspect some inadvertent
+   interaction of software components such as anti-virus software, spyware
+   protectors, personal firewalls or similar components. Try disabling (or
+   uninstalling) these one at a time and see if that helps.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-5.20. Why do my filters work on some sites but not on others?
+    5.20. Why do my filters work on some sites but not on others?
 
-It's probably due to compression. It is a common practice for web servers to
-send their content "compressed" in order to speed things up, and then let the
-browser "uncompress" them. When compiled with zlib support Privoxy can
-decompress content before filtering, otherwise you may want to enable
-prevent-compression.
+   It's probably due to compression. It is a common practice for web servers
+   to send their content "compressed" in order to speed things up, and then
+   let the browser "uncompress" them. When compiled with zlib support Privoxy
+   can decompress content before filtering, otherwise you may want to enable
+   prevent-compression.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
 6. Contacting the developers, Bug Reporting and Feature Requests
 
-We value your feedback. In fact, we rely on it to improve Privoxy and its
-configuration. However, please note the following hints, so we can provide you
-with the best support:
+   We value your feedback. In fact, we rely on it to improve Privoxy and its
+   configuration. However, please note the following hints, so we can provide
+   you with the best support:
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-6.1. Get Support
+  6.1. Get Support
 
-For casual users, our support forum at SourceForge is probably best suited:
-http://sourceforge.net/tracker/?group_id=11118&atid=211118
+   For casual users, our support forum at SourceForge is probably best
+   suited: http://sourceforge.net/tracker/?group_id=11118&atid=211118
 
-All users are of course welcome to discuss their issues on the users mailing
-list, where the developers also hang around.
+   All users are of course welcome to discuss their issues on the users
+   mailing list, where the developers also hang around.
 
-Note that the Privoxy mailing lists are moderated. Posts from unsubscribed
-addresses have to be accepted manually by a moderator. This may cause a delay
-of several days and if you use a subject that doesn't clearly mention Privoxy
-or one of its features, your message may be accidentally discarded as spam.
+   Note that the Privoxy mailing lists are moderated. Posts from unsubscribed
+   addresses have to be accepted manually by a moderator. This may cause a
+   delay of several days and if you use a subject that doesn't clearly
+   mention Privoxy or one of its features, your message may be accidentally
+   discarded as spam.
 
-If you aren't subscribed, you should therefore spend a few seconds to come up
-with a proper subject. Additionally you should make it clear that you want to
-get CC'd. Otherwise some responses will be directed to the mailing list only,
-and you won't see them.
+   If you aren't subscribed, you should therefore spend a few seconds to come
+   up with a proper subject. Additionally you should make it clear that you
+   want to get CC'd. Otherwise some responses will be directed to the mailing
+   list only, and you won't see them.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-6.2. Reporting Problems
+  6.2. Reporting Problems
 
-"Problems" for our purposes, come in two forms:
+   "Problems" for our purposes, come in two forms:
 
-  * Configuration issues, such as ads that slip through, or sites that don't
-    function properly due to one Privoxy "action" or another being turned "on".
+     * Configuration issues, such as ads that slip through, or sites that
+       don't function properly due to one Privoxy "action" or another being
+       turned "on".
 
-  * "Bugs" in the programming code that makes up Privoxy, such as that might
-    cause a crash.
+     * "Bugs" in the programming code that makes up Privoxy, such as that
+       might cause a crash.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-6.2.1. Reporting Ads or Other Configuration Problems
+    6.2.1. Reporting Ads or Other Configuration Problems
 
-Please send feedback on ads that slipped through, innocent images that were
-blocked, sites that don't work properly, and other configuration related
-problem of default.action file, to http://sourceforge.net/tracker/?group_id=
-11118&atid=460288, the Actions File Tracker.
+   Please send feedback on ads that slipped through, innocent images that
+   were blocked, sites that don't work properly, and other configuration
+   related problem of default.action file, to
+   http://sourceforge.net/tracker/?group_id=11118&atid=460288, the Actions
+   File Tracker.
 
-New, improved default.action files may occasionally be made available based on
-your feedback. These will be announced on the ijbswa-announce list and
-available from our the files section of our project page.
+   New, improved default.action files may occasionally be made available
+   based on your feedback. These will be announced on the ijbswa-announce
+   list and available from our the files section of our project page.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-6.2.2. Reporting Bugs
+    6.2.2. Reporting Bugs
 
-Please report all bugs through our bug tracker: http://sourceforge.net/tracker
-/?group_id=11118&atid=111118.
+   Please report all bugs through our bug tracker:
+   http://sourceforge.net/tracker/?group_id=11118&atid=111118.
 
-Before doing so, please make sure that the bug has not already been submitted
-and observe the additional hints at the top of the submit form. If already
-submitted, please feel free to add any info to the original report that might
-help to solve the issue.
+   Before doing so, please make sure that the bug has not already been
+   submitted and observe the additional hints at the top of the submit form.
+   If already submitted, please feel free to add any info to the original
+   report that might help to solve the issue.
 
-Please try to verify that it is a Privoxy bug, and not a browser or site bug or
-documented behaviour that just happens to be different than what you expected.
-If unsure, try toggling off Privoxy, and see if the problem persists.
+   Please try to verify that it is a Privoxy bug, and not a browser or site
+   bug or documented behaviour that just happens to be different than what
+   you expected. If unsure, try toggling off Privoxy, and see if the problem
+   persists.
 
-If you are using your own custom configuration, please try the stock configs to
-see if the problem is configuration related. If you're having problems with a
-feature that is disabled by default, please ask around on the mailing list if
-others can reproduce the problem.
+   If you are using your own custom configuration, please try the stock
+   configs to see if the problem is configuration related. If you're having
+   problems with a feature that is disabled by default, please ask around on
+   the mailing list if others can reproduce the problem.
 
-If you aren't using the latest Privoxy version, the bug may have been found and
-fixed in the meantime. We would appreciate if you could take the time to
-upgrade to the latest version (or even the latest CVS snapshot) and verify that
-your bug still exists.
+   If you aren't using the latest Privoxy version, the bug may have been
+   found and fixed in the meantime. We would appreciate if you could take the
+   time to upgrade to the latest version (or even the latest CVS snapshot)
+   and verify that your bug still exists.
 
-Please be sure to provide the following information:
+   Please be sure to provide the following information:
 
-  * The exact Privoxy version you are using (if you got the source from CVS,
-    please also provide the source code revisions as shown in http://
-    config.privoxy.org/show-version).
+     * The exact Privoxy version you are using (if you got the source from
+       CVS, please also provide the source code revisions as shown in
+       http://config.privoxy.org/show-version).
 
-  * The operating system and versions you run Privoxy on, (e.g. Windows XP
-    SP2), if you are using a Unix flavor, sending the output of "uname -a"
-    should do, in case of GNU/Linux, please also name the distribution.
+     * The operating system and versions you run Privoxy on, (e.g. Windows XP
+       SP2), if you are using a Unix flavor, sending the output of "uname -a"
+       should do, in case of GNU/Linux, please also name the distribution.
 
-  * The name, platform, and version of the browser you were using (e.g.
-    Internet Explorer v5.5 for Mac).
+     * The name, platform, and version of the browser you were using (e.g.
+       Internet Explorer v5.5 for Mac).
 
-  * The URL where the problem occurred, or some way for us to duplicate the
-    problem (e.g. http://somesite.example.com/?somethingelse=123).
+     * The URL where the problem occurred, or some way for us to duplicate
+       the problem (e.g. http://somesite.example.com/?somethingelse=123).
 
-  * Whether your version of Privoxy is one supplied by the Privoxy developers
-    via SourceForge, or if you got your copy somewhere else.
+     * Whether your version of Privoxy is one supplied by the Privoxy
+       developers via SourceForge, or if you got your copy somewhere else.
 
-  * Whether you are using Privoxy in tandem with another proxy such as Tor. If
-    so, please temporary disable the other proxy to see if the symptoms change.
+     * Whether you are using Privoxy in tandem with another proxy such as
+       Tor. If so, please temporary disable the other proxy to see if the
+       symptoms change.
 
-  * Whether you are using a personal firewall product. If so, does Privoxy work
-    without it?
+     * Whether you are using a personal firewall product. If so, does Privoxy
+       work without it?
 
-  * Any other pertinent information to help identify the problem such as config
-    or log file excerpts (yes, you should have log file entries for each action
-    taken).
+     * Any other pertinent information to help identify the problem such as
+       config or log file excerpts (yes, you should have log file entries for
+       each action taken).
 
-You don't have to tell us your actual name when filing a problem report, but
-please use a nickname so we can differentiate between your messages and the
-ones entered by other "anonymous" users that may respond to your request if
-they have the same problem or already found a solution.
+   You don't have to tell us your actual name when filing a problem report,
+   but please use a nickname so we can differentiate between your messages
+   and the ones entered by other "anonymous" users that may respond to your
+   request if they have the same problem or already found a solution.
 
-Please also check the status of your request a few days after submitting it, as
-we may request additional information. If you use a SF id, you should
-automatically get a mail when someone responds to your request.
+   Please also check the status of your request a few days after submitting
+   it, as we may request additional information. If you use a SF id, you
+   should automatically get a mail when someone responds to your request.
 
-The appendix of the Privoxy User Manual also has helpful information on
-understanding actions, and action debugging.
+   The appendix of the Privoxy User Manual also has helpful information on
+   understanding actions, and action debugging.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-6.3. Request New Features
+  6.3. Request New Features
 
-You are welcome to submit ideas on new features or other proposals for
-improvement through our feature request tracker at http://sourceforge.net/
-tracker/?atid=361118&group_id=11118.
+   You are welcome to submit ideas on new features or other proposals for
+   improvement through our feature request tracker at
+   http://sourceforge.net/tracker/?atid=361118&group_id=11118.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
-6.4. Other
+  6.4. Other
 
-For any other issues, feel free to use the mailing lists. Technically
-interested users and people who wish to contribute to the project are also
-welcome on the developers list! You can find an overview of all Privoxy-related
-mailing lists, including list archives, at: http://sourceforge.net/mail/?
-group_id=11118.
+   For any other issues, feel free to use the mailing lists. Technically
+   interested users and people who wish to contribute to the project are also
+   welcome on the developers list! You can find an overview of all
+   Privoxy-related mailing lists, including list archives, at:
+   http://sourceforge.net/mail/?group_id=11118.
 
--------------------------------------------------------------------------------
+   --------------------------------------------------------------------------
 
 7. Privoxy Copyright, License and History
 
-Copyright   2001-2008 by Privoxy Developers <
-ijbswa-developers@lists.sourceforge.net>
-
-Some source code is based on code Copyright   1997 by Anonymous Coders and
-Junkbusters, Inc. and licensed under the GNU General Public License.
+   Copyright © 2001-2008 by Privoxy Developers
+   <ijbswa-developers@lists.sourceforge.net>
 
-Portions of this document are "borrowed" from the original Junkbuster (tm) FAQ,
-and modified as appropriate for Privoxy.
+   Some source code is based on code Copyright © 1997 by Anonymous Coders
+   and Junkbusters, Inc. and licensed under the GNU General Public License.
 
--------------------------------------------------------------------------------
+   Portions of this document are "borrowed" from the original Junkbuster (tm)
+   FAQ, and modified as appropriate for Privoxy.
 
-7.1. License
+   --------------------------------------------------------------------------
 
-Privoxy is free software; you can redistribute it and/or modify it under the
-terms of the GNU General Public License, version 2, as published by the Free
-Software Foundation.
+  7.1. License
 
-This program is distributed in the hope that it will be useful, but WITHOUT ANY
-WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
-PARTICULAR PURPOSE. See the GNU General Public License for more details, which
-is available from the Free Software Foundation, Inc, 51 Franklin Street, Fifth
-Floor, Boston, MA 02110-1301, USA
+   Privoxy is free software; you can redistribute it and/or modify it under
+   the terms of the GNU General Public License, version 2, as published by
+   the Free Software Foundation.
 
-You should have received a copy of the GNU General Public License along with
-this program; if not, write to the
+   This