From owner-freebsd-doc Wed Jan 22 14: 4:46 2003 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 01EB637B401; Wed, 22 Jan 2003 14:04:45 -0800 (PST) Received: from sccrmhc03.attbi.com (sccrmhc03.attbi.com [204.127.202.63]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1AAEB43ED8; Wed, 22 Jan 2003 14:04:44 -0800 (PST) (envelope-from swear@attbi.com) Received: from localhost.localdomain ([12.242.158.67]) by sccrmhc03.attbi.com (sccrmhc03) with ESMTP id <200301222204430030007rlqe>; Wed, 22 Jan 2003 22:04:43 +0000 Received: from localhost.localdomain (localhost [127.0.0.1]) by localhost.localdomain (8.12.6/8.12.5) with ESMTP id h0MM2sm9049946; Wed, 22 Jan 2003 14:03:00 -0800 (PST) (envelope-from swear@attbi.com) Received: (from jojo@localhost) by localhost.localdomain (8.12.6/8.12.5/Submit) id h0MJjZNq048280; Wed, 22 Jan 2003 11:45:35 -0800 (PST) (envelope-from swear@attbi.com) X-Authentication-Warning: localhost.localdomain: jojo set sender to swear@attbi.com using -f To: FreeBSD-gnats-submit@FreeBSD.org Cc: freebsd-doc@FreeBSD.org, mwm@mired.org, trhodes@FreeBSD.org Subject: Re: docs/35951; disklabel(8) patch; PLEASE REVIEW From: swear@attbi.com (Gary W. Swearingen) Date: 22 Jan 2003 11:45:34 -0800 Message-ID: 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: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org I've made a 1300-line patch for disklabel(8) which I'm sure I will need some more work, especially if someone(s) will be kind enough as to review it and provide comments. You can find the thing with http://home.attbi.com/~swear/freebsd/disklabel.8.diff http://home.attbi.com/~swear/freebsd/disklabel.8.mdoc http://home.attbi.com/~swear/freebsd/disklabel.8.html After it gets reviewed/changed, I'd like to make a couple moves: -- The "Examples" section up to between "Description" and "Files" (instead of between "Saved File Format" and "See Also"). (That doesn't give my preferred order, but this seems better, while generally following tradition.) -- "Initializing/Formatting..." subsection to "NOTES" section because it doesn't belong with the command descriptions as now. -- "Enabling and disabling ..." section to above the "Writing a disk label" section. (Gotta enable before writing.) I based many changes on testing and code review. I know it could say more about some things, but I've added about all I care to. If this ever gets closed, docs/35948 can be closed too. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message