[PATCH v2 19/20] man: document 'insert' command
On Sun, 25 Nov 2012, Peter Wang wrote: > Add initial documentation for notmuch insert command. > --- > man/Makefile.local| 1 + > man/man1/notmuch-insert.1 | 60 > +++ > 2 files changed, 61 insertions(+) > create mode 100644 man/man1/notmuch-insert.1 > > diff --git a/man/Makefile.local b/man/Makefile.local > index 72e2a18..216aaa0 100644 > --- a/man/Makefile.local > +++ b/man/Makefile.local > @@ -12,6 +12,7 @@ MAN1 := \ > $(dir)/man1/notmuch-count.1 \ > $(dir)/man1/notmuch-dump.1 \ > $(dir)/man1/notmuch-restore.1 \ > + $(dir)/man1/notmuch-insert.1 \ > $(dir)/man1/notmuch-new.1 \ > $(dir)/man1/notmuch-reply.1 \ > $(dir)/man1/notmuch-search.1 \ > diff --git a/man/man1/notmuch-insert.1 b/man/man1/notmuch-insert.1 > new file mode 100644 > index 000..8b1c4e9 > --- /dev/null > +++ b/man/man1/notmuch-insert.1 > @@ -0,0 +1,60 @@ > +.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 "[ +<" 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. Is it worth emphasising that the command line tags are applied after the new tags so can be used to remove the new tags? Best wishes Mark > +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 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) > -- > 1.7.12.1 > > ___ > notmuch mailing list > notmuch at notmuchmail.org > http://notmuchmail.org/mailman/listinfo/notmuch
[PATCH v2 19/20] man: document 'insert' command
Add initial documentation for notmuch insert command. --- man/Makefile.local| 1 + man/man1/notmuch-insert.1 | 60 +++ 2 files changed, 61 insertions(+) create mode 100644 man/man1/notmuch-insert.1 diff --git a/man/Makefile.local b/man/Makefile.local index 72e2a18..216aaa0 100644 --- a/man/Makefile.local +++ b/man/Makefile.local @@ -12,6 +12,7 @@ MAN1 := \ $(dir)/man1/notmuch-count.1 \ $(dir)/man1/notmuch-dump.1 \ $(dir)/man1/notmuch-restore.1 \ + $(dir)/man1/notmuch-insert.1 \ $(dir)/man1/notmuch-new.1 \ $(dir)/man1/notmuch-reply.1 \ $(dir)/man1/notmuch-search.1 \ diff --git a/man/man1/notmuch-insert.1 b/man/man1/notmuch-insert.1 new file mode 100644 index 000..8b1c4e9 --- /dev/null +++ b/man/man1/notmuch-insert.1 @@ -0,0 +1,60 @@ +.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 "[ +<" 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. + +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 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) -- 1.7.12.1
[PATCH v2 19/20] man: document 'insert' command
Add initial documentation for notmuch insert command. --- man/Makefile.local| 1 + man/man1/notmuch-insert.1 | 60 +++ 2 files changed, 61 insertions(+) create mode 100644 man/man1/notmuch-insert.1 diff --git a/man/Makefile.local b/man/Makefile.local index 72e2a18..216aaa0 100644 --- a/man/Makefile.local +++ b/man/Makefile.local @@ -12,6 +12,7 @@ MAN1 := \ $(dir)/man1/notmuch-count.1 \ $(dir)/man1/notmuch-dump.1 \ $(dir)/man1/notmuch-restore.1 \ + $(dir)/man1/notmuch-insert.1 \ $(dir)/man1/notmuch-new.1 \ $(dir)/man1/notmuch-reply.1 \ $(dir)/man1/notmuch-search.1 \ diff --git a/man/man1/notmuch-insert.1 b/man/man1/notmuch-insert.1 new file mode 100644 index 000..8b1c4e9 --- /dev/null +++ b/man/man1/notmuch-insert.1 @@ -0,0 +1,60 @@ +.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 [ + 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. + +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 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) -- 1.7.12.1 ___ notmuch mailing list notmuch@notmuchmail.org http://notmuchmail.org/mailman/listinfo/notmuch