From ed9a6d74555ab6b5168c78d0b822929345e5ce6c Mon Sep 17 00:00:00 2001
From: Eric Covener <covener@apache.org>
Date: Sat, 3 Dec 2022 15:31:53 +0000
Subject: [PATCH] mention some non-inuititive <If> stuff

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1905716 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/sections.xml | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

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>
-- 
2.47.2