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 2.6 2006/08/27 22:01:55 hal9 Exp $
   7
   8  Copyright (C) 2001 - 2006 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   announce.sgml
  23
  24 -->
  25
  26 <!-- READ: -->
  27 <!-- Careful of the literallayout tags and finished formatting -->
  28
  29 <para>
  30  We value your feedback. In fact, we rely on it to improve
  31  <application>Privoxy</application> and its configuration.
  32  However, please note the following hints, so we can
  33  provide you with the best support:
  34 </para>
  35
  36 <sect2 id="contact-support"><title>Get Support</title>
  37 <para>
  38  For casual users, our
  39  <ulink url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118">support forum at SourceForge</ulink>
  40  is probably best suited:
  41  <ulink url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118">http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118</ulink>
  42 </para>
  43
  44 <para>
  45  All users are of course welcome to discuss their issues on the <ulink
  46  url="http://lists.sourceforge.net/lists/listinfo/ijbswa-users">users
  47  mailing list</ulink>, where the developers also hang around.
  48 </para>
  49
  50 </sect2>
  51
  52 <sect2 id="reporting"><title>Reporting Problems</title>
  53 <para>
  54 <quote>Problems</quote> for our purposes, come in two forms:
  55 </para>
  56  <itemizedlist>
  57
  58   <listitem>
  59    <para>
  60     Configuration issues, such as ads that slip through, or sites that
  61     don't function properly due to one <application>Privoxy</application>
  62     <quote>action</quote> or another being turned <quote>on</quote>.
  63    </para>
  64   </listitem>
  65
  66   <listitem>
  67    <para>
  68     <quote>Bugs</quote> in the programming code that makes up
  69     <application>Privoxy</application>, such as that might cause a crash.
  70    </para>
  71   </listitem>
  72 </itemizedlist>
  73
  74
  75 <sect3 id="contact-ads"><title>Reporting Ads or Other Configuration Problems</title>
  76 <para>
  77  Please send feedback on ads that slipped through, innocent images that were
  78  blocked, sites that don't work properly, and other configuration related problem of
  79  <filename>default.action</filename> file, to
  80  <ulink url="http://sourceforge.net/tracker/?group_id=11118&amp;atid=460288">
  81  http://sourceforge.net/tracker/?group_id=11118&amp;atid=460288</ulink>,
  82  the Actions File Tracker.
  83 </para>
  84
  85 <para>
  86  New, improved <filename>default.action</filename> files may occasionally be made
  87  available based on your feedback. These will be announced on the <ulink
  88  url="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce">ijbswa-announce</ulink>
  89  list and available from our the <ulink
  90  url="http://sourceforge.net/project/showfiles.php?group_id=11118">files section</ulink> of
  91  our <ulink url="http://sf.net/projects/ijbswa/">project page</ulink>.
  92 </para>
  93 </sect3>
  94
  95
  96 <sect3 id="contact-bugs"><title>Reporting Bugs</title>
  97 <para>
  98  Please report all bugs <emphasis>only</emphasis> through our
  99  bug tracker:
 100  <ulink url="http://sourceforge.net/tracker/?group_id=11118&amp;atid=111118">http://sourceforge.net/tracker/?group_id=11118&amp;atid=111118</ulink>.
 101 </para>
 102
 103 <para>
 104   Before doing so, please make sure that the bug has <emphasis>not already been submitted</emphasis>
 105   and observe the additional hints at the top of the <ulink
 106   url="http://sourceforge.net/tracker/?func=add&amp;group_id=11118&amp;atid=111118">submit
 107   form</ulink>. If already submitted, please feel free to add any info to the
 108   original report that might help solve the issue.
 109 </para>
 110
 111 <para>
 112   Please try to verify that it is a <application>Privoxy</application> bug,
 113   and not a browser or site bug first. If unsure,
 114   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
 115   off</ulink> <application>Privoxy</application>, and see if the problem persists.
 116   If you are using your own custom configuration, please try
 117   the stock configs to see if the problem is configuration related.
 118 </para>
 119
 120 <para>
 121   If not using the latest version, the bug may have been found
 122   and fixed in the meantime. We would appreciate if you could take the time
 123   to <ulink url="http://www.privoxy.org/user-manual/installation.html">upgrade
 124   to the latest version</ulink> (or  even the latest CVS snapshot) and verify
 125   your bug.
 126 </para>
 127 <para>
 128 Please be sure to provide the following information:
 129 </para>
 130 <para>
 131  <itemizedlist>
 132
 133   <listitem>
 134    <para>
 135     The exact <application>Privoxy</application> version of the proxy software
 136 (if you got the source from CVS, please also give the date).
 137    </para>
 138   </listitem>
 139
 140   <listitem>
 141    <para>
 142     The operating system and versions you run
 143     <application>Privoxy</application> on, (e.g. <application>Windows
 144     XP</application>).
 145    </para>
 146   </listitem>
 147
 148   <listitem>
 149    <para>
 150     The name, platform, and version of the <application>browser</application>
 151     you were using (e.g. <application>Internet Explorer v5.5</application> for Mac).
 152    </para>
 153   </listitem>
 154
 155   <listitem>
 156    <para>
 157     The URL where the problem occurred, or some way for us to duplicate the
 158     problem (e.g. <literal>http://somesite.example.com?somethingelse=123</literal>).
 159    </para>
 160   </listitem>
 161
 162   <listitem>
 163    <para>
 164     Whether your version of <application>Privoxy</application> is one supplied
 165     by the developers of <application>Privoxy</application> via SourceForge,
 166     or somewhere else.
 167    </para>
 168   </listitem>
 169
 170   <listitem>
 171    <para>
 172     Whether you are using <application>Privoxy</application> in tandem with
 173     another proxy such as <application>TOR</application>. If so, please try
 174     disabling the other proxy.
 175    </para>
 176   </listitem>
 177
 178   <listitem>
 179    <para>
 180     Whether you are using a personal firewall product. If so, does
 181     <application>Privoxy</application> work without it?
 182    </para>
 183   </listitem>
 184
 185   <listitem>
 186    <para>
 187     Any other pertinent information to help identify the problem such as config
 188     or log file excerpts (yes, you should have log file entries for each
 189     action taken).
 190    </para>
 191   </listitem>
 192
 193   <listitem>
 194    <para>
 195     <emphasis>Please provide your SF login, or email address</emphasis>, in case we
 196     need to contact you.
 197    </para>
 198   </listitem>
 199
 200 </itemizedlist>
 201 </para>
 202 <para>
 203   The <ulink url="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT">appendix
 204   of the user manual</ulink> also has helpful information
 205   on understanding <literal>actions</literal>, and <literal>action</literal> debugging.
 206 </para>
 207 </sect3>
 208 </sect2>
 209
 210 <sect2 id="contact-feature"><title>Request New Features</title>
 211 <para>
 212  You are welcome to submit ideas on new features or other proposals
 213  for improvement through our feature request tracker at
 214  <ulink url="http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118">http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</ulink>.
 215 </para>
 216 </sect2>
 217
 218 <sect2 id="contact-other"><title>Other</title>
 219 <para>
 220 For any other issues, feel free to use the mailing lists. Technically interested users
 221 and people who wish to contribute to the project are also welcome on the developers list!
 222 You can find an overview of all <application>Privoxy</application>-related mailing lists,
 223 including list archives, at:
 224 <ulink url="http://sourceforge.net/mail/?group_id=11118">http://sourceforge.net/mail/?group_id=11118</ulink>.
 225 </para>
 226 </sect2>