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 ; 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 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]