From owner-freebsd-small@FreeBSD.ORG  Thu Sep  8 17:44:16 2005
Return-Path: <owner-freebsd-small@FreeBSD.ORG>
X-Original-To: freebsd-small@freebsd.org
Delivered-To: freebsd-small@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 81FDE16A41F
	for <freebsd-small@freebsd.org>; Thu,  8 Sep 2005 17:44:14 +0000 (GMT)
	(envelope-from gnn@neville-neil.com)
Received: from mrout1.yahoo.com (mrout1.yahoo.com [216.145.54.171])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 72F7A43D6A
	for <freebsd-small@freebsd.org>; Thu,  8 Sep 2005 17:44:14 +0000 (GMT)
	(envelope-from gnn@neville-neil.com)
Received: from guest-157.lobby.yahoo.com.neville-neil.com
	(proxy7.corp.yahoo.com [216.145.48.98])
	by mrout1.yahoo.com (8.13.4/8.13.4/y.out) with ESMTP id j88Hg0e1093888; 
	Thu, 8 Sep 2005 10:42:01 -0700 (PDT)
Date: Thu, 08 Sep 2005 10:42:06 -0700
Message-ID: <m2vf1bwj69.wl%gnn@neville-neil.com>
From: "George V. Neville-Neil" <gnn@neville-neil.com>
To: Brooks Davis <brooks@one-eyed-alien.net>
In-Reply-To: <20050908165951.GE31354@odin.ac.hmc.edu>
References: <W903802119519351126194088@webmail2>
	<20050908165951.GE31354@odin.ac.hmc.edu>
User-Agent: Wanderlust/2.12.2 (99 Luftballons) SEMI/1.14.6 (Maruoka)
	FLIM/1.14.7 (=?ISO-8859-4?Q?Sanj=F2?=) APEL/10.6 Emacs/21.3.50
	(powerpc-apple-darwin8.1.0) MULE/5.0 (SAKAKI)
MIME-Version: 1.0 (generated by SEMI 1.14.6 - "Maruoka")
Content-Type: text/plain; charset=US-ASCII
Cc: freebsd-small@freebsd.org
Subject: Re: System Tree essentials UNDERSTANDING the system
X-BeenThere: freebsd-small@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Dedicated and Embedded Systems <freebsd-small.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-small>,
	<mailto:freebsd-small-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-small>
List-Post: <mailto:freebsd-small@freebsd.org>
List-Help: <mailto:freebsd-small-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-small>,
	<mailto:freebsd-small-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 08 Sep 2005 17:44:17 -0000

At Thu, 8 Sep 2005 09:59:51 -0700,
brooks wrote:
> > I'm sure, or at least i hope i'm not the only one who would like such
> > documentation.
> 
> We'd love to have such documenation, but creating it would be a massive
> task and keeping it up to date would be nearly as much work so no one
> has done it.

And if it were to be done I would strongly recommend Doxygen and some
relatively rigorous standards.  I would also be willing to help.

Later,
George