From owner-freebsd-doc@FreeBSD.ORG  Thu Jun 21 14:38:15 2012
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 94499106566B;
	Thu, 21 Jun 2012 14:38:15 +0000 (UTC)
	(envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
	by mx1.freebsd.org (Postfix) with ESMTP id 5026A8FC0C;
	Thu, 21 Jun 2012 14:38:15 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
	by wonkity.com (8.14.5/8.14.5) with ESMTP id q5LEc9ov071283;
	Thu, 21 Jun 2012 08:38:09 -0600 (MDT)
	(envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
	by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q5LEc9Jp071280;
	Thu, 21 Jun 2012 08:38:09 -0600 (MDT)
	(envelope-from wblock@wonkity.com)
Date: Thu, 21 Jun 2012 08:38:09 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: John Baldwin <jhb@freebsd.org>
In-Reply-To: <201206210755.21402.jhb@freebsd.org>
Message-ID: <alpine.BSF.2.00.1206210755280.70177@wonkity.com>
References: <alpine.BSF.2.00.1206201352300.64840@wonkity.com>
	<201206210755.21402.jhb@freebsd.org>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
	(wonkity.com [127.0.0.1]); Thu, 21 Jun 2012 08:38:09 -0600 (MDT)
Cc: freebsd-doc@freebsd.org
Subject: Re: gptboot and zfsboot
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 21 Jun 2012 14:38:15 -0000

On Thu, 21 Jun 2012, John Baldwin wrote:

> On Wednesday, June 20, 2012 3:59:54 pm Warren Block wrote:
>> We have no man pages for gptboot or zfsboot.  Are the details of how
>> they work covered anywhere other than the source?  There's a need for
>> these.
>>
>> http://forums.freebsd.org/showthread.php?t=32807
>> http://forums.freebsd.org/showthread.php?t=32886
>
> Note that there is no boot2(8) manpage either.  Instead there is a boot(8)
> manpage.  I do think boot(8) does not currently handle gptboot and zfsboot (it
> should be fairly easy to update it for gptboot), but that is the right place
> to document these I believe.

boot(8) is kind of written around the standad boot1/boot2.  It will need 
a rewrite to handle the others.  See the Files and Diagnostics sections 
for what I mean; those are going to be different for each of the 
different types.  There ought to be boot2.8, gptboot.8, and zfsboot.8 
links to that page, too.

That's all doable, but it seems like a fair amount of work to combine 
disparate things that would be better separately.

So maybe we should split the boot2 information out into boot2(8), create 
a relatively-trivial gptboot(8) and a possibly-not-so-trivial 
zfsboot(8).