mdoc(7) & nroff cleanup, plus some additional references

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

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
+is a memory based color frame buffer.
-into a user process address space by using
+Its pixel memory can be mapped into a user process address space
-the
+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 ,

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
+is a memory based color frame buffer with overlay plane.
-and control planes can be mapped into a user process address space by using
+Its pixel memory and control planes can be mapped into a user
-the
+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 ,

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.
@@ -56,14 +56,17 @@ 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 mode, i.e.
-emulation does include support for the hardware cursor present on the
+in 8-bit unaccelerated mode.
+This emulation does include support for the hardware cursor present on the
 .Nm cgfourteen ,
 however.
 .Sh SEE ALSO

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.
@@ -51,7 +51,8 @@
 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 ,

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.
@@ -51,7 +51,8 @@
 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 ,

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.
@@ -45,13 +45,15 @@
 .Sh DESCRIPTION
 The
 .Nm cgtwo
-is a memory based color frame buffer. Its control pixel memory can be mapped
+is a memory based color frame buffer.
-into a user process address space by using
+Its control pixel memory can be mapped into a user process address
-the
+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 ,

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.
@@ -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
+This is the driver for the built-in floppy disk drive run by the
-Sparcstation 1, and (optionally) other desktop Sparc systems.
+.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

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.
@@ -46,45 +46,66 @@
 The
 .Nm
 driver provides an interface to the workstation console keyboard.
-.Dq type 2 ,
+The
-.Dq type 3 ,
+.Tn Sun
+.Qq type 2 ,
+.Qq type 3 ,
+.Qq type 4 ,
 and
-.Dq type 4
+.Qq type 5
-keyboards are supported. All types generate keycodes encoding the
+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
+driver either passes the keycodes to an application as they come in
-translates them into ASCII characters first according to a set of built-in
+.Pq e.g. Xr X 1 ,
-tables.
+or translates them into
-If the keyboard is configured as the device
+.Tn ASCII
-to be used for system console input
+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
+is used to get direct access to the keyboard input stream.
-ioctl's are supported (mostly just enough to keep the X11 server going):
+.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
+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.

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.
@@ -51,11 +51,14 @@
 .Sh DESCRIPTION
 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
+Am7990
-.Tn LANCE
+Local Area Network Controller for Ethernet
-Ethernet chip set.
+.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
+parameter is not specified, a default connector is selected for
-all media types for carrier. The first connector on which a carrier is
+use by examining all media types for carrier.
-detected will be selected.
+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

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
+.Pa /dev/mem
-is an interface to the physical memory of the
+is an interface to the physical memory of the computer.
-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

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.

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,
+Due to limitations within the
-these functions run at elevated priority
+.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.

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.
@@ -44,16 +44,19 @@
 .Cd "tcx* at sbus? slot ? offset ?"
 .Sh DESCRIPTION
 The
-.Nm tcx
+.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
+driver supports the minimal ioctl's needed to run
-in
+.Xr X 1 ,
+and can be operated in
 .Xr cgthree 4
 emulation mode.
 .Sh SEE ALSO