man/{,de/}man5/vmm.cfg.5.rst: Added mailbox.root, small updates. v0.6.x
authorPascal Volk <neverseen@users.sourceforge.net>
Tue, 20 Jul 2010 18:29:26 +0000
branchv0.6.x
changeset 299 d15a27eaa9d2
parent 298 ee89399346cb
child 300 efa001edc349
man/{,de/}man5/vmm.cfg.5.rst: Added mailbox.root, small updates.
man/de/man5/vmm.cfg.5.rst
man/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
-  <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