From 4b07d06bcae6f1921dbce84e6f014ee7ea8ed5b4 Mon Sep 17 00:00:00 2001
From: Garrett Wollman <wollman@FreeBSD.org>
Date: Fri, 19 Jan 1996 22:17:57 +0000
Subject: [PATCH] More man page cleanups.

---
 share/man/man4/aha.4           |  64 ++++----
 share/man/man4/ahb.4           |  97 +++++++-----
 share/man/man4/ahc.4           | 142 ++++++++++-------
 share/man/man4/bt.4            |  52 +++---
 share/man/man4/man4.i386/aha.4 |  64 ++++----
 share/man/man4/man4.i386/ahb.4 |  97 +++++++-----
 share/man/man4/man4.i386/ahc.4 | 142 ++++++++++-------
 share/man/man4/man4.i386/asc.4 | 278 +++++++++++++++++----------------
 share/man/man4/man4.i386/bt.4  |  52 +++---
 9 files changed, 544 insertions(+), 444 deletions(-)

diff --git a/share/man/man4/aha.4 b/share/man/man4/aha.4
index 94aa072e01c3..db762b14dd5f 100644
--- a/share/man/man4/aha.4
+++ b/share/man/man4/aha.4
@@ -25,43 +25,43 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\"
-.Dd August 31, 1994
+.Dd January 19, 1996
 .Dt AHA 4 i386
 .Os FreeBSD
 .Sh NAME
 .Nm aha
-.Nd
-Adaptec SCSI host adapter driver
+.Nd Adaptec SCSI host adapter driver
 .Sh SYNOPSIS
-.Cd "controller aha0 at isa? port" \&"IO_AHA0\&" bio irq ? drq 5 vector ahaintr
-.Cd "controller scbus0
-.sp
-For each connected disk:
-.Cd "device sd0
-.sp
-For each connected tape device:
-.Cd "device st0
-.sp
-For one or more cdroms:
-.Cd "device cd0
+.Cd controller "aha0 at isa? port" \&"IO_AHA0\&" "bio irq ? drq 5 vector ahaintr"
+.Cd controller scbus0 at aha0
 .Sh DESCRIPTION
-This driver provides access to SCSI devices connected to an Adaptec 
-154xA, 154xB, 154xC or 164x hostadapter. It also works for compatible cards like
-the BusLogic 545 and the Adaptec 174x in 154x emulation mode.
-.sp
-For Adaptec 174x cards in enhanced mode the ahb(4) driver should be used. This
-mode is prefered over 154x emulation mode.
-.Sh FILES
-.Bl -tag -width Pa -compact
-.It Pa /sys/i386/conf/GENERIC
-sample generic kernel config file for Adaptec based systems
-.It Pa /sys/i386/isa/aha.c
-driver source
-.El
-.Sh SEE ALSO
+This driver provides access to the
+.Tn SCSI
+bus connected to an Adaptec 154xA, 154xB, 154xC or 164x host
+adapter.  It also works for compatible cards like the BusLogic 545 and
+the Adaptec 174x in 154x emulation mode.
+For Adaptec 174x cards in enhanced mode the
 .Xr ahb 4
-.Xr ahc 4
-.Xr cd 4
-.Xr scsi 4
-.Xr sd 4
+driver should be used instead.
+.Sh SEE ALSO
+.Xr ahb 4 ,
+.Xr ahc 4 ,
+.Xr cd 4 ,
+.Xr scsi 4 ,
+.Xr sd 4 ,
 .Xr st 4
+.\"
+.\" .Sh DIAGNOSTICS
+.\"
+.Sh AUTHOR
+The
+.Nm
+driver was written by Julian Elischer for
+.Tn Mach
+2.5.
+.Sh HISTORY
+The
+.Nm
+driver first appeared in the
+.Tn 386BSD
+patchkit.
diff --git a/share/man/man4/ahb.4 b/share/man/man4/ahb.4
index 27b0ba53172d..46957d328a63 100644
--- a/share/man/man4/ahb.4
+++ b/share/man/man4/ahb.4
@@ -25,49 +25,70 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\"
-.Dd August 31, 1994
+.Dd January 19, 1996
 .Dt AHB 4 i386
 .Os FreeBSD
 .Sh NAME
 .Nm ahb
-.Nd
-Adaptec EISA SCSI host adapter driver
+.Nd Adaptec EISA SCSI host adapter driver
 .Sh SYNOPSIS
-.Cd "controller ahb0 at isa? bio irq ? vector ahbintr
-.Cd "controller scbus0
-.sp
-For each disk:
-.Cd "device sd0
-.sp
-For each tape device:
-.Cd "device st0
-.sp
-For one or more cdroms:
-.Cd "device cd0
+.Cd controller ahb0 at isa? bio irq ? vector ahbintr
+.Cd controller scbus0 at ahb0
 .Sh DESCRIPTION
