mod_alias: document Alias context restrictions for one-arg vs two-arg forms (Bug...

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1933768 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/mod/mod_alias.xml b/docs/manual/mod/mod_alias.xml
index 7c28b0723d62cb75dff18f584c180637491d9df0..064772ec00d84f8a341f97e10bbafc0e7e9281c0 100644 (file)
--- a/docs/manual/mod/mod_alias.xml
+++ b/docs/manual/mod/mod_alias.xml
@@ -212,6 +212,18 @@ Alias "/image" "/ftp/pub/image"
 </Location>
     </highlight>
 
+    <note><title>Context restrictions</title>
+    <p>The two-argument form of <directive>Alias</directive> can only
+    be used in server config or <directive module="core"
+    type="section">VirtualHost</directive>. The one-argument form,
+    where the URL path is taken from the enclosing section, can be
+    used in <directive module="core" type="section">Location</directive>,
+    <directive module="mod_proxy" type="section">Proxy</directive>,
+    and <directive module="core" type="section">If</directive>, but
+    not in <directive module="core" type="section">Directory</directive>
+    or <directive module="core" type="section">Files</directive>.</p>
+    </note>
+
 </usage>
 </directivesynopsis>