- <b>--folder=<folder></b>
- Deliver the message to the specified folder, relative to the
- top-level directory given by the value of <b>database.path</b>. The
- default is to deliver to the top-level directory.
-
- <b>--create-folder</b>
- Try to create the folder named by the <b>--folder</b> option, if it
- does not exist. Otherwise the folder must already exist for
- mail delivery to succeed.
-
- <b>--keep</b> Keep the message file if indexing fails, and keep the message
- indexed if applying tags or maildir flag synchronization
- fails. Ignore these errors and return exit status 0 to indi‐
- cate successful mail delivery.
-
- <b>--no-hooks</b>
- Prevent hooks from being run.
+ <b>--folder=<folder></b>
+ Deliver the message to the specified folder, relative to the
+ top-level directory given by the value of <b>database.mail</b>_<b>root</b>.
+ The default is the empty string, which means delivering to the
+ top-level directory.
+
+ <b>--create-folder</b>
+ Try to create the folder named by the <b>--folder</b> option, if it
+ does not exist. Otherwise the folder must already exist for mail
+ delivery to succeed.
+
+ <b>--keep</b> Keep the message file if indexing fails, and keep the message
+ indexed if applying tags or maildir flag synchronization fails.
+ Ignore these errors and return exit status 0 to indicate suc‐
+ cessful mail delivery.
+
+ <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'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
+ 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
+ of the message itself, so please ensure that the notmuch message
+ index is adequately protected. DO NOT USE <b>--decrypt=true</b> or
+ <b>--decrypt=nostash</b> without considering the security of your in‐
+ dex.
+
+ See also <b>index.decrypt</b> in <a href='../notmuch-config-1/'>notmuch-config</a>(1).