[Python-bugs-list] [ python-Bugs-610401 ] linuxaudiodev not documented

[SourceForge.net]

Bugs item #610401, was opened at 2002-09-17 03:31
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=610401&group_id=5470

Category: Documentation
Group: None
Status: Open
Resolution: None
Priority: 5
Submitted By: Alexandre Fayolle (afayolle)
Assigned to: Fred L. Drake, Jr. (fdrake)
Summary: linuxaudiodev not documented

Initial Comment:
Hi,

I've just discovered that there is a linuxaudiodev
module in python, which is not mentioned in the
standard library documentation. 

While it looks a lot like sunaudiodev, which is
documented, the sunaudiodev docs cannot be used
directly because both modules don't share the same
interfaces. For instance open() does not accept the
same parameters, and the audio device objects don't
have the same methods. 

Having some docstrings in the linuxaudiodev module
could help a lot.

Cheers,

Alexandre

----------------------------------------------------------------------

>Comment By: Neal Norwitz (nnorwitz)
Date: 2003-01-07 20:02

Message:
Logged In: YES 
user_id=33168

Note:  linuxaudiodev has been deprecated.  ossaudiodev is
the module which should be documented.

----------------------------------------------------------------------

Comment By: Fred L. Drake, Jr. (fdrake)
Date: 2002-09-17 10:05

Message:
Logged In: YES 
user_id=3066

There's also an "audiodev" module, which masks the
differences between the SGI interface (the "al" and "AL"
modules) and the Solaris interface ("sunaudiodev"). 
Probably the right thing would be for someone who
understands the linuxaudiodev interface to extend the
"audiodev" module to support Linux as well, and then we
could document the audiodev interface instead, and treat the
others as implementation details.

But I know almost nothing about audio beyond how to stick a
CD in a CD player.  Contributions are welcome.

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=610401&group_id=5470