Re: When should we put @key inside @kbd?

[Michael Albinus]

Eli Zaretskii <address@hidden> writes:

>> "@code{esc-map} is for characters that follow @key{ESC}."
>
> This should actually say "for keys you type following @key{ESC}",
> because that's clearly the intent, given the fact it talks about a
> keymap.

Maybe. But there are still examples where it is spoken about characters,
like

"... the keymap for the @file{*scratch*} buffer (using Lisp Interaction
mode) is a sparse keymap in which the entry for @key{ESC},
@acronym{ASCII} code 27, is another sparse keymap."

In general, from the texinfo manual it is not clear to me how to mark
such characters (not keyboard keys to be pressed) properly. The current
practice to mark them like @key{ESC} looks OK to me, but it is not
documented.

Karl?

Best regards, Michael.