From dc8a35796a1c47bf70e891d9728265590823d52f Mon Sep 17 00:00:00 2001
From: Trygve Aaberge <trygveaa@gmail.com>
Date: Sat, 22 Oct 2022 12:32:18 +0200
Subject: doc/api: Improve python example for config_new_section

This updates the Python examples to include all the possible return
values for the callbacks in config_new_section, like it is done in the C
example. It also aligns the order of the values with the C example.
---
 doc/sr/weechat_plugin_api.sr.adoc | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

(limited to 'doc/sr/weechat_plugin_api.sr.adoc')

diff --git a/doc/sr/weechat_plugin_api.sr.adoc b/doc/sr/weechat_plugin_api.sr.adoc
index 9c353049f..e14da7d95 100644
--- a/doc/sr/weechat_plugin_api.sr.adoc
+++ b/doc/sr/weechat_plugin_api.sr.adoc
@@ -6269,24 +6269,34 @@ def my_section_read_cb(data: str, config_file: str, section: str, option_name: s
     # ...
     return weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED
     # return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
-    # return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
     # return weechat.WEECHAT_CONFIG_OPTION_SET_ERROR
+    # return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
 
 def my_section_write_cb(data: str, config_file: str, section_name: str) -> int:
     # ...
     return weechat.WEECHAT_CONFIG_WRITE_OK
+    # return weechat.WEECHAT_CONFIG_WRITE_ERROR
+    # return weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR
 
 def my_section_write_default_cb(data: str, config_file: str, section_name: str) -> int:
     # ...
     return weechat.WEECHAT_CONFIG_WRITE_OK
+    # return weechat.WEECHAT_CONFIG_WRITE_ERROR
+    # return weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR
 
 def my_section_create_option_cb(data: str, config_file: str, section: str, option_name: str, value: str | None) -> int:
     # ...
-    return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
+    return weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED
+    # return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
+    # return weechat.WEECHAT_CONFIG_OPTION_SET_ERROR
+    # return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
 
 def my_section_delete_option_cb(data: str, config_file: str, section: str, option: str) -> int:
     # ...
     return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED
+    # return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET
+    # return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_RESET
+    # return weechat.WEECHAT_CONFIG_OPTION_UNSET_ERROR
 
 section = weechat.config_new_section(config_file, "section1", 1, 1,
     "my_section_read_cb", "",
-- 
cgit v1.2.3

