Re: emacs-27 fda6009: Minor copyedits of Emacs manual

Re: emacs-27 fda6009: Minor copyedits of Emacs manual

[Stefan Kangas]

Eli Zaretskii <eliz@gnu.org> writes:

> branch: emacs-27
> commit fda60094a2a686323bcf23439e286f2240cfe737
> Author: Eli Zaretskii <eliz@gnu.org>
> Commit: Eli Zaretskii <eliz@gnu.org>
>
>     Minor copyedits of Emacs manual

Thanks for working on improving the manual.  One small comment:

>  Emacs comes with an introductory online tutorial available in many
> -languages.  This book picks up where that tutorial ends.  It explains
> -the full range of Emacs's power and contains reference material useful
> -to expert users.
> +languages, and this manual picks up where that tutorial ends.  It
> +explains the full range of the power of Emacs, now up to @strong{version
> +27.2}, and contains reference material useful to expert users.  It
> +also includes appendices with specific material about X and GTK
> +resources, and with details for users of macOS and Microsoft Windows.

I think the final sentence here could be left out.  The appendices
aren't super exciting or important in themselves, and the paragraph as
a whole carries more punch without it.  Just my two cents.

Re: emacs-27 fda6009: Minor copyedits of Emacs manual

[Eli Zaretskii]

> From: Stefan Kangas <stefan@marxist.se>
> Date: Tue, 6 Jul 2021 14:30:36 +0200
> 
> >  Emacs comes with an introductory online tutorial available in many
> > -languages.  This book picks up where that tutorial ends.  It explains
> > -the full range of Emacs's power and contains reference material useful
> > -to expert users.
> > +languages, and this manual picks up where that tutorial ends.  It
> > +explains the full range of the power of Emacs, now up to @strong{version
> > +27.2}, and contains reference material useful to expert users.  It
> > +also includes appendices with specific material about X and GTK
> > +resources, and with details for users of macOS and Microsoft Windows.
> 
> I think the final sentence here could be left out.  The appendices
> aren't super exciting or important in themselves, and the paragraph as
> a whole carries more punch without it.  Just my two cents.

It's a marketing thing, not a technical one.  The text comes from a
person who manages the next printing of the Emacs manual for the FSF
shop.

Re: emacs-27 fda6009: Minor copyedits of Emacs manual

[Stefan Kangas]

Eli Zaretskii <eliz@gnu.org> writes:

> It's a marketing thing, not a technical one.

Yes, that's why I spoke of the text "packing more punch".  But I'm
obviously fine either way, so please feel free to do what you decide
is best.