diff --git a/dovecot/manifests/init.pp b/dovecot/manifests/init.pp
index 5ee6c21..49572f8 100644
--- a/dovecot/manifests/init.pp
+++ b/dovecot/manifests/init.pp
@@ -12,13 +12,20 @@ class dovecot::common {
     }
 }
 
-# Variables
-# dovecot_mail_domain = foo.invalid
-# dovecot_mx_mailname = mail.foo.invalid
-# dovecot_ssl_csr = puppet:///private/foo.invalid.csr
-# dovecot_ssl_cert = puppet:///private/foo.invalid.crt
-# dovecot_ssl_key = puppet:///private/foo.invalid.key
-# dovecot_ssl_chain = puppet:///private/foo.invalid.chain.crt
+# === Global variables
+#
+#   $dovecot_mail_domain:
+#       Mail domain name.
+#   $dovecot_mx_mailname:
+#       MX mail name.
+#   $dovecot_ssl_csr:
+#       Puppet source for the CSR file.
+#   $dovecot_ssl_cert:
+#       Puppet source for the X.509 certificate.
+#   $dovecot_ssl_key:
+#       Puppet source for the X.509 key.
+#   $dovecot_ssl_chain:
+#       Puppet source for the optional X.509 chain certificate.
 
 class dovecot::server inherits dovecot::common {