Docs: multipath.8: A little quick copyediting

The following patch applies cleanly at least to the following commit:

  de4e708f82c5f5f1575fafefbceb3624600c3dac

To apply this patch, save this email to:

  /path/to/email

and then run the following from the repository:

  $ git am --scissors /path/to/email

8<-----------8<-----------8<-----------8<-----------8<-----------8<-----------

Date: Mon, 22 Apr 2013 21:31:36 +0000

The grammar was arguably incorrect (or at asymmetrical):

  multipath is used to detect... and coalesces them

Also, I found the description for the `device' parameter
to be a little rough.

Signed-off-by: Michael Witten <mfwitten@gmail.com>

diff --git a/multipath/multipath.8 b/multipath/multipath.8
index a63a9f1..afaa6c4 100644 (file)
--- a/multipath/multipath.8
+++ b/multipath/multipath.8
@@ -14,7 +14,7 @@ multipath \- Device mapper target autoconfig
 .RB [\| device \|]
 .SH DESCRIPTION
 .B multipath
-is used to detect multiple paths to devices for fail-over or performance reasons and coalesces them
+is used to detect and coalesce multiple paths to devices, for fail-over or performance reasons.
 .SH OPTIONS
 .TP
 .B \-v " level"
@@ -92,13 +92,19 @@ in /sys/class/fc_transport/target*/node_name.
 Existing maps are not modified.
 .TP
 .BI device
-update only the devmap the path pointed by
-.I device
-is in. 
-.I device
-is in the /dev/sdb (as shown by udev in the $DEVNAME variable) or major:minor format.
-.I device
-may alternatively be a multipath mapname
+update only the devmap specified by
+.IR device ,
+which is either:
+.RS 1.2i
+.IP \[bu]
+a devmap name
+.IP \[bu]
+a path associated with the desired devmap; the path may be in one of the following formats:
+.RS 1.2i
+.IP \[bu]
+.B /dev/sdb
+.IP \[bu]
+.B major:minor
 .SH "SEE ALSO"
 .BR multipathd (8),
 .BR multipath.conf (5),