Add a "Whats New in this release" Section. Further work on multiple filter
[privoxy.git] / doc / webserver / user-manual / contact.html
index f139b22..967d2ba 100644 (file)
@@ -1,4 +1,3 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <HTML
 ><HEAD
 ><TITLE
@@ -6,9 +5,10 @@
 Requests</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
+"><LINK
 REL="HOME"
-TITLE="Privoxy 3.0.3 User Manual"
+TITLE="Privoxy 3.0.4 User Manual"
 HREF="index.html"><LINK
 REL="PREVIOUS"
 TITLE="Templates"
@@ -38,7 +38,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy 3.0.3 User Manual</TH
+>Privoxy 3.0.4 User Manual</TH
 ></TR
 ><TR
 ><TD
@@ -75,9 +75,9 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="CONTACT"
+></A
 >11. Contacting the Developers, Bug Reporting and Feature
-Requests</A
-></H1
+Requests</H1
 ><P
 > We value your feedback. In fact, we rely on it to improve
  <SPAN
@@ -92,8 +92,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-SUPPORT"
->11.1. Get Support</A
-></H2
+></A
+>11.1. Get Support</H2
 ><P
 > For casual users, our 
  <A
@@ -120,9 +120,96 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
+NAME="REPORTING"
+></A
+>11.2. Reporting Problems</H2
+><P
+><SPAN
+CLASS="QUOTE"
+>"Problems"</SPAN
+> for our purposes, come in two forms:</P
+><P
+></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"
+></A
+>11.2.1. Reporting Ads or Other Configuration Problems</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&#38;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"
->11.2. Report Bugs</A
-></H2
+></A
+>11.2.2. Reporting Bugs</H3
 ><P
 > Please report all bugs <SPAN
 CLASS="emphasis"
@@ -138,13 +225,20 @@ TARGET="_top"
 >http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118</A
 >. </P
 ><P
->  Before doing so, please make sure that the bug has not already been submitted
+>  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
->.</P
+>. If already submitted, please feel free to add any info to the 
+  original report that might help solve the issue.</P
 ><P
 > 
   Please try to verify that it is a <SPAN
@@ -161,16 +255,10 @@ TARGET="_top"
 CLASS="APPLICATION"
 >Privoxy</SPAN
 >, and see if the problem persists.
-  The <A
-HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
-TARGET="_top"
->appendix
-  of the user manual</A
-> also has helpful information 
-  on action debugging. If you are using your own custom configuration, please try
+  If you are using your own custom configuration, please try
   the stock configs to see if the problem is configuration related.</P
 ><P
->  If not using the latest version, chances are that the bug has been found
+>  If not using the latest 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"
@@ -178,7 +266,127 @@ TARGET="_top"
 >upgrade
   to the latest version</A
 > (or  even the latest CVS snapshot) and verify
-  your bug, but this is not required for reporting.</P
+  your bug.</P
+><P
+>Please be sure to provide the following information:</P
+><P
+> <P
+></P
+><UL
+><LI
+><P
+>    The exact <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> version of the proxy software
+(if you got the source from CVS, please also give the date).
+   </P
+></LI
+><LI
+><P
+>    The operating system and verions you run
+    <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> on, (e.g. <SPAN
+CLASS="APPLICATION"
+>Windows
+    XP</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 developers of <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> via SourceForge,
+    or 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 try 
+    disabling the other proxy.
+   </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).
+   </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.
+   </P
+></LI
+></UL
+></P
+><P
+>  The <A
+HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
+TARGET="_top"
+>appendix
+  of the 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"
@@ -186,8 +394,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-FEATURE"
->11.3. Request New Features</A
-></H2
+></A
+>11.3. Request New Features</H2
 ><P
 > You are welcome to submit ideas on new features or other proposals
  for improvement through our feature request tracker at
@@ -202,52 +410,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="CONTACT-ADS"
->11.4. Report Ads or Other Actions-Related Problems</A
-></H2
-><P
-> Please send feedback on ads that slipped through, innocent images that were blocked,
- and any other problems relating to the <TT
-CLASS="FILENAME"
->default.action</TT
-> file through
- our actions feedback mechanism located at
- <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"
->http://www.privoxy.org/actions/</A
->.
- On this page, you will also find a bookmark which will take you back there from
- any troubled site and even pre-fill the form!</P
-><P
-> New, improved <TT
-CLASS="FILENAME"
->default.action</TT
-> files will 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="SECT2"
-><H2
-CLASS="SECT2"
-><A
 NAME="CONTACT-OTHER"
->11.5. Other</A
-></H2
+></A
+>11.4. Other</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!