manpages 0.15

[obsolete/notmuch-wiki] / manpages / notmuch-reply-1.mdwn

diff --git a/manpages/notmuch-reply-1.mdwn b/manpages/notmuch-reply-1.mdwn
index 9fe27951786a7d14b0ed632ce1824dff79a5557e..0d9f8c2d5ecef019fe6669ad34b4d69b28a9ecad 100644 (file)
--- a/manpages/notmuch-reply-1.mdwn
+++ b/manpages/notmuch-reply-1.mdwn
@@ -34,7 +34,7 @@
 
        Supported options for <b>reply</b> include
 
-              <b>--format=</b>(<b>default</b>|<b>json</b>|<b>headers-only</b>)
+              <b>--format=</b>(<b>default</b>|<b>json</b>|<b>sexp</b>|<b>headers-only</b>)
 
                   <b>default</b>
                       Includes subject and quoted message body.
@@ -45,48 +45,69 @@
                       put  can  be  used by a client to create a reply message
                       intelligently.
 
+                  <b>sexp</b>
+                      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.
+
                   <b>headers-only</b>
-                      Only produces In-Reply-To, References, To, Cc,  and  Bcc
+                      Only  produces  In-Reply-To, References, To, Cc, and Bcc
                       headers.
 
+              <b>--format-version=N</b>
+
+                  Use the specified structured output format version.  This is
+                  intended for programs that invoke <a href='../notmuch-1/'>notmuch</a>(1) internally.  If
+                  omitted, the latest supported version will be used.
+
               <b>--reply-to=</b>(<b>all</b>|<b>sender</b>)
 
                   <b>all</b> (default)
                       Replies to all addresses.
 
                   <b>sender</b>
-                      Replies  only  to  the sender. If replying to user&apos;s own
-                      message (Reply-to: or From: header is one of the  user&apos;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&apos;s
+                      Replies only to the sender. If replying  to  user&apos;s  own
+                      message  (Reply-to: or From: header is one of the user&apos;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&apos;s
                       addresses.
 
               <b>--decrypt</b>
 
-                  Decrypt any MIME  encrypted  parts  found  in  the  selected
-                  content  (ie.  &quot;multipart/encrypted&quot;  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.
+                  Decrypt  any MIME encrypted parts found in the selected con-
+                  tent  (ie.  &quot;multipart/encrypted&quot;  parts).  Status  of   the
+                  decryption  will  be reported (currently only supported with
+                  --format=json and --format=sexp) and the multipart/encrypted
+                  part will be replaced by the decrypted content.
 
-       See <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7) for details of  the  supported  syntax  for
+       See  <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7)  for  details  of the supported syntax for
        &lt;search-terms&gt;.
 
-       Note:  It  is  most  common  to  use <b>notmuch</b> <b>reply</b> with a search string
-       matching a single message, (such as id:&lt;message-id&gt;),  but  it  can  be
+       Note: It is most common to use  <b>notmuch</b>  <b>reply</b>  with  a  search  string
+       matching  a  single  message,  (such as id:&lt;message-id&gt;), 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.
+       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.
+</pre>
+
+<h2>EXIT STATUS</h2>
+<pre>
+       This command supports the following special exit status codes
+
+       <b>20</b>     The requested format version is too old.
+
+       <b>21</b>     The requested format version is too new.
 </pre>
 
 <h2>SEE ALSO</h2>
 <pre>
-       <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>
-       <a href='../notmuch-hooks-5/'>much-hooks</a>(5), <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-restore-1/'>notmuch-restore</a>(1),  <a href='../notmuch-search-1/'>notmuch-search</a>(1),
+       <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>
+       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-restore-1/'>notmuch-restore</a>(1), <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/'>notmuch-tag</a>(1)
 </pre>
 
-<h2>Notmuch 0.14</h2>
+<h2>Notmuch 0.15</h2>