From 7dfd309216244461bb134dd2084bd03ff8fdfbd4 Mon Sep 17 00:00:00 2001
From: fair <fair@NetBSD.org>
Date: Thu, 11 Jun 1998 08:32:19 +0000
Subject: [PATCH] mdoc(7) & nroff cleanup, plus some additional references

---
 share/man/man4/man4.sparc/bwtwo.4      |  5 +-
 share/man/man4/man4.sparc/cgeight.4    | 14 +++--
 share/man/man4/man4.sparc/cgfour.4     | 14 +++--
 share/man/man4/man4.sparc/cgfourteen.4 | 23 ++++----
 share/man/man4/man4.sparc/cgsix.4      |  7 ++-
 share/man/man4/man4.sparc/cgthree.4    |  7 ++-
 share/man/man4/man4.sparc/cgtwo.4      | 18 +++---
 share/man/man4/man4.sparc/fd.4         | 28 +++++----
 share/man/man4/man4.sparc/kbd.4        | 78 +++++++++++++++++---------
 share/man/man4/man4.sparc/le.4         | 25 +++++----
 share/man/man4/man4.sparc/mem.4        | 15 +++--
 share/man/man4/man4.sparc/ms.4         |  8 ++-
 share/man/man4/man4.sparc/openprom.4   | 16 +++++-
 share/man/man4/man4.sparc/tcx.4        | 19 ++++---
 14 files changed, 170 insertions(+), 107 deletions(-)

diff --git a/share/man/man4/man4.sparc/bwtwo.4 b/share/man/man4/man4.sparc/bwtwo.4
index 1fc00b904fca..2346c4b64922 100644
--- a/share/man/man4/man4.sparc/bwtwo.4
+++ b/share/man/man4/man4.sparc/bwtwo.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: bwtwo.4,v 1.2 1996/07/31 20:33:03 thorpej Exp $
+.\"	$NetBSD: bwtwo.4,v 1.3 1998/06/11 08:32:19 fair Exp $
 .\"
 .\" Copyright (c) 1992, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -50,7 +50,8 @@
 The 
 .Nm
 is a memory based black and white frame buffer.
-It supports the minimal ioctl's needed to run X11.
+It supports the minimal ioctl's needed to run
+.Xr X 1 .
 .Sh SEE ALSO
 .Xr cgsix 4 ,
 .Xr cgthree 4
diff --git a/share/man/man4/man4.sparc/cgeight.4 b/share/man/man4/man4.sparc/cgeight.4
index d8b764c80a23..dddb3e261673 100644
--- a/share/man/man4/man4.sparc/cgeight.4
+++ b/share/man/man4/man4.sparc/cgeight.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: cgeight.4,v 1.2 1997/10/08 22:00:03 jtc Exp $
+.\"	$NetBSD: cgeight.4,v 1.3 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -46,13 +46,15 @@
 .Sh DESCRIPTION
 The 
 .Nm
-is a memory based color frame buffer. Its pixel memory can be mapped
-into a user process address space by using
-the
+is a memory based color frame buffer.
+Its pixel memory can be mapped into a user process address space
+by using the
 .Xr mmap 2
-system call. The
+system call.
+The
 .Nm
-driver supports the minimal ioctl's needed to run X11.
+driver supports the minimal ioctl's needed to run
+.Xr X 1 .
 .Sh SEE ALSO
 .Xr bwtwo 4 ,
 .Xr cgtwo 4 ,
diff --git a/share/man/man4/man4.sparc/cgfour.4 b/share/man/man4/man4.sparc/cgfour.4
index 7449afa96c0d..dc6ec8aaeef4 100644
--- a/share/man/man4/man4.sparc/cgfour.4
+++ b/share/man/man4/man4.sparc/cgfour.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: cgfour.4,v 1.2 1997/10/08 22:00:05 jtc Exp $
+.\"	$NetBSD: cgfour.4,v 1.3 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -46,13 +46,15 @@
 .Sh DESCRIPTION
 The 
 .Nm
