X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-reply-1.mdwn;h=54a3a17fd19b3211516e7c15bcbf64dd3410cf1b;hb=ced8564f8c5034012ef80c90bbf7e9e57f125b41;hp=203b57d4b695e4cee51089e4957a1fe66c28e494;hpb=aeb851d55ecf79d2e8a8c9a1a99fd73ef1a7ac06;p=notmuch-wiki diff --git a/manpages/notmuch-reply-1.mdwn b/manpages/notmuch-reply-1.mdwn index 203b57d..54a3a17 100644 --- a/manpages/notmuch-reply-1.mdwn +++ b/manpages/notmuch-reply-1.mdwn @@ -2,12 +2,12 @@

NAME

-       notmuch-reply - Constructs a reply template for a set of messages.
+       notmuch-reply - constructs a reply template for a set of messages

SYNOPSIS

-       notmuch reply [options...] <search-term>...
+       notmuch reply [option ...] <search-term> ...

DESCRIPTION

@@ -15,60 +15,80 @@ Constructs a reply template for a set of messages. To make replying to email easier, notmuch reply takes an existing set - of messages and constructs a suitable mail template. The Reply-to: - header (if any, otherwise From:) is used for the To: address. Unless - --reply-to=sender is specified, values from the To: and Cc: headers are - copied, but not including any of the current user's email addresses (as - configured in primary_mail or other_email in the .notmuch-config file) - in the recipient list. - - It also builds a suitable new subject, including Re: at the front (if - not already present), and adding the message IDs of the messages being - replied to to the References list and setting the In-Reply-To: field + of messages and constructs a suitable mail template. Its To: address is + set according to the original email in this way: if the Reply-to: + header is present and different from any To:/Cc: address it is used, + otherwise From: header is used. Unless --reply-to=sender is specified, + values from the To: and Cc: headers are copied, but not including any + of the current user's email addresses (as configured in primary_mail or + other_email in the .notmuch-config file) in the recipient list. + + It also builds a suitable new subject, including Re: at the front (if + not already present), and adding the message IDs of the messages being + replied to to the References list and setting the In-Reply-To: field correctly. - Finally, the original contents of the emails are quoted by prefixing + Finally, the original contents of the emails are quoted by prefixing each line with '> ' and included in the body. The resulting message template is output to stdout. Supported options for reply include - --format=(default|json|headers-only) + --format=(default|json|sexp|headers-only) - default - Includes subject and quoted message body. + default + Includes subject and quoted message body as an RFC 2822 + message. - json - Produces JSON output containing headers for a reply mes- - sage and the contents of the original message. This out- - put can be used by a client to create a reply message - intelligently. + json Produces JSON output containing headers for a reply mes‐ + sage and the contents of the original message. This out‐ + put can be used by a client to create a reply message + intelligently. - headers-only - Only produces In-Reply-To, References, To, Cc, and Bcc - headers. + 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. - --reply-to=(all|sender) + headers-only + Only produces In-Reply-To, References, To, Cc, and Bcc + headers. - all (default) - Replies to all addresses. + --format-version=N + Use the specified structured output format version. This is + intended for programs that invoke notmuch(1) internally. If + omitted, the latest supported version will be used. - sender - Replies only to the sender. If replying to user's own - message (Reply-to: or From: header is one of the user's - configured email addresses), try To:, Cc:, and Bcc: - headers in this order, and copy values from the first - that contains something other than only the user's - addresses. + --reply-to=(all|sender) - --decrypt + all (default) + Replies to all addresses. - Decrypt any MIME encrypted parts found in the selected con- - tent (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 content. + sender Replies only to the sender. If replying to user's own + message (Reply-to: or From: header is one of the user's + configured email addresses), try To:, Cc:, and Bcc: head‐ + ers in this order, and copy values from the first that + contains something other than only the user's addresses. + + --decrypt=(false|auto|true) + If true, decrypt any MIME encrypted parts found in the selected con‐ + tent (i.e., "multipart/encrypted" parts). Status of the decryption + will be reported (currently only supported with --format=json and + --format=sexp), and on successful decryption the multipart/encrypted + part will be replaced by the decrypted content. + + If auto, and a session key is already known for the message, then it + will be decrypted, but notmuch will not try to access the user's + secret keys. + + Use false to avoid even automatic decryption. + + Non-automatic decryption expects a functioning gpg-agent(1) to pro‐ + vide any needed credentials. Without one, the decryption will likely + fail. + + Default: auto See notmuch-search-terms(7) for details of the supported syntax for <search-terms>. @@ -79,15 +99,34 @@ 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. + the JSON and S-Expression formats do not. + + +

EXIT STATUS

+
+       This command supports the following special exit status codes
+
+       20     The requested format version is too old.
+
+       21     The requested format version is too new.

SEE ALSO

-       notmuch(1),  notmuch-config(1), notmuch-count(1), notmuch-dump(1), not-
-       much-hooks(5)
-, notmuch-new(1),  notmuch-restore(1),  notmuch-search(1),
-       notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
+       notmuch(1),  notmuch-config(1), notmuch-count(1), notmuch-dump(1), not‐
+       much-hooks(5), notmuch-insert(1),  notmuch-new(1),  notmuch-restore(1),
+       notmuch-search(1),   notmuch-search-terms(7),   notmuch-show(1),   not‐
+       much-tag(1)
+
+ +

AUTHOR

+
+       Carl Worth and many others
+
+ +

COPYRIGHT

+
+       2009-2020, Carl Worth and many others
-

Notmuch 0.13.2

+

0.31