Added style variant without TOC for the homepage
[privoxy.git] / doc / webserver / user-manual / index.html
index 4ead0e2..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.91 2002/04/24 02:39:31 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"
@@ -59,9 +55,6 @@ NAME="AEN9"
 ><P
 ></P
 ><P
-> 
- </P
-><P
 >  The user manual gives users information on how to install, configure and use
   <A
 HREF="http://www.privoxy.org/"
@@ -71,7 +64,7 @@ CLASS="APPLICATION"
 >Privoxy</SPAN
 ></A
 >.
 </P
+ </P
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -110,7 +103,7 @@ TARGET="_top"
 >Contact section</A
 > on how to
   contact the developers.
 </P
+ </P
 ><P
 ></P
 ></DIV
@@ -124,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
@@ -137,70 +125,75 @@ HREF="introduction.html"
 ><DL
 ><DT
 >1.1. <A
-HREF="introduction.html#NEWFEATURES"
->New Features</A
+HREF="introduction.html#FEATURES"
+>Features</A
 ></DT
 ></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
->3.1.1. <A
+>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.1.2. <A
+>2.1.2. <A
 HREF="installation.html#INSTALLATION-DEB"
 >Debian</A
 ></DT
 ><DT
->3.1.3. <A
+>2.1.3. <A
 HREF="installation.html#INSTALLATION-PACK-WIN"
 >Windows</A
 ></DT
 ><DT
->3.1.4. <A
+>2.1.4. <A
 HREF="installation.html#INSTALLATION-PACK-BINTGZ"
 >Solaris, NetBSD, FreeBSD, HP-UX</A
 ></DT
 ><DT
->3.1.5. <A
+>2.1.5. <A
 HREF="installation.html#INSTALLATION-OS2"
 >OS/2</A
 ></DT
 ><DT
->3.1.6. <A
+>2.1.6. <A
 HREF="installation.html#INSTALLATION-MAC"
 >Max OSX</A
 ></DT
 ><DT
->3.1.7. <A
+>2.1.7. <A
 HREF="installation.html#INSTALLATION-AMIGA"
 >AmigaOS</A
 ></DT
 ></DL
 ></DD
 ><DT
->3.2. <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
 >4. <A
 HREF="quickstart.html"
 >Quickstart to Using <SPAN
@@ -212,26 +205,65 @@ CLASS="APPLICATION"
 ><DL
 ><DT
 >4.1. <A
-HREF="quickstart.html#UPGRADERSNOTE"
->Note to Upgraders</A
+HREF="quickstart.html#QUICKSTART-AD-BLOCKING"
+>Quickstart to Ad Blocking</A
 ></DT
+></DL
+></DD
 ><DT
->4.2. <A
-HREF="quickstart.html#STARTUP"
+>5. <A
+HREF="startup.html"
 >Starting <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 ></A
 ></DT
+><DD
+><DL
 ><DT
->4.3. <A
-HREF="quickstart.html#CMDOPTIONS"
+>5.1. <A
+HREF="startup.html#START-REDHATDEBIAN"
+>RedHat, Conectiva and Debian</A
+></DT
+><DT
+>5.2. <A
+HREF="startup.html#START-SUSE"
+>SuSE</A
+></DT
+><DT
+>5.3. <A
+HREF="startup.html#START-WINDOWS"
+>Windows</A
+></DT
+><DT
+>5.4. <A
+HREF="startup.html#START-UNICES"
+>Solaris, NetBSD, FreeBSD, HP-UX and others</A
+></DT
+><DT
+>5.5. <A
+HREF="startup.html#START-OS2"
+>OS/2</A
+></DT
+><DT
+>5.6. <A
+HREF="startup.html#START-MACOSX"
+>MAX OSX</A
+></DT
+><DT
+>5.7. <A
+HREF="startup.html#START-AMIGAOS"
+>AmigaOS</A
+></DT
+><DT
+>5.8. <A
+HREF="startup.html#CMDOPTIONS"
 >Command Line Options</A
 ></DT
 ></DL
 ></DD
 ><DT
->5. <A
+>6. <A
 HREF="configuration.html"
 ><SPAN
 CLASS="APPLICATION"
@@ -241,110 +273,454 @@ CLASS="APPLICATION"
 ><DD
 ><DL
 ><DT
->5.1. <A
-HREF="configuration.html#AEN324"
+>6.1. <A
+HREF="configuration.html#AEN481"
 >Controlling <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > with Your Web Browser</A
 ></DT
 ><DT
