]> git.eshelyaron.com Git - emacs.git/commitdiff
(Hooks): Most minor modes run mode hooks too.
authorLuc Teirlinck <teirllm@auburn.edu>
Sat, 14 May 2005 15:25:38 +0000 (15:25 +0000)
committerLuc Teirlinck <teirllm@auburn.edu>
Sat, 14 May 2005 15:25:38 +0000 (15:25 +0000)
`add-hook' can handle void hooks or hooks whose value is a single function.

lispref/modes.texi

index c3247b4ca578e92e519e8ce71f27a9e2338bcbc1..47d9ded13461eb857a7868b1a99897261b238c93 100644 (file)
@@ -2836,10 +2836,10 @@ a uniform way.
   Every major mode function is supposed to run a normal hook called the
 @dfn{mode hook} as the last step of initialization.  This makes it easy
 for a user to customize the behavior of the mode, by overriding the
-buffer-local variable assignments already made by the mode.  But hooks
-are used in other contexts too.  For example, the hook
-@code{suspend-hook} runs just before Emacs suspends itself
-(@pxref{Suspending Emacs}).
+buffer-local variable assignments already made by the mode.  Most
+minor modes also run a mode hook at their end.  But hooks are used in
+other contexts too.  For example, the hook @code{suspend-hook} runs
+just before Emacs suspends itself (@pxref{Suspending Emacs}).
 
   The recommended way to add a hook function to a normal hook is by
 calling @code{add-hook} (see below).  The hook functions may be any of
@@ -2937,6 +2937,10 @@ executed first (barring another @code{add-hook} call).  If the optional
 argument @var{append} is non-@code{nil}, the new hook function goes at
 the end of the hook list and will be executed last.
 
+@code{add-hook} can handle the cases where @var{hook} is void or its
+value is a single function; it sets or changes the value to a list of
+functions.
+
 If @var{local} is non-@code{nil}, that says to add @var{function} to
 the buffer-local hook list instead of to the global hook list.  If
 needed, this makes the hook buffer-local and adds @code{t} to the