Date: Mon, 12 Mar 2001 08:53:05 -0500 (EST) From: Robert Watson <rwatson@FreeBSD.ORG> To: Jeroen Ruigrok/Asmodai <asmodai@wxs.nl> Cc: Luigi Rizzo <luigi@info.iet.unipi.it>, Josef Karthauser <joe@tao.org.uk>, Ian Dowse <iedowse@FreeBSD.ORG>, cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: The Project and onward [was: Re: cvs commit: src/sys/netinet ip_output.c] Message-ID: <Pine.NEB.3.96L.1010312085059.44219A-100000@fledge.watson.org> In-Reply-To: <20010312144415.B47805@daemon.ninth-circle.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.NEB.3.96L.1010312085059.44219A-100000>