From 9a50f760e94d4676f2fa643939cdc3561577a1b9 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sun, 24 Oct 2021 09:44:18 +0300 Subject: [PATCH] ; * doc/lispref/modes.texi (Hooks): Clarify wording. (Bug#34588) --- doc/lispref/modes.texi | 13 +++++++------ 1 file 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 -- 2.39.2