From: Joshua Slive <slive@apache.org>
Date: Fri, 7 Jun 2002 02:20:53 +0000 (+0000)
Subject: Document that ProxyPass can't take a query string, but that RewriteRule can be used
X-Git-Tag: 2.0.37~44
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=c9705ff48590ea05744c33b8b3d46c66b5e4a2b9;p=apache

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 735a120ec3..c20c15fc5a 100644
--- 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 f334f9402c..f50b542679 100644
--- 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>