svn commit: r1003164 - in /httpd/httpd/trunk/docs/manual/mod: core.html.en core.xml

[rb...@apache.org]

Author: rbowen
Date: Thu Sep 30 17:01:39 2010
New Revision: 1003164

URL: http://svn.apache.org/viewvc?rev=1003164&view=rev
Log:
Mention specific error message that people might come searching for.

Modified:
    httpd/httpd/trunk/docs/manual/mod/core.html.en
    httpd/httpd/trunk/docs/manual/mod/core.xml

Modified: httpd/httpd/trunk/docs/manual/mod/core.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/core.html.en?rev=1003164&r1=1003163&r2=1003164&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/core.html.en (original)
+++ httpd/httpd/trunk/docs/manual/mod/core.html.en Thu Sep 30 17:01:39 2010
@@ -3322,7 +3322,6 @@ itself</td></tr>
     section specifies what hostname must appear in the request's
     <code>Host:</code> header to match this virtual host.</p>
 
-
     <p>Sometimes, the server runs behind a device that processes SSL,
     such as a reverse proxy, load balancer or SSL offload
     appliance. When this is the case, specify the
@@ -3340,6 +3339,17 @@ itself</td></tr>
     specified port, or to the port number given in the client's request.
     </p>
 
+    <div class="warning">
+    <p>Failure to set <code class="directive">ServerName</code> to a name that
+    your server can resolve to an IP address will result in a startup
+    warning. <code>httpd</code> will then use whatever hostname it can
+    determine, using the system's <code>hostname</code> command. This
+    will almost never be the hostname you actually want.</p>
+    <div class="example"><p><code>
+    httpd: Could not reliably determine the server's fully qualified domain name, using rocinante.local for ServerName
+    </code></p></div>
+    </div>
+
 
 <h3>See also</h3>
 <ul>

Modified: httpd/httpd/trunk/docs/manual/mod/core.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/core.xml?rev=1003164&r1=1003163&r2=1003164&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/core.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/core.xml Thu Sep 30 17:01:39 2010
@@ -3319,7 +3319,6 @@ itself</description>
     section specifies what hostname must appear in the request's
     <code>Host:</code> header to match this virtual host.</p>
 
-
     <p>Sometimes, the server runs behind a device that processes SSL,
     such as a reverse proxy, load balancer or SSL offload
     appliance. When this is the case, specify the
@@ -3337,6 +3336,17 @@ itself</description>
     specified port, or to the port number given in the client's request.
     </p>
 
+    <note type="warning">
+    <p>Failure to set <directive>ServerName</directive> to a name that
+    your server can resolve to an IP address will result in a startup
+    warning. <code>httpd</code> will then use whatever hostname it can
+    determine, using the system's <code>hostname</code> command. This
+    will almost never be the hostname you actually want.</p>
+    <example>
+    httpd: Could not reliably determine the server's fully qualified domain name, using rocinante.local for ServerName
+    </example>
+    </note>
+
 </usage>
 
 <seealso><a href="../dns-caveats.html">Issues Regarding DNS and