Date: Mon, 24 Jun 2019 06:47:08 -0700 From: Cy Schubert <Cy.Schubert@cschubert.com> To: freebsd-hackers@freebsd.org, Oliver Pinter <oliver.pinter@hardenedbsd.org>, Mark Johnston <markj@freebsd.org> Cc: "freebsd-hackers@freebsd.org" <freebsd-hackers@freebsd.org>, "re@freebsd.org" <re@freebsd.org> Subject: Re: release notes file Message-ID: <D5C285B1-F4B5-4534-B621-B713BED33F0C@cschubert.com> In-Reply-To: <CAPQ4ffsAr=neOdXnEv76No1fvv8378AFzzrd3s-5j40%2BrkU5Zg@mail.gmail.com> References: <20190623191818.GA84365@raichu> <CAPQ4ffsAr=neOdXnEv76No1fvv8378AFzzrd3s-5j40%2BrkU5Zg@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On June 23, 2019 2:20:13 PM PDT, Oliver Pinter <oliver=2Epinter@hardenedbsd= =2Eorg> wrote: >On Sunday, June 23, 2019, 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 > > > >In the future with git you could easily add meta infos for specific >commits=2E The project currently using this to store git-svn meta, but >you >can add more the one note to each commit=2E >W > > > > >> >> 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" >> >_______________________________________________ >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" It should be a =2Emd file to format it properly on github=2E The more I th= ink of it, a Makefile target to install it to / instead of /etc is more int= uitive=2E=20 --=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?D5C285B1-F4B5-4534-B621-B713BED33F0C>