Backports from trunk:

- r1200955: Patch from Luke Meyer, clarifies usage of ProxyPassReverseCookiePath directive. As per bug #51126
- r1200968: A little clarification about variable interpolation, as requested in bug #51125
- r1202453: Fix xml

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1238730 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/mod/mod_proxy.xml b/docs/manual/mod/mod_proxy.xml
index 7cd2c91c2ce4d5ae963d19eeb11452028cdd8b08..75e65f46a447487c27322f1264644b36850c6c6d 100644 (file)
--- a/docs/manual/mod/mod_proxy.xml
+++ b/docs/manual/mod/mod_proxy.xml
@@ -1331,6 +1331,8 @@ rewriting headers that are a URL, this rewrites the <code>domain</code>
 string in <code>Set-Cookie</code> headers.</p>
 </usage>
 </directivesynopsis>
+
+
 <directivesynopsis>
 <name>ProxyPassReverseCookiePath</name>
 <description>Adjusts the Path string in Set-Cookie headers from a reverse-
@@ -1341,10 +1343,25 @@ proxied server</description>
 <context>directory</context>
 </contextlist>
 <usage>
-<p>Usage is basically similar to
-<directive module="mod_proxy">ProxyPassReverse</directive>, but instead of
-rewriting headers that are a URL, this rewrites the <code>path</code>
-string in <code>Set-Cookie</code> headers.</p>
+<p>
+Useful in conjunction with
+<directive module="mod_proxy">ProxyPassReverse</directive>
+in situations where backend URL paths are mapped to public paths on the
+reverse proxy. This directive rewrites the <code>path</code> string in
+<code>Set-Cookie</code> headers. If the beginning of the cookie path matches
+<var>internal-path</var>, the cookie path will be replaced with
+<var>public-path</var>.
+</p><p>
+In the example given with 
+<directive module="mod_proxy">ProxyPassReverse</directive>, the directive:
+</p>
+    <example>
+      ProxyPassReverseCookiePath  /  /mirror/foo/
+    </example>
+<p>
+will rewrite a cookie with backend path <code>/</code> (or
+<code>/example</code> or, in fact, anything) to <code>/mirror/foo/</code>.
+</p>
 </usage>
 </directivesynopsis>
 
@@ -1712,7 +1729,7 @@ header for proxied requests</description>
     <directive>ProxyPassReverseCookiePath</directive> directives,
     and causes them to substitute the value of an environment
     variable <code>varname</code> for the string <code>${varname}</code>
-    in configuration directives.</p>
+    in configuration directives (if the <var>interpolate</var> option is set).</p>
     <p>Keep this turned off (for server performance) unless you need it!</p>
 </usage>
 </directivesynopsis>