* Emacs 28.2 released
@ 2022-09-12 10:13 Stefan Kangas
2022-09-12 11:28 ` Michael Albinus
2022-09-12 20:59 ` Karl Fogel
0 siblings, 2 replies; 44+ messages in thread
From: Stefan Kangas @ 2022-09-12 10:13 UTC (permalink / raw)
To: emacs-devel
[-- Attachment #1: Type: text/plain, Size: 2086 bytes --]
Version 28.2 of Emacs, the extensible text editor, should now
be available from your nearest GNU mirror:
https://ftpmirror.gnu.org/emacs/emacs-28.2.tar.xz
https://ftpmirror.gnu.org/emacs/emacs-28.2.tar.gz
The tarball is signed; you can get the PGP signature file at:
https://ftpmirror.gnu.org/emacs/emacs-28.2.tar.xz.sig
https://ftpmirror.gnu.org/emacs/emacs-28.2.tar.gz.sig
You can choose a mirror explicitly from the list at:
https://www.gnu.org/prep/ftp.html
Mirrors may take some time to update; the main GNU FTP server is at:
https://ftp.gnu.org/gnu/emacs/
To verify that the downloaded tarball is intact, download both the
tarball and the corresponding .sig file, and run this command:
gpg --verify emacs-28.2.tar.xz.sig
(and similarly for emacs-28.2.tar.gz, if you download that format).
If the GPG command fails because you don't have the required PGP
public key, run this command to import the key:
gpg --keyserver pgp.mit.edu --recv-keys \
CEA1DE21AB108493CC9C65742E82323B8F4353EE
Alternative keyservers to try are keyserver.ubuntu.com and keys.openpgp.org.
You can also run sha1sum or sha256sum and confirm that these
checksums match:
SHA1 emacs-28.2.tar.xz
d61863db02b732547e6d6c77081e3348734458be
SHA1 emacs-28.2.tar.gz
b019ec832c73cd8548981fe2bc11a7d6e812ddb9
SHA256 emacs-28.2.tar.xz
ee21182233ef3232dc97b486af2d86e14042dbb65bbc535df562c3a858232488
SHA256 emacs-28.2.tar.gz
a6912b14ef4abb1edab7f88191bfd61c3edd7085e084de960a4f86485cb7cad8
Emacs 28.2 is a bug-fix release, with no new features with respect to
Emacs 28.1.
For the complete list of changes and the people who made them, see the
various ChangeLog files in the source distribution. For a summary of
all the people who have contributed to Emacs, see the etc/AUTHORS file.
The online manuals and website will be updated shortly.
Printed copies of the Emacs manual are available for purchase from the
Free Software Foundation's online store at:
https://shop.fsf.org/product/emacs-manual/
For more information about Emacs, see:
https://www.gnu.org/software/emacs
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 519 bytes --]
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-12 10:13 Stefan Kangas
@ 2022-09-12 11:28 ` Michael Albinus
2022-09-12 11:55 ` Michael Albinus
` (3 more replies)
2022-09-12 20:59 ` Karl Fogel
1 sibling, 4 replies; 44+ messages in thread
From: Michael Albinus @ 2022-09-12 11:28 UTC (permalink / raw)
To: Stefan Kangas; +Cc: emacs-devel
Stefan Kangas <stefankangas@gmail.com> writes:
> Version 28.2 of Emacs, the extensible text editor, should now
> be available from your nearest GNU mirror:
Great, thanks a lot!
Does it mean that the emacs-28 branch is reopened for patches? I have
some of them hanging around in Tramp's 2.5 branch.
Or is it unlikely that there will be an Emacs 28.3?
Best regards, Michael.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-12 11:28 ` Michael Albinus
@ 2022-09-12 11:55 ` Michael Albinus
2022-09-12 11:59 ` Eli Zaretskii
` (2 subsequent siblings)
3 siblings, 0 replies; 44+ messages in thread
From: Michael Albinus @ 2022-09-12 11:55 UTC (permalink / raw)
To: Stefan Kangas; +Cc: emacs-devel
Michael Albinus <michael.albinus@gmx.de> writes:
Hi Stefan,
> Does it mean that the emacs-28 branch is reopened for patches? I have
> some of them hanging around in Tramp's 2.5 branch.
>
> Or is it unlikely that there will be an Emacs 28.3?
Forget the message. I've just seen your latest changes in the emacs-28
branch, this answers my questions.
Best regards, Michael.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-12 11:28 ` Michael Albinus
2022-09-12 11:55 ` Michael Albinus
@ 2022-09-12 11:59 ` Eli Zaretskii
2022-09-12 12:00 ` Eli Zaretskii
2022-09-12 12:20 ` Lars Ingebrigtsen
3 siblings, 0 replies; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-12 11:59 UTC (permalink / raw)
To: Michael Albinus; +Cc: stefankangas, emacs-devel
> From: Michael Albinus <michael.albinus@gmx.de>
> Cc: emacs-devel@gnu.org
> Date: Mon, 12 Sep 2022 13:28:33 +0200
>
> Stefan Kangas <stefankangas@gmail.com> writes:
>
> > Version 28.2 of Emacs, the extensible text editor, should now
> > be available from your nearest GNU mirror:
>
> Great, thanks a lot!
>
> Does it mean that the emacs-28 branch is reopened for patches?
Yes.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-12 11:28 ` Michael Albinus
2022-09-12 11:55 ` Michael Albinus
2022-09-12 11:59 ` Eli Zaretskii
@ 2022-09-12 12:00 ` Eli Zaretskii
2022-09-12 12:03 ` Michael Albinus
2022-09-12 12:20 ` Lars Ingebrigtsen
3 siblings, 1 reply; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-12 12:00 UTC (permalink / raw)
To: Michael Albinus; +Cc: stefankangas, emacs-devel
> From: Michael Albinus <michael.albinus@gmx.de>
> Cc: emacs-devel@gnu.org
> Date: Mon, 12 Sep 2022 13:28:33 +0200
>
> Stefan Kangas <stefankangas@gmail.com> writes:
>
> > Version 28.2 of Emacs, the extensible text editor, should now
> > be available from your nearest GNU mirror:
>
> Great, thanks a lot!
>
> Does it mean that the emacs-28 branch is reopened for patches?
Yes. But please, only safe ones.
> Or is it unlikely that there will be an Emacs 28.3?
Too early to say.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-12 12:00 ` Eli Zaretskii
@ 2022-09-12 12:03 ` Michael Albinus
0 siblings, 0 replies; 44+ messages in thread
From: Michael Albinus @ 2022-09-12 12:03 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: stefankangas, emacs-devel
Eli Zaretskii <eliz@gnu.org> writes:
>> Does it mean that the emacs-28 branch is reopened for patches?
>
> Yes. But please, only safe ones.
Sure. No new features, only what Tramp has released already via GNU ELPPA.
Best regards, Michael.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-12 11:28 ` Michael Albinus
` (2 preceding siblings ...)
2022-09-12 12:00 ` Eli Zaretskii
@ 2022-09-12 12:20 ` Lars Ingebrigtsen
3 siblings, 0 replies; 44+ messages in thread
From: Lars Ingebrigtsen @ 2022-09-12 12:20 UTC (permalink / raw)
To: Michael Albinus; +Cc: Stefan Kangas, emacs-devel
Michael Albinus <michael.albinus@gmx.de> writes:
> Or is it unlikely that there will be an Emacs 28.3?
If there are serious bugs in Emacs 28.2, then there'll be another
release. But as things stand now, I'd rather the next release be Emacs
29.1.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-12 10:13 Stefan Kangas
2022-09-12 11:28 ` Michael Albinus
@ 2022-09-12 20:59 ` Karl Fogel
2022-09-13 1:36 ` Stefan Kangas
1 sibling, 1 reply; 44+ messages in thread
From: Karl Fogel @ 2022-09-12 20:59 UTC (permalink / raw)
To: Stefan Kangas; +Cc: emacs-devel
Congratulations on the release!
Since these release announcement emails are widely shared (I saw
this one appear on news.ycombinator.com, for example), it might be
good to include a link to corresponding release notes.
That could be a link to an appropriate named anchor on
https://www.gnu.org/savannah-checkouts/gnu/emacs/emacs.html#Releases
(but there do not appear to be release-specific anchors on that
page currently, so we'd have to add that to release process).
Or it could be a link directly to the plaintext release notes that
the above web page points to anyway; in this case, that would be
https://www.gnu.org/savannah-checkouts/gnu/emacs/news/NEWS.28.1.
Either way, it would be helpful to those who see these release
announcements to be able to go directly from the announcement to a
page that tells them what's new in that release.
Best regards,
-Karl
On 12 Sep 2022, Stefan Kangas wrote:
>Version 28.2 of Emacs, the extensible text editor, should now
>be available from your nearest GNU mirror:
>
> https://ftpmirror.gnu.org/emacs/emacs-28.2.tar.xz
> https://ftpmirror.gnu.org/emacs/emacs-28.2.tar.gz
>
>The tarball is signed; you can get the PGP signature file at:
>
> https://ftpmirror.gnu.org/emacs/emacs-28.2.tar.xz.sig
> https://ftpmirror.gnu.org/emacs/emacs-28.2.tar.gz.sig
>
>You can choose a mirror explicitly from the list at:
> https://www.gnu.org/prep/ftp.html
>
>Mirrors may take some time to update; the main GNU FTP server is
>at:
> https://ftp.gnu.org/gnu/emacs/
>
>To verify that the downloaded tarball is intact, download both
>the
>tarball and the corresponding .sig file, and run this command:
>
> gpg --verify emacs-28.2.tar.xz.sig
>
>(and similarly for emacs-28.2.tar.gz, if you download that
>format).
>
>If the GPG command fails because you don't have the required PGP
>public key, run this command to import the key:
>
> gpg --keyserver pgp.mit.edu --recv-keys \
> CEA1DE21AB108493CC9C65742E82323B8F4353EE
>
>Alternative keyservers to try are keyserver.ubuntu.com and
>keys.openpgp.org.
>
>You can also run sha1sum or sha256sum and confirm that these
>checksums match:
>
>SHA1 emacs-28.2.tar.xz
>d61863db02b732547e6d6c77081e3348734458be
>SHA1 emacs-28.2.tar.gz
>b019ec832c73cd8548981fe2bc11a7d6e812ddb9
>
>SHA256 emacs-28.2.tar.xz
>ee21182233ef3232dc97b486af2d86e14042dbb65bbc535df562c3a858232488
>SHA256 emacs-28.2.tar.gz
>a6912b14ef4abb1edab7f88191bfd61c3edd7085e084de960a4f86485cb7cad8
>
>Emacs 28.2 is a bug-fix release, with no new features with
>respect to
>Emacs 28.1.
>
>For the complete list of changes and the people who made them,
>see the
>various ChangeLog files in the source distribution. For a
>summary of
>all the people who have contributed to Emacs, see the etc/AUTHORS
>file.
>
>The online manuals and website will be updated shortly.
>
>Printed copies of the Emacs manual are available for purchase
>from the
>Free Software Foundation's online store at:
> https://shop.fsf.org/product/emacs-manual/
>
>For more information about Emacs, see:
> https://www.gnu.org/software/emacs
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-12 20:59 ` Karl Fogel
@ 2022-09-13 1:36 ` Stefan Kangas
2022-09-13 2:30 ` Eli Zaretskii
0 siblings, 1 reply; 44+ messages in thread
From: Stefan Kangas @ 2022-09-13 1:36 UTC (permalink / raw)
To: Karl Fogel; +Cc: emacs-devel
Karl Fogel <kfogel@red-bean.com> writes:
> Since these release announcement emails are widely shared (I saw
> this one appear on news.ycombinator.com, for example), it might be
> good to include a link to corresponding release notes.
Good idea. Maybe we should start making an HTML export of the release
notes and publish it on the website?
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-13 1:36 ` Stefan Kangas
@ 2022-09-13 2:30 ` Eli Zaretskii
2022-09-13 9:39 ` Stefan Kangas
0 siblings, 1 reply; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-13 2:30 UTC (permalink / raw)
To: Stefan Kangas; +Cc: kfogel, emacs-devel
> From: Stefan Kangas <stefankangas@gmail.com>
> Date: Mon, 12 Sep 2022 21:36:57 -0400
> Cc: emacs-devel@gnu.org
>
> Karl Fogel <kfogel@red-bean.com> writes:
>
> > Since these release announcement emails are widely shared (I saw
> > this one appear on news.ycombinator.com, for example), it might be
> > good to include a link to corresponding release notes.
>
> Good idea. Maybe we should start making an HTML export of the release
> notes and publish it on the website?
We already do that, see the web site. It's just that the page was not
updated for this release yet.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-13 2:30 ` Eli Zaretskii
@ 2022-09-13 9:39 ` Stefan Kangas
2022-09-13 12:03 ` Eli Zaretskii
0 siblings, 1 reply; 44+ messages in thread
From: Stefan Kangas @ 2022-09-13 9:39 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: kfogel, emacs-devel
Eli Zaretskii <eliz@gnu.org> writes:
>> Maybe we should start making an HTML export of the release notes and
>> publish it on the website?
>
> We already do that, see the web site.
We just copy the plain text, right?
https://www.gnu.org/savannah-checkouts/gnu/emacs/news/NEWS.28.2
> It's just that the page was not updated for this release yet.
It should be done now.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-13 9:39 ` Stefan Kangas
@ 2022-09-13 12:03 ` Eli Zaretskii
2022-09-13 12:46 ` Stefan Kangas
2022-09-13 15:29 ` Karl Fogel
0 siblings, 2 replies; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-13 12:03 UTC (permalink / raw)
To: Stefan Kangas; +Cc: kfogel, emacs-devel
> From: Stefan Kangas <stefankangas@gmail.com>
> Date: Tue, 13 Sep 2022 05:39:52 -0400
> Cc: kfogel@red-bean.com, emacs-devel@gnu.org
>
> Eli Zaretskii <eliz@gnu.org> writes:
>
> >> Maybe we should start making an HTML export of the release notes and
> >> publish it on the website?
> >
> > We already do that, see the web site.
>
> We just copy the plain text, right?
Yes. That was one of Karl's proposals, right?
> https://www.gnu.org/savannah-checkouts/gnu/emacs/news/NEWS.28.2
I think this is enough. Reworking our humongous NEWS into HTML is too
much, and most people won't read that anyway. This is why we have a
short list of the most important new features right there on the page.
> > It's just that the page was not updated for this release yet.
>
> It should be done now.
Thanks!
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-13 12:03 ` Eli Zaretskii
@ 2022-09-13 12:46 ` Stefan Kangas
2022-09-13 13:03 ` Lars Ingebrigtsen
2022-09-13 15:29 ` Karl Fogel
1 sibling, 1 reply; 44+ messages in thread
From: Stefan Kangas @ 2022-09-13 12:46 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: kfogel, emacs-devel
Eli Zaretskii <eliz@gnu.org> writes:
>> https://www.gnu.org/savannah-checkouts/gnu/emacs/news/NEWS.28.2
>
> I think this is enough. Reworking our humongous NEWS into HTML is too
> much, and most people won't read that anyway.
I was thinking of using something like org-mode to export it to HTML.
I don't think it would take much coding, really.
But I'm fine with leaving it alone, too.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-13 12:46 ` Stefan Kangas
@ 2022-09-13 13:03 ` Lars Ingebrigtsen
2022-09-13 13:43 ` Robert Pluim
0 siblings, 1 reply; 44+ messages in thread
From: Lars Ingebrigtsen @ 2022-09-13 13:03 UTC (permalink / raw)
To: Stefan Kangas; +Cc: Eli Zaretskii, kfogel, emacs-devel
Stefan Kangas <stefankangas@gmail.com> writes:
> I was thinking of using something like org-mode to export it to HTML.
> I don't think it would take much coding, really.
>
> But I'm fine with leaving it alone, too.
I think that's a good idea -- our NEWS file uses a very regular syntax,
and writing a converter into Org format (and then exporting it to HTML)
doesn't sound like a major job.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-13 13:03 ` Lars Ingebrigtsen
@ 2022-09-13 13:43 ` Robert Pluim
2022-09-13 13:55 ` Lars Ingebrigtsen
2022-09-14 16:43 ` Stefan Kangas
0 siblings, 2 replies; 44+ messages in thread
From: Robert Pluim @ 2022-09-13 13:43 UTC (permalink / raw)
To: Lars Ingebrigtsen; +Cc: Stefan Kangas, Eli Zaretskii, kfogel, emacs-devel
>>>>> On Tue, 13 Sep 2022 15:03:24 +0200, Lars Ingebrigtsen <larsi@gnus.org> said:
Lars> Stefan Kangas <stefankangas@gmail.com> writes:
>> I was thinking of using something like org-mode to export it to HTML.
>> I don't think it would take much coding, really.
>>
>> But I'm fine with leaving it alone, too.
Lars> I think that's a good idea -- our NEWS file uses a very regular syntax,
Lars> and writing a converter into Org format (and then exporting it to HTML)
Lars> doesn't sound like a major job.
Converter? You can just do
M-x org-mode RET
M-x org-export-dispatch h h
And it produces a nice html file. We might consider turning off the
table of contents, though.
Robert
--
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-13 13:43 ` Robert Pluim
@ 2022-09-13 13:55 ` Lars Ingebrigtsen
2022-09-14 16:43 ` Stefan Kangas
1 sibling, 0 replies; 44+ messages in thread
From: Lars Ingebrigtsen @ 2022-09-13 13:55 UTC (permalink / raw)
To: Robert Pluim; +Cc: Stefan Kangas, Eli Zaretskii, kfogel, emacs-devel
[-- Attachment #1: Type: text/plain, Size: 160 bytes --]
Robert Pluim <rpluim@gmail.com> writes:
> Converter? You can just do
>
> M-x org-mode RET
> M-x org-export-dispatch h h
>
> And it produces a nice html file.
[-- Attachment #2: Type: image/png, Size: 243006 bytes --]
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-13 12:03 ` Eli Zaretskii
2022-09-13 12:46 ` Stefan Kangas
@ 2022-09-13 15:29 ` Karl Fogel
2022-09-13 15:49 ` Eli Zaretskii
1 sibling, 1 reply; 44+ messages in thread
From: Karl Fogel @ 2022-09-13 15:29 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: Stefan Kangas, emacs-devel
On 13 Sep 2022, Eli Zaretskii wrote:
>> From: Stefan Kangas <stefankangas@gmail.com>
>> Date: Tue, 13 Sep 2022 05:39:52 -0400
>> Cc: kfogel@red-bean.com, emacs-devel@gnu.org
>>
>> Eli Zaretskii <eliz@gnu.org> writes:
>>
>> >> Maybe we should start making an HTML export of the release
>> >> notes and
>> >> publish it on the website?
>> >
>> > We already do that, see the web site.
>>
>> We just copy the plain text, right?
>
>Yes. That was one of Karl's proposals, right?
My proposal was that the email announcement should always contain
a link to release notes, so that those who see the email can
easily go straight to more details about what's in the new
release.
Somehow, the followup discussion to my suggestion seems to have
become about improving the format of the release notes themselves,
or about offering various different formats / levels of detail of
release notes. Those might all be good ideas, but they're
separate from what I was suggesting.
Best regards,
-Karl
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-13 15:29 ` Karl Fogel
@ 2022-09-13 15:49 ` Eli Zaretskii
2022-09-13 15:52 ` Eli Zaretskii
2022-09-14 16:59 ` Karl Fogel
0 siblings, 2 replies; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-13 15:49 UTC (permalink / raw)
To: Karl Fogel; +Cc: stefankangas, emacs-devel
> From: Karl Fogel <kfogel@red-bean.com>
> Cc: Stefan Kangas <stefankangas@gmail.com>, emacs-devel@gnu.org
> Date: Tue, 13 Sep 2022 10:29:36 -0500
>
> My proposal was that the email announcement should always contain
> a link to release notes, so that those who see the email can
> easily go straight to more details about what's in the new
> release.
If so, I'm not sure I agree. Other projects do that, or even post the
entire contents of NEWS as part of the announcement. But our NEWS is
so large that posting it really makes no sense, and I won't expect
anyone to read the entire NEWS file, only search it for issues
relevant to him/her.
This is one case where doing what others do makes no sense.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-13 15:49 ` Eli Zaretskii
@ 2022-09-13 15:52 ` Eli Zaretskii
2022-09-14 16:59 ` Karl Fogel
1 sibling, 0 replies; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-13 15:52 UTC (permalink / raw)
To: kfogel, stefankangas; +Cc: emacs-devel
> Date: Tue, 13 Sep 2022 18:49:12 +0300
> From: Eli Zaretskii <eliz@gnu.org>
> Cc: stefankangas@gmail.com, emacs-devel@gnu.org
>
> > From: Karl Fogel <kfogel@red-bean.com>
> > Cc: Stefan Kangas <stefankangas@gmail.com>, emacs-devel@gnu.org
> > Date: Tue, 13 Sep 2022 10:29:36 -0500
> >
> > My proposal was that the email announcement should always contain
> > a link to release notes, so that those who see the email can
> > easily go straight to more details about what's in the new
> > release.
>
> If so, I'm not sure I agree. Other projects do that, or even post the
> entire contents of NEWS as part of the announcement. But our NEWS is
> so large that posting it really makes no sense, and I won't expect
> anyone to read the entire NEWS file, only search it for issues
> relevant to him/her.
>
> This is one case where doing what others do makes no sense.
And one more thing: announcements of major releases do include a short
list of main new features. This is minor release, where the only
"new" things are bugfixes, so we don't include such a list in this
case.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-13 13:43 ` Robert Pluim
2022-09-13 13:55 ` Lars Ingebrigtsen
@ 2022-09-14 16:43 ` Stefan Kangas
2022-09-14 16:47 ` Lars Ingebrigtsen
` (2 more replies)
1 sibling, 3 replies; 44+ messages in thread
From: Stefan Kangas @ 2022-09-14 16:43 UTC (permalink / raw)
To: Robert Pluim, Lars Ingebrigtsen; +Cc: Eli Zaretskii, kfogel, emacs-devel
Robert Pluim <rpluim@gmail.com> writes:
> You can just do
>
> M-x org-mode RET
> M-x org-export-dispatch h h
>
> And it produces a nice html file. We might consider turning off the
> table of contents, though.
It was a bit more work than that, but I've now pushed a preliminary
version to emacs-28.
See here for the result:
https://www.gnu.org/software/emacs/news/NEWS.28.2.html
If we like it, we could change the links to go to HTML versions instead.
And then we could export HTML versions for old versions, if we want to.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 16:43 ` Stefan Kangas
@ 2022-09-14 16:47 ` Lars Ingebrigtsen
2022-09-14 17:33 ` Eli Zaretskii
2022-09-14 16:54 ` Eli Zaretskii
2022-09-14 16:57 ` Karl Fogel
2 siblings, 1 reply; 44+ messages in thread
From: Lars Ingebrigtsen @ 2022-09-14 16:47 UTC (permalink / raw)
To: Stefan Kangas; +Cc: Robert Pluim, Eli Zaretskii, kfogel, emacs-devel
Stefan Kangas <stefankangas@gmail.com> writes:
> It was a bit more work than that, but I've now pushed a preliminary
> version to emacs-28.
>
> See here for the result:
>
> https://www.gnu.org/software/emacs/news/NEWS.28.2.html
Great; that looks really good.
> If we like it, we could change the links to go to HTML versions instead.
> And then we could export HTML versions for old versions, if we want to.
Older NEWS files might not be as stringent wrt. format as they currently
are, so that might be more work? But if it's straightforward, then I'd
be all for having the older versions as HTML, too.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 16:43 ` Stefan Kangas
2022-09-14 16:47 ` Lars Ingebrigtsen
@ 2022-09-14 16:54 ` Eli Zaretskii
2022-09-14 22:50 ` Stefan Kangas
2022-09-14 16:57 ` Karl Fogel
2 siblings, 1 reply; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-14 16:54 UTC (permalink / raw)
To: Stefan Kangas; +Cc: rpluim, larsi, kfogel, emacs-devel
> From: Stefan Kangas <stefankangas@gmail.com>
> Date: Wed, 14 Sep 2022 09:43:34 -0700
> Cc: Eli Zaretskii <eliz@gnu.org>, kfogel@red-bean.com, emacs-devel@gnu.org
>
> Robert Pluim <rpluim@gmail.com> writes:
>
> > You can just do
> >
> > M-x org-mode RET
> > M-x org-export-dispatch h h
> >
> > And it produces a nice html file. We might consider turning off the
> > table of contents, though.
>
> It was a bit more work than that, but I've now pushed a preliminary
> version to emacs-28.
>
> See here for the result:
>
> https://www.gnu.org/software/emacs/news/NEWS.28.2.html
This is mostly Emacs 28.1 NEWS (as expected), which IMNSHO is
misleading.
Once again, I don't think we should publish NEWS for minor releases.
At the very least, remove everything that pertains to previous
releases of the same major version.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 16:43 ` Stefan Kangas
2022-09-14 16:47 ` Lars Ingebrigtsen
2022-09-14 16:54 ` Eli Zaretskii
@ 2022-09-14 16:57 ` Karl Fogel
2022-09-14 18:34 ` Bob Rogers
2 siblings, 1 reply; 44+ messages in thread
From: Karl Fogel @ 2022-09-14 16:57 UTC (permalink / raw)
To: Stefan Kangas; +Cc: Robert Pluim, Lars Ingebrigtsen, Eli Zaretskii, emacs-devel
On 14 Sep 2022, Stefan Kangas wrote:
>Robert Pluim <rpluim@gmail.com> writes:
>
>> You can just do
>>
>> M-x org-mode RET
>> M-x org-export-dispatch h h
>>
>> And it produces a nice html file. We might consider turning off
>> the
>> table of contents, though.
>
>It was a bit more work than that, but I've now pushed a
>preliminary
>version to emacs-28.
>
>See here for the result:
>
> https://www.gnu.org/software/emacs/news/NEWS.28.2.html
>
>If we like it, we could change the links to go to HTML versions
>instead.
>And then we could export HTML versions for old versions, if we
>want to.
Very nice. In the first item (1.1), you can see some
misformatting has happened. (I don't see that problem in any
other items, from a quick scan.)
Best regards,
-Karl
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-13 15:49 ` Eli Zaretskii
2022-09-13 15:52 ` Eli Zaretskii
@ 2022-09-14 16:59 ` Karl Fogel
2022-09-14 17:04 ` Eli Zaretskii
1 sibling, 1 reply; 44+ messages in thread
From: Karl Fogel @ 2022-09-14 16:59 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: stefankangas, emacs-devel
On 13 Sep 2022, Eli Zaretskii wrote:
>> From: Karl Fogel <kfogel@red-bean.com>
>> Cc: Stefan Kangas <stefankangas@gmail.com>,
>> emacs-devel@gnu.org
>> Date: Tue, 13 Sep 2022 10:29:36 -0500
>>
>> My proposal was that the email announcement should always
>> contain
>> a link to release notes, so that those who see the email can
>> easily go straight to more details about what's in the new
>> release.
>
>If so, I'm not sure I agree. Other projects do that, or even
>post the
>entire contents of NEWS as part of the announcement. But our
>NEWS is
>so large that posting it really makes no sense, and I won't
>expect
>anyone to read the entire NEWS file, only search it for issues
>relevant to him/her.
>
>This is one case where doing what others do makes no sense.
I was not suggesting including the contents of the NEWS file. I
was suggesting including a *link to* the NEWS file, so that those
who are interested can follow the link.
That is what others do -- I can't think of another project that
doesn't do this in their release announcement emails, in fact --
and I think we should do it too.
Best regards,
-Karl
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 16:59 ` Karl Fogel
@ 2022-09-14 17:04 ` Eli Zaretskii
0 siblings, 0 replies; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-14 17:04 UTC (permalink / raw)
To: Karl Fogel; +Cc: stefankangas, emacs-devel
> From: Karl Fogel <kfogel@red-bean.com>
> Cc: stefankangas@gmail.com, emacs-devel@gnu.org
> Date: Wed, 14 Sep 2022 11:59:35 -0500
>
> >If so, I'm not sure I agree. Other projects do that, or even
> >post the
> >entire contents of NEWS as part of the announcement. But our
> >NEWS is
> >so large that posting it really makes no sense, and I won't
> >expect
> >anyone to read the entire NEWS file, only search it for issues
> >relevant to him/her.
> >
> >This is one case where doing what others do makes no sense.
>
> I was not suggesting including the contents of the NEWS file. I
> was suggesting including a *link to* the NEWS file, so that those
> who are interested can follow the link.
I responded to both these alternatives.
> That is what others do -- I can't think of another project that
> doesn't do this in their release announcement emails, in fact --
> and I think we should do it too.
I disagree, for the reasons I explained. If you want to try changing
my mind, you will have to allude to those reasons, not just reiterate
what you already said before.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
@ 2022-09-14 17:06 Karl Fogel
2022-09-14 17:21 ` Eli Zaretskii
2022-09-14 17:39 ` Eli Zaretskii
0 siblings, 2 replies; 44+ messages in thread
From: Karl Fogel @ 2022-09-14 17:06 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: stefankangas, emacs-devel
>I was not suggesting including the contents of the NEWS file. I
>was
>suggesting including a *link to* the NEWS file, so that those who
>are
>interested can follow the link.
I should have said: "a link to the NEWS file or some other web
page that describes the release".
The key point is for the announcement email to link to a more
detailed description of what's new in the release. Whether that
description is the NEWS file or something else is a separate
question -- whatever it is, it'll have more information about the
release than the email announcement has.
Best regards,
-Karl
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 17:06 Emacs 28.2 released Karl Fogel
@ 2022-09-14 17:21 ` Eli Zaretskii
2022-09-14 18:49 ` Karl Fogel
2022-09-14 17:39 ` Eli Zaretskii
1 sibling, 1 reply; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-14 17:21 UTC (permalink / raw)
To: Karl Fogel; +Cc: stefankangas, emacs-devel
> From: Karl Fogel <kfogel@red-bean.com>
> Cc: stefankangas@gmail.com, emacs-devel@gnu.org
> Date: Wed, 14 Sep 2022 12:06:17 -0500
>
> >I was not suggesting including the contents of the NEWS file. I
> >was
> >suggesting including a *link to* the NEWS file, so that those who
> >are
> >interested can follow the link.
>
> I should have said: "a link to the NEWS file or some other web
> page that describes the release".
But we already do that! For a major release, the Web page includes
its main new features, and the Web page mentions them for a month
since the release. And the announcement tells how to read the NEWS
file. What is missing?
> The key point is for the announcement email to link to a more
> detailed description of what's new in the release.
More detailed than what?
> Whether that description is the NEWS file or something else is a
> separate question -- whatever it is, it'll have more information
> about the release than the email announcement has.
Here's the list of main new features in Emacs 28.1, copied from
https://www.gnu.org/software/emacs/
Emacs 28.1
Released Apr 4, 2022
Emacs 28.1 has a wide variety of new features, including:
Native compilation of Lisp files
Text shaping with HarfBuzz and drawing with Cairo
Support for loading Secure Computing filters
Much improved display of Emoji and Emoji sequences
New system for documenting groups of functions
A minor mode for context menus
Mode-specific commands
Emacs shows matching parentheses by default
Many improvements and extensions to project.el
There's a link to NEWS for people who want that.
What is the problem for the email announcement to have the same list
of main new features, and refer to NEWS, as we already do, for those
who really want that?
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 16:47 ` Lars Ingebrigtsen
@ 2022-09-14 17:33 ` Eli Zaretskii
2022-09-14 22:50 ` Stefan Kangas
0 siblings, 1 reply; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-14 17:33 UTC (permalink / raw)
To: Lars Ingebrigtsen; +Cc: stefankangas, rpluim, kfogel, emacs-devel
> From: Lars Ingebrigtsen <larsi@gnus.org>
> Cc: Robert Pluim <rpluim@gmail.com>, Eli Zaretskii <eliz@gnu.org>,
> kfogel@red-bean.com, emacs-devel@gnu.org
> Date: Wed, 14 Sep 2022 18:47:51 +0200
>
> Stefan Kangas <stefankangas@gmail.com> writes:
>
> > It was a bit more work than that, but I've now pushed a preliminary
> > version to emacs-28.
> >
> > See here for the result:
> >
> > https://www.gnu.org/software/emacs/news/NEWS.28.2.html
>
> Great; that looks really good.
I don't like the result at all, and like even less what is intended to
be its usage. So please don't install that.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 17:06 Emacs 28.2 released Karl Fogel
2022-09-14 17:21 ` Eli Zaretskii
@ 2022-09-14 17:39 ` Eli Zaretskii
1 sibling, 0 replies; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-14 17:39 UTC (permalink / raw)
To: Karl Fogel; +Cc: stefankangas, emacs-devel
> From: Karl Fogel <kfogel@red-bean.com>
> Cc: stefankangas@gmail.com, emacs-devel@gnu.org
> Date: Wed, 14 Sep 2022 12:06:17 -0500
>
> The key point is for the announcement email to link to a more
> detailed description of what's new in the release.
The email announcement is a plain-text message. It lists the main new
features of a major release, and explains how to access NEWS for more.
Why is anything else needed?
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 16:57 ` Karl Fogel
@ 2022-09-14 18:34 ` Bob Rogers
2022-09-16 14:56 ` Stefan Kangas
0 siblings, 1 reply; 44+ messages in thread
From: Bob Rogers @ 2022-09-14 18:34 UTC (permalink / raw)
To: Karl Fogel
Cc: Stefan Kangas, Robert Pluim, Lars Ingebrigtsen, Eli Zaretskii,
emacs-devel
From: Karl Fogel <kfogel@red-bean.com>
Date: Wed, 14 Sep 2022 11:57:21 -0500
On 14 Sep 2022, Stefan Kangas wrote:
>Robert Pluim <rpluim@gmail.com> writes:
>
> . . .
>
>It was a bit more work than that, but I've now pushed a
>preliminary version to emacs-28.
>
>See here for the result:
>
> https://www.gnu.org/software/emacs/news/NEWS.28.2.html
>
>If we like it, we could change the links to go to HTML versions
>instead.
>And then we could export HTML versions for old versions, if we
>want to.
Very nice. In the first item (1.1), you can see some
misformatting has happened. (I don't see that problem in any
other items, from a quick scan.)
Best regards,
-Karl
Item 6.2 has the following code snippet:
(set-fontset-font t 'emoji
~("My New Emoji Font" . "iso10646-1") nil ~prepend)
Notice how the quotes have been changed to twiddles. (I wondered what
new reader syntax had been invented for describing emoji fonts . . .)
-- Bob Rogers
http://www.rgrjr.com/
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 17:21 ` Eli Zaretskii
@ 2022-09-14 18:49 ` Karl Fogel
2022-09-14 18:56 ` Eli Zaretskii
0 siblings, 1 reply; 44+ messages in thread
From: Karl Fogel @ 2022-09-14 18:49 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: stefankangas, emacs-devel
I think I see where the miscommunication is coming from here. Let
me explain my suggestion more clearly:
Stefan's announcement mail was for 28.2, and has this sentence:
"Emacs 28.2 is a bug-fix release, with no new features with
respect to Emacs 28.1."
That's probably why his email didn't have any link out to a
description of the release -- because 28.2 has no new features;
it's just bugfixes.
(You can see his mail here, for reference:
https://mail.gnu.org/archive/html/emacs-devel/2022-09/msg00730.html)
What I'm saying is that *every* release announcement email should
have a clickable link to the release notes for that release, even
when we're only making a bugfix release.
There are a couple of reasons for this, one direct and one more
subtle:
The direct reason is:
Many readers will want to be able to click on a link to see what's
in the release, because even if it's only bugfixes, they'll want
to know what those fixes were. They're making a decision about
whether to upgrade, and typically that decision involves reading
the release notes. So if we just point to the release notes for
*every* release, always, we'll help smooth their decision process.
The more subtle reason is:
Some people who (for whatever reason) didn't upgrade from >= 27.x
when 28.1 came out may decide to do so when they see the 28.2
announcement. Online release notes are usually structured so that
if one is reading the notes for X.Y, it's very easy to get from
there to the notes for X.(Y-1) -- you just scroll farther down in
the web page, or you edit the URL in some obvious way, or
something like that. Thus, people who saw Stefan's announcement
would have the following assumption in the back of their minds:
"If I can get to the release notes for 28.2, it'll be an equally
easy hop from there to the release notes for 28.1". Therefore,
including a link to the 28.2 release notes in the 28.2
announcement email would help those who are upgrading from >= 27.x
too, as well as those upgrading from 28.1.
So my suggestion is that release announcement emails always
include a direct link to the release notes for that release, for
the reasons given above. And specifically, that we stick to this
policy even for minor or bugfix releases.
I hope this clarifies.
Best regards,
-Karl
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 18:49 ` Karl Fogel
@ 2022-09-14 18:56 ` Eli Zaretskii
2022-09-14 19:15 ` Karl Fogel
0 siblings, 1 reply; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-14 18:56 UTC (permalink / raw)
To: Karl Fogel; +Cc: stefankangas, emacs-devel
> From: Karl Fogel <kfogel@red-bean.com>
> Cc: stefankangas@gmail.com, emacs-devel@gnu.org
> Date: Wed, 14 Sep 2022 13:49:58 -0500
>
> What I'm saying is that *every* release announcement email should
> have a clickable link to the release notes for that release, even
> when we're only making a bugfix release.
But we don't have any release notes for bugfix releases. We don't
track bugs that we fix in such releases, and don't record them
anywhere except in Git logs. We certainly don't record them in NEWS,
which is why what Stefan did misses your point.
> So my suggestion is that release announcement emails always
> include a direct link to the release notes for that release, for
> the reasons given above. And specifically, that we stick to this
> policy even for minor or bugfix releases.
For that to be possible, we should first have some record of the bugs
we fixed explained in a language that would be understandable to users
(as opposed to Emacs developers). Such a record will most probably
mention only some of the bugfixes, since many of them are minor and
others don't tell anything to users. So let's first discuss whether
we want such a record, and if we do, how this could be possible in
practice. Until we have such a record, talking about publishing it in
a release announcement is meaningless.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 18:56 ` Eli Zaretskii
@ 2022-09-14 19:15 ` Karl Fogel
2022-09-14 19:21 ` Eli Zaretskii
0 siblings, 1 reply; 44+ messages in thread
From: Karl Fogel @ 2022-09-14 19:15 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: stefankangas, emacs-devel
On 14 Sep 2022, Eli Zaretskii wrote:
>But we don't have any release notes for bugfix releases. We
>don't
>track bugs that we fix in such releases, and don't record them
>anywhere except in Git logs. We certainly don't record them in
>NEWS,
>which is why what Stefan did misses your point.
We have an entry in NEWS for 28.2.
That entry has a substantive item about an installation change.
There are also a couple of items listed under "Changes in
Specialized Modes and Packages in Emacs 28.2" (although one of
them says that the change was actually released in 28.1 and that
we just forgot to include it in the release notes then).
>> So my suggestion is that release announcement emails always
>> include a direct link to the release notes for that release,
>> for
>> the reasons given above. And specifically, that we stick to
>> this
>> policy even for minor or bugfix releases.
>
>For that to be possible, we should first have some record of the
>bugs
>we fixed explained in a language that would be understandable to
>users
>(as opposed to Emacs developers). Such a record will most
>probably
>mention only some of the bugfixes, since many of them are minor
>and
>others don't tell anything to users. So let's first discuss
>whether
>we want such a record, and if we do, how this could be possible
>in
>practice. Until we have such a record, talking about publishing
>it in
>a release announcement is meaningless.
While that would certainly make better release notes, I can't say
whether it's worth the effort, and anyway it's not required here.
Even without us keeping such a record, the so-called "more subtle"
point in my previous message still holds:
People who land on the 28.2 notes can easily find their way from
there to the previous notes, and so on. Since we don't know the
version of Emacs the reader might be contemplating upgrading from,
by linking from the announcement email to the corresponding recent
release notes, we put the reader at a starting point from which
they can easily trace back as far as they need to go to make their
decision.
In other words, *even* if all we do for a minor release is put an
entry into NEWS that says...
> * Changes in Emacs X.Y
>
> This is a bug-fix release with no new features.
...and then we point to that (in whatever form it lives on the
web), we are still helping the reader start their informational
journey.
This also simplifies the release process a tiny bit, because it's
an unconditional policy. The email template would always have a
slot for that link, and that link would always has a place to
point to.
Best regards,
-Karl
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 19:15 ` Karl Fogel
@ 2022-09-14 19:21 ` Eli Zaretskii
2022-09-14 19:53 ` Karl Fogel
0 siblings, 1 reply; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-14 19:21 UTC (permalink / raw)
To: Karl Fogel; +Cc: stefankangas, emacs-devel
> From: Karl Fogel <kfogel@red-bean.com>
> Cc: stefankangas@gmail.com, emacs-devel@gnu.org
> Date: Wed, 14 Sep 2022 14:15:26 -0500
>
> On 14 Sep 2022, Eli Zaretskii wrote:
> >But we don't have any release notes for bugfix releases. We
> >don't
> >track bugs that we fix in such releases, and don't record them
> >anywhere except in Git logs. We certainly don't record them in
> >NEWS,
> >which is why what Stefan did misses your point.
>
> We have an entry in NEWS for 28.2.
>
> That entry has a substantive item about an installation change.
> There are also a couple of items listed under "Changes in
> Specialized Modes and Packages in Emacs 28.2" (although one of
> them says that the change was actually released in 28.1 and that
> we just forgot to include it in the release notes then).
These are not the bugfixes whose list you wanted to see.
> People who land on the 28.2 notes can easily find their way from
> there to the previous notes, and so on. Since we don't know the
> version of Emacs the reader might be contemplating upgrading from,
> by linking from the announcement email to the corresponding recent
> release notes, we put the reader at a starting point from which
> they can easily trace back as far as they need to go to make their
> decision.
>
> In other words, *even* if all we do for a minor release is put an
> entry into NEWS that says...
>
> > * Changes in Emacs X.Y
> >
> > This is a bug-fix release with no new features.
>
> ...and then we point to that (in whatever form it lives on the
> web), we are still helping the reader start their informational
> journey.
You keep changing the request on every step. It is very hard to have
a useful discussion this way.
So now I understand that you suggest having something like this:
. a link to NEWS of the current release (for minor releases, this
NEWS could be empty or almost empty, and we don't have a way to
describe the bugs we fixed there, but you now say this is not
important?)
. a link to the announcement of previous release, where there will
be a link to NEWS of that release
. and so on, all the way to some old enough release beyond which no
one will bother
Is that correct? Or do we have a misunderstanding again?
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 19:21 ` Eli Zaretskii
@ 2022-09-14 19:53 ` Karl Fogel
2022-09-15 6:58 ` Eli Zaretskii
0 siblings, 1 reply; 44+ messages in thread
From: Karl Fogel @ 2022-09-14 19:53 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: stefankangas, emacs-devel
On 14 Sep 2022, Eli Zaretskii wrote:
>> From: Karl Fogel <kfogel@red-bean.com>
>> Cc: stefankangas@gmail.com, emacs-devel@gnu.org
>> Date: Wed, 14 Sep 2022 14:15:26 -0500
>>
>> On 14 Sep 2022, Eli Zaretskii wrote:
>> >But we don't have any release notes for bugfix releases. We
>> >don't
>> >track bugs that we fix in such releases, and don't record them
>> >anywhere except in Git logs. We certainly don't record them
>> >in
>> >NEWS,
>> >which is why what Stefan did misses your point.
>>
>> We have an entry in NEWS for 28.2.
>>
>> That entry has a substantive item about an installation change.
>> There are also a couple of items listed under "Changes in
>> Specialized Modes and Packages in Emacs 28.2" (although one of
>> them says that the change was actually released in 28.1 and
>> that
>> we just forgot to include it in the release notes then).
>
>These are not the bugfixes whose list you wanted to see.
Sure it is. It's good enough -- and presumably that's why we link
to it from the 28.2 section on
https://www.gnu.org/savannah-checkouts/gnu/emacs/emacs.html#Releases
.
All I'm saying is that the announcement email should contain the
*same link* that the above page contains.
If we want to make further improvements to release notes, we can.
I'm not against that. But my core suggestion has always been to
just link to the thing *that we already have*. We don't need to
do more work to make a better thing. Let's just point to the
thing we have -- that would already be an improvement on the
status quo, and a very easy improvement to implement.
While the blurb for 28.2 may not be a complete list of bugfixes,
it is still useful, both in what it contains and in its position
at the end of an easily-navigable long line of past release notes.
>You keep changing the request on every step. It is very hard to
>have
>a useful discussion this way.
I have been making the same request in every single email. My
original email contains the same proposal I am making above:
https://mail.gnu.org/archive/html/emacs-devel/2022-09/msg00757.html
(Later I introduced the observation that readers of announcement
emails will also use the *already existing* ability to easily get
from the current release notes to past release notes. That merely
supplements the argument I've always been making -- it is an
additional feature, but it doesn't require any extra work on our
part: we already have it.)
>So now I understand that you suggest having something like this:
>
> . a link to NEWS of the current release (for minor releases,
> this
> NEWS could be empty or almost empty, and we don't have a way
> to
> describe the bugs we fixed there, but you now say this is not
> important?)
> . a link to the announcement of previous release, where there
> will
> be a link to NEWS of that release
> . and so on, all the way to some old enough release beyond
> which no
> one will bother
>
>Is that correct? Or do we have a misunderstanding again?
I don't understand how you got that from what I wrote, but it is
not what I said.
My suggestion is simply this:
Every release announcement email -- major or minor -- should have
a link to the corresponding online release notes.
That single link is enough to satisfy readers who want to go
looking for more detail. Sure, we could improve our release notes
for minor releases, if we decide it's worth the effort, but just
dependably having the link at all would still be an improvement
over the status quo.
In practice, some readers will use that to jump to information
about older releases, since not everyone upgrades with every
release. Our online release notes are already presented in a way
that makes such jumping convenient, so we don't need to do any
more work to get that benefit.
Best regards,
-Karl
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 17:33 ` Eli Zaretskii
@ 2022-09-14 22:50 ` Stefan Kangas
2022-09-15 5:37 ` Eli Zaretskii
0 siblings, 1 reply; 44+ messages in thread
From: Stefan Kangas @ 2022-09-14 22:50 UTC (permalink / raw)
To: Eli Zaretskii, Lars Ingebrigtsen; +Cc: rpluim, kfogel, emacs-devel
Eli Zaretskii <eliz@gnu.org> writes:
>> > See here for the result:
>> >
>> > https://www.gnu.org/software/emacs/news/NEWS.28.2.html
>>
>> Great; that looks really good.
>
> I don't like the result at all, and like even less what is intended to
> be its usage.
To clarify, the intention is to replace the link on
https://www.gnu.org/software/emacs/#Releases
which currently points to
https://www.gnu.org/software/emacs/news/NEWS.28.2
with
https://www.gnu.org/software/emacs/news/NEWS.28.2.html
.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 16:54 ` Eli Zaretskii
@ 2022-09-14 22:50 ` Stefan Kangas
2022-09-15 5:38 ` Eli Zaretskii
0 siblings, 1 reply; 44+ messages in thread
From: Stefan Kangas @ 2022-09-14 22:50 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: rpluim, larsi, kfogel, emacs-devel
Eli Zaretskii <eliz@gnu.org> writes:
> Once again, I don't think we should publish NEWS for minor releases.
> At the very least, remove everything that pertains to previous
> releases of the same major version.
Do you suggest deleting and/or trimming this file too
https://www.gnu.org/software/emacs/news/NEWS.28.2
?
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 22:50 ` Stefan Kangas
@ 2022-09-15 5:37 ` Eli Zaretskii
2022-09-15 7:44 ` Stefan Kangas
0 siblings, 1 reply; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-15 5:37 UTC (permalink / raw)
To: Stefan Kangas; +Cc: larsi, rpluim, kfogel, emacs-devel
> From: Stefan Kangas <stefankangas@gmail.com>
> Date: Wed, 14 Sep 2022 15:50:48 -0700
> Cc: rpluim@gmail.com, kfogel@red-bean.com, emacs-devel@gnu.org
>
> Eli Zaretskii <eliz@gnu.org> writes:
>
> >> > See here for the result:
> >> >
> >> > https://www.gnu.org/software/emacs/news/NEWS.28.2.html
> >>
> >> Great; that looks really good.
> >
> > I don't like the result at all, and like even less what is intended to
> > be its usage.
>
> To clarify, the intention is to replace the link on
>
> https://www.gnu.org/software/emacs/#Releases
>
> which currently points to
>
> https://www.gnu.org/software/emacs/news/NEWS.28.2
>
> with
>
> https://www.gnu.org/software/emacs/news/NEWS.28.2.html
First, this was not what Karl was talking about (AFAIU, and it sounds
like I might be misunderstanding -- again). He asked to include a
link in the email announcement we post to various GNU mailing lists,
whereas the above replaces the link on the Emacs Web site, which is a
different place. I was talking about what I perceived was Karl's
request.
Second, to evaluate your proposal, please describe what is needed
(which commands and packages, and how to use them) to produce this
HTML version. Also, how will this HTML version be maintained, after
it is produced. I don't think you described all that in detail;
apologies if I missed something.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 22:50 ` Stefan Kangas
@ 2022-09-15 5:38 ` Eli Zaretskii
0 siblings, 0 replies; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-15 5:38 UTC (permalink / raw)
To: Stefan Kangas; +Cc: rpluim, larsi, kfogel, emacs-devel
> From: Stefan Kangas <stefankangas@gmail.com>
> Date: Wed, 14 Sep 2022 15:50:56 -0700
> Cc: rpluim@gmail.com, larsi@gnus.org, kfogel@red-bean.com, emacs-devel@gnu.org
>
> Eli Zaretskii <eliz@gnu.org> writes:
>
> > Once again, I don't think we should publish NEWS for minor releases.
> > At the very least, remove everything that pertains to previous
> > releases of the same major version.
>
> Do you suggest deleting and/or trimming this file too
>
> https://www.gnu.org/software/emacs/news/NEWS.28.2
>
> ?
No.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 19:53 ` Karl Fogel
@ 2022-09-15 6:58 ` Eli Zaretskii
2022-09-15 7:44 ` Stefan Kangas
2022-09-15 17:59 ` Karl Fogel
0 siblings, 2 replies; 44+ messages in thread
From: Eli Zaretskii @ 2022-09-15 6:58 UTC (permalink / raw)
To: Karl Fogel; +Cc: stefankangas, emacs-devel
> From: Karl Fogel <kfogel@red-bean.com>
> Cc: stefankangas@gmail.com, emacs-devel@gnu.org
> Date: Wed, 14 Sep 2022 14:53:43 -0500
>
> >> We have an entry in NEWS for 28.2.
> >>
> >> That entry has a substantive item about an installation change.
> >> There are also a couple of items listed under "Changes in
> >> Specialized Modes and Packages in Emacs 28.2" (although one of
> >> them says that the change was actually released in 28.1 and
> >> that
> >> we just forgot to include it in the release notes then).
> >
> >These are not the bugfixes whose list you wanted to see.
>
> Sure it is. It's good enough -- and presumably that's why we link
> to it from the 28.2 section on
> https://www.gnu.org/savannah-checkouts/gnu/emacs/emacs.html#Releases
> .
Are we talking about the email announcements or are we talking about
the Emacs Web page? They are two different media, and I thought you
were talking about the former.
The email announcement of a major release (in this case, Emacs 28.1)
has this text:
For a summary of changes in Emacs 28.1, see the etc/NEWS file in the
tarball; you can view it from Emacs by typing 'C-h n', or by clicking
Help->Emacs News from the menu bar.
For the complete list of changes and the people who made them, see the
various ChangeLog files in the source distribution. For a summary of
all the people who have contributed to Emacs, see the etc/AUTHORS
file.
AFAIU, you wanted to have there an HTML link to the NEWS file, is that
correct? If so, I can suggest adding to the above text the link to
https://git.savannah.gnu.org/cgit/emacs.git/tree/etc/NEWS?h=emacs-28
Would that be okay?
One subtle issue here is that when we post the email announcement
about a new release, the on-line manuals and the Emacs Web page are
not yet up-to-date, so either a link to anything inside the Web pages
will be outdated, or we will need to delay the announcement until the
Web pages are updated, both of which are undesirable. A link to Git
above is thus a compromise that doesn't have these disadvantages.
> All I'm saying is that the announcement email should contain the
> *same link* that the above page contains.
See above: that'd delay the release announcement, sometimes by days,
depending on the free time of the people who do these updating jobs.
> While the blurb for 28.2 may not be a complete list of bugfixes,
> it is still useful, both in what it contains and in its position
> at the end of an easily-navigable long line of past release notes.
As explained already, that blurb is not a list of bugfixes at all. It
is a list of noteworthy changes in the release, and in minor releases
it is usually very short, sometimes includes "old news" from the
previous releases that we just forgot to mention, and could even be
empty. I don't especially mind having that referenced in the email
announcements, but if that satisfies your request, I really wonder
what was all the fuss about.
> >You keep changing the request on every step. It is very hard to
> >have
> >a useful discussion this way.
>
> I have been making the same request in every single email. My
> original email contains the same proposal I am making above:
No, it didn't, not in this detail and accuracy.
> >Is that correct? Or do we have a misunderstanding again?
>
> I don't understand how you got that from what I wrote, but it is
> not what I said.
As already mentioned, it is hard to understand what exactly are you
saying. Apologies for not being better at that.
> My suggestion is simply this:
>
> Every release announcement email -- major or minor -- should have
> a link to the corresponding online release notes.
If by "release notes" you mean the NEWS file, this can be done,
although I question the usefulness. If you mean something else, then
we don't have any "release notes" in Emacs; however the Emacs Web page
does show a list of the more important new features in each major
release.
> That single link is enough to satisfy readers who want to go
> looking for more detail.
What is this assertion based on? I understand that doing so will
satisfy you, but how do you know it will satisfy others?
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-15 5:37 ` Eli Zaretskii
@ 2022-09-15 7:44 ` Stefan Kangas
0 siblings, 0 replies; 44+ messages in thread
From: Stefan Kangas @ 2022-09-15 7:44 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: larsi, rpluim, kfogel, emacs-devel
Eli Zaretskii <eliz@gnu.org> writes:
> I was talking about what I perceived was Karl's request.
Sorry, it's my bad for getting an idea in the middle of a discussion and
then not explaining it clearly. As my idea is orthogonal to Karl's, I
will make a separate email where I will describe my proposal in more
detail.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-15 6:58 ` Eli Zaretskii
@ 2022-09-15 7:44 ` Stefan Kangas
2022-09-15 17:59 ` Karl Fogel
1 sibling, 0 replies; 44+ messages in thread
From: Stefan Kangas @ 2022-09-15 7:44 UTC (permalink / raw)
To: Eli Zaretskii, Karl Fogel; +Cc: emacs-devel
Eli Zaretskii <eliz@gnu.org> writes:
> AFAIU, you wanted to have there an HTML link to the NEWS file, is that
> correct? If so, I can suggest adding to the above text the link to
>
> https://git.savannah.gnu.org/cgit/emacs.git/tree/etc/NEWS?h=emacs-28
>
> Would that be okay?
That proposal sounds okay to me, FWIW.
> One subtle issue here is that when we post the email announcement
> about a new release, the on-line manuals and the Emacs Web page are
> not yet up-to-date, so either a link to anything inside the Web pages
> will be outdated, or we will need to delay the announcement until the
> Web pages are updated, both of which are undesirable. A link to Git
> above is thus a compromise that doesn't have these disadvantages.
That's exactly right. While I do happen to think there is room for more
automation here, the link to git is a good compromise for now.
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-15 6:58 ` Eli Zaretskii
2022-09-15 7:44 ` Stefan Kangas
@ 2022-09-15 17:59 ` Karl Fogel
1 sibling, 0 replies; 44+ messages in thread
From: Karl Fogel @ 2022-09-15 17:59 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: stefankangas, emacs-devel
On 15 Sep 2022, Eli Zaretskii wrote:
>> From: Karl Fogel <kfogel@red-bean.com>
>> Cc: stefankangas@gmail.com, emacs-devel@gnu.org
>> Date: Wed, 14 Sep 2022 14:53:43 -0500
>>
>> >> We have an entry in NEWS for 28.2.
>> >>
>> >> That entry has a substantive item about an installation
>> >> change.
>> >> There are also a couple of items listed under "Changes in
>> >> Specialized Modes and Packages in Emacs 28.2" (although one
>> >> of
>> >> them says that the change was actually released in 28.1 and
>> >> that
>> >> we just forgot to include it in the release notes then).
>> >
>> >These are not the bugfixes whose list you wanted to see.
>>
>> Sure it is. It's good enough -- and presumably that's why we
>> link
>> to it from the 28.2 section on
>> https://www.gnu.org/savannah-checkouts/gnu/emacs/emacs.html#Releases
>> .
>
>Are we talking about the email announcements or are we talking
>about
>the Emacs Web page? They are two different media, and I thought
>you
>were talking about the former.
We're talking about making a change to email announcements.
The fact that we already link to the minor release's NEWS file
from the "#Releases" section of the web site indicates that we
think the contents of those NEWS files to be noteworthy for the
release. We're already using them, effectively, as release notes
-- they are, after all, notes about the release, that we link to
from our web page about releases. (I could have been clearer
about the fact that I was using "release notes" as a shorthand
phrase to refer this information that we already post to the web
to accompany a release.)
>The email announcement of a major release (in this case, Emacs
>28.1)
>has this text:
>
> For a summary of changes in Emacs 28.1, see the etc/NEWS file
> in the
> tarball; you can view it from Emacs by typing 'C-h n', or by
> clicking
> Help->Emacs News from the menu bar.
>
> For the complete list of changes and the people who made them,
> see the
> various ChangeLog files in the source distribution. For a
> summary of
> all the people who have contributed to Emacs, see the
> etc/AUTHORS
> file.
>
>AFAIU, you wanted to have there an HTML link to the NEWS file, is
>that
>correct? If so, I can suggest adding to the above text the link
>to
>
> https://git.savannah.gnu.org/cgit/emacs.git/tree/etc/NEWS?h=emacs-28
>
>Would that be okay?
Yes.
There have been separate followup discussions here of improving
the in-browser presentation of that information, and/or making the
URL something a little more familiar, and those would be welcome
improvements, but just doing the above would solve the problem --
we would now have a clickable link.
>One subtle issue here is that when we post the email announcement
>about a new release, the on-line manuals and the Emacs Web page
>are
>not yet up-to-date, so either a link to anything inside the Web
>pages
>will be outdated, or we will need to delay the announcement until
>the
>Web pages are updated, both of which are undesirable. A link to
>Git
>above is thus a compromise that doesn't have these disadvantages.
I didn't know about that process ordering issue. In that case, a
simple solution is just a link to Git, as you suggest.
>> All I'm saying is that the announcement email should contain
>> the
>> *same link* that the above page contains.
>
>See above: that'd delay the release announcement, sometimes by
>days,
>depending on the free time of the people who do these updating
>jobs.
Yup; I didn't know about that ordering issue. But a link to the
exact same information (at this different, Git-based URL) is fine.
>> While the blurb for 28.2 may not be a complete list of
>> bugfixes,
>> it is still useful, both in what it contains and in its
>> position
>> at the end of an easily-navigable long line of past release
>> notes.
>
>As explained already, that blurb is not a list of bugfixes at
>all. It
>is a list of noteworthy changes in the release, and in minor
>releases
>it is usually very short, sometimes includes "old news" from the
>previous releases that we just forgot to mention, and could even
>be
>empty. I don't especially mind having that referenced in the
>email
>announcements, but if that satisfies your request, I really
>wonder
>what was all the fuss about.
"A list of noteworthy changes in the release" sounds like a
description of release notes, and is good enough. If some day we
have a chance to make even more information easily available,
that's even better, but no need to wait for that.
>If by "release notes" you mean the NEWS file, this can be done,
>although I question the usefulness.
I assumed that if we are maintaining the NEWS file entries, we
must think they are useful news. Otherwise, why are we writing
them?
>If you mean something else, then
>we don't have any "release notes" in Emacs; however the Emacs Web
>page
>does show a list of the more important new features in each major
>release.
>
>> That single link is enough to satisfy readers who want to go
>> looking for more detail.
>
>What is this assertion based on? I understand that doing so will
>satisfy you, but how do you know it will satisfy others?
I tried to explain this in an earlier post, where I wrote:
> Online release notes are usually structured so that
> if one is reading the notes for X.Y, it's very easy to get from
> there to the notes for X.(Y-1) -- you just scroll farther down
> in
> the web page, or you edit the URL in some obvious way, or
> something like that. Thus, people who saw Stefan's announcement
> would have the following assumption in the back of their minds:
> "If I can get to the release notes for 28.2, it'll be an equally
> easy hop from there to the release notes for 28.1". Therefore,
> including a link to the 28.2 release notes in the 28.2
> announcement email would help those who are upgrading from >=
> 27.x
> too, as well as those upgrading from 28.1.
What I said there applies (for example) to the NEWS file link you
give above.
Once someone has landed on the Git-served NEWS web page, they can
easily find their way to earlier release notes if the wish to. In
this case they would do it by searching farther down in the same
page. In other cases, such as if they had landed on
https://git.savannah.gnu.org/cgit/emacs.git/tree/etc/NEWS.28, they
might might do it via trivial URL editing.
These are common strategies that people who install software like
Emacs generally know how to use. I would expect that you yourself
have used such strategies before, though I don't know for sure.
Best regards,
-Karl
^ permalink raw reply [flat|nested] 44+ messages in thread
* Re: Emacs 28.2 released
2022-09-14 18:34 ` Bob Rogers
@ 2022-09-16 14:56 ` Stefan Kangas
0 siblings, 0 replies; 44+ messages in thread
From: Stefan Kangas @ 2022-09-16 14:56 UTC (permalink / raw)
To: Bob Rogers, Karl Fogel
Cc: Robert Pluim, Lars Ingebrigtsen, Eli Zaretskii, emacs-devel
Karl Fogel <kfogel@red-bean.com> writes:
> Very nice. In the first item (1.1), you can see some
> misformatting has happened. (I don't see that problem in any
> other items, from a quick scan.)
Bob Rogers <rogers@rgrjr.com> writes:
> Item 6.2 has the following code snippet:
>
> (set-fontset-font t 'emoji
> ~("My New Emoji Font" . "iso10646-1") nil ~prepend)
>
> Notice how the quotes have been changed to twiddles. (I wondered what
> new reader syntax had been invented for describing emoji fonts . . .)
Both of the above errors should now be fixed, see:
https://www.gnu.org/software/emacs/news/NEWS.28.html
(Note that the old file NEWS.28.2.html has been deleted.)
^ permalink raw reply [flat|nested] 44+ messages in thread
end of thread, other threads:[~2022-09-16 14:56 UTC | newest]
Thread overview: 44+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2022-09-14 17:06 Emacs 28.2 released Karl Fogel
2022-09-14 17:21 ` Eli Zaretskii
2022-09-14 18:49 ` Karl Fogel
2022-09-14 18:56 ` Eli Zaretskii
2022-09-14 19:15 ` Karl Fogel
2022-09-14 19:21 ` Eli Zaretskii
2022-09-14 19:53 ` Karl Fogel
2022-09-15 6:58 ` Eli Zaretskii
2022-09-15 7:44 ` Stefan Kangas
2022-09-15 17:59 ` Karl Fogel
2022-09-14 17:39 ` Eli Zaretskii
-- strict thread matches above, loose matches on Subject: below --
2022-09-12 10:13 Stefan Kangas
2022-09-12 11:28 ` Michael Albinus
2022-09-12 11:55 ` Michael Albinus
2022-09-12 11:59 ` Eli Zaretskii
2022-09-12 12:00 ` Eli Zaretskii
2022-09-12 12:03 ` Michael Albinus
2022-09-12 12:20 ` Lars Ingebrigtsen
2022-09-12 20:59 ` Karl Fogel
2022-09-13 1:36 ` Stefan Kangas
2022-09-13 2:30 ` Eli Zaretskii
2022-09-13 9:39 ` Stefan Kangas
2022-09-13 12:03 ` Eli Zaretskii
2022-09-13 12:46 ` Stefan Kangas
2022-09-13 13:03 ` Lars Ingebrigtsen
2022-09-13 13:43 ` Robert Pluim
2022-09-13 13:55 ` Lars Ingebrigtsen
2022-09-14 16:43 ` Stefan Kangas
2022-09-14 16:47 ` Lars Ingebrigtsen
2022-09-14 17:33 ` Eli Zaretskii
2022-09-14 22:50 ` Stefan Kangas
2022-09-15 5:37 ` Eli Zaretskii
2022-09-15 7:44 ` Stefan Kangas
2022-09-14 16:54 ` Eli Zaretskii
2022-09-14 22:50 ` Stefan Kangas
2022-09-15 5:38 ` Eli Zaretskii
2022-09-14 16:57 ` Karl Fogel
2022-09-14 18:34 ` Bob Rogers
2022-09-16 14:56 ` Stefan Kangas
2022-09-13 15:29 ` Karl Fogel
2022-09-13 15:49 ` Eli Zaretskii
2022-09-13 15:52 ` Eli Zaretskii
2022-09-14 16:59 ` Karl Fogel
2022-09-14 17:04 ` Eli Zaretskii
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).