aboutsummaryrefslogtreecommitdiffhomepage
path: root/man
diff options
context:
space:
mode:
authorGravatar Jani Nikula <jani@nikula.org>2013-11-06 18:38:56 +0200
committerGravatar David Bremner <david@tethera.net>2013-11-07 19:16:15 -0400
commit85e95c0844849773a5403b884bca4a52b3bb4fa0 (patch)
tree3e182a3dbc53f3beaa1b4e76ee4e7e338c5c8280 /man
parent0e04bda2a97a78ea63c5888fa3b3d60e7f84bd1a (diff)
man: document notmuch compact --quiet and --backup=DIRECTORY options
Diffstat (limited to 'man')
-rw-r--r--man/man1/notmuch-compact.128
1 files changed, 27 insertions, 1 deletions
diff --git a/man/man1/notmuch-compact.1 b/man/man1/notmuch-compact.1
index 1aeed221..0c95873b 100644
--- a/man/man1/notmuch-compact.1
+++ b/man/man1/notmuch-compact.1
@@ -4,6 +4,8 @@ notmuch-compact \- compact the notmuch database
.SH SYNOPSIS
.B notmuch compact
+.RI "[ --quiet ]"
+.RI "[ --backup=<" directory "> ]"
.SH DESCRIPTION
@@ -14,11 +16,35 @@ the space required by the database and improve lookup performance.
The compacted database is built in a temporary directory and is later
moved into the place of the origin database. The original uncompacted
-database is preserved to be deleted by the user as desired.
+database is discarded, unless the
+.BR "\-\-backup=" <directory>
+option is used.
Note that the database write lock will be held during the compaction
process (which may be quite long) to protect data integrity.
+Supported options for
+.B compact
+include
+
+.RS 4
+.TP 4
+.BR "\-\-backup=" <directory>
+
+Save the current database to the given directory before replacing it
+with the compacted database. The backup directory must not exist and
+it must reside on the same mounted filesystem as the current database.
+
+.RE
+
+.RS 4
+.TP 4
+.BR \-\-quiet
+
+Do not report database compaction progress to stdout.
+
+.RE
+
.RE
.SH ENVIRONMENT
The following environment variables can be used to control the