[Emacs-diffs] trunk r115211: * src/data.c (Fmake_variable_buffer_local): Mention `permanent-local'.

[Stefan Monnier]

------------------------------------------------------------
revno: 115211
revision-id: address@hidden
parent: address@hidden
committer: Stefan Monnier <address@hidden>
branch nick: trunk
timestamp: Sun 2013-11-24 13:20:18 -0500
message:
  * src/data.c (Fmake_variable_buffer_local): Mention `permanent-local'.
modified:
  src/ChangeLog                  changelog-20091113204419-o5vbwnq5f7feedwu-1438
  src/data.c                     data.c-20091113204419-o5vbwnq5f7feedwu-251

=== modified file 'src/ChangeLog'
--- a/src/ChangeLog     2013-11-23 11:32:05 +0000
+++ b/src/ChangeLog     2013-11-24 18:20:18 +0000
@@ -1,3 +1,7 @@
+2013-11-24  Stefan Monnier  <address@hidden>
+
+       * data.c (Fmake_variable_buffer_local): Mention `permanent-local'.
+
 2013-11-23  Romain Francoise  <address@hidden>
 
        * fileio.c (init_fileio): Move `write_region_inhibit_fsync'

=== modified file 'src/data.c'
--- a/src/data.c        2013-11-21 06:46:59 +0000
+++ b/src/data.c        2013-11-24 18:20:18 +0000
@@ -1551,8 +1551,12 @@
 a `let'-style binding made in this buffer is in effect,
 does not make the variable buffer-local.  Return VARIABLE.
 
-In most cases it is better to use `make-local-variable',
-which makes a variable local in just one buffer.
+This globally affects all uses of this variable, so it belongs together with
+the variable declaration, rather than with its uses (if you just want to make
+a variable local to the current buffer for one particular use, use
+`make-local-variable').  Buffer-local bindings are normally cleared
+while setting up a new major mode, unless they have a `permanent-local'
+property.
 
 The function `default-value' gets the default value and `set-default' sets it. 
 */)
   (register Lisp_Object variable)