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.
                 
 
  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.
 
  ======================================================================
   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
 
 <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>
     <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>. 
     <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
   <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
    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>
   </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>.
     <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>.
  
     <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
  <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>
  </para>
- </listitem>
-
- </itemizedlist>
-</para>
-
+</sect2>