From cb9e2e9e1936b0ff7a2822194a1a80127adcdb9d Mon Sep 17 00:00:00 2001
From: Astrid Malo <kess@apache.org>
Date: Mon, 17 Nov 2003 22:28:17 +0000
Subject: [PATCH] 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
---
 docs/manual/programs/configure.html.en | 11 ++++++++---
 docs/manual/programs/configure.xml     | 11 ++++++++---
 2 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/docs/manual/programs/configure.html.en b/docs/manual/programs/configure.html.en
index 1e2ebd76cc..50d6f25720 100644
--- 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 7cd19611de..da5030b043 100644
--- 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>
 
-- 
2.40.0