From owner-freebsd-doc@FreeBSD.ORG  Sun May  4 21:45:12 2003
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 6DA7D37B401
	for <freebsd-doc@freebsd.org>; Sun,  4 May 2003 21:45:12 -0700 (PDT)
Received: from sixshooter.v6.thrupoint.net (sixshooter.v6.thrupoint.net
	[65.242.152.6])	by mx1.FreeBSD.org (Postfix) with ESMTP id B969D43F85
	for <freebsd-doc@freebsd.org>; Sun,  4 May 2003 21:45:11 -0700 (PDT)
	(envelope-from jpb@sixshooter.v6.thrupoint.net)
Received: from sixshooter.v6.thrupoint.net (localhost.v6.thrupoint.net
	[127.0.0.1])
	by sixshooter.v6.thrupoint.net (Postfix) with ESMTP id 2889D4CF9
	for <freebsd-doc@freebsd.org>; Mon,  5 May 2003 00:45:11 -0400 (EDT)
Received: (from jpb@localhost)h454jB9X096395
	for freebsd-doc@freebsd.org; Mon, 5 May 2003 00:45:11 -0400 (EDT)
Date: Mon, 5 May 2003 00:45:11 -0400
From: Jim Brown <jpb@sixshooter.v6.thrupoint.net>
To: freebsd-doc@freebsd.org
Message-ID: <20030505044511.GB96309@sixshooter.v6.thrupoint.net>
Mail-Followup-To: freebsd-doc@freebsd.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.4.1i
Subject: "Working With Manual Pages" Handbook Chapter Preview
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 05 May 2003 04:45:12 -0000

Hello all,

I'd like to present "Working With Manual Pages", available at
http://sixshooter.v6.thrupoint.net/manpg/book.html

The chapter SGML markup is at
http://sixshooter.v6.thrupoint.net/manpg/chapter.sgml

I used a doctored up book.sgml and some custom scripts to
piece it all together.  These are also available if needed.

Currently there doesn't seem to be a lot of material
on man page constuction and updating in the Handbook, 
the FDP, or the Developers Handbook.  This chapter gives 
a bit of background, and some interactive examples for 
anyone interested in man pages.

I intended to work through any corrections on groff or the mdoc
package with Ruslan, but I understand he is on vacation this week.
As a result, there may be some inaccuracies with those topics.

Your comments and suggestions are welcome.

Best Regards,
jpb
===