generated
[privoxy.git] / doc / webserver / user-manual / index.html
index b52ec30..d9afd90 100644 (file)
@@ -49,7 +49,7 @@ CLASS="ORGNAME"
 ></DIV
 ><P
 CLASS="PUBDATE"
->$Id: user-manual.sgml,v 1.95 2002/04/26 17:23:29 swa Exp $<BR></P
+>$Id: user-manual.sgml,v 1.99 2002/04/28 16:59:05 swa Exp $<BR></P
 ><DIV
 ><DIV
 CLASS="ABSTRACT"
@@ -208,6 +208,41 @@ CLASS="APPLICATION"
 ><DL
 ><DT
 >6.1. <A
+HREF="startup.html#START-REDHATDEBIAN"
+>RedHat and Debian</A
+></DT
+><DT
+>6.2. <A
+HREF="startup.html#START-SUSE"
+>SuSE</A
+></DT
+><DT
+>6.3. <A
+HREF="startup.html#START-WINDOWS"
+>Windows</A
+></DT
+><DT
+>6.4. <A
+HREF="startup.html#START-UNICES"
+>Solaris, NetBSD, FreeBSD, HP-UX and others</A
+></DT
+><DT
+>6.5. <A
+HREF="startup.html#START-OS2"
+>OS/2</A
+></DT
+><DT
+>6.6. <A
+HREF="startup.html#START-MACOSX"
+>MAX OSX</A
+></DT
+><DT
+>6.7. <A
+HREF="startup.html#START-AMIGAOS"
+>AmigaOS</A
+></DT
+><DT
+>6.8. <A
 HREF="startup.html#CMDOPTIONS"
 >Command Line Options</A
 ></DT
@@ -225,7 +260,7 @@ CLASS="APPLICATION"
 ><DL
 ><DT
 >7.1. <A
-HREF="configuration.html#AEN320"
+HREF="configuration.html#AEN305"
 >Controlling <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -236,98 +271,431 @@ CLASS="APPLICATION"
 HREF="configuration.html#CONFOVERVIEW"
 >Configuration Files Overview</A
 ></DT
+></DL
+></DD
 ><DT
->7.3. <A
-HREF="configuration.html#CONFIG"
+>8. <A
+HREF="config.html"
 >The Main Configuration File</A
 ></DT
 ><DD
 ><DL
 ><DT
->7.3.1. <A
-HREF="configuration.html#CONF-LOG-LOC"
+>8.1. <A
+HREF="config.html#CONF-LOG-LOC"
 >Configuration and Log File Locations</A
 ></DT
+><DD
+><DL
 ><DT
->7.3.2. <A
-HREF="configuration.html#LOCAL-SET-UP"
+>8.1.1. <A
+HREF="config.html#CONFDIR"
+>confdir</A
+></DT
+><DT
+>8.1.2. <A
+HREF="config.html#LOGDIR"
+>logdir</A
+></DT
+><DT
+>8.1.3. <A
+HREF="config.html#ACTIONSFILE"
+>actionsfile</A
+></DT
+><DT
+>8.1.4. <A
+HREF="config.html#FILTERFILE"
+>filterfile</A
+></DT
+><DT
+>8.1.5. <A
+HREF="config.html#LOGFILE"
+>logfile</A
+></DT
+><DT
+>8.1.6. <A
+HREF="config.html#JARFILE"
+>jarfile</A
+></DT
+><DT
+>8.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
+HREF="config.html#LOCAL-SET-UP"
 >Local Set-up Documentation</A
 ></DT
+><DD
+><DL
+><DT
+>8.2.1. <A
+HREF="config.html#TRUST-INFO-URL"
+>trust-info-url</A
+></DT
+><DT
+>8.2.2. <A
+HREF="config.html#ADMIN-ADDRESS"
+>admin-address</A
+></DT
+><DT
+>8.2.3. <A
+HREF="config.html#PROXY-INFO-URL"
+>proxy-info-url</A
+></DT
+></DL
+></DD
 ><DT
