From owner-freebsd-hackers@freebsd.org Sun Jun 23 21:20:16 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 1A89715DBAFE for ; Sun, 23 Jun 2019 21:20:16 +0000 (UTC) (envelope-from oliver.pinter@hardenedbsd.org) Received: from mail-yb1-xb2d.google.com (mail-yb1-xb2d.google.com [IPv6:2607:f8b0:4864:20::b2d]) (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 AA49B70A90 for ; Sun, 23 Jun 2019 21:20:14 +0000 (UTC) (envelope-from oliver.pinter@hardenedbsd.org) Received: by mail-yb1-xb2d.google.com with SMTP id l10so1618172ybj.5 for ; Sun, 23 Jun 2019 14:20:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=hardenedbsd.org; s=google; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=sBMDEqylY4yc4Nd9efTGmGbGbEWKRJ7lsB+bMkuuxYI=; b=LYPq8J61vNWEvhXxrGsR1HGMKfNjYNBn1Sk5tZikZGfKTUUK2YCQOZTgz3pgtVp8Rx CWbDK7+HqNwgTaH4MkkHFR8ohPvZnKdKNUG0uEIM/SSGKFgp0ishl8I7C+6X44cGGGdv rL9qL1WYl6X+/0jF0/WqbCHXrnW6QWDO6XayKRkZp/lwI4jxsRdTZPQ+GwOKzY4DTlwR A/MQtMSUsGUX/i5EueMDx1dkOFXGOdeA2J9mr5jpLrpBz8WHPeA4JCVyNVbkwvN5JO0j xPv+vKXAXDdMyaEn1q5MdWapIITHTC5PO3BieoXik8Dvr1sT0iTG9PnTMtqp+4iPO5UG n2vA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=sBMDEqylY4yc4Nd9efTGmGbGbEWKRJ7lsB+bMkuuxYI=; b=cAEGN0ck1tnUz0IqGsOrWdudSqGph8gykgIJ2hjKuj8+knxJukDCCk/roTY9PQZibe Y1HI2/zgUHrB8za2ipRdnyDgW9FgDEin6BKfAjjr2g45BqUt0QaBt+5S6X0cecL1DcDN 7xZzdebaEbxQDD5nuSwIZjW6qEQHa04spKsm9FsHqWIZDd8adxYu4N5xbSkJWGLh7PtG a71VMuXSdwDKJj9efg6VrwaHLE03Zz7HWehx8hALC3X/+i7ZDMEKJGuAoRZAYliooynE 8Kt9tN/Li8HhfDWDc72D6FjqM7E8Ag4jYpM6GSNWP8yuoqMb+2fJ0yMkYGbfHhuF19BB 63eQ== X-Gm-Message-State: APjAAAV0Wy9rcfkxY3IdIla7Exf/pbbKlkNoZtJ1GVVWBAIx6SUm4aYw rdTUAjvxL5T6O+EjKUrwfva8KtiPAIU3KX2I8hPyALZwRYk= X-Google-Smtp-Source: APXvYqw4a23JIiVy3J9O18OGuZmvHmdgGkqBrX6/EM1lIzUJtQFhotGAbrjcd5f/fEyGAUVb38nNkCxXxb9f3xO//H8= X-Received: by 2002:a25:8109:: with SMTP id o9mr69006737ybk.132.1561324813725; Sun, 23 Jun 2019 14:20:13 -0700 (PDT) MIME-Version: 1.0 Received: by 2002:a25:4a86:0:0:0:0:0 with HTTP; Sun, 23 Jun 2019 14:20:13 -0700 (PDT) In-Reply-To: <20190623191818.GA84365@raichu> References: <20190623191818.GA84365@raichu> From: Oliver Pinter Date: Sun, 23 Jun 2019 23:20:13 +0200 Message-ID: Subject: Re: release notes file To: Mark Johnston Cc: "freebsd-hackers@freebsd.org" , "re@freebsd.org" X-Rspamd-Queue-Id: AA49B70A90 X-Spamd-Bar: ------ Authentication-Results: mx1.freebsd.org; dkim=pass header.d=hardenedbsd.org header.s=google header.b=LYPq8J61; spf=pass (mx1.freebsd.org: domain of oliver.pinter@hardenedbsd.org designates 2607:f8b0:4864:20::b2d as permitted sender) smtp.mailfrom=oliver.pinter@hardenedbsd.org X-Spamd-Result: default: False [-6.36 / 15.00]; ARC_NA(0.00)[]; TO_DN_EQ_ADDR_SOME(0.00)[]; R_DKIM_ALLOW(-0.20)[hardenedbsd.org:s=google]; NEURAL_HAM_MEDIUM(-1.00)[-1.000,0]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[3]; R_SPF_ALLOW(-0.20)[+ip6:2607:f8b0:4000::/36]; 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)[hardenedbsd.org]; TO_DN_SOME(0.00)[]; RCVD_COUNT_THREE(0.00)[3]; TO_MATCH_ENVRCPT_SOME(0.00)[]; DKIM_TRACE(0.00)[hardenedbsd.org:+]; MX_GOOD(-0.01)[alt1.aspmx.l.google.com,aspmx.l.google.com,aspmx2.googlemail.com,alt2.aspmx.l.google.com,aspmx3.googlemail.com]; RCVD_IN_DNSWL_NONE(0.00)[d.2.b.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.84)[-0.845,0]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+,1:+]; RCVD_TLS_LAST(0.00)[]; ASN(0.00)[asn:15169, ipnet:2607:f8b0::/32, country:US]; IP_SCORE(-3.00)[ip: (-9.49), ipnet: 2607:f8b0::/32(-3.14), asn: 15169(-2.33), country: US(-0.06)] 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 21:20:16 -0000 On Sunday, June 23, 2019, 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. In the future with git you could easily add meta infos for specific commits. The project currently using this to store git-svn meta, but you can add more the one note to each commit. W > > 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" >