X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=notmuch.1;h=282ad9896bc6a64004f0c4b16fed2e15ba00b48a;hp=2be77f992055896072578dadd8c316f78c3edb66;hb=c25bc03dc60846090d230cdad21e39faccce35ff;hpb=c1e16435cfe4471c3415d9f625f7230d59c8afb4 diff --git a/notmuch.1 b/notmuch.1 index 2be77f99..282ad989 100644 --- a/notmuch.1 +++ b/notmuch.1 @@ -109,14 +109,6 @@ whenever new mail is delivered and you wish to incorporate it into the database. These subsequent runs will be much quicker than the initial run. -Note: -.B notmuch new -runs (other than the first run) will skip any read-only directories, -so you can use that to mark directories that will not receive any new -mail (and make -.B notmuch new -even faster). - Invoking .B notmuch with no command argument will run @@ -169,6 +161,8 @@ when sorting by .B newest\-first the threads will be sorted by the newest message in each thread. +.RE +.RS 4 By default, results will be displayed in reverse chronological order, (that is, the newest results will be displayed first). @@ -177,7 +171,7 @@ See the section below for details of the supported syntax for . .RE .TP -.BR show " ..." +.BR show " [options...] ..." Shows all messages matching the search terms. @@ -187,6 +181,19 @@ message in date order). The output is not indented by default, but depth tags are printed so that proper indentation can be performed by a post-processor (such as the emacs interface to notmuch). +Supported options for +.B show +include +.RS 4 +.TP 4 +.B \-\-entire\-thread + +By default only those messages that match the search terms will be +displayed. With this option, all messages in the same thread as any +matched message will be displayed. +.RE + +.RS 4 The output format is plain-text, with all text-content MIME parts decoded. Various components in the output, .RB ( message ", " header ", " body ", " attachment ", and MIME " part ), @@ -207,13 +214,14 @@ See the .B "SEARCH SYNTAX" section below for details of the supported syntax for . .RE +.RE The .B reply command is useful for preparing a template for an email reply. - -.TP -.BR reply " ..." +.RS 4 +.TP 4 +.BR reply " [options...] ..." Constructs a reply template for a set of messages. @@ -236,6 +244,21 @@ each line with '> ' and included in the body. The resulting message template is output to stdout. +Supported options for +.B reply +include +.RS +.TP 4 +.BR \-\-format= ( default | headers\-only ) +.RS +.TP 4 +.BR default +Includes subject and quoted message body. +.TP +.BR headers-only +Only produces In-Reply-To, References, To, Cc, and Bcc headers. +.RE + See the .B "SEARCH SYNTAX" section below for details of the supported syntax for . @@ -248,6 +271,7 @@ once. For example, when a series of patches are sent in a single thread, replying to the entire thread allows for the reply to comment on issue found in multiple patches. .RE +.RE The .B tag