From: Eli Zaretskii <eliz@gnu.org>
To: Stefan Kangas <stefan@marxist.se>
Cc: mrsebastianurban@gmail.com, 48504@debbugs.gnu.org
Subject: bug#48504: Improve style of C-h t description (Preface)
Date: Wed, 29 Sep 2021 15:18:24 +0300 [thread overview]
Message-ID: <83k0izinhr.fsf@gnu.org> (raw)
In-Reply-To: <CADwFkmkDaxxeG5LnDda-=+G+yRVxzvmzA3YO5xtchJxmw9tarw@mail.gmail.com> (message from Stefan Kangas on Wed, 29 Sep 2021 05:07:09 -0700)
> From: Stefan Kangas <stefan@marxist.se>
> Date: Wed, 29 Sep 2021 05:07:09 -0700
> Cc: Sebastian Urban <mrsebastianurban@gmail.com>, 48504@debbugs.gnu.org
>
> > To run the tutorial, start Emacs and type @kbd{C-h t} (that is,
> > @kbd{Ctrl+H}, then @kbd{T}).
The first @kbd should be @kbd{@key{Ctrl} H}, I think. For two
reasons:
. "Ctrl" is a single key, not 4 characters C t r l
. "+" isn't something the user should type
IOW, what you suggest violates our (and Texinfo's) conventions for
markup of key sequences. Which is why I proposed a pure-English
description that doesn't use any fancy markup that could only confuse
at this point.
Question: what do we gain from using "Ctrl+H" instead?
next prev parent reply other threads:[~2021-09-29 12:18 UTC|newest]
Thread overview: 15+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-05-18 19:05 bug#48504: Improve style of C-h t description (Preface) Sebastian Urban
2021-05-18 19:19 ` Eli Zaretskii
2021-05-18 20:35 ` Sebastian Urban
2021-05-19 2:24 ` Eli Zaretskii
2021-05-19 11:17 ` Sebastian Urban
2021-05-19 11:56 ` Eli Zaretskii
2021-05-19 13:44 ` Sebastian Urban
2021-05-19 14:06 ` Eli Zaretskii
2021-05-20 6:21 ` Sebastian Urban
2021-05-20 7:06 ` Eli Zaretskii
2021-05-20 13:42 ` Sebastian Urban
2021-09-29 12:07 ` Stefan Kangas
2021-09-29 12:18 ` Eli Zaretskii [this message]
2021-09-29 13:11 ` Stefan Kangas
2022-07-13 12:00 ` Lars Ingebrigtsen
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=83k0izinhr.fsf@gnu.org \
--to=eliz@gnu.org \
--cc=48504@debbugs.gnu.org \
--cc=mrsebastianurban@gmail.com \
--cc=stefan@marxist.se \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).