-is a memory based color frame buffer with overlay plane. Its pixel memory
-and control planes can be mapped into a user process address space by using
-the
+is a memory based color frame buffer with overlay plane.
+Its pixel memory and control planes can be mapped into a user
+process address space by using the
 .Xr mmap 2
-system call. The
+system call.
+The
 .Nm
-driver supports the minimal ioctl's needed to run X11.
+driver supports the minimal ioctl's needed to run
+.Xr X 1 .
 .Sh SEE ALSO
 .Xr bwtwo 4 ,
 .Xr cgtwo 4 ,
diff --git a/share/man/man4/man4.sparc/cgfourteen.4 b/share/man/man4/man4.sparc/cgfourteen.4
index 2f681c1ef17c..7be32f4a55f5 100644
--- a/share/man/man4/man4.sparc/cgfourteen.4
+++ b/share/man/man4/man4.sparc/cgfourteen.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: cgfourteen.4,v 1.2 1997/10/08 22:00:06 jtc Exp $
+.\"	$NetBSD: cgfourteen.4,v 1.3 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright (c) 1996 The President and Fellows of Harvard College.
 .\" All rights reserved.
@@ -28,7 +28,7 @@
 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
@@ -36,7 +36,7 @@
 .\" 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.
-.\" 
+.\"
 .\" Based on tcx.4,
 .\"	NetBSD: tcx.4,v 1.2 1996/06/21 22:35:06 pk Exp
 .\"
@@ -49,22 +49,25 @@
 .Sh SYNOPSIS
 .Cd "cgfourteen* at obio?"
 .Sh DESCRIPTION
-The 
+The
 .Nm cgfourteen
 is a memory based color frame buffer, with graphics acceleration and
-overlay capabilities. Its pixel memory can be mapped into a user process 
+overlay capabilities. Its pixel memory can be mapped into a user process
 address space by using
 the
 .Xr mmap 2
-system call. The
+system call.
+The
 .Nm
-driver supports the minimal ioctl's needed to run X11.
+driver supports the minimal ioctl's needed to run
+.Xr X 1 .
 .Pp
 The driver operates by default in
 .Xr cgthree 4
-emulation mode, i.e. in 8-bit unaccelerated mode. This
-emulation does include support for the hardware cursor present on the
-.Nm cgfourteen , 
+emulation mode, i.e.
+in 8-bit unaccelerated mode.
+This emulation does include support for the hardware cursor present on the
+.Nm cgfourteen ,
 however.
 .Sh SEE ALSO
 .Xr bwtwo 4 ,
diff --git a/share/man/man4/man4.sparc/cgsix.4 b/share/man/man4/man4.sparc/cgsix.4
index 5686f3889ef0..2c7a45366583 100644
--- a/share/man/man4/man4.sparc/cgsix.4
+++ b/share/man/man4/man4.sparc/cgsix.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: cgsix.4,v 1.3 1996/07/31 20:33:04 thorpej Exp $
+.\"	$NetBSD: cgsix.4,v 1.4 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright 1994
 .\"	The Regents of the University of California.  All rights reserved.
@@ -48,10 +48,11 @@
 .Cd "cgsix0 at obio0 addr 0xfb000000 level 4" Pq sun4/300
 .Cd "cgsix0 at obio0 addr 0x0b000000 level 4" Pq sun4/100
 .Sh DESCRIPTION
-The 
+The
 .Nm cgsix
 is a memory based color frame buffer.
-It supports the minimal ioctl's needed to run X11.
+It supports the minimal ioctl's needed to run
+.Xr X 1 .
 .Sh SEE ALSO
 .Xr bwtwo 4 ,
 .Xr cgtwo 4 ,
diff --git a/share/man/man4/man4.sparc/cgthree.4 b/share/man/man4/man4.sparc/cgthree.4
index e6bbe5720b6c..5bbc8b7d0f56 100644
--- a/share/man/man4/man4.sparc/cgthree.4
+++ b/share/man/man4/man4.sparc/cgthree.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: cgthree.4,v 1.3 1996/07/31 20:33:05 thorpej Exp $
+.\"	$NetBSD: cgthree.4,v 1.4 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright (c) 1992, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -48,10 +48,11 @@
 .Cd "cgthree* at sbus? slot ? offset ?"
 .Cd "cgthree* at obio0 slot ? offset ?" Pq some sun4m models
 .Sh DESCRIPTION
