1ba9ef4c204dbd65df0208dc4699577ce5b9e65c
[privoxy.git] / doc / webserver / user-manual / contact.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Contacting the Developers, Bug Reporting and Feature
6 Requests</TITLE
7 ><META
8 NAME="GENERATOR"
9 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
10 REL="HOME"
11 TITLE="Privoxy 3.0.9 User Manual"
12 HREF="index.html"><LINK
13 REL="PREVIOUS"
14 TITLE="Privoxy's Template Files"
15 HREF="templates.html"><LINK
16 REL="NEXT"
17 TITLE="Privoxy Copyright, License and History"
18 HREF="copyright.html"><LINK
19 REL="STYLESHEET"
20 TYPE="text/css"
21 HREF="../p_doc.css"><META
22 HTTP-EQUIV="Content-Type"
23 CONTENT="text/html;
24 charset=ISO-8859-1">
25 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
26 </head
27 ><BODY
28 CLASS="SECT1"
29 BGCOLOR="#EEEEEE"
30 TEXT="#000000"
31 LINK="#0000FF"
32 VLINK="#840084"
33 ALINK="#0000FF"
34 ><DIV
35 CLASS="NAVHEADER"
36 ><TABLE
37 SUMMARY="Header navigation table"
38 WIDTH="100%"
39 BORDER="0"
40 CELLPADDING="0"
41 CELLSPACING="0"
42 ><TR
43 ><TH
44 COLSPAN="3"
45 ALIGN="center"
46 >Privoxy 3.0.9 User Manual</TH
47 ></TR
48 ><TR
49 ><TD
50 WIDTH="10%"
51 ALIGN="left"
52 VALIGN="bottom"
53 ><A
54 HREF="templates.html"
55 ACCESSKEY="P"
56 >Prev</A
57 ></TD
58 ><TD
59 WIDTH="80%"
60 ALIGN="center"
61 VALIGN="bottom"
62 ></TD
63 ><TD
64 WIDTH="10%"
65 ALIGN="right"
66 VALIGN="bottom"
67 ><A
68 HREF="copyright.html"
69 ACCESSKEY="N"
70 >Next</A
71 ></TD
72 ></TR
73 ></TABLE
74 ><HR
75 ALIGN="LEFT"
76 WIDTH="100%"></DIV
77 ><DIV
78 CLASS="SECT1"
79 ><H1
80 CLASS="SECT1"
81 ><A
82 NAME="CONTACT"
83 >11. Contacting the Developers, Bug Reporting and Feature
84 Requests</A
85 ></H1
86 ><P
87 > We value your feedback. In fact, we rely on it to improve
88  <SPAN
89 CLASS="APPLICATION"
90 >Privoxy</SPAN
91 > and its configuration.
92  However, please note the following hints, so we can 
93  provide you with the best support:</P
94 ><DIV
95 CLASS="SECT2"
96 ><H2
97 CLASS="SECT2"
98 ><A
99 NAME="CONTACT-SUPPORT"
100 >11.1. Get Support</A
101 ></H2
102 ><P
103 > For casual users, our 
104  <A
105 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118"
106 TARGET="_top"
107 >support forum at SourceForge</A
108 >
109  is probably best suited:
110  <A
111 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118"
112 TARGET="_top"
113 >http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118</A
114 ></P
115 ><P
116 > All users are of course welcome to discuss their issues on the <A
117 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-users"
118 TARGET="_top"
119 >users
120  mailing list</A
121 >, where the developers also hang around.</P
122 ><P
123 > Note that the Privoxy mailing lists are moderated. Posts from unsubscribed
124  addresses have to be accepted manually by a moderator. This may cause a
125  delay of several days and if you use a subject that doesn't clearly
126  mention Privoxy or one of its features, your message may be accidentally
127  discarded as spam.</P
128 ><P
129 > If you aren't subscribed, you should therefore spend a few seconds
130  to come up with a proper subject. Additionally you should make it clear
131  that you want to get CC'd. Otherwise some responses will be directed to
132  the mailing list only, and you won't see them.</P
133 ></DIV
134 ><DIV
135 CLASS="SECT2"
136 ><H2
137 CLASS="SECT2"
138 ><A
139 NAME="REPORTING"
140 >11.2. Reporting Problems</A
141 ></H2
142 ><P
143 ><SPAN
144 CLASS="QUOTE"
145 >"Problems"</SPAN
146 > for our purposes, come in two forms:</P
147 ><P
148 ></P
149 ><UL
150 ><LI
151 ><P
152 >    Configuration issues, such as ads that slip through, or sites that 
153     don't function properly due to one <SPAN
154 CLASS="APPLICATION"
155 >Privoxy</SPAN
156
157     <SPAN
158 CLASS="QUOTE"
159 >"action"</SPAN
160 > or another being turned <SPAN
161 CLASS="QUOTE"
162 >"on"</SPAN
163 >.
164    </P
165 ></LI
166 ><LI
167 ><P
168 >    <SPAN
169 CLASS="QUOTE"
170 >"Bugs"</SPAN
171 > in the programming code that makes up 
172     <SPAN
173 CLASS="APPLICATION"
174 >Privoxy</SPAN
175 >, such as that might cause a crash.
176    </P
177 ></LI
178 ></UL
179 ><DIV
180 CLASS="SECT3"
181 ><H3
182 CLASS="SECT3"
183 ><A
184 NAME="CONTACT-ADS"
185 >11.2.1. Reporting Ads or Other Configuration Problems</A
186 ></H3
187 ><P
188 > Please send feedback on ads that slipped through, innocent images that were
189  blocked, sites that don't work properly, and other configuration related problem of 
190  <TT
191 CLASS="FILENAME"
192 >default.action</TT
193 > file, to 
194  <A
195 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=460288"
196 TARGET="_top"
197 > http://sourceforge.net/tracker/?group_id=11118&#38;atid=460288</A
198 >,
199  the Actions File Tracker.</P
200 ><P
201 > New, improved <TT
202 CLASS="FILENAME"
203 >default.action</TT
204 > files may occasionally be made
205  available based on your feedback. These will be announced on the <A
206 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce"
207 TARGET="_top"
208 >ijbswa-announce</A
209 >
210  list and available from our the <A
211 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
212 TARGET="_top"
213 >files section</A
214 > of
215  our <A
216 HREF="http://sf.net/projects/ijbswa/"
217 TARGET="_top"
218 >project page</A
219 >.</P
220 ></DIV
221 ><DIV
222 CLASS="SECT3"
223 ><H3
224 CLASS="SECT3"
225 ><A
226 NAME="CONTACT-BUGS"
227 >11.2.2. Reporting Bugs</A
228 ></H3
229 ><P
230 > Please report all bugs through our bug tracker: 
231  <A
232 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118"
233 TARGET="_top"
234 >http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118</A
235 >. </P
236 ><P
237 >  Before doing so, please make sure that the bug has <SPAN
238 CLASS="emphasis"
239 ><I
240 CLASS="EMPHASIS"
241 >not already been submitted</I
242 ></SPAN
243 >
244   and observe the additional hints at the top of the <A
245 HREF="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118"
246 TARGET="_top"
247 >submit
248   form</A
249 >. If already submitted, please feel free to add any info to the 
250   original report that might help to solve the issue.</P
251 ><P
252 >  Please try to verify that it is a <SPAN
253 CLASS="APPLICATION"
254 >Privoxy</SPAN
255 > bug,
256   and not a browser or site bug or documented behaviour that just happens
257   to be different than what you expected. If unsure,
258   try <A
259 HREF="http://config.privoxy.org/toggle?set=disable"
260 TARGET="_top"
261 >toggling
262   off</A
263 > <SPAN
264 CLASS="APPLICATION"
265 >Privoxy</SPAN
266 >, and see if the problem persists.</P
267 ><P
268 >  If you are using your own custom configuration, please try
269   the stock configs to see if the problem is configuration related.
270   If you're having problems with a feature that is disabled by default,
271   please ask around on the mailing list if others can reproduce the problem.</P
272 ><P
273 >  If you aren't using the latest Privoxy version, the bug may have been found
274   and fixed in the meantime. We would appreciate if you could take the time
275   to <A
276 HREF="http://www.privoxy.org/user-manual/installation.html"
277 TARGET="_top"
278 >upgrade
279   to the latest version</A
280 > (or  even the latest CVS snapshot) and verify
281   that your bug still exists.</P
282 ><P
283 >Please be sure to provide the following information:</P
284 ><P
285 > <P
286 ></P
287 ><UL
288 ><LI
289 ><P
290 >    The exact <SPAN
291 CLASS="APPLICATION"
292 >Privoxy</SPAN
293 > version you are using
294     (if you got the source from CVS, please also provide the source code revisions
295      as shown in <A
296 HREF="http://config.privoxy.org/show-version"
297 TARGET="_top"
298 >http://config.privoxy.org/show-version</A
299 >).
300    </P
301 ></LI
302 ><LI
303 ><P
304 >    The operating system and versions you run
305     <SPAN
306 CLASS="APPLICATION"
307 >Privoxy</SPAN
308 > on, (e.g. <SPAN
309 CLASS="APPLICATION"
310 >Windows
311     XP SP2</SPAN
312 >), if you are using a Unix flavor,
313     sending the output of <SPAN
314 CLASS="QUOTE"
315 >"uname -a"</SPAN
316 > should do,
317     in case of GNU/Linux, please also name the distribution.
318    </P
319 ></LI
320 ><LI
321 ><P
322 >    The name, platform, and version of the <SPAN
323 CLASS="APPLICATION"
324 >browser</SPAN
325
326     you were using (e.g. <SPAN
327 CLASS="APPLICATION"
328 >Internet Explorer v5.5</SPAN
329 > for Mac).
330    </P
331 ></LI
332 ><LI
333 ><P
334 >    The URL where the problem occurred, or some way for us to duplicate the
335     problem (e.g. <TT
336 CLASS="LITERAL"
337 >http://somesite.example.com/?somethingelse=123</TT
338 >). 
339    </P
340 ></LI
341 ><LI
342 ><P
343 >    Whether your version of <SPAN
344 CLASS="APPLICATION"
345 >Privoxy</SPAN
346 > is one supplied
347     by the <SPAN
348 CLASS="APPLICATION"
349 >Privoxy</SPAN
350 > developers via SourceForge,
351     or if you got your copy somewhere else.
352    </P
353 ></LI
354 ><LI
355 ><P
356 >    Whether you are using <SPAN
357 CLASS="APPLICATION"
358 >Privoxy</SPAN
359 > in tandem with 
360     another proxy such as <SPAN
361 CLASS="APPLICATION"
362 >Tor</SPAN
363 >. If so, please
364     temporary disable the other proxy to see if the symptoms change.
365    </P
366 ></LI
367 ><LI
368 ><P
369 >    Whether you are using a personal firewall product. If so, does 
370     <SPAN
371 CLASS="APPLICATION"
372 >Privoxy</SPAN
373 > work without it?
374    </P
375 ></LI
376 ><LI
377 ><P
378 >    Any other pertinent information to help identify the problem such as config
379     or log file excerpts (yes, you should have log file entries for each
380     action taken).
381    </P
382 ></LI
383 ></UL
384 ></P
385 ><P
386 > You don't have to tell us your actual name when filing a problem
387  report, but please use a nickname so we can differentiate between
388  your messages and the ones entered by other "anonymous" users that
389  may respond to your request if they have the same problem or already
390  found a solution.</P
391 ><P
392 > Please also check the status of your request a few days after submitting
393  it, as we may request additional information. If you use a SF id,
394  you should automatically get a mail when someone responds to your request.</P
395 ><P
396 >  The <A
397 HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
398 TARGET="_top"
399 >appendix
400   of the Privoxy User Manual</A
401 > also has helpful information 
402   on understanding <TT
403 CLASS="LITERAL"
404 >actions</TT
405 >, and <TT
406 CLASS="LITERAL"
407 >action</TT
408 > debugging. </P
409 ></DIV
410 ></DIV
411 ><DIV
412 CLASS="SECT2"
413 ><H2
414 CLASS="SECT2"
415 ><A
416 NAME="CONTACT-FEATURE"
417 >11.3. Request New Features</A
418 ></H2
419 ><P
420 > You are welcome to submit ideas on new features or other proposals
421  for improvement through our feature request tracker at
422  <A
423 HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118"
424 TARGET="_top"
425 >http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</A
426 >.</P
427 ></DIV
428 ><DIV
429 CLASS="SECT2"
430 ><H2
431 CLASS="SECT2"
432 ><A
433 NAME="CONTACT-OTHER"
434 >11.4. Other</A
435 ></H2
436 ><P
437 >For any other issues, feel free to use the mailing lists. Technically interested users
438 and people who wish to contribute to the project are also welcome on the developers list!
439 You can find an overview of all <SPAN
440 CLASS="APPLICATION"
441 >Privoxy</SPAN
442 >-related mailing lists,
443 including list archives, at:
444 <A
445 HREF="http://sourceforge.net/mail/?group_id=11118"
446 TARGET="_top"
447 >http://sourceforge.net/mail/?group_id=11118</A
448 >.</P
449 ></DIV
450 ></DIV
451 ><DIV
452 CLASS="NAVFOOTER"
453 ><HR
454 ALIGN="LEFT"
455 WIDTH="100%"><TABLE
456 SUMMARY="Footer navigation table"
457 WIDTH="100%"
458 BORDER="0"
459 CELLPADDING="0"
460 CELLSPACING="0"
461 ><TR
462 ><TD
463 WIDTH="33%"
464 ALIGN="left"
465 VALIGN="top"
466 ><A
467 HREF="templates.html"
468 ACCESSKEY="P"
469 >Prev</A
470 ></TD
471 ><TD
472 WIDTH="34%"
473 ALIGN="center"
474 VALIGN="top"
475 ><A
476 HREF="index.html"
477 ACCESSKEY="H"
478 >Home</A
479 ></TD
480 ><TD
481 WIDTH="33%"
482 ALIGN="right"
483 VALIGN="top"
484 ><A
485 HREF="copyright.html"
486 ACCESSKEY="N"
487 >Next</A
488 ></TD
489 ></TR
490 ><TR
491 ><TD
492 WIDTH="33%"
493 ALIGN="left"
494 VALIGN="top"
495 >Privoxy's Template Files</TD
496 ><TD
497 WIDTH="34%"
498 ALIGN="center"
499 VALIGN="top"
500 >&nbsp;</TD
501 ><TD
502 WIDTH="33%"
503 ALIGN="right"
504 VALIGN="top"
505 >Privoxy Copyright, License and History</TD
506 ></TR
507 ></TABLE
508 ></DIV
509 ></BODY
510 ></HTML
511 >