ALSA make menuconfig Help description missing

ALSA make menuconfig Help description missing

[Karel Kulhavy]

Hello

v2.6.11 make menuconfig -> Device Drivers -> Sound -> Advanced Linux
Sound Architecture and

v2.6.11 make menuconfig -> Device Drivers -> Sound -> Advanced Linux
Sound Architecture -> Advanced Linux Sound Architecture

are missing their help descriptions:

"There is no help available for this kernel option."

Therefore the user is unable to determine how to use this subsystem
at all.

CL<

Re: ALSA make menuconfig Help description missing

[Takashi Iwai]

At Tue, 17 May 2005 14:35:49 +0200,
Karel Kulhavy wrote:
> 
> Hello
> 
> v2.6.11 make menuconfig -> Device Drivers -> Sound -> Advanced Linux
> Sound Architecture and
> 
> v2.6.11 make menuconfig -> Device Drivers -> Sound -> Advanced Linux
> Sound Architecture -> Advanced Linux Sound Architecture
> 
> are missing their help descriptions:
> 
> "There is no help available for this kernel option."
> 
> Therefore the user is unable to determine how to use this subsystem
> at all.

Something like below fixes the problem?


Takashi


--- linux/sound/Kconfig	22 Mar 2005 10:44:59 -0000	1.9
+++ linux/sound/Kconfig	17 May 2005 13:47:08 -0000
@@ -42,6 +42,8 @@
 config SND
 	tristate "Advanced Linux Sound Architecture"
 	depends on SOUND
+	help
+	  Say 'Y' or 'M' to enable ALSA (Advanced Linux Sound Architecture)
 
 source "sound/core/Kconfig"
 

Re: ALSA make menuconfig Help description missing

[Alexey Dobriyan]

On Tuesday 17 May 2005 17:49, Takashi Iwai wrote:
> At Tue, 17 May 2005 14:35:49 +0200,
> Karel Kulhavy wrote:
> > v2.6.11 make menuconfig -> Device Drivers -> Sound -> Advanced Linux
> > Sound Architecture and
> > 
> > v2.6.11 make menuconfig -> Device Drivers -> Sound -> Advanced Linux
> > Sound Architecture -> Advanced Linux Sound Architecture
> > 
> > are missing their help descriptions:
> > 
> > "There is no help available for this kernel option."
> > 
> > Therefore the user is unable to determine how to use this subsystem
> > at all.
> 
> Something like below fixes the problem?

> --- linux/sound/Kconfig
> +++ linux/sound/Kconfig
> @@ -42,6 +42,8 @@
>  config SND
>  	tristate "Advanced Linux Sound Architecture"
>  	depends on SOUND
> +	help
> +	  Say 'Y' or 'M' to enable ALSA (Advanced Linux Sound Architecture)

The only new info is that one can abbreviate "Advanced Linux Sound
Architecture" as "ALSA". ;-)

"Advanced Linux Sound Architecture" is already printed. What 'Y' and 'M' do is
also already printed at the top.

Re: ALSA make menuconfig Help description missing

[Takashi Iwai]

At Tue, 17 May 2005 18:16:51 +0400,
Alexey Dobriyan wrote:
> 
> On Tuesday 17 May 2005 17:49, Takashi Iwai wrote:
> > At Tue, 17 May 2005 14:35:49 +0200,
> > Karel Kulhavy wrote:
> > > v2.6.11 make menuconfig -> Device Drivers -> Sound -> Advanced Linux
> > > Sound Architecture and
> > > 
> > > v2.6.11 make menuconfig -> Device Drivers -> Sound -> Advanced Linux
> > > Sound Architecture -> Advanced Linux Sound Architecture
> > > 
> > > are missing their help descriptions:
> > > 
> > > "There is no help available for this kernel option."
> > > 
> > > Therefore the user is unable to determine how to use this subsystem
> > > at all.
> > 
> > Something like below fixes the problem?
> 
> > --- linux/sound/Kconfig
> > +++ linux/sound/Kconfig
> > @@ -42,6 +42,8 @@
> >  config SND
> >  	tristate "Advanced Linux Sound Architecture"
> >  	depends on SOUND
> > +	help
> > +	  Say 'Y' or 'M' to enable ALSA (Advanced Linux Sound Architecture)
> 
> The only new info is that one can abbreviate "Advanced Linux Sound
> Architecture" as "ALSA". ;-)

