All HTML docs for 3.0.6 release.
[privoxy.git] / doc / webserver / faq / configuration.html
index f09c6df..681cefd 100644 (file)
@@ -81,7 +81,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN339"
+NAME="AEN351"
 ></A
 >3.1. What exactly is an <SPAN
 CLASS="QUOTE"
@@ -183,7 +183,7 @@ CLASS="SECT2"
 ><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
@@ -219,7 +219,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN370"
+NAME="AEN382"
 ></A
 >3.4. There are several different <SPAN
 CLASS="QUOTE"
@@ -374,12 +374,39 @@ CLASS="SECT2"
 ><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
@@ -462,6 +489,7 @@ CLASS="SCREEN"
 CLASS="LITERAL"
 >fragile</TT
 > }
+ # Gmail is ...
  mail.google.com</PRE
 ></TD
 ></TR
@@ -492,7 +520,7 @@ CLASS="SECT2"
 ><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
@@ -571,7 +599,7 @@ CLASS="SECT2"
 ><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
@@ -650,9 +678,9 @@ CLASS="SECT2"
 ><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
@@ -734,9 +762,9 @@ CLASS="SECT2"
 ><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
@@ -843,9 +871,9 @@ CLASS="SECT2"
 ><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"
@@ -910,9 +938,9 @@ CLASS="SECT2"
 ><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"
@@ -920,7 +948,7 @@ 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
@@ -940,9 +968,9 @@ CLASS="SECT2"
 ><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
@@ -973,7 +1001,7 @@ CLASS="SECT2"
 ><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
@@ -1011,7 +1039,7 @@ CLASS="SECT2"
 ><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
@@ -1042,7 +1070,7 @@ CLASS="SECT2"
 ><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 
@@ -1058,7 +1086,7 @@ CLASS="SECT2"
 ><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
@@ -1067,12 +1095,12 @@ CLASS="QUOTE"
 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"
@@ -1089,7 +1117,7 @@ HREF="../user-manual/index.html"
 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"
@@ -1103,7 +1131,7 @@ CLASS="SECT2"
 ><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
@@ -1127,7 +1155,7 @@ CLASS="SECT2"
 ><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"
@@ -1165,7 +1193,7 @@ CLASS="SECT2"
 ><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"
@@ -1222,7 +1250,7 @@ CLASS="SECT2"
 ><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
@@ -1260,7 +1288,7 @@ CLASS="SECT2"
 ><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
@@ -1313,7 +1341,7 @@ CLASS="SECT2"
 ><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"
@@ -1324,10 +1352,13 @@ 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
@@ -1342,13 +1373,13 @@ CLASS="SECT2"
 ><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"
@@ -1421,33 +1452,51 @@ CLASS="SECT2"
 ><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
 >: 
@@ -1467,8 +1516,7 @@ HREF="../user-manual/actions-file.html#BLOCK"
 TARGET="_top"
 >-block</A
 > }
- / # UN-Block *all* URLs
- </PRE
+ / # UN-Block *all* URLs</PRE
 ></TD
 ></TR
 ></TABLE
@@ -1497,7 +1545,7 @@ TARGET="_top"
 >-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
 > \
@@ -1506,8 +1554,7 @@ CLASS="LITERAL"
 >allow-popups</TT
 > \
  }
- / # UN-Block *all* URLs and allow ads
- </PRE
+ / # UN-Block *all* URLs and allow ads</PRE
 ></TD
 ></TR
 ></TABLE
@@ -1534,7 +1581,7 @@ CLASS="SECT2"
 ><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
@@ -1543,20 +1590,26 @@ CLASS="EMPHASIS"
 ></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"
@@ -1565,7 +1618,7 @@ 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 
@@ -1577,17 +1630,17 @@ CLASS="EMPHASIS"
 ></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"
@@ -1597,8 +1650,7 @@ WIDTH="100%"
 ><TD
 ><PRE
 CLASS="SCREEN"
-> ./configure --disable-toggle --disable-editor --disable-force
- </PRE
+> ./configure  --disable-toggle  --disable-editor  --disable-force</PRE
 ></TD
 ></TR
 ></TABLE
@@ -1608,9 +1660,10 @@ CLASS="SCREEN"
  <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