Re: [PATCH] sound(4) related manpages 5.3 TODO item

On Wed, Sep 01, 2004 at 08:16:33PM +0100, cg wrote:
[...]
> the /dev entries are /dev/dsp* and /dev/audio*, /dev/sndstat, /dev/mixer*,  
> plus the midi ones: /dev/midi* and /dev/sequencer.  all of these names are  
> mandated by the oss spec.
> 
Oh, of course I meant /dev/dsp* when I wrote /dev/pcm*.  ;)

> i'm not sure about midi device numbering; i believe some cards can  
> implement multiple midi devices, eg an fm synth, io port and a wavetable  
> synth simultaneously.
> 
> pcm won't be a separate device as such; it won't appear in dmesg.  this  
> probably applies to midi too.
> 
OK.

> >So, to summarize, I'd have liked to see the following happen:
> >
> >- "snd" is the generic sound device (module snd.ko)
> >- "snd_foo" is the sound driver for foo (module snd_foo.ko)
> >- "pcm" devclass renamed to "snd"
> >- "pcm", "mixer", and "midi" devices are created as children of "snd"
> 
> no.  pcm and midi will effectively be part of snd.  making them separate  
> newbus drivers would be tricky and require every driver to be modified.
> 
OK, sounds very good.  But what about PCM-related sysctls then?
How will hw.snd.pcm0.vchans be represented, for example?
hw.snd.0.vchans maybe?

> >- repo-copy (and tweak as necessary) all bridge drivers manpages,
> >  as shown in my patch;
> >
> >- do *not* repo-copy pcm(4) to sound(4) yet, just link it, possibly
> >  mentioning in the manpage that the generic driver will soon be
> >  renamed from "sound" to "snd",
> >
> >- fix hints in NOTES (as in my patch) to match reality.
> 
> this sounds ok to me.
> 
OK, I will it then.

> >When "sound" -> "snd" conversion is actually done, repo-copy
> >pcm(4) to sound(4), tweak as necessary, documenting what the
> >"sound" device really is, mentioning "pcm", "mixer", and "midi"
> >sub-devices, link sound(4) to pcm(4), mixer(4), and midi(4).
> >
> >Please let me know how to proceed...
> 
> i don't think i can cope with the pressure of getting it into 5.3, so it'd  
> be better to postpone it until 5.4 i think.
> 
Sure, that's fine.  ;)

Can you please send me some plain text paragraph for the pcm(4)
manpage that will be linked to the sound(4) manpage, documenting
future plans like renaming "sound" to "snd", so people stay
tuned?


Cheers,
-- 
Ruslan Ermilov
ru_at_FreeBSD.org
FreeBSD committer