Date: Tue, 17 Feb 2004 23:13:48 +0100 From: Melvyn Sopacua <freebsd-current@webteckies.org> To: current@FreeBSD.org Subject: Re: Aligning GENERIC with NOTES? Message-ID: <200402172313.48811.freebsd-current@webteckies.org> In-Reply-To: <p0600200ebc58333220ea@[172.29.253.253]> References: <200402162041.i1GKfV4s056904@sleipnir.ncsa.uiuc.edu> <200402171938.i1HJckEA005628@dee.skynet.be> <p0600200ebc58333220ea@[172.29.253.253]>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] On Tuesday 17 February 2004 22:11, Brad Knowles wrote: > It is the less experienced/less knowledgeable people for whom we > should be concerned about with regards to POLA. And they would most > likely be least astonished by a GENERIC kernel description that is > well organized and makes sense, especially when compared to a larger > NOTES file. It has always annoyed me that LINT/NOTES are in different *order*. You keep bouncing up and down through the files, trying to understand why some things are left out and if they would benefit you. If the order is the same, it's very easy to work your way down and understand the design decisions made for GENERIC and read the more verbose comments in NOTES. In fact - I like postfix's approach: insert contents from X here, if you need feature foo. Besides being minor, fixing an ediff is also a *one-time* problem, vs an everlasting benefit of read/useability. My 2c. -- Melvyn ======================================================= FreeBSD sarevok.webteckies.org 5.2-CURRENT FreeBSD 5.2-CURRENT #2: Mon Feb 16 19:59:52 CET 2004 root@sarevok.webteckies.org:/usr/obj/usr/src/sys/SAREVOK_NOAPM_NODEBUG i386 ======================================================= [-- Attachment #2 --] -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQBAMpIcOv9JNmfFN5URAtn9AKCxFnzYEAOFzkvuzX2e8G+xJbSMJwCgg/0H R76JSYJd4/ZMc8N7ARYbIf4= =/z08 -----END PGP SIGNATURE-----help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200402172313.48811.freebsd-current>