Re: Reducing mouse-dependency In Emacs.

[Luc Teirlinck]

Stefan Monnier wrote:

   Reminds me of the suggestion I had a while ago to make such help
   partly automatic (at least when a `local-map' or `keymap' property
   is present, but maybe also when a `mouse-face' is present).

   Having it automatic saves work from the coder, but also allows the help
   text to be different in the `point-over' than in the `mouse-over' case.

I was not a part of that discussion and hence am unfamiliar with the
arguments pro and con.

Eli Zaretskii wrote:

   I think there should be another binding for the same command that
   doesn't use the mouse, and the help echo should print that binding
   when this option is set (since it's obvious the mouse is not used).

There are two problems here.

1. In the dired case, which is rather typical, the problem with
"mouse-2: visit this file in other window" is not just that it
mentions mouse-2 instead of `o', but also that it singles out this
particular command for documentation.  The reason for that is that it
is bound to a mouse command and that the user has the mouse in hand
and hence the author knows that he wants to use a mouse command.
Plenty of help-echo's are in this category.  There is no need to
access these from the keyboard.
2. It seems that your suggestion would require plenty of work
rewriting `help-echo' properties.

If we are going to provide automatic display, I believe we should be
conservative in what we show.  It should really be relevant, since,
especially in spoken version, it is distracting.

I would propose to only show `short-help' on point-over, or at least
provide an option to only show that one.  Maybe `short-help' for
`keymap' and `local-map' properties could be generated automatically
(but overridden by an explicit `short-help' property).  If not, we
could show `help-echo' on point-over, *if* one of those properties is
present, because in that case `help-echo' is very likely to be
relevant.  We could use the convention that a value of t for
`short-help' would mean to show `help-echo' on point-over.  So we
would have three types of `short-help': automatically generated, `t'
to indicate that the `help-echo' property is really relevant to the
keyboard user and explicitly provided strings.

In the beginning most `short-help' properties might be of the first
type, but that could change quickly.  In the meantime, `help-echo' is
available when explicitly asked for, or maybe as an option for
automatic display, for users who do not mind about irrelevant info
showing up in the echo area.

Sincerely,

Luc.