Context Navigation

-              r2f81a4dd
+              r8c3989b2
 <sect1 id="alsa-driver" xreflabel="alsa-driver-&alsa-driver-version;">
+<sect1 id="alsa-driver" xreflabel="ALSA-driver-&alsa-driver-version;">
 <?dbhtml filename="alsa-driver.html" dir="multimedia"?>
 <title>alsa-driver-&alsa-driver-version;</title>
+<title>ALSA-driver-&alsa-driver-version;</title>
 &alsa-driver-intro;

multimedia/libdriv/alsa/alsa-lib.xml

-              r2f81a4dd
+              r8c3989b2
 <sect1 id="alsa-lib" xreflabel="alsa-lib-&alsa-lib-version;">
+<sect1 id="alsa-lib" xreflabel="ALSA-lib-&alsa-lib-version;">
 <?dbhtml filename="alsa-lib.html" dir="multimedia"?>
 <title>alsa-lib-&alsa-lib-version;</title>
+<title>ALSA-lib-&alsa-lib-version;</title>
 &alsa-lib-intro;

multimedia/libdriv/alsa/alsa-oss.xml

-              r2f81a4dd
+              r8c3989b2
 <sect1 id="alsa-oss" xreflabel="alsa-oss-&alsa-oss-version;">
+<sect1 id="alsa-oss" xreflabel="ALSA-OSS-&alsa-oss-version;">
 <?dbhtml filename="alsa-oss.html" dir="multimedia"?>
 <title>alsa-oss-&alsa-oss-version;</title>
+<title>ALSA-OSS-&alsa-oss-version;</title>
 &alsa-oss-intro;

multimedia/libdriv/alsa/alsa-tools.xml

-              r2f81a4dd
+              r8c3989b2
 <sect1 id="alsa-tools" xreflabel="alsa-tools-&alsa-tools-version;">
+<sect1 id="alsa-tools" xreflabel="ALSA-tools-&alsa-tools-version;">
 <?dbhtml filename="alsa-tools.html" dir="multimedia"?>
 <title>alsa-tools-&alsa-tools-version;</title>
+<title>ALSA-tools-&alsa-tools-version;</title>
 &alsa-tools-intro;

multimedia/libdriv/alsa/alsa-utils.xml

-              r2f81a4dd
+              r8c3989b2
 <sect1 id="alsa-utils" xreflabel="alsa-utils-&alsa-utils-version;">
+<sect1 id="alsa-utils" xreflabel="ALSA-utils-&alsa-utils-version;">
 <?dbhtml filename="alsa-utils.html" dir="multimedia"?>
 <title>alsa-utils-&alsa-utils-version;</title>
+<title>ALSA-utils-&alsa-utils-version;</title>
 &alsa-utils-intro;

multimedia/libdriv/alsa/driver/alsa-driver-config.xml

-              r2f81a4dd
+              r8c3989b2
 <sect2>
 <title>Configuring alsa-driver</title>
+<title>Configuring <application><acronym>ALSA</acronym>-driver</application></title>
 <sect3><title>Config files</title>
 …
 <sect3><title>Configuration Information</title>
 <para>To configure the alsa drivers, you need to add some lines to
 <filename>/etc/modules.conf</filename>:</para>
+<para>To configure the <acronym>ALSA</acronym> drivers, you need to add some
+lines to <filename>/etc/modules.conf</filename>:</para>
 <screen><userinput><command>cat &gt;&gt; /etc/modules.conf &lt;&lt; "EOF"
 …
 alias char-major-116 snd
 alias snd-card-0 snd-&lt;soundcard-name&gt;
+alias snd-card-0 snd-<replaceable>[soundcard-name]</replaceable>
 alias sound-slot-0 snd-card-0
 …
 EOF</command></userinput></screen>
 <para>&lt;soundcard-name&gt; needs to be replaced with the driver relevant
+to your soundcard.  If you have more than one soundcard, you can add
+additional sections by repeating the above but changing the first 0 to 1 and
 so on.</para>