->7.3.3. <A
-HREF="configuration.html#DEBUGGING"
+>8.3. <A
+HREF="config.html#DEBUGGING"
 >Debugging</A
 ></DT
+><DD
+><DL
+><DT
+>8.3.1. <A
+HREF="config.html#DEBUG"
+>debug</A
+></DT
+><DT
+>8.3.2. <A
+HREF="config.html#SINGLE-THREADED"
+>single-threaded</A
+></DT
+></DL
+></DD
 ><DT
->7.3.4. <A
-HREF="configuration.html#ACCESS-CONTROL"
+>8.4. <A
+HREF="config.html#ACCESS-CONTROL"
 >Access Control and Security</A
 ></DT
+><DD
+><DL
+><DT
+>8.4.1. <A
+HREF="config.html#LISTEN-ADDRESS"
+>listen-address</A
+></DT
+><DT
+>8.4.2. <A
+HREF="config.html#TOGGLE"
+>toggle</A
+></DT
 ><DT
->7.3.5. <A
-HREF="configuration.html#FORWARDING"
+>8.4.3. <A
+HREF="config.html#ENABLE-REMOTE-TOGGLE"
+>enable-remote-toggle</A
+></DT
+><DT
+>8.4.4. <A
+HREF="config.html#ENABLE-EDIT-ACTIONS"
+>enable-edit-actions</A
+></DT
+><DT
+>8.4.5. <A
+HREF="config.html#ACLS"
+>ACLs: permit-access and deny-access</A
+></DT
+><DT
+>8.4.6. <A
+HREF="config.html#BUFFER-LIMIT"
+>buffer-limit</A
+></DT
+></DL
+></DD
+><DT
+>8.5. <A
+HREF="config.html#FORWARDING"
 >Forwarding</A
 ></DT
+><DD
+><DL
+><DT
+>8.5.1. <A
+HREF="config.html#FORWARD"
+>forward</A
+></DT
 ><DT
->7.3.6. <A
-HREF="configuration.html#WINDOWS-GUI"
+>8.5.2. <A
+HREF="config.html#SOCKS"
+>forward-socks4 and forward-socks4a</A
+></DT
+><DT
+>8.5.3. <A
+HREF="config.html#ADVANCED-FORWARDING-EXAMPLES"
+>Advanced Forwarding Examples</A
+></DT
+></DL
+></DD
+><DT
+>8.6. <A
+HREF="config.html#WINDOWS-GUI"
 >Windows GUI Options</A
 ></DT
 ></DL
 ></DD
 ><DT
->7.4. <A
-HREF="configuration.html#ACTIONS-FILE"
+>9. <A
+HREF="actions-file.html"
 >Actions Files</A
 ></DT
 ><DD
 ><DL
 ><DT
->7.4.1. <A
-HREF="configuration.html#AEN1285"
+>9.1. <A
+HREF="actions-file.html#AEN1299"
 >Finding the Right Mix</A
 ></DT
 ><DT
->7.4.2. <A
-HREF="configuration.html#AEN1292"
+>9.2. <A
+HREF="actions-file.html#AEN1306"
 >How to Edit</A
 ></DT
 ><DT
->7.4.3. <A
-HREF="configuration.html#AEN1298"
+>9.3. <A
+HREF="actions-file.html#AEN1312"
 >How Actions are Applied to URLs</A
 ></DT
 ><DT
->7.4.4. <A
-HREF="configuration.html#AEN1312"
+>9.4. <A
+HREF="actions-file.html#AEN1326"
 >Patterns</A
 ></DT
+><DD
+><DL
+><DT
+>9.4.1. <A
+HREF="actions-file.html#AEN1366"
+>The Domain Pattern</A
+></DT
+><DT
+>9.4.2. <A
+HREF="actions-file.html#AEN1428"
+>The Path Pattern</A
+></DT
+></DL
+></DD
 ><DT
->7.4.5. <A
-HREF="configuration.html#ACTIONS"
+>9.5. <A
+HREF="actions-file.html#ACTIONS"
 >Actions</A
 ></DT
+><DD
+><DL
+><DT
+>9.5.1. <A
+HREF="actions-file.html#ADD-HEADER"
+><I
+CLASS="EMPHASIS"
+>+add-header</I
+></A
+></DT
+><DT
+>9.5.2. <A
+HREF="actions-file.html#BLOCK"
+><I
+CLASS="EMPHASIS"
+>+block</I
+></A
+></DT
+><DT
+>9.5.3. <A
+HREF="actions-file.html#DEANIMATE-GIFS"
+><I
+CLASS="EMPHASIS"
+>+deanimate-gifs</I
+></A
+></DT
+><DT
+>9.5.4. <A
+HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
+><I
+CLASS="EMPHASIS"
+>+downgrade-http-version</I
+></A
+></DT
+><DT
+>9.5.5. <A
+HREF="actions-file.html#FAST-REDIRECTS"
+><I
+CLASS="EMPHASIS"
+>+fast-redirects</I
+></A
+></DT
+><DT
+>9.5.6. <A
+HREF="actions-file.html#FILTER"
+><I
+CLASS="EMPHASIS"
+>+filter</I
+></A
+></DT
+><DT
+>9.5.7. <A
+HREF="actions-file.html#HIDE-FORWARDED-FOR-HEADERS"
+><I
+CLASS="EMPHASIS"
+>+hide-forwarded-for-headers</I
+></A
+></DT
+><DT
+>9.5.8. <A
+HREF="actions-file.html#HIDE-FROM-HEADER"
+><I
+CLASS="EMPHASIS"
+>+hide-from-header</I
+></A
+></DT
+><DT
+>9.5.9. <A
+HREF="actions-file.html#HIDE-REFERER"
+><I
+CLASS="EMPHASIS"
+>+hide-referer</I
+></A
+></DT
+><DT
+>9.5.10. <A
+HREF="actions-file.html#HIDE-USER-AGENT"
+><I
+CLASS="EMPHASIS"
+>+hide-user-agent</I
+></A
+></DT
+><DT
+>9.5.11. <A
+HREF="actions-file.html#HANDLE-AS-IMAGE"
+><I
+CLASS="EMPHASIS"
+>+handle-as-image</I
+></A
+></DT
+><DT
+>9.5.12. <A
+HREF="actions-file.html#SET-IMAGE-BLOCKER"
+><I
+CLASS="EMPHASIS"
+>+set-image-blocker</I
+></A
+></DT
+><DT
+>9.5.13. <A
+HREF="actions-file.html#LIMIT-CONNECT"
+><I
+CLASS="EMPHASIS"
+>+limit-connect</I
+></A
+></DT
 ><DT
->7.4.6. <A
-HREF="configuration.html#ALIASES"
+>9.5.14. <A
+HREF="actions-file.html#PREVENT-COMPRESSION"
+><I
+CLASS="EMPHASIS"
+>+prevent-compression</I
+></A
+></DT
+><DT
+>9.5.15. <A
+HREF="actions-file.html#SESSION-COOKIES-ONLY"
+><I
+CLASS="EMPHASIS"
+>+session-cookies-only</I
+></A
+></DT
+><DT
+>9.5.16. <A
+HREF="actions-file.html#PREVENT-READING-COOKIES"
+><I
+CLASS="EMPHASIS"
+>+prevent-reading-cookies</I
+></A
+></DT
+><DT
+>9.5.17. <A
+HREF="actions-file.html#PREVENT-SETTING-COOKIES"
+><I
+CLASS="EMPHASIS"
+>+prevent-setting-cookies</I
+></A
+></DT
+><DT
+>9.5.18. <A
+HREF="actions-file.html#KILL-POPUP"
+><I
+CLASS="EMPHASIS"
+>+kill-popups<A
+NAME="KILL-POPUPS"
+></A
+></I
+></A
+></DT
+><DT
+>9.5.19. <A
+HREF="actions-file.html#SEND-VANILLA-WAFER"
+><I
+CLASS="EMPHASIS"
+>+send-vanilla-wafer</I
+></A
+></DT
+><DT
+>9.5.20. <A
+HREF="actions-file.html#SEND-WAFER"
+><I
+CLASS="EMPHASIS"
+>+send-wafer</I
+></A
+></DT
+><DT
+>9.5.21. <A
+HREF="actions-file.html#AEN2196"
+>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
+HREF="actions-file.html#ALIASES"
 >Aliases</A
 ></DT
 ></DL
 ></DD
 ><DT