-This driver provides access to SCSI devices connected to an Adaptec 
-174x hostadapter in either Standard or Enhanced Mode. If the controller
-is set to Standard mode (by the ECU), the driver will automatically 
-switch the card to Enhanced mode during the device probe.
-.sp
-Please note that the above implies that when you are configuring a system
-with both aha and ahb drivers, the ahb driver should be listed first in the
-kernel config file. This ensures that the ahb driver will find the Adaptec 174x
-boards before the aha driver probes for Adaptec 154x boards.
-.sp
-Note that no I/O addresses are configured in the kernel config file. The
-174x uses EISA slot specific I/O which is configured automatically.
-.Sh FILES
-.Bl -tag -width Pa -compact
-.It Pa /sys/i386/isa/ahb.c
-driver source
-.It Pa /sys/i386/conf/GENERIC
-sample generic kernel config file for Adaptec based systems
-.El
-.Sh SEE ALSO
+This driver provides access to the
+.Tn SCSI
+bus connected to an Adaptec 
+174x hostadapter in either 
+.Dq Em standard
+or
+.Dq Em enhanced
+mode. If the controller
+is set to standard mode (using the
+.Tn EISA
+configuration utility),
+the driver will automatically 
+switch the card to enhanced mode during the device probe.
+.Pp
+.Sy N.B. :
+When configuring a system
+with both
 .Xr aha 4
-.Xr ahc 4
-.Xr cd 4
-.Xr scsi 4
-.Xr sd 4
+and
+.Nm
+drivers, the
+.Nm
+driver should be listed first in the kernel configuration file.  This
+ensures that the
+.Nm
+driver will find the Adaptec 174x boards before the 
+.Xr aha 4
+driver probes for Adaptec 154x boards.
+.Pp
+Note that no I/O addresses are configured in the kernel config file. The
+174x uses
+.Tn EISA
+slot-specific I/O which is configured automatically.
+.\"
+.\" .Sh DIAGNOSTICS
+.\"
+.Sh SEE ALSO
+.Xr aha 4 ,
+.Xr ahc 4 ,
+.Xr cd 4 ,
+.Xr scsi 4 ,
+.Xr sd 4 ,
 .Xr st 4
+.Sh AUTHOR
+The
+.Nm
+driver was written by Julian Elischer for
+.Tn Mach
+2.5.  It was converted to automatic
+.Tn EISA
+configuration by Justin Gibbs.
+.Sh HISTORY
+The
+.Nm
+driver first appeared in the
+.Tn 386BSD
+patchkit.
diff --git a/share/man/man4/ahc.4 b/share/man/man4/ahc.4
index 5e535ed5ed71..5dbecceec057 100644
--- a/share/man/man4/ahc.4
+++ b/share/man/man4/ahc.4
@@ -30,76 +30,98 @@
 .Os FreeBSD
 .Sh NAME
 .Nm ahc
-.Nd
-Adaptec VL/EISA/PCI SCSI host adapter driver
+.Nd Adaptec VL/EISA/PCI SCSI host adapter driver
 .Sh SYNOPSIS
 For VL/EISA cards:
-.Cd "controller ahc0 at isa? bio irq ? vector ahcintr
-.sp
+.Cd controller ahc0 at isa? bio irq ? vector ahcintr
+.Pp
 For PCI cards:
-.Cd "controller ahc0
-.sp
+.Cd controller ahc0
+.Pp
+To enable tagged queueing:
+.Cd options AHC_TAGENABLE
+.Pp
 For one or more SCSI busses:
-.Cd "controller scbus0
-.sp
-For one or more disk devices:
-.Cd "device sd0
-.sp
-For one or more tape devices:
-.Cd "device st0
-.sp
-For one or more cdroms:
-.Cd "device cd0
+.Cd controller scbus0 at ahc0
 .Sh DESCRIPTION
-This driver provides access to SCSI devices connected to an Adaptec 
-274x, 284x, 294x, or motherboard based aic7770/aic7870 hostadapter.
-Features include twin and wide bus support, 2 commands per target in
-non-tagged queuing mode, and experimental tagged queuing support enabled
-with:
-.sp
-.Cd "option AHC_TAGENABLE
-.sp
-Per target configuration performed in the SCSI-Select menu, accesible at boot
-in non-EISA models or throught an EISA configuration utility for EISA models,
-is honored by this driver with the stipulation that the BIOS is enabled for 
-EISA adaptors.  This includes syncronous/asyncronous transfers, disconnection,
-and maximum syncronous negotiation rate settings.
-.sp
+This driver provides access to the
+.Tn SCSI
+bus connected to an Adaptec 
+274x, 284x, 294x, or motherboard-based
+.Tn AIC7770
+or 
+.Tn AIC7870
+host adapter.
+Features include twin and wide bus support, two commands per target in
+non-tagged-queuing mode, and experimental tagged queuing support enabled
+with the
+.Dq Dv AHC_TAGENABLE
+configuration option.
+.Pp
+Per target configuration performed in the 
+.Tn SCSI-Select
+menu, accesible at boot
+in 
+.No non- Ns Tn EISA
+models or through an 
+.Tn EISA
+configuration utility for 
+.Tn EISA
+models,
+is honored by this driver with the stipulation that the 
+.Tn BIOS
+must be enabled for 
+.Tn EISA
+adaptors.  This includes synchronous/asynchronous transfers, disconnection,
+and maximum synchronous negotiation rate settings.
+.Pp
 Note that I/O addresses are determined automatically by the probe routines,
