GNU bug report logs - #39802
(info "(emacs) Init Rebinding") doesn't explain how to unbind local keys

Previous Next

Full log

Message #42 received at 39802 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Noam Postavsky <npostavs <at> gmail.com>
Cc: 39802 <at> debbugs.gnu.org, jidanni <at> jidanni.org
Subject: Re: bug#39802: (info "(emacs) Init Rebinding") needs to say it is
 impossible to unbind local keys
Date: Fri, 28 Feb 2020 14:56:27 +0200

> From: Noam Postavsky <npostavs <at> gmail.com>
> Cc: 39802 <at> debbugs.gnu.org,  jidanni <at> jidanni.org
> Date: Fri, 28 Feb 2020 05:04:57 -0500
> 
> Eli Zaretskii <eliz <at> gnu.org> writes:
> 
> >>    As described in @ref{Local Keymaps}, major modes and minor modes can
> >> -define local keymaps.  These keymaps are constructed when the mode is
> >> -used for the first time in a session.
> 
> > This loses useful information in the sentence that starts with "These
> > keymaps".
> 
> I moved that information to the next paragraph:
>  
>     +  Since a mode's keymaps are not constructed until it has been loaded,

I saw it, but that "Since" strikes me as "a bolt out of the blue",
because no text before that explained or mentioned this fact.  Leaving
that sentence in place will then go a long way towards making the
"Since" part crystal clear.

IOW, in this and similar cases, repetition facilitates understanding,
and should not be avoided, because we are dealing with something that
won't necessarily be evident to the reader.

> (I think "until it has been loaded" is more accurate than "used for the
> first time", since the file can be loaded without actually using the
> mode defined within.)

I'm okay with rephrasing the original sentence along these lines.  But
I think we should not remove it entirely.  (Obviously, this is a minor
point.)

Thanks.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.