+<para><replaceable>[soundcard-name]</replaceable> needs to be replaced with the
+driver relevant to your soundcard.  If you have more than one soundcard, you
+can add additional sections by repeating the above but changing the first 0 to
+and so on.</para>
 <para>After editing <filename>/etc/modules.conf</filename> you need to run
 <filename>depmod</filename>.  If the drivers you have compiled are for the
+<command>depmod</command>.  If the drivers you have compiled are for the
 version of the kernel you are currently running, simply run
 <screen><userinput><command>depmod</command></userinput></screen>  If you are compiling
 drivers for a different kernel version than those you are running, you
 will need to use a line along the lines of:
 <screen><userinput><command>depmod -a 2.4.19 -F /boot/System.map-2.4.19</command>
 </userinput></screen></para>
+<screen><userinput><command>depmod</command></userinput></screen>
+If you are compiling  drivers for a different kernel version than those you are
+running, you will need to use a line along the lines of:
+<screen><userinput><command>depmod -a 2.4.22 -F /boot/System.map-2.4.22
+</command></userinput></screen></para>
 </sect3>

multimedia/libdriv/alsa/driver/alsa-driver-desc.xml

-              r2f81a4dd
+              r8c3989b2
 <title>Contents</title>
+<para>The alsa-driver package contains the alsa sound card
+drivers and include files.</para>
+<para>The <application><acronym>ALSA</acronym>-driver</application> package
+contains the <acronym>ALSA</acronym> sound card drivers and include files.
+</para>
 </sect2>
 …
 <sect2><title>Description</title>
+<sect3><title>alsa sound card drivers</title>
+<para>These are kernel modules which provide audio and
+<acronym>MIDI</acronym> functionality
+to the operating system.</para></sect3>
+<sect3><title><acronym>ALSA</acronym> sound card drivers</title>
+<para>These are kernel modules which provide audio and <acronym>MIDI</acronym>
+functionality to the operating system.</para></sect3>
 <sect3><title>include files</title>
+<para>These are installed in <filename
+class="directory">/usr/include/sound</filename> and are required to compile
+certain packages such as alsa-lib.</para></sect3>
+<para>These are installed in <filename class="directory">/usr/include/sound
+</filename> and are required to compile certain packages such as
+<application><acronym>ALSA</acronym>-lib</application>.
+</para></sect3>
 </sect2>

multimedia/libdriv/alsa/driver/alsa-driver-exp.xml

-              r2f81a4dd
+              r8c3989b2
 <title>Command explanations</title>
 <para><command>--with-sequencer=yes</command> : This tells the
+alsa-driver package to build the sequencer modules for whichever soundcards
+for which you are building. Most people want them so you will usually want to
 leave it set to yes.</para>
+<para><command>--with-sequencer=yes</command> : This tells the <application>
+<acronym>ALSA</acronym>-driver</application> package to build the sequencer
+modules for whichever soundcards for which you are building. Most people want
+them so you will usually want to leave it set to yes.</para>
 <para><command>--with-oss=yes</command> : This tells the package to
 build the <acronym>OSS</acronym>/Free emulation modules. Again, most people want this so it's
 probably best to stick with yes.</para>
+build the <acronym>OSS</acronym>/Free emulation modules. Again, most people
+want this so it's probably best to stick with yes.</para>
 <para><command>--with-isapnp=no</command> : Most sound cards these days
 are <acronym>PCI</acronym> and so <acronym>ISA</acronym> Plug and Play
 support isn't needed. If you are using an
 <acronym>ISA</acronym> soundcard, it's best to say yes here.</para>
+support isn't needed. If you are using an <acronym>ISA</acronym> soundcard,
+it's best to say yes here.</para>
 <para><command>--with-cards=all</command> : You can tell the script just
 …
 on which drivers are available see <command>./configure
 --help</command>. If you aren't sure which chipset your soundcard uses,
+have a look in <filename>CARDS-STATUS</filename> in the alsa-driver source
+have a look in <filename>CARDS-STATUS</filename> in the
+<application><acronym>ALSA</acronym>-driver</application> source
 tree. The default specified here will build all drivers.</para>

multimedia/libdriv/alsa/driver/alsa-driver-inst.xml

