Module Name: src
Committed By: wiz
Date: Sun Sep 6 17:59:09 UTC 2009
Modified Files:
src/share/man/man4: hdaudio.4
Log Message:
Whitespace cleanup, sort sections, fix list.
To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/share/man/man4/hdaudio.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/hdaudio.4
diff -u src/share/man/man4/hdaudio.4:1.1 src/share/man/man4/hdaudio.4:1.2
--- src/share/man/man4/hdaudio.4:1.1 Sun Sep 6 17:25:55 2009
+++ src/share/man/man4/hdaudio.4 Sun Sep 6 17:59:09 2009
@@ -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 jmcne...@netbsd.org
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
