Re: Keybinding styles

[Eli Zaretskii <eliz@gnu.org>]

> From: John Yates <john@yates-sheets.org>
> Date: Wed, 8 Sep 2021 16:37:05 -0400
> Cc: Tim Cross <theophilusx@gmail.com>, Emacs developers <emacs-devel@gnu.org>,
>  Richard Stallman <rms@gnu.org>, Stefan Monnier <monnier@iro.umontreal.ca>
> 
> On Wed, Sep 8, 2021 at 8:15 AM André A. Gomes <andremegafone@gmail.com> wrote:
> First iteration:
> * Add a new Tex markup item whose required first argument
>   would be a function name and whose optional second argument
>   would be a key sequence.
> * Makeinfo would make both data available in the generated info
>   file.  A standalone info reader would display the optional second
>   argument if present.  The emacs info reader would lookup any
>   current bindings for the function name.
> 
> Second iteration:
> * Modify makeinfo to accept a table of bindings.  In this case any
>   optional second argument would be ignored.  Instead bindings
>   for a function name would be looked up in that table and included
>   in the output.

I don't see a need to modify anything but info.el.  A table that you
want already exists: it's the Index.  We need a special-purpose index
for this: one that maps commands to keys, but Texinfo already supports
the capability of defining new types of indices.  A markup for keys
also already exists.  So all that's needed is to add a feature to
info.el to display a different set of keys given some state variable.

Of course, the printed manual will still show only the standard key
bindings, and so will the HTML-formatted manual we put on the Web
site.