[deployment-guide/comm-rel: 464/727] Updated the AccessFileName directive description.

[Jaromir Hradilek]

commit 2b80ebc049b348558e6be5bd947022a020181ea6
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Tue Aug 24 12:04:26 2010 +0200

    Updated the AccessFileName directive description.

 en-US/The_Apache_HTTP_Server.xml |   51 ++++++++++++++++++++------------------
 1 files changed, 27 insertions(+), 24 deletions(-)
---
diff --git a/en-US/The_Apache_HTTP_Server.xml b/en-US/The_Apache_HTTP_Server.xml
index 1239061..cd0fbc6 100644
--- a/en-US/The_Apache_HTTP_Server.xml
+++ b/en-US/The_Apache_HTTP_Server.xml
@@ -228,30 +228,6 @@ httpd (pid 19014) is running...</screen>
       <para>
         For more information about <filename>mod_ssl</filename> directives, refer to the documentation online at <ulink url="http://httpd.apache.org/docs/2.2/mod/mod_ssl.html" />.
       </para>
-      <indexterm>
-        <primary><filename>httpd.conf</filename></primary>
-        <see>configuration directives, Apache</see>
-      </indexterm>
-      <indexterm>
-        <primary>configuration directives, Apache</primary>
-      </indexterm>
-      <formalpara id="s2-apache-accessfilename">
-        <title>AccessFileName</title>
-        <indexterm>
-          <primary><command>AccessFileName</command></primary>
-          <secondary>Apache configuration directive</secondary>
-        </indexterm>
-        <indexterm>
-          <primary>configuration directives, Apache</primary>
-          <secondary><command>AccessFileName</command></secondary>
-        </indexterm>
-        <para>
-          <command>AccessFileName</command> names the file which the server should use for access control information in each directory. The default is <filename>.htaccess</filename>.
-        </para>
-      </formalpara>
-      <para>
-        Immediately after the <command>AccessFileName</command> directive, a set of <command>Files</command> tags apply access control to any file beginning with a <filename>.ht</filename>. These directives deny Web access to any <filename>.htaccess</filename> files (or other files which begin with <filename>.ht</filename>) for security reasons.
-      </para>
       <formalpara id="s2-apache-action">
         <title>Action</title>
         <indexterm>
@@ -266,6 +242,33 @@ httpd (pid 19014) is running...</screen>
           <command>Action</command> specifies a MIME content type and CGI script pair, so that when a file of that media type is requested, a particular CGI script is executed.
         </para>
       </formalpara>
+      <variablelist>
+        <varlistentry>
+          <term><option>AccessFileName</option></term>
+          <listitem>
+            <para>
+              The <option>AccessFileName</option> directive allows you to specify the file to be used to customize access control information for each directory. It takes the following form:
+            </para>
+            <screen>AccessFileName <replaceable>filename</replaceable></screen>
+            <para>
+              The default option is <filename>.htaccess</filename>.
+            </para>
+            <para>
+              For security reasons, the directive is followed by the <literal>Files</literal> tag that prevents all files beginning with <filename>.ht</filename> from being accessed by web clients. This usually includes the <filename>.htaccess</filename> and <filename>.htpasswd</filename> files.
+            </para>
+            <example id="example-apache-httpdconf-accessfilename">
+              <title>Using the <option>AccessFileName</option> directive</title>
+              <screen>AccessFileName .htaccess
+
+&lt;Files ~ "^\.ht"&gt;
+  Order allow,deny
+  Deny from all
+  Satisfy All
+&lt;/Files&gt;</screen>
+            </example>
+          </listitem>
+        </varlistentry>
+      </variablelist>
       <formalpara id="s2-apache-adddescription">
         <title>AddDescription</title>
         <indexterm>