From: Peter Wang <novalazy@gmail.com>
Date: Sun, 23 Jun 2013 04:24:01 +0000 (+1000)
Subject: man: document insert --folder option
X-Git-Tag: 0.16_rc1~34
X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=commitdiff_plain;h=9a5b12900255989b0aa42b18736f4fce212b68f6;ds=sidebyside

man: document insert --folder option

Add documentation for notmuch insert --folder option.
---

diff --git a/man/man1/notmuch-insert.1 b/man/man1/notmuch-insert.1
index fbf83e03..e85fef8a 100644
--- a/man/man1/notmuch-insert.1
+++ b/man/man1/notmuch-insert.1
@@ -4,6 +4,7 @@ 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,19 @@ 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
 .SH EXIT STATUS