mdoc(7) police: overhaul.

Approved by:	re

1 files changed, 30 insertions, 25 deletions

diff --git a/share/man/man4/atapicam.4 b/share/man/man4/atapicam.4
index 4d7d8c5..7691398 100644
--- a/share/man/man4/atapicam.4
+++ b/share/man/man4/atapicam.4
@@ -38,59 +38,64 @@
 .Sh DESCRIPTION
 The ATAPI/CAM module allows ATAPI devices (CD-ROM, CD-RW, DVD drives,
 floppy drives such as Iomega Zip, tape drives) to be accessed through
-the SCSI subsystem (CAM). 
+the SCSI subsystem,
+.Xr cam 4 .
 .Pp
-.Nm ata
+.Xr ata 4
 and
-.Nm scbus
+.Xr scbus 4
 must be configured in the kernel as well.
 The SCSI target drivers
-.Pq Nm cd , Nm da , No or Nm st
+.Xr ( cd 4 ,
+.Xr da 4 ,
+or
+.Xr st 4 )
 can then be used to access the devices.
-The generic passthrough device
-.Nm pass
+The generic passthrough device,
+.Xr pass 4 ,
 can also be used to send SCSI commands directly
 to the devices through the CAM API.
 .Pp
 A separate CAM bus is created for each ATA bus in the system.
-On each of these buses, target id 0 is assigned to the master
-device, and id 1 is assigned to the slave
-.Pq provided they are ATAPI devices .
+On each of these buses, target ID 0 is assigned to the master
+device, and ID 1 is assigned to the slave
+(provided they are ATAPI devices).
 .Sh IMPLEMENTATION NOTES
 Some SCSI commands are intercepted by the driver, and undergo special
 processing in order to work around limitations of ATAPI devices.
 Such limitations can be consequences of the ATAPI specification.
 For example, ATAPI devices do not implement the 6-byte versions
 of
-.Nm MODE_SELECT ,
-.Nm MODE_SENSE ,
-.Nm READ ,
+.Dv MODE_SELECT , MODE_SENSE , READ ,
 or
-.Nm WRITE .
+.Dv WRITE .
 They can also be common bugs, such as hanging when queried for
 extended
-.Nm INQUIRY
+.Dv INQUIRY
 information.
 .Sh EXAMPLES
-.Dl device atapicam
-.Dl device scbus
-.Dl device cd
-.Dl device pass
+.Bd -literal -offset indent
+device atapicam
+device scbus
+device cd
+device pass
+.Ed
 .Pp
 Add the
 .Nm
 driver to the kernel.
 .Pp
-.Dl camcontrol devlist
+.Dl "camcontrol devlist"
 .Pp
 Print the list of all devices available through CAM.
 .Pp
-.Dl mount -t cd9660 /dev/cd0c /mnt
+.Dl "mount -t cd9660 /dev/cd0c /mnt"
 .Pp
 Mount a CD-ROM from an ATAPI CD-ROM drive
-.Pq the command above assumes that the ATAPI drive is the only CD-ROM unit .
+(the command above assumes that the ATAPI drive is the only CD-ROM unit).
 .Sh SEE ALSO
 .Xr ata 4 ,
+.Xr cam 4 ,
 .Xr scsi 4 ,
 .Xr atacontrol 8 ,
 .Xr camcontrol 8
@@ -100,15 +105,15 @@ The ATAPI/CAM driver first appeared in
 and
 .Fx 5.0 .
 .Sh AUTHORS
-.An -nosplit
 The ATAPI/CAM driver was written by
 .An Thomas Quinot Aq thomas@FreeBSD.org .
 .Sh BUGS
-.Pp
 .Nm
 and ATAPI-specific target drivers
-.Pq Nm acd , Nm ast , No and Nm afd
+.Xr ( acd 4 ,
+.Xr ast 4 ,
+and
+.Xr afd 4 )
 can be configured in the same kernel.
 Simultaneous access to the same device through the SCSI generic drivers
 and the ATAPI-specific drivers may cause problems and is strongly discouraged.
-