# HG changeset patch # User Pascal Volk # Date 1279650566 0 # Node ID d15a27eaa9d281a1908042d8ca52df5b4588155c # Parent ee89399346cbd1c3110aaa687684fa7634f1b89b man/{,de/}man5/vmm.cfg.5.rst: Added mailbox.root, small updates. diff -r ee89399346cb -r d15a27eaa9d2 man/de/man5/vmm.cfg.5.rst --- a/man/de/man5/vmm.cfg.5.rst Tue Jul 20 16:25:31 2010 +0000 +++ b/man/de/man5/vmm.cfg.5.rst Tue Jul 20 18:29:26 2010 +0000 @@ -180,8 +180,8 @@ ``dovecotpw (Vorgabe: /usr/sbin/dovecotpw)`` : *String* Der absolute Pfad zum dovecotpw Binary. Geben Sie den absoluten Pfad zum - doveadm Binary an, falls Sie Dovecot v2.0 verwenden. Dieses Binary wird - zur Hash-Erzeugung verwendet, wenn |misc.password_scheme|_ einen der + **doveadm**\(1) Binary an, falls Sie Dovecot v2.0 verwenden. Dieses Binary + wird zur Hash-Erzeugung verwendet, wenn |misc.password_scheme|_ einen der nachfolgenden Werte hat: 'CRAM-MD5', 'HMAC-MD5', 'LANMAN', 'OTP' 'RPA' oder 'SKEY'. Dieses Binary wird auch benötigt, wenn Ihre Python-Installation einen der folgenden Hash-Algorithmen nicht @@ -298,54 +298,44 @@ ``folders (Vorgabe: Drafts:Sent:Templates:Trash)`` : *String* Eine durch Doppelpunkten getrennte Liste mit Mailboxnamen die - erstellt werden sollen. (Wird derzeit nur berücksichtigt, wenn - |mailbox.format|_ entweder **maildir** oder **mbox** ist. Sollte das - gewählte Format ein anderes sein, kann Dovecots autocreate Plugin - verwendet werden.) Sollen - keine zusätzlichen Mailboxen angelegt werden, ist dieser Optionen ein - einzelner Doppelpunkt ('**:**') als Wert zuzuweisen. + erstellt werden sollen. Sollen keine zusätzlichen Mailboxen angelegt werden, + ist dieser Optionen ein einzelner Doppelpunkt ('**:**') als Wert zuzuweisen. Sollen Verzeichnisse mit Unterverzeichnissen angelegt werden, ist ein einzelner Punkt ('**.**') als Separator zu verwenden. + Sollen Mailboxen mit internationalisierten Namen erstellt werden (zum + Beispiel: 'Wysłane' oder 'Gelöschte Objekte'), ist der Name UTF-8 kodiert + anzugeben. |vmm(1)|_ wird die internationalisierten Mailboxnamen in eine + modifizierten Variante des UTF-7-Zeichensatzes (siehe auch: :RFC:`3501`, + Sektion 5.1.3) konvertieren. + .. _mailbox.format: ``format (Vorgabe: maildir)`` : *String* Das zu verwendende Format der Mailbox der Benutzer. Abhängig von der - verwendeten Dovecot-Version, stehen bis zu vier Formate zur Verfügung: + verwendeten Dovecot-Version, stehen bis zu drei Formate zur Verfügung: ``maildir`` seit Dovecot v1.0.0 - ``mbox`` - seit Dovecot v1.0.0 - ``dbox`` - seit Dovecot v1.0.0 ``mdbox`` - seit Dovecot v2.0.0 + seit Dovecot v2.0.beta1 + ``sdbox`` + seit Dovecot v1.0.rc3 + +.. _mailbox.root: + +``root (Vorgabe: Maildir)`` : *String* + Name des Mailbox-Wurzelverzeichnisses im Home-Verzeichnis des jeweiligen + Benutzers. Übliche Namen, je nach verwendetem |mailbox.format|_, sind: + **Maildir**, **mdbox** oder **sdbox**. Beispiel:: [mailbox] folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix format = maildir - -.. _imap_uft7: - -.. note:: Sollen in der **folders**-Einstellung internationalisierte Namen - für Maildir-Verzeichnisse verwendet werden, sind diese in einer - modifizierten Variante des UTF-7-Zeichensatzes (siehe :RFC:`3501`, Sektion - 5.1.3) anzugeben. - - Dovecot stellt seit Version 1.2.0 das nützlich Hilfsprogramm **imap-utf7** - zur Verfügung. Dieses dient zur mUTF-7 <-> UTF-8 Konvertierung. -.. - -imap-utf7 Beispiel:: - - user@host:~$ /usr/local/libexec/dovecot/imap-utf7 -r Wysłane - Wys&AUI-ane - user@host:~$ /usr/local/libexec/dovecot/imap-utf7 "&AVo-mietnik" - Śmietnik + root = Maildir MISC diff -r ee89399346cb -r d15a27eaa9d2 man/man5/vmm.cfg.5.rst --- a/man/man5/vmm.cfg.5.rst Tue Jul 20 16:25:31 2010 +0000 +++ b/man/man5/vmm.cfg.5.rst Tue Jul 20 18:29:26 2010 +0000 @@ -171,8 +171,8 @@ ``dovecotpw (default: /usr/sbin/dovecotpw)`` : *String* The absolute path to the dovecotpw binary. Use the absolute path to the - doveadm binary, if you are using Dovecot v2.0. This binary is used to - generate a password hash, if |misc.password_scheme|_ is set to one of + **doveadm**\(1) binary, if you are using Dovecot v2.0. This binary is used + to generate a password hash, if |misc.password_scheme|_ is set to one of 'CRAM-MD5', 'HMAC-MD5', 'LANMAN', 'OTP', 'RPA' or 'SKEY'. This binary will be also required if your Python installation doesn't support the: @@ -284,53 +284,44 @@ .. _mailbox.folders: ``folders (default: Drafts:Sent:Templates:Trash)`` : *String* - A colon separated list of mailboxes that should be created. (Works currently - only if the |mailbox.format|_ is either **maildir** or **mbox**. For other - formats use Dovecot's autocreate plugin - .) If no additionally mailboxes - should be created, set the value of this option to a single colon ('**:**'). + A colon separated list of mailboxes that should be created. If no + additionally mailboxes should be created, set the value of this option to a + single colon ('**:**'). If you want to create folders containing one or more subfolders, separate them with a single dot ('**.**'). + If you want to use internationalized mailbox names (e.g. 'Wysłane' or + 'Gelöschte Objekte'), write their names UTF-8 encoded. |vmm(1)|_ will convert + internationalized mailbox names to a modified version of the UTF-7 encoding + (see also: :RFC:`3501`, section 5.1.3). + .. _mailbox.format: ``format (default: maildir)`` : *String* The mailbox format to be used for a user's mailbox. Depending on the used - Dovecot version there are up to four supported formats: + Dovecot version there are up to three supported formats: ``maildir`` since Dovecot v1.0.0 - ``mbox`` - since Dovecot v1.0.0 - ``dbox`` - since Dovecot v1.0.0 ``mdbox`` - comes with Dovecot v2.0.0 + since Dovecot v2.0.beta1 + ``sdbox`` + since Dovecot v2.0.rc3 +.. _mailbox.root: + +``root (default: Maildir)`` : *String* + Name of the mailbox root directory in a user's home directory. Commonly used + names, depending on the used |mailbox.format|_, are **Maildir**, **mdbox** + or **sdbox**. Example:: [mailbox] folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix format = maildir - -.. _imap_uft7: - -.. note:: If you want to use internationalized mailbox names in the - **folders** setting, you have to specify them in a modified version of the - UTF-7 encoding (see :RFC:`3501`, section 5.1.3). - - Dovecot provides a useful utility for mUTF-7 <-> UTF-8 conversion: - **imap-utf7**, it's available since Dovecot version 1.2.0. -.. - -imap-utf7 example:: - - user@host:~$ /usr/local/libexec/dovecot/imap-utf7 -r Wysłane - Wys&AUI-ane - user@host:~$ /usr/local/libexec/dovecot/imap-utf7 "&AVo-mietnik" - Śmietnik + root = Maildir MISC