smartpqi.4: Reorder various pieces of text to follow usual conventions

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man4/smartpqi.4 b/man4/smartpqi.4
index 465a138162f670cc3504e188b234d538e0cb1d71..a038cbad63b610040351e8a3095f861a0cbe63c4 100644 (file)
--- a/man4/smartpqi.4
+++ b/man4/smartpqi.4
@@ -18,7 +18,49 @@ smartpqi \- Microsemi Smart Family SCSI driver
 .SH DESCRIPTION
 .B smartpqi
 is a SCSI driver for Microsemi Smart Family controllers.
-.SH OPTIONS
+.SS Supported \f[BI]ioctl\fP\/() operations
+For compatibility with applications written for the
+.BR cciss (4)
+and
+.BR hpsa (4)
+drivers, many, but not all of 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 operations
+are described in the Linux kernel source file
+.IR include/linux/cciss_ioctl.h .
+.TP
+.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
+.BR smartpqi -specific
+host
+.I rescan
+attribute.
+.TP
+.B CCISS_GETPCIINFO
+This operation Returns the PCI domain, bus,
+device and function and "board ID" (PCI subsystem ID).
+.TP
+.B CCISS_GETDRIVVER
+This operation returns the driver version in four bytes, encoded as:
+.IP
+.in +4n
+.EX
+(major_version << 28) | (minor_version << 24) |
+        (release << 16) | revision
+.EE
+.in
+.TP
+.B CCISS_PASSTHRU
+Allows BMIC and CISS commands to be passed through to the controller.
+.SS Boot options
 .TP
 .BR disable_device_id_wildcards= { 0 | 1 }
 Disables support for device ID wildcards.
@@ -48,13 +90,6 @@ parameter    action
 \fBreboot\fP   reboot the system
 \fBpanic\fP    panic the system
 .TE
-.SH CONFIGURATION
-To configure Microsemi Smart Family controllers, please refer to the
-controller's User Guide documentation.
-.\" FIXME
-.\" Does this manual have a title?  Is it freely available online?
-.\" Does it have a stable URL?  Can this information be moved to the SEE
-.\" ALSO section?
 .RE
 .SH FILES
 .SS Device nodes
@@ -177,49 +212,14 @@ $ \c
 0
 .EE
 .in
-.SS Supported \f[BI]ioctl\fP\/() operations
-.\" Does this subsection belong here, under .SH FILES ?
-For compatibility with applications written for the
-.BR cciss (4)
-and
-.BR hpsa (4)
-drivers, many, but not all of 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 operations
-are described in the Linux kernel source file
-.IR include/linux/cciss_ioctl.h .
-.TP
-.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
-.BR smartpqi -specific
-host
-.I rescan
-attribute.
-.TP
-.B CCISS_GETPCIINFO
-This operation Returns the PCI domain, bus,
-device and function and "board ID" (PCI subsystem ID).
-.TP
-.B CCISS_GETDRIVVER
-This operation returns the driver version in four bytes, encoded as:
-.IP
-.in +4n
-.EX
-(major_version << 28) | (minor_version << 24) |
-        (release << 16) | revision
-.EE
-.in
-.TP
-.B CCISS_PASSTHRU
-Allows BMIC and CISS commands to be passed through to the controller.
+.SH NOTES
+.SS Configuration
+To configure Microsemi Smart Family controllers, please refer to the
+controller's User Guide documentation.
+.\" FIXME
+.\" Does this manual have a title?  Is it freely available online?
+.\" Does it have a stable URL?  Can this information be moved to the SEE
+.\" ALSO section?
 .SH SEE ALSO
 .BR cciss (4),
 .BR hpsa (4),