Sync with various changes from 3.0 branch. Add two new files for config stuff.
[privoxy.git] / doc / source / contacting.sgml
index 2c6e3f6..00f3a0a 100644 (file)
@@ -3,14 +3,10 @@
 
  Purpose     :  Entity included in other project documents.
                 
- $Id: contacting.sgml,v 1.7 2002/04/10 04:06:57 hal9 Exp $
+ $Id: contacting.sgml,v 1.15 2002/05/26 17:04:24 hal9 Exp $
 
- Written by and Copyright (C) 2001 the SourceForge
- Privoxy team. http://www.privoxy.org/
-
- Based on the Internet Junkbuster originally written
- by and Copyright (C) 1997 Anonymous Coders and 
- Junkbusters Corporation.  http://www.junkbusters.com
+ Copyright (C) 2001, 2002 Privoxy Developers <developers@privoxy.org>
+ See LICENSE.
 
  ======================================================================
   This file used for inclusion with other documents only.
   README
   user-manual
   webserver/index.sgml
+  privoxy-index.html
+  announce.sgml
 
 -->
 
 <!-- READ: -->
-<!-- Careful of the literllayout tags and finished formatting -->
+<!-- Careful of the literallayout tags and finished formatting -->
+
+<para>
+ We value your feedback. In fact, we rely on it to improve
+ <application>Privoxy</application> and its configuration.
+ However, please note the following hints, so we can 
+ provide you with the best support:
+</para>
 
+<sect2 id="contact-support"><title>Get Support</title>
 <para>
- We value your feedback. However, to provide you with the best support, please
- note:
-
- <itemizedlist>
-
-  <listitem>
-   <literallayout>
-Use the Sourceforge Support Forum to get help:
-   
-    <ulink url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118">http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118</ulink>
-   </literallayout>
-  </listitem>
-  <listitem>
-   <literallayout>
-Submit bugs only through our Sourceforge Bug Forum:
-    <ulink url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118">http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118</ulink>. 
-    </literallayout>
-  <para>
-   Make sure that the bug has not already been submitted.  Please try to
-   verify that it is a <application>Privoxy</application> 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
-   <application>Privoxy</application>/<application>Junkbuster</application>
-   version, platform, browser, any pertinent log data, any other relevant
-   details (please be specific) and, if possible, some way to reproduce the
-   bug.
-  </para>
- </listitem>
-  <listitem>
-   <literallayout>
-Submit feature requests only through our Sourceforge feature request forum:
-    <ulink url="http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118&#38;func=browse"></ulink>.
-   </literallayout>
-  </listitem>
-
-
-  <listitem>
-   <literallayout>
-You can also send feedback on websites that Privoxy has problems with. Please bookmark
-the following link: <ulink url="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());"><quote>Privoxy - Submit Filter Feedback</quote></ulink>. Once you surf to a page with problems, use the
-bookmark to send us feedback. We will look into the issue as soon as possible.
-   </literallayout>
-  </listitem>
-
-
- <listitem>
-   <literallayout>
-For any other issues, feel free to use the mailing lists:
-    <ulink url="http://sourceforge.net/mail/?group_id=11118">http://sourceforge.net/mail/?group_id=11118</ulink>.
- </literallayout>
- <para>
-  Anyone interested in actively participating in development and related
-  discussions can also join the appropriate mailing list. Archives are
-  available, too. 
- </para>
- </listitem>
-
- </itemizedlist>
+ For casual users, our support forum at
+ <ulink url="http://sourceforge.net/">SourceForge</ulink>
+ is probably best suited:
+ <ulink url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118">http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118</ulink>
 </para>
 
+<para>
+ All users are of course welcome to discuss their issues on the <ulink
+ url="http://lists.sourceforge.net/lists/listinfo/ijbswa-users">users
+ mailing list</ulink>, where the developers also hang around.
+</para>
+
+</sect2>
+
+<sect2 id="contact-bugs"><title>Report Bugs</title>
+<para>
+ Please report all bugs <emphasis>only</emphasis> through our
+ bug tracker: 
+ <ulink url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118">http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118</ulink>. 
+</para>
+
+<para>
+  Before doing so, please make sure that the bug has not already been submitted
+  and observe the additional hints at the top of the <ulink
+  url="http://sourceforge.net/tracker/?func=add&amp;group_id=11118&amp;atid=111118">submit
+  form</ulink>.
+</para>
+
+<para> 
+  Please try to verify that it is a <application>Privoxy</application> bug,
+  and not a browser or site bug first. If unsure,
+  try <ulink url="javascript:void(window.open('http://config.privoxy.org/toggle?mini=y&amp;set=disabled','ijbstatus','width=250,height=100,resizable=yes,scrollbars=no,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());">toggling
+  off</ulink> <application>Privoxy</application>, and see if the problem persists.
+  The <ulink url="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT">appendix
+  of the user manual</ulink> 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.
+</para>
+
+<para>
+  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 <ulink url="http://www.privoxy.org/user-manual/installation.html">upgrade
+  to the latest version</ulink> (or  even the latest CVS snapshot) and verify
+  your bug, but this is not required for reporting.
+</para>
+</sect2>
+
+<sect2 id="contact-feature"><title>Request New Features</title>
+<para>
+ You are welcome to submit ideas on new features or other proposals
+ for improvement through our feature request tracker at
+ <ulink url="http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118">http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</ulink>.
+</para>
+</sect2>
+
+<sect2 id="contact-ads"><title>Report Ads or Other Actions-Related Problems</title>
+<para>
+ Please send feedback on ads that slipped through, innocent images that were blocked,
+ and any other problems relating to the <filename>default.action</filename> file through
+ our actions feedback mechanism located at
+ <ulink url="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());">http://www.privoxy.org/actions/</ulink>.
+ 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!
+</para> 
+
+<para>
+ New, improved <filename>default.action</filename> files will occasionally be made
+ available based on your feedback. These will be announced on the <ulink
+ url="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce">ijbswa-announce</ulink>
+ list and available from our <ulink url="http://sf.net/projects/ijbswa/">project page</ulink>.
+</para>
+</sect2>
+
+<sect2 id="contact-other"><title>Other</title>
+<para>
+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 <application>Privoxy</application>-related mailing lists,
+including list archives, at:
+<ulink url="http://sourceforge.net/mail/?group_id=11118">http://sourceforge.net/mail/?group_id=11118</ulink>.
+</para>
+</sect2>