From owner-freebsd-doc Sun Jan 23 16:41: 5 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mass.cdrom.com (castles537.castles.com [208.214.165.101]) by hub.freebsd.org (Postfix) with ESMTP id B0A7614D18; Sun, 23 Jan 2000 16:41:00 -0800 (PST) (envelope-from msmith@mass.cdrom.com) Received: from mass.cdrom.com (localhost [127.0.0.1]) by mass.cdrom.com (8.9.3/8.9.3) with ESMTP id QAA09005; Sun, 23 Jan 2000 16:49:18 -0800 (PST) (envelope-from msmith@mass.cdrom.com) Message-Id: <200001240049.QAA09005@mass.cdrom.com> X-Mailer: exmh version 2.1.1 10/15/1999 To: Bill Maniatty Cc: Jeroen Ruigrok/Asmodai , FreeBSD-doc@FreeBSD.ORG, maniatty@cs.albany.edu, freebsd-hackers@FreeBSD.ORG, Greg Lehey Subject: Re: Learning the FreeBSD Kernel In-reply-to: Your message of "Sun, 23 Jan 2000 11:48:39 EST." <200001231648.LAA53658@cs.rpi.edu> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Date: Sun, 23 Jan 2000 16:49:18 -0800 From: Mike Smith Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > > Actually the lack a reference or tutorial document is kind of damning > in a way, since it gives hardware vendors a powerful excuse not to > support FreeBSD in the way that say Lin*x is supported. We have a better solution; they just give us the documentation and we write the drivers for them. The end result is a better driver, produced in less time, and with a motivated maintainer. I've also written skeleton drivers for hardware vendors; typically they just have to fill in the very lowest level of the driver for their device, the rest can be generated in a couple of hours based on only the very simplest description. Writing documentation is a resource-sucking nuisance; supporting outdated documentation even more so. The BSD driver model is sufficiently simple that it's fair to say that if you can't work it out from the code, you probably shouldn't be writing a driver in the first place. That's not to say that a document describing the process wouldn't be good, merely that such a document isn't actually going to help _us_ very much at all. -- \\ Give a man a fish, and you feed him for a day. \\ Mike Smith \\ Tell him he should learn how to fish himself, \\ msmith@freebsd.org \\ and he'll hate you for a lifetime. \\ msmith@cdrom.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message