Commit 9a588d75 authored by Rainer Jung's avatar Rainer Jung
Browse files

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
parent 47ce0591

docs/manual/dso.xml

+17 −3
Original line number Diff line number Diff line
@@ -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

docs/manual/programs/configure.xml

+17 −5
Original line number Diff line number Diff line
@@ -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>

docs/manual/upgrading.xml

+6 −0
Original line number Diff line number Diff line
@@ -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>