From b559434c053283091501348b2035c5512511b1e6 Mon Sep 17 00:00:00 2001
From: Eric Covener <covener@apache.org>
Date: Wed, 19 Sep 2007 13:50:35 +0000
Subject: [PATCH] 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/branches/2.0.x@577305 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mod_rewrite.html.en | 11 +++++++++++
 docs/manual/mod/mod_rewrite.xml     | 11 +++++++++++
 2 files changed, 22 insertions(+)

diff --git a/docs/manual/mod/mod_rewrite.html.en b/docs/manual/mod/mod_rewrite.html.en
index 3b19068c347..56d13927a4a 100644
--- a/docs/manual/mod/mod_rewrite.html.en
+++ b/docs/manual/mod/mod_rewrite.html.en
@@ -1489,6 +1489,17 @@ cannot use <code>$N</code> in the substitution string!
 
       </ul>
 
+<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>Note: Enabling rewrites in per-directory context</h3>
  To enable the rewriting engine
           for per-directory configuration files, you need to set
diff --git a/docs/manual/mod/mod_rewrite.xml b/docs/manual/mod/mod_rewrite.xml
index 2265ccca780..9971f67b26f 100644
--- a/docs/manual/mod/mod_rewrite.xml
+++ b/docs/manual/mod/mod_rewrite.xml
@@ -1512,6 +1512,17 @@ cannot use <code>$N</code> in the substitution string!
 
       </ul>
 
+<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>Note: Enabling rewrites in per-directory context</title>
  To enable the rewriting engine
           for per-directory configuration files, you need to set
-- 
2.47.2