Status of ALSA documentation?
I have just uploaded a template for the idea PD had to make a complete howto for each card and link it to the sound card matrix or something similar.
You can find it here:
http://www.boosthardware.com/LAU/alsa/template2.html
I would appreciate help from people to collect these things. Working modules.conf parameters and working .asoundrc files. Obviously I could do this myself but the parameters I provide will be next to useless for some cards. eg rme9652.
Please send me the info as text.
Also I have not recieved any feedback on my attempt at updating the mainpage to meet peoples requests. In case you missed it you can find it here:
http://www.boosthardware.com/LAU/alsa/
--
Patrick Shirkey - Boost Hardware Ltd
For the discerning hardware connoisseur Http://www.boosthardware.com Http://www.boosthardware.com/LAU/Linux_Audio_Users_Guide/
Quoted 31 lines · --- Kevin Conder
Quoted 8 lines · Andy Wingo
Quoted 4 lines · Kevin Conder
<rant>
Finally, if you're going to turn everything over to the Wikki
kiddies then count me out! I believe in quality over quantity. </rant>having written my share of documents, it's not the format that matters;
I was unclear, I wasn't talking about format. IMHO, using a Wikki
for technical documentation is misguided. Since it's off-topic, we can discuss this off of the list.Quoted 3 lines
but you've
demonstrated it best yourself, converting mark rage's document from the wiki to docbook was easier than writing something yourself.I converted Mark Rage's document to DocBook as a demonstration.
Nobody asked me to re-write it. Was I supposed to?Too often, Open Source hackers develop NIH (Not-Invented-Here)
Syndrome. You see them do the same work over and over. I try to avoid that, if possible. That's why I have worked with the maintainers of the existing documents like Mark and Valentijn.I'm dumb-founded by this personal attack... Maintenance work might
be "mechanical" but it's necessary.
Quoted 8 lines
-- Kevin Conder, [email protected]
_______________________________________________
Alsa-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/alsa-devel
_____________________________________________________________
Want a new web-based email account ? ---> http://www.firstlinux.net
_______________________________________________
Alsa-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/alsa-devel
Quoted 1 line · Patrick Shirkey
I hope you don't mind me adding the above contents to this Wiki below...
http://alsa.opensrc.org/?page=cmipci
It took me less than 2 minutes to create the above page, and anyone can revise or add new material without any impediments... too easy.
Quoted 5 lines
Also I have not recieved any feedback on my attempt at updating the mainpage to meet peoples requests. In case you missed it you can find it here:
That is an excllent intro, I'd certainly vote that it gets merged into the official site. Pity is wasn't a Wiki where you could have already made the changes rather than having to waste time lobbying.
--markc
_______________________________________________
Alsa-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/alsa-devel
Quoted 3 lines · Patrick Shirkey
I have just uploaded a template for the idea PD had to make a complete howto for each card and link it to the sound card matrix or something similar.
[...]
Quoted 1 line
Looks very good.
Quoted 3 lines
Also I have not recieved any feedback on my attempt at updating the mainpage to meet peoples requests. In case you missed it you can find it here:
[...]
Quoted 1 line
I guess the amount of feedback is to be expected (kind of explains why the web pages haven't been updated...). Anyway, this too looks good. One thing that might raise discussion is the five primary goals of ALSA. Are these still up-to-date or should they be upgraded to the post-alsa-in-2.5 era.
One thing that the front page should answer is why ALSA, what makes it better than OSS?
PS Also, the applications page requires updating (doesn't even
mention 0.6-0.9 APIs).
Signature · 8 lines
http://www.eca.cx Audio software for Linux! _______________________________________________ Alsa-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/alsa-devel
Quoted 7 lines · Patrick Shirkey
Quoted 4 lines
I have just uploaded a template for the idea PD had to make a complete howto for each card and link it to the sound card matrix or something similar.
[...]
Quoted 1 line
looks OK. a few nitpicks:
1) don't point people at /lib/modules ... the structure of this
tree is different in 2.0, 2.2 and 2.4
2) don't put a reference to alsamixer in the template; some cards have no mixer and so it won't do anything useful
3) don't assume that they use vi(1)
4) defining the card name to be of type "hw" might not be too smart for naive "consumer" users who
then try to use any old app with that as the PCM device name.
more generally, it doesn't seem useful to me to duplicate the instructions for building+installing+configuring ALSA for each card. isn't this what hyperlinks are for? what we need on a per-card basis is the stuff thats really specific for that card:
* what modules to load
* what module parameters the driver takes
* a lot of explanation about what they do
* a list of every Control and PCM switch
* a lot of explanation about what they do
* a "FAQ" detailing things like:
- how to get sound from the rear speakers?
- how to download firmware?
- how to get new sounds from the synth?
- how to make the synth work?
- why do i have to preload module XXX?
Quoted 1 line
Quoted 1 line
doesn't render under netscape 4.0
I think that simply for working on this, Patrick should be made webmaster for alsa-project.org. The simple fact that he has bothered to do some work on the website moves him beyond almost anybody else on the list, though in most cases, for all the right reasons.
--p
_______________________________________________
Alsa-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/alsa-devel
Quoted 4 lines · Paul Davis
I think that simply for working on this, Patrick should be made webmaster for alsa-project.org. The simple fact that he has bothered to do some work on the website moves him beyond almost anybody else on the list, though in most cases, for all the right reasons.
It's fine with me. I offered write access to WWW tree to him a few days ago.
Jaroslav
-----
Jaroslav Kysela <[email protected]>
Linux Kernel Sound Maintainer
ALSA Project http://www.alsa-project.org
SuSE Linux http://www.suse.com
_______________________________________________
Alsa-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/alsa-devel