.TH NOTMUCH-INSERT 1 2012-xx-xx "Notmuch 0.xx"
.SH NAME
notmuch-insert \- add a message to the maildir and notmuch database
.SH SYNOPSIS

.B notmuch insert
.RI "[" options "]"
.RI "--"
.RI "[ +<" tag> "|\-<" tag "> ... ]"

.SH DESCRIPTION

.B notmuch insert
reads a message from standard input and delivers it to the specified
maildir folder, then incorporates the message into the notmuch
database.  It is an alternative to using a separate tool to deliver
the message then running
.B notmuch new
afterwards.

The new message will be tagged with the tags specified by the
.B new.tags
configuration option.
Additional tagging operations may be specified on the command-line.
Tags prefixed by '+' are added while those prefixed by '\-' are
removed.  notmuch will warn about ambiguous tag removal arguments
which may be confused with option arguments.  It is recommended to use
the option list terminator "--" to avoid ambiguity.

Supported options for
.B insert
include
.RS 4
.TP 4
.BI "--folder=<" folder ">"

Deliver the message to the
.RI Maildir/ folder
directory, which must already exist.
The default is to deliver to the top-level directory.

.RE
.RE
.SH SEE ALSO

\fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),
\fBnotmuch-dump\fR(1), \fBnotmuch-hooks\fR(5), \fBnotmuch-reply\fR(1),
\fBnotmuch-restore\fR(1), \fBnotmuch-search\fR(1),
\fBnotmuch-search-terms\fR(7), \fBnotmuch-show\fR(1),
\fBnotmuch-tag\fR(1)