Too many people seem to try to use _default_ with name-virtual hosts.

Maybe this will help?

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

diff --git a/docs/manual/mod/core.html.en b/docs/manual/mod/core.html.en
index 0454e128a3c6f150d1ca879ae31a2df00859930f..e51f544fae599151def2c63e6b47e0e047c2cbf2 100644 (file)
--- a/docs/manual/mod/core.html.en
+++ b/docs/manual/mod/core.html.en
@@ -1692,18 +1692,24 @@ hostname or IP address</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.
     ...&gt; ... &lt;/VirtualHost&gt;</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Core</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:</a></td><td>core</td></tr></table></td></tr></table>
     <p><code class="directive">&lt;VirtualHost&gt;</code> and
     <code>&lt;/VirtualHost&gt;</code> are used to enclose a group of
-    directives which will apply only to a particular virtual host. Any
-    directive which is allowed in a virtual host context may be
+    directives that will apply only to a particular virtual host. Any
+    directive that is allowed in a virtual host context may be
     used. When the server receives a request for a document on a
     particular virtual host, it uses the configuration directives
     enclosed in the <code class="directive">&lt;VirtualHost&gt;</code>
     section. <em>Addr</em> can be</p>
 
     <ul>
-      <li>The IP address of the virtual host</li>
+      <li>The IP address of the virtual host;</li>
 
       <li>A fully qualified domain name for the IP address of the
-      virtual host.</li>
+      virtual host;</li>
+
+      <li>The character *, which is used only in combination with
+      <code>NameVirtualHost *</code> to match all IP addresses; or</li>
+
+      <li>The string <code>_default_</code>, which is used only
+      with IP virtual hosting to catch unmatched IP addresses.</li>
     </ul>
     
 
@@ -1738,14 +1744,18 @@ hostname or IP address</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.
     accept IP packets for multiple addresses. (If the machine does
     not have multiple network interfaces, then this can be
     accomplished with the <code>ifconfig alias</code> command (if
-    your OS supports it), or with kernel patches like <a href="../misc/vif-info.html">VIF</a> (for SunOS(TM) 4.1.x)).</p>
+    your OS supports it).</p>
 
-    <p>The special name <code>_default_</code> can be specified in
+    <p>When using IP-based virtual hosting, the special name
+    <code>_default_</code> can be specified in
     which case this virtual host will match any IP address that is
     not explicitly listed in another virtual host. In the absence
     of any _default_ virtual host the "main" server config,
     consisting of all those definitions outside any VirtualHost
-    section, is used when no match occurs.</p>
+    section, is used when no IP-match occurs.  (But note that any IP
+    address that matches a <a href="#namevirtualhost" class="directive"><code class="directive">NameVirtualHost</code></a> directive will never use
+    the "main" server config.  See the <a href="../vhosts/name-based.html">name-based virtual hosting</a>
+    documentation for further details.)</p>
 
     <p>You can specify a <code>:port</code> to change the port that is
     matched. If unspecified then it defaults to the same port as the

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index 50a82e06f22894be7e127623ba6e3b20fc628e51..3d6ca8130dd235e8f722226513a6d1a8d4e4eb53 100644 (file)
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -2456,18 +2456,24 @@ hostname or IP address</description>
 <usage>
     <p><directive type="section">VirtualHost</directive> and
     <code>&lt;/VirtualHost&gt;</code> are used to enclose a group of
-    directives which will apply only to a particular virtual host. Any
-    directive which is allowed in a virtual host context may be
+    directives that will apply only to a particular virtual host. Any
+    directive that is allowed in a virtual host context may be
     used. When the server receives a request for a document on a
     particular virtual host, it uses the configuration directives
     enclosed in the <directive type="section">VirtualHost</directive>
     section. <em>Addr</em> can be</p>
 
     <ul>
-      <li>The IP address of the virtual host</li>
+      <li>The IP address of the virtual host;</li>
 
       <li>A fully qualified domain name for the IP address of the
-      virtual host.</li>
+      virtual host;</li>
+
+      <li>The character *, which is used only in combination with
+      <code>NameVirtualHost *</code> to match all IP addresses; or</li>
+
+      <li>The string <code>_default_</code>, which is used only
+      with IP virtual hosting to catch unmatched IP addresses.</li>
     </ul>
     
 
@@ -2502,15 +2508,20 @@ hostname or IP address</description>
     accept IP packets for multiple addresses. (If the machine does
     not have multiple network interfaces, then this can be
     accomplished with the <code>ifconfig alias</code> command (if
-    your OS supports it), or with kernel patches like <a
-    href="../misc/vif-info.html">VIF</a> (for SunOS(TM) 4.1.x)).</p>
+    your OS supports it).</p>
 
-    <p>The special name <code>_default_</code> can be specified in
+    <p>When using IP-based virtual hosting, the special name
+    <code>_default_</code> can be specified in
     which case this virtual host will match any IP address that is
     not explicitly listed in another virtual host. In the absence
     of any _default_ virtual host the "main" server config,
     consisting of all those definitions outside any VirtualHost
-    section, is used when no match occurs.</p>
+    section, is used when no IP-match occurs.  (But note that any IP
+    address that matches a <directive
+    module="core">NameVirtualHost</directive> directive will never use
+    the "main" server config.  See the <a
+    href="../vhosts/name-based.html">name-based virtual hosting</a>
+    documentation for further details.)</p>
 
     <p>You can specify a <code>:port</code> to change the port that is
     matched. If unspecified then it defaults to the same port as the