From 9ca4c014c87716b8712f710cbc8bbdf1421a08fc Mon Sep 17 00:00:00 2001 From: Stefan Monnier Date: Tue, 27 Dec 2011 18:48:53 -0500 Subject: [PATCH] * variables.texi (Creating Buffer-Local): Warn against misuses of make-variable-buffer-local. Fixes: debbugs:10258 --- doc/lispref/ChangeLog | 5 +++++ doc/lispref/variables.texi | 2 ++ 2 files changed, 7 insertions(+) diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 2db274f2703..51143c27859 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,8 @@ +2011-12-27 Stefan Monnier + + * variables.texi (Creating Buffer-Local): Warn against misuses of + make-variable-buffer-local (bug#10258). + 2011-08-28 Dani Moncayo (tiny change) * lists.texi (Building Lists): Fix typo. diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi index 1c86a7eb65c..c4f091484e6 100644 --- a/doc/lispref/variables.texi +++ b/doc/lispref/variables.texi @@ -1268,6 +1268,8 @@ needed if you use the @var{local} argument to @code{add-hook} or This function marks @var{variable} (a symbol) automatically buffer-local, so that any subsequent attempt to set it will make it local to the current buffer at the time. +Contrary to @code{make-local-variable} with which it is often confused, this +cannot be undone, and affects the behavior of the variable in all buffers. A peculiar wrinkle of this feature is that binding the variable (with @code{let} or other binding constructs) does not create a buffer-local -- 2.39.5