clap

commit 1dcc74499aca7e8d768b6bb4b04f3fc69eab165f
parent 9b58efd79bf3acc2c5d1851daf02daa92a7c3127
Author: Alexandre Bique <bique.alexandre@gmail.com>
Date:   Wed, 24 Apr 2024 10:43:12 +0200

rename to set_context_info_subscription()

Diffstat:
M
include/clap/ext/draft/undo.h
 | 
11
+++++++----

1 file changed, 7 insertions(+), 4 deletions(-)
diff --git a/include/clap/ext/draft/undo.h b/include/clap/ext/draft/undo.h
@@ -144,15 +144,18 @@ typedef struct clap_host_undo {
    void(CLAP_ABI *redo)(const clap_host_t *host);
 
    // Subscribes to or unsubscribes from undo context info.
-   // The plugin may only need the context info if its GUI is shown and it wants to display
-   // undo/redo info.
+   //
+   // This method helps reducing the number of calls the host has to perform when updating
+   // the undo context info. Consider a large project with 1000+ plugins, we don't want to
+   // call 1000+ times update, while the plugin may only need the context info if its GUI
+   // is shown and it wants to display undo/redo info.
    //
    // Initial state is unsubscribed.
    //
-   // wants_info: set to true to receive context info
+   // is_subscribed: set to true to receive context info
    //
    // [main-thread]
-   void(CLAP_ABI *set_wants_context_info)(const clap_host_t *host, bool wants_info);
+   void(CLAP_ABI *set_context_info_subscription)(const clap_host_t *host, bool is_subscribed);
 } clap_host_undo_t;
 
 #ifdef __cplusplus