Re: emacs-30 d063af203c8 7/8: Add "New in Emacs 30" to FAQ

Re: emacs-30 d063af203c8 7/8: Add "New in Emacs 30" to FAQ

[Stefan Kangas]

Stefan Kangas <stefankangas@gmail.com> writes:

> branch: emacs-30
> commit d063af203c893354d1b02399502ff5be3f3eb36b
> Author: Stefan Kangas <stefankangas@gmail.com>
> Commit: Stefan Kangas <stefankangas@gmail.com>
>
>     Add "New in Emacs 30" to FAQ
>
>     * doc/misc/efaq.texi (New in Emacs 30): New section.

This is a first draft; feel free to help expand, edit, revise, and
improve this.

Thanks in advance.

Re: emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits.

[Po Lu]

Stefan Kangas <stefankangas@gmail.com> writes:
 
>  +++
> @@ -288,7 +288,7 @@ for which you can use '(category . tex-shell)'.
>  +++
>  *** Tool bars can now be placed on the bottom on more systems.
>  The 'tool-bar-position' frame parameter can be set to 'bottom' on all
> -window systems other than Nextstep.
> +window systems other than Nextstep and macOS.

In Emacs nomenclature, "Nextstep" denotes the window system common to
both Mac OS and GNUstep, so that this is a tautology of kinds.

Re: emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits.

[Stefan Kangas]

Po Lu <luangruo@yahoo.com> writes:

> Stefan Kangas <stefankangas@gmail.com> writes:
>
>>  +++
>> @@ -288,7 +288,7 @@ for which you can use '(category . tex-shell)'.
>>  +++
>>  *** Tool bars can now be placed on the bottom on more systems.
>>  The 'tool-bar-position' frame parameter can be set to 'bottom' on all
>> -window systems other than Nextstep.
>> +window systems other than Nextstep and macOS.
>
> In Emacs nomenclature, "Nextstep" denotes the window system common to
> both Mac OS and GNUstep, so that this is a tautology of kinds.

Our priority is to make our documentation as clear as possible for users
of varied skill levels and backgrounds.  This sometimes means adding
explanations that may seem redundant (or even tautological) to Emacs
developers.

In particular, we can't assume that readers are familiar with all of our
nomenclature, especially not when it's as obscure as "Nextstep means
macOS and Gnustep".

That said, I think the above text should be updated to read "window
systems other than macOS and GNUstep (Nextstep)", so I did that now.

Re: emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits.

[Po Lu]

Stefan Kangas <stefankangas@gmail.com> writes:

> Our priority is to make our documentation as clear as possible for users
> of varied skill levels and backgrounds.  This sometimes means adding
> explanations that may seem redundant (or even tautological) to Emacs
> developers.
>
> In particular, we can't assume that readers are familiar with all of our
> nomenclature, especially not when it's as obscure as "Nextstep means
> macOS and Gnustep".

The first priority of all documentation is to be accurate and not
mislead users, as it will if we mention "Nextstep" and "Mac OS" in
contrast to each other, and they subsequently encounter references to
Nextstep.

Re: emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits.

[Stefan Kangas]

Po Lu <luangruo@yahoo.com> writes:

> Stefan Kangas <stefankangas@gmail.com> writes:
>
>> Our priority is to make our documentation as clear as possible for users
>> of varied skill levels and backgrounds.  This sometimes means adding
>> explanations that may seem redundant (or even tautological) to Emacs
>> developers.
>>
>> In particular, we can't assume that readers are familiar with all of our
>> nomenclature, especially not when it's as obscure as "Nextstep means
>> macOS and Gnustep".
>
> The first priority of all documentation is to be accurate and not
> mislead users, as it will if we mention "Nextstep" and "Mac OS" in
> contrast to each other, and they subsequently encounter references to
> Nextstep.

Thanks, but I realized the mistake and updated the text.  The new text
was in the paragraph below the ones you quote here.

Please criticize the updated text if you still think that it's
inaccurate, and propose a better wording.

Re: emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits.

[Po Lu]

Stefan Kangas <stefankangas@gmail.com> writes:

> Thanks, but I realized the mistake and updated the text.  The new text
> was in the paragraph below the ones you quote here.
>
> Please criticize the updated text if you still think that it's
> inaccurate, and propose a better wording.

Oh no, I'm perfectly satisfied with the text you installed.