docs/122052: minor update on handbook section 20.7.1
trhodes at FreeBSD.org
Sun Jan 11 23:41:07 UTC 2009
On Sun, 28 Dec 2008 09:10:04 GMT
Federico Galvez-Durand Besnard <federico.besnard at del.ufrj.br> wrote:
> The following reply was made to PR docs/122052; it has been noted by GNATS.
> From: Federico Galvez-Durand Besnard <federico.besnard at del.ufrj.br>
> To: bug-followup at FreeBSD.org
> Cc: trhodes at 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.
> 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):
> 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
> 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,
More information about the freebsd-doc