X-Git-Url: https://git.notmuchmail.org/git?a=blobdiff_plain;f=man%2Fman1%2Fnotmuch-insert.1;h=227d1c84bc2ade1f26ff704e0bd1882f7b7227eb;hb=bd0c56b2bdb10aa88b41ec9460f9e67a90d63c12;hp=fbf83e03c7f722e9002449bd281cfb687e17642c;hpb=c8365d09955dd24f0e4278bec18b43c362116941;p=notmuch diff --git a/man/man1/notmuch-insert.1 b/man/man1/notmuch-insert.1 index fbf83e03..227d1c84 100644 --- a/man/man1/notmuch-insert.1 +++ b/man/man1/notmuch-insert.1 @@ -1,9 +1,10 @@ -.TH NOTMUCH-INSERT 1 2013-xx-xx "Notmuch 0.xx" +.TH NOTMUCH-INSERT 1 2013-11-20 "Notmuch 0.17~rc1" .SH NAME notmuch-insert \- add a message to the maildir and notmuch database .SH SYNOPSIS .B notmuch insert +.RI "[" options "]" .RI "[ +<" tag> "|\-<" tag "> ... ]" .SH DESCRIPTION @@ -28,6 +29,31 @@ 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. +Supported options for +.B insert +include +.RS 4 +.TP 4 +.BI "--folder=<" folder ">" + +Deliver the message to the specified folder, +relative to the top-level directory given by the value of +\fBdatabase.path\fR. +The default is to deliver to the top-level directory. + +.RE + +.RS 4 +.TP 4 +.B "--create-folder" + +Try to create the folder named by the +.B "--folder" +option, if it does not exist. +Otherwise the folder must already exist for mail +delivery to succeed. + .RE .SH EXIT STATUS