From owner-freebsd-hackers@freebsd.org Sun Jun 23 19:32:57 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 94F6815D8A53 for ; Sun, 23 Jun 2019 19:32:57 +0000 (UTC) (envelope-from wlosh@bsdimp.com) Received: from mail-qk1-x734.google.com (mail-qk1-x734.google.com [IPv6:2607:f8b0:4864:20::734]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id BC98B6C1D7 for ; Sun, 23 Jun 2019 19:32:56 +0000 (UTC) (envelope-from wlosh@bsdimp.com) Received: by mail-qk1-x734.google.com with SMTP id p144so8203728qke.11 for ; Sun, 23 Jun 2019 12:32:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bsdimp-com.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=p8lDehDUG24Knafc190r6zhBNYp8VHbGAaDU/d19fr8=; b=LNBisFzkXAyQH/1sjFN+pz48JbS9TRs7eDTuIlSDusRr5En0G4QWC22ITzhAmBlFza v6QGB+mHhwWivetLLQtcvX9BWsJxZqo+MKOvyOJgvnuazvQmgATu6C8CTIXl2Y3HAobt Ttu5a86xzASJpRlABBxk0USfSzC/KSuxHG7uYDWHW1EAZddaV13j8aLDA/5jDovMm5Wl wjzYqyQeo1psile5zMij5dYFEVWZ+AHLMguXD7VmClKHYQr+Dru3B+nPoBeV0XJLFEEo eMpBMEdB1GBZ6EN5GPNkVbXUId4S65xHjerrf+4D9OLSXfa9stS8F4fQeUHK2LHA2I1a T9FQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=p8lDehDUG24Knafc190r6zhBNYp8VHbGAaDU/d19fr8=; b=M1pmxvAgUQaZLrnzR6QlUMQdEvMtzC5w2ed5uJOQHyVbIap6h44nS6Dx8BN7drd0o7 GcvACzt5NOcTVypNrmfTZGVad5zk516MUhg49LD35W9gCMv2D1IXMLyQPIGr2LlF9m5c bSu3qYBSO6i+98oK6gMPndJgdt3y5WsR2b0F78qZxy9hx+rmVCIdc0TguxczKXCGYUdw 1AtqaqjQSybJO/q2+alhp2XaOZHuZzs++sIKSwhBiG/uh/i+grBdkvPVEZ+9bVIJGfUq Ygoi00zcdG/gxFKKJc/YpH+7y2U2ev4kjal4+12goVXUHwAG44qXCPCzYgw93y7IyCCr zbzA== X-Gm-Message-State: APjAAAXQQwKeDr8CFB25QhlTLMcF8It+Balv66eff3IIcqb5A6IQ/9VZ rOx4Jsa8fnUSepE4xxz2ffMfbDx+fjQkCfdTdH+gEdeA448= X-Google-Smtp-Source: APXvYqyG0nhB7pJg6czQSNBHLHk5b8NKP17nPiSWvE1RcQJdyjWJX1iwXfzCo6nWO/D1xGUw6mBYOLpDMaz0SM75HBI= X-Received: by 2002:ae9:f107:: with SMTP id k7mr56386030qkg.215.1561318375726; Sun, 23 Jun 2019 12:32:55 -0700 (PDT) MIME-Version: 1.0 References: <20190623191818.GA84365@raichu> In-Reply-To: <20190623191818.GA84365@raichu> From: Warner Losh Date: Sun, 23 Jun 2019 13:32:44 -0600 Message-ID: Subject: Re: release notes file To: Mark Johnston Cc: "freebsd-hackers@freebsd.org" , FreeBSD Release Engineering Team X-Rspamd-Queue-Id: BC98B6C1D7 X-Spamd-Bar: ----- Authentication-Results: mx1.freebsd.org; dkim=pass header.d=bsdimp-com.20150623.gappssmtp.com header.s=20150623 header.b=LNBisFzk X-Spamd-Result: default: False [-5.89 / 15.00]; ARC_NA(0.00)[]; TO_DN_EQ_ADDR_SOME(0.00)[]; R_DKIM_ALLOW(-0.20)[bsdimp-com.20150623.gappssmtp.com:s=20150623]; NEURAL_HAM_MEDIUM(-1.00)[-1.000,0]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[3]; TO_DN_SOME(0.00)[]; NEURAL_HAM_LONG(-1.00)[-1.000,0]; MIME_GOOD(-0.10)[multipart/alternative,text/plain]; PREVIOUSLY_DELIVERED(0.00)[freebsd-hackers@freebsd.org]; DMARC_NA(0.00)[bsdimp.com]; TO_MATCH_ENVRCPT_SOME(0.00)[]; DKIM_TRACE(0.00)[bsdimp-com.20150623.gappssmtp.com:+]; MX_GOOD(-0.01)[cached: ALT1.aspmx.l.google.com]; RCVD_IN_DNSWL_NONE(0.00)[4.3.7.0.0.0.0.0.0.0.0.0.0.0.0.0.0.2.0.0.4.6.8.4.0.b.8.f.7.0.6.2.list.dnswl.org : 127.0.5.0]; NEURAL_HAM_SHORT(-0.87)[-0.873,0]; R_SPF_NA(0.00)[]; FORGED_SENDER(0.30)[imp@bsdimp.com,wlosh@bsdimp.com]; MIME_TRACE(0.00)[0:+,1:+]; RCVD_TLS_LAST(0.00)[]; ASN(0.00)[asn:15169, ipnet:2607:f8b0::/32, country:US]; FROM_NEQ_ENVFROM(0.00)[imp@bsdimp.com,wlosh@bsdimp.com]; IP_SCORE(-3.00)[ip: (-9.48), ipnet: 2607:f8b0::/32(-3.15), asn: 15169(-2.33), country: US(-0.06)]; RCVD_COUNT_TWO(0.00)[2] Content-Type: text/plain; charset="UTF-8" X-Content-Filtered-By: Mailman/MimeDel 2.1.29 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:32:57 -0000 I love it. I proposed something similar before, and it went nowhere. I often forget, or realize after the fact that something should be in the release notes. Warner On Sun, Jun 23, 2019 at 1:21 PM 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" >