all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Eli Zaretskii <eliz@gnu.org>
To: Noam Postavsky <npostavs@gmail.com>
Cc: 39802@debbugs.gnu.org, jidanni@jidanni.org
Subject: 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	[thread overview]
Message-ID: <83zhd2g9ac.fsf@gnu.org> (raw)
In-Reply-To: <877e079gdy.fsf@gmail.com> (message from Noam Postavsky on Fri, 28 Feb 2020 05:04:57 -0500)

> From: Noam Postavsky <npostavs@gmail.com>
> Cc: 39802@debbugs.gnu.org,  jidanni@jidanni.org
> Date: Fri, 28 Feb 2020 05:04:57 -0500
> 
> Eli Zaretskii <eliz@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.





  reply	other threads:[~2020-02-28 12:56 UTC|newest]

Thread overview: 13+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-02-26 15:48 bug#39802: (info "(emacs) Init Rebinding") needs to say it is impossible to unbind local keys 積丹尼 Dan Jacobson
2020-02-26 16:17 ` Noam Postavsky
2020-02-26 16:31   ` 積丹尼 Dan Jacobson
2020-02-26 17:04     ` Noam Postavsky
2020-02-26 23:22       ` 積丹尼 Dan Jacobson
2020-02-27 13:14         ` Noam Postavsky
2020-02-27 13:26           ` Robert Pluim
2020-02-28  7:52           ` Eli Zaretskii
2020-02-28  8:48             ` Phil Sainty
2020-02-28 12:30               ` 積丹尼 Dan Jacobson
2020-02-28 10:04             ` Noam Postavsky
2020-02-28 12:56               ` Eli Zaretskii [this message]
2020-03-04  3:13                 ` Noam Postavsky

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=83zhd2g9ac.fsf@gnu.org \
    --to=eliz@gnu.org \
    --cc=39802@debbugs.gnu.org \
    --cc=jidanni@jidanni.org \
    --cc=npostavs@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.