Mailing List Archive

svn commit: r1905793 - /httpd/httpd/trunk/docs/manual/mod/core.xml
Author: covener
Date: Tue Dec 6 13:36:03 2022
New Revision: 1905793

URL: http://svn.apache.org/viewvc?rev=1905793&view=rev
Log:
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.


Modified:
httpd/httpd/trunk/docs/manual/mod/core.xml

Modified: httpd/httpd/trunk/docs/manual/mod/core.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/core.xml?rev=1905793&r1=1905792&r2=1905793&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/core.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/core.xml Tue Dec 6 13:36:03 2022
@@ -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</descr
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>