From owner-freebsd-current@FreeBSD.ORG Sat Feb 21 22:22:13 2004 Return-Path: Delivered-To: freebsd-current@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BBEEF16A4CE for ; Sat, 21 Feb 2004 22:22:13 -0800 (PST) Received: from mail.ncsa.uiuc.edu (mail.ncsa.uiuc.edu [141.142.2.28]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7858343D1D for ; Sat, 21 Feb 2004 22:22:13 -0800 (PST) (envelope-from koziol@ncsa.uiuc.edu) X-Envelope-From: koziol@ncsa.uiuc.edu X-Envelope-To: freebsd-current@freebsd.org Received: from sleipnir.ncsa.uiuc.edu (sleipnir.ncsa.uiuc.edu [141.142.96.70]) by mail.ncsa.uiuc.edu (8.11.7/8.11.6) with ESMTP id i1M6M6J11243; Sun, 22 Feb 2004 00:22:06 -0600 Received: from sleipnir.ncsa.uiuc.edu (localhost [127.0.0.1]) i1M6Lv5D038375; Sun, 22 Feb 2004 00:21:57 -0600 (CST) (envelope-from koziol@sleipnir.ncsa.uiuc.edu) Received: (from koziol@localhost) by sleipnir.ncsa.uiuc.edu (8.12.10/8.12.10/Submit) id i1M6LkkI035046; Sun, 22 Feb 2004 00:21:46 -0600 (CST) (envelope-from koziol) From: Quincey Koziol Message-Id: <200402220621.i1M6LkkI035046@sleipnir.ncsa.uiuc.edu> In-Reply-To: To: Brad Knowles Date: Sun, 22 Feb 2004 00:21:46 -0600 (CST) X-Mailer: ELM [version 2.4ME+ PL99f (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII cc: Randy Bush cc: =?ISO-8859-1?Q?Dag-Erling_Sm=F8rgrav___?= cc: freebsd-current@freebsd.org Subject: Re: Aligning GENERIC with NOTES? X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 22 Feb 2004 06:22:13 -0000 Hi all, I've put my reorganized versions of GENERIC and GENERIC.hints here: ftp://hdf.ncsa.uiuc.edu/pub/outgoing/koziol/GENERIC ftp://hdf.ncsa.uiuc.edu/pub/outgoing/koziol/GENERIC.hints I've tried to add information from the NOTES files where appropriate, but keep the changes to the comments on the devices/options/etc lines minimal so that these commands generate a very small diff: (I know that it's possible to fix these commands to generate essentially no diffs, but I'll leave that perl script up to someone with more time and perl-fu than I have right now... :-) sleipnir# grep -v ^# GENERIC.new | grep -v ^$ | sort > & new sleipnir# grep -v ^# GENERIC | grep -v ^$ | sort > & old sleipnir# diff -w old new I didn't go ahead with reorganizing the NOTES files to be more consistent with each other (i.e. list SCSI options, then ATA options, then NIC options, etc) because I haven't had the time yet. I know that changing the format of GENERIC is a potential bikeshed issue, but it would be nice if GENERIC wasn't _quite_ as crufty as it is... (There's a couple of places where options are listed in really odd orders... :-) BTW: it would be nice if mergemaster reviewed differences in GENERIC and the NOTES files also... Quincey > At 3:35 PM -0800 2004/02/17, Randy Bush wrote: > > >> It is the less experienced/less knowledgeable people for whom we > >> should be concerned about with regards to POLA. > > > > and when current becomes stable? > > Then we can make wholesale changes in the new current, while > making almost exclusively incremental improvements in stable. > > > what is the functional improvement of the change? what will > > the user actually get for the pain? > > A GENERIC kernel description that is more intelligently > organized? More easily understood? More easily modified to suit > situations that are close but not quite exactly the same? > > > a very very few of us who think the generic kernel text has > > crufted to the max over the years will. 10^(2..3) users who > > just make kernels will not be happy. > > Most users probably never make another kernel, or at least don't > know that's what they're doing. Of those that do, most probably > won't see the kernel files, they'll just rebuild what's there. > > However, the next group of users will see the files and it would > be very useful to the community as a whole for these files to be > well-organized, and in line with NOTES. Doing this right will help > reduce the number of questions asked related to this topic, and > eliminate the dumber questions that would have been asked if people > had read and understood the kernel file correctly, but got confused > because of the cruftage. > > -- > Brad Knowles, > > "They that can give up essential liberty to obtain a little temporary > safety deserve neither liberty nor safety." > -Benjamin Franklin, Historical Review of Pennsylvania. > > GCS/IT d+(-) s:+(++)>: a C++(+++)$ UMBSHI++++$ P+>++ L+ !E-(---) W+++(--) N+ > !w--- O- M++ V PS++(+++) PE- Y+(++) PGP>+++ t+(+++) 5++(+++) X++(+++) R+(+++) > tv+(+++) b+(++++) DI+(++++) D+(++) G+(++++) e++>++++ h--- r---(+++)* z(+++) >