From: Fabian Keil <fk@fabiankeil.de>
Date: Fri, 25 Jan 2013 14:26:40 +0000 (+0000)
Subject: Rebuild documentation with the updated contact section
X-Git-Tag: v_3_0_21~81
X-Git-Url: http://www.privoxy.org/gitweb/@default-cgi@/faq/%22https:/@default-cgi@error-favicon.ico?a=commitdiff_plain;h=4fef8970e4e382c21598949e7b035e596a4a8048;p=privoxy.git
Rebuild documentation with the updated contact section
---
diff --git a/doc/webserver/developer-manual/contact.html b/doc/webserver/developer-manual/contact.html
index 1c5345ef..16f3f1c2 100644
--- a/doc/webserver/developer-manual/contact.html
+++ b/doc/webserver/developer-manual/contact.html
@@ -44,10 +44,166 @@
<p>We value your feedback. In fact, we rely on it to improve <span class=
"APPLICATION">Privoxy</span> and its configuration. However, please note
- the following hints, so we can provide you with the best support:</p>
+ the following hints, so we can provide you with the best support.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="CONTACT-SUPPORT" id="CONTACT-SUPPORT">8.1.
+ <h2 class="SECT2"><a name="SUFFICIENT-INFORMATION" id=
+ "SUFFICIENT-INFORMATION">8.1. Please provide sufficient
+ information</a></h2>
+
+ <p>A lot of support requests don't contain enough information and can't
+ be solved without a lot of back and forth which causes unnecessary
+ delays. Reading this section should help to prevent that.</p>
+
+ <p>Before contacting us to report a problem, please try to verify that
+ it is a <span class="APPLICATION">Privoxy</span> problem, and not a
+ browser or site problem or documented behaviour that just happens to be
+ different than what you expected. If unsure, try <a href=
+ "http://config.privoxy.org/toggle?set=disable" target="_top">toggling
+ off</a> <span class="APPLICATION">Privoxy</span>, and see if the
+ problem persists.</p>
+
+ <p>If you are using your own custom configuration, please try the
+ default configuration 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.</p>
+
+ <p>If you aren't using the latest Privoxy version, the problem may have
+ been found and fixed in the meantime. We would appreciate if you could
+ take the time to <a href=
+ "http://www.privoxy.org/user-manual/installation.html" target=
+ "_top">upgrade to the latest version</a> and verify that the problem
+ still exists.</p>
+
+ <p>Please be sure to provide the following information when reporting
+ problems or requesting support:</p>
+
+ <ul>
+ <li>
+ <p>The exact <span class="APPLICATION">Privoxy</span> version you
+ are using.</p>
+ </li>
+
+ <li>
+ <p>The operating system and versions you run <span class=
+ "APPLICATION">Privoxy</span> on, e.g. <span class=
+ "APPLICATION">Windows XP SP2</span>.</p>
+ </li>
+
+ <li>
+ <p>The name, platform, and version of the <span class=
+ "APPLICATION">browser</span> you were using (e.g. <span class=
+ "APPLICATION">Internet Explorer v5.5</span> for Mac).</p>
+ </li>
+
+ <li>
+ <p>The URL where the problem occurred, or some way for us to
+ duplicate the problem (e.g. <tt class=
+ "LITERAL">http://somesite.example.com/?somethingelse=123</tt>).</p>
+ </li>
+
+ <li>
+ <p>Whether your version of <span class="APPLICATION">Privoxy</span>
+ is one supplied by the <span class="APPLICATION">Privoxy</span>
+ developers via SourceForge, or if you got your copy somewhere
+ else.</p>
+ </li>
+
+ <li>
+ <p>Whether you are using <span class="APPLICATION">Privoxy</span>
+ together with another proxy such as <span class=
+ "APPLICATION">Tor</span>. If so, please temporary disable the other
+ proxy to see if the symptoms change.</p>
+ </li>
+
+ <li>
+ <p>Whether you are using a personal firewall product. If so, does
+ <span class="APPLICATION">Privoxy</span> work without it?</p>
+ </li>
+
+ <li>
+ <p>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). To get a meaningful logfile, please
+ make sure that the <a href="../user-manual/config.html#LOGFILE"
+ target="_top">logfile directive</a> is being used and the following
+ <a href="../user-manual/config.html#DEBUG" target="_top">debug
+ options</a> are enabled (all of them):</p>
+
+ <p class="LITERALLAYOUT">
+ debug 1 # Log the destination for each request Privoxy let through. See also debug 1024.<br>
+
+ debug 2 # show each connection status<br>
+
+ debug 4 # show I/O status<br>
+
+ debug 8 # show header parsing<br>
+
+ debug 128 # debug redirects<br>
+ debug 256 # debug GIF de-animation<br>
+
+ debug 512 # Common Log Format<br>
+
+ debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why.<br>
+
+ debug 4096 # Startup banner and warnings.<br>
+
+ debug 8192 # Non-fatal errors</p>
+
+ <p>If you are having trouble with a filter, please additionally
+ enable</p>
+
+ <p class="LITERALLAYOUT">
+ debug 64 # debug regular expression filters</p>If
+ you are using Privoxy 3.0.17 or later and suspect that it
+ interprets the request or the response incorrectly, please enable
+
+ <p class="LITERALLAYOUT">
+ debug 32768 # log all data read from the network</p>
+
+ <p>It's easy for us to ignore log messages that aren't relevant but
+ missing log messages may make it impossible to investigate a
+ problem. If you aren't sure which of the debug directives are
+ relevant, please just enable all of them and let us worry about
+ it.</p>
+
+ <p>Note that Privoxy log files may contain sensitive information so
+ please don't submit any logfiles you didn't read first. You can
+ mask sensitive information as long as it's clear that you removed
+ something.</p>
+ </li>
+ </ul>
+
+ <p>You don't have to tell us your actual name when filing a problem
+ report, but if you don't, 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. Note that due to spam the trackers may not
+ always allow to post without being logged into SourceForge. If that's
+ the case, you are still free to create a login that isn't directly
+ linked to your name, though.</p>
+
+ <p>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 don't bother to add an email address when using
+ the tracker. If you prefer to communicate through email, just use one
+ of the mailing lists directly.</p>
+
+ <p>If you are new to reporting problems, you might be interested in
+ <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html" target=
+ "_top">How to Report Bugs Effectively</a>.</p>
+
+ <p>The <a href=
+ "http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" target=
+ "_top">appendix of the Privoxy User Manual</a> also has helpful
+ information on understanding <tt class="LITERAL">actions</tt>, and
+ <tt class="LITERAL">action</tt> debugging.</p>
+ </div>
+
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="CONTACT-SUPPORT" id="CONTACT-SUPPORT">8.2.
Get Support</a></h2>
<p>For casual users, our <a href=
@@ -86,7 +242,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="REPORTING" id="REPORTING">8.2. Reporting
+ <h2 class="SECT2"><a name="REPORTING" id="REPORTING">8.3. Reporting
Problems</a></h2>
<p><span class="QUOTE">"Problems"</span> for our purposes, come in two
@@ -108,7 +264,7 @@
</ul>
<div class="SECT3">
- <h3 class="SECT3"><a name="CONTACT-ADS" id="CONTACT-ADS">8.2.1.
+ <h3 class="SECT3"><a name="CONTACT-ADS" id="CONTACT-ADS">8.3.1.
Reporting Ads or Other Configuration Problems</a></h3>
<p>Please send feedback on ads that slipped through, innocent images
@@ -131,7 +287,7 @@
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="CONTACT-BUGS" id="CONTACT-BUGS">8.2.2.
+ <h3 class="SECT3"><a name="CONTACT-BUGS" id="CONTACT-BUGS">8.3.2.
Reporting Bugs</a></h3>
<p>Please report all bugs through our bug tracker: <a href=
@@ -146,155 +302,11 @@
target="_top">submit form</a>. If already submitted, please feel free
to add any info to the original report that might help to solve the
issue.</p>
-
- <p>Please try to verify that it is a <span class=
- "APPLICATION">Privoxy</span> bug, and not a browser or site bug or
- documented behaviour that just happens to be different than what you
- expected. If unsure, try <a href=
- "http://config.privoxy.org/toggle?set=disable" target="_top">toggling
- off</a> <span class="APPLICATION">Privoxy</span>, and see if the
- problem persists.</p>
-
- <p>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.</p>
-
- <p>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 <a href=
- "http://www.privoxy.org/user-manual/installation.html" target=
- "_top">upgrade to the latest version</a> (or even the latest CVS
- snapshot) and verify that your bug still exists.</p>
-
- <p>Please be sure to provide the following information:</p>
-
- <ul>
- <li>
- <p>The exact <span class="APPLICATION">Privoxy</span> version you
- are using (if you got the source from CVS, please also provide
- the source code revisions as shown in <a href=
- "http://config.privoxy.org/show-version" target=
- "_top">http://config.privoxy.org/show-version</a>).</p>
- </li>
-
- <li>
- <p>The operating system and versions you run <span class=
- "APPLICATION">Privoxy</span> on, (e.g. <span class=
- "APPLICATION">Windows XP SP2</span>), if you are using a Unix
- flavor, sending the output of <span class="QUOTE">"uname
- -a"</span> should do, in case of GNU/Linux, please also name the
- distribution.</p>
- </li>
-
- <li>
- <p>The name, platform, and version of the <span class=
- "APPLICATION">browser</span> you were using (e.g. <span class=
- "APPLICATION">Internet Explorer v5.5</span> for Mac).</p>
- </li>
-
- <li>
- <p>The URL where the problem occurred, or some way for us to
- duplicate the problem (e.g. <tt class=
- "LITERAL">http://somesite.example.com/?somethingelse=123</tt>).</p>
- </li>
-
- <li>
- <p>Whether your version of <span class=
- "APPLICATION">Privoxy</span> is one supplied by the <span class=
- "APPLICATION">Privoxy</span> developers via SourceForge, or if
- you got your copy somewhere else.</p>
- </li>
-
- <li>
- <p>Whether you are using <span class="APPLICATION">Privoxy</span>
- in tandem with another proxy such as <span class=
- "APPLICATION">Tor</span>. If so, please temporary disable the
- other proxy to see if the symptoms change.</p>
- </li>
-
- <li>
- <p>Whether you are using a personal firewall product. If so, does
- <span class="APPLICATION">Privoxy</span> work without it?</p>
- </li>
-
- <li>
- <p>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). To get a meaningful logfile,
- please make sure that the <a href=
- "../user-manual/config.html#LOGFILE" target="_top">logfile
- directive</a> is being used and the following <a href=
- "../user-manual/config.html#DEBUG" target="_top">debug
- options</a> are enabled:</p>
-
- <p class="LITERALLAYOUT">
- debug 1 # Log the destination for each request Privoxy let through. See also debug 1024.<br>
-
- debug 2 # show each connection status<br>
-
- debug 4 # show I/O status<br>
-
- debug 8 # show header parsing<br>
-
- debug 128 # debug redirects<br>
- debug 256 # debug GIF de-animation<br>
-
- debug 512 # Common Log Format<br>
-
- debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why.<br>
-
- debug 4096 # Startup banner and warnings.<br>
-
- debug 8192 # Non-fatal errors</p>If you
- are having trouble with a filter, please additionally enable
-
- <p class="LITERALLAYOUT">
- debug 64 # debug regular expression filters</p>If
- you are using Privoxy 3.0.17 or later and suspect that it
- interprets the request or the response incorrectly, please enable
-
- <p class="LITERALLAYOUT">
- debug 32768 # log all data read from the network</p>Note
- that Privoxy log files may contain sensitive information so
- please don't submit any logfiles you didn't read first. You can
- mask sensitive information as long as it's clear that you removed
- something.
- </li>
- </ul>
-
- <p>You don't have to tell us your actual name when filing a problem
- report, but if you don't, 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. Note that due to spam the
- trackers may not always allow to post without being logged into
- SourceForge. If that's the case, you are still free to create a login
- that isn't directly linked to your name, though.</p>
-
- <p>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 don't bother to add an email address when using
- the tracker. If you prefer to communicate through email, just use one
- of the mailing lists directly.</p>
-
- <p>If you are new to reporting problems, you might be interested in
- <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html"
- target="_top">How to Report Bugs Effectively</a>.</p>
-
- <p>The <a href=
- "http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
- target="_top">appendix of the Privoxy User Manual</a> also has
- helpful information on understanding <tt class=
- "LITERAL">actions</tt>, and <tt class="LITERAL">action</tt>
- debugging.</p>
</div>
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="CONTACT-FEATURE" id="CONTACT-FEATURE">8.3.
+ <h2 class="SECT2"><a name="CONTACT-FEATURE" id="CONTACT-FEATURE">8.4.
Request New Features</a></h2>
<p>You are welcome to submit ideas on new features or other proposals
@@ -304,7 +316,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="MAILING-LISTS" id="MAILING-LISTS">8.4.
+ <h2 class="SECT2"><a name="MAILING-LISTS" id="MAILING-LISTS">8.5.
Mailing Lists</a></h2>
<p>If you prefer to communicate through email, instead of using a web
diff --git a/doc/webserver/developer-manual/copyright.html b/doc/webserver/developer-manual/copyright.html
index de82e5c9..1ffe6a5e 100644
--- a/doc/webserver/developer-manual/copyright.html
+++ b/doc/webserver/developer-manual/copyright.html
@@ -50,7 +50,7 @@
"CITETITLE">GNU General Public License</i>.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN1232" id="AEN1232">9.1. License</a></h2>
+ <h2 class="SECT2"><a name="AEN1236" id="AEN1236">9.1. License</a></h2>
<p><span class="APPLICATION">Privoxy</span> is free software; you can
redistribute it and/or modify it under the terms of the <i class=
@@ -76,7 +76,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN1248" id="AEN1248">9.2. History</a></h2>
+ <h2 class="SECT2"><a name="AEN1252" id="AEN1252">9.2. History</a></h2>
<p>A long time ago, there was the <span class="APPLICATION">Internet
Junkbuster</span>, by Anonymous Coders and Junkbusters Corporation.
diff --git a/doc/webserver/developer-manual/index.html b/doc/webserver/developer-manual/index.html
index 71fc595d..b989dd58 100644
--- a/doc/webserver/developer-manual/index.html
+++ b/doc/webserver/developer-manual/index.html
@@ -325,26 +325,29 @@
<dd>
<dl>
- <dt>8.1. <a href="contact.html#CONTACT-SUPPORT">Get
+ <dt>8.1. <a href="contact.html#SUFFICIENT-INFORMATION">Please
+ provide sufficient information</a></dt>
+
+ <dt>8.2. <a href="contact.html#CONTACT-SUPPORT">Get
Support</a></dt>
- <dt>8.2. <a href="contact.html#REPORTING">Reporting
+ <dt>8.3. <a href="contact.html#REPORTING">Reporting
Problems</a></dt>
<dd>
<dl>
- <dt>8.2.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
+ <dt>8.3.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
or Other Configuration Problems</a></dt>
- <dt>8.2.2. <a href="contact.html#CONTACT-BUGS">Reporting
+ <dt>8.3.2. <a href="contact.html#CONTACT-BUGS">Reporting
Bugs</a></dt>
</dl>
</dd>
- <dt>8.3. <a href="contact.html#CONTACT-FEATURE">Request New
+ <dt>8.4. <a href="contact.html#CONTACT-FEATURE">Request New
Features</a></dt>
- <dt>8.4. <a href="contact.html#MAILING-LISTS">Mailing
+ <dt>8.5. <a href="contact.html#MAILING-LISTS">Mailing
Lists</a></dt>
</dl>
</dd>
@@ -354,9 +357,9 @@
<dd>
<dl>
- <dt>9.1. <a href="copyright.html#AEN1232">License</a></dt>
+ <dt>9.1. <a href="copyright.html#AEN1236">License</a></dt>
- <dt>9.2. <a href="copyright.html#AEN1248">History</a></dt>
+ <dt>9.2. <a href="copyright.html#AEN1252">History</a></dt>
</dl>
</dd>
diff --git a/doc/webserver/faq/contact.html b/doc/webserver/faq/contact.html
index ca2020e4..e8d9cf6c 100644
--- a/doc/webserver/faq/contact.html
+++ b/doc/webserver/faq/contact.html
@@ -45,10 +45,166 @@
<p>We value your feedback. In fact, we rely on it to improve <span class=
"APPLICATION">Privoxy</span> and its configuration. However, please note
- the following hints, so we can provide you with the best support:</p>
+ the following hints, so we can provide you with the best support.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="CONTACT-SUPPORT" id="CONTACT-SUPPORT">6.1.
+ <h2 class="SECT2"><a name="SUFFICIENT-INFORMATION" id=
+ "SUFFICIENT-INFORMATION">6.1. Please provide sufficient
+ information</a></h2>
+
+ <p>A lot of support requests don't contain enough information and can't
+ be solved without a lot of back and forth which causes unnecessary
+ delays. Reading this section should help to prevent that.</p>
+
+ <p>Before contacting us to report a problem, please try to verify that
+ it is a <span class="APPLICATION">Privoxy</span> problem, and not a
+ browser or site problem or documented behaviour that just happens to be
+ different than what you expected. If unsure, try <a href=
+ "http://config.privoxy.org/toggle?set=disable" target="_top">toggling
+ off</a> <span class="APPLICATION">Privoxy</span>, and see if the
+ problem persists.</p>
+
+ <p>If you are using your own custom configuration, please try the
+ default configuration 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.</p>
+
+ <p>If you aren't using the latest Privoxy version, the problem may have
+ been found and fixed in the meantime. We would appreciate if you could
+ take the time to <a href=
+ "http://www.privoxy.org/user-manual/installation.html" target=
+ "_top">upgrade to the latest version</a> and verify that the problem
+ still exists.</p>
+
+ <p>Please be sure to provide the following information when reporting
+ problems or requesting support:</p>
+
+ <ul>
+ <li>
+ <p>The exact <span class="APPLICATION">Privoxy</span> version you
+ are using.</p>
+ </li>
+
+ <li>
+ <p>The operating system and versions you run <span class=
+ "APPLICATION">Privoxy</span> on, e.g. <span class=
+ "APPLICATION">Windows XP SP2</span>.</p>
+ </li>
+
+ <li>
+ <p>The name, platform, and version of the <span class=
+ "APPLICATION">browser</span> you were using (e.g. <span class=
+ "APPLICATION">Internet Explorer v5.5</span> for Mac).</p>
+ </li>
+
+ <li>
+ <p>The URL where the problem occurred, or some way for us to
+ duplicate the problem (e.g. <tt class=
+ "LITERAL">http://somesite.example.com/?somethingelse=123</tt>).</p>
+ </li>
+
+ <li>
+ <p>Whether your version of <span class="APPLICATION">Privoxy</span>
+ is one supplied by the <span class="APPLICATION">Privoxy</span>
+ developers via SourceForge, or if you got your copy somewhere
+ else.</p>
+ </li>
+
+ <li>
+ <p>Whether you are using <span class="APPLICATION">Privoxy</span>
+ together with another proxy such as <span class=
+ "APPLICATION">Tor</span>. If so, please temporary disable the other
+ proxy to see if the symptoms change.</p>
+ </li>
+
+ <li>
+ <p>Whether you are using a personal firewall product. If so, does
+ <span class="APPLICATION">Privoxy</span> work without it?</p>
+ </li>
+
+ <li>
+ <p>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). To get a meaningful logfile, please
+ make sure that the <a href="../user-manual/config.html#LOGFILE"
+ target="_top">logfile directive</a> is being used and the following
+ <a href="../user-manual/config.html#DEBUG" target="_top">debug
+ options</a> are enabled (all of them):</p>
+
+ <p class="LITERALLAYOUT">
+ debug 1 # Log the destination for each request Privoxy let through. See also debug 1024.<br>
+
+ debug 2 # show each connection status<br>
+
+ debug 4 # show I/O status<br>
+
+ debug 8 # show header parsing<br>
+
+ debug 128 # debug redirects<br>
+ debug 256 # debug GIF de-animation<br>
+
+ debug 512 # Common Log Format<br>
+
+ debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why.<br>
+
+ debug 4096 # Startup banner and warnings.<br>
+
+ debug 8192 # Non-fatal errors</p>
+
+ <p>If you are having trouble with a filter, please additionally
+ enable</p>
+
+ <p class="LITERALLAYOUT">
+ debug 64 # debug regular expression filters</p>If
+ you are using Privoxy 3.0.17 or later and suspect that it
+ interprets the request or the response incorrectly, please enable
+
+ <p class="LITERALLAYOUT">
+ debug 32768 # log all data read from the network</p>
+
+ <p>It's easy for us to ignore log messages that aren't relevant but
+ missing log messages may make it impossible to investigate a
+ problem. If you aren't sure which of the debug directives are
+ relevant, please just enable all of them and let us worry about
+ it.</p>
+
+ <p>Note that Privoxy log files may contain sensitive information so
+ please don't submit any logfiles you didn't read first. You can
+ mask sensitive information as long as it's clear that you removed
+ something.</p>
+ </li>
+ </ul>
+
+ <p>You don't have to tell us your actual name when filing a problem
+ report, but if you don't, 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. Note that due to spam the trackers may not
+ always allow to post without being logged into SourceForge. If that's
+ the case, you are still free to create a login that isn't directly
+ linked to your name, though.</p>
+
+ <p>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 don't bother to add an email address when using
+ the tracker. If you prefer to communicate through email, just use one
+ of the mailing lists directly.</p>
+
+ <p>If you are new to reporting problems, you might be interested in
+ <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html" target=
+ "_top">How to Report Bugs Effectively</a>.</p>
+
+ <p>The <a href=
+ "http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" target=
+ "_top">appendix of the Privoxy User Manual</a> also has helpful
+ information on understanding <tt class="LITERAL">actions</tt>, and
+ <tt class="LITERAL">action</tt> debugging.</p>
+ </div>
+
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="CONTACT-SUPPORT" id="CONTACT-SUPPORT">6.2.
Get Support</a></h2>
<p>For casual users, our <a href=
@@ -87,7 +243,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="REPORTING" id="REPORTING">6.2. Reporting
+ <h2 class="SECT2"><a name="REPORTING" id="REPORTING">6.3. Reporting
Problems</a></h2>
<p><span class="QUOTE">"Problems"</span> for our purposes, come in two
@@ -109,7 +265,7 @@
</ul>
<div class="SECT3">
- <h3 class="SECT3"><a name="CONTACT-ADS" id="CONTACT-ADS">6.2.1.
+ <h3 class="SECT3"><a name="CONTACT-ADS" id="CONTACT-ADS">6.3.1.
Reporting Ads or Other Configuration Problems</a></h3>
<p>Please send feedback on ads that slipped through, innocent images
@@ -132,7 +288,7 @@
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="CONTACT-BUGS" id="CONTACT-BUGS">6.2.2.
+ <h3 class="SECT3"><a name="CONTACT-BUGS" id="CONTACT-BUGS">6.3.2.
Reporting Bugs</a></h3>
<p>Please report all bugs through our bug tracker: <a href=
@@ -147,155 +303,11 @@
target="_top">submit form</a>. If already submitted, please feel free
to add any info to the original report that might help to solve the
issue.</p>
-
- <p>Please try to verify that it is a <span class=
- "APPLICATION">Privoxy</span> bug, and not a browser or site bug or
- documented behaviour that just happens to be different than what you
- expected. If unsure, try <a href=
- "http://config.privoxy.org/toggle?set=disable" target="_top">toggling
- off</a> <span class="APPLICATION">Privoxy</span>, and see if the
- problem persists.</p>
-
- <p>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.</p>
-
- <p>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 <a href=
- "http://www.privoxy.org/user-manual/installation.html" target=
- "_top">upgrade to the latest version</a> (or even the latest CVS
- snapshot) and verify that your bug still exists.</p>
-
- <p>Please be sure to provide the following information:</p>
-
- <ul>
- <li>
- <p>The exact <span class="APPLICATION">Privoxy</span> version you
- are using (if you got the source from CVS, please also provide
- the source code revisions as shown in <a href=
- "http://config.privoxy.org/show-version" target=
- "_top">http://config.privoxy.org/show-version</a>).</p>
- </li>
-
- <li>
- <p>The operating system and versions you run <span class=
- "APPLICATION">Privoxy</span> on, (e.g. <span class=
- "APPLICATION">Windows XP SP2</span>), if you are using a Unix
- flavor, sending the output of <span class="QUOTE">"uname
- -a"</span> should do, in case of GNU/Linux, please also name the
- distribution.</p>
- </li>
-
- <li>
- <p>The name, platform, and version of the <span class=
- "APPLICATION">browser</span> you were using (e.g. <span class=
- "APPLICATION">Internet Explorer v5.5</span> for Mac).</p>
- </li>
-
- <li>
- <p>The URL where the problem occurred, or some way for us to
- duplicate the problem (e.g. <tt class=
- "LITERAL">http://somesite.example.com/?somethingelse=123</tt>).</p>
- </li>
-
- <li>
- <p>Whether your version of <span class=
- "APPLICATION">Privoxy</span> is one supplied by the <span class=
- "APPLICATION">Privoxy</span> developers via SourceForge, or if
- you got your copy somewhere else.</p>
- </li>
-
- <li>
- <p>Whether you are using <span class="APPLICATION">Privoxy</span>
- in tandem with another proxy such as <span class=
- "APPLICATION">Tor</span>. If so, please temporary disable the
- other proxy to see if the symptoms change.</p>
- </li>
-
- <li>
- <p>Whether you are using a personal firewall product. If so, does
- <span class="APPLICATION">Privoxy</span> work without it?</p>
- </li>
-
- <li>
- <p>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). To get a meaningful logfile,
- please make sure that the <a href=
- "../user-manual/config.html#LOGFILE" target="_top">logfile
- directive</a> is being used and the following <a href=
- "../user-manual/config.html#DEBUG" target="_top">debug
- options</a> are enabled:</p>
-
- <p class="LITERALLAYOUT">
- debug 1 # Log the destination for each request Privoxy let through. See also debug 1024.<br>
-
- debug 2 # show each connection status<br>
-
- debug 4 # show I/O status<br>
-
- debug 8 # show header parsing<br>
-
- debug 128 # debug redirects<br>
- debug 256 # debug GIF de-animation<br>
-
- debug 512 # Common Log Format<br>
-
- debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why.<br>
-
- debug 4096 # Startup banner and warnings.<br>
-
- debug 8192 # Non-fatal errors</p>If you
- are having trouble with a filter, please additionally enable
-
- <p class="LITERALLAYOUT">
- debug 64 # debug regular expression filters</p>If
- you are using Privoxy 3.0.17 or later and suspect that it
- interprets the request or the response incorrectly, please enable
-
- <p class="LITERALLAYOUT">
- debug 32768 # log all data read from the network</p>Note
- that Privoxy log files may contain sensitive information so
- please don't submit any logfiles you didn't read first. You can
- mask sensitive information as long as it's clear that you removed
- something.
- </li>
- </ul>
-
- <p>You don't have to tell us your actual name when filing a problem
- report, but if you don't, 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. Note that due to spam the
- trackers may not always allow to post without being logged into
- SourceForge. If that's the case, you are still free to create a login
- that isn't directly linked to your name, though.</p>
-
- <p>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 don't bother to add an email address when using
- the tracker. If you prefer to communicate through email, just use one
- of the mailing lists directly.</p>
-
- <p>If you are new to reporting problems, you might be interested in
- <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html"
- target="_top">How to Report Bugs Effectively</a>.</p>
-
- <p>The <a href=
- "http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
- target="_top">appendix of the Privoxy User Manual</a> also has
- helpful information on understanding <tt class=
- "LITERAL">actions</tt>, and <tt class="LITERAL">action</tt>
- debugging.</p>
</div>
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="CONTACT-FEATURE" id="CONTACT-FEATURE">6.3.
+ <h2 class="SECT2"><a name="CONTACT-FEATURE" id="CONTACT-FEATURE">6.4.
Request New Features</a></h2>
<p>You are welcome to submit ideas on new features or other proposals
@@ -305,7 +317,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="MAILING-LISTS" id="MAILING-LISTS">6.4.
+ <h2 class="SECT2"><a name="MAILING-LISTS" id="MAILING-LISTS">6.5.
Mailing Lists</a></h2>
<p>If you prefer to communicate through email, instead of using a web
diff --git a/doc/webserver/faq/copyright.html b/doc/webserver/faq/copyright.html
index f582fda1..177db393 100644
--- a/doc/webserver/faq/copyright.html
+++ b/doc/webserver/faq/copyright.html
@@ -55,7 +55,7 @@
"APPLICATION">Privoxy</span>.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN1466" id="AEN1466">7.1. License</a></h2>
+ <h2 class="SECT2"><a name="AEN1470" id="AEN1470">7.1. License</a></h2>
<p><span class="APPLICATION">Privoxy</span> is free software; you can
redistribute it and/or modify it under the terms of the <i class=
@@ -81,7 +81,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN1482" id="AEN1482">7.2. History</a></h2>
+ <h2 class="SECT2"><a name="AEN1486" id="AEN1486">7.2. History</a></h2>
<p>A long time ago, there was the <span class="APPLICATION">Internet
Junkbuster</span>, by Anonymous Coders and Junkbusters Corporation.
diff --git a/doc/webserver/faq/index.html b/doc/webserver/faq/index.html
index 5676d1a7..a1e52447 100644
--- a/doc/webserver/faq/index.html
+++ b/doc/webserver/faq/index.html
@@ -481,26 +481,29 @@
<dd>
<dl>
- <dt>6.1. <a href="contact.html#CONTACT-SUPPORT">Get
+ <dt>6.1. <a href="contact.html#SUFFICIENT-INFORMATION">Please
+ provide sufficient information</a></dt>
+
+ <dt>6.2. <a href="contact.html#CONTACT-SUPPORT">Get
Support</a></dt>
- <dt>6.2. <a href="contact.html#REPORTING">Reporting
+ <dt>6.3. <a href="contact.html#REPORTING">Reporting
Problems</a></dt>
<dd>
<dl>
- <dt>6.2.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
+ <dt>6.3.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
or Other Configuration Problems</a></dt>
- <dt>6.2.2. <a href="contact.html#CONTACT-BUGS">Reporting
+ <dt>6.3.2. <a href="contact.html#CONTACT-BUGS">Reporting
Bugs</a></dt>
</dl>
</dd>
- <dt>6.3. <a href="contact.html#CONTACT-FEATURE">Request New
+ <dt>6.4. <a href="contact.html#CONTACT-FEATURE">Request New
Features</a></dt>
- <dt>6.4. <a href="contact.html#MAILING-LISTS">Mailing
+ <dt>6.5. <a href="contact.html#MAILING-LISTS">Mailing
Lists</a></dt>
</dl>
</dd>
@@ -510,9 +513,9 @@
<dd>
<dl>
- <dt>7.1. <a href="copyright.html#AEN1466">License</a></dt>
+ <dt>7.1. <a href="copyright.html#AEN1470">License</a></dt>
- <dt>7.2. <a href="copyright.html#AEN1482">History</a></dt>
+ <dt>7.2. <a href="copyright.html#AEN1486">History</a></dt>
</dl>
</dd>
</dl>
diff --git a/doc/webserver/user-manual/actions-file.html b/doc/webserver/user-manual/actions-file.html
index 9df397ef..5a3ac071 100644
--- a/doc/webserver/user-manual/actions-file.html
+++ b/doc/webserver/user-manual/actions-file.html
@@ -117,7 +117,7 @@
in <tt class="FILENAME">default.action</tt> are:</p>
<div class="TABLE">
- <a name="AEN2807" id="AEN2807"></a>
+ <a name="AEN2774" id="AEN2774"></a>
<p><b>Table 1. Default Configurations</b></p>
@@ -314,7 +314,7 @@
actions</a>.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN2906" id="AEN2906">8.1. Finding the Right
+ <h2 class="SECT2"><a name="AEN2873" id="AEN2873">8.1. Finding the Right
Mix</a></h2>
<p>Note that some <a href="actions-file.html#ACTIONS">actions</a>, like
@@ -339,7 +339,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN2913" id="AEN2913">8.2. How to
+ <h2 class="SECT2"><a name="AEN2880" id="AEN2880">8.2. How to
Edit</a></h2>
<p>The easiest way to edit the actions files is with a browser by using
@@ -529,7 +529,7 @@
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN3025" id="AEN3025">8.4.1. The Domain
+ <h3 class="SECT3"><a name="AEN2992" id="AEN2992">8.4.1. The Domain
Pattern</a></h3>
<p>The matching of the domain part offers some flexible options: if
@@ -634,7 +634,7 @@
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN3101" id="AEN3101">8.4.2. The Path
+ <h3 class="SECT3"><a name="AEN3068" id="AEN3068">8.4.2. The Path
Pattern</a></h3>
<p><span class="APPLICATION">Privoxy</span> uses <span class=
@@ -4324,7 +4324,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN4773" id="AEN4773">8.5.35.
+ <h3 class="SECT3"><a name="AEN4740" id="AEN4740">8.5.35.
Summary</a></h3>
<p>Note that many of these actions have the potential to cause a page
@@ -4483,7 +4483,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not
together:</p>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN4837" id="AEN4837">8.7.1.
+ <h3 class="SECT3"><a name="AEN4804" id="AEN4804">8.7.1.
match-all.action</a></h3>
<p>Remember <span class="emphasis"><i class="EMPHASIS">all actions
@@ -4532,7 +4532,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN4859" id="AEN4859">8.7.2.
+ <h3 class="SECT3"><a name="AEN4826" id="AEN4826">8.7.2.
default.action</a></h3>
<p>If you aren't a developer, there's no need for you to edit the
@@ -4875,7 +4875,7 @@ wiki.
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN4972" id="AEN4972">8.7.3.
+ <h3 class="SECT3"><a name="AEN4939" id="AEN4939">8.7.3.
user.action</a></h3>
<p>So far we are painting with a broad brush by setting general
diff --git a/doc/webserver/user-manual/appendix.html b/doc/webserver/user-manual/appendix.html
index caee2e30..31238c81 100644
--- a/doc/webserver/user-manual/appendix.html
+++ b/doc/webserver/user-manual/appendix.html
@@ -293,7 +293,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN5853" id="AEN5853">14.2. Privoxy's
+ <h2 class="SECT2"><a name="AEN5824" id="AEN5824">14.2. Privoxy's
Internal Pages</a></h2>
<p>Since <span class="APPLICATION">Privoxy</span> proxies each
@@ -313,7 +313,7 @@
<ul>
<li>
- <p>Privoxy main page:</p><a name="AEN5867" id="AEN5867"></a>
+ <p>Privoxy main page:</p><a name="AEN5838" id="AEN5838"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/" target=
@@ -328,8 +328,8 @@
<li>
<p>Show information about the current configuration, including
- viewing and editing of actions files:</p><a name="AEN5875" id=
- "AEN5875"></a>
+ viewing and editing of actions files:</p><a name="AEN5846" id=
+ "AEN5846"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-status" target=
@@ -338,8 +338,8 @@
</li>
<li>
- <p>Show the source code version numbers:</p><a name="AEN5880" id=
- "AEN5880"></a>
+ <p>Show the source code version numbers:</p><a name="AEN5851" id=
+ "AEN5851"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-version" target=
@@ -348,8 +348,8 @@
</li>
<li>
- <p>Show the browser's request headers:</p><a name="AEN5885" id=
- "AEN5885"></a>
+ <p>Show the browser's request headers:</p><a name="AEN5856" id=
+ "AEN5856"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-request" target=
@@ -358,8 +358,8 @@
</li>
<li>
- <p>Show which actions apply to a URL and why:</p><a name="AEN5890"
- id="AEN5890"></a>
+ <p>Show which actions apply to a URL and why:</p><a name="AEN5861"
+ id="AEN5861"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-url-info" target=
@@ -373,20 +373,20 @@
<span class="QUOTE">"off"</span>, <span class=
"QUOTE">"Privoxy"</span> continues to run, but only as a
pass-through proxy, with no actions taking place:</p><a name=
- "AEN5898" id="AEN5898"></a>
+ "AEN5869" id="AEN5869"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/toggle" target=
"_top">http://config.privoxy.org/toggle</a></p>
</blockquote>
- <p>Short cuts. Turn off, then on:</p><a name="AEN5902" id=
- "AEN5902"></a>
+ <p>Short cuts. Turn off, then on:</p><a name="AEN5873" id=
+ "AEN5873"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/toggle?set=disable" target=
"_top">http://config.privoxy.org/toggle?set=disable</a></p>
- </blockquote><a name="AEN5905" id="AEN5905"></a>
+ </blockquote><a name="AEN5876" id="AEN5876"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/toggle?set=enable" target=
diff --git a/doc/webserver/user-manual/configuration.html b/doc/webserver/user-manual/configuration.html
index 25ec1d0f..f23a45af 100644
--- a/doc/webserver/user-manual/configuration.html
+++ b/doc/webserver/user-manual/configuration.html
@@ -46,7 +46,7 @@
controlled easily with a web browser.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN1056" id="AEN1056">6.1. Controlling
+ <h2 class="SECT2"><a name="AEN1023" id="AEN1023">6.1. Controlling
Privoxy with Your Web Browser</a></h2>
<p><span class="APPLICATION">Privoxy</span>'s user interface can be
@@ -63,8 +63,8 @@
</pre>
- <h2 class="BRIDGEHEAD"><a name="AEN1064" id=
- "AEN1064"></a> Privoxy Menu</h2>
+ <h2 class="BRIDGEHEAD"><a name="AEN1031" id=
+ "AEN1031"></a> Privoxy Menu</h2>
<pre>
</pre>
diff --git a/doc/webserver/user-manual/contact.html b/doc/webserver/user-manual/contact.html
index 96e35e1c..0024ac75 100644
--- a/doc/webserver/user-manual/contact.html
+++ b/doc/webserver/user-manual/contact.html
@@ -45,10 +45,166 @@
<p>We value your feedback. In fact, we rely on it to improve <span class=
"APPLICATION">Privoxy</span> and its configuration. However, please note
- the following hints, so we can provide you with the best support:</p>
+ the following hints, so we can provide you with the best support.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="CONTACT-SUPPORT" id="CONTACT-SUPPORT">11.1.
+ <h2 class="SECT2"><a name="SUFFICIENT-INFORMATION" id=
+ "SUFFICIENT-INFORMATION">11.1. Please provide sufficient
+ information</a></h2>
+
+ <p>A lot of support requests don't contain enough information and can't
+ be solved without a lot of back and forth which causes unnecessary
+ delays. Reading this section should help to prevent that.</p>
+
+ <p>Before contacting us to report a problem, please try to verify that
+ it is a <span class="APPLICATION">Privoxy</span> problem, and not a
+ browser or site problem or documented behaviour that just happens to be
+ different than what you expected. If unsure, try <a href=
+ "http://config.privoxy.org/toggle?set=disable" target="_top">toggling
+ off</a> <span class="APPLICATION">Privoxy</span>, and see if the
+ problem persists.</p>
+
+ <p>If you are using your own custom configuration, please try the
+ default configuration 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.</p>
+
+ <p>If you aren't using the latest Privoxy version, the problem may have
+ been found and fixed in the meantime. We would appreciate if you could
+ take the time to <a href=
+ "http://www.privoxy.org/user-manual/installation.html" target=
+ "_top">upgrade to the latest version</a> and verify that the problem
+ still exists.</p>
+
+ <p>Please be sure to provide the following information when reporting
+ problems or requesting support:</p>
+
+ <ul>
+ <li>
+ <p>The exact <span class="APPLICATION">Privoxy</span> version you
+ are using.</p>
+ </li>
+
+ <li>
+ <p>The operating system and versions you run <span class=
+ "APPLICATION">Privoxy</span> on, e.g. <span class=
+ "APPLICATION">Windows XP SP2</span>.</p>
+ </li>
+
+ <li>
+ <p>The name, platform, and version of the <span class=
+ "APPLICATION">browser</span> you were using (e.g. <span class=
+ "APPLICATION">Internet Explorer v5.5</span> for Mac).</p>
+ </li>
+
+ <li>
+ <p>The URL where the problem occurred, or some way for us to
+ duplicate the problem (e.g. <tt class=
+ "LITERAL">http://somesite.example.com/?somethingelse=123</tt>).</p>
+ </li>
+
+ <li>
+ <p>Whether your version of <span class="APPLICATION">Privoxy</span>
+ is one supplied by the <span class="APPLICATION">Privoxy</span>
+ developers via SourceForge, or if you got your copy somewhere
+ else.</p>
+ </li>
+
+ <li>
+ <p>Whether you are using <span class="APPLICATION">Privoxy</span>
+ together with another proxy such as <span class=
+ "APPLICATION">Tor</span>. If so, please temporary disable the other
+ proxy to see if the symptoms change.</p>
+ </li>
+
+ <li>
+ <p>Whether you are using a personal firewall product. If so, does
+ <span class="APPLICATION">Privoxy</span> work without it?</p>
+ </li>
+
+ <li>
+ <p>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). To get a meaningful logfile, please
+ make sure that the <a href="../user-manual/config.html#LOGFILE"
+ target="_top">logfile directive</a> is being used and the following
+ <a href="../user-manual/config.html#DEBUG" target="_top">debug
+ options</a> are enabled (all of them):</p>
+
+ <p class="LITERALLAYOUT">
+ debug 1 # Log the destination for each request Privoxy let through. See also debug 1024.<br>
+
+ debug 2 # show each connection status<br>
+
+ debug 4 # show I/O status<br>
+
+ debug 8 # show header parsing<br>
+
+ debug 128 # debug redirects<br>
+ debug 256 # debug GIF de-animation<br>
+
+ debug 512 # Common Log Format<br>
+
+ debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why.<br>
+
+ debug 4096 # Startup banner and warnings.<br>
+
+ debug 8192 # Non-fatal errors</p>
+
+ <p>If you are having trouble with a filter, please additionally
+ enable</p>
+
+ <p class="LITERALLAYOUT">
+ debug 64 # debug regular expression filters</p>If
+ you are using Privoxy 3.0.17 or later and suspect that it
+ interprets the request or the response incorrectly, please enable
+
+ <p class="LITERALLAYOUT">
+ debug 32768 # log all data read from the network</p>
+
+ <p>It's easy for us to ignore log messages that aren't relevant but
+ missing log messages may make it impossible to investigate a
+ problem. If you aren't sure which of the debug directives are
+ relevant, please just enable all of them and let us worry about
+ it.</p>
+
+ <p>Note that Privoxy log files may contain sensitive information so
+ please don't submit any logfiles you didn't read first. You can
+ mask sensitive information as long as it's clear that you removed
+ something.</p>
+ </li>
+ </ul>
+
+ <p>You don't have to tell us your actual name when filing a problem
+ report, but if you don't, 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. Note that due to spam the trackers may not
+ always allow to post without being logged into SourceForge. If that's
+ the case, you are still free to create a login that isn't directly
+ linked to your name, though.</p>
+
+ <p>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 don't bother to add an email address when using
+ the tracker. If you prefer to communicate through email, just use one
+ of the mailing lists directly.</p>
+
+ <p>If you are new to reporting problems, you might be interested in
+ <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html" target=
+ "_top">How to Report Bugs Effectively</a>.</p>
+
+ <p>The <a href=
+ "http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" target=
+ "_top">appendix of the Privoxy User Manual</a> also has helpful
+ information on understanding <tt class="LITERAL">actions</tt>, and
+ <tt class="LITERAL">action</tt> debugging.</p>
+ </div>
+
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="CONTACT-SUPPORT" id="CONTACT-SUPPORT">11.2.
Get Support</a></h2>
<p>For casual users, our <a href=
@@ -87,7 +243,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="REPORTING" id="REPORTING">11.2. Reporting
+ <h2 class="SECT2"><a name="REPORTING" id="REPORTING">11.3. Reporting
Problems</a></h2>
<p><span class="QUOTE">"Problems"</span> for our purposes, come in two
@@ -109,7 +265,7 @@
</ul>
<div class="SECT3">
- <h3 class="SECT3"><a name="CONTACT-ADS" id="CONTACT-ADS">11.2.1.
+ <h3 class="SECT3"><a name="CONTACT-ADS" id="CONTACT-ADS">11.3.1.
Reporting Ads or Other Configuration Problems</a></h3>
<p>Please send feedback on ads that slipped through, innocent images
@@ -132,7 +288,7 @@
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="CONTACT-BUGS" id="CONTACT-BUGS">11.2.2.
+ <h3 class="SECT3"><a name="CONTACT-BUGS" id="CONTACT-BUGS">11.3.2.
Reporting Bugs</a></h3>
<p>Please report all bugs through our bug tracker: <a href=
@@ -147,155 +303,11 @@
target="_top">submit form</a>. If already submitted, please feel free
to add any info to the original report that might help to solve the
issue.</p>
-
- <p>Please try to verify that it is a <span class=
- "APPLICATION">Privoxy</span> bug, and not a browser or site bug or
- documented behaviour that just happens to be different than what you
- expected. If unsure, try <a href=
- "http://config.privoxy.org/toggle?set=disable" target="_top">toggling
- off</a> <span class="APPLICATION">Privoxy</span>, and see if the
- problem persists.</p>
-
- <p>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.</p>
-
- <p>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 <a href=
- "http://www.privoxy.org/user-manual/installation.html" target=
- "_top">upgrade to the latest version</a> (or even the latest CVS
- snapshot) and verify that your bug still exists.</p>
-
- <p>Please be sure to provide the following information:</p>
-
- <ul>
- <li>
- <p>The exact <span class="APPLICATION">Privoxy</span> version you
- are using (if you got the source from CVS, please also provide
- the source code revisions as shown in <a href=
- "http://config.privoxy.org/show-version" target=
- "_top">http://config.privoxy.org/show-version</a>).</p>
- </li>
-
- <li>
- <p>The operating system and versions you run <span class=
- "APPLICATION">Privoxy</span> on, (e.g. <span class=
- "APPLICATION">Windows XP SP2</span>), if you are using a Unix
- flavor, sending the output of <span class="QUOTE">"uname
- -a"</span> should do, in case of GNU/Linux, please also name the
- distribution.</p>
- </li>
-
- <li>
- <p>The name, platform, and version of the <span class=
- "APPLICATION">browser</span> you were using (e.g. <span class=
- "APPLICATION">Internet Explorer v5.5</span> for Mac).</p>
- </li>
-
- <li>
- <p>The URL where the problem occurred, or some way for us to
- duplicate the problem (e.g. <tt class=
- "LITERAL">http://somesite.example.com/?somethingelse=123</tt>).</p>
- </li>
-
- <li>
- <p>Whether your version of <span class=
- "APPLICATION">Privoxy</span> is one supplied by the <span class=
- "APPLICATION">Privoxy</span> developers via SourceForge, or if
- you got your copy somewhere else.</p>
- </li>
-
- <li>
- <p>Whether you are using <span class="APPLICATION">Privoxy</span>
- in tandem with another proxy such as <span class=
- "APPLICATION">Tor</span>. If so, please temporary disable the
- other proxy to see if the symptoms change.</p>
- </li>
-
- <li>
- <p>Whether you are using a personal firewall product. If so, does
- <span class="APPLICATION">Privoxy</span> work without it?</p>
- </li>
-
- <li>
- <p>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). To get a meaningful logfile,
- please make sure that the <a href=
- "../user-manual/config.html#LOGFILE" target="_top">logfile
- directive</a> is being used and the following <a href=
- "../user-manual/config.html#DEBUG" target="_top">debug
- options</a> are enabled:</p>
-
- <p class="LITERALLAYOUT">
- debug 1 # Log the destination for each request Privoxy let through. See also debug 1024.<br>
-
- debug 2 # show each connection status<br>
-
- debug 4 # show I/O status<br>
-
- debug 8 # show header parsing<br>
-
- debug 128 # debug redirects<br>
- debug 256 # debug GIF de-animation<br>
-
- debug 512 # Common Log Format<br>
-
- debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why.<br>
-
- debug 4096 # Startup banner and warnings.<br>
-
- debug 8192 # Non-fatal errors</p>If you
- are having trouble with a filter, please additionally enable
-
- <p class="LITERALLAYOUT">
- debug 64 # debug regular expression filters</p>If
- you are using Privoxy 3.0.17 or later and suspect that it
- interprets the request or the response incorrectly, please enable
-
- <p class="LITERALLAYOUT">
- debug 32768 # log all data read from the network</p>Note
- that Privoxy log files may contain sensitive information so
- please don't submit any logfiles you didn't read first. You can
- mask sensitive information as long as it's clear that you removed
- something.
- </li>
- </ul>
-
- <p>You don't have to tell us your actual name when filing a problem
- report, but if you don't, 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. Note that due to spam the
- trackers may not always allow to post without being logged into
- SourceForge. If that's the case, you are still free to create a login
- that isn't directly linked to your name, though.</p>
-
- <p>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 don't bother to add an email address when using
- the tracker. If you prefer to communicate through email, just use one
- of the mailing lists directly.</p>
-
- <p>If you are new to reporting problems, you might be interested in
- <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html"
- target="_top">How to Report Bugs Effectively</a>.</p>
-
- <p>The <a href=
- "http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
- target="_top">appendix of the Privoxy User Manual</a> also has
- helpful information on understanding <tt class=
- "LITERAL">actions</tt>, and <tt class="LITERAL">action</tt>
- debugging.</p>
</div>
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="CONTACT-FEATURE" id="CONTACT-FEATURE">11.3.
+ <h2 class="SECT2"><a name="CONTACT-FEATURE" id="CONTACT-FEATURE">11.4.
Request New Features</a></h2>
<p>You are welcome to submit ideas on new features or other proposals
@@ -305,7 +317,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="MAILING-LISTS" id="MAILING-LISTS">11.4.
+ <h2 class="SECT2"><a name="MAILING-LISTS" id="MAILING-LISTS">11.5.
Mailing Lists</a></h2>
<p>If you prefer to communicate through email, instead of using a web
diff --git a/doc/webserver/user-manual/copyright.html b/doc/webserver/user-manual/copyright.html
index 875a830c..c55e69e8 100644
--- a/doc/webserver/user-manual/copyright.html
+++ b/doc/webserver/user-manual/copyright.html
@@ -51,7 +51,7 @@
"CITETITLE">GNU General Public License</i>.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN5609" id="AEN5609">12.1. License</a></h2>
+ <h2 class="SECT2"><a name="AEN5580" id="AEN5580">12.1. License</a></h2>
<p><span class="APPLICATION">Privoxy</span> is free software; you can
redistribute it and/or modify it under the terms of the <i class=
diff --git a/doc/webserver/user-manual/filter-file.html b/doc/webserver/user-manual/filter-file.html
index 9a95faaf..ad6f8087 100644
--- a/doc/webserver/user-manual/filter-file.html
+++ b/doc/webserver/user-manual/filter-file.html
@@ -151,7 +151,7 @@ FILTER: foo Replace all "foo" with "bar"
started.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN5127" id="AEN5127">9.1. Filter File
+ <h2 class="SECT2"><a name="AEN5094" id="AEN5094">9.1. Filter File
Tutorial</a></h2>
<p>Now, let's complete our <span class="QUOTE">"foo"</span> content
diff --git a/doc/webserver/user-manual/index.html b/doc/webserver/user-manual/index.html
index e0b68be3..6c891d0e 100644
--- a/doc/webserver/user-manual/index.html
+++ b/doc/webserver/user-manual/index.html
@@ -23,7 +23,7 @@
2001-2013 by <a href="http://www.privoxy.org/" target="_top">Privoxy
Developers</a></sub><br></p>
- <p class="PUBDATE">$Id: user-manual.sgml,v 2.163 2013/01/18 12:31:41
+ <p class="PUBDATE">$Id: user-manual.sgml,v 2.165 2013/01/20 18:10:28
fabiankeil Exp $<br></p>
<div>
@@ -153,25 +153,18 @@
<dd>
<dl>
- <dt>5.1. <a href="startup.html#START-REDHAT">Red Hat and
- Fedora</a></dt>
+ <dt>5.1. <a href="startup.html#START-DEBIAN">Debian</a></dt>
- <dt>5.2. <a href="startup.html#START-DEBIAN">Debian</a></dt>
+ <dt>5.2. <a href="startup.html#START-WINDOWS">Windows</a></dt>
- <dt>5.3. <a href="startup.html#START-WINDOWS">Windows</a></dt>
-
- <dt>5.4. <a href="startup.html#START-UNICES">Solaris, NetBSD,
+ <dt>5.3. <a href="startup.html#START-UNICES">Solaris, NetBSD,
FreeBSD, HP-UX and others</a></dt>
- <dt>5.5. <a href="startup.html#START-OS2">OS/2</a></dt>
-
- <dt>5.6. <a href="startup.html#START-MACOSX">Mac OS X</a></dt>
+ <dt>5.4. <a href="startup.html#START-OS2">OS/2</a></dt>
- <dt>5.7. <a href="startup.html#START-AMIGAOS">AmigaOS</a></dt>
+ <dt>5.5. <a href="startup.html#START-MACOSX">Mac OS X</a></dt>
- <dt>5.8. <a href="startup.html#START-GENTOO">Gentoo</a></dt>
-
- <dt>5.9. <a href="startup.html#CMDOPTIONS">Command Line
+ <dt>5.6. <a href="startup.html#CMDOPTIONS">Command Line
Options</a></dt>
</dl>
</dd>
@@ -180,7 +173,7 @@
<dd>
<dl>
- <dt>6.1. <a href="configuration.html#AEN1056">Controlling Privoxy
+ <dt>6.1. <a href="configuration.html#AEN1023">Controlling Privoxy
with Your Web Browser</a></dt>
<dt>6.2. <a href="configuration.html#CONFOVERVIEW">Configuration
@@ -349,10 +342,10 @@
<dd>
<dl>
- <dt>8.1. <a href="actions-file.html#AEN2906">Finding the Right
+ <dt>8.1. <a href="actions-file.html#AEN2873">Finding the Right
Mix</a></dt>
- <dt>8.2. <a href="actions-file.html#AEN2913">How to Edit</a></dt>
+ <dt>8.2. <a href="actions-file.html#AEN2880">How to Edit</a></dt>
<dt>8.3. <a href="actions-file.html#ACTIONS-APPLY">How Actions
are Applied to Requests</a></dt>
@@ -362,10 +355,10 @@
<dd>
<dl>
- <dt>8.4.1. <a href="actions-file.html#AEN3025">The Domain
+ <dt>8.4.1. <a href="actions-file.html#AEN2992">The Domain
Pattern</a></dt>
- <dt>8.4.2. <a href="actions-file.html#AEN3101">The Path
+ <dt>8.4.2. <a href="actions-file.html#AEN3068">The Path
Pattern</a></dt>
<dt>8.4.3. <a href="actions-file.html#TAG-PATTERN">The Tag
@@ -479,7 +472,7 @@
"actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt>
<dt>8.5.35. <a href=
- "actions-file.html#AEN4773">Summary</a></dt>
+ "actions-file.html#AEN4740">Summary</a></dt>
</dl>
</dd>
@@ -491,13 +484,13 @@
<dd>
<dl>
<dt>8.7.1. <a href=
- "actions-file.html#AEN4837">match-all.action</a></dt>
+ "actions-file.html#AEN4804">match-all.action</a></dt>
<dt>8.7.2. <a href=
- "actions-file.html#AEN4859">default.action</a></dt>
+ "actions-file.html#AEN4826">default.action</a></dt>
<dt>8.7.3. <a href=
- "actions-file.html#AEN4972">user.action</a></dt>
+ "actions-file.html#AEN4939">user.action</a></dt>
</dl>
</dd>
</dl>
@@ -507,7 +500,7 @@
<dd>
<dl>
- <dt>9.1. <a href="filter-file.html#AEN5127">Filter File
+ <dt>9.1. <a href="filter-file.html#AEN5094">Filter File
Tutorial</a></dt>
<dt>9.2. <a href="filter-file.html#PREDEFINED-FILTERS">The
@@ -522,26 +515,29 @@
<dd>
<dl>
- <dt>11.1. <a href="contact.html#CONTACT-SUPPORT">Get
+ <dt>11.1. <a href="contact.html#SUFFICIENT-INFORMATION">Please
+ provide sufficient information</a></dt>
+
+ <dt>11.2. <a href="contact.html#CONTACT-SUPPORT">Get
Support</a></dt>
- <dt>11.2. <a href="contact.html#REPORTING">Reporting
+ <dt>11.3. <a href="contact.html#REPORTING">Reporting
Problems</a></dt>
<dd>
<dl>
- <dt>11.2.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
+ <dt>11.3.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
or Other Configuration Problems</a></dt>
- <dt>11.2.2. <a href="contact.html#CONTACT-BUGS">Reporting
+ <dt>11.3.2. <a href="contact.html#CONTACT-BUGS">Reporting
Bugs</a></dt>
</dl>
</dd>
- <dt>11.3. <a href="contact.html#CONTACT-FEATURE">Request New
+ <dt>11.4. <a href="contact.html#CONTACT-FEATURE">Request New
Features</a></dt>
- <dt>11.4. <a href="contact.html#MAILING-LISTS">Mailing
+ <dt>11.5. <a href="contact.html#MAILING-LISTS">Mailing
Lists</a></dt>
</dl>
</dd>
@@ -551,7 +547,7 @@
<dd>
<dl>
- <dt>12.1. <a href="copyright.html#AEN5609">License</a></dt>
+ <dt>12.1. <a href="copyright.html#AEN5580">License</a></dt>
<dt>12.2. <a href="copyright.html#HISTORY">History</a></dt>
@@ -568,7 +564,7 @@
<dt>14.1. <a href="appendix.html#REGEX">Regular
Expressions</a></dt>
- <dt>14.2. <a href="appendix.html#AEN5853">Privoxy's Internal
+ <dt>14.2. <a href="appendix.html#AEN5824">Privoxy's Internal
Pages</a></dt>
<dd>
diff --git a/doc/webserver/user-manual/quickstart.html b/doc/webserver/user-manual/quickstart.html
index f44495bd..d33e87c8 100644
--- a/doc/webserver/user-manual/quickstart.html
+++ b/doc/webserver/user-manual/quickstart.html
@@ -343,7 +343,7 @@
"GUIBUTTON">Edit</span>"</span>:</p>
<div class="FIGURE">
- <a name="AEN803" id="AEN803"></a>
+ <a name="AEN799" id="AEN799"></a>
<p><b>Figure 1. Actions Files in Use</b></p>
diff --git a/doc/webserver/user-manual/startup.html b/doc/webserver/user-manual/startup.html
index 45545a6d..49c1d507 100644
--- a/doc/webserver/user-manual/startup.html
+++ b/doc/webserver/user-manual/startup.html
@@ -55,7 +55,7 @@
protocols.</p>
<div class="FIGURE">
- <a name="AEN858" id="AEN858"></a>
+ <a name="AEN854" id="AEN854"></a>
<p><b>Figure 2. Proxy Configuration Showing Mozilla/Netscape HTTP and
HTTPS (SSL) Settings</b></p>
@@ -112,7 +112,7 @@
only HTTP and HTTPS (SSL)!</p>
<div class="FIGURE">
- <a name="AEN903" id="AEN903"></a>
+ <a name="AEN899" id="AEN899"></a>
<p><b>Figure 3. Proxy Configuration Showing Internet Explorer HTTP and
HTTPS (Secure) Settings</b></p>
@@ -137,38 +137,7 @@
will try <tt class="FILENAME">config.txt</tt>.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="START-REDHAT" id="START-REDHAT">5.1. Red Hat
- and Fedora</a></h2>
-
- <p>A default Red Hat installation may not start <span class=
- "APPLICATION">Privoxy</span> upon boot. It will use the file <tt class=
- "FILENAME">/etc/privoxy/config</tt> as its main configuration file.</p>
-
- <table border="0" bgcolor="#E0E0E0" width="100%">
- <tr>
- <td>
- <pre class="SCREEN">
- # /etc/rc.d/init.d/privoxy start
-</pre>
- </td>
- </tr>
- </table>
-
- <p>Or ...</p>
-
- <table border="0" bgcolor="#E0E0E0" width="100%">
- <tr>
- <td>
- <pre class="SCREEN">
- # service privoxy start
-</pre>
- </td>
- </tr>
- </table>
- </div>
-
- <div class="SECT2">
- <h2 class="SECT2"><a name="START-DEBIAN" id="START-DEBIAN">5.2.
+ <h2 class="SECT2"><a name="START-DEBIAN" id="START-DEBIAN">5.1.
Debian</a></h2>
<p>We use a script. Note that Debian typically starts <span class=
@@ -188,7 +157,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="START-WINDOWS" id="START-WINDOWS">5.3.
+ <h2 class="SECT2"><a name="START-WINDOWS" id="START-WINDOWS">5.2.
Windows</a></h2>
<p>Click on the <span class="APPLICATION">Privoxy</span> Icon to start
@@ -209,7 +178,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="START-UNICES" id="START-UNICES">5.4.
+ <h2 class="SECT2"><a name="START-UNICES" id="START-UNICES">5.3.
Solaris, NetBSD, FreeBSD, HP-UX and others</a></h2>
<p>Example Unix startup command:</p>
@@ -226,7 +195,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="START-OS2" id="START-OS2">5.5. OS/2</a></h2>
+ <h2 class="SECT2"><a name="START-OS2" id="START-OS2">5.4. OS/2</a></h2>
<p>During installation, <span class="APPLICATION">Privoxy</span> is
configured to start automatically when the system restarts. You can
@@ -236,7 +205,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="START-MACOSX" id="START-MACOSX">5.6. Mac OS
+ <h2 class="SECT2"><a name="START-MACOSX" id="START-MACOSX">5.5. Mac OS
X</a></h2>
<p>After downloading the privoxy software, unzip the downloaded file by
@@ -264,55 +233,7 @@
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="START-AMIGAOS" id="START-AMIGAOS">5.7.
- AmigaOS</a></h2>
-
- <p>Start <span class="APPLICATION">Privoxy</span> (with RUN
- <>NIL:) in your <tt class="FILENAME">startnet</tt> script
- (AmiTCP), in <tt class="FILENAME">s:user-startup</tt> (RoadShow), as
- startup program in your startup script (Genesis), or as startup action
- (Miami and MiamiDx). <span class="APPLICATION">Privoxy</span> will
- automatically quit when you quit your TCP/IP stack (just ignore the
- harmless warning your TCP/IP stack may display that <span class=
- "APPLICATION">Privoxy</span> is still running).</p>
- </div>
-
- <div class="SECT2">
- <h2 class="SECT2"><a name="START-GENTOO" id="START-GENTOO">5.8.
- Gentoo</a></h2>
-
- <p>A script is again used. It will use the file <tt class=
- "FILENAME">/etc/privoxy/config</tt> as its main configuration file.</p>
-
- <table border="0" bgcolor="#E0E0E0" width="100%">
- <tr>
- <td>
- <pre class="SCREEN">
- /etc/init.d/privoxy start
-
-</pre>
- </td>
- </tr>
- </table>
-
- <p>Note that <span class="APPLICATION">Privoxy</span> is not
- automatically started at boot time by default. You can change this with
- the <tt class="LITERAL">rc-update</tt> command.</p>
-
- <table border="0" bgcolor="#E0E0E0" width="100%">
- <tr>
- <td>
- <pre class="SCREEN">
- rc-update add privoxy default
-
-</pre>
- </td>
- </tr>
- </table>
- </div>
-
- <div class="SECT2">
- <h2 class="SECT2"><a name="CMDOPTIONS" id="CMDOPTIONS">5.9. Command
+ <h2 class="SECT2"><a name="CMDOPTIONS" id="CMDOPTIONS">5.6. Command
Line Options</a></h2>
<p><span class="APPLICATION">Privoxy</span> may be invoked with the
diff --git a/doc/webserver/user-manual/whatsnew.html b/doc/webserver/user-manual/whatsnew.html
index 216cae84..57f52b5c 100644
--- a/doc/webserver/user-manual/whatsnew.html
+++ b/doc/webserver/user-manual/whatsnew.html
@@ -900,11 +900,6 @@
yourself.</p>
</li>
- <li>
- <p><tt class="FILENAME">standard.action</tt> has been merged into
- the <tt class="FILENAME">default.action</tt> file.</p>
- </li>
-
<li>
<p>In the default configuration only fatal errors are logged now.
You can change that in the <a href="config.html#DEBUG">debug