procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

(File Local Variables): Clarifications.

Browse source
This commit is contained in:
Richard M. Stallman 2006-02-15 04:38:45 +00:00
parent 2b2ea6dbc5
commit 3fdd8b9aa9
1 changed files with 11 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
lispref/variables.texi
View file

@ -1777,14 +1777,12 @@ visiting a file could take over your Emacs. Emacs takes several
measures to prevent this.
@cindex safe local variable
A variable can be marked as @dfn{safe} by setting its
You can specify safe values for a variable with a
@code{safe-local-variable} property. If the property is @code{t},
setting that variable in a file is always considered safe, regardless
of the value assigned to it. The @code{safe-local-variable} property
can also be a function of one argument. In that case, Emacs considers
it safe to give the variable a certain value if the function returns
non-@code{nil} when given that value as argument. Many
commonly-encountered file variables standardly have
of the value used. If the property is a function of one argument,
then any value is safe if the function returns non-@code{nil} given
that value. Many commonly encountered file variables standardly have
@code{safe-local-variable} properties, including @code{fill-column},
@code{fill-prefix}, and @code{indent-tabs-mode}.
@ -1794,10 +1792,11 @@ safe. It is a list of cons cells @code{(@var{var} . @var{val})},
where @var{var} is a variable name and @var{val} is a value which is
safe for that variable.
When Emacs asks the user whether or not to obey a set of file variable
specifications, the user can choose to mark them as safe. Doing so
adds those variable-value pairs to @code{safe-local-variable-values},
and saves it to the user's custom file.
When Emacs asks the user whether or not to obey a set of file local
variable specifications, the user can choose to mark them as safe.
Doing so adds those variable/value pairs to
@code{safe-local-variable-values}, and saves it to the user's custom
file.
@end defopt
@defun safe-local-variable-p sym val
@ -1825,8 +1824,8 @@ based on the above criteria.
If a variable is risky, it will not be entered automatically into
@code{safe-local-variable-values} as described above. Therefore,
Emacs will always query before setting a risky variable, unless the
user explicitly allows it by editing @code{safe-local-variable-values}
via Customize.
user explicitly allows the setting by customizing
@code{safe-local-variable-values} directly.
@defvar ignored-local-variables
This variable holds a list of variables that should not be given local