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