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        --reply-to=sender 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
  37            --format=(<b>default</b>|<b>json</b>|<b>sexp</b>|<b>headers-only</b>)
  38
  39               <b>default</b>
  40
  41                      Includes  subject  and quoted message body as an RFC 2822
  42                      message.
  43
  44               <b>json</b>
  45
  46                      Produces JSON output containing headers for a reply  mes-
  47                      sage  and the contents of the original message. This out-
  48                      put can be used by a client to  create  a  reply  message
  49                      intelligently.
  50
  51               <b>sexp</b>
  52
  53                      Produces  S-Expression  output  containing  headers for a
  54                      reply message and the contents of the  original  message.
  55                      This  output  can  be  used by a client to create a reply
  56                      message intelligently.
  57
  58               <b>headers-only</b>
  59
  60                      Only produces In-Reply-To, References, To,  Cc,  and  Bcc
  61                      headers.
  62
  63            <b>--format-version=N</b>
  64
  65                   Use  the specified structured output format version. This is
  66                   intended for programs that invoke <a href='../notmuch-1/'>notmuch</a>(1) internally.  If
  67                   omitted, the latest supported version will be used.
  68
  69            --reply-to=(<b>all</b>|<b>sender</b>)
  70
  71               <b>all</b> <b>(default)</b>
  72
  73                      Replies to all addresses.
  74
  75               <b>sender</b>
  76
  77                      Replies  only  to  the  sender. If replying to user&apos;s own
  78                      message (Reply-to: or From: header is one of  the  user&apos;s
  79                      configured email addresses), try To:, Cc:, and Bcc: head-
  80                      ers in this order, and copy values from  the  first  that
  81                      contains  something other than only the user&apos;s addresses.
  82
  83            <b>--decrypt</b>
  84
  85                   Decrypt any MIME encrypted parts found in the selected  con-
  86                   tent   (ie.  &quot;multipart/encrypted&quot;  parts).  Status  of  the
  87                   decryption will be reported (currently only  supported  with
  88                   --format=json  and  --format=sexp) and on successful decryp-
  89                   tion the multipart/encrypted part will be  replaced  by  the
  90                   decrypted content.
  91
  92                   Decryption expects a functioning <b>gpg-agent</b>(1) to provide any
  93                   needed credentials. Without one, the decryption will fail.
  94
  95        See <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7) for details of  the  supported  syntax  for
  96        &lt;search-terms&gt;.
  97
  98        Note:  It  is  most  common  to  use <b>notmuch</b> <b>reply</b> with a search string
  99        matching a single message, (such as id:&lt;message-id&gt;),  but  it  can  be
 100        useful to reply to several messages at once. For example, when a series
 101        of patches are sent in a single thread, replying to the  entire  thread
 102        allows  for  the  reply to comment on issues found in multiple patches.
 103        The default format supports replying to multiple messages at once,  but
 104        the JSON and S-Expression formats do not.
 105 </pre>
 106
 107 <h2>EXIT STATUS</h2>
 108 <pre>
 109        This command supports the following special exit status codes
 110
 111        <b>20</b>
 112
 113               The requested format version is too old.
 114
 115        <b>21</b>
 116
 117               The requested format version is too new.
 118 </pre>
 119
 120 <h2>SEE ALSO</h2>
 121 <pre>
 122        <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>
 123        <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),
 124        <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>
 125        <a href='../notmuch-tag-1/'>much-tag</a>(1)
 126 </pre>
 127
 128 <h2>AUTHOR</h2>
 129 <pre>
 130        Carl Worth and many others
 131 </pre>
 132
 133 <h2>COPYRIGHT</h2>
 134 <pre>
 135        2014, Carl Worth and many others
 136 </pre>
 137
 138 <h2>0.18</h2>