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

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

@ -1,7 +1,7 @@
<!-- <!--
The FreeBSD Documentation Project 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"> <chapter id="sound">
@ -18,7 +18,7 @@
<title>Sound</title> <title>Sound</title>
<sect1> <sect1 id="sound-synopsis">
<title>Synopsis</title> <title>Synopsis</title>
<para>FreeBSD supports a wide variety of sound cards, allowing you <para>FreeBSD supports a wide variety of sound cards, allowing you
@ -49,7 +49,7 @@
</itemizedlist> </itemizedlist>
</sect1> </sect1>
<sect1> <sect1 id="sound-device">
<title>Locating the Correct Device</title> <title>Locating the Correct Device</title>
<indexterm><primary>PCI</primary></indexterm> <indexterm><primary>PCI</primary></indexterm>
@ -116,10 +116,16 @@
<primary>kernel</primary> <primary>kernel</primary>
<secondary>configuration</secondary> <secondary>configuration</secondary>
</indexterm> </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 <para>To use your sound device, you will need to load the proper
you will need to add to your <link linkend="kernelconfig">kernel device driver. This may be accomplished in one of two ways.
configuration</link>.</para> 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> <sect2>
<title>Creative, Advance, and ESS Sound Cards</title> <title>Creative, Advance, and ESS Sound Cards</title>
@ -211,16 +217,7 @@ device csa</programlisting>
</sect2> </sect2>
</sect1> </sect1>
<sect1> <sect1 id="sound-devicenodes">
<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>
<title>Creating and Testing the Device Nodes</title> <title>Creating and Testing the Device Nodes</title>
<indexterm><primary>device nodes</primary></indexterm> <indexterm><primary>device nodes</primary></indexterm>
@ -310,64 +307,55 @@ pcm0: &lt;SB16 DSP 4.11&gt; on sbc0</screen>
</informaltable> </informaltable>
<para>If all goes well, you should now have a functioning sound <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
</sect1> <port>audio/mpg123</port> to listen to audio files.</para>
<sect1> <sect2>
<title>Common Problems</title> <title>Common Problems</title>
<qandaset> <informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Error</entry>
<entry>Solution</entry>
</row>
</thead>
<indexterm><primary>device node</primary></indexterm> <indexterm><primary>device node</primary></indexterm>
<qandaentry>
<question>
<para>I get an unsupported subdevice XX error!</para>
</question>
<answer> <tbody>
<para>One or more of the device nodes was not created <row>
correctly. Repeat the steps above.</para> <entry><errorname>unsupported subdevice XX</errorname></entry>
</answer> <entry><para>One or more of the device nodes was not created
</qandaentry> correctly. Repeat the steps above.</para></entry>
</row>
<indexterm><primary>I/O port</primary></indexterm> <indexterm><primary>I/O port</primary></indexterm>
<qandaentry> <row>
<question> <entry><errorname>sb_dspwr(XX) timed out</errorname></entry>
<para>I get a sb_dspwr(XX) timed out error!</para> <entry><para>The I/O port is not set correctly.</para></entry>
</question> </row>
<answer>
<para>The I/O port is not set correctly.</para>
</answer>
</qandaentry>
<indexterm><primary>IRQ</primary></indexterm> <indexterm><primary>IRQ</primary></indexterm>
<qandaentry> <row>
<question> <entry><errorname>bad irq XX</errorname></entry>
<para>I get a bad irq XX error!</para> <entry><para>The IRQ is set incorrectly. Make sure that
</question> the set IRQ and the sound IRQ are the same.</para></entry>
</row>
<answer> <row>
<para>The IRQ is set incorrectly. Make sure that the set IRQ <entry><errorname>xxx: gus pcm not attached, out of
and the sound IRQ are the same.</para> memory</errorname></entry>
</answer> <entry><para>There is not enough available memory to use
</qandaentry> the device.</para></entry>
</row>
<qandaentry> </tbody>
<question> </tgroup>
<para>I get a <errorname>xxx: gus pcm not attached, out of </informaltable>
memory</errorname> </sect2>
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>
<sect1 id="mp3"> <sect1 id="sound-mp3">
<sect1info> <sect1info>
<authorgroup> <authorgroup>
<author> <author>

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

