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