mirror of
https://git.notmuchmail.org/git/notmuch
synced 2024-11-22 19:08:09 +01:00
c48797b498
We mostly just cut and paste the command descriptions into individual files, with a short header added to each one. The splitting into subdirectories is to support the use of ./man as an element in MANPATH, e.g. for testing.
40 lines
1.1 KiB
Groff
40 lines
1.1 KiB
Groff
.TH NOTMUCH-HOOKS 5 2011-12-04 "Notmuch 0.10.2"
|
|
|
|
.SH NAME
|
|
notmuch-hooks \- hooks for notmuch
|
|
|
|
.SH SYNOPSIS
|
|
$DATABASEDIR/.notmuch/hooks/*
|
|
|
|
.SH 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 have
|
|
executable permissions.
|
|
|
|
The currently available hooks are described below.
|
|
.RS 4
|
|
.TP 4
|
|
.B pre\-new
|
|
This hook is invoked by the
|
|
.B 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
|
|
.B new
|
|
command.
|
|
|
|
Typically this hook is used for fetching or delivering new mail to be imported
|
|
into the database.
|
|
.RE
|
|
.RS 4
|
|
.TP 4
|
|
.B post\-new
|
|
This hook is invoked by the
|
|
.B 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.
|
|
|
|
Typically this hook is used to perform additional query\-based tagging on the
|
|
imported messages.
|
|
.RE
|