o Convert to our new SYNOPSIS layout

o Add "device scbus/pci/etc" where needed for consistency

MFC after:	3 days

14 files changed, 186 insertions, 41 deletions

diff --git a/share/man/man4/adv.4 b/share/man/man4/adv.4
index cb043a0..76e37a7 100644
--- a/share/man/man4/adv.4
+++ b/share/man/man4/adv.4
@@ -30,24 +30,26 @@
 .Nm adv
 .Nd Advansys ISA/VL/EISA/PCI 8bit SCSI Host adapter driver
 .Sh SYNOPSIS
-For one or more ISA or VL cards:
-.Cd device isa
-.Cd device adv
+To compile this driver into the kernel,
+place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
+.Cd "device scbus"
+.Cd "device adv"
+.Pp
+For one or more EISA cards:
+.Cd "device eisa"
+.Pp
+For one or more VL/ISA cards:
+.Cd "device isa"
 .Pp
 In
 .Pa /boot/device.hints :
 .Cd hint.adv.0.at="isa"
 .Pp
-For one or more EISA cards:
-.Cd device eisa
-.Cd device adv
-.Pp
 For one or more PCI cards:
-.Cd device pci
-.Cd device adv
-.Pp
-For one or more SCSI busses:
-.Cd device scbus
+.Cd "device pci"
+.Ed
 .Sh DESCRIPTION
 This driver provides access to the 8bit
 .Tn SCSI
diff --git a/share/man/man4/adw.4 b/share/man/man4/adw.4
index ca13661..b290c3f 100644
--- a/share/man/man4/adw.4
+++ b/share/man/man4/adw.4
@@ -30,11 +30,13 @@
 .Nm adw
 .Nd Advansys PCI 16bit SCSI Host adapter driver
 .Sh SYNOPSIS
-.Cd device pci
-.Cd device adw
-.Pp
-For one or more SCSI busses:
-.Cd device scbus
+To compile this driver into the kernel,
+place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
+.Cd "device pci"
+.Cd "device scbus"
+.Cd "device adw"
 .Sh DESCRIPTION
 This driver provides access to the 16bit
 .Tn SCSI
diff --git a/share/man/man4/amd.4 b/share/man/man4/amd.4
index 7586760..ee42360 100644
--- a/share/man/man4/amd.4
+++ b/share/man/man4/amd.4
@@ -30,7 +30,20 @@
 .Nm amd
 .Nd amd53c974 PCI SCSI driver
 .Sh SYNOPSIS
+To compile this driver into the kernel,
+place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
+.Cd "device scbus"
 .Cd "device amd"
+.Ed
+.Pp
+Alternatively, to load the driver as a
+module at boot time, place the following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+amd_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/amr.4 b/share/man/man4/amr.4
index 8fde216..082e354 100644
--- a/share/man/man4/amr.4
+++ b/share/man/man4/amr.4
@@ -30,8 +30,21 @@
 .Nm amr
 .Nd MegaRAID SCSI/ATA/SATA RAID driver
 .Sh SYNOPSIS
-.Cd device pci
-.Cd device amr
+To compile this driver into the kernel,
+place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
+.Cd "device pci"
+.Cd "device scbus"
+.Cd "device amr"
+.Ed
+.Pp
+Alternatively, to load the driver as a
+module at boot time, place the following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+amr_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/bt.4 b/share/man/man4/bt.4
index 295837b0..de6fa1a 100644
--- a/share/man/man4/bt.4
+++ b/share/man/man4/bt.4
@@ -33,13 +33,19 @@
 .Nm bt
 .Nd Buslogic/Mylex MultiMaster SCSI host adapter driver
 .Sh SYNOPSIS
-.Cd device bt
-.Cd device scbus
+To compile this driver into the kernel,
+place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
+.Cd "device isa"
+.Cd "device scbus"
+.Cd "device bt"
 .Pp
 In
 .Pa /boot/device.hints :
 .Cd hint.bt.0.at="isa"
 .Cd hint.bt.0.port="0x330"
+.Ed
 .Sh DESCRIPTION
 This driver provides access to the
 .Tn SCSI
diff --git a/share/man/man4/dpt.4 b/share/man/man4/dpt.4
index c5f1d18..a614f28 100644
--- a/share/man/man4/dpt.4
+++ b/share/man/man4/dpt.4
@@ -30,16 +30,32 @@
 .Nm dpt
 .Nd DPT RAID Controller SCSI driver
 .Sh SYNOPSIS
-For one or more EISA Controllers
-.Cd "device eisa"
+To compile this driver into the kernel,
+place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
+.Cd "device scbus"
 .Cd "device dpt"
 .Pp
-For one or more PCI Controllers
+For one or more EISA cards:
+.Cd "device eisa"
+.Pp
+For one or more ISA cards:
+.Cd "device isa"
+.Pp
+For one or more PCI cards:
 .Cd "device pci"
-.Cd "device dpt"
 .Pp
 To allow PCI adapters to use memory mapped I/O if enabled:
 .Cd options DPT_ALLOW_MEMIO
+.Ed
+.Pp
+Alternatively, to load the driver as a
+module at boot time, place the following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+dpt_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/esp.4 b/share/man/man4/esp.4
index 5a51e0c..897ee8e 100644
--- a/share/man/man4/esp.4
+++ b/share/man/man4/esp.4
@@ -32,8 +32,13 @@
 .Nm esp
 .Nd Qlogic FEPS and FAS366 SCSI driver
 .Sh SYNOPSIS
-.Cd device scbus
-.Cd device esp
+To compile this driver into the kernel,
+place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
+.Cd "device scbus"
+.Cd "device esp"
+.Ed
 .Sh HARDWARE
 The
 .Nm
