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 ed68151172bd4297f1a9f91e806536bd66482ee8..176a3af4bac72583777ba2f58bf831decb35b13a 100644 (file)
--- a/docs/manual/mod/mod_md.xml
+++ b/docs/manual/mod/mod_md.xml
@@ -123,6 +123,33 @@ ManagedDomain example.org www.example.org
 </VirtualHost>
                 </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>