Cleanup.

4 files changed, 159 insertions, 133 deletions

diff --git a/share/man/man4/atapiscsi.4 b/share/man/man4/atapiscsi.4
index 035ff31ee81..331b5fe3a6d 100644
--- a/share/man/man4/atapiscsi.4
+++ b/share/man/man4/atapiscsi.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: atapiscsi.4,v 1.5 2000/04/03 21:19:35 aaron Exp $
+.\"	$OpenBSD: atapiscsi.4,v 1.6 2000/07/10 13:27:34 aaron Exp $
 .\"
 .\" Copyright (c) 1999 Constantine Sapuntzakis.
 .\"
@@ -41,14 +41,14 @@
 The
 .Nm
 driver supports ATAPI (also called IDE) devices such as CD-ROMs, ZIP
-drives, LS-120 floppy drives, and tape drives.  All ATAPI devices talk
-a subset of the SCSI protocol.
+drives, LS-120 floppy drives, and tape drives.
+All ATAPI devices talk a subset of the SCSI protocol.
 .Pp
 The
 .Nm
-driver acts like a SCSI adapter.  Thus, the ATAPI devices connected to
-the system will appear as SCSI devices.  ATAPI CD-ROMs will appear
-as
+driver acts like a SCSI adapter.
+Thus, the ATAPI devices connected to the system will appear as SCSI devices.
+ATAPI CD-ROMs will appear as
 .Xr cd 4
 devices, ATAPI tape drives as
 .Xr st 4
@@ -57,19 +57,20 @@ devices, and ATAPI floppies as
 devices.
 .Pp
 For performance reasons, one should avoid putting an ATAPI device and
-a hard disk on the same cable.  The driver does not support bus release
-and, even if it did, many ATAPI devices do not support it. There is
-only one command outstanding on a cable at a time. For example, if a
-hard disk and a CD drive are placed on the same cable, the hard disk
-requests may get queued behind slower CD operations.
-.Sh BUGS
-Slow devices, like tape drives, could do a better job of sharing the channel.
-For now, we recommend you put the tape device on its own channel.
+a hard disk on the same cable.
+The driver does not support bus release and, even if it did, many ATAPI
+devices do not support it.
+There is only one command outstanding on a cable at a time.
+For example, if a hard disk and a CD drive are placed on the same cable,
+the hard disk requests may get queued behind slower CD operations.
 .Sh SEE ALSO
+.Xr cd 4 ,
 .Xr intro 4 ,
 .Xr pciide 4 ,
 .Xr scsi 4 ,
-.Xr wdc 4 ,
-.Xr cd 4 ,
+.Xr sd 4 ,
 .Xr st 4 ,
-.Xr sd 4
+.Xr wdc 4
+.Sh BUGS
+Slow devices, like tape drives, could do a better job of sharing the channel.
+For now, we recommend you put the tape device on its own channel.
diff --git a/share/man/man4/boca.4 b/share/man/man4/boca.4
index a4642b11561..84b87049ca8 100644
--- a/share/man/man4/boca.4
+++ b/share/man/man4/boca.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: boca.4,v 1.1 2000/05/20 17:19:51 deraadt Exp $
+.\"	$OpenBSD: boca.4,v 1.2 2000/07/10 13:27:35 aaron Exp $
 .\"
 .\" Copyright (c) 1990, 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -66,8 +66,8 @@ and is configured as such.)
 .Sh DESCRIPTION
 The
 .Nm boca
