Assorted markup, spelling, and grammar fixes.

10 files changed, 93 insertions, 84 deletions

diff --git a/share/man/man4/acpi_video.4 b/share/man/man4/acpi_video.4
index 47a8d1f..49443d7 100644
--- a/share/man/man4/acpi_video.4
+++ b/share/man/man4/acpi_video.4
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd March 03, 2004
+.Dd March 3, 2004
 .Dt ACPI_VIDEO 4
 .Os
 .Sh NAME
@@ -38,20 +38,25 @@ This driver uses the ACPI Video Extensions to control display switching and
 backlight brightness.
 The availability of the
 .Xr sysctl 8
-variables depends on the functions offered by the hosts ACPI implementation.
+variables depends on the functions offered by the host's ACPI implementation.
 .Sh SYSCTLS
 The following sysctls are currently implemented,
-where <device> is "crt", "lcd" or "tv":
+where
+.Aq Ar device
+is
+.Va crt , lcd ,
+or
+.Va tv :
 .Bl -tag -width indent
-.It Va hw.acpi.video.<device>.active
+.It Va hw.acpi.video. Ns Ao Ar device Ac Ns Va .active
 Current state of the device.
-.It Va hw.acpi.video.<device>.levels
+.It Va hw.acpi.video. Ns Ao Ar device Ac Ns Va .levels
 List of supported brightness levels.
-.It Va hw.acpi.video.<device>.brightness
+.It Va hw.acpi.video. Ns Ao Ar device Ac Ns Va .brightness
 Current brightness level of the device.
-.It Va hw.acpi.video.<device>.fullpower
+.It Va hw.acpi.video. Ns Ao Ar device Ac Ns Va .fullpower
 Preset brightness level to be used in full power mode.
-.It Va hw.acpi.video.<device>.economy
+.It Va hw.acpi.video. Ns Ao Ar device Ac Ns Va .economy
 Preset brightness level to be used in economy mode.
 .El
 .Pp
diff --git a/share/man/man4/bfe.4 b/share/man/man4/bfe.4
index d2285b8..8e2295f 100644
--- a/share/man/man4/bfe.4
+++ b/share/man/man4/bfe.4
@@ -42,28 +42,25 @@ driver provides support for Broadcom BCM4401 based Fast Ethernet adapters.
 The
 .Nm
 driver supports the following media types:
-.Pp
-.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
-.It autoselect
-Enable autoselection of the media type and options
-.It 10baseT/UTP
-Set 10Mbps operation
-.It 100baseTX
-Set 100Mbps (fast ethernet) operation
+.Bl -tag -width ".Cm 10baseT/UTP"
+.It Cm autoselect
+Enable autoselection of the media type and options.
+.It Cm 10baseT/UTP
+Set 10Mbps operation.
+.It Cm 100baseTX
+Set 100Mbps (Fast Ethernet) operation.
 .El
 .Pp
 The
 .Nm
 driver supports the following media options:
-.Pp
-.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
-.It full-duplex
-Set full duplex operation
+.Bl -tag -width ".Cm full-duplex"
+.It Cm full-duplex
+Set full duplex operation.
 .El
 .Pp
 For further information on configuring this device, see
 .Xr ifconfig 8 .
-.Pp
 .Sh DIAGNOSTICS
 .Bl -diag
 .It "bfe%d: couldn't map memory"
diff --git a/share/man/man4/dcons.4 b/share/man/man4/dcons.4
index 814ded4..3353cfc 100644
--- a/share/man/man4/dcons.4
+++ b/share/man/man4/dcons.4
@@ -24,7 +24,6 @@
 .\"
 .\" $FreeBSD$
 .\"
-.\"
 .Dd February 11, 2003
 .Dt DCONS 4
 .Os
@@ -42,7 +41,7 @@
 The
 .Nm
 device is a simple console device which just reads from and writes to
