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

[Eli Zaretskii]

> From: Richard Stallman <address@hidden>
> CC: address@hidden, address@hidden, address@hidden,
>       address@hidden
> Date: Sat, 10 Mar 2018 16:08:55 -0500
> 
>   > > "If you don't have the @key{LFD} or @key{TAB} keys on your keyboard,
>   > > the @kbd{C-j} and @kbd{C-i} keys are equivalent to them, respectively."
> 
>   > But C-j and C-i are not keys, so this is again something that needs to
>   > be fixed in the Emacs manual.
> 
> In Emacs we use "key" as short for "key sequence".  In that sense,
> they are keys.
> 
> However, since we are also using "key" in its vernacular meaning,
> in the first line, the result is an inconsistent usage of "key".
> That is what creates a confusion here.
> 
> Any ideas for how to make this clearer?

How about

  typing @kbd{C-j} and @kbd{C-i}, respectively, will produce the same
  effect.