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 b6c146d21cdba43d4d097ac6b41ddf1da0064c99..779553d06f1b45afede64bdd4faa3886fbe0fa9e 100644 (file)
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -1423,6 +1423,12 @@ EnableSendfile On
 </IfDefine>
     </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>