From: Rich Bowen <rbowen@apache.org>
Date: Fri, 1 May 2026 14:54:37 +0000 (+0000)
Subject: Bug 69329: Document ServerPath in vhost matching details; mark as legacy HTTP/1.0... 
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=8e8be3539fd6c4ea2b9ac36c1edf9e52c2f1fd8d;p=thirdparty%2Fapache%2Fhttpd.git

Bug 69329: Document ServerPath in vhost matching details; mark as legacy HTTP/1.0 feature; fix seealso link

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

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index 901cc9e4b2..febb614049 100644
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -4690,9 +4690,17 @@ is accessed by an incompatible browser</description>
 <usage>
     <p>The <directive>ServerPath</directive> directive sets the legacy
     URL pathname for a host, for use with <a
-    href="../vhosts/">name-based virtual hosts</a>.</p>
+    href="../vhosts/name-based.html">name-based virtual hosts</a>.</p>
+
+    <note><p>This is a legacy feature for providing compatibility with
+    HTTP/1.0 clients that do not send a <code>Host:</code> header. When
+    such a client requests a URL matching a vhost's
+    <directive>ServerPath</directive>, the request is served from that
+    vhost. In practice, all modern HTTP clients send the
+    <code>Host:</code> header, making this directive unnecessary.</p></note>
 </usage>
-<seealso><a href="../vhosts/">Apache HTTP Server Virtual Host documentation</a></seealso>
+<seealso><a href="../vhosts/name-based.html">Name-based Virtual Host Support</a></seealso>
+<seealso><a href="../vhosts/examples.html#serverpath">ServerPath example</a></seealso>
 </directivesynopsis>
 
 <directivesynopsis>
diff --git a/docs/manual/vhosts/details.xml b/docs/manual/vhosts/details.xml
index df9222f64c..c913ead509 100644
--- a/docs/manual/vhosts/details.xml
+++ b/docs/manual/vhosts/details.xml
@@ -222,7 +222,13 @@
     file with the specified IP address has the highest priority
     and catches any request to an unknown server name, or a request
     without a <code>Host:</code> header field (such as a HTTP/1.0
-    request).</p>
+    request). If a <directive module="core">ServerPath</directive>
+    is configured for any of the matching vhosts, and the request URL
+    matches that path, the request is served from that vhost instead.
+    This is a legacy mechanism for HTTP/1.0 clients that do not send
+    a <code>Host:</code> header; see the
+    <a href="examples.html#serverpath">ServerPath example</a> for
+    details.</p>
 
     </section>