I just spent a few minutes helping someone on the users list figure

out how to use <IfModule> with php4 and Apache2 (solution
<IfModule sapi_apache2.c>).  Document the technique for posterity.

Also, try to discourage people from adding random <IfModule>
sections just for the heck of it.

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

diff --git a/docs/manual/mod/core.html.en b/docs/manual/mod/core.html.en
index 7d8d4dfd99907b2b054e06e3459ce0f5687f2907..ab21b9e126ce3a0ae33ac95e8061adb8102555db 100644 (file)
--- a/docs/manual/mod/core.html.en
+++ b/docs/manual/mod/core.html.en
@@ -842,7 +842,8 @@ presence of absence of a specific module</td></tr><tr><th><a href="directive-dic
               </a></th><td>core</td></tr></table>
     <p>The <code>&lt;IfModule
     <em>test</em>&gt;...&lt;/IfModule&gt;</code> section is used to
-    mark directives that are conditional. The directives within an
+    mark directives that are conditional on the presence of a 
+    specific module. The directives within an
     <code class="directive">&lt;IfModule&gt;</code> section are only
     processed if the <em>test</em> is true. If <em>test</em> is false,
     everything between the start and end markers is ignored.</p>
@@ -864,12 +865,20 @@ presence of absence of a specific module</td></tr><tr><th><a href="directive-dic
     name</em> is <strong>not</strong> included.</p>
 
     <p>The <em>module name</em> argument is the file name of the
-    module, at the time it was compiled.
-    For example, <code>mod_rewrite.c</code>.</p>
+    module, at the time it was compiled.  For example,
+    <code>mod_rewrite.c</code>.  If a module consists of several
+    source files, use the name of the file containing the string
+    <code>STANDARD20_MODULE_STUFF</code>.</p>
 
     <p><code class="directive">&lt;IfModule&gt;</code> sections are
     nest-able, which can be used to implement simple multiple-module
     tests.</p>
+
+    <div class="note">This section should only be used if you need to have one
+    configuration file that works whether or not a specific module
+    is available.  In normal operation, directives need not be
+    placed in <code class="directive">&lt;IfModule&gt;</code>
+    sections.</div>
 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="directive-section"><h2><a name="Include" id="Include">Include</a> <a name="include" id="include">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description: 
               </a></th><td>Includes other configuration files from within
 the server configuration files</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index ee4f3573272b6e360233bffc6da5266b213439f7..ea9b47d79329a0ad51da05509c08521bf0e976ed 100644 (file)
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -1036,7 +1036,8 @@ presence of absence of a specific module</description>
 <usage>
     <p>The <code>&lt;IfModule
     <em>test</em>&gt;...&lt;/IfModule&gt;</code> section is used to
-    mark directives that are conditional. The directives within an
+    mark directives that are conditional on the presence of a 
+    specific module. The directives within an
     <directive type="section">IfModule</directive> section are only
     processed if the <em>test</em> is true. If <em>test</em> is false,
     everything between the start and end markers is ignored.</p>
@@ -1060,12 +1061,20 @@ presence of absence of a specific module</description>
     name</em> is <strong>not</strong> included.</p>
 
     <p>The <em>module name</em> argument is the file name of the
-    module, at the time it was compiled.
-    For example, <code>mod_rewrite.c</code>.</p>
+    module, at the time it was compiled.  For example,
+    <code>mod_rewrite.c</code>.  If a module consists of several
+    source files, use the name of the file containing the string
+    <code>STANDARD20_MODULE_STUFF</code>.</p>
 
     <p><directive type="section">IfModule</directive> sections are
     nest-able, which can be used to implement simple multiple-module
     tests.</p>
+
+    <note>This section should only be used if you need to have one
+    configuration file that works whether or not a specific module
+    is available.  In normal operation, directives need not be
+    placed in <directive type="section">IfModule</directive>
+    sections.</note>
 </usage>
 </directivesynopsis>