Re-commit to solve various last minute issues for charsets, etc.
[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&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&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 > Note that the Privoxy mailing lists are moderated. Posts from unsubscribed
120  addresses have to be accepted manually by a moderator. This may cause a
121  delay of several days and if you use a subject that doesn't clearly
122  mention Privoxy or one of its features, your message may be accidentally
123  discarded as spam.</P
124 ><P
125 > If you aren't subscribed, you should therefore spend a few seconds
126  to come up with a proper subject. Additionally you should make it clear
127  that you want to get CC'd. Otherwise some responses will be directed to
128  the mailing list only, and you won't see them.</P
129 ></DIV
130 ><DIV
131 CLASS="SECT2"
132 ><H2
133 CLASS="SECT2"
134 ><A
135 NAME="REPORTING"
136 >6.2. Reporting Problems</A
137 ></H2
138 ><P
139 ><SPAN
140 CLASS="QUOTE"
141 >"Problems"</SPAN
142 > for our purposes, come in two forms:</P
143 ><P
144 ></P
145 ><UL
146 ><LI
147 ><P
148 >    Configuration issues, such as ads that slip through, or sites that 
149     don't function properly due to one <SPAN
150 CLASS="APPLICATION"
151 >Privoxy</SPAN
152
153     <SPAN
154 CLASS="QUOTE"
155 >"action"</SPAN
156 > or another being turned <SPAN
157 CLASS="QUOTE"
158 >"on"</SPAN
159 >.
160    </P
161 ></LI
162 ><LI
163 ><P
164 >    <SPAN
165 CLASS="QUOTE"
166 >"Bugs"</SPAN
167 > in the programming code that makes up 
168     <SPAN
169 CLASS="APPLICATION"
170 >Privoxy</SPAN
171 >, such as that might cause a crash.
172    </P
173 ></LI
174 ></UL
175 ><DIV
176 CLASS="SECT3"
177 ><H3
178 CLASS="SECT3"
179 ><A
180 NAME="CONTACT-ADS"
181 >6.2.1. Reporting Ads or Other Configuration Problems</A
182 ></H3
183 ><P
184 > Please send feedback on ads that slipped through, innocent images that were
185  blocked, sites that don't work properly, and other configuration related problem of 
186  <TT
187 CLASS="FILENAME"
188 >default.action</TT
189 > file, to 
190  <A
191 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=460288"
192 TARGET="_top"
193 > http://sourceforge.net/tracker/?group_id=11118&#38;atid=460288</A
194 >,
195  the Actions File Tracker.</P
196 ><P
197 > New, improved <TT
198 CLASS="FILENAME"
199 >default.action</TT
200 > files may occasionally be made
201  available based on your feedback. These will be announced on the <A
202 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce"
203 TARGET="_top"
204 >ijbswa-announce</A
205 >
206  list and available from our the <A
207 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
208 TARGET="_top"
209 >files section</A
210 > of
211  our <A
212 HREF="http://sf.net/projects/ijbswa/"
213 TARGET="_top"
214 >project page</A
215 >.</P
216 ></DIV
217 ><DIV
218 CLASS="SECT3"
219 ><H3
220 CLASS="SECT3"
221 ><A
222 NAME="CONTACT-BUGS"
223 >6.2.2. Reporting Bugs</A
224 ></H3
225 ><P
226 > Please report all bugs through our bug tracker: 
227  <A
228 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118"
229 TARGET="_top"
230 >http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118</A
231 >. </P
232 ><P
233 >  Before doing so, please make sure that the bug has <SPAN
234 CLASS="emphasis"
235 ><I
236 CLASS="EMPHASIS"
237 >not already been submitted</I
238 ></SPAN
239 >
240   and observe the additional hints at the top of the <A
241 HREF="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118"
242 TARGET="_top"
243 >submit
244   form</A
245 >. If already submitted, please feel free to add any info to the 
246   original report that might help to solve the issue.</P
247 ><P
248 >  Please try to verify that it is a <SPAN
249 CLASS="APPLICATION"
250 >Privoxy</SPAN
251 > bug,
252   and not a browser or site bug or documented behaviour that just happens
253   to be different than what you expected. If unsure,
254   try <A
255 HREF="http://config.privoxy.org/toggle?set=disable"
256 TARGET="_top"
257 >toggling
258   off</A
259 > <SPAN
260 CLASS="APPLICATION"
261 >Privoxy</SPAN
262 >, and see if the problem persists.</P
263 ><P
264 >  If you are using your own custom configuration, please try
265   the stock configs to see if the problem is configuration related.
266   If you're having problems with a feature that is disabled by default,
267   please ask around on the mailing list if others can reproduce the problem.</P
268 ><P
269 >  If you aren't using the latest Privoxy version, the bug may have been found
270   and fixed in the meantime. We would appreciate if you could take the time
271   to <A
272 HREF="http://www.privoxy.org/user-manual/installation.html"
273 TARGET="_top"
274 >upgrade
275   to the latest version</A
276 > (or  even the latest CVS snapshot) and verify
277   that your bug still exists.</P
278 ><P
279 >Please be sure to provide the following information:</P
280 ><P
281 > <P
282 ></P
283 ><UL
284 ><LI
285 ><P
286 >    The exact <SPAN
287 CLASS="APPLICATION"
288 >Privoxy</SPAN
289 > version you are using
290     (if you got the source from CVS, please also provide the source code revisions
291      as shown in <A
292 HREF="http://config.privoxy.org/show-version"
293 TARGET="_top"
294 >http://config.privoxy.org/show-version</A
295 >).
296    </P
297 ></LI
298 ><LI
299 ><P
300 >    The operating system and versions you run
301     <SPAN
302 CLASS="APPLICATION"
303 >Privoxy</SPAN
304 > on, (e.g. <SPAN
305 CLASS="APPLICATION"
306 >Windows
307     XP SP2</SPAN
308 >), if you are using a Unix flavor,
309     sending the output of <SPAN
310 CLASS="QUOTE"
311 >"uname -a"</SPAN
312 > should do,
313     in case of GNU/Linux, please also name the distribution.
314    </P
315 ></LI
316 ><LI
317 ><P
318 >    The name, platform, and version of the <SPAN
319 CLASS="APPLICATION"
320 >browser</SPAN
321
322     you were using (e.g. <SPAN
323 CLASS="APPLICATION"
324 >Internet Explorer v5.5</SPAN
325 > for Mac).
326    </P
327 ></LI
328 ><LI
329 ><P
330 >    The URL where the problem occurred, or some way for us to duplicate the
331     problem (e.g. <TT
332 CLASS="LITERAL"
333 >http://somesite.example.com/?somethingelse=123</TT
334 >). 
335    </P
336 ></LI
337 ><LI
338 ><P
339 >    Whether your version of <SPAN
340 CLASS="APPLICATION"
341 >Privoxy</SPAN
342 > is one supplied
343     by the <SPAN
344 CLASS="APPLICATION"
345 >Privoxy</SPAN
346 > developers via SourceForge,
347     or if you got your copy somewhere else.
348    </P
349 ></LI
350 ><LI
351 ><P
352 >    Whether you are using <SPAN
353 CLASS="APPLICATION"
354 >Privoxy</SPAN
355 > in tandem with 
356     another proxy such as <SPAN
357 CLASS="APPLICATION"
358 >Tor</SPAN
359 >. If so, please
360     temporary disable the other proxy to see if the symptoms change.
361    </P
362 ></LI
363 ><LI
364 ><P
365 >    Whether you are using a personal firewall product. If so, does 
366     <SPAN
367 CLASS="APPLICATION"
368 >Privoxy</SPAN
369 > work without it?
370    </P
371 ></LI
372 ><LI
373 ><P
374 >    Any other pertinent information to help identify the problem such as config
375     or log file excerpts (yes, you should have log file entries for each
376     action taken).
377    </P
378 ></LI
379 ></UL
380 ></P
381 ><P
382 > You don't have to tell us your actual name when filing a problem
383  report, but please use a nickname so we can differentiate between
384  your messages and the ones entered by other "anonymous" users that
385  may respond to your request if they have the same problem or already
386  found a solution.</P
387 ><P
388 > Please also check the status of your request a few days after submitting
389  it, as we may request additional information. If you use a SF id,
390  you should automatically get a mail when someone responds to your request.</P
391 ><P
392 >  The <A
393 HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
394 TARGET="_top"
395 >appendix
396   of the Privoxy User Manual</A
397 > also has helpful information 
398   on understanding <TT
399 CLASS="LITERAL"
400 >actions</TT
401 >, and <TT
402 CLASS="LITERAL"
403 >action</TT
404 > debugging. </P
405 ></DIV
406 ></DIV
407 ><DIV
408 CLASS="SECT2"
409 ><H2
410 CLASS="SECT2"
411 ><A
412 NAME="CONTACT-FEATURE"
413 >6.3. Request New Features</A
414 ></H2
415 ><P
416 > You are welcome to submit ideas on new features or other proposals
417  for improvement through our feature request tracker at
418  <A
419 HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118"
420 TARGET="_top"
421 >http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</A
422 >.</P
423 ></DIV
424 ><DIV
425 CLASS="SECT2"
426 ><H2
427 CLASS="SECT2"
428 ><A
429 NAME="CONTACT-OTHER"
430 >6.4. Other</A
431 ></H2
432 ><P
433 >For any other issues, feel free to use the mailing lists. Technically interested users
434 and people who wish to contribute to the project are also welcome on the developers list!
435 You can find an overview of all <SPAN
436 CLASS="APPLICATION"
437 >Privoxy</SPAN
438 >-related mailing lists,
439 including list archives, at:
440 <A
441 HREF="http://sourceforge.net/mail/?group_id=11118"
442 TARGET="_top"
443 >http://sourceforge.net/mail/?group_id=11118</A
444 >.</P
445 ></DIV
446 ></DIV
447 ><DIV
448 CLASS="NAVFOOTER"
449 ><HR
450 ALIGN="LEFT"
451 WIDTH="100%"><TABLE
452 SUMMARY="Footer navigation table"
453 WIDTH="100%"
454 BORDER="0"
455 CELLPADDING="0"
456 CELLSPACING="0"
457 ><TR
458 ><TD
459 WIDTH="33%"
460 ALIGN="left"
461 VALIGN="top"
462 ><A
463 HREF="trouble.html"
464 ACCESSKEY="P"
465 >Prev</A
466 ></TD
467 ><TD
468 WIDTH="34%"
469 ALIGN="center"
470 VALIGN="top"
471 ><A
472 HREF="index.html"
473 ACCESSKEY="H"
474 >Home</A
475 ></TD
476 ><TD
477 WIDTH="33%"
478 ALIGN="right"
479 VALIGN="top"
480 ><A
481 HREF="copyright.html"
482 ACCESSKEY="N"
483 >Next</A
484 ></TD
485 ></TR
486 ><TR
487 ><TD
488 WIDTH="33%"
489 ALIGN="left"
490 VALIGN="top"
491 >Troubleshooting</TD
492 ><TD
493 WIDTH="34%"
494 ALIGN="center"
495 VALIGN="top"
496 >&nbsp;</TD
497 ><TD
498 WIDTH="33%"
499 ALIGN="right"
500 VALIGN="top"
501 >Privoxy Copyright, License and History</TD
502 ></TR
503 ></TABLE
504 ></DIV
505 ></BODY
506 ></HTML
507 >