Added style variant without TOC for the homepage
[privoxy.git] / doc / webserver / user-manual / index.html
index 0b8ace4..1320e4f 100644 (file)
@@ -29,27 +29,23 @@ CLASS="TITLE"
 NAME="AEN2"
 >Privoxy User Manual</A
 ></H1
-><DIV
-CLASS="AUTHORGROUP"
-><A
-NAME="AEN5"
-></A
-><H3
-CLASS="AUTHOR"
-><A
-NAME="AEN6"
-></A
-></H3
-><DIV
-CLASS="AFFILIATION"
-><SPAN
-CLASS="ORGNAME"
->By: Privoxy Developers<BR></SPAN
-></DIV
-></DIV
 ><P
 CLASS="PUBDATE"
->$Id: user-manual.sgml,v 1.100 2002/04/29 03:05:55 hal9 Exp $<BR></P
+> <SUB
+> <A
+HREF="copyright.html"
+>Copyright</A
+> © 2001, 2002 by 
+ <A
+HREF="http://www.privoxy.org"
+TARGET="_top"
+>Privoxy Developers</A
+>
+ </SUB
+><BR></P
+><P
+CLASS="PUBDATE"
+>$Id: user-manual.sgml,v 1.118 2002/05/21 04:54:55 hal9 Exp $<BR></P
 ><DIV
 ><DIV
 CLASS="ABSTRACT"
@@ -68,7 +64,7 @@ CLASS="APPLICATION"
 >Privoxy</SPAN
 ></A
 >.
 </P
+ </P
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -107,7 +103,7 @@ TARGET="_top"
 >Contact section</A
 > on how to
   contact the developers.
 </P
+ </P
 ><P
 ></P
 ></DIV
@@ -121,11 +117,6 @@ CLASS="TOC"
 >Table of Contents</B
 ></DT
 ><DT
-><A
-HREF="index.html#INTRO"
-></A
-></DT
-><DT
 >1. <A
 HREF="introduction.html"
 >Introduction</A
@@ -140,64 +131,87 @@ HREF="introduction.html#FEATURES"
 ></DL
 ></DD
 ><DT
->3. <A
+>2. <A
 HREF="installation.html"
 >Installation</A
 ></DT
 ><DD
 ><DL
 ><DT
->3.1. <A
+>2.1. <A
+HREF="installation.html#INSTALLATION-PACKAGES"
+>Binary Packages</A
+></DT
+><DD
+><DL
+><DT
+>2.1.1. <A
 HREF="installation.html#INSTALLATION-PACK-RPM"
->Red Hat and SuSE RPMs</A
+>Red Hat, SuSE and Conectiva RPMs</A
 ></DT
 ><DT
->3.2. <A
+>2.1.2. <A
 HREF="installation.html#INSTALLATION-DEB"
 >Debian</A
 ></DT
 ><DT
->3.3. <A
+>2.1.3. <A
 HREF="installation.html#INSTALLATION-PACK-WIN"
 >Windows</A
 ></DT
 ><DT
->3.4. <A
+>2.1.4. <A
 HREF="installation.html#INSTALLATION-PACK-BINTGZ"
 >Solaris, NetBSD, FreeBSD, HP-UX</A
 ></DT
 ><DT
->3.5. <A
+>2.1.5. <A
 HREF="installation.html#INSTALLATION-OS2"
 >OS/2</A
 ></DT
 ><DT
->3.6. <A
+>2.1.6. <A
 HREF="installation.html#INSTALLATION-MAC"
 >Max OSX</A
 ></DT
 ><DT
->3.7. <A
+>2.1.7. <A
 HREF="installation.html#INSTALLATION-AMIGA"
 >AmigaOS</A
 ></DT
 ></DL
 ></DD
 ><DT
->4. <A
+>2.2. <A
+HREF="installation.html#INSTALLATION-SOURCE"
+>Building from Source</A
+></DT
+></DL
+></DD
+><DT
+>3. <A
 HREF="upgradersnote.html"
 >Note to Upgraders</A
 ></DT
 ><DT
