X-Git-Url: https://git.cworth.org/git?p=notmuch-wiki;a=blobdiff_plain;f=manpages%2Fnotmuch-reply-1.mdwn;h=9ce2e2eac0bdd46bd54417522ef5698fd2383804;hp=9fe27951786a7d14b0ed632ce1824dff79a5557e;hb=e4734d2e839d916a78d295c76eff880574c327db;hpb=2134d331154dfbe8d01b8db310f8d5ad7616f38d diff --git a/manpages/notmuch-reply-1.mdwn b/manpages/notmuch-reply-1.mdwn index 9fe2795..9ce2e2e 100644 --- a/manpages/notmuch-reply-1.mdwn +++ b/manpages/notmuch-reply-1.mdwn @@ -7,7 +7,7 @@

SYNOPSIS

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

DESCRIPTION

@@ -33,60 +33,90 @@ The resulting message template is output to stdout. Supported options for reply include + --format=(default|json|sexp|headers-only) + + 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. + + 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. + + headers-only + Only produces In-Reply-To, References, To, Cc, and Bcc + headers. + + --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. + + --reply-to=(all|sender) + + all (default) + Replies to all addresses. + + 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 + Decrypt any MIME encrypted parts found in the selected con‐ + tent (ie. "multipart/encrypted" parts). Status of the decryp‐ + tion will be reported (currently only supported with --for‐ + mat=json and --format=sexp) and on successful decryption the + multipart/encrypted part will be replaced by the decrypted + content. + + Decryption expects a functioning gpg-agent(1) to provide any + needed credentials. Without one, the decryption will fail. + + See notmuch-search-terms(7) for details of the supported syntax for + <search-terms>. - --format=(default|json|headers-only) - - default - Includes subject and quoted message body. - - 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. - - --reply-to=(all|sender) - - all (default) - Replies to all addresses. + Note: It is most common to use notmuch reply with a search string + matching a single message, (such as id:<message-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 and S-Expression formats do not. + - 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. +

EXIT STATUS

+
+       This command supports the following special exit status codes
 
-              --decrypt
+       20     The requested format version is too old.
 
-                  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 content.
+       21     The requested format version is too new.
+
- See notmuch-search-terms(7) for details of the supported syntax for - <search-terms>. +

SEE ALSO

+
+       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)
+
- Note: It is most common to use notmuch reply with a search string - matching a single message, (such as id:<message-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. +

AUTHOR

+
+       Carl Worth and many others
-

SEE ALSO

+

COPYRIGHT

-       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)
+       2014, Carl Worth and many others
-

Notmuch 0.14

+

0.20.1