[src/trunk]: src/share/man/man4 Whitespace cleanup, sort sections, fix list.

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

details:   https://anonhg.NetBSD.org/src/rev/bb8405ec4109
branches:  trunk
changeset: 747226:bb8405ec4109
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sun Sep 06 17:59:09 2009 +0000

description:
Whitespace cleanup, sort sections, fix list.

diffstat:

 share/man/man4/hdaudio.4 |  55 +++++++++++++++++++++++++----------------------
 1 files changed, 29 insertions(+), 26 deletions(-)

diffs (107 lines):

diff -r 6ea85af851fb -r bb8405ec4109 share/man/man4/hdaudio.4
--- a/share/man/man4/hdaudio.4  Sun Sep 06 17:33:53 2009 +0000
+++ b/share/man/man4/hdaudio.4  Sun Sep 06 17:59:09 2009 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: hdaudio.4,v 1.1 2009/09/06 17:25:55 sborrill Exp $
+.\"    $NetBSD: hdaudio.4,v 1.2 2009/09/06 17:59:09 wiz Exp $
 .\"
 .\" Copyright (c) 2009 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -49,7 +49,7 @@
 .Xr azalia 4 .
 It was written from scratch following the Intel HD Audio and Microsoft
 Universal Audio Architecture specifications.
-
+.Pp
 The driver consists of two interlinked components, which reflects the
 hardware design.
 The
@@ -57,14 +57,14 @@
 component interfaces with a PCI/PCIe bus and provides an
 .Xr hdaudiobus 4
 onto which different function groups attach.
-Each function group (e.g. audio, vendor-specific modem) is exported as a
+Each function group (e.g. audio, vendor-specific modem) is exported as a
 separate child device of the
 .Nm
 controller.
-Audio function groups (a.k.a audio codec) are exported as
+Audio function groups (a.k.a. audio codec) are exported as
 .Xr hdafg 4
 devices.
-
+.Pp
 Audio codecs are available from a number of manufacturers and are made up of a
 number of widgets (e.g. audio mixer, output pin, analog-to-digital converter).
 The way the widgets are interlinked varies significantly between
@@ -79,22 +79,26 @@
 .Xr azalia 4
 driver (which tends to generate a large number of unclearly named
 .Xr mixer 4
-controls), 
+controls),
 .Nm
 works backwards by starting with a list of desired, consistent and compatible
 .Xr mixer 4
 controls and configuring/discovering appropriate widget link routes to fit.
-
+.Pp
 By following the published mechanisms for common implementations of widget
 parsing, it is expected that nearly all High Definition Audio devices will
 be supported without requiring per-device quirks.
-
 .Sh SEE ALSO
 .Xr audio 4 ,
 .Xr mixer 4 ,
 .Xr pci 4 ,
 .Pa http://www.intel.com/standards/hdaudio/
 .Pa http://www.microsoft.com/whdc/device/audio/
+.Sh HISTORY
+The
+.Nm
+device driver appeared in
+.Nx 6.0 .
 .Sh AUTHORS
 The
 .Nm
@@ -102,23 +106,22 @@
 .An Jared McNeill Aq jmcneill%NetBSD.org@localhost
 under contract by
 .An Precedence Technologies Ltd Aq http://www.precedence.co.uk/ .
-The UAA-compliant widget parser is derived from the FreeBSD snd_hda(4) driver.
+The UAA-compliant widget parser is derived from the
+.Fx
+snd_hda(4) driver.
 .Sh BUGS
 The following items are not yet implemented:
-.Bl -tag -width indent
-- Support sample rates in hardware other than 48kHz
-.Bl -tag -width indent
-- Improve power management support when driver is idle
-.Bl -tag -width indent
-- Add support for non-PCM output formats
-.Bl -tag -width indent
-- Handle unsolicited RIRB messages
-.Bl -tag -width indent
-- Headphone jack sensing
-.Bl -tag -width indent
-- Modem function groups
-.Sh HISTORY
-The
-.Nm
-device driver appeared in
-.Nx 6.0 .
+.Bl -bullet
+.It
+Support sample rates in hardware other than 48kHz
+.It
+Improve power management support when driver is idle
+.It
+Add support for non-PCM output formats
+.It
+Handle unsolicited RIRB messages
+.It
+Headphone jack sensing
+.It
+Modem function groups
+.El