NOTMUCH-INSERT(1)
NAME
notmuch-insert - add a message to the maildir and notmuch database
SYNOPSIS
notmuch insert [options] [ +<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)
Notmuch 0.17