Date: Fri, 16 Mar 2001 12:12:55 -0800 From: Alfred Perlstein <bright@wintelcom.net> To: Matt Dillon <dillon@earth.backplane.com> Cc: John Baldwin <jhb@FreeBSD.ORG>, arch@FreeBSD.ORG Subject: Re: Proposal for the CPU interrupt API Message-ID: <20010316121254.F29888@fw.wintelcom.net> In-Reply-To: <200103162002.f2GK2ON72390@earth.backplane.com>; from dillon@earth.backplane.com on Fri, Mar 16, 2001 at 12:02:24PM -0800 References: <XFMail.010316113800.jhb@FreeBSD.org> <200103162002.f2GK2ON72390@earth.backplane.com>
next in thread | previous in thread | raw e-mail | index | archive | help
* Matt Dillon <dillon@earth.backplane.com> [010316 12:02] wrote: > :And if you would actually read all of the post and keep up to date with the > :code so that you weren't telling us to do what we are already doing it would be > :more helpful, too. Honestly, Matt, you're sort of reminding me of Terry here. > : > :> -Matt > : > : > :John Baldwin <jhb@FreeBSD.org> -- http://www.FreeBSD.org/~jhb/ > > Again, my only issue here is documentation. *You* and the other people > *currently* working on SMPng might know how it works, but take a good > hard look at the actual documentation in the source code. There is none. > Zilch. Zero. Not one single line describing the API anywhere. I don't > see any comments near the function source, I don't see any man-9 pages. > Nothing. > > So how do you expect people coming onto the project to know how to use > these functions? Do they have to learn the hard way, by coding it wrong, > breaking the tree, and then being told what it is? Do they have to guess? > > Compare that against, say, the documentation of the VM system that I > started working on two years ago. Look at vm_page_insert(), for example. Whoa there Matt... just as you told people to check the CVS logs for your contributions, you should have done the same for John. John has committed or been involved with committing major amounts of docco for the smpng APIs as well misc other stuff like the scheduler and header files. Everyone *breath* for a second, k? :) -- -Alfred Perlstein - [bright@wintelcom.net|alfred@freebsd.org] To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-arch" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010316121254.F29888>