From: Stefan Fritsch <sf@apache.org>
Date: Tue, 29 May 2012 19:16:29 +0000 (+0000)
Subject: be more verbose about what -DDUMP_CONFIG does not
X-Git-Tag: 2.5.0-alpha~6777
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=7ec854099f9185ea1d14ae97e9b8dca4dc2a0a18;p=apache

be more verbose about what -DDUMP_CONFIG does not


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1343935 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/configuring.xml b/docs/manual/configuring.xml
index 1f23479cb8..4a8b36bb9c 100644
--- a/docs/manual/configuring.xml
+++ b/docs/manual/configuring.xml
@@ -111,7 +111,8 @@ Server.</p>
     variables resolved and all comments and non-matching
     <directive module="core" type="section">IfDefine</directive> and
     <directive module="core" type="section">IfModule</directive> sections
-    removed.</p>
+    removed. However, the output does not reflect the merging or overriding
+    that may happen for repeated directives.</p>
   </section>
 
   <section id="modules">
diff --git a/docs/manual/mod/mod_info.xml b/docs/manual/mod/mod_info.xml
index 519ed4b744..eba7601227 100644
--- a/docs/manual/mod/mod_info.xml
+++ b/docs/manual/mod/mod_info.xml
@@ -114,8 +114,16 @@ configuration</description>
 <section id="startup"><title>Dumping the configuration on startup</title>
     <p>If the config define <code>-DDUMP_CONFIG</code> is set,
     <module>mod_info</module> will dump the pre-parsed configuration to
-    <code>stdout</code> during server startup. This is roughly equivalent
-    to the <code>?config</code> query.</p>
+    <code>stdout</code> during server startup. Pre-parsed means that
+    directives like
+    <directive type="section" module="core">IfDefine</directive> and
+    <directive type="section" module="core">IfModule</directive> are
+    evaluated and environment varialbles are replaced. However it does
+    not represent the final state of the configuration. In particular,
+    it does not represent the merging or overriding that may happen
+    for repeated directives.</p>
+
+    <p>This is roughly equivalent to the <code>?config</code> query.</p>
 </section>
 
 <section id="limitations"><title>Known Limitations</title>