+<H2>DESCRIPTION</H2><PRE>
+ <B>Privoxy</B> is a web proxy with advanced filtering capabili
+ ties for protecting privacy, filtering web page content,
+ managing cookies, controlling access, and removing ads,
+ banners, pop-ups and other obnoxious Internet junk.
+ <B>Privoxy</B> has a very flexible configuration and can be cus
+ tomized to suit individual needs and tastes. <B>Privoxy</B> has
+ application for both stand-alone systems and multi-user
+ networks.
+
+ Browsers must be individually configured to use <B>Privoxy</B> as
+ a HTTP proxy. The default setting is for localhost, on
+ port 8118 (configurable in the main config file). To set
+ the HTTP proxy in Netscape and Mozilla, go through: <B>Edit</B>;
+ <B>Preferences</B>; <B>Advanced</B>; <B>Proxies</B>; <B>Manual</B> <B>Proxy</B> <B>Configura</B>
+ <B>tion</B>; <B>View</B>.
+
+ For Internet Explorer, go through: <B>Tools</B>; <B>Internet</B> <B>Proper</B>
+ <B>ties</B>; <B>Connections</B>; <B>LAN</B> <B>Settings</B>.
+
+ The Secure (SSL) Proxy should also be set to the same val
+ ues, otherwise https: URLs will not be proxied. Note:
+ <B>Privoxy</B> can only proxy HTTP and HTTPS traffic. Do not try
+ it with FTP or other protocols.
+
+ For other browsers, check the documentation.
+
+
+</PRE>
+<H2>CONFIGURATION</H2><PRE>
+ <B>Privoxy</B> can be configured with the various configuration
+ files. The default configuration files are: <I>config</I>,
+ <I>default.filter</I>, and <I>default.action</I>. <I>user.action</I> should be
+ used for locally defined exceptions to the default rules
+ of <I>default.action</I> These are all well commented. On Unix
+ and Unix-like systems, these are located in <I>/etc/privoxy/</I>
+ by default. On Windows, OS/2 and AmigaOS, these files are
+ in the same directory as the <B>Privoxy</B> executable.
+
+ The name and number of configuration files has changed
+ from previous versions, and is subject to change as devel
+ opment progresses. In fact, the configuration itself is
+ changed and much more sophisticated. See the user-manual
+ for a complete explanation of all configuration options
+ and general usage, and notes for upgrading from <B>Junkbuster</B>
+ and earlier <B>Privoxy</B> versions.
+
+ The actions list (ad blocks, etc) can also be configured
+ with your web browser at http://config.privoxy.org/.
+ <B>Privoxy's</B> configuration parameters can also be viewed at
+ the same page. In addition, <B>Privoxy</B> can be toggled on/off.
+ This is an internal page, and does not require Internet
+ access.
+
+
+</PRE>
+<H2>SAMPLE CONFIGURATION</H2><PRE>
+ A brief example of what a simple <I>default.action</I> configura
+ tion might look like:
+
+ # Define a few useful custom aliases for later use
+ {{alias}}
+
+ # Useful aliases
+ +crunch-cookies = +crunch-incoming-cookies +crunch-outgoing-cookies
+ -crunch-cookies = -crunch-incoming-cookies -crunch-outgoing-cookies
+ fragile = -block -deanimate-gifs -fast-redirects -filter \
+ -hide-referer -prevent-cookies -kill-popups
+
+ ## Turn some actions on ################################
+ { \
+ -add-header \
+ -block \
+ +deanimate-gifs{last} \
+ -downgrade-http-version \
+ -fast-redirects \
+ +filter{html-annoyances} \
+ +filter{js-annoyances} \
+ +filter{content-cookies} \
+ +filter{webbugs} \
+ +filter{banners-by-size} \
+ +hide-forwarded-for-headers \
+ +hide-from-header{block} \
+ +hide-referrer{forge} \
+ -hide-user-agent \
+ -handle-as-image \
+ +set-image-blocker{pattern} \
+ -limit-connect \
+ +prevent-compression \
+ +session-cookies-only \
+ -crunch-cookies \
+ -kill-popups \
+ }
+ / # '/' Matches *all* URL patterns
+
+ # Block, and treat these URL patterns as if they were 'images'.
+ # We would expect these to be ads.
+ {+imageblock}
+ .ad.doubleclick.net
+ .a[0-9].yimg.com/(?:(?!/i/).)*$
+ ad.*.doubleclick.net
+
+ # Block any URLs that match these patterns
+ {+block}
+ ad*.
+ .*ads.
+ banner?.
+ /.*count(er)?\.(pl|cgi|exe|dll|asp|php[34]?)
+ .hitbox.com
+
+ # Make exceptions for these harmless ones that would be
+ # caught by our +block patterns just above.
+ {-block}
+ adsl.
+ advice.
+ .*downloads.
+
+ Then for a <I>user.action</I>, we would put local, narrowly
+ {{alias}}
+
+ # Useful aliases
+ -crunch-cookies = -crunch-incoming-cookies -crunch-outgoing-cookies
+
+ # Set personal exceptions to the policies in default.action #######
+
+ # Sites where we want persistant cookies, so allow *all* cookies
+ {-crunch-cookies -session-cookies-only}
+ .redhat.com
+ .sun.com
+ .msdn.microsoft.com
+
+ # This site breaks easily.
+ {-block -fast-redirects}
+ .forbes.com
+
+ See the comments in the configuration files themselves, or
+ the <I>user-manual</I> for explanations of the above syntax, and
+ other <B>Privoxy</B> configuration options.
+
+
+</PRE>
+<H2>FILES</H2><PRE>
+ <I>/usr/sbin/privoxy</I>
+ <I>/etc/privoxy/config</I>
+ <I>/etc/privoxy/default.action</I>
+ <I>/etc/privoxy/standard.action</I>
+ <I>/etc/privoxy/user.action</I>
+ <I>/etc/privoxy/default.filter</I>
+ <I>/etc/privoxy/trust</I>
+ <I>/etc/privoxy/templates/*</I>
+ <I>/var/log/privoxy/logfile</I>
+
+ Various other files should be included, but may vary
+ depending on platform and build configuration. More docu
+ mentation should be included in the local documentation
+ directory.
+
+
+</PRE>
+<H2>SIGNALS</H2><PRE>
+ <B>Privoxy</B> terminates on the <B>SIGINT</B>, <B>SIGTERM</B> and <B>SIGABRT</B> sig
+ nals. Log rotation scripts may cause a re-opening of the
+ logfile by sending a <B>SIGHUP</B> to <B>Privoxy</B>. Note that unlike
+ other daemons, <B>Privoxy</B> does not need to be made aware of
+ config file changes by <B>SIGHUP</B> -- it will detect them auto
+ matically.
+
+
+</PRE>
+<H2>NOTES</H2><PRE>
+ This is a beta version of <B>Privoxy</B>. Not all features are
+ well tested.
+
+ Please see the <I>User</I> <I>Manual</I> on how to contact the develop
+ ers for feature requests, reporting problems, and other
+ questions.
+ Other references and sites of interest to <B>Privoxy</B> users:
+
+
+ http://www.privoxy.org/, the <B>Privoxy</B> Home page.
+
+ http://www.privoxy.org/faq/, the <B>Privoxy</B> FAQ.
+
+ http://sourceforge.net/projects/ijbswa/, the Project Page
+ for <B>Privoxy</B> on SourceForge.
+
+ http://config.privoxy.org/, the web-based user interface.
+ <B>Privoxy</B> must be running for this to work. Shortcut:
+ http://p.p/
+
+ http://www.privoxy.org/actions/, to submit ``misses'' to
+ the developers.
+
+ http://www.junkbusters.com/ht/en/cookies.html, an explana
+ tion how cookies are used to track web users.
+
+ http://www.junkbusters.com/ijb.html, the original Internet
+ Junkbuster.
+
+ http://www.waldherr.org/junkbuster/, Stefan Waldherr's
+ version of Junkbuster, from which <B>Privoxy</B> was derived.
+
+ http://privacy.net/analyze/, a useful site to check what
+ information about you is leaked while you browse the web.
+
+ http://www.squid-cache.org/, a very popular caching proxy,
+ which is often used together with <B>Privoxy</B>.
+
+ http://www.privoxy.org/developer-manual/, the <B>Privoxy</B>
+ developer manual.
+