From owner-freebsd-arch Thu Jan 4 11:57:23 2001 From owner-freebsd-arch@FreeBSD.ORG Thu Jan 4 11:57:21 2001 Return-Path: Delivered-To: freebsd-arch@freebsd.org Received: from post.mail.nl.demon.net (post-10.mail.nl.demon.net [194.159.73.20]) by hub.freebsd.org (Postfix) with ESMTP id B649637B404; Thu, 4 Jan 2001 11:57:19 -0800 (PST) Received: from [212.238.54.101] (helo=freebie.demon.nl) by post.mail.nl.demon.net with smtp (Exim 3.14 #2) id 14EGVh-0001lW-00; Thu, 04 Jan 2001 19:57:17 +0000 Received: (from wkb@localhost) by freebie.demon.nl (8.11.1/8.11.1) id f04JwBJ51829; Thu, 4 Jan 2001 20:58:11 +0100 (CET) (envelope-from wkb) Date: Thu, 4 Jan 2001 20:58:10 +0100 From: Wilko Bulte To: "Bruce A. Mah" Cc: John Baldwin , Marius Bendiksen , arch@freebsd.org, Alfred Perlstein , David Xu , Kris Kennaway Subject: Re: Release notes (was Re: retiring kernfs) Message-ID: <20010104205810.H22608@freebie.demon.nl> References: <200101041943.f04JhYH10969@bmah-freebsd-0.cisco.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <200101041943.f04JhYH10969@bmah-freebsd-0.cisco.com>; from bmah@freebsd.org on Thu, Jan 04, 2001 at 11:43:34AM -0800 X-OS: FreeBSD 4.2-STABLE X-PGP: finger wilko@freebsd.org Sender: owner-freebsd-arch@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On Thu, Jan 04, 2001 at 11:43:34AM -0800, Bruce A. Mah wrote: > If memory serves me right, John Baldwin wrote: > > > > Why not mandate a line of the form > > > RELEASE NOTE: yyyymmdd[hhmm[ss]] account - note > > > and then have an automated script gather these up regularly? > > To Marius: I presume you're referring to a mandatory line in commit > messages. The problem is that there's lots of commits that don't really > result in release note entries (i.e. fixing a typo in an error > message, or eliminating a compiler warning). I don't think automating release note entries would ever work. A carefully handcrafted relnote file is much better than one created automagically. > (Thanks, by the way, to anyone who's committed to the release notes > files, especially gshapiro and sanpei, who have been especially > consciencious about this.) That is exactly the point: consciencious one must be to produce good, readable and understandable information. Forcing people to write something up in a commit message *that is suitable for a relnote file* is impossible IMHO. -- Wilko Bulte Arnhem, the Netherlands wilko@freebsd.org http://www.freebsd.org http://www.nlfug.nl To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-arch" in the body of the message