make dnsZoneEntry description more understandable

diff --git a/html/doc-mail.wml b/html/doc-mail.wml
index a1c02cc..55eea47 100644 (file)
--- a/html/doc-mail.wml
+++ b/html/doc-mail.wml
@@ -129,9 +129,25 @@ mailRHSBL, and mailWhitelist
 
 <li>The only way to get a dnsZoneEntry record for a debian.net address is to
 use the mail gateway. It will verify the request and prevent name collisions
 
 <li>The only way to get a dnsZoneEntry record for a debian.net address is to
 use the mail gateway. It will verify the request and prevent name collisions

-automatically. Requests can take three forms: <tt>'foo in a 1.2.3.4'</tt>,
-<tt>'foo in cname foo.bar.'</tt>, <tt>'foo in txt plain text here'</tt>,
-or <tt>'foo in mx 10 foo.bar.'</tt> (note the trailing dot).
+automatically. Requests can take several forms:
+  <dl>
+    <dt><tt>foo in a 192.0.2.123</tt></dt>
+    <dd>to create an A record for <tt>foo.debian.net</tt></dd>
+
+    <dt><tt>foo in aaaa 2001:DB8::12:34</tt></dt>
+    <dd>to create an AAAA record for <tt>foo.debian.net</tt></dd>
+
+    <dt><tt>foo in cname example.org.</tt></dt>
+    <dd>to create a CNAME record for <tt>foo.debian.net</tt></dd>
+
+    <dt><tt>'foo in txt plain text here'</tt></dt>
+    <dd>to create a TXT record for <tt>foo.debian.net</tt></dd>
+
+    <dt><tt>foo in mx 10 example.org.</tt></dt>
+    <dd>to create an MX record for <tt>foo.debian.net</tt></dd>
+  </dl>
+
+Please note the trailing dot for the CNAME and MX records.

 Note that you cannot combine CNAME with any other record types.
 The precise form is critical and must not be deviated from.
 Like the SSH function above, multiple hosts are supported, but they must all
 Note that you cannot combine CNAME with any other record types.
 The precise form is critical and must not be deviated from.
 Like the SSH function above, multiple hosts are supported, but they must all