(Creating Buffer-Local): Add an xref to "Setting Hooks" for the effect

of kill-all-local-variables on local hook functions.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index d00f0cb06a88f6ee166529f60338049422a8447e..e12c210061e7874108260b63f47a8b781866d3a1 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,5 +1,9 @@
 2008-10-15  Eli Zaretskii  <eliz@gnu.org>
 
+       * variables.texi (Creating Buffer-Local): Add an xref to "Setting
+       Hooks" for the effect of kill-all-local-variables on local hook
+       functions.
+
        * modes.texi (Major Mode Conventions, Mode Line Variables):
        `mode-name' need not be a string.  xref to "Mode Line Data" for
        details, and to "Emulating Mode Line" for computing a string

diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi
index 55422b7508d9cd622a2fd85b270c8c42dea83711..b02bdd8a9fe762f31b7045d95a1adf1ef18c1954 100644 (file)
--- a/doc/lispref/variables.texi
+++ b/doc/lispref/variables.texi
@@ -1361,8 +1361,10 @@ buffer-local variables interactively.
 
 @defun kill-all-local-variables
 This function eliminates all the buffer-local variable bindings of the
-current buffer except for variables marked as ``permanent.''  As a
-result, the buffer will see the default values of most variables.
+current buffer except for variables marked as ``permanent'' and local
+hook functions that have a non-@code{nil} @code{permanent-local-hook}
+property (@pxref{Setting Hooks}).  As a result, the buffer will see
+the default values of most variables.
 
 This function also resets certain other information pertaining to the
 buffer: it sets the local keymap to @code{nil}, the syntax table to the

diff --git a/etc/NEWS b/etc/NEWS
index 20ea28eaf20a8d79f8366e9eb5b3de7ecc85690c..a11cf88f40db97c058c4290d3226ee967dd76187 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1113,6 +1113,7 @@ don't, these primitives will return nil.
 ** New variable `user-emacs-directory'.
 Use this instead of "~/.emacs.d".
 
++++
 ** If a local hook function has a non-nil `permanent-local-hook'
 property, `kill-all-local-variables' does not remove it from the local
 value of the hook variable; it remains even if you change major modes.