[PATCH 2/2] man: document notmuch compact --quiet and --backup=DIRECTORY options
Tomi Ollila
tomi.ollila at iki.fi
Thu Nov 7 05:25:37 PST 2013
On Wed, Nov 06 2013, Jani Nikula <jani at nikula.org> wrote:
> ---
>
> v2: --verbose -> --quiet
Patches
id:1383755936-11862-1-git-send-email-jani at nikula.org &
id:1383755936-11862-2-git-send-email-jani at nikula.org
(notmuch compact --quiet and --backup=DIRECTORY options with docs)
LGTM
Tomi
> ---
> man/man1/notmuch-compact.1 | 28 +++++++++++++++++++++++++++-
> 1 file changed, 27 insertions(+), 1 deletion(-)
>
> diff --git a/man/man1/notmuch-compact.1 b/man/man1/notmuch-compact.1
> index 1aeed22..0c95873 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
> --
> 1.8.4.rc3
>
> _______________________________________________
> notmuch mailing list
> notmuch at notmuchmail.org
> http://notmuchmail.org/mailman/listinfo/notmuch
More information about the notmuch
mailing list