Rebuild for 3.0.17 stable

[privoxy.git] / doc / webserver / user-manual / actions-file.html

diff --git a/doc/webserver/user-manual/actions-file.html b/doc/webserver/user-manual/actions-file.html
index 54b72b5..c0eb301 100644 (file)
--- a/doc/webserver/user-manual/actions-file.html
+++ b/doc/webserver/user-manual/actions-file.html
@@ -7,7 +7,7 @@
 NAME="GENERATOR"
 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
 REL="HOME"
-TITLE="Privoxy 3.0.11 User Manual"
+TITLE="Privoxy 3.0.17 User Manual"
 HREF="index.html"><LINK
 REL="PREVIOUS"
 TITLE="The Main Configuration File"
@@ -42,7 +42,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy 3.0.11 User Manual</TH
+>Privoxy 3.0.17 User Manual</TH
 ></TR
 ><TR
 ><TD
@@ -233,7 +233,7 @@ CLASS="FILENAME"
 >    <DIV
 CLASS="TABLE"
 ><A
-NAME="AEN2203"
+NAME="AEN2534"
 ></A
 ><P
 ><B
@@ -501,7 +501,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2302"
+NAME="AEN2633"
 >8.1. Finding the Right Mix</A
 ></H2
 ><P
@@ -536,7 +536,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2309"
+NAME="AEN2640"
 >8.2. How to Edit</A
 ></H2
 ><P
@@ -714,31 +714,34 @@ CLASS="EMPHASIS"
 > Generally, an URL pattern has the form
  <TT
 CLASS="LITERAL"
->&#60;domain&#62;/&#60;path&#62;</TT
->, where both the
+>&#60;domain&#62;&#60;port&#62;/&#60;path&#62;</TT
+>, where the
  <TT
 CLASS="LITERAL"
 >&#60;domain&#62;</TT
-> and <TT
+>, the <TT
+CLASS="LITERAL"
+>&#60;port&#62;</TT
+>
+ and the <TT
 CLASS="LITERAL"
 >&#60;path&#62;</TT
-> are
- optional. (This is why the special <TT
+> are optional. (This is why the special
+ <TT
 CLASS="LITERAL"
 >/</TT
-> pattern matches all
- URLs). Note that the protocol portion of the URL pattern (e.g.
- <TT
+> pattern matches all URLs). Note that the protocol
+ portion of the URL pattern (e.g. <TT
 CLASS="LITERAL"
 >http://</TT
->) should <SPAN
+>) should
+ <SPAN
 CLASS="emphasis"
 ><I
 CLASS="EMPHASIS"
 >not</I
 ></SPAN
-> be included in
- the pattern. This is assumed already!</P
+> be included in the pattern. This is assumed already!</P
 ><P
 > The pattern matching syntax is different for the domain and path parts of
  the URL. The domain part uses a simple globbing type matching technique, 
@@ -753,6 +756,20 @@ CLASS="QUOTE"
 ></A
 > (POSIX 1003.2).</P
 ><P
+> The port part of a pattern is a decimal port number preceded by a colon
+ (<TT
+CLASS="LITERAL"
+>:</TT
+>). If the domain part contains a numerical IPv6 address,
+ it has to be put into angle brackets
+ (<TT
+CLASS="LITERAL"
+>&#60;</TT
+>, <TT
+CLASS="LITERAL"
+>&#62;</TT
+>).</P
+><P
 ></P
 ><DIV
 CLASS="VARIABLELIST"
@@ -847,6 +864,41 @@ CLASS="EMPHASIS"
 ><DT
 ><TT
 CLASS="LITERAL"
+>/</TT
+></DT
+><DD
+><P
+>    Matches any URL because there's no requirement for either the
+    domain or the path to match anything.
+   </P
+></DD
+><DT
+><TT
+CLASS="LITERAL"
+>:8000/</TT
+></DT
+><DD
+><P
+>    Matches any URL pointing to TCP port 8000.
+   </P
+></DD
+><DT
+><TT
+CLASS="LITERAL"
+>&#60;2001:db8::1&#62;/</TT
+></DT
+><DD
+><P
+>    Matches any URL with the host address <TT
+CLASS="LITERAL"
+>2001:db8::1</TT
+>.
+    (Note that the real URL uses plain brackets, not angle brackets.)
+   </P
+></DD
+><DT
+><TT
+CLASS="LITERAL"
 >index.html</TT
 ></DT
 ><DD
@@ -866,7 +918,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN2400"
+NAME="AEN2752"
 >8.4.1. The Domain Pattern</A
 ></H3
 ><P
@@ -1106,7 +1158,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN2476"
+NAME="AEN2828"
 >8.4.2. The Path Pattern</A
 ></H3
 ><P
@@ -1769,6 +1821,9 @@ CLASS="QUOTE"
 > are, you definitely don't need to worry about this 
     one.
    </P
+><P
+>    Headers added by this action are not modified by other actions.
+   </P
 ></DD
 ><DT
 >Example usage:</DT
@@ -3489,9 +3544,10 @@ CLASS="EMPHASIS"
 ><P
 >    Filtering requires buffering the page content, which may appear to
     slow down page rendering since nothing is displayed until all content has
-    passed the filters. (It does not really take longer, but seems that way
-    since the page is not incrementally displayed.) This effect will be more
-    noticeable on slower connections.
+    passed the filters. (The total time until the page is completely rendered
+    doesn't change much, but it may be perceived as slower since the page is
+    not incrementally displayed.)
+    This effect will be more noticeable on slower connections.
    </P
 ><P
 >   <SPAN
@@ -5852,7 +5908,7 @@ CLASS="QUOTE"
 CLASS="LITERAL"
 ><A
 HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
->hided-if-modified-since</A
+>hide-if-modified-since</A
 ></TT
 >
     to further customize your random range.
@@ -6674,7 +6730,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN4107"
+NAME="AEN4460"
 >8.5.34. Summary</A
 ></H3
 ><P
@@ -6976,7 +7032,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN4171"
+NAME="AEN4524"
 >8.7.1. match-all.action</A
 ></H3
 ><P
@@ -7074,7 +7130,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN4193"
+NAME="AEN4546"
 >8.7.2. default.action</A
 ></H3
 ><P
@@ -7675,7 +7731,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN4306"
+NAME="AEN4659"
 >8.7.3. user.action</A
 ></H3
 ><P