Rebuilt html docs for Privoxy 3.0.8
[privoxy.git] / doc / webserver / faq / general.html
index b45a949..236ca94 100644 (file)
@@ -1,11 +1,11 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
 <HTML
 ><HEAD
 ><TITLE
 >General Information</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
 REL="HOME"
 TITLE="Privoxy Frequently Asked Questions"
 HREF="index.html"><LINK
@@ -74,23 +74,22 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="GENERAL"
-></A
->1. General Information</H1
+>1. General Information</A
+></H1
 ><DIV
 CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="WHO_USES"
-></A
->1.1. Who should use Privoxy?</H3
-><P
->  Anyone that is interested in security, privacy, or in 
-  finer-grained control over their web and Internet experience.
-  Everyone is encouraged to try <SPAN
+NAME="WHO-USES"
+>1.1. Who should give <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
->.
+> a try?</A
+></H3
+><P
+>  Anyone who is interested in security, privacy, or in 
+  finer-grained control over their web and Internet experience.
  </P
 ></DIV
 ><DIV
@@ -99,20 +98,23 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="BESTCHOICE"
-></A
 >1.2. Is Privoxy the best choice for
-me?</H3
+me?</A
+></H3
 ><P
 >  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > is certainly a good choice, especially for those who want more 
-  control and security. Those that have the ability to fine-tune their installation
-  will benefit the most. One of <SPAN
+  control and security. Those with the willingness to read the documentation
+  and the ability to fine-tune their installation will benefit the most.
+ </P
+><P
+>  One of <SPAN
 CLASS="APPLICATION"
 >Privoxy's</SPAN
 >
-  strength's is that it is highly configurable giving you the ability to
+  strengths is that it is highly configurable giving you the ability to
   completely personalize your installation. Being familiar with, or at least
   having an interest in learning about <A
 HREF="http://en.wikipedia.org/wiki/Http"
@@ -123,12 +125,6 @@ TARGET="_top"
 HREF="http://en.wikipedia.org/wiki/Html"
 TARGET="_top"
 >HTML</A
->, 
-  <A
-HREF="http://en.wikipedia.org/wiki/Internet_Protocol"
-TARGET="_top"
->IP (Internet
-  Protocol)</A
 >, and 
   <A
 HREF="http://en.wikipedia.org/wiki/Regular_expressions"
@@ -164,7 +160,12 @@ HREF="http://en.wikipedia.org/wiki/Text_editors"
 TARGET="_top"
 >text editor</A
 >
-  to edit configuration files.
+  to edit configuration files. Also note that the web-based action editor
+  doesn't use authentication and should only be enabled in environments
+  where all clients with access to <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> listening port can be trusted.
   </P
 ></DIV
 ><DIV
@@ -173,12 +174,12 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="PROXYMORON"
-></A
 >1.3. What is a <SPAN
 CLASS="QUOTE"
 >"proxy"</SPAN
 >? How does
-Privoxy work?</H3
+Privoxy work?</A
+></H3
 ><P
 >  A  <A
 HREF="http://en.wikipedia.org/wiki/Proxy_server"
@@ -229,8 +230,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="OTHERSTUFF"
-></A
->1.4. Does Privoxy do anything more than ad blocking?</H3
+>1.4. Does Privoxy do anything more than ad blocking?</A
+></H3
 ><P
 > 
   Yes, ad blocking is but one possible use. There are many, many ways <SPAN
@@ -245,12 +246,12 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="NEWJB"
-></A
 >1.5. What is this new version of 
 <SPAN
 CLASS="QUOTE"
 >"Junkbuster"</SPAN
->?</H3
+>?</A
+></H3
 ><P
 > A long time ago, there was the
  <A
@@ -335,13 +336,13 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN78"
-></A
+NAME="AEN79"
 >1.6. Why <SPAN
 CLASS="QUOTE"
 >"Privoxy"</SPAN
 >? Why change the name from
-Junkbuster at all?</H3
+Junkbuster at all?</A
+></H3
 ><P
 > Though outdated, <A
 HREF="http://junkbusters.com/"
@@ -419,9 +420,9 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="DIFFERS"
-></A
 >1.7. How does Privoxy differ
-from the old Junkbuster?</H3
+from the old Junkbuster?</A
+></H3
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -440,37 +441,10 @@ HREF="http://en.wikipedia.org/wiki/Browser_cookie"
 TARGET="_top"
 >cookies</A
 >, and still
- helps protect your privacy. But, these are all greatly enhanced, and many,
many new features have been added, all in the same vein.
+ helps protect your privacy. But, most of these features have been enhanced,
and many new ones have been added, all in the same vein.
  </P
 ><P
