Contents | < Browse | Browse >
`@key'{KEY-NAME}
----------------
Use the `@key' command for the conventional name for a key on a
keyboard, as in:
@key{RET}
You can use the `@key' command within the argument of an `@kbd'
command when the sequence of characters to be typed includes one or
more keys that are described by name.
For example, to produce `C-x ESC' you would type:
@kbd{C-x @key{ESC}}
Here is a list of the recommended names for keys; they are all in
upper case:
SPC
Space
RET
Return
LFD
Linefeed
TAB
Tab
BS
Backspace
ESC
Escape
DEL
Delete
SFT
Shift
CTL
Control
META
Meta
There are subtleties to handling words like `meta' or `ctl' that are
names of shift keys. When mentioning a character in which the shift
key is used, such as `Meta-a', use the `@kbd' command alone; do not use
the `@key' command; but when you are referring to the shift key in
isolation, use the `@key' command. For example, write `@kbd{Meta-a}'
to produce `Meta-a' and `@key{META}' to produce META. This is because
`Meta-a' refers to keys that you press on a keyboard, but META refers
to a key without implying that you press it. In short, use `@kbd' for
what you do, and use `@key' for what you talk about: "Press `@kbd{M-a}'
to move point to the beginning of the sentence. The `@key{META}' key
is often in the lower left of the keyboard."