-but care should be taken when using a 284x (VLB controller) in an EISA 
+but care should be taken when using a 284x
+.Pq Tn VESA No local bus controller
+in an
+.Tn EISA 
 system.  Ensure that the jumpers setting the I/O area for the 284x match the 
-EISA slot into which the card is inserted to prevent conflicts with other
-EISA cards.
+.Tn EISA
+slot into which the card is inserted to prevent conflicts with other
+.Tn EISA
+cards.
 .Sh BUGS
 Some Quantum drives (at least the Empire 2100 and 1080s) will not run on an
-aic7870 in syncronous mode at 10MB/s.  It is speculated that the Adaptec
-runs slightly above 10MB/s causing the drive much confusion.  Setting a 
-maximum syncronous negotiation rate of 8MB/s in the SCSI-Select utility
+.Tn AIC7870
+in synchronous mode at 10MB/s.  It is speculated that the Adaptec
+runs slightly above 10MB/s, causing the drive much confusion.  Setting a 
+maximum synchronous negotiation rate of 8MB/s in the 
+.Tn SCSI-Select
+utility
 will allow normal function.
-.sp
-The SCSI ID of aic7870 based controllers (AHA-294x) is hard coded to 7 by
-the driver.  The user configured ID can be obtained by querying the SEEPROM
-or NVRAM where these settings are stored, but there is no driver support for
+.Pp
+The
+.Tn SCSI
+ID of
+.No Tn AIC7870 Ns -based
+controllers
+.Pq Tn AHA-294x
+is hard coded to 7 by the driver.  The user configured ID can be
+obtained by querying the adapter, but there is no driver support for
 this as of yet.
-.Sh FILES
-.Bl -tag -width Pa -compact
-.It Pa /sys/i386/scsi/aic7xxx.c
-.It Pa /sys/i386/scsi/aic7xxx.h
-Bus independent driver source
-.It Pa /sys/i386/eisa/aic7770.c
-EISA device probe/attach routines
-.It Pa /sys/pci/aic7870.c
-PCI device probe/attach routines
-.It Pa /sys/dev/aic7xxx/aic7xxx.seq
-aic7xxx sequencer program
-.It Pa /sys/i386/conf/GENERIC
-sample generic kernel config file including Adaptec support
-.El
 .Sh SEE ALSO
-.Xr aha 4
-.Xr ahb 4
-.Xr aic7xxx_asm 1
-.Xr cd 4
-.Xr scsi 4
-.Xr sd 4
+.Xr aha 4 ,
+.Xr ahb 4 ,
+.Xr cd 4 ,
+.Xr scsi 4 ,
+.Xr sd 4 ,
 .Xr st 4
+.Sh AUTHOR
+The
+.Nm
+driver was written by Justin Gibbs.  The
+.Tn AIC7xxx
+sequencer-code assembler was
+written by John Aycock.
+.Sh HISTORY
+The
+.Nm
+driver appeared in
+.Tn FreeBSD
+2.1.
+
diff --git a/share/man/man4/bt.4 b/share/man/man4/bt.4
index 0db78c5437db..5a48f7ab26dd 100644
--- a/share/man/man4/bt.4
+++ b/share/man/man4/bt.4
@@ -30,32 +30,34 @@
 .Os FreeBSD
 .Sh NAME
 .Nm bt
-.Nd
-Buslogic SCSI host adapter driver
+.Nd Buslogic SCSI host adapter driver
 .Sh SYNOPSIS
-.Cd "controller bt0 at isa? port" \&"IO_BT0\&" bio irq ? vector btintr
-.Cd "controller scbus0
-.sp
-For each connected disk:
-.Cd "device sd0
-.sp
-For each connected tape device:
-.Cd "device st0
-.sp
-For one or more cdroms:
-.Cd "device cd0
+.Cd "controller bt0 at isa? port IO_BT0 bio irq ? vector btintr"
+.Cd controller scbus0 at bt0
 .Sh DESCRIPTION
-This driver provides access to SCSI devices connected to a Buslogic 
-545, 445, 742, 747 or 946 hostadapter. 
-.Sh FILES
-.Bl -tag -width Pa -compact
-.It Pa /sys/i386/conf/GENERIC
-sample generic kernel config file for Buslogic based systems
-.It Pa /sys/i386/isa/bt742a.c
-driver source
-.El
+This driver provides access to the
+.Tn SCSI
+bus connected to a Buslogic 
+545, 445, 742, 747 or 946 host adapter. 
+.\"
+.\" .Sh DIAGNOSTICS
+.\"
 .Sh SEE ALSO
-.Xr cd 4
-.Xr scsi 4
-.Xr sd 4
+.Xr cd 4 ,
+.Xr scsi 4 ,
+.Xr sd 4 ,
 .Xr st 4
