v19-devel branch status

v19-devel is the name of the branch of PortAudio which was started some years ago to develop the 2.0 PortAudio API. This branch has been extensively developed and is now considerd the main line of development by PortAudio developers. The 2.0 API definition has been stable for over two years, however v19-devel does not implement all features on all platforms/host APIs (most notably blocking i/o is not implemented everywhere, nor is the callback buffer timestamping). Version 2.0 API implementation status is documented here: http://www.portaudio.com/docs/proposals/status.html

In spite of lack of complete support for some version 2.0 features, the current v19-devel branch is used in a number of commercial and open source projects and is considered by most PortAudio developers to be more consistent and usable than the V18-patch branch. It implements a number of features which were not available in the version 1.0 API (support for multiple host-APIs in a single build, support for non-interleaved buffers, blocking i/o with some host APIs).

A proposal for the V19 release

In spite of the lack of comprehensive API version 2.0 support, the current v19-devel branch is widely considered to be a better option than V18-patch. Thus it seems reasonable to release it soon to make it available to the wider community (in Linux distributions, as a download tarball etc). The remaining 2.0 features can be addressed in future releases. With this in mind, the following items have been identified as the remaining necessary tasks for the V19 release:

  • Update or omit tutorials in the /docs directory [TUTORIALS MOSTLY DONE IN WIKI]
  • Document non-implemented 2.0 API features
  • Remove "request for source code contributions from license" [DONE - made this a non-binding request outside the licence]
  • Identify any other items which should be added to the above list

The current proposal is to complete the V19 release in 1 months time (4th June 2006).

Task assignment

Please add/remove yourself from this as needed

  • Ross: directory restructure, license revision [DONE]
  • Bjorn: Start of Tutorial
  • Everyone: list of what isn't implemented