[deployment-guide/comm-rel: 483/727] Updated the AllowOverride directive description.

[Jaromir Hradilek]

commit c74eb5287c2758e30a06b47bd765327fb9447f31
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Wed Aug 25 14:31:12 2010 +0200

    Updated the AllowOverride directive description.

 en-US/The_Apache_HTTP_Server.xml |  107 ++++++++++++++++++++++++++++++++-----
 1 files changed, 92 insertions(+), 15 deletions(-)
---
diff --git a/en-US/The_Apache_HTTP_Server.xml b/en-US/The_Apache_HTTP_Server.xml
index 7b94210..f8b3022 100644
--- a/en-US/The_Apache_HTTP_Server.xml
+++ b/en-US/The_Apache_HTTP_Server.xml
@@ -475,21 +475,98 @@ AddIcon /icons/blank.png ^^BLANKICON^^</screen>
             </example>
           </listitem>
         </varlistentry>
+        <varlistentry>
+          <term><option>AllowOverride</option></term>
+          <listitem>
+            <para>
+              The <option>AllowOverride</option> directive allows you to specify which directives in a <filename>.htaccess</filename> file can override the default configuration. It takes the following form:
+            </para>
+            <screen>AllowOverride <replaceable>type</replaceable>...</screen>
+            <para>
+              The <replaceable>type</replaceable> has to be one of the available grouping options as described in <xref linkend="table-apache-httpdconf-allowoverride" />.
+            </para>
+            <table id="table-apache-httpdconf-allowoverride">
+              <title>Available options</title>
+              <tgroup cols="2">
+                <colspec colname="option" colnum="1" colwidth="20*" />
+                <colspec colname="description" colnum="2" colwidth="60*" />
+                <thead>
+                  <row>
+                    <entry>
+                      Option
+                    </entry>
+                    <entry>
+                      Description
+                    </entry>
+                  </row>
+                </thead>
+                <tbody>
+                  <row>
+                    <entry>
+                      <option>All</option>
+                    </entry>
+                    <entry>
+                      All directives in <filename>.htaccess</filename> are allowed to override earlier configuration settings.
+                    </entry>
+                  </row>
+                  <row>
+                    <entry>
+                      <option>None</option>
+                    </entry>
+                    <entry>
+                      No directive in <filename>.htaccess</filename> is allowed to override earlier configuration settings.
+                    </entry>
+                  </row>
+                  <row>
+                    <entry>
+                      <option>AuthConfig</option>
+                    </entry>
+                    <entry>
+                      Allows the use of authorization directives such as <option>AuthName</option>, <option>AuthType</option>, or <option>Require</option>.
+                    </entry>
+                  </row>
+                  <row>
+                    <entry>
+                      <option>FileInfo</option>
+                    </entry>
+                    <entry>
+                      Allows the use of file type, metadata, and <systemitem class="resource">mod_rewrite</systemitem> directives such as <option>DefaultType</option>, <option>RequestHeader</option>, or <option>RewriteEngine</option>, as well as the <option>Action</option> directive.
+                    </entry>
+                  </row>
+                  <row>
+                    <entry>
+                      <option>Indexes</option>
+                    </entry>
+                    <entry>
+                      Allows the use of directory indexing directives such as <option>AddDescription</option>, <option>AddIcon</option>, or <option>FancyIndexing</option>.
+                    </entry>
+                  </row>
+                  <row>
+                    <entry>
+                      <option>Limit</option>
+                    </entry>
+                    <entry>
+                      Allows the use of host access directives, that is, <option>Allow</option>, <option>Deny</option>, and <option>Order</option>.
+                    </entry>
+                  </row>
+                  <row>
+                    <entry>
+                      <option>Options[=<replaceable>option</replaceable>,...]</option>
+                    </entry>
+                    <entry>
+                      Allows the use of the <option>Options</option> directive. You can also provide a comma-separated list of options to specify which options can be set using this directive.
+                    </entry>
+                  </row>
+                </tbody>
+              </tgroup>
+            </table>
+            <example id="example-apache-httpdconf-allowoverride">
+              <title>Using the <option>AllowOverride</option> directive</title>
+              <screen>AllowOverride FileInfo AuthConfig Limit</screen>
+            </example>
+          </listitem>
+        </varlistentry>
       </variablelist>
-      <formalpara id="s2-apache-allowoverride">
-        <title>AllowOverride</title>
-        <indexterm>
-          <primary><command>AllowOverride</command></primary>
-          <secondary>Apache configuration directive</secondary>
-        </indexterm>
-        <indexterm>
-          <primary>configuration directives, Apache</primary>
-          <secondary><command>AllowOverride</command></secondary>
-        </indexterm>
-        <para>
-          The <command>AllowOverride</command> directive sets whether any <command>Options</command> can be overridden by the declarations in an <filename>.htaccess</filename> file. By default, both the root directory and the <command>DocumentRoot</command> are set to allow no <filename>.htaccess</filename> overrides.
-        </para>
-      </formalpara>
       <formalpara id="s2-apache-browsermatch">
         <title>BrowserMatch</title>
         <indexterm>
@@ -656,7 +733,7 @@ AddIcon /icons/blank.png ^^BLANKICON^^</screen>
         </para>
       </formalpara>
       <para>
-        By default, very restrictive parameters are applied to the root directory (<filename>/</filename>), using the <command>Options</command> (refer to <xref linkend="s2-apache-options" />) and <command>AllowOverride</command> (refer to <xref linkend="s2-apache-allowoverride" />) directives. Under this configuration, any directory on the system which needs more permissive settings has to be explicitly given those settings.
+        By default, very restrictive parameters are applied to the root directory (<filename>/</filename>), using the <command>Options</command> (refer to <xref linkend="s2-apache-options" />) and <command>AllowOverride</command> <!-- (refer to <xref linkend="s2-apache-allowoverride" />) -->directives. Under this configuration, any directory on the system which needs more permissive settings has to be explicitly given those settings.
       </para>
       <para>
         In the default configuration, another <command>Directory</command> container is configured for the <command>DocumentRoot</command> which assigns less rigid parameters to the directory tree so that the Apache HTTP Server can access the files residing there.