Yeah, that's pretty important information.  Someone may think ALSA as
"Alpaca and Llama Show Association" or "Australian Las Students'
Association" :)

> "Advanced Linux Sound Architecture" is already printed. What 'Y' and 'M' do is
> also already printed at the top.

I just wanted to confirm that adding a help text would solve the
problem.  A better description is appreciated, of course.


Takashi

Re: ALSA make menuconfig Help description missing

[Karel Kulhavy]

On Tue, May 17, 2005 at 03:49:02PM +0200, Takashi Iwai wrote:
> At Tue, 17 May 2005 14:35:49 +0200,
> Karel Kulhavy wrote:
> > 
> > Hello
> > 
> > v2.6.11 make menuconfig -> Device Drivers -> Sound -> Advanced Linux
> > Sound Architecture and
> > 
> > v2.6.11 make menuconfig -> Device Drivers -> Sound -> Advanced Linux
> > Sound Architecture -> Advanced Linux Sound Architecture
> > 
> > are missing their help descriptions:
> > 
> > "There is no help available for this kernel option."
> > 
> > Therefore the user is unable to determine how to use this subsystem
> > at all.
> 
> Something like below fixes the problem?

Yes, tried, fixes ;-)

However I suggest that a pointer to user documentation for ALSA be added
to the Help.

For example I have a problem when I run XMMS, Skype says something like
"can't open /dev/dsp" and don't know where to start.  The only thing I
know is that 1) I have ALSA turned on and 2) I want to know how to make
it accept more data streams from the programs and mix them together.

CL<
> 
> 
> Takashi
> 
> 
> --- linux/sound/Kconfig	22 Mar 2005 10:44:59 -0000	1.9
> +++ linux/sound/Kconfig	17 May 2005 13:47:08 -0000
> @@ -42,6 +42,8 @@
>  config SND
>  	tristate "Advanced Linux Sound Architecture"
>  	depends on SOUND
> +	help
> +	  Say 'Y' or 'M' to enable ALSA (Advanced Linux Sound Architecture)
>  
>  source "sound/core/Kconfig"
>  

Re: ALSA make menuconfig Help description missing

[Lee Revell]

On Tue, 2005-05-17 at 16:59 +0200, Karel Kulhavy wrote:
> Yes, tried, fixes ;-)
> 
> However I suggest that a pointer to user documentation for ALSA be added
> to the Help.
> 
> For example I have a problem when I run XMMS, Skype says something like
> "can't open /dev/dsp" and don't know where to start.  The only thing I
> know is that 1) I have ALSA turned on and 2) I want to know how to make
> it accept more data streams from the programs and mix them together.

There is no official user level documentation for dmix (which runs in
userspace anyway), because it was not intended to be configured by the
end user.  The current ALSA version, 1.0.9-rcX, uses dmix by default.

It's always a pain to get OSS apps to play nice with dmix, which is why
the real solution is to get proper ALSA support in Skype.

Lee

Re: ALSA make menuconfig Help description missing

[Valdis.Kletnieks]

[-- Attachment #1: Type: text/plain, Size: 468 bytes --]

On Tue, 17 May 2005 15:30:16 EDT, Lee Revell said:

> There is no official user level documentation for dmix (which runs in
> userspace anyway), because it was not intended to be configured by the
> end user.  The current ALSA version, 1.0.9-rcX, uses dmix by default.
> 
> It's always a pain to get OSS apps to play nice with dmix, which is why
> the real solution is to get proper ALSA support in Skype.

Blech. Explains why I can't find the kernel piece for it. ;)

[-- Attachment #2: Type: application/pgp-signature, Size: 226 bytes --]