From owner-freebsd-doc@FreeBSD.ORG Sun Jan 11 23:41:06 2009 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D6A2C1065677 for ; Sun, 11 Jan 2009 23:41:06 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from pittgoth.com (pittgoth.com [205.134.163.206]) by mx1.freebsd.org (Postfix) with ESMTP id 9CDE78FC1A for ; Sun, 11 Jan 2009 23:41:06 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from localhost.fbsdsecure.org (c-68-83-213-214.hsd1.va.comcast.net [68.83.213.214]) (authenticated bits=0) by pittgoth.com (8.14.3/8.14.3) with ESMTP id n0BNeuFE081948 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sun, 11 Jan 2009 18:40:57 -0500 (EST) (envelope-from trhodes@FreeBSD.org) Date: Sun, 11 Jan 2009 18:40:51 -0500 From: Tom Rhodes To: Federico Galvez-Durand Besnard Message-Id: <20090111184051.1fb59d13.trhodes@FreeBSD.org> In-Reply-To: <200812280910.mBS9A4ij088808@freefall.freebsd.org> References: <200812280910.mBS9A4ij088808@freefall.freebsd.org> X-Mailer: Sylpheed version 1.0.6 (GTK+ 1.2.10; amd64-portbld-freebsd8.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org 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 List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 11 Jan 2009 23:41:07 -0000 On Sun, 28 Dec 2008 09:10:04 GMT Federico Galvez-Durand Besnard wrote: > The following reply was made to PR docs/122052; it has been noted by GNATS. > > From: Federico Galvez-Durand Besnard > 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, Hi! > > 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 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. Sorry about the long wait for this reply, my life has been a bit busy. But yes, please, SGML will be very nice as I think these fixes could be really useful. VINUM itself, IIRC, is no longer supported with the 6.X and 7.X versions. There is a gvinum, though, and I see no sign of it going away, nor a hint or whisper about it being removed. So any improvements in that area will be most welcome. Thanks, -- Tom Rhodes