diff --git a/share/man/man4/iir.4 b/share/man/man4/iir.4
index dbce281..7499a7e 100644
--- a/share/man/man4/iir.4
+++ b/share/man/man4/iir.4
@@ -9,8 +9,21 @@
 .Nm iir
 .Nd Intel Integrated RAID controller and ICP Vortex driver
 .Sh SYNOPSIS
+To compile this driver into the kernel,
+place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
+.Cd "device pci"
 .Cd "device scbus"
 .Cd "device iir"
+.Ed
+.Pp
+Alternatively, to load the driver as a
+module at boot time, place the following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+iir_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/ips.4 b/share/man/man4/ips.4
index 25ee2a4..3601e6b 100644
--- a/share/man/man4/ips.4
+++ b/share/man/man4/ips.4
@@ -32,8 +32,21 @@
 .Nm ips
 .Nd IBM/Adaptec ServeRAID controller driver
 .Sh SYNOPSIS
-.Cd device scbus
-.Cd device ips
+To compile this driver into the kernel,
+place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
+.Cd "device pci"
+.Cd "device scbus"
+.Cd "device ips"
+.Ed
+.Pp
+Alternatively, to load the driver as a
+module at boot time, place the following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+ips_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/ncr.4 b/share/man/man4/ncr.4
index c7c8563..0521b4d 100644
--- a/share/man/man4/ncr.4
+++ b/share/man/man4/ncr.4
@@ -30,7 +30,14 @@
 .Nm ncr
 .Nd NCR 53C8xx SCSI driver
 .Sh SYNOPSIS
+To compile this driver into the kernel,
+place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
+.Cd "device pci"
+.Cd "device scbus"
 .Cd "device ncr"
+.Ed
 .Sh HARDWARE
 The
 .Nm
diff --git a/share/man/man4/ncv.4 b/share/man/man4/ncv.4
index 753075c..8ab7199 100644
--- a/share/man/man4/ncv.4
+++ b/share/man/man4/ncv.4
@@ -31,8 +31,20 @@
 .Nm ncv
 .Nd "NCR 53C500 based SCSI host adapter driver"
 .Sh SYNOPSIS
-.Cd "device ncv"
+To compile this driver into the kernel,
+place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
 .Cd "device scbus"
+.Cd "device ncv"
+.Ed
+.Pp
+Alternatively, to load the driver as a
+module at boot time, place the following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+ncv_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/nsp.4 b/share/man/man4/nsp.4
index 2df5803..7ff7fe1 100644
--- a/share/man/man4/nsp.4
+++ b/share/man/man4/nsp.4
@@ -31,8 +31,20 @@
 .Nm nsp
 .Nd "Workbit Ninja SCSI-3 based PC-Card SCSI host adapter driver"
 .Sh SYNOPSIS
-.Cd "device nsp"
+To compile this driver into the kernel,
+place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
 .Cd "device scbus"
+.Cd "device nsp"
+.Ed
+.Pp
+Alternatively, to load the driver as a
+module at boot time, place the following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+nsp_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/stg.4 b/share/man/man4/stg.4
index 2c0afb2..1d088b0 100644
--- a/share/man/man4/stg.4
+++ b/share/man/man4/stg.4
@@ -30,12 +30,30 @@
 .Nm stg
 .Nd driver for Future Domain based SCSI controllers
 .Sh SYNOPSIS
+To compile this driver into the kernel,
+place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
+.Cd "device scbus"
 .Cd "device stg"
 .Pp
+For one or more ISA cards:
+.Cd "device isa"
+.Pp
 In
-.Pa /boot/device.hints
-(for ISA controllers):
+.Pa /boot/device.hints :
 .Cd hint.stg.0.at="isa"
+.Pp
+For one or more PCI cards:
+.Cd "device pci"
+.Ed
+.Pp
+Alternatively, to load the driver as a
+module at boot time, place the following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+stg_load="YES"
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/sym.4 b/share/man/man4/sym.4
index 6ce4e13..547d205 100644
--- a/share/man/man4/sym.4
+++ b/share/man/man4/sym.4
@@ -63,17 +63,30 @@
 .Nm sym
 .Nd NCR/Symbios/LSI Logic 53C8XX PCI SCSI host adapter driver
 .Sh SYNOPSIS
-For any number of cards:
-.Cd device sym
+To compile this driver into the kernel,
+place the following lines in your
+kernel configuration file:
+.Bd -ragged -offset indent
+.Cd "device pci"
+.Cd "device scbus"
+.Cd "device sym"
 .Pp
-To disable PCI parity checking (needed for broken bridges)
-.Cd options SYM_SETUP_PCI_PARITY=<boolean>
+To disable PCI parity checking (needed for broken bridges):
+.Cd "options SYM_SETUP_PCI_PARITY=<boolean>"
 .Pp
-To control driver probing against HVD buses
-.Cd options SYM_SETUP_SCSI_DIFF=<bit combination>
+To control driver probing against HVD buses:
+.Cd "options SYM_SETUP_SCSI_DIFF=<bit combination>"
 .Pp
-To control chip attachment balancing between the ncr driver and this driver
-.Cd options SYM_SETUP_LP_PROBE_MAP=<bit combination>
+To control chip attachment balancing between the ncr driver and this driver:
+.Cd "options SYM_SETUP_LP_PROBE_MAP=<bit combination>"
+.Ed
+.Pp
+Alternatively, to load the driver as a
+module at boot time, place the following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+sym_load="YES"
+.Ed
 .Sh DESCRIPTION
 This driver provides support for the Symbios/LSI Logic 53C8XX
 PCI SCSI controllers.