From: Stefan Eissing <icing@apache.org>
Date: Wed, 9 Aug 2017 15:27:37 +0000 (+0000)
Subject: mod_md: more documentation
X-Git-Tag: 2.5.0-alpha~231
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=8261b587b96cb562e9f182d7d60ab9e900b27ffa;p=apache

mod_md: more documentation


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

diff --git a/docs/manual/mod/mod_md.xml b/docs/manual/mod/mod_md.xml
index ed68151172..176a3af4ba 100644
--- a/docs/manual/mod/mod_md.xml
+++ b/docs/manual/mod/mod_md.xml
@@ -123,6 +123,33 @@ ManagedDomain example.org www.example.org
 &lt;/VirtualHost&gt;
                 </highlight>
             </example>
+            <p>
+                There are two special names that you may use in this directive: 'manual'
+                and 'auto'. This determines if a Managed Domain shall have exactly the 
+                name list as is configured ('manual') or offer more convenince. With 'auto'
+                all names of a virtual host are added to a MD.
+            </p>
+            <example><title>Example</title>
+                <highlight language="config">
+ManagedDomain example.org
+
+&lt;VirtualHost *:443&gt;
+    ServerName example.org
+    ServerAlias www.example.org
+    DocumentRoot htdocs/root
+
+    SSLEngine on
+&lt;/VirtualHost&gt;
+                </highlight>
+            </example>
+            <p>
+                In this example, the domain 'www.example.org' is automatically added to
+                the MD 'example.org'. And when you add more ServerAlias names to this
+                virtual host, they will be added as well.
+            </p><p>
+                If this is too much automagic for you, define 'manual' mode. 
+                <module>mod_md</module> will then complain if the names do not match.
+            </p>
         </usage>
     </directivesynopsis>