* bug#45864: 27.1; hack-local-variables-hook is not documented in Emacs Manual
@ 2021-01-14 15:43 Howard Melman
2021-01-19 6:22 ` Lars Ingebrigtsen
0 siblings, 1 reply; 4+ messages in thread
From: Howard Melman @ 2021-01-14 15:43 UTC (permalink / raw)
To: 45864
I've been frustrated with a few packages that set
outline-regexp as a file local variable in a way I don't
prefer. Since this is set after my major-mode hook is run I
didn't think I had a way to override these. The Emacs
manual only describes how to affect this with the variable
enable-local-variables which isn't granular enough to fix
this.
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.
In GNU Emacs 27.1 (build 1, x86_64-apple-darwin19.5.0, Carbon Version 162 AppKit 1894.5)
of 2020-11-14 built on Traviss-Mac.local
Repository revision: 443027ae4946e227b8eb7754751eea62ab7f3386
Repository branch: HEAD
Windowing system distributor 'Apple Inc.', version 10.15.7
System Description: Mac OS X 10.15.7
--
Howard
^ permalink raw reply [flat|nested] 4+ messages in thread
* bug#45864: 27.1; hack-local-variables-hook is not documented in Emacs Manual
2021-01-14 15:43 bug#45864: 27.1; hack-local-variables-hook is not documented in Emacs Manual Howard Melman
@ 2021-01-19 6:22 ` Lars Ingebrigtsen
[not found] ` <A6C93D80-90E0-4F4C-96AD-33953BE52EEE@gmail.com>
0 siblings, 1 reply; 4+ messages in thread
From: Lars Ingebrigtsen @ 2021-01-19 6:22 UTC (permalink / raw)
To: Howard Melman; +Cc: 45864
Howard Melman <hmelman@gmail.com> 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
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2021-01-19 15:47 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-01-14 15:43 bug#45864: 27.1; hack-local-variables-hook is not documented in Emacs Manual Howard Melman
2021-01-19 6:22 ` Lars Ingebrigtsen
[not found] ` <A6C93D80-90E0-4F4C-96AD-33953BE52EEE@gmail.com>
2021-01-19 13:19 ` Howard Melman
2021-01-19 15:47 ` Lars Ingebrigtsen
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).