+.Sh AUTHOR
+The
+.Nm
+driver was written by Julian Elischer for use with
+.Tn Mach
+2.5.  The interface for the
+.Tn PCI
+and
+.Tn EISA
+busses was written by Justin Gibbs.
+.Sh HISTORY
+We're not sure when the
+.Nm
+driver first appeared.
diff --git a/share/man/man4/man4.i386/aha.4 b/share/man/man4/man4.i386/aha.4
index 94aa072e01c3..db762b14dd5f 100644
--- a/share/man/man4/man4.i386/aha.4
+++ b/share/man/man4/man4.i386/aha.4
@@ -25,43 +25,43 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\"
-.Dd August 31, 1994
+.Dd January 19, 1996
 .Dt AHA 4 i386
 .Os FreeBSD
 .Sh NAME
 .Nm aha
-.Nd
-Adaptec SCSI host adapter driver
+.Nd Adaptec SCSI host adapter driver
 .Sh SYNOPSIS
-.Cd "controller aha0 at isa? port" \&"IO_AHA0\&" bio irq ? drq 5 vector ahaintr
-.Cd "controller scbus0
-.sp
-For each connected disk:
-.Cd "device sd0
-.sp
-For each connected tape device:
-.Cd "device st0
-.sp
-For one or more cdroms:
-.Cd "device cd0
+.Cd controller "aha0 at isa? port" \&"IO_AHA0\&" "bio irq ? drq 5 vector ahaintr"
+.Cd controller scbus0 at aha0
 .Sh DESCRIPTION
-This driver provides access to SCSI devices connected to an Adaptec 
-154xA, 154xB, 154xC or 164x hostadapter. It also works for compatible cards like
-the BusLogic 545 and the Adaptec 174x in 154x emulation mode.
-.sp
-For Adaptec 174x cards in enhanced mode the ahb(4) driver should be used. This
-mode is prefered over 154x emulation mode.
-.Sh FILES
-.Bl -tag -width Pa -compact
-.It Pa /sys/i386/conf/GENERIC
-sample generic kernel config file for Adaptec based systems
-.It Pa /sys/i386/isa/aha.c
-driver source
-.El
-.Sh SEE ALSO
+This driver provides access to the
+.Tn SCSI
+bus connected to an Adaptec 154xA, 154xB, 154xC or 164x host
+adapter.  It also works for compatible cards like the BusLogic 545 and
+the Adaptec 174x in 154x emulation mode.
+For Adaptec 174x cards in enhanced mode the
 .Xr ahb 4
-.Xr ahc 4
-.Xr cd 4
-.Xr scsi 4
-.Xr sd 4
+driver should be used instead.
+.Sh SEE ALSO
+.Xr ahb 4 ,
+.Xr ahc 4 ,
+.Xr cd 4 ,
+.Xr scsi 4 ,
+.Xr sd 4 ,
 .Xr st 4
+.\"
+.\" .Sh DIAGNOSTICS
+.\"
+.Sh AUTHOR
+The
+.Nm
+driver was written by Julian Elischer for
+.Tn Mach
+2.5.
+.Sh HISTORY
+The
+.Nm
+driver first appeared in the
+.Tn 386BSD
+patchkit.
diff --git a/share/man/man4/man4.i386/ahb.4 b/share/man/man4/man4.i386/ahb.4
index 27b0ba53172d..46957d328a63 100644
--- a/share/man/man4/man4.i386/ahb.4
+++ b/share/man/man4/man4.i386/ahb.4
@@ -25,49 +25,70 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\"
-.Dd August 31, 1994
+.Dd January 19, 1996
 .Dt AHB 4 i386
 .Os FreeBSD
 .Sh NAME
 .Nm ahb
-.Nd
-Adaptec EISA SCSI host adapter driver
+.Nd Adaptec EISA SCSI host adapter driver
 .Sh SYNOPSIS
-.Cd "controller ahb0 at isa? bio irq ? vector ahbintr
-.Cd "controller scbus0
-.sp
-For each disk:
-.Cd "device sd0
-.sp
-For each tape device:
-.Cd "device st0
-.sp
-For one or more cdroms:
-.Cd "device cd0
+.Cd controller ahb0 at isa? bio irq ? vector ahbintr
+.Cd controller scbus0 at ahb0
 .Sh DESCRIPTION
-This driver provides access to SCSI devices connected to an Adaptec 
-174x hostadapter in either Standard or Enhanced Mode. If the controller
-is set to Standard mode (by the ECU), the driver will automatically 
-switch the card to Enhanced mode during the device probe.
-.sp
-Please note that the above implies that when you are configuring a system
-with both aha and ahb drivers, the ahb driver should be listed first in the
-kernel config file. This ensures that the ahb driver will find the Adaptec 174x
-boards before the aha driver probes for Adaptec 154x boards.
-.sp
-Note that no I/O addresses are configured in the kernel config file. The
-174x uses EISA slot specific I/O which is configured automatically.
-.Sh FILES
-.Bl -tag -width Pa -compact
-.It Pa /sys/i386/isa/ahb.c
-driver source
-.It Pa /sys/i386/conf/GENERIC
-sample generic kernel config file for Adaptec based systems
-.El
-.Sh SEE ALSO
+This driver provides access to the
+.Tn SCSI
+bus connected to an Adaptec 
+174x hostadapter in either 
+.Dq Em standard
+or
+.Dq Em enhanced
+mode. If the controller
+is set to standard mode (using the
+.Tn EISA
+configuration utility),
+the driver will automatically 
+switch the card to enhanced mode during the device probe.
+.Pp
+.Sy N.B. :
+When configuring a system
+with both
 .Xr aha 4
