[pacman-dev] [PATCH] alpm-hooks.5: include more information on hook files

[Jouke Witteveen]

---
This is a follow-up to my hook sorting patch.

The information added is also available in pacman.conf(5), and in pacman(8), but
this looks like a good place to repeat it.
 doc/alpm-hooks.5.asciidoc | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/doc/alpm-hooks.5.asciidoc b/doc/alpm-hooks.5.asciidoc
index 1d19f96e..cf8d2710 100644
--- a/doc/alpm-hooks.5.asciidoc
+++ b/doc/alpm-hooks.5.asciidoc
@@ -30,9 +30,14 @@ DESCRIPTION
 libalpm provides the ability to specify hooks to run before or after
 transactions based on the packages and/or files being modified.  Hooks consist
 of a single '[Action]' section describing the action to be run and one or more
-'[Trigger]' section describing which transactions it should be run for. Hook
-file names are required to have the suffix ".hook".  Hooks are run in
-alphabetical order of their file name.
+'[Trigger]' section describing which transactions it should be run for.
+
+Hooks are read from files located in the system hook directory
++{datarootdir}/libalpm/hooks+, and additional custom directories.  Additional
+directories are specified linkman:pacman.conf[5].  The default
+additional directory is +{sysconfdir}/pacman.d/hooks+.  Hook file names are
+required to have the suffix ".hook".  Hooks are run in alphabetical order of
+their file name, where the ordering ignores the suffix.
 
 TRIGGERS
 --------
-- 
2.17.1