Rebuild for 3.0.17 stable
[privoxy.git] / doc / webserver / faq / general.html
index 1336454..bd045c9 100644 (file)
@@ -17,7 +17,10 @@ TITLE="Installation"
 HREF="installation.html"><LINK
 REL="STYLESHEET"
 TYPE="text/css"
-HREF="../p_doc.css"></HEAD
+HREF="../p_doc.css"><META
+HTTP-EQUIV="Content-Type"
+CONTENT="text/html;
+charset=ISO-8859-1"></HEAD
 ><BODY
 CLASS="SECT1"
 BGCOLOR="#EEEEEE"
@@ -82,15 +85,14 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="WHO-USES"
->1.1. Who should use Privoxy?</A
+>1.1. Who should give <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> a try?</A
 ></H3
 ><P
->  Anyone that is interested in security, privacy, or in 
+>  Anyone who is interested in security, privacy, or in 
   finer-grained control over their web and Internet experience.
-  Everyone is encouraged to try <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
->.
  </P
 ></DIV
 ><DIV
@@ -107,12 +109,15 @@ me?</A
 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 +128,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"
@@ -153,7 +152,7 @@ CLASS="APPLICATION"
 CLASS="APPLICATION"
 >Privoxy's</SPAN
 > configuration can be done 
-  with a  <A
+  with a <A
 HREF="http://en.wikipedia.org/wiki/Web_browser"
 TARGET="_top"
 >Web browser</A
@@ -164,7 +163,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
@@ -180,29 +184,27 @@ CLASS="QUOTE"
 Privoxy work?</A
 ></H3
 ><P
->  A  <A
+>  A <A
 HREF="http://en.wikipedia.org/wiki/Proxy_server"
 TARGET="_top"
 >web proxy</A
 >
-  is a service, based on a software such as
-  <SPAN
+  is a service, based on a software such as <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
->, that clients (i.e. browsers) can use
-  instead of connecting directly to web servers on the Internet. The
-  clients then ask the proxy to fetch the objects they need (web pages,
-  images, movies etc) on their behalf, and when the proxy has done so, it
-  hands the results back to the client. It is a <SPAN
+>, that clients
+  (i.e. browsers) can use instead of connecting to web servers directly.
+  The clients then ask the proxy to request objects (web pages, images, movies etc)
+  on their behalf and to forward the data to the clients.
+  It is a <SPAN
 CLASS="QUOTE"
 >"go-between"</SPAN
->. See
-  the <A
+>. For details, see
+  <A
 HREF="http://en.wikipedia.org/wiki/Proxy_server"
 TARGET="_top"
->Wikipedia proxy
-  definition</A
-> for more.
+>Wikipedia's proxy definition</A
+>.
  </P
 ><P
 >  There are many reasons to use web proxies, such as security (firewalling),
@@ -213,9 +215,9 @@ TARGET="_top"
 >  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> is a proxy that is primarily focused on privacy
-  protection, ad and junk elimination and freeing the user from restrictions placed on his 
-  activities. Sitting between your browser(s) and the Internet,
+> is a proxy that is primarily focused on
+  privacy enhancement, ad and junk elimination and freeing the user from
+  restrictions placed on his activities. Sitting between your browser(s) and the Internet,
   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
@@ -270,7 +272,7 @@ TARGET="_top"
  web advertising and user tracking.</P
 ><P
 > But the web, its protocols and standards, and with it, the techniques for
- forcing  ads on users, give up autonomy over their browsing, and
+ forcing ads on users, give up autonomy over their browsing, and
  for tracking them, keeps evolving. Unfortunately, the <SPAN
 CLASS="APPLICATION"
 >Internet
@@ -289,19 +291,14 @@ TARGET="_top"
 >.
  Fortunately, it had been released under the GNU
  <A
-HREF="http://www.gnu.org/licenses/gpl.html"
+HREF="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html"
 TARGET="_top"
-> GPL</A
->, which allowed further
- development by others.</P
+>GPL</A
+>,
which allowed further development by others.</P
 ><P
