dovecot-2.2: example-config: Added more detailed documentation f...

[dovecot at dovecot.org]

details:   http://hg.dovecot.org/dovecot-2.2/rev/14964e7e91b9
changeset: 19130:14964e7e91b9
user:      Stephan Bosch <stephan at rename-it.nl>
date:      Tue Sep 08 13:27:41 2015 +0300
description:
example-config: Added more detailed documentation for mailbox settings.

diffstat:

 doc/example-config/conf.d/10-mail.conf      |   2 +
 doc/example-config/conf.d/15-mailboxes.conf |  44 +++++++++++++++++++++-------
 2 files changed, 35 insertions(+), 11 deletions(-)

diffs (68 lines):

diff -r e4438e342208 -r 14964e7e91b9 doc/example-config/conf.d/10-mail.conf
--- a/doc/example-config/conf.d/10-mail.conf	Tue Sep 08 13:26:38 2015 +0300
+++ b/doc/example-config/conf.d/10-mail.conf	Tue Sep 08 13:27:41 2015 +0300
@@ -75,6 +75,8 @@
   # Namespace handles its own subscriptions. If set to "no", the parent
   # namespace handles them (empty prefix should always have this as "yes")
   #subscriptions = yes
+
+  # See 15-mailboxes.conf for definitions of special mailboxes.
 }
 
 # Example shared namespace configuration
diff -r e4438e342208 -r 14964e7e91b9 doc/example-config/conf.d/15-mailboxes.conf
--- a/doc/example-config/conf.d/15-mailboxes.conf	Tue Sep 08 13:26:38 2015 +0300
+++ b/doc/example-config/conf.d/15-mailboxes.conf	Tue Sep 08 13:27:41 2015 +0300
@@ -2,19 +2,41 @@
 ## Mailbox definitions
 ##
 
+# Each mailbox is specified in a separate mailbox section. The section name
+# specifies the mailbox name. If it has spaces, you can put the name
+# "in quotes". These sections can contain the following mailbox settings:
+#
+# auto:
+#   Indicates whether the mailbox with this name is automatically created
+#   implicitly when it is first accessed. The user can also be automatically
+#   subscribed to the mailbox after creation. The following values are
+#   defined for this setting:
+# 
+#     no        - Never created automatically.
+#     create    - Automatically created, but no automatic subscription.
+#     subscribe - Automatically created and subscribed.
+#  
+# special_use:
+#   A space-separated list of SPECIAL-USE flags (RFC 6154) to use for the
+#   mailbox. There are no validity checks, so you could specify anything
+#   you want in here, but it's not a good idea to use flags other than the
+#   standard ones specified in the RFC:
+#
+#     \All      - This (virtual) mailbox presents all messages in the
+#                 user's message store. 
+#     \Archive  - This mailbox is used to archive messages.
+#     \Drafts   - This mailbox is used to hold draft messages.
+#     \Flagged  - This (virtual) mailbox presents all messages in the
+#                 user's message store marked with the IMAP \Flagged flag.
+#     \Junk     - This mailbox is where messages deemed to be junk mail
+#                 are held.
+#     \Sent     - This mailbox is used to hold copies of messages that
+#                 have been sent.
+#     \Trash    - This mailbox is used to hold messages that have been
+#                 deleted.
+
 # NOTE: Assumes "namespace inbox" has been defined in 10-mail.conf.
 namespace inbox {
-
-  #mailbox name {
-    # auto=create will automatically create this mailbox.
-    # auto=subscribe will both create and subscribe to the mailbox.
-    #auto = no
-
-    # Space separated list of IMAP SPECIAL-USE attributes as specified by
-    # RFC 6154: \All \Archive \Drafts \Flagged \Junk \Sent \Trash
-    #special_use =
-  #}
-
   # These mailboxes are widely used and could perhaps be created automatically:
   mailbox Drafts {
     special_use = \Drafts