Renerate for 3.0.21 UNRELEASED
[privoxy.git] / doc / webserver / user-manual / contact.html
index b414700..40f8fd9 100644 (file)
-<HTML
-><HEAD
-><TITLE
->Contacting the Developers, Bug Reporting and Feature
-Requests</TITLE
-><META
-NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
-REL="HOME"
-TITLE="Privoxy User Manual"
-HREF="index.html"><LINK
-REL="PREVIOUS"
-TITLE="Privoxy Configuration"
-HREF="configuration.html"><LINK
-REL="NEXT"
-TITLE="Copyright and History"
-HREF="copyright.html"><LINK
-REL="STYLESHEET"
-TYPE="text/css"
-HREF="../p_doc.css"></HEAD
-><BODY
-CLASS="SECT1"
-BGCOLOR="#EEEEEE"
-TEXT="#000000"
-LINK="#0000FF"
-VLINK="#840084"
-ALINK="#0000FF"
-><DIV
-CLASS="NAVHEADER"
-><TABLE
-WIDTH="100%"
-BORDER="0"
-CELLPADDING="0"
-CELLSPACING="0"
-><TR
-><TH
-COLSPAN="3"
-ALIGN="center"
->Privoxy User Manual</TH
-></TR
-><TR
-><TD
-WIDTH="10%"
-ALIGN="left"
-VALIGN="bottom"
-><A
-HREF="configuration.html"
->Prev</A
-></TD
-><TD
-WIDTH="80%"
-ALIGN="center"
-VALIGN="bottom"
-></TD
-><TD
-WIDTH="10%"
-ALIGN="right"
-VALIGN="bottom"
-><A
-HREF="copyright.html"
->Next</A
-></TD
-></TR
-></TABLE
-><HR
-ALIGN="LEFT"
-WIDTH="100%"></DIV
-><DIV
-CLASS="SECT1"
-><H1
-CLASS="SECT1"
-><A
-NAME="CONTACT"
->6. Contacting the Developers, Bug Reporting and Feature
-Requests</A
-></H1
-><P
-> We value your feedback. However, to provide you with the best support, please
- note:
-
- <P
-></P
-><UL
-><LI
-><P
-CLASS="LITERALLAYOUT"
->&nbsp;Use&nbsp;the&nbsp;Sourceforge&nbsp;Support&nbsp;Forum&nbsp;to&nbsp;get&nbsp;help:<br>
-&nbsp;&nbsp;&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;<A
-HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118"
-TARGET="_top"
->http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118</A
-><br>
-&nbsp;&nbsp;&nbsp;</P
-></LI
-><LI
-><P
-CLASS="LITERALLAYOUT"
->&nbsp;Submit&nbsp;bugs&nbsp;only&nbsp;through&nbsp;our&nbsp;Sourceforge&nbsp;Bug&nbsp;Forum:<br>
-&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;<A
-HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118"
-TARGET="_top"
->http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118</A
->.&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;</P
-><P
->   Make sure that the bug has not already been submitted.  Please try to
-   verify that it is a <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> bug, and not a
-   browser or site bug first. If you are using your own custom configuration,
-   please try the stock configs to see if the problem is a configuration
-   related bug.  And if not using the latest development snapshot, please try
-   the latest one. Or even better, CVS sources. Please be sure to include the
-   <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
->/<SPAN
-CLASS="APPLICATION"
->Junkbuster</SPAN
->
-   version, platform, browser, any pertinent log data, any other relevant
-   details (please be specific) and, if possible, some way to reproduce the
-   bug.
-  </P
-></LI
-><LI
-><P
-CLASS="LITERALLAYOUT"
->&nbsp;Submit&nbsp;feature&nbsp;requests&nbsp;only&nbsp;through&nbsp;our&nbsp;Sourceforge&nbsp;feature&nbsp;request&nbsp;forum:<br>
-&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;<A
-HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse"
-TARGET="_top"
->http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118&#38;func=browse</A
->.<br>
-&nbsp;&nbsp;&nbsp;</P
-></LI
-><LI
-><P
-CLASS="LITERALLAYOUT"
->&nbsp;Submit&nbsp;missed&nbsp;ads&nbsp;and&nbsp;banners,&nbsp;and&nbsp;incorrectly&nbsp;blocked&nbsp;images,&nbsp;popups,&nbsp;etc:<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;<A
-HREF="http://p.p/"
-TARGET="_top"
->http://p.p/</A
->,&nbsp;and&nbsp;select&nbsp;<A
-HREF="javascript:w=Math.floor(screen.width/2);h=Math.floor(screen.height*0.9);void(window.open('http://www.privoxy.org/actions','Feedback','screenx='+w+',width='+w+',height='+h+',scrollbars=yes,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());"
-TARGET="_top"
-><SPAN
-CLASS="QUOTE"
->"actions file feedback system"</SPAN
-></A
-><br>
-&nbsp;&nbsp;&nbsp;</P
-><P
->    This page can also be reached from many of the internal CGI pages.
-   </P
-></LI
-><LI
-><P
-CLASS="LITERALLAYOUT"
->&nbsp;For&nbsp;any&nbsp;other&nbsp;issues,&nbsp;feel&nbsp;free&nbsp;to&nbsp;use&nbsp;the&nbsp;mailing&nbsp;lists:<br>
-&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;<A
-HREF="http://sourceforge.net/mail/?group_id=11118"
-TARGET="_top"
->http://sourceforge.net/mail/?group_id=11118</A
->.<br>
-&nbsp;</P
-><P
->  Anyone interested in actively participating in development and related
-  discussions can also join the appropriate mailing list. Archives are
-  available too. 
- </P
-></LI
-></UL
-></P
-></DIV
-><DIV
-CLASS="NAVFOOTER"
-><HR
-ALIGN="LEFT"
-WIDTH="100%"><TABLE
-WIDTH="100%"
-BORDER="0"
-CELLPADDING="0"
-CELLSPACING="0"
-><TR
-><TD
-WIDTH="33%"
-ALIGN="left"
-VALIGN="top"
-><A
-HREF="configuration.html"
->Prev</A
-></TD
-><TD
-WIDTH="34%"
-ALIGN="center"
-VALIGN="top"
-><A
-HREF="index.html"
->Home</A
-></TD
-><TD
-WIDTH="33%"
-ALIGN="right"
-VALIGN="top"
-><A
-HREF="copyright.html"
->Next</A
-></TD
-></TR
-><TR
-><TD
-WIDTH="33%"
-ALIGN="left"
-VALIGN="top"
-><SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> Configuration</TD
-><TD
-WIDTH="34%"
-ALIGN="center"
-VALIGN="top"
->&nbsp;</TD
-><TD
-WIDTH="33%"
-ALIGN="right"
-VALIGN="top"
->Copyright and History</TD
-></TR
-></TABLE
-></DIV
-></BODY
-></HTML
->
\ No newline at end of file
+<!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 3.0.21 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">
+</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 3.0.21 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 align="left" 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="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&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>
+
+          debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;2&nbsp;#&nbsp;show&nbsp;each&nbsp;connection&nbsp;status<br>
+
+          debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;4&nbsp;#&nbsp;show&nbsp;I/O&nbsp;status<br>
+
+          debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;8&nbsp;#&nbsp;show&nbsp;header&nbsp;parsing<br>
+
+          debug&nbsp;&nbsp;&nbsp;128&nbsp;#&nbsp;debug&nbsp;redirects<br>
+          debug&nbsp;&nbsp;&nbsp;256&nbsp;#&nbsp;debug&nbsp;GIF&nbsp;de-animation<br>
+
+          debug&nbsp;&nbsp;&nbsp;512&nbsp;#&nbsp;Common&nbsp;Log&nbsp;Format<br>
+
+          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>
+
+          debug&nbsp;&nbsp;4096&nbsp;#&nbsp;Startup&nbsp;banner&nbsp;and&nbsp;warnings.<br>
+
+          debug&nbsp;&nbsp;8192&nbsp;#&nbsp;Non-fatal&nbsp;errors</p>
+
+          <p>If you are having trouble with a filter, please additionally
+          enable</p>
+
+          <p class="LITERALLAYOUT">
+          debug&nbsp;&nbsp;&nbsp;&nbsp;64&nbsp;#&nbsp;debug&nbsp;regular&nbsp;expression&nbsp;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&nbsp;32768&nbsp;#&nbsp;log&nbsp;all&nbsp;data&nbsp;read&nbsp;from&nbsp;the&nbsp;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=
+      "http://sourceforge.net/tracker/?group_id=11118&amp;atid=211118"
+      target="_top">support forum at SourceForge</a> is probably best suited:
+      <a href=
+      "http://sourceforge.net/tracker/?group_id=11118&amp;atid=211118"
+      target="_top">http://sourceforge.net/tracker/?group_id=11118&amp;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.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">11.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&amp;atid=460288"
+        target=
+        "_top">http://sourceforge.net/tracker/?group_id=11118&amp;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.3.2.
+        Reporting Bugs</a></h3>
+
+        <p>Please report all bugs through our bug tracker: <a href=
+        "http://sourceforge.net/tracker/?group_id=11118&amp;atid=111118"
+        target=
+        "_top">http://sourceforge.net/tracker/?group_id=11118&amp;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&amp;group_id=11118&amp;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">11.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&amp;group_id=11118"
+      target="_top">http://sourceforge.net/tracker/?atid=361118&amp;group_id=11118</a>.</p>
+    </div>
+
+    <div class="SECT2">
+      <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
+      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="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">&nbsp;</td>
+
+        <td width="33%" align="right" valign="top">Privoxy Copyright, License
+        and History</td>
+      </tr>
+    </table>
+  </div>
+</body>
+</html>