Prepare 0.8.1

.gitignore

@@ -1,7 +1,9 @@
 *.pyc
 *.so
+MANIFEST
 doc/gh-pages/
 doc/html/
 doc/doctrees/
 gh-pages/
-build/
+build/
+dist/

CHANGES

@@ -1,9 +1,37 @@
+Version 0.8.1:
+- document changes (this file)
+
+Version 0.8:
+- 'PCM()' has new 'device' and 'cardindex' keyword arguments.
+
+  The keyword 'device' allows to select virtual devices, 'cardindex' can be
+  used to select hardware cards by index (as with 'mixers()' and 'Mixer()').
+
+  The 'card' keyword argument is still supported, but deprecated.
+
+  The reason for this change is that the 'card' keyword argument guessed
+  a device name from the card name, but this only works sometimes, and breaks
+  opening virtual devices.
+
+- new function 'pcms()' to list available PCM devices.
+
+- mixers() and Mixer() take an additional 'device' keyword argument.
+  This allows to list or open virtual devices.
+
+- The default behaviour of Mixer() without any arguments has changed.
+  Now Mixer() will try to open the 'default' Mixer instead of the Mixer
+  that is associated with card 0.
+
+- fix a memory leak under Python 3.x
+
+- some more memory leaks in error conditions fixed.
+
 Version 0.7:
 - fixed several memory leaks (patch 3372909), contributed by Erik Kulyk)
 
 
 Version 0.6:
-- mostly reverted patch 2594366: alsapcm_setup did not do complete error 
+- mostly reverted patch 2594366: alsapcm_setup did not do complete error
 checking for good reasons; some ALSA functions in alsapcm_setup may fail without
 rendering the device unusable
 
@@ -15,7 +43,7 @@ Version 0.5:
 
 
 Version 0.4:
-- API changes: mixers() and Mixer() now take a card index instead of a 
+- API changes: mixers() and Mixer() now take a card index instead of a
   card name as optional parameter.
 - Support for Python 3.0
 - Documentation converted to reStructuredText; use Sphinx instead of LaTeX.

README.md

@@ -5,12 +5,13 @@ For documentation, see http://larsimmisch.github.io/pyalsaaudio/
 > Author: Casper Wilstrup (cwi@aves.dk)  
 > Maintainer: Lars Immisch (lars@ibp.de)
 
-This package contains wrappers for accessing the ALSA api from Python. It
+This package contains wrappers for accessing the
+[ALSA](http://www.alsa-project.org/) API from Python. It
 is currently fairly complete for PCM devices, and has some support for mixers.
 
 If you find bugs in the wrappers please open an issue in the issue tracker.
 Please don't send bug reports regarding ALSA specifically. There are several
-bugs in this api, and those should be reported to the ALSA team - not
+bugs in the ALSA API, and those should be reported to the ALSA team - not
 me.
 
 This software is licensed under the PSF license - the same one used