httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cove...@apache.org
Subject svn commit: r1040809 - in /httpd/httpd/branches/2.2.x/docs/manual: mod/core.xml sections.xml
Date Tue, 30 Nov 2010 22:10:28 GMT
Author: covener
Date: Tue Nov 30 22:10:27 2010
New Revision: 1040809

URL: http://svn.apache.org/viewvc?rev=1040809&view=rev
Log:
Merge r1040808 from trunk:

PR50375: <Location> has bad example in sections.xml and never actually explains what's
matched
in core.xml.



Modified:
    httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml
    httpd/httpd/branches/2.2.x/docs/manual/sections.xml

Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml?rev=1040809&r1=1040808&r2=1040809&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml Tue Nov 30 22:10:27 2010
@@ -1134,7 +1134,7 @@ in case of an error</description>
     anyone other than the user that starts the server.</p>
     <note type="warning"><title>Note</title>
       <p>When entering a file path on non-Unix platforms, care should be taken
-      to make sure that only forward slashed are used even though the platform
+      to make sure that only forward slashes are used even though the platform
       may allow the use of back slashes. In general it is a good idea to always 
       use forward slashes throughout the configuration files.</p>
     </note>
@@ -1999,6 +1999,34 @@ URLs</description>
     locations.  Since several different URLs may map to the same
     filesystem location, such access controls may by circumvented.</p>
 
+    <p>The enclosed directives will be applied to the request if the path component
+    of the URL meets <em>any</em> of the following criteria:
+    <ul>
+      <li>The specified location matches exactly the path component of the URL.
+      </li>
+      <li>The specified location, which ends in a forward slash, is a prefix 
+      of the path component of the URL (treated as a context root).
+      </li>
+      <li>The specified location, with the addition of a trailing slash, is a 
+      prefix of the path component of the URL (also treated as a context root).
+      </li>
+    </ul>
+    In the example below, where no trailing slash is used, requests to 
+    /private1, /private1/ and /private1/file.txt will have the enclosed
+    directives applied, but /private1other would not. 
+    <example>
+      &lt;Location /private1&gt;
+          ...
+    </example>
+    In the example below, where a trailing slash is used, requests to 
+    /private2/ and /private2/file.txt will have the enclosed
+    directives applied, but /private2 and /private2other would not. 
+    <example>
+      &lt;Location /private2<em>/</em>&gt;
+          ...
+    </example>
+    </p>
+
     <note><title>When to use <directive 
     type="section">Location</directive></title>
 

Modified: httpd/httpd/branches/2.2.x/docs/manual/sections.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/sections.xml?rev=1040809&r1=1040808&r2=1040809&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/sections.xml (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/sections.xml Tue Nov 30 22:10:27 2010
@@ -216,7 +216,7 @@ In particular, it will apply to requests
 as any other requests starting with the <code>/private</code> string.</p>
 
 <example>
-&lt;Location /private&gt;<br />
+&lt;LocationMatch ^/private&gt;<br />
 Order Allow,Deny<br />
 Deny from all<br />
 &lt;/Location&gt;



Mime
View raw message