From owner-freebsd-hackers@freebsd.org Mon Jun 24 15:08: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 7478815D06D8 for ; Mon, 24 Jun 2019 15:08:48 +0000 (UTC) (envelope-from freebsd-rwg@gndrsh.dnsmgr.net) Received: from gndrsh.dnsmgr.net (br1.CN84in.dnsmgr.net [69.59.192.140]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 916C67228C; Mon, 24 Jun 2019 15:08:47 +0000 (UTC) (envelope-from freebsd-rwg@gndrsh.dnsmgr.net) Received: from gndrsh.dnsmgr.net (localhost [127.0.0.1]) by gndrsh.dnsmgr.net (8.13.3/8.13.3) with ESMTP id x5OF8hOn044130; Mon, 24 Jun 2019 08:08:43 -0700 (PDT) (envelope-from freebsd-rwg@gndrsh.dnsmgr.net) Received: (from freebsd-rwg@localhost) by gndrsh.dnsmgr.net (8.13.3/8.13.3/Submit) id x5OF8hi4044129; Mon, 24 Jun 2019 08:08:43 -0700 (PDT) (envelope-from freebsd-rwg) From: "Rodney W. Grimes" Message-Id: <201906241508.x5OF8hi4044129@gndrsh.dnsmgr.net> Subject: Re: release notes file In-Reply-To: <56C57458-6274-47C6-A41D-0A6831A3F15E@cschubert.com> To: Cy Schubert Date: Mon, 24 Jun 2019 08:08:43 -0700 (PDT) CC: freebsd-hackers@freebsd.org, Mark Johnston , re@freebsd.org X-Mailer: ELM [version 2.4ME+ PL121h (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII X-Rspamd-Queue-Id: 916C67228C X-Spamd-Bar: ++ Authentication-Results: mx1.freebsd.org X-Spamd-Result: default: False [2.40 / 15.00]; ARC_NA(0.00)[]; NEURAL_HAM_MEDIUM(-0.11)[-0.109,0]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[4]; TO_DN_SOME(0.00)[]; NEURAL_SPAM_SHORT(0.91)[0.906,0]; MIME_GOOD(-0.10)[text/plain]; RCVD_TLS_LAST(0.00)[]; DMARC_NA(0.00)[dnsmgr.net]; AUTH_NA(1.00)[]; RCVD_COUNT_THREE(0.00)[3]; TO_MATCH_ENVRCPT_SOME(0.00)[]; MX_GOOD(-0.01)[cached: gndrsh.dnsmgr.net]; NEURAL_SPAM_LONG(0.67)[0.673,0]; R_SPF_NA(0.00)[]; FROM_EQ_ENVFROM(0.00)[]; R_DKIM_NA(0.00)[]; MIME_TRACE(0.00)[0:+]; ASN(0.00)[asn:13868, ipnet:69.59.192.0/19, country:US]; MID_RHS_MATCH_FROM(0.00)[]; IP_SCORE(0.04)[ip: (0.14), ipnet: 69.59.192.0/19(0.07), asn: 13868(0.05), country: US(-0.06)] 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 15:08:48 -0000 > On June 23, 2019 12:18:18 PM PDT, Mark Johnston 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. For those that did not install src's there is the formal Release Notes, which is what is condensed from this. Though the idea of a Makefile entry to populate /etc with a version of this for snapshots and other such things is an idea worth considering. > Cy Schubert -- Rod Grimes rgrimes@freebsd.org