From 2bf6410a1b6ecd8eebe71dbaf42aa43ada004f3c Mon Sep 17 00:00:00 2001
From: wiz <wiz@NetBSD.org>
Date: Sat, 22 Sep 2001 01:34:47 +0000
Subject: [PATCH] Sort SEE ALSO, sort sections, use slightly more standard
 section names in some cases, drop some .Pps, improve markup in some places.

---
 share/man/man4/mainbus.4 |  3 +--
 share/man/man4/mbe.4     |  6 +++---
 share/man/man4/mca.4     |  7 +++----
 share/man/man4/mcd.4     | 13 ++++++-------
 share/man/man4/mhzc.4    |  5 ++---
 share/man/man4/midi.4    | 11 +++++------
 share/man/man4/mii.4     |  4 ++--
 share/man/man4/mk48txx.4 | 15 ++++++++-------
 share/man/man4/mlx.4     | 22 +++++++++++-----------
 share/man/man4/mly.4     | 14 +++++++-------
 share/man/man4/mtio.4    |  6 +++---
 11 files changed, 51 insertions(+), 55 deletions(-)

diff --git a/share/man/man4/mainbus.4 b/share/man/man4/mainbus.4
index a23479896d06..6cfc0efbef10 100644
--- a/share/man/man4/mainbus.4
+++ b/share/man/man4/mainbus.4
@@ -1,4 +1,4 @@
-.\" $NetBSD: mainbus.4,v 1.2 2001/04/11 18:31:53 wiz Exp $
+.\" $NetBSD: mainbus.4,v 1.3 2001/09/22 01:34:47 wiz Exp $
 .\"
 .\" Copyright (c) 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -43,7 +43,6 @@
 .Sh SYNOPSIS
 .Cd "mainbus0 at root"
 .Cd "XX       at mainbus0"
-.Pp
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/mbe.4 b/share/man/man4/mbe.4
index 865ded103daf..85ef4ce994a5 100644
--- a/share/man/man4/mbe.4
+++ b/share/man/man4/mbe.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mbe.4,v 1.3 2000/02/12 08:38:13 fair Exp $
+.\"	$NetBSD: mbe.4,v 1.4 2001/09/22 01:34:47 wiz Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -75,9 +75,9 @@ Fujitsu Towa LA501
 .El
 .Sh SEE ALSO
 .Xr ifmedia 4 ,
-.Xr ifconfig 8 ,
 .Xr intro 4 ,
-.Xr pcmcia 4
+.Xr pcmcia 4 ,
+.Xr ifconfig 8
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/mca.4 b/share/man/man4/mca.4
index 2e2442f95328..a20746d5d7f5 100644
--- a/share/man/man4/mca.4
+++ b/share/man/man4/mca.4
@@ -1,4 +1,4 @@
-.\" $NetBSD: mca.4,v 1.12 2001/06/12 11:35:03 wiz Exp $
+.\" $NetBSD: mca.4,v 1.13 2001/09/22 01:34:47 wiz Exp $
 .\"
 .\" Copyright (c) 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -45,15 +45,14 @@ Machine-dependent; depends on the bus topology and
 bus interface of your system. Typical
 .Tn MCA
 buses are connected directly to the main system bus.
-.Sh INTRODUCTION
+.Sh DESCRIPTION
 .Nx
 includes a machine-independent
 .Tn MCA
 bus subsystem and several machine-independent
 .Tn MCA
 device drivers.
-.Pp
-.Sh SUPPORTED DEVICES
+.Sh HARDWARE
 .Nx
 includes machine-independent
 .Tn MCA
diff --git a/share/man/man4/mcd.4 b/share/man/man4/mcd.4
index 32ecc9b8c43a..73baad26d5cc 100644
--- a/share/man/man4/mcd.4
+++ b/share/man/man4/mcd.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mcd.4,v 1.8 2001/09/11 22:52:53 wiz Exp $
+.\"	$NetBSD: mcd.4,v 1.9 2001/09/22 01:34:47 wiz Exp $
 .\"
 .\" Copyright (c) 1994 James A. Jegers
 .\" All rights reserved.
