Add a note regarding the extension id containing draft

free-audio · Jan 10, 2024 · 12ca18f · 12ca18f
1 parent ea9cecf
commit 12ca18f
Show file tree

Hide file tree

Showing 9 changed files with 22 additions and 2 deletions.
diff --git a/include/clap/ext/ambisonic.h b/include/clap/ext/ambisonic.h
@@ -3,8 +3,10 @@
 #include "../plugin.h"
 
 // This extension can be used to specify the channel mapping used by the plugin.
-
-static CLAP_CONSTEXPR const char CLAP_EXT_AMBISONIC[] = "clap.ambisonic/3";
+//
+// This extension ID contains `draft', yet it is stable.
+// See conventions/extension-id.md for more info.
+static CLAP_CONSTEXPR const char CLAP_EXT_AMBISONIC[] = "clap.ambisonic.draft/3";
 
 static CLAP_CONSTEXPR const char CLAP_PORT_AMBISONIC[] = "ambisonic";
 

diff --git a/include/clap/ext/audio-ports-activation.h b/include/clap/ext/audio-ports-activation.h
@@ -25,6 +25,8 @@
 /// Audio ports state is invalidated by clap_plugin_audio_ports_config.select() and
 /// clap_host_audio_ports.rescan(CLAP_AUDIO_PORTS_RESCAN_LIST).
 
+// This extension ID contains `draft', yet it is stable.
+// See conventions/extension-id.md for more info.
 static CLAP_CONSTEXPR const char CLAP_EXT_AUDIO_PORTS_ACTIVATION[] =
    "clap.audio-ports-activation/draft-2";
 

diff --git a/include/clap/ext/audio-ports-config.h b/include/clap/ext/audio-ports-config.h
@@ -26,6 +26,9 @@
 /// extension where all busses can be retrieved in the same way as in the audio-port extension.
 
 static CLAP_CONSTEXPR const char CLAP_EXT_AUDIO_PORTS_CONFIG[] = "clap.audio-ports-config";
+
+// This extension ID contains `draft', yet it is stable.
+// See conventions/extension-id.md for more info.
 static CLAP_CONSTEXPR const char CLAP_EXT_AUDIO_PORTS_CONFIG_INFO[] =
    "clap.audio-ports-config-info/draft-0";
 

diff --git a/include/clap/ext/configurable-audio-ports.h b/include/clap/ext/configurable-audio-ports.h
@@ -8,6 +8,9 @@ extern "C" {
 
 // This extension lets the host configure the plugin's input and output audio ports.
 // This is a "push" approach to audio ports configuration.
+
+// This extension ID contains `draft', yet it is stable.
+// See conventions/extension-id.md for more info.
 static CLAP_CONSTEXPR const char CLAP_EXT_CONFIGURABLE_AUDIO_PORTS[] =
    "clap.configurable-audio-ports.draft1";
 

diff --git a/include/clap/ext/context-menu.h b/include/clap/ext/context-menu.h
@@ -5,6 +5,8 @@
 // This extension lets the host and plugin exchange menu items and let the plugin ask the host to
 // show its context menu.
 
+// This extension ID contains `draft', yet it is stable.
+// See conventions/extension-id.md for more info.
 static CLAP_CONSTEXPR const char CLAP_EXT_CONTEXT_MENU[] = "clap.context-menu.draft/0";
 
 #ifdef __cplusplus

diff --git a/include/clap/ext/param-indication.h b/include/clap/ext/param-indication.h
@@ -13,6 +13,8 @@
 // The color semantic depends upon the host here and the goal is to have a consistent experience
 // across all plugins.
 
+// This extension ID contains `draft', yet it is stable.
+// See conventions/extension-id.md for more info.
 static CLAP_CONSTEXPR const char CLAP_EXT_PARAM_INDICATION[] = "clap.param-indication.draft/4";
 
 #ifdef __cplusplus

diff --git a/include/clap/ext/preset-load.h b/include/clap/ext/preset-load.h
@@ -2,6 +2,8 @@
 
 #include "../plugin.h"
 
+// This extension ID contains `draft', yet it is stable.
+// See conventions/extension-id.md for more info.
 static const char CLAP_EXT_PRESET_LOAD[] = "clap.preset-load.draft/2";
 
 #ifdef __cplusplus

diff --git a/include/clap/ext/remote-controls.h b/include/clap/ext/remote-controls.h
@@ -31,6 +31,8 @@
 // Pressing that button once gets you to the first page of the section.
 // Press it again to cycle through the section's pages.
 
+// This extension ID contains `draft', yet it is stable.
+// See conventions/extension-id.md for more info.
 static CLAP_CONSTEXPR const char CLAP_EXT_REMOTE_CONTROLS[] = "clap.remote-controls.draft/2";
 
 #ifdef __cplusplus

diff --git a/include/clap/ext/surround.h b/include/clap/ext/surround.h
@@ -24,6 +24,8 @@
 // 3. host calls clap_plugin_surround->get_channel_map()
 // 4. host activates the plugin and can start processing audio
 
+// This extension ID contains `draft', yet it is stable.
+// See conventions/extension-id.md for more info.
 static CLAP_CONSTEXPR const char CLAP_EXT_SURROUND[] = "clap.surround.draft/4";
 
 static CLAP_CONSTEXPR const char CLAP_PORT_SURROUND[] = "surround";