-.Xr ahc 4
-.Xr cd 4
-.Xr scsi 4
-.Xr sd 4
+and
+.Nm
+drivers, the
+.Nm
+driver should be listed first in the kernel configuration file.  This
+ensures that the
+.Nm
+driver will find the Adaptec 174x boards before the 
+.Xr aha 4
+driver probes for Adaptec 154x boards.
+.Pp
+Note that no I/O addresses are configured in the kernel config file. The
+174x uses
+.Tn EISA
+slot-specific I/O which is configured automatically.
+.\"
+.\" .Sh DIAGNOSTICS
+.\"
+.Sh SEE ALSO
+.Xr aha 4 ,
+.Xr ahc 4 ,
+.Xr cd 4 ,
+.Xr scsi 4 ,
+.Xr sd 4 ,
 .Xr st 4
+.Sh AUTHOR
+The
+.Nm
+driver was written by Julian Elischer for
+.Tn Mach
+2.5.  It was converted to automatic
+.Tn EISA
+configuration by Justin Gibbs.
+.Sh HISTORY
+The
+.Nm
+driver first appeared in the
+.Tn 386BSD
+patchkit.
diff --git a/share/man/man4/man4.i386/ahc.4 b/share/man/man4/man4.i386/ahc.4
index 5e535ed5ed71..5dbecceec057 100644
--- a/share/man/man4/man4.i386/ahc.4
+++ b/share/man/man4/man4.i386/ahc.4
@@ -30,76 +30,98 @@
 .Os FreeBSD
 .Sh NAME
 .Nm ahc
-.Nd
-Adaptec VL/EISA/PCI SCSI host adapter driver
+.Nd Adaptec VL/EISA/PCI SCSI host adapter driver
 .Sh SYNOPSIS
 For VL/EISA cards:
-.Cd "controller ahc0 at isa? bio irq ? vector ahcintr
-.sp
+.Cd controller ahc0 at isa? bio irq ? vector ahcintr
+.Pp
 For PCI cards:
-.Cd "controller ahc0
-.sp
+.Cd controller ahc0
+.Pp
+To enable tagged queueing:
+.Cd options AHC_TAGENABLE
+.Pp
 For one or more SCSI busses:
-.Cd "controller scbus0
-.sp
-For one or more disk devices:
-.Cd "device sd0
-.sp
-For one or more tape devices:
-.Cd "device st0
-.sp
-For one or more cdroms:
-.Cd "device cd0
+.Cd controller scbus0 at ahc0
 .Sh DESCRIPTION
-This driver provides access to SCSI devices connected to an Adaptec 
-274x, 284x, 294x, or motherboard based aic7770/aic7870 hostadapter.
-Features include twin and wide bus support, 2 commands per target in
-non-tagged queuing mode, and experimental tagged queuing support enabled
-with:
-.sp
-.Cd "option AHC_TAGENABLE
-.sp
-Per target configuration performed in the SCSI-Select menu, accesible at boot
-in non-EISA models or throught an EISA configuration utility for EISA models,
-is honored by this driver with the stipulation that the BIOS is enabled for 
-EISA adaptors.  This includes syncronous/asyncronous transfers, disconnection,
-and maximum syncronous negotiation rate settings.
-.sp
+This driver provides access to the
+.Tn SCSI
+bus connected to an Adaptec 
+274x, 284x, 294x, or motherboard-based
+.Tn AIC7770
+or 
+.Tn AIC7870
+host adapter.
+Features include twin and wide bus support, two commands per target in
+non-tagged-queuing mode, and experimental tagged queuing support enabled
+with the
+.Dq Dv AHC_TAGENABLE
+configuration option.
+.Pp
+Per target configuration performed in the 
+.Tn SCSI-Select
+menu, accesible at boot
+in 
+.No non- Ns Tn EISA
+models or through an 
+.Tn EISA
+configuration utility for 
+.Tn EISA
+models,
+is honored by this driver with the stipulation that the 
+.Tn BIOS
+must be enabled for 
+.Tn EISA
+adaptors.  This includes synchronous/asynchronous transfers, disconnection,
+and maximum synchronous negotiation rate settings.
+.Pp
 Note that I/O addresses are determined automatically by the probe routines,
-but care should be taken when using a 284x (VLB controller) in an EISA 
+but care should be taken when using a 284x
+.Pq Tn VESA No local bus controller
+in an
+.Tn EISA 
 system.  Ensure that the jumpers setting the I/O area for the 284x match the 
-EISA slot into which the card is inserted to prevent conflicts with other
-EISA cards.
+.Tn EISA
+slot into which the card is inserted to prevent conflicts with other
+.Tn EISA
+cards.
 .Sh BUGS
 Some Quantum drives (at least the Empire 2100 and 1080s) will not run on an
-aic7870 in syncronous mode at 10MB/s.  It is speculated that the Adaptec
-runs slightly above 10MB/s causing the drive much confusion.  Setting a 
-maximum syncronous negotiation rate of 8MB/s in the SCSI-Select utility
+.Tn AIC7870
+in synchronous mode at 10MB/s.  It is speculated that the Adaptec
+runs slightly above 10MB/s, causing the drive much confusion.  Setting a 
+maximum synchronous negotiation rate of 8MB/s in the 
+.Tn SCSI-Select
+utility
 will allow normal function.