-an allocated buffer for input and output respectivly.
+an allocated buffer for input and output respectively.
 It is of no use by itself and it is supposed that the buffer is accessed
 via a bus like
 .Xr firewire 4
@@ -51,17 +50,20 @@ or
 for interaction.
 .Pp
 The buffer consists of 4 channels.
-There are 2 ports, one for the console tty and other is GDB ports then each port
-has an input channel and an output channel.
-.Sh EXAMPLE
+There are 2 ports, one for the console TTY and another is GDB port,
+then each port has an input channel and an output channel.
+.Sh EXAMPLES
 If you want to run
 .Xr getty 8
-on dcons, insert the following line into 
+on
+.Nm ,
+insert the following line into
 .Xr /etc/ttys 5
-and
-send a HUP signal to
+and send a
+.Dv HUP
+signal to
 .Xr init 8
-using 
+using
 .Xr kill 1 .
 .Bd -literal -offset indent
 dcons	"/usr/libexec/getty std.9600"	vt100	on  secure
@@ -70,12 +72,14 @@ dcons	"/usr/libexec/getty std.9600"	vt100	on  secure
 Once the
 .Xr fwochi 4
 device is initialized to allow physical access,
-the buffer can be accessed from another host via a FireWire bus using the
+the buffer can be accessed from another host via a
+.Xr firewire 4
+bus using the
 .Xr dconschat 8
-application. See
+application.
+See
 .Xr dconschat 8
 for more details.
-.Pp
 .Sh FILES
 .Bl -tag -width indent -compact
 .It Pa /dev/dcons
@@ -92,5 +96,5 @@ for more details.
 .Sh AUTHORS
 .An Hidetoshi Shimokawa Aq simokawa@FreeBSD.org
 .Sh BUGS
-This driver is still under development.
-.Pp
+This driver is
+.Ud .
diff --git a/share/man/man4/dcons_crom.4 b/share/man/man4/dcons_crom.4
index d3c3c25..b9c5ca0 100644
--- a/share/man/man4/dcons_crom.4
+++ b/share/man/man4/dcons_crom.4
@@ -24,7 +24,6 @@
 .\"
 .\" $FreeBSD$
 .\"
-.\"
 .Dd June 16, 2003
 .Dt DCONS_CROM 4
 .Os
@@ -36,7 +35,6 @@
 .Cd device dcons_crom
 .Cd device dcons
 .Cd device firewire
-.Pp
 .Sh DESCRIPTION
 The
 .Nm
@@ -46,18 +44,18 @@ through the Configuration ROM of
 .Xr firewire 4 .
 This address is supposed to be used by
 .Xr dconschat 8 .
-.El
 .Sh SEE ALSO
 .Xr dcons 4 ,
 .Xr firewire 4 ,
 .Xr fwohci 4 ,
 .Xr dconschat 8 ,
-.Xr fwcontrol 8 .
+.Xr fwcontrol 8
 .Sh AUTHORS
 .An Hidetoshi Shimokawa Aq simokawa@FreeBSD.org
 .Sh BUGS
-If you load dcons_crom.ko manually after the system is booted, you may
+If you load
+.Pa dcons_crom.ko
+manually after the system is booted, you may
 have to initiate a bus reset using
-.Dq Nm fwcontrol -r
+.Dq Nm fwcontrol Fl r
 to update the Configuration ROM.
-.Pp
diff --git a/share/man/man4/en.4 b/share/man/man4/en.4
index 83e5aaf..4632719 100644
--- a/share/man/man4/en.4
+++ b/share/man/man4/en.4
@@ -23,24 +23,24 @@ For configuring the card for IP see
 The following sysctls are recognized by the driver additionally to those
 handled by
 .Xr utopia 4 :
-.Bl -tag -width XXX
-.It Cm hw.atm.enX.istats
+.Bl -tag -width indent
+.It Va hw.atm.enX.istats
 Contains an array of
 .Vt uint32_t
 with internal driver statistics.
