[deployment-guide/comm-rel: 501/727] Updated the DirectoryIndex directive description.

[Jaromir Hradilek]

commit 27f0455d32278d1975c2fb13e7c7a173d0df5999
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Thu Aug 26 13:38:57 2010 +0200

    Updated the DirectoryIndex directive description.

 en-US/The_Apache_HTTP_Server.xml |   33 ++++++++++++++++-----------------
 1 files changed, 16 insertions(+), 17 deletions(-)
---
diff --git a/en-US/The_Apache_HTTP_Server.xml b/en-US/The_Apache_HTTP_Server.xml
index d281048..f765357 100644
--- a/en-US/The_Apache_HTTP_Server.xml
+++ b/en-US/The_Apache_HTTP_Server.xml
@@ -836,24 +836,23 @@ AddIcon /icons/blank.png ^^BLANKICON^^</screen>
             </example>
           </listitem>
         </varlistentry>
+        <varlistentry>
+          <term><option>DirectoryIndex</option></term>
+          <listitem>
+            <para>
+              The <option>DirectoryIndex</option> directive allows you to specify a page to be served to a client when a directory is requested (that is, the URL ends with the <literal>/</literal> character). It takes the following form:
+            </para>
+            <screen>DirectoryIndex <replaceable>page</replaceable>...</screen>
+            <para>
+              By default, the server looks for <filename>index.html</filename> or <filename>index.html.var</filename>.
+            </para>
+            <example id="example-apache-httpdconf-directoryindex">
+              <title>Using the <option>DirectoryIndex</option> option</title>
+              <screen>DirectoryIndex index.html index.html.var</screen>
+            </example>
+          </listitem>
+        </varlistentry>
       </variablelist>
-      <formalpara id="s2-apache-directoryindex">
-        <title>DirectoryIndex</title>
-        <indexterm>
-          <primary><command>DirectoryIndex</command></primary>
-          <secondary>Apache configuration directive</secondary>
-        </indexterm>
-        <indexterm>
-          <primary>configuration directives, Apache</primary>
-          <secondary><command>DirectoryIndex</command></secondary>
-        </indexterm>
-        <para>
-          The <command>DirectoryIndex</command> is the default page served by the server when a user requests an index of a directory by specifying a forward slash (/) at the end of the directory name.
-        </para>
-      </formalpara>
-      <para>
-        When a user requests the page http://<replaceable>example</replaceable>/<replaceable>this_directory</replaceable>/, they get either the <command>DirectoryIndex</command> page, if it exists, or a server-generated directory list. The default for <command>DirectoryIndex</command> is <filename>index.html</filename> and the <filename>index.html.var</filename> type map. The server tries to find either of these files and returns the first one it finds. If it does not find one of these files and <command>Options Indexes</command> is set for that directory, the server generates and returns a listing, in HTML format, of the subdirectories and files within the directory, unless the directory listing feature is turned off.
-      </para>
       <formalpara id="s2-apache-documentroot">
         <title>DocumentRoot</title>
         <indexterm>