-.sp
-The SCSI ID of aic7870 based controllers (AHA-294x) is hard coded to 7 by
-the driver.  The user configured ID can be obtained by querying the SEEPROM
-or NVRAM where these settings are stored, but there is no driver support for
+.Pp
+The
+.Tn SCSI
+ID of
+.No Tn AIC7870 Ns -based
+controllers
+.Pq Tn AHA-294x
+is hard coded to 7 by the driver.  The user configured ID can be
+obtained by querying the adapter, but there is no driver support for
 this as of yet.
-.Sh FILES
-.Bl -tag -width Pa -compact
-.It Pa /sys/i386/scsi/aic7xxx.c
-.It Pa /sys/i386/scsi/aic7xxx.h
-Bus independent driver source
-.It Pa /sys/i386/eisa/aic7770.c
-EISA device probe/attach routines
-.It Pa /sys/pci/aic7870.c
-PCI device probe/attach routines
-.It Pa /sys/dev/aic7xxx/aic7xxx.seq
-aic7xxx sequencer program
-.It Pa /sys/i386/conf/GENERIC
-sample generic kernel config file including Adaptec support
-.El
 .Sh SEE ALSO
-.Xr aha 4
-.Xr ahb 4
-.Xr aic7xxx_asm 1
-.Xr cd 4
-.Xr scsi 4
-.Xr sd 4
+.Xr aha 4 ,
+.Xr ahb 4 ,
+.Xr cd 4 ,
+.Xr scsi 4 ,
+.Xr sd 4 ,
 .Xr st 4
+.Sh AUTHOR
+The
+.Nm
+driver was written by Justin Gibbs.  The
+.Tn AIC7xxx
+sequencer-code assembler was
+written by John Aycock.
+.Sh HISTORY
+The
+.Nm
+driver appeared in
+.Tn FreeBSD
+2.1.
+
diff --git a/share/man/man4/man4.i386/asc.4 b/share/man/man4/man4.i386/asc.4
index fc187f306bb1..80ec6e85b140 100644
--- a/share/man/man4/man4.i386/asc.4
+++ b/share/man/man4/man4.i386/asc.4
@@ -28,152 +28,162 @@
 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-.TH ASC 4 "January 6, 1995" FreeBSD "FreeBSD Programmer's Manual"
