svn commit: r1761343 - /httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml

[co...@apache.org]

Author: covener
Date: Sun Sep 18 17:19:45 2016
New Revision: 1761343

URL: http://svn.apache.org/viewvc?rev=1761343&view=rev
Log:

backport & expand on Define in non-global scope.

We can't backport fixing Define, so explain the problem.


Modified:
    httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml

Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml?rev=1761343&r1=1761342&r2=1761343&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/core.xml Sun Sep 18 17:19:45 2016
@@ -786,6 +786,13 @@ DocumentRoot "/var/www/${servername}/htd
 
     <p>Variable names may not contain colon ":" characters, to avoid clashes
     with <directive module="mod_rewrite">RewriteMap</directive>'s syntax.</p>
+
+    <p>While this directive is supported in virtual host and directory context,
+       the changes it makes are visible to any later configuration
+       directives, beyond any enclosing configuration section. Support for the
+       the other configuration sections was erroneously permitted by the initial
+       implementation of this directive and is only preserved (with unintuitive 
+       results to maintain backward compatibility.</p>
 </usage>
 </directivesynopsis>