-The 
+The
 .Nm
 is a memory based color frame buffer.
-It supports the minimal ioctl's needed to run X11.
+It supports the minimal ioctl's needed to run
+.Xr X 1 .
 .Sh SEE ALSO
 .Xr bwtwo 4 ,
 .Xr cgtwo 4 ,
diff --git a/share/man/man4/man4.sparc/cgtwo.4 b/share/man/man4/man4.sparc/cgtwo.4
index 329c97710922..33fa6c588984 100644
--- a/share/man/man4/man4.sparc/cgtwo.4
+++ b/share/man/man4/man4.sparc/cgtwo.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: cgtwo.4,v 1.3 1997/10/08 22:00:08 jtc Exp $
+.\"	$NetBSD: cgtwo.4,v 1.4 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -25,7 +25,7 @@
 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
@@ -43,15 +43,17 @@
 .Sh SYNOPSIS
 .Cd "cgtwo* at vmes0 addr 0xff400000 level 4 vect 0xa8"
 .Sh DESCRIPTION
-The 
+The
 .Nm cgtwo
-is a memory based color frame buffer. Its control pixel memory can be mapped
-into a user process address space by using
-the
+is a memory based color frame buffer.
+Its control pixel memory can be mapped into a user process address
+space by using the
 .Xr mmap 2
-system call. The
+system call.
+The
 .Nm
-driver supports the minimal ioctl's needed to run X11.
+driver supports the minimal ioctl's needed to run
+.Xr X 1 .
 .Sh SEE ALSO
 .Xr bwtwo 4 ,
 .Xr cgthree 4 ,
diff --git a/share/man/man4/man4.sparc/fd.4 b/share/man/man4/man4.sparc/fd.4
index 3ac76c22fb86..2d4cfd350deb 100644
--- a/share/man/man4/man4.sparc/fd.4
+++ b/share/man/man4/man4.sparc/fd.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: fd.4,v 1.4 1997/11/12 00:49:42 mrg Exp $
+.\"	$NetBSD: fd.4,v 1.5 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -25,7 +25,7 @@
 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
@@ -40,14 +40,18 @@
 .Sh NAME
 .Nm fd ,
 .Nm fdc
-.Nd Sparcstation floppy drive
+.Nd SPARCstation i82072 or i82077 floppy disk controller driver
 .Sh SYNOPSIS
 .Cd "fdc0 at mainbus0" Pq sun4c
 .Cd "fdc0 at obio0" Pq sun4m
 .Cd "fd* at fdc0"
 .Sh DESCRIPTION
-This is the driver for the built-in disquette station found on the
-Sparcstation 1, and (optionally) other desktop Sparc systems.
+This is the driver for the built-in floppy disk drive run by the
+.Tn Intel
+i82072 or i82077 controller chip found on the SPARCstation desktop
+systems, and other
+.Tn SPARC
+systems.
 .Pp
 Bits
 .Bq 0-3
@@ -55,13 +59,13 @@ of the minor device number of the special files referring to this
 device encode the floppy density as follows:
 .Bl -tag -width indent -offset indent
 .It 0
-3.5'' 1.44MB disquettes.
+3.5'' 1.44MB floppy diskettes.
 .It 1
-3.5'' 720KB disquettes.
+3.5'' 720KB floppy diskettes.
 .It 2
-3.5'' 360KB disquettes.
+3.5'' 360KB floppy diskettes.
 .It 3
-3.5'' 1.2MB/NEC Japanese format disquettes.
+3.5'' 1.2MB/NEC Japanese format floppy diskettes.
 .El
 .Sh FORMATTING
 The driver supports floppy disk formatting using the interfaces in
@@ -69,7 +73,8 @@ The driver supports floppy disk formatting using the interfaces in
 .Pp
 .Bl -tag -width FDIOCFORMAT_TRACK -compact
 .It Dv FDIOCGETFORMAT Fa struct fdformat_parms
