From eb5aaced6ad39b1d186ebb42bb7e43c8fa9576c7 Mon Sep 17 00:00:00 2001
From: Ruediger Pluem <rpluem@apache.org>
Date: Sun, 2 Sep 2007 12:19:38 +0000
Subject: [PATCH] Merge r571836 from trunk:

* Improve ProxySet documentation by pointing out one pitfall and one
  interesting use case.

Submitted by: rpluem


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@571965 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mod_proxy.xml | 28 +++++++++++++++++++++++++---
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/docs/manual/mod/mod_proxy.xml b/docs/manual/mod/mod_proxy.xml
index 65de869527a..137bac5db98 100644
--- a/docs/manual/mod/mod_proxy.xml
+++ b/docs/manual/mod/mod_proxy.xml
@@ -501,10 +501,14 @@ expressions</description>
 	and later.</compatibility>
 <usage>
     <p>This directive is used as an alternate method of setting any of the
-    parameters available to Proxy balancers and members normally done via the
+    parameters available to Proxy balancers and workers normally done via the
     <directive module="mod_proxy">ProxyPass</directive> directive. If used
-    within a <code>&lt;Proxy <var>balancer://</var>...&gt;</code> container
-    directive, the <var>url</var> argument is not required.</p>
+    within a <code>&lt;Proxy <var>balancer url|worker url</var>&gt;</code>
+    container directive, the <var>url</var> argument is not required. As a side
+    effect the respective balancer or worker gets created. This can be useful
+    when doing reverse proxying via a
+    <directive module="mod_rewrite">RewriteRule</directive> instead of a
+    <directive module="mod_proxy">ProxyPass</directive> directive.</p>
 
     <example>
       &lt;Proxy balancer://hotcluster&gt;<br />
@@ -516,10 +520,28 @@ expressions</description>
       &lt;/Proxy&gt;
     </example>
 
+    <example>
+      &lt;Proxy http://backend&gt;<br />
+      <indent>
+        ProxySet keepalive=On<br />
+      </indent>
+      &lt;/Proxy&gt;
+    </example>
+
     <example>
         ProxySet balancer://foo lbmethod=bytraffic timeout=15
     </example>
 
+    <example>
+        ProxySet ajp://backend:7001 timeout=15
+    </example>
+
+   <note type="warning"><title>Warning</title>
+      <p>Keep in mind that the same parameter key can have a different meaning
+      depending whether it is applied to a balancer or a worker as shown by the two
+      examples above regarding timeout.</p>
+   </note>
+
 </usage>
 </directivesynopsis>
 
-- 
2.47.3