aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
diff options
context:
space:
mode:
authorMurray Stokely <murray@FreeBSD.org>2001-12-10 06:32:08 +0000
committerMurray Stokely <murray@FreeBSD.org>2001-12-10 06:32:08 +0000
commite47e0dcb9c0ca51114ba372f94a4cde9f28786f4 (patch)
tree7715f80e8ca65b3fa4d32d6440a89f787749de25 /en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
parent291ad9790d52cbb602c0681d8449ee8c844c6c4a (diff)
downloaddoc-e47e0dcb9c0ca51114ba372f94a4cde9f28786f4.tar.gz
doc-e47e0dcb9c0ca51114ba372f94a4cde9f28786f4.zip
Reorganize this chapter a bit.
* Remove a near-empty and completely useless <sect1>. * Combine a "troubleshooting" Q/A section into a small list of error message and accompanying solutions to the previous section. * Improve the wording in one or two places.
Notes
Notes: svn path=/head/; revision=11384
Diffstat (limited to 'en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml')
-rw-r--r--en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml132
1 files changed, 60 insertions, 72 deletions
diff --git a/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml b/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
index 5fe664092b..36b5d05984 100644
--- a/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
@@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
- $FreeBSD: doc/en_US.ISO8859-1/books/handbook/sound/chapter.sgml,v 1.22 2001/09/24 11:23:09 murray Exp $
+ $FreeBSD$
-->
<chapter id="sound">
@@ -18,7 +18,7 @@
<title>Sound</title>
- <sect1>
+ <sect1 id="sound-synopsis">
<title>Synopsis</title>
<para>FreeBSD supports a wide variety of sound cards, allowing you
@@ -49,7 +49,7 @@
</itemizedlist>
</sect1>
- <sect1>
+ <sect1 id="sound-device">
<title>Locating the Correct Device</title>
<indexterm><primary>PCI</primary></indexterm>
@@ -116,10 +116,16 @@
<primary>kernel</primary>
<secondary>configuration</secondary>
</indexterm>
- <para>The driver you use in your kernel depends on the kind of card
- you have. The sections below provide more information and what
- you will need to add to your <link linkend="kernelconfig">kernel
- configuration</link>.</para>
+
+ <para>To use your sound device, you will need to load the proper
+ device driver. This may be accomplished in one of two ways.
+ The easiest way is to simply load a kernel module for your sound
+ card with &man.kldload.8;. Alternatively, you may statically
+ compile in support for your sound card in your kernel. The
+ sections below provide the information you need to add support
+ for your hardware in this manner. For more information about
+ recompiling your kernel, please see <xref
+ linkend="kernelconfig">.</para>
<sect2>
<title>Creative, Advance, and ESS Sound Cards</title>
@@ -211,16 +217,7 @@ device csa</programlisting>
</sect2>
</sect1>
- <sect1>
- <title>Recompiling the Kernel</title>
-
- <para>After adding the requisite driver(s) to your kernel
- configuration file, you will need to recompile your kernel. Please see
- <xref linkend="kernelconfig-building"> of the handbook for
- more information.</para>
- </sect1>
-
- <sect1>
+ <sect1 id="sound-devicenodes">
<title>Creating and Testing the Device Nodes</title>
<indexterm><primary>device nodes</primary></indexterm>
@@ -310,64 +307,55 @@ pcm0: &lt;SB16 DSP 4.11&gt; on sbc0</screen>
</informaltable>
<para>If all goes well, you should now have a functioning sound
- card. If you do not, read the next section.</para>
- </sect1>
+ card. You may want to install an application such as
+ <port>audio/mpg123</port> to listen to audio files.</para>
- <sect1>
- <title>Common Problems</title>
-
- <qandaset>
- <indexterm><primary>device node</primary></indexterm>
- <qandaentry>
- <question>
- <para>I get an unsupported subdevice XX error!</para>
- </question>
-
- <answer>
- <para>One or more of the device nodes was not created
- correctly. Repeat the steps above.</para>
- </answer>
- </qandaentry>
-
- <indexterm><primary>I/O port</primary></indexterm>
- <qandaentry>
- <question>
- <para>I get a sb_dspwr(XX) timed out error!</para>
- </question>
-
- <answer>
- <para>The I/O port is not set correctly.</para>
- </answer>
- </qandaentry>
-
- <indexterm><primary>IRQ</primary></indexterm>
- <qandaentry>
- <question>
- <para>I get a bad irq XX error!</para>
- </question>
-
- <answer>
- <para>The IRQ is set incorrectly. Make sure that the set IRQ
- and the sound IRQ are the same.</para>
- </answer>
- </qandaentry>
-
- <qandaentry>
- <question>
- <para>I get a <errorname>xxx: gus pcm not attached, out of
- memory</errorname>
- error. What causes that?</para>
- </question>
-
- <answer>
- <para>If this happens, it is because there is not enough
- available memory to use the device.</para>
- </answer>
- </qandaentry>
- </qandaset>
+ <sect2>
+ <title>Common Problems</title>
+
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Error</entry>
+ <entry>Solution</entry>
+ </row>
+ </thead>
+ <indexterm><primary>device node</primary></indexterm>
+
+ <tbody>
+ <row>
+ <entry><errorname>unsupported subdevice XX</errorname></entry>
+ <entry><para>One or more of the device nodes was not created
+ correctly. Repeat the steps above.</para></entry>
+ </row>
+
+ <indexterm><primary>I/O port</primary></indexterm>
+ <row>
+ <entry><errorname>sb_dspwr(XX) timed out</errorname></entry>
+ <entry><para>The I/O port is not set correctly.</para></entry>
+ </row>
+
+ <indexterm><primary>IRQ</primary></indexterm>
+ <row>
+ <entry><errorname>bad irq XX</errorname></entry>
+ <entry><para>The IRQ is set incorrectly. Make sure that
+ the set IRQ and the sound IRQ are the same.</para></entry>
+ </row>
+
+ <row>
+ <entry><errorname>xxx: gus pcm not attached, out of
+ memory</errorname></entry>
+ <entry><para>There is not enough available memory to use
+ the device.</para></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </sect2>
</sect1>
- <sect1 id="mp3">
+ <sect1 id="sound-mp3">
<sect1info>
<authorgroup>
<author>