-> So Stefan Waldherr started maintaining an
- <A
-HREF="http://www.waldherr.org/junkbuster/"
-TARGET="_top"
->improved version of the
- software</A
->, to which eventually a number of people contributed patches.
+> So Stefan Waldherr started maintaining an improved version of the
+ software, to which eventually a number of people contributed patches.
  It could already replace banners with a transparent image, and had a first
  version of pop-up killing, but it was still very closely based on the
  original, with all its limitations, such as the lack of HTTP/1.1 support,
@@ -335,7 +332,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN78"
+NAME="AEN85"
 >1.6. Why <SPAN
 CLASS="QUOTE"
 >"Privoxy"</SPAN
@@ -430,7 +427,7 @@ CLASS="APPLICATION"
  <SPAN
 CLASS="APPLICATION"
 >Junkbuster</SPAN
-> left off. All the old features remain.
+> left off.
  The new <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -440,8 +437,8 @@ HREF="http://en.wikipedia.org/wiki/Browser_cookie"
 TARGET="_top"
 >cookies</A
 >, and still
- helps protect your privacy. But, these have all been 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
 > <SPAN
@@ -454,7 +451,42 @@ CLASS="APPLICATION"
 ><UL
 ><LI
 ><P
->   Integrated browser based configuration and control utility at <A
+>     Supports "Connection: keep-alive". Outgoing connections can
+     be kept alive independently from the client.
+  </P
+></LI
+><LI
+><P
+>     Supports IPv6, provided the operating system does so too,
+     and the configure script detects it.
+  </P
+></LI
+><LI
+><P
+>     Supports tagging which allows to change the behaviour
+     based on client and server headers.
+  </P
+></LI
+><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"
 >http://config.privoxy.org/</A
@@ -473,8 +505,7 @@ TARGET="_top"
    invisible <SPAN
 CLASS="QUOTE"
 >"web-bugs"</SPAN
->, JavaScript and HTML annoyances, 
-   pop-up windows, header manipulation, etc.)
+> and HTML annoyances, etc.)
   </P
 ></LI
 ><LI
@@ -486,19 +517,13 @@ CLASS="QUOTE"
 ></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.
-  </P
-></LI
-><LI
-><P
->   Improved cookie management features (e.g. session based cookies).
+>   Support for Perl Compatible Regular Expressions in the configuration files, and
+   a more sophisticated and flexible configuration syntax.
   </P
 ></LI
 ><LI
 ><P
->   GIF de-animation. 
+>   GIF de-animation.
   </P
 ></LI
 ><LI
@@ -508,12 +533,7 @@ CLASS="QUOTE"
 ></LI
 ><LI
 ><P
->   Multi-threaded (POSIX and native threads).
-  </P
-></LI
-><LI
-><P
->   User-customizable HTML templates for all proxy-generated pages (e.g. "blocked" page).
+>   User-customizable HTML templates for most proxy-generated pages (e.g. "blocked" page).
   </P
 ></LI
 ><LI
@@ -523,18 +543,12 @@ CLASS="QUOTE"
 ></LI
 ><LI
 ><P
->   Improved signal handling, and a true daemon mode (Unix).
+>   Most features are controllable on a per-site or per-location basis.
   </P
 ></LI
 ><LI
 ><P
->   Every feature now controllable on a per-site or per-location basis, configuration
-   more powerful and versatile over-all.
-  </P
-></LI
-><LI
-><P
->   Many smaller new features added, limitations and bugs removed, and security holes fixed.
+>   Many smaller new features added, limitations and bugs removed.
   </P
 ></LI
 ></UL
@@ -604,7 +618,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN150"
+NAME="AEN163"
 >1.9. Can Privoxy make mistakes? 
 This does not sound very scientific.</A
 ></H3
@@ -631,21 +645,22 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN156"
+NAME="AEN169"
 >1.10. Will I have to configure Privoxy
  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
@@ -662,7 +677,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"
@@ -715,8 +730,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 
@@ -728,6 +744,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"
@@ -777,7 +806,7 @@ warranty? Registration?</A
 >  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> is licensed under the <A
+> 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) version 2</A
@@ -802,17 +831,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
@@ -836,7 +854,10 @@ CLASS="APPLICATION"
 >Privoxy</SPAN
 > 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"
@@ -857,15 +878,17 @@ 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"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="JOINTEAM"
+NAME="HELP-THE-DEVELOPERS"
 >1.17. I would like to help you, what can I do?</A
 ></H3
 ><DIV
@@ -873,7 +896,7 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="JOINTEAM-WORK"
+NAME="PARTICIPATE"
 >1.17.1. Would you like to participate?</A
 ></H4
 ><P
@@ -899,64 +922,98 @@ CLASS="QUOTE"
 >. There are many other tasks available. In fact,
    the programmers often can't spend as much time programming because of some
    of the other, more mundane things that need to be done, like checking the
-   Tracker feedback sections. 
+   Tracker feedback sections or responding to user questions on the mailing
+   lists.
+ </P
+><P
+>  So first thing, subscribe to the <A
+HREF="https://lists.sourceforge.net/lists/listinfo/ijbswa-users"
+TARGET="_top"
+>Privoxy Users</A
+>
+  or the <A
+HREF="https://lists.sourceforge.net/lists/listinfo/ijbswa-developers"
+TARGET="_top"
+>Privoxy
+  Developers</A
+> mailing list, join the discussion, help out other users, provide general
+  feedback or report problems you noticed.
  </P
 ><P
->  So first thing, <A
+>  If you intend to help out with the trackers, you also might want to <A
 HREF="https://sourceforge.net/account/register.php"
 TARGET="_top"
 >get an account on SourceForge.net</A
 >
-   and mail your id to the <A
-HREF="mailto:ijbswa-developers@lists.sourceforge.net"
-TARGET="_top"
->developers
-   mailing list</A
->. Then, please read the <A
+   so we don't confuse you with the other name-less users.
+ </P
+><P
+>   We also have a <A
 HREF="../developer-manual/index.html"
 TARGET="_top"
 >Developer's Manual</A
->, at least
-   the pertinent sections.</P
+>.
+   While it is partly out of date, it's still worth reading.</P
+><P
+>   Our <A
+HREF="http://ijbswa.cvs.sourceforge.net/viewvc/ijbswa/current/TODO?view=markup"
+TARGET="_top"
+>TODO list</A
+>
+   may be of interest to you as well.
+   Please let us know if you want to work on one of the items listed.</P
 ></DIV
 ><DIV
 CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="JOINTEAM-MONEY"
->1.17.2. Contribute!</A
+NAME="DONATE"
+>1.17.2. Would you like to donate?</A
 ></H4
 ><P
-> We, of course, welcome donations and could use money for domain registering,
- buying software to test <SPAN
+> <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> is developed by unpaid volunteers
+ and thus our current running costs are pretty low. Nevertheless, we
+ have plans that will cost money in the future. We would like to get
+ this money through donations made by our users.</P
+><P
+> <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> with, and, of course,
- for regular world-wide get-togethers (hahaha). If you enjoy the software and feel
- like helping us with a donation, just <A
-HREF="mailto: ijbswa-developers@lists.sourceforge.net"
+> has therefore become an associated
+ project of <A
+HREF="http://www.spi-inc.org/about-spi/about-spi"
 TARGET="_top"
->drop us a note</A
->.</P
-></DIV
-><DIV
-CLASS="SECT3"
-><H4
-CLASS="SECT3"
-><A
-NAME="JOINTEAM-SOFTWARE"
->1.17.3. Software</A
-></H4
+>Software
+ in the Public Interest (SPI)</A
+>, which allows us to receive tax-deductible
+ donations in most western countries.</P
+><P
+> We intend to use the donations to pay for our domain after transfering
+ it to SPI. Our goal is to make sure there's no single point of failure
+ and the bill gets paid and the site keeps running even if a some of
+ the currently active developers were to suddenly disappear for a while.</P
 ><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
+> We would also like to spend some money on more reliable hosting,
+ on hardware to help make sure <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 >
- runs smoothly with your product, you might consider supplying us with a
- copy or license. We can't, however, guarantee that we will fix all potential
- compatibility issues as a result.</P
+ keeps running on platforms the developers currently can't test on,
+ and on technical books to educate our developers about said platforms
+ or to improve their knowledge in general.</P
+><P
+> If you enjoy our software and feel like helping out with a donation,
+ please have a look at
+ <A
+HREF="http://www.spi-inc.org/donations"
+TARGET="_top"
+>SPI's donation page</A
+>
+ to see what the options are.</P
 ></DIV
 ></DIV
 ></DIV