From owner-cvs-all Sat Jul 31 17:37:29 1999 Delivered-To: cvs-all@freebsd.org Received: from allegro.lemis.com (allegro.lemis.com [192.109.197.134]) by hub.freebsd.org (Postfix) with ESMTP id C7DC214D3E; Sat, 31 Jul 1999 17:37:13 -0700 (PDT) (envelope-from grog@freebie.lemis.com) Received: from freebie.lemis.com (freebie.lemis.com [192.109.197.137]) by allegro.lemis.com (8.9.1/8.9.0) with ESMTP id KAA17419; Sun, 1 Aug 1999 10:06:49 +0930 (CST) Received: (from grog@localhost) by freebie.lemis.com (8.9.3/8.9.0) id KAA68508; Sun, 1 Aug 1999 10:06:48 +0930 (CST) Date: Sun, 1 Aug 1999 10:06:47 +0930 From: Greg Lehey To: Robert Nordier Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/sbin/disklabel disklabel.8 Message-ID: <19990801100646.M64532@freebie.lemis.com> References: <199907310812.BAA05505@freefall.freebsd.org> <199907311338.PAA10124@m2-36-dbn.dial-up.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <199907311338.PAA10124@m2-36-dbn.dial-up.net>; from Robert Nordier on Sat, Jul 31, 1999 at 03:38:54PM +0200 WWW-Home-Page: http://www.lemis.com/~grog X-PGP-Fingerprint: 6B 7B C3 8C 61 CD 54 AF 13 24 52 F8 6D A4 95 EF Organization: LEMIS, PO Box 460, Echunga SA 5153, Australia Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-41-739-7062 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk On Saturday, 31 July 1999 at 15:38:54 +0200, Robert Nordier wrote: >> grog 1999/07/31 01:11:59 PDT >> >> Modified files: >> sbin/disklabel disklabel.8 >> Log: >> Make intelligible: >> Describe the command formats in English. >> Add references to other programs (boot0cfg, fdisk). >> Remove some old cruft, including FUD about single-level bootstraps. >> Add example of output format. >> >> Not-objected-to-by: msmith >> rnordier > > Actually, I do object: 24 hours (particularly Friday afternoon through > Saturday morning) is probably too short a period after which to assume > "qui tacet consentire" in the case of a volunteer project. Well, I specifically avoided any reference to consent. And you'd be right about the timing if this were code. I expected some kind of negative feedback, but in view of the fact that this is a man page, and the current text was *very* confusing, I thought it would be better to commit now and correct later. > Although the restructuring makes some information easier to digest, > I think in other ways, this is a step in the wrong direction: it is > too i386-centric, Good point. It probably should be moved to man8.i386, and a similar one to man8.alpha. > and IMO anything relating to the slice structure (boot0cfg and > fdisk) has no business being discussed here. Man pages have always referred to other man pages. Granted, this reference is a little longer, but in view of the fact that this is not discussed anywhere else, I think it's appropriate. It's almost impossible for somebody who doesn't know the code intimately (and that includes most of the committers) to make sense of what we had there. > (Even the pre-existing reference to the fdisk table in the BUGS > section would be better discarded.) I think the reference to fdisk is appropriate; it's an area where things can trip over each other. On the other hand, I *did* remove a reference to the Tahoe partitioning method. > A sample specific gripe: > >> The booteasy bootstrap manager >> >> FreeBSD supplies a boot manager called booteasy which resides in >> the Master Boot Record. Use the boot0cfg program to install it. > > The default FreeBSD/i386 boot manager is simply called "boot0"; it > is *not* called "booteasy", which is a different DOS-based program > that is also available (on CD-ROMs, at ftp.FreeBSD.org, etc.) in the > (DOS) "tools" directory. You can't use boot0cfg to install booteasy. Ah. Then I misunderstood your recent mail message. Why do we have two programs to do the same thing? Any other comments? Greg -- See complete headers for address, home page and phone numbers finger grog@lemis.com for PGP public key To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message