Provided by: notmuch_0.12-1_i386 bug

NAME

       notmuch-search - Search for messages matching the given search terms.

SYNOPSIS

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

DESCRIPTION

       Search  for  messages  matching  the given search terms, and display as
       results the threads containing the matched messages.

       The output consists of one line per thread, giving  a  thread  ID,  the
       date  of  the  newest (or oldest, depending on the sort option) matched
       message in the  thread,  the  number  of  matched  messages  and  total
       messages  in  the  thread, the names of all participants in the thread,
       and the subject of the newest (or oldest) message.

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

       Supported options for search include

           --format=(json|text)

               Presents the results in either JSON or plain-text (default).

           --output=(summary|threads|messages|files|tags)

               summary

                   Output  a  summary of each thread with any message matching
                   the search terms. The summary includes the thread ID, date,
                   the  number  of  messages  in  the  thread (both the number
                   matched and the total number), the authors  of  the  thread
                   and the subject.

               threads

                   Output  the  thread  IDs  of  all  threads with any message
                   matching  the   search   terms,   either   one   per   line
                   (--format=text) or as a JSON array (--format=json).

               messages

                   Output  the message IDs of all messages matching the search
                   terms, either one per line (--format=text)  or  as  a  JSON
                   array (--format=json).

               files

                   Output  the  filenames  of all messages matching the search
                   terms, either one per line (--format=text)  or  as  a  JSON
                   array (--format=json).

               tags

                   Output  all  tags  that  appear on any message matching the
                   search terms, either one per line (--format=text) or  as  a
                   JSON array (--format=json).

           --sort=(newest-first|oldest-first)

               This   option   can  be  used  to  present  results  in  either
               chronological order  (oldest-first)  or  reverse  chronological
               order (newest-first).

               Note:  The  thread  order  will  be  distinct between these two
               options  (beyond  being  simply  reversed).  When  sorting   by
               oldest-first  the  threads will be sorted by the oldest message
               in each thread, but when sorting by  newest-first  the  threads
               will be sorted by the newest message in each thread.

               By  default, results will be displayed in reverse chronological
               order, (that is, the newest results will be displayed first).

           --offset=[-]N

               Skip displaying the first N  results.  With  the  leading  '-',
               start at the Nth result from the end.

           --limit=N

               Limit the number of displayed results to N.

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-terms(7), notmuch-show(1), notmuch-tag(1)