Update vgsplit man page to reflect lvnames on cmdline.

diff --git a/WHATS_NEW b/WHATS_NEW
index 6545137ae7dcb37a525506e6fadf02bbbaba862c..d0dad13a8cdcb3633a916903573304b16a40c141 100644 (file)
--- a/WHATS_NEW
+++ b/WHATS_NEW
@@ -1,6 +1,7 @@
 Version 2.02.34 -
 ===================================
-  Update vgsplit to take "-n LogicalVolumeName" on the commandline.
+  Update vgsplit man page to reflect lvnames on the cmdline.
+  Update vgsplit to take "-n LogicalVolumeName" on the cmdline.
   Use clustered mirror log with pvmove in clustered VGs, if available.
   Fix some pvmove error status codes.
   Fix vgsplit error paths to release vg_to lock.

diff --git a/man/vgsplit.8 b/man/vgsplit.8
index 8614c732856089755f3af35d519e20a267da95ce..36e230caae87a6ab68ec83b9f7a430971f66d2f8 100644 (file)
--- a/man/vgsplit.8
+++ b/man/vgsplit.8
@@ -15,18 +15,21 @@ vgsplit \- split a volume group into two
 .IR type ]
 .RB [ -p | \-\-maxphysicalvolumes
 .IR MaxPhysicalVolumes ]
+.RB [ \-n | \-\-name 
+.IR LogicalVolumeName ]
 .RB [ \-t | \-\-test ]
 .RB [ \-v | \-\-verbose ]
 SourceVolumeGroupName DestinationVolumeGroupName
-PhysicalVolumePath [PhysicalVolumePath...]
+[ PhysicalVolumePath ...]
 .SH DESCRIPTION
 .B vgsplit 
-moves
-.IR PhysicalVolumePath (s)
-from
+moves one or more physical volumes from
 .I SourceVolumeGroupName
 into
-.I DestinationVolumeGroupName\fP.
+.I DestinationVolumeGroupName\fP.  The physical volumes moved can be
+specified either explicitly via \fIPhysicalVolumePath\fP, or implicitly by
+\fB-n\fP \fILogicalVolumeName\fP, in which case only physical volumes
+underlying the specified logical volume will be moved.
 
 If
 .I DestinationVolumeGroupName
@@ -46,9 +49,13 @@ before the physical volumes are moved. Specifying any of the above default
 volume group attributes with an existing destination volume group is an error,
 and no split will occur.
 
-Logical Volumes cannot be split between Volume Groups.
-Each existing Logical Volume must be entirely on the Physical Volumes forming
-either the source or the destination Volume Group.
+Logical volumes cannot be split between volume groups. \fBVgsplit(8)\fP only
+moves complete physical volumes: To move part of a physical volume, use
+\fBpvmove(8)\fP.  Each existing logical volume must be entirely on the physical
+volumes forming either the source or the destination volume group.  For this
+reason, \fBvgsplit(8)\fP may fail with an error if a split would result in a
+logical volume being split across volume groups.
+
 .SH OPTIONS
 See \fBlvm\fP for common options.
 .SH SEE ALSO