docs/122052: minor update on handbook section 20.7.1

[Tom Rhodes]

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,

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 <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.

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