correct Python shell (CPython or JPython).

Because it might be a common mistake to pass a single string, this
situation is treated separately.

Since we were making a copy of the longopts list anyway, we now use
the list() function -- this made it necessary to change all uses of
the local variable (and argument) 'list' to something more meaningful,
i.e., 'opts'.

Also added docstrings (copied from the library manual) and removed the
(now redundant) module comments.

running in a non-threaded environment.  He added some #ifdefs that fix
this.

Noted by Stefan Witzel.

Noted by Stefan Witzel.

Tip by Vladimir Marangozov.

METH_VARARGS conventions and PyArg_ParseTuple(), and document the flag
and where to look for PyArg_ParseTuple() info.

Response to comment from Don Bashford <bashford@scripps.edu>.

<dalke@bioreason.com>).

Project files converted for CW Pro 4. And the daylight savings time switch seems to have "modified" the resource files (but nothing has changed there).

Solaris, the `CD' macro won't exist in the header file, so this will
raise a NameError.

command line operation is (much) faster.

fixes.  Input sources are mutually exclusive.

device and control pseudo-device:

- first look for the device filename in the environment variable
  AUDIODEV.

- if not found, use /dev/audio

- calculate the control device by tacking "ctl" onto the base device
  name.

We now do this.  Also, if the open fails, we call
PyErr_SetFromErrnoWithFilename() to give a more informative error
message.

Added a fileno() method to the audio object returned from open().
This returns the file descriptor which can be used by applications to
set up SIGPOLL notification, as per the manpage.

HTML version.  Give a reference to the actual section to allow a
hyperlink to be built.