X-Git-Url: https://git.notmuchmail.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-hooks-5.mdwn;h=931ea8a18c1d7aa1817ea3a7a3ea9385ac8bb6ee;hb=7ab49d222b1bafd16ce17aa2a8f21648fb3ac8fd;hp=873fd9089d7f571203f7347a37807e1830605214;hpb=6562766d20047abcb3bab0d88a1e5849baaae76d;p=notmuch-wiki diff --git a/manpages/notmuch-hooks-5.mdwn b/manpages/notmuch-hooks-5.mdwn index 873fd90..931ea8a 100644 --- a/manpages/notmuch-hooks-5.mdwn +++ b/manpages/notmuch-hooks-5.mdwn @@ -7,41 +7,51 @@

SYNOPSIS

-          $DATABASEDIR/.notmuch/hooks/*
+       <hook_dir>/{pre-new, post-new, post-insert}

DESCRIPTION

        Hooks  are  scripts (or arbitrary executables or symlinks to such) that
        notmuch invokes before and after certain actions. These scripts  reside
-       in  the .notmuch/hooks directory within the database directory and must
+       in  a  directory  defined  as described in notmuch-config(1). They must
        have executable permissions.
 
        The currently available hooks are described below.
 
-          pre-new
-                 This hook is invoked by the new command  before  scanning  or
-                 importing  new messages into the database. If this hook exits
-                 with a non-zero status, notmuch will abort further processing
-                 of the new command.
+       pre-new
+              This hook is invoked by the new command before scanning  or  im‐
+              porting  new messages into the database. If this hook exits with
+              a non-zero status, notmuch will abort further processing of  the
+              new command.
 
-                 Typically  this  hook  is used for fetching or delivering new
-                 mail to be imported into the database.
+              Typically  this hook is used for fetching or delivering new mail
+              to be imported into the database.
 
-          post-new
-                 This hook is invoked by the new command  after  new  messages
-                 have  been  imported  into the database and initial tags have
-                 been applied. The hook will not be run if there have been any
-                 errors during the scan or import.
+       post-new
+              This hook is invoked by the new command after new messages  have
+              been  imported  into the database and initial tags have been ap‐
+              plied. The hook will not be run if there have  been  any  errors
+              during the scan or import.
 
-                 Typically this hook is used to perform additional query-based
-                 tagging on the imported messages.
+              Typically  this  hook  is used to perform additional query-based
+              tagging on the imported messages.
+
+       post-insert
+              This hook is invoked by the insert command after the message has
+              been  delivered,  added  to  the database, and initial tags have
+              been applied. The hook will not be run if there  have  been  any
+              errors during the message delivery; what is regarded as success‐
+              ful delivery depends on the --keep option.
+
+              Typically this hook is used to  perform  additional  query-based
+              tagging on the delivered messages.

SEE ALSO

-       notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1),  not‐
-       much-insert(1),  notmuch-new(1),  notmuch-reply(1), notmuch-restore(1),
+       notmuch(1),  notmuch-config(1), notmuch-count(1), notmuch-dump(1), not‐
+       much-insert(1), notmuch-new(1),  notmuch-reply(1),  notmuch-restore(1),
        notmuch-search(1),   notmuch-search-terms(7),   notmuch-show(1),   not‐
        much-tag(1)
@@ -53,7 +63,7 @@

COPYRIGHT

-       2014, Carl Worth and many others
+       2009-2021, Carl Worth and many others
-

0.18.1

+

0.32