Merge tag '0.12_rc2'
[notmuch] / man / man1 / notmuch-count.1
1 .TH NOTMUCH-COUNT 1 2012-03-18 "Notmuch 0.12~rc2"
2 .SH NAME
3 notmuch-count \- Count messages matching the given search terms.
4 .SH SYNOPSIS
5
6 .B notmuch count
7 .RI  [ options "... ] <" search-term ">..."
8
9 .SH DESCRIPTION
10
11 Count messages matching the search terms.
12
13 The number of matching messages (or threads) is output to stdout.
14
15 With no search terms, a count of all messages (or threads) in the database will
16 be displayed.
17
18 See \fBnotmuch-search-terms\fR(7)
19 for details of the supported syntax for <search-terms>.
20
21 Supported options for
22 .B count
23 include
24 .RS 4
25 .TP 4
26 .B \-\-output=(messages|threads)
27
28 .RS 4
29 .TP 4
30 .B messages
31
32 Output the number of matching messages. This is the default.
33 .RE
34 .RS 4
35 .TP 4
36 .B threads
37
38 Output the number of matching threads.
39 .RE
40 .RE
41
42 .RS 4
43 .TP 4
44 .BR \-\-no\-exclude
45
46 Do not exclude the messages matching search.exclude_tags in the config file.
47 .RE
48 .RE
49 .RE
50
51 .SH SEE ALSO
52
53 \fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-dump\fR(1),
54 \fBnotmuch-hooks\fR(5), \fBnotmuch-new\fR(1), \fBnotmuch-reply\fR(1),
55 \fBnotmuch-restore\fR(1), \fBnotmuch-search\fR(1),
56 \fBnotmuch-search-terms\fR(7), \fBnotmuch-show\fR(1),
57 \fBnotmuch-tag\fR(1)