From owner-freebsd-hackers  Mon Jan 24 17:57:28 2000
Delivered-To: freebsd-hackers@freebsd.org
Received: from smtp02.teb1.iconnet.net (smtp02.teb1.iconnet.net [209.3.218.43])
	by hub.freebsd.org (Postfix) with ESMTP
	id C885C152AF; Mon, 24 Jan 2000 17:57:24 -0800 (PST)
	(envelope-from babkin@bellatlantic.net)
Received: from bellatlantic.net (client-151-198-135-129.bellatlantic.net [151.198.135.129])
	by smtp02.teb1.iconnet.net (8.9.1/8.9.1) with ESMTP id UAA17969;
	Mon, 24 Jan 2000 20:57:18 -0500 (EST)
Message-ID: <388D04B2.4CDD7B9A@bellatlantic.net>
Date: Mon, 24 Jan 2000 21:04:34 -0500
From: Sergey Babkin <babkin@bellatlantic.net>
X-Mailer: Mozilla 4.7 [en] (X11; U; FreeBSD 4.0-19990626-CURRENT i386)
X-Accept-Language: ru, en
MIME-Version: 1.0
To: Mike Smith <msmith@FreeBSD.ORG>
Cc: Bill Maniatty <maniattb@cs.rpi.edu>,
	Jeroen Ruigrok/Asmodai <asmodai@wxs.nl>, FreeBSD-doc@FreeBSD.ORG,
	maniatty@cs.albany.edu, freebsd-hackers@FreeBSD.ORG,
	Greg Lehey <grog@lemis.com>
Subject: Re: Learning the FreeBSD Kernel
References: <200001240049.QAA09005@mass.cdrom.com>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: owner-freebsd-hackers@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.ORG

Mike Smith wrote:
> 
> Writing documentation is a resource-sucking nuisance; supporting outdated
> documentation even more so.  The BSD driver model is sufficiently simple

I think that there might be a compromise
solution: when someone learns the interface
from analysing the code he might as well document
his findings in some way for others to read.
This would require minor additional effort.
I'm going to try this with CAM in a few weeks
and see whether this idea is viable.

-SB


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-hackers" in the body of the message