Re: Emacs manual: correct @code to @kbd

[Aaron S. Hawley]

On Mon, Jun 8, 2009 at 11:01 PM, Eli Zaretskii<address@hidden> wrote:
>
> However, some of your corrections are wrong.  For example, this:
>
>> --- doc/emacs/custom.texi     4 Jun 2009 03:13:28 -0000       1.22
>> +++ doc/emacs/custom.texi     8 Jun 2009 18:49:57 -0000
>> @@ -1706,7 +1706,7 @@
>> address@hidden example
>>
>>    When the key sequence includes function keys or mouse button events,
>> -or address@hidden characters such as @code{C-=} or @code{H-a},
>> +or address@hidden characters such as @kbd{C-=} or @kbd{H-a},
>
> Since this talks about _characters_, not keystrokes, @kdb is
> inappropriate here, I think.

Maybe, but the @code isn't appropriate since neither characters nor
"key sequence" are source code.

I noticed the node "User Input" in commands.texi also talks about
characters, however, the examples like this are marked with @kbd.
Though, It does more appropriately use @samp, rather than @kbd, for
characters that aren't key sequences.

-- 
In general, we reserve the right to have a poor
memory--the computer, however, is supposed to
remember!  Poor computer.  -- Guy Lewis Steele Jr.