From owner-freebsd-hackers@freebsd.org Sun Jun 23 19:36:13 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 3BFF015D8C24 for ; Sun, 23 Jun 2019 19:36:13 +0000 (UTC) (envelope-from ian@freebsd.org) Received: from outbound1a.eu.mailhop.org (outbound1a.eu.mailhop.org [52.58.109.202]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 7BB9B6C38C for ; Sun, 23 Jun 2019 19:36:12 +0000 (UTC) (envelope-from ian@freebsd.org) ARC-Seal: i=1; a=rsa-sha256; t=1561318570; cv=none; d=outbound.mailhop.org; s=arc-outbound20181012; b=NuOUlAiG2WYAAESOnn20sY9rxbTA1Bd9DouXQBWFh+FpiFRwQ8nlVGelmV0IPNhMH8RyKkCUaG+Hf qFSJkxLNBL1w4RKUELbhlJYh7US/dXsMGFJIagbGF0sZXnsSkcWpxQ9pCJjlTUTQ4FGT3O/fBqPULC 5AuvuJbc52sKC+hiwdUBfAV5ty2s/KnjEVk4X11FrTiS0R6EwIeO4tdOP3A9vc+xhOcDX+wNv8dVol iKplPM3PdZx4JylpZl4mN3MpH/EwYyrWMfuIVZRkcA74FC/Kin7SFBqH2QcGhnBH3A9I38pGTW99bb n61JZMHJwgFM/4RFPcuPXqG3NOwWYLw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=outbound.mailhop.org; s=arc-outbound20181012; h=content-transfer-encoding:mime-version:content-type:references:in-reply-to: date:cc:to:from:subject:message-id:dkim-signature:from; bh=0Ty5fhptkELO5USoeNa6bW4euz1ZjH3cVf8zb7OSXQ8=; b=viRMbC9PjGgG7vPXQdl4KT9pio+gHrPX7bJxqe1lwQxAlG3kvjAGBhVTqOD7mNkyczocVELKMleMv pa5felGlQiHL6nAFvKRwgWawsUWv8+lkqWCHqi1TjoXCylFrgSEMF+ulsINFvRSnrKoiNjqE2pU+JS SfuZYzJbznyFJwgRYtCAQmYB8aqMp1/T7o52vNJVWjmwCBU4e4BI2DdFifJTQTW6BXZWRIrEx5m9iz fjjMNr3rD338aEjErXkvn0g5J1egs8okTIRZrWh5wzbYHiP4xbbp939W7iOa/FFvIk18ZzGW73K5MJ PZiVi41uwNI9McOLUssnJagxwuY+89A== ARC-Authentication-Results: i=1; outbound2.eu.mailhop.org; spf=softfail smtp.mailfrom=freebsd.org smtp.remote-ip=67.177.211.60; dmarc=none header.from=freebsd.org; arc=none header.oldest-pass=0; DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outbound.mailhop.org; s=dkim-high; h=content-transfer-encoding:mime-version:content-type:references:in-reply-to: date:cc:to:from:subject:message-id:from; bh=0Ty5fhptkELO5USoeNa6bW4euz1ZjH3cVf8zb7OSXQ8=; b=enK9wkxTyg4iuatjjMUJpfXsd/4fiMohGhLvzjNn9+BGvB7O6DZ4BpzhNCRYWfW8afc3RWPxjsiRc lIBweDKXvfKEUuBuInwlO6r1nYkgnhp+M353HUxHWfQupt95Mp6J/rt1c2FduEz6hOs5REJA1An/aw aPeVanB2YMZz/7ya+rX8ahb7UT3NLHmcffxpcKMPaJaPbEecBbiDUGNZeaiXF7XnNl7QIkNBr5JymP sz74iBDzpAy+FIPkOpBy42+IPseBiVDa3IBhcaKmj95no+BV2NKc1z47YWWPPiTgOA38O9eDssiPoH QZbVseKLcRnEODzA/DE9oWT2iG0Es5g== X-MHO-RoutePath: aGlwcGll X-MHO-User: 2454ec69-95ee-11e9-8b8b-5bd8169b0639 X-Report-Abuse-To: https://support.duocircle.com/support/solutions/articles/5000540958-duocircle-standard-smtp-abuse-information X-Originating-IP: 67.177.211.60 X-Mail-Handler: DuoCircle Outbound SMTP Received: from ilsoft.org (unknown [67.177.211.60]) by outbound2.eu.mailhop.org (Halon) with ESMTPSA id 2454ec69-95ee-11e9-8b8b-5bd8169b0639; Sun, 23 Jun 2019 19:36:07 +0000 (UTC) Received: from rev (rev [172.22.42.240]) by ilsoft.org (8.15.2/8.15.2) with ESMTP id x5NJa5bA039456; Sun, 23 Jun 2019 13:36:05 -0600 (MDT) (envelope-from ian@freebsd.org) Message-ID: <0175a71fb726c80b450497ecd6acc7ff5404276a.camel@freebsd.org> Subject: Re: release notes file From: Ian Lepore To: Mark Johnston , freebsd-hackers@freebsd.org Cc: re@freebsd.org Date: Sun, 23 Jun 2019 13:36:05 -0600 In-Reply-To: <20190623191818.GA84365@raichu> References: <20190623191818.GA84365@raichu> Content-Type: text/plain; charset="UTF-8" X-Mailer: Evolution 3.28.5 FreeBSD GNOME Team Mime-Version: 1.0 Content-Transfer-Encoding: 7bit X-Rspamd-Queue-Id: 7BB9B6C38C X-Spamd-Bar: -- Authentication-Results: mx1.freebsd.org X-Spamd-Result: default: False [-2.99 / 15.00]; local_wl_from(0.00)[freebsd.org]; NEURAL_HAM_MEDIUM(-1.00)[-1.000,0]; NEURAL_HAM_SHORT(-0.99)[-0.988,0]; NEURAL_HAM_LONG(-1.00)[-1.000,0]; ASN(0.00)[asn:16509, ipnet:52.58.0.0/15, country:US] 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: Sun, 23 Jun 2019 19:36:13 -0000 On Sun, 2019-06-23 at 15:18 -0400, 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? > I think it's a very good idea. -- Ian