[gentoo-doc-cvs] cvs commit: alsa-guide.xml

[Shyam Mani]

fox2mike    05/07/12 19:17:38

  Modified:    xml/htdocs/doc/en alsa-guide.xml
  Log:
  #95574, #98429 - Updates + Fixes to the guide. Added sections on the Audio Group and more info regarding USB + ISA sound cards. #92711 went to RESO FIXED, so genkernel information was updated to reflect the corresponding changes. Thanks to Daniel Drake(dsd), Arun Raghavan (for ISA input), Miles Lubin, Jason Bucata, Deathwing00, alin, rane, LinuxBlues on  IRC for helping with proofing and corrections.

Revision  Changes    Path
1.54      +136 -38   xml/htdocs/doc/en/alsa-guide.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/alsa-guide.xml?rev=1.54&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/alsa-guide.xml?rev=1.54&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/alsa-guide.xml.diff?r1=1.53&r2=1.54&cvsroot=gentoo

Index: alsa-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/alsa-guide.xml,v
retrieving revision 1.53
retrieving revision 1.54
diff -u -r1.53 -r1.54
--- alsa-guide.xml	8 Jun 2005 19:54:07 -0000	1.53
+++ alsa-guide.xml	12 Jul 2005 19:17:38 -0000	1.54
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/alsa-guide.xml,v 1.53 2005/06/08 19:54:07 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/alsa-guide.xml,v 1.54 2005/07/12 19:17:38 fox2mike Exp $ -->
 
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
@@ -15,11 +15,11 @@
 </abstract>
 
 <!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>2.2</version>
-<date>2005-06-09</date>
+<version>2.3</version>
+<date>2005-07-12</date>
 
 <chapter>
 <title>Introduction</title>
@@ -71,13 +71,6 @@
 in your kernel and use <c>media-sound/alsa-driver</c>. It <e>will</e> fail.
 </warn>
 
-<impo>
-<c>genkernel</c> users have their config built such a way that the ALSA 
-sub-system in the kernel is active. Therefore <c>genkernel</c> users can 
-proceed to the <uri link="#alsa-utilities">ALSA Utilities</uri> section 
-directly.
-</impo>
-
 <p>
 The two options are :
 </p>
@@ -164,10 +157,37 @@
 
 <p>
 Whichever method of install you choose, you need to know what drivers your 
-sound card uses. <c>lspci</c> will help you in digging out the required 
-information. Please <c>emerge sys-apps/pciutils</c> to get <c>lspci</c>, if 
-you don't have it installed already. We now proceed to find out details about 
-the sound card.
+sound card uses. In most cases, sound cards (onboard and otherwise) are PCI
+based and <c>lspci</c> will help you in digging out the required  information.
+Please <c>emerge sys-apps/pciutils</c> to get <c>lspci</c>, if you don't have it
+installed already. In case you have a USB sound card, <c>lsusb</c> from
+<c>sys-apps/usbutils</c> <e>might</e> be of help. For ISA cards, try using
+<c>sys-apps/isapnptools</c>. Also, the following pages <e>may</e> help users
+with ISA based sound cards.
+</p>
+
+<ul>
+  <li>
+  <uri link="http://www.roestock.demon.co.uk/isapnptools/">The ISAPNPTOOLS
+  Page</uri>
+  </li>
+  <li>
+  <uri link="http://www2.linuxjournal.com/article/3269">LinuxJournal PnP
+  Article</uri>
+  </li>
+  <li>
+  <uri link="http://www.tldp.org/HOWTO/Sound-HOWTO/x320.html">TLDP Sound
+  HowTo</uri>
+  </li>
+</ul>
+
+<note>
+For ease of use/explanation, we assume the user has a PCI based sound card for
+the remainder of this guide.
+</note>
+
+<p>
+We now proceed to find out details about the sound card.
 </p>
 
 <pre caption="Soundcard Details">
@@ -208,6 +228,11 @@
 Let us now configure the kernel to enable ALSA.
 </p>
 