-.It Cm hw.atm.enX.debug
+.It Va hw.atm.enX.debug
 This is a bit map of debugging options.
 This variable is only available when the driver is compiled with debugging
 support.
 .El
 .Pp
 The driver supports the media options
-.Ar sdh ,
-.Ar noscramb
+.Cm sdh ,
+.Cm noscramb
 and
-.Ar unassigned
+.Cm unassigned
 (see
-.Xr utopia 4 ).
+.Xr utopia 4 ) .
 .Sh DIAGNOSTICS
 .Bd -literal
 en0 <Efficient Networks ENI-155p> rev 0 int a irq 5 on pci0:16
@@ -60,6 +60,7 @@ generation PCI chipsets do not work or exhibit poor performance.
 .Xr route 8
 .Sh AUTHORS
 .An Chuck Cranor
-of Washington University implemented EN driver
-in 1996 for
+of Washington University implemented
+.Nm
+driver in 1996 for
 .Nx .
diff --git a/share/man/man4/fla.4 b/share/man/man4/fla.4
index 11598a8..1a02deb 100644
--- a/share/man/man4/fla.4
+++ b/share/man/man4/fla.4
@@ -39,7 +39,7 @@ The
 .Nm
 driver supports the following in the family of M-systems DiskOnChip:
 .Pp
-.Bl -item -compact
+.Bl -bullet -compact
 .It
 DiskOnChip2000 (8, 12, 24, 32, 40, 72, 144 MB)
 .It
diff --git a/share/man/man4/gem.4 b/share/man/man4/gem.4
index 7fb2739..1f95075 100644
--- a/share/man/man4/gem.4
+++ b/share/man/man4/gem.4
@@ -1,4 +1,3 @@
-.\" $FreeBSD$
 .\" $NetBSD: gem.4,v 1.2 2003/02/14 15:20:18 grant Exp $
 .\"
 .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
@@ -32,6 +31,8 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
+.\" $FreeBSD$
+.\"
 .Dd June 10, 2003
 .Dt GEM 4
 .Os
@@ -72,6 +73,7 @@ The first
 version to include it was
 .Fx 5.0 .
 .Sh AUTHORS
+.An -nosplit
 The
 .Nm
 driver was written by
diff --git a/share/man/man4/harp.4 b/share/man/man4/harp.4
index 44323b0..6f4d941 100644
--- a/share/man/man4/harp.4
+++ b/share/man/man4/harp.4
@@ -24,35 +24,37 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" Author: Hartmut Brandt <harti@freebsd.org>
+.\" Author: Hartmut Brandt <harti@FreeBSD.org>
 .\"
 .\" $FreeBSD$
-.\" 
-.\" harp(4) man page
 .\"
 .Dd July 21, 2003
 .Dt HARP 4
-.Os FreeBSD
+.Os
 .Sh NAME
 .Nm harp
-.Nd Pseudo physical interface driver for HARP
+.Nd pseudo physical interface driver for HARP
 .Sh SYNOPSIS
-.Cd options atm
+.Cd device atm
 .Cd options NATM
 .Cd options ATM_CORE
 .Cd device harp
 .Sh DESCRIPTION
 The
 .Nm
-driver, when loaded, attaches to all netgraph ATM interfaces in the system and for
+driver, when loaded, attaches to all
+.Xr netgraph 4
+ATM interfaces in the system, and for
 each of these interfaces presents a physical interface to the HARP stack.
-The name of the harp physical interface is the same as the name of the
-netgraph interface (they are in different namespaces).
+The name of the
+.Nm
+physical interface is the same as the name of the
+Netgraph interface (they are in different namespaces).
 .Sh SEE ALSO
 .Xr fatm 4 ,
 .Xr hatm 4 ,
-.Xr patm 4 ,
 .Xr ng_atm 4 ,
+.Xr patm 4 ,
 .Xr atm 8
 .Sh CAVEATS
 When
