git.notmuchmail.org Git - notmuch/blob - man/man1/notmuch-new.1

   1 .TH NOTMUCH-NEW 1 2012-05-08 "Notmuch 0.13~rc1"
   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(1), \fBnotmuch-hooks\fR(5), \fBnotmuch-reply\fR(1),
  68 \fBnotmuch-restore\fR(1), \fBnotmuch-search\fR(1),
  69 \fBnotmuch-search-terms\fR(7), \fBnotmuch-show\fR(1),
  70 \fBnotmuch-tag\fR(1)