[dovecot-cvs] dovecot dovecot-example.conf,1.125,1.126

[cras at dovecot.org]

Update of /var/lib/cvs/dovecot
In directory talvi:/tmp/cvs-serv15645

Modified Files:
	dovecot-example.conf 
Log Message:
Updated mail_cache_fields and mail_never_cache_fields comments.



Index: dovecot-example.conf
===================================================================
RCS file: /var/lib/cvs/dovecot/dovecot-example.conf,v
retrieving revision 1.125
retrieving revision 1.126
diff -u -d -r1.125 -r1.126
--- dovecot-example.conf	19 Dec 2004 06:36:12 -0000	1.125
+++ dovecot-example.conf	28 Dec 2004 15:57:13 -0000	1.126
@@ -224,34 +224,29 @@
    #hidden = yes
 #}
 
-# Space-separated list of fields to cache for all mails. Currently these
-# fields are allowed followed by a list of commands they speed up:
+# Space-separated list of fields to initially save into cache file. Currently
+# these fields are allowed:
 #
-#  Envelope      - FETCH ENVELOPE and SEARCH FROM, TO, CC, BCC, SUBJECT,
-#                  SENTBEFORE, SENTON, SENTSINCE, HEADER MESSAGE-ID,
-#                  HEADER IN-REPLY-TO
-#  Body          - FETCH BODY
-#  Bodystructure - FETCH BODY, BODYSTRUCTURE
-#  MessagePart   - FETCH BODY[1.2.3] (ie. body parts), RFC822.SIZE,
-#                  SEARCH SMALLER, LARGER, also speeds up BODY/BODYSTRUCTURE
-#                  generation. This is always set with mbox mailboxes, and
-#                  also default with Maildir.
+#  flags, date.sent, date.received, size.virtual, size.physical
+#  mime.parts, imap.body, imap.bodystructure
 #
-# Different IMAP clients work in different ways, that's why Dovecot by default
-# only caches MessagePart which speeds up most operations. Whenever client
-# does something where caching could be used, the field is automatically marked
-# to be cached later. For example after FETCH BODY the BODY will be cached
-# for all new messages. Normally you should leave this alone, unless you know
-# what most of your IMAP clients are. Caching more fields than needed makes
-# the index files larger and generate useless I/O.
+# Different IMAP clients work in different ways, so they benefit from
+# different cached fields. Some do not benefit from them at all. Caching more
+# than necessary generates useless disk I/O, so you don't want to do that
+# either.
 #
-# With maildir there's one extra optimization - if nothing is cached, indexing
-# the maildir becomes much faster since it's not opening any of the mail files.
-# This could be useful if your IMAP clients access only new mails.
-
-#mail_cache_fields = MessagePart
+# Dovecot attempts to automatically figure out what client wants and it keeps
+# only that. However the first few times a mailbox is opened, Dovecot hasn't
+# yet figured out what client needs, so it may not perform optimally. If you
+# know what fields the majority of your clients need, it may be useful to set
+# these fields by hand. If client doesn't actually use them, Dovecot will
+# eventually drop them.
+#
+# Usually you should just leave this field alone. The potential benefits are
+# typically unnoticeable.
+#mail_cache_fields = 
 
-# Space-separated list of fields that Dovecot should never set to be cached.
+# Space-separated list of fields that Dovecot should never save to cache file.
 # Useful if you want to save disk space at the cost of more I/O when the fields
 # needed.
 #mail_never_cache_fields =