@@ -61,4 +63,4 @@ is used, it must be started before
 .Nm
 is loaded, to get the correct configuration for the HARP physical interface.
 .Sh AUTHORS
-.An Harti Brandt Aq harti@freebsd.org .
+.An Harti Brandt Aq harti@FreeBSD.org
diff --git a/share/man/man4/hme.4 b/share/man/man4/hme.4
index dce0059..49a1be3 100644
--- a/share/man/man4/hme.4
+++ b/share/man/man4/hme.4
@@ -1,4 +1,3 @@
-.\"	$FreeBSD$
 .\"	$NetBSD: hme.4,v 1.4 2003/02/14 15:20:18 grant Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
@@ -35,6 +34,8 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
+.\" $FreeBSD$
+.\"
 .Dd May 21, 2003
 .Dt HME 4
 .Os
@@ -60,29 +61,27 @@ Cards supported by the
 .Nm
 driver include:
 .Pp
-.Bl -item -compact
+.Bl -bullet -compact
 .It
 Sun PCI SunSwift Adapter
-.Po Do SUNW,hme Dc Pc
+.Pq Dq SUNW,hme
 .It
 Sun SBus SunSwift Adapter
-.Po
-.Dq hme
+.Dq ( hme
 and
-.Dq SUNW,hme
-.Pc
+.Dq SUNW,hme )
 .It
 Sun PCI Sun100BaseT Adapter 2.0
-.Po Do SUNW,hme Dc Pc
+.Pq Dq SUNW,hme
 .It
 Sun SBus Sun100BaseT 2.0
-.Po Do SUNW,hme Dc Pc
+.Pq Dq SUNW,hme
 .It
 Sun PCI Quad FastEthernet Controller
-.Po Do SUNW,qfe Dc Pc
+.Pq Dq SUNW,qfe
 .It
 Sun SBus Quad FastEthernet Controller
-.Po Do SUNW,qfe Dc Pc
+.Pq Dq SUNW,qfe
 .El
 .Sh SEE ALSO
 .Xr gem 4 ,
diff --git a/share/man/man4/idt.4 b/share/man/man4/idt.4
index 4bce75a..adf1cf7 100644
--- a/share/man/man4/idt.4
+++ b/share/man/man4/idt.4
@@ -27,20 +27,20 @@ that specifies a peak cell rate.
 All other UBR traffic goes into the lower queue.
 .Pp
 The following sysctls are recognized by the driver:
-.Bl -tag -width XXX
-.It Cm hw.idt.log_bufstat
+.Bl -tag -width indent
+.It Va hw.idt.log_bufstat
 Print statistics about buffer use to the system log periodically.
-.It Cm hw.idt.log_vcs
+.It Va hw.idt.log_vcs
 Print information about VC opens, closes, and other events to the system log.
-.It Cm hw.idt.bufs_large
+.It Va hw.idt.bufs_large
 Set or print the maximum size of the 2KB buffer queue.
-.It Cm hw.idt.bufs_small
+.It Va hw.idt.bufs_small
 Set or print the maximum size of the mbuf queue.
-.It Cm hw.idt.cur_large
+.It Va hw.idt.cur_large
 Print the current size of the 2KB buffer queue.
-.It Cm hw.idt.cur_small
+.It Va hw.idt.cur_small
 Print the current size of the mbuf queue.
-.It Cm hw.idt.qptr_hold
+.It Va hw.idt.qptr_hold
 Optimize the TX queue buffer for lowest overhead.
 .El
 .Sh SEE ALSO
@@ -49,11 +49,12 @@ Optimize the TX queue buffer for lowest overhead.
 .Xr ifconfig 8 ,
 .Xr route 8
 .Sh AUTHORS
+.An -nosplit
 .An Richard Hodges ,
 based on the original driver for
 .Fx 2.2
 by
-.An Mark Tinguely.
+.An Mark Tinguely .
 .An Bruce M. Simpson
 wrote this manual page and backported the driver to
 .Fx 4.9 .