]> git.notmuchmail.org Git - notmuch/commitdiff
man: document notmuch compact --quiet and --backup=DIRECTORY options
authorJani Nikula <jani@nikula.org>
Wed, 6 Nov 2013 16:38:56 +0000 (18:38 +0200)
committerDavid Bremner <david@tethera.net>
Thu, 7 Nov 2013 23:16:15 +0000 (19:16 -0400)
man/man1/notmuch-compact.1

index 1aeed22184664ad39a0b9894b6501d37cdd57806..0c95873b45e869a85da3c3a02b3b86b838da20f9 100644 (file)
@@ -4,6 +4,8 @@ notmuch-compact \- compact the notmuch database
 .SH SYNOPSIS
 
 .B notmuch compact
 .SH SYNOPSIS
 
 .B notmuch compact
+.RI "[ --quiet ]"
+.RI "[ --backup=<" directory "> ]"
 
 .SH DESCRIPTION
 
 
 .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
 
 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.
 
 
 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
 .RE
 .SH ENVIRONMENT
 The following environment variables can be used to control the