- This command returns exit status 0 if the message was successfully
- added to the mail directory, even if the message could not be indexed
- and added to the notmuch database. In the latter case, a warning will
- be printed to standard error but the message file will be left on disk.
-
- If the message could not be written to disk then a non-zero exit status
- is returned.
+ This command returns exit status 0 on succesful 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.
+
+ The exit status of the <b>post-insert</b> hook does not affect the exit status
+ of the <b>insert</b> command.