@ -1,7 +1,7 @@
<!-- <!--
The FreeBSD Documentation Project 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"> <chapter id="sound">
@ -18,7 +18,7 @@
<title>Sound</title> <title>Sound</title>
<sect1> <sect1 id="sound-synopsis">
<title>Synopsis</title> <title>Synopsis</title>
<para>FreeBSD supports a wide variety of sound cards, allowing you <para>FreeBSD supports a wide variety of sound cards, allowing you
@ -49,7 +49,7 @@
</itemizedlist> </itemizedlist>
</sect1> </sect1>
<sect1> <sect1 id="sound-device">
<title>Locating the Correct Device</title> <title>Locating the Correct Device</title>
<indexterm><primary>PCI</primary></indexterm> <indexterm><primary>PCI</primary></indexterm>
@ -116,10 +116,16 @@
<primary>kernel</primary> <primary>kernel</primary>
<secondary>configuration</secondary> <secondary>configuration</secondary>
</indexterm> </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 <para>To use your sound device, you will need to load the proper
you will need to add to your <link linkend="kernelconfig">kernel device driver. This may be accomplished in one of two ways.
configuration</link>.</para> 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> <sect2>
<title>Creative, Advance, and ESS Sound Cards</title> <title>Creative, Advance, and ESS Sound Cards</title>
@ -211,16 +217,7 @@ device csa</programlisting>
</sect2> </sect2>
</sect1> </sect1>
<sect1> <sect1 id="sound-devicenodes">
<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>
<title>Creating and Testing the Device Nodes</title> <title>Creating and Testing the Device Nodes</title>
<indexterm><primary>device nodes</primary></indexterm> <indexterm><primary>device nodes</primary></indexterm>
@ -310,64 +307,55 @@ pcm0: &lt;SB16 DSP 4.11&gt; on sbc0</screen>
</informaltable> </informaltable>
<para>If all goes well, you should now have a functioning sound <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
</sect1> <port>audio/mpg123</port> to listen to audio files.</para>
<sect1> <sect2>
<title>Common Problems</title> <title>Common Problems</title>
<qandaset> <informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Error</entry>
<entry>Solution</entry>
</row>
</thead>
<indexterm><primary>device node</primary></indexterm> <indexterm><primary>device node</primary></indexterm>
<qandaentry>
<question>
<para>I get an unsupported subdevice XX error!</para>
</question>
<answer> <tbody>
<para>One or more of the device nodes was not created <row>
correctly. Repeat the steps above.</para> <entry><errorname>unsupported subdevice XX</errorname></entry>
</answer> <entry><para>One or more of the device nodes was not created
</qandaentry> correctly. Repeat the steps above.</para></entry>
</row>
<indexterm><primary>I/O port</primary></indexterm> <indexterm><primary>I/O port</primary></indexterm>
<qandaentry> <row>
<question> <entry><errorname>sb_dspwr(XX) timed out</errorname></entry>
<para>I get a sb_dspwr(XX) timed out error!</para> <entry><para>The I/O port is not set correctly.</para></entry>
</question> </row>
<answer>
<para>The I/O port is not set correctly.</para>
</answer>
</qandaentry>
<indexterm><primary>IRQ</primary></indexterm> <indexterm><primary>IRQ</primary></indexterm>
<qandaentry> <row>
<question> <entry><errorname>bad irq XX</errorname></entry>
<para>I get a bad irq XX error!</para> <entry><para>The IRQ is set incorrectly. Make sure that
</question> the set IRQ and the sound IRQ are the same.</para></entry>
</row>
<answer> <row>
<para>The IRQ is set incorrectly. Make sure that the set IRQ <entry><errorname>xxx: gus pcm not attached, out of
and the sound IRQ are the same.</para> memory</errorname></entry>
</answer> <entry><para>There is not enough available memory to use
</qandaentry> the device.</para></entry>
</row>
<qandaentry> </tbody>
<question> </tgroup>
<para>I get a <errorname>xxx: gus pcm not attached, out of </informaltable>
memory</errorname> </sect2>
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>
<sect1 id="mp3"> <sect1 id="sound-mp3">
<sect1info> <sect1info>
<authorgroup> <authorgroup>
<author> <author>