-> The configuration has changed significantly as well. This is something that
- users will notice right off the bat if upgrading from 
- <SPAN
-CLASS="APPLICATION"
->Junkbuster</SPAN
-> 2.0.x. The <SPAN
-CLASS="QUOTE"
->"blocklist"</SPAN
->
- <SPAN
-CLASS="QUOTE"
->"cookielist"</SPAN
->, <SPAN
-CLASS="QUOTE"
->"imagelist"</SPAN
-> and much more has been
- combined into the <SPAN
-CLASS="QUOTE"
->"actions"</SPAN
-> files, with a completely different
- syntax.  See the <A
-HREF="../user-manual/whatsnew.html"
-TARGET="_top"
->What's New</A
-> 
- page for the latest updates.</P
-><P
 > <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -481,6 +455,23 @@ CLASS="APPLICATION"
 ><UL
 ><LI
 ><P
+>     Can be run as an "intercepting" proxy, which obviates the need to
+     configure browsers individually.
+  </P
+></LI
+><LI
+><P
+>     Sophisticated actions and filters for manipulating both server and client
+     headers. 
+   </P
+></LI
+><LI
+><P
+>     Can be chained with other proxies.
+  </P
+></LI
+><LI
+><P
 >   Integrated browser based configuration and control utility at <A
 HREF="http://config.privoxy.org/"
 TARGET="_top"
@@ -501,7 +492,7 @@ TARGET="_top"
 CLASS="QUOTE"
 >"web-bugs"</SPAN
 >, JavaScript and HTML annoyances, 
-   pop-up windows, header manipulation, etc.)
+   pop-up windows, etc.)
   </P
 ></LI
 ><LI
@@ -513,14 +504,8 @@ CLASS="QUOTE"
 ></LI
 ><LI
 ><P
->   HTTP/1.1 compliant (but not all optional 1.1 features are supported).
-  </P
-></LI
-><LI
-><P
 >   Support for Perl Compatible Regular Expressions in the configuration files, and 
-   generally a more sophisticated and flexible configuration syntax over
-   previous versions.
+   a more sophisticated and flexible configuration syntax.
   </P
 ></LI
 ><LI
@@ -578,9 +563,9 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="WHATSANAD"
-></A
 >1.8. How does Privoxy know what is
-an ad, and what is not?</H3
+an ad, and what is not?</A
+></H3
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -636,10 +621,10 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN159"
-></A
+NAME="AEN157"
 >1.9. Can Privoxy make mistakes? 
-This does not sound very scientific.</H3
+This does not sound very scientific.</A
+></H3
 ><P
 > Actually, it's a black art ;-) And yes, it is always possible to have a broad
  rule accidentally block or change something by mistake. You will almost surely
@@ -663,21 +648,22 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN165"
-></A
+NAME="AEN163"
 >1.10. Will I have to configure Privoxy
- before I can use it?</H3
+ before I can use it?</A
+></H3
 ><P
-> No, not really. The default installation should give you a good starting
+> That depends on your expectations.
+ The default installation should give you a good starting
  point, and block <SPAN
 CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >most</I
 ></SPAN
-> ads and unwanted content. Many of
- the more advanced features are off by default, and would require you to 
- activate them. </P
+> ads and unwanted content,
+ but many of the more advanced features are off by default, and require
you to activate them. </P
 ><P
 > You do have to set up your browser to use
  <SPAN
@@ -694,7 +680,7 @@ HREF="installation.html#FIRSTSTEP"
 CLASS="APPLICATION"
 >Privoxy's</SPAN
 >
- configuration to more closely match your individual situation. And we would
+ configuration to more closely match your individual situation. And we
  encourage you to do this. This is where the real power of
  <SPAN
 CLASS="APPLICATION"
@@ -707,8 +693,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="LAN"
-></A
->1.11. Can Privoxy run as a server on a network?</H3
+>1.11. Can Privoxy run as a server on a network?</A
+></H3
 ><P
 > 
   Yes, <SPAN
@@ -729,9 +715,9 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="BROWSERS2"
-></A
 >1.12. My browser does the same things as
-Privoxy. Why should I use Privoxy at all?</H3
+Privoxy. Why should I use Privoxy at all?</A
+></H3
 ><P
 >  Modern browsers do indeed have <SPAN
 CLASS="emphasis"
@@ -747,8 +733,9 @@ CLASS="APPLICATION"
   adequate for you. But <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> is much more
-  versatile and powerful, and can do a number of things that browsers just can't.
+> is very
+  versatile and powerful, and can probably do a number of things
+  your browser just can't.
  </P
 ><P
 >  In addition, a proxy is good choice if you use multiple browsers, or 
@@ -760,6 +747,19 @@ CLASS="APPLICATION"
   have to maintain a similar configuration for possibly many browsers or
   users.
  </P
+><P
+>  Note, however, that it's recommended to leverage both your browser's
+  and <SPAN
+CLASS="APPLICATION"
+>Privoxy's</SPAN
+> privacy enhancing features
+  at the same time. While your browser probably lacks some features
+  <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> offers, it should also be able to do some things more
+  reliable, for example restricting and suppressing JavaScript.
+ </P
 ></DIV
 ><DIV
 CLASS="SECT2"
