dovecot-2.2: man: doveadm-move.1: Added description for 'user so...

[dovecot at dovecot.org]

details:   http://hg.dovecot.org/dovecot-2.2/rev/0870cca2b4fb
changeset: 17015:0870cca2b4fb
user:      Pascal Volk <user at localhost.localdomain.org>
date:      Sat Nov 23 18:24:24 2013 +0000
description:
man: doveadm-move.1: Added description for 'user source_user'.

diffstat:

 doc/man/doveadm-move.1.in |  47 +++++++++++++++++++++++++++++++++++++++--------
 1 files changed, 39 insertions(+), 8 deletions(-)

diffs (87 lines):

diff -r 3aa27f41fc42 -r 0870cca2b4fb doc/man/doveadm-move.1.in
--- a/doc/man/doveadm-move.1.in	Sat Nov 23 19:28:48 2013 +0200
+++ b/doc/man/doveadm-move.1.in	Sat Nov 23 18:24:24 2013 +0000
@@ -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 @@
 .\"------------------------------------------------------------------------
 .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 @@
 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