->5. <A
+>4. <A
 HREF="quickstart.html"
 >Quickstart to Using <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 ></A
 ></DT
+><DD
+><DL
 ><DT
->6. <A
+>4.1. <A
+HREF="quickstart.html#QUICKSTART-AD-BLOCKING"
+>Quickstart to Ad Blocking</A
+></DT
+></DL
+></DD
+><DT
+>5. <A
 HREF="startup.html"
 >Starting <SPAN
 CLASS="APPLICATION"
@@ -207,49 +221,49 @@ CLASS="APPLICATION"
 ><DD
 ><DL
 ><DT
->6.1. <A
+>5.1. <A
 HREF="startup.html#START-REDHATDEBIAN"
->RedHat and Debian</A
+>RedHat, Conectiva and Debian</A
 ></DT
 ><DT
->6.2. <A
+>5.2. <A
 HREF="startup.html#START-SUSE"
 >SuSE</A
 ></DT
 ><DT
->6.3. <A
+>5.3. <A
 HREF="startup.html#START-WINDOWS"
 >Windows</A
 ></DT
 ><DT
->6.4. <A
+>5.4. <A
 HREF="startup.html#START-UNICES"
 >Solaris, NetBSD, FreeBSD, HP-UX and others</A
 ></DT
 ><DT
->6.5. <A
+>5.5. <A
 HREF="startup.html#START-OS2"
 >OS/2</A
 ></DT
 ><DT
->6.6. <A
+>5.6. <A
 HREF="startup.html#START-MACOSX"
 >MAX OSX</A
 ></DT
 ><DT
->6.7. <A
+>5.7. <A
 HREF="startup.html#START-AMIGAOS"
 >AmigaOS</A
 ></DT
 ><DT
->6.8. <A
+>5.8. <A
 HREF="startup.html#CMDOPTIONS"
 >Command Line Options</A
 ></DT
 ></DL
 ></DD
 ><DT
->7. <A
+>6. <A
 HREF="configuration.html"
 ><SPAN
 CLASS="APPLICATION"
@@ -259,443 +273,454 @@ CLASS="APPLICATION"
 ><DD
 ><DL
 ><DT
->7.1. <A
-HREF="configuration.html#AEN305"
+>6.1. <A
+HREF="configuration.html#AEN481"
 >Controlling <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > with Your Web Browser</A
 ></DT
 ><DT
->7.2. <A
+>6.2. <A
 HREF="configuration.html#CONFOVERVIEW"
 >Configuration Files Overview</A
 ></DT
 ></DL
 ></DD
 ><DT
->8. <A
+>7. <A
 HREF="config.html"
 >The Main Configuration File</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.1. <A
+>7.1. <A
 HREF="config.html#CONF-LOG-LOC"
 >Configuration and Log File Locations</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.1.1. <A
+>7.1.1. <A
 HREF="config.html#CONFDIR"
 >confdir</A
 ></DT
 ><DT
->8.1.2. <A
+>7.1.2. <A
 HREF="config.html#LOGDIR"
 >logdir</A
 ></DT
 ><DT
->8.1.3. <A
+>7.1.3. <A
 HREF="config.html#ACTIONSFILE"
 >actionsfile</A
 ></DT
 ><DT
->8.1.4. <A
+>7.1.4. <A
 HREF="config.html#FILTERFILE"
 >filterfile</A
 ></DT
 ><DT
->8.1.5. <A
+>7.1.5. <A
 HREF="config.html#LOGFILE"
 >logfile</A
 ></DT
 ><DT
->8.1.6. <A
+>7.1.6. <A
 HREF="config.html#JARFILE"
 >jarfile</A
 ></DT
 ><DT
->8.1.7. <A
+>7.1.7. <A
 HREF="config.html#TRUSTFILE"
 >trustfile</A
 ></DT
-><DT
->8.1.8. <A
-HREF="config.html#USER-MANUAL"
->user-manual</A
-></DT
 ></DL
 ></DD
 ><DT
->8.2. <A
+>7.2. <A
 HREF="config.html#LOCAL-SET-UP"
 >Local Set-up Documentation</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.2.1. <A
