summaryrefslogtreecommitdiff
path: root/doc/en/weechat_plugin_api.en.adoc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/en/weechat_plugin_api.en.adoc')
-rw-r--r--doc/en/weechat_plugin_api.en.adoc11
1 files changed, 10 insertions, 1 deletions
diff --git a/doc/en/weechat_plugin_api.en.adoc b/doc/en/weechat_plugin_api.en.adoc
index 642466188..fc440c6c2 100644
--- a/doc/en/weechat_plugin_api.en.adoc
+++ b/doc/en/weechat_plugin_api.en.adoc
@@ -4988,7 +4988,7 @@ Arguments:
* _name_: name of configuration file (without path or extension)
* _callback_reload_: function called when configuration file is reloaded with
- `/reload` (optional, can be NULL), arguments and return value:
+ `/reload` (optional, can be NULL, see below), arguments and return value:
** _const void *pointer_: pointer
** _void *data_: pointer
** _struct t_config_file *config_file_: configuration file pointer
@@ -5002,6 +5002,15 @@ Arguments:
WeeChat; if not NULL, it must have been allocated with malloc (or similar
function) and it is automatically freed when the configuration file is freed
+Reload callback:
+
+* The callback must only call the function <<_config_reload,config_reload>>,
+ it must not remove the configuration file.
+* A callback is needed only if it does some things before and/or after the
+ call to the function <<_config_reload,config_reload>>. +
+ If no callback is given, WeeChat will call its internal reload function,
+ so the configuration file will be reloaded in all cases.
+
Return value:
* pointer to new configuration file, NULL if an error occurred