From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: YE via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#64621: 28.2; [PATCH] Document ':all' of 'enable-local-variables' in Emacs manual Date: Fri, 14 Jul 2023 19:11:56 +0300 Message-ID: Reply-To: YE Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="32630"; mail-complaints-to="usenet@ciao.gmane.io" To: 64621@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Jul 14 18:13:28 2023 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1qKLQ7-0008Kq-3w for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 14 Jul 2023 18:13:27 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qKLPo-0000Ps-LT; Fri, 14 Jul 2023 12:13:08 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qKLPj-0000Ns-LE for bug-gnu-emacs@gnu.org; Fri, 14 Jul 2023 12:13:03 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qKLPi-00049X-G8 for bug-gnu-emacs@gnu.org; Fri, 14 Jul 2023 12:13:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qKLPi-0005vE-5q for bug-gnu-emacs@gnu.org; Fri, 14 Jul 2023 12:13:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: YE Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 14 Jul 2023 16:13:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 64621 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.168935116022733 (code B ref -1); Fri, 14 Jul 2023 16:13:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 14 Jul 2023 16:12:40 +0000 Original-Received: from localhost ([127.0.0.1]:43309 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qKLPL-0005ub-IO for submit@debbugs.gnu.org; Fri, 14 Jul 2023 12:12:39 -0400 Original-Received: from lists.gnu.org ([2001:470:142::17]:38062) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qKLPK-0005uL-CB for submit@debbugs.gnu.org; Fri, 14 Jul 2023 12:12:38 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qKLP7-0000HJ-6M for bug-gnu-emacs@gnu.org; Fri, 14 Jul 2023 12:12:26 -0400 Original-Received: from out-28.mta1.migadu.com ([2001:41d0:203:375::1c]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qKLP4-000458-CK for bug-gnu-emacs@gnu.org; Fri, 14 Jul 2023 12:12:24 -0400 X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ego.team; s=key1; t=1689351137; h=from:from:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type; bh=+l7f7vByezAinLQj08JF/BWP4jpcMyuY29HcOShJNpU=; b=E1cDDrgY+Wo0i2hNkdAFQ6/sv9p29aLakMQoH8psiKj+EL+MxxEcp3Y8MZIhHnF3jTrGBR F4eHUfBwy1phCbGOZKsYmxetKFWn1WP4pPiuh2LbO/S79wF9wErAe2s/QHoe3hn0X5OvGj ZlSh9pFQS9YUt1q047+mOVtpPXqA2/I= X-Migadu-Flow: FLOW_OUT Received-SPF: pass client-ip=2001:41d0:203:375::1c; envelope-from=yet@ego.team; helo=out-28.mta1.migadu.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-ACL-Warn: , YE Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:265108 Archived-At: --=-=-= Content-Type: text/plain 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). --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-Improve-doc-of-enable-local-variables-in-Emacs-manua.patch Content-Description: Document ':all' of 'enable-local-variables' in Emacs manual >From d431b2a4b7c9ecb8d87ca2c1217aa99ae120b119 Mon Sep 17 00:00:00 2001 From: YugaEgo 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) --=-=-=--