->5.2. <A
-HREF="configuration.html#AEN343"
+>6.2. <A
+HREF="configuration.html#CONFOVERVIEW"
 >Configuration Files Overview</A
 ></DT
+></DL
+></DD
 ><DT
->5.3. <A
-HREF="configuration.html#AEN383"
+>7. <A
+HREF="config.html"
 >The Main Configuration File</A
 ></DT
 ><DD
 ><DL
 ><DT
->5.3.1. <A
-HREF="configuration.html#AEN402"
+>7.1. <A
+HREF="config.html#CONF-LOG-LOC"
 >Configuration and Log File Locations</A
 ></DT
+><DD
+><DL
+><DT
+>7.1.1. <A
+HREF="config.html#CONFDIR"
+>confdir</A
+></DT
+><DT
+>7.1.2. <A
+HREF="config.html#LOGDIR"
+>logdir</A
+></DT
+><DT
+>7.1.3. <A
+HREF="config.html#ACTIONSFILE"
+>actionsfile</A
+></DT
+><DT
+>7.1.4. <A
+HREF="config.html#FILTERFILE"
+>filterfile</A
+></DT
+><DT
+>7.1.5. <A
+HREF="config.html#LOGFILE"
+>logfile</A
+></DT
+><DT
+>7.1.6. <A
+HREF="config.html#JARFILE"
+>jarfile</A
+></DT
+><DT
+>7.1.7. <A
+HREF="config.html#TRUSTFILE"
+>trustfile</A
+></DT
+></DL
+></DD
 ><DT
->5.3.2. <A
-HREF="configuration.html#AEN622"
+>7.2. <A
+HREF="config.html#LOCAL-SET-UP"
 >Local Set-up Documentation</A
 ></DT
+><DD
+><DL
+><DT
+>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
+>7.2.3. <A
+HREF="config.html#ADMIN-ADDRESS"
+>admin-address</A
+></DT
+><DT
+>7.2.4. <A
+HREF="config.html#PROXY-INFO-URL"
+>proxy-info-url</A
+></DT
+></DL
+></DD
 ><DT
->5.3.3. <A
-HREF="configuration.html#AEN706"
+>7.3. <A
+HREF="config.html#DEBUGGING"
 >Debugging</A
 ></DT
+><DD
+><DL
+><DT
+>7.3.1. <A
+HREF="config.html#DEBUG"
+>debug</A
+></DT
+><DT
+>7.3.2. <A
+HREF="config.html#SINGLE-THREADED"
+>single-threaded</A
+></DT
+></DL
+></DD
 ><DT
->5.3.4. <A
-HREF="configuration.html#AEN772"
+>7.4. <A
+HREF="config.html#ACCESS-CONTROL"
 >Access Control and Security</A
 ></DT
+><DD
+><DL
+><DT
+>7.4.1. <A
+HREF="config.html#LISTEN-ADDRESS"
+>listen-address</A
+></DT
+><DT
+>7.4.2. <A
+HREF="config.html#TOGGLE"
+>toggle</A
+></DT
+><DT
+>7.4.3. <A
+HREF="config.html#ENABLE-REMOTE-TOGGLE"
+>enable-remote-toggle</A
+></DT
 ><DT
->5.3.5. <A
-HREF="configuration.html#FORWARDING"
+>7.4.4. <A
+HREF="config.html#ENABLE-EDIT-ACTIONS"
+>enable-edit-actions</A
+></DT
+><DT
+>7.4.5. <A
+HREF="config.html#ACLS"
+>ACLs: permit-access and deny-access</A
+></DT
+><DT
+>7.4.6. <A
+HREF="config.html#BUFFER-LIMIT"
+>buffer-limit</A
+></DT
+></DL
+></DD
+><DT
+>7.5. <A
+HREF="config.html#FORWARDING"
 >Forwarding</A
 ></DT
+><DD
+><DL
+><DT
+>7.5.1. <A
+HREF="config.html#FORWARD"
+>forward</A
+></DT
 ><DT
->5.3.6. <A
-HREF="configuration.html#AEN1143"
+>7.5.2. <A
+HREF="config.html#SOCKS"
+>forward-socks4 and forward-socks4a</A
+></DT
+><DT
+>7.5.3. <A
+HREF="config.html#ADVANCED-FORWARDING-EXAMPLES"
+>Advanced Forwarding Examples</A
+></DT
+></DL
+></DD
+><DT
+>7.6. <A
+HREF="config.html#WINDOWS-GUI"
 >Windows GUI Options</A
 ></DT
 ></DL
 ></DD
 ><DT
