os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Reorganize this chapter a bit.

Browse source 
* 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.
This commit is contained in:
Murray Stokely 2001-12-10 06:32:08 +00:00
parent 291ad9790d
commit e47e0dcb9c
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=11384
2 changed files with 122 additions and 146 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

134
en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
View file

@ -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>
card. You may want to install an application such as
<port>audio/mpg123</port> to listen to audio files.</para>
<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>
<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>
</sect1>
<sect1 id="mp3">
<sect1 id="sound-mp3">
<sect1info>
<authorgroup>
<author>

134
en_US.ISO8859-1/books/handbook/sound/chapter.sgml
View file

@ -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>
card. You may want to install an application such as
<port>audio/mpg123</port> to listen to audio files.</para>
<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>
<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>
</sect1>
<sect1 id="mp3">
<sect1 id="sound-mp3">
<sect1info>
<authorgroup>
<author>