bug#42982: Emacs manual suggestion

bug#42982: Emacs manual suggestion

[Alexander Summers]

[-- Attachment #1: Type: text/plain, Size: 445 bytes --]

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

[-- Attachment #2: Type: text/html, Size: 603 bytes --]

bug#42982: Emacs manual suggestion

[Alexander Summers]

[-- Attachment #1: Type: text/plain, Size: 813 bytes --]

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@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
>

[-- Attachment #2: Type: text/html, Size: 1282 bytes --]

bug#42982: Emacs manual suggestion

[Eli Zaretskii]

> From: Alexander Summers <alexandermsummers@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.

bug#42982: Emacs manual suggestion

[Lars Ingebrigtsen]

Alexander Summers <alexandermsummers@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

bug#42982: Emacs manual suggestion

[Sebastian Urban]

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.