summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/en/weechat_plugin_api.en.adoc12
1 files changed, 11 insertions, 1 deletions
diff --git a/doc/en/weechat_plugin_api.en.adoc b/doc/en/weechat_plugin_api.en.adoc
index f0e0c1c20..f5a28c807 100644
--- a/doc/en/weechat_plugin_api.en.adoc
+++ b/doc/en/weechat_plugin_api.en.adoc
@@ -41,6 +41,15 @@ The plugin has to include "weechat-plugin.h" file (available in WeeChat source
code).
This file defines structures and types used to communicate with WeeChat.
+In order to call WeeChat functions in the format displayed in <<plugin_api>>,
+the following global pointer must be declared and initialized in
+<<_weechat_plugin_init,weechat_plugin_init>>:
+
+[source,C]
+----
+struct t_weechat_plugin *weechat_plugin;
+----
+
[[macros]]
=== Macros
@@ -83,7 +92,8 @@ int weechat_plugin_init (struct t_weechat_plugin *plugin,
Arguments:
-* _plugin_: pointer to WeeChat plugin structure
+* _plugin_: pointer to WeeChat plugin structure, used to initialize the
+ convenience global pointer `weechat_plugin`
* _argc_: number of arguments for plugin (given on command line by user)
* _argv_: arguments for plugin