From owner-freebsd-hackers@freebsd.org Sun Jun 23 19:18:25 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 A513415D7C48 for ; Sun, 23 Jun 2019 19:18:25 +0000 (UTC) (envelope-from markjdb@gmail.com) Received: from mail-io1-xd2d.google.com (mail-io1-xd2d.google.com [IPv6:2607:f8b0:4864:20::d2d]) (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 BB8B16A058; Sun, 23 Jun 2019 19:18:24 +0000 (UTC) (envelope-from markjdb@gmail.com) Received: by mail-io1-xd2d.google.com with SMTP id e3so1496662ioc.12; Sun, 23 Jun 2019 12:18:24 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:date:from:to:cc:subject:message-id:mime-version :content-disposition:user-agent; bh=QtIvPwUHo1YgKCnXglJ8G0SZbJdTINb7SX6sU24qy9w=; b=KFcno8OAi169Cel5TwFkAxZW0Dsz6jEAhv1V47zjhBsUsb3JeVpvBN3Pt2QCtFPMhN yErg8t872Fw2Qaf6yem9KN+FHPwLVBR44PI1kr4RQ9OLNs1gbHi7T6/hIdOtcnadMHSb oqQTRuO1ijDsXEdPcrA84H9RbVEj3Z3WZ1PVnk3o2onI+6c98x4Mvu5slifRl+VmKAJ9 sHx1K/aDssI7Plih8JBPJp3YFFoXDBiljMLaisjb6oYW7flr37XM9mczdCdqa4MGYzt1 XHTIz1FgIMEqE4PuebVrF+o32sPRl8MVfstM6rPMQ//jT3RcnsaJIwjh0Pzd1Uh5xHyI Wi8g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:date:from:to:cc:subject:message-id :mime-version:content-disposition:user-agent; bh=QtIvPwUHo1YgKCnXglJ8G0SZbJdTINb7SX6sU24qy9w=; b=gkGSOROjQKKDIdTdfopgZ/rRsJNaOWrx3iuP6+BchVJJpwzbqz0hlEZGpx/PvG1ptp ILNoSaPYlgjXhIRLpG7Ew5zYejLaEPX8CJj1sbOkf6VO7nn75WwTOrTG2rLDPCPqrVOn 4mHBvswMCVAIKoIqGaLNqeVdcqXFYZ6VeoUyRqfGiqrymKGxn4gURI7YCk5sHwLTfWHZ OrAHxcNbqEJ1zDKXcFwz64Woz22xVrLOANozibek3u9/TJ5FWV/K04ZIBzpP56hfWArr p6kE9eNTEY2JsHbKmCp9KGYBw1JY9hgzRmRIiwCoJy//q7DDY6JyV5VRVGpkakKt941P /IUw== X-Gm-Message-State: APjAAAVj7rvMDKIAyEq35hkpcGQLVZ9mWHbs9dLLqpQfAzG8sANj+qQr 8H6zg15t5ZnpJZfg4dMgzKuY/kWK X-Google-Smtp-Source: APXvYqw7lyzN601Q+C+GcqVJDkNNAIBoVstqCUhQ+UtPfCaeYM+14yekxyyZrla+1bhpjs1MPHA82Q== X-Received: by 2002:a6b:f114:: with SMTP id e20mr33226624iog.169.1561317503531; Sun, 23 Jun 2019 12:18:23 -0700 (PDT) Received: from raichu (toroon0560w-lp140-05-70-29-85-38.dsl.bell.ca. [70.29.85.38]) by smtp.gmail.com with ESMTPSA id n21sm7558203ioh.30.2019.06.23.12.18.22 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Sun, 23 Jun 2019 12:18:22 -0700 (PDT) Sender: Mark Johnston Date: Sun, 23 Jun 2019 15:18:18 -0400 From: Mark Johnston To: freebsd-hackers@freebsd.org Cc: re@freebsd.org Subject: release notes file Message-ID: <20190623191818.GA84365@raichu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.12.0 (2019-05-25) X-Rspamd-Queue-Id: BB8B16A058 X-Spamd-Bar: ----- Authentication-Results: mx1.freebsd.org; dkim=pass header.d=gmail.com header.s=20161025 header.b=KFcno8OA; spf=pass (mx1.freebsd.org: domain of markjdb@gmail.com designates 2607:f8b0:4864:20::d2d as permitted sender) smtp.mailfrom=markjdb@gmail.com X-Spamd-Result: default: False [-5.67 / 15.00]; ARC_NA(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; R_DKIM_ALLOW(-0.20)[gmail.com:s=20161025]; NEURAL_HAM_MEDIUM(-1.00)[-1.000,0]; FROM_HAS_DN(0.00)[]; R_SPF_ALLOW(-0.20)[+ip6:2607:f8b0:4000::/36]; TO_MATCH_ENVRCPT_ALL(0.00)[]; MIME_GOOD(-0.10)[text/plain]; MIME_TRACE(0.00)[0:+]; TO_DN_NONE(0.00)[]; DMARC_NA(0.00)[freebsd.org]; NEURAL_HAM_LONG(-1.00)[-1.000,0]; RCVD_COUNT_THREE(0.00)[3]; RCVD_TLS_LAST(0.00)[]; DKIM_TRACE(0.00)[gmail.com:+]; RCPT_COUNT_TWO(0.00)[2]; RCVD_IN_DNSWL_NONE(0.00)[d.2.d.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]; MX_GOOD(-0.01)[cached: alt3.gmail-smtp-in.l.google.com]; NEURAL_HAM_SHORT(-0.99)[-0.995,0]; IP_SCORE(-2.96)[ip: (-9.27), ipnet: 2607:f8b0::/32(-3.15), asn: 15169(-2.33), country: US(-0.06)]; FORGED_SENDER(0.30)[markj@freebsd.org,markjdb@gmail.com]; MID_RHS_NOT_FQDN(0.50)[]; FREEMAIL_ENVFROM(0.00)[gmail.com]; ASN(0.00)[asn:15169, ipnet:2607:f8b0::/32, country:US]; FROM_NEQ_ENVFROM(0.00)[markj@freebsd.org,markjdb@gmail.com] 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:18:25 -0000 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?