From: Rich Bowen <rbowen@apache.org>
Date: Thu, 30 Apr 2026 14:46:38 +0000 (+0000)
Subject: mod_proxy: clarify ProxyPass ordering in Location blocks (bz#60479)
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=87d8961e8bef4bb7106bceecea5c123d911ff5eb;p=thirdparty%2Fapache%2Fhttpd.git

mod_proxy: clarify ProxyPass ordering in Location blocks (bz#60479)

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

diff --git a/docs/manual/mod/mod_proxy.xml b/docs/manual/mod/mod_proxy.xml
index 979fc0035e..8ff5db7597 100644
--- a/docs/manual/mod/mod_proxy.xml
+++ b/docs/manual/mod/mod_proxy.xml
@@ -1039,8 +1039,15 @@ ProxyPass "/mirror/foo/i" "!"
     <note type="warning"><title>Ordering ProxyPass Directives in Locations</title>
       <p>Only one <directive module="mod_proxy">ProxyPass</directive> directive
       can be placed in a <directive module="core">Location</directive> block,
-      and the most specific location will take precedence.</p>
+      and the last matching
+      <directive module="core">Location</directive> block takes precedence,
+      following the standard
+      <a href="../sections.html#merging">section merging</a> rules.
+      Place more-specific <directive module="core">Location</directive>
+      blocks <em>after</em> less-specific ones to ensure the intended
+      <directive module="mod_proxy">ProxyPass</directive> applies.</p>
     </note>
+
     <note type="warning"><title>Exclusions and the no-proxy environment variable</title>
       <p>Exclusions must come <em>before</em> the
       general <directive>ProxyPass</directive> directives. In 2.4.26 and later, the "no-proxy"