-driver provides support for BOCA Research BB1004, BB1008 and BB2016
-boards that multiplex together up to four, eight or sixteen
+driver provides support for BOCA Research BB1004, BB1008, and BB2016
+boards that multiplex together up to four, eight, or sixteen
 .Tn EIA
 .Tn RS-232C
 .Pf ( Tn CCITT
@@ -78,11 +78,13 @@ Each
 .Nm
 device is the master device for up to eight
 .Nm com
-devices.  The kernel configuration specifies these
+devices.
+The kernel configuration specifies these
 .Nm com
 devices as slave devices of the
 .Nm
-device, as shown in the synopsis.  The slave ID given for each
+device, as shown in the synopsis.
+The slave ID given for each
 .Nm com
 device determines which bit in the interrupt multiplexing register is
 tested to find interrupts for that device.
@@ -104,6 +106,6 @@ The
 .Nm
 driver was written by Charles Hannum, based on the
 .Nm ast
-driver and source code from David Muir Sharnoff.  David wishes to
-acknowledge the assistance of Jason Venner in determining how to use
-the BOCA boards.
+driver and source code from David Muir Sharnoff.
+David wishes to acknowledge the assistance of Jason Venner in determining
+how to use the BOCA boards.
diff --git a/share/man/man4/pty.4 b/share/man/man4/pty.4
index f7fad90b11b..6a2e5f635aa 100644
--- a/share/man/man4/pty.4
+++ b/share/man/man4/pty.4
@@ -1,3 +1,4 @@
+.\"	$OpenBSD: pty.4,v 1.5 2000/07/10 13:27:35 aaron Exp $
 .\"	$NetBSD: pty.4,v 1.4 1998/03/21 03:14:30 fair Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
@@ -51,9 +52,9 @@ A pseudo terminal is a pair of character devices, a
 .Em master
 device and a
 .Em slave
-device.  The slave device provides to a process
-an interface identical
-to that described in
+device.
+The slave device provides to a process an interface identical to that
+described in
 .Xr tty 4 .
 However, whereas all other devices which provide the
 interface described in
@@ -77,7 +78,7 @@ The following
 calls apply only to pseudo terminals:
 .Bl -tag -width TIOCREMOTE
 .It Dv TIOCSTOP
-Stops output to a terminal (e.g. like typing
+Stops output to a terminal (e.g., like typing
 .Ql ^S ) .
 Takes
 no parameter.
@@ -90,18 +91,18 @@ Takes no parameter.
 .It Dv TIOCPKT
 Enable/disable
 .Em packet
-mode.  Packet mode is enabled by specifying (by reference)
-a nonzero parameter and disabled by specifying (by reference)
-a zero parameter.  When applied to the master side of a pseudo
-terminal, each subsequent
-.Xr read
+mode.
+Packet mode is enabled by specifying (by reference) a non-zero parameter
+and disabled by specifying (by reference) a zero parameter.
+When applied to the master side of a pseudo terminal, each subsequent
+.Xr read 2
 from the terminal will return data written on the slave part of
 the pseudo terminal preceded by a zero byte (symbolically
 defined as
 .Dv TIOCPKT_DATA ) ,
 or a single byte reflecting control
-status information.  In the latter case, the byte is an inclusive-or
-of zero or more of the bits:
+status information.
+In the latter case, the byte is an inclusive-or of zero or more of the bits:
 .Bl -tag -width TIOCPKT_FLUSHWRITE
 .It Dv TIOCPKT_FLUSHREAD
 whenever the read queue for the terminal is flushed.
@@ -205,10 +206,10 @@ A mode for the master half of a pseudo terminal, independent
 of
 .Dv TIOCPKT .
 This mode causes input to the pseudo terminal
-to be flow controlled and not input edited (regardless of the
-terminal mode).  Each write to the control terminal produces
-a record boundary for the process reading the terminal.  In
-normal usage, a write of data is like the data typed as a line
+to be flow controlled and not input edited (regardless of the terminal mode).
+Each write to the control terminal produces a record boundary for the process
+reading the terminal.
+In normal usage, a write of data is like the data typed as a line
 on the terminal; a write of 0 bytes is like typing an end-of-file
 character.
 .Dv TIOCREMOTE
@@ -223,8 +224,8 @@ master pseudo terminals
 .It Pa /dev/tty[p-r][0-9a-f]
 slave pseudo terminals
 .El
-.Sh DIAGNOSTICS
-None.
+.Sh SEE ALSO
+.Xr tty 4
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/st.4 b/share/man/man4/st.4
index bf175865444..e7371bb621d 100644
--- a/share/man/man4/st.4
+++ b/share/man/man4/st.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD
+.\"	$OpenBSD: st.4,v 1.5 2000/07/10 13:27:35 aaron Exp $
 .\"	$NetBSD: st.4,v 1.2 1996/10/20 23:15:24 explorer Exp $
 .\"
 .\" Copyright (c) 1996
@@ -40,19 +40,18 @@ The
 .Nm
 driver provides support for
 .Tn SCSI
-tape drives. It allows a tape drive to be run in several different
-modes depending on minor numbers and supports several different
-`sub-modes'.  The device can have both a
+tape drives.
+It allows a tape drive to be run in several different modes depending
+on minor numbers and supports several different
+.Dq sub-modes .
+The device can have both a
 .Em raw
-interface
-and a
+interface and a
 .Em block
-interface; however, only the raw interface is usually used (or
-recommended).
+interface; however, only the raw interface is usually used (or recommended).
 .Pp
 .Tn SCSI
-devices have a relatively high level interface and talk to the
-system via a
+devices have a relatively high level interface and talk to the system via a
 .Tn SCSI
 adapter and a
 .Tn SCSI
@@ -69,7 +68,8 @@ As the
 .Tn SCSI
 adapter is probed during boot, the
 .Tn SCSI
-bus is scanned for devices. Any devices found which answer as
+bus is scanned for devices.
+Any devices found which answer as
 .Sq Em Sequential
 type devices will be attached to the
 .Nm
@@ -80,17 +80,21 @@ The
 driver is based around the concept of a
 .Dq Em mount session ,
 which is defined as the period between the time that a tape is
-mounted, and the time when it is unmounted.  Any parameters set
-during a mount session remain in effect for the remainder of the
-session or until replaced. The tape can be unmounted, bringing the
-session to a close in several ways.  These include:
+mounted, and the time when it is unmounted.
+Any parameters set during a mount session remain in effect for the remainder
+of the session or until replaced.
+The tape can be unmounted, bringing the session to a close in several ways.
+These include:
 .Bl -enum
 .It
-Closing an `unmount device', referred to as sub-mode 00 below. An
-example is
+Closing an
+.Dq unmount device ,
+referred to as sub-mode 00 below.
+An example is
 .Pa /dev/rst0 .
 .It
-Using the MTOFFL
+Using the
+.Dv MTOFFL
 .Xr ioctl 2
 command, reachable through the
 .Sq Cm offline
@@ -98,24 +102,26 @@ command of
 .Xr mt 1 .
 .It
 Opening a different mode will implicitly unmount the tape, thereby
-closing off the mode that was previously mounted.  All parameters
-will be loaded freshly from the new mode.  (See below for more on
-modes.)
+closing off the mode that was previously mounted.
+All parameters will be loaded freshly from the new mode.
+(See below for more on modes.)
 .El
 .Sh MODES AND SUB-MODES
 There are several different
 .Sq operation
-modes. These are controlled by bits 2 and 3 of the minor number
+modes.
+These are controlled by bits 2 and 3 of the minor number
 and are designed to allow users to easily read and write different
-formats of tape on devices that allow multiple formats.  The
-parameters for each mode can be set individually by hand with the
+formats of tape on devices that allow multiple formats.
+The parameters for each mode can be set individually by hand with the
 .Xr mt 1
-command.  When a device corresponding to a particular mode is first
-mounted, The operating parameters for that mount session are copied
-from that mode.  Further changes to the parameters during the
-session will change those in effect for the session but not those
-set in the operation mode.  To change the parameters for an operation
-mode, one must compile them into the
+command.
+When a device corresponding to a particular mode is first
+mounted, the operating parameters for that mount session are copied
+from that mode.
+Further changes to the parameters during the session will change those in
+effect for the session but not those set in the operation mode.
+To change the parameters for an operation mode, one must compile them into the
 .Dq Em quirk
 table in the driver's source code.
 .Pp
@@ -129,17 +135,20 @@ A close will rewind the device; if the tape has been written, then
 a file mark will be written before the rewind is requested.
 The device is unmounted.
 .It 01
-A close will leave the tape mounted.  If the tape was written to,
-a file mark will be written.  No other head positioning takes place.
+A close will leave the tape mounted.
+If the tape was written to, a file mark will be written.
+No other head positioning takes place.
 Any further reads or writes will occur directly after the last
 read, or the written file mark.
 .It 10
-A close will rewind the device. If the tape has been written, then
-a file mark will be written before the rewind is requested.  On
-completion of the rewind an unload command will be issued.  The
-device is unmounted.
+A close will rewind the device.
+If the tape has been written, then a file mark will be written before the
+rewind is requested.
+On completion of the rewind an unload command will be issued.
+The device is unmounted.
 .It 11
-Reserved.  Currently unused.
+Reserved.
+Currently unused.
 .El
 .Sh BLOCKING MODES
 .Tn SCSI
@@ -147,60 +156,68 @@ tapes may run in either
 .Sq Em variable
 or
 .Sq Em fixed
-block-size modes.  Most
+block-size modes.
+Most
 .Tn QIC Ns -type
 devices run in fixed block-size mode, where most nine-track tapes
-and many new cartridge formats allow variable block-size.  The
-difference between the two is as follows:
+and many new cartridge formats allow variable block-size.
+The difference between the two is as follows:
 .Bl -inset
 .It Variable block-size:
 Each write made to the device results in a single logical record
-written to the tape.  One can never read or write
+written to the tape.
+One can never read or write
 .Em part
 of a record from tape (though you may request a larger block and
-read a smaller record); nor can one read multiple blocks.  Data
-from a single write is therefore read by a single read. The block
-size used may be any value supported by the device, the
+read a smaller record); nor can one read multiple blocks.
+Data from a single write is therefore read by a single read.
+The block size used may be any value supported by the device, the
 .Tn SCSI
 adapter and the system (usually between 1 byte and 64 Kbytes,
 sometimes more).
 .Pp
 When reading a variable record/block from the tape, the head is
 logically considered to be immediately after the last item read,
-and before the next item after that. If the next item is a file
-mark, but it was never read, then the next process to read will
-immediately hit the file mark and receive an end-of-file notification.
+and before the next item after that.
+If the next item is a file mark, but it was never read, then the next
+process to read will immediately hit the file mark and receive an
+end-of-file notification.
 .It Fixed block-size
 data written by the user is passed to the tape as a succession of
-fixed size blocks.  It may be contiguous in memory, but it is
-considered to be a series of independent blocks. One may never
-write an amount of data that is not an exact multiple of the
-blocksize.  One may read and write the same data as a different
-set of records. In other words, blocks that were written together
-may be read separately, and vice-versa.
+fixed size blocks.
+It may be contiguous in memory, but it is considered to be a series of
+independent blocks.
+One may never write an amount of data that is not an exact multiple of the
+blocksize.
+One may read and write the same data as a different set of records.
+In other words, blocks that were written together may be read separately,
+and vice-versa.
 .Pp
 If one requests more blocks than remain in the file, the drive will
-encounter the file mark.  Because there is some data to return
-(unless there were no records before the file mark), the read will
-succeed, returning that data. The next read will return immediately
-with an EOF.  (As above, if the file mark is never read, it remains
-for the next process to read if in no-rewind mode.)
+encounter the file mark.
+Because there is some data to return (unless there were no records before
+the file mark), the read will succeed, returning that data.
+The next read will return immediately with an
+.Dv EOF .
+(As above, if the file mark is never read, it remains for the next process
+to read if in no-rewind mode.)
 .El
 .Sh FILE MARK HANDLING
-The handling of file marks on write is automatic. If the user has
-written to the tape, and has not done a read since the last write,
-then a file mark will be written to the tape when the device is
-closed.  If a rewind is requested after a write, then the driver
+The handling of file marks on write is automatic.
+If the user has written to the tape, and has not done a read since the last
+write, then a file mark will be written to the tape when the device is closed.
+If a rewind is requested after a write, then the driver
 assumes that the last file on the tape has been written, and ensures
-that there are two file marks written to the tape.  The exception
-to this is that there seems to be a standard (which we follow, but
-don't understand why) that certain types of tape do not actually
-write two file marks to tape, but when read, report a `phantom'
-file mark when the last file is read.  These devices include the
-QIC family of devices.  (It might be that this set of devices is
-the same set as that of fixed block devices.  This has not been
-determined yet, and they are treated as separate behaviors by the
-driver at this time.)
+that there are two file marks written to the tape.
+The exception to this is that there seems to be a standard (which we follow,
+but don't understand why) that certain types of tape do not actually
+write two file marks to tape, but when read, report a
+.Dq phantom
+file mark when the last file is read.
+These devices include the QIC family of devices.
+(It might be that this set of devices is the same set as that of fixed
+This has not yet been determined, and they are treated as separate
+behaviors by the driver at this time.)
 .Sh KERNEL CONFIGURATION
 Because different tape drives behave differently, there is a
 mechanism within the source to
@@ -210,18 +227,21 @@ models of drive that have special requirements.
 .Pp
 There is a table (called the
 .Dq Em quirk table )
-in which the identification strings of known errant drives can be
-stored.  Alongside each is a set of flags that allows the setting
+in which the identification strings of known errant drives can be stored.
+Alongside each is a set of flags that allows the setting
 of densities and blocksizes for each of the modes, along with a
-set of `QUIRK' flags that can be used to enable or disable sections
+set of
+.Dq QUIRK
+flags that can be used to enable or disable sections
 of code within the driver if a particular drive is recognized.
 .Sh IOCTLS
 The following
 .Xr ioctl 2
 calls apply to
 .Tn SCSI
-tapes.  Some also apply to other tapes.  They are defined in the
-header file
+tapes.
+Some also apply to other tapes.
+They are defined in the header file
 .Aq Pa /sys/mtio.h .
 .\"
 .\" Almost all of this discussion belongs in a separate mt(4)
@@ -234,7 +254,8 @@ header file
 Retrieve the status and parameters of the tape.
 .It Dv MTIOCTOP
 .Pq Li "struct mtop"
-Perform a multiplexed operation.  The argument structure is as follows:
+Perform a multiplexed operation.
+The argument structure is as follows:
 .Bd -literal -offset indent
 struct mtop {
 	short	mt_op;
@@ -252,15 +273,16 @@ end of file marks at the present head position.
 .It Dv MTFSF
 Skip over
 .Va mt_count
-file marks. Leave the head on the EOM side of the last skipped
-file mark.
+file marks.
+Leave the head on the EOM side of the last skipped file mark.
 .It Dv MTBSF
 Skip
 .Em backwards
 over
 .Va mt_count
-file marks. Leave the head on the BOM (beginning of media)
-side of the last skipped file mark.
+file marks.
+Leave the head on the BOM (beginning of media) side of the last skipped
+file mark.
 .It Dv MTFSR
 Skip forwards over
 .Va mt_count
@@ -272,8 +294,9 @@ records.
 .It Dv MTREW
 Rewind the device to the beginning of the media.
 .It Dv MTOFFL
-Rewind the media (and, if possible, eject). Even if the device cannot
-eject the media it will often no longer respond to normal requests.
+Rewind the media (and, if possible, eject).
+Even if the device cannot eject the media it will often no longer respond
+to normal requests.
 .It Dv MTNOP
 No-op; set status only.
 .It Dv MTCACHE
@@ -281,10 +304,10 @@ Enable controller buffering.
 .It Dv MTNOCACHE
 Disable controller buffering.
 .It Dv MTSETBSIZ
-Set the blocksize to use for the device/mode. If the device is capable of
-variable blocksize operation, and the blocksize is set to 0, then the drive
-will be driven in variable mode. This parameter is in effect for the present
-mount session only.
+Set the blocksize to use for the device/mode.
+If the device is capable of variable blocksize operation, and the blocksize
+is set to 0, then the drive will be driven in variable mode.
+This parameter is in effect for the present mount session only.
 .It Dv MTSETDNSTY
 Set the density value (see
 .Xr mt 1 )
@@ -304,7 +327,7 @@ devices).
 .Sh FILES
 .Bl -tag -width /dev/[n][e]rst[0-9] -compact
 .It Pa /dev/[n][e]rst[0-9]
-general form:
+general form
 .It Pa /dev/rst0
 Mode 0, rewind on close
 .It Pa /dev/nrst0
@@ -312,8 +335,6 @@ Mode 2, No rewind on close
 .It Pa /dev/erst0
 Mode 3, Eject on close (if capable)
 .El
-.Sh DIAGNOSTICS
-None.
 .Sh SEE ALSO
 .Xr mt 1 ,
 .Xr mtio 4 ,
@@ -325,6 +346,7 @@ driver was originally written for
 .Tn Mach
 2.5 by Julian Elischer, and was ported to
 .Tn NetBSD
-by Charles Hannum.  This man page was edited for
+by Charles Hannum.
+This man page was edited for
 .Tn NetBSD
 by Jon Buller.