X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=notmuch.1;h=9d0473d5941423b310bf3c0af9389c2d49399064;hp=2df320d8657c2cedb22c0fb6502c5a95451a696c;hb=248e6f8c04ba88806ad7e8cd07f1c68493dc1a52;hpb=6ce2bf68f53fec4302121763e588c33c7cd86a9c

diff --git a/notmuch.1 b/notmuch.1
index 2df320d8..9d0473d5 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=<part-number> <search-term>..."
+
+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 <search-terms>.
+.RE
+
 .SH SEARCH SYNTAX
 Several notmuch commands accept a common syntax for search terms.
 
@@ -373,7 +399,7 @@ terms to match against specific portions of an email, (where
 
 	attachment:<word>
 
-	tag:<tag>
+	tag:<tag> (or is:<tag>)
 
 	id:<message-id>
 
@@ -402,7 +428,7 @@ prefix can be used to search for specific filenames (or extensions) of
 attachments to email messages.
 
 For
-.BR tag: ,
+.BR tag: " and " is:
 valid tag values include
 .BR inbox " and " unread
 by default for new messages added by