From owner-freebsd-hackers  Wed Oct 29 14:59:47 1997
Return-Path: <owner-freebsd-hackers>
Received: (from root@localhost)
          by hub.freebsd.org (8.8.7/8.8.7) id OAA22649
          for hackers-outgoing; Wed, 29 Oct 1997 14:59:47 -0800 (PST)
          (envelope-from owner-freebsd-hackers)
Received: from word.smith.net.au (ppp20.portal.net.au [202.12.71.120])
          by hub.freebsd.org (8.8.7/8.8.7) with ESMTP id OAA22630
          for <hackers@freebsd.org>; Wed, 29 Oct 1997 14:59:42 -0800 (PST)
          (envelope-from mike@word.smith.net.au)
Received: from word.smith.net.au (localhost [127.0.0.1])
	by word.smith.net.au (8.8.7/8.8.5) with ESMTP id JAA02415;
	Thu, 30 Oct 1997 09:25:54 +1030 (CST)
Message-Id: <199710292255.JAA02415@word.smith.net.au>
X-Mailer: exmh version 2.0zeta 7/24/97
To: Alfred Perlstein <perlsta@cs.sunyit.edu>
cc: hackers@freebsd.org
Subject: Re: your commentary gripe (was  Re: svgalib? (forget the newbies) )
In-reply-to: Your message of "Wed, 29 Oct 1997 17:57:26 CDT."
             <Pine.BSF.3.96.971029174820.6656B-100000@server.local.sunyit.edu> 
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Date: Thu, 30 Oct 1997 09:25:51 +1030
From: Mike Smith <mike@smith.net.au>
Sender: owner-freebsd-hackers@freebsd.org
X-Loop: FreeBSD.org
Precedence: bulk

> (i hope no one takes offence at this, please badger me and show me where i
> can find stuff to answer this)

CVS logs.  "The Design and Implementation of the 4.4BSD Operating 
System".  -hackers list archive.

> specifically here's my gripe with FreeBSD and the XFree86 peoples, COMMENT
> YOUR CODE A LITTLE MORE DAMMIT :)

Are you complaining about FreeBSD code, or legacy CSRG code, or code 
from some other source?  If you want to undertake to comment all that 
old hair that nobody else ever did, please do!

> it's not just tracing through the code, i know the structure allows for
> such great things as CVSups and other methods of updating the sourcecode,
> but some simple documentation explaining how to not only make code for
> freebsd, but something that is compadible with the structures already in
> place would be nice...

There is no "simple documentation" because it's not "simple", and the 
effort of producing such documentation is pretty monstrous.  In most 
cases, the code is actually quite bearably followable, and once you 
learn your way around the system it only gets better.

However, if you want to write "BSD Kernel Source for Dummies", go right 
ahead...

mike