->5.4. <A
-HREF="configuration.html#ACTIONSFILE"
->The Actions File</A
+>8. <A
+HREF="actions-file.html"
+>Actions Files</A
 ></DT
 ><DD
 ><DL
 ><DT
->5.4.1. <A
-HREF="configuration.html#AEN1234"
+>8.1. <A
+HREF="actions-file.html#AEN1527"
 >Finding the Right Mix</A
 ></DT
 ><DT
->5.4.2. <A
-HREF="configuration.html#AEN1240"
+>8.2. <A
+HREF="actions-file.html#AEN1534"
 >How to Edit</A
 ></DT
 ><DT
->5.4.3. <A
-HREF="configuration.html#AEN1247"
+>8.3. <A
+HREF="actions-file.html#ACTIONS-APPLY"
 >How Actions are Applied to URLs</A
 ></DT
 ><DT
->5.4.4. <A
-HREF="configuration.html#AEN1256"
+>8.4. <A
+HREF="actions-file.html#AF-PATTERNS"
 >Patterns</A
 ></DT
+><DD
+><DL
+><DT
+>8.4.1. <A
+HREF="actions-file.html#AEN1597"
+>The Domain Pattern</A
+></DT
 ><DT
->5.4.5. <A
-HREF="configuration.html#ACTIONS"
+>8.4.2. <A
+HREF="actions-file.html#AEN1659"
+>The Path Pattern</A
+></DT
+></DL
+></DD
+><DT
+>8.5. <A
+HREF="actions-file.html#ACTIONS"
 >Actions</A
 ></DT
+><DD
+><DL
+><DT
+>8.5.1. <A
+HREF="actions-file.html#ADD-HEADER"
+><I
+CLASS="EMPHASIS"
+>add-header</I
+></A
+></DT
+><DT
+>8.5.2. <A
+HREF="actions-file.html#BLOCK"
+><I
+CLASS="EMPHASIS"
+>block</I
+></A
+></DT
+><DT
+>8.5.3. <A
+HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
+><I
+CLASS="EMPHASIS"
+>crunch-incoming-cookies</I
+></A
+></DT
+><DT
+>8.5.4. <A
+HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
+><I
+CLASS="EMPHASIS"
+>crunch-outgoing-cookies</I
+></A
+></DT
+><DT
+>8.5.5. <A
+HREF="actions-file.html#DEANIMATE-GIFS"
+><I
+CLASS="EMPHASIS"
+>deanimate-gifs</I
+></A
+></DT
+><DT
+>8.5.6. <A
+HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
+><I
+CLASS="EMPHASIS"
+>downgrade-http-version</I
+></A
+></DT
+><DT
+>8.5.7. <A
+HREF="actions-file.html#FAST-REDIRECTS"
+><I
+CLASS="EMPHASIS"
+>fast-redirects</I
+></A
+></DT
+><DT
+>8.5.8. <A
+HREF="actions-file.html#FILTER"
+><I
+CLASS="EMPHASIS"
+>filter</I
+></A
+></DT
+><DT
+>8.5.9. <A
+HREF="actions-file.html#HANDLE-AS-IMAGE"
+><I
+CLASS="EMPHASIS"
+>handle-as-image</I
+></A
+></DT
+><DT
+>8.5.10. <A
+HREF="actions-file.html#HIDE-FORWARDED-FOR-HEADERS"
+><I
+CLASS="EMPHASIS"
+>hide-forwarded-for-headers</I
+></A
+></DT
+><DT
+>8.5.11. <A
+HREF="actions-file.html#HIDE-FROM-HEADER"
+><I
+CLASS="EMPHASIS"
+>hide-from-header</I
+></A
+></DT
+><DT
+>8.5.12. <A
+HREF="actions-file.html#HIDE-REFERRER"
+><I
+CLASS="EMPHASIS"
+>hide-referrer</I
+></A
+></DT
+><DT
+>8.5.13. <A
+HREF="actions-file.html#HIDE-USER-AGENT"
+><I
+CLASS="EMPHASIS"
+>hide-user-agent</I
+></A
+></DT
+><DT
+>8.5.14. <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
+HREF="actions-file.html#LIMIT-CONNECT"
+><I
+CLASS="EMPHASIS"
+>limit-connect</I
+></A
+></DT
+><DT
+>8.5.16. <A
+HREF="actions-file.html#PREVENT-COMPRESSION"
+><I
+CLASS="EMPHASIS"
+>prevent-compression</I
+></A
+></DT
+><DT
+>8.5.17. <A
+HREF="actions-file.html#SEND-VANILLA-WAFER"
+><I
+CLASS="EMPHASIS"
+>send-vanilla-wafer</I
+></A
+></DT
+><DT
+>8.5.18. <A
+HREF="actions-file.html#SEND-WAFER"
+><I
+CLASS="EMPHASIS"
+>send-wafer</I
+></A
+></DT
+><DT
+>8.5.19. <A
+HREF="actions-file.html#SESSION-COOKIES-ONLY"
+><I
+CLASS="EMPHASIS"
+>session-cookies-only</I
+></A
+></DT
 ><DT
