--- a/dovecot-example.conf	Tue Feb 28 09:42:58 2006 +0200
+++ b/dovecot-example.conf	Tue Feb 28 09:50:54 2006 +0200
@@ -20,10 +20,20 @@
 # IP or host address where to listen in for connections. It's not currently
 # possible to specify multiple addresses. "*" listens in all IPv4 interfaces.
 # "[::]" listens in all IPv6 interfaces, but may also listen in all IPv4
-# interfaces depending on the operating system.  If you want to specify ports
-# for each service, you will need to configure these settings inside the
-# protocol imap/pop3 { ... } section, so you can specify different ports
-# for IMAP/POP3.
+# interfaces depending on the operating system.
+#
+# If you want to specify ports for each service, you will need to configure
+# these settings inside the protocol imap/pop3 { ... } section, so you can
+# specify different ports for IMAP/POP3. For example:
+#   protocol imap {
+#     listen = *:10143
+#     ssl_listen = *:10943
+#     ..
+#   }
+#   protocol pop3 {
+#     listen = *:10100
+#     ..
+#   }
 #listen = *
 
 # IP or host address where to listen in for SSL connections. Defaults
@@ -646,10 +656,12 @@
     #deny = yes
   #}
 
-  # PAM authentication. Preferred nowadays by most systems.
+  # PAM authentication. Preferred nowadays by most systems. 
   # Note that PAM can only be used to verify if user's password is correct,
   # so it can't be used as userdb. If you don't want to use a separate user
   # database (passwd usually), you can use static userdb.
+  # REMEMBER: You'll need /etc/pam.d/dovecot file created for PAM
+  # authentication to actually work.
   passdb pam {
     # [session=yes] [cache_key=<key>] [<service name>]
     #
@@ -668,7 +680,7 @@
     #   %u%s - Username and service (ie. IMAP, POP3) must match.
     # 
     # If service name is "*", it means the authenticating service name
-    # is used, eg. pop3 or imap.
+    # is used, eg. pop3 or imap (/etc/pam.d/pop3, /etc/pam.d/imap).
     #
     # Some examples:
     #   args = session=yes *