@@ -41,7 +41,6 @@ driver provides support for
 controller and drive on the
 .Xr isa 4
 bus.
-.Pp
 .Sh FILES
 .Bl -tag -width /dev/rmcd[0-9][a-h] -compact
 .It Pa /dev/cd[0-9][a-h]
@@ -53,6 +52,11 @@ raw mode Mitsumi
 .Tn CD-ROM
 devices
 .El
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr isa 4 ,
+.Xr ne 4 ,
+.Xr we 4
 .Sh BUGS
 The
 .Nm
@@ -74,8 +78,3 @@ hardware which  returns other result codes.
 .Pp
 .Cd "options MCD_PROMISC"
 enables the  original promiscuous probe behaviour. Use with extreme caution.
-.Sh SEE ALSO
-.Xr intro 4 ,
-.Xr isa 4 ,
-.Xr ne 4 ,
-.Xr we 4
diff --git a/share/man/man4/mhzc.4 b/share/man/man4/mhzc.4
index 6606c0fafc89..29ea8b4d2489 100644
--- a/share/man/man4/mhzc.4
+++ b/share/man/man4/mhzc.4
@@ -1,4 +1,4 @@
-.\" $NetBSD: mhzc.4,v 1.1 1999/11/14 22:42:00 augustss Exp $
+.\" $NetBSD: mhzc.4,v 1.2 2001/09/22 01:34:47 wiz Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -44,8 +44,7 @@
 .Cd "mhzc* at pcmcia? function ?"
 .Cd "com*  at mhzc?"
 .Cd "sm*   at mhzc?"
-.Pp
-.Sh INTRODUCTION
+.Sh DESCRIPTION
 .Nx
 provides support for the Megahertz combined Ethernet and modem cards.
 .Sh SEE ALSO
diff --git a/share/man/man4/midi.4 b/share/man/man4/midi.4
index 54e7dc7db267..f562c654b712 100644
--- a/share/man/man4/midi.4
+++ b/share/man/man4/midi.4
@@ -1,4 +1,4 @@
-.\" $NetBSD: midi.4,v 1.18 2001/09/11 22:52:53 wiz Exp $
+.\" $NetBSD: midi.4,v 1.19 2001/09/22 01:34:47 wiz Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -100,13 +100,13 @@ interface.
 .It Pa /dev/sequencer
 .El
 .Sh SEE ALSO
-.Xr audio 4 ,
-.Xr ioctl 2 ,
 .Xr midiplay 1 ,
+.Xr ioctl 2 ,
+.Xr ossaudio 3 ,
+.Xr audio 4 ,
 .Xr mpu 4 ,
 .Xr opl 4 ,
-.Xr umidi 4 ,
-.Xr ossaudio 3 .
+.Xr umidi 4
 .br
 For ports using the ISA bus:
 .Xr cms 4 ,
@@ -123,4 +123,3 @@ driver first appeared in
 .Nx 1.4 .
 .Sh BUGS
 This man page is very incomplete.
-.Pp
diff --git a/share/man/man4/mii.4 b/share/man/man4/mii.4
index ef1734b8b197..2ba710b26cee 100644
--- a/share/man/man4/mii.4
+++ b/share/man/man4/mii.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mii.4,v 1.12 2001/08/25 04:11:17 thorpej Exp $
+.\"	$NetBSD: mii.4,v 1.13 2001/09/22 01:34:47 wiz Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -108,8 +108,8 @@ program.
 .Xr icsphy 4 ,
 .Xr ifmedia 4 ,
 .Xr inphy 4 ,
-.Xr iophy 4 ,
 .Xr intro 4 ,
+.Xr iophy 4 ,
 .Xr lxtphy 4 ,
 .Xr makphy 4 ,
 .Xr nsphy 4 ,
diff --git a/share/man/man4/mk48txx.4 b/share/man/man4/mk48txx.4
index e09d4f9b3491..8922d9a80110 100644
--- a/share/man/man4/mk48txx.4
+++ b/share/man/man4/mk48txx.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk48txx.4,v 1.2 2001/09/11 00:08:29 wiz Exp $
+.\"	$NetBSD: mk48txx.4,v 1.3 2001/09/22 01:34:47 wiz Exp $
 .\"
 .\" Copyright (c) 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -97,14 +97,15 @@ The following models are supported:
 .El
 .Sh SEE ALSO
 .Xr intro 4 ,
