svn commit: r1647229 - in /httpd/httpd/trunk/docs/manual: mod/core.xml vhosts/name-based.xml

[co...@apache.org]

Author: covener
Date: Mon Dec 22 00:44:01 2014
New Revision: 1647229

URL: http://svn.apache.org/r1647229
Log:
some tweaks for no ServerName from PR57384

Modified:
    httpd/httpd/trunk/docs/manual/mod/core.xml
    httpd/httpd/trunk/docs/manual/vhosts/name-based.xml

Modified: httpd/httpd/trunk/docs/manual/mod/core.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/core.xml?rev=1647229&r1=1647228&r2=1647229&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/core.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/core.xml Mon Dec 22 00:44:01 2014
@@ -3899,8 +3899,10 @@ itself</description>
     server).</p>
 
     <p>If no <directive>ServerName</directive> is specified, then the
-    server attempts to deduce the hostname by performing a reverse
-    lookup on the IP address. If no port is specified in the
+    server attempts to deduce the client visible hostname by performing a
+    reverse lookup on an IP address of the systems hostname.</p>
+    
+    <p>If no port is specified in the
     <directive>ServerName</directive>, then the server will use the
     port from the incoming request. For optimal reliability and
     predictability, you should specify an explicit hostname and port

Modified: httpd/httpd/trunk/docs/manual/vhosts/name-based.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/vhosts/name-based.xml?rev=1647229&r1=1647228&r2=1647229&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/vhosts/name-based.xml (original)
+++ httpd/httpd/trunk/docs/manual/vhosts/name-based.xml Mon Dec 22 00:44:01 2014
@@ -76,6 +76,12 @@
     module="core">ServerAlias</directive> directives to the server name
     present in the request.</p>
 
+    <p>If you omit the <directive module="core">ServerName</directive> 
+    directive from any name-based virtual host, the server will default
+    to a fully qualified domain name (FQDN) derived from the system hostname.
+    This implicitly set server name can lead to counter-intuitive virtual host
+    matching and is discouraged.</p>
+ 
     <section id="defaultvhost"><title>The default name-based vhost for an IP and port combination </title>
     <p> If no matching ServerName or ServerAlias is found in the set of
     virtual hosts containing the most specific matching IP address and port