+<impo>
+<c>genkernel</c> users should now run <c>genkernel --menuconfig</c> and then follow
+the instructions in <uri link="#doc_chap2_pre3">Kernel Options for ALSA</uri>.
+</impo>
+
 <pre caption="Heading over to the source">
 # <i>cd /usr/src/linux</i>
 # <i>make menuconfig</i>
@@ -223,13 +248,14 @@
 kernel to ensure proper ALSA support for our sound card.
 </p>
 
-<note>
-Please note that for the sake of ease, all examples show a modular kernel. It 
-is advisable to follow the same. Please do <e>not</e> skip the 
-<uri link="#alsa-config">Configuration</uri> section of this document. If 
-you still like to have options built-in, ensure that you make changes to your 
-config accordingly.
-</note>
+<p>
+Please note that for the sake of ease, all examples show ALSA built as modules.
+It is advisable to follow the same as it then allows the use of <c>alsaconf</c>
+which is a boon when you want to configure your card. Please do <e>not</e> skip the <uri
+link="#alsa-config">Configuration</uri> section of this document. If you still
+like to have options built-in, ensure that you make changes to your config
+accordingly.
+</p>
 
 <pre caption="Kernel Options for ALSA">
 Device Drivers  ---&gt;
@@ -318,6 +344,12 @@
 fail. The next code listing gives you one way of performing the checks.
 </p>
 
+<note>
+<c>genkernel</c> users can proceed with <uri link="#doc_chap2_pre6">Installing
+alsa-driver</uri> as their configuration is in sync with the one shown below by
+default.
+</note>
+
 <ol>
   <li>
   <c>CONFIG_SOUND</c> is set. (Basic Sound support enabled)
@@ -347,7 +379,7 @@
 </pre>
 
 <p>
-Now all you have to do is type the magic words...and no, its not abracadabra.
+Now all you have to do is type the magic words... and no, it's not abracadabra.
 </p>
 
 <pre caption="Installing alsa-driver">
@@ -412,10 +444,9 @@
 your devices and try to find out your sound card. You will be asked to pick 
 your sound card from a list. Once that's done, it will ask you permission to 
 automatically make required changes to <path>/etc/modules.d/alsa</path>. 
-It will then adjust your volume settings to optimum levels and run 
-<c>modules-update</c> and starts the <path>/etc/init.d/alsasound</path> 
-service. Once <c>alsaconf</c> exits, you can proceed with setting up the ALSA
-initscript. 
+It will then adjust your volume settings to optimum levels, run
+<c>modules-update</c> and start the <path>/etc/init.d/alsasound</path> service.
+Once <c>alsaconf</c> exits, you can proceed with setting up the ALSA initscript. 
 </p>
 
 </body>
@@ -432,8 +463,8 @@
 </p>
 
 <pre caption="Adding ALSA to default">
-# <i>rc-update add alsasound default</i>
- * alsasound added to runlevel default
+# <i>rc-update add alsasound boot</i>
+ * alsasound added to runlevel boot
  * rc-update complete.
 </pre>
 
@@ -446,6 +477,29 @@
 </body>
 </section>
 <section>
+<title>Audio Group</title>
+<body>
+
+<p>
+Before we move on to testing, there's one last <e>important</e> thing that needs
+to be setup. Rule of thumb in a *nix OS : Do not run as root unless needed.
+This applies here as well ;) How? Well, most of the times you should be logged
+in as a user and would like to listen to music or access your soundcard. For
+that to happen, you need to be in	the "audio" group. At this point, we'll add
+users to the audio group, so that they won't have any issues when they want to
+access sound devices. We'll use <c>gpasswd</c> here and you need to be logged in
+as root for this to work.
+</p>
+
+<pre caption="Adding users to the audio group">
+<comment>(Substitute &lt;username&gt; with your user)</comment>
+# <i>gpasswd -a &lt;username&gt; audio </i>
+Adding user &lt;username&gt; to group audio
+</pre>
+
+</body>
+</section>
+<section>
 <title>Volume Check!</title>
 <body>
 
@@ -456,7 +510,7 @@
 </p>



-- 
gentoo-doc-cvs@g.o mailing list