X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-insert-1.mdwn;h=56a2b2a746708b0b8dd69ea94c914bafd17fcd5a;hb=87440cbc1d12fc3a860289b11d7b850b538dcf3d;hp=fdaa55a3ce2bcea5ca24b0dbb60b6198b2bf60cc;hpb=6562766d20047abcb3bab0d88a1e5849baaae76d;p=notmuch-wiki diff --git a/manpages/notmuch-insert-1.mdwn b/manpages/notmuch-insert-1.mdwn index fdaa55a..56a2b2a 100644 --- a/manpages/notmuch-insert-1.mdwn +++ b/manpages/notmuch-insert-1.mdwn @@ -26,29 +26,42 @@ base (it has same Message-ID), it will be added to the maildir folder and notmuch database, but the tags will not be changed. - Option arguments must appear before any tag operation arguments. Supâ + The insert command supports hooks. See notmuch-hooks(5) for more + details on hooks. + + Option arguments must appear before any tag operation arguments. Supâ ported options for insert include --folder=<folder> - Deliver the message to the specified folder, relative to the - top-level directory given by the value of database.path. The + Deliver the message to the specified folder, relative to the + top-level directory given by the value of database.path. The default is to deliver to the top-level directory. --create-folder - Try to create the folder named by the --folder option, if it - does not exist. Otherwise the folder must already exist for + Try to create the folder named by the --folder option, if it + does not exist. Otherwise the folder must already exist for mail delivery to succeed. + + --keep 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 succesful mail delivery. + + --no-hooks + Prevent hooks from being run.
- 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. + 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 --keep option may be used to settle for successful + message file delivery. - If the message could not be written to disk then a non-zero exit status - is returned. + The exit status of the post-insert hook does not affect the exit status + of the insert command.