From owner-freebsd-questions@FreeBSD.ORG  Fri Dec 30 21:35:47 2011
Return-Path: <owner-freebsd-questions@FreeBSD.ORG>
Delivered-To: freebsd-questions@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 61055106564A
	for <freebsd-questions@freebsd.org>;
	Fri, 30 Dec 2011 21:35:47 +0000 (UTC)
	(envelope-from bonomi@mail.r-bonomi.com)
Received: from mail.r-bonomi.com (mx-out.r-bonomi.com [204.87.227.120])
	by mx1.freebsd.org (Postfix) with ESMTP id 3048F8FC12
	for <freebsd-questions@freebsd.org>;
	Fri, 30 Dec 2011 21:35:46 +0000 (UTC)
Received: (from bonomi@localhost)
	by mail.r-bonomi.com (8.14.4/rdb1) id pBULcZfw076474
	for freebsd-questions@freebsd.org; Fri, 30 Dec 2011 15:38:35 -0600 (CST)
Date: Fri, 30 Dec 2011 15:38:35 -0600 (CST)
From: Robert Bonomi <bonomi@mail.r-bonomi.com>
Message-Id: <201112302138.pBULcZfw076474@mail.r-bonomi.com>
To: freebsd-questions@freebsd.org
In-Reply-To: <CAGy-+i-m7hUfrUPKaG6FAiv8cor6+WXUW-OwWA=uOAt0yDToag@mail.gmail.com>
Subject: Re: FreeBSD Kernel Internals Documentation
X-BeenThere: freebsd-questions@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: User questions <freebsd-questions.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
	<mailto:freebsd-questions-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-questions>
List-Post: <mailto:freebsd-questions@freebsd.org>
List-Help: <mailto:freebsd-questions-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
	<mailto:freebsd-questions-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 30 Dec 2011 21:35:47 -0000


David Jackson <djackson452@gmail.com> wrte:
> Robert Bonomi <bonomi@mail.r-bonomi.com>wrote:
> > David Jackson <djackson452@gmail.com> wrte:
> > >
...
> > >
> > > However, My finding is that due to poor documentation, ...

 [ sneck remaineder of ill-informed trolling ]

> > Start with "The Design and Implementation of the BSD 4.4.4 Operating
> > System"
> > by McKusick, eal.
> >
> > Then read "The design and Implementation of the FreeBSD Operating System",
> > by McKusick and Neville-Neal.`
> >
> > *You* are free to contribute 'better documentation' as you review any
> > particular file.   Since you feel it is important, you are strongly
> > encouraged to "do something" to actually 'make it better', as opposed
> > to merely sitting on the sidelines and sniping at the work of others.
> >
> > Well, okay, yes, I have heard of these books.

Ah, you've "heard" of them.  And, you obviously haven't bothered to read 
them, right? 

Do you know _who_ McKusick is?  Or Bostic?  Or the other authors of the first
book I referenced?   Do you have any idea why it might be a good idea to start
with what they've written?

Do you know that manpages exist for a lot of kernel-mode functions?

Do you understand that with all that *external* documentation, there is 
little need to replicate it inside the source files?