NOTMUCH-INSERT(1)

NAME

       notmuch-insert - add a message to the maildir and notmuch database

SYNOPSIS

       notmuch insert [option ...] [+<tag>|-<tag> ...]

DESCRIPTION

       notmuch insert reads a message from standard input and delivers it into
       the maildir directory given by configuration option database.path, then
       incorporates  the  message into the notmuch database. It is an alterna-
       tive to using a separate tool to deliver the message then running  not-
       much new afterwards.

       The  new message will be tagged with the tags specified by the new.tags
       configuration option, then by operations specified on the command-line:
       tags prefixed by '+' are added while those prefixed by '-' are removed.

       If the new message is  a  duplicate  of  an  existing  message  in  the
       database  (it  has  same  Message-ID),  it will be added to the maildir
       folder and notmuch database, but the tags will not be changed.

       Option arguments must appear before any tag operation arguments.   Sup-
       ported options for insert include

           --folder=<folder>

                  Deliver the message to the specified folder, relative to the
                  top-level directory given by the value of database.path. The
                  default is to deliver to the top-level directory.

           --create-folder

                  Try to create the folder named by the --folder option, if it
                  does not exist. Otherwise the folder must already exist  for
                  mail delivery to succeed.

EXIT STATUS

       This  command  returns  exit  status  0 if the message was successfully
       added to the mail directory, even if the message could not  be  indexed
       and  added  to the notmuch database. In the latter case, a warning will
       be printed to standard error but the message file will be left on disk.

       If the message could not be written to disk then a non-zero exit status
       is returned.

SEE ALSO

       notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1),  not-
       much-hooks(5), notmuch-reply(1), notmuch-restore(1), notmuch-search(1),
       notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)

AUTHOR

       Carl Worth and many others

COPYRIGHT

       2014, Carl Worth and many others

0.18