document the mod_userdir-like tilde expansion sometimes performed by mod_rewrite

A tilde can sneak into a rule via a backreference and cause some surprising behavior

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

diff --git a/docs/manual/mod/mod_rewrite.html.en b/docs/manual/mod/mod_rewrite.html.en
index dc762b98db7fbb8a62d8d37859dfcb24150cdb72..2e84901268cc0f1990d264e9281a69f1a6d1f6d0 100644 (file)
--- a/docs/manual/mod/mod_rewrite.html.en
+++ b/docs/manual/mod/mod_rewrite.html.en
@@ -1513,6 +1513,17 @@ cannot use <code>$N</code> in the substitution string!
         </dd>
       </dl>
 
+<div class="note"><h3>Home directory expansion</h3>
+<p> When the substitution string begins with a string
+resembling "/~user" (via explicit text or backreferences), mod_rewrite performs
+home directory expansion independent of the presence or configuration 
+of <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code></p>
+
+<p> This expansion does not occur when the <em>PT</em>
+flag is used on the <code class="directive"><a href="#rewriterule">RewriteRule</a></code>
+directive.</p>
+</div>
+
 <div class="note"><h3>Per-directory Rewrites</h3>
  
 <p>The rewrite engine may be used in <a href="../howto/htaccess.html">.htaccess</a> files.  To enable the

diff --git a/docs/manual/mod/mod_rewrite.xml b/docs/manual/mod/mod_rewrite.xml
index 7f06d7a8d702790ee9cb5972a283c81bb278f012..ab780896ad9183aa7a747d0b37879f5b8639e8c7 100644 (file)
--- a/docs/manual/mod/mod_rewrite.xml
+++ b/docs/manual/mod/mod_rewrite.xml
@@ -1532,6 +1532,17 @@ cannot use <code>$N</code> in the substitution string!
         </dd>
       </dl>
 
+<note><title>Home directory expansion</title>
+<p> When the substitution string begins with a string
+resembling "/~user" (via explicit text or backreferences), mod_rewrite performs
+home directory expansion independent of the presence or configuration 
+of <module>mod_userdir</module></p>
+
+<p> This expansion does not occur when the <em>PT</em>
+flag is used on the <directive module="mod_rewrite">RewriteRule</directive>
+directive.</p>
+</note>
+
 <note><title>Per-directory Rewrites</title>
  
 <p>The rewrite engine may be used in <a