From 750c2f65c5447703306e843c15d14f3d4932a77e Mon Sep 17 00:00:00 2001
From: Rainer Jung <rjung@apache.org>
Date: Tue, 8 Nov 2011 21:58:03 +0000
Subject: Add "reallyall" and --enable-load-all-modules to docs. Clarify
 LoadModule activation status.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1199481 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/dso.xml                | 20 +++++++++++++++++---
 docs/manual/programs/configure.xml | 22 +++++++++++++++++-----
 docs/manual/upgrading.xml          |  6 ++++++
 3 files changed, 40 insertions(+), 8 deletions(-)

(limited to 'docs')

diff --git a/docs/manual/dso.xml b/docs/manual/dso.xml
index 98bb1d5345..a6e17fb289 100644
--- a/docs/manual/dso.xml
+++ b/docs/manual/dso.xml
@@ -101,9 +101,9 @@ $ make install
       </li>
 
       <li>
-      <p>Configure Apache HTTP Server with all modules enabled, and loaded
-      as shared objects. You can then remove individual ones by
-      commenting out the <directive
+      <p>Configure Apache HTTP Server with all modules enabled. Only a basic
+      set will be loaded during server startup. You can change the set of loaded
+      modules by activating or deactivating the <directive
       module="mod_so">LoadModule</directive> directives in
       <code>httpd.conf</code>.</p>
 
@@ -113,6 +113,20 @@ $ make install
 </example>
       </li>
 
+      <li>
+      <p>Some modules are only useful for developers and will not be build.
+      when using the module set <em>all</em>. To build all available modules
+      including developer modules use <em>reallyall</em>. In addition the
+      <directive module="mod_so">LoadModule</directive> directives for all
+      built modules can be activated via the configure option
+      <code>--enable-load-all-modules</code>.</p>
+
+<example>
+$ ./configure --enable-mods-shared=reallyall --enable-load-all-modules<br />
+$ make install
+</example>
+      </li>
+
       <li>
         Build and install a <em>third-party</em> Apache httpd module, say
         <code>mod_foo.c</code>, into its own DSO
diff --git a/docs/manual/programs/configure.xml b/docs/manual/programs/configure.xml
index 23fbebad06..a762516fdf 100644
--- a/docs/manual/programs/configure.xml
+++ b/docs/manual/programs/configure.xml
@@ -289,15 +289,15 @@
     </section>
 
     <section id="choosemodules"><title>Choosing modules to compile</title>
-      <p>Some modules are compiled by default and have to be disabled
+      <p>Most modules are compiled by default and have to be disabled
         explicitly or by using the keywords <code>few</code> or
         <code>none</code> (see <code>--enable-modules</code>,
         <code>--enable-mods-shared</code> and <code>--enable-mods-static</code>
         below for further explanation) to be removed.</p>
 
         <p>Other modules are not compiled by default and have to be enabled
-        explicitly or by using the keywords <code>most</code> or
-        <code>all</code> to be available.</p>
+        explicitly or by using the keywords <code>all</code> or
+        <code>reallyall</code> to be available.</p>
 
         <p>To find out which modules are compiled by default, run
         <code>./configure -h</code> or <code>./configure --help</code>
@@ -402,8 +402,9 @@
           <example>
             --enable-mods-shared='headers rewrite dav'
           </example>
-          <p>Additionally you can use the special keywords <code>all</code>,
-            <code>most</code> and <code>few</code>. For example,</p>
+          <p>Additionally you can use the special keywords <code>reallyall</code>,
+            <code>all</code>, <code>most</code>, <code>few</code> and <code>none</code>.
+            For example,</p>
           <example>
             --enable-mods-shared=most
           </example>
@@ -415,6 +416,17 @@
           <p>The default set is <code>most</code>.</p>
             <!-- See <a href="../install/enabledmodules.html">Overview of
               enabled modules</a> for further information. -->
+          <p>The <directive module="mod_so">LoadModule</directive> directives for
+          the chosen modules will be automatically generated in the main
+          configuration file. By default, all those directives will be commented
+          out except for the modules that are either required or explicitly selected
+          by a configure <code>--enable-foo</code> argument. You can change the set
+          of loaded modules by activating or deactivating the <directive 
+          module="mod_so">LoadModule</directive> directives in
+          <code>httpd.conf</code>. In addition the
+          <directive module="mod_so">LoadModule</directive> directives for all
+          built modules can be activated via the configure option
+          <code>--enable-load-all-modules</code>.</p>
           <p><strong>Caveat:</strong>
           <code>--enable-mods-shared=all</code> does not actually build all
           modules. To build all modules then, one might use:</p>
diff --git a/docs/manual/upgrading.xml b/docs/manual/upgrading.xml
index 5c78026fd0..2de2c1a71c 100644
--- a/docs/manual/upgrading.xml
+++ b/docs/manual/upgrading.xml
@@ -76,7 +76,13 @@
 
       <li>configure: dynamic modules (DSO) are built by default</li>
 
+      <li>configure: By default, only load those modules that are either required
+      or explicitly selected by a configure <code>--enable-foo</code> argument.</li>
+
       <li>configure: the "most" module set gets built by default</li>
+
+      <li>configure: the "realyall" module set adds developer modules
+      to the "all" set</li>
     </ul>
 
   </section>
-- 
cgit v1.2.3