From: Eric Covener <covener@apache.org>
Date: Sat, 3 Dec 2022 15:31:53 +0000 (+0000)
Subject: mention some non-inuititive <If> stuff
X-Git-Tag: 2.5.0-alpha2-ci-test-only~183
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ed9a6d74555ab6b5168c78d0b822929345e5ce6c;p=thirdparty%2Fapache%2Fhttpd.git

mention some non-inuititive <If> stuff



git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1905716 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/sections.xml b/docs/manual/sections.xml
index 4ac440c78aa..1689f26ff88 100644
--- a/docs/manual/sections.xml
+++ b/docs/manual/sections.xml
@@ -481,7 +481,8 @@ are interpreted, it is important to understand how this works.</p>
       and <directive type="section"
       module="core">LocationMatch</directive> done simultaneously</li>
 
-      <li><directive type="section" module="core">If</directive>
+      <li><directive type="section" module="core">If</directive> sections, even when
+      they are enclosed in any of the preceding contexts.
       </li>
 
     </ol>
@@ -519,6 +520,15 @@ are interpreted, it is important to understand how this works.</p>
         container takes the place of the <directive module="core"
         type="section">Directory</directive> container in the processing
         order.</li>
+        <li> Caution should be exercised when mixing related configuration
+        directives inside and outside of <directive type="section" module="core"
+        >If</directive> because of the effect on merging order.  Explicit use
+        of <directive type="section" module="core" >Else</directive> can help.
+        </li>
+        <li> When <directive type="section" module="core" >If</directive> is 
+        used in <code>.htaccess</code>, the enclosed directives in a parent 
+        directory will be merged <em>after</em> non-enclosed directives in a 
+        subdirectory.</li>
     </ul>
 
     <note><title>Technical Note</title>