core.xml: Wrap a Define directive sentence in a <note>

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

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index 2d16fed0b158b0ed9c6c32b7581301fa43719dc1..5af1ebd91dce6f6457eea5555ab018e886330630 100644 (file)
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -787,12 +787,11 @@ 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 (matching or not).
-       Support for 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>
+    <note><title>Virtual Host scope and pitfalls</title>
+      <p>While this directive is supported in virtual host context,
+         the changes it makes are visible to any later configuration
+         directives, beyond any enclosing virtual host.</p>
+    </note>
 </usage>
 <seealso><directive module="core">UnDefine</directive></seealso>
 <seealso><directive module="core">IfDefine</directive></seealso>