Bring in line with reality.

1 files changed, 51 insertions, 18 deletions

diff --git a/share/man/man4/vinum.4 b/share/man/man4/vinum.4
index c021370..de3dfb3 100644
--- a/share/man/man4/vinum.4
+++ b/share/man/man4/vinum.4
@@ -36,9 +36,8 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd 28 March 1999
-.Dt VINUM 4
-.Os
+.Dd 5 October 1999
+.Dt vinum 4
 .Sh NAME
 .Nm vinum
 .Nd Logical Volume Manager
@@ -190,6 +189,13 @@ as described above.
 If the VINUMDEBUG variables do not match, vinum(8) will fail with a message
 explaining the problem and what to do to correct it.
 .Pp
+.Nm
+was previously available in two versions: a freely available version which did
+not contain RAID-5 functionality, and a full version including RAID-5
+functionality, which was available only from Cybernet Systems Inc.  The present
+version of
+.Nm
+includes the RAID-5 functionality.
 .Sh RUNNING VINUM
 .Nm
 is part of the base FreeBSD system.  It does not require installation.
@@ -697,12 +703,9 @@ The drive is up and running.
 .Bl -enum
 .It
 .Nm
-is a new product.  Many bugs can be expected.  The configuration mechanism is
-not yet fully functional.  If you have difficulties, please look at
-.Pa http://www.lemis.com/vinum_beta.html
-and
-.Pa http://www.lemis.com/vinum_debugging.html 
-before reporting problems.
+is a new product.  Bugs can be expected.  The configuration mechanism is not yet
+fully functional.  If you have difficulties, please look at the section
+DEBUGGING PROBLEMS WITH VINUM before reporting problems.
 .It
 Kernels with the
 .Nm
@@ -712,6 +715,14 @@ kernel and test with the kld module.
 .It
 Detection of differences between the version of the kernel and the kld is not
 yet implemented.
+.It
+The RAID-5 functionality is new in FreeBSD 3.3.  Some problems have been
+reported with 
+.Nm
+in combination with soft updates, but these are not reproducible on all
+systems.  If you are planning to use
+.Nm
+in a production environment, please test carefully.
 .El
 .Sh DEBUGGING PROBLEMS WITH VINUM
 .Pp
@@ -808,8 +819,11 @@ command if you have this kind of trouble.
 .Pp
 In order to analyse a panic which you suspect comes from
 .Nm
-you will need to build a debug kernel.  See the online handbook for more details
-of how to do this.
+you will need to build a debug kernel.  See the online handbook at 
+.Pa /usr/share/doc/handbook/kerneldebug.html 
+(if installed) or
+.Pa http://www.freebsd.org/handbook/kerneldebug.html  
+for more details of how to do this.
 .Pp
 Perform the following steps to analyse a
 .Nm
@@ -959,19 +973,38 @@ For an initial investigation, the most important information is the output of
 the
 .Nm bt
 (backtrace) command above.
-.Sh AUTHORS
-.An Greg Lehey Aq grog@lemis.com
+.Ss Reporting problems with Vinum
+.Pp
+If you find any bugs in
+.Nm vinum ,
+please report them to Greg Lehey <grog@lemis.com>.  Supply the following
+information:
+.Pp
+.Bl -bullet
+.It
+The output of the
+.Nm vinum list
+command.
+.It
+Any messages printed in
+.Pa /var/log/messages .
+All such messages will be identified by the text
+.Nm
+at the beginning.
+.It
+If you have a panic, a stack trace as described above.
+.El
+.Sh AUTHOR
+.An Greg Lehey Aq grog@lemis.com .
 .Sh HISTORY
 .Nm vinum
-first appeared in
-.Fx 3.0 .
-The RAID-5 component of
+first appeared in FreeBSD 3.0.  The RAID-5 component of
 .Nm
 was developed by Cybernet Inc. 
 .Pa www.cybernet.com
 for its NetMAX product.
 .Sh SEE ALSO
+.Xr vinum 8 ,
 .Xr disklabel 5 ,
 .Xr disklabel 8 ,
-.Xr newfs 8 ,
-.Xr vinum 8 .
+.Xr newfs 8 .