man: doveadm-move.1: Added description for 'user source_user'.

diff --git a/doc/man/doveadm-move.1.in b/doc/man/doveadm-move.1.in
index 55da8efea8712b55c99b73ca417cda8c9e2d285d..80f2edb72cc6ff933def3fcea603852ceee0d787 100644 (file)
--- a/doc/man/doveadm-move.1.in
+++ b/doc/man/doveadm-move.1.in
@@ -1,5 +1,5 @@
-.\" Copyright (c) 2011 Dovecot authors, see the included COPYING file
-.TH DOVEADM\-MOVE 1 "2013-11-16" "Dovecot v2.2" "Dovecot"
+.\" Copyright (c) 2011-2013 Dovecot authors, see the included COPYING file
+.TH DOVEADM\-MOVE 1 "2013-11-23" "Dovecot v2.2" "Dovecot"
 .SH NAME
 doveadm\-move \- Move messages matching the given search query into another
 mailbox
@@ -9,31 +9,43 @@ mailbox
 .\"------------------------------------------------------------------------
 .SH SYNOPSIS
 .BR doveadm " [" \-Dv "] " move " [" \-S
-.IR socket_path "] " "destination search_query"
+.IR socket_path "] " destination
+.RB [ user
+.IR source_user "] " search_query
 .br
 .\"-------------------------------------
 .BR doveadm " [" \-Dv "] " move " [" \-S
 .IR socket_path "] "
-.BI \-A " destination search_query"
+.BI \-A " destination
+.RB [ user
+.IR source_user "] " search_query
 .br
 .\"-------------------------------------
 .BR doveadm " [" \-Dv "] " move " [" \-S
 .IR socket_path "] "
-.BI \-u " user destination search_query"
+.BI \-u " user destination
+.RB [ user
+.IR source_user "] " search_query
 .\"-------------------------------------
 .PP
 .BR doveadm " [" \-Dv "] " copy " [" \-S
-.IR socket_path "] " "destination search_query"
+.IR socket_path "] " "destination
+.RB [ user
+.IR source_user "] " search_query
 .br
 .\"-------------------------------------
 .BR doveadm " [" \-Dv "] " copy " [" \-S
 .IR socket_path "] "
-.BI \-A " destination search_query"
+.BI \-A " destination
+.RB [ user
+.IR source_user "] " search_query
 .br
 .\"-------------------------------------
 .BR doveadm " [" \-Dv "] " copy " [" \-S
 .IR socket_path "] "
-.BI \-u " user destination search_query"
+.BI \-u " user destination
+.RB [ user
+.IR source_user "] " search_query
 .\"------------------------------------------------------------------------
 .SH DESCRIPTION
 .B doveadm move
@@ -94,6 +106,25 @@ Move/copy messages matching the given search query.
 See
 .BR doveadm\-search\-query (7)
 for details.
+.\"-------------------------------------
+.TP
+.BI user \ source_user
+The keyword
+.B user
+followed by a valid user name.
+When this argument is present,
+.BR doveadm (1)
+will apply the
+.I search_query
+to the
+.IR source_user "\(aqs " mail_location .
+.br
+.B Limitation:
+Currently the users, specified by
+.BI \-u " user"
+and
+.BI user " source_user,"
+must share the same UID and GID.
 .\"------------------------------------------------------------------------
 .SH EXAMPLE
 Move jane\(aqs messages \- received in September 2011 \- from her INBOX