add some notes about server admin URLs

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

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index 0eac772dc7956654f8b0e64617079860a9011810..46fb551537420a211cb3b640fcd271c09e4370a6 100644 (file)
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -2524,14 +2524,20 @@ later</compatibility>
 <name>ServerAdmin</name>
 <description>Email address that the server includes in error
 messages sent to the client</description>
-<syntax>ServerAdmin <var>email-address</var></syntax>
+<syntax>ServerAdmin <var>email-address</var>|<var>URL</var></syntax>
 <contextlist><context>server config</context><context>virtual host</context>
 </contextlist>
 
 <usage>
-    <p>The <directive>ServerAdmin</directive> sets the e-mail address
+    <p>The <directive>ServerAdmin</directive> sets the contact address
     that the server includes in any error messages it returns to the
-    client.</p>
+    client. If the httpd doesn't recognize the supplied argument as an URL, it
+    assumes, that it's an <var>email-address</var> and prepends it with
+    <code>mailto:</code> in hyperlink targets. However, it's recommended to
+    actually use an email address, since there are a lot of CGI scripts that
+    make that assumption. If you want to use an URL, it should point to another
+    server under your control. Otherwise users may not be able to contact you in
+    case of errors.</p>
 
     <p>It may be worth setting up a dedicated address for this, e.g.</p>