[src/trunk]: src/share/man/man4 Fix paragraph problems, sort sections, sort X...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/0f0f032f3bcc
branches:  trunk
changeset: 514864:0f0f032f3bcc
user:      wiz <wiz%NetBSD.org@localhost>
date:      Tue Sep 11 23:18:55 2001 +0000

description:
Fix paragraph problems, sort sections, sort Xrefs in SEE ALSO, and other
miscellaneous fixes.

diffstat:

 share/man/man4/uaudio.4    |  13 ++++++-------
 share/man/man4/ucom.4      |   9 ++++-----
 share/man/man4/udp.4       |   4 ++--
 share/man/man4/ugen.4      |   3 +--
 share/man/man4/uha.4       |  10 +++++-----
 share/man/man4/uhci.4      |   3 +--
 share/man/man4/uhid.4      |   7 +++----
 share/man/man4/uk.4        |   4 +---
 share/man/man4/ukbd.4      |   3 +--
 share/man/man4/ukphy.4     |  12 ++++++------
 share/man/man4/ulpt.4      |   3 +--
 share/man/man4/umass.4     |   3 +--
 share/man/man4/umidi.4     |  12 ++++++------
 share/man/man4/umodem.4    |   9 ++++-----
 share/man/man4/ums.4       |   3 +--
 share/man/man4/upl.4       |   6 +++---
 share/man/man4/urio.4      |   8 ++++----
 share/man/man4/usb.4       |  13 ++++++-------
 share/man/man4/uscanner.4  |  20 ++++++++++----------
 share/man/man4/userconf.4  |  15 +++++++--------
 share/man/man4/usscanner.4 |   6 +++---
 share/man/man4/uyap.4      |   5 ++---
 share/man/man4/vga.4       |  18 +++++++++---------
 share/man/man4/viaenv.4    |   7 +++----
 share/man/man4/vlan.4      |  12 ++++++------
 share/man/man4/vnd.4       |  13 ++++++-------
 share/man/man4/vr.4        |   7 +++----
 share/man/man4/wds.4       |   9 ++++-----
 share/man/man4/we.4        |   9 ++++-----
 share/man/man4/wi.4        |  16 ++++++++--------
 share/man/man4/wscons.4    |  13 ++++++-------
 share/man/man4/wsdisplay.4 |  20 ++++++++++----------
 share/man/man4/wskbd.4     |  10 +++++-----
 share/man/man4/wsmouse.4   |  12 ++++++------
 share/man/man4/wsmux.4     |   6 ++----
 share/man/man4/wt.4        |   3 +--
 share/man/man4/xi.4        |  26 +++++++++++++-------------
 share/man/man4/yds.4       |  10 +++++-----
 share/man/man4/ym.4        |  32 ++++++++++++++++----------------
 share/man/man4/zstty.4     |   4 ++--
 40 files changed, 187 insertions(+), 211 deletions(-)

diffs (truncated from 1183 to 300 lines):

diff -r 1ec4a3030af3 -r 0f0f032f3bcc share/man/man4/uaudio.4
--- a/share/man/man4/uaudio.4   Tue Sep 11 22:52:52 2001 +0000
+++ b/share/man/man4/uaudio.4   Tue Sep 11 23:18:55 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: uaudio.4,v 1.10 2001/09/11 22:52:54 wiz Exp $
+.\" $NetBSD: uaudio.4,v 1.11 2001/09/11 23:18:55 wiz Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -43,7 +43,6 @@
 .Sh SYNOPSIS
 .Cd "uaudio* at uhub?"
 .Cd "audio*  at uaudio?"
-.Pp
 .Sh DESCRIPTION
 The
 .Nm
@@ -111,11 +110,6 @@
 .Tn USB
 Audio class specification is indispensable
 reading.
-.Sh BUGS
-The mixer interface is really incomplete.
-.Pp
-There should be some heuristics that allows important controls,
-e.g., volume, to be identified and given its traditional name.
 .Sh SEE ALSO
 The
 .Tn USB
@@ -130,3 +124,8 @@
 driver
 appeared in
 .Nx 1.5 .
+.Sh BUGS
+The mixer interface is really incomplete.
+.Pp
+There should be some heuristics that allows important controls,
+e.g., volume, to be identified and given its traditional name.
diff -r 1ec4a3030af3 -r 0f0f032f3bcc share/man/man4/ucom.4
--- a/share/man/man4/ucom.4     Tue Sep 11 22:52:52 2001 +0000
+++ b/share/man/man4/ucom.4     Tue Sep 11 23:18:55 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: ucom.4,v 1.6 2001/04/01 02:38:49 augustss Exp $
+.\" $NetBSD: ucom.4,v 1.7 2001/09/11 23:18:55 wiz Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -47,7 +47,6 @@
 .Cd "ucom* at uplcom?"
 .Cd "ucom* at umct?"
 .Cd "ucom* at uvisor? portno ?"
