From owner-svn-src-all@freebsd.org Thu Aug 1 18:09:50 2019 Return-Path: Delivered-To: svn-src-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id D564DC46AB for ; Thu, 1 Aug 2019 18:09:50 +0000 (UTC) (envelope-from ian@freebsd.org) Received: from outbound3d.ore.mailhop.org (outbound3d.ore.mailhop.org [54.186.57.195]) (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 45zyxV0hQNz42Xr for ; Thu, 1 Aug 2019 18:09:49 +0000 (UTC) (envelope-from ian@freebsd.org) ARC-Seal: i=1; a=rsa-sha256; t=1564682989; cv=none; d=outbound.mailhop.org; s=arc-outbound20181012; b=g9ldrNijZT2fNWLoTP8CRA+JncZ3gVTmrWNhS9BHnx6cnF7UhKiXWJwRzt44lDSMIbSyt6i/Th5DN HqQq6O3/djqRGeNA99Frl04e0Kh9GzAc3mNc+cDSoHikx2I1vmZNsf9e6V/z4Pl6ccEU2Qr7LCCf7+ kjzP73w6R61rfnYUnH7D8xpy7bOwLB9t0zitCde1Xfg9FYJ7L5YLv0u24rjpY2R1cS2eAOdtEx/7J9 7HJJzGNGlv4SGAI64eSJ5Kxy6K1zZYi2zga4MfQ6hzFOd8+1AUenOLbCMsSLIUuJdMORJt2m4g9rz7 8a/W8nNl/4tU+FrHfVi9he9UvJgND9w== 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=7PvE+cWyFmnLIFMAJfkyGAH8MdJsUv2iEbfgBB54qrU=; b=Vt40PU+dY5UOYLnj/t0KQSXOMh6Wgjzk4tZH7m40sXWq4SIV2IWKurvDzYCQpWH8Iodx2GH/9nVYr k0QdvdvULKFALbf1be+zaG/0tQvs8P5Ut50nd2p2X9poB8MZJGBWwpZsOe4Y60KVJAJ8yVOsPP/WP3 /aWXHH3v6zOlvemnqoPF/HEIUT+9z9Lst3jlXpieteGzf2bZqQK3ZrV8mmQ+qtitRNSaeDfwnmh8iU p029ewr4Xa5HmqSHoHutXl4lvCkZL/CWkeyW1SKYJVLvhim9V8V5CrIAZjdMohj6ybheEf/yX9Txol RSX1nRnjALJOEDIcGg4ATFmndi/bU6A== ARC-Authentication-Results: i=1; outbound3.ore.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=7PvE+cWyFmnLIFMAJfkyGAH8MdJsUv2iEbfgBB54qrU=; b=myQeX2MIJJo4mykAEQ8n9+B278NeBfXpiL0kw1gh5VZOsZ98HuC7MxFF4ZVPZo5SQj9j+2cQliM7J Z+uMRsV/szH1Ubr7rvXyibci9dtbkxk2w10rPiczXh/nWi2Al7sNjhrpzcnT9kys5S+bCcGkoEOTda dtG4ipjHhmD6d1XPkSJd/dEMVra0qvFP+PTQkpHrAuhfR8fSNVLq+i631aYUMA90j7xHrCDoLLMSis cSovHdGZkehDncIBatYjRUK4pinTg2nsGhDA9FxHYhazXapgHyE2wU3XwOYksuqT9MQld7UTLnVZ3E sOZ407V90jCYEIcmc/ibdR8RZvHNPwg== X-MHO-RoutePath: aGlwcGll X-MHO-User: 8b80b073-b487-11e9-b679-cdd75d6ce7a8 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 outbound3.ore.mailhop.org (Halon) with ESMTPSA id 8b80b073-b487-11e9-b679-cdd75d6ce7a8; Thu, 01 Aug 2019 18:09:47 +0000 (UTC) Received: from rev (rev [172.22.42.240]) by ilsoft.org (8.15.2/8.15.2) with ESMTP id x71I9kCc002368; Thu, 1 Aug 2019 12:09:46 -0600 (MDT) (envelope-from ian@freebsd.org) Message-ID: Subject: Re: svn commit: r350505 - in head: contrib/binutils/binutils/doc gnu/usr.bin/binutils/objdump From: Ian Lepore To: John Baldwin , Ed Maste , "Rodney W. Grimes" Cc: src-committers , svn-src-all , svn-src-head Date: Thu, 01 Aug 2019 12:09:46 -0600 In-Reply-To: References: <201908011650.x71GoxBe060563@gndrsh.dnsmgr.net> 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: 45zyxV0hQNz42Xr X-Spamd-Bar: / Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-0.79 / 15.00]; local_wl_from(0.00)[freebsd.org]; NEURAL_HAM_SHORT(-0.79)[-0.791,0]; ASN(0.00)[asn:16509, ipnet:54.186.0.0/15, country:US] X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 01 Aug 2019 18:09:50 -0000 On Thu, 2019-08-01 at 10:39 -0700, John Baldwin wrote: > On 7/31/19 8:13 PM, Ed Maste wrote: > > On Thu, 1 Aug 2019 at 12:51, Rodney W. Grimes < > > freebsd@gndrsh.dnsmgr.net> wrote: > > > > > > That would be fine, the important thing is that the > > > r350505 gets listed in the file, > > > > I don't see any reason that r350505 specifically should be in a > > release note - this is a minor clarification of an existing > > deprecation notice. It seems having an overall "deprecation > > notices" > > section in the release notes would make sense, but they should > > really > > persist from version to version. Should we add a top-level > > DEPRECATION_NOTICES file perhaps? Or tag deprecation notices with > > some > > sort of comment in the source so they can be found with a 'grep' > > during release preparation? > > I think it would make sense to have "sections" in RELNOTES that mimic > the sections we have in the existing release notes (e.g. kernel vs > userland). That is effectively what GDB does with a top level NEWS > file. This approach would hopefully make it easier to translate this > file into the real release notes. It also means that a given "note" > can evolve over time (e.g. it might start with "XYZ is deprecated" to > "XYZ is removed" if a deprecation note is added and merged and later > it > is removed) rather than only having a running journal ala UPDATING. > > On the question of whether we want a dedicated section just for > deprecation notices, I'm not sure. Probably we can just stick with > the > layout of our existing release notes? > I wonder why it is that this relnotes file is some kind of major attractor for complexity? As I understand it, the *entire* intent of this file was "if you forget to add Relnotes: yes" to a commit, this gives you a way to flag the commit after the fact, since commit messages are immutable. If people realize they forgot Relnotes: yes, and the remedy for that is that they have to spelunk around in some complex formatted file to find the "right section" (whatever that means)... well, I think in the real world: they won't. -- Ian