diff options
Diffstat (limited to 'doc/lispref/variables.texi')
-rw-r--r-- | doc/lispref/variables.texi | 33 |
1 files changed, 31 insertions, 2 deletions
diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi index 63438170d1a..9356fb9f699 100644 --- a/doc/lispref/variables.texi +++ b/doc/lispref/variables.texi @@ -1010,6 +1010,9 @@ a dynamic local binding, Emacs records the contents of the value cell value cell. When the binding construct finishes executing, Emacs pops the old value off the stack, and puts it in the value cell. + Note that when code using Dynamic Binding is native compiled the +native compiler will not perform any Lisp specific optimization. + @node Dynamic Binding Tips @subsection Proper Use of Dynamic Binding @@ -1579,6 +1582,12 @@ buffer-local binding in buffer @var{buffer}, it returns the default value (@pxref{Default Value}) of @var{variable} instead. @end defun +@defun buffer-local-boundp variable buffer +This returns non-@code{nil} if there's either a buffer-local binding +of @var{variable} (a symbol) in buffer @var{buffer}, or @var{variable} +has a global binding. +@end defun + @defun buffer-local-variables &optional buffer This function returns a list describing the buffer-local variables in buffer @var{buffer}. (If @var{buffer} is omitted, the current buffer @@ -1696,7 +1705,6 @@ buffer has a buffer-local binding. For example, you could use you are in a C or Lisp mode buffer that has a buffer-local value for this variable. -@c Emacs 19 feature The special forms @code{defvar} and @code{defconst} also set the default value (if they set the variable at all), rather than any buffer-local value. @@ -1708,7 +1716,6 @@ this variable. If @var{symbol} is not buffer-local, this is equivalent to @code{symbol-value} (@pxref{Accessing Variables}). @end defun -@c Emacs 19 feature @defun default-boundp symbol The function @code{default-boundp} tells you whether @var{symbol}'s default value is nonvoid. If @code{(default-boundp 'foo)} returns @@ -1884,6 +1891,14 @@ any form of file-local variable. For examples of why you might want to use this, @pxref{Auto Major Mode}. @end defvar +@defvar permanently-enabled-local-variables +Some local variable settings will, by default, be heeded even if +@code{enable-local-variables} is @code{nil}. By default, this is only +the case for the @code{lexical-binding} local variable setting, but +this can be controlled by using this variable, which is a list of +symbols. +@end defvar + @defun hack-local-variables &optional handle-mode This function parses, and binds or evaluates as appropriate, any local variables specified by the contents of the current buffer. The variable @@ -1980,6 +1995,20 @@ Doing so adds those variable/value pairs to file. @end defopt +@defopt ignored-local-variable-values +If there are some values of particular local variables that you always +want to ignore completely, you can use this variable. Its value has +the same form as @code{safe-local-variable-values}; a file-local +variable setting to the value that appears in the list will always be +ignored when processing the local variables specified by the file. As +with that variable, when Emacs queries the user about whether to obey +file-local variables, the user can choose to ignore their particular +values permanently, and that will alter this variable and save it to +the user's custom file. Variable-value pairs that appear in this +variable take precedence over the same pairs in +@code{safe-local-variable-values}. +@end defopt + @defun safe-local-variable-p sym val This function returns non-@code{nil} if it is safe to give @var{sym} the value @var{val}, based on the above criteria. |