From owner-freebsd-doc Thu Mar 28 2:37: 0 2002 Delivered-To: freebsd-doc@freebsd.org Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65]) by hub.freebsd.org (Postfix) with ESMTP id 3989637B404; Thu, 28 Mar 2002 02:36:46 -0800 (PST) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.11.6/8.11.2) id g2SAaaJ20340; Thu, 28 Mar 2002 12:36:36 +0200 (EET) (envelope-from ru) Date: Thu, 28 Mar 2002 12:36:36 +0200 From: Ruslan Ermilov To: Murray Stokely Cc: Dima Dorfman , Chris Costello , freebsd-doc@FreeBSD.org Subject: Re: Cleaning up section 8 (Re: docs/35011) Message-ID: <20020328103636.GA17147@sunbay.com> References: <20020304165226.A7081@holly.calldei.com> <20020305004434.D76BC3E2F@bazooka.trit.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20020305004434.D76BC3E2F@bazooka.trit.org> User-Agent: Mutt/1.3.27i Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On Tue, Mar 05, 2002 at 12:44:29AM +0000, Dima Dorfman wrote: > Chris Costello wrote: > > 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? > > I agree in general, but please talk to ru before changing yp(8) to > yp(7); he just recently changed it from yp(4), and perhaps he had a > reason to choose section 8 over 7 ({Open,Net}BSD compatibility?). > I disagree. According to intro(8), this section contains information related to system operation and maintenance. adding_user(8) - procedure for adding new users crash(8) - FreeBSD system failures diskless(8) - booting a system over the network picobsd(8) - floppy disk based FreeBSD system sticky(8) - sticky text and append-only directories yp(8) - description of the YP/NIS system IMO all these relate to system operation and/or maintenance. Most of them also describe real commands. They fit nicely into this category. adding_user: chpass(1) and vipw(8) crash: dumpcore(8), savedump(8) and gdb(1) diskless: /etc/rc.diskless1 and /etc/rc.diskless2 (compare to rc(8)) picobsd: customized /etc/rc* sticky: explains sticky bit on dirs that strongly relates to maintenance yp: this manual is incomplete; OpenBSD and NetBSD have a more complete one with all YP commands referenced in SYNOPSIS Cheers, -- Ruslan Ermilov Sysadmin and DBA, ru@sunbay.com Sunbay Software AG, ru@FreeBSD.org FreeBSD committer, +380.652.512.251 Simferopol, Ukraine http://www.FreeBSD.org The Power To Serve http://www.oracle.com Enabling The Information Age To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message