changeset 8928:0ea4cc4ca339

(add-hook): Doc fix.
author Richard M. Stallman <rms@gnu.org>
date Tue, 20 Sep 1994 00:59:24 +0000
parents 4477436f8ba5
children d7dc9a5b8c70
files lisp/subr.el
diffstat 1 files changed, 9 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/lisp/subr.el	Tue Sep 20 00:26:25 1994 +0000
+++ b/lisp/subr.el	Tue Sep 20 00:59:24 1994 +0000
@@ -551,7 +551,15 @@
 
 HOOK should be a symbol, and FUNCTION may be any valid function.  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, it is changed to a list of functions.
+
+Note: if you make a hook variable buffer-local, copy its value before
+you use `add-hook' to add to it.  For example,
+
+  (make-local-variable 'foo-hook)
+  (if (boundp 'foo-hook)
+      (setq foo-hook (copy-sequence foo-hook)))
+  (add-hook 'foo-hook 'my-foo-function)"
   (or (boundp hook) (set hook nil))
   ;; If the hook value is a single function, turn it into a list.
   (let ((old (symbol-value hook)))