Re: Keybinding styles

[Eli Zaretskii <eliz@gnu.org>]

> From: Alexandre Garreau <galex-713@galex-713.eu>
> Cc: André A. Gomes <andremegafone@gmail.com>, eliz@gnu.org, theophilusx@gmail.com, monnier@iro.umontreal.ca, john@yates-sheets.org
> Date: Wed, 15 Sep 2021 23:29:24 +0200
> 
> Don’t we already have a special markup in texinfo for keybindings? 

No, we don't.  (And it's not "we" who define the Texinfo markup, it's
the Texinfo language, which is not maintained and developed by the
Emacs project.)

What is needed here is to have the _command_ invoked by a key
sequence, rather than the key sequence itself, be mentioned in Texinfo
and propagated to Info with some markup there, so that info.el could
replace the command name by the actual key binding.  Something like
the \\[..] markup we have for doc strings.

> otherwise we ought to: we control texinfo (essentially used for emacs and 
> some other popular gnu stuff (since it’s used by gnu stuff)), and the main 
> implementation already is emacs.

That's not true.  First, the Texinfo language is not controlled by the
Emacs project, it's developed and maintained by a sibling GNU
project.  And second, there are actively developed Info readers that
are not in Emacs: the trivial example is the stand-alone reader that
is part of the Texinfo project.

We cannot make unilateral changes in this area.

> We could add some markup to contextualize the origin of keybindings (for 
> instance what mode/software the current section is talking about)

I don't think I understand the details of this proposal, but in any
case, many sections in the manual do not talk about a single major
mode.