[deployment-guide/comm-rel: 594/727] Updated the <Location> directive description.

[Jaromir Hradilek]

commit f87dfa0ecf78dc117b26c2258167870e0d921f15
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Mon Sep 6 17:23:28 2010 +0200

    Updated the <Location> directive description.

 en-US/The_Apache_HTTP_Server.xml |   56 ++++++++++++++++---------------------
 1 files changed, 24 insertions(+), 32 deletions(-)
---
diff --git a/en-US/The_Apache_HTTP_Server.xml b/en-US/The_Apache_HTTP_Server.xml
index 17297a6..06467f2 100644
--- a/en-US/The_Apache_HTTP_Server.xml
+++ b/en-US/The_Apache_HTTP_Server.xml
@@ -303,6 +303,30 @@ httpd (pid 19014) is running...</screen>
           </listitem>
         </varlistentry>
         <varlistentry>
+          <term><option>&lt;Location&gt;</option></term>
+          <listitem>
+            <para>
+              The <option>&lt;Location&gt;</option> directive allows you to apply certain directives to the selected URL only. It takes the following form:
+            </para>
+            <screen>&lt;Location <replaceable>url</replaceable>&gt;
+  <replaceable>directive</replaceable>
+  &#8230;
+&lt;/Location&gt;</screen>
+            <para>
+              The <replaceable>url</replaceable> can be either a path relative to the directory specified by the <option>DocumentRoot</option> directive (for example, <literal>/server-info</literal>), or an external URL such as <literal>http://example.com/server-info</literal>.
+            </para>
+            <example id="example-apache-httpdconf-location">
+              <title>Using the <option>&lt;Location&gt;</option> directive</title>
+              <screen>&lt;Location /server-info&gt;
+  SetHandler server-info
+  Order deny,allow
+  Deny from all
+  Allow from .example.com
+&lt;/Location&gt;</screen>
+            </example>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
           <term><option>AccessFileName</option></term>
           <listitem>
             <para>
@@ -2493,38 +2517,6 @@ ErrorDocument 404 /404-not_found.html</screen>
           </listitem>
         </varlistentry>
       </variablelist>
-      <formalpara id="s2-apache-location">
-        <title>Location</title>
-        <indexterm>
-          <primary><command>Location</command></primary>
-          <secondary>Apache configuration directive</secondary>
-        </indexterm>
-        <indexterm>
-          <primary>configuration directives, Apache</primary>
-          <secondary><command>Location</command></secondary>
-        </indexterm>
-        <indexterm>
-          <primary>Apache HTTP Server</primary>
-          <secondary>server status reports</secondary>
-        </indexterm>
-        <para>
-          The <command>&lt;Location&gt;</command> and <command>&lt;/Location&gt;</command> tags create a container in which access control based on URL can be specified.
-        </para>
-      </formalpara>
-      <para>
-        For instance, to allow people connecting from within the server's domain to see status reports, use the following directives:
-      </para>
-      <screen><command>&lt;Location /server-status&gt; SetHandler server-status Order deny,allow Deny from all Allow from <replaceable>&lt;.example.com&gt;</replaceable> &lt;/Location&gt;</command></screen>
-      <para>
-        Replace <replaceable>&lt;.example.com&gt;</replaceable> with the second-level domain name for the Web server.
-      </para>
-      <para>
-        To provide server configuration reports (including installed modules and configuration directives) to requests from inside the domain, use the following directives:
-      </para>
-      <screen><command>&lt;Location /server-info&gt; SetHandler server-info Order deny,allow Deny from all Allow from <replaceable>&lt;.example.com&gt;</replaceable> &lt;/Location&gt;</command></screen>
-      <para>
-        Again, replace <replaceable>&lt;.example.com&gt;</replaceable> with the second-level domain name for the Web server.
-      </para>
       <formalpara id="s2-apache-proxy">
         <title>Proxy</title>
         <indexterm>