Bug 69329: Document ServerPath in vhost matching details; mark as legacy HTTP/1.0...

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 901cc9e4b2bf27b2f19b920f0aa2434c86d279f3..febb614049d17b4b5fc6bb16a138101a92da826e 100644 (file)
--- 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 df9222f64c09498095124c7b43a6f621b6c16e18..c913ead509bea4befaeb12d63bfe6463d833e919 100644 (file)
--- 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>