Syncing with recent sgml updates.
[privoxy.git] / doc / webserver / user-manual / index.html
index cad3279..d60408c 100644 (file)
@@ -1,10 +1,11 @@
 <HTML
 ><HEAD
 ><TITLE
->Privoxy User Manual</TITLE
+>Privoxy 3.0.4 User Manual</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
+"><LINK
 REL="NEXT"
 TITLE="Introduction"
 HREF="introduction.html"><LINK
@@ -26,17 +27,17 @@ CLASS="TITLEPAGE"
 CLASS="TITLE"
 ><A
 NAME="AEN2"
->Privoxy User Manual</A
-></H1
+></A
+>Privoxy 3.0.4 User Manual</H1
 ><P
 CLASS="PUBDATE"
 > <SUB
 > <A
 HREF="copyright.html"
 >Copyright</A
-> © 2001, 2002 by 
+> © 2001 - 2004 by 
  <A
-HREF="http://www.privoxy.org"
+HREF="http://www.privoxy.org/"
 TARGET="_top"
 >Privoxy Developers</A
 >
@@ -44,7 +45,7 @@ TARGET="_top"
 ><BR></P
 ><P
 CLASS="PUBDATE"
->$Id: user-manual.sgml,v 1.117 2002/05/17 13:56:16 oes Exp $<BR></P
+>$Id: user-manual.sgml,v 2.14 2006/08/29 10:59:36 hal9 Exp $<BR></P
 ><DIV
 ><DIV
 CLASS="ABSTRACT"
@@ -54,8 +55,11 @@ NAME="AEN9"
 ><P
 ></P
 ><P
->  The user manual gives users information on how to install, configure and use
-  <A
+>  The <I
+CLASS="CITETITLE"
+>User Manual</I
+> gives users information on how to
+  install, configure and use <A
 HREF="http://www.privoxy.org/"
 TARGET="_top"
 ><SPAN
@@ -69,7 +73,7 @@ CLASS="APPLICATION"
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > is a web proxy with advanced filtering
- capabilities for protecting privacy, filtering web page content, managing
+ capabilities for protecting privacy, modifying web page content, managing
  cookies, controlling access, and removing ads, banners, pop-ups and other
  obnoxious Internet junk. <SPAN
 CLASS="APPLICATION"
@@ -91,14 +95,16 @@ CLASS="APPLICATION"
  Junkbuster</SPAN
 > (tm).</P
 ><P
->  You can find the latest version of the user manual at  <A
+>  You can find the latest version of the <I
+CLASS="CITETITLE"
+>User Manual</I
+> at  <A
 HREF="http://www.privoxy.org/user-manual/"
 TARGET="_top"
 >http://www.privoxy.org/user-manual/</A
 >.
   Please see the <A
 HREF="contact.html"
-TARGET="_top"
 >Contact section</A
 > on how to
   contact the developers.
@@ -146,7 +152,7 @@ HREF="installation.html#INSTALLATION-PACKAGES"
 ><DT
 >2.1.1. <A
 HREF="installation.html#INSTALLATION-PACK-RPM"
->Red Hat, SuSE RPMs and Conectiva</A
+>Red Hat, SuSE and Conectiva RPMs</A
 ></DT
 ><DT
 >2.1.2. <A
@@ -171,13 +177,18 @@ HREF="installation.html#INSTALLATION-OS2"
 ><DT
 >2.1.6. <A
 HREF="installation.html#INSTALLATION-MAC"
->Max OSX</A
+>Mac OSX</A
 ></DT
 ><DT
 >2.1.7. <A
 HREF="installation.html#INSTALLATION-AMIGA"
 >AmigaOS</A
 ></DT
+><DT
+>2.1.8. <A
+HREF="installation.html#INSTALLATTION-GENTOO"
+>Gentoo</A
+></DT
 ></DL
 ></DD
 ><DT
@@ -185,13 +196,27 @@ HREF="installation.html#INSTALLATION-AMIGA"
 HREF="installation.html#INSTALLATION-SOURCE"
 >Building from Source</A
 ></DT
+><DT
+>2.3. <A
+HREF="installation.html#INSTALLATION-KEEPUPDATED"
+>Keeping your Installation Up-to-Date</A
+></DT
 ></DL
 ></DD
 ><DT
 >3. <A
-HREF="upgradersnote.html"
+HREF="whatsnew.html"
+>What's New in this Release</A
+></DT
+><DD
+><DL
+><DT
+>3.1. <A
+HREF="whatsnew.html#UPGRADERSNOTE"
 >Note to Upgraders</A
 ></DT
+></DL
+></DD
 ><DT
 >4. <A
 HREF="quickstart.html"
