Add a "Whats New in this release" Section. Further work on multiple filter
[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.4 User Manual"
12 HREF="index.html"><LINK
13 REL="PREVIOUS"
14 TITLE="Templates"
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"></HEAD
22 ><BODY
23 CLASS="SECT1"
24 BGCOLOR="#EEEEEE"
25 TEXT="#000000"
26 LINK="#0000FF"
27 VLINK="#840084"
28 ALINK="#0000FF"
29 ><DIV
30 CLASS="NAVHEADER"
31 ><TABLE
32 SUMMARY="Header navigation table"
33 WIDTH="100%"
34 BORDER="0"
35 CELLPADDING="0"
36 CELLSPACING="0"
37 ><TR
38 ><TH
39 COLSPAN="3"
40 ALIGN="center"
41 >Privoxy 3.0.4 User Manual</TH
42 ></TR
43 ><TR
44 ><TD
45 WIDTH="10%"
46 ALIGN="left"
47 VALIGN="bottom"
48 ><A
49 HREF="templates.html"
50 ACCESSKEY="P"
51 >Prev</A
52 ></TD
53 ><TD
54 WIDTH="80%"
55 ALIGN="center"
56 VALIGN="bottom"
57 ></TD
58 ><TD
59 WIDTH="10%"
60 ALIGN="right"
61 VALIGN="bottom"
62 ><A
63 HREF="copyright.html"
64 ACCESSKEY="N"
65 >Next</A
66 ></TD
67 ></TR
68 ></TABLE
69 ><HR
70 ALIGN="LEFT"
71 WIDTH="100%"></DIV
72 ><DIV
73 CLASS="SECT1"
74 ><H1
75 CLASS="SECT1"
76 ><A
77 NAME="CONTACT"
78 ></A
79 >11. Contacting the Developers, Bug Reporting and Feature
80 Requests</H1
81 ><P
82 > We value your feedback. In fact, we rely on it to improve
83  <SPAN
84 CLASS="APPLICATION"
85 >Privoxy</SPAN
86 > and its configuration.
87  However, please note the following hints, so we can 
88  provide you with the best support:</P
89 ><DIV
90 CLASS="SECT2"
91 ><H2
92 CLASS="SECT2"
93 ><A
94 NAME="CONTACT-SUPPORT"
95 ></A
96 >11.1. Get Support</H2
97 ><P
98 > For casual users, our 
99  <A
100 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118"
101 TARGET="_top"
102 >support forum at SourceForge</A
103 >
104  is probably best suited:
105  <A
106 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118"
107 TARGET="_top"
108 >http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118</A
109 ></P
110 ><P
111 > All users are of course welcome to discuss their issues on the <A
112 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-users"
113 TARGET="_top"
114 >users
115  mailing list</A
116 >, where the developers also hang around.</P
117 ></DIV
118 ><DIV
119 CLASS="SECT2"
120 ><H2
121 CLASS="SECT2"
122 ><A
123 NAME="REPORTING"
124 ></A
125 >11.2. Reporting Problems</H2
126 ><P
127 ><SPAN
128 CLASS="QUOTE"
129 >"Problems"</SPAN
130 > for our purposes, come in two forms:</P
131 ><P
132 ></P
133 ><UL
134 ><LI
135 ><P
136 >    Configuration issues, such as ads that slip through, or sites that 
137     don't function properly due to one <SPAN
138 CLASS="APPLICATION"
139 >Privoxy</SPAN
140
141     <SPAN
142 CLASS="QUOTE"
143 >"action"</SPAN
144 > or another being turned <SPAN
145 CLASS="QUOTE"
146 >"on"</SPAN
147 >.
148    </P
149 ></LI
150 ><LI
151 ><P
152 >    <SPAN
153 CLASS="QUOTE"
154 >"Bugs"</SPAN
155 > in the programming code that makes up 
156     <SPAN
157 CLASS="APPLICATION"
158 >Privoxy</SPAN
159 >, such as that might cause a crash.
160    </P
161 ></LI
162 ></UL
163 ><DIV
164 CLASS="SECT3"
165 ><H3
166 CLASS="SECT3"
167 ><A
168 NAME="CONTACT-ADS"
169 ></A
170 >11.2.1. Reporting Ads or Other Configuration Problems</H3
171 ><P
172 > Please send feedback on ads that slipped through, innocent images that were
173  blocked, sites that don't work properly, and other configuration related problem of 
174  <TT
175 CLASS="FILENAME"
176 >default.action</TT
177 > file, to 
178  <A
179 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=460288"
180 TARGET="_top"
181 > http://sourceforge.net/tracker/?group_id=11118&#38;atid=460288</A
182 >,
183  the Actions File Tracker.</P
184 ><P
185 > New, improved <TT
186 CLASS="FILENAME"
187 >default.action</TT
188 > files may occasionally be made
189  available based on your feedback. These will be announced on the <A
190 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce"
191 TARGET="_top"
192 >ijbswa-announce</A
193 >
194  list and available from our the <A
195 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
196 TARGET="_top"
197 >files section</A
198 > of
199  our <A
200 HREF="http://sf.net/projects/ijbswa/"
201 TARGET="_top"
202 >project page</A
203 >.</P
204 ></DIV
205 ><DIV
206 CLASS="SECT3"
207 ><H3
208 CLASS="SECT3"
209 ><A
210 NAME="CONTACT-BUGS"
211 ></A
212 >11.2.2. Reporting Bugs</H3
213 ><P
214 > Please report all bugs <SPAN
215 CLASS="emphasis"
216 ><I
217 CLASS="EMPHASIS"
218 >only</I
219 ></SPAN
220 > through our
221  bug tracker: 
222  <A
223 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118"
224 TARGET="_top"
225 >http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118</A
226 >. </P
227 ><P
228 >  Before doing so, please make sure that the bug has <SPAN
229 CLASS="emphasis"
230 ><I
231 CLASS="EMPHASIS"
232 >not already been submitted</I
233 ></SPAN
234 >
235   and observe the additional hints at the top of the <A
236 HREF="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118"
237 TARGET="_top"
238 >submit
239   form</A
240 >. If already submitted, please feel free to add any info to the 
241   original report that might help solve the issue.</P
242 ><P
243
244   Please try to verify that it is a <SPAN
245 CLASS="APPLICATION"
246 >Privoxy</SPAN
247 > bug,
248   and not a browser or site bug first. If unsure,
249   try <A
250 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());"
251 TARGET="_top"
252 >toggling
253   off</A
254 > <SPAN
255 CLASS="APPLICATION"
256 >Privoxy</SPAN
257 >, and see if the problem persists.
258   If you are using your own custom configuration, please try
259   the stock configs to see if the problem is configuration related.</P
260 ><P
261 >  If not using the latest version, the bug may have been found
262   and fixed in the meantime. We would appreciate if you could take the time
263   to <A
264 HREF="http://www.privoxy.org/user-manual/installation.html"
265 TARGET="_top"
266 >upgrade
267   to the latest version</A
268 > (or  even the latest CVS snapshot) and verify
269   your bug.</P
270 ><P
271 >Please be sure to provide the following information:</P
272 ><P
273 > <P
274 ></P
275 ><UL
276 ><LI
277 ><P
278 >    The exact <SPAN
279 CLASS="APPLICATION"
280 >Privoxy</SPAN
281 > version of the proxy software
282 (if you got the source from CVS, please also give the date).
283    </P
284 ></LI
285 ><LI
286 ><P
287 >    The operating system and verions you run
288     <SPAN
289 CLASS="APPLICATION"
290 >Privoxy</SPAN
291 > on, (e.g. <SPAN
292 CLASS="APPLICATION"
293 >Windows
294     XP</SPAN
295 >).
296    </P
297 ></LI
298 ><LI
299 ><P
300 >    The name, platform, and version of the <SPAN
301 CLASS="APPLICATION"
302 >browser</SPAN
303
304     you were using (e.g. <SPAN
305 CLASS="APPLICATION"
306 >Internet Explorer v5.5</SPAN
307 > for Mac).
308    </P
309 ></LI
310 ><LI
311 ><P
312 >    The URL where the problem occurred, or some way for us to duplicate the
313     problem (e.g. <TT
314 CLASS="LITERAL"
315 >http://somesite.example.com?somethingelse=123</TT
316 >). 
317    </P
318 ></LI
319 ><LI
320 ><P
321 >    Whether your version of <SPAN
322 CLASS="APPLICATION"
323 >Privoxy</SPAN
324 > is one supplied
325     by the developers of <SPAN
326 CLASS="APPLICATION"
327 >Privoxy</SPAN
328 > via SourceForge,
329     or somewhere else.
330    </P
331 ></LI
332 ><LI
333 ><P
334 >    Whether you are using <SPAN
335 CLASS="APPLICATION"
336 >Privoxy</SPAN
337 > in tandem with 
338     another proxy such as <SPAN
339 CLASS="APPLICATION"
340 >TOR</SPAN
341 >. If so, please try 
342     disabling the other proxy.
343    </P
344 ></LI
345 ><LI
346 ><P
347 >    Whether you are using a personal firewall product. If so, does 
348     <SPAN
349 CLASS="APPLICATION"
350 >Privoxy</SPAN
351 > work without it?
352    </P
353 ></LI
354 ><LI
355 ><P
356 >    Any other pertinent information to help identify the problem such as config
357     or log file excerpts (yes, you should have log file entries for each
358     action taken).
359    </P
360 ></LI
361 ><LI
362 ><P
363 >    <SPAN
364 CLASS="emphasis"
365 ><I
366 CLASS="EMPHASIS"
367 >Please provide your SF login, or email address</I
368 ></SPAN
369 >, in case we 
370     need to contact you.
371    </P
372 ></LI
373 ></UL
374 ></P
375 ><P
376 >  The <A
377 HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
378 TARGET="_top"
379 >appendix
380   of the user manual</A
381 > also has helpful information 
382   on understanding <TT
383 CLASS="LITERAL"
384 >actions</TT
385 >, and <TT
386 CLASS="LITERAL"
387 >action</TT
388 > debugging. </P
389 ></DIV
390 ></DIV
391 ><DIV
392 CLASS="SECT2"
393 ><H2
394 CLASS="SECT2"
395 ><A
396 NAME="CONTACT-FEATURE"
397 ></A
398 >11.3. Request New Features</H2
399 ><P
400 > You are welcome to submit ideas on new features or other proposals
401  for improvement through our feature request tracker at
402  <A
403 HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118"
404 TARGET="_top"
405 >http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</A
406 >.</P
407 ></DIV
408 ><DIV
409 CLASS="SECT2"
410 ><H2
411 CLASS="SECT2"
412 ><A
413 NAME="CONTACT-OTHER"
414 ></A
415 >11.4. Other</H2
416 ><P
417 >For any other issues, feel free to use the mailing lists. Technically interested users
418 and people who wish to contribute to the project are also welcome on the developers list!
419 You can find an overview of all <SPAN
420 CLASS="APPLICATION"
421 >Privoxy</SPAN
422 >-related mailing lists,
423 including list archives, at:
424 <A
425 HREF="http://sourceforge.net/mail/?group_id=11118"
426 TARGET="_top"
427 >http://sourceforge.net/mail/?group_id=11118</A
428 >.</P
429 ></DIV
430 ></DIV
431 ><DIV
432 CLASS="NAVFOOTER"
433 ><HR
434 ALIGN="LEFT"
435 WIDTH="100%"><TABLE
436 SUMMARY="Footer navigation table"
437 WIDTH="100%"
438 BORDER="0"
439 CELLPADDING="0"
440 CELLSPACING="0"
441 ><TR
442 ><TD
443 WIDTH="33%"
444 ALIGN="left"
445 VALIGN="top"
446 ><A
447 HREF="templates.html"
448 ACCESSKEY="P"
449 >Prev</A
450 ></TD
451 ><TD
452 WIDTH="34%"
453 ALIGN="center"
454 VALIGN="top"
455 ><A
456 HREF="index.html"
457 ACCESSKEY="H"
458 >Home</A
459 ></TD
460 ><TD
461 WIDTH="33%"
462 ALIGN="right"
463 VALIGN="top"
464 ><A
465 HREF="copyright.html"
466 ACCESSKEY="N"
467 >Next</A
468 ></TD
469 ></TR
470 ><TR
471 ><TD
472 WIDTH="33%"
473 ALIGN="left"
474 VALIGN="top"
475 >Templates</TD
476 ><TD
477 WIDTH="34%"
478 ALIGN="center"
479 VALIGN="top"
480 >&nbsp;</TD
481 ><TD
482 WIDTH="33%"
483 ALIGN="right"
484 VALIGN="top"
485 ><SPAN
486 CLASS="APPLICATION"
487 >Privoxy</SPAN
488 > Copyright, License and History</TD
489 ></TR
490 ></TABLE
491 ></DIV
492 ></BODY
493 ></HTML
494 >