From: Rich Bowen <rbowen@apache.org>
Date: Fri, 11 Nov 2011 17:06:40 +0000 (+0000)
Subject: Patch from Luke Meyer, clarifies usage of ProxyPassReverseCookiePath directive. As... 
X-Git-Tag: 2.5.0-alpha~7933
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=bdd0af17de142684448d87e8d982ba357f7da0bd;p=thirdparty%2Fapache%2Fhttpd.git

Patch from Luke Meyer, clarifies usage of ProxyPassReverseCookiePath directive. As per bug #51126


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1200955 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/mod_proxy.xml b/docs/manual/mod/mod_proxy.xml
index d694301e4ae..3caea11b473 100644
--- a/docs/manual/mod/mod_proxy.xml
+++ b/docs/manual/mod/mod_proxy.xml
@@ -1329,6 +1329,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-
@@ -1339,10 +1341,23 @@ 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:
+    <example>
+      ProxyPassReverseCookiePath  /  /mirror/foo/
+    </example>
+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>