procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

; * doc/lispref/modes.texi (Hooks): Clarify wording. (Bug#34588)

Browse source
This commit is contained in:
Eli Zaretskii 2021-10-24 09:44:18 +03:00
parent e154fd9119
commit 9a50f760e9
1 changed files with 7 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
doc/lispref/modes.texi
View file

@ -59,12 +59,13 @@ runs just before Emacs suspends itself (@pxref{Suspending Emacs}).
@cindex abnormal hook
If the hook variable's name does not end with @samp{-hook}, that
indicates it is probably an @dfn{abnormal hook}. That means one of
two things: either that the hook functions are called with arguments,
or that their return values are used in some way. The hook's
documentation says how the functions are called. Any functions added
to an abnormal hook must follow the hook's calling convention. By
convention, abnormal hook names end in @samp{-functions}.
indicates it is probably an @dfn{abnormal hook}. These differ from
normal hooks in two ways: they can be called with one or more
arguments, and their return values can be used in some way. The
hook's documentation says how the functions are called and how their
return values are used. Any functions added to an abnormal hook must
follow the hook's calling convention. By convention, abnormal hook
names end in @samp{-functions}.
@cindex single-function hook
If the name of the variable ends in @samp{-predicate} or