[Emacs-diffs] /srv/bzr/emacs/emacs-23 r100629: * variables.texi (Creating Buffer-Local): Warn against misuses of

[Stefan Monnier]

------------------------------------------------------------
revno: 100629
fixes bug(s): http://debbugs.gnu.org/cgi/bugreport.cgi?bug=10258
committer: Stefan Monnier <address@hidden>
branch nick: emacs-23
timestamp: Tue 2011-12-27 18:48:53 -0500
message:
  * variables.texi (Creating Buffer-Local): Warn against misuses of
  make-variable-buffer-local.
modified:
  doc/lispref/ChangeLog
  doc/lispref/variables.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2011-08-28 19:08:45 +0000
+++ b/doc/lispref/ChangeLog     2011-12-27 23:48:53 +0000
@@ -1,3 +1,8 @@
+2011-12-27  Stefan Monnier  <address@hidden>
+
+       * variables.texi (Creating Buffer-Local): Warn against misuses of
+       make-variable-buffer-local (bug#10258).
+
 2011-08-28  Dani Moncayo  <address@hidden>  (tiny change)
 
        * lists.texi (Building Lists): Fix typo.

=== modified file 'doc/lispref/variables.texi'
--- a/doc/lispref/variables.texi        2011-02-25 07:59:40 +0000
+++ b/doc/lispref/variables.texi        2011-12-27 23:48:53 +0000
@@ -1268,6 +1268,8 @@
 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