@@ -200,6 +225,15 @@ CLASS="APPLICATION"
 >Privoxy</SPAN
 ></A
 ></DT
+><DD
+><DL
+><DT
+>4.1. <A
+HREF="quickstart.html#QUICKSTART-AD-BLOCKING"
+>Quickstart to Ad Blocking</A
+></DT
+></DL
+></DD
 ><DT
 >5. <A
 HREF="startup.html"
@@ -212,41 +246,51 @@ CLASS="APPLICATION"
 ><DL
 ><DT
 >5.1. <A
-HREF="startup.html#START-REDHATDEBIAN"
->RedHat, Conectiva and Debian</A
+HREF="startup.html#START-REDHAT"
+>Red Hat and Conectiva</A
 ></DT
 ><DT
 >5.2. <A
+HREF="startup.html#START-DEBIAN"
+>Debian</A
+></DT
+><DT
+>5.3. <A
 HREF="startup.html#START-SUSE"
 >SuSE</A
 ></DT
 ><DT
->5.3. <A
+>5.4. <A
 HREF="startup.html#START-WINDOWS"
 >Windows</A
 ></DT
 ><DT
->5.4. <A
+>5.5. <A
 HREF="startup.html#START-UNICES"
 >Solaris, NetBSD, FreeBSD, HP-UX and others</A
 ></DT
 ><DT
->5.5. <A
+>5.6. <A
 HREF="startup.html#START-OS2"
 >OS/2</A
 ></DT
 ><DT
->5.6. <A
+>5.7. <A
 HREF="startup.html#START-MACOSX"
->MAX OSX</A
+>Mac OSX</A
 ></DT
 ><DT
->5.7. <A
+>5.8. <A
 HREF="startup.html#START-AMIGAOS"
 >AmigaOS</A
 ></DT
 ><DT
->5.8. <A
+>5.9. <A
+HREF="startup.html#START-GENTOO"
+>Gentoo</A
+></DT
+><DT
+>5.10. <A
 HREF="startup.html#CMDOPTIONS"
 >Command Line Options</A
 ></DT
@@ -264,7 +308,7 @@ CLASS="APPLICATION"
 ><DL
 ><DT
 >6.1. <A
-HREF="configuration.html#AEN357"
+HREF="configuration.html#AEN725"
 >Controlling <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -455,12 +499,12 @@ HREF="actions-file.html"
 ><DL
 ><DT
 >8.1. <A
-HREF="actions-file.html#AEN1403"
+HREF="actions-file.html#AEN1897"
 >Finding the Right Mix</A
 ></DT
 ><DT
 >8.2. <A
-HREF="actions-file.html#AEN1410"
+HREF="actions-file.html#AEN1904"
 >How to Edit</A
 ></DT
 ><DT
@@ -476,18 +520,13 @@ HREF="actions-file.html#AF-PATTERNS"
 ><DD
 ><DL
 ><DT
->22<A
-HREF="actions-file.html#AEN1440"
-></A
-></DT
-><DT
 >8.4.1. <A
-HREF="actions-file.html#AEN1473"
+HREF="actions-file.html#AEN1978"
 >The Domain Pattern</A
 ></DT
 ><DT
 >8.4.2. <A
-HREF="actions-file.html#AEN1535"
+HREF="actions-file.html#AEN2040"
 >The Path Pattern</A
 ></DT
 ></DL
@@ -502,169 +541,184 @@ HREF="actions-file.html#ACTIONS"
 ><DT
 >8.5.1. <A
 HREF="actions-file.html#ADD-HEADER"
-><I
-CLASS="EMPHASIS"
->add-header</I
-></A
+>add-header</A
 ></DT
 ><DT
 >8.5.2. <A
 HREF="actions-file.html#BLOCK"
-><I
-CLASS="EMPHASIS"
->block</I
-></A
+>block</A
 ></DT
 ><DT
 >8.5.3. <A
-HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
-><I
-CLASS="EMPHASIS"
->crunch-incoming-cookies</I
-></A
+HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
+>content-type-overwrite</A
 ></DT
 ><DT
 >8.5.4. <A
-HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
-><I
-CLASS="EMPHASIS"
->crunch-outgoing-cookies</I
-></A
+HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
+>crunch-client-header</A
 ></DT
 ><DT
 >8.5.5. <A
-HREF="actions-file.html#DEANIMATE-GIFS"
-><I
-CLASS="EMPHASIS"
->deanimate-gifs</I
-></A
+HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
+>crunch-if-none-match</A
 ></DT
 ><DT
 >8.5.6. <A
-HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
-><I
-CLASS="EMPHASIS"
->downgrade-http-version</I
-></A
+HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
+>crunch-incoming-cookies</A
 ></DT
 ><DT
 >8.5.7. <A
-HREF="actions-file.html#FAST-REDIRECTS"
-><I
-CLASS="EMPHASIS"
->fast-redirects</I
-></A
+HREF="actions-file.html#CRUNCH-SERVER-HEADER"
+>crunch-server-header</A
 ></DT
 ><DT
 >8.5.8. <A
-HREF="actions-file.html#FILTER"
-><I
-CLASS="EMPHASIS"
->filter</I
-></A
+HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
+>crunch-outgoing-cookies</A
 ></DT
 ><DT
 >8.5.9. <A
-HREF="actions-file.html#HANDLE-AS-IMAGE"
-><I
-CLASS="EMPHASIS"
->handle-as-image</I
-></A
+HREF="actions-file.html#DEANIMATE-GIFS"
+>deanimate-gifs</A
 ></DT
 ><DT
 >8.5.10. <A
-HREF="actions-file.html#HIDE-FORWARDED-FOR-HEADERS"
-><I
-CLASS="EMPHASIS"
->hide-forwarded-for-headers</I
-></A
+HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
+>downgrade-http-version</A
 ></DT
 ><DT
 >8.5.11. <A
-HREF="actions-file.html#HIDE-FROM-HEADER"
-><I
-CLASS="EMPHASIS"
->hide-from-header</I
-></A
+HREF="actions-file.html#FAST-REDIRECTS"
+>fast-redirects</A
 ></DT
 ><DT
 >8.5.12. <A
-HREF="actions-file.html#HIDE-REFERRER"
-><I
-CLASS="EMPHASIS"
->hide-referrer</I
-></A
+HREF="actions-file.html#FILTER"
+>filter</A
 ></DT
 ><DT
 >8.5.13. <A
-HREF="actions-file.html#HIDE-USER-AGENT"
-><I
-CLASS="EMPHASIS"
->hide-user-agent</I
-></A
+HREF="actions-file.html#FILTER-CLIENT-HEADERS"
+>filter-client-headers</A
 ></DT
 ><DT
 >8.5.14. <A
+HREF="actions-file.html#FILTER-SERVER-HEADERS"
+>filter-server-headers</A
+></DT
+><DT
+>8.5.15. <A
+HREF="actions-file.html#FORCE-TEXT-MODE"
+>force-text-mode</A
+></DT
+><DT
+>8.5.16. <A
+HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
+>handle-as-empty-document</A
+></DT
+><DT
+>8.5.17. <A
+HREF="actions-file.html#HANDLE-AS-IMAGE"
+>handle-as-image</A
+></DT
+><DT
+>8.5.18. <A
+HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
+>hide-accept-language</A
+></DT
+><DT
+>8.5.19. <A
+HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
+>hide-content-disposition</A
+></DT
+><DT
+>8.5.20. <A
+HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
+>hide-if-modified-since</A
+></DT
+><DT
+>8.5.21. <A
+HREF="actions-file.html#HIDE-FORWARDED-FOR-HEADERS"
+>hide-forwarded-for-headers</A
+></DT
+><DT
+>8.5.22. <A
+HREF="actions-file.html#HIDE-FROM-HEADER"
+>hide-from-header</A
+></DT
+><DT
+>8.5.23. <A
+HREF="actions-file.html#HIDE-REFERRER"
+>hide-referrer</A
+></DT
+><DT
+>8.5.24. <A
+HREF="actions-file.html#HIDE-USER-AGENT"
+>hide-user-agent</A
+></DT
+><DT
+>8.5.25. <A
+HREF="actions-file.html#INSPECT-JPEGS"
+>inspect-jpegs</A
+></DT
+><DT
+>8.5.26. <A
 HREF="actions-file.html#KILL-POPUPS"
-><I
-CLASS="EMPHASIS"
 >kill-popups<A
 NAME="KILL-POPUP"
 ></A
-></I
 ></A
 ></DT
 ><DT
->8.5.15. <A
+>8.5.27. <A
 HREF="actions-file.html#LIMIT-CONNECT"
-><I
-CLASS="EMPHASIS"
->limit-connect</I
-></A
+>limit-connect</A
 ></DT
 ><DT
->8.5.16. <A
+>8.5.28. <A
 HREF="actions-file.html#PREVENT-COMPRESSION"
-><I
-CLASS="EMPHASIS"
->prevent-compression</I
-></A
+>prevent-compression</A
 ></DT
 ><DT
