diff options
author | Sébastien Helleu <flashcode@flashtux.org> | 2023-07-06 19:00:16 +0200 |
---|---|---|
committer | Sébastien Helleu <flashcode@flashtux.org> | 2023-07-08 13:28:40 +0200 |
commit | 66cb9f6ea2e534887e73c885d3f131710c48382d (patch) | |
tree | 1d21dafd605395a57078f9d82d8f525bad588bb6 /doc/fr | |
parent | 8f9d88edd0106c92daf1ce624638f037f7e8fe0d (diff) | |
download | weechat-66cb9f6ea2e534887e73c885d3f131710c48382d.zip |
core: add option type "enum" (closes #1973)
The type "enum" replaces type "integer" when used with string values.
For compatibility, any option created with type "integer" and string values is
automatically created to "enum" on creation, with no error.
Diffstat (limited to 'doc/fr')
-rw-r--r-- | doc/fr/weechat_plugin_api.fr.adoc | 196 | ||||
-rw-r--r-- | doc/fr/weechat_user.fr.adoc | 22 |
2 files changed, 158 insertions, 60 deletions
diff --git a/doc/fr/weechat_plugin_api.fr.adoc b/doc/fr/weechat_plugin_api.fr.adoc index d2a4b001b..df4e6b1ea 100644 --- a/doc/fr/weechat_plugin_api.fr.adoc +++ b/doc/fr/weechat_plugin_api.fr.adoc @@ -6995,7 +6995,7 @@ section = weechat.config_search_section(config_file, "section") ==== config_new_option -_Mis à jour dans la 1.5._ +_Mis à jour dans la 1.5, 4.1.0._ Créer une nouvelle option dans une section d'un fichier de configuration. @@ -7043,12 +7043,14 @@ Paramètres : "name << file.section.option" * _type_ : type de l'option : ** _boolean_ : valeur booléenne (on/off) -** _integer_ : valeur entière (avec en option une chaîne pour chaque valeur) +** _integer_ : valeur entière ** _string_ : une chaîne de caractères ** _color_ : une couleur +** _enum_ : liste de valeurs sous forme de chaînes (stocké comme nombre entier + en interne) * _description_ : description de l'option -* _string_values_ : valeurs sous forme de chaîne (séparées par `+|+`), utilisées - pour le type _integer_ (optionnel) +* _string_values_ : valeurs sous forme de chaîne (séparées par `+|+`) (optionnel, + requis pour le type _enum_) * _min_ : valeur minimum (pour le type _integer_) * _max_ : valeur maximum (pour le type _integer_) * _default_value_ : valeur par défaut de l'option (utilisée quand l'option est @@ -7103,8 +7105,8 @@ Exemple en C : [source,c] ---- /* booléen */ -struct t_config_option *option1 = - weechat_config_new_option (config_file, section, "option1", "boolean", +struct t_config_option *option1_bool = + weechat_config_new_option (config_file, section, "option_bool", "boolean", "Mon option, type booléen", NULL, 0, 0, @@ -7116,8 +7118,8 @@ struct t_config_option *option1 = NULL, NULL, NULL); /* entier */ -struct t_config_option *option2 = - weechat_config_new_option (config_file, section, "option2", "integer", +struct t_config_option *option_int = + weechat_config_new_option (config_file, section, "option_int", "integer", "Mon option, type entier", NULL, 0, 100, @@ -7128,23 +7130,9 @@ struct t_config_option *option2 = NULL, NULL, NULL, NULL, NULL, NULL); -/* entier (avec valeurs sous forme de chaînes) */ -struct t_config_option *option3 = - weechat_config_new_option (config_file, section, "option3", "integer", - "Mon option, type entier " - "(avec valeurs sous forme de chaînes)", - "top|bottom|left|right", - 0, 0, - "bottom", - "bottom", - 0, - NULL, NULL, NULL, - NULL, NULL, NULL, - NULL, NULL, NULL); - /* chaîne */ -struct t_config_option *option4 = - weechat_config_new_option (config_file, section, "option4", "string", +struct t_config_option *option_str = + weechat_config_new_option (config_file, section, "option_str", "string", "Mon option, type chaîne", NULL, 0, 0, @@ -7156,8 +7144,8 @@ struct t_config_option *option4 = NULL, NULL, NULL); /* couleur */ -struct t_config_option *option5 = - weechat_config_new_option (config_file, section, "option5", "color", +struct t_config_option *option_col = + weechat_config_new_option (config_file, section, "option_col", "color", "Mon option, type couleur", NULL, 0, 0, @@ -7167,6 +7155,19 @@ struct t_config_option *option5 = NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL); + +/* énuméré */ +struct t_config_option *option_enum = + weechat_config_new_option (config_file, section, "option_enum", "enum", + "Mon option, type énuméré", + "top|bottom|left|right", + 0, 0, + "bottom", + "bottom", + 0, + NULL, NULL, NULL, + NULL, NULL, NULL, + NULL, NULL, NULL); ---- Script (Python) : @@ -7182,52 +7183,52 @@ def config_new_option(config_file: str, section: str, name: str, type: str, desc callback_delete: str, callback_delete_data: str) -> str: ... # exemple -def option4_check_value_cb(data: str, option: str, value: str) -> int: +def option_str_check_value_cb(data: str, option: str, value: str) -> int: # ... return 1 # return 0 -def option4_change_cb(data: str, option: str) -> None: +def option_str_change_cb(data: str, option: str) -> None: # ... -def option4_delete_cb(data: str, option: str) -> None: +def option_str_delete_cb(data: str, option: str) -> None: # ... -option1 = weechat.config_new_option(config_file, section, "option1", "boolean", +option_bool = weechat.config_new_option(config_file, section, "option_bool", "boolean", "Mon option, type booléen", "", 0, 0, "on", "on", 0, "", "", "", "", "", "") -option2 = weechat.config_new_option(config_file, section, "option2", "integer", +option_int = weechat.config_new_option(config_file, section, "option_int", "integer", "Mon option, type entier", "", 0, 100, "15", "15", 0, "", "", "", "", "", "") -option3 = weechat.config_new_option(config_file, section, "option3", "integer", - "Mon option, type entier (avec valeurs sous forme de chaînes)", - "top|bottom|left|right", - 0, 0, "bottom", "bottom", 0, - "", "", - "", "", - "", "") - -option4 = weechat.config_new_option(config_file, section, "option4", "string", +option_str = weechat.config_new_option(config_file, section, "option_str", "string", "Mon option, type chaîne", "", 0, 0, "test", "test", 1, - "option4_check_value_cb", "", - "option4_change_cb", "", - "option4_delete_cb", "") + "option_str_check_value_cb", "", + "option_str_change_cb", "", + "option_str_delete_cb", "") -option5 = weechat.config_new_option(config_file, section, "option5", "color", +option_col = weechat.config_new_option(config_file, section, "option_col", "color", "Mon option, type couleur", "", 0, 0, "lightblue", "lightblue", 0, "", "", "", "", "", "") + +option_enum = weechat.config_new_option(config_file, section, "option_enum", "enum", + "Mon option, type énuméré", + "top|bottom|left|right", + 0, 0, "bottom", "bottom", 0, + "", "", + "", "", + "", "") ---- [NOTE] @@ -7512,7 +7513,7 @@ Paramètres : selon le type de l'option : ** _boolean_ : *** `toggle` : basculer la valeur courante -** _integer_ ou _color_ : +** _integer_, _color_ ou _enum_ : *** `++N` : ajouter `N` (un entier) à la valeur courante *** `--N` : soustraire `N` (un entier) de la valeur courante * _run_callback_ : 1 pour appeler la fonction de rappel si la valeur de @@ -7748,6 +7749,7 @@ Paramètres : *** _integer_ *** _string_ *** _color_ +*** _enum_ ** _description_ : description de l'option Valeur de retour : @@ -7924,6 +7926,7 @@ Valeur de retour, selon le type de l'option : * _integer_ : 0 * _string_ : 0 * _color_ : 0 +* _enum_ : 0 Exemple en C : @@ -7974,6 +7977,7 @@ Valeur de retour, selon le type de l'option : * _integer_ : 0 * _string_ : 0 * _color_ : 0 +* _enum_ : 0 Exemple en C : @@ -8024,6 +8028,7 @@ Valeur de retour, selon le type de l'option : * _integer_ : valeur entière de l'option * _string_ : 0 * _color_ : index de la couleur +* _enum_ : valeur entière de l'option (index de la valeur de l'énuméré) Exemple en C : @@ -8066,6 +8071,7 @@ Valeur de retour, selon le type de l'option : * _integer_ : valeur entière par défaut de l'option * _string_ : 0 * _color_ : index de la couleur par défaut +* _enum_ : valeur entière par défaut de l'option (index de la valeur de l'énuméré) Exemple en C : @@ -8105,10 +8111,10 @@ Paramètres : Valeur de retour, selon le type de l'option : * _boolean_ : "on" si la valeur est vraie, sinon "off" -* _integer_ : valeur de l'option sous forme de chaîne si l'option est un entier - avec des valeurs sous forme de chaînes, sinon NULL +* _integer_ : NULL * _string_ : valeur de l'option sous forme de chaîne * _color_ : nom de la couleur +* _enum_ : valeur de l'option sous forme de chaîne Exemple en C : @@ -8148,10 +8154,10 @@ Paramètres : Valeur de retour, selon le type de l'option : * _boolean_ : "on" si la valeur par défaut est vraie, sinon "off" -* _integer_ : valeur par défaut de l'option sous forme de chaîne si l'option - est un entier avec des valeurs sous forme de chaînes, sinon NULL +* _integer_ : NULL * _string_ : valeur par défaut de l'option sous forme de chaîne * _color_ : nom de la couleur par défaut +* _enum_ : valeur par défaut de l'option sous forme de chaîne Exemple en C : @@ -8194,6 +8200,7 @@ Valeur de retour, selon le type de l'option : * _integer_ : NULL * _string_ : NULL * _color_ : nom de la couleur +* _enum_ : NULL Exemple en C : @@ -8236,6 +8243,7 @@ Valeur de retour, selon le type de l'option : * _integer_ : NULL * _string_ : NULL * _color_ : nom de la couleur par défaut +* _enum_ : NULL Exemple en C : @@ -8257,6 +8265,96 @@ option = weechat.config_get("plugin.section.option") value = weechat.config_color_default(option) ---- +==== config_enum + +_WeeChat ≥ 4.1.0._ + +Retourner la valeur de l'option, sous forme d'entier. + +Prototype : + +[source,c] +---- +int weechat_config_enum (struct t_config_option *option); +---- + +Paramètres : + +* _option_ : pointeur vers l'option + +Valeur de retour, selon le type de l'option : + +* _boolean_ : valeur booléenne de l'option (0 ou 1) +* _integer_ : valeur entière de l'option +* _string_ : 0 +* _color_ : index de la couleur +* _enum_ : valeur entière de l'option (index de la valeur de l'énuméré) + +Exemple en C : + +[source,c] +---- +struct t_config_option *option = weechat_config_get ("plugin.section.option"); +int value = weechat_config_enum (option); +---- + +Script (Python) : + +[source,python] +---- +# prototype +def config_enum(option: str) -> int: ... + +# exemple +option = weechat.config_get("plugin.section.option") +value = weechat.config_enum(option) +---- + +==== config_enum_default + +_WeeChat ≥ 4.1.0._ + +Retourner la valeur par défaut de l'option, sous forme d'entier. + +Prototype : + +[source,c] +---- +int weechat_config_enum_default (struct t_config_option *option); +---- + +Paramètres : + +* _option_ : pointeur vers l'option + +Valeur de retour, selon le type de l'option : + +* _boolean_ : valeur booléenne par défaut de l'option (0 ou 1) +* _integer_ : valeur entière par défaut de l'option +* _string_ : 0 +* _color_ : index de la couleur par défaut +* _enum_ : valeur entière par défaut de l'option (index de la valeur de l'énuméré) + +Exemple en C : + +[source,c] +---- +struct t_config_option *option = weechat_config_get ("plugin.section.option"); +int value = weechat_config_enum_default (option); +---- + +Script (Python) : + +[source,python] +---- +# prototype +def config_enum_default(option: str) -> int: ... + +# example +option = weechat.config_get("plugin.section.option") +value = weechat.config_enum_default(option) +---- + ==== config_write_option Écrire une ligne dans le fichier de configuration avec l'option et sa valeur diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc index d38c28b12..830144b95 100644 --- a/doc/fr/weechat_user.fr.adoc +++ b/doc/fr/weechat_user.fr.adoc @@ -1747,8 +1747,8 @@ avec la touche kbd:[Alt+m] (commande : `+/mouse toggle+`). | kbd:[▼] | - | chat : tampon fset | Descendre de cinq lignes dans le tampon fset. | `+/fset -down 5+` | ◾◽◽ | - | chat : tampon fset | Sélectionner la ligne dans le tampon fset. | `+/window ${_window_number};/fset -go ${_chat_line_y}+` | ◽◽◾ | - | chat : tampon fset | Basculer le booléen (on/off) ou éditer la valeur de l'option. | `+hsignal:fset_mouse+` -| ◽◽◾ | left | chat : tampon fset | Décrémenter la valeur de l'entier/couleur, définir/ajouter à la valeur pour les autres types. | `+hsignal:fset_mouse+` -| ◽◽◾ | right | chat : tampon fset | Incrémenter la valeur de l'entier/couleur, définir/ajouter à la valeur pour les autres types. | `+hsignal:fset_mouse+` +| ◽◽◾ | left | chat : tampon fset | Décrémenter la valeur de l'entier/couleur/énuméré, définir/ajouter à la valeur pour les autres types. | `+hsignal:fset_mouse+` +| ◽◽◾ | right | chat : tampon fset | Incrémenter la valeur de l'entier/couleur/énuméré, définir/ajouter à la valeur pour les autres types. | `+hsignal:fset_mouse+` | ◽◽◾ | up / down | chat : tampon fset | Marquer/démarquer de multiples options. | `+hsignal:fset_mouse+` | kbd:[▲] | - | chat : tampon script | Monter de 5 lignes dans le tampon script. | `+/script up 5+` | kbd:[▼] | - | chat : tampon script | Descendre de 5 lignes dans le tampon script. | `+/script down 5+` @@ -1796,8 +1796,8 @@ Ces touches et actions sont utilisées sur le tampon fset | kbd:[F11] | `pass:[<]` | Faire défiler horizontalement vers la gauche. | `+/fset -left+` | kbd:[F12] | `pass:[>]` | Faire défiler horizontalement vers la droite. | `+/fset -right+` | kbd:[Alt+Space] | `t` | Basculer la valeur booléenne. | `+/fset -toggle+` -| kbd:[Alt+-] | `-` | Soustraire 1 de la valeur de l'entier/couleur, définir la valeur pour les autres types. | `+/fset -add -1+` -| kbd:[Alt++] | `+` | Ajouter 1 à la valeur de l'entier/couleur, ajouter à la valeur pour les autres types. | `+/fset -add 1+` +| kbd:[Alt+-] | `-` | Soustraire 1 de la valeur de l'entier/couleur/énuméré, définir la valeur pour les autres types. | `+/fset -add -1+` +| kbd:[Alt++] | `+` | Ajouter 1 à la valeur de l'entier/couleur/énuméré, ajouter à la valeur pour les autres types. | `+/fset -add 1+` | kbd:[Alt+f], kbd:[Alt+r] | `r` | Réinitialiser la valeur. | `+/fset -reset+` | kbd:[Alt+f], kbd:[Alt+u] | `u` | Supprimer/réinitialiser la valeur. | `+/fset -unset+` | kbd:[Alt+Enter] | `s` | Définir la valeur. | `+/fset -set+` @@ -1868,7 +1868,7 @@ Exemple de tampon fset affichant les options commençant par `weechat.look` : │2.fset │weechat.look.bare_display_exit_on_input: exit the bare display mode on any c│ │ │hanges in input [default: on] │ │ │----------------------------------------------------------------------------│ -│ │ weechat.look.align_end_of_lines integer message │ +│ │ weechat.look.align_end_of_lines enum message │ │ │ weechat.look.align_multiline_words boolean on │ │ │ weechat.look.bar_more_down string "++" │ │ │ weechat.look.bar_more_left string "<<" │ @@ -1877,12 +1877,12 @@ Exemple de tampon fset affichant les options commençant par `weechat.look` : │ │## weechat.look.bare_display_exit_on_input boolean on ##│ │ │ weechat.look.bare_display_time_format string "%H:%M" │ │ │ weechat.look.buffer_auto_renumber boolean on │ -│ │ weechat.look.buffer_notify_default integer all │ -│ │ weechat.look.buffer_position integer end │ +│ │ weechat.look.buffer_notify_default enum all │ +│ │ weechat.look.buffer_position enum end │ │ │ weechat.look.buffer_search_case_sensitive boolean off │ │ │ weechat.look.buffer_search_force_default boolean off │ │ │ weechat.look.buffer_search_regex boolean off │ -│ │ weechat.look.buffer_search_where integer prefix_message │ +│ │ weechat.look.buffer_search_where enum prefix_message │ │ │ weechat.look.buffer_time_format string "%H:%M:%S" │ │ │ weechat.look.buffer_time_same string "" │ │ │[12:55] [2] [fset] 2:fset │ @@ -3366,7 +3366,7 @@ irc.server.libera.autorejoin_delay integer null -> 30 irc.server.libera.away_check integer null -> 0 irc.server.libera.away_check_max_nicks integer null -> 25 irc.server.libera.capabilities string null -> "*" -irc.server.libera.charset_message integer null -> message +irc.server.libera.charset_message enum null -> message irc.server.libera.command string null -> "" irc.server.libera.command_delay integer null -> 0 irc.server.libera.connection_timeout integer null -> 60 @@ -3382,9 +3382,9 @@ irc.server.libera.notify string null -> "" irc.server.libera.password string null -> "" irc.server.libera.proxy string null -> "" irc.server.libera.realname string null -> "" -irc.server.libera.sasl_fail integer null -> reconnect +irc.server.libera.sasl_fail enum null -> reconnect irc.server.libera.sasl_key string null -> "" -irc.server.libera.sasl_mechanism integer null -> plain +irc.server.libera.sasl_mechanism enum null -> plain irc.server.libera.sasl_password string "${sec.data.libera}" irc.server.libera.sasl_timeout integer null -> 15 irc.server.libera.sasl_username string "alice" |