# HG changeset patch # User Lute Kamstra # Date 1117099935 0 # Node ID d66d7efe0adf8d054bd7afb9694a3a64a89472e2 # Parent 23e016b887bbb3a9d2f0acb53af80e8c37391b52 (Frun_hooks): Mention run-mode-hooks in docstring. diff -r 23e016b887bb -r d66d7efe0adf src/eval.c --- a/src/eval.c Wed May 25 22:46:48 2005 +0000 +++ b/src/eval.c Thu May 26 09:32:15 2005 +0000 @@ -2292,7 +2292,7 @@ enum run_hooks_condition)); DEFUN ("run-hooks", Frun_hooks, Srun_hooks, 0, MANY, 0, - doc: /* Run each hook in HOOKS. Major mode functions use this. + doc: /* Run each hook in HOOKS. Each argument should be a symbol, a hook variable. These symbols are processed in the order specified. If a hook symbol has a non-nil value, that value may be a function @@ -2300,6 +2300,9 @@ If the value is a function, it is called with no arguments. If it is a list, the elements are called, in order, with no arguments. +Major modes should not use this function directly to run their mode +hook; they should use `run-mode-hooks' instead. + Do not use `make-local-variable' to make a hook variable buffer-local. Instead, use `add-hook' and specify t for the LOCAL argument. usage: (run-hooks &rest HOOKS) */)