Re: rcirc manual

[Eli Zaretskii]

> Date: Sun, 15 Jan 2006 16:23:45 -0600
> From: address@hidden (Karl Berry)
> Cc: address@hidden, address@hidden, address@hidden
> 
> @node key
> @subsection @code{@@address@hidden@address@hidden
> @findex key
> 
> Use the @code{@@key} command for the conventional name for a key on a
> keyboard, as in:
> 
> @example
> @@address@hidden@}
> @end example
> 
> You can use the @code{@@key} command within the argument of an
> @code{@@kbd} command when the sequence of characters to be typed
> includes one or more keys that are described by name.
> 
> [...]

This still doesn't spell out what I think it should: that @key is for
keys whose names are more than 1 character long.  And the reason for
that is to avoid the user confusion, since @kbd{RET} _could_ be
interpreted as @kbd{R E T}.  There's no such confusion in the
single-character key case.