-.SH NAME
-\fBasc\fP - a device driver for a handy scanner
-.SH SYNOPSIS
-.TP
-\fB#include <machine/asc_ioctl.h>\fP
-.TP
-\fBMinor number bits:\fP \fIuu d g p ...\fP
-\fIuu\fP - unit asc0 .. asc3
-\fI d\fP - selects logging of \fIdebug\fP messages
-\fI g\fP - selects \fIbitmap\fP vs. \fIgraymap\fP output
-\fI p\fP - selects \fIraw\fP vs. portable \fIpnm\fP output
-.TP
-\fBdd if=/dev/asc0 of=rawfile bs=(width/8) count=(height)
-.TP
-\fBcat /dev/asc0p > pbmfile\fP
-.PB
-.SH DESCRIPTION
-The \fBasc\fP character device driver currently handles the
-GI1904-based hand scanner (e.g. Trust Amiscan Grey).
-It uses DMA and interrupts. Input data from the scanner are
-buffered, up to 50 scanlines are buffered in the driver.
-.PP
-The device can operate at four different \fIresolutions\fP: 100, 200,
-300 and 400dpi. It produces a simple bitmap with the most significant bit
-at the left side. The driver can optionally output the famous and
-likely simple portable bitmap file format pbm(5) by Jef
-Poskanzer. Thus the scans can easily processed by any graphic package
-around (xpaint, xv, xli only to name some of them ...).
-.PP
-The \fIwidth\fP of the output bitmap is fixed as given by the
-resolution value. However, the \fIheight\fP of the bitmap must be
-supplied in \fIpnm\fP mode since the driver must know at what time the
-'end-of-file' shall be reached. The default is to produce a
-square image, i.e. \fIheight=width\fP. With this feature you are able to
-directly copy the scanner output into a pbm file whith cat(1).  Of
-course you can obtain a similar effect by using dd(1) with the driver
-in \fIraw\fP mode.
-.PP
-The \fIgraymap\fP output mode is not yet implemented into the driver.
-It is even questionable if external programs would not do this job
-better thereby not counting to the size of the kernel. Even though, I
-do not know of tools which produce a graymap from a halftone bitmap.
-.SH IOCTL REQUESTS
-The ioctl requests that are served by \fBasc\fP are listed below.
-There is a utility, called sasc(1), that provides access to these
-requests from within shell.
-.TP
-ASC_GRES int
+.Dd January 19, 1995
+.Dt ASC 4 i386
+.Os FreeBSD
+.Sh NAME
+.Nm asc
+.Nd device driver for a GI1904-based hand scanner
+.Sh SYNOPSIS
+.Cd "device asc0 at isa? port IO_ASC1 tty drq 3 irq 10 vector ascintr"
+.Sh DESCRIPTION
+The
+.Nm
+character device driver currently handles the
+.Tn GI1904 Ns -based
+hand scanner (e.g. Trust Amiscan Grey).
+It uses DMA and interrupts. 
+Up to 50 lines of scanned input data are buffered in the driver.
+.Pp
+The device can operate at four different resolutions: 100, 200, 300
+and 400 dots per inch. It produces a simple bitmap with the most
+significant bit at the left side.  The driver can optionally output
+the simple portable bitmap file format
+.Xr pbm 5 ;
+thus the scans can easily processed by most graphics packages.
+.Pp
+The width of the output bitmap is fixed as given by the
+resolution value.  However, the height of the bitmap must be
+supplied when in
+.Xr pbm 5
+mode, since the driver must know at what time the
+`end-of-file' shall be reached.  The default is to produce a
+square image; i.e., height equals width.
+With this feature one is able to
+directly copy the scanner output into a
+.Xr pbm 5
+file using
+.Xr cat 1 .
+One can obtain a similar effect by using
+.Xr dd 1
+with the driver
+in raw mode.
+.Sh IOCTLS
+The
+.Xr ioctl 2
+commands applicable to
+.Nm
+are listed below.
+The
+.Xr sasc 1
+provides user-level access to these commands.
+.Bl -tag -width "ASC_GHEIGHT"
+.It Dv ASC_GRES
+.Pq Li int
 Get current resolution in dots per inch (dpi).
-.TP
-ASC_GWIDTH int
+.It Dv ASC_GWIDTH
+.Pq Li int
 Get current width of the bitmap in pixels.
-.TP
-ASC_SHEIGHT int
-Set the \fIheight\fP of the bitmap in \fIpnm\fP mode. This is actually
+.It Dv ASC_SHEIGHT
+.Pq Li int
+Set the height of the bitmap in 
+.Xr pbm 5
+mode.  This is actually
 a limit on the amount of lines scannable after the first read
-operation. When the limit is reached read will return 0. However, the
-device is turned off only when a close is performed (either
-explicitely or implicitely on exit of the calling process).
-.TP
-ASC_GHEIGHT int
+operation.  When the limit is reached, read will return 0. However, the
+device is turned off only when the last open file descriptor is closed.
+.It Dv ASC_GHEIGHT
+.Pq Li int
 Get the current height of the bitmap.
-.TP
-ASC_SBLEN int
+.It Dv ASC_SBLEN
+.Pq Li int
 Set the length of the buffer used internally to do the DMA transfer.
 The buffer length is supplied in lines of the bitmap. Since the buffer
-size limit is (currently) 0x3000 bytes the maximum number of lines
-allowed will vary with the width of each line. This upper limit is
-checked before it overwrites the current value and pases an ENOMEM in
-the \fBerrno\fP variable. However, since the bitmap width can change
-after a buffer length was selected a read request may fail with ENOMEM
-if the buffer length turns out too high. It is generally wise to
-choose long buffers rather than go save in order to obtain better
-output.
-.TP
-ASC_GBLEN int
+size limit is (currently) 0x3000 bytes, the maximum number of lines
+allowed will vary with the width of each line.  An
+.Er ENOMEM
+error is returned if the requested length would exceed this limit.
+.It Dv ASC_GBLEN
+.Pq Li int
 Get the current buffer length in lines.
-.TP
-ASC_SBTIME int
+.It Dv ASC_SBTIME
+.Pq Li int
 Set the timeout for the completion of reading one buffer. Since a
 handy scanner is a human/computer interface timeout values are usually
-higher than those of a flat scanner. Default is 15 seconds. After
-timeout is reached the read operation will fail with EBUSY. Note that
-the timeout timer starts anew for each buffer to be read and thus does
-not cause you to scan faster for longer images. BLEN/BTIME is similar
-as MIN/TIME in termios(4).
-.TP
-ASC_GBTIME int
+higher than those of a flat scanner; the default is 15 seconds.  After
+timeout is reached the read operation will fail with 
+.Er EBUSY .
+Note that
+the timeout timer starts anew for each buffer to be read and thus 
+reducing it does not result in faster scans for longer images.
+.It Dv ASC_GBTIME
+.Pq Li int
 Get the current buffer timeout.
-.PP
-All ioctl requests that modify a parameter except ASC_SBTIME do not
-have an effect on an ongoing scan process, i.e. after the first read
-request that follows open. You must close the device and open it again
-for the new selections to take effect. Consequently, the selections
-are not reset when you close or open the device.
-.PP
+.El
+.Pp
+All
+.Fn ioctl
+requests that modify a parameter except
+.Dv ASC_SBTIME
+do not have an effect on an ongoing scan process.  The user must close
+the device and open it again for the new selections to take effect.
+Consequently, the selections are 
+.Em not
+reset when the device is opened or closed.
+.Pp
 Similarily, requests that read a value do not report the value that is
-used for the ongoing scan process. The values needed during the scan
-process are saved when it starts and thus are not accessed by ioctl
+used for the ongoing scan process.  The values needed during the scan
+process are saved when it starts and thus are not accessed by 
+.Fn ioctl
 requests.
-.PP
-The BTIME value does, however, have an immediate effect on the ongoing
-scan. Thus the timeout can for example be set to long until the user
-starts scanning.  It can then be set to a short amount to react
-(nearly) immediately when the user stops. Note that the user should be
-left time to at least fill one buffer without having to haste.
-.PP
-Note that the \fIpbm\fP versus \fIraw\fP mode selection is done by the
-minor number not by ioctl requests. In \fIraw\fP mode the selected
+.Pp
+The
+.Dv ASC_SBTIME
+value does, however, have an immediate effect on the ongoing scan.
+Thus the timeout can, for example, be set to a large value until the
+user starts scanning, and then set to a small value to react
+(nearly) immediately when the user stops.
+.Pp
+Note that the
+.Xr pbm 5
+versus raw mode selection is done by the
+minor number, not by
+.Fn ioctl
+requests.  In raw mode, the selected
 height of the bitmap will have no effect.
-.SH FILES
-.TP 15
-.BI /dev/asc0
-device node for \fIraw\fP output, has minor number 0.
-.TP
-.BI /dev/asc0d
-device node for \fIraw\fP output emiting \fIdebug\fP messages if the
-ASCDEBUG option was given at compile time, has minor number 32.
-.TP
-.BI /dev/asc0p
-device node for output in \fIpbm\fP file format, has minor number 8.
-.TP
-.BI /dev/asc0pd
-device node for \fIpbm\fP and \fIdebug\fP mode, has minor number 40.
+.Sh FILES
+.Bl -tag -width /dev/asc0pd -compact
+.It Pa /dev/asc0
+device node for raw output
+.It Pa /dev/asc0d
+device node for raw output, emitting debug messages if the
+.Dv ASCDEBUG
+option was given in the kernel configuration file
+.It Pa /dev/asc0p
+device node for output in
+.Xr pbm 5
+file format
+.It Pa /dev/asc0pd
+device node for
+.Xr pbm 5
+and debug mode
 .PB
-.SH DIAGNOSTICS
-.TP
-\fBASCDEBUG\fP
-When you define this name as an `option' in the kernel configuration
-you can get debug output if you access the driver with a minor number
-whose debug bit (i.e. bit 5 out of 7) is set.
-.SH SEE ALSO
-.nh
-open(2),
-ioctl(2),
-intro(2),
-read(2),
-close(2),
-cat(1),
-dd(1),
-pbm(5),
-pnm(1),
-termios(4).
-.hy
-.SH BUGS
+.\"
+.\" .Sh DIAGNOSTICS
+.\"
+.Sh SEE ALSO
+.Xr sasc 1
+.Xr pbm 5
+.Sh BUGS
 Ioctl support is not working yet.
