svn commit: r1906615 - /httpd/httpd/branches/2.2.x/docs/manual/rewrite/intro.xml

[rb...@apache.org]

Author: rbowen
Date: Wed Jan 11 18:51:20 2023
New Revision: 1906615

URL: http://svn.apache.org/viewvc?rev=1906615&view=rev
Log:
Addresses https://bz.apache.org/bugzilla/show_bug.cgi?id=53108

Modified:
    httpd/httpd/branches/2.2.x/docs/manual/rewrite/intro.xml

Modified: httpd/httpd/branches/2.2.x/docs/manual/rewrite/intro.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/rewrite/intro.xml?rev=1906615&r1=1906614&r2=1906615&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/rewrite/intro.xml (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/rewrite/intro.xml Wed Jan 11 18:51:20 2023
@@ -193,7 +193,7 @@ value.
 <p>The <var>Substitution</var> can itself be one of three things:</p>
 
 <dl>
-<dt>A full filesystem path to a resource</dt>
+<dt>1. A full filesystem path to a resource</dt>
 <dd>
 <example>
 RewriteRule ^/games.* /usr/local/games/web
@@ -202,7 +202,7 @@ RewriteRule ^/games.* /usr/local/games/w
 like the <directive module="mod_alias">Alias</directive> directive.</p>
 </dd>
 
-<dt>A web-path to a resource</dt>
+<dt>2. A web-path to a resource</dt>
 <dd>
 <example>
 RewriteRule ^/foo$ /bar
@@ -213,7 +213,7 @@ map requests for <code>http://example.co
 path <code>/usr/local/apache2/htdocs/bar</code>.</p>
 </dd>
 
-<dt>An absolute URL</dt>
+<dt>3. An absolute URL</dt>
 <dd>
 <example>
 RewriteRule ^/product/view$ http://site2.example.com/seeproduct.html [R]
@@ -222,6 +222,8 @@ RewriteRule ^/product/view$ http://site2
 </dd>
 </dl>
 
+<note type="warning">Note that <strong>1</strong> and <strong>2</strong> have exactly the same syntax. The difference between them is that in the case of <strong>1</strong>, the top level of the target path (i.e., <code>/usr/</code>) exists on the filesystem, where as in the case of <strong>2</strong>, it does not. (i.e., there's no <code>/bar/</code> as a root-level directory in the filesystem.)</note>
+
 <p>The <var>Substitution</var> can also
 contain <em>back-references</em> to parts of the incoming URL-path
 matched by the <var>Pattern</var>. Consider the following:</p>