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

of kill-all-local-variables on local hook functions.
This commit is contained in:
Eli Zaretskii 2008-10-15 11:49:10 +00:00
parent 7cb7097441
commit ee666f8409
3 changed files with 9 additions and 2 deletions

View file

@ -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

View file

@ -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

View file

@ -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.