-.SH AUTHOR
-Luigi Rizzo <luigi.rizzo@iet.unipi.it>
+.Sh AUTHOR
+The
+.Nm
+driver was written by
+Luigi Rizzo.
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Tn FreeBSD
+2.1.
diff --git a/share/man/man4/man4.i386/bt.4 b/share/man/man4/man4.i386/bt.4
index 0db78c5437db..5a48f7ab26dd 100644
--- a/share/man/man4/man4.i386/bt.4
+++ b/share/man/man4/man4.i386/bt.4
@@ -30,32 +30,34 @@
 .Os FreeBSD
 .Sh NAME
 .Nm bt
-.Nd
-Buslogic SCSI host adapter driver
+.Nd Buslogic SCSI host adapter driver
 .Sh SYNOPSIS
-.Cd "controller bt0 at isa? port" \&"IO_BT0\&" bio irq ? vector btintr
-.Cd "controller scbus0
-.sp
-For each connected disk:
-.Cd "device sd0
-.sp
-For each connected tape device:
-.Cd "device st0
-.sp
-For one or more cdroms:
-.Cd "device cd0
+.Cd "controller bt0 at isa? port IO_BT0 bio irq ? vector btintr"
+.Cd controller scbus0 at bt0
 .Sh DESCRIPTION
-This driver provides access to SCSI devices connected to a Buslogic 
-545, 445, 742, 747 or 946 hostadapter. 
-.Sh FILES
-.Bl -tag -width Pa -compact
-.It Pa /sys/i386/conf/GENERIC
-sample generic kernel config file for Buslogic based systems
-.It Pa /sys/i386/isa/bt742a.c
-driver source
-.El
+This driver provides access to the
+.Tn SCSI
+bus connected to a Buslogic 
+545, 445, 742, 747 or 946 host adapter. 
+.\"
+.\" .Sh DIAGNOSTICS
+.\"
 .Sh SEE ALSO
-.Xr cd 4
-.Xr scsi 4
-.Xr sd 4
+.Xr cd 4 ,
+.Xr scsi 4 ,
+.Xr sd 4 ,
 .Xr st 4
+.Sh AUTHOR
+The
+.Nm
+driver was written by Julian Elischer for use with
+.Tn Mach
+2.5.  The interface for the
+.Tn PCI
+and
+.Tn EISA
+busses was written by Justin Gibbs.
+.Sh HISTORY
+We're not sure when the
+.Nm
+driver first appeared.