backport & expand on Define in non-global scope.

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

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1761343 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index 54442305be78b6a1c9bb576765ecdf8424d2ec94..065a65e2b4aaea0d6f815871a36f7c93c815d3c9 100644 (file)
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -786,6 +786,13 @@ DocumentRoot "/var/www/${servername}/htdocs"
 
     <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>