]> git.cworth.org Git - notmuch-wiki/blobdiff - manpages/notmuch-hooks-5.mdwn
0.20.1 manpages update
[notmuch-wiki] / manpages / notmuch-hooks-5.mdwn
index b537c0cbfc37c948ceebb563215f4784a47a847f..deb45f1e079d2d424b9dd2a0129877aaa73709cb 100644 (file)
@@ -1,62 +1,69 @@
 <h1>NOTMUCH-HOOKS(5)</h1>
 
 <h2>NAME</h2>
-
 <pre>
        notmuch-hooks - hooks for notmuch
 </pre>
 
 <h2>SYNOPSIS</h2>
-
 <pre>
-        $DATABASEDIR/.notmuch/hooks/*
+       $DATABASEDIR/.notmuch/hooks/*
 </pre>
 
 <h2>DESCRIPTION</h2>
-
 <pre>
        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
        have executable permissions.
-</pre>
 
-<pre>
        The currently available hooks are described below.
-</pre>
 
-<pre>
-           <b>pre-new</b>
-               This hook is invoked by the  <b>new</b>  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 <b>new</b> command.
-</pre>
+          <b>pre-new</b>
+                 This hook is invoked by the <b>new</b> 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 <b>new</b> command.
 
-<pre>
-               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.
+
+          <b>post-new</b>
+                 This hook is invoked by the <b>new</b> 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.
+
+                 Typically this hook is used to perform additional query-based
+                 tagging on the imported messages.
+
+          <b>post-insert</b>
+              This hook is invoked by the <b>insert</b> 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 succes‐
+              ful delivery depends on the <b>--keep</b> option.
+
+              Typically this hook is used to  perform  additional  query-based
+              tagging on the delivered messages.
 </pre>
 
+<h2>SEE ALSO</h2>
 <pre>
-           <b>post-new</b>
-               This hook is invoked by the <b>new</b> 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.
+       <a href='../notmuch-1/'>notmuch</a>(1),  <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-insert-1/'>not‐</a>
+       <a href='../notmuch-insert-1/'>much-insert</a>(1), <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),  <a href='../notmuch-restore-1/'>notmuch-restore</a>(1),
+       <a href='../notmuch-search-1/'>notmuch-search</a>(1),   <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7),   <a href='../notmuch-show-1/'>notmuch-show</a>(1),   <a href='../notmuch-tag-1/'>not‐</a>
+       <a href='../notmuch-tag-1/'>much-tag</a>(1)
 </pre>
 
+<h2>AUTHOR</h2>
 <pre>
-               Typically  this  hook is used to perform additional query-based
-               tagging on the imported messages.
+       Carl Worth and many others
 </pre>
 
-<h2>SEE ALSO</h2>
-
+<h2>COPYRIGHT</h2>
 <pre>
-       <b>notmuch</b>(1), <b>notmuch-config</b>(1), <b>notmuch-count</b>(1), <b>notmuch-dump</b>(1),  <b>not-</b>
-       <b>much-new</b>(1),  <b>notmuch-reply</b>(1),  <b>notmuch-restore</b>(1), <b>notmuch-search</b>(1),
-       <b>notmuch-search-terms</b>(7), <b>notmuch-show</b>(1), <b>notmuch-tag</b>(1)
+       2014, Carl Worth and many others
 </pre>
 
-<h2>Notmuch 0.13.2</h2>
+<h2>0.20.1</h2>