From owner-freebsd-hackers@freebsd.org Mon Jun 24 13:48:00 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 0992815CDBFE for ; Mon, 24 Jun 2019 13:48:00 +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 1C4826EB7B; Mon, 24 Jun 2019 13:47:59 +0000 (UTC) (envelope-from cy.schubert@cschubert.com) Received: from spqr.komquats.com ([70.67.125.17]) by shaw.ca with ESMTPA id fPK9hK2sildkPfPKAhdvhq; Mon, 24 Jun 2019 07:47:58 -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=6I5d2MoRAAAA:8 a=YxBL1-UpAAAA:8 a=lTTchZjeOa9R918DG7oA:9 a=QEXdDO2ut3YA:10 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 02CEB974; Mon, 24 Jun 2019 06:47:56 -0700 (PDT) Date: Mon, 24 Jun 2019 06:41:45 -0700 User-Agent: K-9 Mail for Android In-Reply-To: <20190623191818.GA84365@raichu> 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,Mark Johnston CC: re@freebsd.org From: Cy Schubert Message-ID: <56C57458-6274-47C6-A41D-0A6831A3F15E@cschubert.com> X-CMAE-Envelope: MS4wfF+8k4NEvAg2P+jRVjHQMo2tkfgJWUFtKfpVeLHMTdJEiwNS0ZVHfMglJPIRx8TqbYI+YAN5ZyCeldUjKLpJTOmvTi7xnyN5sQMEhc0zjc+GaNschLPe 6EUtwhggbC+GXUPIlzkCf9aTN3oC9QcZZHUjS6kTDoL0rFcPc3pBJnwaG2TN78+dqkYrMQVqWc7csr9NfNb7cGRMl7u4ktJ7U7OEMv8KMLD6OTFRL7JgJ0EA U8YlyKUn4tRYjv1VJUJGvw== X-Rspamd-Queue-Id: 1C4826EB7B X-Spamd-Bar: ----- Authentication-Results: mx1.freebsd.org X-Spamd-Result: default: False [-5.71 / 15.00]; ARC_NA(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; RECEIVED_SPAMHAUS_PBL(0.00)[17.125.67.70.zen.spamhaus.org : 127.0.0.11]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[3]; TO_MATCH_ENVRCPT_ALL(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]; TO_DN_SOME(0.00)[]; RCVD_COUNT_THREE(0.00)[3]; IP_SCORE(-2.55)[ip: (-6.85), ipnet: 64.59.128.0/20(-3.27), asn: 6327(-2.53), country: CA(-0.09)]; MX_GOOD(-0.01)[cached: spqr.komquats.com]; NEURAL_HAM_SHORT(-0.95)[-0.953,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:6327, ipnet:64.59.128.0/20, country:CA]; MID_RHS_MATCH_FROM(0.00)[]; RCVD_IN_DNSWL_LOW(-0.10)[12.134.59.64.list.dnswl.org : 127.0.5.1] 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:48:00 -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=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 FreeBSD UNIX: Web: http://www=2EFreeBSD=2Eorg The need of the many outweighs the greed of the few=2E