-Fetch current formatting parameters.  This gets the default parameters
+Fetch current formatting parameters.
+This gets the default parameters
 for the open device if no parameters have been set during the session.
 .Pp
 .It Dv FDIOCSETFORMAT Fa struct fdformat_parms
@@ -86,7 +91,8 @@ If it returns
 there was a medium error while formatting the track.
 .Pp
 .It Dv FDIOCSETOPTS Fa int
-Set driver options which persist until the device is closed.  The
+Set driver options which persist until the device is closed.
+The
 options should be the logical OR of the desired values below:
 .Pp
 .Bl -tag -width FDOPT_NORETRY -compact
diff --git a/share/man/man4/man4.sparc/kbd.4 b/share/man/man4/man4.sparc/kbd.4
index 17a5d18f7add..eaccddc5c411 100644
--- a/share/man/man4/man4.sparc/kbd.4
+++ b/share/man/man4/man4.sparc/kbd.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: kbd.4,v 1.3 1997/11/25 22:15:56 pk Exp $
+.\"	$NetBSD: kbd.4,v 1.4 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -25,7 +25,7 @@
 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
@@ -46,45 +46,66 @@
 The
 .Nm
 driver provides an interface to the workstation console keyboard.
-.Dq type 2 ,
-.Dq type 3 ,
+The
+.Tn Sun
+.Qq type 2 ,
+.Qq type 3 ,
+.Qq type 4 ,
 and
-.Dq type 4
-keyboards are supported. All types generate keycodes encoding the
+.Qq type 5
+keyboards are supported.
+The
+.Qq type 5
+keyboard is treated as if it were a
+.Qq type 4 .
+All types generate keycodes encoding the
 key identity and motion (up or down) as the keys are pressed and released.
 The
 .Nm
-driver either passes the keycodes to an application as they come in, or
-translates them into ASCII characters first according to a set of built-in
-tables.
-If the keyboard is configured as the device
-to be used for system console input
+driver either passes the keycodes to an application as they come in
+.Pq e.g. Xr X 1 ,
+or translates them into
+.Tn ASCII
+characters first according to a set of built-in tables.
+.Pp
+If the
+.Nm
+is configured as the device to be used for system console input
 .Pq see Xr openprom 4 ,
 it will be internally connected to the
 .Pa /dev/console
 device special file, which can be used as a
 .Xr tty 4
 device.
+.Pp
 The device special file
 .Pa /dev/kbd
-is used to get direct access to the keyboard input stream. The following
-ioctl's are supported (mostly just enough to keep the X11 server going):
+is used to get direct access to the keyboard input stream.
+.Pp
+The following
+ioctl's are supported (mostly just enough to keep the
+.Xr X 1
+server going):
 .Bl -tag -width KIOCSDIRECT
 .It KIOCTRANS
-Set translation mode. The argument is of type
+Set translation mode.
+The argument is of type
 .Fa "int *" ,
 the only value supported is
 .Dv TR_UNTRANS_EVENT .
 .It KIOCGTRANS
-Get translation mode. The argument is of type
+Get translation mode.
+The argument is of type
 .Fa "int *" .
 .Dv TR_UNTRANS_EVENT
 is always returned.
 .It KIOCGETKEY
-Fill in old-style key station translation. The argument is of type
+Fill in old-style key station translation.
+The argument is of type
 .Fa "struct okiockey *" .
 .It KIOCCMD
-Send a command to the keyboard. The argument is of type
+Send a command to the keyboard.
+The argument is of type
 .Fa "int *" ,
 and can have one of the following values:
 .Bl -tag -width KBD_CMD_NOCLICK
@@ -95,10 +116,11 @@ Stop the keyboard beeper.
 .It KBD_CMD_CLICK
 Instruct the keyboard to make extra noise when touching keys.
 .It KBD_CMD_NOCLICK
-Instruct the keyboard to.. oh well..
+Instruct the keyboard to stop making extra noise when touching keys.
 .El
 .It KIOCTYPE
