git.cworth.org Git - obsolete/notmuch-wiki/blob - manpages/notmuch-count-1.mdwn

   1 <h1>NOTMUCH-COUNT(1)</h1>
   2
   3 <h2>NAME</h2>
   4 <pre>
   5        notmuch-count - count messages matching the given search terms
   6 </pre>
   7
   8 <h2>SYNOPSIS</h2>
   9 <pre>
  10        <b>notmuch</b> <b>count</b> [<u>options</u>... ] &lt;<u>search-term</u>&gt;...
  11 </pre>
  12
  13 <h2>DESCRIPTION</h2>
  14 <pre>
  15        Count messages matching the search terms.
  16
  17        The number of matching messages (or threads) is output to stdout.
  18
  19        With  no  search  terms,  a  count  of all messages (or threads) in the
  20        database will be displayed.
  21
  22        See <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7) for details of  the  supported  syntax  for
  23        &lt;search-terms&gt;.
  24
  25        Supported options for <b>count</b> include
  26
  27            <b>--output=(messages|threads)</b>
  28
  29                <b>messages</b>
  30
  31                    Output  the  number  of  matching  messages.  This  is  the
  32                    default.
  33
  34                <b>threads</b>
  35
  36                    Output the number of matching threads.
  37
  38            <b>--exclude=(true|false)</b>
  39
  40                Specify whether to omit  messages  matching  search.tag_exclude
  41                from the count (the default) or not.
  42 </pre>
  43
  44 <h2>SEE ALSO</h2>
  45 <pre>
  46        <a href='../notmuch-1/'>notmuch</a>(1),  <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>notmuch-hooks</a>(5), <a href='../notmuch-new-1/'>not-</a>
  47        <a href='../notmuch-new-1/'>much-new</a>(1), <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),  <a href='../notmuch-restore-1/'>notmuch-restore</a>(1),  <a href='../notmuch-search-1/'>notmuch-search</a>(1),
  48        <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7), <a href='../notmuch-show-1/'>notmuch-show</a>(1), <a href='../notmuch-tag-1/'>notmuch-tag</a>(1)
  49 </pre>
  50
  51 <h2>Notmuch 0.15.2</h2>