-.Pp
 .Sh DESCRIPTION
 The
 .Nm
@@ -75,11 +74,11 @@
 .Xr tty 4 ,
 .\"Xr uetekcom 4 ,
 .Xr uftdi 4 ,
+.Xr umct 4 ,
 .Xr umodem 4 ,
 .Xr uplcom 4 ,
-.Xr umct 4 ,
-.Xr uvisor 4 ,
-.Xr usb 4
+.Xr usb 4 ,
+.Xr uvisor 4
 .Sh HISTORY
 The
 .Nm
diff -r 1ec4a3030af3 -r 0f0f032f3bcc share/man/man4/udp.4
--- a/share/man/man4/udp.4      Tue Sep 11 22:52:52 2001 +0000
+++ b/share/man/man4/udp.4      Tue Sep 11 23:18:55 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: udp.4,v 1.6 2000/05/22 02:01:34 itojun Exp $
+.\"    $NetBSD: udp.4,v 1.7 2001/09/11 23:18:55 wiz Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -133,9 +133,9 @@
 .Xr recv 2 ,
 .Xr send 2 ,
 .Xr socket 2 ,
-.Xr intro 4 ,
 .Xr inet 4 ,
 .Xr inet6 4 ,
+.Xr intro 4 ,
 .Xr ip 4 ,
 .Xr ip6 4
 .Rs
diff -r 1ec4a3030af3 -r 0f0f032f3bcc share/man/man4/ugen.4
--- a/share/man/man4/ugen.4     Tue Sep 11 22:52:52 2001 +0000
+++ b/share/man/man4/ugen.4     Tue Sep 11 23:18:55 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: ugen.4,v 1.13 2001/09/11 22:52:54 wiz Exp $
+.\" $NetBSD: ugen.4,v 1.14 2001/09/11 23:18:55 wiz Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -42,7 +42,6 @@
 .Nd USB generic device support
 .Sh SYNOPSIS
 .Cd "ugen* at uhub?"
-.Pp
 .Sh DESCRIPTION
 The
 .Nm
diff -r 1ec4a3030af3 -r 0f0f032f3bcc share/man/man4/uha.4
--- a/share/man/man4/uha.4      Tue Sep 11 22:52:52 2001 +0000
+++ b/share/man/man4/uha.4      Tue Sep 11 23:18:55 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: uha.4,v 1.6 1999/12/17 16:23:22 abs Exp $
+.\"    $NetBSD: uha.4,v 1.7 2001/09/11 23:18:55 wiz Exp $
 .\"
 .\" Copyright (c) 1994 James A. Jegers
 .\" All rights reserved.
@@ -46,11 +46,11 @@
 .It Ultrastor ISA 34f
 .El
 .Sh SEE ALSO
+.Xr cd 4 ,
+.Xr ch 4 ,
+.Xr eisa 4 ,
 .Xr intro 4 ,
-.Xr eisa 4 ,
 .Xr isa 4 ,
 .Xr scsi 4 ,
 .Xr sd 4 ,
-.Xr st 4 ,
-.Xr cd 4 ,
-.Xr ch 4
+.Xr st 4
diff -r 1ec4a3030af3 -r 0f0f032f3bcc share/man/man4/uhci.4
--- a/share/man/man4/uhci.4     Tue Sep 11 22:52:52 2001 +0000
+++ b/share/man/man4/uhci.4     Tue Sep 11 23:18:55 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: uhci.4,v 1.4 1999/11/23 01:47:34 augustss Exp $
+.\" $NetBSD: uhci.4,v 1.5 2001/09/11 23:18:55 wiz Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -43,7 +43,6 @@
 .Sh SYNOPSIS
 .Cd "uhci*    at pci? dev ? function ?"
 .Cd "usb*     at uhci?"
-.Pp
 .Sh DESCRIPTION
 The
 .Nm
diff -r 1ec4a3030af3 -r 0f0f032f3bcc share/man/man4/uhid.4
--- a/share/man/man4/uhid.4     Tue Sep 11 22:52:52 2001 +0000
+++ b/share/man/man4/uhid.4     Tue Sep 11 23:18:55 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: uhid.4,v 1.9 2001/09/11 22:52:54 wiz Exp $
+.\" $NetBSD: uhid.4,v 1.10 2001/09/11 23:18:55 wiz Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -42,7 +42,6 @@
 .Nd USB generic HID support
 .Sh SYNOPSIS
 .Cd "uhid* at uhub?"
-.Pp
 .Sh DESCRIPTION
 The
 .Nm
@@ -115,9 +114,9 @@
 .It Pa /dev/uhid?
 .El
 .Sh SEE ALSO
+.Xr usbhidctl 1 ,
 .Xr usb 3 ,
-.Xr usb 4 ,
-.Xr usbhidctl 1
+.Xr usb 4
 .Sh HISTORY
 The
 .Nm
diff -r 1ec4a3030af3 -r 0f0f032f3bcc share/man/man4/uk.4
--- a/share/man/man4/uk.4       Tue Sep 11 22:52:52 2001 +0000
+++ b/share/man/man4/uk.4       Tue Sep 11 23:18:55 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: uk.4,v 1.7 1999/03/16 01:19:19 garbled Exp $
+.\"    $NetBSD: uk.4,v 1.8 2001/09/11 23:18:55 wiz Exp $
 .\"
 .\" Copyright (c) 1996
 .\"     Julian Elischer <julian%freebsd.org@localhost>.  All rights reserved.
@@ -44,7 +44,6 @@
 .Tn SCSI
 adapter must also be separately configured into the system before
 this driver makes sense.
-.Pp
 .Sh KERNEL CONFIGURATION
 If a
 .Ar count
@@ -53,7 +52,6 @@
 devices will be configured into the
 .Nx
 kernel.
-.Pp
 .Sh IOCTLS
 The
 .Nm
diff -r 1ec4a3030af3 -r 0f0f032f3bcc share/man/man4/ukbd.4
--- a/share/man/man4/ukbd.4     Tue Sep 11 22:52:52 2001 +0000
+++ b/share/man/man4/ukbd.4     Tue Sep 11 23:18:55 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: ukbd.4,v 1.6 2001/09/11 22:52:54 wiz Exp $
+.\" $NetBSD: ukbd.4,v 1.7 2001/09/11 23:18:55 wiz Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -43,7 +43,6 @@
 .Sh SYNOPSIS
 .Cd "ukbd*     at uhub?"
 .Cd "wskbd*    at ukbd? console ?"
-.Pp
 .Sh DESCRIPTION
 The
 .Nm
diff -r 1ec4a3030af3 -r 0f0f032f3bcc share/man/man4/ukphy.4
--- a/share/man/man4/ukphy.4    Tue Sep 11 22:52:52 2001 +0000
+++ b/share/man/man4/ukphy.4    Tue Sep 11 23:18:55 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ukphy.4,v 1.3 2001/09/11 00:08:31 wiz Exp $
+.\"    $NetBSD: ukphy.4,v 1.4 2001/09/11 23:18:55 wiz Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -47,13 +47,13 @@
 The
 .Nm
 driver supports the basic functionality of most Ethernet PHYs.
+.Sh SEE ALSO
+.Xr ifmedia 4 ,
+.Xr intro 4 ,
+.Xr mii 4 ,
+.Xr ifconfig 8
 .Sh BUGS
 In areas where the programming interface for PHYs differ, such
 as detecting the currently active medium, this driver often
 does not work optimally. When available, it is best to use a
 PHY-specific driver.
-.Sh SEE ALSO
-.Xr ifmedia 4 ,
-.Xr intro 4 ,
-.Xr mii 4 ,
-.Xr ifconfig 8
diff -r 1ec4a3030af3 -r 0f0f032f3bcc share/man/man4/ulpt.4
--- a/share/man/man4/ulpt.4     Tue Sep 11 22:52:52 2001 +0000
+++ b/share/man/man4/ulpt.4     Tue Sep 11 23:18:55 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: ulpt.4,v 1.4 1999/08/23 12:32:19 augustss Exp $
+.\" $NetBSD: ulpt.4,v 1.5 2001/09/11 23:18:55 wiz Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -42,7 +42,6 @@
 .Nd USB printer support
 .Sh SYNOPSIS
 .Cd "ulpt*   at uhub?"
-.Pp
 .Sh DESCRIPTION
 The
 .Nm
diff -r 1ec4a3030af3 -r 0f0f032f3bcc share/man/man4/umass.4
--- a/share/man/man4/umass.4    Tue Sep 11 22:52:52 2001 +0000
+++ b/share/man/man4/umass.4    Tue Sep 11 23:18:55 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: umass.4,v 1.10 2001/09/11 22:52:54 wiz Exp $
+.\" $NetBSD: umass.4,v 1.11 2001/09/11 23:18:55 wiz Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -44,7 +44,6 @@
 .Cd "umass*     at uhub?"
 .Cd "atapibus*  at umass? channel ?"
 .Cd "scsibus*   at umass? channel ?"
-.Pp
 .Sh DESCRIPTION
 The
 .Nm
diff -r 1ec4a3030af3 -r 0f0f032f3bcc share/man/man4/umidi.4
--- a/share/man/man4/umidi.4    Tue Sep 11 22:52:52 2001 +0000
+++ b/share/man/man4/umidi.4    Tue Sep 11 23:18:55 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: umidi.4,v 1.2 2001/05/29 08:18:11 tshiozak Exp $
+.\" $NetBSD: umidi.4,v 1.3 2001/09/11 23:18:55 wiz Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -61,14 +61,14 @@
 .Sh SEE ALSO
 .Xr midi 4 ,
 .Xr usb 4
-.Sh BUGS
-The
-.Nm
-driver has been only tested with the vendor specific devices listed above;
-not yet tested with the devices that follow the USB MIDI standard.