rebuild docs
[privoxy.git] / doc / webserver / user-manual / introduction.html
index aced3d2..91005e9 100644 (file)
@@ -1,23 +1,28 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
 <HTML
 ><HEAD
 ><TITLE
 >Introduction</TITLE
 ><META
 NAME="GENERATOR"
 <HTML
 ><HEAD
 ><TITLE
 >Introduction</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
 REL="HOME"
 REL="HOME"
-TITLE="Privoxy User Manual"
+TITLE="Privoxy 3.0.27 User Manual"
 HREF="index.html"><LINK
 REL="PREVIOUS"
 HREF="index.html"><LINK
 REL="PREVIOUS"
-TITLE="Privoxy User Manual"
+TITLE="Privoxy 3.0.27 User Manual"
 HREF="index.html"><LINK
 REL="NEXT"
 TITLE="Installation"
 HREF="installation.html"><LINK
 REL="STYLESHEET"
 TYPE="text/css"
 HREF="index.html"><LINK
 REL="NEXT"
 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">
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
+</head
 ><BODY
 CLASS="SECT1"
 BGCOLOR="#EEEEEE"
 ><BODY
 CLASS="SECT1"
 BGCOLOR="#EEEEEE"
@@ -28,6 +33,7 @@ ALINK="#0000FF"
 ><DIV
 CLASS="NAVHEADER"
 ><TABLE
 ><DIV
 CLASS="NAVHEADER"
 ><TABLE
+SUMMARY="Header navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -36,7 +42,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy User Manual</TH
+>Privoxy 3.0.27 User Manual</TH
 ></TR
 ><TR
 ><TD
 ></TR
 ><TR
 ><TD
@@ -45,6 +51,7 @@ ALIGN="left"
 VALIGN="bottom"
 ><A
 HREF="index.html"
 VALIGN="bottom"
 ><A
 HREF="index.html"
+ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
 >Prev</A
 ></TD
 ><TD
@@ -58,6 +65,7 @@ ALIGN="right"
 VALIGN="bottom"
 ><A
 HREF="installation.html"
 VALIGN="bottom"
 ><A
 HREF="installation.html"
+ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR
 >Next</A
 ></TD
 ></TR
@@ -74,138 +82,155 @@ NAME="INTRODUCTION"
 >1. Introduction</A
 ></H1
 ><P
 >1. Introduction</A
 ></H1
 ><P
-> This documentation is included with the current beta version of
+> This documentation is included with the current UNRELEASED version of
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
->, v.2.9.14, 
+>, 3.0.27,
  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
  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 version 3.0 is currently nearing
- completion, and includes many significant changes and enhancements over
- earlier versions. The target release date for
- stable v3.0 is <SPAN
-CLASS="QUOTE"
->"soon"</SPAN
-> ;-).</P
+ configuration files. Development of a new version is currently nearing
+ completion, and includes significant changes and enhancements over
+ earlier versions.</P
 ><P
 ><P
-> Since this is a beta 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 <I
+> 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
 CLASS="EMPHASIS"
 >may be</I
+></SPAN
 > bugs, though hopefully
 > bugs, though hopefully
- not many! </P
+ not many!</P
 ><DIV
 CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
 ><DIV
 CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN37"
->1.1. New Features</A
+NAME="FEATURES"
+>1.1. Features</A
 ></H2
 ><P
 ></H2
 ><P
-> In addition to <SPAN
-CLASS="APPLICATION"
->Internet Junkbuster's</SPAN
-> traditional
- feature of ad and banner blocking and cookie management,
+> In addition to the core
+ features of ad blocking and
+ <A
+HREF="http://en.wikipedia.org/wiki/Browser_cookie"
+TARGET="_top"
+>cookie</A
+> management,
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> provides new features,
- some of them currently under development:</P
+> provides many supplemental
+ features, some of them currently under development,
+ that give the end-user more control, more privacy and more freedom:</P
 ><P
 ><P
-> <P
 ></P
 ><UL
 ><LI
 ><P
 ></P
 ><UL
 ><LI
 ><P
->   Integrated browser based configuration and control utility (<A
-HREF="http://p.p"
-TARGET="_top"
->http://p.p</A
->). Browser-based tracing of rule
-   and filter effects.
+>     Supports "Connection: keep-alive". Outgoing connections can
+     be kept alive independently from the client.
   </P
 ></LI
 ><LI
 ><P
   </P
 ></LI
 ><LI
 ><P
->    Blocking of annoying pop-up browser windows.
+>     Supports IPv6, provided the operating system does so too,
+     and the configure script detects it.
   </P
 ></LI
 ><LI
 ><P
   </P
 ></LI
 ><LI
 ><P
