summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2021-10-24 09:44:18 +0300
committerEli Zaretskii <eliz@gnu.org>2021-10-24 09:44:18 +0300
commit9a50f760e94d4676f2fa643939cdc3561577a1b9 (patch)
tree3e5e5bc173069b0dc5a23c6177dd8c2b0647f436 /doc
parente154fd9119dc36dd1249ea9e372bcf8b3cae8546 (diff)
downloademacs-9a50f760e94d4676f2fa643939cdc3561577a1b9.tar.gz
; * doc/lispref/modes.texi (Hooks): Clarify wording. (Bug#34588)
Diffstat (limited to 'doc')
-rw-r--r--doc/lispref/modes.texi13
1 files changed, 7 insertions, 6 deletions
diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index ed0c535867f..5df3a74e780 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -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