->5.4.6. <A
-HREF="configuration.html#AEN2110"
+>8.5.20. <A
+HREF="actions-file.html#SET-IMAGE-BLOCKER"
+><I
+CLASS="EMPHASIS"
+>set-image-blocker</I
+></A
+></DT
+><DT
+>8.5.21. <A
+HREF="actions-file.html#AEN2593"
+>Summary</A
+></DT
+></DL
+></DD
+><DT
+>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
->5.5. <A
-HREF="configuration.html#FILTERFILE"
+>9. <A
+HREF="filter-file.html"
 >The Filter File</A
 ></DT
+><DD
+><DL
 ><DT
->5.6. <A
-HREF="configuration.html#AEN2176"
->Templates</A
+>9.1. <A
+HREF="filter-file.html#AEN2902"
+>Filter File Tutorial</A
 ></DT
 ></DL
 ></DD
 ><DT
->6. <A
+>10. <A
+HREF="templates.html"
+>Templates</A
+></DT
+><DT
+>11. <A
 HREF="contact.html"
 >Contacting the Developers, Bug Reporting and Feature
 Requests</A
@@ -352,54 +728,79 @@ Requests</A
 ><DD
 ><DL
 ><DT
->6.1. <A
-HREF="contact.html#SUBMITACTIONS"
->Submitting Ads and <SPAN
-CLASS="QUOTE"
->"Action"</SPAN
-> Problems</A
+>11.1. <A
+HREF="contact.html#CONTACT-SUPPORT"
+>Get Support</A
+></DT
+><DT
+>11.2. <A
+HREF="contact.html#CONTACT-BUGS"
+>Report Bugs</A
+></DT
+><DT
+>11.3. <A
+HREF="contact.html#CONTACT-FEATURE"
+>Request New Features</A
+></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
 ></DL
 ></DD
 ><DT
->7. <A
+>12. <A
 HREF="copyright.html"
->Copyright and History</A
+><SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> Copyright, License and History</A
 ></DT
 ><DD
 ><DL
 ><DT
->7.1. <A
-HREF="copyright.html#AEN2227"
->Copyright</A
+>12.1. <A
+HREF="copyright.html#AEN3096"
+>License</A
 ></DT
 ><DT
->7.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
->8. <A
+>13. <A
 HREF="seealso.html"
 >See Also</A
 ></DT
 ><DT
->9. <A
+>14. <A
 HREF="appendix.html"
 >Appendix</A
 ></DT
 ><DD
 ><DL
 ><DT
->9.1. <A
+>14.1. <A
 HREF="appendix.html#REGEX"
 >Regular Expressions</A
 ></DT
 ><DT
->9.2. <A
-HREF="appendix.html#AEN2452"
+>14.2. <A
+HREF="appendix.html#AEN3346"
 ><SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -408,19 +809,19 @@ CLASS="APPLICATION"
 ><DD
 ><DL
 ><DT
->9.2.1. <A
+>14.2.1. <A
 HREF="appendix.html#BOOKMARKLETS"
 >Bookmarklets</A
 ></DT
 ></DL
 ></DD
 ><DT
->9.3. <A
+>14.3. <A
 HREF="appendix.html#CHAIN"
 >Chain of Events</A
 ></DT
 ><DT
->9.4. <A
+>14.4. <A
 HREF="appendix.html#ACTIONSANAT"
 >Anatomy of an Action</A
 ></DT
@@ -428,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"