Attachment 123209 Details for Bug 183418 – alsa-driver-is-going-to-get-nuked.patch

[patch] alsa-driver-is-going-to-get-nuked.patch

alsa-driver-is-going-to-get-nuked.patch (text/plain), 6.83 KB, created by Jan Kundrát (RETIRED) on 2007-06-27 15:47:04 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Jan Kundrát (RETIRED)

Created: 2007-06-27 15:47:04 UTC

Size: 6.83 KB

patch

obsolete

>Index: xml/htdocs/doc/en/alsa-guide.xml
>===================================================================
>RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/alsa-guide.xml,v
>retrieving revision 1.80
>diff -u -b -B -r1.80 alsa-guide.xml
>--- xml/htdocs/doc/en/alsa-guide.xml	19 May 2007 03:00:29 -0000	1.80
>+++ xml/htdocs/doc/en/alsa-guide.xml	27 Jun 2007 15:46:52 -0000
>@@ -24,8 +24,8 @@
> 
> <license/>
> 
>-<version>2.22</version>
>-<date>2007-05-07</date>
>+<version>3</version>
>+<date>2007-06-27</date>
> 
> <chapter>
> <title>Introduction</title>
>@@ -51,19 +51,6 @@
> 
> </body>
> </section>
>-<section>
>-<title>ALSA on Gentoo</title>
>-<body>
>-
>-<p>
>-One of Gentoo's main strengths lies in giving the user maximum control over
>-how a system is installed/configured. ALSA on Gentoo follows the same
>-principle. There are two ways you can get ALSA support up and running on your
>-system. We shall look at them in detail in the next chapter.
>-</p>
>-
>-</body>
>-</section>
> </chapter>
> 
> <chapter>
>@@ -72,99 +59,16 @@
> <title>Options</title>
> <body>
> 
>-<warn>
>-The methods shown below are mutually exclusive. You cannot have ALSA compiled
>-in your kernel and use <c>media-sound/alsa-driver</c>. It <e>will</e> fail.
>-</warn>
>-
> <p>
>-The two options are:
>-</p>
>-
>-<ol>
>-  <li>
>-    Use ALSA provided by your kernel. This is the preferred/recommended method.
>-  </li>
>-  <li>Use Gentoo's <c>media-sound/alsa-driver</c> package.</li>
>-</ol>
>-
>-<p>
>-The in-kernel drivers and the <c>alsa-driver</c> package can vary a little; it's
>-possible that features and fixes found in one might not yet be incorporated into
>-the other. The upstream developers are aware of this, but the two drivers are
>-effectively separate branches of the ALSA project; they are not entirely
>-identical. You should be aware that they might function slightly differently, so
>-if one doesn't work for you, try the other! We shall take a peek into both
>-before finally deciding on one.
>-</p>
>-
>-<p>
>-If you were to use ALSA provided by the kernel, the following are the pros and
>-cons:
>-</p>
>-
>-<table>
>-<tr>
>-  <th>Kernel ALSA</th>
>-  <th>Pros and Cons</th>
>-</tr>
>-<tr>
>-  <th>+</th>
>-  <ti>
>-    No need to emerge yet another package; drivers are integrated into kernel.
>-  </ti>
>-</tr>
>-<tr>
>-  <th>+</th>
>-  <ti>One shot solution, no repeating emerges.</ti>
>-</tr>
>-<tr>
>-  <th>-</th>
>-  <ti>Might be a slightly different version than <c>alsa-driver</c>.</ti>
>-</tr>
>-</table>
>-
>-<p>
>-And, if you were to use <c>alsa-driver</c>,
>-</p>
>-
>-<table>
>-<tr>
>-  <th>alsa-driver</th>
>-  <th>Pros and Cons</th>
>-</tr>
>-<tr>
>-  <th>+</th>
>-  <ti>Possibly the latest drivers from the ALSA Project.</ti>
>-</tr>
>-<tr>
>-  <th>+</th>
>-  <ti>Useful if you intend to develop audio drivers.</ti>
>-</tr>
>-<tr>
>-  <th>-</th>
>-  <ti>Every kernel recompile requires a re-emerge of <c>alsa-driver</c>.</ti>
>-</tr>
>-<tr>
>-  <th>-</th>
>-  <ti>Needs certain kernel config options disabled to work correctly.</ti>
>-</tr>
>-</table>
>-
>-</body>
>-</section>
>-<section>
>-<title>So...</title>
>-<body>
>-
>-<p>
>-The differences between <c>alsa-driver</c> and the in-kernel ALSA drivers are
>-quite subtle, as mentioned earlier. Since there are not any huge differences,
>-you are encouraged to go through the process of using the ALSA provided by the
>-kernel <e>first</e> for ease of use. Before reporting any sound related issues
>-to <uri link="https://bugs.gentoo.org">Gentoo Bugzilla</uri>, please try to
>-reproduce them using <c>alsa-driver</c> and file the bug report no matter what
>-the result.
>+Gentoo has always been offering two ways to get ALSA up and running for its
>+users, the <e>in-kernel method</e> and the <c>media-sound/alsa-driver</c>
>+package. Having two packages essentially doing the same thing proved to be
>+pretty hard and time consuming. Therefore, in June 2006 it was decided to
>+discontinue support for the <c>media-sound/alsa-driver</c> package which was
>+added to the list of packages slotted for removal from the tree. If you still
>+require the <c>alsa-driver</c> package, please mail <mail
>+link="alsa-bugs@gentoo.org">Gentoo ALSA maintainers</mail> with details about
>+why the in-kernel drivers don't work for you.
> </p>
> 
> </body>
>@@ -174,7 +78,7 @@
> <body>
> 
> <p>
>-Whichever method of install you choose, you need to know what drivers your
>+At first, you need to know what drivers your
> 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
>@@ -236,10 +140,6 @@
> <title>Using ALSA provided by your Kernel</title>
> <body>
> 
>-<p>
>-If you're a person who likes to keep things simple, then this is the way to go.
>-</p>
>-
> <note>
> Since the 2005.0 release, Gentoo Linux uses 2.6 as the default kernel. Please
> check that your kernel is a 2.6 series kernel. This method will <e>not</e> work
>@@ -338,11 +238,23 @@
> </body>
> </section>
> <section id="alsa-driver">
>+
> <title>Using the ALSA Driver package</title>
> <body>
> 
>+<impo>
>+The <c>alsa-driver</c> package is not supported by Gentoo developers. If your
>+soundcard doesn't work with in-kernel drivers, it's a bug that should be fixed.
>+Please let the <mail link="alsa-bugs@gentoo.org">Gentoo ALSA maintainers</mail>
>+know about your issues. If you don't, this package will be removed from the tree
>+and sound will stop working for you.
>+</impo>
>+
> <p>
>-So you've decided to go the <c>alsa-driver</c> way. Let's get started then.
> There are a few minor things to be done to ensure only the drivers for your
> sound card are compiled. Although this is not really necessary, it cuts down
> on the unnecessary drivers that will be compiled otherwise.
>@@ -735,6 +647,9 @@
> 0: SigmaTel STAC9721/23
> </pre>
> 
>+
>+
> <p>
> The other most common issue users face is the dreaded "Unknown symbol in module"
> error. An example of the same is shown below.
>@@ -825,6 +740,8 @@
> that should take care of this issue.
> </p>
> 
>+
>+
> </body>
> </section>
> </chapter>
>@@ -969,8 +886,8 @@
> 
> <p>
> You can have more than one sound card in your system simultaneously, provided
>-that you have built ALSA as modules in your kernel (or have installed
>-<c>alsa-driver</c> instead). You just need to specify which should be started
>+that you have built ALSA as modules in your kernel. You just need to specify
>+which should be started
> first in <path>/etc/modules.d/alsa</path>. Your cards are identified by their
> driver names inside this file. 0 is the first card, 1 is the second, and so on.
> Here's an example for a system with two sound cards.

Actions: View | Diff

Attachments on bug 183418: 123209