From owner-freebsd-arch Thu Jan 4 11:29: 7 2001 From owner-freebsd-arch@FreeBSD.ORG Thu Jan 4 11:29:05 2001 Return-Path: Delivered-To: freebsd-arch@freebsd.org Received: from meow.osd.bsdi.com (meow.osd.bsdi.com [204.216.28.88]) by hub.freebsd.org (Postfix) with ESMTP id 7A33B37B400; Thu, 4 Jan 2001 11:29:05 -0800 (PST) Received: from laptop.baldwin.cx (john@jhb-laptop.osd.bsdi.com [204.216.28.241]) by meow.osd.bsdi.com (8.11.1/8.9.3) with ESMTP id f04JSEG60610; Thu, 4 Jan 2001 11:28:14 -0800 (PST) (envelope-from jhb@FreeBSD.org) Message-ID: X-Mailer: XFMail 1.4.0 on FreeBSD X-Priority: 3 (Normal) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 8bit MIME-Version: 1.0 In-Reply-To: Date: Thu, 04 Jan 2001 11:29:11 -0800 (PST) From: John Baldwin To: Marius Bendiksen Subject: Re: Release notes (was Re: retiring kernfs) Cc: arch@FreeBSD.org, Alfred Perlstein , David Xu , Kris Kennaway , "Bruce A. Mah" Sender: owner-freebsd-arch@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On 04-Jan-01 Marius Bendiksen wrote: >> too much detail for our release notes. Basically, the problem is that >> the audience for our commit messages and the audience for "release >> notes" (as I perceive them anyways) are different. >> >> I've been doing a lot of the items for RELNOTES.TXT lately; it's >> sometimes hard figuring out what impact a given commit message is going >> to have on my-conception-of-the-average-user. Some other committers >> (I'm going to hold up gshapiro as a great example) do a wonderful job of >> documenting their commits in the release notes, which helps immensely. > > 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? If that would work, then committers would be adding lines to RELNOTES.TXT directly on their own. > Marius -- John Baldwin -- http://www.FreeBSD.org/~jhb/ PGP Key: http://www.baldwin.cx/~john/pgpkey.asc "Power Users Use the Power to Serve!" - http://www.FreeBSD.org/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-arch" in the body of the message