From: Stefan Monnier Date: Sun, 24 Nov 2013 18:20:18 +0000 (-0500) Subject: * src/data.c (Fmake_variable_buffer_local): Mention `permanent-local'. X-Git-Tag: emacs-24.3.90~173^2^2~42^2~45^2~387^2~720 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=450533b07a9adf8a1d19d3ce7142f946f04e76ac;p=emacs.git * src/data.c (Fmake_variable_buffer_local): Mention `permanent-local'. --- diff --git a/src/ChangeLog b/src/ChangeLog index d17f320516c..c3062d0fc0a 100644 --- a/src/ChangeLog +++ b/src/ChangeLog @@ -1,3 +1,7 @@ +2013-11-24 Stefan Monnier + + * data.c (Fmake_variable_buffer_local): Mention `permanent-local'. + 2013-11-23 Romain Francoise * fileio.c (init_fileio): Move `write_region_inhibit_fsync' diff --git a/src/data.c b/src/data.c index bdd56bf0f62..ca896897ddf 100644 --- a/src/data.c +++ b/src/data.c @@ -1551,8 +1551,12 @@ Note that binding the variable with `let', or setting it while 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)