version: set new version and release date

[notmuch] / man / man1 / notmuch-insert.1

diff --git a/man/man1/notmuch-insert.1 b/man/man1/notmuch-insert.1
index fbf83e03c7f722e9002449bd281cfb687e17642c..87ae11c92e37cee2abadc011b54b7009d5492dee 100644 (file)
--- 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-07-28 "Notmuch 0.16"
 .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