-Get keyboard type. The argument is of type
+Get keyboard type.
+The argument is of type
 .Fa "int *" ,
 in which one of the values
 .Dv KB_SUN2 ,
@@ -107,20 +129,24 @@ or
 .Dv KB_SUN4
 will be returned.
 .It KIOCSDIRECT
-Route the keyboard input stream through the (SunOS) compatible event module.
+Route the keyboard input stream through the
+.Tn SunOS
+compatible event module.
 The argument is of type
 .Fa "int *" ,
 a non-zero value will put the driver into
-.Dq event
+.Qq event
 mode, while a value of zero will make it return to
-.Dq ASCII translation
+.Qq ASCII translation
 mode.
 .It KIOCSKEY
-Set key station translation. The argument is of type
-.Fa "struct kiockey *" 
+Set key station translation.
+The argument is of type
+.Fa "struct kiockey *"
 .Pq see Pa /usr/include/machine/kbio.h No for more details .
 .It KIOCGKEY
-Get key station translation. The argument is of type
+Get key station translation.
+The argument is of type
 .Fa "struct kiockey *" .
 .It KIOCLAYOUT
 Get keyboard layout
@@ -161,4 +187,4 @@ in which the current LED state is returned.
 .Nm
 is hardwired to the built-in
 .Em zs1
-serial port.
+serial port at 1200 bps.
diff --git a/share/man/man4/man4.sparc/le.4 b/share/man/man4/man4.sparc/le.4
index ad1c57481997..f4f0ee925af6 100644
--- a/share/man/man4/man4.sparc/le.4
+++ b/share/man/man4/man4.sparc/le.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: le.4,v 1.6 1997/07/11 09:33:18 pk Exp $
+.\"	$NetBSD: le.4,v 1.7 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright (c) 1992, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -49,13 +49,16 @@
 .Cd "le* at ledma0 slot ? offset ?"
 .Cd "le* at lebuffer? slot ? offset ?"
 .Sh DESCRIPTION
-The 
+The
 .Nm
-interface provides access to the 10 Mb/s Ethernet network via the
+interface provides access to the 10 Mb/s
+.Tn Ethernet
+network via the
 .Tn AMD
-7990
-.Tn LANCE
-Ethernet chip set.
+Am7990
+Local Area Network Controller for Ethernet
+.Pq Tn LANCE
+chip set.
 .Pp
 Each of the host's network addresses
 is specified at boot time with an
@@ -65,7 +68,9 @@ The
 .Nm
 interface employs the address resolution protocol described in
 .Xr arp 4
-to dynamically map between Internet and Ethernet addresses on the local
+to dynamically map between Internet and
+.Tn Ethernet
+addresses on the local
 network.
 .Pp
 Interfaces attached to an
@@ -95,9 +100,9 @@ to select the UTP connector.
 .Pp
 If a
 .Cm media
-parameter is not specified, a default connector is selected for use by examining
-all media types for carrier. The first connector on which a carrier is
-detected will be selected.
+parameter is not specified, a default connector is selected for
+use by examining all media types for carrier.
+The first connector on which a carrier is detected will be selected.
 Additionally, if carrier is dropped on a port, the driver will switch between
 the possible ports until one with carrier is found.
 .Pp
diff --git a/share/man/man4/man4.sparc/mem.4 b/share/man/man4/man4.sparc/mem.4
index 3f70bb3934da..95658e26c615 100644
--- a/share/man/man4/man4.sparc/mem.4
+++ b/share/man/man4/man4.sparc/mem.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mem.4,v 1.2 1996/07/31 20:33:08 thorpej Exp $
+.\"	$NetBSD: mem.4,v 1.3 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright (c) 1992, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -43,23 +43,22 @@
 .Sh NAME
 .Nm mem ,
 .Nm kmem
-.Nd main memory
+.Nd main memory access driver
 .Sh DESCRIPTION
 The file
