GNU bug report logs - #42982
Emacs manual suggestion

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 42982 in the body.
You can then email your comments to 42982 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

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

From: Alexander Summers <alexandermsummers <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: Emacs manual suggestion
Date: Sat, 22 Aug 2020 03:38:51 -0400

[Message part 1 (text/plain, inline)]

In the preface to the Emacs manual, it is recommended that the reader first
access the tutorial with "C-h t". However, I'm not sure if the target
audience for that particular paragraph will know what that means -- that
is, to hold down Shift and h, release, and then type 't'. I am concerned
this instruction might confuse them.

Also, it seems the HTML version is missing this preface entirely. Why is
that the case?

Thanks,
Alexander Summers

[Message part 2 (text/html, inline)]

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

From: Alexander Summers <alexandermsummers <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: Re: Emacs manual suggestion
Date: Sat, 22 Aug 2020 03:43:08 -0400

[Message part 1 (text/plain, inline)]

Apologies, after considering my previous email and confirming it with
research, I learned that the 'c' abbreviation is for the "control" key, not
shift. I am new to Emacs so I had a brief lapse of judgement.

I suppose my last email was self-demonstrative ;)

On Sat, Aug 22, 2020, 3:38 AM Alexander Summers <alexandermsummers <at> gmail.com>
wrote:

> In the preface to the Emacs manual, it is recommended that the reader
> first access the tutorial with "C-h t". However, I'm not sure if the target
> audience for that particular paragraph will know what that means -- that
> is, to hold down Shift and h, release, and then type 't'. I am concerned
> this instruction might confuse them.
>
> Also, it seems the HTML version is missing this preface entirely. Why is
> that the case?
>
> Thanks,
> Alexander Summers
>

[Message part 2 (text/html, inline)]

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Alexander Summers <alexandermsummers <at> gmail.com>
Cc: 42982 <at> debbugs.gnu.org
Subject: Re: bug#42982: Emacs manual suggestion
Date: Sat, 22 Aug 2020 12:10:46 +0300

> From: Alexander Summers <alexandermsummers <at> gmail.com>
> Date: Sat, 22 Aug 2020 03:38:51 -0400
> 
> Also, it seems the HTML version is missing this preface entirely. Why is that the case?

The Preface only appears in the printed version of the manual.

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Alexander Summers <alexandermsummers <at> gmail.com>
Cc: 42982 <at> debbugs.gnu.org
Subject: Re: bug#42982: Emacs manual suggestion
Date: Mon, 24 Aug 2020 15:09:49 +0200

Alexander Summers <alexandermsummers <at> gmail.com> writes:

> In the preface to the Emacs manual, it is recommended that the reader
> first access the tutorial with "C-h t". However, I'm not sure if the
> target audience for that particular paragraph will know what that
> means -- that is, to hold down Shift and h, release, and then type
> 't'. I am concerned this instruction might confuse them.

Makes sense.  I've now added something like that to the preface (only
correcting for shift->control :-)).

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

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

From: Sebastian Urban <mrsebastianurban <at> gmail.com>
To: larsi <at> gnus.org
Cc: 42982 <at> debbugs.gnu.org
Subject: bug#42982: Emacs manual suggestion
Date: Tue, 25 Aug 2020 13:09:19 +0200

Perhaps copy-pasting explanation from SCREEN.TEXI would be a better
solution, i.e. instead of
   (which is ``control h and then t'')
something like this:
   (hold down @key{Control} and type @kbd{h}, then let go of
   @key{Control} and type @kbd{t})
?

If not, then at least @kbd should be used and Control should start
with the capital letter C.


S. U.

BTW, this looks like part (point 5.) of https://debbugs.gnu.org/37327
bug report.

Previous Next

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