bdf781e1c9b69e5f0024fdcaa414dfbd8218fbfe
[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 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="javascript:void(window.open('http://config.privoxy.org/toggle?mini=y&set=disabled','ijbstatus','width=250,height=100,resizable=yes,scrollbars=no,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());"
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 give the date).
281    </P
282 ></LI
283 ><LI
284 ><P
285 >    The operating system and verions you run
286     <SPAN
287 CLASS="APPLICATION"
288 >Privoxy</SPAN
289 > on, (e.g. <SPAN
290 CLASS="APPLICATION"
291 >Windows
292     XP</SPAN
293 >).
294    </P
295 ></LI
296 ><LI
297 ><P
298 >    The name, platform, and version of the <SPAN
299 CLASS="APPLICATION"
300 >browser</SPAN
301
302     you were using (e.g. <SPAN
303 CLASS="APPLICATION"
304 >Internet Explorer v5.5</SPAN
305 > for Mac).
306    </P
307 ></LI
308 ><LI
309 ><P
310 >    The URL where the problem occurred, or some way for us to duplicate the
311     problem (e.g. <TT
312 CLASS="LITERAL"
313 >http://somesite.example.com?somethingelse=123</TT
314 >). 
315    </P
316 ></LI
317 ><LI
318 ><P
319 >    Whether your version of <SPAN
320 CLASS="APPLICATION"
321 >Privoxy</SPAN
322 > is one supplied
323     by the developers of <SPAN
324 CLASS="APPLICATION"
325 >Privoxy</SPAN
326 > via SourceForge,
327     or somewhere else.
328    </P
329 ></LI
330 ><LI
331 ><P
332 >    Whether you are using <SPAN
333 CLASS="APPLICATION"
334 >Privoxy</SPAN
335 > in tandem with 
336     another proxy such as <SPAN
337 CLASS="APPLICATION"
338 >TOR</SPAN
339 >. If so, please try 
340     disabling the other proxy.
341    </P
342 ></LI
343 ><LI
344 ><P
345 >    Whether you are using a personal firewall product. If so, does 
346     <SPAN
347 CLASS="APPLICATION"
348 >Privoxy</SPAN
349 > work without it?
350    </P
351 ></LI
352 ><LI
353 ><P
354 >    Any other pertinent information to help identify the problem such as config
355     or log file excerpts (yes, you should have log file entries for each
356     action taken).
357    </P
358 ></LI
359 ><LI
360 ><P
361 >    <SPAN
362 CLASS="emphasis"
363 ><I
364 CLASS="EMPHASIS"
365 >Please provide your SF login, or email address</I
366 ></SPAN
367 >, in case we 
368     need to contact you.
369    </P
370 ></LI
371 ></UL
372 ></P
373 ><P
374 >  The <A
375 HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
376 TARGET="_top"
377 >appendix
378   of the user manual</A
379 > also has helpful information 
380   on understanding <TT
381 CLASS="LITERAL"
382 >actions</TT
383 >, and <TT
384 CLASS="LITERAL"
385 >action</TT
386 > debugging. </P
387 ></DIV
388 ></DIV
389 ><DIV
390 CLASS="SECT2"
391 ><H2
392 CLASS="SECT2"
393 ><A
394 NAME="CONTACT-FEATURE"
395 ></A
396 >6.3. Request New Features</H2
397 ><P
398 > You are welcome to submit ideas on new features or other proposals
399  for improvement through our feature request tracker at
400  <A
401 HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118"
402 TARGET="_top"
403 >http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</A
404 >.</P
405 ></DIV
406 ><DIV
407 CLASS="SECT2"
408 ><H2
409 CLASS="SECT2"
410 ><A
411 NAME="CONTACT-OTHER"
412 ></A
413 >6.4. Other</H2
414 ><P
415 >For any other issues, feel free to use the mailing lists. Technically interested users
416 and people who wish to contribute to the project are also welcome on the developers list!
417 You can find an overview of all <SPAN
418 CLASS="APPLICATION"
419 >Privoxy</SPAN
420 >-related mailing lists,
421 including list archives, at:
422 <A
423 HREF="http://sourceforge.net/mail/?group_id=11118"
424 TARGET="_top"
425 >http://sourceforge.net/mail/?group_id=11118</A
426 >.</P
427 ></DIV
428 ></DIV
429 ><DIV
430 CLASS="NAVFOOTER"
431 ><HR
432 ALIGN="LEFT"
433 WIDTH="100%"><TABLE
434 SUMMARY="Footer navigation table"
435 WIDTH="100%"
436 BORDER="0"
437 CELLPADDING="0"
438 CELLSPACING="0"
439 ><TR
440 ><TD
441 WIDTH="33%"
442 ALIGN="left"
443 VALIGN="top"
444 ><A
445 HREF="trouble.html"
446 ACCESSKEY="P"
447 >Prev</A
448 ></TD
449 ><TD
450 WIDTH="34%"
451 ALIGN="center"
452 VALIGN="top"
453 ><A
454 HREF="index.html"
455 ACCESSKEY="H"
456 >Home</A
457 ></TD
458 ><TD
459 WIDTH="33%"
460 ALIGN="right"
461 VALIGN="top"
462 ><A
463 HREF="copyright.html"
464 ACCESSKEY="N"
465 >Next</A
466 ></TD
467 ></TR
468 ><TR
469 ><TD
470 WIDTH="33%"
471 ALIGN="left"
472 VALIGN="top"
473 >Troubleshooting</TD
474 ><TD
475 WIDTH="34%"
476 ALIGN="center"
477 VALIGN="top"
478 >&nbsp;</TD
479 ><TD
480 WIDTH="33%"
481 ALIGN="right"
482 VALIGN="top"
483 >Privoxy Copyright, License and History</TD
484 ></TR
485 ></TABLE
486 ></DIV
487 ></BODY
488 ></HTML
489 >