-.Nm /dev/mem
-is an interface to the physical memory of the
-computer.
+.Pa /dev/mem
+is an interface to the physical memory of the computer.
 Byte offsets in this file are interpreted as physical memory addresses.
 Reading and writing this file is equivalent to reading and writing
 memory itself.
 An error will be returned if an attempt is made to reference
 an offset outside of
-.Nm /dev/mem .
+.Pa /dev/mem .
 .Pp
 Kernel virtual memory is accessed via the file
-.Nm /dev/kmem
+.Pa /dev/kmem
 in the same manner as
-.Nm /dev/mem .
+.Pa /dev/mem .
 Only kernel virtual addresses that are currently mapped to memory are allowed.
 .Sh SPARC
 On the
diff --git a/share/man/man4/man4.sparc/ms.4 b/share/man/man4/man4.sparc/ms.4
index 503c2a6e485d..682cf56492b5 100644
--- a/share/man/man4/man4.sparc/ms.4
+++ b/share/man/man4/man4.sparc/ms.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: ms.4,v 1.3 1998/06/11 07:21:07 fair Exp $
+.\"	$NetBSD: ms.4,v 1.4 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -70,7 +70,9 @@ The device special file
 .Pa /dev/mouse
 is used to get direct access to the mouse input stream.
 The following
-ioctl's are supported (mostly just enough to keep the X11 server going):
+ioctl's are supported (mostly just enough to keep the
+.Xr X 1
+server going):
 .Bl -tag -width VUIDSFORMAT
 .It Dv VUIDSFORMAT
 Set translation mode.
@@ -91,4 +93,4 @@ is always returned.
 .Nm
 is hardwired to the built-in
 .Em zs1
-serial port.
+serial port at 1200 bps.
diff --git a/share/man/man4/man4.sparc/openprom.4 b/share/man/man4/man4.sparc/openprom.4
index 6de96b29c97b..f756f2d574ee 100644
--- a/share/man/man4/man4.sparc/openprom.4
+++ b/share/man/man4/man4.sparc/openprom.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: openprom.4,v 1.2 1996/07/31 20:33:09 thorpej Exp $
+.\"	$NetBSD: openprom.4,v 1.3 1998/06/11 08:32:21 fair Exp $
 .\"
 .\" Copyright (c) 1992, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -149,7 +149,17 @@ exceeds the maximum allowed length (8191 bytes).
 .El
 .Sh SEE ALSO
 .Xr ioctl 2
+.Pp
+.Pa http://playground.sun.com/1275/
 .Sh BUGS
-Due to limitations within the OPENPROM itself,
-these functions run at elevated priority
+Due to limitations within the
+.Nm
+itself, these functions run at elevated priority
 and may adversely affect system performance.
+.Pp
+The
+.Tn Sun
+.Nm
+is what became the Open Firmware
+.Pq Tn IEEE 1275
+standard for processor and system independent boot firmware.
diff --git a/share/man/man4/man4.sparc/tcx.4 b/share/man/man4/man4.sparc/tcx.4
index 606d0fcbd4e2..cb4fce0d018d 100644
--- a/share/man/man4/man4.sparc/tcx.4
+++ b/share/man/man4/man4.sparc/tcx.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: tcx.4,v 1.3 1997/10/08 22:00:14 jtc Exp $
+.\"	$NetBSD: tcx.4,v 1.4 1998/06/11 08:32:21 fair Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -25,7 +25,7 @@
 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
@@ -43,17 +43,20 @@
 .Sh SYNOPSIS
 .Cd "tcx* at sbus? slot ? offset ?"
 .Sh DESCRIPTION
-The 
-.Nm tcx
+The
+.Nm
 is a memory based color frame buffer, with graphics acceleration and
-overlay capabilities. Its control registers, colour lookup table and
+overlay capabilities.
+Its control registers, colour lookup table and
 pixel memory can be mapped into a user process address space by using
 the
 .Xr mmap 2
-system call. The
+system call.
+The
 .Nm
-driver supports the minimal ioctl's needed to run X11, and can be operated
-in
+driver supports the minimal ioctl's needed to run
+.Xr X 1 ,
+and can be operated in
 .Xr cgthree 4
 emulation mode.
 .Sh SEE ALSO