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]>
next in thread | previous in thread | raw e-mail | index | archive | help
--Boundary-02=_cIpMAhM1HRiUsif Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Content-Disposition: inline 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= =20 bouncing up and down through the files, trying to understand why some thing= s=20 are left out and if they would benefit you. If the order is the same, it's= =20 very easy to work your way down and understand the design decisions made fo= r=20 GENERIC and read the more verbose comments in NOTES. In fact - I like postfix's approach: insert contents from X here, if you ne= ed=20 feature foo. Besides being minor, fixing an ediff is also a *one-time* problem, vs an=20 everlasting benefit of read/useability. My 2c. =2D-=20 Melvyn =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D =46reeBSD sarevok.webteckies.org 5.2-CURRENT FreeBSD 5.2-CURRENT #2: Mon Fe= b 16=20 19:59:52 CET 2004 =20 root@sarevok.webteckies.org:/usr/obj/usr/src/sys/SAREVOK_NOAPM_NODEBUG i386 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D --Boundary-02=_cIpMAhM1HRiUsif Content-Type: application/pgp-signature Content-Description: signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQBAMpIcOv9JNmfFN5URAtn9AKCxFnzYEAOFzkvuzX2e8G+xJbSMJwCgg/0H R76JSYJd4/ZMc8N7ARYbIf4= =/z08 -----END PGP SIGNATURE----- --Boundary-02=_cIpMAhM1HRiUsif--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200402172313.48811.freebsd-current>