Merge r1786709 from trunk:

Add a note in the docs about evaluation of Location sections

The sections.html doc was missing, in my opinion, a direct
reference to the fact multiple Location blocks matching
a HTTP request will be evaluated in the order in which they
appear in the configuration files (same as Ifs, etc..).

Reworked a bit a single block of text to be a bit more readable.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1786895 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/sections.xml b/docs/manual/sections.xml
index 679d5843337a4a5cee34cfe8c9da6228934a9c86..520d50717e378557a5fdb2aeb3e9546238106f92 100644 (file)
--- a/docs/manual/sections.xml
+++ b/docs/manual/sections.xml
@@ -483,32 +483,40 @@ are interpreted, it is important to understand how this works.</p>
 
     </ol>
 
-    <p>Apart from <directive type="section"
-    module="core">Directory</directive>, each group is processed in
-    the order that they appear in the configuration files.  <directive
-    type="section" module="core">Directory</directive> (group 1 above)
-    is processed in the order shortest directory component to longest.
-    So for example, <code>&lt;Directory "/var/web/dir"&gt;</code> will
-    be processed before <code>&lt;Directory
-    "/var/web/dir/subdir"&gt;</code>.  If multiple <directive
-    type="section" module="core">Directory</directive> sections apply
-    to the same directory they are processed in the configuration file
-    order. Configurations included via the <directive
-    module="core">Include</directive> directive will be treated as if
-    they were inside the including file at the location of the
-    <directive module="core">Include</directive> directive.</p>
-
-    <p>Sections inside <directive type="section"
-    module="core">VirtualHost</directive> sections
-    are applied <em>after</em> the corresponding sections outside
-    the virtual host definition. This allows virtual hosts to
-    override the main server configuration.</p>
-
-    <p>When the request is served by <module>mod_proxy</module>, the
-    <directive module="mod_proxy" type="section">Proxy</directive>
-    container takes the place of the <directive module="core"
-    type="section">Directory</directive> container in the processing
-    order.</p>
+    <p>Some important remarks:</p>
+    <ul>
+        <li>Apart from <directive type="section"
+        module="core">Directory</directive>, within each group the sections are
+        processed in the order they appear in the configuration files.
+        For example, a request for <em>/foo</em> will match
+        <code>&lt;Location "/foo/bar"&gt;</code> and 
+        <code>&lt;Location "/foo"&gt;</code> (group 4 in this case):
+        both sections will be evaluated
+        but in the order they appear in the configuration files.</li>
+        <li><directive type="section" module="core">Directory</directive>
+        (group 1 above) is processed in the order shortest directory
+        component to longest. For example,
+        <code>&lt;Directory "/var/web/dir"&gt;</code> will be processed before
+        <code>&lt;Directory "/var/web/dir/subdir"&gt;</code>.</li>
+        <li>If multiple <directive
+        type="section" module="core">Directory</directive> sections apply
+        to the same directory they are processed in the configuration file
+        order.</li>
+        <li>Configurations included via the <directive
+        module="core">Include</directive> directive will be treated as if
+        they were inside the including file at the location of the
+        <directive module="core">Include</directive> directive.</li>
+        <li>Sections inside <directive type="section"
+        module="core">VirtualHost</directive> sections
+        are applied <em>after</em> the corresponding sections outside
+        the virtual host definition. This allows virtual hosts to
+        override the main server configuration.</li>
+        <li>When the request is served by <module>mod_proxy</module>, the
+        <directive module="mod_proxy" type="section">Proxy</directive>
+        container takes the place of the <directive module="core"
+        type="section">Directory</directive> container in the processing
+        order.</li>
+    </ul>
 
     <note><title>Technical Note</title>
       There is actually a