Sync with various changes from 3.0 branch. Add two new files for config stuff.
[privoxy.git] / doc / source / contacting.sgml
1 <!--
2  File        :  $Source: /cvsroot/ijbswa/current/doc/source/contacting.sgml,v $
3
4  Purpose     :  Entity included in other project documents.
5                 
6  $Id: contacting.sgml,v 1.15 2002/05/26 17:04:24 hal9 Exp $
7
8  Copyright (C) 2001, 2002 Privoxy Developers <developers@privoxy.org>
9  See LICENSE.
10
11  ======================================================================
12   This file used for inclusion with other documents only.
13  ======================================================================
14
15  This file is included into:
16
17   faq
18   developer-manual
19   README
20   user-manual
21   webserver/index.sgml
22   privoxy-index.html
23   announce.sgml
24
25 -->
26
27 <!-- READ: -->
28 <!-- Careful of the literallayout tags and finished formatting -->
29
30 <para>
31  We value your feedback. In fact, we rely on it to improve
32  <application>Privoxy</application> and its configuration.
33  However, please note the following hints, so we can 
34  provide you with the best support:
35 </para>
36
37 <sect2 id="contact-support"><title>Get Support</title>
38 <para>
39  For casual users, our support forum at
40  <ulink url="http://sourceforge.net/">SourceForge</ulink>
41  is probably best suited:
42  <ulink url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118">http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118</ulink>
43 </para>
44
45 <para>
46  All users are of course welcome to discuss their issues on the <ulink
47  url="http://lists.sourceforge.net/lists/listinfo/ijbswa-users">users
48  mailing list</ulink>, where the developers also hang around.
49 </para>
50
51 </sect2>
52
53 <sect2 id="contact-bugs"><title>Report Bugs</title>
54 <para>
55  Please report all bugs <emphasis>only</emphasis> through our
56  bug tracker: 
57  <ulink url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118">http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118</ulink>. 
58 </para>
59
60 <para>
61   Before doing so, please make sure that the bug has not already been submitted
62   and observe the additional hints at the top of the <ulink
63   url="http://sourceforge.net/tracker/?func=add&amp;group_id=11118&amp;atid=111118">submit
64   form</ulink>.
65 </para>
66
67 <para> 
68   Please try to verify that it is a <application>Privoxy</application> bug,
69   and not a browser or site bug first. If unsure,
70   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
71   off</ulink> <application>Privoxy</application>, and see if the problem persists.
72   The <ulink url="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT">appendix
73   of the user manual</ulink> also has helpful information 
74   on action debugging. If you are using your own custom configuration, please try
75   the stock configs to see if the problem is configuration related.
76 </para>
77
78 <para>
79   If not using the latest version, chances are that the bug has been found
80   and fixed in the meantime. We would appreciate if you could take the time
81   to <ulink url="http://www.privoxy.org/user-manual/installation.html">upgrade
82   to the latest version</ulink> (or  even the latest CVS snapshot) and verify
83   your bug, but this is not required for reporting.
84 </para>
85 </sect2>
86
87 <sect2 id="contact-feature"><title>Request New Features</title>
88 <para>
89  You are welcome to submit ideas on new features or other proposals
90  for improvement through our feature request tracker at
91  <ulink url="http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118">http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</ulink>.
92 </para>
93 </sect2>
94
95 <sect2 id="contact-ads"><title>Report Ads or Other Actions-Related Problems</title>
96 <para>
97  Please send feedback on ads that slipped through, innocent images that were blocked,
98  and any other problems relating to the <filename>default.action</filename> file through
99  our actions feedback mechanism located at
100  <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>.
101  On this page, you will also find a bookmark which will take you back there from
102  any troubled site and even pre-fill the form!
103 </para> 
104
105 <para>
106  New, improved <filename>default.action</filename> files will occasionally be made
107  available based on your feedback. These will be announced on the <ulink
108  url="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce">ijbswa-announce</ulink>
109  list and available from our <ulink url="http://sf.net/projects/ijbswa/">project page</ulink>.
110 </para>
111 </sect2>
112
113 <sect2 id="contact-other"><title>Other</title>
114 <para>
115 For any other issues, feel free to use the mailing lists. Technically interested users
116 and people who wish to contribute to the project are also welcome on the developers list!
117 You can find an overview of all <application>Privoxy</application>-related mailing lists,
118 including list archives, at:
119 <ulink url="http://sourceforge.net/mail/?group_id=11118">http://sourceforge.net/mail/?group_id=11118</ulink>.
120 </para>
121 </sect2>