doc/webserver/user-manual/contact.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
   2 "http://www.w3.org/TR/html4/loose.dtd">
   3
   4 <html>
   5 <head>
   6   <title>Contacting the Developers, Bug Reporting and Feature
   7   Requests</title>
   8   <meta name="GENERATOR" content=
   9   "Modular DocBook HTML Stylesheet Version 1.79">
  10   <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html">
  11   <link rel="PREVIOUS" title="Privoxy's Template Files" href=
  12   "templates.html">
  13   <link rel="NEXT" title="Privoxy Copyright, License and History" href=
  14   "copyright.html">
  15   <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
  16   <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
  17   <link rel="STYLESHEET" type="text/css" href="p_doc.css">
  18 </head>
  19
  20 <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
  21 "#840084" alink="#0000FF">
  22   <div class="NAVHEADER">
  23     <table summary="Header navigation table" width="100%" border="0"
  24     cellpadding="0" cellspacing="0">
  25       <tr>
  26         <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th>
  27       </tr>
  28
  29       <tr>
  30         <td width="10%" align="left" valign="bottom"><a href="templates.html"
  31         accesskey="P">Prev</a></td>
  32
  33         <td width="80%" align="center" valign="bottom"></td>
  34
  35         <td width="10%" align="right" valign="bottom"><a href=
  36         "copyright.html" accesskey="N">Next</a></td>
  37       </tr>
  38     </table>
  39     <hr align="left" width="100%">
  40   </div>
  41
  42   <div class="SECT1">
  43     <h1 class="SECT1"><a name="CONTACT" id="CONTACT">11. Contacting the
  44     Developers, Bug Reporting and Feature Requests</a></h1>
  45
  46     <p>We value your feedback. In fact, we rely on it to improve <span class=
  47     "APPLICATION">Privoxy</span> and its configuration. However, please note
  48     the following hints, so we can provide you with the best support.</p>
  49
  50     <div class="SECT2">
  51       <h2 class="SECT2"><a name="SUFFICIENT-INFORMATION" id=
  52       "SUFFICIENT-INFORMATION">11.1. Please provide sufficient
  53       information</a></h2>
  54
  55       <p>A lot of support requests don't contain enough information and can't
  56       be solved without a lot of back and forth which causes unnecessary
  57       delays. Reading this section should help to prevent that.</p>
  58
  59       <p>Before contacting us to report a problem, please try to verify that
  60       it is a <span class="APPLICATION">Privoxy</span> problem, and not a
  61       browser or site problem or documented behaviour that just happens to be
  62       different than what you expected. If unsure, try <a href=
  63       "http://config.privoxy.org/toggle?set=disable" target="_top">toggling
  64       off</a> <span class="APPLICATION">Privoxy</span>, and see if the
  65       problem persists.</p>
  66
  67       <p>If you are using your own custom configuration, please try the
  68       default configuration to see if the problem is configuration related.
  69       If you're having problems with a feature that is disabled by default,
  70       please ask around on the mailing list if others can reproduce the
  71       problem.</p>
  72
  73       <p>If you aren't using the latest Privoxy version, the problem may have
  74       been found and fixed in the meantime. We would appreciate if you could
  75       take the time to <a href=
  76       "https://www.privoxy.org/user-manual/installation.html" target=
  77       "_top">upgrade to the latest version</a> and verify that the problem
  78       still exists.</p>
  79
  80       <p>Please be sure to provide the following information when reporting
  81       problems or requesting support:</p>
  82
  83       <ul>
  84         <li>
  85           <p>The exact <span class="APPLICATION">Privoxy</span> version you
  86           are using.</p>
  87         </li>
  88
  89         <li>
  90           <p>The operating system and versions you run <span class=
  91           "APPLICATION">Privoxy</span> on, e.g. <span class=
  92           "APPLICATION">Windows XP SP2</span>.</p>
  93         </li>
  94
  95         <li>
  96           <p>The name, platform, and version of the <span class=
  97           "APPLICATION">browser</span> you were using (e.g. <span class=
  98           "APPLICATION">Internet Explorer v5.5</span> for Mac).</p>
  99         </li>
 100
 101         <li>
 102           <p>The URL where the problem occurred, or some way for us to
 103           duplicate the problem (e.g. <tt class=
 104           "LITERAL">http://somesite.example.com/?somethingelse=123</tt>).</p>
 105         </li>
 106
 107         <li>
 108           <p>Whether your version of <span class="APPLICATION">Privoxy</span>
 109           is one supplied by the <span class="APPLICATION">Privoxy</span>
 110           developers via SourceForge, or if you got your copy somewhere
 111           else.</p>
 112         </li>
 113
 114         <li>
 115           <p>Whether you are using <span class="APPLICATION">Privoxy</span>
 116           together with another proxy such as <span class=
 117           "APPLICATION">Tor</span>. If so, please temporary disable the other
 118           proxy to see if the symptoms change.</p>
 119         </li>
 120
 121         <li>
 122           <p>Whether you are using a personal firewall product. If so, does
 123           <span class="APPLICATION">Privoxy</span> work without it?</p>
 124         </li>
 125
 126         <li>
 127           <p>Any other pertinent information to help identify the problem
 128           such as config or log file excerpts (yes, you should have log file
 129           entries for each action taken). To get a meaningful logfile, please
 130           make sure that the <a href="../user-manual/config.html#LOGFILE"
 131           target="_top">logfile directive</a> is being used and the following
 132           <a href="../user-manual/config.html#DEBUG" target="_top">debug
 133           options</a> are enabled (all of them):</p>
 134
 135           <p class="LITERALLAYOUT">
 136           debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;1&nbsp;#&nbsp;Log&nbsp;the&nbsp;destination&nbsp;for&nbsp;each&nbsp;request&nbsp;Privoxy&nbsp;let&nbsp;through.&nbsp;See&nbsp;also&nbsp;debug&nbsp;1024.<br>
 137
 138           debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;2&nbsp;#&nbsp;show&nbsp;each&nbsp;connection&nbsp;status<br>
 139
 140           debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;4&nbsp;#&nbsp;show&nbsp;I/O&nbsp;status<br>
 141
 142           debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;8&nbsp;#&nbsp;show&nbsp;header&nbsp;parsing<br>
 143
 144           debug&nbsp;&nbsp;&nbsp;128&nbsp;#&nbsp;debug&nbsp;redirects<br>
 145           debug&nbsp;&nbsp;&nbsp;256&nbsp;#&nbsp;debug&nbsp;GIF&nbsp;de-animation<br>
 146
 147           debug&nbsp;&nbsp;&nbsp;512&nbsp;#&nbsp;Common&nbsp;Log&nbsp;Format<br>
 148
 149           debug&nbsp;&nbsp;1024&nbsp;#&nbsp;Log&nbsp;the&nbsp;destination&nbsp;for&nbsp;requests&nbsp;Privoxy&nbsp;didn't&nbsp;let&nbsp;through,&nbsp;and&nbsp;the&nbsp;reason&nbsp;why.<br>
 150
 151           debug&nbsp;&nbsp;4096&nbsp;#&nbsp;Startup&nbsp;banner&nbsp;and&nbsp;warnings.<br>
 152
 153           debug&nbsp;&nbsp;8192&nbsp;#&nbsp;Non-fatal&nbsp;errors</p>
 154
 155           <p>If you are having trouble with a filter, please additionally
 156           enable</p>
 157
 158           <p class="LITERALLAYOUT">
 159           debug&nbsp;&nbsp;&nbsp;&nbsp;64&nbsp;#&nbsp;debug&nbsp;regular&nbsp;expression&nbsp;filters</p>If
 160           you are using Privoxy 3.0.17 or later and suspect that it
 161           interprets the request or the response incorrectly, please enable
 162
 163           <p class="LITERALLAYOUT">
 164           debug&nbsp;32768&nbsp;#&nbsp;log&nbsp;all&nbsp;data&nbsp;read&nbsp;from&nbsp;the&nbsp;network</p>
 165
 166           <p>It's easy for us to ignore log messages that aren't relevant but
 167           missing log messages may make it impossible to investigate a
 168           problem. If you aren't sure which of the debug directives are
 169           relevant, please just enable all of them and let us worry about
 170           it.</p>
 171
 172           <p>Note that Privoxy log files may contain sensitive information so
 173           please don't submit any logfiles you didn't read first. You can
 174           mask sensitive information as long as it's clear that you removed
 175           something.</p>
 176         </li>
 177       </ul>
 178
 179       <p>You don't have to tell us your actual name when filing a problem
 180       report, but if you don't, please use a nickname so we can differentiate
 181       between your messages and the ones entered by other "anonymous" users
 182       that may respond to your request if they have the same problem or
 183       already found a solution. Note that due to spam the trackers may not
 184       always allow to post without being logged into SourceForge. If that's
 185       the case, you are still free to create a login that isn't directly
 186       linked to your name, though.</p>
 187
 188       <p>Please also check the status of your request a few days after
 189       submitting it, as we may request additional information. If you use a
 190       SF id, you should automatically get a mail when someone responds to
 191       your request. Please don't bother to add an email address when using
 192       the tracker. If you prefer to communicate through email, just use one
 193       of the mailing lists directly.</p>
 194
 195       <p>If you are new to reporting problems, you might be interested in
 196       <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html" target=
 197       "_top">How to Report Bugs Effectively</a>.</p>
 198
 199       <p>The <a href=
 200       "https://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" target=
 201       "_top">appendix of the Privoxy User Manual</a> also has helpful
 202       information on understanding <tt class="LITERAL">actions</tt>, and
 203       <tt class="LITERAL">action</tt> debugging.</p>
 204     </div>
 205
 206     <div class="SECT2">
 207       <h2 class="SECT2"><a name="CONTACT-SUPPORT" id="CONTACT-SUPPORT">11.2.
 208       Get Support</a></h2>
 209
 210       <p>All users are welcome to discuss their issues on the <a href=
 211       "https://lists.sourceforge.net/lists/listinfo/ijbswa-users" target=
 212       "_top">users mailing list</a>, where the developers also hang
 213       around.</p>
 214
 215       <p>Please don't send private support requests to individual Privoxy
 216       developers, either use the mailing lists or the support trackers.</p>
 217
 218       <p>If you have to contact a Privoxy developer directly for other
 219       reasons, please send a real mail and do not bother with SourceForge's
 220       messaging system. Answers to SourceForge messages are usually bounced
 221       by SourceForge's mail server in which case the developer wasted time
 222       writing a response you don't get. From your point of view it will look
 223       like your message has been completely ignored, so this is frustrating
 224       for all parties involved.</p>
 225
 226       <p>Note that the Privoxy mailing lists are moderated. Posts from
 227       unsubscribed addresses have to be accepted manually by a moderator.
 228       This may cause a delay of several days and if you use a subject that
 229       doesn't clearly mention Privoxy or one of its features, your message
 230       may be accidentally discarded as spam.</p>
 231
 232       <p>If you aren't subscribed, you should therefore spend a few seconds
 233       to come up with a proper subject. Additionally you should make it clear
 234       that you want to get CC'd. Otherwise some responses will be directed to
 235       the mailing list only, and you won't see them.</p>
 236     </div>
 237
 238     <div class="SECT2">
 239       <h2 class="SECT2"><a name="REPORTING" id="REPORTING">11.3. Reporting
 240       Problems</a></h2>
 241
 242       <p><span class="QUOTE">"Problems"</span> for our purposes, come in two
 243       forms:</p>
 244
 245       <ul>
 246         <li>
 247           <p>Configuration issues, such as ads that slip through, or sites
 248           that don't function properly due to one <span class=
 249           "APPLICATION">Privoxy</span> <span class="QUOTE">"action"</span> or
 250           another being turned <span class="QUOTE">"on"</span>.</p>
 251         </li>
 252
 253         <li>
 254           <p><span class="QUOTE">"Bugs"</span> in the programming code that
 255           makes up <span class="APPLICATION">Privoxy</span>, such as that
 256           might cause a crash. Documentation issues, for example spelling
 257           errors and unclear descriptions, are bugs, too.</p>
 258         </li>
 259       </ul>
 260
 261       <div class="SECT3">
 262         <h3 class="SECT3"><a name="CONTACT-ADS" id="CONTACT-ADS">11.3.1.
 263         Reporting Ads or Other Configuration Problems</a></h3>
 264
 265         <p>Please send feedback on ads that slipped through, innocent images
 266         that were blocked, sites that don't work properly, and other
 267         configuration related problem of <tt class=
 268         "FILENAME">default.action</tt> file, to <a href=
 269         "https://sourceforge.net/tracker/?group_id=11118&amp;atid=460288"
 270         target=
 271         "_top">https://sourceforge.net/tracker/?group_id=11118&amp;atid=460288</a>,
 272         the Actions File Tracker.</p>
 273       </div>
 274
 275       <div class="SECT3">
 276         <h3 class="SECT3"><a name="CONTACT-BUGS" id="CONTACT-BUGS">11.3.2.
 277         Reporting Bugs</a></h3>
 278
 279         <p>Before reporting bugs, please make sure that the bug has
 280         <span class="emphasis"><i class="EMPHASIS">not already been
 281         submitted</i></span> and observe the additional hints at the top of
 282         the <a href=
 283         "https://sourceforge.net/tracker/?func=add&amp;group_id=11118&amp;atid=111118"
 284         target="_top">submit form</a>. If already submitted, please feel free
 285         to add any info to the original report that might help to solve the
 286         issue.</p>
 287       </div>
 288     </div>
 289
 290     <div class="SECT2">
 291       <h2 class="SECT2"><a name="SECURITY-CONTACT" id=
 292       "SECURITY-CONTACT">11.4. Reporting security problems</a></h2>
 293
 294       <p>If you discovered a security problem or merely suspect that a bug
 295       might be a security issue, please mail Fabian Keil
 296       &lt;fk@fabiankeil.de&gt; (OpenPGP fingerprint: 4F36 C17F 3816 9136 54A1
 297       E850 6918 2291 8BA2 371C).</p>
 298
 299       <p>Usually you should get a response within a day, otherwise it's
 300       likely that either your mail or the response didn't make it. If that
 301       happens, please mail to the developer list to request a status
 302       update.</p>
 303     </div>
 304
 305     <div class="SECT2">
 306       <h2 class="SECT2"><a name="MAILING-LISTS" id="MAILING-LISTS">11.5.
 307       Mailing Lists</a></h2>
 308
 309       <p>If you prefer to communicate through email, instead of using a web
 310       interface, feel free to use one of the mailing lists. To discuss issues
 311       that haven't been completely diagnosed yet, please use the Privoxy
 312       users list. Technically interested users and people who wish to
 313       contribute to the project are always welcome on the developers list.
 314       You can find an overview of all <span class=
 315       "APPLICATION">Privoxy</span>-related mailing lists, including list
 316       archives, at: <a href="https://sourceforge.net/mail/?group_id=11118"
 317       target="_top">https://sourceforge.net/mail/?group_id=11118</a>.</p>
 318     </div>
 319
 320     <div class="SECT2">
 321       <h2 class="SECT2"><a name="SF-TRACKERS" id="SF-TRACKERS">11.6.
 322       SourceForge support trackers</a></h2>
 323
 324       <p>The <a href=
 325       "https://sourceforge.net/tracker/?group_id=11118&amp;atid=211118"
 326       target="_top">SourceForge support trackers</a> may be used as well, but
 327       have various technical problems that are unlikely to be fixed anytime
 328       soon. If you don't get a timely response, please try the mailing list
 329       as well. While it's hosted at SourceForge as well, it usually works as
 330       expected.</p>
 331     </div>
 332   </div>
 333
 334   <div class="NAVFOOTER">
 335     <hr align="left" width="100%">
 336
 337     <table summary="Footer navigation table" width="100%" border="0"
 338     cellpadding="0" cellspacing="0">
 339       <tr>
 340         <td width="33%" align="left" valign="top"><a href="templates.html"
 341         accesskey="P">Prev</a></td>
 342
 343         <td width="34%" align="center" valign="top"><a href="index.html"
 344         accesskey="H">Home</a></td>
 345
 346         <td width="33%" align="right" valign="top"><a href="copyright.html"
 347         accesskey="N">Next</a></td>
 348       </tr>
 349
 350       <tr>
 351         <td width="33%" align="left" valign="top">Privoxy's Template
 352         Files</td>
 353
 354         <td width="34%" align="center" valign="top">&nbsp;</td>
 355
 356         <td width="33%" align="right" valign="top">Privoxy Copyright, License
 357         and History</td>
 358       </tr>
 359     </table>
 360   </div>
 361 </body>
 362 </html>