+>7.2.1. <A
+HREF="config.html#USER-MANUAL"
+>user-manual</A
+></DT
+><DT
+>7.2.2. <A
 HREF="config.html#TRUST-INFO-URL"
 >trust-info-url</A
 ></DT
 ><DT
->8.2.2. <A
+>7.2.3. <A
 HREF="config.html#ADMIN-ADDRESS"
 >admin-address</A
 ></DT
 ><DT
->8.2.3. <A
+>7.2.4. <A
 HREF="config.html#PROXY-INFO-URL"
 >proxy-info-url</A
 ></DT
 ></DL
 ></DD
 ><DT
->8.3. <A
+>7.3. <A
 HREF="config.html#DEBUGGING"
 >Debugging</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.3.1. <A
+>7.3.1. <A
 HREF="config.html#DEBUG"
 >debug</A
 ></DT
 ><DT
->8.3.2. <A
+>7.3.2. <A
 HREF="config.html#SINGLE-THREADED"
 >single-threaded</A
 ></DT
 ></DL
 ></DD
 ><DT
->8.4. <A
+>7.4. <A
 HREF="config.html#ACCESS-CONTROL"
 >Access Control and Security</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.4.1. <A
+>7.4.1. <A
 HREF="config.html#LISTEN-ADDRESS"
 >listen-address</A
 ></DT
 ><DT
->8.4.2. <A
+>7.4.2. <A
 HREF="config.html#TOGGLE"
 >toggle</A
 ></DT
 ><DT
->8.4.3. <A
+>7.4.3. <A
 HREF="config.html#ENABLE-REMOTE-TOGGLE"
 >enable-remote-toggle</A
 ></DT
 ><DT
->8.4.4. <A
+>7.4.4. <A
 HREF="config.html#ENABLE-EDIT-ACTIONS"
 >enable-edit-actions</A
 ></DT
 ><DT
->8.4.5. <A
+>7.4.5. <A
 HREF="config.html#ACLS"
 >ACLs: permit-access and deny-access</A
 ></DT
 ><DT
->8.4.6. <A
+>7.4.6. <A
 HREF="config.html#BUFFER-LIMIT"
 >buffer-limit</A
 ></DT
 ></DL
 ></DD
 ><DT
->8.5. <A
+>7.5. <A
 HREF="config.html#FORWARDING"
 >Forwarding</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.5.1. <A
+>7.5.1. <A
 HREF="config.html#FORWARD"
 >forward</A
 ></DT
 ><DT
->8.5.2. <A
+>7.5.2. <A
 HREF="config.html#SOCKS"
 >forward-socks4 and forward-socks4a</A
 ></DT
 ><DT
->8.5.3. <A
+>7.5.3. <A
 HREF="config.html#ADVANCED-FORWARDING-EXAMPLES"
 >Advanced Forwarding Examples</A
 ></DT
 ></DL
 ></DD
 ><DT
->8.6. <A
+>7.6. <A
 HREF="config.html#WINDOWS-GUI"
 >Windows GUI Options</A
 ></DT
 ></DL
 ></DD
 ><DT
->9. <A
+>8. <A
 HREF="actions-file.html"
 >Actions Files</A
 ></DT
 ><DD
 ><DL
 ><DT
->9.1. <A
-HREF="actions-file.html#AEN1309"
+>8.1. <A
+HREF="actions-file.html#AEN1527"
 >Finding the Right Mix</A
 ></DT
 ><DT
->9.2. <A
-HREF="actions-file.html#AEN1316"
+>8.2. <A
+HREF="actions-file.html#AEN1534"
 >How to Edit</A
 ></DT
 ><DT
->9.3. <A
-HREF="actions-file.html#AEN1322"
+>8.3. <A
+HREF="actions-file.html#ACTIONS-APPLY"
 >How Actions are Applied to URLs</A
 ></DT
 ><DT
->9.4. <A
-HREF="actions-file.html#AEN1336"
+>8.4. <A
+HREF="actions-file.html#AF-PATTERNS"
 >Patterns</A
 ></DT
 ><DD
 ><DL
 ><DT
