Provided by: notmuch_0.12-1_amd64 bug

NAME

       notmuch-show - Show messages matching the given search terms.

SYNOPSIS

       notmuch show [options...] <search-term>...

DESCRIPTION

       Shows all messages matching the search terms.

       See notmuch-search-terms(7) for details of the supported syntax for <search-terms>.

       The  messages  will  be  grouped  and  sorted  based  on  the  threading (all replies to a
       particular message will appear immediately after that 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 show include

           --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.

           --format=(text|json|mbox|raw)

               text (default for messages)

                   The default plain-text format has all text-content MIME parts decoded. Various
                   components  in the output, (message, header, body, attachment, and MIME part),
                   will be delimited by easily-parsed markers. Each marker consists of a Control-
                   L  character  (ASCII  decimal  12), the name of the marker, and then either an
                   opening or closing brace, ('{' or '}'), to either open or close the component.
                   For a multipart MIME message, these parts will be nested.

               json

                   The output is formatted with Javascript Object Notation (JSON). This format is
                   more robust  than  the  text  format  for  automated  processing.  The  nested
                   structure  of multipart MIME messages is reflected in nested JSON output. JSON
                   output  always  includes  all  messages  in  a  matching  thread;  in   effect
                   --format=json implies --entire-thread

               mbox

                   All  matching  messages  are  output in the traditional, Unix mbox format with
                   each message being prefixed by a line beginning with "From " and a blank  line
                   separating  each  message. Lines in the message content beginning with "From "
                   (preceded by zero or more '>' characters) have  an  additional  '>'  character
                   added.  This  reversible  escaping  is termed "mboxrd" format and described in
                   detail here:

                   http://homepage.ntlworld.com/jonathan.deboynepollard/FGA/mail-mbox-formats.html

               raw (default for a single part, see --part)

                   For a message, the original, raw content  of  the  email  message  is  output.
                   Consumers  of this format should expect to implement MIME decoding and similar
                   functions.

                   For a single part (--part) the raw part content is output after performing any
                   necessary MIME decoding.

                   The raw format must only be used with search terms matching single message.

           --part=N

               Output  the single decoded MIME part N of a single message.  The search terms must
               match only a single message.  Message parts are numbered in a depth-first walk  of
               the  message  MIME  structure,  and  are identified in the 'json' or 'text' output
               formats.

           --verify

               Compute and report the validity of any MIME cryptographic signatures found in  the
               selected  content  (ie. "multipart/signed" parts). Status of the signature will be
               reported (currently only supported with --format=json), and  the  multipart/signed
               part will be replaced by the signed data.

           --decrypt

               Decrypt   any   MIME   encrypted   parts   found  in  the  selected  content  (ie.
               "multipart/encrypted" parts). Status of the decryption will be reported (currently
               only  supported  with  --format=json)  and  the  multipart/encrypted  part will be
               replaced by the decrypted content.

       A common use of notmuch show is to display a single thread of email  messages.  For  this,
       use  a  search  term  of "thread:<thread-id>" as can be seen in the first column of output
       from the notmuch search command.

SEE ALSO

       notmuch(1),  notmuch-config(1),   notmuch-count(1),   notmuch-dump(1),   notmuch-hooks(5),
       notmuch-new(1),  notmuch-reply(1),  notmuch-restore(1), notmuch-search(1), notmuch-search-
       terms(7), notmuch-tag(1)