From bb6b032ca198b1bcd6018cc43d8d5eebb596bfda Mon Sep 17 00:00:00 2001
From: Joshua Slive <slive@apache.org>
Date: Wed, 1 Aug 2007 18:50:43 +0000
Subject: [PATCH] Note the L doesn't necessarily mean no more rewriting.

PR: 40004


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@561906 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mod_rewrite.html.en | 20 +++++++++++---------
 docs/manual/mod/mod_rewrite.xml     | 20 +++++++++++---------
 2 files changed, 22 insertions(+), 18 deletions(-)

diff --git a/docs/manual/mod/mod_rewrite.html.en b/docs/manual/mod/mod_rewrite.html.en
index a11961d6a1..079f095e7c 100644
--- a/docs/manual/mod/mod_rewrite.html.en
+++ b/docs/manual/mod/mod_rewrite.html.en
@@ -1316,15 +1316,17 @@ cannot use <code>$N</code> in the substitution string!
         ``<code>cgi-script</code>''.</li>
 
         <li>'<strong><code>last|L</code></strong>'
-        (<strong>l</strong>ast rule)<br />
-        Stop the rewriting process here and don't apply any more
-        rewrite rules. This corresponds to the Perl
-        <code>last</code> command or the <code>break</code> command
-        in C. Use this flag to prevent the currently
-        rewritten URL from being rewritten further by following
-        rules. For example, use it to rewrite the root-path URL
-        ('<code>/</code>') to a real one, <em>e.g.</em>,
-        '<code>/e/www/</code>'.</li>
+        (<strong>l</strong>ast rule)<br /> Stop the rewriting process
+        here and don't apply any more rewrite rules. This corresponds
+        to the Perl <code>last</code> command or the
+        <code>break</code> command in C. Use this flag to prevent the
+        currently rewritten URL from being rewritten further by
+        following rules. Remember, however, that if the
+        <code class="directive">RewriteRule</code> generates an internal
+        redirect (which frequently occurs when rewriting in a
+        per-directory context), this will reinject the request and
+        will cause processing to be repeated starting from the first
+        <code class="directive">RewriteRule</code>.</li>
 
         <li>'<strong><code>next|N</code></strong>'
         (<strong>n</strong>ext round)<br />
diff --git a/docs/manual/mod/mod_rewrite.xml b/docs/manual/mod/mod_rewrite.xml
index eca555dd33..dd7c5d8318 100644
--- a/docs/manual/mod/mod_rewrite.xml
+++ b/docs/manual/mod/mod_rewrite.xml
@@ -1333,15 +1333,17 @@ cannot use <code>$N</code> in the substitution string!
         ``<code>cgi-script</code>''.</li>
 
         <li>'<strong><code>last|L</code></strong>'
-        (<strong>l</strong>ast rule)<br />
-        Stop the rewriting process here and don't apply any more
-        rewrite rules. This corresponds to the Perl
-        <code>last</code> command or the <code>break</code> command
-        in C. Use this flag to prevent the currently
-        rewritten URL from being rewritten further by following
-        rules. For example, use it to rewrite the root-path URL
-        ('<code>/</code>') to a real one, <em>e.g.</em>,
-        '<code>/e/www/</code>'.</li>
+        (<strong>l</strong>ast rule)<br /> Stop the rewriting process
+        here and don't apply any more rewrite rules. This corresponds
+        to the Perl <code>last</code> command or the
+        <code>break</code> command in C. Use this flag to prevent the
+        currently rewritten URL from being rewritten further by
+        following rules. Remember, however, that if the
+        <directive>RewriteRule</directive> generates an internal
+        redirect (which frequently occurs when rewriting in a
+        per-directory context), this will reinject the request and
+        will cause processing to be repeated starting from the first
+        <directive>RewriteRule</directive>.</li>
 
         <li>'<strong><code>next|N</code></strong>'
         (<strong>n</strong>ext round)<br />
-- 
2.50.1