->9.4.1. <A
-HREF="actions-file.html#AEN1376"
+>8.4.1. <A
+HREF="actions-file.html#AEN1597"
 >The Domain Pattern</A
 ></DT
 ><DT
->9.4.2. <A
-HREF="actions-file.html#AEN1438"
+>8.4.2. <A
+HREF="actions-file.html#AEN1659"
 >The Path Pattern</A
 ></DT
 ></DL
 ></DD
 ><DT
->9.5. <A
+>8.5. <A
 HREF="actions-file.html#ACTIONS"
 >Actions</A
 ></DT
 ><DD
 ><DL
 ><DT
->9.5.1. <A
+>8.5.1. <A
 HREF="actions-file.html#ADD-HEADER"
 ><I
 CLASS="EMPHASIS"
->+add-header</I
+>add-header</I
 ></A
 ></DT
 ><DT
->9.5.2. <A
+>8.5.2. <A
 HREF="actions-file.html#BLOCK"
 ><I
 CLASS="EMPHASIS"
->+block</I
+>block</I
 ></A
 ></DT
 ><DT
->9.5.3. <A
-HREF="actions-file.html#DEANIMATE-GIFS"
+>8.5.3. <A
+HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
 ><I
 CLASS="EMPHASIS"
->+deanimate-gifs</I
+>crunch-incoming-cookies</I
 ></A
 ></DT
 ><DT
->9.5.4. <A
-HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
+>8.5.4. <A
+HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
 ><I
 CLASS="EMPHASIS"
->+downgrade-http-version</I
+>crunch-outgoing-cookies</I
 ></A
 ></DT
 ><DT
->9.5.5. <A
-HREF="actions-file.html#FAST-REDIRECTS"
+>8.5.5. <A
+HREF="actions-file.html#DEANIMATE-GIFS"
 ><I
 CLASS="EMPHASIS"
->+fast-redirects</I
+>deanimate-gifs</I
 ></A
 ></DT
 ><DT
->9.5.6. <A
-HREF="actions-file.html#FILTER"
+>8.5.6. <A
+HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
 ><I
 CLASS="EMPHASIS"
->+filter</I
+>downgrade-http-version</I
 ></A
 ></DT
 ><DT
->9.5.7. <A
-HREF="actions-file.html#HIDE-FORWARDED-FOR-HEADERS"
+>8.5.7. <A
+HREF="actions-file.html#FAST-REDIRECTS"
 ><I
 CLASS="EMPHASIS"
->+hide-forwarded-for-headers</I
+>fast-redirects</I
 ></A
 ></DT
 ><DT
->9.5.8. <A
-HREF="actions-file.html#HIDE-FROM-HEADER"
+>8.5.8. <A
+HREF="actions-file.html#FILTER"
 ><I
 CLASS="EMPHASIS"
->+hide-from-header</I
+>filter</I
 ></A
 ></DT
 ><DT
->9.5.9. <A
-HREF="actions-file.html#HIDE-REFERER"
+>8.5.9. <A
+HREF="actions-file.html#HANDLE-AS-IMAGE"
 ><I
 CLASS="EMPHASIS"
->+hide-referer</I
+>handle-as-image</I
 ></A
 ></DT
 ><DT
->9.5.10. <A
-HREF="actions-file.html#HIDE-USER-AGENT"
+>8.5.10. <A
+HREF="actions-file.html#HIDE-FORWARDED-FOR-HEADERS"
 ><I
 CLASS="EMPHASIS"
->+hide-user-agent</I
+>hide-forwarded-for-headers</I
 ></A
 ></DT
 ><DT
->9.5.11. <A
-HREF="actions-file.html#HANDLE-AS-IMAGE"
+>8.5.11. <A
+HREF="actions-file.html#HIDE-FROM-HEADER"
 ><I
 CLASS="EMPHASIS"
->+handle-as-image</I
+>hide-from-header</I
 ></A
 ></DT
 ><DT
->9.5.12. <A
-HREF="actions-file.html#SET-IMAGE-BLOCKER"
+>8.5.12. <A
+HREF="actions-file.html#HIDE-REFERRER"
 ><I
 CLASS="EMPHASIS"
->+set-image-blocker</I
+>hide-referrer</I
 ></A
 ></DT
 ><DT
->9.5.13. <A
-HREF="actions-file.html#LIMIT-CONNECT"
+>8.5.13. <A
+HREF="actions-file.html#HIDE-USER-AGENT"
 ><I
 CLASS="EMPHASIS"
->+limit-connect</I
+>hide-user-agent</I
 ></A
 ></DT
 ><DT
->9.5.14. <A
-HREF="actions-file.html#PREVENT-COMPRESSION"
+>8.5.14. <A
+HREF="actions-file.html#KILL-POPUPS"
 ><I
 CLASS="EMPHASIS"
->+prevent-compression</I
+>kill-popups<A
+NAME="KILL-POPUP"
+></A
+></I
 ></A
 ></DT
 ><DT
->9.5.15. <A
-HREF="actions-file.html#SESSION-COOKIES-ONLY"
+>8.5.15. <A
+HREF="actions-file.html#LIMIT-CONNECT"
 ><I
 CLASS="EMPHASIS"
->+session-cookies-only</I
+>limit-connect</I
 ></A
 ></DT
 ><DT
->9.5.16. <A
-HREF="actions-file.html#PREVENT-READING-COOKIES"
+>8.5.16. <A
+HREF="actions-file.html#PREVENT-COMPRESSION"
 ><I
 CLASS="EMPHASIS"
->+prevent-reading-cookies</I
+>prevent-compression</I
 ></A
 ></DT
 ><DT
->9.5.17. <A
-HREF="actions-file.html#PREVENT-SETTING-COOKIES"
+>8.5.17. <A
+HREF="actions-file.html#SEND-VANILLA-WAFER"
 ><I
 CLASS="EMPHASIS"
->+prevent-setting-cookies</I
+>send-vanilla-wafer</I
 ></A
 ></DT
 ><DT
->9.5.18. <A
-HREF="actions-file.html#KILL-POPUP"
+>8.5.18. <A
+HREF="actions-file.html#SEND-WAFER"
 ><I
 CLASS="EMPHASIS"
->+kill-popups<A
-NAME="KILL-POPUPS"
-></A
-></I
+>send-wafer</I
 ></A
 ></DT
 ><DT
->9.5.19. <A
-HREF="actions-file.html#SEND-VANILLA-WAFER"
+>8.5.19. <A
+HREF="actions-file.html#SESSION-COOKIES-ONLY"
 ><I
 CLASS="EMPHASIS"
->+send-vanilla-wafer</I
+>session-cookies-only</I
 ></A
 ></DT
 ><DT
->9.5.20. <A
-HREF="actions-file.html#SEND-WAFER"
+>8.5.20. <A
+HREF="actions-file.html#SET-IMAGE-BLOCKER"
 ><I
 CLASS="EMPHASIS"
->+send-wafer</I
+>set-image-blocker</I
 ></A
 ></DT
 ><DT
->9.5.21. <A
-HREF="actions-file.html#AEN2206"
+>8.5.21. <A
+HREF="actions-file.html#AEN2593"
 >Summary</A
 ></DT
-><DT
->9.5.22. <A
-HREF="actions-file.html#ACT-EXAMPLES"
->Sample Actions Files</A
-></DT
 ></DL
 ></DD
 ><DT
->9.6. <A
+>8.6. <A
 HREF="actions-file.html#ALIASES"
 >Aliases</A
 ></DT
+><DT
+>8.7. <A
+HREF="actions-file.html#ACT-EXAMPLES"
+>Actions Files Tutorial</A
+></DT
+><DD
+><DL
+><DT
+>8.7.1. <A
+HREF="actions-file.html#AEN2645"
+>default.action</A
+></DT
+><DT
+>8.7.2. <A
+HREF="actions-file.html#AEN2799"
+>user.action</A
+></DT
+></DL
+></DD
 ></DL
 ></DD
 ><DT
->10. <A
+>9. <A
 HREF="filter-file.html"
 >The Filter File</A
 ></DT
 ><DD
 ><DL
 ><DT
->10.1. <A
-HREF="filter-file.html#AEN2349"
->The <I
-CLASS="EMPHASIS"
->+filter</I
-> Action</A
+>9.1. <A
+HREF="filter-file.html#AEN2902"
+>Filter File Tutorial</A
 ></DT
 ></DL
 ></DD
 ><DT
->11. <A
+>10. <A
 HREF="templates.html"
 >Templates</A
 ></DT
 ><DT
->12. <A
+>11. <A
 HREF="contact.html"
 >Contacting the Developers, Bug Reporting and Feature
 Requests</A
@@ -703,71 +728,79 @@ Requests</A
 ><DD
 ><DL
 ><DT
->12.1. <A
+>11.1. <A
 HREF="contact.html#CONTACT-SUPPORT"
 >Get Support</A
 ></DT
 ><DT
->12.2. <A
+>11.2. <A
 HREF="contact.html#CONTACT-BUGS"
->Report bugs</A
+>Report Bugs</A
 ></DT
 ><DT
->12.3. <A
+>11.3. <A
 HREF="contact.html#CONTACT-FEATURE"
->Request new features</A
+>Request New Features</A
 ></DT
 ><DT
->12.4. <A
+>11.4. <A
 HREF="contact.html#CONTACT-ADS"
->Report ads or other filter problems</A
+>Report Ads or Other Actions-Related Problems</A
 ></DT
 ><DT
->12.5. <A
+>11.5. <A
 HREF="contact.html#CONTACT-OTHER"
 >Other</A
 ></DT
 ></DL
 ></DD
 ><DT
->13. <A
+>12. <A
 HREF="copyright.html"
->Copyright and History</A
+><SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> Copyright, License and History</A
 ></DT
 ><DD
 ><DL
 ><DT
->13.1. <A
-HREF="copyright.html#AEN2410"
->Copyright</A
+>12.1. <A
+HREF="copyright.html#AEN3096"
+>License</A
 ></DT
 ><DT
->13.2. <A
+>12.2. <A
 HREF="copyright.html#HISTORY"
 >History</A
 ></DT
+><DT
+>12.3. <A
+HREF="copyright.html#AUTHORS"
+>Authors</A
+></DT
 ></DL
 ></DD
 ><DT
->14. <A
+>13. <A
 HREF="seealso.html"
 >See Also</A
 ></DT
 ><DT
->15. <A
+>14. <A
 HREF="appendix.html"
 >Appendix</A
 ></DT
 ><DD
 ><DL
 ><DT
->15.1. <A
+>14.1. <A
 HREF="appendix.html#REGEX"
 >Regular Expressions</A
 ></DT
 ><DT
->15.2. <A
-HREF="appendix.html#AEN2635"
+>14.2. <A
+HREF="appendix.html#AEN3346"
 ><SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -776,19 +809,19 @@ CLASS="APPLICATION"
 ><DD
 ><DL
 ><DT
->15.2.1. <A
+>14.2.1. <A
 HREF="appendix.html#BOOKMARKLETS"
 >Bookmarklets</A
 ></DT
 ></DL
 ></DD
 ><DT
->15.3. <A
+>14.3. <A
 HREF="appendix.html#CHAIN"
 >Chain of Events</A
 ></DT
 ><DT
->15.4. <A
+>14.4. <A
 HREF="appendix.html#ACTIONSANAT"
 >Anatomy of an Action</A
 ></DT
@@ -796,17 +829,6 @@ HREF="appendix.html#ACTIONSANAT"
 ></DD
 ></DL
 ></DIV
-><DIV
-CLASS="SECT1"
-><H1
-CLASS="SECT1"
-><A
-NAME="INTRO"
-></A
-></H1
-><P
-> </P
-></DIV
 ></DIV
 ><DIV
 CLASS="NAVFOOTER"