From 31aafeedf0e404caa5e72aa57ebf38971de1af98 Mon Sep 17 00:00:00 2001
From: Stefan Fritsch <sf@apache.org>
Date: Tue, 29 May 2012 19:16:29 +0000
Subject: [PATCH] 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
---
 docs/manual/configuring.xml  |  3 ++-
 docs/manual/mod/mod_info.xml | 12 ++++++++++--
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/docs/manual/configuring.xml b/docs/manual/configuring.xml
index 1f23479cb81..4a8b36bb9c7 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 519ed4b744e..eba76012270 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>
-- 
2.47.3