.\" Copyright (c) 2010 Dovecot authors, see the included COPYING file
-.TH DOVECOT 1 "2010-06-01" "Dovecot v2.0" "Dovecot"
+.TH DOVECOT 1 "2010-07-02" "Dovecot v2.0" "Dovecot"
.SH NAME
dovecot \- a secure and highly configurable IMAP and POP3 server
.\"------------------------------------------------------------------------
.\"------------------------------------------------------------------------
@INCLUDE:reporting-bugs@
.\"------------------------------------------------------------------------
+.SH AUTHOR
+Dovecot <http://dovecot.org> and its manual pages were written by the
+Dovecot authors <http://dovecot.org/doc/AUTHORS>, mainly Timo Sirainen <tss
+at iki.fi>, and are licensed under the terms of the MIT and LGPLv2.1
+licenses, see <http://dovecot.org/doc/COPYING> for details.
+.\"------------------------------------------------------------------------
.SH SEE ALSO
.BR doveadm (1),
.BR doveconf (1),
.\" Copyright (c) 2010 Dovecot authors, see the included COPYING file
-.TH DSYNC 1 "2010-07-01" "Dovecot v2.0" "Dovecot"
+.TH DSYNC 1 "2010-07-02" "Dovecot v2.0" "Dovecot"
.SH NAME
dsync \- Dovecot\(aqs mailbox synchronization utility
.\"------------------------------------------------------------------------
.B \-f
Makes
.B dsync
-run in \(dqfull sync\(dq mode rather than \(dqfast sync\(dq mode. In fast
-sync mode dsync might skip syncing a mailbox, if both locations had modified
-it equally many times (i.e. highest-modseqs were equal), but with different
-changes.
+run in \(dqfull sync\(dq mode rather than \(dqfast sync\(dq mode.
+In fast sync mode
+.B dsync
+might skip syncing a mailbox, if both locations had modified it equally
+many times (i.e. highest\-modseqs were equal), but with different changes.
.\"---------------------------------
.TP
.BI \-m\ mailbox
If the location is on local filesystem, you can use a regular
mail_location, such as maildir:/backup/user/Maildir
.sp
-If the location is on a remote server, dsync can ssh to it by giving
+If the location is on a remote server,
+.B dsync
+can ssh to it by giving
.I host
or
.I user@host
as the parameter.
If user is specified, it\(aqs given as
.B \-u
-parameter to dsync, not to ssh.
+parameter to
+.BR dsync ,
+not to ssh.
The ssh username is always the default.
.sp
The final way to specify a location is to give a full command line or a
-path to a script that executes the dsync.
+path to a script that executes the
+.BR dsync .
For example:
.sp
.nf
If you want to do this without any downtime, you can do the conversion one
user at a time.
Initially:
+.RS 4
.IP \(bu 4
Configuration uses
.B mail_location = maildir:~/Maildir
Set up the possibility of doing per\-user mail location using
.I userdb
extra fields.
+.RE
.PP
Then for each user:
+.RS 4
.IP 1. 4
Run
.I dsync mirror
After this there should be no changes to Maildir, because the user\(aqs
mail location has been changed and all existing processes using it have
been killed.
+.RE
.PP
Once all users have been converted, you can set the default
.I mail_location