generated
[privoxy.git] / doc / webserver / user-manual / index.html
index 0b8ace4..3bf97fd 100644 (file)
@@ -49,7 +49,7 @@ CLASS="ORGNAME"
 ></DIV
 ><P
 CLASS="PUBDATE"
->$Id: user-manual.sgml,v 1.100 2002/04/29 03:05:55 hal9 Exp $<BR></P
+>$Id: user-manual.sgml,v 1.103 2002/05/04 00:40:53 hal9 Exp $<BR></P
 ><DIV
 ><DIV
 CLASS="ABSTRACT"
@@ -121,11 +121,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,56 +135,70 @@ 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
 ></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"
@@ -197,7 +206,7 @@ CLASS="APPLICATION"
 ></A
 ></DT
 ><DT
->6. <A
+>5. <A
 HREF="startup.html"
 >Starting <SPAN
 CLASS="APPLICATION"
@@ -207,49 +216,49 @@ CLASS="APPLICATION"
 ><DD
 ><DL
 ><DT
->6.1. <A
+>5.1. <A
 HREF="startup.html#START-REDHATDEBIAN"
 >RedHat 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,239 +268,239 @@ CLASS="APPLICATION"
 ><DD
 ><DL
 ><DT
->7.1. <A
-HREF="configuration.html#AEN305"
+>6.1. <A
+HREF="configuration.html#AEN346"
 >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#AEN1378"
 >Finding the Right Mix</A
 ></DT
 ><DT
->9.2. <A
-HREF="actions-file.html#AEN1316"
+>8.2. <A
+HREF="actions-file.html#AEN1385"
 >How to Edit</A
 ></DT
 ><DT
->9.3. <A
-HREF="actions-file.html#AEN1322"
+>8.3. <A
+HREF="actions-file.html#AEN1394"
 >How Actions are Applied to URLs</A
 ></DT
 ><DT
->9.4. <A
-HREF="actions-file.html#AEN1336"
+>8.4. <A
+HREF="actions-file.html#AEN1408"
 >Patterns</A
 ></DT
 ><DD
 ><DL
 ><DT
->9.4.1. <A
-HREF="actions-file.html#AEN1376"
+>8.4.1. <A
+HREF="actions-file.html#AEN1448"
 >The Domain Pattern</A
 ></DT
 ><DT
->9.4.2. <A
-HREF="actions-file.html#AEN1438"
+>8.4.2. <A
+HREF="actions-file.html#AEN1510"
 >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"
@@ -499,7 +508,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.2. <A
+>8.5.2. <A
 HREF="actions-file.html#BLOCK"
 ><I
 CLASS="EMPHASIS"
@@ -507,7 +516,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.3. <A
+>8.5.3. <A
 HREF="actions-file.html#DEANIMATE-GIFS"
 ><I
 CLASS="EMPHASIS"
@@ -515,7 +524,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.4. <A
+>8.5.4. <A
 HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
 ><I
 CLASS="EMPHASIS"
@@ -523,7 +532,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.5. <A
+>8.5.5. <A
 HREF="actions-file.html#FAST-REDIRECTS"
 ><I
 CLASS="EMPHASIS"
@@ -531,7 +540,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.6. <A
+>8.5.6. <A
 HREF="actions-file.html#FILTER"
 ><I
 CLASS="EMPHASIS"
@@ -539,7 +548,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.7. <A
+>8.5.7. <A
 HREF="actions-file.html#HIDE-FORWARDED-FOR-HEADERS"
 ><I
 CLASS="EMPHASIS"
@@ -547,7 +556,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.8. <A
+>8.5.8. <A
 HREF="actions-file.html#HIDE-FROM-HEADER"
 ><I
 CLASS="EMPHASIS"
@@ -555,7 +564,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.9. <A
+>8.5.9. <A
 HREF="actions-file.html#HIDE-REFERER"
 ><I
 CLASS="EMPHASIS"
@@ -563,7 +572,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.10. <A
+>8.5.10. <A
 HREF="actions-file.html#HIDE-USER-AGENT"
 ><I
 CLASS="EMPHASIS"
@@ -571,7 +580,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.11. <A
+>8.5.11. <A
 HREF="actions-file.html#HANDLE-AS-IMAGE"
 ><I
 CLASS="EMPHASIS"
@@ -579,7 +588,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.12. <A
+>8.5.12. <A
 HREF="actions-file.html#SET-IMAGE-BLOCKER"
 ><I
 CLASS="EMPHASIS"
@@ -587,7 +596,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.13. <A
+>8.5.13. <A
 HREF="actions-file.html#LIMIT-CONNECT"
 ><I
 CLASS="EMPHASIS"
@@ -595,7 +604,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.14. <A
+>8.5.14. <A
 HREF="actions-file.html#PREVENT-COMPRESSION"
 ><I
 CLASS="EMPHASIS"
@@ -603,7 +612,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.15. <A
+>8.5.15. <A
 HREF="actions-file.html#SESSION-COOKIES-ONLY"
 ><I
 CLASS="EMPHASIS"
@@ -611,7 +620,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.16. <A
+>8.5.16. <A
 HREF="actions-file.html#PREVENT-READING-COOKIES"
 ><I
 CLASS="EMPHASIS"
@@ -619,7 +628,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.17. <A
+>8.5.17. <A
 HREF="actions-file.html#PREVENT-SETTING-COOKIES"
 ><I
 CLASS="EMPHASIS"
@@ -627,7 +636,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.18. <A
+>8.5.18. <A
 HREF="actions-file.html#KILL-POPUP"
 ><I
 CLASS="EMPHASIS"
@@ -638,7 +647,7 @@ NAME="KILL-POPUPS"
 ></A
 ></DT
 ><DT
->9.5.19. <A
+>8.5.19. <A
 HREF="actions-file.html#SEND-VANILLA-WAFER"
 ><I
 CLASS="EMPHASIS"
@@ -646,7 +655,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.20. <A
+>8.5.20. <A
 HREF="actions-file.html#SEND-WAFER"
 ><I
 CLASS="EMPHASIS"
@@ -654,34 +663,34 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.21. <A
-HREF="actions-file.html#AEN2206"
+>8.5.21. <A
+HREF="actions-file.html#AEN2289"
 >Summary</A
 ></DT
 ><DT
->9.5.22. <A
+>8.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
 ></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"
+>9.1. <A
+HREF="filter-file.html#AEN2432"
 >The <I
 CLASS="EMPHASIS"
 >+filter</I
@@ -690,12 +699,12 @@ CLASS="EMPHASIS"
 ></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 +712,71 @@ 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
 ></DT
 ><DT
->12.3. <A
+>11.3. <A
 HREF="contact.html#CONTACT-FEATURE"
 >Request new features</A
 ></DT
 ><DT
->12.4. <A
+>11.4. <A
 HREF="contact.html#CONTACT-ADS"
 >Report ads or other filter 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
 ></DT
 ><DD
 ><DL
 ><DT
->13.1. <A
-HREF="copyright.html#AEN2410"
+>12.1. <A
+HREF="copyright.html#AEN2493"
 >Copyright</A
 ></DT
 ><DT
->13.2. <A
+>12.2. <A
 HREF="copyright.html#HISTORY"
 >History</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#AEN2718"
 ><SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -776,19 +785,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 +805,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"