[parent not found: <20240629151110.D1321C1FB5B@vcs2.savannah.gnu.org>]
* Re: emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits.
[not found] ` <20240629151110.D1321C1FB5B@vcs2.savannah.gnu.org>
@ 2024-06-30 1:21 ` Po Lu
2024-06-30 1:57 ` Stefan Kangas
0 siblings, 1 reply; 6+ messages in thread
From: Po Lu @ 2024-06-30 1:21 UTC (permalink / raw)
To: emacs-devel; +Cc: Stefan Kangas
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.
^ permalink raw reply [flat|nested] 6+ messages in thread* Re: emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits.
2024-06-30 1:21 ` emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits Po Lu
@ 2024-06-30 1:57 ` Stefan Kangas
2024-06-30 2:03 ` Po Lu
0 siblings, 1 reply; 6+ messages in thread
From: Stefan Kangas @ 2024-06-30 1:57 UTC (permalink / raw)
To: Po Lu, emacs-devel
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.
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits.
2024-06-30 1:57 ` Stefan Kangas
@ 2024-06-30 2:03 ` Po Lu
2024-06-30 2:08 ` Stefan Kangas
0 siblings, 1 reply; 6+ messages in thread
From: Po Lu @ 2024-06-30 2:03 UTC (permalink / raw)
To: Stefan Kangas; +Cc: emacs-devel
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.
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits.
2024-06-30 2:03 ` Po Lu
@ 2024-06-30 2:08 ` Stefan Kangas
2024-06-30 2:15 ` Po Lu
0 siblings, 1 reply; 6+ messages in thread
From: Stefan Kangas @ 2024-06-30 2:08 UTC (permalink / raw)
To: Po Lu; +Cc: emacs-devel
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.
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits.
2024-06-30 2:08 ` Stefan Kangas
@ 2024-06-30 2:15 ` Po Lu
0 siblings, 0 replies; 6+ messages in thread
From: Po Lu @ 2024-06-30 2:15 UTC (permalink / raw)
To: Stefan Kangas; +Cc: emacs-devel
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.
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2024-06-30 2:15 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
[not found] <171967386705.12704.7103897810618296421@vcs2.savannah.gnu.org>
[not found] ` <20240629151113.6A350C1FB74@vcs2.savannah.gnu.org>
2024-06-29 15:17 ` emacs-30 d063af203c8 7/8: Add "New in Emacs 30" to FAQ Stefan Kangas
[not found] ` <20240629151110.D1321C1FB5B@vcs2.savannah.gnu.org>
2024-06-30 1:21 ` emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits Po Lu
2024-06-30 1:57 ` Stefan Kangas
2024-06-30 2:03 ` Po Lu
2024-06-30 2:08 ` Stefan Kangas
2024-06-30 2:15 ` Po Lu
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).