dovecot-2.2: man: Added doveadm-exec.1.

[dovecot at dovecot.org]

details:   http://hg.dovecot.org/dovecot-2.2/rev/d3e554bccf68
changeset: 16649:d3e554bccf68
user:      Pascal Volk <user at localhost.localdomain.org>
date:      Mon Aug 05 15:52:52 2013 +0000
description:
man: Added doveadm-exec.1.

diffstat:

 .hgignore                 |   2 +-
 doc/man/Makefile.am       |   4 +++-
 doc/man/doveadm-exec.1.in |  47 +++++++++++++++++++++++++++++++++++++++++++++++
 doc/man/doveadm.1.in      |   7 ++++++-
 doc/man/sed.sh            |   5 ++++-
 5 files changed, 61 insertions(+), 4 deletions(-)

diffs (129 lines):

diff -r 692c1797a8c9 -r d3e554bccf68 .hgignore
--- a/.hgignore	Mon Aug 05 17:38:13 2013 +0300
+++ b/.hgignore	Mon Aug 05 15:52:52 2013 +0000
@@ -105,5 +105,5 @@
 
 syntax: regexp
 src/.*/test-[^\.]*$
-doc/man/doveadm-(altmove|auth|deduplicate|director|dump|expunge|fetch|flags|import|instance|index|force-resync|help|kick|log|mailbox|mount|move|penalty|purge|pw|quota|search|user|who)\.1$
+doc/man/doveadm-(altmove|auth|deduplicate|director|dump|exec|expunge|fetch|flags|import|instance|index|force-resync|help|kick|log|mailbox|mount|move|penalty|purge|pw|quota|search|user|who)\.1$
 doc/man/(doveadm|doveconf|dovecot-lda|dovecot|dsync)\.1$
diff -r 692c1797a8c9 -r d3e554bccf68 doc/man/Makefile.am
--- a/doc/man/Makefile.am	Mon Aug 05 17:38:13 2013 +0300
+++ b/doc/man/Makefile.am	Mon Aug 05 15:52:52 2013 +0000
@@ -18,6 +18,7 @@
 	doveadm-deduplicate.1 \
 	doveadm-director.1 \
 	doveadm-dump.1 \
+	doveadm-exec.1 \
 	doveadm-expunge.1 \
 	doveadm-fetch.1 \
 	doveadm-flags.1 \
@@ -58,6 +59,7 @@
 	doveadm-deduplicate.1.in \
 	doveadm-director.1.in \
 	doveadm-dump.1.in \
+	doveadm-exec.1.in \
 	doveadm-expunge.1.in \
 	doveadm-fetch.1.in \
 	doveadm-flags.1.in \
@@ -89,4 +91,4 @@
 
 .1.in.1: $(man_includefiles) Makefile
 	$(SHELL) $(srcdir)/sed.sh $(srcdir) $(rundir) $(pkgsysconfdir) \
-		< $< > $@
+		$(pkglibexecdir) < $< > $@
diff -r 692c1797a8c9 -r d3e554bccf68 doc/man/doveadm-exec.1.in
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/man/doveadm-exec.1.in	Mon Aug 05 15:52:52 2013 +0000
@@ -0,0 +1,47 @@
+.\" Copyright (c) 2013 Dovecot authors, see the included COPYING file
+.TH DOVEADM\-EXEC 1 "2013-08-05" "Dovecot v2.2" "Dovecot"
+.SH NAME
+doveadm\-exec \- easily execute commands from Dovecot\(aqs libexec_dir
+.\"------------------------------------------------------------------------
+.SH SYNOPSIS
+.BR doveadm " [" \-Dv "] " exec
+.IR binary " [" "binary arguments" ]
+.\"------------------------------------------------------------------------
+.SH DESCRIPTION
+This command allows administrators and local users to simply execute
+commands from within
+.IR libexec_dir .
+So for example a logged in system user could start a pre\-authenticated
+imap session, using the command:
+.BR "doveadm exec imap" .
+An administrator would use the command:
+.B "doveadm exec imap \-u"
+.IR username .
+.\"------------------------------------------------------------------------
+ at INCLUDE:global-options@
+.\"------------------------------------------------------------------------
+.SH ARGUMENTS
+.TP
+.I binary
+the name of an executable located in
+.IR @pkglibexecdir@ .
+.\"-------------------------------------
+.TP
+.I binary arguments
+options and arguments, wich will be passed through to the
+.IR binary .
+.\"------------------------------------------------------------------------
+.SH EXAMPLE
+This example demonstrates how to deliver a message from a file to a
+user\(aqs mailbox.
+.sp
+.nf
+.B doveadm exec dovecot\-lda \-d user at example.net \(rs
+.B \-f admin at example.net < \(ti/stuff/welcome.msg
+.fi
+.\"------------------------------------------------------------------------
+ at INCLUDE:reporting-bugs@
+.\"------------------------------------------------------------------------
+.SH SEE ALSO
+.BR doveadm (1),
+.BR dovecot\-lda (1)
\ No newline at end of file
diff -r 692c1797a8c9 -r d3e554bccf68 doc/man/doveadm.1.in
--- a/doc/man/doveadm.1.in	Mon Aug 05 17:38:13 2013 +0300
+++ b/doc/man/doveadm.1.in	Mon Aug 05 15:52:52 2013 +0000
@@ -1,5 +1,5 @@
 .\" Copyright (c) 2010-2013 Dovecot authors, see the included COPYING file
-.TH DOVEADM 1 "2013-08-02" "Dovecot v2.2" "Dovecot"
+.TH DOVEADM 1 "2013-08-05" "Dovecot v2.2" "Dovecot"
 .SH NAME
 doveadm \- Dovecot\(aqs administration utility
 .\"------------------------------------------------------------------------
@@ -44,6 +44,11 @@
 Manage Dovecot directors (if used by proxy servers).
 .\"-------------------------------------
 .TP
+.B doveadm exec
+.BR doveadm\-exec (1),
+Easily execute commands from Dovecot\(aqs libexec_dir.
+.\"-------------------------------------
+.TP
 .B doveadm instance
 .BR doveadm\-instance (1),
 Manage the list of running Dovecot instances.
diff -r 692c1797a8c9 -r d3e554bccf68 doc/man/sed.sh
--- a/doc/man/sed.sh	Mon Aug 05 17:38:13 2013 +0300
+++ b/doc/man/sed.sh	Mon Aug 05 15:52:52 2013 +0000
@@ -3,6 +3,7 @@
 SRCDIR="${1:-`pwd`}"
 RUNDIR="${2:-/usr/local/var/run/dovecot}"
 PKGSYSCONFDIR="${3:-/usr/local/etc/dovecot}"
+PKGLIBEXECDIR="${4:-/usr/local/libexec/dovecot}"
 
 sed -e "/^@INCLUDE:global-options@$/{
 		r ${SRCDIR}/global-options.inc
@@ -27,5 +28,7 @@
 	-e "/^@INCLUDE:reporting-bugs@$/{
 		r ${SRCDIR}/reporting-bugs.inc
 		d
-	}" | sed -e "s|@pkgsysconfdir@|${PKGSYSCONFDIR}|" -e "s|@rundir@|${RUNDIR}|"
+	}" | sed -e "s|@pkgsysconfdir@|${PKGSYSCONFDIR}|" \
+	-e "s|@rundir@|${RUNDIR}|" \
+	-e "s|@pkglibexecdir@|${PKGLIBEXECDIR}|"