From 3fdd8b9aa962853c8ed49ebdfc1bb1c0f666af97 Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Wed, 15 Feb 2006 04:38:45 +0000 Subject: [PATCH] (File Local Variables): Clarifications. --- lispref/variables.texi | 23 +++++++++++------------ 1 file changed, 11 insertions(+), 12 deletions(-) diff --git a/lispref/variables.texi b/lispref/variables.texi index c3fe6cf6a23..f3e81c3ddd3 100644 --- a/lispref/variables.texi +++ b/lispref/variables.texi @@ -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 -- 2.39.2