[deployment-guide/comm-rel: 476/727] Updated the Alias directive description.

[Jaromir Hradilek]

commit 5ca356ef57ccd2830527090a57ee44a53aed9d9c
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Tue Aug 24 17:56:50 2010 +0200

    Updated the Alias directive description.

 en-US/The_Apache_HTTP_Server.xml |   37 +++++++++++++++++++++++--------------
 1 files changed, 23 insertions(+), 14 deletions(-)
---
diff --git a/en-US/The_Apache_HTTP_Server.xml b/en-US/The_Apache_HTTP_Server.xml
index 9bb209a..e4109b3 100644
--- a/en-US/The_Apache_HTTP_Server.xml
+++ b/en-US/The_Apache_HTTP_Server.xml
@@ -436,21 +436,30 @@ AddIcon /icons/blank.png ^^BLANKICON^^</screen>
             </example>
           </listitem>
         </varlistentry>
+        <varlistentry>
+          <term><option>Alias</option></term>
+          <listitem>
+            <para>
+              The <option>Alias</option> directive allows you to refer to files and directories outside the default directory that is specified by the <option>DocumentRoot</option> directive. By default, only the <literal>/icons/</literal> alias is created, so that requesting <systemitem class="resource">http://<replaceable>hostname</replaceable>/icons/tar.png</systemitem> returns the <filename>/var/www/icons/tar.png</filename> file. The directive takes the following form:
+            </para>
+            <screen>Alias <replaceable>url-path</replaceable> <replaceable>real-path</replaceable></screen>
+            <para>
+              Note that the <replaceable>url-path</replaceable> option is case sensitive. The <option>Alias</option> directive is usually followed by the <literal>Directory</literal> tag containing additional permissions to access the target directory.
+            </para>
+            <example id="example-apache-httpdconf-alias">
+              <title>Using the <option>Alias</option> directive</title>
+              <screen>Alias /icons/ /var/www/icons/
+
+&lt;Directory "/var/www/icons"&gt;
+  Options Indexes MultiViews FollowSymLinks
+  AllowOverride None
+  Order allow,deny
+  Allow from all
+&lt;Directory&gt;</screen>
+            </example>
+          </listitem>
+        </varlistentry>
       </variablelist>
-      <formalpara id="s2-apache-alias">
-        <title>Alias</title>
-        <indexterm>
-          <primary><command>Alias</command></primary>
-          <secondary>Apache configuration directive</secondary>
-        </indexterm>
-        <indexterm>
-          <primary>configuration directives, Apache</primary>
-          <secondary><command>Alias</command></secondary>
-        </indexterm>
-        <para>
-          The <command>Alias</command> setting allows directories outside the <command>DocumentRoot</command> directory to be accessible. Any URL ending in the alias automatically resolves to the alias' path. By default, one alias for an <filename>icons/</filename> directory is already set up. An <filename>icons/</filename> directory can be accessed by the Web server, but the directory is not in the <command> DocumentRoot</command>.
-        </para>
-      </formalpara>
       <formalpara id="s2-apache-allow">
         <title>Allow</title>
         <indexterm>