GNU bug report logs - #48504
Improve style of C-h t description (Preface)

Previous Next

Full log

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

From: Sebastian Urban <mrsebastianurban <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 48504 <at> debbugs.gnu.org
Subject: Re: bug#48504: Improve style of C-h t description (Preface)
Date: Wed, 19 May 2021 15:44:51 +0200

>> No, I mean to change this:
>>     (which is ``control h and then t'')
>> into this:
>>     (hold down @key{Control} and type @kbd{h}, then let go of
>>     @key{Control} and type @kbd{t})
>
> That's awkward.

What exactly? It's basically copy-paste from SCREEN.TEXI (L126). Is it
awkward there as well?

> How about
>
>   To run the tutorial, start Emacs and type @kbd{C-h t} (that is,
>   press and hold Control, then type h, then release Control and type
>   t).

Why @kbd/@key (commands for indication) can't be used here for
"Control"/"h"/"t"?

The complete sentence would look (in EMACS.TEXI) like this:

   To run the tutorial, start Emacs and type @kbd{C-h t} (that/which
   is, hold down @key{Control} and type @kbd{h}, then let go of
   @key{Control} and type @kbd{t}).

Whether there will be "that is" or "which is" - it's up to you.

Previous Next

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