all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: "Drew Adams" <drew.adams@oracle.com>
To: "'Per Starbäck'" <per@starback.se>
Cc: 'Stefan Monnier' <monnier@iro.umontreal.ca>, emacs-devel@gnu.org
Subject: RE: where-is only mentions first key in interval
Date: Mon, 13 Feb 2012 09:06:14 -0800	[thread overview]
Message-ID: <49A85CD56ECA46168F6E71E9E7DD3144@us.oracle.com> (raw)
In-Reply-To: <CADkQgvvfCpS15NRJkGMV+BSJJi7qWnt4GQ4SON4cBwm5Q65+Wg@mail.gmail.com>

> > Per Emacs key notation, `e..f' means only one thing: the 
> > sequence of four keystrokes `e', `.', `.', and `f'.
> 
> But that is written 'e . . f' of course!

Well, yes (`e . . f', not 'e . . f').

But in the `where-is' output there are no `' wrappers: spaces are generally used
to separate keys.  That too is a problem (to be fixed, IMO): Sometimes a space
separates key sequences, sometimes it does not: "C-x C-f", for example.

But given the use of spaces here to separate keys, a user might very easily
think (wrongly) that e..f represents a single key sequence.

And if you tried to introduce spaces to separate those keys, like "e .. f", that
falsely communicates three key bindings: `e', `..', and `f'.  And it does not in
any way communicate the fact that `..' means "and everything between".

And even the notion of "everything between" is not so clear in this context.
This is not obviously a list of bindings ordered by character code.  A user
might be able to guess "e..f" here, but "SPC..~" would perhaps not be so clear.
And there is nothing in the doc of `where-is' or even `where-is-internal' that
describes the order used in the key-sequence output (another problem to be
fixed, IMO).

Obviously, just "e f" would be OK here.  It was what was used prior to Emacs 23.
Returning to that would fix the regression, even if it wouldn't make `C-h w'
output crystal clear.

> Emacs already uses ".." for intervals at least for
> describe-bindings, but with spaces, like:
> 
> SPC .. ~	self-insert-command

Completely different context.  (And there too, things could be improved, IMO, by
providing a better column header or a legend that says what `..' represents.
And state what order is used for the table rows.)

If we cannot immediately improve the `where-is' output then we should at least
restore the behavior prior to this regression, i.e., prior to Emacs 23.
 




      reply	other threads:[~2012-02-13 17:06 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-02-13 15:19 where-is only mentions first key in interval Per Starbäck
2012-02-13 16:00 ` Stefan Monnier
2012-02-13 16:15   ` Drew Adams
2012-02-13 16:28     ` Per Starbäck
2012-02-13 17:06       ` Drew Adams [this message]

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=49A85CD56ECA46168F6E71E9E7DD3144@us.oracle.com \
    --to=drew.adams@oracle.com \
    --cc=emacs-devel@gnu.org \
    --cc=monnier@iro.umontreal.ca \
    --cc=per@starback.se \
    /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.