More man page cleanups.

1 files changed, 82 insertions, 60 deletions

diff --git a/share/man/man4/ahc.4 b/share/man/man4/ahc.4
index 5e535ed..5dbecce 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.
+