From owner-cvs-all@FreeBSD.ORG  Thu May 18 17:15:50 2006
Return-Path: <owner-cvs-all@FreeBSD.ORG>
X-Original-To: cvs-all@FreeBSD.org
Delivered-To: cvs-all@FreeBSD.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 526A116A482;
	Thu, 18 May 2006 17:15:50 +0000 (UTC)
	(envelope-from gnn@neville-neil.com)
Received: from mrout2.yahoo.com (mrout2.yahoo.com [216.145.54.172])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 28AE943D70;
	Thu, 18 May 2006 17:15:40 +0000 (GMT)
	(envelope-from gnn@neville-neil.com)
Received: from minion.local.neville-neil.com (proxy7.corp.yahoo.com
	[216.145.48.98])
	by mrout2.yahoo.com (8.13.6/8.13.4/y.out) with ESMTP id k4IHERKf035989; 
	Thu, 18 May 2006 10:14:28 -0700 (PDT)
Date: Thu, 18 May 2006 10:14:26 -0700
Message-ID: <m2ejyrl0gd.wl%gnn@neville-neil.com>
From: "George V. Neville-Neil" <gnn@neville-neil.com>
To: "Poul-Henning Kamp" <phk@phk.freebsd.dk>
In-Reply-To: <39318.1147960050@critter.freebsd.dk>
References: <200605181516.15541.hm@kts.org>
	<39318.1147960050@critter.freebsd.dk>
User-Agent: Wanderlust/2.14.0 (Africa) SEMI/1.14.6 (Maruoka) FLIM/1.14.8
	(=?ISO-8859-4?Q?Shij=F2?=) APEL/10.6 Emacs/22.0.50
	(i386-apple-darwin8.5.1) MULE/5.0 (SAKAKI)
MIME-Version: 1.0 (generated by SEMI 1.14.6 - "Maruoka")
Content-Type: text/plain; charset=US-ASCII
Cc: cvs-src@FreeBSD.org, src-committers@FreeBSD.org,
	Julian Elischer <julian@elischer.org>, cvs-all@FreeBSD.org,
	hellmuth.michaelis@t-online.de
Subject: Re: cvs commit: src Makefile.inc1 ObsoleteFiles.inc
	src/etc/defaults rc.conf src/etc/mtree BSD.usr.dist
	src/etc/rc.d Makefile isdnd pcvt syscons
	src/release/picobsd/build picobsd src/share/man/man4 Makefile
	atkbd.4 kbdmux.4 pcvt.4 splash.4 vkbd.4 ... 
X-BeenThere: cvs-all@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: CVS commit messages for the entire tree <cvs-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-all>
List-Post: <mailto:cvs-all@freebsd.org>
List-Help: <mailto:cvs-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 18 May 2006 17:15:52 -0000

At Thu, 18 May 2006 15:47:30 +0200,
Poul-Henning Kamp wrote:
> Part of the problem is that there will never be a "definitive kernel
> API manual" for FreeBSD, it will always be in flux and therefore
> drivers will need to be updated to keep abreast.

I so hate to chime in on this thread, but I really think we need to
start putting things into the code and using Doxygen, or a moral
equivalent, to at least have a chance of keeping such things up to
date.  Someone a while back set up a proper Doxygen file for use with
FreeBSD and we might simply pursue that tack.

Later,
George