rebuild docs
[privoxy.git] / doc / webserver / user-manual / introduction.html
index 2319dc8..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,147 +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="NEWFEATURES"
->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
- features 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 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.
+>     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 (but not all optional 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
   </P
 ></LI
 ><LI
 ><P
->   GIF de-animation. 
+>     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
->   Web page content filtering (removes banners based on size,
-   invisible <SPAN
-CLASS="QUOTE"
->"web-bugs"</SPAN
->, JavaScript and HTML annoyances, pop-ups, etc.)
+>   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
->   Bypass many click-tracking scripts (avoids script redirection).
+>   Web page filtering (text replacements, removes banners based on size,
+   invisible <SPAN
+CLASS="QUOTE"
+>"web-bugs"</SPAN
+> and HTML annoyances, etc.)
   </P
 ></LI
 ><LI
 ><P
   </P
 ></LI
 ><LI
 ><P
->   Multi-threaded (POSIX and native threads).
+>   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
->   Auto-detection and re-reading of config file changes.
+>   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
->   User-customizable HTML templates (e.g. 404 error page).
+>   GIF de-animation.
   </P
 ></LI
 ><LI
 ><P
   </P
 ></LI
 ><LI
 ><P
->   Improved cookie management features (e.g. session based cookies).
+>   Bypass many click-tracking scripts (avoids script redirection).
   </P
 ></LI
 ><LI
 ><P
   </P
 ></LI
 ><LI
 ><P
->   Improved signal handling, and a true daemon mode (Unix).
+>   User-customizable HTML templates for most proxy-generated pages (e.g. "blocked" page).
   </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,
-   NetBSD and AmigaOS.
+>   Auto-detection and re-reading of config file changes.
   </P
 ></LI
 ><LI
 ><P
   </P
 ></LI
 ><LI
 ><P
->   Every feature now controllable on a per-site or per-location basis, configuration
-   more powerful and versatile over-all.
+>   Most features are controllable on a per-site or per-location basis.
   </P
 ></LI
 ><LI
 ><P
   </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
   </P
 ></LI
 ></UL
-></P
 ></DIV
 ></DIV
 ><DIV
 ></DIV
 ></DIV
 ><DIV
@@ -222,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"
@@ -233,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
@@ -241,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
@@ -249,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
@@ -257,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"