From: Eric Covener <covener@apache.org>
Date: Tue, 6 Dec 2022 13:36:03 +0000 (+0000)
Subject: PR66374: add some <If> warning notes.
X-Git-Tag: 2.5.0-alpha2-ci-test-only~182
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=45c46dfcb06d1ea5d49fc3689c674f6abacc83b8;p=thirdparty%2Fapache%2Fhttpd.git

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/trunk@1905793 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index b6c146d21cd..779553d06f1 100644
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -1423,6 +1423,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>
 
@@ -2262,6 +2268,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>
 
@@ -5293,6 +5309,12 @@ recognized methods to modules.</p>
 &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>