X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-insert-1.mdwn;h=54cfd13e43a1322c1ea83675232c6e6c220015f8;hb=dd8c0d25288488dc30b41c04c35bdd552bf04e71;hp=0cb24e38a38eba12b6522f51af9aa9e60c0d68c9;hpb=c63cba0c3c8f17697612a900fe41a308b878cd23;p=notmuch-wiki diff --git a/manpages/notmuch-insert-1.mdwn b/manpages/notmuch-insert-1.mdwn index 0cb24e3..54cfd13 100644 --- a/manpages/notmuch-insert-1.mdwn +++ b/manpages/notmuch-insert-1.mdwn @@ -14,7 +14,7 @@
notmuch insert reads a message from standard input and delivers it into the maildir directory given by configuration option database.path, then - incorporates the message into the notmuch database. It is an alterna- + incorporates the message into the notmuch database. It is an alternaâ tive to using a separate tool to deliver the message then running not- much new afterwards. @@ -22,40 +22,51 @@ configuration option, then by operations specified on the command-line: tags prefixed by '+' are added while those prefixed by '-' are removed. - If the new message is a duplicate of an existing message in the - database (it has same Message-ID), it will be added to the maildir - folder and notmuch database, but the tags will not be changed. + If the new message is a duplicate of an existing message in the dataâ + 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> + --folder=<folder> + 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. - 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 + mail delivery to succeed. - --create-folder + --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. - 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. + --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. - - 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 --keep option may be used to settle for successful + message file delivery. + + The exit status of the post-insert hook does not affect the exit status + of the insert command.
- notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1), not- + notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1), notâ much-hooks(5), notmuch-reply(1), notmuch-restore(1), notmuch-search(1), notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)@@ -67,7 +78,7 @@
- 2014, Carl Worth and many others + 2009-2016, Carl Worth and many others-