add a note about *:80 and change the example to use it.

PR: 23606

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

diff --git a/docs/manual/vhosts/name-based.html.en b/docs/manual/vhosts/name-based.html.en
index 102e25582649fa0425b331655dee6d0d90ce35f6..f22243afa5b39789969f4a3a883ab3299af4f876 100644 (file)
--- a/docs/manual/vhosts/name-based.html.en
+++ b/docs/manual/vhosts/name-based.html.en
@@ -77,10 +77,12 @@
     address (and possibly port) on the server that will be accepting
     requests for the hosts.  This is configured using the <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> directive.
     In the normal case where any and all IP addresses on the server should
-    be used, you can use <code>*</code> as the argument to <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>. Note that mentioning an
-    IP address in a <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>
-    directive does not automatically make the server listen to that IP address.
-    See <a href="../bind.html">Setting which addresses and ports Apache uses</a> 
+    be used, you can use <code>*</code> as the argument to <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>. If you're planning to use
+    multiple ports (e.g. running SSL) you should add a Port to the argument,
+    such as <code>*:80</code>. Note that mentioning an IP address in a
+    <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> directive does not
+    automatically make the server listen to that IP address. See
+    <a href="../bind.html">Setting which addresses and ports Apache uses</a>
     for more details. In addition, any IP address specified here must be
     associated with a network interface        on the server.</p>
 
@@ -109,9 +111,9 @@
     Then you simply add the following to <code>httpd.conf</code>:</p>
 
     <div class="example"><p><code>
-        NameVirtualHost *<br />
+        NameVirtualHost *:80<br />
         <br />
-        &lt;VirtualHost *&gt;<br />
+        &lt;VirtualHost *:80&gt;<br />
         <span class="indent">
             ServerName www.domain.tld<br />
             ServerAlias domain.tld *.domain.tld<br />
@@ -119,7 +121,7 @@
         </span>
         &lt;/VirtualHost&gt;<br />
         <br />
-        &lt;VirtualHost *&gt;<br />
+        &lt;VirtualHost *:80&gt;<br />
         <span class="indent">ServerName www.otherdomain.tld<br />
             DocumentRoot /www/otherdomain<br />
         </span>

diff --git a/docs/manual/vhosts/name-based.xml b/docs/manual/vhosts/name-based.xml
index 08c651a25d91b0c6a1729b9bda1f105c0ffb0e1e..8b416c7b36620ebb8b8858dd45d33bec8d0618b5 100644 (file)
--- a/docs/manual/vhosts/name-based.xml
+++ b/docs/manual/vhosts/name-based.xml
@@ -76,10 +76,12 @@
     module="core">NameVirtualHost</directive> directive.
     In the normal case where any and all IP addresses on the server should
     be used, you can use <code>*</code> as the argument to <directive
-    module="core">NameVirtualHost</directive>. Note that mentioning an
-    IP address in a <directive module="core">NameVirtualHost</directive>
-    directive does not automatically make the server listen to that IP address.
-    See <a href="../bind.html">Setting which addresses and ports Apache uses</a> 
+    module="core">NameVirtualHost</directive>. If you're planning to use
+    multiple ports (e.g. running SSL) you should add a Port to the argument,
+    such as <code>*:80</code>. Note that mentioning an IP address in a
+    <directive module="core">NameVirtualHost</directive> directive does not
+    automatically make the server listen to that IP address. See
+    <a href="../bind.html">Setting which addresses and ports Apache uses</a>
     for more details. In addition, any IP address specified here must be
     associated with a network interface        on the server.</p>
 
@@ -114,9 +116,9 @@
     Then you simply add the following to <code>httpd.conf</code>:</p>
 
     <example>
-        NameVirtualHost *<br />
+        NameVirtualHost *:80<br />
         <br />
-        &lt;VirtualHost *&gt;<br />
+        &lt;VirtualHost *:80&gt;<br />
         <indent>
             ServerName www.domain.tld<br />
             ServerAlias domain.tld *.domain.tld<br />
@@ -124,7 +126,7 @@
         </indent>
         &lt;/VirtualHost&gt;<br />
         <br />
-        &lt;VirtualHost *&gt;<br />
+        &lt;VirtualHost *:80&gt;<br />
         <indent>ServerName www.otherdomain.tld<br />
             DocumentRoot /www/otherdomain<br />
         </indent>