Freshly built HTML docs for 3.0.5 beta.
[privoxy.git] / doc / webserver / user-manual / contact.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >Contacting the Developers, Bug Reporting and Feature
5 Requests</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
9 "><LINK
10 REL="HOME"
11 TITLE="Privoxy 3.0.5 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.5 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 ></A
81 >11. Contacting the Developers, Bug Reporting and Feature
82 Requests</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 ></A
98 >11.1. Get Support</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 ></DIV
120 ><DIV
121 CLASS="SECT2"
122 ><H2
123 CLASS="SECT2"
124 ><A
125 NAME="REPORTING"
126 ></A
127 >11.2. Reporting Problems</H2
128 ><P
129 ><SPAN
130 CLASS="QUOTE"
131 >"Problems"</SPAN
132 > for our purposes, come in two forms:</P
133 ><P
134 ></P
135 ><UL
136 ><LI
137 ><P
138 >    Configuration issues, such as ads that slip through, or sites that 
139     don't function properly due to one <SPAN
140 CLASS="APPLICATION"
141 >Privoxy</SPAN
142
143     <SPAN
144 CLASS="QUOTE"
145 >"action"</SPAN
146 > or another being turned <SPAN
147 CLASS="QUOTE"
148 >"on"</SPAN
149 >.
150    </P
151 ></LI
152 ><LI
153 ><P
154 >    <SPAN
155 CLASS="QUOTE"
156 >"Bugs"</SPAN
157 > in the programming code that makes up 
158     <SPAN
159 CLASS="APPLICATION"
160 >Privoxy</SPAN
161 >, such as that might cause a crash.
162    </P
163 ></LI
164 ></UL
165 ><DIV
166 CLASS="SECT3"
167 ><H3
168 CLASS="SECT3"
169 ><A
170 NAME="CONTACT-ADS"
171 ></A
172 >11.2.1. Reporting Ads or Other Configuration Problems</H3
173 ><P
174 > Please send feedback on ads that slipped through, innocent images that were
175  blocked, sites that don't work properly, and other configuration related problem of 
176  <TT
177 CLASS="FILENAME"
178 >default.action</TT
179 > file, to 
180  <A
181 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=460288"
182 TARGET="_top"
183 > http://sourceforge.net/tracker/?group_id=11118&#38;atid=460288</A
184 >,
185  the Actions File Tracker.</P
186 ><P
187 > New, improved <TT
188 CLASS="FILENAME"
189 >default.action</TT
190 > files may occasionally be made
191  available based on your feedback. These will be announced on the <A
192 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce"
193 TARGET="_top"
194 >ijbswa-announce</A
195 >
196  list and available from our the <A
197 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
198 TARGET="_top"
199 >files section</A
200 > of
201  our <A
202 HREF="http://sf.net/projects/ijbswa/"
203 TARGET="_top"
204 >project page</A
205 >.</P
206 ></DIV
207 ><DIV
208 CLASS="SECT3"
209 ><H3
210 CLASS="SECT3"
211 ><A
212 NAME="CONTACT-BUGS"
213 ></A
214 >11.2.2. Reporting Bugs</H3
215 ><P
216 > Please report all bugs <SPAN
217 CLASS="emphasis"
218 ><I
219 CLASS="EMPHASIS"
220 >only</I
221 ></SPAN
222 > through our
223  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 solve the issue.</P
244 ><P
245
246   Please try to verify that it is a <SPAN
247 CLASS="APPLICATION"
248 >Privoxy</SPAN
249 > bug,
250   and not a browser or site bug first. If unsure,
251   try <A
252 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());"
253 TARGET="_top"
254 >toggling
255   off</A
256 > <SPAN
257 CLASS="APPLICATION"
258 >Privoxy</SPAN
259 >, and see if the problem persists.
260   If you are using your own custom configuration, please try
261   the stock configs to see if the problem is configuration related.</P
262 ><P
263 >  If not using the latest version, the bug may have been found
264   and fixed in the meantime. We would appreciate if you could take the time
265   to <A
266 HREF="http://www.privoxy.org/user-manual/installation.html"
267 TARGET="_top"
268 >upgrade
269   to the latest version</A
270 > (or  even the latest CVS snapshot) and verify
271   your bug.</P
272 ><P
273 >Please be sure to provide the following information:</P
274 ><P
275 > <P
276 ></P
277 ><UL
278 ><LI
279 ><P
280 >    The exact <SPAN
281 CLASS="APPLICATION"
282 >Privoxy</SPAN
283 > version of the proxy software
284 (if you got the source from CVS, please also give the date).
285    </P
286 ></LI
287 ><LI
288 ><P
289 >    The operating system and versions you run
290     <SPAN
291 CLASS="APPLICATION"
292 >Privoxy</SPAN
293 > on, (e.g. <SPAN
294 CLASS="APPLICATION"
295 >Windows
296     XP</SPAN
297 >).
298    </P
299 ></LI
300 ><LI
301 ><P
302 >    The name, platform, and version of the <SPAN
303 CLASS="APPLICATION"
304 >browser</SPAN
305
306     you were using (e.g. <SPAN
307 CLASS="APPLICATION"
308 >Internet Explorer v5.5</SPAN
309 > for Mac).
310    </P
311 ></LI
312 ><LI
313 ><P
314 >    The URL where the problem occurred, or some way for us to duplicate the
315     problem (e.g. <TT
316 CLASS="LITERAL"
317 >http://somesite.example.com?somethingelse=123</TT
318 >). 
319    </P
320 ></LI
321 ><LI
322 ><P
323 >    Whether your version of <SPAN
324 CLASS="APPLICATION"
325 >Privoxy</SPAN
326 > is one supplied
327     by the developers of <SPAN
328 CLASS="APPLICATION"
329 >Privoxy</SPAN
330 > via SourceForge,
331     or somewhere else.
332    </P
333 ></LI
334 ><LI
335 ><P
336 >    Whether you are using <SPAN
337 CLASS="APPLICATION"
338 >Privoxy</SPAN
339 > in tandem with 
340     another proxy such as <SPAN
341 CLASS="APPLICATION"
342 >TOR</SPAN
343 >. If so, please try 
344     disabling the other proxy.
345    </P
346 ></LI
347 ><LI
348 ><P
349 >    Whether you are using a personal firewall product. If so, does 
350     <SPAN
351 CLASS="APPLICATION"
352 >Privoxy</SPAN
353 > work without it?
354    </P
355 ></LI
356 ><LI
357 ><P
358 >    Any other pertinent information to help identify the problem such as config
359     or log file excerpts (yes, you should have log file entries for each
360     action taken).
361    </P
362 ></LI
363 ><LI
364 ><P
365 >    <SPAN
366 CLASS="emphasis"
367 ><I
368 CLASS="EMPHASIS"
369 >Please provide your SF login, or email address</I
370 ></SPAN
371 >, in case we 
372     need to contact you.
373    </P
374 ></LI
375 ></UL
376 ></P
377 ><P
378 >  The <A
379 HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
380 TARGET="_top"
381 >appendix
382   of the Privoxy User Manual</A
383 > also has helpful information 
384   on understanding <TT
385 CLASS="LITERAL"
386 >actions</TT
387 >, and <TT
388 CLASS="LITERAL"
389 >action</TT
390 > debugging. </P
391 ></DIV
392 ></DIV
393 ><DIV
394 CLASS="SECT2"
395 ><H2
396 CLASS="SECT2"
397 ><A
398 NAME="CONTACT-FEATURE"
399 ></A
400 >11.3. Request New Features</H2
401 ><P
402 > You are welcome to submit ideas on new features or other proposals
403  for improvement through our feature request tracker at
404  <A
405 HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118"
406 TARGET="_top"
407 >http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</A
408 >.</P
409 ></DIV
410 ><DIV
411 CLASS="SECT2"
412 ><H2
413 CLASS="SECT2"
414 ><A
415 NAME="CONTACT-OTHER"
416 ></A
417 >11.4. Other</H2
418 ><P
419 >For any other issues, feel free to use the mailing lists. Technically interested users
420 and people who wish to contribute to the project are also welcome on the developers list!
421 You can find an overview of all <SPAN
422 CLASS="APPLICATION"
423 >Privoxy</SPAN
424 >-related mailing lists,
425 including list archives, at:
426 <A
427 HREF="http://sourceforge.net/mail/?group_id=11118"
428 TARGET="_top"
429 >http://sourceforge.net/mail/?group_id=11118</A
430 >.</P
431 ></DIV
432 ></DIV
433 ><DIV
434 CLASS="NAVFOOTER"
435 ><HR
436 ALIGN="LEFT"
437 WIDTH="100%"><TABLE
438 SUMMARY="Footer navigation table"
439 WIDTH="100%"
440 BORDER="0"
441 CELLPADDING="0"
442 CELLSPACING="0"
443 ><TR
444 ><TD
445 WIDTH="33%"
446 ALIGN="left"
447 VALIGN="top"
448 ><A
449 HREF="templates.html"
450 ACCESSKEY="P"
451 >Prev</A
452 ></TD
453 ><TD
454 WIDTH="34%"
455 ALIGN="center"
456 VALIGN="top"
457 ><A
458 HREF="index.html"
459 ACCESSKEY="H"
460 >Home</A
461 ></TD
462 ><TD
463 WIDTH="33%"
464 ALIGN="right"
465 VALIGN="top"
466 ><A
467 HREF="copyright.html"
468 ACCESSKEY="N"
469 >Next</A
470 ></TD
471 ></TR
472 ><TR
473 ><TD
474 WIDTH="33%"
475 ALIGN="left"
476 VALIGN="top"
477 >Privoxy's Template Files</TD
478 ><TD
479 WIDTH="34%"
480 ALIGN="center"
481 VALIGN="top"
482 >&nbsp;</TD
483 ><TD
484 WIDTH="33%"
485 ALIGN="right"
486 VALIGN="top"
487 >Privoxy Copyright, License and History</TD
488 ></TR
489 ></TABLE
490 ></DIV
491 ></BODY
492 ></HTML
493 >