365 lines
16 KiB
HTML
365 lines
16 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
|
|
"http://www.w3.org/TR/html4/loose.dtd">
|
|
|
|
<html>
|
|
<head>
|
|
<meta name="generator" content=
|
|
"HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org">
|
|
|
|
<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 3.0.19 User Manual" href="index.html">
|
|
<link rel="PREVIOUS" title="Privoxy's Template Files" href=
|
|
"templates.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">
|
|
<link rel="STYLESHEET" type="text/css" href="p_doc.css">
|
|
<style type="text/css">
|
|
body {
|
|
background-color: #EEEEEE;
|
|
color: #000000;
|
|
}
|
|
:link { color: #0000FF }
|
|
:visited { color: #840084 }
|
|
:active { color: #0000FF }
|
|
span.c2 {font-style: italic}
|
|
hr.c1 {text-align: left}
|
|
</style>
|
|
</head>
|
|
|
|
<body class="SECT1">
|
|
<div class="NAVHEADER">
|
|
<table summary="Header navigation table" width="100%" border="0"
|
|
cellpadding="0" cellspacing="0">
|
|
<tr>
|
|
<th colspan="3" align="center">Privoxy 3.0.19 User Manual</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td width="10%" align="left" valign="bottom"><a href="templates.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 class="c1" width="100%">
|
|
</div>
|
|
|
|
<div class="SECT1">
|
|
<h1 class="SECT1"><a name="CONTACT" id="CONTACT">11. 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="CONTACT-SUPPORT" id="CONTACT-SUPPORT">11.1.
|
|
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">11.2. 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">11.2.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">11.2.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 EMPHASIS c2">not already been submitted</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>
|
|
|
|
<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.
|
|
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">11.4.
|
|
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 class="c1" 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="templates.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">Privoxy's Template
|
|
Files</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>
|