dovecot-2.2: man: Added description for command `doveadm copy`.
dovecot at dovecot.org
dovecot at dovecot.org
Sat Nov 16 16:12:01 EET 2013
details: http://hg.dovecot.org/dovecot-2.2/rev/a913f29068a7
changeset: 16953:a913f29068a7
user: Pascal Volk <user at localhost.localdomain.org>
date: Sat Nov 16 14:06:32 2013 +0000
description:
man: Added description for command `doveadm copy`.
diffstat:
doc/man/Makefile.am | 1 +
doc/man/doveadm-copy.1 | 1 +
doc/man/doveadm-move.1.in | 37 ++++++++++++++++++++++++++++++-------
doc/man/doveadm.1.in | 7 ++++++-
4 files changed, 38 insertions(+), 8 deletions(-)
diffs (126 lines):
diff -r 87ff0023fe79 -r a913f29068a7 doc/man/Makefile.am
--- a/doc/man/Makefile.am Fri Nov 08 17:48:54 2013 +0200
+++ b/doc/man/Makefile.am Sat Nov 16 14:06:32 2013 +0000
@@ -5,6 +5,7 @@
dist_man1_MANS = \
deliver.1 \
doveadm-config.1 \
+ doveadm-copy.1 \
doveadm-reload.1 \
doveadm-stop.1
diff -r 87ff0023fe79 -r a913f29068a7 doc/man/doveadm-copy.1
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/man/doveadm-copy.1 Sat Nov 16 14:06:32 2013 +0000
@@ -0,0 +1,1 @@
+.so man1/doveadm-move.1
diff -r 87ff0023fe79 -r a913f29068a7 doc/man/doveadm-move.1.in
--- a/doc/man/doveadm-move.1.in Fri Nov 08 17:48:54 2013 +0200
+++ b/doc/man/doveadm-move.1.in Sat Nov 16 14:06:32 2013 +0000
@@ -1,8 +1,11 @@
.\" Copyright (c) 2011 Dovecot authors, see the included COPYING file
-.TH DOVEADM\-MOVE 1 "2011-09-25" "Dovecot v2.2" "Dovecot"
+.TH DOVEADM\-MOVE 1 "2013-11-16" "Dovecot v2.2" "Dovecot"
.SH NAME
doveadm\-move \- Move messages matching the given search query into another
mailbox
+.br
+doveadm\-copy \- Copy messages matching the given search query into another
+mailbox
.\"------------------------------------------------------------------------
.SH SYNOPSIS
.BR doveadm " [" \-Dv "] " move " [" \-S
@@ -17,6 +20,20 @@
.BR doveadm " [" \-Dv "] " move " [" \-S
.IR socket_path "] "
.BI \-u " user destination search_query"
+.\"-------------------------------------
+.PP
+.BR doveadm " [" \-Dv "] " copy " [" \-S
+.IR socket_path "] " "destination search_query"
+.br
+.\"-------------------------------------
+.BR doveadm " [" \-Dv "] " copy " [" \-S
+.IR socket_path "] "
+.BI \-A " destination search_query"
+.br
+.\"-------------------------------------
+.BR doveadm " [" \-Dv "] " copy " [" \-S
+.IR socket_path "] "
+.BI \-u " user destination search_query"
.\"------------------------------------------------------------------------
.SH DESCRIPTION
.B doveadm move
@@ -26,23 +43,28 @@
is used to restrict which messages are moved into the
.I destination
mailbox.
+.br
+.B doveadm copy
+behaves the same as
+.BR "doveadm move" ,
+except that copied messages will not be expunged after copying.
.PP
In the first form,
.BR doveadm (1)
-will executed the
-.B move
+will execute the
+.BR move / copy
action with the environment of the logged in system user.
.PP
In the second form,
.BR doveadm (1)
will iterate over all users, found in the configured
.IR user_db (s),
-and move each user\(aqs messages, matching the given
+and move or copy each user\(aqs messages, matching the given
.IR search_query ,
into the user\(aqs
.IR destination " mailbox."
.PP
-In the third form, matching mails will be moved only for given
+In the third form, matching mails will be moved or copied only for given
.IR user (s).
.\"------------------------------------------------------------------------
@INCLUDE:global-options@
@@ -60,14 +82,15 @@
.SH ARGUMENTS
.TP
.I destination
-The name of the destination mailbox, into which the mails should be moved.
+The name of the destination mailbox, into which the mails should be moved
+or copied.
The
.I destination
mailbox must exist, otherwise this command will fail.
.\"-------------------------------------
.TP
.I search_query
-Move messages matching the given search query.
+Move/copy messages matching the given search query.
See
.BR doveadm\-search\-query (7)
for details.
diff -r 87ff0023fe79 -r a913f29068a7 doc/man/doveadm.1.in
--- a/doc/man/doveadm.1.in Fri Nov 08 17:48:54 2013 +0200
+++ b/doc/man/doveadm.1.in Sat Nov 16 14:06:32 2013 +0000
@@ -1,5 +1,5 @@
.\" Copyright (c) 2010-2013 Dovecot authors, see the included COPYING file
-.TH DOVEADM 1 "2013-08-05" "Dovecot v2.2" "Dovecot"
+.TH DOVEADM 1 "2013-11-16" "Dovecot v2.2" "Dovecot"
.SH NAME
doveadm \- Dovecot\(aqs administration utility
.\"------------------------------------------------------------------------
@@ -102,6 +102,11 @@
Move matching mails to the alternative storage.
.\"-------------------------------------
.TP
+.B doveadm copy
+.BR doveadm\-copy (1),
+Copy messages matching the given search query into another mailbox.
+.\"-------------------------------------
+.TP
.B doveadm deduplicate
.BR doveadm\-deduplicate (1),
Expunge duplicate messages.
More information about the dovecot-cvs
mailing list