manpages updates for release 0.27

[notmuch-wiki] / manpages / notmuch-insert-1.mdwn

diff --git a/manpages/notmuch-insert-1.mdwn b/manpages/notmuch-insert-1.mdwn
index bf44bdc4b4a1d9ae48eaa07110d6e7a553c186ff..e7b05b62883e284b44bcfe48e7a53d1bb18c8912 100644 (file)
--- a/manpages/notmuch-insert-1.mdwn
+++ b/manpages/notmuch-insert-1.mdwn
@@ -51,22 +51,28 @@
        <b>--no-hooks</b>
               Prevent hooks from being run.
 
+       <b>--world-readable</b>
+              When  writing  mail to the mailbox, allow it to be read by users
+              other than the current user.  Note that this does  not  override
+              umask.   By default, delivered mail is only readable by the cur‐
+              rent user.
+
        <b>--decrypt=(true|nostash|auto|false)</b>
               If <b>true</b> and the message is encrypted, try to decrypt the message
-              while indexing, stashing any session keys discovered.  If  <b>auto</b>,
-              and  notmuch  already knows about a session key for the message,
-              it will try decrypting using that session key but will  not  try
-              to  access the user&apos;s secret keys.  If decryption is successful,
-              index the cleartext itself.  Either way, the message  is  always
+              while  indexing, stashing any session keys discovered.  If <b>auto</b>,
+              and notmuch already knows about a session key for  the  message,
+              it  will  try decrypting using that session key but will not try
+              to access the user&apos;s secret keys.  If decryption is  successful,
+              index  the  cleartext itself.  Either way, the message is always
               stored to disk in its original form (ciphertext).
 
-              <b>nostash</b>  is  the  same  as  <b>true</b>  except  that it will not stash
+              <b>nostash</b> is the same as  <b>true</b>  except  that  it  will  not  stash
               newly-discovered session keys in the database.
 
               Be aware that the index is likely sufficient (and a stashed ses‐
-              sion  key  is certainly sufficient) to reconstruct the cleartext
+              sion key is certainly sufficient) to reconstruct  the  cleartext
               of the message itself, so please ensure that the notmuch message
-              index  is  adequately  protected.  DO  NOT USE <b>--decrypt=true</b> or
+              index is adequately protected.  DO  NOT  USE  <b>--decrypt=true</b>  or
               <b>--decrypt=nostash</b>  without  considering  the  security  of  your
               index.
 
@@ -75,15 +81,15 @@
 
 <h2>EXIT STATUS</h2>
 <pre>
-       This  command  returns  exit  status  0  on  successful  mail delivery,
-       non-zero otherwise. The default is to indicate failed mail delivery  on
-       any  errors, including message file delivery to the filesystem, message
-       indexing to Notmuch database, changing tags, and synchronizing tags  to
-       maildir  flags.  The <b>--keep</b> option may be used to settle for successful
+       This command  returns  exit  status  0  on  successful  mail  delivery,
+       non-zero  otherwise. The default is to indicate failed mail delivery on
+       any errors, including message file delivery to the filesystem,  message
+       indexing  to Notmuch database, changing tags, and synchronizing tags to
+       maildir flags. The <b>--keep</b> option may be used to settle  for  successful
        message file delivery.
 
        This command supports the following special exit status code for errors
-       most  likely  to be temporary in nature, e.g. failure to get a database
+       most likely to be temporary in nature, e.g. failure to get  a  database
        write lock.
 
        <b>75</b> <b>(EX</b>_<b>TEMPFAIL)</b>
@@ -95,7 +101,7 @@
 
 <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-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-reply-1/'>notmuch-reply</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>
@@ -110,4 +116,4 @@
        2009-2018, Carl Worth and many others
 </pre>
 
-<h2>0.26</h2>
+<h2>0.27</h2>