GNU bug report logs - #42917
27.1; temporary note included in 27 NEWS

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 42917 in the body.
You can then email your comments to 42917 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Alex Branham <alex.branham <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 27.1; temporary note included in 27 NEWS
Date: Tue, 18 Aug 2020 14:05:34 -0400

Hi all -

The following note:

Temporary note:
+++ indicates that all relevant manuals in doc/ have been updated.
--- means no change in the manuals is needed.
When you add a new item, use the appropriate mark if you are sure it
applies, and please also update docstrings as needed.

is included in Emacs 27.1 NEWS. Judging from previous releases, it
should have been removed, correct?

Thanks!

Message #8 received at 42917 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Alex Branham <alex.branham <at> gmail.com>
Cc: 42917 <at> debbugs.gnu.org
Subject: Re: bug#42917: 27.1; temporary note included in 27 NEWS
Date: Tue, 18 Aug 2020 21:26:16 +0300

> From: Alex Branham <alex.branham <at> gmail.com>
> Date: Tue, 18 Aug 2020 14:05:34 -0400
> 
> The following note:
> 
> Temporary note:
> +++ indicates that all relevant manuals in doc/ have been updated.
> --- means no change in the manuals is needed.
> When you add a new item, use the appropriate mark if you are sure it
> applies, and please also update docstrings as needed.
> 
> is included in Emacs 27.1 NEWS. Judging from previous releases, it
> should have been removed, correct?

Yes.

Message #13 received at 42917 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefankangas <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>, Alex Branham <alex.branham <at> gmail.com>
Cc: 42917 <at> debbugs.gnu.org
Subject: Re: bug#42917: 27.1; temporary note included in 27 NEWS
Date: Wed, 19 Aug 2020 14:01:50 -0400

close 42917 27.2
thanks

Eli Zaretskii <eliz <at> gnu.org> writes:

>> The following note:
>>
>> Temporary note:
>> +++ indicates that all relevant manuals in doc/ have been updated.
>> --- means no change in the manuals is needed.
>> When you add a new item, use the appropriate mark if you are sure it
>> applies, and please also update docstrings as needed.
>>
>> is included in Emacs 27.1 NEWS. Judging from previous releases, it
>> should have been removed, correct?
>
> Yes.

Fixed on emacs-27.

Best regards,
Stefan Kangas

Message #18 received at 42917 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Stefan Kangas <stefankangas <at> gmail.com>
Cc: 42917 <at> debbugs.gnu.org, alex.branham <at> gmail.com
Subject: Re: bug#42917: 27.1; temporary note included in 27 NEWS
Date: Wed, 19 Aug 2020 21:43:04 +0300

> From: Stefan Kangas <stefankangas <at> gmail.com>
> Date: Wed, 19 Aug 2020 14:01:50 -0400
> Cc: 42917 <at> debbugs.gnu.org
> 
> >> Temporary note:
> >> +++ indicates that all relevant manuals in doc/ have been updated.
> >> --- means no change in the manuals is needed.
> >> When you add a new item, use the appropriate mark if you are sure it
> >> applies, and please also update docstrings as needed.
> >>
> >> is included in Emacs 27.1 NEWS. Judging from previous releases, it
> >> should have been removed, correct?
> >
> > Yes.
> 
> Fixed on emacs-27.

Thanks, but that was a mistake: this part is only removed when
preparing the release tarball.  It cannot be removed in the
repository, because it must be there for people who make changes in
NEWS to see.  And people do make changes in NEWS, even though this is
a release branch.

Message #21 received at 42917 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefankangas <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 42917 <at> debbugs.gnu.org, alex.branham <at> gmail.com,
 Nicolas Petton <nico <at> petton.fr>
Subject: Re: bug#42917: 27.1; temporary note included in 27 NEWS
Date: Wed, 19 Aug 2020 18:58:57 +0000

reopen 42917
thanks

(I'm copying in Nico into the discussion.)

Eli Zaretskii <eliz <at> gnu.org> writes:

> Thanks, but that was a mistake: this part is only removed when
> preparing the release tarball.  It cannot be removed in the
> repository, because it must be there for people who make changes in
> NEWS to see.  And people do make changes in NEWS, even though this is
> a release branch.

Oh, I double-checked the emacs-26 branch and saw that it was removed
there (but I guess that was right after 26.3).  I'll revert that change.

I'm not sure what to do about this then.  Should we perhaps add
anything else to admin/release-process to remind about this, for example:

modified   admin/release-process
@@ -79,8 +79,10 @@ so e.g. admin/ is fine.)  This is important for
legal compliance.
 ** Remove temporary +++/--- lines in NEWS.
 But first make sure there are no unmarked entries, and update the
 documentation (or decide no updates are necessary) for those that aren't.

