Adds caution about overusing IfModule, and mentions the -M flag in

rbowen · rbowen · commit 8425acc68ae0 · 2010-09-30T19:45:43.000Z
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
diff --git 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
@@ -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">
