man/{,de/}man5/vmm.cfg.5.rst: Added mailbox.root, small updates.
--- 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
- <http://wiki.dovecot.org/Plugins/Autocreate> 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
--- 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
- <http://wiki.dovecot.org/Plugins/Autocreate>.) 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