Made forward chapter a little more easily understandable

diff --git a/doc/source/p-config.sgml b/doc/source/p-config.sgml
index 48bc8db..908d293 100644 (file)
--- a/doc/source/p-config.sgml
+++ b/doc/source/p-config.sgml
@@ -3,7 +3,7 @@
 
  Purpose     :  Used with other docs and files only.
 
- $Id: p-config.sgml,v 1.1.2.3 2002/05/31 02:56:25 hal9 Exp $
+ $Id: p-config.sgml,v 1.1.2.4 2002/08/01 11:22:57 oes Exp $
 
  Copyright (C) 2001, 2002 Privoxy Developers <developers@privoxy.org>
  See LICENSE.
@@ -98,7 +98,7 @@
 Copyright (C) 2001, 2002 Privoxy Developers http://privoxy.org
 </para>
 <para>
-$Id: p-config.sgml,v 1.1.2.3 2002/05/31 02:56:25 hal9 Exp $
+$Id: p-config.sgml,v 1.1.2.4 2002/08/01 11:22:57 oes Exp $
 </para>
 
 <para>
@@ -1507,17 +1507,17 @@ ACLs: permit-access and deny-access</title>
   <term>Type of value:</term>
   <listitem>
    <para>
-    <replaceable class="parameter">target_domain</replaceable>[:<replaceable class="parameter">port</replaceable>]
+    <replaceable class="parameter">target_pattern</replaceable>
     <replaceable class="parameter">http_parent</replaceable>[:<replaceable class="parameter">port</replaceable>]
    </para>
    <para>
-    Where <replaceable class="parameter">target_domain</replaceable> is a domain name pattern (see the
-    chapter on domain matching in the <filename>default.action</filename> file),
-    <replaceable class="parameter">http_parent</replaceable> is the address of the parent HTTP proxy
-    as an IP addresses in dotted decimal notation or as a valid DNS name (or <quote>.</quote> to denote
-    <quote>no forwarding</quote>, and the optional 
-    <replaceable class="parameter">port</replaceable> parameters are TCP ports, i.e. integer
-    values from 1 to 64535
+    where <replaceable class="parameter">target_pattern</replaceable> is a <link linkend="af-patterns">URL pattern</link> 
+    that specifies to which requests (i.e. URLs) this forward rule shall apply. Use <literal>/</literal> to
+    denote <quote>all URLs</quote>.
+    <replaceable class="parameter">http_parent</replaceable>[:<replaceable class="parameter">port</replaceable>]
+    is the DNS name or IP address of the parent HTTP proxy through which the requests should be forwarded,
+    optionally followed by its listening port (default: 8080).
+    Use a single dot (<literal>.</literal>) to denote <quote>no forwarding</quote>.
    </para>
   </listitem>
  </varlistentry>
@@ -1555,7 +1555,7 @@ ACLs: permit-access and deny-access</title>
    </para>
    <para>
     <screen>
-  forward   .*.    anon-proxy.example.org:8080
+  forward   /      anon-proxy.example.org:8080
   forward   :443   .
 </screen>
    </para>
@@ -1565,7 +1565,7 @@ ACLs: permit-access and deny-access</title>
    </para>
    <para>
     <screen>
-  forward   .*.                caching-proxy.example-isp.net:8000
+  forward   /                  caching-proxy.example-isp.net:8000
   forward   .example-isp.net   .
 </screen>
    </para>
@@ -1594,13 +1594,14 @@ forward-socks4 and forward-socks4a</title>
   <term>Type of value:</term>
   <listitem>
    <para>
-    <replaceable class="parameter">target_domain</replaceable>[:<replaceable class="parameter">port</replaceable>]
+    <replaceable class="parameter">target_pattern</replaceable>
     <replaceable class="parameter">socks_proxy</replaceable>[:<replaceable class="parameter">port</replaceable>]
     <replaceable class="parameter">http_parent</replaceable>[:<replaceable class="parameter">port</replaceable>]
    </para>
    <para>
-    Where <replaceable class="parameter">target_domain</replaceable> is a domain name pattern (see the
-    chapter on domain matching in the <filename>default.action</filename> file),
+    where <replaceable class="parameter">target_pattern</replaceable> is a <link linkend="af-patterns">URL pattern</link> 
+    that specifies to which requests (i.e. URLs) this forward rule shall apply. Use <literal>/</literal> to
+    denote <quote>all URLs</quote>.
     <replaceable class="parameter">http_parent</replaceable> and <replaceable class="parameter">socks_proxy</replaceable>
     are IP addresses in dotted decimal notation or valid DNS names (<replaceable class="parameter">http_parent</replaceable>
     may be <quote>.</quote> to denote <quote>no HTTP forwarding</quote>), and the optional 
@@ -1651,7 +1652,7 @@ forward-socks4 and forward-socks4a</title>
    </para>
    <para>
     <screen>
-  forward-socks4a   .*.            socks-gw.example.com:1080  www-cache.example-isp.net:8080
+  forward-socks4a   /              socks-gw.example.com:1080  www-cache.example-isp.net:8080
   forward           .example.com   .
 </screen>
    </para>
@@ -1660,7 +1661,7 @@ forward-socks4 and forward-socks4a</title>
    </para>
    <para>
     <screen>
-  forward-socks4   .*.            socks-gw.example.com:1080  .
+  forward-socks4   /               socks-gw.example.com:1080  .
 </screen>
    </para>
   </listitem>
@@ -1691,7 +1692,7 @@ forward-socks4 and forward-socks4a</title>
 
 <para>
  <screen>
-  forward    .*.         .
+  forward    /           .
   forward    .isp-b.net  host-b:8118
 </screen>
 </para>
@@ -1702,7 +1703,7 @@ forward-socks4 and forward-socks4a</title>
 
 <para>
  <screen>
-  forward    .*.         .
+  forward    /           .
   forward    .isp-a.net  host-a:8118
 </screen>
 </para>
@@ -1744,6 +1745,17 @@ forward-socks4 and forward-socks4a</title>
  Squid normally uses port 3128. If unsure consult <literal>http_port</literal> in <filename>squid.conf</filename>.
 </para>
 
+<para>
+ You could just as well decide to only forward requests for Windows executables through
+ a virus-scanning parent proxy, say, on <literal>antivir.example.com</literal>, port 8010:
+</para>
+
+<para>
+ <screen>
+  forward   /                          .
+  forward   /.*\.(exe|com|dll|zip)$    antivir.example.com:8010</screen> 
+</para>
+
 </sect3>
 ]]>