--- a/dovecot-example.conf	Mon Jan 20 15:54:42 2003 +0200
+++ b/dovecot-example.conf	Mon Jan 20 15:56:55 2003 +0200
@@ -189,6 +189,11 @@
 
 #mail_cache_fields = MessagePart
 
+# Space-separated list of fields that Dovecot should never set to be cached.
+# Useful if you want to save disk space at the cost of more I/O when the fields
+# needed.
+#mail_never_cache_fields = 
+
 # Dovecot can notify client of new mail in selected mailbox soon after it's
 # received. This setting specifies the minimum interval in seconds between
 # new mail notifications to client - internally they may be checked more or
@@ -196,11 +201,6 @@
 # NOTE: Evolution client breaks with this option when it's trying to APPEND.
 #mailbox_check_interval = 0
 
-# Space-separated list of fields that Dovecot should never set to be cached.
-# Useful if you want to save disk space at the cost of more I/O when the fields
-# needed.
-#mail_never_cache_fields = 
-
 # Save mails with CR+LF instead of plain LF. This makes sending those mails
 # take less CPU, especially with sendfile() syscall with Linux and FreeBSD.
 # But it also creates a bit more disk I/O which may just make it slower.
@@ -208,14 +208,15 @@
 
 # Use mmap() instead of read() to read mail files. read() seems to be a bit
 # faster with my Linux/x86 and it's better with NFS, so that's the default.
+# Currently mmap()ing is forced with mbox - this is a bug and will be fixed.
 #mail_read_mmaped = no
 
 # Copy mail to another folders using hard links. This is much faster than
-# actually copying the file. Only problem with it is that if either of the
-# mails are modified directly both will change. This isn't a problem with
-# IMAP however since it offers no way to modify the existing mails. Also
-# at least mutt modifies mails by deleting the old one and inserting a new
-# modified mail. So if performance matters at all you should turn this on.
+# actually copying the file. This is problematic only if something modifies
+# the mail in one folder but doesn't want it modified in the others. I don't
+# know any MUA which would modify mail files directly. IMAP protocol also
+# requires that the mails don't change, so it would be problematic in any case.
+# If you care about performance, enable it.
 #maildir_copy_with_hardlinks = no
 
 # Check if mails' content has been changed by external programs. This slows