Rebuild for 3.0.17 stable
[privoxy.git] / doc / webserver / user-manual / contact.html
index 702a415..e03c353 100644 (file)
@@ -1,3 +1,4 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
 <HTML
 ><HEAD
 ><TITLE
@@ -5,10 +6,9 @@
 Requests</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
 REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.17 User Manual"
 HREF="index.html"><LINK
 REL="PREVIOUS"
 TITLE="Privoxy's Template Files"
@@ -18,7 +18,10 @@ TITLE="Privoxy Copyright, License and History"
 HREF="copyright.html"><LINK
 REL="STYLESHEET"
 TYPE="text/css"
-HREF="../p_doc.css">
+HREF="../p_doc.css"><META
+HTTP-EQUIV="Content-Type"
+CONTENT="text/html;
+charset=ISO-8859-1">
 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
 </head
 ><BODY
@@ -40,7 +43,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy 3.0.6 User Manual</TH
+>Privoxy 3.0.17 User Manual</TH
 ></TR
 ><TR
 ><TD
@@ -77,9 +80,9 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="CONTACT"
-></A
 >11. Contacting the Developers, Bug Reporting and Feature
-Requests</H1
+Requests</A
+></H1
 ><P
 > We value your feedback. In fact, we rely on it to improve
  <SPAN
@@ -94,18 +97,18 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-SUPPORT"
-></A
->11.1. Get Support</H2
+>11.1. Get Support</A
+></H2
 ><P
 > For casual users, our 
  <A
-HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118"
+HREF="http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118"
 TARGET="_top"
 >support forum at SourceForge</A
 >
  is probably best suited:
  <A
-HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118"
+HREF="http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118"
 TARGET="_top"
 >http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118</A
 ></P
@@ -116,6 +119,20 @@ 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
+> 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"
@@ -123,8 +140,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="REPORTING"
-></A
->11.2. Reporting Problems</H2
+>11.2. Reporting Problems</A
+></H2
 ><P
 ><SPAN
 CLASS="QUOTE"
@@ -168,8 +185,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="CONTACT-ADS"
-></A
->11.2.1. Reporting Ads or Other Configuration Problems</H3
+>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 
@@ -178,7 +195,7 @@ CLASS="FILENAME"
 >default.action</TT
 > file, to 
  <A
-HREF="http://sourceforge.net/tracker/?group_id=11118&atid=460288"
+HREF="http://sourceforge.net/tracker/?group_id=11118&#38;atid=460288"
 TARGET="_top"
 > http://sourceforge.net/tracker/?group_id=11118&#38;atid=460288</A
 >,
@@ -210,19 +227,12 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="CONTACT-BUGS"
-></A
->11.2.2. Reporting Bugs</H3
+>11.2.2. Reporting Bugs</A
+></H3
 ><P
-> Please report all bugs <SPAN
-CLASS="emphasis"
-><I
-CLASS="EMPHASIS"
->only</I
-></SPAN
-> through our
- bug tracker: 
+> Please report all bugs through our bug tracker: 
  <A
-HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118"
+HREF="http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118"
 TARGET="_top"
 >http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118</A
 >. </P
@@ -235,19 +245,19 @@ CLASS="EMPHASIS"
 ></SPAN
 >
   and observe the additional hints at the top of the <A
-HREF="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118"
+HREF="http://sourceforge.net/tracker/?func=add&#38;group_id=11118&#38;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
+>  Please try to verify that it is a <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > bug,
-  and not a browser or site bug first. If unsure,
+  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"
@@ -256,11 +266,14 @@ TARGET="_top"
 > <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
->, and see if the problem persists.
-  If you are using your own custom configuration, please try
-  the stock configs to see if the problem is configuration related.</P
+>, 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 not using the latest version, the bug may have been found
+>  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"
@@ -268,7 +281,7 @@ TARGET="_top"
 >upgrade
   to the latest version</A
 > (or  even the latest CVS snapshot) and verify
-  your bug.</P
+  that your bug still exists.</P
 ><P
 >Please be sure to provide the following information:</P
 ><P
@@ -280,7 +293,7 @@ TARGET="_top"
 >    The exact <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> version of the proxy software
+> 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"
@@ -303,7 +316,8 @@ CLASS="APPLICATION"
     sending the output of <SPAN
 CLASS="QUOTE"
 >"uname -a"</SPAN
-> should do.
+> should do,
+    in case of GNU/Linux, please also name the distribution.
    </P
 ></LI
 ><LI
@@ -333,11 +347,11 @@ CLASS="LITERAL"
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > is one supplied
-    by the developers of <SPAN
+    by the <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> via SourceForge,
-    or somewhere else.
+> developers via SourceForge,
+    or if you got your copy somewhere else.
    </P
 ></LI
 ><LI
@@ -349,8 +363,8 @@ CLASS="APPLICATION"
     another proxy such as <SPAN
 CLASS="APPLICATION"
 >Tor</SPAN
->. If so, please try 
-    disabling the other proxy.
+>. If so, please
+    temporary disable the other proxy to see if the symptoms change.
    </P
 ></LI
 ><LI
@@ -366,24 +380,53 @@ CLASS="APPLICATION"
 ><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).
-   </P
-></LI
-><LI
-><P
->    <SPAN
-CLASS="emphasis"
-><I
-CLASS="EMPHASIS"
->Please provide your SF login, or email address</I
-></SPAN
->, in case we 
-    need to contact you.
+    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
+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
+>
+    If you are having trouble with a filter, please additionally enable
+    <P
+CLASS="LITERALLAYOUT"
+>debug&nbsp;&nbsp;&nbsp;&nbsp;64&nbsp;#&nbsp;debug&nbsp;regular&nbsp;expression&nbsp;filters</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
 ><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.</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.</P
+><P
 >  The <A
 HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
 TARGET="_top"
@@ -405,13 +448,13 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-FEATURE"
-></A
->11.3. Request New Features</H2
+>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"
+HREF="http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118"
 TARGET="_top"
 >http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</A
 >.</P
@@ -422,8 +465,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-OTHER"
-></A
->11.4. Other</H2
+>11.4. Other</A
+></H2
 ><P
 >For any other issues, feel free to use the mailing lists. Technically interested users
 and people who wish to contribute to the project are also welcome on the developers list!
@@ -499,4 +542,4 @@ VALIGN="top"
 ></DIV
 ></BODY
 ></HTML
->
\ No newline at end of file
+>