->8.5.17. <A
+>8.5.29. <A
+HREF="actions-file.html#OVERWRITE-LAST-MODIFIED"
+>overwrite-last-modified</A
+></DT
+><DT
+>8.5.30. <A
+HREF="actions-file.html#REDIRECT"
+>redirect</A
+></DT
+><DT
+>8.5.31. <A
 HREF="actions-file.html#SEND-VANILLA-WAFER"
-><I
-CLASS="EMPHASIS"
->send-vanilla-wafer</I
-></A
+>send-vanilla-wafer</A
 ></DT
 ><DT
->8.5.18. <A
+>8.5.32. <A
 HREF="actions-file.html#SEND-WAFER"
-><I
-CLASS="EMPHASIS"
->send-wafer</I
-></A
+>send-wafer</A
 ></DT
 ><DT
->8.5.19. <A
+>8.5.33. <A
 HREF="actions-file.html#SESSION-COOKIES-ONLY"
-><I
-CLASS="EMPHASIS"
->session-cookies-only</I
-></A
+>session-cookies-only</A
 ></DT
 ><DT
->8.5.20. <A
+>8.5.34. <A
 HREF="actions-file.html#SET-IMAGE-BLOCKER"
-><I
-CLASS="EMPHASIS"
->set-image-blocker</I
-></A
+>set-image-blocker</A
 ></DT
 ><DT
->8.5.21. <A
-HREF="actions-file.html#AEN2469"
+>8.5.35. <A
+HREF="actions-file.html#TREAT-FORBIDDEN-CONNECTS-LIKE-BLOCKS"
+>treat-forbidden-connects-like-blocks</A
+></DT
+><DT
+>8.5.36. <A
+HREF="actions-file.html#AEN3633"
 >Summary</A
 ></DT
 ></DL
@@ -683,12 +737,12 @@ HREF="actions-file.html#ACT-EXAMPLES"
 ><DL
 ><DT
 >8.7.1. <A
-HREF="actions-file.html#AEN2521"
+HREF="actions-file.html#AEN3698"
 >default.action</A
 ></DT
 ><DT
 >8.7.2. <A
-HREF="actions-file.html#AEN2675"
+HREF="actions-file.html#AEN3864"
 >user.action</A
 ></DT
 ></DL
@@ -698,15 +752,20 @@ HREF="actions-file.html#AEN2675"
 ><DT
 >9. <A
 HREF="filter-file.html"
->The Filter File</A
+>Filter Files</A
 ></DT
 ><DD
 ><DL
 ><DT
 >9.1. <A
-HREF="filter-file.html#AEN2778"
+HREF="filter-file.html#AEN3994"
 >Filter File Tutorial</A
 ></DT
+><DT
+>9.2. <A
+HREF="filter-file.html#PREDEFINED-FILTERS"
+>The Pre-defined Filters</A
+></DT
 ></DL
 ></DD
 ><DT
@@ -729,9 +788,23 @@ HREF="contact.html#CONTACT-SUPPORT"
 ></DT
 ><DT
 >11.2. <A
+HREF="contact.html#REPORTING"
+>Reporting Problems</A
+></DT
+><DD
+><DL
+><DT
+>11.2.1. <A
+HREF="contact.html#CONTACT-ADS"
+>Reporting Ads or Other Configuration Problems</A
+></DT
+><DT
+>11.2.2. <A
 HREF="contact.html#CONTACT-BUGS"
->Report Bugs</A
+>Reporting Bugs</A
 ></DT
+></DL
+></DD
 ><DT
 >11.3. <A
 HREF="contact.html#CONTACT-FEATURE"
@@ -739,11 +812,6 @@ HREF="contact.html#CONTACT-FEATURE"
 ></DT
 ><DT
 >11.4. <A
-HREF="contact.html#CONTACT-ADS"
->Report Ads or Other Actions-Related Problems</A
-></DT
-><DT
->11.5. <A
 HREF="contact.html#CONTACT-OTHER"
 >Other</A
 ></DT
@@ -761,7 +829,7 @@ CLASS="APPLICATION"
 ><DL
 ><DT
 >12.1. <A
-HREF="copyright.html#AEN2972"
+HREF="copyright.html#AEN4394"
 >License</A
 ></DT
 ><DT
@@ -795,7 +863,7 @@ HREF="appendix.html#REGEX"
 ></DT
 ><DT
 >14.2. <A
-HREF="appendix.html#AEN3218"
+HREF="appendix.html#AEN4640"
 ><SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -830,6 +898,7 @@ CLASS="NAVFOOTER"
 ><HR
 ALIGN="LEFT"
 WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -851,6 +920,7 @@ ALIGN="right"
 VALIGN="top"
 ><A
 HREF="introduction.html"
+ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR