Rebuild docs with updated OS X instructions
[privoxy.git] / doc / webserver / user-manual / actions-file.html
index c9652e6..a0efab2 100644 (file)
@@ -6,7 +6,7 @@
   <title>Actions Files</title>
   <meta name="GENERATOR" content=
   "Modular DocBook HTML Stylesheet Version 1.79">
-  <link rel="HOME" title="Privoxy 3.0.22 User Manual" href="index.html">
+  <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html">
   <link rel="PREVIOUS" title="The Main Configuration File" href=
   "config.html">
   <link rel="NEXT" title="Filter Files" href="filter-file.html">
@@ -21,7 +21,7 @@
     <table summary="Header navigation table" width="100%" border="0"
     cellpadding="0" cellspacing="0">
       <tr>
-        <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th>
+        <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
       </tr>
 
       <tr>
         in <tt class="FILENAME">default.action</tt> are:</p>
 
         <div class="TABLE">
-          <a name="AEN2888" id="AEN2888"></a>
+          <a name="AEN2614" id="AEN2614"></a>
 
           <p><b>Table 1. Default Configurations</b></p>
 
     actions</a>.</p>
 
     <div class="SECT2">
-      <h2 class="SECT2"><a name="AEN2987" id="AEN2987">8.1. Finding the Right
+      <h2 class="SECT2"><a name="AEN2713" id="AEN2713">8.1. Finding the Right
       Mix</a></h2>
 
       <p>Note that some <a href="actions-file.html#ACTIONS">actions</a>, like
     </div>
 
     <div class="SECT2">
-      <h2 class="SECT2"><a name="AEN2994" id="AEN2994">8.2. How to
+      <h2 class="SECT2"><a name="AEN2720" id="AEN2720">8.2. How to
       Edit</a></h2>
 
       <p>The easiest way to edit the actions files is with a browser by using
       </div>
 
       <div class="SECT3">
-        <h3 class="SECT3"><a name="AEN3188" id="AEN3188">8.4.2. The Path
+        <h3 class="SECT3"><a name="AEN2914" id="AEN2914">8.4.2. The Path
         Pattern</a></h3>
 
         <p><span class="APPLICATION">Privoxy</span> uses <span class=
             <dt>Type:</dt>
 
             <dd>
-              <p>Parameterized.</p>
+              <p>Multi-value.</p>
             </dd>
 
             <dt>Parameter:</dt>
             <dt>Type:</dt>
 
             <dd>
-              <p>Parameterized.</p>
+              <p>Multi-value.</p>
             </dd>
 
             <dt>Parameter:</dt>
@@ -2026,7 +2026,7 @@ problem-host.example.com
             <dt>Type:</dt>
 
             <dd>
-              <p>Parameterized.</p>
+              <p>Multi-value.</p>
             </dd>
 
             <dt>Parameter:</dt>
@@ -2246,7 +2246,7 @@ problem-host.example.com
             <dt>Type:</dt>
 
             <dd>
-              <p>Parameterized.</p>
+              <p>Multi-value.</p>
             </dd>
 
             <dt>Parameter:</dt>
@@ -2794,7 +2794,7 @@ problem-host.example.com
             <dt>Type:</dt>
 
             <dd>
-              <p>Multi-value.</p>
+              <p>Parameterized.</p>
             </dd>
 
             <dt>Parameter:</dt>
@@ -2833,6 +2833,30 @@ problem-host.example.com
                   <span class="QUOTE">"forward-socks5"</span> for socks5
                   connections (with remote DNS resolution).</p>
                 </li>
+
+                <li>
+                  <p><span class="QUOTE">"forward-webserver
+                  127.0.0.1:80"</span> to use the HTTP server listening at
+                  127.0.0.1 port 80 without adjusting the request
+                  headers.</p>
+
+                  <p>This makes it more convenient to use Privoxy to make
+                  existing websites available as onion services as well.</p>
+
+                  <p>Many websites serve content with hardcoded URLs and
+                  can't be easily adjusted to change the domain based on the
+                  one used by the client.</p>
+
+                  <p>Putting Privoxy between Tor and the webserver (or an
+                  stunnel that forwards to the webserver) allows to rewrite
+                  headers and content to make client and server happy at the
+                  same time.</p>
+
+                  <p>Using Privoxy for webservers that are only reachable
+                  through onion addresses and whose location is supposed to
+                  be secret is not recommended and should not be necessary
+                  anyway.</p>
+                </li>
               </ul>
             </dd>
 
@@ -4119,7 +4143,7 @@ www.privoxy.org/user-manual/
             <dt>Type:</dt>
 
             <dd>
-              <p>Parameterized.</p>
+              <p>Multi-value.</p>
             </dd>
 
             <dt>Parameter:</dt>
@@ -4192,7 +4216,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not
             <dt>Type:</dt>
 
             <dd>
-              <p>Parameterized.</p>
+              <p>Multi-value.</p>
             </dd>
 
             <dt>Parameter:</dt>
@@ -4489,7 +4513,7 @@ TAG:^image/
       </div>
 
       <div class="SECT3">
-        <h3 class="SECT3"><a name="AEN4920" id="AEN4920">8.5.36.
+        <h3 class="SECT3"><a name="AEN4653" id="AEN4653">8.5.36.
         Summary</a></h3>
 
         <p>Note that many of these actions have the potential to cause a page
@@ -4648,7 +4672,7 @@ TAG:^image/
       together:</p>
 
       <div class="SECT3">
-        <h3 class="SECT3"><a name="AEN4984" id="AEN4984">8.7.1.
+        <h3 class="SECT3"><a name="AEN4717" id="AEN4717">8.7.1.
         match-all.action</a></h3>
 
         <p>Remember <span class="emphasis"><i class="EMPHASIS">all actions
@@ -4697,7 +4721,7 @@ TAG:^image/
       </div>
 
       <div class="SECT3">
-        <h3 class="SECT3"><a name="AEN5006" id="AEN5006">8.7.2.
+        <h3 class="SECT3"><a name="AEN4739" id="AEN4739">8.7.2.
         default.action</a></h3>
 
         <p>If you aren't a developer, there's no need for you to edit the
@@ -5040,7 +5064,7 @@ wiki.
       </div>
 
       <div class="SECT3">
-        <h3 class="SECT3"><a name="AEN5119" id="AEN5119">8.7.3.
+        <h3 class="SECT3"><a name="AEN4852" id="AEN4852">8.7.3.
         user.action</a></h3>
 
         <p>So far we are painting with a broad brush by setting general