From owner-freebsd-doc@FreeBSD.ORG Wed Apr 30 16:40:16 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id CCEDE37B401 for ; Wed, 30 Apr 2003 16:40:16 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 38FB843FBD for ; Wed, 30 Apr 2003 16:40:16 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h3UNeFUp057824 for ; Wed, 30 Apr 2003 16:40:15 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h3UNeF26057820; Wed, 30 Apr 2003 16:40:15 -0700 (PDT) Date: Wed, 30 Apr 2003 16:40:15 -0700 (PDT) Message-Id: <200304302340.h3UNeF26057820@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: "Simon L. Nielsen" Subject: Re: docs/35011: There are no commands called "diskless" or "jail" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: "Simon L. Nielsen" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 30 Apr 2003 23:40:17 -0000 The following reply was made to PR docs/35011; it has been noted by GNATS. From: "Simon L. Nielsen" To: freebsd-gnats-submit@FreeBSD.org, kstailey@surfbest.net Cc: Subject: Re: docs/35011: There are no commands called "diskless" or "jail" Date: Thu, 1 May 2003 01:35:24 +0200 --dzI2QqkSBOAresgT Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hello To summerize this bug : Several man pages from section 8 really should be moved to section 7 since section 7 should be for "system maintenance and operation commands". The ones I can find are (basically most of share/man/man8/) : adding_user crash diskless picobsd (this is strictly a command but hardly has anything to do with "system maintenance and operation commands"). sticky yp For the complete picture NetBSD appears to have modified their definition of what should be in section 8 to accomodate man pages like diskless(8) : A number of pages in this section describe general system management t= op- ics. For example, the diskless(8) page describes how to boot a system over a network, and the compat_linux(8) page describes how to run Linux binaries on NetBSD architectures that support it. OpenBSD still have diskless in section 8 but does not have generally noted this in intro(8) but do have : The section `crash' should be consulted to understand how to interpret system crash dumps. If the pages should be moved I can make the patch to update the relevant references from man pages / docbook documents and so on. My 0.02c is that this would be a good thing for consistency. --=20 Simon L. Nielsen --dzI2QqkSBOAresgT Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+sF288kocFXgPTRwRAjzdAKC70IZzNz3kgLoDI5AOGLPCKJPNxwCeNo8+ aCytbsNg8HcnKq4iurXiNTo= =omP6 -----END PGP SIGNATURE----- --dzI2QqkSBOAresgT--