From owner-freebsd-commit  Thu Dec 14 09:33:00 1995
Return-Path: owner-commit
Received: (from root@localhost)
          by freefall.freebsd.org (8.7.3/8.7.3) id JAA18302
          for freebsd-commit-outgoing; Thu, 14 Dec 1995 09:33:00 -0800 (PST)
Received: (from root@localhost)
          by freefall.freebsd.org (8.7.3/8.7.3) id JAA18005
          for cvs-all-outgoing; Thu, 14 Dec 1995 09:31:24 -0800 (PST)
Received: from wiley.csusb.edu (wiley.csusb.edu [139.182.2.2])
          by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id JAA17975
          for <cvs-all@freebsd.org>; Thu, 14 Dec 1995 09:31:03 -0800 (PST)
Received: (from rmallory@localhost) by wiley.csusb.edu (8.6.11/8.6.11) id JAA24436; Thu, 14 Dec 1995 09:35:50 -0800
From: Rob Mallory <rmallory@wiley.csusb.edu>
Message-Id: <199512141735.JAA24436@wiley.csusb.edu>
Subject: Re: cvs commit: src/share/man/man9 Makefile intro.9
To: phk@freefall.freebsd.org (Poul-Henning Kamp)
Date: Thu, 14 Dec 1995 09:35:50 -0800 (PST)
Cc: cvs-all@freebsd.org
In-Reply-To: <199512141008.CAA22911@freefall.freebsd.org> from "Poul-Henning Kamp" at Dec 14, 95 02:08:34 am
X-Mailer: ELM [version 2.4 PL22]
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Sender: owner-commit@freebsd.org
Precedence: bulk

> 
> phk         95/12/14 02:08:32
> 
>   Modified:    share/man  Makefile
>   Added:       share/man/man9  Makefile intro.9
>   Log:
>   Add a section 9 about the kernel to out man pages.
>   
>   Please help fill this out !
>   
>   Revision  Changes    Path
>   1.8       +1 -1      src/share/man/Makefile
> 
...did you get this idea from my posting last week?
Wow, if we could get the kernel, dev's and their 
interfaces documented, I think it would attract more
kernel hackers and device driver developers! 
The solaris2.5 developers kit has a preaty decent
section-9, broken down as:
 man9e (entry points)
 man9f (functions)
 man9s (structures)

A nice touch they throw in is source code examples
for generic device drivers including ncrscsi, 
ethernet, video, and audio.   

Things like this make it easy to just 'jump right in'
and also get a good feeling for what is where when
things go wrong. 

Rob Mallory   [rmallory@csusb.edu][mallorrp@sce.com]