# HG changeset patch
# User cannam
# Date 1144665079 0
# Node ID b4043af4227868b6ba35bc58c998ae44aec9c7f4
# Parent  a67eeb9d634130877424d0d50251e1e50999e48d
* Some textual changes

diff -r a67eeb9d6341 -r b4043af42278 Makefile
--- a/Makefile	Fri Apr 07 17:50:52 2006 +0000
+++ b/Makefile	Mon Apr 10 10:31:19 2006 +0000
@@ -20,11 +20,11 @@
 HOST_LIBS	= -Lvamp-sdk -lvamp-sdk -lsndfile -ldl
 
 # Libraries required for the plugin.  Note that we can (and actively
-# want to) statically link with libstdc++, because our plugin exposes
+# want to) statically link libstdc++, because our plugin exposes only
 # a C API so there are no boundary compatibility problems.
 #
 PLUGIN_LIBS	= -Lvamp-sdk -lvamp-sdk
-#PLUGIN_LIBS	= -lvamp-sdk $(shell g++ -print-file-name=libstdc++.a)
+#PLUGIN_LIBS	= -Lvamp-sdk -lvamp-sdk $(shell g++ -print-file-name=libstdc++.a)
 
 # Flags required to tell the compiler to link to a dynamically loadable object
 #
diff -r a67eeb9d6341 -r b4043af42278 README
--- a/README	Fri Apr 07 17:50:52 2006 +0000
+++ b/README	Mon Apr 10 10:31:19 2006 +0000
@@ -5,8 +5,7 @@
 An API for audio analysis and feature extraction plugins.
 
 Vamp is an API for C and C++ plugins that process sampled audio data
-to produce descriptive output, such as measurements of particular
-features of the audio or semantic output based on them.
+to produce descriptive output (measurements or semantic observations).
 
 The principal differences between Vamp and a real-time audio
 processing plugin system such as VST are:
@@ -25,16 +24,22 @@
 
  * Vamp plugins have more control over their inputs than a typical
    real-time processing plugin.  For example, they can indicate to
-   the host the permitted range of processing block sizes, and can
-   request input data in the frequency domain instead of the time
-   domain.
+   the host their preferred processing block and step sizes, and these
+   may differ.
+
+ * Vamp plugins may ask to receive data in the frequency domain
+   instead of the time domain.  The host takes the responsibility
+   for converting the input data using an FFT of windowed frames.
+   This simplifies plugins that do straightforward frequency-domain
+   processing and permits the host to cache frequency-domain data
+   when possible.
 
  * A Vamp plugin is configured once before each processing run, and
    receives no further parameter changes during use -- unlike real
    time plugin APIs in which the input parameters may change at any
    time.  This also means that fundamental properties such as the
    number of values per output or the preferred processing block
-   size can depend on the input parameters.
+   size may depend on the input parameters.
 
 
 About this SDK
@@ -52,14 +57,17 @@
 
 Although this is the official API for Vamp, we don't recommend that
 you program directly to it.  The C++ abstraction in the SDK directory
-(below) is likely to be preferable for most purposes and also better
+(below) is likely to be preferable for most purposes, and is better
 documented.
 
  * vamp-sdk
 
 C++ classes for straightforwardly implementing Vamp plugins and hosts.
-Plugins should subclass Vamp::Plugin (in vamp-sdk/Plugin.h) and then
-use a Vamp::PluginAdapter to expose the correct C API for the plugin.
+
+Plugins should subclass Vamp::Plugin and then use a
+Vamp::PluginAdapter to expose the correct C API for the plugin.  Read
+vamp-sdk/PluginBase.h and Plugin.h for code documentation.
+
 Hosts may use the Vamp::PluginHostAdapter to convert the loaded
 plugin's C API back into a Vamp::Plugin object.
 
@@ -80,17 +88,18 @@
 Building the SDK
 ================
 
-Edit the Makefile for your platform according to the comments in it.
-Type "make".
+Edit the Makefile to suit your platform according to the comments in
+it.  Type "make".
 
 
 Licensing
 =========
 
-This plugin SDK is freely redistributable under the "new BSD" licence.
-See the file COPYING for more details.  In short, you are permitted to
-reuse the SDK and example plugins in any commercial or non-commercial,
-proprietary or open-source application under almost any conditions.
+This plugin SDK is freely redistributable under a "new-style BSD"
+licence.  See the file COPYING for more details.  In short, you are
+permitted to reuse the SDK and example plugins in any commercial or
+non-commercial, proprietary or open-source application or plugin under
+almost any conditions provided you retain the original copyright note.
 
 
 See Also
diff -r a67eeb9d6341 -r b4043af42278 vamp/vamp.h
--- a/vamp/vamp.h	Fri Apr 07 17:50:52 2006 +0000
+++ b/vamp/vamp.h	Mon Apr 10 10:31:19 2006 +0000
@@ -41,16 +41,24 @@
  * C language API for Vamp plugins.
  * 
  * This is the formal plugin API for Vamp.  Plugin authors may prefer
- * to use the C++ classes defined in the sdk directory, instead of
+ * to use the C++ classes provided in the Vamp plugin SDK, instead of
  * using this API directly.  There is an adapter class provided that
  * makes C++ plugins available using this C API with relatively little
- * work.  See the example plugins in the examples directory.
+ * work, and the C++ headers are thoroughly documented.
  */
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
+/** 
+ * Plugin API version. Incompatible changes to the API may be expected
+ * prior to version 1.0.
+ */
+#define VAMP_API_VERSION "0.2"
+#define VAMP_API_VERSION_MAJOR 0
+#define VAMP_API_VERSION_MINOR 2
+
 typedef struct _VampParameterDescriptor
 {
     const char *name;