From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#45864: 27.1; hack-local-variables-hook is not documented in Emacs Manual Date: Tue, 19 Jan 2021 07:22:55 +0100 Message-ID: <875z3to37k.fsf@gnus.org> References: <62F9C4EE-B85D-4348-BAF1-3358CF49193C@gmail.com> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="24787"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Cc: 45864@debbugs.gnu.org To: Howard Melman Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Jan 19 07:47:13 2021 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 1l1knJ-0006Jp-M5 for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 19 Jan 2021 07:47:13 +0100 Original-Received: from localhost ([::1]:57802 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1l1knI-00009G-KE for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 19 Jan 2021 01:47:12 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:39112) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1l1kQs-0001UA-GX for bug-gnu-emacs@gnu.org; Tue, 19 Jan 2021 01:24:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:37627) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1l1kQs-0000cL-5t for bug-gnu-emacs@gnu.org; Tue, 19 Jan 2021 01:24:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1l1kQs-0003cn-10 for bug-gnu-emacs@gnu.org; Tue, 19 Jan 2021 01:24:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 19 Jan 2021 06:24:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 45864 X-GNU-PR-Package: emacs Original-Received: via spool by 45864-submit@debbugs.gnu.org id=B45864.161103738713852 (code B ref 45864); Tue, 19 Jan 2021 06:24:01 +0000 Original-Received: (at 45864) by debbugs.gnu.org; 19 Jan 2021 06:23:07 +0000 Original-Received: from localhost ([127.0.0.1]:49170 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1l1kPy-0003bM-W1 for submit@debbugs.gnu.org; Tue, 19 Jan 2021 01:23:07 -0500 Original-Received: from quimby.gnus.org ([95.216.78.240]:55230) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1l1kPx-0003aa-Cu for 45864@debbugs.gnu.org; Tue, 19 Jan 2021 01:23:05 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=x/1B6TfRwcAg4JGVOSWj5/vKUTjpNz6xp1BS+RwbL5s=; b=SME4fT2qhF92MtypgnQsoIMnIF VLqHOe/lKQcho0BOXBIawoJL+/tZwkjkLVosmnAd9qr5qf0YEFhs2RTcEry0lzTPn+OadX3g+1ZHG +HGMWAM8PDaxFBc8GtOPiryvGtUWEBqyFOs8iRgHIu/IG/ZyHiUAu1nFb65OSVB39YWg=; Original-Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1l1kPo-0004MY-US; Tue, 19 Jan 2021 07:22:59 +0100 X-Now-Playing: Sylvester's _For Discos Only (2)_: "Dance (Disco Heat)(Special 12inch Disco Mix)" In-Reply-To: <62F9C4EE-B85D-4348-BAF1-3358CF49193C@gmail.com> (Howard Melman's message of "Thu, 14 Jan 2021 10:43:48 -0500") 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: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:198132 Archived-At: Howard Melman writes: > Today I learned about the hack-local-variables-hook which > allows me to correct these. I'm surprised that it and > before-hack-local-variables-hook are not documented in the > Emacs Manual but are only mentioned in the Elisp Reference > Manual. Unless I'm misunderstanding something they're meant > for users and not just for elisp programmers so they should > be in the Emacs Manual. The doc string of the former variable says: ---- Major modes can use this to examine user-specified local variables in order to initialize other data structure based on them. ---- So they are meant for people implementing major modes, which is why they're in the lispref manual, and not the Emacs manual. (Users can use them, too, but that's not really their purpose.) So I think it makes sense to keep the documentation as is, and I'm closing this bug report. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no