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