From: hal9 <hal9@users.sourceforge.net> Date: Wed, 22 May 2002 04:27:01 +0000 (+0000) Subject: Catch up on recent source changes. X-Git-Tag: v_3_0_branchpoint~31 X-Git-Url: http://www.privoxy.org/gitweb/%22https:/developer-manual/man-page/faq/@default-cgi@/diff?a=commitdiff_plain;h=2d6b5d2e894f920d7e376a9dc4fa436a8dbefcec;p=privoxy.git Catch up on recent source changes. --- diff --git a/doc/webserver/developer-manual/coding.html b/doc/webserver/developer-manual/coding.html index 06b207ca..364af8e1 100644 --- a/doc/webserver/developer-manual/coding.html +++ b/doc/webserver/developer-manual/coding.html @@ -2019,7 +2019,7 @@ WIDTH="100%" ><TD ><PRE CLASS="PROGRAMLISTING" ->const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.42 2002/05/05 20:26:02 hal9 Exp $"; +>const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.45 2002/05/19 23:01:54 hal9 Exp $"; /********************************************************************* * * File : $Source$ @@ -2097,7 +2097,7 @@ WIDTH="100%" CLASS="PROGRAMLISTING" >#ifndef _FILENAME_H #define _FILENAME_H -#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.42 2002/05/05 20:26:02 hal9 Exp $" +#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.45 2002/05/19 23:01:54 hal9 Exp $" /********************************************************************* * * File : $Source$ diff --git a/doc/webserver/developer-manual/contact.html b/doc/webserver/developer-manual/contact.html index 3848767a..c9112352 100644 --- a/doc/webserver/developer-manual/contact.html +++ b/doc/webserver/developer-manual/contact.html @@ -74,8 +74,13 @@ NAME="CONTACT" >8. 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 the following sections.</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 @@ -85,17 +90,25 @@ NAME="CONTACT-SUPPORT" >8.1. Get Support</A ></H2 ><P -> <P -CLASS="LITERALLAYOUT" ->To get support, use the Sourceforge Support Forum:<br> -<br> - <A +> For casual users, our support forum at + <A +HREF="http://sourceforge.net/" +TARGET="_top" +>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 +><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 ></DIV ><DIV CLASS="SECT2" @@ -103,37 +116,61 @@ CLASS="SECT2" CLASS="SECT2" ><A NAME="CONTACT-BUGS" ->8.2. Report bugs</A +>8.2. Report Bugs</A ></H2 ><P -> <P -CLASS="LITERALLAYOUT" ->To submit bugs, use the Sourceforge Bug Forum:<br> -<br> - <A +> Please report all bugs <I +CLASS="EMPHASIS" +>only</I +> 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 ->. </P -> - </P +>. </P +><P +> Before doing so, please make sure that the bug has not already been submitted + and observe the aditional hints at the top of the <A +HREF="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118" +TARGET="_top" +>submit + form</A +>.</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 first. If unsure, + try <A +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());" +TARGET="_top" +>toggling + off</A +> <SPAN CLASS="APPLICATION" >Privoxy</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 +>, and see if the problem persists. + The <A +HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" +TARGET="_top" +>appendix + of the user manual</A +> also has helpful information + on action debugging. If you are using your own custom configuration, please try + the stock configs to see if the problem is configuration related.</P +><P +> If not using the latest version, chances are that the bug has 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 + your bug, but this is not required for reporting.</P ></DIV ><DIV CLASS="SECT2" @@ -141,20 +178,16 @@ CLASS="SECT2" CLASS="SECT2" ><A NAME="CONTACT-FEATURE" ->8.3. Request new features</A +>8.3. Request New Features</A ></H2 ><P -> <P -CLASS="LITERALLAYOUT" ->To submit ideas on new features, use the Sourceforge feature request forum:<br> -<br> - <A -HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse" +> You are welcome to submit ideas on new features or other proposals + for improvement through our feature request tracker at + <A +HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118" TARGET="_top" ->http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse</A +>http://sourceforge.net/tracker/?atid=361118&group_id=11118</A >.</P -> - </P ></DIV ><DIV CLASS="SECT2" @@ -162,20 +195,22 @@ CLASS="SECT2" CLASS="SECT2" ><A NAME="CONTACT-ADS" ->8.4. Report ads or other filter problems</A +>8.4. Report Ads or Other Actions-Related Problems</A ></H2 ><P ->You can also send feedback on websites that Privoxy has problems with. Please bookmark -the following link: <A +> Please send feedback on ads that slipped through, innocent images that were blocked, + and any other problems relating to the <TT +CLASS="FILENAME" +>default.action</TT +> file through + our actions feedback mechanism located at + <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 -CLASS="QUOTE" ->"Privoxy - Submit Filter Feedback"</SPAN -></A ->. Once you surf to a page with problems, use the -bookmark to send us feedback. We will look into the issue as soon as possible. - </P +>http://www.privoxy.org/actions/</A +>. + On this page, you will also find a bookmark which will take you back there from + any troubled site and even pre-fill the form!</P ><P > New, improved <TT CLASS="FILENAME" @@ -186,7 +221,11 @@ HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce" TARGET="_top" >ijbswa-announce</A > - list.</P + list and available from our <A +HREF="http://sf.net/projects/ijbswa/" +TARGET="_top" +>project page</A +>.</P ></DIV ><DIV CLASS="SECT2" @@ -197,22 +236,18 @@ NAME="CONTACT-OTHER" >8.5. Other</A ></H2 ><P -> <P -CLASS="LITERALLAYOUT" ->For any other issues, feel free to use the mailing lists:<br> - <br> - <A +>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" +>Prixoxy</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 -> - </P -><P -> Anyone interested in actively participating in development and related - discussions can also join the appropriate mailing list. Archives are - available, too. See the page on Sourceforge. - </P ></DIV ></DIV ><DIV diff --git a/doc/webserver/developer-manual/copyright.html b/doc/webserver/developer-manual/copyright.html index 783b6f72..f4093413 100644 --- a/doc/webserver/developer-manual/copyright.html +++ b/doc/webserver/developer-manual/copyright.html @@ -93,7 +93,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1061" +NAME="AEN1121" >9.1. License</A ></H2 ><P @@ -155,47 +155,86 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1077" +NAME="AEN1137" >9.2. History</A ></H2 ><P -> <SPAN -CLASS="APPLICATION" ->Privoxy</SPAN -> is evolved, and derived from, - <SPAN +> In the beginning, there was the + <A +HREF="http://www.junkbusters.com/ijb.html" +TARGET="_top" +><SPAN CLASS="APPLICATION" ->the Internet Junkbuster</SPAN ->, with many - improvments and enhancements over the original.</P +>Internet Junkbuster</SPAN +></A +>, + by Anonymous Coders and <A +HREF="http://www.junkbusters.com/" +TARGET="_top" +>Junkbusters + Corporation</A +>. It saved many users a lot of pain in the early days of + web advertising and user tracking.</P ><P -> <SPAN +> But the web, its protocols and standards, and with it, the techniques for + forcing users to consume ads, give up autonomy over their browsing, and + for spying on them, kept evolving. Unfortunately, the <SPAN CLASS="APPLICATION" ->Junkbuster</SPAN -> was originally written by Anonymous - Coders and <A +>Internet + Junkbuster</SPAN +> did not. Version 2.0.2, published in 1998, was + (and is) the last official + <A +HREF="http://www.junkbusters.com/ijbdist.html#release" +TARGET="_top" +>release</A +> + available from <A HREF="http://www.junkbusters.com" TARGET="_top" ->Junkbusters - Corporation</A ->, and was released as free open-source software under the - GNU GPL. <A +>Junkbusters Corporation</A +>. + Fortunately, it had been released under the GNU + <A +HREF="http://www.gnu.org/licenses/gpl.html" +TARGET="_top" +> GPL</A +>, which allowed further + development by others.</P +><P +> So Stefan Waldherr started maintaining an + <A HREF="http://www.waldherr.org/junkbuster/" TARGET="_top" ->Stefan - Waldherr</A -> made many improvements, and started the <A -HREF="http://sourceforge.net/projects/ijbswa/" +>improved version of the + software</A +>, to which eventually a number of people contributed patches. + It could already replace banners with a transparent image, and had a first + version of pop-up killing, but it was still very closely based on the + original, with all its limitations, such as the lack of HTTP/1.1 support, + flexible per-site configuration, or content modification. The last release + from this effort was version 2.0.2-10, published in 2000.</P +><P +> Then, some + <A +HREF="http://www.privoxy.org/user-manual/copyright.html#AUTHORS" +TARGET="_top" +>developers</A +> + picked up the thread, and started turning the software inside out, upside down, + and then reassembled it, adding many + <A +HREF="http://www.privoxy.org/user-manual/introduction.html#FEATURES" TARGET="_top" ->SourceForge project - Privoxy</A -> to rekindle development. There are now several active - developers contributing. The last stable release of - <SPAN +>new + features</A +> along the way.</P +><P +> The result of this is <SPAN CLASS="APPLICATION" ->Junkbuster</SPAN -> was v2.0.2, which has now - grown whiskers ;-).</P +>Privoxy</SPAN +>, whose first + stable release, 3.0, is due in May 2002.</P ></DIV ></DIV ><DIV diff --git a/doc/webserver/developer-manual/index.html b/doc/webserver/developer-manual/index.html index e4a139f8..cf386de8 100644 --- a/doc/webserver/developer-manual/index.html +++ b/doc/webserver/developer-manual/index.html @@ -48,7 +48,7 @@ TARGET="_top" <BR></P ><P CLASS="PUBDATE" ->$Id: developer-manual.sgml,v 1.42 2002/05/05 20:26:02 hal9 Exp $<BR></P +>$Id: developer-manual.sgml,v 1.45 2002/05/19 23:01:54 hal9 Exp $<BR></P ><DIV ><DIV CLASS="ABSTRACT" @@ -70,7 +70,6 @@ TARGET="_top" >. Please see <A HREF="contact.html" -TARGET="_top" >the Contact section</A > on how to contact the developers.</P @@ -478,56 +477,61 @@ HREF="newrelease.html#THERELEASE" ><DL ><DT >6.3.1. <A +HREF="newrelease.html#PACK-GUIDELINES" +>Note on Privoxy Packaging</A +></DT +><DT +>6.3.2. <A HREF="newrelease.html#NEWRELEASE-TARBALL" >Source Tarball</A ></DT ><DT ->6.3.2. <A +>6.3.3. <A HREF="newrelease.html#NEWRELEASE-RPM" ->SuSE or Red Hat RPM</A +>SuSE, Conectiva or Red Hat RPM</A ></DT ><DT ->6.3.3. <A +>6.3.4. <A HREF="newrelease.html#NEWRELEASE-OS2" >OS/2</A ></DT ><DT ->6.3.4. <A +>6.3.5. <A HREF="newrelease.html#NEWRELEASE-SOLARIS" >Solaris</A ></DT ><DT ->6.3.5. <A +>6.3.6. <A HREF="newrelease.html#NEWRELEASE-WINDOWS" >Windows</A ></DT ><DT ->6.3.6. <A +>6.3.7. <A HREF="newrelease.html#NEWRELEASE-DEBIAN" >Debian</A ></DT ><DT ->6.3.7. <A +>6.3.8. <A HREF="newrelease.html#NEWRELEASE-MACOSX" >Mac OSX</A ></DT ><DT ->6.3.8. <A +>6.3.9. <A HREF="newrelease.html#NEWRELEASE-FREEBSD" >FreeBSD</A ></DT ><DT ->6.3.9. <A +>6.3.10. <A HREF="newrelease.html#NEWRELEASE-HPUX" >HP-UX 11</A ></DT ><DT ->6.3.10. <A +>6.3.11. <A HREF="newrelease.html#NEWRELEASE-AMIGA" >Amiga OS</A ></DT ><DT ->6.3.11. <A +>6.3.12. <A HREF="newrelease.html#NEWRELEASE-AIX" >AIX</A ></DT @@ -565,17 +569,17 @@ HREF="contact.html#CONTACT-SUPPORT" ><DT >8.2. <A HREF="contact.html#CONTACT-BUGS" ->Report bugs</A +>Report Bugs</A ></DT ><DT >8.3. <A HREF="contact.html#CONTACT-FEATURE" ->Request new features</A +>Request New Features</A ></DT ><DT >8.4. <A HREF="contact.html#CONTACT-ADS" ->Report ads or other filter problems</A +>Report Ads or Other Actions-Related Problems</A ></DT ><DT >8.5. <A @@ -593,12 +597,12 @@ HREF="copyright.html" ><DL ><DT >9.1. <A -HREF="copyright.html#AEN1061" +HREF="copyright.html#AEN1121" >License</A ></DT ><DT >9.2. <A -HREF="copyright.html#AEN1077" +HREF="copyright.html#AEN1137" >History</A ></DT ></DL diff --git a/doc/webserver/developer-manual/newrelease.html b/doc/webserver/developer-manual/newrelease.html index 62721d34..5ff11fb5 100644 --- a/doc/webserver/developer-manual/newrelease.html +++ b/doc/webserver/developer-manual/newrelease.html @@ -361,15 +361,239 @@ CLASS="EMPHASIS" </P ><P > Please find additional instructions for the source tarball and the - individual platform dependent binary packages below. + individual platform dependent binary packages below. And details + on the Sourceforge release process below that. </P ><DIV CLASS="SECT3" ><H3 CLASS="SECT3" ><A +NAME="PACK-GUIDELINES" +>6.3.1. Note on Privoxy Packaging</A +></H3 +><P +> Please keep these general guidelines in mind when putting together + your package. These apply to <I +CLASS="EMPHASIS" +>all</I +> platforms! + </P +><P +> <P +></P +><UL +><LI +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> <I +CLASS="EMPHASIS" +>requires</I +> + write access to: all <TT +CLASS="FILENAME" +>*.action</TT +> files, all + logfiles, and the <TT +CLASS="FILENAME" +>trust</TT +> file. You will + need to determine the best way to do this for your platform. + </P +></LI +><LI +><P +> Please include up to date documentation. At a bare minimum: + </P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <TT +CLASS="FILENAME" +>LICENSE</TT +> (toplevel directory) + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <TT +CLASS="FILENAME" +>README</TT +> (toplevel directory) + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <TT +CLASS="FILENAME" +>AUTHORS</TT +> (toplevel directory) + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <TT +CLASS="FILENAME" +>man page</TT +> (toplevel directory, Unix-like + platforms only) + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <TT +CLASS="FILENAME" +>The User Manual</TT +> (doc/webserver/user-manual/) + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <TT +CLASS="FILENAME" +>FAQ</TT +> (doc/webserver/faq/) + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +> Also suggested: <TT +CLASS="FILENAME" +>Developer Manual</TT +> + (doc/webserver/devel-manual) and <TT +CLASS="FILENAME" +>ChangeLog</TT +> + (toplevel directory). <TT +CLASS="FILENAME" +>FAQ</TT +> and the manuals are + HTML docs. There are also text versions in + <TT +CLASS="FILENAME" +>doc/text/</TT +> which could conceivably also be + included. + </P +><P +> The documentation has been designed such that the manuals are linked + to each other from parallel directories, and should be packaged + that way. <TT +CLASS="FILENAME" +>index.html</TT +> can also be included and + can serve as a focal point for docs and other links of interest. + This should be one level up from the manuals. There are two + css stylesheets that can be included for better presentation: + <TT +CLASS="FILENAME" +>p_doc.css</TT +> and <TT +CLASS="FILENAME" +>p_web.css</TT +>. + These should be in the same directory with + <TT +CLASS="FILENAME" +>index.html</TT +>, (i.e. one level up from the manual + directories). + </P +></LI +><LI +><P +> <TT +CLASS="FILENAME" +>user.action</TT +> is designed for local preferences. + Make sure this does not get overwritten! + </P +></LI +><LI +><P +> Other configuration files should be installed as the new defaults, + but all previously installed configuration files should be preserved + as backups. This is just good manners :-) + </P +></LI +><LI +><P +> Please check platform specific notes in this doc, if you haven't + done <SPAN +CLASS="QUOTE" +>"Privoxy"</SPAN +> packaging before for other platform + specific issues. Conversely, please add any notes that you know + are important for your platform (or contact one of the doc + maintainers to do this if you can't). + </P +></LI +></UL +> + </P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A NAME="NEWRELEASE-TARBALL" ->6.3.1. Source Tarball</A +>6.3.2. Source Tarball</A ></H3 ><P > First, <I @@ -446,7 +670,7 @@ CLASS="SECT3" CLASS="SECT3" ><A NAME="NEWRELEASE-RPM" ->6.3.2. SuSE or Red Hat RPM</A +>6.3.3. SuSE, Conectiva or Red Hat RPM</A ></H3 ><P > In following text, replace <TT @@ -591,7 +815,7 @@ CLASS="SECT3" CLASS="SECT3" ><A NAME="NEWRELEASE-OS2" ->6.3.3. OS/2</A +>6.3.4. OS/2</A ></H3 ><P > First, <I @@ -725,7 +949,7 @@ CLASS="SECT3" CLASS="SECT3" ><A NAME="NEWRELEASE-SOLARIS" ->6.3.4. Solaris</A +>6.3.5. Solaris</A ></H3 ><P > Login to Sourceforge's compilefarm via ssh: @@ -805,7 +1029,7 @@ CLASS="SECT3" CLASS="SECT3" ><A NAME="NEWRELEASE-WINDOWS" ->6.3.5. Windows</A +>6.3.6. Windows</A ></H3 ><P > You should ensure you have the latest version of Cygwin (from @@ -882,7 +1106,7 @@ CLASS="SECT3" CLASS="SECT3" ><A NAME="NEWRELEASE-DEBIAN" ->6.3.6. Debian</A +>6.3.7. Debian</A ></H3 ><P > First, <I @@ -918,7 +1142,7 @@ CLASS="SECT3" CLASS="SECT3" ><A NAME="NEWRELEASE-MACOSX" ->6.3.7. Mac OSX</A +>6.3.8. Mac OSX</A ></H3 ><P > First, <I @@ -1023,7 +1247,7 @@ CLASS="SECT3" CLASS="SECT3" ><A NAME="NEWRELEASE-FREEBSD" ->6.3.8. FreeBSD</A +>6.3.9. FreeBSD</A ></H3 ><P > Login to Sourceforge's compilefarm via ssh: @@ -1103,7 +1327,7 @@ CLASS="SECT3" CLASS="SECT3" ><A NAME="NEWRELEASE-HPUX" ->6.3.9. HP-UX 11</A +>6.3.10. HP-UX 11</A ></H3 ><P > First, <I @@ -1139,7 +1363,7 @@ CLASS="SECT3" CLASS="SECT3" ><A NAME="NEWRELEASE-AMIGA" ->6.3.10. Amiga OS</A +>6.3.11. Amiga OS</A ></H3 ><P > First, <I @@ -1175,7 +1399,7 @@ CLASS="SECT3" CLASS="SECT3" ><A NAME="NEWRELEASE-AIX" ->6.3.11. AIX</A +>6.3.12. AIX</A ></H3 ><P > Login to Sourceforge's compilefarm via ssh: @@ -1296,6 +1520,12 @@ CLASS="LITERAL" > </P ><P +> Or use the <B +CLASS="COMMAND" +>make</B +> targets as described above. + </P +><P > Once this done go to <A HREF="http://sourceforge.net/project/admin/editpackages.php?group_id=11118" TARGET="_top" diff --git a/doc/webserver/developer-manual/seealso.html b/doc/webserver/developer-manual/seealso.html index 8cee57e3..3c9f9e42 100644 --- a/doc/webserver/developer-manual/seealso.html +++ b/doc/webserver/developer-manual/seealso.html @@ -81,12 +81,12 @@ BORDER="0" ><TBODY ><TR ><TD -> <A +> <A HREF="http://www.privoxy.org/" TARGET="_top" >http://www.privoxy.org/</A >, - The <SPAN + the <SPAN CLASS="APPLICATION" >Privoxy</SPAN > Home page. @@ -104,10 +104,33 @@ BORDER="0" ><TBODY ><TR ><TD -> <A -HREF="http://sourceforge.net/projects/ijbswa" +> <A +HREF="http://www.privoxy.org/faq/" +TARGET="_top" +>http://www.privoxy.org/faq/</A +>, + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> FAQ. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://sourceforge.net/projects/ijbswa/" TARGET="_top" ->http://sourceforge.net/projects/ijbswa</A +>http://sourceforge.net/projects/ijbswa/</A >, the Project Page for <SPAN CLASS="APPLICATION" @@ -116,7 +139,7 @@ CLASS="APPLICATION" <A HREF="http://sourceforge.net" TARGET="_top" ->Sourceforge</A +>SourceForge</A >. </TD ></TR @@ -132,21 +155,20 @@ BORDER="0" ><TBODY ><TR ><TD -> <A -HREF="http://p.p/" +> <A +HREF="http://config.privoxy.org/" TARGET="_top" ->http://p.p/</A ->, access - <SPAN +>http://config.privoxy.org/</A +>, + the web-based user interface. <SPAN CLASS="APPLICATION" >Privoxy</SPAN -> from your browser. Alternately, - <A -HREF="http://config.privoxy.org" +> must be + running for this to work. Shortcut: <A +HREF="http://p.p/" TARGET="_top" ->http://config.privoxy.org</A +>http://p.p/</A > - may work in some situations where the first does not. </TD ></TR ></TBODY @@ -161,18 +183,11 @@ BORDER="0" ><TBODY ><TR ><TD -> <A -HREF="http://p.p/" -TARGET="_top" ->http://p.p/</A ->, and select <A +> <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 -CLASS="QUOTE" ->"Privoxy - Submit Filter Feedback"</SPAN -></A -> to submit <SPAN +>http://www.privoxy.org/actions/</A +>, to submit <SPAN CLASS="QUOTE" >"misses"</SPAN > to the developers. @@ -190,11 +205,32 @@ BORDER="0" ><TBODY ><TR ><TD -> <A +> <A HREF="http://www.junkbusters.com/ht/en/cookies.html" TARGET="_top" >http://www.junkbusters.com/ht/en/cookies.html</A +>, + an explanation how cookies are used to track web users. + </TD +></TR +></TBODY +></TABLE +><P +></P > + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.junkbusters.com/ijb.html" +TARGET="_top" +>http://www.junkbusters.com/ijb.html</A +>, + the original Internet Junkbuster. </TD ></TR ></TBODY @@ -209,11 +245,16 @@ BORDER="0" ><TBODY ><TR ><TD -> <A +> <A HREF="http://www.waldherr.org/junkbuster/" TARGET="_top" >http://www.waldherr.org/junkbuster/</A -> +>, + Stefan Waldherr's version of Junkbuster, from which <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> was + derived. </TD ></TR ></TBODY @@ -228,11 +269,12 @@ BORDER="0" ><TBODY ><TR ><TD -> <A +> <A HREF="http://privacy.net/analyze/" TARGET="_top" >http://privacy.net/analyze/</A -> +>, a useful site + to check what information about you is leaked while you browse the web. </TD ></TR ></TBODY @@ -251,14 +293,41 @@ BORDER="0" HREF="http://www.squid-cache.org/" TARGET="_top" >http://www.squid-cache.org/</A +>, a very popular + caching proxy, which is often used together with <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. + </TD +></TR +></TBODY +></TABLE +><P +></P > + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.privoxy.org/developer-manual/" +TARGET="_top" +>http://www.privoxy.org/developer-manual/</A +>, + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> developer manual. </TD ></TR ></TBODY ></TABLE ><P ></P -> </P +></P ></DIV ><DIV CLASS="NAVFOOTER" diff --git a/doc/webserver/faq/contact.html b/doc/webserver/faq/contact.html index 5be9576e..7c8ff51b 100644 --- a/doc/webserver/faq/contact.html +++ b/doc/webserver/faq/contact.html @@ -74,8 +74,13 @@ NAME="CONTACT" >6. 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 the following sections.</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 @@ -85,17 +90,25 @@ NAME="CONTACT-SUPPORT" >6.1. Get Support</A ></H2 ><P -> <P -CLASS="LITERALLAYOUT" ->To get support, use the Sourceforge Support Forum:<br> -<br> - <A +> For casual users, our support forum at + <A +HREF="http://sourceforge.net/" +TARGET="_top" +>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 +><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 ></DIV ><DIV CLASS="SECT2" @@ -103,37 +116,61 @@ CLASS="SECT2" CLASS="SECT2" ><A NAME="CONTACT-BUGS" ->6.2. Report bugs</A +>6.2. Report Bugs</A ></H2 ><P -> <P -CLASS="LITERALLAYOUT" ->To submit bugs, use the Sourceforge Bug Forum:<br> -<br> - <A +> Please report all bugs <I +CLASS="EMPHASIS" +>only</I +> 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 ->. </P -> - </P +>. </P +><P +> Before doing so, please make sure that the bug has not already been submitted + and observe the aditional hints at the top of the <A +HREF="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118" +TARGET="_top" +>submit + form</A +>.</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 first. If unsure, + try <A +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());" +TARGET="_top" +>toggling + off</A +> <SPAN CLASS="APPLICATION" >Privoxy</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 +>, and see if the problem persists. + The <A +HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" +TARGET="_top" +>appendix + of the user manual</A +> also has helpful information + on action debugging. If you are using your own custom configuration, please try + the stock configs to see if the problem is configuration related.</P +><P +> If not using the latest version, chances are that the bug has 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 + your bug, but this is not required for reporting.</P ></DIV ><DIV CLASS="SECT2" @@ -141,20 +178,16 @@ CLASS="SECT2" CLASS="SECT2" ><A NAME="CONTACT-FEATURE" ->6.3. Request new features</A +>6.3. Request New Features</A ></H2 ><P -> <P -CLASS="LITERALLAYOUT" ->To submit ideas on new features, use the Sourceforge feature request forum:<br> -<br> - <A -HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse" +> You are welcome to submit ideas on new features or other proposals + for improvement through our feature request tracker at + <A +HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118" TARGET="_top" ->http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse</A +>http://sourceforge.net/tracker/?atid=361118&group_id=11118</A >.</P -> - </P ></DIV ><DIV CLASS="SECT2" @@ -162,20 +195,22 @@ CLASS="SECT2" CLASS="SECT2" ><A NAME="CONTACT-ADS" ->6.4. Report ads or other filter problems</A +>6.4. Report Ads or Other Actions-Related Problems</A ></H2 ><P ->You can also send feedback on websites that Privoxy has problems with. Please bookmark -the following link: <A +> Please send feedback on ads that slipped through, innocent images that were blocked, + and any other problems relating to the <TT +CLASS="FILENAME" +>default.action</TT +> file through + our actions feedback mechanism located at + <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 -CLASS="QUOTE" ->"Privoxy - Submit Filter Feedback"</SPAN -></A ->. Once you surf to a page with problems, use the -bookmark to send us feedback. We will look into the issue as soon as possible. - </P +>http://www.privoxy.org/actions/</A +>. + On this page, you will also find a bookmark which will take you back there from + any troubled site and even pre-fill the form!</P ><P > New, improved <TT CLASS="FILENAME" @@ -186,7 +221,11 @@ HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce" TARGET="_top" >ijbswa-announce</A > - list.</P + list and available from our <A +HREF="http://sf.net/projects/ijbswa/" +TARGET="_top" +>project page</A +>.</P ></DIV ><DIV CLASS="SECT2" @@ -197,22 +236,18 @@ NAME="CONTACT-OTHER" >6.5. Other</A ></H2 ><P -> <P -CLASS="LITERALLAYOUT" ->For any other issues, feel free to use the mailing lists:<br> - <br> - <A +>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" +>Prixoxy</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 -> - </P -><P -> Anyone interested in actively participating in development and related - discussions can also join the appropriate mailing list. Archives are - available, too. See the page on Sourceforge. - </P ></DIV ></DIV ><DIV diff --git a/doc/webserver/faq/copyright.html b/doc/webserver/faq/copyright.html index 11efe1d6..8a79af8e 100644 --- a/doc/webserver/faq/copyright.html +++ b/doc/webserver/faq/copyright.html @@ -101,7 +101,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN647" +NAME="AEN666" >7.1. License</A ></H2 ><P @@ -163,47 +163,86 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN663" +NAME="AEN682" >7.2. History</A ></H2 ><P -> <SPAN -CLASS="APPLICATION" ->Privoxy</SPAN -> is evolved, and derived from, - <SPAN +> In the beginning, there was the + <A +HREF="http://www.junkbusters.com/ijb.html" +TARGET="_top" +><SPAN CLASS="APPLICATION" ->the Internet Junkbuster</SPAN ->, with many - improvments and enhancements over the original.</P +>Internet Junkbuster</SPAN +></A +>, + by Anonymous Coders and <A +HREF="http://www.junkbusters.com/" +TARGET="_top" +>Junkbusters + Corporation</A +>. It saved many users a lot of pain in the early days of + web advertising and user tracking.</P ><P -> <SPAN +> But the web, its protocols and standards, and with it, the techniques for + forcing users to consume ads, give up autonomy over their browsing, and + for spying on them, kept evolving. Unfortunately, the <SPAN CLASS="APPLICATION" ->Junkbuster</SPAN -> was originally written by Anonymous - Coders and <A +>Internet + Junkbuster</SPAN +> did not. Version 2.0.2, published in 1998, was + (and is) the last official + <A +HREF="http://www.junkbusters.com/ijbdist.html#release" +TARGET="_top" +>release</A +> + available from <A HREF="http://www.junkbusters.com" TARGET="_top" ->Junkbusters - Corporation</A ->, and was released as free open-source software under the - GNU GPL. <A +>Junkbusters Corporation</A +>. + Fortunately, it had been released under the GNU + <A +HREF="http://www.gnu.org/licenses/gpl.html" +TARGET="_top" +> GPL</A +>, which allowed further + development by others.</P +><P +> So Stefan Waldherr started maintaining an + <A HREF="http://www.waldherr.org/junkbuster/" TARGET="_top" ->Stefan - Waldherr</A -> made many improvements, and started the <A -HREF="http://sourceforge.net/projects/ijbswa/" +>improved version of the + software</A +>, to which eventually a number of people contributed patches. + It could already replace banners with a transparent image, and had a first + version of pop-up killing, but it was still very closely based on the + original, with all its limitations, such as the lack of HTTP/1.1 support, + flexible per-site configuration, or content modification. The last release + from this effort was version 2.0.2-10, published in 2000.</P +><P +> Then, some + <A +HREF="http://www.privoxy.org/user-manual/copyright.html#AUTHORS" TARGET="_top" ->SourceForge project - Privoxy</A -> to rekindle development. There are now several active - developers contributing. The last stable release of - <SPAN +>developers</A +> + picked up the thread, and started turning the software inside out, upside down, + and then reassembled it, adding many + <A +HREF="http://www.privoxy.org/user-manual/introduction.html#FEATURES" +TARGET="_top" +>new + features</A +> along the way.</P +><P +> The result of this is <SPAN CLASS="APPLICATION" ->Junkbuster</SPAN -> was v2.0.2, which has now - grown whiskers ;-).</P +>Privoxy</SPAN +>, whose first + stable release, 3.0, is due in May 2002.</P ></DIV ></DIV ><DIV diff --git a/doc/webserver/faq/general.html b/doc/webserver/faq/general.html index c157e7cb..eadcc0ff 100644 --- a/doc/webserver/faq/general.html +++ b/doc/webserver/faq/general.html @@ -279,7 +279,7 @@ CLASS="QUOTE" ><P > Modularized configuration that allows for standard settings and user settings to reside in separate files, so that installing updated - actions files won't overwrite idividual user settings. + actions files won't overwrite individual user settings. </P ></LI ><LI @@ -491,7 +491,7 @@ CLASS="APPLICATION" includes tools to help identify these types of situations so they can be addressed as needed, allowing you to customize your installation. (<A -HREF="trouble.html#AEN578" +HREF="trouble.html#AEN589" >See the Troubleshooting section below</A >.)</P ></DIV diff --git a/doc/webserver/faq/index.html b/doc/webserver/faq/index.html index 835cf776..b6cba2ea 100644 --- a/doc/webserver/faq/index.html +++ b/doc/webserver/faq/index.html @@ -45,7 +45,7 @@ TARGET="_top" ><BR></P ><P CLASS="PUBDATE" ->$Id: faq.sgml,v 1.57 2002/05/05 20:26:02 hal9 Exp $<BR></P +>$Id: faq.sgml,v 1.59 2002/05/15 04:03:30 hal9 Exp $<BR></P ><DIV ><DIV CLASS="ABSTRACT" @@ -549,7 +549,7 @@ HREF="trouble.html" ><DL ><DT >5.1. <A -HREF="trouble.html#AEN559" +HREF="trouble.html#AEN570" >I just upgraded and am getting <SPAN CLASS="QUOTE" >"connection refused"</SPAN @@ -558,13 +558,13 @@ with every web page?</A ></DT ><DT >5.2. <A -HREF="trouble.html#AEN572" +HREF="trouble.html#AEN583" >I just added a new rule, but the steenkin ad is still getting through. How?</A ></DT ><DT >5.3. <A -HREF="trouble.html#AEN578" +HREF="trouble.html#AEN589" >One of my favorite sites does not work with <SPAN CLASS="APPLICATION" >Privoxy</SPAN @@ -588,17 +588,17 @@ HREF="contact.html#CONTACT-SUPPORT" ><DT >6.2. <A HREF="contact.html#CONTACT-BUGS" ->Report bugs</A +>Report Bugs</A ></DT ><DT >6.3. <A HREF="contact.html#CONTACT-FEATURE" ->Request new features</A +>Request New Features</A ></DT ><DT >6.4. <A HREF="contact.html#CONTACT-ADS" ->Report ads or other filter problems</A +>Report Ads or Other Actions-Related Problems</A ></DT ><DT >6.5. <A @@ -616,12 +616,12 @@ HREF="copyright.html" ><DL ><DT >7.1. <A -HREF="copyright.html#AEN647" +HREF="copyright.html#AEN666" >License</A ></DT ><DT >7.2. <A -HREF="copyright.html#AEN663" +HREF="copyright.html#AEN682" >History</A ></DT ></DL diff --git a/doc/webserver/faq/misc.html b/doc/webserver/faq/misc.html index 21a7b40d..df6c40b2 100644 --- a/doc/webserver/faq/misc.html +++ b/doc/webserver/faq/misc.html @@ -230,7 +230,6 @@ NAME="NEWADS" ><P >Please see the <A HREF="contact.html" -TARGET="_top" >Contact section</A >.</P ><P @@ -604,12 +603,12 @@ BORDER="0" ><TBODY ><TR ><TD -> <A +> <A HREF="http://www.privoxy.org/" TARGET="_top" >http://www.privoxy.org/</A >, - The <SPAN + the <SPAN CLASS="APPLICATION" >Privoxy</SPAN > Home page. @@ -627,10 +626,33 @@ BORDER="0" ><TBODY ><TR ><TD -> <A -HREF="http://sourceforge.net/projects/ijbswa" +> <A +HREF="http://www.privoxy.org/faq/" +TARGET="_top" +>http://www.privoxy.org/faq/</A +>, + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> FAQ. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://sourceforge.net/projects/ijbswa/" TARGET="_top" ->http://sourceforge.net/projects/ijbswa</A +>http://sourceforge.net/projects/ijbswa/</A >, the Project Page for <SPAN CLASS="APPLICATION" @@ -639,7 +661,7 @@ CLASS="APPLICATION" <A HREF="http://sourceforge.net" TARGET="_top" ->Sourceforge</A +>SourceForge</A >. </TD ></TR @@ -655,21 +677,20 @@ BORDER="0" ><TBODY ><TR ><TD -> <A -HREF="http://p.p/" +> <A +HREF="http://config.privoxy.org/" TARGET="_top" ->http://p.p/</A ->, access - <SPAN +>http://config.privoxy.org/</A +>, + the web-based user interface. <SPAN CLASS="APPLICATION" >Privoxy</SPAN -> from your browser. Alternately, - <A -HREF="http://config.privoxy.org" +> must be + running for this to work. Shortcut: <A +HREF="http://p.p/" TARGET="_top" ->http://config.privoxy.org</A +>http://p.p/</A > - may work in some situations where the first does not. </TD ></TR ></TBODY @@ -684,18 +705,11 @@ BORDER="0" ><TBODY ><TR ><TD -> <A -HREF="http://p.p/" -TARGET="_top" ->http://p.p/</A ->, and select <A +> <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 -CLASS="QUOTE" ->"Privoxy - Submit Filter Feedback"</SPAN -></A -> to submit <SPAN +>http://www.privoxy.org/actions/</A +>, to submit <SPAN CLASS="QUOTE" >"misses"</SPAN > to the developers. @@ -713,11 +727,32 @@ BORDER="0" ><TBODY ><TR ><TD -> <A +> <A HREF="http://www.junkbusters.com/ht/en/cookies.html" TARGET="_top" >http://www.junkbusters.com/ht/en/cookies.html</A +>, + an explanation how cookies are used to track web users. + </TD +></TR +></TBODY +></TABLE +><P +></P > + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.junkbusters.com/ijb.html" +TARGET="_top" +>http://www.junkbusters.com/ijb.html</A +>, + the original Internet Junkbuster. </TD ></TR ></TBODY @@ -732,11 +767,16 @@ BORDER="0" ><TBODY ><TR ><TD -> <A +> <A HREF="http://www.waldherr.org/junkbuster/" TARGET="_top" >http://www.waldherr.org/junkbuster/</A -> +>, + Stefan Waldherr's version of Junkbuster, from which <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> was + derived. </TD ></TR ></TBODY @@ -751,11 +791,12 @@ BORDER="0" ><TBODY ><TR ><TD -> <A +> <A HREF="http://privacy.net/analyze/" TARGET="_top" >http://privacy.net/analyze/</A -> +>, a useful site + to check what information about you is leaked while you browse the web. </TD ></TR ></TBODY @@ -774,14 +815,41 @@ BORDER="0" HREF="http://www.squid-cache.org/" TARGET="_top" >http://www.squid-cache.org/</A +>, a very popular + caching proxy, which is often used together with <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. + </TD +></TR +></TBODY +></TABLE +><P +></P > + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.privoxy.org/developer-manual/" +TARGET="_top" +>http://www.privoxy.org/developer-manual/</A +>, + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> developer manual. </TD ></TR ></TBODY ></TABLE ><P ></P -> </P +></P ></DIV ></DIV ><DIV diff --git a/doc/webserver/faq/trouble.html b/doc/webserver/faq/trouble.html index 5a561e78..59af117a 100644 --- a/doc/webserver/faq/trouble.html +++ b/doc/webserver/faq/trouble.html @@ -78,7 +78,7 @@ CLASS="SECT2" ><H3 CLASS="SECT2" ><A -NAME="AEN559" +NAME="AEN570" >5.1. I just upgraded and am getting <SPAN CLASS="QUOTE" >"connection refused"</SPAN @@ -128,7 +128,7 @@ CLASS="SECT2" ><H3 CLASS="SECT2" ><A -NAME="AEN572" +NAME="AEN583" >5.2. I just added a new rule, but the steenkin ad is still getting through. How?</A ></H3 @@ -155,7 +155,7 @@ CLASS="SECT2" ><H3 CLASS="SECT2" ><A -NAME="AEN578" +NAME="AEN589" >5.3. One of my favorite sites does not work with <SPAN CLASS="APPLICATION" >Privoxy</SPAN diff --git a/doc/webserver/index.html b/doc/webserver/index.html index f8e069fe..d6d79586 100644 --- a/doc/webserver/index.html +++ b/doc/webserver/index.html @@ -88,17 +88,17 @@ HREF="#CONTACT-SUPPORT" ><DT ><A HREF="#CONTACT-BUGS" ->Report bugs</A +>Report Bugs</A ></DT ><DT ><A HREF="#CONTACT-FEATURE" ->Request new features</A +>Request New Features</A ></DT ><DT ><A HREF="#CONTACT-ADS" ->Report ads or other filter problems</A +>Report Ads or Other Actions-Related Problems</A ></DT ><DT ><A @@ -109,17 +109,17 @@ HREF="#CONTACT-OTHER" ></DD ><DT ><A -HREF="#AEN101" +HREF="#AEN109" >License</A ></DT ><DT ><A -HREF="#AEN121" +HREF="#AEN129" >History</A ></DT ><DT ><A -HREF="#AEN132" +HREF="#AEN147" ></A ></DT ></DL @@ -334,8 +334,13 @@ NAME="SUPPORT" >Support and Service via Sourceforge</A ></H1 ><P -> We value your feedback. However, to provide you with the best support, please - note the following sections.</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" ><HR><H2 @@ -345,17 +350,25 @@ NAME="CONTACT-SUPPORT" >Get Support</A ></H2 ><P -> <P -CLASS="LITERALLAYOUT" ->To get support, use the Sourceforge Support Forum:<br> -<br> - <A +> For casual users, our support forum at + <A +HREF="http://sourceforge.net/" +TARGET="_top" +>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 +><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 ></DIV ><DIV CLASS="SECT2" @@ -363,37 +376,61 @@ CLASS="SECT2" CLASS="SECT2" ><A NAME="CONTACT-BUGS" ->Report bugs</A +>Report Bugs</A ></H2 ><P -> <P -CLASS="LITERALLAYOUT" ->To submit bugs, use the Sourceforge Bug Forum:<br> -<br> - <A +> Please report all bugs <I +CLASS="EMPHASIS" +>only</I +> 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 ->. </P -> - </P +>. </P +><P +> Before doing so, please make sure that the bug has not already been submitted + and observe the aditional hints at the top of the <A +HREF="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118" +TARGET="_top" +>submit + form</A +>.</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 first. If unsure, + try <A +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());" +TARGET="_top" +>toggling + off</A +> <SPAN CLASS="APPLICATION" >Privoxy</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 +>, and see if the problem persists. + The <A +HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" +TARGET="_top" +>appendix + of the user manual</A +> also has helpful information + on action debugging. If you are using your own custom configuration, please try + the stock configs to see if the problem is configuration related.</P +><P +> If not using the latest version, chances are that the bug has 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 + your bug, but this is not required for reporting.</P ></DIV ><DIV CLASS="SECT2" @@ -401,20 +438,16 @@ CLASS="SECT2" CLASS="SECT2" ><A NAME="CONTACT-FEATURE" ->Request new features</A +>Request New Features</A ></H2 ><P -> <P -CLASS="LITERALLAYOUT" ->To submit ideas on new features, use the Sourceforge feature request forum:<br> -<br> - <A -HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse" +> You are welcome to submit ideas on new features or other proposals + for improvement through our feature request tracker at + <A +HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118" TARGET="_top" ->http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse</A +>http://sourceforge.net/tracker/?atid=361118&group_id=11118</A >.</P -> - </P ></DIV ><DIV CLASS="SECT2" @@ -422,20 +455,22 @@ CLASS="SECT2" CLASS="SECT2" ><A NAME="CONTACT-ADS" ->Report ads or other filter problems</A +>Report Ads or Other Actions-Related Problems</A ></H2 ><P ->You can also send feedback on websites that Privoxy has problems with. Please bookmark -the following link: <A +> Please send feedback on ads that slipped through, innocent images that were blocked, + and any other problems relating to the <TT +CLASS="FILENAME" +>default.action</TT +> file through + our actions feedback mechanism located at + <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 -CLASS="QUOTE" ->"Privoxy - Submit Filter Feedback"</SPAN -></A ->. Once you surf to a page with problems, use the -bookmark to send us feedback. We will look into the issue as soon as possible. - </P +>http://www.privoxy.org/actions/</A +>. + On this page, you will also find a bookmark which will take you back there from + any troubled site and even pre-fill the form!</P ><P > New, improved <TT CLASS="FILENAME" @@ -446,7 +481,11 @@ HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce" TARGET="_top" >ijbswa-announce</A > - list.</P + list and available from our <A +HREF="http://sf.net/projects/ijbswa/" +TARGET="_top" +>project page</A +>.</P ></DIV ><DIV CLASS="SECT2" @@ -457,22 +496,18 @@ NAME="CONTACT-OTHER" >Other</A ></H2 ><P -> <P -CLASS="LITERALLAYOUT" ->For any other issues, feel free to use the mailing lists:<br> - <br> - <A +>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" +>Prixoxy</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 -> - </P -><P -> Anyone interested in actively participating in development and related - discussions can also join the appropriate mailing list. Archives are - available, too. See the page on Sourceforge. - </P ></DIV ></DIV ><DIV @@ -480,7 +515,7 @@ CLASS="SECT1" ><HR><H1 CLASS="SECT1" ><A -NAME="AEN101" +NAME="AEN109" >License</A ></H1 ><P @@ -557,61 +592,100 @@ CLASS="SECT1" ><HR><H1 CLASS="SECT1" ><A -NAME="AEN121" +NAME="AEN129" >History</A ></H1 ><P -> <SPAN -CLASS="APPLICATION" ->Privoxy</SPAN -> is evolved, and derived from, - <SPAN +> In the beginning, there was the + <A +HREF="http://www.junkbusters.com/ijb.html" +TARGET="_top" +><SPAN CLASS="APPLICATION" ->the Internet Junkbuster</SPAN ->, with many - improvments and enhancements over the original.</P +>Internet Junkbuster</SPAN +></A +>, + by Anonymous Coders and <A +HREF="http://www.junkbusters.com/" +TARGET="_top" +>Junkbusters + Corporation</A +>. It saved many users a lot of pain in the early days of + web advertising and user tracking.</P ><P -> <SPAN +> But the web, its protocols and standards, and with it, the techniques for + forcing users to consume ads, give up autonomy over their browsing, and + for spying on them, kept evolving. Unfortunately, the <SPAN CLASS="APPLICATION" ->Junkbuster</SPAN -> was originally written by Anonymous - Coders and <A +>Internet + Junkbuster</SPAN +> did not. Version 2.0.2, published in 1998, was + (and is) the last official + <A +HREF="http://www.junkbusters.com/ijbdist.html#release" +TARGET="_top" +>release</A +> + available from <A HREF="http://www.junkbusters.com" TARGET="_top" ->Junkbusters - Corporation</A ->, and was released as free open-source software under the - GNU GPL. <A +>Junkbusters Corporation</A +>. + Fortunately, it had been released under the GNU + <A +HREF="http://www.gnu.org/licenses/gpl.html" +TARGET="_top" +> GPL</A +>, which allowed further + development by others.</P +><P +> So Stefan Waldherr started maintaining an + <A HREF="http://www.waldherr.org/junkbuster/" TARGET="_top" ->Stefan - Waldherr</A -> made many improvements, and started the <A -HREF="http://sourceforge.net/projects/ijbswa/" +>improved version of the + software</A +>, to which eventually a number of people contributed patches. + It could already replace banners with a transparent image, and had a first + version of pop-up killing, but it was still very closely based on the + original, with all its limitations, such as the lack of HTTP/1.1 support, + flexible per-site configuration, or content modification. The last release + from this effort was version 2.0.2-10, published in 2000.</P +><P +> Then, some + <A +HREF="http://www.privoxy.org/user-manual/copyright.html#AUTHORS" TARGET="_top" ->SourceForge project - Privoxy</A -> to rekindle development. There are now several active - developers contributing. The last stable release of - <SPAN +>developers</A +> + picked up the thread, and started turning the software inside out, upside down, + and then reassembled it, adding many + <A +HREF="http://www.privoxy.org/user-manual/introduction.html#FEATURES" +TARGET="_top" +>new + features</A +> along the way.</P +><P +> The result of this is <SPAN CLASS="APPLICATION" ->Junkbuster</SPAN -> was v2.0.2, which has now - grown whiskers ;-).</P +>Privoxy</SPAN +>, whose first + stable release, 3.0, is due in May 2002.</P ></DIV ><DIV CLASS="SECT1" ><HR><H1 CLASS="SECT1" ><A -NAME="AEN132" +NAME="AEN147" ></A ></H1 ><P ><DIV CLASS="INFORMALTABLE" ><A -NAME="AEN135" +NAME="AEN150" ></A ><P ></P diff --git a/doc/webserver/user-manual/actions-file.html b/doc/webserver/user-manual/actions-file.html index fb9d76b3..bc85832d 100644 --- a/doc/webserver/user-manual/actions-file.html +++ b/doc/webserver/user-manual/actions-file.html @@ -4,7 +4,8 @@ >Actions Files</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="Privoxy User Manual" HREF="index.html"><LINK @@ -201,7 +202,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1403" +NAME="AEN1527" >8.1. Finding the Right Mix</A ></H2 ><P @@ -235,7 +236,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1410" +NAME="AEN1534" >8.2. How to Edit</A ></H2 ><P @@ -434,7 +435,7 @@ CLASS="SECT3" ><H3 CLASS="SECT3" ><A -NAME="AEN1473" +NAME="AEN1597" >8.4.1. The Domain Pattern</A ></H3 ><P @@ -608,7 +609,7 @@ CLASS="SECT3" ><H3 CLASS="SECT3" ><A -NAME="AEN1535" +NAME="AEN1659" >8.4.2. The Path Pattern</A ></H3 ><P @@ -3614,7 +3615,7 @@ CLASS="SECT3" ><H3 CLASS="SECT3" ><A -NAME="AEN2469" +NAME="AEN2593" >8.5.21. Summary</A ></H3 ><P @@ -3870,7 +3871,7 @@ CLASS="SECT3" ><H3 CLASS="SECT3" ><A -NAME="AEN2521" +NAME="AEN2645" >8.7.1. default.action</A ></H3 ><P @@ -4659,7 +4660,7 @@ CLASS="SECT3" ><H3 CLASS="SECT3" ><A -NAME="AEN2675" +NAME="AEN2799" >8.7.2. user.action</A ></H3 ><P diff --git a/doc/webserver/user-manual/appendix.html b/doc/webserver/user-manual/appendix.html index 8480b635..a60e0a9b 100644 --- a/doc/webserver/user-manual/appendix.html +++ b/doc/webserver/user-manual/appendix.html @@ -4,7 +4,8 @@ >Appendix</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="Privoxy User Manual" HREF="index.html"><LINK @@ -702,7 +703,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN3218" +NAME="AEN3346" >14.2. <SPAN CLASS="APPLICATION" >Privoxy</SPAN @@ -751,7 +752,7 @@ CLASS="APPLICATION" Privoxy main page: </P ><A -NAME="AEN3233" +NAME="AEN3361" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -784,7 +785,7 @@ CLASS="APPLICATION" editing of actions files: </P ><A -NAME="AEN3241" +NAME="AEN3369" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -804,7 +805,7 @@ TARGET="_top" Show the source code version numbers: </P ><A -NAME="AEN3246" +NAME="AEN3374" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -824,7 +825,7 @@ TARGET="_top" Show the browser's request headers: </P ><A -NAME="AEN3251" +NAME="AEN3379" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -844,7 +845,7 @@ TARGET="_top" Show which actions apply to a URL and why: </P ><A -NAME="AEN3256" +NAME="AEN3384" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -868,7 +869,7 @@ CLASS="QUOTE" to run, but only as a pass-through proxy, with no actions taking place: </P ><A -NAME="AEN3262" +NAME="AEN3390" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -885,7 +886,7 @@ TARGET="_top" > Short cuts. Turn off, then on: </P ><A -NAME="AEN3266" +NAME="AEN3394" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -899,7 +900,7 @@ TARGET="_top" </P ></BLOCKQUOTE ><A -NAME="AEN3269" +NAME="AEN3397" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -1363,19 +1364,44 @@ WIDTH="100%" CLASS="SCREEN" > Matches for http://google.com: ---- File standard --- -(no matches in this file) - ---- File default --- + In file: default.action <SPAN +CLASS="GUIBUTTON" +>[ View ]</SPAN +> <SPAN +CLASS="GUIBUTTON" +>[ Edit ]</SPAN +> -{ -add-header -block +deanimate-gifs{last} -downgrade-http-version +fast-redirects - -filter{popups} -filter{fun} -filter{shockwave-flash} -filter{crude-parental} - +filter{html-annoyances} +filter{js-annoyances} +filter{content-cookies} - +filter{webbugs} +filter{refresh-tags} +filter{nimda} +filter{banners-by-size} - +hide-forwarded-for-headers +hide-from-header{block} +hide-referer{forge} - -hide-user-agent -handle-as-image +set-image-blocker{pattern} -limit-connect - +prevent-compression +session-cookies-only -crunch-outgoing-cookies - -crunch-incoming-cookies -kill-popups -send-vanilla-wafer -send-wafer } +{-add-header + -block + -crunch-outgoing-cookies + -crunch-incoming-cookies + +deanimate-gifs{last} + -downgrade-http-version + +fast-redirects + -filter{popups} + -filter{fun} + -filter{shockwave-flash} + -filter{crude-parental} + +filter{html-annoyances} + +filter{js-annoyances} + +filter{content-cookies} + +filter{webbugs} + +filter{refresh-tags} + +filter{nimda} + +filter{banners-by-size} + +hide-forwarded-for-headers + +hide-from-header{block} + +hide-referer{forge} + -hide-user-agent + -handle-as-image + -kill-popups + -limit-connect + +prevent-compression + -send-vanilla-wafer + -send-wafer + +session-cookies-only + +set-image-blocker{pattern} } / { -session-cookies-only } @@ -1384,7 +1410,13 @@ CLASS="SCREEN" { -fast-redirects } .google.com ---- File user --- +In file: user.action <SPAN +CLASS="GUIBUTTON" +>[ View ]</SPAN +> <SPAN +CLASS="GUIBUTTON" +>[ Edit ]</SPAN +> (no matches in this file) </PRE ></TD ></TR @@ -1506,14 +1538,37 @@ WIDTH="100%" ><PRE CLASS="SCREEN" > Final results: - -add-header -block +deanimate-gifs{last} -downgrade-http-version -fast-redirects - -filter{popups} -filter{fun} -filter{shockwave-flash} -filter{crude-parental} - +filter{html-annoyances} +filter{js-annoyances} +filter{content-cookies} - +filter{webbugs} +filter{refresh-tags} +filter{nimda} +filter{banners-by-size} - +hide-forwarded-for-headers +hide-from-header{block} +hide-referer{forge} - -hide-user-agent -handle-as-image +set-image-blocker{pattern} -limit-connect - +prevent-compression -session-cookies-only -crunch-outgoing-cookies - -crunch-incoming-cookies -kill-popups -send-vanilla-wafer -send-wafer</PRE + + -add-header + -block + -crunch-outgoing-cookies + -crunch-incoming-cookies + +deanimate-gifs{last} + -downgrade-http-version + -fast-redirects + -filter{popups} + -filter{fun} + -filter{shockwave-flash} + -filter{crude-parental} + +filter{html-annoyances} + +filter{js-annoyances} + +filter{content-cookies} + +filter{webbugs} + +filter{refresh-tags} + +filter{nimda} + +filter{banners-by-size} + +hide-forwarded-for-headers + +hide-from-header{block} + +hide-referer{forge} + -hide-user-agent + -handle-as-image + -kill-popups + -limit-connect + +prevent-compression + -send-vanilla-wafer + -send-wafer + -session-cookies-only + +set-image-blocker{pattern} </PRE ></TD ></TR ></TABLE @@ -1621,13 +1676,40 @@ WIDTH="100%" CLASS="SCREEN" > Matches for http://www.rhapsodyk.net/adsl/HOWTO/: - { -add-header -block +deanimate-gifs -downgrade-http-version +fast-redirects - +filter{html-annoyances} +filter{js-annoyances} +filter{kill-popups} - +filter{webbugs} +filter{nimda} +filter{banners-by-size} +filter{hal} - +filter{fun} +hide-forwarded-for-headers +hide-from-header{block} - +hide-referer{forge} -hide-user-agent -handle-as-image +set-image-blocker{blank} - +prevent-compression +session-cookies-only -crunch-incoming-cookies - -crunch-outgoing-cookies +kill-popups -send-vanilla-wafer -send-wafer } + In file: default.action <SPAN +CLASS="GUIBUTTON" +>[ View ]</SPAN +> <SPAN +CLASS="GUIBUTTON" +>[ Edit ]</SPAN +> + + {-add-header + -block + -crunch-incoming-cookies + -crunch-outgoing-cookies + +deanimate-gifs + -downgrade-http-version + +fast-redirects + +filter{html-annoyances} + +filter{js-annoyances} + +filter{kill-popups} + +filter{webbugs} + +filter{nimda} + +filter{banners-by-size} + +filter{hal} + +filter{fun} + +hide-forwarded-for-headers + +hide-from-header{block} + +hide-referer{forge} + -hide-user-agent + -handle-as-image + +kill-popups + +prevent-compression + -send-vanilla-wafer + -send-wafer + +session-cookies-only + +set-image-blocker{blank} } / { +block +handle-as-image } diff --git a/doc/webserver/user-manual/config.html b/doc/webserver/user-manual/config.html index e16e47af..c51c4ea4 100644 --- a/doc/webserver/user-manual/config.html +++ b/doc/webserver/user-manual/config.html @@ -4,7 +4,8 @@ >The Main Configuration File</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="Privoxy User Manual" HREF="index.html"><LINK diff --git a/doc/webserver/user-manual/configuration.html b/doc/webserver/user-manual/configuration.html index 3b4256fd..ecba3d6b 100644 --- a/doc/webserver/user-manual/configuration.html +++ b/doc/webserver/user-manual/configuration.html @@ -4,7 +4,8 @@ >Privoxy Configuration</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="Privoxy User Manual" HREF="index.html"><LINK @@ -92,7 +93,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN357" +NAME="AEN481" >6.1. Controlling <SPAN CLASS="APPLICATION" >Privoxy</SPAN diff --git a/doc/webserver/user-manual/contact.html b/doc/webserver/user-manual/contact.html index 8e67ad83..265c1977 100644 --- a/doc/webserver/user-manual/contact.html +++ b/doc/webserver/user-manual/contact.html @@ -5,7 +5,8 @@ Requests</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="Privoxy User Manual" HREF="index.html"><LINK diff --git a/doc/webserver/user-manual/copyright.html b/doc/webserver/user-manual/copyright.html index 1cb500c2..0d5c62d3 100644 --- a/doc/webserver/user-manual/copyright.html +++ b/doc/webserver/user-manual/copyright.html @@ -4,7 +4,8 @@ >Privoxy Copyright, License and History</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="Privoxy User Manual" HREF="index.html"><LINK @@ -96,7 +97,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2972" +NAME="AEN3096" >12.1. License</A ></H2 ><P diff --git a/doc/webserver/user-manual/filter-file.html b/doc/webserver/user-manual/filter-file.html index 7bb9f261..d9a382fe 100644 --- a/doc/webserver/user-manual/filter-file.html +++ b/doc/webserver/user-manual/filter-file.html @@ -4,7 +4,8 @@ >The Filter File</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="Privoxy User Manual" HREF="index.html"><LINK @@ -253,7 +254,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2778" +NAME="AEN2902" >9.1. Filter File Tutorial</A ></H2 ><P diff --git a/doc/webserver/user-manual/index.html b/doc/webserver/user-manual/index.html index cad32796..1320e4f8 100644 --- a/doc/webserver/user-manual/index.html +++ b/doc/webserver/user-manual/index.html @@ -4,7 +4,8 @@ >Privoxy User Manual</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="NEXT" TITLE="Introduction" HREF="introduction.html"><LINK @@ -44,7 +45,7 @@ TARGET="_top" ><BR></P ><P CLASS="PUBDATE" ->$Id: user-manual.sgml,v 1.117 2002/05/17 13:56:16 oes Exp $<BR></P +>$Id: user-manual.sgml,v 1.118 2002/05/21 04:54:55 hal9 Exp $<BR></P ><DIV ><DIV CLASS="ABSTRACT" @@ -146,7 +147,7 @@ HREF="installation.html#INSTALLATION-PACKAGES" ><DT >2.1.1. <A HREF="installation.html#INSTALLATION-PACK-RPM" ->Red Hat, SuSE RPMs and Conectiva</A +>Red Hat, SuSE and Conectiva RPMs</A ></DT ><DT >2.1.2. <A @@ -200,6 +201,15 @@ CLASS="APPLICATION" >Privoxy</SPAN ></A ></DT +><DD +><DL +><DT +>4.1. <A +HREF="quickstart.html#QUICKSTART-AD-BLOCKING" +>Quickstart to Ad Blocking</A +></DT +></DL +></DD ><DT >5. <A HREF="startup.html" @@ -264,7 +274,7 @@ CLASS="APPLICATION" ><DL ><DT >6.1. <A -HREF="configuration.html#AEN357" +HREF="configuration.html#AEN481" >Controlling <SPAN CLASS="APPLICATION" >Privoxy</SPAN @@ -455,12 +465,12 @@ HREF="actions-file.html" ><DL ><DT >8.1. <A -HREF="actions-file.html#AEN1403" +HREF="actions-file.html#AEN1527" >Finding the Right Mix</A ></DT ><DT >8.2. <A -HREF="actions-file.html#AEN1410" +HREF="actions-file.html#AEN1534" >How to Edit</A ></DT ><DT @@ -476,18 +486,13 @@ HREF="actions-file.html#AF-PATTERNS" ><DD ><DL ><DT ->22<A -HREF="actions-file.html#AEN1440" -></A -></DT -><DT >8.4.1. <A -HREF="actions-file.html#AEN1473" +HREF="actions-file.html#AEN1597" >The Domain Pattern</A ></DT ><DT >8.4.2. <A -HREF="actions-file.html#AEN1535" +HREF="actions-file.html#AEN1659" >The Path Pattern</A ></DT ></DL @@ -664,7 +669,7 @@ CLASS="EMPHASIS" ></DT ><DT >8.5.21. <A -HREF="actions-file.html#AEN2469" +HREF="actions-file.html#AEN2593" >Summary</A ></DT ></DL @@ -683,12 +688,12 @@ HREF="actions-file.html#ACT-EXAMPLES" ><DL ><DT >8.7.1. <A -HREF="actions-file.html#AEN2521" +HREF="actions-file.html#AEN2645" >default.action</A ></DT ><DT >8.7.2. <A -HREF="actions-file.html#AEN2675" +HREF="actions-file.html#AEN2799" >user.action</A ></DT ></DL @@ -704,7 +709,7 @@ HREF="filter-file.html" ><DL ><DT >9.1. <A -HREF="filter-file.html#AEN2778" +HREF="filter-file.html#AEN2902" >Filter File Tutorial</A ></DT ></DL @@ -761,7 +766,7 @@ CLASS="APPLICATION" ><DL ><DT >12.1. <A -HREF="copyright.html#AEN2972" +HREF="copyright.html#AEN3096" >License</A ></DT ><DT @@ -795,7 +800,7 @@ HREF="appendix.html#REGEX" ></DT ><DT >14.2. <A -HREF="appendix.html#AEN3218" +HREF="appendix.html#AEN3346" ><SPAN CLASS="APPLICATION" >Privoxy</SPAN diff --git a/doc/webserver/user-manual/installation.html b/doc/webserver/user-manual/installation.html index 42d10135..a2c87ff5 100644 --- a/doc/webserver/user-manual/installation.html +++ b/doc/webserver/user-manual/installation.html @@ -4,7 +4,8 @@ >Installation</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="Privoxy User Manual" HREF="index.html"><LINK @@ -121,7 +122,7 @@ CLASS="SECT3" CLASS="SECT3" ><A NAME="INSTALLATION-PACK-RPM" ->2.1.1. Red Hat, SuSE RPMs and Conectiva</A +>2.1.1. Red Hat, SuSE and Conectiva RPMs</A ></H3 ><P > RPMs can be installed with <TT @@ -155,7 +156,7 @@ automatically start Privoxy in the boot process.</P > If you have problems with failed dependencies, try rebuilding the SRC RPM: <TT CLASS="LITERAL" ->rpm --rebuild privoxy-2.9.15-1.src.rpm;</TT +>rpm --rebuild privoxy-2.9.15-1.src.rpm</TT >. This will use your locally installed libraries and RPM version. </P ><P diff --git a/doc/webserver/user-manual/introduction.html b/doc/webserver/user-manual/introduction.html index 536b4f46..807a0ac1 100644 --- a/doc/webserver/user-manual/introduction.html +++ b/doc/webserver/user-manual/introduction.html @@ -4,7 +4,8 @@ >Introduction</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="Privoxy User Manual" HREF="index.html"><LINK diff --git a/doc/webserver/user-manual/quickstart.html b/doc/webserver/user-manual/quickstart.html index ac3066d0..fa3df908 100644 --- a/doc/webserver/user-manual/quickstart.html +++ b/doc/webserver/user-manual/quickstart.html @@ -4,7 +4,8 @@ >Quickstart to Using Privoxy</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="Privoxy User Manual" HREF="index.html"><LINK @@ -235,6 +236,473 @@ HREF="contact.html" ></LI ></UL ></P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="QUICKSTART-AD-BLOCKING" +>4.1. Quickstart to Ad Blocking</A +></H2 +><P +> Ad blocking is but one of <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + array of features. Many of these features are for the technically minded advanced + user. But, ad and banner blocking is surely common ground for everybody.</P +><P +> + This section will provide a quick summary of ad blocking so + you can get up to speed quickly without having to read the more extensive + information provided below, though this is highly recommeneded.</P +><P +> First a bit of a warning ... blocking ads is much like blocking SPAM: the + more aggressive you are about it, the more likely you are to block + things that were not intended. So there is a trade off here. If you want + extreme ad free browsing, be prepared to deal with more + <SPAN +CLASS="QUOTE" +>"problem"</SPAN +> sites, and to spend more time adjusting the + configuration to solve these unintended consequences. In short, there is + not an easy way to eliminate <I +CLASS="EMPHASIS" +>all</I +> ads. Either take + the easy way and settle for <I +CLASS="EMPHASIS" +>most</I +> ads blocked with the + default configuration, or jump in and tweak it for your personal surfing + habits and preferences.</P +><P +> Secondly, a brief explanation of <SPAN +CLASS="APPLICATION" +>Privoxy's </SPAN +> + <SPAN +CLASS="QUOTE" +>"actions"</SPAN +>. <SPAN +CLASS="QUOTE" +>"Actions"</SPAN +> in this context, are + the directives we use to tell <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to perform + some task relating to HTTP transactions (i.e. web browsing). We tell + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to take some <SPAN +CLASS="QUOTE" +>"action"</SPAN +>. Each + action has a unique name and function. While there are many potential + <SPAN +CLASS="APPLICATION" +>actions</SPAN +> in <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + arsenal, only a few are used for ad blocking. <A +HREF="actions-file.html#ACTIONS" +>Actions</A +>, and <A +HREF="actions-file.html" +>action + configuration files</A +>, are explained in depth below.</P +><P +> Actions are specified in <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> configuration, + followed by one or more URLs to which the action should apply. URLs + can actually be URL type <A +HREF="actions-file.html#AF-PATTERNS" +>patterns</A +> that use + wildcards so they can apply potentially to a range of similar URLs.</P +><P +> When you connect to a website, the full path of the URL will either match one + of the <SPAN +CLASS="QUOTE" +>"actions"</SPAN +> as defined in + <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> configuration, or not. If so, then + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will perform the action accordingly. If + not, then nothing special happens. Futhermore, web pages may contain + embedded, secondary URLs that your web browser will display as it parses the + original page's HTML content. An ad image for instance, is just a URL + embedded in the page somewhere. The image itself may be on the same server, + or a server somewhere else on the Internet. Complex web pages will have many + such embedded URLs.</P +><P +> The actions we need to know about for ad blocking are: <A +HREF="actions-file.html#BLOCK" +>block</A +>, <A +HREF="actions-file.html#HANDLE-AS-IMAGE" +>handle-as-image</A +>, and <A +HREF="actions-file.html#SET-IMAGE-BLOCKER" +>set-image-blocker</A +>:</P +><P +> <P +></P +><UL +><LI +><P +> <A +HREF="actions-file.html#BLOCK" +><I +CLASS="EMPHASIS" +>block</I +></A +> - this action stops + any contact between your browser and any URL patterns that match this + action's configuration. It can be used for blocking ads, but also anything + that is determined to be unwanted. By itself, it simply stops any + communication with the remote server. If this is the only action that + matches for this particular URL, then <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will + display its own BLOCKED page to let you now what has happened. + </P +></LI +><LI +><P +> <A +HREF="actions-file.html#HANDLE-AS-IMAGE" +><I +CLASS="EMPHASIS" +>handle-as-image</I +></A +> - + forces <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to treat this URL as if it were + an image. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> knows about common image + types (e.g. GIF), but there are many situations where this does not apply. + So we'll force it. This is particularly important for ad blocking, since + once we can treat it as an image, we can make more intelligent decisisions + on how to handle it. There are some limitations to this though. For + instance, you can't just force an image substituion for an entire HTML page + in most situations. + </P +></LI +><LI +><P +> <A +HREF="actions-file.html#SET-IMAGE-BLOCKER" +><I +CLASS="EMPHASIS" +>set-image-blocker</I +></A +> - + tells <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> what to display in place of + an ad image that has hit a block rule. For this to come into play, + the URL must match a block action somewhere in the configuration. + <I +CLASS="EMPHASIS" +>And</I +>, it must also either be of a known image type, or + match an <A +HREF="actions-file.html#HANDLE-AS-IMAGE" +><I +CLASS="EMPHASIS" +>handle-as-image</I +></A +> + action. + </P +><P +> The configuration options on what to display instead of the ad are: + </P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <I +CLASS="EMPHASIS" +>pattern</I +> - a checkboard pattern, so that an ad + replacement is obvious. This is the default. + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <I +CLASS="EMPHASIS" +>blank</I +> - A very small empty GIF image is displayed. + This is the so-called <SPAN +CLASS="QUOTE" +>"invisible"</SPAN +> configuration option. + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <I +CLASS="EMPHASIS" +>http://<URL></I +> - A redirect to any URL of the + user's choosing (advanced usage). + </TD +></TR +></TBODY +></TABLE +><P +></P +></LI +></UL +></P +><P +> The quickest way to adjust any of these settings is with your browser through + the special <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> editor at <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>http://config.privoxy.org/show-status</A +> + (shortcut: <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/show-status</A +>). This + is an internal page, and does not require Internet access. Select the + appropriate <SPAN +CLASS="QUOTE" +>"actions"</SPAN +> file, and click + <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Edit</SPAN +>"</SPAN +>. It is best to put personal or + local preferences in <TT +CLASS="FILENAME" +>user.action</TT +> since this is not + meant to be overwritten during upgrades, and will over-ride the settings in + other files. Here you can insert new <SPAN +CLASS="QUOTE" +>"actions"</SPAN +>, and URLs for ad + blocking or other purposes, and make other adjustments to the configuration. + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will detect these changes automatically.</P +><P +> A quick and simple step by step example:</P +><P +> <P +></P +><UL +><LI +><P +> Right click on the ad image to be blocked, then select + <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIMENUITEM" +>Copy Link Location</SPAN +>"</SPAN +> from the + pop-up menu. + </P +></LI +><LI +><P +> Set your browser to + <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>http://config.privoxy.org/show-status</A +> + </P +></LI +><LI +><P +> Find <TT +CLASS="FILENAME" +>user.action</TT +> in the top section, and click + on <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Edit</SPAN +>"</SPAN +>: + </P +><P +> <DIV +CLASS="FIGURE" +><A +NAME="AEN349" +></A +><P +><B +>Figure 1. Actions Files in Use</B +></P +><DIV +CLASS="MEDIAOBJECT" +><P +><IMG +SRC="../images/files-in-use.jpg" +ALT="Screenshot of Files in Use" +></IMG +></P +></DIV +></DIV +> + </P +></LI +><LI +><P +> You should have an Actions section labeled <I +CLASS="EMPHASIS" +>+block</I +>. + If not, click the <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Edit</SPAN +>"</SPAN +> button just + under the word <SPAN +CLASS="QUOTE" +>"Actions"</SPAN +>. This will bring up a list of all + actions. Find <I +CLASS="EMPHASIS" +>block</I +> near the top, and click in the + <SPAN +CLASS="QUOTE" +>"Enabled"</SPAN +> column, then + <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Submit</SPAN +>"</SPAN +> just below the list. + </P +></LI +><LI +><P +> Now, in the <I +CLASS="EMPHASIS" +>+block</I +> actions section, click the + <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Add</SPAN +>"</SPAN +> button, and paste the URL the + browser got from <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIMENUITEM" +>Copy Link + Location</SPAN +>"</SPAN +>. Remove the <TT +CLASS="LITERAL" +>http://</TT +> at + the beginning of the URL. Then, click + <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Submit</SPAN +>"</SPAN +>. + </P +></LI +><LI +><P +> Now go back to the original page, and press <B +CLASS="KEYCAP" +>SHIFT-Reload</B +> + (or flush all browser caches). The image should be gone now. + </P +></LI +></UL +></P +><P +> This is a very crude and simple example. There might be good reasons to use a + wildcard pattern match to include potentially similar images from the same + site. For a more extensive explanation of <SPAN +CLASS="QUOTE" +>"patterns"</SPAN +>, and + the entire actions concept, see <A +HREF="actions-file.html" +>the Actions + section</A +>.</P +><P +> For advanced users who want to hand edit their config files, you might want + to now go to the <A +HREF="actions-file.html#ACT-EXAMPLES" +>Actions Files Tutorial</A +>.</P +></DIV ></DIV ><DIV CLASS="NAVFOOTER" diff --git a/doc/webserver/user-manual/seealso.html b/doc/webserver/user-manual/seealso.html index bff29f27..9d13cdf0 100644 --- a/doc/webserver/user-manual/seealso.html +++ b/doc/webserver/user-manual/seealso.html @@ -4,7 +4,8 @@ >See Also</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="Privoxy User Manual" HREF="index.html"><LINK @@ -309,6 +310,29 @@ CLASS="APPLICATION" ></TABLE ><P ></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.privoxy.org/developer-manual/" +TARGET="_top" +>http://www.privoxy.org/developer-manual/</A +>, + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> developer manual. + </TD +></TR +></TBODY +></TABLE +><P +></P ></P ></DIV ><DIV diff --git a/doc/webserver/user-manual/startup.html b/doc/webserver/user-manual/startup.html index d6ba5e29..3c6560e0 100644 --- a/doc/webserver/user-manual/startup.html +++ b/doc/webserver/user-manual/startup.html @@ -4,7 +4,8 @@ >Starting Privoxy</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="Privoxy User Manual" HREF="index.html"><LINK diff --git a/doc/webserver/user-manual/templates.html b/doc/webserver/user-manual/templates.html index dbd8a604..137244a5 100644 --- a/doc/webserver/user-manual/templates.html +++ b/doc/webserver/user-manual/templates.html @@ -4,7 +4,8 @@ >Templates</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="Privoxy User Manual" HREF="index.html"><LINK diff --git a/doc/webserver/user-manual/upgradersnote.html b/doc/webserver/user-manual/upgradersnote.html index 6e8ea179..3fc7d241 100644 --- a/doc/webserver/user-manual/upgradersnote.html +++ b/doc/webserver/user-manual/upgradersnote.html @@ -4,7 +4,8 @@ >Note to Upgraders</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="Privoxy User Manual" HREF="index.html"><LINK