+++ /dev/null
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
-"http://www.w3.org/TR/html4/loose.dtd">
-
-<html>
-<head>
- <title>Contacting the developers, Bug Reporting and Feature
- Requests</title>
- <meta name="GENERATOR" content=
- "Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy Developer Manual" href="index.html">
- <link rel="PREVIOUS" title="Update the Webserver" href=
- "webserver-update.html">
- <link rel="NEXT" title="Privoxy Copyright, License and History" href=
- "copyright.html">
- <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
- <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
-</head>
-
-<body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
-"#840084" alink="#0000FF">
- <div class="NAVHEADER">
- <table summary="Header navigation table" width="100%" border="0"
- cellpadding="0" cellspacing="0">
- <tr>
- <th colspan="3" align="center">Privoxy Developer Manual</th>
- </tr>
-
- <tr>
- <td width="10%" align="left" valign="bottom"><a href=
- "webserver-update.html" accesskey="P">Prev</a></td>
-
- <td width="80%" align="center" valign="bottom"></td>
-
- <td width="10%" align="right" valign="bottom"><a href=
- "copyright.html" accesskey="N">Next</a></td>
- </tr>
- </table>
- <hr align="left" width="100%">
- </div>
-
- <div class="SECT1">
- <h1 class="SECT1"><a name="CONTACT" id="CONTACT">8. Contacting the
- developers, Bug Reporting and Feature Requests</a></h1>
-
- <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>
-
- <div class="SECT2">
- <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=
- "http://sourceforge.net/tracker/?group_id=11118&atid=211118"
- target="_top">support forum at SourceForge</a> is probably best suited:
- <a href=
- "http://sourceforge.net/tracker/?group_id=11118&atid=211118"
- target="_top">http://sourceforge.net/tracker/?group_id=11118&atid=211118</a></p>
-
- <p>All users are of course welcome to discuss their issues on the
- <a href="http://lists.sourceforge.net/lists/listinfo/ijbswa-users"
- target="_top">users mailing list</a>, where the developers also hang
- around.</p>
-
- <p>Please don't sent private support requests to individual Privoxy
- developers, either use the mailing lists or the support trackers.</p>
-
- <p>If you have to contact a Privoxy developer directly for other
- reasons, please send a real mail and do not bother with SourceForge's
- messaging system. Answers to SourceForge messages are usually bounced
- by SourceForge's mail server in which case the developer wasted time
- writing a response you don't get. From your point of view it will look
- like your message has been completely ignored, so this is frustrating
- for all parties involved.</p>
-
- <p>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.</p>
-
- <p>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.</p>
- </div>
-
- <div class="SECT2">
- <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
- forms:</p>
-
- <ul>
- <li>
- <p>Configuration issues, such as ads that slip through, or sites
- that don't function properly due to one <span class=
- "APPLICATION">Privoxy</span> <span class="QUOTE">"action"</span> or
- another being turned <span class="QUOTE">"on"</span>.</p>
- </li>
-
- <li>
- <p><span class="QUOTE">"Bugs"</span> in the programming code that
- makes up <span class="APPLICATION">Privoxy</span>, such as that
- might cause a crash.</p>
- </li>
- </ul>
-
- <div class="SECT3">
- <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
- that were blocked, sites that don't work properly, and other
- configuration related problem of <tt class=
- "FILENAME">default.action</tt> file, to <a href=
- "http://sourceforge.net/tracker/?group_id=11118&atid=460288"
- target=
- "_top">http://sourceforge.net/tracker/?group_id=11118&atid=460288</a>,
- the Actions File Tracker.</p>
-
- <p>New, improved <tt class="FILENAME">default.action</tt> files may
- occasionally be made available based on your feedback. These will be
- announced on the <a href=
- "http://lists.sourceforge.net/lists/listinfo/ijbswa-announce" target=
- "_top">ijbswa-announce</a> list and available from our the <a href=
- "http://sourceforge.net/project/showfiles.php?group_id=11118" target=
- "_top">files section</a> of our <a href=
- "http://sf.net/projects/ijbswa/" target="_top">project page</a>.</p>
- </div>
-
- <div class="SECT3">
- <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=
- "http://sourceforge.net/tracker/?group_id=11118&atid=111118"
- target=
- "_top">http://sourceforge.net/tracker/?group_id=11118&atid=111118</a>.</p>
-
- <p>Before doing so, please make sure that the bug has <span class=
- "emphasis"><i class="EMPHASIS">not already been submitted</i></span>
- and observe the additional hints at the top of the <a href=
- "http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118"
- 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>
- </div>
- </div>
-
- <div class="SECT2">
- <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
- for improvement through our feature request tracker at <a href=
- "http://sourceforge.net/tracker/?atid=361118&group_id=11118"
- target="_top">http://sourceforge.net/tracker/?atid=361118&group_id=11118</a>.</p>
- </div>
-
- <div class="SECT2">
- <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
- interface, feel free to use one of the mailing lists. To discuss issues
- that haven't been completely diagnosed yet, please use the Privoxy
- users list. Technically interested users and people who wish to
- contribute to the project are always welcome on the developers list.
- You can find an overview of all <span class=
- "APPLICATION">Privoxy</span>-related mailing lists, including list
- archives, at: <a href="http://sourceforge.net/mail/?group_id=11118"
- target="_top">http://sourceforge.net/mail/?group_id=11118</a>.</p>
- </div>
- </div>
-
- <div class="NAVFOOTER">
- <hr align="left" width="100%">
-
- <table summary="Footer navigation table" width="100%" border="0"
- cellpadding="0" cellspacing="0">
- <tr>
- <td width="33%" align="left" valign="top"><a href=
- "webserver-update.html" accesskey="P">Prev</a></td>
-
- <td width="34%" align="center" valign="top"><a href="index.html"
- accesskey="H">Home</a></td>
-
- <td width="33%" align="right" valign="top"><a href="copyright.html"
- accesskey="N">Next</a></td>
- </tr>
-
- <tr>
- <td width="33%" align="left" valign="top">Update the Webserver</td>
-
- <td width="34%" align="center" valign="top"> </td>
-
- <td width="33%" align="right" valign="top">Privoxy Copyright, License
- and History</td>
- </tr>
- </table>
- </div>
-</body>
-</html>
+++ /dev/null
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
-"http://www.w3.org/TR/html4/loose.dtd">
-
-<html>
-<head>
- <title>Privoxy Copyright, License and History</title>
- <meta name="GENERATOR" content=
- "Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy Developer Manual" href="index.html">
- <link rel="PREVIOUS" title=
- "Contacting the developers, Bug Reporting and Feature Requests" href=
- "contact.html">
- <link rel="NEXT" title="See also" href="seealso.html">
- <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
- <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
-</head>
-
-<body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
-"#840084" alink="#0000FF">
- <div class="NAVHEADER">
- <table summary="Header navigation table" width="100%" border="0"
- cellpadding="0" cellspacing="0">
- <tr>
- <th colspan="3" align="center">Privoxy Developer Manual</th>
- </tr>
-
- <tr>
- <td width="10%" align="left" valign="bottom"><a href="contact.html"
- accesskey="P">Prev</a></td>
-
- <td width="80%" align="center" valign="bottom"></td>
-
- <td width="10%" align="right" valign="bottom"><a href="seealso.html"
- accesskey="N">Next</a></td>
- </tr>
- </table>
- <hr align="left" width="100%">
- </div>
-
- <div class="SECT1">
- <h1 class="SECT1"><a name="COPYRIGHT" id="COPYRIGHT">9. Privoxy
- Copyright, License and History</a></h1>
-
- <p>Copyright © 2001-2013 by Privoxy Developers <code class=
- "EMAIL"><<a href=
- "mailto:ijbswa-developers@lists.sourceforge.net">ijbswa-developers@lists.sourceforge.net</a>></code></p>
-
- <p>Some source code is based on code Copyright © 1997 by Anonymous
- Coders and Junkbusters, Inc. and licensed under the <i class=
- "CITETITLE">GNU General Public License</i>.</p>
-
- <div class="SECT2">
- <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=
- "CITETITLE">GNU General Public License</i>, version 2, as published by
- the Free Software Foundation.</p>
-
- <p>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 <a href=
- "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target=
- "_top"><i class="CITETITLE">GNU General Public License</i></a> for
- details.</p>
-
- <p>You should have received a copy of the <i class="CITETITLE">GNU
- GPL</i> along with this program; if not, write to the</p>
-
- <p class="ADDRESS"> Free Software<br>
- Foundation, Inc. <span class="STREET">51 Franklin
- Street, Fifth Floor</span><br>
- <span class="CITY">Boston</span>, <span class=
- "STATE">MA</span> <span class="POSTCODE">02110-1301</span><br>
- <span class="COUNTRY">USA</span> </p>
- </div>
-
- <div class="SECT2">
- <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.
- This saved many users a lot of pain in the early days of web
- advertising and user tracking.</p>
-
- <p>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
- <span class="APPLICATION">Internet Junkbuster</span> did not. Version
- 2.0.2, published in 1998, was the last official release, available from
- Junkbusters Corporation. Fortunately, it had been released under the
- GNU <a href="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html"
- target="_top">GPL</a>, which allowed further development by others.</p>
-
- <p>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.</p>
-
- <p>Then, some <a href=
- "http://www.privoxy.org/user-manual/copyright.html#AUTHORS" target=
- "_top">developers</a> picked up the thread, and started turning the
- software inside out, upside down, and then reassembled it, adding many
- <a href="http://www.privoxy.org/user-manual/introduction.html#FEATURES"
- target="_top">new features</a> along the way.</p>
-
- <p>The result of this is <span class="APPLICATION">Privoxy</span>,
- whose first stable version, 3.0, was released August, 2002.</p>
-
- <p>As of 2012 the Junkbusters Corporation's website
- (http://www.junkbusters.com/) has been shut down, but Privoxy is still
- actively maintained.</p>
- </div>
- </div>
-
- <div class="NAVFOOTER">
- <hr align="left" width="100%">
-
- <table summary="Footer navigation table" width="100%" border="0"
- cellpadding="0" cellspacing="0">
- <tr>
- <td width="33%" align="left" valign="top"><a href="contact.html"
- accesskey="P">Prev</a></td>
-
- <td width="34%" align="center" valign="top"><a href="index.html"
- accesskey="H">Home</a></td>
-
- <td width="33%" align="right" valign="top"><a href="seealso.html"
- accesskey="N">Next</a></td>
- </tr>
-
- <tr>
- <td width="33%" align="left" valign="top">Contacting the developers,
- Bug Reporting and Feature Requests</td>
-
- <td width="34%" align="center" valign="top"> </td>
-
- <td width="33%" align="right" valign="top">See also</td>
- </tr>
- </table>
- </div>
-</body>
-</html>
<h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy Developer
Manual</a></h1>
- <p class="PUBDATE"><sub><a href="copyright.html">Copyright</a> ©
- 2001-2009 by <a href="http://www.privoxy.org/" target="_top">Privoxy
+ <p class="PUBDATE"><sub><a href=
+ "http://www.privoxy.org/user-manual/copyright.html" target=
+ "_top">Copyright</a> © 2001-2012 by <a href=
+ "http://www.privoxy.org/" target="_top">Privoxy
Developers</a></sub><br></p>
<p class="PUBDATE">$Id: developer-manual.sgml,v 2.53 2013/02/26
represents the state at the release of version 3.0.21. You can find
the latest version of the this manual at <a href=
"http://www.privoxy.org/developer-manual/" target=
- "_top">http://www.privoxy.org/developer-manual/</a>. Please see
- <a href="contact.html">the Contact section</a> on how to contact
- the developers.</p>
+ "_top">http://www.privoxy.org/developer-manual/</a>. Please have a
+ look at the <a href=
+ "http://www.privoxy.org/user-manual/contact.html" target=
+ "_top">contact section in the user manual</a> if you are interested
+ in contacting the developers.</p>
</div>
</div>
<hr>
</dd>
<dt>7. <a href="webserver-update.html">Update the Webserver</a></dt>
-
- <dt>8. <a href="contact.html">Contacting the developers, Bug
- Reporting and Feature Requests</a></dt>
-
- <dd>
- <dl>
- <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.3. <a href="contact.html#REPORTING">Reporting
- Problems</a></dt>
-
- <dd>
- <dl>
- <dt>8.3.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
- or Other Configuration Problems</a></dt>
-
- <dt>8.3.2. <a href="contact.html#CONTACT-BUGS">Reporting
- Bugs</a></dt>
- </dl>
- </dd>
-
- <dt>8.4. <a href="contact.html#CONTACT-FEATURE">Request New
- Features</a></dt>
-
- <dt>8.5. <a href="contact.html#MAILING-LISTS">Mailing
- Lists</a></dt>
- </dl>
- </dd>
-
- <dt>9. <a href="copyright.html">Privoxy Copyright, License and
- History</a></dt>
-
- <dd>
- <dl>
- <dt>9.1. <a href="copyright.html#AEN1236">License</a></dt>
-
- <dt>9.2. <a href="copyright.html#AEN1252">History</a></dt>
- </dl>
- </dd>
-
- <dt>10. <a href="seealso.html">See also</a></dt>
</dl>
</div>
</div>
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. <tt class="FILENAME">config</tt>, 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.</p>
+ (and the html version of the man page) 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.</p>
</li>
<li>
<tr>
<td>
<pre class="PROGRAMLISTING">
- debchange -v 3.0.21-UNRELEASED-1 "New upstream version"
+ debchange -v 3.0.21-stable-1 "New upstream version"
</pre>
</td>
</tr>
</table>
<p>This will create <tt class=
- "FILENAME">../privoxy_3.0.21-UNRELEASED-1_i386.deb</tt> which can be
+ "FILENAME">../privoxy_3.0.21-stable-1_i386.deb</tt> which can be
uploaded. To upload the package to Sourceforge, simply issue</p>
<table border="0" bgcolor="#E0E0E0" width="100%">
+++ /dev/null
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
-"http://www.w3.org/TR/html4/loose.dtd">
-
-<html>
-<head>
- <title>See also</title>
- <meta name="GENERATOR" content=
- "Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy Developer Manual" href="index.html">
- <link rel="PREVIOUS" title="Privoxy Copyright, License and History" href=
- "copyright.html">
- <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
- <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
-</head>
-
-<body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
-"#840084" alink="#0000FF">
- <div class="NAVHEADER">
- <table summary="Header navigation table" width="100%" border="0"
- cellpadding="0" cellspacing="0">
- <tr>
- <th colspan="3" align="center">Privoxy Developer Manual</th>
- </tr>
-
- <tr>
- <td width="10%" align="left" valign="bottom"><a href="copyright.html"
- accesskey="P">Prev</a></td>
-
- <td width="80%" align="center" valign="bottom"></td>
-
- <td width="10%" align="right" valign="bottom"> </td>
- </tr>
- </table>
- <hr align="left" width="100%">
- </div>
-
- <div class="SECT1">
- <h1 class="SECT1"><a name="SEEALSO" id="SEEALSO">10. See also</a></h1>
-
- <p>Other references and sites of interest to <span class=
- "APPLICATION">Privoxy</span> users:</p>
-
- <table border="0">
- <tbody>
- <tr>
- <td><a href="http://www.privoxy.org/" target=
- "_top">http://www.privoxy.org/</a>, the <span class=
- "APPLICATION">Privoxy</span> Home page.</td>
- </tr>
- </tbody>
- </table>
-
- <table border="0">
- <tbody>
- <tr>
- <td><a href="http://www.privoxy.org/faq/" target=
- "_top">http://www.privoxy.org/faq/</a>, the <span class=
- "APPLICATION">Privoxy</span> FAQ.</td>
- </tr>
- </tbody>
- </table>
-
- <table border="0">
- <tbody>
- <tr>
- <td><a href="http://www.privoxy.org/developer-manual/" target=
- "_top">http://www.privoxy.org/developer-manual/</a>, the
- <span class="APPLICATION">Privoxy</span> developer manual.</td>
- </tr>
- </tbody>
- </table>
-
- <table border="0">
- <tbody>
- <tr>
- <td><a href="https://sourceforge.net/projects/ijbswa/" target=
- "_top">https://sourceforge.net/projects/ijbswa/</a>, the Project
- Page for <span class="APPLICATION">Privoxy</span> on <a href=
- "http://sourceforge.net" target="_top">SourceForge</a>.</td>
- </tr>
- </tbody>
- </table>
-
- <table border="0">
- <tbody>
- <tr>
- <td><a href="http://config.privoxy.org/" target=
- "_top">http://config.privoxy.org/</a>, the web-based user
- interface. <span class="APPLICATION">Privoxy</span> must be running
- for this to work. Shortcut: <a href="http://p.p/" target=
- "_top">http://p.p/</a></td>
- </tr>
- </tbody>
- </table>
-
- <table border="0">
- <tbody>
- <tr>
- <td><a href=
- "https://sourceforge.net/tracker/?group_id=11118&atid=460288"
- target=
- "_top">https://sourceforge.net/tracker/?group_id=11118&atid=460288</a>,
- to submit <span class="QUOTE">"misses"</span> and other
- configuration related suggestions to the developers.</td>
- </tr>
- </tbody>
- </table>
-
- <table border="0">
- <tbody>
- <tr>
- <td><a href="http://www.squid-cache.org/" target=
- "_top">http://www.squid-cache.org/</a>, a popular caching proxy,
- which is often used together with <span class=
- "APPLICATION">Privoxy</span>.</td>
- </tr>
- </tbody>
- </table>
-
- <table border="0">
- <tbody>
- <tr>
- <td><a href="http://www.pps.jussieu.fr/~jch/software/polipo/"
- target="_top">http://www.pps.jussieu.fr/~jch/software/polipo/</a>,
- <span class="APPLICATION">Polipo</span> is a caching proxy with
- advanced features like pipelining, multiplexing and caching of
- partial instances. In many setups it can be used as <span class=
- "APPLICATION">Squid</span> replacement.</td>
- </tr>
- </tbody>
- </table>
-
- <table border="0">
- <tbody>
- <tr>
- <td><a href="https://www.torproject.org/" target=
- "_top">https://www.torproject.org/</a>, <span class=
- "APPLICATION">Tor</span> can help anonymize web browsing, web
- publishing, instant messaging, IRC, SSH, and other
- applications.</td>
- </tr>
- </tbody>
- </table>
- </div>
-
- <div class="NAVFOOTER">
- <hr align="left" width="100%">
-
- <table summary="Footer navigation table" width="100%" border="0"
- cellpadding="0" cellspacing="0">
- <tr>
- <td width="33%" align="left" valign="top"><a href="copyright.html"
- accesskey="P">Prev</a></td>
-
- <td width="34%" align="center" valign="top"><a href="index.html"
- accesskey="H">Home</a></td>
-
- <td width="33%" align="right" valign="top"> </td>
- </tr>
-
- <tr>
- <td width="33%" align="left" valign="top">Privoxy Copyright, License
- and History</td>
-
- <td width="34%" align="center" valign="top"> </td>
-
- <td width="33%" align="right" valign="top"> </td>
- </tr>
- </table>
- </div>
-</body>
-</html>
<link rel="HOME" title="Privoxy Developer Manual" href="index.html">
<link rel="PREVIOUS" title="Releasing a New Version" href=
"newrelease.html">
- <link rel="NEXT" title=
- "Contacting the developers, Bug Reporting and Feature Requests" href=
- "contact.html">
<link rel="STYLESHEET" type="text/css" href="../p_doc.css">
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
</head>
<td width="80%" align="center" valign="bottom"></td>
- <td width="10%" align="right" valign="bottom"><a href="contact.html"
- accesskey="N">Next</a></td>
+ <td width="10%" align="right" valign="bottom"> </td>
</tr>
</table>
<hr align="left" width="100%">
<tr>
<td>
<pre class="PROGRAMLISTING">
- make dok dok-pdf # (or 'make redhat-dok dok-pdf' if 'make dok' doesn't work for you)
+ make dok
</pre>
</td>
</tr>
"FILENAME">doc/webserver/user-manual</tt>, <tt class=
"FILENAME">doc/webserver/developer-manual</tt>, <tt class=
"FILENAME">doc/webserver/faq</tt>, <tt class=
- "FILENAME">doc/pdf/*.pdf</tt> and <tt class=
"FILENAME">doc/webserver/index.html</tt> automatically.</p>
<p>If you changed the manual page sources, generate <tt class=
<td width="34%" align="center" valign="top"><a href="index.html"
accesskey="H">Home</a></td>
- <td width="33%" align="right" valign="top"><a href="contact.html"
- accesskey="N">Next</a></td>
+ <td width="33%" align="right" valign="top"> </td>
</tr>
<tr>
<td width="34%" align="center" valign="top"> </td>
- <td width="33%" align="right" valign="top">Contacting the developers,
- Bug Reporting and Feature Requests</td>
+ <td width="33%" align="right" valign="top"> </td>
</tr>
</table>
</div>
"CITETITLE">GNU General Public License</i>, version 2, as published by
the Free Software Foundation.</p>
- <p>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 <a href=
- "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target=
- "_top"><i class="CITETITLE">GNU General Public License</i></a> for
- details.</p>
-
- <p>You should have received a copy of the <i class="CITETITLE">GNU
- GPL</i> along with this program; if not, write to the</p>
-
- <p class="ADDRESS"> Free Software<br>
- Foundation, Inc. <span class="STREET">51 Franklin
- Street, Fifth Floor</span><br>
- <span class="CITY">Boston</span>, <span class=
- "STATE">MA</span> <span class="POSTCODE">02110-1301</span><br>
- <span class="COUNTRY">USA</span> </p>
+ <p><span class="APPLICATION">Privoxy</span> 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 <a href=
+ "http://www.privoxy.org/user-manual/copyright.html#LICENSE" target=
+ "_top"><i class="CITETITLE">license</i></a> for details.</p>
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN1486" id="AEN1486">7.2. History</a></h2>
+ <h2 class="SECT2"><a name="AEN1479" id="AEN1479">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.
<dl>
<dt>7.1. <a href="copyright.html#AEN1470">License</a></dt>
- <dt>7.2. <a href="copyright.html#AEN1486">History</a></dt>
+ <dt>7.2. <a href="copyright.html#AEN1479">History</a></dt>
</dl>
</dd>
</dl>
</ul>
<p>The most recent release is <a href="announce.txt" target=
- "_top">3.0.21 (UNRELEASED)</a>.</p>
+ "_top">3.0.21 (stable)</a>.</p>
</div>
</div>
<hr>
in <tt class="FILENAME">default.action</tt> are:</p>
<div class="TABLE">
- <a name="AEN2830" id="AEN2830"></a>
+ <a name="AEN2822" id="AEN2822"></a>
<p><b>Table 1. Default Configurations</b></p>
actions</a>.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN2929" id="AEN2929">8.1. Finding the Right
+ <h2 class="SECT2"><a name="AEN2921" id="AEN2921">8.1. Finding the Right
Mix</a></h2>
<p>Note that some <a href="actions-file.html#ACTIONS">actions</a>, like
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN2936" id="AEN2936">8.2. How to
+ <h2 class="SECT2"><a name="AEN2928" id="AEN2928">8.2. How to
Edit</a></h2>
<p>The easiest way to edit the actions files is with a browser by using
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN3048" id="AEN3048">8.4.1. The Domain
+ <h3 class="SECT3"><a name="AEN3040" id="AEN3040">8.4.1. The Domain
Pattern</a></h3>
<p>The matching of the domain part offers some flexible options: if
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN3124" id="AEN3124">8.4.2. The Path
+ <h3 class="SECT3"><a name="AEN3116" id="AEN3116">8.4.2. The Path
Pattern</a></h3>
<p><span class="APPLICATION">Privoxy</span> uses <span class=
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN4796" id="AEN4796">8.5.35.
+ <h3 class="SECT3"><a name="AEN4788" id="AEN4788">8.5.35.
Summary</a></h3>
<p>Note that many of these actions have the potential to cause a page
together:</p>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN4860" id="AEN4860">8.7.1.
+ <h3 class="SECT3"><a name="AEN4852" id="AEN4852">8.7.1.
match-all.action</a></h3>
<p>Remember <span class="emphasis"><i class="EMPHASIS">all actions
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN4882" id="AEN4882">8.7.2.
+ <h3 class="SECT3"><a name="AEN4874" id="AEN4874">8.7.2.
default.action</a></h3>
<p>If you aren't a developer, there's no need for you to edit the
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN4995" id="AEN4995">8.7.3.
+ <h3 class="SECT3"><a name="AEN4987" id="AEN4987">8.7.3.
user.action</a></h3>
<p>So far we are painting with a broad brush by setting general
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN5871" id="AEN5871">14.2. Privoxy's
+ <h2 class="SECT2"><a name="AEN5863" id="AEN5863">14.2. Privoxy's
Internal Pages</a></h2>
<p>Since <span class="APPLICATION">Privoxy</span> proxies each
<ul>
<li>
- <p>Privoxy main page:</p><a name="AEN5885" id="AEN5885"></a>
+ <p>Privoxy main page:</p><a name="AEN5877" id="AEN5877"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/" target=
<li>
<p>Show information about the current configuration, including
- viewing and editing of actions files:</p><a name="AEN5893" id=
- "AEN5893"></a>
+ viewing and editing of actions files:</p><a name="AEN5885" id=
+ "AEN5885"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-status" target=
</li>
<li>
- <p>Show the source code version numbers:</p><a name="AEN5898" id=
- "AEN5898"></a>
+ <p>Show the source code version numbers:</p><a name="AEN5890" id=
+ "AEN5890"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-version" target=
</li>
<li>
- <p>Show the browser's request headers:</p><a name="AEN5903" id=
- "AEN5903"></a>
+ <p>Show the browser's request headers:</p><a name="AEN5895" id=
+ "AEN5895"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-request" target=
</li>
<li>
- <p>Show which actions apply to a URL and why:</p><a name="AEN5908"
- id="AEN5908"></a>
+ <p>Show which actions apply to a URL and why:</p><a name="AEN5900"
+ id="AEN5900"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-url-info" target=
<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=
- "AEN5916" id="AEN5916"></a>
+ "AEN5908" id="AEN5908"></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="AEN5920" id=
- "AEN5920"></a>
+ <p>Short cuts. Turn off, then on:</p><a name="AEN5912" id=
+ "AEN5912"></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="AEN5923" id="AEN5923"></a>
+ </blockquote><a name="AEN5915" id="AEN5915"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/toggle?set=enable" target=
controlled easily with a web browser.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN1076" id="AEN1076">6.1. Controlling
+ <h2 class="SECT2"><a name="AEN1070" id="AEN1070">6.1. Controlling
Privoxy with Your Web Browser</a></h2>
<p><span class="APPLICATION">Privoxy</span>'s user interface can be
</pre>
- <h2 class="BRIDGEHEAD"><a name="AEN1084" id=
- "AEN1084"></a> Privoxy Menu</h2>
+ <h2 class="BRIDGEHEAD"><a name="AEN1078" id=
+ "AEN1078"></a> Privoxy Menu</h2>
<pre>
</pre>
<p>For Unix, *BSD and Linux, all configuration files are located in
<tt class="FILENAME">/etc/privoxy/</tt> by default. For MS Windows,
OS/2, and AmigaOS these are all in the same directory as the
- <span class="APPLICATION">Privoxy</span> executable. The name and
- number of configuration files has changed from previous versions, and
- is subject to change as development progresses.</p>
+ <span class="APPLICATION">Privoxy</span> executable.</p>
<p>The installed defaults provide a reasonable starting point, though
some settings may be aggressive by some standards. For the time being,
"QUOTE">"wake up"</span> requests must obviously be sent to the
<span class="emphasis"><i class="EMPHASIS">old</i></span> listening
address.</p>
-
- <p>While under development, the configuration content is subject to
- change. The below documentation may not be accurate by the time you
- read this. Also, what constitutes a <span class=
- "QUOTE">"default"</span> setting, may change, so please check all your
- configuration files on important issues.</p>
</div>
</div>
the Free Software Foundation and included in the next section.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN5639" id="AEN5639">12.1. License</a></h2>
+ <h2 class="SECT2"><a name="LICENSE" id="LICENSE">12.1. License</a></h2>
<table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
started.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN5150" id="AEN5150">9.1. Filter File
+ <h2 class="SECT2"><a name="AEN5142" id="AEN5142">9.1. Filter File
Tutorial</a></h2>
<p>Now, let's complete our <span class="QUOTE">"foo"</span> content
from source</a></dt>
<dt>2.1.7. <a href=
- "installation.html#INSTALLATION-TBZ">FreeBSD</a></dt>
+ "installation.html#INSTALLATION-FREEBSD">FreeBSD</a></dt>
</dl>
</dd>
<dd>
<dl>
- <dt>6.1. <a href="configuration.html#AEN1076">Controlling Privoxy
+ <dt>6.1. <a href="configuration.html#AEN1070">Controlling Privoxy
with Your Web Browser</a></dt>
<dt>6.2. <a href="configuration.html#CONFOVERVIEW">Configuration
<dd>
<dl>
- <dt>8.1. <a href="actions-file.html#AEN2929">Finding the Right
+ <dt>8.1. <a href="actions-file.html#AEN2921">Finding the Right
Mix</a></dt>
- <dt>8.2. <a href="actions-file.html#AEN2936">How to Edit</a></dt>
+ <dt>8.2. <a href="actions-file.html#AEN2928">How to Edit</a></dt>
<dt>8.3. <a href="actions-file.html#ACTIONS-APPLY">How Actions
are Applied to Requests</a></dt>
<dd>
<dl>
- <dt>8.4.1. <a href="actions-file.html#AEN3048">The Domain
+ <dt>8.4.1. <a href="actions-file.html#AEN3040">The Domain
Pattern</a></dt>
- <dt>8.4.2. <a href="actions-file.html#AEN3124">The Path
+ <dt>8.4.2. <a href="actions-file.html#AEN3116">The Path
Pattern</a></dt>
<dt>8.4.3. <a href="actions-file.html#TAG-PATTERN">The Tag
"actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt>
<dt>8.5.35. <a href=
- "actions-file.html#AEN4796">Summary</a></dt>
+ "actions-file.html#AEN4788">Summary</a></dt>
</dl>
</dd>
<dd>
<dl>
<dt>8.7.1. <a href=
- "actions-file.html#AEN4860">match-all.action</a></dt>
+ "actions-file.html#AEN4852">match-all.action</a></dt>
<dt>8.7.2. <a href=
- "actions-file.html#AEN4882">default.action</a></dt>
+ "actions-file.html#AEN4874">default.action</a></dt>
<dt>8.7.3. <a href=
- "actions-file.html#AEN4995">user.action</a></dt>
+ "actions-file.html#AEN4987">user.action</a></dt>
</dl>
</dd>
</dl>
<dd>
<dl>
- <dt>9.1. <a href="filter-file.html#AEN5150">Filter File
+ <dt>9.1. <a href="filter-file.html#AEN5142">Filter File
Tutorial</a></dt>
<dt>9.2. <a href="filter-file.html#PREDEFINED-FILTERS">The
<dd>
<dl>
- <dt>12.1. <a href="copyright.html#AEN5639">License</a></dt>
+ <dt>12.1. <a href="copyright.html#LICENSE">License</a></dt>
<dt>12.2. <a href="copyright.html#HISTORY">History</a></dt>
<dt>14.1. <a href="appendix.html#REGEX">Regular
Expressions</a></dt>
- <dt>14.2. <a href="appendix.html#AEN5871">Privoxy's Internal
+ <dt>14.2. <a href="appendix.html#AEN5863">Privoxy's Internal
Pages</a></dt>
<dd>
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="INSTALLATION-TBZ" id=
- "INSTALLATION-TBZ">2.1.7. FreeBSD</a></h3>
+ <h3 class="SECT3"><a name="INSTALLATION-FREEBSD" id=
+ "INSTALLATION-FREEBSD">2.1.7. FreeBSD</a></h3>
<p>Privoxy is part of FreeBSD's Ports Collection, you can build and
install it with <tt class="LITERAL">cd /usr/ports/www/privoxy; make
install clean</tt>.</p>
-
- <p>If you don't use the ports, you can fetch and install the package
- with <tt class="LITERAL">pkg_add -r privoxy</tt>.</p>
-
- <p>The port skeleton and the package can also be downloaded from the
- <a href=
- "https://sourceforge.net/project/showfiles.php?group_id=11118"
- target="_top">File Release Page</a>, but there's no reason to use
- them unless you're interested in the beta releases which are only
- available there.</p>
</div>
</div>
<tr>
<td>
<pre class="SCREEN">
- tar xzvf privoxy-3.0.21-beta-src.tar.gz
- cd privoxy-3.0.21-beta
+ tar xzvf privoxy-3.0.21-stable-src.tar.gz
+ cd privoxy-3.0.21-stable
</pre>
</td>
</tr>
<h1 class="SECT1"><a name="INTRODUCTION" id="INTRODUCTION">1.
Introduction</a></h1>
- <p>This documentation is included with the current UNRELEASED version of
- <span class="APPLICATION">Privoxy</span>, v.3.0.21, and is mostly
- complete at this point. The most up to date reference for the time being
- is still the comments in the source files and in the individual
- configuration files. Development of a new version is currently nearing
- completion, and includes significant changes and enhancements over
- earlier versions.</p>
-
- <p>Since this is a UNRELEASED version, not all new features are well
- tested. This documentation may be slightly out of sync as a result
- (especially with CVS sources). And there <span class="emphasis"><i class=
- "EMPHASIS">may be</i></span> bugs, though hopefully not many!</p>
+ <p>This documentation is included with the current stable version of
+ <span class="APPLICATION">Privoxy</span>, 3.0.21.</p>
<div class="SECT2">
<h2 class="SECT2"><a name="FEATURES" id="FEATURES">1.1.
<p>In addition to the core features of ad blocking and <a href=
"http://en.wikipedia.org/wiki/Browser_cookie" target="_top">cookie</a>
management, <span class="APPLICATION">Privoxy</span> provides many
- supplemental features, some of them currently under development, that
- give the end-user more control, more privacy and more freedom:</p>
+ supplemental features, that give the end-user more control, more
+ privacy and more freedom:</p>
<ul>
<li>
"GUIBUTTON">Edit</span>"</span>:</p>
<div class="FIGURE">
- <a name="AEN852" id="AEN852"></a>
+ <a name="AEN846" id="AEN846"></a>
<p><b>Figure 1. Actions Files in Use</b></p>
protocols.</p>
<div class="FIGURE">
- <a name="AEN907" id="AEN907"></a>
+ <a name="AEN901" id="AEN901"></a>
<p><b>Figure 2. Proxy Configuration Showing Mozilla/Netscape HTTP and
HTTPS (SSL) Settings</b></p>
only HTTP and HTTPS (SSL)!</p>
<div class="FIGURE">
- <a name="AEN952" id="AEN952"></a>
+ <a name="AEN946" id="AEN946"></a>
<p><b>Figure 3. Proxy Configuration Showing Internet Explorer HTTP and
HTTPS (Secure) Settings</b></p>
projects / privoxy.git / commitdiff