Improve documentation of permanent local variables.

 variables.texi (Creating Buffer-Local): Explain the meaning of
 permanent local variables.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 664464acda2ca3854acd181bbdc5a44ff423f78b..1d95eaf678cd8264db7367df60506d5146f2a735 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2011-02-18  Eli Zaretskii  <eliz@gnu.org>
+
+       * variables.texi (Creating Buffer-Local): Explain the meaning of
+       permanent local variables.
+
 2011-02-18  Glenn Morris  <rgm@gnu.org>
 
        * keymaps.texi (Remapping Commands): Mention how to undo it.

diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi
index 2baf3895822a219802708b54bf869c70568198ca..18343b4dc856a8194a3563553161acec415c5110 100644 (file)
--- a/doc/lispref/variables.texi
+++ b/doc/lispref/variables.texi
@@ -1409,6 +1409,8 @@ subsequent major mode.  @xref{Hooks}.
 @cindex permanent local variable
 A buffer-local variable is @dfn{permanent} if the variable name (a
 symbol) has a @code{permanent-local} property that is non-@code{nil}.
+Such variables are unaffected by @code{kill-all-local-variables}, and
+their local bindings are therefore not cleared by changing major modes.
 Permanent locals are appropriate for data pertaining to where the file
 came from or how to save it, rather than with how to edit the contents.