From 1b398e31a756d24199e41d90e2204126f3584326 Mon Sep 17 00:00:00 2001
From: Rich Bowen <rbowen@apache.org>
Date: Thu, 30 Sep 2010 19:45:43 +0000
Subject: [PATCH] Adds caution about overusing IfModule, and mentions the -M
 flag in addition to the -l flag for determining what modules are loaded.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1003217 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/configuring.html.en | 15 ++++++++++-----
 docs/manual/configuring.xml     | 15 ++++++++++-----
 2 files changed, 20 insertions(+), 10 deletions(-)

diff --git a/docs/manual/configuring.html.en b/docs/manual/configuring.html.en
index 6258de26bd..11cee4bd17 100644
--- a/docs/manual/configuring.html.en
+++ b/docs/manual/configuring.html.en
@@ -49,7 +49,7 @@ Server.</p>
     added using the <code class="directive"><a href="./mod/core.html#include">Include</a></code>
     directive, and wildcards can be used to include many configuration
     files. Any directive may be placed in any of these configuration
-    files.  Changes to the main configuration files are only
+    files. Changes to the main configuration files are only
     recognized by httpd when it is started or restarted.</p>
 
     <p>The server also reads a file containing mime document types;
@@ -79,13 +79,13 @@ Server.</p>
     If "ENVVAR" is the name of a valid environment variable, the value
     of that variable is substituted into that spot in the
     configuration file line, and processing continues as if that text
-    were found directly in the configuration file.  (If the ENVVAR
+    were found directly in the configuration file. (If the ENVVAR
     variable is not found, the characters "${ENVVAR}" are left
     unchanged for use by later stages in the config file
     processing.)</p>
 
     <p>Only environment variables defined before the server is started
-    can be used in expansions.  Variables defined in the
+    can be used in expansions. Variables defined in the
     configuration file itself, for example with <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code>, take effect too late to be
     used for expansions in the configuration file.</p>
 
@@ -115,10 +115,15 @@ Server.</p>
     directive.
     Otherwise, httpd must be recompiled to add or remove modules.
     Configuration directives may be included conditional on a
-    presence of a particular module by enclosing them in an <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code> block.</p>
+    presence of a particular module by enclosing them in an <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code> block. However,
+    <code class="directive">&lt;IfModule&gt;</code> blocks are not
+    required, and in some cases may mask the fact that you're missing an
+    important module.</p>
 
     <p>To see which modules are currently compiled into the server,
-    you can use the <code>-l</code> command line option.</p>
+    you can use the <code>-l</code> command line option. You can also
+    see what modules are loaded dynamically using the <code>-M</code>
+    command line option.</p>
   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="scope" id="scope">Scope of Directives</a></h2>
diff --git a/docs/manual/configuring.xml b/docs/manual/configuring.xml
index 1c78223ea4..901ae7bb36 100644
--- a/docs/manual/configuring.xml
+++ b/docs/manual/configuring.xml
@@ -51,7 +51,7 @@ Server.</p>
     added using the <directive module="core">Include</directive>
     directive, and wildcards can be used to include many configuration
     files. Any directive may be placed in any of these configuration
-    files.  Changes to the main configuration files are only
+    files. Changes to the main configuration files are only
     recognized by httpd when it is started or restarted.</p>
 
     <p>The server also reads a file containing mime document types;
@@ -82,13 +82,13 @@ Server.</p>
     If "ENVVAR" is the name of a valid environment variable, the value
     of that variable is substituted into that spot in the
     configuration file line, and processing continues as if that text
-    were found directly in the configuration file.  (If the ENVVAR
+    were found directly in the configuration file. (If the ENVVAR
     variable is not found, the characters "${ENVVAR}" are left
     unchanged for use by later stages in the config file
     processing.)</p>
 
     <p>Only environment variables defined before the server is started
-    can be used in expansions.  Variables defined in the
+    can be used in expansions. Variables defined in the
     configuration file itself, for example with <directive
     module="mod_env">SetEnv</directive>, take effect too late to be
     used for expansions in the configuration file.</p>
@@ -130,10 +130,15 @@ Server.</p>
     Otherwise, httpd must be recompiled to add or remove modules.
     Configuration directives may be included conditional on a
     presence of a particular module by enclosing them in an <directive
-    module="core" type="section">IfModule</directive> block.</p>
+    module="core" type="section">IfModule</directive> block. However,
+    <directive type="section">IfModule</directive> blocks are not
+    required, and in some cases may mask the fact that you're missing an
+    important module.</p>
 
     <p>To see which modules are currently compiled into the server,
-    you can use the <code>-l</code> command line option.</p>
+    you can use the <code>-l</code> command line option. You can also
+    see what modules are loaded dynamically using the <code>-M</code>
+    command line option.</p>
   </section>
 
   <section id="scope">
-- 
2.50.1