From 1408b135d9415188df771cb39391703ba538226c Mon Sep 17 00:00:00 2001
From: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Mon, 13 Nov 2017 07:21:21 +0100
Subject: [PATCH] smartpqi.4: Minor wording fixes

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
---
 man4/smartpqi.4 | 28 ++++++++++++----------------
 1 file changed, 12 insertions(+), 16 deletions(-)

diff --git a/man4/smartpqi.4 b/man4/smartpqi.4
index 85e4a5b6e..139375258 100644
--- a/man4/smartpqi.4
+++ b/man4/smartpqi.4
@@ -80,9 +80,9 @@ Writing to this attribute will cause the driver to scan for new,
 changed, or removed devices (e.g., hot-plugged tape drives, or newly
 configured or deleted logical drives) and notify the SCSI mid-layer of
 any changes detected.
-Normally this action is triggered automatically by configuration
+Usually this action is triggered automatically by configuration
 changes, so the user should not normally have to write to this file.
-Doing so may be useful when hot-plugging devices like tape drives, or
+Doing so may be useful when hot-plugging devices such as tape drives or
 entire storage boxes containing pre-configured logical drives.
 .TP
 .IR /sys/class/scsi_host/host * /version
@@ -120,11 +120,11 @@ In the file specifications below,
 .I c
 stands for the number of the appropriate SCSI controller,
 .I b
-the bus number,
+is the bus number,
 .I t
 the target number, and
 .I l
-the logical unit number (LUN).
+is the logical unit number (LUN).
 .TP
 .IR /sys/class/scsi_disk/ c : b : t : l /device/raid_level
 The
@@ -184,22 +184,18 @@ For compatibility with applications written for the
 and
 .BR hpsa (4)
 drivers, many, but not all of the
-.IR ioctl s
-supported by the
+.BR ioctl (2)
+operations supported by the
 .B hpsa
 driver are also supported by the
 .B smartpqi
 driver.
-The data structures used by these
-.IR ioctl s
+The data structures used by these operations
 are described in the Linux kernel source file
 .IR include/linux/cciss_ioctl.h .
 .TP
-.BR CCISS_DEREGDISK ,\c
-.BR CCISS_REGNEWDISK ,\c
-.B CCISS_REGNEWD
-The above three
-.IR ioctl s
+.BR CCISS_DEREGDISK ", " CCISS_REGNEWDISK ", " CCISS_REGNEWD
+These operations
 all do exactly the same thing, which is to cause the driver to re-scan
 for new devices.
 This does exactly the same thing as writing to the
@@ -209,11 +205,11 @@ host
 attribute.
 .TP
 .B CCISS_GETPCIINFO
-Returns the PCI domain, bus, device and function and "board ID" (PCI
-subsystem ID).
+This operation Returns the PCI domain, bus,
+device and function and "board ID" (PCI subsystem ID).
 .TP
 .B CCISS_GETDRIVVER
-Returns the driver version in four bytes, encoded as:
+This operation returns the driver version in four bytes, encoded as:
 .EX
 (major_version << 28) | (minor_version << 24) | (release << 16) | revision
 .EE