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