]> git.notmuchmail.org Git - notmuch/blobdiff - man/man1/notmuch-show.1
man: show and reply --decrypt option requires gpg-agent
[notmuch] / man / man1 / notmuch-show.1
index bd41c48af2d0588d88609df940aab9248bed1c77..7697dfcc2eccc8db32a1771eee9a26acfeb8284f 100644 (file)
@@ -1,4 +1,4 @@
-.TH NOTMUCH-SHOW 1 2012-08-20 "Notmuch 0.14"
+.TH NOTMUCH-SHOW 1 2013-02-17 "Notmuch 0.15.2"
 .SH NAME
 notmuch-show \- show messages matching the given search terms
 .SH SYNOPSIS
@@ -126,6 +126,15 @@ message.
 .RE
 .RE
 
+.RS 4
+.TP 4
+.BR \-\-format-version=N
+
+Use the specified structured output format version.  This is intended
+for programs that invoke \fBnotmuch\fR(1) internally.  If omitted, the
+latest supported version will be used.
+.RE
+
 .RS 4
 .TP 4
 .B \-\-part=N
@@ -154,8 +163,13 @@ will be replaced by the signed data.
 Decrypt any MIME encrypted parts found in the selected content
 (ie. "multipart/encrypted" parts). Status of the decryption will be
 reported (currently only supported with --format=json and
---format=sexp) and the multipart/encrypted part will be replaced
-by the decrypted content.  Implies --verify.
+--format=sexp) and on successful decryption the multipart/encrypted
+part will be replaced by the decrypted content.
+
+Decryption expects a functioning \fBgpg-agent\fR(1) to provide any
+needed credentials. Without one, the decryption will fail.
+
+Implies --verify.
 .RE
 
 .RS 4
@@ -201,6 +215,17 @@ column of output from the
 .B notmuch search
 command.
 
+.SH EXIT STATUS
+
+This command supports the following special exit status codes
+
+.TP
+.B 20
+The requested format version is too old.
+.TP
+.B 21
+The requested format version is too new.
+
 .SH SEE ALSO
 
 \fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),