From owner-freebsd-doc@FreeBSD.ORG  Mon May  5 05:55:34 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 E5B6037B401
	for <freebsd-doc@freebsd.org>; Mon,  5 May 2003 05:55:34 -0700 (PDT)
Received: from sixshooter.v6.thrupoint.net (sixshooter.v6.thrupoint.net
	[65.242.152.6])	by mx1.FreeBSD.org (Postfix) with ESMTP id 4D03343FAF
	for <freebsd-doc@freebsd.org>; Mon,  5 May 2003 05:55:34 -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 7F6F14CF9
	for <freebsd-doc@freebsd.org>; Mon,  5 May 2003 08:55:33 -0400 (EDT)
Received: (from jpb@localhost)h45CtXPn097283
	for freebsd-doc@freebsd.org; Mon, 5 May 2003 08:55:33 -0400 (EDT)
Date: Mon, 5 May 2003 08:55:33 -0400
From: Jim Brown <jpb@sixshooter.v6.thrupoint.net>
To: freebsd-doc@freebsd.org
Message-ID: <20030505125533.GA97216@sixshooter.v6.thrupoint.net>
Mail-Followup-To: freebsd-doc@freebsd.org
References: <20030505044511.GB96309@sixshooter.v6.thrupoint.net>
	<20030505003849.C225@freebsdmall.com> <3EB65D03.1070102@centtech.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <3EB65D03.1070102@centtech.com>
User-Agent: Mutt/1.4.1i
Subject: Re: "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 12:55:35 -0000

* Eric Anderson <anderson@centtech.com> [2003-05-05 08:46]:
> Murray Stokely wrote:
> >On Mon, May 05, 2003 at 12:45:11AM -0400, Jim Brown wrote:
> >
> >>I'd like to present "Working With Manual Pages", available at
> >>http://sixshooter.v6.thrupoint.net/manpg/book.html
> >
> >
> >Cool, I've wanted something like this for quite some time.
> >
> >I think the Developer's Handbook, the Doc Project Primer, or a
> >separate article would be suitable homes for this content.  I think
> >I'm leaning towards the Developer's Handbook (which I think should be
> >split up soon into two books -- one for kernel architecture and one
> >for general FreeBSD development).
> 
> I agree - I've also been wanting this for awhile.  One question - should 
> the "stirbits(1)" really be linked to the freebsd man pages (since it is 
> after all a fake man page)?  Doesn't seem like it to me..
> 
> Eric
> 

Good point- it might confuse people.  I'll try <command> 
and/or <literal> instead and work this change in sometime today.

Nice catch.

jpb
===