><TD
><PRE
CLASS="PROGRAMLISTING"
->const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 2.9 2006/09/14 02:30:07 hal9 Exp $";
+>const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 2.11 2006/09/26 02:36:29 hal9 Exp $";
/*********************************************************************
*
* File : $Source$
CLASS="PROGRAMLISTING"
>#ifndef _FILENAME_H
#define _FILENAME_H
-#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 2.9 2006/09/14 02:30:07 hal9 Exp $"
+#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 2.11 2006/09/26 02:36:29 hal9 Exp $"
/*********************************************************************
*
* File : $Source$
CLASS="APPLICATION"
>Windows
XP SP2</SPAN
->), if you are using some kind of Unix flavour,
+>), if you are using a Unix flavor,
sending the output of <SPAN
CLASS="QUOTE"
>"uname -a"</SPAN
><H2
CLASS="SECT2"
><A
-NAME="AEN1220"
+NAME="AEN1222"
></A
>9.1. License</H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN1236"
+NAME="AEN1238"
></A
>9.2. History</H2
><P
-> Along time ago, there was the
+> A long time ago, there was the
<A
HREF="http://www.junkbusters.com/ijb.html"
TARGET="_top"
> You might also find <SPAN
CLASS="QUOTE"
>"<A
-HREF="http://www.bureau-cornavin.com/opensource/crash-course/"
+HREF="http://opensource.bureau-cornavin.com/crash-course/index.html"
TARGET="_top"
>Writing Documentation
Using DocBook - A Crash Course</A
>
version string, e.g. <SPAN
CLASS="QUOTE"
->"3.0.5"</SPAN
+>"3.0.6"</SPAN
>.
</TD
></TR
<BR></P
><P
CLASS="PUBDATE"
->$Id: developer-manual.sgml,v 2.9 2006/09/14 02:30:07 hal9 Exp $<BR></P
+>$Id: developer-manual.sgml,v 2.11 2006/09/26 02:36:29 hal9 Exp $<BR></P
><DIV
><DIV
CLASS="ABSTRACT"
for anyone who wants to join the team.</P
><P
> Please note that this document is constantly evolving. This copy represents
- the state at the release of version 3.0.5.
+ the state at the release of version 3.0.6.
You can find the latest version of the this manual at <A
HREF="http://www.privoxy.org/developer-manual/"
TARGET="_top"
><DL
><DT
>9.1. <A
-HREF="copyright.html#AEN1220"
+HREF="copyright.html#AEN1222"
>License</A
></DT
><DT
>9.2. <A
-HREF="copyright.html#AEN1236"
+HREF="copyright.html#AEN1238"
>History</A
></DT
></DL
><TD
><PRE
CLASS="PROGRAMLISTING"
-> debchange -v 3.0.5-BETA-1 "New upstream version"</PRE
+> debchange -v 3.0.6-stable-1 "New upstream version"</PRE
></TD
></TR
></TABLE
> This will create
<TT
CLASS="FILENAME"
->../privoxy_3.0.5-BETA-1_i386.deb</TT
+>../privoxy_3.0.6-stable-1_i386.deb</TT
>
which can be uploaded. To upload the package to Sourceforge, simply
issue
CLASS="emphasis"
><I
CLASS="EMPHASIS"
->3.0.5
+>3.0.6
(beta)</I
></SPAN
>.
><H3
CLASS="SECT2"
><A
-NAME="AEN339"
+NAME="AEN351"
></A
>3.1. What exactly is an <SPAN
CLASS="QUOTE"
><H3
CLASS="SECT2"
><A
-NAME="AEN362"
+NAME="AEN374"
></A
>3.3. How are actions files configured? What is the easiest
way to do this?</H3
><H3
CLASS="SECT2"
><A
-NAME="AEN370"
+NAME="AEN382"
></A
>3.4. There are several different <SPAN
CLASS="QUOTE"
><H3
CLASS="SECT2"
><A
+NAME="DIFFICULT"
+></A
+>3.7. Why is the configuration so complicated?</H3
+><P
+> <SPAN
+CLASS="QUOTE"
+>"Complicated"</SPAN
+> is in the eye of the beholder. Those that are
+ familiar with some of the underlying concepts, such as regular expression
+ syntax, take to it like a fish takes to water. Also, software that tries
+ hard to be <SPAN
+CLASS="QUOTE"
+>"user friendly"</SPAN
+>, often lacks sophistication and
+ flexibility. There is always that trade-off there between power vs.
+ easy-of-use. Furthermore, anyone is welcome to contribute ideas and
+ implementations to enhance <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>.
+ </P
+></DIV
+><DIV
+CLASS="SECT2"
+><H3
+CLASS="SECT2"
+><A
NAME="YAHOO"
></A
->3.7. How can I make my Yahoo/Hotmail/Gmail account work?</H3
+>3.8. How can I make my Yahoo/Hotmail/Gmail account work?</H3
><P
> The default configuration shouldn't impact the usability of any of these services.
- It
will, however, make all <A
+ It
may, however, make all <A
HREF="http://en.wikipedia.org/wiki/Browser_cookie"
TARGET="_top"
>cookies</A
CLASS="LITERAL"
>fragile</TT
> }
+ # Gmail is ...
mail.google.com</PRE
></TD
></TR
><A
NAME="CONFIGFILES"
></A
->3.8. What's the difference between the
+>3.9. What's the difference between the
<SPAN
CLASS="QUOTE"
>"Cautious"</SPAN
><A
NAME="BROWSECONFIG"
></A
->3.9. Why can I change the configuration
+>3.10. Why can I change the configuration
with a browser? Does that not raise security issues?</H3
><P
> It may seem strange that regular users can edit the config files with their
><H3
CLASS="SECT2"
><A
-NAME="AEN470"
+NAME="AEN488"
></A
->3.10. What is the <TT
+>3.11. What is the <TT
CLASS="FILENAME"
>default.filter</TT
> file? What is a <SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN488"
+NAME="LANCONFIG"
></A
->3.11. How can I set up Privoxy to act as a proxy for my
+>3.12. How can I set up Privoxy to act as a proxy for my
LAN?</H3
><P
> By default, <SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN513"
+NAME="AEN531"
></A
->3.12. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</H3
+>3.13. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</H3
><P
> The replacement for blocked images can be controlled with the <A
HREF="../user-manual/actions-file.html#SET-IMAGE-BLOCKER"
><H3
CLASS="SECT2"
><A
-NAME="AEN530"
+NAME="AEN548"
></A
->3.13. Why would anybody want to see a checkerboard pattern?</H3
+>3.14. Why would anybody want to see a checkerboard pattern?</H3
><P
> Remember that <A
HREF="general.html#WHATSANAD"
isn't</A
>, is an educated guess. While we hope that the standard configuration
is rather smart, it will make occasional mistakes. The checkerboard image is visually
- decent, but it shows you that and where images were blocked, which can be very
+ decent, and it shows you where images have been blocked, which can be very
helpful in case some navigation aid or otherwise innocent image was
erroneously blocked. It is recommended for new users so they can
<SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN536"
+NAME="AEN554"
></A
->3.14. I see some images being replaced by a text
+>3.15. I see some images being replaced by a text
instead of the checkerboard image. Why and how do I get rid of this?</H3
><P
> This happens when the banners are not embedded in the HTML code of the
><A
NAME="SRVANY"
></A
->3.15. Can Privoxy run as a service
+>3.16. Can Privoxy run as a service
on Win2K/NT/XP?</H3
><P
> Yes. Version 3.0.5 introduces full <SPAN
><A
NAME="OTHERPROXY"
></A
->3.16. How can I make Privoxy work with other
+>3.17. How can I make Privoxy work with other
proxies like Squid or Tor?</H3
><P
> This can be done and is often useful to combine the benefits of
><A
NAME="PORT-80"
></A
->3.17. Can I just set Privoxy to use port 80
+>3.18. Can I just set Privoxy to use port 80
and thus avoid individual browser configuration?</H3
><P
> No, its more complicated than that. This only works with special kinds
><A
NAME="TRANSPARENT"
></A
->3.18. Can Privoxy run as a <SPAN
+>3.19. Can Privoxy run as a <SPAN
CLASS="QUOTE"
>"transparent"</SPAN
> proxy?</H3
CLASS="APPLICATION"
>Privoxy</SPAN
> currently does not have this ability,
- though it may be added in a future release. Transparent proxies require
+ though it may be added in a future release. Transparent proxies require
special handling of the request headers beyond what
<SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> is now capable of.</P
+> is now capable of. </P
><P
> Chaining <SPAN
CLASS="APPLICATION"
TARGET="_top"
>User Manual</A
>. As
- a transparent proxy to be used for chaining we recommend Transproxy
+ a transparent proxy to be used for chaining we suggest Transproxy
(<A
HREF="http://transproxy.sourceforge.net/"
TARGET="_top"
><A
NAME="OUTLOOK"
></A
->3.19. How can I configure Privoxy for use with Outlook
+>3.20. How can I configure Privoxy for use with Outlook
Express?</H3
><P
> <SPAN
><A
NAME="OUTLOOK-MORE"
></A
->3.20. How can I have separate rules just for HTML mail?</H3
+>3.21. How can I have separate rules just for HTML mail?</H3
><P
> The short answer is, you can't. <SPAN
CLASS="APPLICATION"
><A
NAME="SNEAKY-COOKIES"
></A
->3.21. I sometimes notice cookies sneaking through. How?</H3
+>3.22. I sometimes notice cookies sneaking through. How?</H3
><P
> <A
HREF="http://en.wikipedia.org/wiki/Browser_cookie"
><A
NAME="EVIL-COOKIES"
></A
->3.22. Are all cookies bad? Why?</H3
+>3.23. Are all cookies bad? Why?</H3
><P
> No, in fact there are many beneficial uses of
<A
><A
NAME="ALLOW-COOKIES"
></A
->3.23. How can I allow permanent cookies for my trusted sites?</H3
+>3.24. How can I allow permanent cookies for my trusted sites?</H3
><P
> There are several actions that relate to cookies. The default behavior is to
allow only <SPAN
><A
NAME="MULTIPLES"
></A
->3.24. Can I have separate configurations for different users?</H3
+>3.25. Can I have separate configurations for different users?</H3
><P
> Each instance of <SPAN
CLASS="APPLICATION"
CLASS="APPLICATION"
>Privoxy</SPAN
>, each with
- a unique <TT
-CLASS="LITERAL"
->listen-address</TT
-> and configuration path, and then
+ a unique
+ <A
+HREF="../user-manual/config.html#LISTEN-ADDRESS"
+TARGET="_top"
+>listen-address</A
+>
+ configuration setting, and configuration path, and then
each of these can have their own configurations. Think of it as per-port
configuration.</P
><P
><A
NAME="WHITELISTS"
></A
->3.25. Can I set-up Privoxy as a whitelist of
+>3.26. Can I set-up Privoxy as a whitelist of
<SPAN
CLASS="QUOTE"
>"good"</SPAN
> sites?</H3
><P
-> Sure. There are a couple of things you can do for simple whitelisting.
+> Sure. There are a couple of things you can do for simple white-listing.
Here's one real easy one:</P
><TABLE
BORDER="0"
><A
NAME="NO-ADBLOCK"
></A
->3.26. How can I turn off ad-blocking?</H3
+>3.27. How can I turn off ad-blocking?</H3
><P
-> Ad blocking is hard-coded into the default configuration files. It has been
- assumed that everyone using <SPAN
+> Ad blocking is achieved through a complex application of various <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>
+ <A
+HREF="../user-manual/actions-file.html"
+TARGET="_top"
+>actions</A
+>. These
+ actions are deployed against simple images, banners, flash animations,
+ text pages, JavaScript, pop-ups and pop-unders, etc., so its not as simple as
+ just turning one or two actions off. The various actions that make up
+ <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> is interested in this feature. If you want
- to do without this, there are several approaches you can take: You can
- manually undo the many block rules in <TT
+> ad blocking are hard-coded into the default configuration files. It
+ has been assumed that everyone using <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> is interested in this
+ particular feature.
+ </P
+><P
+> If you want to do without this, there are several approaches you can take:
+ You can manually undo the many block rules in
+ <TT
CLASS="FILENAME"
>default.action</TT
->. Or
- even easier, just create your own <TT
+>. Or even easier, just create your own
+ <TT
CLASS="FILENAME"
>default.action</TT
-> file
- from scratch without the many ad blocking rules, and corresponding exceptions.
- Or lastly, if you are not concerned about the additional blocks that are
- done for privacy reasons, you can very easily over-ride
- <SPAN
+> file from scratch without the many ad
+ blocking rules, and corresponding exceptions. Or lastly, if you are not
+ concerned about the additional blocks that are done for privacy reasons, you
+ can very easily over-ride <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>all</I
></SPAN
-> blocking with the following very simple rule in
- <TT
+> blocking with the
+ following very simple rule in your <TT
CLASS="FILENAME"
>user.action</TT
>:
TARGET="_top"
>-block</A
> }
- / # UN-Block *all* URLs
- </PRE
+ / # UN-Block *all* URLs</PRE
></TD
></TR
></TABLE
>-filter{banners-by-size}</A
> \
<A
-HREF="../user-manual/actions-file.html#FILTER-BANNERS-BY-SIZE"
+HREF="../user-manual/actions-file.html#FILTER-BANNERS-BY-LINK"
TARGET="_top"
>-filter{banners-by-link}</A
> \
>allow-popups</TT
> \
}
- / # UN-Block *all* URLs and allow ads
- </PRE
+ / # UN-Block *all* URLs and allow ads</PRE
></TD
></TR
></TABLE
><A
NAME="TEMPLATES"
></A
->3.27. How can I have custom template pages, like the
+>3.28. How can I have custom template pages, like the
<SPAN
CLASS="emphasis"
><I
></SPAN
> page?</H3
><P
-> All the template pages are installed in a sub-directory appropriately named:
- <TT
-CLASS="FILENAME"
->templates</TT
->. These are specialized text files utilized
- by <SPAN
+> <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> <SPAN
+CLASS="QUOTE"
+>"templates"</SPAN
+> are specialized text files utilized by
+ <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> and can easily be modified using any text editor. Knowing something
- about HTML will of course be helpful. You cannot rename any of these files,
- or create completely new templates, that is not possible. But you can change
- the page content to whatever you like. Be forewarned that these files are
- subject to being overwritten during upgrades, so be sure to save any
- customizations.</P
+> for various purposes and can easily be modified using any text
+ editor. All the template pages are installed in a sub-directory appropriately
+ named: <TT
+CLASS="FILENAME"
+>templates</TT
+>. Knowing something about HTML syntax
+ will of course be helpful. You cannot rename any of these files, or create
+ completely new templates, that is not possible. But you can change the page
+ content to whatever you like. Be forewarned that these files are subject to
+ being overwritten during upgrades, so be sure to save any customizations.</P
></DIV
><DIV
CLASS="SECT2"
><A
NAME="BLOCKALL"
></A
->3.28. How can I remove the <SPAN
+>3.29. How can I remove the <SPAN
CLASS="QUOTE"
>"Go There Anyway"</SPAN
> link from
></SPAN
> page?</H3
><P
-> Editing the template page (see above) may dissuade some users, but this
- method is easily circumvented. Where you want this level of control, you should
- build <SPAN
+> Editing the BLOCKED template page (see above) may dissuade some users, but
+ this method is easily circumvented. Where you need this level of control, you
+ should build <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> from source, and enable various features that are
- available as compile-time options. You should use
+> from source, and enable various features that are
+ available as compile-time options. You should
<B
CLASS="COMMAND"
>configure</B
-> as follows:</P
+> the sources as follows:</P
><P
> <TABLE
BORDER="0"
><TD
><PRE
CLASS="SCREEN"
-> ./configure --disable-toggle --disable-editor --disable-force
- </PRE
+> ./configure --disable-toggle --disable-editor --disable-force</PRE
></TD
></TR
></TABLE
<SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> does not allow easy bypassing of blocks or changing the current
- configuration. Some of these features can also by toggled on/off via options
- in <SPAN
+> does not allow easy bypassing of blocked sites, or changing the
+ current configuration via any connected user's web browser. Some of these
+ features can also be toggled on/off via options in
+ <SPAN
CLASS="APPLICATION"
>Privoxy's</SPAN
> main
CLASS="APPLICATION"
>Windows
XP SP2</SPAN
->), if you are using some kind of Unix flavour,
+>), if you are using a Unix flavor,
sending the output of <SPAN
CLASS="QUOTE"
>"uname -a"</SPAN
><H2
CLASS="SECT2"
><A
-NAME="AEN1320"
+NAME="AEN1373"
></A
>7.1. License</H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN1336"
+NAME="AEN1389"
></A
>7.2. History</H2
><P
it is in a perfect position to filter outbound personal information that your
browser is leaking, as well as inbound junk. It uses a variety of techniques to do
this, all of which are under your complete control via the various configuration
- files and options.
+ files and options. Being a proxy also makes it easier to share
+ configurations among multiple browsers and/or users.
</P
></DIV
><DIV
><H3
CLASS="SECT2"
><A
+NAME="OTHERSTUFF"
+></A
+>1.4. Does Privoxy do anything more than ad blocking?</H3
+><P
+>
+ Yes, ad blocking is but one possible use. There are many, many ways <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>
+ can be used to sanitize and customize web browsing. </P
+></DIV
+><DIV
+CLASS="SECT2"
+><H3
+CLASS="SECT2"
+><A
NAME="NEWJB"
></A
->1.4. What is this new version of
+>1.5. What is this new version of
<SPAN
CLASS="QUOTE"
>"Junkbuster"</SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN74"
+NAME="AEN78"
></A
->1.5. Why <SPAN
+>1.6. Why <SPAN
CLASS="QUOTE"
>"Privoxy"</SPAN
>? Why change the name from
Junkbuster at all?</H3
><P
-> <A
HREF="http://junkbusters.com/"
TARGET="_top"
>Junkbusters Corporation</A
>-derived software under the same name
led to confusion.</P
><P
-> There are also potential legal complications from the continued use of the
+> There are also potential legal complications from our use of the
<SPAN
CLASS="APPLICATION"
>Junkbuster</SPAN
><A
NAME="DIFFERS"
></A
->1.6. How does Privoxy differ
+>1.7. How does Privoxy differ
from the old Junkbuster?</H3
><P
> <SPAN
></LI
><LI
><P
-> Web page content filtering (removes banners based on size,
+> Web page filtering (text replacements, removes banners based on size,
invisible <SPAN
CLASS="QUOTE"
>"web-bugs"</SPAN
->, JavaScript and HTML annoyances, pop-up windows, etc.)
+>, JavaScript and HTML annoyances,
+ pop-up windows, header manipulation, etc.)
</P
></LI
><LI
><A
NAME="WHATSANAD"
></A
->1.7. How does Privoxy know what is
+>1.8. How does Privoxy know what is
an ad, and what is not?</H3
><P
> <SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN155"
+NAME="AEN159"
></A
->1.8. Can Privoxy make mistakes?
+>1.9. Can Privoxy make mistakes?
This does not sound very scientific.</H3
><P
> Actually, it's a black art ;-) And yes, it is always possible to have a broad
><H3
CLASS="SECT2"
><A
-NAME="AEN161"
+NAME="AEN165"
></A
->1.9. Will I have to configure Privoxy
+>1.10. Will I have to configure Privoxy
before I can use it?</H3
><P
> No, not really. The default installation should give you a good starting
CLASS="EMPHASIS"
>most</I
></SPAN
-> unwanted content.</P
+> ads and unwanted content. Many of
+ the more advanced features are off by default, and would require you to
+ activate them. </P
+><P
+> You do have to set up your browser to use
+ <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> (see the <A
+HREF="installation.html#FIRSTSTEP"
+>Installation section below</A
+>). </P
><P
-> But you will certainly run into situations where there are false positives,
+> And you will certainly run into situations where there are false positives,
or ads not being blocked that you may not want to see. In these cases, you
would certainly benefit by customizing <SPAN
CLASS="APPLICATION"
CLASS="APPLICATION"
>Privoxy</SPAN
> lies!</P
+></DIV
+><DIV
+CLASS="SECT2"
+><H3
+CLASS="SECT2"
+><A
+NAME="LAN"
+></A
+>1.11. Can Privoxy run as a server on a network?</H3
><P
-> You will have to tell your browser about <SPAN
+>
+ Yes, <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
->
- (see the Installation section below).</P
+> runs as a server already, and can easily be configured to
+ <SPAN
+CLASS="QUOTE"
+>"serve"</SPAN
+> more than one client. See <A
+HREF="configuration.html#LANCONFIG"
+> How can I set up Privoxy to act as a proxy for my LAN</A
+> below.</P
></DIV
><DIV
CLASS="SECT2"
><A
NAME="BROWSERS2"
></A
->1.10. My browser does the same things as
-Privoxy. Why should I use
-Privoxy at all?</H3
+>1.12. My browser does the same things as
+Privoxy. Why should I use Privoxy at all?</H3
><P
> Modern browsers do indeed have <SPAN
CLASS="emphasis"
</P
><P
> In addition, a proxy is good choice if you use multiple browsers, or
- have a LAN with multiple computers. This way all the configuration
- is in one place, and you don't have to maintain a similar configuration
- for possibly many browsers.
+ have a LAN with multiple computers since <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> can run as a server
+ application. This way all the configuration is in one place, and you don't
+ have to maintain a similar configuration for possibly many browsers or
+ users.
</P
></DIV
><DIV
><A
NAME="WHYTRUST"
></A
->1.11. Why should I trust Privoxy?</H3
+>1.13. Why should I trust Privoxy?</H3
><P
> The most important reason is because you have access to
<SPAN
><A
NAME="LICENSE"
></A
->1.12. Is there is a license or fee? What about a
+>1.14. Is there is a license or fee? What about a
warranty? Registration?</H3
><P
> <SPAN
><A
NAME="SPYWARE"
></A
->1.13. Can Privoxy remove spyware? Adware? Viruses?</H3
+>1.15. Can Privoxy remove spyware? Adware? Viruses?</H3
><P
> No. <SPAN
CLASS="APPLICATION"
preventative. <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> can help prevent contact from sites
- that use such tactics with approriate configuration rules, and thus could
- conceivably prevent contamination from such sites.</P
+> can help prevent contact from sites that use such
+ tactics with appropriate configuration rules, and thus could conceivably
+ prevent contamination from such sites.</P
></DIV
><DIV
CLASS="SECT2"
><A
NAME="OTHERADS"
></A
->1.14. Can I use Privoxy with other ad-blocking software?</H3
+>1.16. Can I use Privoxy with other ad-blocking software?</H3
><P
> <SPAN
CLASS="APPLICATION"
><A
NAME="JOINTEAM"
></A
->1.15. I would like to help you, what can I do?</H3
+>1.17. I would like to help you, what can I do?</H3
><DIV
CLASS="SECT3"
><H4
><A
NAME="JOINTEAM-WORK"
></A
->1.15.1. Would you like to participate?</H4
+>1.17.1. Would you like to participate?</H4
><P
> Well, we <SPAN
CLASS="emphasis"
>Developer's Manual</A
>, at least
the pertinent sections.</P
-><P
-> Once we have added you to the team, you'll have access to the <A
-HREF="http://sourceforge.net/cvs/?group_id=11118"
-TARGET="_top"
->CVS repository</A
->, and
- together we'll find a suitable task for you.</P
></DIV
><DIV
CLASS="SECT3"
><A
NAME="JOINTEAM-MONEY"
></A
->1.15.2. Contribute!</H4
+>1.17.2. Contribute!</H4
><P
> We, of course, welcome donations and could use money for domain registering,
buying software to test <SPAN
><A
NAME="JOINTEAM-SOFTWARE"
></A
->1.15.3. Software</H4
+>1.17.3. Software</H4
><P
> If you are a vendor of a web-related software like a browser, web server
or proxy, and would like us to ensure that <SPAN
><BR></P
><P
CLASS="PUBDATE"
->$Id: faq.sgml,v 2.21 2006/10/03 14:40:51 fabiankeil Exp $<BR></P
+>$Id: faq.sgml,v 2.23 2006/10/21 22:19:52 hal9 Exp $<BR></P
><DIV
><DIV
CLASS="ABSTRACT"
> Privoxy is based on Internet Junkbuster (tm).</P
><P
> Please note that this document is a work in progress. This copy represents
- the state at the release of version 3.0.5.
+ the state at the release of version 3.0.6.
You can find the latest version of the document at <A
HREF="http://www.privoxy.org/faq/"
TARGET="_top"
></DT
><DT
>1.4. <A
+HREF="general.html#OTHERSTUFF"
+>Does Privoxy do anything more than ad blocking?</A
+></DT
+><DT
+>1.5. <A
HREF="general.html#NEWJB"
>What is this new version of
<SPAN
>?</A
></DT
><DT
-HREF="general.html#AEN74"
+HREF="general.html#AEN78"
>Why <SPAN
CLASS="QUOTE"
>"Privoxy"</SPAN
Junkbuster at all?</A
></DT
><DT
HREF="general.html#DIFFERS"
>How does Privoxy differ
from the old Junkbuster?</A
></DT
><DT
HREF="general.html#WHATSANAD"
>How does Privoxy know what is
an ad, and what is not?</A
></DT
><DT
-HREF="general.html#AEN155"
+HREF="general.html#AEN159"
>Can Privoxy make mistakes?
This does not sound very scientific.</A
></DT
><DT
-HREF="general.html#AEN161"
+HREF="general.html#AEN165"
>Will I have to configure Privoxy
before I can use it?</A
></DT
><DT
->1.10. <A
+>1.11. <A
+HREF="general.html#LAN"
+>Can Privoxy run as a server on a network?</A
+></DT
+><DT
+>1.12. <A
HREF="general.html#BROWSERS2"
>My browser does the same things as
-Privoxy. Why should I use
-Privoxy at all?</A
+Privoxy. Why should I use Privoxy at all?</A
></DT
><DT
HREF="general.html#WHYTRUST"
>Why should I trust Privoxy?</A
></DT
><DT
HREF="general.html#LICENSE"
>Is there is a license or fee? What about a
warranty? Registration?</A
></DT
><DT
HREF="general.html#SPYWARE"
>Can Privoxy remove spyware? Adware? Viruses?</A
></DT
><DT
HREF="general.html#OTHERADS"
>Can I use Privoxy with other ad-blocking software?</A
></DT
><DT
HREF="general.html#JOINTEAM"
>I would like to help you, what can I do?</A
></DT
><DD
><DL
><DT
HREF="general.html#JOINTEAM-WORK"
>Would you like to participate?</A
></DT
><DT
HREF="general.html#JOINTEAM-MONEY"
>Contribute!</A
></DT
><DT
HREF="general.html#JOINTEAM-SOFTWARE"
>Software</A
></DT
></DT
><DT
>2.5. <A
-HREF="installation.html#AEN263"
+HREF="installation.html#FIRSTSTEP"
>I just installed Privoxy. Is there anything
special I have to do now?</A
></DT
><DL
><DT
>3.1. <A
-HREF="configuration.html#AEN339"
+HREF="configuration.html#AEN351"
>What exactly is an <SPAN
CLASS="QUOTE"
>"actions"</SPAN
></DT
><DT
>3.3. <A
-HREF="configuration.html#AEN362"
+HREF="configuration.html#AEN374"
>How are actions files configured? What is the easiest
way to do this?</A
></DT
><DT
>3.4. <A
-HREF="configuration.html#AEN370"
+HREF="configuration.html#AEN382"
>There are several different <SPAN
CLASS="QUOTE"
>"actions"</SPAN
></DT
><DT
>3.7. <A
+HREF="configuration.html#DIFFICULT"
+>Why is the configuration so complicated?</A
+></DT
+><DT
+>3.8. <A
HREF="configuration.html#YAHOO"
>How can I make my Yahoo/Hotmail/Gmail account work?</A
></DT
><DT
HREF="configuration.html#CONFIGFILES"
>What's the difference between the
<SPAN
> defaults?</A
></DT
><DT
HREF="configuration.html#BROWSECONFIG"
>Why can I change the configuration
with a browser? Does that not raise security issues?</A
></DT
><DT
-HREF="configuration.html#AEN470"
+HREF="configuration.html#AEN488"
>What is the <TT
CLASS="FILENAME"
>default.filter</TT
>?</A
></DT
><DT
-HREF="configuration.html#AEN488"
+HREF="configuration.html#LANCONFIG"
>How can I set up Privoxy to act as a proxy for my
LAN?</A
></DT
><DT
-HREF="configuration.html#AEN513"
+HREF="configuration.html#AEN531"
>Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</A
></DT
><DT
-HREF="configuration.html#AEN530"
+HREF="configuration.html#AEN548"
>Why would anybody want to see a checkerboard pattern?</A
></DT
><DT
-HREF="configuration.html#AEN536"
+HREF="configuration.html#AEN554"
>I see some images being replaced by a text
instead of the checkerboard image. Why and how do I get rid of this?</A
></DT
><DT
HREF="configuration.html#SRVANY"
>Can Privoxy run as a service
on Win2K/NT/XP?</A
></DT
><DT
HREF="configuration.html#OTHERPROXY"
>How can I make Privoxy work with other
proxies like Squid or Tor?</A
></DT
><DT
HREF="configuration.html#PORT-80"
>Can I just set Privoxy to use port 80
and thus avoid individual browser configuration?</A
></DT
><DT
HREF="configuration.html#TRANSPARENT"
>Can Privoxy run as a <SPAN
CLASS="QUOTE"
> proxy?</A
></DT
><DT
HREF="configuration.html#OUTLOOK"
>How can I configure Privoxy for use with Outlook
Express?</A
></DT
><DT
HREF="configuration.html#OUTLOOK-MORE"
>How can I have separate rules just for HTML mail?</A
></DT
><DT
HREF="configuration.html#SNEAKY-COOKIES"
>I sometimes notice cookies sneaking through. How?</A
></DT
><DT
HREF="configuration.html#EVIL-COOKIES"
>Are all cookies bad? Why?</A
></DT
><DT
HREF="configuration.html#ALLOW-COOKIES"
>How can I allow permanent cookies for my trusted sites?</A
></DT
><DT
HREF="configuration.html#MULTIPLES"
>Can I have separate configurations for different users?</A
></DT
><DT
HREF="configuration.html#WHITELISTS"
>Can I set-up Privoxy as a whitelist of
<SPAN
> sites?</A
></DT
><DT
HREF="configuration.html#NO-ADBLOCK"
>How can I turn off ad-blocking?</A
></DT
><DT
HREF="configuration.html#TEMPLATES"
>How can I have custom template pages, like the
<SPAN
> page?</A
></DT
><DT
HREF="configuration.html#BLOCKALL"
>How can I remove the <SPAN
CLASS="QUOTE"
><DL
><DT
>4.1. <A
-HREF="misc.html#AEN688"
+HREF="misc.html#AEN712"
>How much does Privoxy slow my browsing down? This
has to add extra time to browsing.</A
></DT
></DT
><DT
>4.8. <A
-HREF="misc.html#AEN760"
+HREF="misc.html#AEN784"
>Can Privoxy guarantee I am anonymous?</A
></DT
><DT
>4.9. <A
-HREF="misc.html#AEN778"
+HREF="misc.html#AEN802"
>A test site says I am not using a Proxy.</A
></DT
><DT
></DT
><DT
>4.11. <A
-HREF="misc.html#AEN835"
+HREF="misc.html#AEN859"
>Might some things break because header information or
content is being altered?</A
></DT
><DT
>4.12. <A
-HREF="misc.html#AEN849"
+HREF="misc.html#AEN873"
>Can Privoxy act as a <SPAN
CLASS="QUOTE"
>"caching"</SPAN
></DT
><DT
>4.13. <A
-HREF="misc.html#AEN858"
+HREF="misc.html#AEN882"
>What about as a firewall? Can Privoxy protect me?</A
></DT
><DT
>4.14. <A
-HREF="misc.html#AEN863"
+HREF="misc.html#AEN887"
>I have large empty spaces / a checkerboard pattern now where
ads used to be. Why?</A
></DT
><DT
>4.15. <A
-HREF="misc.html#AEN868"
+HREF="misc.html#AEN895"
>How can Privoxy filter Secure (HTTPS) URLs?</A
></DT
><DT
>4.16. <A
-HREF="misc.html#AEN882"
+HREF="misc.html#AEN909"
>Privoxy runs as a <SPAN
CLASS="QUOTE"
>"server"</SPAN
></DT
><DT
>4.19. <A
+HREF="misc.html#TURNOFF2"
+>How can I tell Privoxy to totally ignore certain sites?</A
+></DT
+><DT
+>4.20. <A
HREF="misc.html#CRUNCH"
>My logs show Privoxy <SPAN
CLASS="QUOTE"
>?</A
></DT
><DT
HREF="misc.html#DOWNLOADS"
>Can Privoxy effect files that I download
from a webserver? FTP server?</A
></DT
><DT
HREF="misc.html#DOWNLOADS2"
>I just downloaded a Perl script, and Privoxy
altered it! Yikes, what is wrong!</A
></DT
><DT
HREF="misc.html#HOSTSFILE"
>Should I continue to use a <SPAN
CLASS="QUOTE"
> file for ad-blocking?</A
></DT
><DT
HREF="misc.html#SEEALSO"
>Where can I find more information about Privoxy
and related issues?</A
></DT
><DT
HREF="misc.html#MICROSUCK"
>I've noticed that Privoxy changes <SPAN
CLASS="QUOTE"
><DL
><DT
>5.1. <A
-HREF="trouble.html#AEN1031"
+HREF="trouble.html#AEN1062"
>I cannot connect to any websites. Or, I am getting
<SPAN
CLASS="QUOTE"
></DT
><DT
>5.2. <A
-HREF="trouble.html#AEN1050"
+HREF="trouble.html#ERROR503"
+>Why am I getting a 503 Error (WSAECONNREFUSED) on every page?</A
+></DT
+><DT
+>5.3. <A
+HREF="trouble.html#AEN1085"
>I just added a new rule, but the steenkin ad is
still getting through. How?</A
></DT
><DT
HREF="trouble.html#BADSITE"
>One of my favorite sites does not work with Privoxy.
What can I do?</A
></DT
><DT
HREF="trouble.html#DUN"
>After installing Privoxy, I have to log in
every time I start IE. What gives?</A
></DT
><DT
HREF="trouble.html#FTP"
>I cannot connect to any FTP sites. Privoxy
is blocking me.</A
></DT
><DT
HREF="trouble.html#OSXIE"
>In Mac OSX, I can't configure Microsoft Internet Explorer to use
Privoxy as the HTTP proxy.</A
></DT
><DT
HREF="trouble.html#OSXUNINSTALL"
>In Mac OSX, I dragged the Privoxy folder to the trash in order to
uninstall it. Now the finder tells me I don't have sufficient privileges to
empty the trash.</A
></DT
><DT
HREF="trouble.html#OSXIMAGES"
>In Mac OSX Panther (10.3), images often fail to load and/or I
experience random delays in page loading. I'm using
> as my browser's proxy setting.</A
></DT
><DT
HREF="trouble.html#BLANKPAGE"
>I get a completely blank page at one site. <SPAN
CLASS="QUOTE"
Privoxy the page loads fine.</A
></DT
><DT
->5.10. <A
-HREF="trouble.html#ERROR503"
->Why am I getting a 503 Error (WSAECONNREFUSED) on every page?</A
-></DT
-><DT
>5.11. <A
HREF="trouble.html#NOHOSTNAME"
>My logs show many <SPAN
>I just installed Privoxy, and all my
browsing has slowed to a crawl. What gives?</A
></DT
+><DT
+>5.20. <A
+HREF="trouble.html#PREVENTCOMP"
+>Why do my filters work on some sites but not on others?</A
+></DT
></DL
></DD
><DT
><DL
><DT
>7.1. <A
-HREF="copyright.html#AEN1320"
+HREF="copyright.html#AEN1373"
>License</A
></DT
><DT
>7.2. <A
-HREF="copyright.html#AEN1336"
+HREF="copyright.html#AEN1389"
>History</A
></DT
></DL
><H3
CLASS="SECT2"
><A
-NAME="AEN263"
+NAME="FIRSTSTEP"
></A
>2.5. I just installed Privoxy. Is there anything
special I have to do now?</H3
>Privoxy</SPAN
>
as a proxy by specifying the correct proxy address and port number
- in the appropriate configuration area for the browser. See below.
- You should also flush your browser's memory and disk cache to get rid of any
+ in the appropriate configuration area for the browser. See
+ <A
+HREF="../user-manual/startup.html"
+TARGET="_top"
+>the User Manual for more
+ details</A
+>. You should also flush your browser's memory and disk cache to get rid of any
cached junk items, and remove any stored
<A
HREF="http://en.wikipedia.org/wiki/Browser_cookie"
CLASS="APPLICATION"
>Privoxy</SPAN
>
- is running, or the equivalent hostname. Port assignment would be
- same as above. Note that <SPAN
+ is running, or the equivalent hostname, e.g. <TT
+CLASS="LITERAL"
+>192.168.1.1</TT
+>.
+ Port assignment would be same as above. Note that
+ <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> doesn't
- listen on any LAN interfaces by default.
+> doesn't listen on any LAN interfaces by
+ default.
</P
><P
> <SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN688"
+NAME="AEN712"
></A
>4.1. How much does Privoxy slow my browsing down? This
has to add extra time to browsing.</H3
>Privoxy</SPAN
>, http://example.com/show-proxy-args and http://i.j.b/,
are no longer supported. If you still use such an old version, you should really consider
- upgrading to 3.0.5.</P
+ upgrading to 3.0.6.</P
></DIV
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="AEN760"
+NAME="AEN784"
></A
>4.8. Can Privoxy guarantee I am anonymous?</H3
><P
><H3
CLASS="SECT2"
><A
-NAME="AEN778"
+NAME="AEN802"
></A
>4.9. A test site says I am not using a Proxy.</H3
><P
>Tor</SPAN
>.</P
><P
-> Afterwards, please take the time to at least skim through the rest
+> Afterward, please take the time to at least skim through the rest
of <SPAN
CLASS="APPLICATION"
>Tor's</SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN835"
+NAME="AEN859"
></A
>4.11. Might some things break because header information or
content is being altered?</H3
><H3
CLASS="SECT2"
><A
-NAME="AEN849"
+NAME="AEN873"
></A
>4.12. Can Privoxy act as a <SPAN
CLASS="QUOTE"
><H3
CLASS="SECT2"
><A
-NAME="AEN858"
+NAME="AEN882"
></A
>4.13. What about as a firewall? Can Privoxy protect me?</H3
><P
><H3
CLASS="SECT2"
><A
-NAME="AEN863"
+NAME="AEN887"
></A
>4.14. I have large empty spaces / a checkerboard pattern now where
ads used to be. Why?</H3
><P
-> It would be technically possible eliminate the banners in a way that frees
- their screen estate in many cases, by doing all banner blocking with filters,
- i.e. eliminating the whole image references from the HTML pages instead
- of letting them stay in, and blocking the resulting requests for the
- banners themselves.</P
-><P
-> But this would consume considerable CPU resources, would likely destroy
- the layout of many web pages which rely on the banners consuming a certain
- amount of screen space, and would fail in other cases, where the screen space
- is reserved e.g. by tables anyway. Also, making the banners disappear without
- a visual trace complicates troubleshooting.</P
-><P
-> So we won't support this in the default configuration, but you can of course
- define appropriate filters yourself.</P
+> It is technically possible to eliminate banners and ads in a way that frees
+ their allocated page space. This could easily be done by blocking with
+ <SPAN
+CLASS="APPLICATION"
+>Privoxy's</SPAN
+> filters,
+ and eliminating the <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>entire</I
+></SPAN
+> image references from the
+ HTML page source. </P
+><P
+> But, this would consume considerably more CPU resources (IOW, slow things
+ down), would likely destroy the layout of some web pages which rely on the
+ banners utilizing a certain amount of page space, and might fail in other
+ cases, where the screen space is reserved (e.g. by HTML tables for instance).
+ Also, making ads and banners disappear without any trace complicates
+ troubleshooting, and would sooner or later be problematic.</P
+><P
+> The better alternative is to instead let them stay, and block the resulting
+ requests for the banners themselves as is now the case. This leaves either
+ empty space, or the familiar checkerboard pattern.</P
+><P
+> So the developers won't support this in the default configuration, but you
+ can of course define appropriate filters yourself to achieve this.</P
></DIV
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="AEN868"
+NAME="AEN895"
></A
>4.15. How can Privoxy filter Secure (HTTPS) URLs?</H3
><P
><H3
CLASS="SECT2"
><A
-NAME="AEN882"
+NAME="AEN909"
></A
>4.16. Privoxy runs as a <SPAN
CLASS="QUOTE"
CLASS="QUOTE"
>"middle-man"</SPAN
> in
- the interaction between your browser and web sites.</P
+ the interaction between your browser and web sites. See below to bypass
+ the proxy.</P
+></DIV
+><DIV
+CLASS="SECT2"
+><H3
+CLASS="SECT2"
+><A
+NAME="TURNOFF2"
+></A
+>4.19. How can I tell Privoxy to totally ignore certain sites?</H3
+><P
+> Bypassing a proxy, or proxying based on arbitrary criteria, is purely a browser
+ configuration issue, not a <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> issue. Modern browsers typically do have
+ settings for not proxying certain sites. Check your browser's help files.</P
></DIV
><DIV
CLASS="SECT2"
><A
NAME="CRUNCH"
></A
->4.19. My logs show Privoxy <SPAN
+>4.20. My logs show Privoxy <SPAN
CLASS="QUOTE"
>"crunches"</SPAN
>
><A
NAME="DOWNLOADS"
></A
->4.20. Can Privoxy effect files that I download
+>4.21. Can Privoxy effect files that I download
from a webserver? FTP server?</H3
><P
> From the webserver's perspective, there is no difference between
><A
NAME="DOWNLOADS2"
></A
->4.21. I just downloaded a Perl script, and Privoxy
+>4.22. I just downloaded a Perl script, and Privoxy
altered it! Yikes, what is wrong!</H3
><P
> Please read above.</P
><A
NAME="HOSTSFILE"
></A
->4.22. Should I continue to use a <SPAN
+>4.23. Should I continue to use a <SPAN
CLASS="QUOTE"
>"HOSTS"</SPAN
> file for ad-blocking?</H3
><A
NAME="SEEALSO"
></A
->4.23. Where can I find more information about Privoxy
+>4.24. Where can I find more information about Privoxy
and related issues?</H3
><P
> Other references and sites of interest to <SPAN
><A
NAME="MICROSUCK"
></A
->4.24. I've noticed that Privoxy changes <SPAN
+>4.25. I've noticed that Privoxy changes <SPAN
CLASS="QUOTE"
>"Microsoft"</SPAN
> to
><H3
CLASS="SECT2"
><A
-NAME="AEN1031"
+NAME="AEN1062"
></A
>5.1. I cannot connect to any websites. Or, I am getting
<SPAN
>"connection refused"</SPAN
> message with every web page. Why?</H3
><P
-> Either ... </P
+> There are several possibilities:</P
><P
><P
></P
that <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> is installed correctly, has not died, and is running.</P
+> is installed correctly, has not crashed, and is indeed running.
+ Look at <SPAN
+CLASS="APPLICATION"
+>Privoxy's</SPAN
+> logs to see what they say.</P
></LI
><LI
><P
><LI
><P
> Or you have a firewall that is interfering and blocking you. Solution:
- try disabling or removing the firewall as a test.
+ try disabling or removing the firewall as a simple test.
</P
></LI
></UL
><H3
CLASS="SECT2"
><A
-NAME="AEN1050"
+NAME="ERROR503"
+></A
+>5.2. Why am I getting a 503 Error (WSAECONNREFUSED) on every page?</H3
+><P
+> More than likely this is a problem with your TCP/IP networking. ZoneAlarm has
+ been reported to cause this symptom -- even if not running! The solution is
+ to either fight the ZA configuration, or uninstall ZoneAlarm, and then find
+ something better behaved in its place. Other personal firewall type products
+ may cause similar type problems if not configured correctly.
+ </P
+></DIV
+><DIV
+CLASS="SECT2"
+><H3
+CLASS="SECT2"
+><A
+NAME="AEN1085"
></A
->5.2. I just added a new rule, but the steenkin ad is
+>5.3. I just added a new rule, but the steenkin ad is
still getting through. How?</H3
><P
> If the ad had been displayed before you added its URL, it will probably be
CLASS="APPLICATION"
>Privoxy</SPAN
>
- will not be in the picture. The best thing to do is try flushing the browser's
- caches. And then try again.</P
+ will not be involved. Flush the browser's caches, and then try again.</P
><P
> If this doesn't help, you probably have an error in the rule you
applied. Try pasting the full URL of the offending ad into <A
>http://config.privoxy.org/show-url-info</A
>
and see if it really matches your new rule. Blocking ads is like blocking
- spam: a lot of tinkering is required to stay ahead of the game.</P
+ spam: a lot of tinkering is required to stay ahead of the game. And
+ remember you need to block the URL of the ad in question, which may be
+ entirely different from the site URL itself. Most ads are hosted on different
+ servers than the main site itself. If you right-click on the ad, you should
+ be able to get all the relevant information you need. Alternately, you can
+ find the correct URL by looking at <SPAN
+CLASS="APPLICATION"
+>Privoxy's</SPAN
+> logs.</P
+><P
+> Below is a slightly modified real-life log snippet that originates with one
+ requested URL: <TT
+CLASS="LITERAL"
+>www.example.com</TT
+> (name of site was changed
+ for this example, the number of requests is real). You can see in this the
+ complexity of what goes into making up this one <SPAN
+CLASS="QUOTE"
+>"page"</SPAN
+>. There
+ are eight different domains involved here, with thirty two separate URLs
+ requested in all, making up all manner of images, Shockwave Flash,
+ JavaScript, CSS stylesheets, scripts, and other related content. Some of this
+ content is obviously <SPAN
+CLASS="QUOTE"
+>"good"</SPAN
+> or <SPAN
+CLASS="QUOTE"
+>"bad"</SPAN
+>, but not all.
+ Many of the more questionable looking requests, are going to outside domains
+ that seem to be identifying themselves with suspicious looking names, making
+ our job a little easier. <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> has <SPAN
+CLASS="QUOTE"
+>"crunched"</SPAN
+> (meaning caught
+ and BLOCKED) quite a few items in this example, but perhaps missed a few as well. </P
+><P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>Request: www.example.com/
+Request: www.example.com/favicon.ico
+Request: img.example.com/main.css
+Request: img.example.com/sr.js
+Request: example.betamarker.com/example.html
+Request: www.lik-sang.com/Banners/bestsellers/skyscraper.php?likref=BSellers
+Request: img.example.com/pb.png
+Request: www.google-analytics.com/urchin.js crunch!
+Request: www.advertising-department.com/ats/switch.ps.php?26856 crunch!
+Request: img.example.com/p.gif
+Request: www.popuptraffic.com/assign.php?l=example&mode=behind crunch!
+Request: www.popuptraffic.com/scripts/popup.php?hid=5c3cf&tmpl=PBa.tmpl crunch!
+Request: www.popuptraffic.com/assign.php?l=example crunch!
+Request: www.lik-sang.com/Banners/best_sellers/best_sellers.css
+Request: www.adtrak.net/adx.js crunch!
+Request: img.example.com/hbg.gif
+Request: img.example.com/example.jpg
+Request: img.example.com/mt.png
+Request: img.example.com/mm.png
+Request: img.example.com/mb.png
+Request: www.popuptraffic.com/scripts/popup.php?hid=a71b91fa5&tmpl=Ua.tmp crunch!
+Request: www.example.com/tracker.js
+Request: www.lik-sang.com/Banners/best_sellers/lsi_head.gif
+Request: www.adtrak.net/adjs.php?n=020548130&what=zone:61 crunch!
+Request: www.adtrak.net/adjs.php?n=463594413&what=zone:58&source=Ua crunch!
+Request: www.lik-sang.com/Banners/best_sellers/bottomani.swf
+Request: mmm.elitemediagroup.net/install.php?allowpop=no&popupmincook=0&allowsp2=1 crunch!
+Request: www.example.com/tracker.js?screen=1400x1050&win=962x693
+Request: www.adtrak.net/adlog.php?bannerid=1309&clientid=439&zoneid=61 crunch!
+Request: 66.70.21.80/scripts/click.php?hid=5c3cf599a9efd0320d26&si
+Request: 66.70.21.80/img/pixel.gif
+Request: www.adtrak.net/adlog.php?bannerid=1309&clientid=439&zoneid=58&source=Ua&block=86400 crunch!
+Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua</PRE
+></TD
+></TR
+></TABLE
+></P
+><P
+> Despite 12 out of 32 requests being blocked, the page looked, and seemed to
+ behave perfectly <SPAN
+CLASS="QUOTE"
+>"normal"</SPAN
+> (minus some ads, of course).</P
></DIV
><DIV
CLASS="SECT2"
><A
NAME="BADSITE"
></A
->5.3. One of my favorite sites does not work with Privoxy.
+>5.4. One of my favorite sites does not work with Privoxy.
What can I do?</H3
><P
> First verify that it is indeed a <SPAN
while clicking reload. Alternatively, flush your browser's disk and memory
caches).</P
><P
-> If still a problem, go to <A
+> If the problem went away, we know we have a configuration related problem.
+ Now go to <A
HREF="http://config.privoxy.org/show-url-info"
TARGET="_top"
>http://config.privoxy.org/show-url-info</A
>
- and paste the full URL of the page in question into the prompt. See which actions
- are being applied to the URL, and which matches in which actions files are
- responsible for that. Now, armed with this information, go to <A
+ and paste the full URL of the page in question into the prompt. See which
+ actions are being applied to the URL, and which matches in which actions
+ files are responsible for that. It might be helpful also to look at your logs
+ for this site too, to see what else might be happening. Many sites are
+ complex and require a number of related pages to help present their content.
+ Look at what else might be used by the page in question, and what of that
+ might be <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>required</I
+></SPAN
+>.
+ Now, armed with this information, go to
+ <A
HREF="http://config.privoxy.org/show-status"
TARGET="_top"
>http://config.privoxy.org/show-status</A
>
- and select the appropriate actions files for editing.</P
+ and select the appropriate actions files for editing. </P
><P
> You can now either look for a section which disables the actions that
you suspect to cause the problem and add a pattern for your site there,
>actions tutorial</A
>
with general configuration information and examples.</P
+><P
+> As a last resort, you can always see if your browser has a setting that will
+ bypass the proxy setting for selective sites. Modern browsers can do this.</P
></DIV
><DIV
CLASS="SECT2"
><A
NAME="DUN"
></A
->5.4. After installing Privoxy, I have to log in
+>5.5. After installing Privoxy, I have to log in
every time I start IE. What gives?</H3
><P
> This is a quirk that effects the installation of
><A
NAME="FTP"
></A
->5.5. I cannot connect to any FTP sites. Privoxy
+>5.6. I cannot connect to any FTP sites. Privoxy
is blocking me.</H3
><P
> <SPAN
><A
NAME="OSXIE"
></A
->5.6. In Mac OSX, I can't configure Microsoft Internet Explorer to use
+>5.7. In Mac OSX, I can't configure Microsoft Internet Explorer to use
Privoxy as the HTTP proxy.</H3
><P
> Microsoft Internet Explorer (in versions like 5.1) respects system-wide
><A
NAME="OSXUNINSTALL"
></A
->5.7. In Mac OSX, I dragged the Privoxy folder to the trash in order to
+>5.8. In Mac OSX, I dragged the Privoxy folder to the trash in order to
uninstall it. Now the finder tells me I don't have sufficient privileges to
empty the trash.</H3
><P
><A
NAME="OSXIMAGES"
></A
->5.8. In Mac OSX Panther (10.3), images often fail to load and/or I
+>5.9. In Mac OSX Panther (10.3), images often fail to load and/or I
experience random delays in page loading. I'm using
<TT
CLASS="LITERAL"
><A
NAME="BLANKPAGE"
></A
->5.9. I get a completely blank page at one site. <SPAN
+>5.10. I get a completely blank page at one site. <SPAN
CLASS="QUOTE"
>"View Source"</SPAN
>
><H3
CLASS="SECT2"
><A
-NAME="ERROR503"
-></A
->5.10. Why am I getting a 503 Error (WSAECONNREFUSED) on every page?</H3
-><P
-> More than likely this is a problem with your TCP/IP networking. ZoneAlarm has
- been reported to cause this symptom -- even if not running. The solution is
- to either fight the ZA configuration, or uninstall ZoneAlarm, and then find
- something better behaved in its place. Other personal firewall type products
- may cause similar type problems if not configured correctly.
- </P
-></DIV
-><DIV
-CLASS="SECT2"
-><H3
-CLASS="SECT2"
-><A
NAME="NOHOSTNAME"
></A
>5.11. My logs show many <SPAN
>HOSTS</TT
>
file. If this file has been changed from the original, try reverting it to
- see if that helps. Make sure what ever name(s) are used for the local system,
+ see if that helps. Make sure whatever name(s) are used for the local system,
that they resolve both ways.</P
></DIV
><DIV
> which is reporting whatever problem occurred
downstream, and not the root cause of the error.</P
><P
-> In any case, v. 3.0.5 includes various improvements to help
+> In any case, newer versions include various improvements to help
<SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
firewalls or similar components. Try disabling (or uninstalling) these one
at a time and see if that helps.</P
></DIV
+><DIV
+CLASS="SECT2"
+><H3
+CLASS="SECT2"
+><A
+NAME="PREVENTCOMP"
+></A
+>5.20. Why do my filters work on some sites but not on others?</H3
+><P
+> It's probably due to compression. It is a common practice for web servers to
+ send their content <SPAN
+CLASS="QUOTE"
+>"compressed"</SPAN
+> in order to speed things up, and
+ then let the browser <SPAN
+CLASS="QUOTE"
+>"uncompress"</SPAN
+> them. <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> does not (yet)
+ support compression. But we can force the web server to bend to our will ;-)
+ So for filtering, make sure you have <A
+HREF="../user-manual/actions-file.html#PREVENT-COMPRESSION"
+TARGET="_top"
+>prevent-compression</A
+>
+ turned ON! </P
+></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
> The most recent release is <A
HREF="announce.txt"
TARGET="_top"
->3.0.5 (BETA)</A
+>3.0.6 (stable)</A
>.
</P
><P
<HTML><HEAD><TITLE>Manpage of PRIVOXY</TITLE>
<LINK REL="STYLESHEET" TYPE="text/css" HREF="../p_doc.css"></HEAD><BODY>
<H1>PRIVOXY</H1>
-Section: (1)<BR>Updated:
21 September 2006<BR><A HREF="#index">Index</A>
+Section: (1)<BR>Updated:
13 November 2006<BR><A HREF="#index">Index</A>
<HR>
<A NAME="lbAB"> </A>
+filter{refresh-tags} \
-filter{unsolicited-popups} \
-filter{all-popups} \
-+filter{img-reorder} \
-+filter{banners-by-size} \
+-filter{img-reorder} \
+-filter{banners-by-size} \
-filter{banners-by-link} \
+filter{webbugs} \
-filter{tiny-textforms} \
-filter{crude-parental} \
+filter{ie-exploits} \
-filter{site-specifics} \
+-filter{google} \
+-filter{yahoo} \
+-filter{msn} \
+-filter{blogspot} \
+-filter{xml-to-html} \
+-filter{html-to-xml} \
+-filter{no-ping} \
+-filter{hide-tor-exit-notation} \
-filter-client-headers \
-filter-server-headers \
-force-text-mode \
/ # '/' Match *all* URL patterns
- # Block, and treat these URL patterns as if they were 'images'.
- # We would expect these to be ads.
- { +block-as-image }
- .ad.doubleclick.net
- .a[0-9].yimg.com/(?:(?!/i/).)*$
- ad.*.doubleclick.net
-
# Block all URLs that match these patterns
{ +block }
- ad*.
+ ad.
+ ad[sv].
.*ads.
banner?.
/.*count(er)?\.(pl|cgi|exe|dll|asp|php[34]?)
.hitbox.com
media./.*(ads|banner)
+ # Block, and treat these URL patterns as if they were 'images'.
+ # We would expect these to be ads.
+ { +block-as-image }
+ .ad.doubleclick.net
+ .a[0-9].yimg.com/(?:(?!/i/).)*$
+ ad.*.doubleclick.net
+
# Make exceptions for these harmless ones that would be
# caught by our +block patterns just above.
{ -block }
adsl.
+ adobe.
advice.
.*downloads.
+ # uploads or downloads
+ /.*loads
</PRE>
<P>
<P>
-This is a BETA version of <B>Privoxy</B>. Not
-all features are well tested.
-<P>
-
Please see the <I>User Manual</I> on how to contact the
developers, for feature requests, reporting problems, and other questions.
<A NAME="lbAL"> </A>
Hal Burgiss
Ian Cummings
- Félix Rauch
Roland Rosenfeld
</PRE>
This document was created by
man2html,
using the manual pages.<BR>
-Time: 01:21:32 GMT, September 22, 2006
+Time: 01:57:58 GMT, November 14, 2006
</BODY>
</HTML>
>Privoxy - The Privacy Enhancing Proxy</H1
><H2
CLASS="SUBTITLE"
->Project Index Page v3.0.5</H2
+>Project Index Page v3.0.6</H2
><DIV
><DIV
CLASS="ABSTRACT"
> <TT
CLASS="FILENAME"
>standard.action</TT
-> - is used by the web based editor
+> - is used only by the web based editor
at <A
HREF="http://config.privoxy.org/edit-actions-list?f=default"
TARGET="_top"
>Cautious</SPAN
>
button changes the actions list to low/safe settings which will activate
- a minimal set of <SPAN
+ ad blocking and a minimal set of <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
->'s features, and subsequently there will be
- less of a chance for accidental problems. The <SPAN
+>'s features, and subsequently
+ there will be less of a chance for accidental problems. The
+ <SPAN
CLASS="GUIBUTTON"
>Medium</SPAN
->
- button sets the list to a medium level of ad blocking and a low level set of
- privacy features. The <SPAN
+> button sets the list to a medium level of
+ other features and a low level set of privacy features. The
+ <SPAN
CLASS="GUIBUTTON"
>Advanced</SPAN
-> button
- sets the list to a high level of ad blocking and medium level of
- privacy. See the chart below. The latter three buttons over-ride
- any changes via with the <SPAN
+> button sets the list to a high level of
+ ad blocking and medium level of privacy. See the chart below. The latter
+ three buttons over-ride any changes via with the
+ <SPAN
CLASS="GUIBUTTON"
>Edit</SPAN
-> button. More
- fine-tuning can be done in the lower sections of this internal page.
+> button. More fine-tuning can be done in the
+ lower sections of this internal page.
</P
><P
> It is not recommend to edit the <TT
> <DIV
CLASS="TABLE"
><A
-NAME="AEN1970"
+NAME="AEN2003"
></A
><P
><B
><H2
CLASS="SECT2"
><A
-NAME="AEN2069"
+NAME="AEN2102"
></A
>8.1. Finding the Right Mix</H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN2076"
+NAME="AEN2109"
></A
>8.2. How to Edit</H2
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN2159"
+NAME="AEN2192"
></A
>8.4.1. The Domain Pattern</H3
><P
></DL
></DIV
><P
-> While flexibile, this is not the sophistication of full regular expression based syntax.</P
+> While flexible, this is not the sophistication of full regular expression based syntax.</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
-NAME="AEN2230"
+NAME="AEN2263"
></A
>8.4.2. The Path Pattern</H3
><P
><PRE
CLASS="SCREEN"
># Check if www.example.net/ really uses valid XHTML
-{+content-type-overwrite {application/xml}}
+{ +content-type-overwrite{application/xml} }
www.example.net/
# but leave the content type unmodified if the URL looks like a style sheet
><PRE
CLASS="SCREEN"
># Block the non-existent "Privacy-Violation:" client header
-{+crunch-client-header {Privacy-Violation:}}
+{ +crunch-client-header{Privacy-Violation:} }
/
</PRE
></TD
><PRE
CLASS="SCREEN"
># Let the browser revalidate cached documents without being tracked across sessions
-{+hide-if-modified-since {-60} \
-+overwrite-last-modified {randomize} \
-+crunch-if-none-match}
+{ +hide-if-modified-since{-60} \
+ +overwrite-last-modified{randomize} \
+ +crunch-if-none-match}
/ </PRE
></TD
></TR
><PRE
CLASS="SCREEN"
># Crunch server headers that try to prevent caching
-{+crunch-server-header {no-cache}}
+{ +crunch-server-header{no-cache} }
/ </PRE
></TD
></TR
></TD
></TR
></TABLE
+>
+ </P
+><P
+> <A
+NAME="FILTER-NO-PING"
+></A
+>
+ <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>+filter{no-ping} # Removes non-standard ping attributes from anchor and area tags</PRE
+></TD
+></TR
+></TABLE
+>
+ </P
+><P
+> <A
+NAME="FILTER-HIDE-TOR-EXIT-NOTATION"
+></A
+>
+ <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>+filter{hide-tor-exit-notation} # Header filter to remove the Tor exit node notation in Host and Referer headers</PRE
+></TD
+></TR
+></TABLE
>
</P
></DD
>,
the presence or absence of this mark decides whether an HTML <SPAN
CLASS="QUOTE"
->"blocked"</SPAN
+>"BLOCKED"</SPAN
>
page, or an empty document will be sent to the client as a substitute for the blocked content.
The <SPAN
>Privoxy's</SPAN
>
default HTML page; this option can be used to silence them.
+ And of course this action can also be used to eliminate the <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>
+ BLOCKED message in frames.
</P
><P
> The content type for the empty document can be specified with
><PRE
CLASS="SCREEN"
># Disarm the download link in Sourceforge's patch tracker
-{-filter\
-+content-type-overwrite {text/plain}\
-+hide-content-disposition {block} }
-.sourceforge.net/tracker/download.php</PRE
+{ -filter \
+ +content-type-overwrite{text/plain}\
+ +hide-content-disposition{block} }
+ .sourceforge.net/tracker/download.php</PRE
></TD
></TR
></TABLE
><PRE
CLASS="SCREEN"
># Let the browser revalidate without being tracked across sessions
-{+hide-if-modified-since {-60}\
-+overwrite-last-modified {randomize}\
-+crunch-if-none-match}
+{ +hide-if-modified-since{-60} \
+ +overwrite-last-modified{randomize} \
+ +crunch-if-none-match}
/</PRE
></TD
></TR
><TD
><PRE
CLASS="SCREEN"
-># Set default:
+># Selectively turn off compression, and enable a filter
#
-{+prevent-compression}
-/ # Match all sites
+{ +filter{tiny-textforms} +prevent-compression }
+# Match only these sites
+ .google.
+ sourceforge.net
+ sf.net
-# Make exceptions for ill sites:
+# Or instead, we could set a universal default:
#
-{-prevent-compression}
-www.debianhelp.org
-www.pclinuxonline.com</PRE
+{ +prevent-compression }
+ / # Match all sites
+
+# Then maybe make exceptions for ill-behaved sites:
+#
+{ -prevent-compression }
+ .debianhelp.org
+ www.pclinuxonline.com</PRE
></TD
></TR
></TABLE
><PRE
CLASS="SCREEN"
># Let the browser revalidate without being tracked across sessions
-{+hide-if-modified-since {-60}\
-+overwrite-last-modified {randomize}\
-+crunch-if-none-match}
+{ +hide-if-modified-since{-60} \
+ +overwrite-last-modified{randomize} \
+ +crunch-if-none-match}
/</PRE
></TD
></TR
><H3
CLASS="SECT3"
><A
-NAME="AEN3912"
+NAME="AEN3952"
></A
>8.5.36. Summary</H3
><P
editor honors aliases when reading the actions files, but it expands
them before writing. So the effects of your aliases are of course preserved,
but the aliases themselves are lost when you edit sections that use aliases
- with it.
- This is likely to change in future versions of <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
->.</P
+ with it.</P
><P
> Now let's define some aliases...</P
><P
>crunch-outgoing-cookies</A
>
+block-as-image = +block +handle-as-image
-
mercy-for-cookies = -crunch-all-cookies -<A
+
allow-all-cookies = -crunch-all-cookies -<A
HREF="actions-file.html#SESSION-COOKIES-ONLY"
>session-cookies-only</A
> -<A
> -<A
HREF="actions-file.html#KILL-POPUPS"
>kill-popups</A
+> -<A
+HREF="actions-file.html#PREVENT-COMPRESSION"
+>prevent-compression</A
>
+
shop = -crunch-all-cookies -<A
HREF="actions-file.html#FILTER-ALL-POPUPS"
>filter{all-popups}</A
{fragile}
.office.microsoft.com
.windowsupdate.microsoft.com
- .nytimes.com
+ # Gmail is really mail.google.com, not gmail.com
+ mail.google.com
# Shopping sites:
# Allow cookies (for setting and retrieving your customer data)
{shop}
.quietpc.com
.worldpay.com # for quietpc.com
- .scan.co.uk
+ mybank.example.com
# These shops require pop-ups:
#
- {shop -kill-popups -filter{all-popups}}
+ {-kill-popups -filter{all-popups} -filter{unsolicited-popups}}
.dabs.com
.overclockers.co.uk</PRE
></TD
> and <SPAN
CLASS="QUOTE"
>"fragile"</SPAN
-> are often used for
+> are typically used for
<SPAN
CLASS="QUOTE"
>"problem"</SPAN
-> sites that require some actions to be disabled
+> sites that require more than one action to be disabled
in order to function properly.</P
></DIV
><DIV
><H3
CLASS="SECT3"
><A
-NAME="AEN3977"
+NAME="AEN4017"
></A
>8.7.1. default.action</H3
><P
-<A
HREF="actions-file.html#FILTER-HTML-TO-XML"
>filter-html-to-xml</A
+> \
+ -<A
+HREF="actions-file.html#FILTER-NO-PING"
+>filter-no-ping</A
+> \
+ -<A
+HREF="actions-file.html#FILTER-HIDE-TOR-EXIT-NOTATION"
+>filter-hide-tor-exit-notation</A
> \
-<A
HREF="actions-file.html#FORCE-TEXT-MODE"
><H3
CLASS="SECT3"
><A
-NAME="AEN4164"
+NAME="AEN4206"
></A
>8.7.2. user.action</H3
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN4992"
+NAME="AEN5046"
></A
>14.2. Privoxy's Internal Pages</H2
><P
Privoxy main page:
</P
><A
-NAME="AEN5006"
+NAME="AEN5060"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
editing of actions files:
</P
><A
-NAME="AEN5014"
+NAME="AEN5068"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show the source code version numbers:
</P
><A
-NAME="AEN5019"
+NAME="AEN5073"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show the browser's request headers:
</P
><A
-NAME="AEN5024"
+NAME="AEN5078"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show which actions apply to a URL and why:
</P
><A
-NAME="AEN5029"
+NAME="AEN5083"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
to run, but only as a pass-through proxy, with no actions taking place:
</P
><A
-NAME="AEN5035"
+NAME="AEN5089"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
> Short cuts. Turn off, then on:
</P
><A
-NAME="AEN5039"
+NAME="AEN5093"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
</P
></BLOCKQUOTE
><A
-NAME="AEN5042"
+NAME="AEN5096"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
></A
>14.3. Chain of Events</H2
><P
-> Let's take a quick look at the basic sequence of events when a web page is
- requested by your browser and <SPAN
+> Let's take a quick look at how some of <SPAN
CLASS="APPLICATION"
->Privoxy</SPAN
-> is on duty:</P
+>Privoxy's</SPAN
+>
+ core features are triggered, and the ensuing sequence of events when a web
+ page is requested by your browser:</P
><P
> <P
></P
>"+handle-as-image"</SPAN
></A
>
- is then checked and if it does not match, an
+ and
+ <A
+HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
+><SPAN
+CLASS="QUOTE"
+>"+handle-as-empty-document"</SPAN
+></A
+>
+ are then checked, and if there is no match, an
HTML <SPAN
CLASS="QUOTE"
>"BLOCKED"</SPAN
-> page is sent back. Otherwise, if it does match,
- an image is returned. The type of image depends on the setting of <A
+> page is sent back to the browser. Otherwise, if
+ it does match, an image is returned for the former, and an empty text
+ document for the latter. The type of image would depend on the setting of
+ <A
HREF="actions-file.html#SET-IMAGE-BLOCKER"
><SPAN
CLASS="QUOTE"
></LI
><LI
><P
-> Now the web server starts sending its response back (i.e. typically a web page and related
- data).
+> Now the web server starts sending its response back (i.e. typically a web
+ page).
</P
></LI
><LI
></LI
><LI
><P
-> If a <A
HREF="actions-file.html#FILTER"
><SPAN
CLASS="QUOTE"
>"+filter"</SPAN
></A
->
+> action
or <A
HREF="actions-file.html#DEANIMATE-GIFS"
><SPAN
> back to your browser.
</P
><P
-> If neither <A
HREF="actions-file.html#FILTER"
><SPAN
CLASS="QUOTE"
>"+filter"</SPAN
></A
->
+> action
or <A
HREF="actions-file.html#DEANIMATE-GIFS"
><SPAN
> As the browser receives the now (possibly filtered) page content, it
reads and then requests any URLs that may be embedded within the page
source, e.g. ad images, stylesheets, JavaScript, other HTML documents (e.g.
- frames), sounds, etc. For each of these objects, the browser issues a new
- request. And each such request is in turn processed as above. Note that a
- complex web page may have many such embedded URLs.
+ frames), sounds, etc. For each of these objects, the browser issues a
+ separate request (this is easily viewable in <SPAN
+CLASS="APPLICATION"
+>Privoxy's</SPAN
+>
+ logs). And each such request is in turn processed just as above. Note that a
+ complex web page will have many, many such embedded URLs. If these
+ secondary requests are to a different server, then quite possibly a very
+ differing set of actions is triggered.
</P
></LI
></UL
></P
+><P
+> NOTE: This is somewhat of a simplistic overview of what happens with each URL
+ request. For the sake of brevity and simplicity, we have focused on
+ <SPAN
+CLASS="APPLICATION"
+>Privoxy's</SPAN
+> core features only.</P
></DIV
><DIV
CLASS="SECT2"
-filter {blogspot}
-filter {xml-to-html}
-filter {html-to-xml}
+ -filter {no-ping}
+ -filter{hide-tor-exit-notation}
-filter-client-headers
-filter-server-headers
-force-text-mode
-filter {blogspot}
-filter {xml-to-html}
-filter {html-to-xml}
+ -filter {no-ping}
+ -filter{hide-tor-exit-notation}
-filter-client-headers
-filter-server-headers
-force-text-mode
-filter {blogspot}
-filter {xml-to-html}
-filter {html-to-xml}
+ -filter {no-ping}
+ -filter{hide-tor-exit-notation}
-filter-client-headers
-filter-server-headers
-force-text-mode
>, for local site
exceptions. Note that when a simple domain pattern is used by itself (without
the subsequent path portion), all sub-pages within that domain are included
- automatcially in the scope of the action.</P
+ automatically in the scope of the action.</P
><P
> Images that are inexplicably being blocked, may well be hitting the
<A
><H2
CLASS="SECT2"
><A
-NAME="AEN806"
+NAME="AEN841"
></A
>6.1. Controlling Privoxy with Your Web Browser</H2
><P
> <H2
CLASS="BRIDGEHEAD"
><A
-NAME="AEN814"
+NAME="AEN849"
></A
>Â Â Â Â Privoxy Menu</H2
><P
<SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> executable. The name
- and number of configuration files has changed from previous versions, and is
- subject to change as development progresses.</P
+> executable. </P
><P
> The installed defaults provide a reasonable starting point, though
some settings may be aggressive by some standards. For the time being, the
upgrades. <TT
CLASS="FILENAME"
>standard.action</TT
-> is for
+> is only for
<SPAN
CLASS="APPLICATION"
>Privoxy's</SPAN
>old</I
></SPAN
> listening address.</P
-><P
-> While under development, the configuration content is subject to change.
- The below documentation may not be accurate by the time you read this.
- Also, what constitutes a <SPAN
-CLASS="QUOTE"
->"default"</SPAN
-> setting, may change, so
- please check all your configuration files on important issues.</P
></DIV
></DIV
><DIV
CLASS="APPLICATION"
>Windows
XP SP2</SPAN
->), if you are using some kind of Unix flavour,
+>), if you are using a Unix flavor,
sending the output of <SPAN
CLASS="QUOTE"
>"uname -a"</SPAN
><H2
CLASS="SECT2"
><A
-NAME="AEN4742"
+NAME="AEN4796"
></A
>12.1. License</H2
><P
<br>
Hal Burgiss<br>
Ian Cummings<br>
- Félix Rauch<br>
Roland Rosenfeld</P
><P
> Former Privoxy Team Members:</P
Sarantis Paskalis<br>
Stefan Waldherr</P
><P
-> Thanks to the many people who have tested Privoxy, reported bugs, made
- suggestions or contributed in some way. These include (in alphabetical order):</P
+> Thanks to the many people who have tested Privoxy, reported bugs, provided
+ patches, made suggestions or contributed in some way. These include (in
+ alphabetical order):</P
><P
CLASS="LITERALLAYOUT"
> Ken Arromdee<br>
Reiner Buehl<br>
Andrew J. Caines<br>
Clifford Caoile<br>
+ Frédéric Crozat<br>
Michael T. Davis<br>
Mattes Dolak <br>
- Ulrich Drepper<br>
Peter E<br>
+ Florian Effenberger<br>
+ Dean Gaudet<br>
Aaron Hamid<br>
+ Darel Henman<br>
Magnus Holmgren<br>
+ Derek Jennings<br>
+ David Laight<br>
Don Libes <br>
Paul Lieverse<br>
Jindrich Makovicka <br>
David Mediavilla <br>
+ Raphael Moll<br>
Oliver Stoeneberg<br>
+ Martin Thomas<br>
Roberto Ragusa<br>
+ Félix Rauch<br>
Maynard Riley<br>
+ Spinor S<br>
Bart Schelstraete<br>
Bobby G. Vinyard<br>
- Darren Wiebe<br>
Jörg Weinmann <br>
+ Darren Wiebe<br>
+ Anduin Withers<br>
Oliver Yeoh<br>
Jamie Zawinski</P
><P
><P
CLASS="LITERALLAYOUT"
> Junkbusters Corp.<br>
- Anonymous Coders</P
+ Anonymous Coders<br>
+ Ulrich Drepper<br>
+ Philip Hazel</P
></DIV
></DIV
><DIV
><H2
CLASS="SECT2"
><A
-NAME="AEN4304"
+NAME="AEN4346"
></A
>9.1. Filter File Tutorial</H2
><P
> Header filter to change the Content-Type from html to xml.
</P
></DD
+><DT
+><SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>no-ping</I
+></SPAN
+></DT
+><DD
+><P
+> Removes the non-standard <TT
+CLASS="LITERAL"
+>ping</TT
+> attribute from
+ anchor and area HTML tags.
+ </P
+></DD
+><DT
+><SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>hide-tor-exit-notation</I
+></SPAN
+></DT
+><DD
+><P
+> Header filter to remove the <B
+CLASS="COMMAND"
+>Tor</B
+> exit node notation
+ found in Host and Referer headers.
+ </P
+></DD
></DL
></DIV
></DIV
><BR></P
><P
CLASS="PUBDATE"
->$Id: user-manual.sgml,v 2.23 2006/10/02 22:43:53 hal9 Exp $<BR></P
+>$Id: user-manual.sgml,v 2.26 2006/10/24 11:16:44 hal9 Exp $<BR></P
><DIV
><DIV
CLASS="ABSTRACT"
><DT
>2.1.1. <A
HREF="installation.html#INSTALLATION-PACK-RPM"
->Red Hat, SuSE and Conectiva RPMs</A
+>Red Hat and Fedora RPMs</A
></DT
><DT
>2.1.2. <A
><DT
>5.1. <A
HREF="startup.html#START-REDHAT"
->Red Hat, Fedora and Conectiva</A
+>Red Hat and Fedora</A
></DT
><DT
>5.2. <A
></DT
><DT
>5.3. <A
-HREF="startup.html#START-SUSE"
->SuSE</A
-></DT
-><DT
->5.4. <A
HREF="startup.html#START-WINDOWS"
>Windows</A
></DT
><DT
HREF="startup.html#START-UNICES"
>Solaris, NetBSD, FreeBSD, HP-UX and others</A
></DT
><DT
HREF="startup.html#START-OS2"
>OS/2</A
></DT
><DT
HREF="startup.html#START-MACOSX"
>Mac OSX</A
></DT
><DT
HREF="startup.html#START-AMIGAOS"
>AmigaOS</A
></DT
><DT
HREF="startup.html#START-GENTOO"
>Gentoo</A
></DT
><DT
HREF="startup.html#CMDOPTIONS"
>Command Line Options</A
></DT
><DL
><DT
>6.1. <A
-HREF="configuration.html#AEN806"
+HREF="configuration.html#AEN841"
>Controlling Privoxy with Your Web Browser</A
></DT
><DT
><DL
><DT
>8.1. <A
-HREF="actions-file.html#AEN2069"
+HREF="actions-file.html#AEN2102"
>Finding the Right Mix</A
></DT
><DT
>8.2. <A
-HREF="actions-file.html#AEN2076"
+HREF="actions-file.html#AEN2109"
>How to Edit</A
></DT
><DT
><DL
><DT
>8.4.1. <A
-HREF="actions-file.html#AEN2159"
+HREF="actions-file.html#AEN2192"
>The Domain Pattern</A
></DT
><DT
>8.4.2. <A
-HREF="actions-file.html#AEN2230"
+HREF="actions-file.html#AEN2263"
>The Path Pattern</A
></DT
></DL
></DT
><DT
>8.5.36. <A
-HREF="actions-file.html#AEN3912"
+HREF="actions-file.html#AEN3952"
>Summary</A
></DT
></DL
><DL
><DT
>8.7.1. <A
-HREF="actions-file.html#AEN3977"
+HREF="actions-file.html#AEN4017"
>default.action</A
></DT
><DT
>8.7.2. <A
-HREF="actions-file.html#AEN4164"
+HREF="actions-file.html#AEN4206"
>user.action</A
></DT
></DL
><DL
><DT
>9.1. <A
-HREF="filter-file.html#AEN4304"
+HREF="filter-file.html#AEN4346"
>Filter File Tutorial</A
></DT
><DT
><DL
><DT
>12.1. <A
-HREF="copyright.html#AEN4742"
+HREF="copyright.html#AEN4796"
>License</A
></DT
><DT
></DT
><DT
>14.2. <A
-HREF="appendix.html#AEN4992"
+HREF="appendix.html#AEN5046"
>Privoxy's Internal Pages</A
></DT
><DD
><A
NAME="INSTALLATION-PACK-RPM"
></A
->2.1.1. Red Hat, SuSE and Conectiva RPMs</H3
+>2.1.1. Red Hat and Fedora RPMs</H3
><P
> RPMs can be installed with <TT
CLASS="LITERAL"
CLASS="APPLICATION"
>Privoxy</SPAN
> sources
- is to download the source tarball from our <A
-HREF="http://sf.net/projects/ijbswa/"
+ is to download the source tarball from our
+ <A
+HREF="http://sourceforge.net/project/showfiles.php?group_id=11118&package_id=10571"
TARGET="_top"
->project
+>project download
page</A
>.</P
><P
><TD
><PRE
CLASS="SCREEN"
-> tar xzvf privoxy-3.0.6-beta-src* [.tgz or .tar.gz]
- cd privoxy-3.0.6-beta</PRE
+> tar xzvf privoxy-3.0.6-src* [.tgz or .tar.gz]
+ cd privoxy-3.0.6</PRE
></TD
></TR
></TABLE
></P
><P
> For retrieving the current CVS sources, you'll need a CVS client installed.
- Note that sources from CVS are typicially development quality, and may not be
+ Note that sources from CVS are typically development quality, and may not be
stable, or well tested. To download CVS source, check the Sourceforge
documentation, which might give commands like:</P
><P
CLASS="APPLICATION"
>Privoxy</SPAN
>
- as root, and instead it is suggested to create a <SPAN
+ as root. You should configure/install/run <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> as
+ an unprivileged user, preferably by creating a <SPAN
CLASS="QUOTE"
>"privoxy"</SPAN
> user
- and group for this purpose. See your local documentation for the correct
- command line to do this. </P
+ and group just for this purpose. See your local documentation for the correct
+ command line to do add new users and groups (something like
+ <B
+CLASS="COMMAND"
+>adduser</B
+>, but the command syntax may vary from platform
+ to platform). </P
><P
> <TT
CLASS="FILENAME"
autoconf
./configure # (--help to see options)
make # (the make from GNU, sometimes called gmake)
- su
+ su # Possibly required
make -n install # (to see where all the files will go)
make -s install # (to really install, -s to silence output)</PRE
></TD
></TABLE
></P
><P
-> If you have GNU <B
+> Using GNU <B
CLASS="COMMAND"
>make</B
>, you can have the first four steps
><P
> in the freshly downloaded or unpacked source directory.</P
><P
+> To build an executable with security enhanced features so that
+ users cannot easily bypass the proxy (e.g. <SPAN
+CLASS="QUOTE"
+>"Go There Anyway"</SPAN
+>), or
+ alter their own configurations, <B
+CLASS="COMMAND"
+>configure</B
+> like this:</P
+><P
+> <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+> ./configure --disable-toggle --disable-editor --disable-force</PRE
+></TD
+></TR
+></TABLE
+></P
+><P
+>Then build as above.</P
+><P
> <SPAN
CLASS="emphasis"
><I
<SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
->, it should be run as this same user to
- insure write access to configuration and log files.</P
+>, it must be run as this same user to
+ insure write access to configuration and log files!</P
><P
> Alternately, you can specify <TT
CLASS="LITERAL"
CLASS="COMMAND"
>./configure</B
> path options. If you are doing
- a root install to anywhere else besides <TT
+ an install to anywhere besides <TT
CLASS="FILENAME"
>/usr/local</TT
>, be
(<B
CLASS="COMMAND"
>./configure --help</B
->).</P
+>). Non-privileged users must of course
+ have write access permissions to wherever the target installation is going.</P
><P
> If you do install to <TT
CLASS="FILENAME"
> If installing to <TT
CLASS="FILENAME"
>/usr/local</TT
->, the docs will go by default
- to <TT
+>, the documentation will go
+ by default to <TT
CLASS="FILENAME"
>$prefix/share/doc</TT
->. But if this directory doesn't
- exist, it will then try <TT
+>. But if this directory
+ doesn't exist, it will then try <TT
CLASS="FILENAME"
>$prefix/doc</TT
-> and install there before
- creating a new <TT
+> and install
+ there before creating a new <TT
CLASS="FILENAME"
>$prefix/share/doc</TT
> just for
in <TT
CLASS="FILENAME"
>config</TT
-> (main configuration file). You may want
- to check this to make sure all values are correct. If appropriate,
+> (main configuration file). You should
+ check this to make sure all values are correct. If appropriate,
an init script will be installed, but it is up to the user to determine
how and where to start <SPAN
CLASS="APPLICATION"
script should be checked for correct paths and values, if anything other than
a default install is done.</P
><P
-> If install finds previous versions of any local configuration files, these
- will not be overwritten, and the new ones will be installed with a
+> If install finds previous versions of local configuration files, most of
+ these will not be overwritten, and the new ones will be installed with a
<SPAN
CLASS="QUOTE"
>"new"</SPAN
> extension. default.action, default.filter, and
- standard.action will be overwritten. You will then need to manually update
- the other installed configuration files as needed. All template files will be
- overwritten. If you have customized, local templates, you should save these
- first. If a previous version of <SPAN
+ standard.action <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>will be overwritten</I
+></SPAN
+>. You will then need
+ to manually update the other installed configuration files as needed. All
+ template files will be overwritten. If you have customized, local templates,
+ you should save these first, and in fact it is wise to always save any
+ important configuration files <SPAN
+CLASS="QUOTE"
+>"just in case"</SPAN
+>. If a previous
+ version of <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> is
- already running, you will have to restart it manually.</P
+> is already running, you will
+ have to restart it manually.</P
><P
> For more detailed instructions on how to build Redhat RPMs,
Windows self-extracting installers, building on platforms with
></A
>1. Introduction</H1
><P
-> This documentation is included with the current UNRELEASED version of
+> This documentation is included with the current stable version of
<SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
->, v.3.0.6,
- and is mostly complete at this point. The most up to date reference for the
- time being is still the comments in the source files and in the individual
- configuration files. Development of a new version is currently nearing
- completion, and includes significant changes and enhancements over
- earlier versions. .</P
-><P
-> Since this is a UNRELEASED version, not all new features are well tested. This
- documentation may be slightly out of sync as a result (especially with
- CVS sources). And there <SPAN
-CLASS="emphasis"
-><I
-CLASS="EMPHASIS"
->may be</I
-></SPAN
-> bugs, though hopefully
- not many! </P
+>, v.3.0.6.</P
><DIV
CLASS="SECT2"
><H2
CLASS="APPLICATION"
>Privoxy</SPAN
> provides many supplemental
- features, some of them currently under development,
+ features,
that give the end-user more control, more privacy and more freedom:</P
><P
> <P
></LI
><LI
><P
-> Web page content filtering (removes banners based on size,
+> Web page filtering (text replacements, removes banners based on size,
invisible <SPAN
CLASS="QUOTE"
>"web-bugs"</SPAN
->, JavaScript and HTML annoyances, pop-up windows, etc.)
+>, JavaScript and HTML annoyances,
+ pop-up windows, header manipulation, etc.)
</P
></LI
><LI
><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
+ things that were not intended. And the more likely that some things
+ may not work as intended. So there is a trade off here. If you want
extreme ad free browsing, be prepared to deal with more
<SPAN
CLASS="QUOTE"
CLASS="APPLICATION"
>Privoxy</SPAN
> to perform
- some task relating to HTTP transactions (i.e. web browsing). We tell
+ some task relating to WWW transactions (i.e. web browsing). We tell
<SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
original page's HTML content. An ad image for instance, is just an 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
+ such embedded URLs. <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> can deal with each URL individually, so, for
+ instance, the main page text is not touched, but images from such-and-such
+ server are blocked.</P
><P
-> The actions we need to know about for ad blocking are: <TT
+> The most important actions for basic ad blocking are: <TT
CLASS="LITERAL"
><A
HREF="actions-file.html#BLOCK"
HREF="actions-file.html#HANDLE-AS-IMAGE"
>handle-as-image</A
></TT
->, and
+>,
+ <TT
+CLASS="LITERAL"
+><A
+HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
+>handle-as-empty-document</A
+></TT
+>,and
<TT
CLASS="LITERAL"
><A
HREF="actions-file.html#BLOCK"
>block</A
></TT
-> - 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 and sends <SPAN
+> - this is perhaps
+ the single most used action, and is particularly important for ad blocking.
+ 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 and sends
+ <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
->'s
- own built-in BLOCKED page instead to let you now what has happened.
+>'s own built-in BLOCKED page instead to
+ let you now what has happened (with some exceptions, see below).
</P
></LI
><LI
> <TT
CLASS="LITERAL"
><A
+HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
+>handle-as-empty-document</A
+></TT
+> -
+ sends an empty document instead of <SPAN
+CLASS="APPLICATION"
+>Privoxy's</SPAN
+>
+ normal BLOCKED HTML page. This is useful for file types that are neither
+ HTML nor images, such as blocking JavaScript files.
+ </P
+></LI
+><LI
+><P
+> <TT
+CLASS="LITERAL"
+><A
HREF="actions-file.html#SET-IMAGE-BLOCKER"
>set-image-blocker</A
></TT
> <DIV
CLASS="FIGURE"
><A
-NAME="AEN568"
+NAME="AEN599"
></A
><P
><B
>Actions Files Tutorial</A
>.
The ideas explained therein also apply to the web-based editor.</P
+><P
+> There are also various
+ <A
+HREF="actions-file.html#FILTER"
+>filters</A
+> that can be used for ad blocking
+ (filters are a special subset of actions). These
+ fall into the <SPAN
+CLASS="QUOTE"
+>"advanced"</SPAN
+> usage category, and are explained in
+ depth in later sections. </P
></DIV
></DIV
><DIV
> <DIV
CLASS="FIGURE"
><A
-NAME="AEN620"
+NAME="AEN654"
></A
><P
><B
With <SPAN
CLASS="APPLICATION"
>Firefox</SPAN
->, this can be set under:</P
+>, this is typically set under:</P
><P
CLASS="LITERALLAYOUT"
> <SPAN
>Manual Proxy Configuration</SPAN
><br> </P
><P
+>
+ Or optionally on some platforms:</P
+><P
+CLASS="LITERALLAYOUT"
+> <SPAN
+CLASS="GUIBUTTON"
+>Edit</SPAN
+> -> <SPAN
+CLASS="GUIBUTTON"
+>Preferences</SPAN
+> -> <SPAN
+CLASS="GUIBUTTON"
+>General</SPAN
+> -> <SPAN
+CLASS="GUIBUTTON"
+>Connection Settings</SPAN
+> -> <SPAN
+CLASS="GUIBUTTON"
+>Manual Proxy Configuration</SPAN
+><br> </P
+><P
>
With <SPAN
CLASS="APPLICATION"
> <DIV
CLASS="FIGURE"
><A
-NAME="AEN657"
+NAME="AEN698"
></A
><P
><B
><A
NAME="START-REDHAT"
></A
->5.1. Red Hat, Fedora and Conectiva</H2
+>5.1. Red Hat and Fedora</H2
><P
> A default Red Hat installation may not start <SPAN
CLASS="APPLICATION"
><H2
CLASS="SECT2"
><A
-NAME="START-SUSE"
-></A
->5.3. SuSE</H2
-><P
->We use a script. It will use the file <TT
-CLASS="FILENAME"
->/etc/privoxy/config</TT
->
-as its main configuration file. Note that SuSE starts Privoxy upon booting
-your PC.</P
-><P
-> <TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><PRE
-CLASS="SCREEN"
-> # rcprivoxy start</PRE
-></TD
-></TR
-></TABLE
-></P
-></DIV
-><DIV
-CLASS="SECT2"
-><H2
-CLASS="SECT2"
-><A
NAME="START-WINDOWS"
></A
->5.4. Windows</H2
+>5.3. Windows</H2
><P
>Click on the <SPAN
CLASS="APPLICATION"
><A
NAME="START-UNICES"
></A
->5.5. Solaris, NetBSD, FreeBSD, HP-UX and others</H2
+>5.4. Solaris, NetBSD, FreeBSD, HP-UX and others</H2
><P
>Example Unix startup command:</P
><P
><A
NAME="START-OS2"
></A
->5.6. OS/2</H2
+>5.5. OS/2</H2
><P
> During installation, <SPAN
CLASS="APPLICATION"
><A
NAME="START-MACOSX"
></A
->5.7. Mac OSX</H2
+>5.6. Mac OSX</H2
><P
> During installation, <SPAN
CLASS="APPLICATION"
><A
NAME="START-AMIGAOS"
></A
->5.8. AmigaOS</H2
+>5.7. AmigaOS</H2
><P
> Start <SPAN
CLASS="APPLICATION"
><A
NAME="START-GENTOO"
></A
->5.9. Gentoo</H2
+>5.8. Gentoo</H2
><P
> A script is again used. It will use the file <TT
CLASS="FILENAME"
><A
NAME="CMDOPTIONS"
></A
->5.10. Command Line Options</H2
+>5.9. Command Line Options</H2
><P
> <SPAN
CLASS="APPLICATION"
></A
>3. What's New in this Release</H1
><P
-> There are many improvements and new features since the last <SPAN
+> There are many improvements and new features since <SPAN
CLASS="APPLICATION"
->Privoxy</SPAN
-> stable release:</P
+>Privoxy 3.0.3</SPAN
+>, the last stable release:</P
><P
> <P
></P
><P
> In addition, there are numerous bug fixes and significant enhancements,
including error pages should no longer be cached if the problem is fixed,
- much better DNS error handling, and various logging improvements.
- </P
-></LI
-><LI
-><P
-> The default actions setting is now <TT
-CLASS="LITERAL"
->Cautious</TT
->. Previous
- releases had a default setting of <TT
-CLASS="LITERAL"
->Medium</TT
->. Experienced
- users may want to adjust this, as it is fairly conservative by <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
->
- standards and past practices. See <A
-HREF="http://config.privoxy.org/edit-actions-list?f=default"
-TARGET="_top"
-> http://config.privoxy.org/edit-actions-list?f=default</A
->. New users
- should try the default settings for a while before turning up the volume.
+ much better DNS error handling, various logging improvements, and
+ configuration updates for better ad blocking and junk elimination.
</P
></LI
></UL
>"off"</SPAN
> by default.
There are also a number of new actions and filters you may want to
- consider, most of which are not incorporated into the default settings as
- yet (see above).
+ consider, most of which are not fully incorporated into the default
+ settings as yet (see above).
+ </P
+></LI
+><LI
+><P
+> The default actions setting is now <TT
+CLASS="LITERAL"
+>Cautious</TT
+>. Previous
+ releases had a default setting of <TT
+CLASS="LITERAL"
+>Medium</TT
+>. Experienced
+ users may want to adjust this, as it is fairly conservative by <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>
+ standards and past practices. See <A
+HREF="http://config.privoxy.org/edit-actions-list?f=default"
+TARGET="_top"
+> http://config.privoxy.org/edit-actions-list?f=default</A
+>. New users
+ should try the default settings for a while before turning up the volume.
+ </P
+></LI
+><LI
+><P
+> The default setting has filtering turned <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>off</I
+></SPAN
+>, which
+ subsequently means that compression is <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>on</I
+></SPAN
+>. Remember
+ that filtering does not work on compressed pages, so if you use, or want to
+ use, filtering, you will need to force compression off. Example:
+ </P
+><P
+> <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+> { +<A
+HREF="actions-file.html#FILTER"
+>filter</A
+>{google} +<A
+HREF="actions-file.html#PREVENT-COMPRESSION"
+>prevent-compression</A
+> }
+ .google.</PRE
+></TD
+></TR
+></TABLE
+>
+ </P
+><P
+> Or if you use a number of filters, or filter many sites, you may just want
+ to turn off compression for all sites in
+ <TT
+CLASS="FILENAME"
+>default.action</TT
+> (or
+ <TT
+CLASS="FILENAME"
+>user.action</TT
+>).
+ </P
+></LI
+><LI
+><P
+> Also, <A
+HREF="actions-file.html#SESSION-COOKIES-ONLY"
+>session-cookies-only</A
+> is
+ off by default now. If you've liked this feature in the past, you may want
+ to turn it back on in <TT
+CLASS="FILENAME"
+>user.action</TT
+> now.
</P
></LI
><LI
projects / privoxy.git / commitdiff