bug#64621: 28.2; [PATCH] Document ':all' of 'enable-local-variables' in Emacs manual

bug#64621: 28.2; [PATCH] Document ':all' of 'enable-local-variables' in Emacs manual

[YE via Bug reports for GNU Emacs, the Swiss army knife of text editors]

[-- Attachment #1: Type: text/plain, Size: 403 bytes --]

Hi,

The suggested patch documents ':all' value of 'enable-local-variables'
in the Emacs manual.

Currently, the last sentence of 'enable-local-variables' description
(the one starting with "Any other value ...") is not correct and brings
confusion.

I first doubted whether ':all' value was omitted on purpose from the
Emacs manual, but it is already mentioned in doc/emacs/misc.texi (Host
Security).


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: Document ':all' of 'enable-local-variables' in Emacs manual --]
[-- Type: text/x-patch, Size: 1392 bytes --]

From d431b2a4b7c9ecb8d87ca2c1217aa99ae120b119 Mon Sep 17 00:00:00 2001
From: YugaEgo <yet@ego.team>
Date: Fri, 14 Jul 2023 18:49:36 +0300
Subject: [PATCH] Improve doc of 'enable-local-variables' in Emacs manual

* doc/emacs/custom.texi (Safe File Variables): Document value ':all'
---
 doc/emacs/custom.texi | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi
index d8221f51425..b527af46fa7 100644
--- a/doc/emacs/custom.texi
+++ b/doc/emacs/custom.texi
@@ -1368,9 +1368,11 @@ can include remote directories as well (@pxref{Remote Files}).
 way Emacs processes local variables.  Its default value is @code{t},
 which specifies the behavior described above.  If it is @code{nil},
 Emacs simply ignores all file local variables.  @code{:safe} means use
-only the safe values and ignore the rest.  Any other value says to
-query you about each file that has local variables, without trying to
-determine whether the values are known to be safe.
+only the safe values and ignore the rest.  @code{:all} instructs Emacs
+to set all file local variables (we advise not to use it permanently).
+Any other value says to query you about each file that has local
+variables, without trying to determine whether the values are known to
+be safe.
 
 @vindex enable-local-eval
 @vindex safe-local-eval-forms
-- 
2.39.2 (Apple Git-143)

bug#64621: 28.2; [PATCH] Document ':all' of 'enable-local-variables' in Emacs manual

[Eli Zaretskii]

> Date: Fri, 14 Jul 2023 19:11:56 +0300
> From:  YE via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs@gnu.org>
> 
> The suggested patch documents ':all' value of 'enable-local-variables'
> in the Emacs manual.

Thanks, installed on the emacs-29 branch, and closing the bug.