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