@@ -767,8 +767,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="WHYTRUST"
-></A
->1.13. Why should I trust Privoxy?</H3
+>1.13. Why should I trust Privoxy?</A
+></H3
 ><P
 >  The most important reason is because you have access to
   <SPAN
@@ -780,9 +780,9 @@ CLASS="EMPHASIS"
 >, and you can control everything. You can
   check every line of every configuration file yourself. You can check every
   last bit of source code should you desire. And even if you can't read code, 
-  there should be some comfort in knowing that thousands of other people can, 
-  and do read it. You can build the software from scratch, if you want, so
-  that you know the executable is clean, and that it is
+  there should be some comfort in knowing that other people can, 
+  and do read it. You can build the software from scratch, if you want,
+  so that you know the executable is clean, and that it is
   <SPAN
 CLASS="emphasis"
 ><I
@@ -802,17 +802,17 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="LICENSE"
-></A
 >1.14. Is there is a license or fee? What about a 
-warranty? Registration?</H3
+warranty? Registration?</A
+></H3
 ><P
 >  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> is licensed under the <A
-HREF="http://www.gnu.org/copyleft/gpl.html"
+> is free software and licensed under the <A
+HREF="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html"
 TARGET="_top"
->GNU General Public License (GPL)</A
+>GNU General Public License (GPL) version 2</A
 >.
   It is free to use, copy, modify or distribute as you wish under the terms of this
   license.  Please see the <A
@@ -834,17 +834,6 @@ CLASS="EMPHASIS"
 ></SPAN
 > of any kind, expressed, implied or otherwise.
   That is something that would cost real money ;-) There is no registration either.
-  <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> really is <SPAN
-CLASS="emphasis"
-><I
-CLASS="EMPHASIS"
->free</I
-></SPAN
->
-  in every respect!
  </P
 ></DIV
 ><DIV
@@ -853,19 +842,25 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="SPYWARE"
-></A
->1.15. Can Privoxy remove spyware? Adware? Viruses?</H3
+>1.15. Can Privoxy remove spyware? Adware? Viruses?</A
+></H3
 ><P
-> No. <SPAN
+> No, at least not reliably enough to trust it. <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> cannot remove anything. It is not a removal tool. It is a
- preventative. <SPAN
+> is not designed to be
+ a malware removal tool and the default configuration doesn't even try to
+ filter out any malware.</P
+><P
+> <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> can help prevent contact from sites that use such
+> could help prevent contact from (known) sites that use such
  tactics with appropriate configuration rules, and thus could conceivably
- prevent contamination from such sites.</P
+ prevent contamination from such sites. However, keeping such a configuration
+ up to date would require a lot of time and effort that would be better spend
+ on keeping your software itself up to date so it doesn't have known
+ vulnerabilities.</P
 ></DIV
 ><DIV
 CLASS="SECT2"
@@ -873,8 +868,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="OTHERADS"
-></A
->1.16. Can I use Privoxy with other ad-blocking software?</H3
+>1.16. Can I use Privoxy with other ad-blocking software?</A
+></H3
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -886,8 +881,10 @@ CLASS="APPLICATION"
 >Privoxy</SPAN
 > in conjunction with other
  ad-blocking products, and this could conceivably cause undesirable results.
- It would be better to choose one software or the other and work a little to
+ It might be better to choose one software or the other and work a little to
  tweak its configuration to your liking.</P
+><P
+> Note that this is an advice specific to ad blocking.</P
 ></DIV
 ><DIV
 CLASS="SECT2"
@@ -895,16 +892,16 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="JOINTEAM"
-></A
->1.17. I would like to help you, what can I do?</H3
+>1.17. I would like to help you, what can I do?</A
+></H3
 ><DIV
 CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
 NAME="JOINTEAM-WORK"
-></A
->1.17.1. Would you like to participate?</H4
+>1.17.1. Would you like to participate?</A
+></H4
 ><P
 >   Well, we <SPAN
 CLASS="emphasis"
@@ -947,6 +944,11 @@ TARGET="_top"
 >Developer's Manual</A
 >, at least
    the pertinent sections.</P
+><P
+>  You can also start helping out without SourceForge.net account,
+  simply by showing up on the mailing list, helping out other users,
+  providing general feedback or reporting problems you noticed.
+ </P
 ></DIV
 ><DIV
 CLASS="SECT3"
@@ -954,8 +956,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="JOINTEAM-MONEY"
-></A
->1.17.2. Contribute!</H4
+>1.17.2. Contribute!</A
+></H4
 ><P
 > We, of course, welcome donations and could use money for domain registering,
  buying software to test <SPAN
@@ -967,7 +969,8 @@ CLASS="APPLICATION"
 HREF="mailto: ijbswa-developers@lists.sourceforge.net"
 TARGET="_top"
 >drop us a note</A
->.</P
+>
+ and get your name on the list of contributors.</P
 ></DIV
 ><DIV
 CLASS="SECT3"
@@ -975,8 +978,8 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="JOINTEAM-SOFTWARE"
-></A
->1.17.3. Software</H4
+>1.17.3. Software</A
+></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