mdoc(7) police: overhaul.

Approved by:	re

1 files changed, 45 insertions, 33 deletions

diff --git a/share/man/man4/ahd.4 b/share/man/man4/ahd.4
index af64ba9..0ae0460 100644
--- a/share/man/man4/ahd.4
+++ b/share/man/man4/ahd.4
@@ -36,19 +36,29 @@
 .Nd Adaptec PCI/PCI-X Ultra320 SCSI host adapter driver
 .Sh SYNOPSIS
 For one or more PCI/PCI-X cards:
+.Bd -ragged -offset indent -compact
 .Cd device pci
 .Cd device ahd
+.Ed
 .Pp
-To compile in debugging code.
+To compile in debugging code:
+.Bd -ragged -offset indent -compact
 .Cd options AHD_DEBUG
 .Cd options AHD_DEBUG_OPTS=<bitmask of options>
 .Cd options AHD_REG_PRETTY_PRINT
+.Ed
 .Pp
 To configure one or more controllers to assume the target role:
+.Bd -ragged -offset indent -compact
 .Cd options AHD_TMODE_ENABLE=<bitmask of units>
+.Ed
 .Pp
-For one or more SCSI busses:
+For one or more
+.Tn SCSI
+busses:
+.Bd -ragged -offset indent -compact
 .Cd device scbus
+.Ed
 .Sh DESCRIPTION
 This driver provides access to the
 .Tn SCSI
@@ -61,51 +71,53 @@ These chips are found on many motherboards as well as the
 .Tn 29320
 and
 .Tn 39320
-Adaptec SCSI controller cards.
+Adaptec
+.Tn SCSI
+controller cards.
 .Pp
 Driver features include support for narrow and wide busses,
 fast, ultra, ultra2, ultra160, and ultra320 synchronous transfers,
 packetized transfers, tagged queueing, 512 SCB's, and target mode.
 .Pp
 The
-.Dq Dv AHD_DEBUG_OPTS
+.Dv AHD_DEBUG_OPTS
 option is used to control which diagnostic messages are printed to the
 console when
-.Dq Dv AHD_DEBUG
-is enabled.  Logically 'or' the following bits together:
-.Pp
-.Bd -ragged -offset indent
-.Bl -column "Value " Function
-.Em "Value   Function"
-0x0001  Show miscellanious information
-0x0002  Show sense data
-0x0004  Show Serial EEPROM contents
-0x0008  Show bus termination settings
-0x0010  Show host memory usage
-0x0020  Show SCSI protocol messages
-0x0040  Show mode pointer of the chip register window
-0x0080  Show selection timeouts
-0x0100  Show FIFO usage messages
-0x0200  Show Queue Full status
-0x0400  Show SCB queue status
-0x0800  Show inbound packet information
-0x1000  Show S/G list information
-0x2000  Enable extra diagnostic code in the firmware
+.Dv AHD_DEBUG
+is enabled.
+Logically OR the following bits together:
+.Bl -column -offset indent Value Function
+.Em "Value	Function"
+0x0001	Show miscellanious information
+0x0002	Show sense data
+0x0004	Show Serial EEPROM contents
+0x0008	Show bus termination settings
+0x0010	Show host memory usage
+0x0020	Show SCSI protocol messages
+0x0040	Show mode pointer of the chip register window
+0x0080	Show selection timeouts
+0x0100	Show FIFO usage messages
+0x0200	Show Queue Full status
+0x0400	Show SCB queue status
+0x0800	Show inbound packet information
+0x1000	Show S/G list information
+0x2000	Enable extra diagnostic code in the firmware
 .El
-.Ed
 .Pp
 The
-.Dq Dv AHD_REG_PRETTY_PRINT
+.Dv AHD_REG_PRETTY_PRINT
 option compiles in support for human-readable bit definitions for each register
-that is printed by the debugging code.  However, it also bloats the compiled
+that is printed by the debugging code.
+However, it also bloats the compiled
 size of the driver by approximately 215KB.
 .Pp
 Individual controllers may be configured to operate in the target role
 through the
-.Dq Dv AHD_TMODE_ENABLE
-configuration option.  The value assigned to this option should be a bitmap
+.Dv AHD_TMODE_ENABLE
+configuration option.
+The value assigned to this option should be a bitmap
 of all units where target mode is desired.
-For example, a value of 0x25, would enable target mode on units 0, 2, and 5.
+For example, a value of 0x25 would enable target mode on units 0, 2, and 5.
 Note that target mode is only supoprted for ultra160 speeds and below.
 .Pp
 Per target configuration performed in the
@@ -116,13 +128,13 @@ This includes synchronous/asynchronous transfers,
 maximum synchronous negotiation rate,
 wide transfers,
 disconnection,
-and the host adapter's SCSI ID.
-.Pp
+and the host adapter's
+.Tn SCSI
+ID.
 .Sh BUGS
 The current generation of 79xx chips do not support target mode in Ultra320
 mode.
 Target mode in general has not been well tested in this driver.
-.Pp
 .Sh SEE ALSO
 .Xr ahc 4 ,
 .Xr cd 4 ,