Re: [PATCH 2/2] man: document notmuch compact --quiet and --backup=DIRECTORY options

Subject: Re: [PATCH 2/2] man: document notmuch compact --quiet and --backup=DIRECTORY options

Date: Thu, 07 Nov 2013 15:25:37 +0200

To: Jani Nikula, notmuch@notmuchmail.org

Cc:

From: Tomi Ollila


On Wed, Nov 06 2013, Jani Nikula <jani@nikula.org> wrote:

> ---
>
> v2: --verbose -> --quiet

Patches

id:1383755936-11862-1-git-send-email-jani@nikula.org &
id:1383755936-11862-2-git-send-email-jani@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@notmuchmail.org
> http://notmuchmail.org/mailman/listinfo/notmuch

Thread: