GNU bug report logs - #16803
@kbd for long option names?

Previous Next

Full log

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: karl <at> freefriends.org (Karl Berry)
To: bug-coreutils <at> gnu.org
Subject: @kbd for long option names?
Date: Tue, 18 Feb 2014 23:57:28 GMT

I just realized that, at some point, the coreutils manual started using
@kbd for long option names, as in:

@item -b
@itemx @w{@kbd{--backup}[=@var{method}]}

Why?  Semantically, long option names are not keyboard input.
Practically, I find the result pretty suboptimal in the printed output,
at least, since the -b is typeset in upright typewriter and --backup in
slanted typewriter, even though they are synonyms.

I'm happy to send a patch to remove all the @kbd's if you'll accept it,
but I imagine you had a reason to insert them in the first place.
Surely I didn't use them when I translated some of the original
descriptions?!  Can't say I remember [anything] with 100% certainty :).

karl

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.