]> git.cworth.org Git - notmuch-wiki/blobdiff - manpages/notmuch-count-1.mdwn
updated manpages using fingerterm on N9
[notmuch-wiki] / manpages / notmuch-count-1.mdwn
index 8f7ed4640c5f86a7209c09d92d30641977d2203f..e5e781272571c74476a8a6d71550fb8dff1b0486 100644 (file)
 
        The number of matching messages (or threads) is output to stdout.
 
-       With no search terms, a count of all messages (or threads) in the data-
-       base will be displayed.
+       With  no  search  terms,  a  count  of all messages (or threads) in the
+       database will be displayed.
 
        See <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7) for details of  the  supported  syntax  for
        &lt;search-terms&gt;.
 
        Supported options for <b>count</b> include
 
-           <b>--output=(messages|threads)</b>
+           <b>--output=(messages|threads|files)</b>
 
                <b>messages</b>
 
 
                    Output the number of matching threads.
 
+               <b>files</b>
+
+                   Output the number of files associated  with  matching  mes-
+                   sages.  This may be bigger than the number of matching mes-
+                   sages due to duplicates (i.e.  multiple  files  having  the
+                   same message-id).
+
            <b>--exclude=(true|false)</b>
 
-               Specify whether to omit  messages  matching  search.tag_exclude
+               Specify  whether  to  omit messages matching search.tag_exclude
                from the count (the default) or not.
 
            <b>--batch</b>
 
-               Read  queries from a file (stdin by default), one per line, and
-               output the number of matching messages (or threads) to  stdout,
-               one  per line. On an empty input line the count of all messages
+               Read queries from a file (stdin by default), one per line,  and
+               output  the number of matching messages (or threads) to stdout,
+               one per line. On an empty input line the count of all  messages
                (or threads) in the database will be output. This option is not
                compatible with specifying search terms on the command line.
 
            <b>--input=</b>&lt;filename&gt;
 
-               Read  input  from  given  file,  instead of from stdin. Implies
+               Read input from given file,  instead  of  from  stdin.  Implies
                <b>--batch</b>.
 </pre>
 
 <h2>SEE ALSO</h2>
 <pre>
-       <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-insert-1/'>not-</a>
-       <a href='../notmuch-insert-1/'>much-insert</a>(1),  <a href='../notmuch-new-1/'>notmuch-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), <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-</a>
+       <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-insert-1/'>not-</a>
+       <a href='../notmuch-insert-1/'>much-insert</a>(1), <a href='../notmuch-new-1/'>notmuch-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),  <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-</a>
        <a href='../notmuch-tag-1/'>tag</a>(1)
 </pre>
 
-<h2>Notmuch 0.16</h2>
+<h2>Notmuch 0.17</h2>