From: Rich Bowen <rbowen@apache.org>
Date: Sun, 3 May 2026 14:03:54 +0000 (+0000)
Subject: mod_alias: document Alias context restrictions for one-arg vs two-arg forms (Bug... 
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=c102e55c149cbe4dcc7730770d1bae93984c9418;p=thirdparty%2Fapache%2Fhttpd.git

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

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 7c28b0723d..064772ec00 100644
--- a/docs/manual/mod/mod_alias.xml
+++ b/docs/manual/mod/mod_alias.xml
@@ -212,6 +212,18 @@ Alias "/image" "/ftp/pub/image"
 &lt;/Location&gt;
     </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>