-              r2f81a4dd
+              r8c3989b2
 <sect2>
 <title>Installation of <application>alsa-driver</application></title>
+<title>Installation of <application><acronym>ALSA</acronym>-driver</application></title>
 <para>Before installing the alsa-drivers note that in your kernel
 configuration you should have <userinput>Sound Card Support
+<para>Before installing the <acronym>ALSA</acronym> drivers note that in your
+kernel configuration you should have <userinput>Sound Card Support
 (CONFIG_SOUND)</userinput> enabled but <emphasis>nothing</emphasis> else in
 the Sound menu (with the possible exception of TV Card Mixer support.  In
 particular you should <emphasis>not</emphasis> have <userinput>OSS Sound
 Modules</userinput> enabled as this will cause problems when loading the
 alsa driver modules.</para>
+<acronym>ALSA</acronym> driver modules.</para>
 <note><para>Because alsa drivers are kernel
+<note><para>Because <acronym>ALSA</acronym> drivers are kernel
 modules, they must be compiled with the same compiler the kernel has
 used.</para></note>
 <para>Install <application>alsa-driver</application> using the following
 commands as a template:</para>
+<para>Install <application><acronym>ALSA</acronym>-driver</application> using
+the following commands as a template:</para>
 <screen><userinput><command>CC=/opt/gcc-2.95.3/bin/gcc ./configure \
 …
 <para>If this is the first time you have installed the alsa drivers, you
 will need to create the <filename class="directory">/dev</filename> entries
 using the script provided in the alsa-driver source tree:
+using the script provided in the <acronym>ALSA</acronym>-driver source tree:
 <screen><userinput><command>./snddevices</command></userinput></screen></para>

multimedia/libdriv/alsa/driver/alsa-driver-intro.xml

-              r2f81a4dd
+              r8c3989b2
 <sect2>
+<title>Introduction to <application>alsa-driver</application></title>
+<title>Introduction to <application><acronym>ALSA</acronym>-driver</application>
+</title>
+<para>The <application>alsa-driver</application> package contains the alsa sound drivers. These are
+<para>The <application><acronym>ALSA</acronym>-driver</application> package
+contains the <acronym>ALSA</acronym> sound drivers. These are
 the next generation of sound drivers for Linux.</para>

multimedia/libdriv/alsa/lib/alsa-lib-config.xml

r2f81a4dd	r8c3989b2
1	1	<sect2>
2		<title>Configuring ~~alsa-lib~~</title>
	2	<title>Configuring <application><acronym>ALSA</acronym>-lib</application></title>
3	3
4	4	<sect3><title>Configuration Information</title>

multimedia/libdriv/alsa/lib/alsa-lib-desc.xml

-              r2f81a4dd
+              r8c3989b2
 <title>Contents</title>
+<para>The alsa-lib package contains <command>aserver</command> and the
+<filename class="libraryfile">libasound</filename> library.</para>
+<para>The <application><acronym>ALSA</acronym>-lib</application> package
+contains <command>aserver</command> and the <filename class="libraryfile">
+libasound</filename> library.</para>
 </sect2>
 …
 <sect3><title>libasound (alsa library)</title>
 <para><filename class="libraryfile">libasound</filename> provides alsa
 functions for application programs.</para></sect3>
+<para><filename class="libraryfile">libasound</filename> provides
+<acronym>ALSA</acronym> functions for application programs.</para></sect3>
 </sect2>

multimedia/libdriv/alsa/lib/alsa-lib-inst.xml

-              r2f81a4dd
+              r8c3989b2
 <sect2>
+<title>Installation of <application>alsa-lib</application></title>
+<title>Installation of <application><acronym>ALSA</acronym>-lib</application>
+</title>
+<para>Install <application>alsa-lib</application> by running the following commands:</para>
+<para>Install <application><acronym>ALSA</acronym>-lib</application> by running
+the following commands:</para>
 <screen><userinput><command>./configure &amp;&amp;

multimedia/libdriv/alsa/lib/alsa-lib-intro.xml

-              r2f81a4dd
+              r8c3989b2
 <sect2>
 <title>Introduction to <application>alsa-lib</application></title>
+<title>Introduction to <application><acronym>ALSA</acronym>-lib</application></title>
+<para>The <application>alsa-lib</application> package contains the alsa library.  This is used by
+programs (including alsa-utils) which wish to use the alsa sound interface.</para>
+<para>The <application><acronym>ALSA</acronym>-lib</application> package
+contains the <acronym>ALSA</acronym> library.  This is used by programs
+(including <application><acronym>ALSA</acronym>-utils</application>) which wish
+to use the <acronym>ALSA</acronym> sound interface.</para>
 <sect3><title>Package information</title>
 …
 </sect3>
 <sect3><title><application>alsa-lib</application> dependencies</title>
+<sect3><title><application><acronym>ALSA</acronym>-lib</application> dependencies</title>
 <sect4><title>Required</title>
 <para><xref linkend="alsa-driver"/>

multimedia/libdriv/alsa/oss/alsa-oss-config.xml

r2f81a4dd	r8c3989b2
1	1	<sect2>
2		<title>Configuring ~~alsa-oss~~</title>
	2	<title>Configuring <application><acronym>ALSA</acronym>-<acronym>OSS</acronym></application></title>
3	3
4	4	<sect3><title>Configuration Information</title>

multimedia/libdriv/alsa/oss/alsa-oss-desc.xml

-              r2f81a4dd
+              r8c3989b2
 <title>Contents</title>
+<para>The alsa-oss package contains <command>aoss</command> and the
+<filename class="libraryfile">libaoss</filename> (alsa oss compatibility
+<para>The <application><acronym>ALSA</acronym>-<acronym>OSS</acronym>
+</application> package contains <command>aoss</command> and the
+<filename class="libraryfile">libaoss</filename>
+(<acronym>ALSA</acronym> <acronym>OSS</acronym> compatibility
 library) library.</para>

multimedia/libdriv/alsa/oss/alsa-oss-inst.xml

-              r2f81a4dd
+              r8c3989b2
 <sect2>
 <title>Installation of <application>alsa-oss</application></title>
+<title>Installation of <application><acronym>ALSA</acronym>-<acronym>OSS</acronym></application></title>
 <para>Install <application>alsa-oss</application> by running the following commands:</para>
+<para>Install <application><acronym>ALSA</acronym>-<acronym>OSS</acronym></application> by running the following commands:</para>
 <screen><userinput><command>./configure &amp;&amp;

multimedia/libdriv/alsa/oss/alsa-oss-intro.xml

-              r2f81a4dd
+              r8c3989b2
 <sect2>
 <title>Introduction to <application>alsa-oss</application></title>
+<title>Introduction to <application><acronym>ALSA</acronym>-<acronym>OSS</acronym></application></title>
+<para>The alsa-oss package contains the alsa oss compatibility library.
+This is used by programs which wish to use the alsa oss sound interface</para>
+<para>The
+<application><acronym>ALSA</acronym>-<acronym>OSS</acronym></application>
+package contains the <acronym>ALSA</acronym> <acronym>OSS</acronym>
+compatibility library. This is used by programs which wish to use the
+<acronym>ALSA</acronym> <acronym>OSS</acronym> sound interface</para>
 <sect3><title>Package information</title>
 …
 </sect3>
 <sect3><title><application>alsa-oss</application> dependencies</title>
+<sect3><title><application><acronym>ALSA</acronym>-<acronym>OSS</acronym></application> dependencies</title>
 <sect4><title>Required</title>
 <para><xref linkend="alsa-lib"/>

multimedia/libdriv/alsa/tools/alsa-tools-desc.xml

-              r2f81a4dd
+              r8c3989b2
 <sect3><title>as10k1</title>
+<para><command>as10k1</command> is an assembler for the emu10k1 DSP chip present in the
+Creative SB Live, PCI 512, and emu APS sound cards. It is used to make
+audio effects such as a flanger, chorus or reverb.</para></sect3>
+<para><command>as10k1</command> is an assembler for the emu10k1 <acronym>DSP
+</acronym> chip present in the Creative <acronym>SB</acronym> Live,
+<acronym>PCI</acronym> 512, and emu <acronym>APS</acronym> sound cards. It is
+used to make audio effects such as a flanger, chorus or reverb.</para></sect3>
 <sect3><title>envy24control</title>
 <para><command>envy24control</command> is a control tool for Envy24 (ice1712) based
 soundcards</para></sect3>
+<para><command>envy24control</command> is a control tool for Envy24 (ice1712)
+based soundcards</para></sect3>
 <sect3><title>sb16_csp</title>
+<para><command>sb16_csp</command> is an SB16/AWE32 Creative Signal Processor (ASP/CSP) control
+program.</para></sect3>
+<para><command>sb16_csp</command> is an <acronym>SB</acronym>16/<acronym>AWE
+</acronym>32 Creative Signal Processor (<acronym>ASP</acronym>/<acronym>CSP
+</acronym>) control program.</para></sect3>
 <sect3><title>sbiload</title>
 <para><command>sbiload</command>is an OPL2/3 FM instrument loader for
 the <acronym>ALSA</acronym> sequencer.</para></sect3>
+<para><command>sbiload</command>is an <acronym>OPL</acronym>2/3 FM instrument
+loader for the <acronym>ALSA</acronym> sequencer.</para></sect3>
 </sect2>

multimedia/libdriv/alsa/tools/alsa-tools-inst.xml

-              r2f81a4dd
+              r8c3989b2
 <sect2>
 <title>Installation of <application>alsa-tools</application></title>
+<title>Installation of <application><acronym>ALSA</acronym>-tools</application></title>
+<para>The <application>alsa-tools</application> package is only needed by those with advanced
+requirements for their sound card.  The tools are not all built together,
+instead you need to <command>cd</command> into the directory of each
+tool you wish to compile and run the following commands:</para>
+<para>The <application><acronym>ALSA</acronym>-tools</application> package is
+only needed by those with advanced requirements for their sound card.  The
+tools are not all built together, instead you need to <command>cd</command>
+into the directory of each tool you wish to compile and run the following
+commands:</para>
 <screen><userinput><command>./configure &amp;&amp;

multimedia/libdriv/alsa/tools/alsa-tools-intro.xml

-              r2f81a4dd
+              r8c3989b2
 <sect2>
 <title>Introduction to <application>alsa-tools</application></title>
+<title>Introduction to <application><acronym>ALSA</acronym>-tools</application></title>
 <para>The <application>alsa-tools</application> package contains
+<para>The <application><acronym>ALSA</acronym>-tools</application> package contains
 advanced tools for certain soundcards.</para>
 …
 </sect3>
 <sect3><title><application>alsa-tools</application> dependencies</title>
+<sect3><title><application><acronym>ALSA</acronym>-tools</application> dependencies</title>
 <sect4><title>Required</title>
 <para><xref linkend="alsa-lib"/>

multimedia/libdriv/alsa/utils/alsa-utils-config.xml

-              r2f81a4dd
+              r8c3989b2
 <sect2>
 <title>Configuring alsa-utils</title>
+<title>Configuring <application><acronym>ALSA</acronym>-utils</application></title>
 <sect3><title>Config files</title>
 …
 those readers who wish to do this.</para>
 <para>The alsa-drivers package installs a script as
+<filename>/etc/rc.d/init.d/alsasound</filename>.  While it is possible to use
+this script, it contains a lot of extraneous detail which isn't needed on an
+LFS system and so we create our own script
 <filename>/etc/rc.d/init.d/alsa</filename>.</para>
+<para>The <application><acronym>ALSA</acronym>-drivers</application> package
+installs a script as <filename>/etc/rc.d/init.d/alsasound</filename>.  While it
+is possible to use this script, it contains a lot of extraneous detail which
+isn't needed on an <acronym>LFS</acronym> system and so we create our own
+script <filename>/etc/rc.d/init.d/alsa</filename>.</para>
 <para>To create the alsa script, do the following:</para>
 <screen><userinput><command>cat &gt; /etc/rc.d/init.d/alsa &lt;&lt; "EOF"
+<screen><userinput><command>cat &gt; /etc/rc.d/init.d/alsa &lt;&lt; "EOF"</command>
 #!/bin/sh
 # Begin $rc_base/init.d/alsa
 …
 # End $rc_base/init.d/alsa
 EOF
+<command>EOF
 chmod 755 /etc/rc.d/init.d/alsa</command></userinput></screen>
 …
 <para>Note that all channels of your soundcard are muted by default. You can
+use the <command>alsamixer</command> program from alsa-utils (or any other
+use the <command>alsamixer</command> program from
+<application><acronym>ALSA</acronym>-utils</application> (or any other
 <acronym>OSS</acronym> mixer) to change this.</para>
 <para>Also, the first time the above script is run, it will complain that
 there is no state in <filename>/etc/asound.state</filename>.  You can
+prevent this by running the following commands after installing alsa-utils:
+prevent this by running the following commands after installing
+<application><acronym>ALSA</acronym>-utils</application>:
 <screen><userinput><command>touch /etc/asound.state &amp;&amp;
 alsactl store</command></userinput></screen></para>
 …
 are commented out.  They are there as an example of other things you may
 wish to do in the startup script.  <filename>sfxload</filename> is a
+separate package of interest to SoundBlaster AWE and Live! users.  It is
+designed for loading "sound-fonts" (which are used for MIDI output).  You
+may wish to delete these lines and add your own or, if you have the relevant
+soundcard, install <filename>sfxload</filename> and uncomment them.</para>
+separate package of interest to SoundBlaster <acronym>AWE</acronym> and Live!
+users.  It is designed for loading "sound-fonts" (which are used for
+<acronym>MIDI</acronym> output).  You may wish to delete these lines and add
+your own or, if you have the relevant soundcard, install <filename>sfxload
+</filename> and uncomment them.</para>
 </sect3>

multimedia/libdriv/alsa/utils/alsa-utils-desc.xml

-              r2f81a4dd
+              r8c3989b2
 <title>Contents</title>
+<para>The alsa-utils package contains <command>aconnect</command>,
+<para>The <application><acronym>ALSA</acronym>-utils</application> package
+contains <command>aconnect</command>,
 <command>alsactl</command>, <command>alsamixer</command>,
 <command>amixer</command>, <command>aplay</command>,
 …
 <sect3><title>aconnect</title>
 <para><command>aconnect</command> is a utility for connecting and disconnecting two existing
 ports in the <acronym>ALSA</acronym> sequencer system.</para></sect3>
+<para><command>aconnect</command> is a utility for connecting and disconnecting two existing ports in the <acronym>ALSA</acronym> sequencer system.</para>
+</sect3>
 <sect3><title>alsactl</title>

multimedia/libdriv/alsa/utils/alsa-utils-inst.xml

-              r2f81a4dd
+              r8c3989b2
 <sect2>
 <title>Installation of <application>alsa-utils</application></title>
+<title>Installation of <application><acronym>ALSA</acronym>-utils</application></title>
 <para>Install <application>alsa-utils</application> by running the following commands:</para>
+<para>Install <application><acronym>ALSA</acronym>-utils</application> by running the following commands:</para>
 <screen><userinput><command>./configure &amp;&amp;

multimedia/libdriv/alsa/utils/alsa-utils-intro.xml

-              r2f81a4dd
+              r8c3989b2
 <sect2>
 <title>Introduction to <application>alsa-utils</application></title>
+<title>Introduction to <application><acronym>ALSA</acronym>-utils</application></title>
+<para>The <application>alsa-utils</application> package contains various
+utilities which are useful for controlling your sound card.</para>
+<para>The <application><acronym>ALSA</acronym>-utils</application> package
+contains various utilities which are useful for controlling your sound card.
+</para>
 <sect3><title>Package information</title>
 …
 </sect3>
 <sect3><title><application>alsa-utils</application> dependencies</title>
+<sect3><title><application><acronym>ALSA</acronym>-utils</application> dependencies</title>
 <sect4><title>Required</title>
 <para><xref linkend="alsa-lib"/>

Note: See TracChangeset for help on using the changeset viewer.

Context Navigation

Changeset 8c3989b2 for multimedia/libdriv/alsa

Legend:

Download in other formats: