X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=man%2Fman1%2Fnotmuch-reply.1;h=9fa1956113bdad1f526323d63ca0ebc6d2751175;hp=d264060bad9b713d9c32e502f18c2c4ab743552d;hb=f6adf6615c51d878a61b1f37afb4c501ba31e4de;hpb=6442a473612064858c21aba9fac7e97388a16113 diff --git a/man/man1/notmuch-reply.1 b/man/man1/notmuch-reply.1 index d264060b..9fa19561 100644 --- a/man/man1/notmuch-reply.1 +++ b/man/man1/notmuch-reply.1 @@ -37,7 +37,7 @@ Supported options for include .RS .TP 4 -.BR \-\-format= ( default | json | headers\-only ) +.BR \-\-format= ( default | json | sexp | headers\-only ) .RS .TP 4 .BR default @@ -48,10 +48,25 @@ Produces JSON output containing headers for a reply message and the contents of the original message. This output can be used by a client to create a reply message intelligently. .TP +.BR sexp +Produces S-Expression output containing headers for a reply message and +the contents of the original message. This output can be used by a client +to create a reply message intelligently. +.TP .BR headers\-only Only produces In\-Reply\-To, References, To, Cc, and Bcc headers. .RE .RE + +.RS +.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 .TP 4 .BR \-\-reply\-to= ( all | sender ) @@ -74,8 +89,8 @@ user's addresses. 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 the -multipart/encrypted part will be replaced by the decrypted +reported (currently only supported with --format=json and --format=sexp) +and the multipart/encrypted part will be replaced by the decrypted content. .RE @@ -89,10 +104,22 @@ id:), but it can be useful to reply to several messages at once. For example, when a series of patches are sent in a single thread, replying to the entire thread allows for the reply to comment on issues found in multiple patches. The default format supports -replying to multiple messages at once, but the JSON format does not. +replying to multiple messages at once, but the JSON and S-Expression +formats do not. .RE .RE +.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),