From owner-freebsd-doc@FreeBSD.ORG  Sun Dec 28 09:10:05 2008
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 1E73B106564A
	for <freebsd-doc@hub.freebsd.org>; Sun, 28 Dec 2008 09:10:05 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
	[IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id 0D78B8FC12
	for <freebsd-doc@hub.freebsd.org>; Sun, 28 Dec 2008 09:10:05 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mBS9A4Ej088812
	for <freebsd-doc@freefall.freebsd.org>; Sun, 28 Dec 2008 09:10:04 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mBS9A4ij088808;
	Sun, 28 Dec 2008 09:10:04 GMT (envelope-from gnats)
Date: Sun, 28 Dec 2008 09:10:04 GMT
Message-Id: <200812280910.mBS9A4ij088808@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Federico Galvez-Durand Besnard <federico.besnard@del.ufrj.br>
Cc: 
Subject: Re: docs/122052: minor update on handbook section 20.7.1
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: Federico Galvez-Durand Besnard <federico.besnard@del.ufrj.br>
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: Sun, 28 Dec 2008 09:10:05 -0000

The following reply was made to PR docs/122052; it has been noted by GNATS.

From: Federico Galvez-Durand Besnard <federico.besnard@del.ufrj.br>
To: bug-followup@FreeBSD.org
Cc: trhodes@FreeBSD.org
Subject: Re: docs/122052: minor update on handbook section 20.7.1
Date: Sun, 28 Dec 2008 09:41:46 +0100

 Hi Tom,
 
 Greg Lehey work writing VINUM is outstanding.
 However, the manual does not match the quality of the source code.
 
 Some highlights:
 1) The definition of RAID-10 given in 21.6.4 is wrong.
 It actually describes RAID-01.
 I added RAID-10, for the sake of completeness.
 http://en.wikipedia.org/wiki/Nested_RAID_levels
 
 2) VINUM was originally written for Release 4.x, the manual needed 
 updates to accommodate most recent Releases and GEOM framework.
 Same stands for man pages.
 This patch separates clearly 4.x from > 5.x. Also, all misleading 
 embedded-guidances have been treated.
 
 3) This patch improves the whole section text and figures. 
 
 4) Examples have been also improved. Configuration files and <gvinum 
 list> output are shown.
 
 
 I will appreciate any feedback if there is a committer, familiar with 
 VINUM, available for reading (and compare to the actual version) the 
 proposed update (shown in this link for the sake of simplicity and for 
 few fellows who requested it):
 http://www.del.ufrj.br/~federico.besnard/FreeBSD/apocrypha/handbook/vinum-vinum.html
 
 
 I will work on the SGML version only if this patch makes sense to 
 someone with power for committing the patch.
 I have seen recent developers' activity on the GEOM side, it might be 
 the case of not having a need for VINUM any longer. So this work on the 
 handbook is not only low priority but useless.
 I am not sure, I am not writing code for GEOM nor tracking all activity 
 there.
 
 Please advise.