Provided by: notmuch_0.12-1_i386 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)