->   HTTP/1.1 compliant (most, but not all 1.1 features are supported).
+>     Supports tagging which allows to change the behaviour
+     based on client and server headers.
   </P
 ></LI
 ><LI
 ><P
   </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. 
+>     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
   </P
 ></LI
 ><LI
 ><P
->   GIF de-animation. 
+>   Integrated browser-based configuration and control utility at <A
+HREF="http://config.privoxy.org/"
+TARGET="_top"
+>http://config.privoxy.org/</A
+>
+   (shortcut: <A
+HREF="http://p.p/"
+TARGET="_top"
+>http://p.p/</A
+>). Browser-based
+   tracing of rule and filter effects. Remote toggling.
   </P
 ></LI
 ><LI
 ><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
    invisible <SPAN
 CLASS="QUOTE"
 >"web-bugs"</SPAN
->, JavaScript, pop-ups, status bar abuse,
-   etc.)
+> and HTML annoyances, etc.)
   </P
 ></LI
 ><LI
 ><P
   </P
 ></LI
 ><LI
 ><P
->   Bypass many click-tracking scripts (avoids script redirection).
+>   Modularized configuration that allows for standard settings and
+   user settings to reside in separate files, so that installing updated
+   actions files won't overwrite individual user settings.
   </P
 ></LI
 ><LI
 ><P
   </P
 ></LI
 ><LI
 ><P
->   Multi-threaded (POSIX and native threads).
+>   Support for Perl Compatible Regular Expressions in the configuration files, and
+   a more sophisticated and flexible configuration syntax.
   </P
 ></LI
 ><LI
 ><P
   </P
 ></LI
 ><LI
 ><P
->   Auto-detection and re-reading of config file changes.
+>   GIF de-animation.
   </P
 ></LI
 ><LI
 ><P
   </P
 ></LI
 ><LI
 ><P
->   User-customizable HTML templates (e.g. 404 error page).
+>   Bypass many click-tracking scripts (avoids script redirection).
   </P
 ></LI
 ><LI
 ><P
   </P
 ></LI
 ><LI
 ><P
->   Improved cookie management features (e.g. session based cookies).
+>   User-customizable HTML templates for most proxy-generated pages (e.g. "blocked" page).
   </P
 ></LI
 ><LI
 ><P
   </P
 ></LI
 ><LI
 ><P
->   Improved signal handling, and a true daemon mode (Unix).
+>   Auto-detection and re-reading of config file changes.
   </P
 ></LI
 ><LI
 ><P
   </P
 ></LI
 ><LI
 ><P
->   Builds from source on most UNIX-like systems. Packages available for: Linux
-   (RedHat, SuSE, or Debian), Windows, Sun Solaris, Mac OSX, OS/2, HP-UX 11 and AmigaOS.
+>   Most features are controllable on a per-site or per-location basis.
   </P
 ></LI
 ><LI
 ><P
   </P
 ></LI
 ><LI
 ><P
->   In addition, the configuration is much more powerful and versatile over-all.
+>   Many smaller new features added, limitations and bugs removed.
   </P
 ></LI
 ></UL
   </P
 ></LI
 ></UL
-></P
 ></DIV
 ></DIV
 ><DIV
 ></DIV
 ></DIV
 ><DIV
@@ -213,6 +238,7 @@ CLASS="NAVFOOTER"
 ><HR
 ALIGN="LEFT"
 WIDTH="100%"><TABLE
 ><HR
 ALIGN="LEFT"
 WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -224,6 +250,7 @@ ALIGN="left"
 VALIGN="top"
 ><A
 HREF="index.html"
 VALIGN="top"
 ><A
 HREF="index.html"
+ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
 >Prev</A
 ></TD
 ><TD
@@ -232,6 +259,7 @@ ALIGN="center"
 VALIGN="top"
 ><A
 HREF="index.html"
 VALIGN="top"
 ><A
 HREF="index.html"
+ACCESSKEY="H"
 >Home</A
 ></TD
 ><TD
 >Home</A
 ></TD
 ><TD
@@ -240,6 +268,7 @@ ALIGN="right"
 VALIGN="top"
 ><A
 HREF="installation.html"
 VALIGN="top"
 ><A
 HREF="installation.html"
+ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR
 >Next</A
 ></TD
 ></TR
@@ -248,7 +277,7 @@ HREF="installation.html"
 WIDTH="33%"
 ALIGN="left"
 VALIGN="top"
 WIDTH="33%"
 ALIGN="left"
 VALIGN="top"
->Privoxy User Manual</TD
+>Privoxy 3.0.27 User Manual</TD
 ><TD
 WIDTH="34%"
 ALIGN="center"
 ><TD
 WIDTH="34%"
 ALIGN="center"