X-Git-Url: http://www.privoxy.org/gitweb/?a=blobdiff_plain;f=doc%2Fwebserver%2Fuser-manual%2Fcontact.html;h=05987a3d68d4129a8e71cbaa346119c505a92c3f;hb=66237b3fc4eb5187c29d7bc598a87676db5b780b;hp=3db65565af8aab878c3257e80892ff28a75b959c;hpb=0eb052b2d480ed7354480491a5982ebad16d7d82;p=privoxy.git diff --git a/doc/webserver/user-manual/contact.html b/doc/webserver/user-manual/contact.html index 3db65565..05987a3d 100644 --- a/doc/webserver/user-manual/contact.html +++ b/doc/webserver/user-manual/contact.html @@ -1,3 +1,4 @@ + <META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.64 -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" -TITLE="Privoxy User Manual" +TITLE="Privoxy 3.0.16 User Manual" HREF="index.html"><LINK REL="PREVIOUS" -TITLE="Privoxy Configuration" -HREF="configuration.html"><LINK +TITLE="Privoxy's Template Files" +HREF="templates.html"><LINK REL="NEXT" -TITLE="Copyright and History" +TITLE="Privoxy Copyright, License and History" HREF="copyright.html"><LINK REL="STYLESHEET" TYPE="text/css" -HREF="../p_doc.css"></HEAD +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head ><BODY CLASS="SECT1" BGCOLOR="#EEEEEE" @@ -29,6 +34,7 @@ ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE +SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" @@ -37,7 +43,7 @@ CELLSPACING="0" ><TH COLSPAN="3" ALIGN="center" ->Privoxy User Manual</TH +>Privoxy 3.0.16 User Manual</TH ></TR ><TR ><TD @@ -45,7 +51,8 @@ WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A -HREF="configuration.html" +HREF="templates.html" +ACCESSKEY="P" >Prev</A ></TD ><TD @@ -59,6 +66,7 @@ ALIGN="right" VALIGN="bottom" ><A HREF="copyright.html" +ACCESSKEY="N" >Next</A ></TD ></TR @@ -72,161 +80,406 @@ CLASS="SECT1" CLASS="SECT1" ><A NAME="CONTACT" ->6. Contacting the Developers, Bug Reporting and Feature +>11. Contacting the Developers, Bug Reporting and Feature Requests</A ></H1 ><P -> We value your feedback. However, to provide you with the best support, please - note: - - <P +> We value your feedback. In fact, we rely on it to improve + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> and its configuration. + However, please note the following hints, so we can + provide you with the best support:</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CONTACT-SUPPORT" +>11.1. Get Support</A +></H2 +><P +> For casual users, our + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118" +TARGET="_top" +>support forum at SourceForge</A +> + is probably best suited: + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118" +TARGET="_top" +>http://sourceforge.net/tracker/?group_id=11118&atid=211118</A +></P +><P +> All users are of course welcome to discuss their issues on the <A +HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-users" +TARGET="_top" +>users + mailing list</A +>, where the developers also hang around.</P +><P +> Please don't sent private support requests to individual Privoxy + developers, either use the mailing lists or the support trackers.</P +><P +> Note that the Privoxy mailing lists are moderated. Posts from unsubscribed + addresses have to be accepted manually by a moderator. This may cause a + delay of several days and if you use a subject that doesn't clearly + mention Privoxy or one of its features, your message may be accidentally + discarded as spam.</P +><P +> If you aren't subscribed, you should therefore spend a few seconds + to come up with a proper subject. Additionally you should make it clear + that you want to get CC'd. Otherwise some responses will be directed to + the mailing list only, and you won't see them.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="REPORTING" +>11.2. Reporting Problems</A +></H2 +><P +><SPAN +CLASS="QUOTE" +>"Problems"</SPAN +> for our purposes, come in two forms:</P +><P ></P ><UL ><LI ><P -CLASS="LITERALLAYOUT" ->Use the Sourceforge Support Forum to get help:<br> -   <br> -    <A -HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118" -TARGET="_top" ->http://sourceforge.net/tracker/?group_id=11118&atid=211118</A -><br> -   </P +> Configuration issues, such as ads that slip through, or sites that + don't function properly due to one <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + <SPAN +CLASS="QUOTE" +>"action"</SPAN +> or another being turned <SPAN +CLASS="QUOTE" +>"on"</SPAN +>. + </P ></LI ><LI ><P -CLASS="LITERALLAYOUT" ->Submit bugs only through our Sourceforge Bug Forum:<br> - <br> -    <A -HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118" +> <SPAN +CLASS="QUOTE" +>"Bugs"</SPAN +> in the programming code that makes up + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, such as that might cause a crash. + </P +></LI +></UL +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="CONTACT-ADS" +>11.2.1. Reporting Ads or Other Configuration Problems</A +></H3 +><P +> Please send feedback on ads that slipped through, innocent images that were + blocked, sites that don't work properly, and other configuration related problem of + <TT +CLASS="FILENAME" +>default.action</TT +> file, to + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=460288" +TARGET="_top" +> http://sourceforge.net/tracker/?group_id=11118&atid=460288</A +>, + the Actions File Tracker.</P +><P +> New, improved <TT +CLASS="FILENAME" +>default.action</TT +> files may occasionally be made + available based on your feedback. These will be announced on the <A +HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce" +TARGET="_top" +>ijbswa-announce</A +> + list and available from our the <A +HREF="http://sourceforge.net/project/showfiles.php?group_id=11118" +TARGET="_top" +>files section</A +> of + our <A +HREF="http://sf.net/projects/ijbswa/" +TARGET="_top" +>project page</A +>.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="CONTACT-BUGS" +>11.2.2. Reporting Bugs</A +></H3 +><P +> Please report all bugs through our bug tracker: + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118" TARGET="_top" >http://sourceforge.net/tracker/?group_id=11118&atid=111118</A ->. <br> -    </P +>. </P +><P +> Before doing so, please make sure that the bug has <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not already been submitted</I +></SPAN +> + and observe the additional hints at the top of the <A +HREF="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118" +TARGET="_top" +>submit + form</A +>. If already submitted, please feel free to add any info to the + original report that might help to solve the issue.</P ><P -> Make sure that the bug has not already been submitted. Please try to - verify that it is a <SPAN +> Please try to verify that it is a <SPAN CLASS="APPLICATION" >Privoxy</SPAN -> bug, and not a - browser or site bug first. If you are using your own custom configuration, - please try the stock configs to see if the problem is a configuration - related bug. And if not using the latest development snapshot, please try - the latest one. Or even better, CVS sources. Please be sure to include the - <SPAN +> bug, + and not a browser or site bug or documented behaviour that just happens + to be different than what you expected. If unsure, + try <A +HREF="http://config.privoxy.org/toggle?set=disable" +TARGET="_top" +>toggling + off</A +> <SPAN CLASS="APPLICATION" >Privoxy</SPAN ->/<SPAN -CLASS="APPLICATION" ->Junkbuster</SPAN -> - version, platform, browser, any pertinent log data, any other relevant - details (please be specific) and, if possible, some way to reproduce the - bug. - </P -></LI +>, and see if the problem persists.</P +><P +> If you are using your own custom configuration, please try + the stock configs to see if the problem is configuration related. + If you're having problems with a feature that is disabled by default, + please ask around on the mailing list if others can reproduce the problem.</P +><P +> If you aren't using the latest Privoxy version, the bug may have been found + and fixed in the meantime. We would appreciate if you could take the time + to <A +HREF="http://www.privoxy.org/user-manual/installation.html" +TARGET="_top" +>upgrade + to the latest version</A +> (or even the latest CVS snapshot) and verify + that your bug still exists.</P +><P +>Please be sure to provide the following information:</P +><P +> <P +></P +><UL ><LI ><P -CLASS="LITERALLAYOUT" ->Submit feature requests only through our Sourceforge feature request forum:<br> - <br> -    <A -HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse" +> The exact <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> version you are using + (if you got the source from CVS, please also provide the source code revisions + as shown in <A +HREF="http://config.privoxy.org/show-version" TARGET="_top" ->http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse</A ->.<br> -   </P +>http://config.privoxy.org/show-version</A +>). + </P ></LI ><LI ><P -CLASS="LITERALLAYOUT" ->You can also send feedback on websites that Privoxy has problems with. Please bookmark<br> -the following link: <A -HREF="javascript:w=Math.floor(screen.width/2);h=Math.floor(screen.height*0.9);void(window.open('http://www.privoxy.org/actions','Feedback','screenx='+w+',width='+w+',height='+h+',scrollbars=yes,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());" -TARGET="_top" -><SPAN +> The operating system and versions you run + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> on, (e.g. <SPAN +CLASS="APPLICATION" +>Windows + XP SP2</SPAN +>), if you are using a Unix flavor, + sending the output of <SPAN CLASS="QUOTE" ->"Privoxy - Submit Filter Feedback"</SPAN -></A ->. Once you surf to a page with problems, use the<br> -bookmark to send us feedback. We will look into the issue as soon as possible.<br> -   </P +>"uname -a"</SPAN +> should do, + in case of GNU/Linux, please also name the distribution. + </P ></LI ><LI ><P -CLASS="LITERALLAYOUT" ->For any other issues, feel free to use the mailing lists:<br> - <br> -    <A -HREF="http://sourceforge.net/mail/?group_id=11118" -TARGET="_top" ->http://sourceforge.net/mail/?group_id=11118</A ->.<br> - </P +> The name, platform, and version of the <SPAN +CLASS="APPLICATION" +>browser</SPAN +> + you were using (e.g. <SPAN +CLASS="APPLICATION" +>Internet Explorer v5.5</SPAN +> for Mac). + </P +></LI +><LI ><P -> Anyone interested in actively participating in development and related - discussions can also join the appropriate mailing list. Archives are - available, too. - </P +> The URL where the problem occurred, or some way for us to duplicate the + problem (e.g. <TT +CLASS="LITERAL" +>http://somesite.example.com/?somethingelse=123</TT +>). + </P ></LI -></UL -></P -><DIV -CLASS="SECT2" -><H2 -CLASS="SECT2" -><A -NAME="SUBMITACTIONS" ->6.1. Submitting Ads and <SPAN -CLASS="QUOTE" ->"Action"</SPAN -> Problems</A -></H2 +><LI ><P -> Ads and banners that are not stopped by <SPAN +> Whether your version of <SPAN CLASS="APPLICATION" >Privoxy</SPAN -> - can be submitted to the developers by accessing a special page and filling - out the brief, required form. Conversely, you can also report pages, images, - etc. that <SPAN +> is one supplied + by the <SPAN CLASS="APPLICATION" >Privoxy</SPAN -> is blocking, but should not. - The form itself does require Internet access.</P +> developers via SourceForge, + or if you got your copy somewhere else. + </P +></LI +><LI ><P -> To do this, point your browser to <SPAN +> Whether you are using <SPAN CLASS="APPLICATION" >Privoxy</SPAN -> - at <A -HREF="http://p.p/" +> in tandem with + another proxy such as <SPAN +CLASS="APPLICATION" +>Tor</SPAN +>. If so, please + temporary disable the other proxy to see if the symptoms change. + </P +></LI +><LI +><P +> Whether you are using a personal firewall product. If so, does + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> work without it? + </P +></LI +><LI +><P +> Any other pertinent information to help identify the problem such as config + or log file excerpts (yes, you should have log file entries for each + action taken). To get a meaningful logfile, please make sure that the + <A +HREF="../user-manual/config.html#LOGFILE" TARGET="_top" ->http://p.p/</A ->, and then select - <A -HREF="javascript:w=Math.floor(screen.width/2);h=Math.floor(screen.height*0.9);void(window.open('http://www.privoxy.org/actions','Feedback','screenx='+w+',width='+w+',height='+h+',scrollbars=yes,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());" +>logfile directive</A +> + is being used and the following <A +HREF="../user-manual/config.html#DEBUG" TARGET="_top" ->Actions file feedback system</A ->, - near the bottom of the page. Paste in the URL that is the cause of the - unwanted behavior, and follow the prompts. The developers will - try to incorporate your submission into future versions.</P +>debug options</A +> are enabled: + <P +CLASS="LITERALLAYOUT" +>debug     1 # Log the destination for each request Privoxy let through. See also debug 1024.<br> +debug     2 # show each connection status<br> +debug     4 # show I/O status<br> +debug     8 # show header parsing<br> +debug   128 # debug redirects<br> +debug   256 # debug GIF de-animation<br> +debug   512 # Common Log Format<br> +debug  1024 # Log the destination for requests Privoxy didn't let through, and the reason why.<br> +debug  4096 # Startup banner and warnings.<br> +debug  8192 # Non-fatal errors</P +> + If you are having trouble with a filter, please additionally enable + <P +CLASS="LITERALLAYOUT" +>debug    64 # debug regular expression filters</P +> + Note that Privoxy log files may contain sensitive information so please don't + submit any logfiles you didn't read first. You can mask sensitive information + as long as it's clear that you removed something. + </P +></LI +></UL +></P ><P -> New <TT -CLASS="FILENAME" ->default.actions</TT -> files will occasionally be made - available based on your feedback. These - will be announced on the +> You don't have to tell us your actual name when filing a problem + report, but please use a nickname so we can differentiate between + your messages and the ones entered by other "anonymous" users that + may respond to your request if they have the same problem or already + found a solution.</P +><P +> Please also check the status of your request a few days after submitting + it, as we may request additional information. If you use a SF id, + you should automatically get a mail when someone responds to your request.</P +><P +> The <A +HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" +TARGET="_top" +>appendix + of the Privoxy User Manual</A +> also has helpful information + on understanding <TT +CLASS="LITERAL" +>actions</TT +>, and <TT +CLASS="LITERAL" +>action</TT +> debugging. </P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CONTACT-FEATURE" +>11.3. Request New Features</A +></H2 +><P +> You are welcome to submit ideas on new features or other proposals + for improvement through our feature request tracker at <A -HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce" +HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118" TARGET="_top" ->ijbswa-announce</A -> - list.</P +>http://sourceforge.net/tracker/?atid=361118&group_id=11118</A +>.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CONTACT-OTHER" +>11.4. Other</A +></H2 +><P +>For any other issues, feel free to use the mailing lists. Technically interested users +and people who wish to contribute to the project are also welcome on the developers list! +You can find an overview of all <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>-related mailing lists, +including list archives, at: +<A +HREF="http://sourceforge.net/mail/?group_id=11118" +TARGET="_top" +>http://sourceforge.net/mail/?group_id=11118</A +>.</P ></DIV ></DIV ><DIV @@ -234,6 +487,7 @@ CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" @@ -244,7 +498,8 @@ WIDTH="33%" ALIGN="left" VALIGN="top" ><A -HREF="configuration.html" +HREF="templates.html" +ACCESSKEY="P" >Prev</A ></TD ><TD @@ -253,6 +508,7 @@ ALIGN="center" VALIGN="top" ><A HREF="index.html" +ACCESSKEY="H" >Home</A ></TD ><TD @@ -261,6 +517,7 @@ ALIGN="right" VALIGN="top" ><A HREF="copyright.html" +ACCESSKEY="N" >Next</A ></TD ></TR @@ -269,10 +526,7 @@ HREF="copyright.html" WIDTH="33%" ALIGN="left" VALIGN="top" -><SPAN -CLASS="APPLICATION" ->Privoxy</SPAN -> Configuration</TD +>Privoxy's Template Files</TD ><TD WIDTH="34%" ALIGN="center" @@ -282,7 +536,7 @@ VALIGN="top" WIDTH="33%" ALIGN="right" VALIGN="top" ->Copyright and History</TD +>Privoxy Copyright, License and History</TD ></TR ></TABLE ></DIV