Merge branch 'release'
[notmuch] / man / man1 / notmuch-new.1
1 .TH NOTMUCH-NEW 1 2011-12-04 "Notmuch 0.10.2"
2 .SH NAME
3 notmuch-new \- Incorporate new mail into the notmuch database.
4 .SH SYNOPSIS
5
6 .B notmuch new
7 .RB "[" --no-hooks "]"
8
9 .SH DESCRIPTION
10
11 Find and import any new messages to the database.
12
13 The
14 .B new
15 command scans all sub-directories of the database, performing
16 full-text indexing on new messages that are found. Each new message
17 will automatically be tagged with both the
18 .BR inbox " and " unread
19 tags.
20
21 You should run
22 .B "notmuch new"
23 once after first running
24 .B "notmuch setup"
25 to create the initial database. The first run may take a long time if
26 you have a significant amount of mail (several hundred thousand
27 messages or more). Subsequently, you should run
28 .B "notmuch new"
29 whenever new mail is delivered and you wish to incorporate it into the
30 database. These subsequent runs will be much quicker than the initial
31 run.
32
33 Invoking
34 .B notmuch
35 with no command argument will run
36 .B new
37 if
38 .B "notmuch setup"
39 has previously been completed, but
40 .B "notmuch new"
41 has not previously been run.
42
43
44 The
45 .B new
46 command supports hooks. See  \fBnotmuch-hooks(5)\fR
47 for more details on hooks.
48
49 Supported options for
50 .B new
51 include
52 .RS 4
53 .TP 4
54 .BR \-\-no\-hooks
55
56 Prevents hooks from being run.
57 .RE
58 .RE
59 .SH SEE ALSO
60
61 \fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),
62 \fBnotmuch-dump\fR(5), \fBnotmuch-hooks\fR(5), \fBnotmuch-part\fR(1),
63 \fBnotmuch-reply\fR(1), \fBnotmuch-restore\fR(1),
64 \fBnotmuch-search\fR(1), \fBnotmuch-search-terms\fR(7),
65 \fBnotmuch-show\fR(1), \fBnotmuch-tag\fR(1)