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