improve this document step by step:

- use --enable-layout description from install.xml

further contributions and comments are welcome

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

diff --git a/docs/manual/programs/configure.html.en b/docs/manual/programs/configure.html.en
index 1e2ebd76cc05f2ae9a2dce8154d9ddd5ff4111e7..50d6f25720c137c829e4dc70f7b11b09e3669817 100644 (file)
--- a/docs/manual/programs/configure.html.en
+++ b/docs/manual/programs/configure.html.en
@@ -131,11 +131,16 @@
 
     <h4><a name="layout" id="layout">Define a directory layout</a></h4>
       <dl>
-        
         <dt><code>--enable-layout=<var>LAYOUT</var></code></dt>
         <dd>Configure the source code and build scripts to assume an
-          installation tree based on the layout <var>LAYOUT</var>. The default
-          layout is <code>Apache</code>.</dd>
+          installation tree based on the layout <var>LAYOUT</var>. This allows
+          you to separately specify the locations for each type of file within
+          the Apache HTTP Server installation. The <code>config.layout</code>
+          file contains several example configurations, and you can also create
+          your own custom configuration following the examples. The different
+          layouts in this file are grouped into <code>&lt;Layout
+            FOO&gt;...&lt;/Layout&gt;</code> sections and referred to by name as
+          in <code>FOO</code>. The default layout is <code>Apache</code>.</dd>
       </dl>
     
 

diff --git a/docs/manual/programs/configure.xml b/docs/manual/programs/configure.xml
index 7cd19611de743a14ac971b3f74ee0e91161faab4..da5030b043f89af40d394e6e37b2c801767b8d84 100644 (file)
--- a/docs/manual/programs/configure.xml
+++ b/docs/manual/programs/configure.xml
@@ -114,11 +114,16 @@
 
     <section id="layout"><title>Define a directory layout</title>
       <dl>
-        <!-- further explanation needed -->
         <dt><code>--enable-layout=<var>LAYOUT</var></code></dt>
         <dd>Configure the source code and build scripts to assume an
-          installation tree based on the layout <var>LAYOUT</var>. The default
-          layout is <code>Apache</code>.</dd>
+          installation tree based on the layout <var>LAYOUT</var>. This allows
+          you to separately specify the locations for each type of file within
+          the Apache HTTP Server installation. The <code>config.layout</code>
+          file contains several example configurations, and you can also create
+          your own custom configuration following the examples. The different
+          layouts in this file are grouped into <code>&lt;Layout
+            FOO&gt;...&lt;/Layout&gt;</code> sections and referred to by name as
+          in <code>FOO</code>. The default layout is <code>Apache</code>.</dd>
       </dl>
     </section>