Clarify what happens if you don't have a ServerName in your

<VirtualHost>, since people sometimes assume that this
implies the host has no name, resulting in confusion.

Suggested by: Michael Rasmussen <mikeraz patch.com>

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

diff --git a/docs/manual/mod/core.html.en b/docs/manual/mod/core.html.en
index bc8d8a7a01e96b574227f78b8b4636bd6b3ca469..7de1b66543ef7ccbc11c43469183ac67eb87c61a 100644 (file)
--- a/docs/manual/mod/core.html.en
+++ b/docs/manual/mod/core.html.en
@@ -3186,6 +3186,11 @@ hostname or IP address</td></tr>
     to match all ports on that address. (This is recommended when used
     with <code>_default_</code>.)</p>
 
+    <p>A <code class="directive"><a href="#servername">ServerName</a></code> should be
+    specified inside each <code class="directive">&lt;VirtualHost&gt;</code> block. If it is absent, the
+    <code class="directive"><a href="#servername">ServerName</a></code> from the "main"
+    server configuration will be inherited.</p>
+
     <div class="warning"><h3>Security</h3>
     <p>See the <a href="../misc/security_tips.html">security tips</a>
     document for details on why your security could be compromised if the

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index fa7175aba60fb3eff565e9ee23f44a71ec0b2cc2..6799ddfe78c7d19826a9a0fe5f1b2d60380a31ff 100644 (file)
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -3157,6 +3157,12 @@ hostname or IP address</description>
     to match all ports on that address. (This is recommended when used
     with <code>_default_</code>.)</p>
 
+    <p>A <directive module="core">ServerName</directive> should be
+    specified inside each <directive
+    type="section">VirtualHost</directive> block. If it is absent, the
+    <directive module="core">ServerName</directive> from the "main"
+    server configuration will be inherited.</p>
+
     <note type="warning"><title>Security</title>
     <p>See the <a href="../misc/security_tips.html">security tips</a>
     document for details on why your security could be compromised if the