bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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


From: Richard Stallman
Subject: Re: When should we put @key inside @kbd?
Date: Sat, 10 Mar 2018 16:08:23 -0500

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

  > @key shall always be slanted if it is about user input.

Sorry, I don't think this distinction is useful.

@key is always about user input.  @key is used for keyboard keys.
The only thing a keyboard key is good for is user input.

Even if the sentence in question does not talk about pressing the key,
the only significance of the key is that you might press it.

  > Often (at least in the Emacs manual), @key{} is used to describe
  > characters. Whether this is good practice shall be decided. Instead of
  > writing "the @key{SPC} character", one could also write "the space
  > character".

I just checked with grep and found just a few places where @key could
have been taken to refer to something other than user input.  They
will be fixed.

So I think it is best for @key never to be slanted.

-- 
Dr Richard Stallman
President, Free Software Foundation (https://gnu.org, https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)
Skype: No way! See https://stallman.org/skype.html.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]