git.cworth.org Git - notmuch-wiki/blob - manpages/notmuch-reply-1.mdwn

   1 <h1>NOTMUCH-REPLY(1)</h1>
   2
   3 <h2>NAME</h2>
   4 <pre>
   5        notmuch-reply - constructs a reply template for a set of messages
   6 </pre>
   7
   8 <h2>SYNOPSIS</h2>
   9 <pre>
  10        <b>notmuch</b> <b>reply</b> [option ...] &lt;<u>search-term</u>&gt; ...
  11 </pre>
  12
  13 <h2>DESCRIPTION</h2>
  14 <pre>
  15        Constructs a reply template for a set of messages.
  16
  17        To  make  replying to email easier, <b>notmuch</b> <b>reply</b> takes an existing set
  18        of messages and constructs a  suitable  mail  template.  The  Reply-to:
  19        header  (if  any,  otherwise From:) is used for the To: address. Unless
  20        <b>--reply-to=sender</b> is specified, values from the To: and Cc: headers are
  21        copied, but not including any of the current user&apos;s email addresses (as
  22        configured in primary_mail or other_email in the .notmuch-config  file)
  23        in the recipient list.
  24
  25        It  also  builds a suitable new subject, including Re: at the front (if
  26        not already present), and adding the message IDs of the messages  being
  27        replied  to  to  the References list and setting the In-Reply-To: field
  28        correctly.
  29
  30        Finally, the original contents of the emails are  quoted  by  prefixing
  31        each line with &apos;&gt; &apos; and included in the body.
  32
  33        The resulting message template is output to stdout.
  34
  35        Supported options for <b>reply</b> include
  36           <b>--format=</b>(<b>default</b>|<b>json</b>|<b>sexp</b>|<b>headers-only</b>)
  37
  38               <b>default</b>
  39                      Includes  subject  and quoted message body as an RFC 2822
  40                      message.
  41
  42               <b>json</b>   Produces JSON output containing headers for a reply  mes‐
  43                      sage  and the contents of the original message. This out‐
  44                      put can be used by a client to  create  a  reply  message
  45                      intelligently.
  46
  47               <b>sexp</b>   Produces  S-Expression  output  containing  headers for a
  48                      reply message and the contents of the  original  message.
  49                      This  output  can  be  used by a client to create a reply
  50                      message intelligently.
  51
  52               <b>headers-only</b>
  53                      Only produces In-Reply-To, References, To,  Cc,  and  Bcc
  54                      headers.
  55
  56           <b>--format-version=N</b>
  57                  Use  the  specified structured output format version. This is
  58                  intended for programs that invoke <a href='../notmuch-1/'>notmuch</a>(1)  internally.  If
  59                  omitted, the latest supported version will be used.
  60
  61           <b>--reply-to=</b>(<b>all</b>|<b>sender</b>)
  62
  63               <b>all</b> <b>(default)</b>
  64                      Replies to all addresses.
  65
  66               <b>sender</b> Replies  only  to  the  sender. If replying to user&apos;s own
  67                      message (Reply-to: or From: header is one of  the  user&apos;s
  68                      configured email addresses), try To:, Cc:, and Bcc: head‐
  69                      ers in this order, and copy values from  the  first  that
  70                      contains something other than only the user&apos;s addresses.
  71
  72           <b>--decrypt</b>
  73                  Decrypt  any  MIME encrypted parts found in the selected con‐
  74                  tent (ie. &quot;multipart/encrypted&quot; parts). Status of the decryp‐
  75                  tion  will  be reported (currently only supported with --for‐
  76                  mat=json and --format=sexp) and on successful decryption  the
  77                  multipart/encrypted  part  will  be replaced by the decrypted
  78                  content.
  79
  80                  Decryption expects a functioning <b>gpg-agent</b>(1) to provide  any
  81                  needed credentials. Without one, the decryption will fail.
  82
  83        See  <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7)  for  details  of the supported syntax for
  84        &lt;search-terms&gt;.
  85
  86        Note: It is most common to use  <b>notmuch</b>  <b>reply</b>  with  a  search  string
  87        matching  a  single  message,  (such as id:&lt;message-id&gt;), but it can be
  88        useful to reply to several messages at once. For example, when a series
  89        of  patches  are sent in a single thread, replying to the entire thread
  90        allows for the reply to comment on issues found  in  multiple  patches.
  91        The  default format supports replying to multiple messages at once, but
  92        the JSON and S-Expression formats do not.
  93 </pre>
  94
  95 <h2>EXIT STATUS</h2>
  96 <pre>
  97        This command supports the following special exit status codes
  98
  99        <b>20</b>     The requested format version is too old.
 100
 101        <b>21</b>     The requested format version is too new.
 102 </pre>
 103
 104 <h2>SEE ALSO</h2>
 105 <pre>
 106        <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1),  <a href='../notmuch-hooks-5/'>not‐</a>
 107        <a href='../notmuch-hooks-5/'>much-hooks</a>(5),  <a href='../notmuch-insert-1/'>notmuch-insert</a>(1),  <a href='../notmuch-new-1/'>notmuch-new</a>(1), <a href='../notmuch-restore-1/'>notmuch-restore</a>(1),
 108        <a href='../notmuch-search-1/'>notmuch-search</a>(1),   <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7),   <a href='../notmuch-show-1/'>notmuch-show</a>(1),   <a href='../notmuch-tag-1/'>not‐</a>
 109        <a href='../notmuch-tag-1/'>much-tag</a>(1)
 110 </pre>
 111
 112 <h2>AUTHOR</h2>
 113 <pre>
 114        Carl Worth and many others
 115 </pre>
 116
 117 <h2>COPYRIGHT</h2>
 118 <pre>
 119        2014, Carl Worth and many others
 120 </pre>
 121
 122 <h2>0.20.1</h2>