aboutsummaryrefslogtreecommitdiffhomepage
path: root/notmuch.1
diff options
context:
space:
mode:
authorGravatar Jameson Graef Rollins <jrollins@finestructure.net>2011-05-23 15:31:32 -0700
committerGravatar Jameson Graef Rollins <jrollins@finestructure.net>2011-05-23 15:31:32 -0700
commit2f8871df6ea3c0b44f85a0fc1b4f58a6b70b0a0e (patch)
tree600325a4bc630431bc67f03aef99d329d5bd3036 /notmuch.1
parentecae541031911b65594c3ec757abb671583e8872 (diff)
New part output handling as option to notmuch-show.
Outputting of single MIME parts is moved to an option of notmuch show, instead of being handled in it's own sub-command. The recent rework of multipart mime allowed for this change but consolidating part handling into a single recursive function (show_message_part) that includes formatting. This allows for far simpler handling single output of a single part, including formatting.
Diffstat (limited to 'notmuch.1')
-rw-r--r--notmuch.115
1 files changed, 14 insertions, 1 deletions
diff --git a/notmuch.1 b/notmuch.1
index 2912fcfd..76222981 100644
--- a/notmuch.1
+++ b/notmuch.1
@@ -297,8 +297,20 @@ The original, raw content of the email message is displayed.
Consumers of this format should expect to implement MIME decoding and
similar functions. This format must only be used with search terms
matching a single message.
+.RE
+.RE
+
+.RS 4
+.TP 4
+.B \-\-part=N
+Output the single decoded MIME part N of a single message. The search
+terms must match only a single message. Message parts are numbered in
+a depth-first walk of the message MIME structure, and are identified
+in the 'json' or
+'text' output formats.
.RE
+
A common use of
.B notmuch show
is to display a single thread of email messages. For this, use a
@@ -311,7 +323,8 @@ See the
.B "SEARCH SYNTAX"
section below for details of the supported syntax for <search-terms>.
.RE
-.TP
+.RS 4
+.TP 4
.BR count " <search-term>..."
Count messages matching the search terms.