Document that ProxyPass can't take a query string, but that RewriteRule can be used

for reverse proxying with much more flexibility.

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

diff --git a/docs/manual/mod/mod_proxy.html.en b/docs/manual/mod/mod_proxy.html.en
index 735a120ec3513d3b4eed1d65b56f9fc790fbee17..c20c15fc5a2abe087cb7509fed0d8fcf0a1675bf 100644 (file)
--- a/docs/manual/mod/mod_proxy.html.en
+++ b/docs/manual/mod/mod_proxy.html.en
@@ -451,7 +451,8 @@ URL-space</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax"
 the local server; the local server does not act as a proxy in the
 conventional sense, but appears to be a mirror of the remote
 server. <em>path</em> is the name of a local virtual path;
-<em>url</em> is a partial URL for the remote server.</p>
+<em>url</em> is a partial URL for the remote server and cannot
+include a query string.</p>
 
 <p>Suppose the local server has address <code>http://wibble.org/</code>; 
 then</p>
@@ -475,6 +476,11 @@ a subdirectory. eg.</p>
 
 <p>When used inside a <a href="core.html#location" class="directive"><code class="directive">&lt;Location&gt;</code></a> section, the first argument is
 ommitted and the local directory is obtained from the <a href="core.html#location" class="directive"><code class="directive">&lt;Location&gt;</code></a>.</p>
+
+<p>If you require a more flexible reverse-proxy configuration, see
+the <a href="mod_rewrite.html#rewriterule" class="directive"><code class="directive">RewriteRule</code></a> directive
+with the <code>[P]</code> flag.</p>
+
 <hr/><h2><a name="ProxyPassReverse">ProxyPassReverse</a> <a name="proxypassreverse">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td nowrap="nowrap"><strong>Description: </strong></td><td>Adjusts the URL in HTTP response headers sent from
 a reverse proxied server</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>ProxyPassReverse [<em>path</em>] <em>url</em></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_proxy</td></tr></table></td></tr></table>
 <p>This directive lets Apache adjust the URL in the <code>Location</code>,

diff --git a/docs/manual/mod/mod_proxy.xml b/docs/manual/mod/mod_proxy.xml
index f334f9402c5bf4d22ff20f4be41a7c5936b21e0a..f50b54267914e2554dc75daf54856331bbdadc35 100644 (file)
--- a/docs/manual/mod/mod_proxy.xml
+++ b/docs/manual/mod/mod_proxy.xml
@@ -449,7 +449,8 @@ URL-space</description>
 the local server; the local server does not act as a proxy in the
 conventional sense, but appears to be a mirror of the remote
 server. <em>path</em> is the name of a local virtual path;
-<em>url</em> is a partial URL for the remote server.</p>
+<em>url</em> is a partial URL for the remote server and cannot
+include a query string.</p>
 
 <p>Suppose the local server has address <code>http://wibble.org/</code>; 
 then</p>
@@ -475,6 +476,11 @@ a subdirectory. eg.</p>
 module="core">Location</directive> section, the first argument is
 ommitted and the local directory is obtained from the <directive
 type="section" module="core">Location</directive>.</p>
+
+<p>If you require a more flexible reverse-proxy configuration, see
+the <directive module="mod_rewrite">RewriteRule</directive> directive
+with the <code>[P]</code> flag.</p>
+
 </usage>
 
 </directivesynopsis>