Extended and further commented the example actions files
[privoxy.git] / doc / source / contacting.sgml
index 33b85af..28b53ee 100644 (file)
@@ -3,14 +3,10 @@
 
  Purpose     :  Entity included in other project documents.
                 
- $Id: contacting.sgml,v 1.5 2002/04/09 23:29:41 hal9 Exp $
+ $Id: contacting.sgml,v 1.12 2002/04/27 15:34:27 swa 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.
 
 -->
 
-<!-- Careful of the literllayout tags and finished formatting -->
+<!-- READ: -->
+<!-- Careful of the literallayout tags and finished formatting -->
 
 <para>
  We value your feedback. However, to provide you with the best support, please
- note:
+ note the following sections.
+</para>
 
- <itemizedlist>
+<sect2 id="contact-support"><title>Get Support</title>
+  <para>
+   <literallayout class="normal">
+To get support, use the Sourceforge Support Forum:
 
-  <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:
+</literallayout>
+  </para>
+</sect2>
+
+<sect2 id="contact-bugs"><title>Report bugs</title>
+  <para>
+   <literallayout class="normal">
+To submit bugs, use the 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>
+</literallayout>
+ </para>
   <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
    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.
+   <application>Privoxy</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:
+</sect2>
+
+<sect2 id="contact-feature"><title>Request new features</title>
+  <para>
+   <literallayout class="normal">
+To submit ideas on new features, use the Sourceforge feature request forum:
+
     <ulink url="http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118&#38;func=browse"></ulink>.
-   </literallayout>
-  </listitem>
+</literallayout>
+  </para>
+</sect2>
 
+<sect2 id="contact-ads"><title>Report ads or other filter problems</title>
+  <para>
+<!--     <literallayout class="normal"> -->
+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> -->
+  </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.
+</para>
+</sect2>
 
-  <listitem>
-<!-- FIXME -->
-<!--
-We will soon have an automated way to submit advertisements, incorrectly
-blocked images, popups and the like. Check back.
--->
-<!--  <ulink url="http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118&#38;func=browse"></ulink>. -->
-   <literallayout>
- Submit missed ads and banners, and incorrectly blocked images, popups, etc:
-      
-      <ulink url="http://p.p/">http://p.p/</ulink>, and select <ulink url="javascript:void(window.open('http://www.privoxy.org/actions','Feedback','width=600,scrollbars=yes,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());"><quote>actions file feedback system</quote></ulink>
-   </literallayout>
-   <para>
-    This page can also be reached from many of the internal CGI pages.
-   </para>
-  </listitem>
-
-
- <listitem>
-   <literallayout>
- For any other issues, feel free to use the mailing lists:
+<sect2 id="contact-other"><title>Other</title>
+ <para>
+   <literallayout class="normal">
+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>
-
+</literallayout>
+ </para>
  <para>
   Anyone interested in actively participating in development and related
   discussions can also join the appropriate mailing list. Archives are
-  available too. 
+  available, too. See the page on Sourceforge.
  </para>
- </listitem>
-
- </itemizedlist>
-</para>
-
+</sect2>