Date: Mon, 24 Jun 2019 06:41:45 -0700 From: Cy Schubert <Cy.Schubert@cschubert.com> To: freebsd-hackers@freebsd.org,Mark Johnston <markj@freebsd.org> Cc: re@freebsd.org Subject: Re: release notes file Message-ID: <56C57458-6274-47C6-A41D-0A6831A3F15E@cschubert.com> In-Reply-To: <20190623191818.GA84365@raichu> References: <20190623191818.GA84365@raichu>
index | next in thread | previous in thread | raw e-mail
On June 23, 2019 12:18:18 PM PDT, Mark Johnston <markj@freebsd.org> wrote: >Hi, > >Today we add a Relnotes tag to commits that warrant a release note. >My impression is that it doesn't work so well: if a committer forgets >or doesn't know to add one there's no way to amend the commit message >(same for MFCs), and a commit message isn't a convenient place to write >the text of a release note. I would like to propose adding a top-level >RELNOTES file instead, which like UPDATING would document notes for >specific commits. It would be truncated every time the head branch is >forked, and changes to it would be MFCed. This fixes the >above-mentioned problems and would hopefully reduce the amount of time >needed by re@ to compile release notes. > >For example: > >Index: RELNOTES >=================================================================== >--- RELNOTES (nonexistent) >+++ RELNOTES (working copy) >@@ -0,0 +1,8 @@ >+Release notes for FreeBSD 13.0. >+ >+r349286: >+ swapon(8) can now erase a swap device immediately before >+ enabling it, similar to newfs(8)'s -E option. This behaviour >+ can be specified by adding -E to swapon(8)'s command-line >+ parameters, or by adding the "trimonce" option to a swap >+ device's /etc/fstab entry. > >What do folks think? >_______________________________________________ >freebsd-hackers@freebsd.org mailing list >https://lists.freebsd.org/mailman/listinfo/freebsd-hackers >To unsubscribe, send any mail to >"freebsd-hackers-unsubscribe@freebsd.org" There should also be a Makefile target to install it into /etc for people who do not install sources. -- Pardon the typos and autocorrect, small keyboard in use. Cheers, Cy Schubert <Cy.Schubert@cschubert.com> FreeBSD UNIX: <cy@FreeBSD.org> Web: http://www.FreeBSD.org The need of the many outweighs the greed of the few.help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?56C57458-6274-47C6-A41D-0A6831A3F15E>