From owner-freebsd-arch Fri Mar 16 12:12:57 2001 Delivered-To: freebsd-arch@freebsd.org Received: from fw.wintelcom.net (ns1.wintelcom.net [209.1.153.20]) by hub.freebsd.org (Postfix) with ESMTP id 8847F37B718; Fri, 16 Mar 2001 12:12:55 -0800 (PST) (envelope-from bright@fw.wintelcom.net) Received: (from bright@localhost) by fw.wintelcom.net (8.10.0/8.10.0) id f2GKCtk21795; Fri, 16 Mar 2001 12:12:55 -0800 (PST) Date: Fri, 16 Mar 2001 12:12:55 -0800 From: Alfred Perlstein To: Matt Dillon Cc: John Baldwin , arch@FreeBSD.ORG Subject: Re: Proposal for the CPU interrupt API Message-ID: <20010316121254.F29888@fw.wintelcom.net> References: <200103162002.f2GK2ON72390@earth.backplane.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <200103162002.f2GK2ON72390@earth.backplane.com>; from dillon@earth.backplane.com on Fri, Mar 16, 2001 at 12:02:24PM -0800 X-all-your-base: are belong to us. Sender: owner-freebsd-arch@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG * Matt Dillon [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 -- 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