From 2e9c7aba99598eafd7b5fc52897da14ea13af216 Mon Sep 17 00:00:00 2001 From: David Edmondson Date: Wed, 24 Mar 2010 07:21:20 +0000 Subject: notmuch: Add a 'part' subcommand A new 'part' subcommand allows the user to extract a single part from a MIME message. Usage: notmuch part --part= The search terms must match only a single message (e.g. id:foo@bar.com). The part number specified refers to the part identifiers output by `notmuch show'. The content of the part is written the stdout with no formatting or identification marks. It is not JSON formatted. --- notmuch.1 | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) (limited to 'notmuch.1') diff --git a/notmuch.1 b/notmuch.1 index e573749..9d0473d 100644 --- a/notmuch.1 +++ b/notmuch.1 @@ -353,6 +353,32 @@ So if you've previously been using sup for mail, then the .B "notmuch restore" command provides you a way to import all of your tags (or labels as sup calls them). +.RE + +The +.B part +command can used to output a single part of a multi-part MIME message. + +.RS 4 +.TP 4 +.BR part " --part= ..." + +Output a single MIME part of a message. + +A single decoded MIME part, with no encoding or framing, is output to +stdout. The search terms must match only a single message, otherwise +this command will fail. + +The part number should match the part "id" field output by the +"--format=json" option of "notmuch show". If the message specified by +the search terms does not include a part with the specified "id" there +will be no output. + +See the +.B "SEARCH SYNTAX" +section below for details of the supported syntax for . +.RE + .SH SEARCH SYNTAX Several notmuch commands accept a common syntax for search terms. -- cgit v1.2.3