Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch)
[privoxy.git] / doc / webserver / user-manual / contact.html
index 6e65674..f139b22 100644 (file)
@@ -1,3 +1,4 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <HTML
 ><HEAD
 ><TITLE
@@ -5,16 +6,15 @@
 Requests</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
 REL="HOME"
-TITLE="Privoxy User Manual"
+TITLE="Privoxy 3.0.3 User Manual"
 HREF="index.html"><LINK
 REL="PREVIOUS"
-TITLE="Privoxy Configuration"
-HREF="configuration.html"><LINK
+TITLE="Templates"
+HREF="templates.html"><LINK
 REL="NEXT"
-TITLE="Copyright and History"
+TITLE="Privoxy Copyright, License and History"
 HREF="copyright.html"><LINK
 REL="STYLESHEET"
 TYPE="text/css"
@@ -29,6 +29,7 @@ ALINK="#0000FF"
 ><DIV
 CLASS="NAVHEADER"
 ><TABLE
+SUMMARY="Header navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -37,7 +38,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy User Manual</TH
+>Privoxy 3.0.3 User Manual</TH
 ></TR
 ><TR
 ><TD
@@ -45,7 +46,8 @@ WIDTH="10%"
 ALIGN="left"
 VALIGN="bottom"
 ><A
-HREF="configuration.html"
+HREF="templates.html"
+ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -59,6 +61,7 @@ ALIGN="right"
 VALIGN="bottom"
 ><A
 HREF="copyright.html"
+ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR
@@ -72,168 +75,192 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="CONTACT"
->6. Contacting the Developers, Bug Reporting and Feature
+>11. 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
+> 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"
+>11.1. Get Support</A
+></H2
 ><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
+> 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&#38;atid=211118</A
-><br>
-&nbsp;&nbsp;&nbsp;</P
-></LI
-><LI
+></P
 ><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
+> 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
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="CONTACT-BUGS"
+>11.2. Report Bugs</A
+></H2
+><P
+> Please report all bugs <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>only</I
+></SPAN
+> through our
+ bug tracker: 
+ <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
+><P
+>  Before doing so, please make sure that the bug has not already been submitted
+  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
 ><P
->   Make sure that the bug has not already been submitted.  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 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
+> bug,
+  and not a browser or site bug first. If unsure,
+  try <A
+HREF="javascript:void(window.open('http://config.privoxy.org/toggle?mini=y&set=disabled','ijbstatus','width=250,height=100,resizable=yes,scrollbars=no,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());"
+TARGET="_top"
+>toggling
+  off</A
+> <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"
+>, and see if the problem persists.
+  The <A
+HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
 TARGET="_top"
->http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118&#38;func=browse</A
->.<br>
-&nbsp;&nbsp;&nbsp;</P
-></LI
-><LI
+>appendix
+  of the user manual</A
+> also has helpful information 
+  on action debugging. If you are using your own custom configuration, please try
+  the stock configs to see if the problem is configuration related.</P
 ><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());"
+>  If not using the latest version, chances are that the bug has 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"
-><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
+>upgrade
+  to the latest version</A
+> (or  even the latest CVS snapshot) and verify
+  your bug, but this is not required for reporting.</P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="CONTACT-FEATURE"
+>11.3. Request New Features</A
+></H2
 ><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"
+> 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/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
+>http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</A
+>.</P
+></DIV
 ><DIV
 CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="SUBMITACTIONS"
->6.1. Submitting Ads and <SPAN
-CLASS="QUOTE"
->"Action"</SPAN
-> Problems</A
+NAME="CONTACT-ADS"
+>11.4. Report Ads or Other Actions-Related Problems</A
 ></H2
 ><P
-> Ads and banners that are not stopped by <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> 
- can be submitted to the developers by accessing a special page and filling 
- out the brief, required form. Conversely, you can also report pages, images,
- etc. that <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> is blocking, but should not.
- The form itself does require Internet access.</P
-><P
-> To do this, point your browser to <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> 
- at <A
-HREF="http://p.p/"
-TARGET="_top"
->http://p.p/</A
->, and then select 
+> 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"
->Actions file feedback system</A
->, 
- near the bottom of the page. Paste in the URL that is the cause of the 
- unwanted behavior, and follow the prompts. The developers will 
- try to incorporate your submission into future versions.</P
+>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 <TT
+> New, improved <TT
 CLASS="FILENAME"
->default.actions</TT
+>default.action</TT
 > files will occasionally be made
- available based on your feedback. These 
- will be announced on the 
- <A
+ 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.</P
+ 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
+><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!
+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
@@ -241,6 +268,7 @@ CLASS="NAVFOOTER"
 ><HR
 ALIGN="LEFT"
 WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -251,7 +279,8 @@ WIDTH="33%"
 ALIGN="left"
 VALIGN="top"
 ><A
-HREF="configuration.html"
+HREF="templates.html"
+ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -260,6 +289,7 @@ ALIGN="center"
 VALIGN="top"
 ><A
 HREF="index.html"
+ACCESSKEY="H"
 >Home</A
 ></TD
 ><TD
@@ -268,6 +298,7 @@ ALIGN="right"
 VALIGN="top"
 ><A
 HREF="copyright.html"
+ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR
@@ -276,10 +307,7 @@ HREF="copyright.html"
 WIDTH="33%"
 ALIGN="left"
 VALIGN="top"
-><SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> Configuration</TD
+>Templates</TD
 ><TD
 WIDTH="34%"
 ALIGN="center"
@@ -289,7 +317,10 @@ VALIGN="top"
 WIDTH="33%"
 ALIGN="right"
 VALIGN="top"
->Copyright and History</TD
+><SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> Copyright, License and History</TD
 ></TR
 ></TABLE
 ></DIV