doc: describe return code according to option type in config functions (plugin API reference)

1 files changed, 50 insertions, 16 deletions

diff --git a/doc/it/weechat_plugin_api.it.asciidoc b/doc/it/weechat_plugin_api.it.asciidoc
index 3734d896d..641303e62 100644
--- a/doc/it/weechat_plugin_api.it.asciidoc
+++ b/doc/it/weechat_plugin_api.it.asciidoc
@@ -5672,9 +5672,13 @@ Argomenti:
 
 * 'option': puntatore all'opzione
 
-Valore restituito:
+// TRANSLATION MISSING
+Return value, depending on the option type:
 
-* valore bool di un'opzione (0 o 1)
+* 'boolean': boolean value of option (0 or 1)
+* 'integer': 0
+* 'string': 0
+* 'color': 0
 
 Esempio in C:
 
@@ -5719,9 +5723,13 @@ Argomenti:
 
 * 'option': puntatore all'opzione
 
-Valore restituito:
+// TRANSLATION MISSING
+Return value, depending on the option type:
 
-* il valore bool predefinito di un'opzione (0 o 1)
+* 'boolean': default boolean value of option (0 or 1)
+* 'integer': 0
+* 'string': 0
+* 'color': 0
 
 Esempio in C:
 
@@ -5766,9 +5774,13 @@ Argomenti:
 
 * 'option': puntatore all'opzione
 
-Valore restituito:
+// TRANSLATION MISSING
+Return value, depending on the option type:
 
-* valore intero di un'opzione
+* 'boolean': boolean value of option (0 or 1)
+* 'integer': integer value of option
+* 'string': 0
+* 'color': color index
 
 Esempio in C:
 
@@ -5805,9 +5817,13 @@ Argomenti:
 
 * 'option': puntatore all'opzione
 
-Valore restituito:
+// TRANSLATION MISSING
+Return value, depending on the option type:
 
-* valore intero predefinito di un'opzione
+* 'boolean': default boolean value of option (0 or 1)
+* 'integer': default integer value of option
+* 'string': 0
+* 'color': default color index
 
 Esempio in C:
 
@@ -5844,9 +5860,14 @@ Argomenti:
 
 * 'option': puntatore all'opzione
 
-Valore restituito:
+// TRANSLATION MISSING
+Return value, depending on the option type:
 
-* valore stringa di un'opzione
+* 'boolean': "on" if value is true, otherwise "off"
+* 'integer': string value if the option is an integer with string values,
+  otherwise NULL
+* 'string': string value of option
+* 'color': name of color
 
 Esempio in C:
 
@@ -5883,9 +5904,14 @@ Argomenti:
 
 * 'option': puntatore all'opzione
 
-Valore restituito:
+// TRANSLATION MISSING
+Return value, depending on the option type:
 
-* valore stringa predefinito di un'opzione
+* 'boolean': "on" if default value is true, otherwise "off"
+* 'integer': default string value if the option is an integer with string
+  values, otherwise NULL
+* 'string': default string value of option
+* 'color': name of default color
 
 Esempio in C:
 
@@ -5922,9 +5948,13 @@ Argomenti:
 
 * 'option': puntatore all'opzione
 
-Valore restituito:
+// TRANSLATION MISSING
+Return value, depending on the option type:
 
-* valore colore dell'opzione (stringa con il nome del colore)
+* 'boolean': NULL
+* 'integer': NULL
+* 'string': NULL
+* 'color': name of color
 
 Esempio in C:
 
@@ -5961,9 +5991,13 @@ Argomenti:
 
 * 'option': puntatore all'opzione
 
-Valore restituito:
+// TRANSLATION MISSING
+Return value, depending on the option type:
 
-* valore colore predefinito di un'opzione (stringa con il nome del colore)
+* 'boolean': NULL
+* 'integer': NULL
+* 'string': NULL
+* 'color': name of default color
 
 Esempio in C: