+2011-12-27 Stefan Monnier <monnier@iro.umontreal.ca>
+
+ * variables.texi (Creating Buffer-Local): Warn against misuses of
+ make-variable-buffer-local (bug#10258).
+
2012-01-07 Lars Magne Ingebrigtsen <larsi@gnus.org>
* macros.texi (Defining Macros): Document `doc-string' (bug#9668).
@deffn Command make-variable-buffer-local variable
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.
+local to the current buffer at the time. Unlike
+@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