><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$
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$
>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
>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"
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"
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"
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"
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"
>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
><H2
CLASS="SECT2"
><A
-NAME="AEN1061"
+NAME="AEN1121"
>9.1. License</A
></H2
><P
><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
<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"
>.
Please see <A
HREF="contact.html"
-TARGET="_top"
>the Contact section</A
>
on how to contact the developers.</P
><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
HREF="newrelease.html#NEWRELEASE-RPM"
->SuSE or Red Hat RPM</A
+>SuSE, Conectiva or Red Hat RPM</A
></DT
><DT
HREF="newrelease.html#NEWRELEASE-OS2"
>OS/2</A
></DT
><DT
HREF="newrelease.html#NEWRELEASE-SOLARIS"
>Solaris</A
></DT
><DT
HREF="newrelease.html#NEWRELEASE-WINDOWS"
>Windows</A
></DT
><DT
HREF="newrelease.html#NEWRELEASE-DEBIAN"
>Debian</A
></DT
><DT
HREF="newrelease.html#NEWRELEASE-MACOSX"
>Mac OSX</A
></DT
><DT
HREF="newrelease.html#NEWRELEASE-FREEBSD"
>FreeBSD</A
></DT
><DT
HREF="newrelease.html#NEWRELEASE-HPUX"
>HP-UX 11</A
></DT
><DT
HREF="newrelease.html#NEWRELEASE-AMIGA"
>Amiga OS</A
></DT
><DT
HREF="newrelease.html#NEWRELEASE-AIX"
>AIX</A
></DT
><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
><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
</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
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
CLASS="SECT3"
><A
NAME="NEWRELEASE-OS2"
->6.3.3. OS/2</A
+>6.3.4. OS/2</A
></H3
><P
> First, <I
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:
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
CLASS="SECT3"
><A
NAME="NEWRELEASE-DEBIAN"
->6.3.6. Debian</A
+>6.3.7. Debian</A
></H3
><P
> First, <I
CLASS="SECT3"
><A
NAME="NEWRELEASE-MACOSX"
->6.3.7. Mac OSX</A
+>6.3.8. Mac OSX</A
></H3
><P
> First, <I
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:
CLASS="SECT3"
><A
NAME="NEWRELEASE-HPUX"
->6.3.9. HP-UX 11</A
+>6.3.10. HP-UX 11</A
></H3
><P
> First, <I
CLASS="SECT3"
><A
NAME="NEWRELEASE-AMIGA"
->6.3.10. Amiga OS</A
+>6.3.11. Amiga OS</A
></H3
><P
> First, <I
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:
>
</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"
><TBODY
><TR
><TD
+> <A
HREF="http://www.privoxy.org/"
TARGET="_top"
>http://www.privoxy.org/</A
>,
- The <SPAN
+ the <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
> Home page.
><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"
<A
HREF="http://sourceforge.net"
TARGET="_top"
->Sourceforge</A
+>SourceForge</A
>.
</TD
></TR
><TBODY
><TR
><TD
-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
><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.
><TBODY
><TR
><TD
+> <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
><TBODY
><TR
><TD
+> <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
><TBODY
><TR
><TD
+> <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
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"
>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
>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"
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"
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"
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"
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"
>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
><H2
CLASS="SECT2"
><A
-NAME="AEN647"
+NAME="AEN666"
>7.1. License</A
></H2
><P
><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
><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
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
><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"
><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
></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
><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
><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
><P
>Please see the <A
HREF="contact.html"
-TARGET="_top"
>Contact section</A
>.</P
><P
><TBODY
><TR
><TD
+> <A
HREF="http://www.privoxy.org/"
TARGET="_top"
>http://www.privoxy.org/</A
>,
- The <SPAN
+ the <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
> Home page.
><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"
<A
HREF="http://sourceforge.net"
TARGET="_top"
->Sourceforge</A
+>SourceForge</A
>.
</TD
></TR
><TBODY
><TR
><TD
-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
><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.
><TBODY
><TR
><TD
+> <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
><TBODY
><TR
><TD
+> <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
><TBODY
><TR
><TD
+> <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
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
><H3
CLASS="SECT2"
><A
-NAME="AEN559"
+NAME="AEN570"
>5.1. I just upgraded and am getting <SPAN
CLASS="QUOTE"
>"connection refused"</SPAN
><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
><H3
CLASS="SECT2"
><A
-NAME="AEN578"
+NAME="AEN589"
>5.3. One of my favorite sites does not work with <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
><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
></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
>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
>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"
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"
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"
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"
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"
>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
><HR><H1
CLASS="SECT1"
><A
-NAME="AEN101"
+NAME="AEN109"
>License</A
></H1
><P
><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
>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
><H2
CLASS="SECT2"
><A
-NAME="AEN1403"
+NAME="AEN1527"
>8.1. Finding the Right Mix</A
></H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN1410"
+NAME="AEN1534"
>8.2. How to Edit</A
></H2
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN1473"
+NAME="AEN1597"
>8.4.1. The Domain Pattern</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN1535"
+NAME="AEN1659"
>8.4.2. The Path Pattern</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN2469"
+NAME="AEN2593"
>8.5.21. Summary</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN2521"
+NAME="AEN2645"
>8.7.1. default.action</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN2675"
+NAME="AEN2799"
>8.7.2. user.action</A
></H3
><P
>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
><H2
CLASS="SECT2"
><A
-NAME="AEN3218"
+NAME="AEN3346"
>14.2. <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
Privoxy main page:
</P
><A
-NAME="AEN3233"
+NAME="AEN3361"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
editing of actions files:
</P
><A
-NAME="AEN3241"
+NAME="AEN3369"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show the source code version numbers:
</P
><A
-NAME="AEN3246"
+NAME="AEN3374"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show the browser's request headers:
</P
><A
-NAME="AEN3251"
+NAME="AEN3379"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show which actions apply to a URL and why:
</P
><A
-NAME="AEN3256"
+NAME="AEN3384"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
to run, but only as a pass-through proxy, with no actions taking place:
</P
><A
-NAME="AEN3262"
+NAME="AEN3390"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
> Short cuts. Turn off, then on:
</P
><A
-NAME="AEN3266"
+NAME="AEN3394"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
</P
></BLOCKQUOTE
><A
-NAME="AEN3269"
+NAME="AEN3397"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
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 }
{ -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
><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
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 }
>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
>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
><H2
CLASS="SECT2"
><A
-NAME="AEN357"
+NAME="AEN481"
>6.1. Controlling <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
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
>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
><H2
CLASS="SECT2"
><A
-NAME="AEN2972"
+NAME="AEN3096"
>12.1. License</A
></H2
><P
>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
><H2
CLASS="SECT2"
><A
-NAME="AEN2778"
+NAME="AEN2902"
>9.1. Filter File Tutorial</A
></H2
><P
>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
><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"
><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
>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"
><DL
><DT
>6.1. <A
-HREF="configuration.html#AEN357"
+HREF="configuration.html#AEN481"
>Controlling <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
><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
><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
></DT
><DT
>8.5.21. <A
-HREF="actions-file.html#AEN2469"
+HREF="actions-file.html#AEN2593"
>Summary</A
></DT
></DL
><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
><DL
><DT
>9.1. <A
-HREF="filter-file.html#AEN2778"
+HREF="filter-file.html#AEN2902"
>Filter File Tutorial</A
></DT
></DL
><DL
><DT
>12.1. <A
-HREF="copyright.html#AEN2972"
+HREF="copyright.html#AEN3096"
>License</A
></DT
><DT
></DT
><DT
>14.2. <A
-HREF="appendix.html#AEN3218"
+HREF="appendix.html#AEN3346"
><SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
>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
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
> 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
>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
>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
></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"
>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
></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
>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
>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
>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
projects / privoxy.git / commitdiff