docs/69644: (PATCH) "Proper synopsis" for handbook's Vinum chapter?

[Kevin Kinsey]

>Number:         69644
>Category:       docs
>Synopsis:       (PATCH) "Proper synopsis" for handbook's Vinum chapter?
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jul 27 02:20:18 GMT 2004
>Closed-Date:
>Last-Modified:
>Originator:     Kevin Kinsey
>Release:        FreeBSD 5.2.1-RELEASE-p3 i386
>Organization:
DaleCo, S.P. 
>Environment:
System: FreeBSD ezekiel.daleco.biz 5.2.1-RELEASE-p3 FreeBSD 5.2.1-RELEASE-p3 #3: Thu Apr 8 17:36:47 CDT 2004 root at ezekiel.daleco.biz:/usr/obj/usr/src/sys/GENERIC i386


	
>Description:
	Saw this on the "to-do".  Don't know that it's great, but there is at
	least more to this than the old version.  Some text from vinumvm.org...
	
>How-To-Repeat:
	
	NA
>Fix:

	

--- chapter.sgml	Wed Nov  5 04:36:56 2003
+++ chapter.sgml.edit	Mon Jul 26 20:57:50 2004
@@ -15,20 +15,36 @@
   <sect1 id="vinum-synopsis">
     <title>Synopsis</title>
 
-    <para>No matter what disks you have, there will always be limitations:</para>
+
+<para>No matter what disks you have, there are always potential problems:</para>
       <itemizedlist>
-	<listitem>
-	  <para>They can be too small.</para>
-	</listitem>
-
-	<listitem>
-	  <para>They can be too slow.</para>
-	</listitem>
-
-	<listitem>
-	  <para>They can be too unreliable.</para>
-	</listitem>
+        <listitem>
+          <para>They can be too small.</para>
+        </listitem>
+
+        <listitem>
+          <para>They can be too slow.</para>
+        </listitem>
+
+        <listitem>
+          <para>They can be too unreliable.</para>
+        </listitem>
       </itemizedlist>
+
+<para>One way some users safeguard themselves against such issues is
+through the use of multiple, and sometimes redundant, disks.</para>
+
+<para>In addition to supporting various cards and controllers for hardware
+RAID systems, the base FreeBSD system includes the Vinum Volume Manager,
+a block device driver that implements virtual disk drives.</para>
+
+<para>Vinum provides more flexibility, performance, and reliability than
+traditional disk storage, and implements RAID-0, RAID-1, and RAID-5
+models both individually and in combination.</para>
+
+<para>This chapter provides an overview of potential problems with traditional
+disk storage, and an introduction to the Vinum Volume Manager.</para>
+
   </sect1>
 
   <sect1 id="vinum-intro">

>Release-Note:
>Audit-Trail:
>Unformatted: