From owner-freebsd-hackers@freebsd.org Mon Jun 24 13:47:48 2019 Return-Path: Delivered-To: freebsd-hackers@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id DFE2715CDBE8 for ; Mon, 24 Jun 2019 13:47:47 +0000 (UTC) (envelope-from cy.schubert@cschubert.com) Received: from smtp-out-no.shaw.ca (smtp-out-no.shaw.ca [64.59.134.12]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "Client", Issuer "CA" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 90A9E6EB60; Mon, 24 Jun 2019 13:47:46 +0000 (UTC) (envelope-from cy.schubert@cschubert.com) Received: from spqr.komquats.com ([70.67.125.17]) by shaw.ca with ESMTPA id fPJnhK2kUldkPfPJphdveq; Mon, 24 Jun 2019 07:47:38 -0600 X-Authority-Analysis: v=2.3 cv=Ko4zJleN c=1 sm=1 tr=0 a=VFtTW3WuZNDh6VkGe7fA3g==:117 a=VFtTW3WuZNDh6VkGe7fA3g==:17 a=jpOVt7BSZ2e4Z31A5e1TngXxSK0=:19 a=IkcTkHD0fZMA:10 a=xqWC_Br6kY4A:10 a=dq6fvYVFJ5YA:10 a=ypVJL4-jAAAA:8 a=6I5d2MoRAAAA:8 a=YxBL1-UpAAAA:8 a=9npE18AETBUPgtKCxG0A:9 a=QEXdDO2ut3YA:10 a=khIbc0fXALFIcTpOSxgJ:22 a=IjZwj45LgO3ly-622nXo:22 a=Ia-lj3WSrqcvXOmTRaiG:22 Received: from [IPv6:2605:8d80:404:19e0:896e:40fe:905f:4d17] (unknown [72.143.239.75]) by spqr.komquats.com (Postfix) with ESMTPSA id B15A096F; Mon, 24 Jun 2019 06:47:34 -0700 (PDT) Date: Mon, 24 Jun 2019 06:47:08 -0700 User-Agent: K-9 Mail for Android In-Reply-To: References: <20190623191818.GA84365@raichu> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Subject: Re: release notes file To: freebsd-hackers@freebsd.org, Oliver Pinter , Mark Johnston CC: "freebsd-hackers@freebsd.org" , "re@freebsd.org" From: Cy Schubert Message-ID: X-CMAE-Envelope: MS4wfGQSH61+4CFCmsK99bQRax5ZBJJAUEtgPVo+5hgxXeNCVdZ+xg4V73z+nEACeSCvoSVzTS63lTc+uR0eM9QpD6dOqdVn/jEm0Ze6FfOioFkNCqkN/XXw QxdvtDRP1s3BpRDy/TxfqsXsoX2QeAScIQ3iWzdYVnmERDOcDEx/B8k8W8Amcsy4rwNWigskFHUy3a/8BPoL3e6ad2bNv1HX2PasUyu43NYadOk6z1t+jnlq AXkgEvhkxpeXB0RKr/uLw74hcOqL2pUTiFcoYlpQVYbEVvE36UfhJ98cG3mJfASh X-Rspamd-Queue-Id: 90A9E6EB60 X-Spamd-Bar: ----- Authentication-Results: mx1.freebsd.org X-Spamd-Result: default: False [-5.70 / 15.00]; ARC_NA(0.00)[]; TO_DN_EQ_ADDR_SOME(0.00)[]; FROM_EQ_ENVFROM(0.00)[]; FROM_HAS_DN(0.00)[]; TO_DN_SOME(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; NEURAL_HAM_LONG(-1.00)[-1.000,0]; MIME_GOOD(-0.10)[text/plain]; RCVD_TLS_LAST(0.00)[]; NEURAL_HAM_MEDIUM(-1.00)[-1.000,0]; RCPT_COUNT_FIVE(0.00)[5]; RCVD_COUNT_THREE(0.00)[3]; TO_MATCH_ENVRCPT_SOME(0.00)[]; MX_GOOD(-0.01)[cached: spqr.komquats.com]; NEURAL_HAM_SHORT(-0.95)[-0.949,0]; R_SPF_NA(0.00)[]; RCVD_IN_DNSWL_LOW(-0.10)[12.134.59.64.list.dnswl.org : 127.0.5.1]; R_DKIM_NA(0.00)[]; MIME_TRACE(0.00)[0:+]; ASN(0.00)[asn:6327, ipnet:64.59.128.0/20, country:CA]; MID_RHS_MATCH_FROM(0.00)[]; IP_SCORE(-2.54)[ip: (-6.83), ipnet: 64.59.128.0/20(-3.26), asn: 6327(-2.53), country: CA(-0.09)]; RECEIVED_SPAMHAUS_PBL(0.00)[17.125.67.70.zen.spamhaus.org : 127.0.0.11] X-BeenThere: freebsd-hackers@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Technical Discussions relating to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 24 Jun 2019 13:47:48 -0000 On June 23, 2019 2:20:13 PM PDT, Oliver Pinter wrote: >On Sunday, June 23, 2019, Mark Johnston 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 FreeBSD UNIX: Web: http://www=2EFreeBSD=2Eorg The need of the many outweighs the greed of the few=2E