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

[dovecot at dovecot.org]

details:   http://hg.dovecot.org/dovecot-2.2/rev/e1cc249ad417
changeset: 17829:e1cc249ad417
user:      Pascal Volk <user at localhost.localdomain.org>
date:      Wed Sep 24 20:01:46 2014 +0000
description:
man: Added doveadm-fts.1.

diffstat:

 .hgignore                |   2 +-
 doc/man/Makefile.am      |   2 +
 doc/man/doveadm-fts.1.in |  76 ++++++++++++++++++++++++++++++++++++++++++++++++
 doc/man/doveadm.1.in     |   5 +++
 4 files changed, 84 insertions(+), 1 deletions(-)

diffs (125 lines):

diff -r 07cb8ad8b063 -r e1cc249ad417 .hgignore
--- a/.hgignore	Wed Sep 24 19:50:37 2014 +0000
+++ b/.hgignore	Wed Sep 24 20:01:46 2014 +0000
@@ -105,5 +105,5 @@
 
 syntax: regexp
 src/.*/test-[^\.]*$
-doc/man/doveadm-(acl|altmove|auth|batch|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-(acl|altmove|auth|batch|deduplicate|director|dump|exec|expunge|fetch|flags|fts|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 07cb8ad8b063 -r e1cc249ad417 doc/man/Makefile.am
--- a/doc/man/Makefile.am	Wed Sep 24 19:50:37 2014 +0000
+++ b/doc/man/Makefile.am	Wed Sep 24 20:01:46 2014 +0000
@@ -25,6 +25,7 @@
 	doveadm-expunge.1 \
 	doveadm-fetch.1 \
 	doveadm-flags.1 \
+	doveadm-fts.1 \
 	doveadm-import.1 \
 	doveadm-instance.1 \
 	doveadm-index.1 \
@@ -68,6 +69,7 @@
 	doveadm-expunge.1.in \
 	doveadm-fetch.1.in \
 	doveadm-flags.1.in \
+	doveadm-fts.1.in \
 	doveadm-import.1.in \
 	doveadm-instance.1.in \
 	doveadm-index.1.in \
diff -r 07cb8ad8b063 -r e1cc249ad417 doc/man/doveadm-fts.1.in
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/man/doveadm-fts.1.in	Wed Sep 24 20:01:46 2014 +0000
@@ -0,0 +1,76 @@
+.\" Copyright (c) 2014 Dovecot authors, see the included COPYING file
+.TH DOVEADM\-FTS 1 "2014-09-24" "Dovecot v2.2" "Dovecot"
+.SH NAME
+doveadm\-fts \- Manipulate the Full Text Search (FTS) index
+.\"------------------------------------------------------------------------
+.SH SYNOPSIS
+.BR doveadm " [" \-Dv ]
+.\"	[\fB\-f\fP \fIformatter\fP]
+.BI fts \ command
+.RI [ OPTIONS ]\ [ ARGUMENTS ]
+.\"------------------------------------------------------------------------
+.SH DESCRIPTION
+The
+doveadm fts
+.I COMMANDS
+can be used to manipulate the Full Text Search (FTS) index.
+.\"------------------------------------------------------------------------
+.\"	@INCLUDE:global-options-formatter@
+ at INCLUDE:global-options@
+.\" --- command specific options --- "/.
+.PP
+This command uses by default the output formatter
+.B flow
+(without the
+.IR key =
+prefix).
+.PP
+Command specific
+.IR options :
+.\"-------------------------------------
+ at INCLUDE:option-A@
+.\"-------------------------------------
+ at INCLUDE:option-S-socket@
+.\"-------------------------------------
+ at INCLUDE:option-u-user@
+.\"------------------------------------------------------------------------
+.SH ARGUMENTS
+.TP
+.I namespace
+The name of a namespace, e.g. the name of the shared namespace.
+When no namespace was given, the user\(aqs private namespace will be used.
+.\"------------------------------------------------------------------------
+.SH COMMANDS
+.SS fts optimize
+.B doveadm fts optimize
+[\fB\-u\fP \fIuser\fP|\fB\-A\fP]
+[\fB\-S\fP \fIsocket_path\fP]
+.RI [ namespace ]
+.PP
+Optimize the full text search index.
+This is also done automatically by the full text search engines, but this
+enforces it to happen.
+.\"-------------------------------------
+.SS fts rescan
+.B doveadm fts rescan
+[\fB\-u\fP \fIuser\fP|\fB\-A\fP]
+[\fB\-S\fP \fIsocket_path\fP]
+.RI [ namespace ]
+.PP
+Scan what mails exist in the full text search index and compare those to
+what actually exist in mailboxes.
+This removes mails from the index that have already been expunged and
+makes sure that the next
+.B doveadm index
+will index all the missing mails (if any).
+.\"------------------------------------------------------------------------
+ at INCLUDE:reporting-bugs@
+.\"------------------------------------------------------------------------
+.SH SEE ALSO
+.BR doveadm (1),
+.BR doveadm\-index (1)
+.\"-------------------------------------
+.PP
+Additional resources:
+.IP "Full text search indexing"
+http://wiki2.dovecot.org/Plugins/FTS
\ No newline at end of file
diff -r 07cb8ad8b063 -r e1cc249ad417 doc/man/doveadm.1.in
--- a/doc/man/doveadm.1.in	Wed Sep 24 19:50:37 2014 +0000
+++ b/doc/man/doveadm.1.in	Wed Sep 24 20:01:46 2014 +0000
@@ -142,6 +142,11 @@
 Add, remove or replace messages\(aq flags.
 .\"-------------------------------------
 .TP
+.B doveadm fts
+.BR doveadm\-fts (1),
+Manipulate the Full Text Search (FTS) index.
+.\"-------------------------------------
+.TP
 .B doveadm force\-resync
 .BR doveadm\-force\-resync (1),
 Repair broken mailboxes, in case Dovecot doesn\(aqt automatically do that.