From: Eric Covener <covener@apache.org>
Date: Tue, 6 Dec 2022 13:41:04 +0000 (+0000)
Subject: Merge r1905793 from trunk:
X-Git-Tag: 2.4.55-rc1-candidate~44
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=cd8ec9c5284cacbb5c908c1e96be2b3b6e2d861f;p=thirdparty%2Fapache%2Fhttpd.git

Merge r1905793 from trunk:

PR66374: add some <If> warning notes.

EXEC_ON_READ and similar can't be conditional on runtime checks,
but for backwards compat they aren't yet rejected.




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

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index 78bf50834bc..239c9cd1060 100644
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -1404,6 +1404,12 @@ EnableSendfile On
 &lt;/IfDefine&gt;
     </highlight>
 
+    <note type="warning"><title>Note</title>
+        <p> This directive is evaluated and configuration processing time, 
+        not at runtime. As a result, this directive cannot be conditonally
+        evaluated by enclosing it in an <directive type="section" module="core"
+        >If</directive> section.</p>
+    </note>
 </usage>
 </directivesynopsis>
 
@@ -2230,6 +2236,16 @@ satisfied by a request at runtime</description>
     been evaluated, and so will not be available to use in this
     directive.
     </note>
+    
+    <note type="warning">
+    Directives that take affect during configuration parsing, such as 
+    <directive>Define</directive>, <directive>Include</directive>, and
+    <directive>Error</directive> cannot be made conditional by enclosing
+    them in an if <directive type="section">If</directive> configuration
+    section.  These sections are always part of the configuration, 
+    regardless of how they evaluate at runtime.
+    </note>
+
 
 </usage>