->7.5. <A
-HREF="configuration.html#FILTER-FILE"
+>10. <A
+HREF="filter-file.html"
 >The Filter File</A
 ></DT
+><DD
+><DL
 ><DT
->7.6. <A
-HREF="configuration.html#AEN2273"
->Templates</A
+>10.1. <A
+HREF="filter-file.html#AEN2339"
+>The <I
+CLASS="EMPHASIS"
+>+filter</I
+> Action</A
 ></DT
 ></DL
 ></DD
 ><DT
->8. <A
+>11. <A
+HREF="templates.html"
+>Templates</A
+></DT
+><DT
+>12. <A
 HREF="contact.html"
 >Contacting the Developers, Bug Reporting and Feature
 Requests</A
@@ -335,71 +703,71 @@ Requests</A
 ><DD
 ><DL
 ><DT
->8.1. <A
+>12.1. <A
 HREF="contact.html#CONTACT-SUPPORT"
 >Get Support</A
 ></DT
 ><DT
->8.2. <A
+>12.2. <A
 HREF="contact.html#CONTACT-BUGS"
 >Report bugs</A
 ></DT
 ><DT
->8.3. <A
+>12.3. <A
 HREF="contact.html#CONTACT-FEATURE"
 >Request new features</A
 ></DT
 ><DT
->8.4. <A
+>12.4. <A
 HREF="contact.html#CONTACT-ADS"
 >Report ads or other filter problems</A
 ></DT
 ><DT
->8.5. <A
+>12.5. <A
 HREF="contact.html#CONTACT-OTHER"
 >Other</A
 ></DT
 ></DL
 ></DD
 ><DT
->9. <A
+>13. <A
 HREF="copyright.html"
 >Copyright and History</A
 ></DT
 ><DD
 ><DL
 ><DT
->9.1. <A
-HREF="copyright.html#AEN2320"
+>13.1. <A
+HREF="copyright.html#AEN2400"
 >Copyright</A
 ></DT
 ><DT
->9.2. <A
+>13.2. <A
 HREF="copyright.html#HISTORY"
 >History</A
 ></DT
 ></DL
 ></DD
 ><DT
->10. <A
+>14. <A
 HREF="seealso.html"
 >See Also</A
 ></DT
 ><DT
->11. <A
+>15. <A
 HREF="appendix.html"
 >Appendix</A
 ></DT
 ><DD
 ><DL
 ><DT
->11.1. <A
+>15.1. <A
 HREF="appendix.html#REGEX"
 >Regular Expressions</A
 ></DT
 ><DT
->11.2. <A
-HREF="appendix.html#AEN2545"
+>15.2. <A
+HREF="appendix.html#AEN2625"
 ><SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -408,19 +776,19 @@ CLASS="APPLICATION"
 ><DD
 ><DL
 ><DT
->11.2.1. <A
+>15.2.1. <A
 HREF="appendix.html#BOOKMARKLETS"
 >Bookmarklets</A
 ></DT
 ></DL
 ></DD
 ><DT
->11.3. <A
+>15.3. <A
 HREF="appendix.html#CHAIN"
 >Chain of Events</A
 ></DT
 ><DT
->11.4. <A
+>15.4. <A
 HREF="appendix.html#ACTIONSANAT"
 >Anatomy of an Action</A
 ></DT