+** Remove "Temporary note" at the top of NEWS.
+
 ** Try to reorder NEWS: most important things first, related items together.

 ** For a major release, add a "New in Emacs XX" section to faq.texi.

Best regards,
Stefan Kangas

Message #26 received at 42917 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Stefan Kangas <stefankangas <at> gmail.com>
Cc: 42917 <at> debbugs.gnu.org, alex.branham <at> gmail.com, nico <at> petton.fr
Subject: Re: bug#42917: 27.1; temporary note included in 27 NEWS
Date: Wed, 19 Aug 2020 22:22:46 +0300

> From: Stefan Kangas <stefankangas <at> gmail.com>
> Date: Wed, 19 Aug 2020 18:58:57 +0000
> Cc: alex.branham <at> gmail.com, 42917 <at> debbugs.gnu.org, 
> 	Nicolas Petton <nico <at> petton.fr>
> 
> I'm not sure what to do about this then.  Should we perhaps add
> anything else to admin/release-process to remind about this, for example:
> 
> modified   admin/release-process
> @@ -79,8 +79,10 @@ so e.g. admin/ is fine.)  This is important for
> legal compliance.
>  ** Remove temporary +++/--- lines in NEWS.
>  But first make sure there are no unmarked entries, and update the
>  documentation (or decide no updates are necessary) for those that aren't.

Something like that, yes.  There's also admin/make-tarball.txt.

Message #29 received at 42917 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefankangas <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 42917 <at> debbugs.gnu.org, Glenn Morris <rgm <at> gnu.org>, alex.branham <at> gmail.com,
 Nicolas Petton <nico <at> petton.fr>
Subject: Re: bug#42917: 27.1; temporary note included in 27 NEWS
Date: Thu, 20 Aug 2020 02:58:10 -0700

Stefan Kangas <stefankangas <at> gmail.com> writes:

> Oh, I double-checked the emacs-26 branch and saw that it was removed
> there (but I guess that was right after 26.3).  I'll revert that change.

Reverted.  Glenn also pushed this:

Author: Glenn Morris <rgm <at> gnu.org>
Date:   Wed Aug 19 20:52:08 2020 +0100

    * admin/admin.el (set-version): Trap yet another NEWS error.

Is that sufficient to solve this issue, or is there more to do here?

Best regards,
Stefan Kangas

Message #32 received at 42917 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Stefan Kangas <stefankangas <at> gmail.com>
Cc: 42917 <at> debbugs.gnu.org, rgm <at> gnu.org, alex.branham <at> gmail.com, nico <at> petton.fr
Subject: Re: bug#42917: 27.1; temporary note included in 27 NEWS
Date: Thu, 20 Aug 2020 16:26:38 +0300

> From: Stefan Kangas <stefankangas <at> gmail.com>
> Date: Thu, 20 Aug 2020 02:58:10 -0700
> Cc: alex.branham <at> gmail.com, 42917 <at> debbugs.gnu.org, 
> 	Nicolas Petton <nico <at> petton.fr>, Glenn Morris <rgm <at> gnu.org>
> 
> Stefan Kangas <stefankangas <at> gmail.com> writes:
> 
> > Oh, I double-checked the emacs-26 branch and saw that it was removed
> > there (but I guess that was right after 26.3).  I'll revert that change.
> 
> Reverted.  Glenn also pushed this:
> 
> Author: Glenn Morris <rgm <at> gnu.org>
> Date:   Wed Aug 19 20:52:08 2020 +0100
> 
>     * admin/admin.el (set-version): Trap yet another NEWS error.
> 
> Is that sufficient to solve this issue, or is there more to do here?

I think this is sufficient, thanks.

Message #35 received at 42917 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefankangas <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 42917 <at> debbugs.gnu.org, rgm <at> gnu.org, alex.branham <at> gmail.com, nico <at> petton.fr
Subject: Re: bug#42917: 27.1; temporary note included in 27 NEWS
Date: Thu, 20 Aug 2020 07:19:49 -0700

close 42917 27.2
thanks

Eli Zaretskii <eliz <at> gnu.org> writes:

> I think this is sufficient, thanks.

OK; closing.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.