-<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 <a href='../notmuch-new-1/'>notmuch-new</a>(1) 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 <a href='../notmuch-insert-1/'>notmuch-insert</a>(1) 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
+ successful delivery depends on the <b>--keep</b> option.
+
+ Typically this hook is used to perform additional query-based
+ tagging on the delivered messages.