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>
next in thread | previous in thread | raw e-mail | index | archive | help
On June 23, 2019 12:18:18 PM PDT, Mark Johnston <markj@freebsd=2Eorg> wrote= : >Hi, > >Today we add a Relnotes tag to commits that warrant a release note=2E >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=2E I would like to propose adding a top-level >RELNOTES file instead, which like UPDATING would document notes for >specific commits=2E It would be truncated every time the head branch is >forked, and changes to it would be MFCed=2E This fixes the >above-mentioned problems and would hopefully reduce the amount of time >needed by re@ to compile release notes=2E > >For example: > >Index: RELNOTES >=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D >--- RELNOTES (nonexistent) >+++ RELNOTES (working copy) >@@ -0,0 +1,8 @@ >+Release notes for FreeBSD 13=2E0=2E >+ >+r349286: >+ swapon(8) can now erase a swap device immediately before >+ enabling it, similar to newfs(8)'s -E option=2E 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=2E > >What do folks think? >_______________________________________________ >freebsd-hackers@freebsd=2Eorg mailing list >https://lists=2Efreebsd=2Eorg/mailman/listinfo/freebsd-hackers >To unsubscribe, send any mail to >"freebsd-hackers-unsubscribe@freebsd=2Eorg" There should also be a Makefile target to install it into /etc for people = who do not install sources=2E --=20 Pardon the typos and autocorrect, small keyboard in use=2E Cheers, Cy Schubert <Cy=2ESchubert@cschubert=2Ecom> FreeBSD UNIX: <cy@FreeBSD=2Eorg> Web: http://www=2EFreeBSD=2Eorg The need of the many outweighs the greed of the few=2E
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?56C57458-6274-47C6-A41D-0A6831A3F15E>