git.cworth.org Git - notmuch-wiki/blob - manpages/notmuch-new-1.mdwn

   1 <h1>NOTMUCH-NEW(1)</h1>
   2
   3 <h2>NAME</h2>
   4
   5 <pre>
   6        notmuch-new - Incorporate new mail into the notmuch database.
   7 </pre>
   8
   9 <h2>SYNOPSIS</h2>
  10
  11 <pre>
  12        <b>notmuch</b> <b>new</b> [<b>--no-hooks</b>]
  13 </pre>
  14
  15 <h2>DESCRIPTION</h2>
  16
  17 <pre>
  18        Find and import any new messages to the database.
  19 </pre>
  20
  21 <pre>
  22        The  <b>new</b>  command scans all sub-directories of the database, performing
  23        full-text indexing on new messages that are  found.  Each  new  message
  24        will automatically be tagged with both the <b>inbox</b> and <b>unread</b> tags.
  25 </pre>
  26
  27 <pre>
  28        You  should  run  <b>notmuch</b> <b>new</b> once after first running <b>notmuch</b> <b>setup</b> to
  29        create the initial database. The first run may take a long time if  you
  30        have a significant amount of mail (several hundred thousand messages or
  31        more). Subsequently, you should run <b>notmuch</b> <b>new</b> whenever  new  mail  is
  32        delivered  and you wish to incorporate it into the database. These sub-
  33        sequent runs will be much quicker than the initial run.
  34 </pre>
  35
  36 <pre>
  37        Invoking <b>notmuch</b> with no command argument will run <b>new</b> if <b>notmuch</b> <b>setup</b>
  38        has  previously been completed, but <b>notmuch</b> <b>new</b> has not previously been
  39        run.
  40 </pre>
  41
  42 <pre>
  43        <b>notmuch</b> <b>new</b> updates tags according  to  maildir  flag  changes  if  the
  44        <b>maildir.synchronize</b>_<b>flags</b> configuration option is enabled. See <b>notmuch-</b>
  45        <b>config</b>(1) for details.
  46 </pre>
  47
  48 <pre>
  49        The <b>new</b> command supports hooks. See  <b>notmuch-hooks(5)</b> for more  details
  50        on hooks.
  51 </pre>
  52
  53 <pre>
  54        Supported options for <b>new</b> include
  55 </pre>
  56
  57 <pre>
  58            <b>--no-hooks</b>
  59 </pre>
  60
  61 <pre>
  62                Prevents hooks from being run.
  63 </pre>
  64
  65 <h2>SEE ALSO</h2>
  66
  67 <pre>
  68        <b>notmuch</b>(1),  <b>notmuch-config</b>(1), <b>notmuch-count</b>(1), <b>notmuch-dump</b>(1), <b>not-</b>
  69        <b>much-hooks</b>(5), <b>notmuch-reply</b>(1), <b>notmuch-restore</b>(1), <b>notmuch-search</b>(1),
  70        <b>notmuch-search-terms</b>(7), <b>notmuch-show</b>(1), <b>notmuch-tag</b>(1)
  71 </pre>
  72
  73 <h1>Notmuch 0.13.2</h1>