man: add references to maildir flag synchronization
[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 .B "notmuch new"
44 updates tags according to maildir flag changes if the
45 .B "maildir.synchronize_flags"
46 configuration option is enabled. See \fBnotmuch-config\fR(1) for
47 details.
48
49 The
50 .B new
51 command supports hooks. See  \fBnotmuch-hooks(5)\fR
52 for more details on hooks.
53
54 Supported options for
55 .B new
56 include
57 .RS 4
58 .TP 4
59 .BR \-\-no\-hooks
60
61 Prevents hooks from being run.
62 .RE
63 .RE
64 .SH SEE ALSO
65
66 \fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),
67 \fBnotmuch-dump\fR(5), \fBnotmuch-hooks\fR(5), \fBnotmuch-part\fR(1),
68 \fBnotmuch-reply\fR(1), \fBnotmuch-restore\fR(1),
69 \fBnotmuch-search\fR(1), \fBnotmuch-search-terms\fR(7),
70 \fBnotmuch-show\fR(1), \fBnotmuch-tag\fR(1)