From owner-freebsd-current@FreeBSD.ORG  Tue Feb 17 14:13:52 2004
Return-Path: <owner-freebsd-current@FreeBSD.ORG>
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 636D116A4CF
	for <current@FreeBSD.org>; Tue, 17 Feb 2004 14:13:52 -0800 (PST)
Received: from sarevok.webteckies.org (node123e0.a2000.nl [24.132.35.224])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 31F8F43D31
	for <current@FreeBSD.org>; Tue, 17 Feb 2004 14:13:52 -0800 (PST)
	(envelope-from mdev@sarevok.webteckies.org)
Received: by sarevok.webteckies.org (Postfix, from userid 100)
	id 002BCB83A; Tue, 17 Feb 2004 23:13:48 +0100 (CET)
From: Melvyn Sopacua <freebsd-current@webteckies.org>
Organization: WebTeckies.org
To: current@FreeBSD.org
Date: Tue, 17 Feb 2004 23:13:48 +0100
User-Agent: KMail/1.5.94
References: <200402162041.i1GKfV4s056904@sleipnir.ncsa.uiuc.edu>
	<200402171938.i1HJckEA005628@dee.skynet.be>
	<p0600200ebc58333220ea@[172.29.253.253]>
In-Reply-To: <p0600200ebc58333220ea@[172.29.253.253]>
MIME-Version: 1.0
Content-Type: multipart/signed;
  protocol="application/pgp-signature";
  micalg=pgp-sha1;
  boundary="Boundary-02=_cIpMAhM1HRiUsif";
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Message-Id: <200402172313.48811.freebsd-current@webteckies.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
	<freebsd-current.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>,
	<mailto:freebsd-current-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-current>
List-Post: <mailto:freebsd-current@freebsd.org>
List-Help: <mailto:freebsd-current-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>,
	<mailto:freebsd-current-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 17 Feb 2004 22:13:52 -0000


--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--