man/man5/vmm.cfg.5.rst
branchv0.6.x
changeset 230 eefbe052a135
parent 180 f8279c90e99c
child 264 04fea4d8b900
equal deleted inserted replaced
229:0fb2f12648a7 230:eefbe052a135
     5 --------------------------
     5 --------------------------
     6 configuration file for vmm
     6 configuration file for vmm
     7 --------------------------
     7 --------------------------
     8 
     8 
     9 :Author:         Pascal Volk <neverseen@users.sourceforge.net>
     9 :Author:         Pascal Volk <neverseen@users.sourceforge.net>
    10 :Date:           2010-02-01
    10 :Date:           2010-03-03
    11 :Version:        vmm-0.6.0
    11 :Version:        vmm-0.6.0
    12 :Manual group:   vmm Manual
    12 :Manual group:   vmm Manual
    13 :Manual section: 5
    13 :Manual section: 5
    14 
    14 
    15 .. contents::
    15 .. contents::
   262   delete_directory = false
   262   delete_directory = false
   263   directory_mode = 504
   263   directory_mode = 504
   264   force_deletion = false
   264   force_deletion = false
   265 
   265 
   266 
   266 
   267 MAILDIR
   267 MAILBOX
   268 -------
   268 -------
   269 The **maildir** section is used to specify some default options for new
   269 The **mailbox** section is used to specify some options for new created
   270 created Maildirs and folders inside.
   270 mailboxes in the users home directories. The INBOX will be created always.
   271 
   271 
   272 .. _maildir.folders:
   272 .. _mailbox.folders:
   273 
   273 
   274 ``folders (default: Drafts:Sent:Templates:Trash)`` : *String*
   274 ``folders (default: Drafts:Sent:Templates:Trash)`` : *String*
   275   A colon separated list of folder names, that should be created. If no
   275   A colon separated list of mailboxes that should be created. (Works currently
   276   folders should be created inside the Maildir, set the value of this option
   276   only if the |mailbox.format|_ is either **maildir** or **mbox**. For other
   277   to a single colon ('**:**').
   277   formats use Dovecot's autocreate plugin
       
   278   <http://wiki.dovecot.org/Plugins/Autocreate>.) If no additionally mailboxes
       
   279   should be created, set the value of this option to a single colon ('**:**').
   278 
   280 
   279   If you want to create folders containing one or more subfolders, separate
   281   If you want to create folders containing one or more subfolders, separate
   280   them with a single dot ('**.**').
   282   them with a single dot ('**.**').
   281 
   283 
   282 .. _maildir.name:
   284 .. _mailbox.format:
   283 
   285 
   284 ``name (default: Maildir)`` : *String*
   286 ``format (default: maildir)`` : *String*
   285   Default name of the Maildir folder in users home directories.
   287   The mailbox format to be used for a user's mailbox. Depending on the used
   286 
   288   Dovecot version there are up to four supported formats:
   287 Example::
   289 
   288 
   290     ``maildir``
   289   [maildir]
   291       since Dovecot v1.0.0
       
   292     ``mbox``
       
   293       since Dovecot v1.0.0
       
   294     ``dbox``
       
   295       since Dovecot v1.2.0
       
   296     ``mdbox``
       
   297       comes with Dovecot v2.0.0
       
   298 
       
   299 
       
   300 Example::
       
   301 
       
   302   [mailbox]
   290   folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix
   303   folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix
   291   name = Maildir
   304   format = maildir
   292 
   305 
   293 .. _imap_uft7:
   306 .. _imap_uft7:
   294 
   307 
   295 .. note:: If you want to use internationalized mailbox names in the
   308 .. note:: If you want to use internationalized mailbox names in the
   296   **folders** setting, you have to specify them in a modified version of the
   309   **folders** setting, you have to specify them in a modified version of the