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

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