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 78bf50834bc1b50bf3688a6673467b267b54365f..239c9cd10609211c47a0c964affc88c1d2f3d0e7 100644 (file)
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -1404,6 +1404,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>
 
@@ -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>