From owner-freebsd-doc  Mon Mar  4 23: 7:51 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP
	id 1A33137B400; Mon,  4 Mar 2002 23:07:48 -0800 (PST)
Received: from thig.blarg.net (thig.blarg.net [206.124.128.18])
	by lists.blarg.net (Postfix) with ESMTP
	id BDC61BD70; Mon,  4 Mar 2002 23:07:47 -0800 (PST)
Received: from localhost.localdomain ([206.124.139.115])
	by thig.blarg.net (8.9.3/8.9.3) with ESMTP id XAA06268;
	Mon, 4 Mar 2002 23:07:47 -0800
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.6/8.11.3) id g257BGF12288;
	Mon, 4 Mar 2002 23:11:17 -0800 (PST)
	(envelope-from swear@blarg.net)
To: chris@FreeBSD.ORG
Cc: freebsd-doc@FreeBSD.ORG
Subject: Re: Cleaning up section 8 (Re: docs/35011)
References: <200202162200.g1GM03452105@freefall.freebsd.org>
	<20020304165226.A7081@holly.calldei.com>
From: swear@blarg.net (Gary W. Swearingen)
Date: 04 Mar 2002 23:11:16 -0800
In-Reply-To: <20020304165226.A7081@holly.calldei.com>
Message-ID: <izelizh4kr.liz@localhost.localdomain>
Lines: 24
User-Agent: Gnus/5.0808 (Gnus v5.8.8) XEmacs/21.1 (Cuyahoga Valley)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

Chris Costello <chris@FreeBSD.ORG> writes:

> On Saturday, February 16, 2002, Chris Costello wrote:
> >     Actually, there is a command called `jail'.  However,
> >  diskless(8) should probably become diskless(7).
> 
>    Moreover, I propose that we move all non-commands out of
> section 8:
> 
> adding_user.8   diskless.8      sticky.8
> crash.8         picobsd.8       yp.8
> 
>    I vote that they be moved into section 7 (Miscellaneous
> Information Manual).  Anybody agree with me?

Looking at intro(8) and taking the first description sentence out of
context leads me to believe that someone thought some non-commands
belonged there.  It specifically mentions "crash".  It could use a
rewrite no matter what decision is made regarding section 8. I have
no opinion on that.

I was suprised that these things weren't described (at least briefly) in
the man(1) man page and I didn't find them in the handbook (though my
note says they are there).  Probably, man(1) should mention intro(*).

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message