From owner-freebsd-doc Mon Jan 24 19:31:12 2000 Delivered-To: freebsd-doc@freebsd.org Received: from yana.lemis.com (yana.lemis.com [192.109.197.140]) by hub.freebsd.org (Postfix) with ESMTP id 67D2015984; Mon, 24 Jan 2000 19:30:55 -0800 (PST) (envelope-from grog@mojave.worldwide.lemis.com) Received: from mojave.worldwide.lemis.com (j13.ktb6.jaring.my [161.142.234.27]) by yana.lemis.com (8.8.8/8.8.8) with ESMTP id OAA14058; Tue, 25 Jan 2000 14:00:45 +1030 (CST) (envelope-from grog@mojave.worldwide.lemis.com) Received: (from grog@localhost) by mojave.worldwide.lemis.com (8.9.3/8.9.3) id KAA04822; Tue, 25 Jan 2000 10:58:26 +0800 (MYT) (envelope-from grog) Date: Tue, 25 Jan 2000 10:58:26 +0800 From: Greg Lehey To: Jeroen Ruigrok/Asmodai Cc: Mike Smith , Bill Maniatty , FreeBSD-doc@FreeBSD.ORG, maniatty@cs.albany.edu, freebsd-hackers@FreeBSD.ORG Subject: Re: Learning the FreeBSD Kernel Message-ID: <20000125105825.B4775@mojave.worldwide.lemis.com> Reply-To: Greg Lehey References: <20000124123920.F2643@mojave.worldwide.lemis.com> <200001240635.WAA10110@mass.cdrom.com> <20000124100410.A691@daemon.ninth-circle.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0i In-Reply-To: <20000124100410.A691@daemon.ninth-circle.org>; from asmodai@wxs.nl on Mon, Jan 24, 2000 at 10:04:10AM +0100 WWW-Home-Page: http://www.lemis.com/~grog X-PGP-Fingerprint: 6B 7B C3 8C 61 CD 54 AF 13 24 52 F8 6D A4 95 EF Organization: LEMIS, PO Box 460, Echunga SA 5153, Australia Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-41-739-7062 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Monday, 24 January 2000 at 10:04:10 +0100, Jeroen Ruigrok/Asmodai wrote: > -On [20000124 08:01], Mike Smith (msmith@freebsd.org) wrote: >>> I can't agree with Mike Smith that reading the code is adequate. It >>> certainly doesn't apply to newcomers, but it doesn't even apply to >>> seasoned hackers like Mike: the BSD style doesn't provide for adequate >>> comments, and so what you see from the code is mainly tactics, not >>> strategy. >> >> You miss my point; you don't want to be writing a driver until you know >> what you're doing. Documentation on an OS' driver interface won't teach >> you that; it's something that's really only ever gleaned from experience. > > This I agree on with Mike. Writing device drivers isn't like > writing an application. In this respect, it is: I understand Mike to be saying "you can't learn by reading, you learn by doing". > The documentation I am writing will definately not be a tutorial > style piece of documentation, but a reference guide with sufficient > background material so that people a bit familiar with FreeBSD on > source level (note the ``a bit'') will get enough ideas and clues > from it to proceed forwards. I think it would benefit from tutorial style. That wouldn't be enough, but defining the workspace would make people a lot more comfortable. > I do not think making it a tutorial will be beneficial in the long run, > since I would have to discuss kernel sources, gdb, ddb and a number of > other things on the side. And that's a bad idea? I'd disagree. > I just know, from experience, that writing a driver involves more > than just code. Definitely. And that's one thing you've got to tell the newcomers. Greg -- Finger grog@lemis.com for PGP public key See complete headers for address and phone numbers To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message