From owner-cvs-all Mon Mar 12 5:55:45 2001 Delivered-To: cvs-all@freebsd.org Received: from fledge.watson.org (fledge.watson.org [204.156.12.50]) by hub.freebsd.org (Postfix) with ESMTP id 2816437B718; Mon, 12 Mar 2001 05:55:39 -0800 (PST) (envelope-from robert@fledge.watson.org) Received: from fledge.watson.org (robert@fledge.pr.watson.org [192.0.2.3]) by fledge.watson.org (8.11.1/8.11.1) with SMTP id f2CDr5h44348; Mon, 12 Mar 2001 08:53:05 -0500 (EST) (envelope-from robert@fledge.watson.org) Date: Mon, 12 Mar 2001 08:53:05 -0500 (EST) From: Robert Watson X-Sender: robert@fledge.watson.org To: Jeroen Ruigrok/Asmodai Cc: Luigi Rizzo , Josef Karthauser , Ian Dowse , cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: The Project and onward [was: Re: cvs commit: src/sys/netinet ip_output.c] In-Reply-To: <20010312144415.B47805@daemon.ninth-circle.org> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On Mon, 12 Mar 2001, Jeroen Ruigrok/Asmodai wrote: > -On [20010312 14:38], Robert Watson (rwatson@FreeBSD.ORG) wrote: > >On Mon, 12 Mar 2001, Jeroen Ruigrok/Asmodai wrote: > > > >> We have one problem, although John Baldwin et al. have worked very hard > >> on providing a lot of documentation for the current system under which > >> FreeBSD works I see a distinct number of kernel hackers not being able > >> to keep up with the recent changes. > > > >In fairness to John, I think you under-emphasize this point -- as new > >kernel APIs have been introduced in SMPng, they have been rigorously > >documented, and as API updates have occurred, the documentation has been > >updated in a timely and consistent manner. > > Yes, I agree with your sentiment. John has been doing an excellent job, > as well as the others, I was merely using some situations as a jump to > the real case. Yeah, I figured as much, and I don't disagree with your general point, just with SMPng as a possible example. I'm still hoping Adrian gets around to finishing and committing his VFS documentation work, because every time I deal with VFS, I have to read the kern/vfs* code, as well as at least two file systems, to figure out what is going on, and that (to me) points to a lack of documentation :-). "USTL" isn't something that one should always be proud of, especially for the various "generic" interfaces intended at providing abstractions over a variety of implementors. Robert N M Watson FreeBSD Core Team, TrustedBSD Project robert@fledge.watson.org NAI Labs, Safeport Network Services To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message