-.Xr todr 9 ,
-.Sh AUTHORS
-The
-.Nm
-driver was written by Paul Kranenburg
-.Aq pk@netbsd.org .
+.Xr todr 9
 .Sh HISTORY
 The
 .Nm mk48txx
 driver first appeared in
 .Nx 1.5 .
+.Sh AUTHORS
+The
+.Nm
+driver was written by
+.An Paul Kranenburg
+.Aq pk@netbsd.org .
diff --git a/share/man/man4/mlx.4 b/share/man/man4/mlx.4
index 3ca9e304a9de..44e8b425e3fe 100644
--- a/share/man/man4/mlx.4
+++ b/share/man/man4/mlx.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mlx.4,v 1.6 2001/09/11 00:08:29 wiz Exp $
+.\"	$NetBSD: mlx.4,v 1.7 2001/09/22 01:34:48 wiz Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -86,18 +86,18 @@ Supported controllers include:
 .Xr ld 4 ,
 .Xr mly 4 ,
 .Xr mlxctl 8
-.Sh AUTHORS
-The
-.Nm
-driver was written by
-by Andrew Doran
-.Aq ad@netbsd.org .
-It is derived from the
-.Fx
-driver of the same name, written by Michael Smith
-.Aq msmith@freebsd.org .
 .Sh HISTORY
 The
 .Nm mlx
 driver first appeared in
 .Nx 1.6 .
+.Sh AUTHORS
+The
+.Nm
+driver was written by
+.An Andrew Doran
+.Aq ad@netbsd.org .
+It is derived from the
+.Fx
+driver of the same name, written by Michael Smith
+.Aq msmith@freebsd.org .
diff --git a/share/man/man4/mly.4 b/share/man/man4/mly.4
index 943f797c8c77..642bd9d55d13 100644
--- a/share/man/man4/mly.4
+++ b/share/man/man4/mly.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mly.4,v 1.4 2001/08/03 14:11:41 ad Exp $
+.\"	$NetBSD: mly.4,v 1.5 2001/09/22 01:34:48 wiz Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -271,14 +271,19 @@ The driver does not attempt to name the enclosures.
 These events report controller status changes.
 .El
 .Sh SEE ALSO
-.Xr intro 4 ,
 .Xr cd 4 ,
 .Xr ch 4 ,
+.Xr intro 4 ,
 .Xr mlx 4 ,
 .Xr scsi 4 ,
 .Xr sd 4 ,
 .Xr st 4 ,
 .Xr scsictl 8
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Nx 1.6 .
 .Sh AUTHORS
 The
 .Nm
@@ -292,11 +297,6 @@ Thor Lancelot Simon
 .Aq tls@netbsd.org
 and Eric Haszlakiewicz
 .Aq erh@netbsd.org .
-.Sh HISTORY
-The
-.Nm
-driver first appeared in
-.Nx 1.6 .
 .Sh BUGS
 The
 .Nm
diff --git a/share/man/man4/mtio.4 b/share/man/man4/mtio.4
index 0f7d4ff9db9b..7701b6f9b468 100644
--- a/share/man/man4/mtio.4
+++ b/share/man/man4/mtio.4
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mtio.4,v 1.11 2001/09/17 19:35:21 jdolecek Exp $
+.\"	$NetBSD: mtio.4,v 1.12 2001/09/22 01:34:48 wiz Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -152,13 +152,13 @@ particular capabilities and limitations.
 .Sh SEE ALSO
 .Xr dd 1 ,
 .Xr mt 1 ,
-.Xr tar 1 ,
 .Xr pax 1 ,
+.Xr tar 1 ,
 .Xr ht 4 ,
+.Xr mt 4 ,
 .Xr st 4 ,
 .Xr tm 4 ,
 .Xr ts 4 ,
-.Xr mt 4 ,
 .Xr ut 4
 .Sh HISTORY
 The