clap

commit 91235bb7cc74b5600bcb21475b16b8108286667e
parent 8d76d26a6b2722928bcbb21b3b4b998d7de9316f
Author: Alexandre Bique <bique.alexandre@gmail.com>
Date:   Thu, 22 Dec 2022 14:30:59 +0100

clarify when it is allowed to call get_extension()

Fixes #186

Diffstat:
M
ChangeLog.md
 | 
2
++
M
include/clap/host.h
 | 
2
++
M
include/clap/plugin.h
 | 
2
++

3 files changed, 6 insertions(+), 0 deletions(-)
diff --git a/ChangeLog.md b/ChangeLog.md
@@ -1,6 +1,8 @@
 # Changes in 1.1.5
 
 * [plugin.h](include/clap/plugin.h): clarify plugin state after init()
+* [plugin.h](include/clap/plugin.h): clarify when it is allowed to call get_extension()
+* [host.h](include/clap/host.h): clarify when it is allowed to call get_extension()
 
 # Changes in 1.1.4
 
diff --git a/include/clap/host.h b/include/clap/host.h
@@ -18,6 +18,8 @@ typedef struct clap_host {
    const char *version; // eg: "4.3"
 
    // Query an extension.
+   // It is forbidden to call it before plugin->init().
+   // You can call it within plugin->init() call, and after.
    // [thread-safe]
    const void *(CLAP_ABI *get_extension)(const struct clap_host *host, const char *extension_id);
 
diff --git a/include/clap/plugin.h b/include/clap/plugin.h
@@ -85,6 +85,8 @@ typedef struct clap_plugin {
 
    // Query an extension.
    // The returned pointer is owned by the plugin.
+   // It is forbidden to call it before plugin->init().
+   // You can call it within plugin->init() call, and after.
    // [thread-safe]
    const void *(CLAP_ABI *get_extension)(const struct clap_plugin *plugin, const char *id);