From 1352b184f3f7bd1e31ee71ee4b60491dacaf347b Mon Sep 17 00:00:00 2001 From: Tomas Nordin Date: Thu, 27 Feb 2025 22:06:25 +0100 Subject: Improve docstring of add-hook and remove-hook * lisp/subr.el (add-hook, remove-hook): Remove detail about setting to nil and talk about functions instead of hooks. (Bug#72915) --- lisp/subr.el | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) (limited to 'lisp/subr.el') diff --git a/lisp/subr.el b/lisp/subr.el index 0394a333b44..dfd91825363 100644 --- a/lisp/subr.el +++ b/lisp/subr.el @@ -2090,6 +2090,9 @@ instead; it will indirectly limit the specpdl stack size as well.") "Add to the value of HOOK the function FUNCTION. FUNCTION is not added if already present. +HOOK should be a symbol. If HOOK is void, or if HOOK's value is a +single function, it is changed to a list of functions. + The place where the function is added depends on the DEPTH parameter. DEPTH defaults to 0. By convention, it should be a number between -100 and 100 where 100 means that the function @@ -2108,10 +2111,6 @@ This makes the hook buffer-local, and it makes t a member of the buffer-local value. That acts as a flag to run the hook functions of the global value as well as in the local value. -HOOK should be a symbol. If HOOK is void, it is first set to -nil. If HOOK's value is a single function, it is changed to a -list of functions. - FUNCTION may be any valid function, but it's recommended to use a function symbol and not a lambda form. Using a symbol will ensure that the function is not re-added if the function is @@ -2176,10 +2175,11 @@ performance impact when running `add-hook' and `remove-hook'." (set-default hook hook-value)))) (defun remove-hook (hook function &optional local) - "Remove from the value of HOOK the function FUNCTION. -HOOK should be a symbol, and FUNCTION may be any valid function. If -FUNCTION isn't the value of HOOK, or, if FUNCTION doesn't appear in the -list of hooks to run in HOOK, then nothing is done. See `add-hook'. + "Remove FUNCTION from HOOK's functions. +HOOK should be a symbol, and FUNCTION may be any valid function. +Do nothing if HOOK does not currently contain FUNCTION. +Compare functions with `equal`, which means that it can be +slow if FUNCTION is not a symbol. See `add-hook'. The optional third argument, LOCAL, if non-nil, says to modify the hook's buffer-local value rather than its default value. -- cgit v1.2.3