diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/en/weechat_plugin_api.en.adoc | 2 | ||||
| -rw-r--r-- | doc/fr/cmdline_options.fr.adoc | 4 | ||||
| -rw-r--r-- | doc/fr/weechat.1.fr.adoc | 10 | ||||
| -rw-r--r-- | doc/fr/weechat_dev.fr.adoc | 204 | ||||
| -rw-r--r-- | doc/fr/weechat_faq.fr.adoc | 212 | ||||
| -rw-r--r-- | doc/fr/weechat_plugin_api.fr.adoc | 5790 | ||||
| -rw-r--r-- | doc/fr/weechat_quickstart.fr.adoc | 100 | ||||
| -rw-r--r-- | doc/fr/weechat_relay_protocol.fr.adoc | 420 | ||||
| -rw-r--r-- | doc/fr/weechat_scripting.fr.adoc | 152 | ||||
| -rw-r--r-- | doc/fr/weechat_tester.fr.adoc | 32 | ||||
| -rw-r--r-- | doc/fr/weechat_user.fr.adoc | 724 | ||||
| -rw-r--r-- | doc/it/weechat_plugin_api.it.adoc | 2 | ||||
| -rw-r--r-- | doc/ja/weechat_plugin_api.ja.adoc | 2 |
13 files changed, 3827 insertions, 3827 deletions
diff --git a/doc/en/weechat_plugin_api.en.adoc b/doc/en/weechat_plugin_api.en.adoc index 14a248a59..5be4ab370 100644 --- a/doc/en/weechat_plugin_api.en.adoc +++ b/doc/en/weechat_plugin_api.en.adoc @@ -15388,7 +15388,7 @@ C example: struct t_gui_lines *own_lines; struct t_gui_line *line; -struct t_gui_line_data *line_data; +struct t_gui_line_data *line_data; struct t_hdata *hdata; struct t_hashtable *hashtable; char str_date[64]; diff --git a/doc/fr/cmdline_options.fr.adoc b/doc/fr/cmdline_options.fr.adoc index 0a5bf6aeb..b24fdbf71 100644 --- a/doc/fr/cmdline_options.fr.adoc +++ b/doc/fr/cmdline_options.fr.adoc @@ -7,8 +7,8 @@ *-d*, *--dir* _<répertoire>_:: Définir le répertoire comme étant la base de WeeChat (utilisé pour les fichiers de configuration, logs, extensions - et scripts de l'utilisateur), la valeur par défaut est "~/.weechat" (note : - le répertoire est créé s'il n'est pas trouvé par WeeChat). + et scripts de l'utilisateur), la valeur par défaut est "~/.weechat" + (note : le répertoire est créé s'il n'est pas trouvé par WeeChat). Si cette option n'est pas donnée, la variable d'environnement WEECHAT_HOME est utilisée (si non vide). diff --git a/doc/fr/weechat.1.fr.adoc b/doc/fr/weechat.1.fr.adoc index 1a8ee4a61..91906813f 100644 --- a/doc/fr/weechat.1.fr.adoc +++ b/doc/fr/weechat.1.fr.adoc @@ -36,16 +36,16 @@ consulter la documentation des extensions dans le https://weechat.org/doc[guide utilisateur de WeeChat]. Avec l'extension irc, vous pouvez vous connecter à un serveur de manière -temporaire avec une URL, comme ceci : +temporaire avec une URL, comme ceci : irc[6][s]://[[pseudo][:motdepasse]@]serveur[:port][/#canal1[,#canal2...]] -Pour rejoindre le canal IRC de support WeeChat avec le pseudo "monpseudo" : +Pour rejoindre le canal IRC de support WeeChat avec le pseudo "monpseudo" : irc://monpseudo@chat.freenode.net/#weechat Les adresses IPv6 peuvent être entourées par des crochets pour ajouter un port -après, par exemple : +après, par exemple : irc://monpseudo@[2001:db8:0:85a3::ac1f:8001]:6668/#test @@ -111,8 +111,8 @@ choix) toute version ultérieure. Merci de consulter le fichier COPYING pour plus d'informations. -Site web : https://weechat.org/ +Site web : https://weechat.org/ == SUPPORT / SIGNALER DES BUGS -Pour de l'aide ou signaler un bug : https://weechat.org/dev/support +Pour de l'aide ou signaler un bug : https://weechat.org/dev/support diff --git a/doc/fr/weechat_dev.fr.adoc b/doc/fr/weechat_dev.fr.adoc index e2766dfd2..f5173d6e4 100644 --- a/doc/fr/weechat_dev.fr.adoc +++ b/doc/fr/weechat_dev.fr.adoc @@ -12,7 +12,7 @@ Ce manuel documente le client de messagerie instantanée WeeChat, il fait partie de WeeChat. -La dernière version de ce document peut être téléchargée sur cette page : +La dernière version de ce document peut être téléchargée sur cette page : https://weechat.org/doc @@ -22,7 +22,7 @@ https://weechat.org/doc WeeChat (Wee Enhanced Environment for Chat) est un client de discussion libre, rapide et léger, conçu pour différents systèmes d'exploitation. -Ce manuel documente l'intérieur de WeeChat : +Ce manuel documente l'intérieur de WeeChat : * dépôts * règles de développement @@ -33,10 +33,10 @@ Ce manuel documente l'intérieur de WeeChat : [[repositories]] == Dépôts -Les dépôts de WeeChat sont dans l'organisation "weechat" de GitHub : +Les dépôts de WeeChat sont dans l'organisation "weechat" de GitHub : https://github.com/weechat -Liste des dépôts : +Liste des dépôts : weechat:: dépôt principal avec le code source et la documentation @@ -45,7 +45,7 @@ scripts:: les scripts _officiels_ soumis sur weechat.org weechat.org:: - le code source du site de WeeChat : https://weechat.org/ + le code source du site de WeeChat : https://weechat.org/ weercd:: serveur de test IRC @@ -58,13 +58,13 @@ Ce manuel documente seulement le dépôt _weechat_. [[overview]] === Vue d'ensemble -Les répertoires principaux de WeeChat sont : +Les répertoires principaux de WeeChat sont : [width="100%",cols="1m,3",options="header"] |=== | Répertoire | Description | src/ | Racine des sources. -| core/ | Fonctions du cœur : point d'entrée, structures internes. +| core/ | Fonctions du cœur : point d'entrée, structures internes. | gui/ | Fonctions pour les tampons, fenêtres, ... (utilisées par toutes les interfaces). | curses/ | Interface Curses. | plugins/ | API extension/script. @@ -100,15 +100,15 @@ Les répertoires principaux de WeeChat sont : [[sources_core]] ==== Cœur -Le cœur de WeeChat est situé dans les répertoires suivants : +Le cœur de WeeChat est situé dans les répertoires suivants : -* _src/core/_ : fonctions du cœur (pour manipuler des données) -* _src/gui/_ : fonctions pour l'interface (tampons, fenêtres, ...) +* _src/core/_ : fonctions du cœur (pour manipuler des données) +* _src/gui/_ : fonctions pour l'interface (tampons, fenêtres, ...) [width="100%",cols="1m,3",options="header"] |=== | Chemin/fichier | Description -| core/ | Fonctions du cœur : point d'entrée, structures internes. +| core/ | Fonctions du cœur : point d'entrée, structures internes. | wee-arraylist.c | Listes avec tableau (« arraylists »). | wee-backtrace.c | Afficher une trace après un plantage. | wee-command.c | Commandes du cœur de WeeChat. @@ -134,7 +134,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants : | wee-utf8.c | Fonctions UTF-8. | wee-util.c | Quelques autres fonctions utilitaires. | wee-version.c | Fonctions pour la version de WeeChat. -| weechat.c | Fonctions principales : options de ligne de commande, démarrage. +| weechat.c | Fonctions principales : options de ligne de commande, démarrage. | gui/ | Fonctions pour les tampons, fenêtres, ... (utilisées par toutes les interfaces). | gui-bar-item.c | Objets de barre. | gui-bar-window.c | Fenêtres de barre. @@ -179,7 +179,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants : | plugin-api.c | Fonctions supplémentaires pour l'API extension (enveloppes autour des fonctions du cœur de WeeChat). | plugin-config.c | Options de configuration des extensions (fichier plugins.conf). | plugin-script.c | Fonctions communes utilisés par les extensions pour les scripts. -| plugin-script-api.c | Fonctions pour l'API script : enveloppes autour de quelques fonctions de l'API extension. +| plugin-script-api.c | Fonctions pour l'API script : enveloppes autour de quelques fonctions de l'API extension. | weechat-plugin.h | En-tête destiné à être distribué avec les extensions WeeChat, pour les compiler. | alias/ | Extension Alias. | alias.c | Fonctions principales pour les alias. @@ -321,22 +321,22 @@ Le cœur de WeeChat est situé dans les répertoires suivants : | tests.cpp | Programme utilisé pour lancer les tests. | unit/ | Racine des tests unitaires. | core/ | Racine des tests unitaires pour le cœur. -| test-arraylist.cpp | Tests : listes avec tableau (« arraylists »). -| test-eval.cpp | Tests : évaluation d'expressions. -| test-hashtble.cpp | Tests : tables de hachage. -| test-hdata.cpp | Tests : hdata. -| test-infolist.cpp | Tests : infolists. -| test-list.cpp | Tests : listes. -| test-string.cpp | Tests : chaînes. -| test-url.cpp | Tests : URLs. -| test-utf8.cpp | Tests : UTF-8. -| test-util.cpp | Tests : fonctions utiles. +| test-arraylist.cpp | Tests : listes avec tableau (« arraylists »). +| test-eval.cpp | Tests : évaluation d'expressions. +| test-hashtble.cpp | Tests : tables de hachage. +| test-hdata.cpp | Tests : hdata. +| test-infolist.cpp | Tests : infolists. +| test-list.cpp | Tests : listes. +| test-string.cpp | Tests : chaînes. +| test-url.cpp | Tests : URLs. +| test-utf8.cpp | Tests : UTF-8. +| test-util.cpp | Tests : fonctions utiles. |=== [[documentation_translations]] === Documentation / traductions -Fichiers de documentation : +Fichiers de documentation : [width="100%",cols="1m,3",options="header"] |=== @@ -344,7 +344,7 @@ Fichiers de documentation : | doc/ | Documentation. | docinfo.html | Style Asciidoctor. | docgen.py | Script Python pour construire les fichiers dans le répertoire _autogen/_ (voir ci-dessous). -| XX/ | Documentation pour la langue XX (langues : en, fr, de, it, ...). +| XX/ | Documentation pour la langue XX (langues : en, fr, de, it, ...). | cmdline_options.XX.adoc | Options de ligne de commande (fichier inclus dans la page de manuel et le guide utilisateur). | weechat.1.XX.adoc | Page de manuel (`man weechat`). | weechat_dev.XX.adoc | Guide du développeur (ce document). @@ -361,7 +361,7 @@ Fichiers de documentation : |=== Les traductions pour WeeChat et les extensions sont effectuées avec gettext, les -fichiers sont dans le répertoire _po/_ : +fichiers sont dans le répertoire _po/_ : [width="100%",cols="1m,3",options="header"] |=== @@ -379,14 +379,14 @@ fichiers sont dans le répertoire _po/_ : * Dans le code source, vos commentaires, noms de variables, ... doivent être écrits en anglais *uniquement* (aucune autre langue n'est autorisée). -* Utilisez un en-tête de copyright dans chaque nouveau fichier source avec : +* Utilisez un en-tête de copyright dans chaque nouveau fichier source avec : ** une brève description du fichier (une seule ligne), ** la date, ** le nom, ** l'e-mail, ** la licence. -Exemple en C : +Exemple en C : [source,C] ---- @@ -415,7 +415,7 @@ Exemple en C : [[coding_c_style]] === Style C -Quelques règles basiques que vous *devez* suivre quand vous écrivez du code C : +Quelques règles basiques que vous *devez* suivre quand vous écrivez du code C : * Utilisez 4 espaces pour l'indentation. N'utilisez pas de tabulations, c'est le mal. @@ -427,7 +427,7 @@ Quelques règles basiques que vous *devez* suivre quand vous écrivez du code C (utilisez toujours un commentaire multi-lignes, même si la description est très courte). -Exemple : +Exemple : [source,C] ---- @@ -457,10 +457,10 @@ foo () ---- * Utilisez des noms de variable explicites, par exemple "nicks_count" au lieu de - "n" ou "nc". Exception : dans les boucles `for`, où les variables comme "i" ou + "n" ou "nc". Exception : dans les boucles `for`, où les variables comme "i" ou "n" sont OK. * Initialisez les variables locales après la déclaration, dans le corps de la - fonction, exemple : + fonction, exemple : [source,C] ---- @@ -480,7 +480,7 @@ foo () au lieu de `+x + y * z+`. * Disposez les accolades `+{ }+` seules sur la ligne, et indentez les avec le nombre d'espaces utilisés sur la ligne au dessus de l'accolade ouvrante (le - `if` dans l'exemple) : + `if` dans l'exemple) : [source,C] ---- @@ -491,7 +491,7 @@ if (nicks_count == 1) ---- * Utilisez des lignes vides pour séparer différents blocs dans les fonctions, et - si possible ajoutez un commentaire pour chacun, comme ceci : + si possible ajoutez un commentaire pour chacun, comme ceci : [source,C] ---- @@ -535,7 +535,7 @@ irc_server_outqueue_send (struct t_irc_server *server) * Indentez les conditions `if`, et utilisez des parenthèses autour des conditions avec un opérateur (pas nécessaire pour un booléen simple), comme - ceci : + ceci : [source,C] ---- @@ -559,7 +559,7 @@ else } ---- -* Indentez les `switch` comme ceci : +* Indentez les `switch` comme ceci : [source,C] ---- @@ -578,7 +578,7 @@ switch (string[0]) ---- * Utilisez `typedef` pur les prototypes de fonctions mais pas pour les - structures : + structures : [source,C] ---- @@ -601,7 +601,7 @@ new_hook_fd = malloc (sizeof (*new_hook_fd)); ---- * Ce code Lisp peut être utilisé dans votre _~/.emacs.el_ pour indenter - correctement si vous utilisez l'éditeur de texte Emacs : + correctement si vous utilisez l'éditeur de texte Emacs : [source,lisp] ---- @@ -628,14 +628,14 @@ Voir http://www.python.org/dev/peps/pep-0008/ [[naming_convention_files]] ==== Fichiers -Les noms de fichiers sont composés de lettres et tirets, avec le format : +Les noms de fichiers sont composés de lettres et tirets, avec le format : _xxx-yyyyy.[ch]_, où _xxx_ est le répertoire/composant (peut être une abréviation) et _yyyyy_ un nom pour le fichier. Le fichier principal d'un répertoire peut avoir le même nom que le répertoire, par exemple _irc.c_ pour l'extension irc. -Exemples : +Exemples : [width="100%",cols="1m,3",options="header"] |=== @@ -654,13 +654,13 @@ exemple _wee-command.h_ pour le fichier _wee-command.c_. [[naming_convention_structures]] ==== Structures -Les structures ont le nom _t_X_Y_ ou _t_X_Y_Z_ : +Les structures ont le nom _t_X_Y_ ou _t_X_Y_Z_ : -* _X_ : répertoire/composant (peut être une abréviation) -* _Y_ : fin du nom de fichier -* _Z_ : nom de la structure (facultatif) +* _X_ : répertoire/composant (peut être une abréviation) +* _Y_ : fin du nom de fichier +* _Z_ : nom de la structure (facultatif) -Exemple : un pseudo IRC (de _src/plugins/irc/irc-nick.h_) : +Exemple : un pseudo IRC (de _src/plugins/irc/irc-nick.h_) : [source,C] ---- @@ -681,16 +681,16 @@ struct t_irc_nick [[naming_convention_variables]] ==== Variables -Les variables globales (en dehors des fonctions) ont le nom _X_Y_Z_ : +Les variables globales (en dehors des fonctions) ont le nom _X_Y_Z_ : -* _X_ : répertoire/composant (peut être une abréviation) -* _Y_ : fin du nom de fichier -* _Z_ : nom de la variable +* _X_ : répertoire/composant (peut être une abréviation) +* _Y_ : fin du nom de fichier +* _Z_ : nom de la variable -Exception : pour les variables des derniers éléments d'une liste, le nom est +Exception : pour les variables des derniers éléments d'une liste, le nom est _last_X_ (où _X_ est le nom de la variable, en utilisant le singulier). -Exemple : fenêtres (de _src/gui/gui-window.c_) : +Exemple : fenêtres (de _src/gui/gui-window.c_) : [source,C] ---- @@ -702,7 +702,7 @@ struct t_gui_window *gui_current_window = NULL; /* current window */ Il n'y a pas de convention pour les variables locales (dans les fonctions). La seule recommandation est que le nom soit explicite (et pas trop court). + Cependant, les pointeurs vers les structures sont souvent nommés _ptr_xxxx_, par -exemple un pointeur sur _struct t_gui_buffer *_ sera : _*ptr_buffer_. +exemple un pointeur sur _struct t_gui_buffer *_ sera : _*ptr_buffer_. [[naming_convention_functions]] ==== Fonctions @@ -710,7 +710,7 @@ exemple un pointeur sur _struct t_gui_buffer *_ sera : _*ptr_buffer_. La convention pour les noms des fonctions est le même que celui des <<naming_convention_variables,variables>>. -Exemple : création d'une nouvelle fenêtre (de _src/gui/gui-window.c_) : +Exemple : création d'une nouvelle fenêtre (de _src/gui/gui-window.c_) : [source,C] ---- @@ -745,10 +745,10 @@ avec un "callback". [[doubly_linked_lists]] === Listes doublement chaînées -La plupart des listes chaînes WeeChat sont doublement chaînées : chaque nœud a +La plupart des listes chaînes WeeChat sont doublement chaînées : chaque nœud a un pointeur vers le nœud précédent/suivant. -Exemple : liste des tampons (de _src/gui/gui-buffer.h_) : +Exemple : liste des tampons (de _src/gui/gui-buffer.h_) : [source,C] ---- @@ -763,7 +763,7 @@ struct t_gui_buffer }; ---- -Et les deux pointeurs vers la tête et la fin de liste : +Et les deux pointeurs vers la tête et la fin de liste : [source,C] ---- @@ -778,37 +778,37 @@ WeeChat utilise ses propres codes couleur dans les chaînes pour afficher les attributs (gras, souligné, ...) et les couleurs à l'écran. Tous les attributs/couleurs sont préfixés par un caractère dans la chaîne, qui -peuvent être : +peuvent être : -* _0x19_ : code couleur (suivi par un/des code(s) couleur) -* _0x1A_ : activer un attribut (suivi par un attribut sur un caractère) -* _0x1B_ : supprimer un attribut (suivi par un attribut sur un caractère) -* _0x1C_ : réinitialiser (rien après) +* _0x19_ : code couleur (suivi par un/des code(s) couleur) +* _0x1A_ : activer un attribut (suivi par un attribut sur un caractère) +* _0x1B_ : supprimer un attribut (suivi par un attribut sur un caractère) +* _0x1C_ : réinitialiser (rien après) -Les attributs autorisés sont (un ou plusieurs caractères) : +Les attributs autorisés sont (un ou plusieurs caractères) : -* `+*+` : gras -* `+!+` : vidéo inverse -* `+/+` : italique -* `+_+` : souligné -* `+|+` : garder les attributs +* `+*+` : gras +* `+!+` : vidéo inverse +* `+/+` : italique +* `+_+` : souligné +* `+|+` : garder les attributs -Les couleurs possibles sont : +Les couleurs possibles sont : -* couleur standard : attributs facultatifs + nombre sur 2 digits -* couleur étendue : `+@+` + attributs facultatifs + nombre sur 5 digits +* couleur standard : attributs facultatifs + nombre sur 2 digits +* couleur étendue : `+@+` + attributs facultatifs + nombre sur 5 digits -Dans le tableau qui suit, les conventions suivantes sont utilisées : +Dans le tableau qui suit, les conventions suivantes sont utilisées : -* `STD` : couleur standard (2 digits) -* `(A)STD` : couleur standard avec des attributs facultatifs +* `STD` : couleur standard (2 digits) +* `(A)STD` : couleur standard avec des attributs facultatifs (attributs + 2 digits) -* `EXT` : couleur étendue (`+@+` + 5 digits) -* `(A)EXT` : couleur étendue avec des attributs facultatifs +* `EXT` : couleur étendue (`+@+` + 5 digits) +* `(A)EXT` : couleur étendue avec des attributs facultatifs (`+@+` + attributs + 5 digits) -* `ATTR` : un caractère d'attribut (`+*+`, `+!+`, `+/+`, `+_+` ou `+|+`) +* `ATTR` : un caractère d'attribut (`+*+`, `+!+`, `+/+`, `+_+` ou `+|+`) -Toutes les combinaisons sont résumées dans ce tableau : +Toutes les combinaisons sont résumées dans ce tableau : [width="100%",cols="4,2,2,8",options="header"] |=== @@ -841,7 +841,7 @@ Toutes les combinaisons sont résumées dans ce tableau : |=== Les codes couleur utilisant des options (voir _t_gui_color_enum_, dans le -fichier _src/gui/gui-color.h_) : +fichier _src/gui/gui-color.h_) : [width="70%",cols="^1m,10",options="header"] |=== @@ -893,7 +893,7 @@ fichier _src/gui/gui-color.h_) : | 44 | weechat.color.chat_value_null _(WeeChat ≥ 1.4)_ |=== -Les couleurs WeeChat sont : +Les couleurs WeeChat sont : [width="70%",cols="^1m,10",options="header"] |=== @@ -917,7 +917,7 @@ Les couleurs WeeChat sont : | 16 | Blanc |=== -Exemples de codes couleur : +Exemples de codes couleur : [width="70%",cols="1,2",options="header"] |=== @@ -945,7 +945,7 @@ WeeChat. Et puis des macros sont utilisées pour appeler ces fonctions. Par exemple, la fonction _hook_timer_ est définie dans la structure -_t_weechat_plugin_ comme ceci : +_t_weechat_plugin_ comme ceci : [source,C] ---- @@ -958,7 +958,7 @@ struct t_hook *(*hook_timer) (struct t_weechat_plugin *plugin, void *callback_data); ---- -Et la macro utilisée pour appeler cette fonction est : +Et la macro utilisée pour appeler cette fonction est : [source,C] ---- @@ -969,7 +969,7 @@ Et la macro utilisée pour appeler cette fonction est : __callback, __data) ---- -Donc dans une extension, l'appel à cette fonction sera par exemple : +Donc dans une extension, l'appel à cette fonction sera par exemple : [source,C] ---- @@ -985,42 +985,42 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000, [[git_repository]] === Dépôt Git -Le dépôt Git est à cette URL : https://github.com/weechat/weechat +Le dépôt Git est à cette URL : https://github.com/weechat/weechat Tout patch pour un bug ou une nouvelle fonctionnalité doit être effectué sur la branche master, le format préféré étant une "pull request" sur GitHub. Un patch peut aussi être envoyé par e-mail (fait avec `git diff` ou `git format-patch`). -Le format du message de commit est le suivant (pour fermer un bug GitHub) : +Le format du message de commit est le suivant (pour fermer un bug GitHub) : ---- component: fix a problem (closes #123) ---- -Pour un bug Savannah : +Pour un bug Savannah : ---- component: fix a problem (bug #12345) ---- -Où _component_ est : +Où _component_ est : -* pour le cœur WeeChat : _core_ (les fichiers dans le répertoire racine, _po/_ +* pour le cœur WeeChat : _core_ (les fichiers dans le répertoire racine, _po/_ et _src/_, sauf _src/plugins/_) -* fichiers de documentation : _doc_ (fichiers dans le répertoire _doc/_) -* nom d'une extension : _irc_, _python_, _relay_, ... (fichiers dans le +* fichiers de documentation : _doc_ (fichiers dans le répertoire _doc/_) +* nom d'une extension : _irc_, _python_, _relay_, ... (fichiers dans le répertoire _src/plugins/_) -Quelques règles à suivre : +Quelques règles à suivre : * Utilisez seulement l'anglais. * Utilisez des verbes à l'infinitif. * Si le commit est relatif au tracker, écrivez-le entre parenthèses après le - message, avec ce format : -** GitHub : closes #123 -** Savannah : bug #12345, task #12345, patch #12345 + message, avec ce format : +** GitHub : closes #123 +** Savannah : bug #12345, task #12345, patch #12345 -Exemples de messages de commit : +Exemples de messages de commit : ---- irc: add command /unquiet (closes #36) @@ -1041,7 +1041,7 @@ Les fichiers gettext sont dans le répertoire _po/_. Si vous souhaitez initialiser une nouvelle langue, utilisez la commande `msginit`. Par exemple pour créer un fichier qui est prêt à traduire en -néerlandais : +néerlandais : ---- $ cd po @@ -1052,7 +1052,7 @@ La langue de base pour WeeChat est l'anglais, donc vous devez évidemment comprendre parfaitement l'anglais pour traduire vers votre langue. Une fois terminé, vous *devez* vérifier votre fichier avec le script -_msgcheck.py_ (https://github.com/flashcode/msgcheck) : +_msgcheck.py_ (https://github.com/flashcode/msgcheck) : ---- $ msgcheck.py xx.po @@ -1067,14 +1067,14 @@ par le script _doc/docgen.py_. Copiez ce script python dans votre répertoire python (par exemple _~/.weechat/python_). Vous pouvez alors charger le script dans votre WeeChat, et configurer le chemin -vers votre répertoire _/doc_ : +vers votre répertoire _/doc_ : ---- /python load docgen.py /set plugins.var.python.docgen.path "~/src/weechat/doc" ---- -Créez alors cet alias pour construire les fichiers : +Créez alors cet alias pour construire les fichiers : ---- /alias add doc /perl unload; /python unload; /ruby unload; /lua unload; /tcl unload; /guile unload; /javascript unload; /python load docgen.py; /wait 1ms /docgen @@ -1097,14 +1097,14 @@ Les fichiers Asciidoc donc dans le répertoire _doc/XX/_ où _XX_ est la langue Faites d'abord une copie du fichier asciidoc en anglais (dans le répertoire _doc/en/_), puis travaillez dessus. -Les traductions manquantes dans les fichiers sont indiquées par cette chaîne : +Les traductions manquantes dans les fichiers sont indiquées par cette chaîne : ---- // TRANSLATION MISSING ---- Vous devez traduire tout le fichier sauf les liens et les mots-clés spéciaux -pour les notes, avertissements, ... Ces mots doivent être gardés tels quels : +pour les notes, avertissements, ... Ces mots doivent être gardés tels quels : ---- [[link_name]] @@ -1117,7 +1117,7 @@ pour les notes, avertissements, ... Ces mots doivent être gardés tels quels : [CAUTION] ---- -Lorsqu'il y a un nom après `<<link_name>>`, alors vous devez le traduire : +Lorsqu'il y a un nom après `<<link_name>>`, alors vous devez le traduire : ---- <<link_name,ce texte doit être traduit>> diff --git a/doc/fr/weechat_faq.fr.adoc b/doc/fr/weechat_faq.fr.adoc index 5c856ed8b..85f79e8e6 100644 --- a/doc/fr/weechat_faq.fr.adoc +++ b/doc/fr/weechat_faq.fr.adoc @@ -30,7 +30,7 @@ mais elle ne s'applique pas à WeeChat !). Parce que WeeChat est très léger et apporte des fonctionnalités innovantes. -Plus d'infos sur cette page : https://weechat.org/about/features +Plus d'infos sur cette page : https://weechat.org/about/features [[compilation_install]] == Compilation / installation @@ -39,7 +39,7 @@ Plus d'infos sur cette page : https://weechat.org/about/features === J'ai entendu parler de plusieurs interfaces pour WeeChat. Comment puis-je les compiler/utiliser ? Des interfaces distantes sont disponibles, voir les liens sur la page des -fonctionnalités : https://weechat.org/about/features +fonctionnalités : https://weechat.org/about/features [[compile_git]] === Je ne peux pas compiler WeeChat après avoir cloné la base git, pourquoi ? @@ -59,13 +59,13 @@ mises à jour. === Comment puis-je installer WeeChat sous OS X ? Il est recommandé d'utiliser http://brew.sh/[Homebrew], vous pouvez avoir de -l'aide avec : +l'aide avec : ---- brew info weechat ---- -Vous pouvez installer WeeChat avec cette commande : +Vous pouvez installer WeeChat avec cette commande : ---- brew install weechat --with-aspell --with-curl --with-python --with-perl --with-ruby --with-lua --with-guile @@ -78,7 +78,7 @@ Pour obtenir de l'aide tapez `/help`. Pour de l'aide sur une commande, tapez `/help commande`. Les touches et commandes sont listées dans la documentation. Il est recommandé pour les nouveaux utilisateurs de lire le guide de démarrage -rapide : https://weechat.org/doc +rapide : https://weechat.org/doc [[display]] == Affichage @@ -87,10 +87,10 @@ rapide : https://weechat.org/doc === Je ne vois pas bien certains accents dans WeeChat, que faire ? C'est un problème courant, merci de lire attentivement et vérifier *TOUS* les -points ci-dessous : +points ci-dessous : -* Vérifiez que weechat est lié avec libncursesw (attention : nécessaire - sur beaucoup de distributions, mais pas toutes) : +* Vérifiez que weechat est lié avec libncursesw (attention : nécessaire + sur beaucoup de distributions, mais pas toutes) : `ldd /chemin/vers/weechat`. * Vérifiez que l'extension "charset" est chargée avec la commande `/plugin` (s'il ne l'est pas, vous devez peut-être installer le paquet @@ -99,9 +99,9 @@ points ci-dessous : devriez voir _ISO-XXXXXX_ ou _UTF-8_ pour le charset du terminal. Si vous voyez _ANSI_X3.4-1968_ ou d'autres valeurs, votre locale est probablement erronée (corrigez votre $LANG). -* Affectez la valeur pour le décodage global, par exemple : +* Affectez la valeur pour le décodage global, par exemple : `/set charset.default.decode "ISO-8859-15"`. -* Si vous utilisez la locale UTF-8 : +* Si vous utilisez la locale UTF-8 : ** Vérifiez que votre terminal est compatible UTF-8 (un terminal conseillé pour l'UTF-8 est rxvt-unicode). ** Si vous utilisez screen, vérifiez qu'il est lancé en mode UTF-8 @@ -121,10 +121,10 @@ Cela peut être causé par un bug de la libc dans la fonction _wcwidth_ et devrait être corrigé dans la glibc 2.22 (peut-être pas encore disponible dans votre distribution). -Il y a un moyen de contournement pour utiliser la fonction _wcwidth_ corrigée : +Il y a un moyen de contournement pour utiliser la fonction _wcwidth_ corrigée : https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat -Voir ce rapport de bug pour plus d'informations : +Voir ce rapport de bug pour plus d'informations : https://github.com/weechat/weechat/issues/79 [[bars_background]] @@ -133,16 +133,16 @@ https://github.com/weechat/weechat/issues/79 Cela peut être du à la variable TERM qui n'a pas la bonne valeur (regardez la sortie de `echo $TERM` dans votre terminal). -Selon la façon de lancer WeeChat, vous devriez avoir : +Selon la façon de lancer WeeChat, vous devriez avoir : -* Si WeeChat tourne en local ou sur une machine distante sans screen ni tmux : - cela dépend du terminal utilisé : _xterm_, _xterm-256color_, _rxvt-unicode_, +* Si WeeChat tourne en local ou sur une machine distante sans screen ni tmux : + cela dépend du terminal utilisé : _xterm_, _xterm-256color_, _rxvt-unicode_, _rxvt-256color_, etc... * Si WeeChat tourne sous screen, vous devriez avoir _screen_ ou _screen-256color_. * Si WeeChat tourne sous tmux, vous devriez avoir _tmux_, _tmux-256color_, _screen_ ou _screen-256color_. -Si besoin, corrigez la variable TERM : `export TERM="xxx"`. +Si besoin, corrigez la variable TERM : `export TERM="xxx"`. [[screen_weird_chars]] === Quand j'utilise weechat sous screen/tmux, j'ai des caractères bizarres et aléatoires, comment corriger ça ? @@ -153,7 +153,7 @@ sortie de `echo $TERM` dans votre terminal, *en dehors de screen/tmux*). Par exemple _xterm-color_ provoque ce genre de problèmes, utilisez _xterm_ qui est ok (comme plein d'autres valeurs). -Si besoin, corrigez la variable TERM : `export TERM="xxx"`. +Si besoin, corrigez la variable TERM : `export TERM="xxx"`. [[osx_display_broken]] === J'ai compilé WeeChat sous OS X, et je vois des "(null)" partout sur l'écran, pourquoi ? @@ -180,30 +180,30 @@ aucune fenêtre) ou affiché par une ou plusieurs fenêtres. [[buffers_list]] === Comment afficher la liste des tampons sur la gauche ? -Utilisez le script _buffers.pl_ : +Utilisez le script _buffers.pl_ : ---- /script install buffers.pl ---- -Pour limiter la taille de la barre : +Pour limiter la taille de la barre : ---- /set weechat.bar.buffers.size_max 15 ---- -Pour déplacer la barre en bas : +Pour déplacer la barre en bas : ---- /set weechat.bar.buffers.position bottom ---- -Pour faire défiler la barre : si la souris est activée (touche : kbd:[Alt+m]), +Pour faire défiler la barre : si la souris est activée (touche : kbd:[Alt+m]), vous pouvez faire défiler avec la roulette de votre souris. Ou vous pouvez définir des touches, comme les touches déjà existantes pour faire défiler la liste de pseudos. -Par exemple pour utiliser kbd:[F1], kbd:[F2], kbd:[Alt+F1] et kbd:[Alt+F2] : +Par exemple pour utiliser kbd:[F1], kbd:[F2], kbd:[Alt+F1] et kbd:[Alt+F2] : ---- /key bind meta-OP /bar scroll buffers * -100% @@ -219,13 +219,13 @@ Pour trouver le code de la touche appuyez sur kbd:[Alt+k] puis la touche. [[customize_prefix]] === Comment puis-je réduire la longueur des pseudos ou supprimer l'alignement des pseudos dans la zone de discussion ? -Pour réduire la longueur maximum des pseudos dans la zone de discussion : +Pour réduire la longueur maximum des pseudos dans la zone de discussion : ---- /set weechat.look.prefix_align_max 15 ---- -Pour supprimer l'alignement sur les pseudos : +Pour supprimer l'alignement sur les pseudos : ---- /set weechat.look.prefix_align none @@ -235,23 +235,23 @@ Pour supprimer l'alignement sur les pseudos : === Que signifie [H: 3(1,8), 2(4)] dans la barre de statut ? Il s'agit de la "hotlist", une liste de tampons avec le nombre de messages non -lus, par ordre : highlights, messages privés, messages, autres messages +lus, par ordre : highlights, messages privés, messages, autres messages (comme join/part). + Le nombre de "messages non lus" est le nombre de nouveaux messages affichés/reçus depuis que vous avez visité le tampon. -Dans l'exemple `[H: 3(1,8), 2(4)]`, il y a : +Dans l'exemple `[H: 3(1,8), 2(4)]`, il y a : * un highlight et 8 messages non lus sur le tampon n°3, * 4 messages non lus sur le tampon n°2. La couleur du tampon/compter dépend du type de message, les couleurs par défaut -sont : +sont : -* highlight : `lightmagenta` / `magenta` -* message privé : `lightgreen` / `green` -* message : `yellow` / `brown` -* autre message : `default` / `default` (couleur du texte dans le terminal) +* highlight : `lightmagenta` / `magenta` +* message privé : `lightgreen` / `green` +* message : `yellow` / `brown` +* autre message : `default` / `default` (couleur du texte dans le terminal) Ces couleurs peuvent être changées via les options __weechat.color.status_data_*__ (tampons) et __weechat.color.status_count_*__ (compteurs). + @@ -269,13 +269,13 @@ L'option _size_ dans la barre input peut être définie à une valeur supérieur dynamique, et alors l'option _size_max_ définira la taille maximum (0 = pas de limite). -Exemple avec une taille dynamique : +Exemple avec une taille dynamique : ---- /set weechat.bar.input.size 0 ---- -Taille maximum de 2 : +Taille maximum de 2 : ---- /set weechat.bar.input.size_max 2 @@ -287,7 +287,7 @@ Taille maximum de 2 : Oui, vous devez créer une barre de type "root" (avec un objet pour savoir dans quelle fenêtre vous êtes), puis supprimer la barre input courante. -Par exemple : +Par exemple : ---- /bar add rootinput root bottom 1 0 [buffer_name]+[input_prompt]+(away),[input_search],[input_paste],input_text @@ -296,7 +296,7 @@ Par exemple : Si jamais vous n'étiez pas satisfait avec ça, supprimez simplement la nouvelle barre, WeeChat recréera automatiquement la barre par défaut "input" si l'objet -"input_text" n'est utilisé dans aucune barre : +"input_text" n'est utilisé dans aucune barre : ---- /bar del rootinput @@ -306,14 +306,14 @@ barre, WeeChat recréera automatiquement la barre par défaut "input" si l'objet === Comment puis-je copier/coller du texte sans coller la liste des pseudos ? Avec WeeChat ≥ 1.0, vous pouvez utiliser l'affichage dépouillé (touche par -défaut : kbd:[Alt+l]). +défaut : kbd:[Alt+l]). Vous pouvez utiliser un terminal qui propose la sélection rectangulaire (comme rxvt-unicode, konsole, gnome-terminal, etc...). La touche est habituellement kbd:[Ctrl] + kbd:[Alt] + sélection à la souris. Une autre solution est de déplacer la liste des pseudos en haut ou en bas, par -exemple : +exemple : ---- /set weechat.bar.nicklist.position top @@ -323,12 +323,12 @@ exemple : === Comment puis-je cliquer sur les longs URLs (plus d'une ligne) ? Avec WeeChat ≥ 1.0, vous pouvez utiliser l'affichage dépouillé (touche par -défaut : kbd:[Alt+l]). +défaut : kbd:[Alt+l]). Par défaut, WeeChat affiche l'heure et un préfixe pour chaque ligne avec des barres optionnelles autour de la zone de discussion. Pour rendre la le clic d'URL plus facile, vous pouvez déplacer la liste des pseudos en haut et -supprimer l'alignement sur les pseudos : +supprimer l'alignement sur les pseudos : ---- /set weechat.bar.nicklist.position top @@ -338,7 +338,7 @@ supprimer l'alignement sur les pseudos : Avec WeeChat ≥ 0.3.6, vous pouvez activer l'option "eat_newline_glitch", pour éviter qu'un caractère de nouvelle ligne soit affiché après chaque ligne (donc -cela ne cassera pas la sélection d'une URL) : +cela ne cassera pas la sélection d'une URL) : ---- /set weechat.look.eat_newline_glitch on @@ -348,7 +348,7 @@ cela ne cassera pas la sélection d'une URL) : Cette option peut causer des problèmes d'affichage. Si vous rencontrez de tels problèmes, vous devez désactiver cette option. -Une autre solution est d'utiliser un script : +Une autre solution est d'utiliser un script : ---- /script search url @@ -357,14 +357,14 @@ Une autre solution est d'utiliser un script : [[change_locale_without_quit]] === Je souhaite changer la langue des messages affichés par WeeChat, mais sans quitter WeeChat, est-ce possible ? -Oui, avec WeeChat ≥ 1.0 : +Oui, avec WeeChat ≥ 1.0 : ---- /set env LANG fr_FR.UTF-8 /upgrade ---- -Avec un ancien WeeChat : +Avec un ancien WeeChat : ---- /script install shell.py @@ -378,11 +378,11 @@ Avec un ancien WeeChat : Les 256 couleurs sont supportées avec WeeChat ≥ 0.3.4. Premièrement vérifiez que votre variable d'environnement _TERM_ est correcte, -les valeurs recommandées sont : +les valeurs recommandées sont : -* sous screen : _screen-256color_ -* sous tmux : _screen-256color_ ou _tmux-256color_ -* en dehors de screen/tmux : _xterm-256color_, _rxvt-256color_, +* sous screen : _screen-256color_ +* sous tmux : _screen-256color_ ou _tmux-256color_ +* en dehors de screen/tmux : _xterm-256color_, _rxvt-256color_, _putty-256color_, ... [NOTE] @@ -390,14 +390,14 @@ Vous devrez peut-être installer le paquet "ncurses-term" pour utiliser ces valeurs dans la variable _TERM_. Si vous utilisez screen, vous pouvez ajouter cette ligne dans votre -_~/.screenrc_ : +_~/.screenrc_ : ---- term screen-256color ---- Si votre variable _TERM_ a une valeur erronée et que WeeChat est déjà lancé, -vous pouvez la changer avec ces deux commandes (avec WeeChat ≥ 1.0) : +vous pouvez la changer avec ces deux commandes (avec WeeChat ≥ 1.0) : ---- /set env TERM screen-256color @@ -408,7 +408,7 @@ Pour la version 0.3.4, vous devez utiliser la commande `/color` pour ajouter des nouvelles couleurs. Pour les versions ≥ 0.3.5, vous pouvez utiliser un numéro de couleur dans les -options (facultatif : vous pouvez ajouter des alias de couleurs avec la commande +options (facultatif : vous pouvez ajouter des alias de couleurs avec la commande `/color`). Merci de lire le guide utilisateur pour plus d'information sur la gestion des @@ -417,8 +417,8 @@ couleurs. [[search_text]] === Comment puis-je chercher du texte dans le tampon (comme /lastlog dans irssi) ? -La touche par défaut est kbd:[Ctrl+r] (la commande est : `/input search_text_here`). -Et sauter aux highlights : kbd:[Alt+p] / kbd:[Alt+n]. +La touche par défaut est kbd:[Ctrl+r] (la commande est : `/input search_text_here`). +Et sauter aux highlights : kbd:[Alt+p] / kbd:[Alt+n]. Voir le guide utilisateur pour plus d'information sur cette fonctionnalité (raccourcis clavier par défaut). @@ -429,19 +429,19 @@ Voir le guide utilisateur pour plus d'information sur cette fonctionnalité Vous devez activer les évènements du focus avec un code spécial envoyé au terminal. -*Important* : +*Important* : * Actuellement, *seulement* _xterm_ semble supporter cette fonctionnalité. * Cela ne fonctionne *pas* sous screen/tmux. -Pour envoyer le code au démarrage de WeeChat : +Pour envoyer le code au démarrage de WeeChat : ---- /set weechat.startup.command_after_plugins "/print -stdout \033[?1004h\n" ---- Puis associez deux touches pour le focus (remplacez les commandes `/print` par -les commandes de votre choix) : +les commandes de votre choix) : ---- /key bind meta2-I /print -core focus @@ -454,7 +454,7 @@ les commandes de votre choix) : Cela est causé par l'option "bracketed paste" qui est activée par défaut, et pas correctement gérée par screen dans les autres fenêtres. -Vous pouvez simplement désactiver le mode "bracketed paste" : +Vous pouvez simplement désactiver le mode "bracketed paste" : ---- /set weechat.look.paste_bracketed off @@ -468,13 +468,13 @@ Vous pouvez simplement désactiver le mode "bracketed paste" : Si vous utilisez certains terminaux comme xterm ou uxterm, quelques touches meta ne fonctionnent pas par défaut. Vous pouvez ajouter cette ligne dans le -fichier _~/.Xresources_ : +fichier _~/.Xresources_ : -* Pour xterm : +* Pour xterm : ---- XTerm*metaSendsEscape: true ---- -* Pour uxterm : +* Pour uxterm : ---- UXTerm*metaSendsEscape: true ---- @@ -495,7 +495,7 @@ l'inclure dans la ligne de commande. La touche est kbd:[Alt+j] puis 2 chiffres, par exemple kbd:[Alt+j], kbd:[1], kbd:[1] pour sauter au tampon 11. -Vous pouvez définir une touche, par exemple : +Vous pouvez définir une touche, par exemple : ---- /key bind meta-q /buffer *11 @@ -509,7 +509,7 @@ La liste des touches par défaut est dans le Guide utilisateur. Vous pouvez assigner les touches haut et bas sur l'historique global (les touches par défaut pour l'historique global sont kbd:[Ctrl+↑] et kbd:[Ctrl+↓]). -Exemple : +Exemple : ---- /key bind meta2-A /input history_global_previous @@ -528,7 +528,7 @@ Pour trouver le code de la touche appuyez sur kbd:[Alt+k] puis la touche. La souris est supportée avec WeeChat ≥ 0.3.6. -Premièrement essayez d'activer la souris : +Premièrement essayez d'activer la souris : ---- /mouse enable @@ -538,7 +538,7 @@ Si la souris ne fonctionne toujours pas, vérifiez la variable TERM dans votre shell (regardez la sortie de `echo $TERM` dans votre terminal). Selon le terminfo utilisé, la souris peut ne pas être supportée. -Vous pouvez tester le support de la souris dans le terminal : +Vous pouvez tester le support de la souris dans le terminal : ---- $ printf '\033[?1002h' @@ -547,7 +547,7 @@ $ printf '\033[?1002h' Et cliquez sur le premier caractère du terminal (en haut à gauche). Vous devriez voir " !!#!!". -Pour désactiver la souris dans le terminal : +Pour désactiver la souris dans le terminal : ---- $ printf '\033[?1002l' @@ -578,7 +578,7 @@ kbd:[Alt] au lieu de kbd:[Shift]). Si vous utilisez Mac OS X, vous devez installer `openssl` depuis Homebrew. Un fichier CA sera installé avec le le trousseau système. Vous pouvez alors -définie le chemin vers les certificats sous WeeChat : +définie le chemin vers les certificats sous WeeChat : ---- /set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem" @@ -586,21 +586,21 @@ définie le chemin vers les certificats sous WeeChat : Si vous voyez des erreurs à propos de la poignée de main gnutls ("handshake"), vous pouvez utiliser une valeur plus petite pour la clé Diffie-Hellman (par -défaut 2048) : +défaut 2048) : ---- /set irc.server.example.ssl_dhkey_size 1024 ---- Si vous voyez des erreurs à propos du certificat, vous pouvez désactiver -"ssl_verify" (attention, la connexion sera moins sûre en faisant cela) : +"ssl_verify" (attention, la connexion sera moins sûre en faisant cela) : ---- /set irc.server.example.ssl_verify off ---- Si le serveur a un certificat invalide et que vous savez ce que devrait être -le certificat, vous pouvez spécifier l'empreinte (SHA-512, SHA-256 ou SHA-1) : +le certificat, vous pouvez spécifier l'empreinte (SHA-512, SHA-256 ou SHA-1) : ---- /set irc.server.example.ssl_fingerprint 0c06e399d3c3597511dc8550848bfd2a502f0ce19883b728b73f6b7e8604243b @@ -610,7 +610,7 @@ le certificat, vous pouvez spécifier l'empreinte (SHA-512, SHA-256 ou SHA-1) : === Lors de la connexion SSL à un serveur, je vois juste une erreur "TLS handshake failed", que puis-je faire ? Vous pouvez essayer une chaîne de priorité différente (WeeChat ≥ 0.3.5 -seulement), remplacez "xxx" par le nom de votre serveur : +seulement), remplacez "xxx" par le nom de votre serveur : ---- /set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT" @@ -620,7 +620,7 @@ seulement), remplacez "xxx" par le nom de votre serveur : === Comment puis-je me connecter à freenode avec SSL ? Positionnez l'option _weechat.network.gnutls_ca_file_ avec le fichier des -certificats : +certificats : ---- /set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt" @@ -630,7 +630,7 @@ certificats : Vérifiez que vous avez bien ce fichier (fourni généralement par le paquet "ca-certificates"). -Configurez le port du serveur, SSL, puis connectez-vous : +Configurez le port du serveur, SSL, puis connectez-vous : ---- /set irc.server.freenode.addresses "chat.freenode.net/7000" @@ -646,7 +646,7 @@ Des serveurs tels que _twitch_ requièrent oauth pour se connecter. L'oauth est simplement un mot de passe avec la valeur "oauth:XXXX". Vous pouvez ajouter un tel serveur et vous y connecter avec les commandes -suivantes (remplacez le nom et l'adresse par les valeurs appropriées) : +suivantes (remplacez le nom et l'adresse par les valeurs appropriées) : ---- /server add nom irc.server.org -password=oauth:XXXX @@ -657,7 +657,7 @@ suivantes (remplacez le nom et l'adresse par les valeurs appropriées) : === Comment puis-je être identifié avant de rejoindre les canaux ? Si le serveur supporte SASL, vous devriez l'utiliser au lieu d'envoyer une -commande pour l'authentification avec nickserv, par exemple : +commande pour l'authentification avec nickserv, par exemple : ---- /set irc.server.freenode.sasl_username "mynick" @@ -665,7 +665,7 @@ commande pour l'authentification avec nickserv, par exemple : ---- Si le serveur ne supporte pas SASL, vous pouvez ajouter un délai (entre la -commande et le join des canaux) : +commande et le join des canaux) : ---- /set irc.server.freenode.command_delay 5 @@ -693,21 +693,21 @@ active/désactive les filtres). === Comment puis-je filtrer les messages join/part/quit sur les canaux IRC ? Avec le filtre intelligent (pour garder les join/part/quit des utilisateurs qui -ont parlé récemment) : +ont parlé récemment) : ---- /set irc.look.smart_filter on /filter add irc_smart * irc_smart_filter * ---- -Avec un filtre global (pour cacher *tous* les join/part/quit) : +Avec un filtre global (pour cacher *tous* les join/part/quit) : ---- /filter add joinquit * irc_join,irc_part,irc_quit * ---- [NOTE] -Pour l'aide : `/help filter` et `/help irc.look.smart_filter` +Pour l'aide : `/help filter` et `/help irc.look.smart_filter` [[filter_irc_join_channel_messages]] === Comment puis-je filtrer certains messages affichés quand je rejoins un canal IRC ? @@ -731,14 +731,14 @@ voice pour montrer les utilisateurs absents, et vous recevez plein de messages voice. Par conséquent, vous pouvez changer cela et laisser WeeChat utiliser une couleur spéciale pour les pseudos absents dans la liste des pseudos. -Pour Bitlbee ≥ 3, faites ceci sur le canal _&bitlbee_ : +Pour Bitlbee ≥ 3, faites ceci sur le canal _&bitlbee_ : ---- channel set show_users online,away ---- Pour une version plus ancienne de Bitlbee, faites ceci sur le canal -_&bitlbee_ : +_&bitlbee_ : ---- set away_devoice false @@ -749,7 +749,7 @@ Pour vérifier les pseudos absents dans WeeChat, voir la question à propos des Si vous voulez vraiment filtrer les messages voice, vous pouvez utiliser cette commande, mais elle n'est pas parfaite (elle fonctionne seulement si le -premier mode changé est voice) : +premier mode changé est voice) : ---- /filter add hidevoices * irc_mode (\+|\-)v @@ -765,7 +765,7 @@ Vous pouvez aussi positionner l'option _irc.server_default.away_check_max_nicks_ pour limiter la vérification d'absence sur les petits canaux seulement. Par exemple, pour vérifier les pseudos absents toutes les 5 minutes, pour les -canaux avec maximum 25 pseudos : +canaux avec maximum 25 pseudos : ---- /set irc.server_default.away_check 5 @@ -784,7 +784,7 @@ un highlight ou un message privé. Par conséquent vous pouvez configurer votre terminal (ou multiplexeur comme screen/tmux) pour lancer une commande ou jouer un son lorsque le _BEL_ se produit. -Ou vous pouvez ajouter une commande dans le trigger "beep" : +Ou vous pouvez ajouter une commande dans le trigger "beep" : ---- /set trigger.trigger.beep.command "/print -beep;/exec -bg /chemin/vers/commande paramètres" @@ -793,13 +793,13 @@ Ou vous pouvez ajouter une commande dans le trigger "beep" : Avec un WeeChat plus ancien, vous pouvez utiliser un script comme _beep.pl_ ou _launcher.pl_. -Pour _launcher.pl_, vous devez configurer la commande : +Pour _launcher.pl_, vous devez configurer la commande : ---- /set plugins.var.perl.launcher.signal.weechat_highlight "/chemin/vers/commande paramètres" ---- -Autres scripts sur ce sujet : +Autres scripts sur ce sujet : ---- /script search notify @@ -808,7 +808,7 @@ Autres scripts sur ce sujet : [[irc_target_buffer]] === Comment puis-je changer le serveur cible pour les commandes avec des tampons mélangés (comme le tampon avec les serveurs) ? -La touche par défaut est kbd:[Ctrl+x] (la commande est : +La touche par défaut est kbd:[Ctrl+x] (la commande est : `/input switch_active_buffer`). [[plugins_scripts]] @@ -820,7 +820,7 @@ La touche par défaut est kbd:[Ctrl+x] (la commande est : Sous OpenBSD, le nom des extensions se termine par ".so.0.0" (".so" sous Linux). -Vous devez configurer ça : +Vous devez configurer ça : ---- /set weechat.plugin.extension ".so.0.0" @@ -843,7 +843,7 @@ Les scripts ne sont pas compatibles avec d'autres clients IRC. Vous pouvez, mais ce n'est *PAS* recommandé. -La commande `/set` dans WeeChat est recommandée : +La commande `/set` dans WeeChat est recommandée : * Vous pouvez compléter la valeur avec la touche Tab. * La valeur est vérifiée, un message est affiché en cas d'erreur. @@ -851,7 +851,7 @@ La commande `/set` dans WeeChat est recommandée : quoi que ce soit. Si vous souhaitez quand même éditer les fichiers à la main, vous devez faire -attention : +attention : * Si vous mettez une valeur invalide pour une option, WeeChat affichera une erreur au chargement et ne tiendra pas compte de la valeur (la valeur par @@ -862,15 +862,15 @@ attention : [[memory_usage]] === Comment configurer WeeChat pour consommer moins de mémoire ? -Vous pouvez essayer les astuces suivantes pour consommer moins de mémoire : +Vous pouvez essayer les astuces suivantes pour consommer moins de mémoire : * Utiliser la dernière version stable (elle est supposée avoir moins de fuites de mémoire que les versions plus anciennes). -* Ne pas charger les extensions si vous ne les utilisez pas, par exemple : +* Ne pas charger les extensions si vous ne les utilisez pas, par exemple : aspell, fifo, logger, perl, python, ruby, lua, tcl, guile, javascript, xfer (utilisé pour les DCC). * Charger uniquement les scripts dont vous avez vraiment besoin. -* Ne pas charger les certificats si SSL n'est *PAS* utilisé : affecter une +* Ne pas charger les certificats si SSL n'est *PAS* utilisé : affecter une chaîne vide pour l'option _weechat.network.gnutls_ca_file_. * Réduire la valeur de l'option _weechat.history.max_buffer_lines_number_ ou affecter une valeur à l'option _weechat.history.max_buffer_lines_minutes_. @@ -880,27 +880,27 @@ Vous pouvez essayer les astuces suivantes pour consommer moins de mémoire : === Comment configurer WeeChat pour moins utiliser le processeur ? Vous pouvez suivre les mêmes astuces que pour la <<memory_usage,mémoire>>, et -celles-ci : +celles-ci : -* Cacher la barre "nicklist" : `/bar hide nicklist`. -* Supprimer l'affichage des secondes dans l'heure de la barre de statut : +* Cacher la barre "nicklist" : `/bar hide nicklist`. +* Supprimer l'affichage des secondes dans l'heure de la barre de statut : `/set weechat.look.item_time_format "%H:%M"` (ceci est la valeur par défaut). * Désactiver la vérification en temps réel des mots mal orthographiés dans la - ligne de commande (si vous l'avez activée) : `/set aspell.check.real_time off`. -* Définir la variable _TZ_ (par exemple : `export TZ="Europe/Paris"`), pour + ligne de commande (si vous l'avez activée) : `/set aspell.check.real_time off`. +* Définir la variable _TZ_ (par exemple : `export TZ="Europe/Paris"`), pour éviter un accès fréquent au fichier _/etc/localtime_. [[security]] === Je suis paranoïaque sur la sécurité, quels paramètres puis-je changer pour être encore plus sûr ? -Désactivez les messages de part et quit IRC : +Désactivez les messages de part et quit IRC : ---- /set irc.server_default.msg_part "" /set irc.server_default.msg_quit "" ---- -Désactivez les réponses à toutes les demandes CTCP : +Désactivez les réponses à toutes les demandes CTCP : ---- /set irc.ctcp.clientinfo "" @@ -913,7 +913,7 @@ Désactivez les réponses à toutes les demandes CTCP : ---- Déchargez et désactivez le chargement automatique de l'extension "xfer" -(utilisée pour le DCC IRC) : +(utilisée pour le DCC IRC) : ---- /plugin unload xfer @@ -921,11 +921,11 @@ Déchargez et désactivez le chargement automatique de l'extension "xfer" ---- Définissez une phrase de chiffrement et utilisez les données sécurisées partout -où vous le pouvez pour les données sensibles comme les mots de passe : voir +où vous le pouvez pour les données sensibles comme les mots de passe : voir `/help secure` et `/help` sur les options (si vous pouvez utiliser les données sécurisées, cela est mentionné dans l'aide). -Par exemple : +Par exemple : ---- /secure passphrase xxxxxxxxxx @@ -941,12 +941,12 @@ Par exemple : [[bug_task_patch]] === Comment puis-je reporter un bug, demander une nouvelle fonctionnalité ou envoyer un patch ? -Voir : https://weechat.org/dev/support +Voir : https://weechat.org/dev/support [[gdb_error_threads]] === Quand je lance WeeChat sous gdb, il y a une erreur à propos des threads, que puis-je faire ? -Quand vous lancez WeeChat sous gdb, vous pouvez avoir cette erreur : +Quand vous lancez WeeChat sous gdb, vous pouvez avoir cette erreur : ---- $ gdb /path/to/weechat @@ -956,7 +956,7 @@ Cannot find new threads: generic error ---- Pour corriger ça, vous pouvez lancer gdb avec cette commande (remplacez le -chemin vers libpthread et WeeChat avec les chemins sur votre système) : +chemin vers libpthread et WeeChat avec les chemins sur votre système) : ---- $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat @@ -966,7 +966,7 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat [[supported_os]] === Quelle est la liste des plates-formes supportées par WeeChat ? Sera-t-il porté sur d'autres systèmes d'exploitation ? -La liste complète est sur cette page : https://weechat.org/download +La liste complète est sur cette page : https://weechat.org/download Nous faisons le maximum pour supporter le plus de plates-formes possible. Toute aide est la bienvenue pour les systèmes que nous n'avons pas, pour y @@ -978,7 +978,7 @@ tester WeeChat. Il y a plusieurs choses à faire (test, code, documentation, etc...) Merci de prendre contact avec nous par IRC ou mail, consultez la page -support : https://weechat.org/dev/support +support : https://weechat.org/dev/support [[donate]] === Puis-je donner de l'argent ou d'autres choses aux développeurs WeeChat ? diff --git a/doc/fr/weechat_plugin_api.fr.adoc b/doc/fr/weechat_plugin_api.fr.adoc index b00af996b..16a1658ba 100644 --- a/doc/fr/weechat_plugin_api.fr.adoc +++ b/doc/fr/weechat_plugin_api.fr.adoc @@ -13,7 +13,7 @@ Ce manuel documente le client de messagerie instantanée WeeChat, il fait partie de WeeChat. -La dernière version de ce document peut être téléchargée sur cette page : +La dernière version de ce document peut être téléchargée sur cette page : https://weechat.org/doc @@ -47,7 +47,7 @@ WeeChat. [[macros]] === Macros -L'extension doit utiliser des macros (pour définir quelques variables) : +L'extension doit utiliser des macros (pour définir quelques variables) : WEECHAT_PLUGIN_NAME("name"):: nom de l'extension @@ -67,7 +67,7 @@ WEECHAT_PLUGIN_PRIORITY(1000):: [[main_functions]] === Fonctions principales -L'extension doit utiliser deux fonctions : +L'extension doit utiliser deux fonctions : * weechat_plugin_init * weechat_plugin_end @@ -76,7 +76,7 @@ L'extension doit utiliser deux fonctions : Cette fonction est appelée quand l'extension est chargée par WeeChat. -Prototype : +Prototype : [source,C] ---- @@ -84,14 +84,14 @@ int weechat_plugin_init (struct t_weechat_plugin *plugin, int argc, char *argv[]); ---- -Paramètres : +Paramètres : -* _plugin_ : pointeur vers la structure d'extension WeeChat -* _argc_ : nombre de paramètres pour l'extension (donnés sur la ligne de +* _plugin_ : pointeur vers la structure d'extension WeeChat +* _argc_ : nombre de paramètres pour l'extension (donnés sur la ligne de commande par l'utilisateur) -* _argv_ : paramètres pour l'extension +* _argv_ : paramètres pour l'extension -Valeur de retour : +Valeur de retour : * _WEECHAT_RC_OK_ si ok (l'extension sera chargée) * _WEECHAT_RC_ERROR_ si erreur (l'extension ne sera PAS chargée) @@ -107,7 +107,7 @@ Une grande priorité signifie que la fonction _init_ est appelée en premier. La priorité par défaut est 1000 (avec une telle priorité, l'extension est chargée après toutes les extensions par défaut). -Les extensions par défaut de WeeChat sont initialisées dans cet ordre : +Les extensions par défaut de WeeChat sont initialisées dans cet ordre : include::autogen/plugin_api/plugins_priority.adoc[] @@ -115,18 +115,18 @@ include::autogen/plugin_api/plugins_priority.adoc[] Cette fonction est appelée quand l'extension est déchargée par WeeChat. -Prototype : +Prototype : [source,C] ---- int weechat_plugin_end (struct t_weechat_plugin *plugin); ---- -Paramètres : +Paramètres : -* _plugin_ : pointeur vers la structure d'extension WeeChat +* _plugin_ : pointeur vers la structure d'extension WeeChat -Valeur de retour : +Valeur de retour : * _WEECHAT_RC_OK_ si ok * _WEECHAT_RC_ERROR_ si erreur @@ -137,7 +137,7 @@ Valeur de retour : La compilation ne nécessite pas les sources de WeeChat, seul le fichier _weechat-plugin.h_ est requis. -Pour compiler l'extension qui n'a qu'un fichier "toto.c" (sous GNU/Linux) : +Pour compiler l'extension qui n'a qu'un fichier "toto.c" (sous GNU/Linux) : ---- $ gcc -fPIC -Wall -c toto.c @@ -151,7 +151,7 @@ Copiez le fichier _libtoto.so_ dans le répertoire système des extensions (par exemple _/usr/local/lib/weechat/plugins_) ou dans le répertoire utilisateur des extensions (par exemple _/home/xxx/.weechat/plugins_). -Sous WeeChat : +Sous WeeChat : ---- /plugin load toto @@ -160,9 +160,9 @@ Sous WeeChat : [[plugin_example]] === Exemple d'extension -Exemple complet d'extension, qui ajoute une commande `/double` : affiche deux +Exemple complet d'extension, qui ajoute une commande `/double` : affiche deux fois les paramètres sur le tampon courant, ou exécute deux fois une commande -(ok ce n'est pas très utile, mais c'est juste un exemple !) : +(ok ce n'est pas très utile, mais c'est juste un exemple !) : [source,C] ---- @@ -210,8 +210,8 @@ weechat_plugin_init (struct t_weechat_plugin *plugin, "Affiche deux fois un message " "ou exécute deux fois une commande", "message | commande", - "message : message à afficher deux fois\n" - "commande : commande à exécuter deux fois", + "message : message à afficher deux fois\n" + "commande : commande à exécuter deux fois", NULL, &commande_double_cb, NULL, NULL); @@ -234,7 +234,7 @@ weechat_plugin_end (struct t_weechat_plugin *plugin) Les chapitres ci-dessous décrivent les fonctions de l'API, classées par catégorie. -Pour chaque fonction, on donne : +Pour chaque fonction, on donne : * une description de la fonction, * le prototype en C, @@ -253,30 +253,30 @@ Fonctions pour obtenir des informations sur les extensions. Retourner le nom d'une extension. -Prototype : +Prototype : [source,C] ---- const char *weechat_plugin_get_name (struct t_weechat_plugin *plugin); ---- -Paramètres : +Paramètres : -* _plugin_ : pointeur vers la structure d'extension WeeChat (peut être NULL) +* _plugin_ : pointeur vers la structure d'extension WeeChat (peut être NULL) -Valeur de retour : +Valeur de retour : * nom de l'extension, "core" pour le cœur de WeeChat (si le pointeur vers l'extension est NULL) -Exemple en C : +Exemple en C : [source,C] ---- const char *name = weechat_plugin_get_name (plugin); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -301,25 +301,25 @@ Définir le nouveau jeu de caractères (le jeu de caractères par défaut est _UTF-8_, donc si votre extension utilise _UTF-8_, vous n'avez pas besoin d'appeler cette fonction). -Prototype : +Prototype : [source,C] ---- void weechat_charset_set (const char *charset); ---- -Paramètres : +Paramètres : -* _charset_ : nouveau jeu de caractères à utiliser +* _charset_ : nouveau jeu de caractères à utiliser -Exemple en C : +Exemple en C : [source,C] ---- weechat_charset_set ("iso-8859-1"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -334,32 +334,32 @@ weechat.charset_set("iso-8859-1") Convertir une chaîne vers le jeu de caractères interne (UTF-8). -Prototype : +Prototype : [source,C] ---- char *weechat_iconv_to_internal (const char *charset, const char *string); ---- -Paramètres : +Paramètres : -* _charset_ : jeu de caractères à convertir -* _string_ : chaîne à convertir +* _charset_ : jeu de caractères à convertir +* _string_ : chaîne à convertir -Valeur de retour : +Valeur de retour : * chaîne convertie (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- -char *str = weechat_iconv_to_internal ("iso-8859-1", "chaîne iso : é à"); +char *str = weechat_iconv_to_internal ("iso-8859-1", "chaîne iso : é à"); /* ... */ free (str); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -367,39 +367,39 @@ Script (Python) : str = weechat.iconv_to_internal(charset, string) # exemple -str = weechat.iconv_to_internal("iso-8859-1", "chaîne iso : é à") +str = weechat.iconv_to_internal("iso-8859-1", "chaîne iso : é à") ---- ==== iconv_from_internal Convertir une chaîne du jeu de caractères interne (UTF-8) vers un autre. -Prototype : +Prototype : [source,C] ---- char *weechat_iconv_from_internal (const char *charset, const char *string); ---- -Paramètres : +Paramètres : -* _charset_ : jeu de caractères cible -* _string_ : chaîne à convertir +* _charset_ : jeu de caractères cible +* _string_ : chaîne à convertir -Valeur de retour : +Valeur de retour : * chaîne convertie (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- -char *str = weechat_iconv_from_internal ("iso-8859-1", "chaîne utf-8 : é à"); +char *str = weechat_iconv_from_internal ("iso-8859-1", "chaîne utf-8 : é à"); /* ... */ free (str); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -407,36 +407,36 @@ Script (Python) : str = weechat.iconv_from_internal(charset, string) # exemple -str = weechat.iconv_from_internal("iso-8859-1", "chaîne utf-8 : é à") +str = weechat.iconv_from_internal("iso-8859-1", "chaîne utf-8 : é à") ---- ==== gettext Retourner la chaîne traduite (dépend de la langue locale). -Prototype : +Prototype : [source,C] ---- const char *weechat_gettext (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne à traduire +* _string_ : chaîne à traduire -Valeur de retour : +Valeur de retour : * chaîne traduite -Exemple en C : +Exemple en C : [source,C] ---- char *str = weechat_gettext ("hello"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -452,7 +452,7 @@ str = weechat.gettext("hello") Retourner la chaîne traduite, en utilisant le singulier ou le pluriel, selon le paramètre _count_. -Prototype : +Prototype : [source,C] ---- @@ -460,25 +460,25 @@ const char *weechat_ngettext (const char *string, const char *plural, int count); ---- -Paramètres : +Paramètres : -* _string_ : chaîne à traduire, au singulier -* _plural_ : chaîne à traduire, au pluriel -* _count_ : utilisé pour choisir entre le singulier et le pluriel (le choix est +* _string_ : chaîne à traduire, au singulier +* _plural_ : chaîne à traduire, au pluriel +* _count_ : utilisé pour choisir entre le singulier et le pluriel (le choix est fonction de la langue utilisée) -Valeur de retour : +Valeur de retour : * chaîne traduite -Exemple en C : +Exemple en C : [source,C] ---- char *str = weechat_ngettext ("file", "files", num_files); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -494,27 +494,27 @@ str = weechat.ngettext("file", "files", num_files) Retourner la chaîne dupliquée, avec au plus _length_ caractères. -Prototype : +Prototype : [source,C] ---- char *weechat_strndup (const char *string, int length); ---- -Paramètres : +Paramètres : -* _string_ : chaîne à dupliquer -* _length_ : nombre maximum de caractères à dupliquer +* _string_ : chaîne à dupliquer +* _length_ : nombre maximum de caractères à dupliquer -Valeur de retour : +Valeur de retour : * chaîne dupliquée (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- -char *str = weechat_strndup ("abcdef", 3); /* résultat : "abc" */ +char *str = weechat_strndup ("abcdef", 3); /* résultat : "abc" */ /* ... */ free (str); ---- @@ -526,23 +526,23 @@ Cette fonction n'est pas disponible dans l'API script. Convertir une chaîne UTF-8 en minuscules. -Prototype : +Prototype : [source,C] ---- void weechat_string_tolower (char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne à convertir +* _string_ : chaîne à convertir -Exemple en C : +Exemple en C : [source,C] ---- char str[] = "AbCdé"; -weechat_string_tolower (str); /* str vaut maintenant : "abcdé" */ +weechat_string_tolower (str); /* str vaut maintenant : "abcdé" */ ---- [NOTE] @@ -552,23 +552,23 @@ Cette fonction n'est pas disponible dans l'API script. Convertir une chaîne UTF-8 en majuscules. -Prototype : +Prototype : [source,C] ---- void weechat_string_toupper (char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne à convertir +* _string_ : chaîne à convertir -Exemple en C : +Exemple en C : [source,C] ---- char str[] = "AbCdé"; -weechat_string_toupper (str); /* str vaut maintenant : "ABCDé" */ +weechat_string_toupper (str); /* str vaut maintenant : "ABCDé" */ ---- [NOTE] @@ -580,25 +580,25 @@ _Mis à jour dans la 1.0._ Comparer deux chaînes indépendemment de la locale et de la casse. -Prototype : +Prototype : [source,C] ---- int weechat_strcasecmp (const char *string1, const char *string2); ---- -Paramètres : +Paramètres : -* _string1_ : première chaîne à comparer -* _string2_ : seconde chaîne à comparer +* _string1_ : première chaîne à comparer +* _string2_ : seconde chaîne à comparer -Valeur de retour : +Valeur de retour : * -1 si string1 < string2 * 0 si string1 == string2 * 1 si string1 > string2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -615,32 +615,32 @@ _WeeChat ≥ 0.3.7, mis à jour dans la 1.0._ Comparer deux chaînes indépendemment de la locale et de la casse, avec un intervalle pour comparer la casse. -Prototype : +Prototype : [source,C] ---- int weechat_strcasecmp_range (const char *string1, const char *string2, int range); ---- -Paramètres : +Paramètres : -* _string1_ : première chaîne à comparer -* _string2_ : seconde chaîne à comparer -* _range_ : nombre de caractères pour la comparaison de casse, par exemple : -** 26 : `+A-Z+` deviennent en minuscules `a-z` -** 29 : `+A-Z [ \ ]+` deviennent minuscules `+a-z { | }+` -** 30 : `+A-Z [ \ ] ^+` deviennent minuscules `+a-z { | } ~+` +* _string1_ : première chaîne à comparer +* _string2_ : seconde chaîne à comparer +* _range_ : nombre de caractères pour la comparaison de casse, par exemple : +** 26 : `+A-Z+` deviennent en minuscules `a-z` +** 29 : `+A-Z [ \ ]+` deviennent minuscules `+a-z { | }+` +** 30 : `+A-Z [ \ ] ^+` deviennent minuscules `+a-z { | } ~+` [NOTE] Les valeurs 29 et 30 sont utilisés par quelques protocoles comme IRC. -Valeur de retour : +Valeur de retour : * -1 si string1 < string2 * 0 si string1 == string2 * 1 si string1 > string2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -657,26 +657,26 @@ _Mis à jour dans la 1.0._ Comparer deux chaînes indépendemment de la locale et de la casse, pour _max_ caractères. -Prototype : +Prototype : [source,C] ---- int weechat_strncasecmp (const char *string1, const char *string2, int max); ---- -Paramètres : +Paramètres : -* _string1_ : première chaîne à comparer -* _string2_ : seconde chaîne à comparer -* _max_ : nombre maximum de caractères à comparer +* _string1_ : première chaîne à comparer +* _string2_ : seconde chaîne à comparer +* _max_ : nombre maximum de caractères à comparer -Valeur de retour : +Valeur de retour : * -1 si string1 < string2 * 0 si string1 == string2 * 1 si string1 > string2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -693,33 +693,33 @@ _WeeChat ≥ 0.3.7, mis à jour dans la 1.0._ Comparer deux chaînes indépendemment de la locale et de la casse, pour _max_ caractères, avec un intervalle pour comparer la casse. -Prototype : +Prototype : [source,C] ---- int weechat_strncasecmp_range (const char *string1, const char *string2, int max, int range); ---- -Paramètres : +Paramètres : -* _string1_ : première chaîne à comparer -* _string2_ : seconde chaîne à comparer -* _max_ : nombre maximum de caractères à comparer -* _range_ : nombre de caractères pour la comparaison de casse, par exemple : -** 26 : `+A-Z+` deviennent en minuscules `+a-z+` -** 29 : `+A-Z [ \ ]+` deviennent minuscules `+a-z { | }+` -** 30 : `+A-Z [ \ ] ^+` deviennent minuscules `+a-z { | } ~+` +* _string1_ : première chaîne à comparer +* _string2_ : seconde chaîne à comparer +* _max_ : nombre maximum de caractères à comparer +* _range_ : nombre de caractères pour la comparaison de casse, par exemple : +** 26 : `+A-Z+` deviennent en minuscules `+a-z+` +** 29 : `+A-Z [ \ ]+` deviennent minuscules `+a-z { | }+` +** 30 : `+A-Z [ \ ] ^+` deviennent minuscules `+a-z { | } ~+` [NOTE] Les valeurs 29 et 30 sont utilisés par quelques protocoles comme IRC. -Valeur de retour : +Valeur de retour : * -1 si string1 < string2 * 0 si string1 == string2 * 1 si string1 > string2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -736,7 +736,7 @@ _Mis à jour dans la 1.0._ Comparer deux chaînes indépendemment de la locale (et en option de la casse), en ignorant des caractères. -Prototype : +Prototype : [source,C] ---- @@ -745,20 +745,20 @@ int weechat_strcmp_ignore_chars (const char *string1, const char *string2, int case_sensitive); ---- -Paramètres : +Paramètres : -* _string1_ : première chaîne à comparer -* _string2_ : seconde chaîne à comparer -* _chars_ignored_ : chaîne avec les caractères à ignorer -* _case_sensitive_ : 1 pour une comparaison tenant compte de la casse, sinon 0 +* _string1_ : première chaîne à comparer +* _string2_ : seconde chaîne à comparer +* _chars_ignored_ : chaîne avec les caractères à ignorer +* _case_sensitive_ : 1 pour une comparaison tenant compte de la casse, sinon 0 -Valeur de retour : +Valeur de retour : * -1 si string1 < string2 * 0 si string1 == string2 * 1 si string1 > string2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -774,29 +774,29 @@ _Mis à jour dans la 1.3._ Rechercher une chaîne indépendemment de la locale et de la casse. -Prototype : +Prototype : [source,C] ---- const char *weechat_strcasestr (const char *string, const char *search); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _search_ : chaîne à rechercher dans _string_ +* _string_ : chaîne +* _search_ : chaîne à rechercher dans _string_ -Valeur de retour : +Valeur de retour : * pointeur vers la chaîne trouvée, ou NULL si non trouvée - (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un + (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un _char *_) -Exemple en C : +Exemple en C : [source,C] ---- -const char *pos = weechat_strcasestr ("aBcDeF", "de"); /* résultat : pointeur vers "DeF" */ +const char *pos = weechat_strcasestr ("aBcDeF", "de"); /* résultat : pointeur vers "DeF" */ ---- [NOTE] @@ -811,29 +811,29 @@ sur l'écran. Les caractères non affichables ont une longueur de 1 (c'est la différence avec la fonction <<_utf8_strlen_screen,utf8_strlen_screen>>). -Prototype : +Prototype : [source,C] ---- int weechat_strlen_screen (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * nombre de caractères nécessaires pour afficher la chaîne UTF-8 sur l'écran -Exemple en C : +Exemple en C : [source,C] ---- int length_on_screen = weechat_strlen_screen ("é"); /* == 1 */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -850,7 +850,7 @@ _Mis à jour dans la 1.0._ Vérifier si une chaîne correspond à un masque. -Prototype : +Prototype : [source,C] ---- @@ -858,22 +858,22 @@ int weechat_string_match (const char *string, const char *mask, int case_sensitive); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _mask_ : masque avec des caractères joker (`+*+`), chaque joker correspond à 0 +* _string_ : chaîne +* _mask_ : masque avec des caractères joker (`+*+`), chaque joker correspond à 0 ou plusieurs caractères dans la chaîne -* _case_sensitive_ : 1 pour une comparaison tenant compte de la casse, sinon 0 +* _case_sensitive_ : 1 pour une comparaison tenant compte de la casse, sinon 0 [NOTE] Depuis la version 1.0, les caractères joker sont autorisés à l'intérieur du masque (pas seulement au début et à la fin du masque). -Valeur de retour : +Valeur de retour : * 1 si la chaîne correspond au masque, sinon 0 -Exemple en C : +Exemple en C : [source,C] ---- @@ -884,7 +884,7 @@ int match4 = weechat_string_match ("abcdef", "*de*", 0); /* == 1 */ int match5 = weechat_string_match ("abcdef", "*b*d*", 0); /* == 1 */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -906,28 +906,28 @@ _WeeChat ≥ 0.3.3._ Remplacer le `+~+` en début de chaîne par le répertoire "home". Si la chaîne ne débute pas par `+~+`, alors une chaîne identique est retournée. -Prototype : +Prototype : [source,C] ---- char *weechat_string_expand_home (const char *path); ---- -Paramètres : +Paramètres : -* _path_ : chemin +* _path_ : chemin -Valeur de retour : +Valeur de retour : * chemin avec le `+~+` en début remplacé par le répertoire "home" (doit être supprimé par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- char *str = weechat_string_expand_home ("~/fichier.txt"); -/* résultat : "/home/xxx/fichier.txt" */ +/* résultat : "/home/xxx/fichier.txt" */ /* ... */ free (str); ---- @@ -939,14 +939,14 @@ Cette fonction n'est pas disponible dans l'API script. _WeeChat ≥ 1.3._ -Évaluer un chemin en 3 étapes : +Évaluer un chemin en 3 étapes : . remplacer le `%h` du début par le répertoire maison de WeeChat, . remplacer le `+~+` du début par le répertoire maison de l'utilisateur (appel à <<_string_expand_home,string_expand_home>>), . évaluer les variables (voir <<_string_eval_expression,string_eval_expression>>). -Prototype : +Prototype : [source,C] ---- @@ -956,31 +956,31 @@ char *weechat_string_eval_path_home (const char *path, struct t_hashtable *options); ---- -Paramètres : +Paramètres : -* _path_ : chemin -* _pointers_ : table de hachage pour l'appel à la fonction +* _path_ : chemin +* _pointers_ : table de hachage pour l'appel à la fonction <<_string_eval_expression,string_eval_expression>> -* _extra_vars_ : table de hachage pour l'appel à la fonction +* _extra_vars_ : table de hachage pour l'appel à la fonction <<_string_eval_expression,string_eval_expression>> -* _options_ : table de hachage pour l'appel à la fonction +* _options_ : table de hachage pour l'appel à la fonction <<_string_eval_expression,string_eval_expression>> -Valeur de retour : +Valeur de retour : * chemin évalué (doit être supprimé par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- char *str = weechat_string_eval_path_home ("%h/test", NULL, NULL, NULL); -/* résultat : "/home/xxx/.weechat/test" */ +/* résultat : "/home/xxx/.weechat/test" */ /* ... */ free (str); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -997,29 +997,29 @@ path = weechat.string_eval_path_home("%h/test", {}, {}, {}) Supprimer les apostrophes/guillemets au début et à la fin d'une chaîne (les espaces avant la première apostrophe ou après la dernière sont ignorés). -Prototype : +Prototype : [source,C] ---- char *weechat_string_remove_quotes (const char *string, const char *quotes); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _quotes_ : chaîne avec la liste des apostrophes/guillemets à supprimer +* _string_ : chaîne +* _quotes_ : chaîne avec la liste des apostrophes/guillemets à supprimer -Valeur de retour : +Valeur de retour : * chaîne sans les apostrophes/guillemets au début et à la fin (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- char *str = weechat_string_remove_quotes (string, " 'aujourd'hui' ", "'"); -/* résultat : "aujourd'hui" */ +/* résultat : "aujourd'hui" */ /* ... */ free (str); ---- @@ -1031,7 +1031,7 @@ Cette fonction n'est pas disponible dans l'API script. Supprimer des caractères au début et/ou à la fin d'une chaîne. -Prototype : +Prototype : [source,C] ---- @@ -1039,23 +1039,23 @@ char *weechat_string_strip (const char *string, int left, int right, const char *chars); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _left_ : supprime les caractères en début de chaîne si différent de 0 -* _right_ : supprime les caractères en fin de chaîne si différent de 0 -* _chars_ : chaîne avec les caractères à supprimer +* _string_ : chaîne +* _left_ : supprime les caractères en début de chaîne si différent de 0 +* _right_ : supprime les caractères en fin de chaîne si différent de 0 +* _chars_ : chaîne avec les caractères à supprimer -Valeur de retour : +Valeur de retour : * chaîne avec les caractères supprimés (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- -char *str = weechat_string_strip (".abc -", 0, 1, "- ."); /* résultat : ".abc" */ +char *str = weechat_string_strip (".abc -", 0, 1, "- ."); /* résultat : ".abc" */ /* ... */ free (str); ---- @@ -1067,47 +1067,47 @@ Cette fonction n'est pas disponible dans l'API script. _WeeChat ≥ 1.0._ -Convertir les caractères échappés par leur valeur : - -* `+\"+` : double guillemet droit -* `+\\+` : barre oblique inversée -* `+\a+` : alerte (BEL) -* `+\b+` : retour arrière -* `+\e+` : échappement -* `+\f+` : saut de page -* `+\n+` : nouvelle ligne -* `+\r+` : retour chariot -* `+\t+` : tabulation horizontale -* `+\v+` : tabulation verticale -* `+\0ooo+` : caractère sous forme de valeur octale (`ooo` a 0 à 3 chiffres) -* `+\xhh+` : caractère sous forme de valeur hexadécimale (`hh` a 1 à 2 chiffres) -* `+\uhhhh+` : caractère unicode sous forme de valeur hexadécimale +Convertir les caractères échappés par leur valeur : + +* `+\"+` : double guillemet droit +* `+\\+` : barre oblique inversée +* `+\a+` : alerte (BEL) +* `+\b+` : retour arrière +* `+\e+` : échappement +* `+\f+` : saut de page +* `+\n+` : nouvelle ligne +* `+\r+` : retour chariot +* `+\t+` : tabulation horizontale +* `+\v+` : tabulation verticale +* `+\0ooo+` : caractère sous forme de valeur octale (`ooo` a 0 à 3 chiffres) +* `+\xhh+` : caractère sous forme de valeur hexadécimale (`hh` a 1 à 2 chiffres) +* `+\uhhhh+` : caractère unicode sous forme de valeur hexadécimale (`hhhh` a 1 à 4 chiffres) -* `+\Uhhhhhhhh+` : caractère unicode sous forme de valeur hexadécimale +* `+\Uhhhhhhhh+` : caractère unicode sous forme de valeur hexadécimale (`hhhhhhhh` a 1 à 8 chiffres) -Prototype : +Prototype : [source,C] ---- char *weechat_string_convert_escaped_chars (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * chaîne avec les caractères échappés remplacés par leur valeur (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- -char *str = weechat_string_convert_escaped_chars ("snowman : \\u2603"); -/* str == "snowman : ☃" */ +char *str = weechat_string_convert_escaped_chars ("snowman : \\u2603"); +/* str == "snowman : ☃" */ /* ... */ free (str); ---- @@ -1121,33 +1121,33 @@ Retourner une expression régulière ("regex"), construite avec un masque où le seul caractère spécial est `+*+`. Tous les autres caractères spéciaux d'expression régulière sont échappés. -Prototype : +Prototype : [source,C] ---- char *weechat_string_mask_to_regex (const char *mask); ---- -Paramètres : +Paramètres : -* _mask_ : masque +* _mask_ : masque -Valeur de retour : +Valeur de retour : * expression régulière, sous forme de chaîne (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- char *str_regex = weechat_string_mask_to_regex ("test*mask"); -/* résultat : "test.*mask" */ +/* résultat : "test.*mask" */ /* ... */ free (str_regex); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -1165,42 +1165,42 @@ _WeeChat ≥ 0.3.7._ Retourner un pointeur dans la chaîne après les "flags" et le masque avec les "flags" pour compiler l'expression régulière. -Prototype : +Prototype : [source,C] ---- const char *weechat_string_regex_flags (const char *regex, int default_flags, int *flags) ---- -Paramètres : +Paramètres : -* _regex_ : expression régulière POSIX étendue -* _default_flags_ : combinaison des valeurs suivantes (voir `man regcomp`) : +* _regex_ : expression régulière POSIX étendue +* _default_flags_ : combinaison des valeurs suivantes (voir `man regcomp`) : ** REG_EXTENDED ** REG_ICASE ** REG_NEWLINE ** REG_NOSUB -* _flags_ : la valeur du pointer est alimentée avec les "flags" utilisés dans +* _flags_ : la valeur du pointer est alimentée avec les "flags" utilisés dans l'expression régulière ("flags" par défaut + "flags" définis dans l'expression régulière) -Les "flags" doivent être au début de l'expression régulière. Le format est : +Les "flags" doivent être au début de l'expression régulière. Le format est : "(?eins-eins)chaîne". -Les "flags" autorisés sont : +Les "flags" autorisés sont : -* _e_ : expression régulière POSIX étendue (_REG_EXTENDED_) -* _i_ : insensible à la casse (_REG_ICASE_) -* _n_ : les opérateurs qui cherchent n'importe quel caractère ne trouvent pas +* _e_ : expression régulière POSIX étendue (_REG_EXTENDED_) +* _i_ : insensible à la casse (_REG_ICASE_) +* _n_ : les opérateurs qui cherchent n'importe quel caractère ne trouvent pas les nouvelles lignes (_REG_NEWLINE_) -* _s_ : le support d'adressage des sous-chaînes de correspondance n'est pas +* _s_ : le support d'adressage des sous-chaînes de correspondance n'est pas requis (_REG_NOSUB_) -Valeur de retour : +Valeur de retour : * pointeur dans la _regex_, après les "flags" -Exemple en C : +Exemple en C : [source,C] ---- @@ -1220,29 +1220,29 @@ _WeeChat ≥ 0.3.7._ Compiler une expression régulière avec des "flags" optionnels en début de chaîne (pour le format des "flags", voir <<_string_regex_flags,string_regex_flags>>). -Prototype : +Prototype : [source,C] ---- int weechat_string_regcomp (void *preg, const char *regex, int default_flags) ---- -Paramètres : +Paramètres : -* _preg_ : pointeur vers la structure _regex_t_ -* _regex_ : expression régulière POSIX étendue -* _default_flags_ : combinaison des valeurs suivantes (voir `man regcomp`) : +* _preg_ : pointeur vers la structure _regex_t_ +* _regex_ : expression régulière POSIX étendue +* _default_flags_ : combinaison des valeurs suivantes (voir `man regcomp`) : ** REG_EXTENDED ** REG_ICASE ** REG_NEWLINE ** REG_NOSUB -Valeur de retour : +Valeur de retour : * même code retour que la fonction `regcomp` (0 si ok, autre valeur pour une erreur, voir `man regcomp`) -Exemple en C : +Exemple en C : [source,C] ---- @@ -1261,7 +1261,7 @@ Cette fonction n'est pas disponible dans l'API script. Vérifier si une chaîne a un ou plusieurs "highlights", en utilisant une liste de mots "highlight". -Prototype : +Prototype : [source,C] ---- @@ -1269,23 +1269,23 @@ int weechat_string_has_highlight (const char *string, const char highlight_words); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _highlight_words_ : liste de mots "highlight", séparés par des virgules +* _string_ : chaîne +* _highlight_words_ : liste de mots "highlight", séparés par des virgules -Valeur de retour : +Valeur de retour : * 1 si la chaîne a un ou plusieurs "highlights", sinon 0 -Exemple en C : +Exemple en C : [source,C] ---- int hl = weechat_string_has_highlight ("my test string", "test,word2"); /* == 1 */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -1303,32 +1303,32 @@ _WeeChat ≥ 0.3.4._ Vérifier si une chaîne a un ou plusieurs "highlights", en utilisant une expression régulière POSIX étendue. + Pour au moins une correspondance dans la chaîne, elle doit être entourée de -délimiteurs (caractères différents de : alphanumérique, `+-+`, `+_+` et `+|+`). +délimiteurs (caractères différents de : alphanumérique, `+-+`, `+_+` et `+|+`). -Prototype : +Prototype : [source,C] ---- int weechat_string_has_highlight_regex (const char *string, const char *regex); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _regex_ : expression régulière POSIX étendue +* _string_ : chaîne +* _regex_ : expression régulière POSIX étendue -Valeur de retour : +Valeur de retour : * 1 si la chaîne a un ou plusieurs "highlights", sinon 0 -Exemple en C : +Exemple en C : [source,C] ---- int hl = weechat_string_has_highlight_regex ("my test string", "test|word2"); /* == 1 */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -1343,7 +1343,7 @@ highlight = weechat.string_has_highlight_regex("my test string", "test|word2") Remplacer toutes les occurrences d'une chaîne par une autre chaîne. -Prototype : +Prototype : [source,C] ---- @@ -1351,22 +1351,22 @@ char *weechat_string_replace (const char *string, const char *search, const char *replace); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _search_ : chaîne à remplacer -* _replace_ : remplacement pour la chaîne _search_ +* _string_ : chaîne +* _search_ : chaîne à remplacer +* _replace_ : remplacement pour la chaîne _search_ -Valeur de retour : +Valeur de retour : * chaîne avec _search_ remplacée par _replace_ (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- -char *str = weechat_string_replace ("test, test", "s", "x"); /* résultat : "text" */ +char *str = weechat_string_replace ("test, test", "s", "x"); /* résultat : "text" */ /* ... */ free (str); ---- @@ -1381,7 +1381,7 @@ _WeeChat ≥ 1.0._ Remplacer du texte dans une chaîne en utilisant une expression régulière, du texte de remplacement et un "callback" optionnel. -Prototype : +Prototype : [source,C] ---- @@ -1391,37 +1391,37 @@ char *weechat_string_replace_regex (const char *string, void *regex, void *callback_data); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _regex_ : pointeur vers une expression régulière (structure _regex_t_) +* _string_ : chaîne +* _regex_ : pointeur vers une expression régulière (structure _regex_t_) compilée avec la fonction WeeChat <<_string_regcomp,string_regcomp>> ou regcomp (voir `man regcomp`) -* _replace_ : texte de remplacement, où les références suivantes sont - autorisées : -** `+$0+` à `+$99+` : correspondance 0 à 99 dans l'expression régulière (0 est la +* _replace_ : texte de remplacement, où les références suivantes sont + autorisées : +** `+$0+` à `+$99+` : correspondance 0 à 99 dans l'expression régulière (0 est la correspondance entière, 1 à 99 sont les groupes capturés entre parenthèses) -** `+$++` : la dernière correspondance (avec le numéro le plus élevé) -** `+$.*N+` : correspondance `+N+` (peut être `+++` ou de `+0+` à `+99+`), avec +** `+$++` : la dernière correspondance (avec le numéro le plus élevé) +** `+$.*N+` : correspondance `+N+` (peut être `+++` ou de `+0+` à `+99+`), avec tous les caractères remplacés par `+*+` (le caractère `+*+` peut être n'importe quel caractère entre l'espace (32) et `+~+` (126)) -* _reference_char_ : le caractère utilisé pour les références aux +* _reference_char_ : le caractère utilisé pour les références aux correspondances (en général `+$+`) -* _callback_ : un "callback" optionnel appelé pour chaque référence dans +* _callback_ : un "callback" optionnel appelé pour chaque référence dans _replace_ (sauf pour les correspondances remplacées par un caractère); le - "callback" doit retourner : -** une chaîne nouvellement allouée : elle est utilisée en texte de remplacement + "callback" doit retourner : +** une chaîne nouvellement allouée : elle est utilisée en texte de remplacement (elle est libérée après utilisation) -** NULL : le texte reçu dans le "callback" est utilisé comme texte de +** NULL : le texte reçu dans le "callback" est utilisé comme texte de remplacement (sans changement) -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé -Valeur de retour : +Valeur de retour : * chaîne avec le texte remplacé, NULL en cas de problème (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- @@ -1430,9 +1430,9 @@ char *string; if (weechat_string_regcomp (&my_regex, "([0-9]{4})-([0-9]{2})-([0-9]{2})", REG_EXTENDED) == 0) { - string = weechat_string_replace_regex ("date : 2014-02-14", &my_regex, + string = weechat_string_replace_regex ("date : 2014-02-14", &my_regex, "$3/$2/$1", '$', NULL, NULL); - /* string == "date : 14/02/2014" */ + /* string == "date : 14/02/2014" */ if (string) free (string); regfree (&my_regex); @@ -1446,7 +1446,7 @@ Cette fonction n'est pas disponible dans l'API script. Découper une chaîne à l'aide de délimiteur(s). -Prototype : +Prototype : [source,C] ---- @@ -1455,34 +1455,34 @@ char **weechat_string_split (const char *string, const char *separators, int *num_items); ---- -Paramètres : +Paramètres : -* _string_ : chaîne à découper -* _separators_ : délimiteurs utilisés pour le découpage -* _keep_eol_ : si différent de 0, alors chaque paramètre contiendra toutes les +* _string_ : chaîne à découper +* _separators_ : délimiteurs utilisés pour le découpage +* _keep_eol_ : si différent de 0, alors chaque paramètre contiendra toutes les chaînes jusqu'à la fin de la ligne (voir exemple ci-dessous) -** 0 : chaque chaîne contiendra un mot -** 1 : chaque chaîne contiendra toute la chaîne jusqu'à la fin de la ligne (voir +** 0 : chaque chaîne contiendra un mot +** 1 : chaque chaîne contiendra toute la chaîne jusqu'à la fin de la ligne (voir exemple ci-dessous) -** 2 : comme 1, mais ne supprime pas les séparateurs en fin de chaîne avant le +** 2 : comme 1, mais ne supprime pas les séparateurs en fin de chaîne avant le découpage _(WeeChat ≥ 0.3.6)_ -* _num_items_max_ : nombre maximum de chaînes à créer (0 = pas de limite) -* _num_items_ : pointeur vers un entier qui contiendra le nombre de chaînes +* _num_items_max_ : nombre maximum de chaînes à créer (0 = pas de limite) +* _num_items_ : pointeur vers un entier qui contiendra le nombre de chaînes créées -Valeur de retour : +Valeur de retour : * tableau de chaînes, NULL en cas de problème (doit être supprimé par un appel à <<_string_free_split,string_free_split>> après utilisation) -Exemples en C : +Exemples en C : [source,C] ---- char **argv; int argc; argv = weechat_string_split ("abc de fghi ", " ", 0, 0, &argc); -/* résultat : argv[0] == "abc" +/* résultat : argv[0] == "abc" argv[1] == "de" argv[2] == "fghi" argv[3] == NULL @@ -1491,7 +1491,7 @@ argv = weechat_string_split ("abc de fghi ", " ", 0, 0, &argc); weechat_string_free_split (argv); argv = weechat_string_split ("abc de fghi ", " ", 1, 0, &argc); -/* résultat : argv[0] == "abc de fghi" +/* résultat : argv[0] == "abc de fghi" argv[1] == "de fghi" argv[2] == "fghi" argv[3] == NULL @@ -1500,7 +1500,7 @@ argv = weechat_string_split ("abc de fghi ", " ", 1, 0, &argc); weechat_string_free_split (argv); argv = weechat_string_split ("abc de fghi ", " ", 2, 0, &argc); -/* résultat : argv[0] == "abc de fghi " +/* résultat : argv[0] == "abc de fghi " argv[1] == "de fghi " argv[2] == "fghi " argv[3] == NULL @@ -1519,36 +1519,36 @@ _WeeChat ≥ 1.0._ Découper une chaîne comme le shell le fait pour une commande avec ses paramètres. -Cette fonction est une conversion en C de la classe Python "shlex" (fichier : -Lib/shlex.py dans le dépôt Python), voir : +Cette fonction est une conversion en C de la classe Python "shlex" (fichier : +Lib/shlex.py dans le dépôt Python), voir : http://docs.python.org/3/library/shlex.html. -Prototype : +Prototype : [source,C] ---- char **weechat_string_split_shell (const char *string, int *num_items); ---- -Paramètres : +Paramètres : -* _string_ : chaîne à découper -* _num_items_ : pointeur vers un entier qui contiendra le nombre de chaînes +* _string_ : chaîne à découper +* _num_items_ : pointeur vers un entier qui contiendra le nombre de chaînes créées -Valeur de retour : +Valeur de retour : * tableau de chaînes, NULL en cas de problème (doit être supprimé par un appel à <<_string_free_split,string_free_split>> après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- char **argv; int argc; argv = weechat_string_split_shell ("test 'first arg' \"second arg\"", &argc); -/* résultat : argv[0] == "test" +/* résultat : argv[0] == "test" argv[1] == "first arg" argv[2] == "second arg" argv[3] == NULL @@ -1564,18 +1564,18 @@ Cette fonction n'est pas disponible dans l'API script. Supprimer une chaîne découpée. -Prototype : +Prototype : [source,C] ---- void weechat_string_free_split (char **split_string); ---- -Paramètres : +Paramètres : -* _split_string_ : chaîne découpée par <<_string_split,string_split>> +* _split_string_ : chaîne découpée par <<_string_split,string_split>> -Exemple en C : +Exemple en C : [source,C] ---- @@ -1593,7 +1593,7 @@ Cette fonction n'est pas disponible dans l'API script. Construire une chaîne à partir d'une chaîne découpée. -Prototype : +Prototype : [source,C] ---- @@ -1601,17 +1601,17 @@ char *weechat_string_build_with_split_string (char **split_string const char *separator); ---- -Paramètres : +Paramètres : -* _split_string_ : chaîne découpée par la fonction <<_string_split,string_split>> -* _separator_ : chaîne utilisée pour séparer les différentes chaînes +* _split_string_ : chaîne découpée par la fonction <<_string_split,string_split>> +* _separator_ : chaîne utilisée pour séparer les différentes chaînes -Valeur de retour : +Valeur de retour : * chaîne construite avec la chaîne découpée (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- @@ -1632,29 +1632,29 @@ Cette fonction n'est pas disponible dans l'API script. Découper une liste de commandes séparées par _separator_ (qui peut être échappé par `+\+` dans la chaîne). -Prototype : +Prototype : [source,C] ---- char **weechat_string_split_command (const char *command, char separator); ---- -Paramètres : +Paramètres : -* _command_ : commande à découper -* _separator_ : séparateur +* _command_ : commande à découper +* _separator_ : séparateur -Valeur de retour : +Valeur de retour : * tableau de chaînes, NULL en cas de problème (doit être supprimé par un appel à <<_free_split_command,free_split_command>> après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- char **argv = weechat_string_split_command ("/commande1 arg;/commande2", ';'); -/* résultat : argv[0] == "/commande1 arg" +/* résultat : argv[0] == "/commande1 arg" argv[1] == "/commande2" argv[2] == NULL */ @@ -1668,19 +1668,19 @@ Cette fonction n'est pas disponible dans l'API script. Supprimer une commande découpée. -Prototype : +Prototype : [source,C] ---- void weechat_string_free_split_command (char **split_command); ---- -Paramètres : +Paramètres : -* _split_command_ : commande découpée par +* _split_command_ : commande découpée par <<_string_split_command,string_split_command>> -Exemple en C : +Exemple en C : [source,C] ---- @@ -1697,22 +1697,22 @@ Cette fonction n'est pas disponible dans l'API script. Construire une chaîne avec une taille de fichier formatée et une unité traduite dans la langue locale. -Prototype : +Prototype : [source,C] ---- char *weechat_string_format_size (unsigned long long size); ---- -Paramètres : +Paramètres : -* _size_ : taille (en octets) +* _size_ : taille (en octets) -Valeur de retour : +Valeur de retour : * chaîne formatée (doit être supprimée par un appel à "free" après utilisation) -Exemples en C : +Exemples en C : [source,C] ---- @@ -1746,7 +1746,7 @@ Cette fonction n'est pas disponible dans l'API script. Supprimer les couleurs WeeChat dans une chaîne. -Prototype : +Prototype : [source,C] ---- @@ -1754,19 +1754,19 @@ char *weechat_string_remove_color (const char *string, const char *replacement); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _replacement_ : si non NULL et non vide, les couleurs WeeChat sont remplacées +* _string_ : chaîne +* _replacement_ : si non NULL et non vide, les couleurs WeeChat sont remplacées par le premier caractère de cette chaîne, sinon les codes couleurs WeeChat et les caractères suivants (rattachés à la couleur) sont supprimés de la chaîne -Valeur de retour : +Valeur de retour : * chaîne sans couleur (doit être supprimée par un appel à "free" après utilisation) -Exemples en C : +Exemples en C : [source,C] ---- @@ -1781,7 +1781,7 @@ char *str = weechat_string_remove_color (ma_chaine2, "?"); free (str); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -1798,21 +1798,21 @@ _WeeChat ≥ 0.3.2._ Encoder une chaîne en base64. -Prototype : +Prototype : [source,C] ---- void weechat_string_encode_base64 (const char *from, int length, char *to); ---- -Paramètres : +Paramètres : -* _from_ : chaîne à encoder -* _length_ : longueur de chaîne à encoder (par exemple `strlen(from)`) -* _to_ : pointeur vers la chaîne pour stocker le résultat (doit être +* _from_ : chaîne à encoder +* _length_ : longueur de chaîne à encoder (par exemple `strlen(from)`) +* _to_ : pointeur vers la chaîne pour stocker le résultat (doit être suffisamment long, le résultat est plus long que la chaîne initiale) -Exemple en C : +Exemple en C : [source,C] ---- @@ -1830,24 +1830,24 @@ _WeeChat ≥ 0.3.2._ Décoder une chaîne base64. -Prototype : +Prototype : [source,C] ---- int weechat_string_decode_base64 (const char *from, char *to); ---- -Paramètres : +Paramètres : -* _from_ : chaîne à décoder -* _to_ : pointeur vers la chaîne pour stocker le résultat (doit être +* _from_ : chaîne à décoder +* _to_ : pointeur vers la chaîne pour stocker le résultat (doit être suffisamment long, le résultat est plus court que la chaîne initiale) -Valeur de retour : +Valeur de retour : * longueur de la chaîne stockée dans _*to_ (ne compte pas le _\0_ final) -Exemple en C : +Exemple en C : [source,C] ---- @@ -1866,7 +1866,7 @@ _WeeChat ≥ 1.4._ Afficher les données sous forme d'octets en hexadécimal et ascii. -Prototype : +Prototype : [source,C] ---- @@ -1874,22 +1874,22 @@ char *string_hex_dump (const char *data, int data_size, int bytes_per_line, const char *prefix, const char *suffix); ---- -Paramètres : +Paramètres : -* _data_ : les données à afficher -* _data_size_ : nombre d'octets à afficher dans _data_ -* _bytes_per_line_ : nombre d'octets à afficher sur chaque ligne -* _prefix_ : le préfixe à afficher au début de chaque ligne +* _data_ : les données à afficher +* _data_size_ : nombre d'octets à afficher dans _data_ +* _bytes_per_line_ : nombre d'octets à afficher sur chaque ligne +* _prefix_ : le préfixe à afficher au début de chaque ligne (optionnel, peut être NULL) -* _suffix_ : le suffixe à afficher à la fin de chaque ligne +* _suffix_ : le suffixe à afficher à la fin de chaque ligne (optionnel, peut être NULL) -Valeur de retour : +Valeur de retour : * chaîne avec les données (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- @@ -1909,22 +1909,22 @@ _WeeChat ≥ 0.3.2._ Vérifier si le premier caractère de la chaîne est un caractère de commande (le caractère par défaut de commande est `+/+`). -Prototype : +Prototype : [source,C] ---- int weechat_string_is_command_char (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * 1 si le premier caractère de la chaîne est un caractère de commande, sinon 0 -Exemples en C : +Exemples en C : [source,C] ---- @@ -1932,7 +1932,7 @@ int command_char1 = weechat_string_is_command_char ("/test"); /* == 1 */ int command_char2 = weechat_string_is_command_char ("test"); /* == 0 */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -1951,22 +1951,22 @@ _WeeChat ≥ 0.3.2._ Retourner un pointeur vers le texte envoyé vers le tampon (pointeur à l'intérieur du paramètre "string"), ou NULL si c'est une commande. -Prototype : +Prototype : [source,C] ---- const char *weechat_string_input_for_buffer (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * pointeur vers "string", ou NULL -Exemples en C : +Exemples en C : [source,C] ---- @@ -1975,7 +1975,7 @@ const char *str2 = weechat_string_input_for_buffer ("/test"); /* NULL */ const char *str3 = weechat_string_input_for_buffer ("//test"); /* "/test" */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -1997,10 +1997,10 @@ Les variables spéciales avec le format `+${variable}+` sont étendues (voir le tableau ci-dessous). [NOTE] -Depuis la version 1.0, les variables imbriquées sont supportées, par exemple : +Depuis la version 1.0, les variables imbriquées sont supportées, par exemple : `+${color:${variable}}+`. -Prototype : +Prototype : [source,C] ---- @@ -2010,47 +2010,47 @@ char *weechat_string_eval_expression (const char *expr, struct t_hashtable *options); ---- -Paramètres : +Paramètres : -* _expr_ : l'expression à évaluer (voir le tableau ci-dessous) -* _pointers_ : table de hachage avec les pointeurs (les clés doivent être des +* _expr_ : l'expression à évaluer (voir le tableau ci-dessous) +* _pointers_ : table de hachage avec les pointeurs (les clés doivent être des chaînes, les valeurs doivent être des pointeurs); les pointeurs "window" et "buffer" sont automatiquement ajoutés s'ils ne sont pas dans la table de - hachage (avec le pointer vers fenêtre/tampon courants) (peut être NULL) : -** _regex_ : pointeur vers une expression régulière (structure _regex_t_) + hachage (avec le pointer vers fenêtre/tampon courants) (peut être NULL) : +** _regex_ : pointeur vers une expression régulière (structure _regex_t_) compilée avec la fonction WeeChat - <<_string_regcomp,string_regcomp>> ou regcomp (voir `man regcomp`) ; + <<_string_regcomp,string_regcomp>> ou regcomp (voir `man regcomp`) ; cette option est similaire à _regex_ dans la table de hachage _options_ (ci-dessous), mais est utilisée pour de meilleures performances -* _extra_vars_ : variables additionnelles qui seront étendues (peut être NULL) -* _options_ : table de hachage avec des options (les clés et valeurs doivent - être des chaînes) (peut être NULL) : -** _type_ : le comportement par défaut est de juste remplacer les valeurs dans - l'expression, d'autres types peuvent être choisis : -*** _condition_ : l'expression est évaluée comme une condition : les opérateurs +* _extra_vars_ : variables additionnelles qui seront étendues (peut être NULL) +* _options_ : table de hachage avec des options (les clés et valeurs doivent + être des chaînes) (peut être NULL) : +** _type_ : le comportement par défaut est de juste remplacer les valeurs dans + l'expression, d'autres types peuvent être choisis : +*** _condition_ : l'expression est évaluée comme une condition : les opérateurs et parenthèses sont utilisés, le résultat est un booléen ("0" ou "1") -** _prefix_ : préfixe avant les variables à remplacer (par défaut : `+${+`) -** _suffix_ : suffixe après les variables à remplacer (par défaut : `+}+`) -** _extra_ : le comportement par défaut est juste de remplacer les variables - additionnelles (_extra_vars_), un autre comportement peut être sélectionné : -*** _eval_ : les variables additionnelles (_extra_vars_) sont évaluées +** _prefix_ : préfixe avant les variables à remplacer (par défaut : `+${+`) +** _suffix_ : suffixe après les variables à remplacer (par défaut : `+}+`) +** _extra_ : le comportement par défaut est juste de remplacer les variables + additionnelles (_extra_vars_), un autre comportement peut être sélectionné : +*** _eval_ : les variables additionnelles (_extra_vars_) sont évaluées elles-mêmes avant remplacement -** _regex_ : une expression regulière pour remplacer du texte dans _expr_ (qui +** _regex_ : une expression regulière pour remplacer du texte dans _expr_ (qui n'est alors pas évalué) -** _regex_replace_ : le texte de remplacement à utiliser avec _regex_, pour +** _regex_replace_ : le texte de remplacement à utiliser avec _regex_, pour remplacer du texte dans _expr_ (_regex_replace_ est évalué sur chaque correspondance de _regex_ sur _expr_, jusqu'à ce que plus aucune correspondance ne soit trouvée) -Valeur de retour : +Valeur de retour : * expression évaluée (doit être supprimée après un appel à "free" après utilisation), ou NULL si problème (expression invalide ou pas assez de mémoire) Liste des variables étendues dans l'expression (par ordre de priorité, de la -première étendue à la dernière) : +première étendue à la dernière) : [width="100%",cols="2,8,4,4",options="header"] |=== @@ -2083,7 +2083,7 @@ première étendue à la dernière) : `+************+` | `+${re:N}+` | - Groupe regex capturé : `0` = toute la chaîne correspondante, + Groupe regex capturé : `0` = toute la chaîne correspondante, `1` à `99` = groupe capturé, `+++` = dernier groupe capturé. | `+${re:1}+` | `+test+` @@ -2145,7 +2145,7 @@ première étendue à la dernière) : `+1+` |=== -Exemples en C : +Exemples en C : [source,C] ---- @@ -2171,7 +2171,7 @@ struct t_hashtable *options2 = weechat_hashtable_new (8, /* ajout de crochets autour des URLs */ weechat_hashtable_set (options2, "regex", "\\w+://\\S+"); weechat_hashtable_set (options2, "regex_replace", "[ ${re:0} ]"); -char *str4 = weechat_string_eval_expression ("test : https://weechat.org", NULL, NULL, NULL); /* "test : [ https://weechat.org ]" */ +char *str4 = weechat_string_eval_expression ("test : https://weechat.org", NULL, NULL, NULL); /* "test : [ https://weechat.org ]" */ /* masquage des mots de passe */ weechat_hashtable_set (options2, "regex", "(password=)(\\S+)"); @@ -2179,7 +2179,7 @@ weechat_hashtable_set (options2, "regex_replace", "${re:1}${hide:*,${re:2}}"); char *str5 = weechat_string_eval_expression ("password=abc password=def", NULL, NULL, NULL); /* "password=*** password=***" */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -2195,14 +2195,14 @@ str2 = weechat.string_eval_expression("abc =~ def", {}, {}, {"type": "condition" # expression simple str3 = weechat.string_eval_expression("${buffer.full_name}", {}, {}, {}) # "core.weechat" -# remplacement avec regex : ajout de crochets autour des URLs +# remplacement avec regex : ajout de crochets autour des URLs options = { "regex": "\\w+://\\S+", "regex_replace": "[ ${re:0} ]", } -str4 = weechat.string_eval_expression("test : https://weechat.org", {}, {}, options) # "test : [ https://weechat.org ]" +str4 = weechat.string_eval_expression("test : https://weechat.org", {}, {}, options) # "test : [ https://weechat.org ]" -# replace with regex : masquage des mots de passe +# replace with regex : masquage des mots de passe options = { "regex": "(password=)(\\S+)", "regex_replace": "${re:1}${hide:*,${re:2}}", @@ -2219,23 +2219,23 @@ Fonctions pour les chaînes UTF-8. Vérifier si une chaîne a des caractères 8-bits. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_has_8bits (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * 1 si la chaîne a des caractères 8-bits, 0 s'il y a seulement des caractères 7-bits -Exemple en C : +Exemple en C : [source,C] ---- @@ -2254,26 +2254,26 @@ _Mis à jour dans la 1.4._ Vérifier si une chaîne est valide UTF-8. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_is_valid (const char *string, int length, char **error); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _length_ : nombre maximum de caractères UTF-8 à vérifier ; si ≤ 0, la chaîne +* _string_ : chaîne +* _length_ : nombre maximum de caractères UTF-8 à vérifier ; si ≤ 0, la chaîne complète est vérifiée _(WeeChat ≥ 1.4)_ -* _error_ : si non NULL, _*error_ est alimenté avec le pointeur vers le premier +* _error_ : si non NULL, _*error_ est alimenté avec le pointeur vers le premier caractère non valide dans la chaîne, s'il y en a -Valeur de retour : +Valeur de retour : * 1 si la chaîne UTF-8 est valide, sinon 0 -Exemple en C : +Exemple en C : [source,C] ---- @@ -2293,22 +2293,22 @@ Cette fonction n'est pas disponible dans l'API script. ==== utf8_normalize -Normaliser une chaîne UTF-8 : supprimer tous les caractères non valides UTF-8 +Normaliser une chaîne UTF-8 : supprimer tous les caractères non valides UTF-8 en les remplaçant par un caractère. -Prototype : +Prototype : [source,C] ---- void weechat_utf8_normalize (char *string, char replacement); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _replacement_ : caractère de remplacement pour les caractères non valides +* _string_ : chaîne +* _replacement_ : caractère de remplacement pour les caractères non valides -Exemple en C : +Exemple en C : [source,C] ---- @@ -2324,7 +2324,7 @@ _Mis à jour dans la 1.3._ Retourner un pointeur vers le caractère UTF-8 précédent dans une chaîne. -Prototype : +Prototype : [source,C] ---- @@ -2332,20 +2332,20 @@ const char *weechat_utf8_prev_char (const char *string_start, const char *string); ---- -Paramètres : +Paramètres : -* _string_start_ : début de la chaîne (la fonction ne retournera pas un +* _string_start_ : début de la chaîne (la fonction ne retournera pas un caractère situé avant ce pointeur) -* _string_ : pointeur vers la chaîne (doit être ≥ _string_start_) +* _string_ : pointeur vers la chaîne (doit être ≥ _string_start_) -Valeur de retour : +Valeur de retour : * pointeur vers le caractère UTF-8 précédent, NULL si non trouvé (début de chaîne atteint) - (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un + (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un _char *_) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2361,25 +2361,25 @@ _Mis à jour dans la 1.3._ Retourner un pointeur vers le caractère UTF-8 suivant dans une chaîne. -Prototype : +Prototype : [source,C] ---- const char *weechat_utf8_next_char (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * pointeur vers le caractère UTF-8 suivant, NULL si non trouvé (fin de la chaîne atteinte) - (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un + (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un _char *_) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2393,22 +2393,22 @@ Cette fonction n'est pas disponible dans l'API script. Retourner un caractère UTF-8 sous forme d'entier. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_char_int (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * caractère UTF-8 sous forme d'entier -Exemple en C : +Exemple en C : [source,C] ---- @@ -2422,22 +2422,22 @@ Cette fonction n'est pas disponible dans l'API script. Retourner la taille d'un caractère UTF-8 (en octets). -Prototype : +Prototype : [source,C] ---- int weechat_utf8_char_size (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * taille du caractère UTF-8 (en octets) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2451,22 +2451,22 @@ Cette fonction n'est pas disponible dans l'API script. Retourner la taille d'une chaîne UTF-8 (en nombre de caractères UTF-8). -Prototype : +Prototype : [source,C] ---- int weechat_utf8_strlen (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * longueur de la chaîne UTF-8 (nombre de caractères UTF-8) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2481,23 +2481,23 @@ Cette fonction n'est pas disponible dans l'API script. Retourner la taille d'une chaîne UTF-8 (en nombre de caractères UTF-8), pour au maximum _bytes_ octets dans la chaîne. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_strnlen (const char *string, int bytes); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _bytes_ : nombre maximum d'octets +* _string_ : chaîne +* _bytes_ : nombre maximum d'octets -Valeur de retour : +Valeur de retour : * longueur de la chaîne UTF-8 (nombre de caractères UTF-8) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2512,22 +2512,22 @@ Cette fonction n'est pas disponible dans l'API script. Retourner le nombre de caractères nécessaires pour afficher la chaîne UTF-8 sur l'écran. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_strlen_screen (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * nombre de caractères nécessaires pour afficher la chaîne UTF-8 sur l'écran -Exemple en C : +Exemple en C : [source,C] ---- @@ -2543,25 +2543,25 @@ _Mis à jour dans la 1.0._ Comparer deux caractères UTF-8. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_charcmp (const char *string1, const char *string2); ---- -Paramètres : +Paramètres : -* _string1_ : première chaîne pour la comparaison -* _string2_ : seconde chaîne pour la comparaison +* _string1_ : première chaîne pour la comparaison +* _string2_ : seconde chaîne pour la comparaison -Valeur de retour : +Valeur de retour : * -1 si string1 < string2 * 0 si string1 == string2 * 1 si string1 > string2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -2577,25 +2577,25 @@ _Mis à jour dans la 1.0._ Comparer deux caractères UTF-8 en ignorant la casse. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_charcasecmp (const char *string1, const char *string2); ---- -Paramètres : +Paramètres : -* _string1_ : première chaîne pour la comparaison -* _string2_ : seconde chaîne pour la comparaison +* _string1_ : première chaîne pour la comparaison +* _string2_ : seconde chaîne pour la comparaison -Valeur de retour : +Valeur de retour : * -1 si string1 < string2 * 0 si string1 == string2 * 1 si string1 > string2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -2610,22 +2610,22 @@ Cette fonction n'est pas disponible dans l'API script. Retourner le nombre de caractères nécessaires pour afficher le caractère UTF-8 sur l'écran. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_char_size_screen (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * nombre de caractères nécessaires pour afficher le caractère UTF-8 sur l'écran -Exemple en C : +Exemple en C : [source,C] ---- @@ -2641,26 +2641,26 @@ _Mis à jour dans la 1.3._ Avancer de N caractères dans une chaîne UTF-8. -Prototype : +Prototype : [source,C] ---- const char *weechat_utf8_add_offset (const char *string, int offset); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _offset_ : nombre de caractères +* _string_ : chaîne +* _offset_ : nombre de caractères -Valeur de retour : +Valeur de retour : * pointeur vers la chaîne, N caractères après (NULL s'il est impossible d'atteindre cette position dans la chaîne) - (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un + (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un _char *_) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2675,23 +2675,23 @@ Cette fonction n'est pas disponible dans l'API script. Retourner la position réelle dans une chaîne UTF-8. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_real_pos (const char *string, int pos); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _pos_ : position (en nombre de caractères) +* _string_ : chaîne +* _pos_ : position (en nombre de caractères) -Valeur de retour : +Valeur de retour : * position réelle (en octets) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2705,23 +2705,23 @@ Cette fonction n'est pas disponible dans l'API script. Retourner la position dans une chaîne UTF-8. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_pos (const char *string, int real_pos); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _real_pos_ : position (en octets) +* _string_ : chaîne +* _real_pos_ : position (en octets) -Valeur de retour : +Valeur de retour : * position (en nombre de caractères) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2735,24 +2735,24 @@ Cette fonction n'est pas disponible dans l'API script. Retourner une chaîne dupliquée, avec au plus _length_ caractères. -Prototype : +Prototype : [source,C] ---- char *weechat_utf8_strndup (const char *string, int length); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _length_ : nombre maximum de caractères à dupliquer +* _string_ : chaîne +* _length_ : nombre maximum de caractères à dupliquer -Valeur de retour : +Valeur de retour : * chaîne dupliquée (doit être supprimée avec un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2773,23 +2773,23 @@ Fonctions liées aux répertoires. Créer un répertoire dans le répertoire de WeeChat. -Prototype : +Prototype : [source,C] ---- int weechat_mkdir_home (char *directory, int mode); ---- -Paramètres : +Paramètres : -* _directory_ : nom du répertoire à créer -* _mode_ : mode pour le répertoire +* _directory_ : nom du répertoire à créer +* _mode_ : mode pour le répertoire -Valeur de retour : +Valeur de retour : * 1 si le répertoire est créé, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -2799,7 +2799,7 @@ if (!weechat_mkdir_home ("temp", 0755)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -2814,23 +2814,23 @@ weechat.mkdir_home("temp", 0755) Créer un répertoire. -Prototype : +Prototype : [source,C] ---- int weechat_mkdir (char *directory, int mode); ---- -Paramètres : +Paramètres : -* _directory_ : nom du répertoire à créer -* _mode_ : mode pour le répertoire +* _directory_ : nom du répertoire à créer +* _mode_ : mode pour le répertoire -Valeur de retour : +Valeur de retour : * 1 si le répertoire est créé, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -2840,7 +2840,7 @@ if (!weechat_mkdir ("/tmp/mydir", 0755)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -2855,23 +2855,23 @@ weechat.mkdir("/tmp/mydir", 0755) Créer un répertoire et ses parents si besoin. -Prototype : +Prototype : [source,C] ---- int weechat_mkdir_parents (char *directory, int mode); ---- -Paramètres : +Paramètres : -* _directory_ : nom du répertoire à créer -* _mode_ : mode pour le répertoire +* _directory_ : nom du répertoire à créer +* _mode_ : mode pour le répertoire -Valeur de retour : +Valeur de retour : * 1 si le répertoire est créé, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -2881,7 +2881,7 @@ if (!weechat_mkdir_parents ("/tmp/my/dir", 0755)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -2899,7 +2899,7 @@ _Mis à jour dans la 1.5._ Balayer les fichiers dans un répertoire et exécuter un "callback" pour chaque fichier. -Prototype : +Prototype : [source,C] ---- @@ -2910,17 +2910,17 @@ void weechat_exec_on_files (const char *directory, void *callback_data); ---- -Paramètres : +Paramètres : -* _directory_ : répertoire où chercher les fichiers -* _hidden_files_ : 1 pour inclure les fichiers cachés, sinon 0 -* _callback_ : fonction appelée pour chaque fichier trouvé, paramètres : -** _void *data_ : pointeur -** _const char *filename_ : nom de fichier trouvé -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _directory_ : répertoire où chercher les fichiers +* _hidden_files_ : 1 pour inclure les fichiers cachés, sinon 0 +* _callback_ : fonction appelée pour chaque fichier trouvé, paramètres : +** _void *data_ : pointeur +** _const char *filename_ : nom de fichier trouvé +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -Exemple en C : +Exemple en C : [source,C] ---- @@ -2941,23 +2941,23 @@ _WeeChat ≥ 0.3.1._ Lire le contenu d'un fichier texte dans une chaîne de caractères. -Prototype : +Prototype : [source,C] ---- char *weechat_file_get_content (const char *filename); ---- -Paramètres : +Paramètres : -* _filename_ : chemin et nom du fichier +* _filename_ : chemin et nom du fichier -Valeur de retour : +Valeur de retour : * contenu du fichier sous forme de chaîne (doit être supprimé par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2980,25 +2980,25 @@ Quelques fonctions utiles. Comparer deux structures "timeval". -Prototype : +Prototype : [source,C] ---- int weechat_util_timeval_cmp (struct timeval *tv1, struct timeval *tv2); ---- -Paramètres : +Paramètres : -* _tv1_ : première structure "timeval" -* _tv2_ : seconde structure "timeval" +* _tv1_ : première structure "timeval" +* _tv2_ : seconde structure "timeval" -Valeur de retour : +Valeur de retour : * -1 si tv1 < tv2 * zéro si tv1 == tv2 * +1 si tv1 > tv2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -3017,26 +3017,26 @@ _Mis à jour dans la 1.1._ Retourner la différence (en microsecondes) entre deux structures "timeval". -Prototype : +Prototype : [source,C] ---- long long weechat_util_timeval_diff (struct timeval *tv1, struct timeval *tv2); ---- -Paramètres : +Paramètres : -* _tv1_ : première structure "timeval" -* _tv2_ : seconde structure "timeval" +* _tv1_ : première structure "timeval" +* _tv2_ : seconde structure "timeval" -Valeur de retour : +Valeur de retour : * différence en microsecondes [NOTE] Avec WeeChat ≤ 1.0, la valeur retournée était en millisecondes. -Exemple en C : +Exemple en C : [source,C] ---- @@ -3052,22 +3052,22 @@ _Mis à jour dans la 1.1._ Ajouter un intervalle (en microsecondes) à une structure "timeval". -Prototype : +Prototype : [source,C] ---- void weechat_util_timeval_add (struct timeval *tv, long long interval); ---- -Paramètres : +Paramètres : -* _tv_ : structure "timeval" -* _interval_ : intervalle (en microsecondes) +* _tv_ : structure "timeval" +* _interval_ : intervalle (en microsecondes) [NOTE] Avec WeeChat ≤ 1.0, l'intervalle était exprimé en millisecondes. -Exemple en C : +Exemple en C : [source,C] ---- @@ -3084,27 +3084,27 @@ _WeeChat ≥ 0.3.2, mise à jour dans la 1.3._ Retourner la date/heure sous forme de chaîne construite avec "strftime" et le format défini dans l'option _weechat.look.time_format_. -Prototype : +Prototype : [source,C] ---- const char *weechat_util_get_time_string (const time_t *date); ---- -Paramètres : +Paramètres : -* _date_ : pointeur vers la date +* _date_ : pointeur vers la date -Valeur de retour : +Valeur de retour : * pointeur vers une chaîne contenant la date/heure -Exemple en C : +Exemple en C : [source,C] ---- time_t date = time (NULL); -weechat_printf (NULL, "date : %s", +weechat_printf (NULL, "date : %s", weechat_util_get_time_string (&date)); ---- @@ -3117,19 +3117,19 @@ _WeeChat ≥ 0.3.9._ Convertir une chaîne avec la version WeeChat en nombre. -Prototype : +Prototype : [source,C] ---- int weechat_util_version_number (const char *version); ---- -Paramètres : +Paramètres : -* _version_ : version WeeChat sous forme de chaîne (exemple : "0.3.9" ou +* _version_ : version WeeChat sous forme de chaîne (exemple : "0.3.9" ou "0.3.9-dev") -Exemple en C : +Exemple en C : [source,C] ---- @@ -3151,25 +3151,25 @@ Fonctions pour les listes triées. Créer une nouvelle liste. -Prototype : +Prototype : [source,C] ---- struct t_weelist *weechat_list_new (); ---- -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle liste -Exemple en C : +Exemple en C : [source,C] ---- struct t_weelist *list = weechat_list_new (); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3184,7 +3184,7 @@ list = weechat.list_new() Ajouter un élément dans une liste. -Prototype : +Prototype : [source,C] ---- @@ -3194,21 +3194,21 @@ struct t_weelist_item *weechat_list_add (struct t_weelist *weelist, void *user_data); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste -* _data_ : donnée à insérer dans la liste -* _where_ : position dans la liste : -** _WEECHAT_LIST_POS_SORT_ : ajout dans la liste, en gardant la liste triée -** _WEECHAT_LIST_POS_BEGINNING_ : ajout en début de liste -** _WEECHAT_LIST_POS_END_ : ajout en fin de liste -* _user_data_ : un pointeur quelconque +* _weelist_ : pointeur vers la liste +* _data_ : donnée à insérer dans la liste +* _where_ : position dans la liste : +** _WEECHAT_LIST_POS_SORT_ : ajout dans la liste, en gardant la liste triée +** _WEECHAT_LIST_POS_BEGINNING_ : ajout en début de liste +** _WEECHAT_LIST_POS_END_ : ajout en fin de liste +* _user_data_ : un pointeur quelconque -Valeur de retour : +Valeur de retour : * pointeur vers le nouvel élément -Exemple en C : +Exemple en C : [source,C] ---- @@ -3216,7 +3216,7 @@ struct t_weelist_item *my_item = weechat_list_add (list, "ma donnée", WEECHAT_LIST_POS_SORT, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3231,7 +3231,7 @@ item = weechat.list_add(list, "ma donnée", weechat.WEECHAT_LIST_POS_SORT, "") Rechercher un élément dans une liste. -Prototype : +Prototype : [source,C] ---- @@ -3239,23 +3239,23 @@ struct t_weelist_item *weechat_list_search (struct t_weelist *weelist, const char *data); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste -* _data_ : donnée à chercher dans la liste +* _weelist_ : pointeur vers la liste +* _data_ : donnée à chercher dans la liste -Valeur de retour : +Valeur de retour : * pointeur vers l'élément trouvé, NULL si aucun élément n'a été trouvé -Exemple en C : +Exemple en C : [source,C] ---- struct t_weelist_item *item = weechat_list_search (list, "ma donnée"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3272,7 +3272,7 @@ _WeeChat ≥ 0.3.4._ Rechercher la position d'un élément dans une liste. -Prototype : +Prototype : [source,C] ---- @@ -3280,23 +3280,23 @@ int weechat_list_search_pos (struct t_weelist *weelist, const char *data); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste -* _data_ : donnée à chercher dans la liste +* _weelist_ : pointeur vers la liste +* _data_ : donnée à chercher dans la liste -Valeur de retour : +Valeur de retour : * position de l'élément trouvé, -1 si aucun élément n'a été trouvé -Exemple en C : +Exemple en C : [source,C] ---- int pos_item = weechat_list_search_pos (list, "ma donnée"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3311,7 +3311,7 @@ pos_item = weechat.list_search_pos(list, "ma donnée") Rechercher un élément dans la liste, sans tenir compte de la casse. -Prototype : +Prototype : [source,C] ---- @@ -3319,23 +3319,23 @@ struct t_weelist_item *weechat_list_casesearch (struct t_weelist *weelist, const char *data); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste -* _data_ : données à chercher dans la liste +* _weelist_ : pointeur vers la liste +* _data_ : données à chercher dans la liste -Valeur de retour : +Valeur de retour : * pointeur vers l'élément trouvé, NULL si aucun élément n'a été trouvé -Exemple en C : +Exemple en C : [source,C] ---- struct t_weelist_item *item = weechat_list_casesearch (list, "ma donnée"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3353,7 +3353,7 @@ _WeeChat ≥ 0.3.4._ Rechercher la position d'un élément dans la liste, sans tenir compte de la casse. -Prototype : +Prototype : [source,C] ---- @@ -3361,23 +3361,23 @@ int weechat_list_casesearch_pos (struct t_weelist *weelist, const char *data); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste -* _data_ : données à chercher dans la liste +* _weelist_ : pointeur vers la liste +* _data_ : données à chercher dans la liste -Valeur de retour : +Valeur de retour : * position l'élément trouvé, -1 si aucun élément n'a été trouvé -Exemple en C : +Exemple en C : [source,C] ---- int pos_item = weechat_list_casesearch_pos (list, "ma donnée"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3392,7 +3392,7 @@ pos_item = weechat.list_casesearch_pos(list, "ma donnée") Retourner un élément de la liste par sa position. -Prototype : +Prototype : [source,C] ---- @@ -3400,23 +3400,23 @@ struct t_weelist_item *weechat_list_get (struct t_weelist *weelist, int position); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste -* _position_ : position dans la liste (le premier élément est 0) +* _weelist_ : pointeur vers la liste +* _position_ : position dans la liste (le premier élément est 0) -Valeur de retour : +Valeur de retour : * pointeur vers l'élément trouvé, NULL si aucun élément n'a été trouvé -Exemple en C : +Exemple en C : [source,C] ---- struct t_weelist_item *item = weechat_list_get (list, 0); /* premier élément */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3431,26 +3431,26 @@ item = weechat.list_get(list, 0) Affecter une nouvelle valeur pour un élément. -Prototype : +Prototype : [source,C] ---- void weechat_list_set (struct t_weelist_item *item, const char *value); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'élément -* _value_ : nouvelle valeur pour l'élément +* _item_ : pointeur vers l'élément +* _value_ : nouvelle valeur pour l'élément -Exemple en C : +Exemple en C : [source,C] ---- weechat_list_set (item, "nouvelle donnée"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3465,30 +3465,30 @@ weechat.list_set(item, "nouvelle donnée") Retourner l'élément suivant dans la liste. -Prototype : +Prototype : [source,C] ---- struct t_weelist_item *weechat_list_next (struct t_weelist_item *item); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'élément +* _item_ : pointeur vers l'élément -Valeur de retour : +Valeur de retour : * pointeur vers l'élément suivant, NULL si le pointeur était sur le dernier élément de la liste -Exemple en C : +Exemple en C : [source,C] ---- struct t_weelist_item *next_item = weechat_list_next (item); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3503,30 +3503,30 @@ item = weechat.list_next(item) Retourner l'élément précédent dans la liste. -Prototype : +Prototype : [source,C] ---- struct t_weelist_item *weechat_list_prev (struct t_weelist_item *item); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'élément +* _item_ : pointeur vers l'élément -Valeur de retour : +Valeur de retour : * pointeur vers l'élément précédent, NULL si le pointeur était sur le premier élément de la liste -Exemple en C : +Exemple en C : [source,C] ---- struct t_weelist_item *prev_item = weechat_list_prev (item); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3541,29 +3541,29 @@ item = weechat.list_prev(item) Retourner la valeur de l'élément sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- const char *weechat_list_string (struct t_weelist_item *item); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'élément +* _item_ : pointeur vers l'élément -Valeur de retour : +Valeur de retour : * valeur de l'élément -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "valeur de l'item : %s", weechat_list_string (item)); +weechat_printf (NULL, "valeur de l'item : %s", weechat_list_string (item)); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3571,36 +3571,36 @@ Script (Python) : value = weechat.list_string(item) # exemple -weechat.prnt("", "valeur de l'item : %s" % weechat.list_string(item)) +weechat.prnt("", "valeur de l'item : %s" % weechat.list_string(item)) ---- ==== list_size Retourner la taille de la liste (nombre d'éléments). -Prototype : +Prototype : [source,C] ---- char *weechat_list_size (struct t_weelist *weelist); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste +* _weelist_ : pointeur vers la liste -Valeur de retour : +Valeur de retour : * taille de la liste (nombre d'éléments), 0 si la liste est vide -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "taille de la liste : %d", weechat_list_size (list)); +weechat_printf (NULL, "taille de la liste : %d", weechat_list_size (list)); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3608,14 +3608,14 @@ Script (Python) : size = weechat.list_size(list) # exemple -weechat.prnt("", "taille de la liste : %d" % weechat.list_size(list)) +weechat.prnt("", "taille de la liste : %d" % weechat.list_size(list)) ---- ==== list_remove Supprimer un élément de la liste. -Prototype : +Prototype : [source,C] ---- @@ -3623,19 +3623,19 @@ void weechat_list_remove (struct t_weelist *weelist, struct t_weelist_item *item); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste -* _item_ : pointeur vers l'élément +* _weelist_ : pointeur vers la liste +* _item_ : pointeur vers l'élément -Exemple en C : +Exemple en C : [source,C] ---- weechat_list_remove (list, item); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3650,25 +3650,25 @@ weechat.list_remove(list, item) Supprimer tous les éléments de la liste. -Prototype : +Prototype : [source,C] ---- void weechat_list_remove_all (struct t_weelist *weelist); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste +* _weelist_ : pointeur vers la liste -Exemple en C : +Exemple en C : [source,C] ---- weechat_list_remove_all (list); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3683,25 +3683,25 @@ weechat.list_remove_all(list) Supprimer une liste. -Prototype : +Prototype : [source,C] ---- void weechat_list_free (struct t_weelist *weelist); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste +* _weelist_ : pointeur vers la liste -Exemple en C : +Exemple en C : [source,C] ---- weechat_list_free (list); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3723,7 +3723,7 @@ _WeeChat ≥ 0.3.3._ Créer une nouvelle table de hachage. -Prototype : +Prototype : [source,C] ---- @@ -3737,47 +3737,47 @@ struct t_hashtable *weechat_hashtable_new (int size, const void *key2)); ---- -Paramètres : +Paramètres : -* _size_ : taille du tableau interne pour stocker les clés sous forme de +* _size_ : taille du tableau interne pour stocker les clés sous forme de hachage, une grande valeur utilise plus de mémoire mais présente une meilleure performance (cela n'est *pas* une limite sur le nombre d'entrées de la table de hachage) -* _type_keys_ : type pour les clés dans la table de hachage : +* _type_keys_ : type pour les clés dans la table de hachage : ** _WEECHAT_HASHTABLE_INTEGER_ ** _WEECHAT_HASHTABLE_STRING_ ** _WEECHAT_HASHTABLE_POINTER_ ** _WEECHAT_HASHTABLE_BUFFER_ ** _WEECHAT_HASHTABLE_TIME_ -* _type_values_ : type pour les valeurs dans la table de hachage : +* _type_values_ : type pour les valeurs dans la table de hachage : ** _WEECHAT_HASHTABLE_INTEGER_ ** _WEECHAT_HASHTABLE_STRING_ ** _WEECHAT_HASHTABLE_POINTER_ ** _WEECHAT_HASHTABLE_BUFFER_ ** _WEECHAT_HASHTABLE_TIME_ -* _callback_hash_key_ : fonction appelée pour rendre le hachage d'une clé (la +* _callback_hash_key_ : fonction appelée pour rendre le hachage d'une clé (la clé sous forme de nombre entier), peut être NULL si le type de clé n'est pas "buffer" (une fonction de hachage par défaut est utilisée), paramètres et - valeur de retour : -** _struct t_hashtable *hashtable_ : pointeur vers la table de hachage -** _const void *key_ : clé -** valeur de retour : hachage de la clé -* _callback_keycmp_ : fonction appelée pour comparer deux clés, peut être NULL + valeur de retour : +** _struct t_hashtable *hashtable_ : pointeur vers la table de hachage +** _const void *key_ : clé +** valeur de retour : hachage de la clé +* _callback_keycmp_ : fonction appelée pour comparer deux clés, peut être NULL si le type de clé n'est pas "buffer" (une fonction de comparaison par défaut - est utilisée), paramètres et valeur de retour : -** _struct t_hashtable *hashtable_ : pointeur vers la table de hachage -** _const void *key1_ : première clé -** _const void *key2_ : seconde clé -** valeur de retour : + est utilisée), paramètres et valeur de retour : +** _struct t_hashtable *hashtable_ : pointeur vers la table de hachage +** _const void *key1_ : première clé +** _const void *key2_ : seconde clé +** valeur de retour : *** nombre négatif si _key1_ est inférieur à _key2_ *** 0 si _key1_ est égal à _key2_ *** nombre positif si _key1_ est supérieur à _key2_ -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle table de hachage, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -3798,7 +3798,7 @@ _WeeChat ≥ 0.3.3, mis à jour dans la 0.4.2._ Ajouter ou mettre à jour une entrée dans une table de hachage avec une taille pour la clé et la valeur. -Prototype : +Prototype : [source,C] ---- @@ -3807,21 +3807,21 @@ struct t_hashtable_item *weechat_hashtable_set_with_size (struct t_hashtable *ha const void *value, int value_size); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _key_ : pointeur vers la clé -* _key_size_ : taille de la clé (en octets), utilisée seulement si le type de +* _hashtable_ : pointeur vers la table de hachage +* _key_ : pointeur vers la clé +* _key_size_ : taille de la clé (en octets), utilisée seulement si le type de clés dans la table de hachage est "buffer" -* _value_ : pointeur vers la valeur -* _value_size_ : taille de la valeur (en octets), utilisée seulement si le type +* _value_ : pointeur vers la valeur +* _value_size_ : taille de la valeur (en octets), utilisée seulement si le type de valeurs dans la table de hachage est "buffer" -Valeur de retour : +Valeur de retour : * pointeur vers l'item créé/mis à jour, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -3838,7 +3838,7 @@ _WeeChat ≥ 0.3.3, mis à jour dans la 0.4.2._ Ajouter ou mettre à jour une entrée dans la table de hachage. -Prototype : +Prototype : [source,C] ---- @@ -3846,17 +3846,17 @@ struct t_hashtable_item *weechat_hashtable_set (struct t_hashtable *hashtable, const void *key, const void *value); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _key_ : pointeur vers la clé -* _value_ : pointeur vers la valeur +* _hashtable_ : pointeur vers la table de hachage +* _key_ : pointeur vers la clé +* _value_ : pointeur vers la valeur -Valeur de retour : +Valeur de retour : * pointeur vers l'item créé/mis à jour, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -3872,23 +3872,23 @@ _WeeChat ≥ 0.3.3._ Retourner la valeur associée à une clé dans une table de hachage. -Prototype : +Prototype : [source,C] ---- void *weechat_hashtable_get (struct t_hashtable *hashtable, void *key); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _key_ : pointeur vers la clé +* _hashtable_ : pointeur vers la table de hachage +* _key_ : pointeur vers la clé -Valeur de retour : +Valeur de retour : * valeur pour la clé, NULL si la clé n'est pas trouvée -Exemple en C : +Exemple en C : [source,C] ---- @@ -3904,24 +3904,24 @@ _WeeChat ≥ 0.3.4._ Vérifier si une clé est présente dans la table de hachage. -Prototype : +Prototype : [source,C] ---- int weechat_hashtable_has_key (struct t_hashtable *hashtable, void *key); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _key_ : pointeur vers la clé +* _hashtable_ : pointeur vers la table de hachage +* _key_ : pointeur vers la clé -Valeur de retour : +Valeur de retour : * 1 si la clé est dans la table de hachage, 0 si la clé n'est pas dans la table de hachage -Exemple en C : +Exemple en C : [source,C] ---- @@ -3941,7 +3941,7 @@ _WeeChat ≥ 0.3.3._ Appeller une fonction pour chaque entrée d'une table de hachage. -Prototype : +Prototype : [source,C] ---- @@ -3953,13 +3953,13 @@ void weechat_hashtable_map (struct t_hashtable *hashtable, void *callback_map_data); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _callback_map_ : fonction appelée pour chaque entrée de la table de hachage -* _callback_map_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _hashtable_ : pointeur vers la table de hachage +* _callback_map_ : fonction appelée pour chaque entrée de la table de hachage +* _callback_map_data_ : pointeur donné au "callback" lorsqu'il est appelé -Exemple en C : +Exemple en C : [source,C] ---- @@ -3968,7 +3968,7 @@ map_cb (void *data, struct t_hashtable *hashtable, const void *key, const void *value) { /* afficher la clé et la valeur (elles sont des chaînes ici) */ - weechat_printf (NULL, "clé : '%s', valeur : '%s'", + weechat_printf (NULL, "clé : '%s', valeur : '%s'", (const char *)key, (const char *)value); } @@ -3986,7 +3986,7 @@ _WeeChat ≥ 0.3.7._ Appeller une fonction pour chaque entrée d'une table de hachage, en envoyant les clés et valeurs sous forme de chaînes. -Prototype : +Prototype : [source,C] ---- @@ -3998,17 +3998,17 @@ void weechat_hashtable_map_string (struct t_hashtable *hashtable, void *callback_map_data); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _callback_map_ : fonction appelée pour chaque entrée de la table de hachage -* _callback_map_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _hashtable_ : pointeur vers la table de hachage +* _callback_map_ : fonction appelée pour chaque entrée de la table de hachage +* _callback_map_data_ : pointeur donné au "callback" lorsqu'il est appelé [NOTE] Les chaînes _key_ et _value_ envoyées au "callback" sont des chaînes temporaires, elles sont supprimées après l'appel au "callback". -Exemple en C : +Exemple en C : [source,C] ---- @@ -4017,7 +4017,7 @@ map_cb (void *data, struct t_hashtable *hashtable, const char *key, const char *value) { /* afficher la clé et la valeur */ - weechat_printf (NULL, "clé : '%s', valeur : '%s'", + weechat_printf (NULL, "clé : '%s', valeur : '%s'", key, value); } /* ... */ @@ -4033,22 +4033,22 @@ _WeeChat ≥ 1.0._ Dupliquer une table de hachage. -Prototype : +Prototype : [source,C] ---- struct t_hashtable *weechat_hashtable_dup (struct t_hashtable *hashtable); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage +* _hashtable_ : pointeur vers la table de hachage -Valeur de retour : +Valeur de retour : * table de hachage dupliquée -Exemple en C : +Exemple en C : [source,C] ---- @@ -4064,7 +4064,7 @@ _WeeChat ≥ 0.3.3._ Retourner une valeur entière pour une propriété d'une table de hachage. -Prototype : +Prototype : [source,C] ---- @@ -4072,18 +4072,18 @@ int weechat_hashtable_get_integer (struct t_hashtable *hashtable, void *property); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _property_ : nom de propriété : -** _size_ : taille du tableau interne "htable" dans la table de hachage -** _items_count_ : nombre d'éléments dans la table de hachage +* _hashtable_ : pointeur vers la table de hachage +* _property_ : nom de propriété : +** _size_ : taille du tableau interne "htable" dans la table de hachage +** _items_count_ : nombre d'éléments dans la table de hachage -Valeur de retour : +Valeur de retour : * valeur de la propriété sous forme d'entier -Exemple en C : +Exemple en C : [source,C] ---- @@ -4100,7 +4100,7 @@ _WeeChat ≥ 0.3.4._ Retourner une valeur pour une propriété d'une table de hachage sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- @@ -4108,43 +4108,43 @@ const char *weechat_hashtable_get_string (struct t_hashtable *hashtable, const char *property); ---- -Paramètres : - -* _hashtable_ : pointeur vers la table de hachage -* _property_ : nom de la propriété : -** _type_keys_ : type pour les clés : -*** _integer_ : entier -*** _string_ : chaîne -*** _pointer_ : pointeur -*** _buffer_ : buffer -*** _time_ : heure -** _type_values_ : type pour les valeurs : -*** _integer_ : entier -*** _string_ : chaîne -*** _pointer_ : pointeur -*** _buffer_ : buffer -*** _time_ : heure -** _keys_ : chaîne avec la liste des clés (format : "clé1,clé2,clé3") -** _keys_sorted_ : chaîne avec la liste triée des clés (format : +Paramètres : + +* _hashtable_ : pointeur vers la table de hachage +* _property_ : nom de la propriété : +** _type_keys_ : type pour les clés : +*** _integer_ : entier +*** _string_ : chaîne +*** _pointer_ : pointeur +*** _buffer_ : buffer +*** _time_ : heure +** _type_values_ : type pour les valeurs : +*** _integer_ : entier +*** _string_ : chaîne +*** _pointer_ : pointeur +*** _buffer_ : buffer +*** _time_ : heure +** _keys_ : chaîne avec la liste des clés (format : "clé1,clé2,clé3") +** _keys_sorted_ : chaîne avec la liste triée des clés (format : "clé1,clé2,clé3") -** _values_ : chaîne avec la liste des valeurs (format : +** _values_ : chaîne avec la liste des valeurs (format : "valeur1,valeur2,valeur3") -** _keys_values_ : chaîne avec la liste des clés et valeurs - (format : "clé1:valeur1,clé2:valeur2,clé3:valeur3") -** _keys_values_sorted_ : chaîne avec la liste des clés et valeurs (triée sur - les clés) (format : "clé1:valeur1,clé2:valeur2,clé3:valeur3") +** _keys_values_ : chaîne avec la liste des clés et valeurs + (format : "clé1:valeur1,clé2:valeur2,clé3:valeur3") +** _keys_values_sorted_ : chaîne avec la liste des clés et valeurs (triée sur + les clés) (format : "clé1:valeur1,clé2:valeur2,clé3:valeur3") -Valeur de retour : +Valeur de retour : * valeur de la propriété sous forme de chaîne -Exemples en C : +Exemples en C : [source,C] ---- -weechat_printf (NULL, "les clés sont de type : %s", +weechat_printf (NULL, "les clés sont de type : %s", weechat_hashtable_get_string (hashtable, "type_keys")); -weechat_printf (NULL, "liste des clés : %s", +weechat_printf (NULL, "liste des clés : %s", weechat_hashtable_get_string (hashtable, "keys")); ---- @@ -4157,7 +4157,7 @@ _WeeChat ≥ 0.3.4._ Affecter un pointeur à une propriété d'une table de hachage. -Prototype : +Prototype : [source,C] ---- @@ -4165,17 +4165,17 @@ void weechat_hashtable_set_pointer (struct t_hashtable *hashtable, const char *property, void *pointer); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _property_ : nom de la propriété : -** _callback_free_key_ : définit la fonction "callback" pour supprimer les clés +* _hashtable_ : pointeur vers la table de hachage +* _property_ : nom de la propriété : +** _callback_free_key_ : définit la fonction "callback" pour supprimer les clés de la table de hachage _(WeeChat ≥ 0.4.2)_ -** _callback_free_value_ : définit la fonction "callback" pour supprimer les +** _callback_free_value_ : définit la fonction "callback" pour supprimer les valeurs de la table de hachage -* _pointer_ : nouvelle valeur de pointeur pour la propriété +* _pointer_ : nouvelle valeur de pointeur pour la propriété -Exemple en C : +Exemple en C : [source,C] ---- @@ -4204,7 +4204,7 @@ _WeeChat ≥ 0.3.3._ Ajouter les éléments d'une table de hachage dans un objet infolist. -Prototype : +Prototype : [source,C] ---- @@ -4213,26 +4213,26 @@ int weechat_hashtable_add_to_infolist (struct t_hashtable *hashtable, const char *prefix); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _infolist_item_ : pointeur vers l'objet de l'infolist -* _prefix_ : chaîne utilisée comme préfixe pour les noms dans l'infolist +* _hashtable_ : pointeur vers la table de hachage +* _infolist_item_ : pointeur vers l'objet de l'infolist +* _prefix_ : chaîne utilisée comme préfixe pour les noms dans l'infolist -Valeur de retour : +Valeur de retour : * 1 si ok, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- weechat_hashtable_add_to_infolist (hashtable, infolist_item, "testhash"); -/* si la table de hachage contient : +/* si la table de hachage contient : "cle1" => "valeur 1" "cle2" => "valeur 2" - alors les variables suivantes seront ajoutées dans l'objet de l'infolist : + alors les variables suivantes seront ajoutées dans l'objet de l'infolist : "testhash_name_00000" = "cle1" "testhash_value_00000" = "valeur 1" "testhash_name_00001" = "cle2" @@ -4249,19 +4249,19 @@ _WeeChat ≥ 0.3.3._ Supprimer un élément d'une table de hachage. -Prototype : +Prototype : [source,C] ---- void weechat_hashtable_remove (struct t_hashtable *hashtable, const void *key); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _key_ : pointeur vers la clé +* _hashtable_ : pointeur vers la table de hachage +* _key_ : pointeur vers la clé -Exemple en C : +Exemple en C : [source,C] ---- @@ -4277,18 +4277,18 @@ _WeeChat ≥ 0.3.3._ Supprimer tous les éléments d'une table de hachage. -Prototype : +Prototype : [source,C] ---- void weechat_hashtable_remove_all (struct t_hashtable *hashtable); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage +* _hashtable_ : pointeur vers la table de hachage -Exemple en C : +Exemple en C : [source,C] ---- @@ -4304,18 +4304,18 @@ _WeeChat ≥ 0.3.3._ Supprimer une table de hachage. -Prototype : +Prototype : [source,C] ---- void weechat_hashtable_free (struct t_hashtable *hashtable); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage +* _hashtable_ : pointeur vers la table de hachage -Exemple en C : +Exemple en C : [source,C] ---- @@ -4336,7 +4336,7 @@ _Mis à jour dans la 1.5._ Créer un nouveau fichier de configuration. -Prototype : +Prototype : [source,C] ---- @@ -4348,28 +4348,28 @@ struct t_config_file *weechat_config_new (const char *name, void *callback_reload_data); ---- -Paramètres : +Paramètres : -* _name_ : nom du nouveau fichier de configuration (sans chemin ou extension) -* _callback_reload_ : fonction appelée quand le fichier de configuration est +* _name_ : nom du nouveau fichier de configuration (sans chemin ou extension) +* _callback_reload_ : fonction appelée quand le fichier de configuration est rechargé avec `/reload` (optionnel, peut être NULL), paramètres et valeur de - retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_file *config_file_ : pointeur vers le fichier de + retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_file *config_file_ : pointeur vers le fichier de configuration -** valeur de retour : +** valeur de retour : *** _WEECHAT_CONFIG_READ_OK_ *** _WEECHAT_CONFIG_READ_MEMORY_ERROR_ *** _WEECHAT_CONFIG_READ_FILE_NOT_FOUND_ -* _callback_reload_pointer_ : pointeur donné au "callback" de rechargement +* _callback_reload_pointer_ : pointeur donné au "callback" de rechargement lorsqu'il est appelé par WeeChat -* _callback_reload_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_reload_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le fichier de configuration est libéré -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau fichier de configuration, NULL en cas d'erreur @@ -4380,7 +4380,7 @@ Vous ne devriez appeler cette fonction qu'après avoir créé les sections (avec <<_config_new_section,config_new_section>>) et les options (avec <<_config_new_option,config_new_option>>). -Exemple en C : +Exemple en C : [source,C] ---- @@ -4398,7 +4398,7 @@ struct t_config_file *config_file = weechat_config_new ("test", NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -4419,7 +4419,7 @@ _Mis à jour dans la 1.5._ Créer une nouvelle section dans un fichier de configuration. -Prototype : +Prototype : [source,C] ---- @@ -4465,114 +4465,114 @@ struct t_config_section *weechat_config_new_section ( void *callback_delete_option_data); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration -* _name_ : nom de la section -* _user_can_add_options_ : 1 si l'utilisateur peut créer de nouvelles options +* _config_file_ : pointeur vers le fichier de configuration +* _name_ : nom de la section +* _user_can_add_options_ : 1 si l'utilisateur peut créer de nouvelles options dans la section, ou 0 si c'est interdit -* _user_can_delete_options_ : 1 si l'utilisateur peut supprimer des options +* _user_can_delete_options_ : 1 si l'utilisateur peut supprimer des options dans la section, ou 0 si c'est interdit -* _callback_read_ : fonction appelée quand une option de la section est lue +* _callback_read_ : fonction appelée quand une option de la section est lue depuis le disque (devrait être NULL dans la plupart des cas, sauf si des options de la section nécessitent une fonction personnalisée), paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_file *config_file_ : pointeur vers le fichier de + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_file *config_file_ : pointeur vers le fichier de configuration -** _struct t_config_section *section_ : pointeur vers la section -** _const char *option_name_ : nom de l'option -** _const char *value_ : valeur -** valeur de retour : +** _struct t_config_section *section_ : pointeur vers la section +** _const char *option_name_ : nom de l'option +** _const char *value_ : valeur +** valeur de retour : *** _WEECHAT_CONFIG_READ_OK_ *** _WEECHAT_CONFIG_READ_MEMORY_ERROR_ *** _WEECHAT_CONFIG_READ_FILE_NOT_FOUND_ -* _callback_read_pointer_ : pointeur donné au "callback" quand il est appelé +* _callback_read_pointer_ : pointeur donné au "callback" quand il est appelé par WeeChat -* _callback_read_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_read_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque la section est libérée -* _callback_write_ : fonction appelée lorsque la section est écrite dans le +* _callback_write_ : fonction appelée lorsque la section est écrite dans le fichier (devrait être NULL dans la plupart des cas, sauf si la section nécessite d'être écrite par une fonction personnalisée), paramètres et valeur - de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_file *config_file_ : pointeur vers le fichier de + de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_file *config_file_ : pointeur vers le fichier de configuration -** _const char *section_name_ : nom de la section -** valeur de retour : +** _const char *section_name_ : nom de la section +** valeur de retour : *** _WEECHAT_CONFIG_WRITE_OK_ *** _WEECHAT_CONFIG_WRITE_ERROR_ *** _WEECHAT_CONFIG_WRITE_MEMORY_ERROR_ -* _callback_write_pointer_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_write_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_write_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_write_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque la section est libérée -* _callback_write_default_ : fonction appelée lorsque les valeurs par défaut - doivent être écrites dans le fichier, paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_file *config_file_ : pointeur vers le fichier de +* _callback_write_default_ : fonction appelée lorsque les valeurs par défaut + doivent être écrites dans le fichier, paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_file *config_file_ : pointeur vers le fichier de configuration -** _const char *section_name_ : nom de la section -** valeur de retour : +** _const char *section_name_ : nom de la section +** valeur de retour : *** _WEECHAT_CONFIG_WRITE_OK_ *** _WEECHAT_CONFIG_WRITE_ERROR_ *** _WEECHAT_CONFIG_WRITE_MEMORY_ERROR_ -* _callback_write_default_pointer_ : pointeur donné au "callback" lorsqu'il est +* _callback_write_default_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_write_default_data_ : pointeur donné au "callback" lorsqu'il est +* _callback_write_default_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque la section est libérée -* _callback_create_option_ : fonction appelée lorsqu'une nouvelle option est +* _callback_create_option_ : fonction appelée lorsqu'une nouvelle option est créée dans la section (NULL si la section n'autorise pas la création de - nouvelles options), paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_file *config_file_ : pointeur vers le fichier de + nouvelles options), paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_file *config_file_ : pointeur vers le fichier de configuration -** _struct t_config_section *section_ : pointeur vers la section -** _const char *option_name_ : nom de l'option -** _const char *value_ : valeur -* _callback_create_option_pointer_ : pointeur donné au "callback" lorsqu'il est +** _struct t_config_section *section_ : pointeur vers la section +** _const char *option_name_ : nom de l'option +** _const char *value_ : valeur +* _callback_create_option_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_create_option_data_ : pointeur donné au "callback" lorsqu'il est +* _callback_create_option_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque la section est libérée -* _callback_delete_option_ : fonction appelée lorsqu'une option est supprimée +* _callback_delete_option_ : fonction appelée lorsqu'une option est supprimée de la section (NULL si la section n'autorise pas la suppression d'options), - paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_file *config_file_ : pointeur vers le fichier de + paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_file *config_file_ : pointeur vers le fichier de configuration -** _struct t_config_section *section_ : pointeur vers la section -** _struct t_config_option *option_ : pointeur vers l'option -** valeur de retour : +** _struct t_config_section *section_ : pointeur vers la section +** _struct t_config_option *option_ : pointeur vers l'option +** valeur de retour : *** _WEECHAT_CONFIG_OPTION_SET_OK_CHANGED_ *** _WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE_ *** _WEECHAT_CONFIG_OPTION_SET_ERROR_ *** _WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND_ -* _callback_delete_option_pointer_ : pointeur donné au "callback" lorsqu'il est +* _callback_delete_option_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_delete_option_data_ : pointeur donné au "callback" lorsqu'il est +* _callback_delete_option_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque la section est libérée -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle section du fichier de configuration, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -4663,7 +4663,7 @@ struct t_config_section *new_section2 = &my_section_delete_option_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -4711,7 +4711,7 @@ section = weechat.config_new_section(config_file, "section1", 1, 1, Rechercher une section dans un fichier de configuration. -Prototype : +Prototype : [source,C] ---- @@ -4720,16 +4720,16 @@ struct t_config_section *weechat_config_search_section ( const char *section_name); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration -* _section_name_ : nom de la section à chercher +* _config_file_ : pointeur vers le fichier de configuration +* _section_name_ : nom de la section à chercher -Valeur de retour : +Valeur de retour : * pointeur vers la section trouvée, ou NULL si la section n'a pas été trouvée -Exemple en C : +Exemple en C : [source,C] ---- @@ -4737,7 +4737,7 @@ struct t_config_section *section = weechat_config_search_section (config_file, "section"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -4754,7 +4754,7 @@ _Mis à jour dans la 1.5._ Créer une nouvelle option dans une section d'un fichier de configuration. -Prototype : +Prototype : [source,C] ---- @@ -4788,72 +4788,72 @@ struct t_config_option *weechat_config_new_option ( void *callback_delete_data); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration -* _section_ : pointeur vers la section -* _name_ : nom de l'option ; avec WeeChat ≥ 1.4, le nom peut inclure le nom +* _config_file_ : pointeur vers le fichier de configuration +* _section_ : pointeur vers la section +* _name_ : nom de l'option ; avec WeeChat ≥ 1.4, le nom peut inclure le nom d'une option parente (la valeur de l'option parente sera affichée dans la - sortie de `/set` si cette option est "null"), la syntaxe est alors : + sortie de `/set` si cette option est "null"), la syntaxe est alors : "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) -** _string_ : une chaîne de caractères -** _color_ : une couleur -* _description_ : description de l'option -* _string_values_ : valeurs sous forme de chaîne (séparées par `+|+`), utilisées +* _type_ : type de l'option : +** _boolean_ : valeur booléenne (on/off) +** _integer_ : valeur entière (avec en option une chaîne pour chaque valeur) +** _string_ : une chaîne de caractères +** _color_ : une couleur +* _description_ : description de l'option +* _string_values_ : valeurs sous forme de chaîne (séparées par `+|+`), utilisées pour le type _integer_ (optionnel) -* _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 +* _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 réinitialisée) -* _value_ : valeur de l'option -* _null_value_allowed_ : 1 si _null_ (valeur non définie) est autorisé pour +* _value_ : valeur de l'option +* _null_value_allowed_ : 1 si _null_ (valeur non définie) est autorisé pour l'option, sinon 0 -* _callback_check_value_ : fonction appelée pour vérifier la nouvelle valeur - de l'option (optionnel), paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_option *option_ : pointeur vers l'option -** _const char *value_ : nouvelle valeur pour l'option -** valeur de retour : +* _callback_check_value_ : fonction appelée pour vérifier la nouvelle valeur + de l'option (optionnel), paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_option *option_ : pointeur vers l'option +** _const char *value_ : nouvelle valeur pour l'option +** valeur de retour : *** 1 si la valeur est ok *** 0 si la valeur est invalide -* _callback_check_value_pointer_ : pointeur donné au "callback" lorsqu'il est +* _callback_check_value_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_check_value_data_ : pointeur donné au "callback" lorsqu'il est +* _callback_check_value_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque l'option est libérée -* _callback_change_ : fonction appelée lorsque la valeur de l'option a changé - (optionnel), paramètres : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_option *option_ : pointeur vers l'option -* _callback_change_pointer_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_change_ : fonction appelée lorsque la valeur de l'option a changé + (optionnel), paramètres : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_option *option_ : pointeur vers l'option +* _callback_change_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_change_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_change_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque l'option est libérée -* _callback_delete_ : fonction appelée lorsque l'option est supprimée - (optionnel), paramètres : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_option *option_ : pointeur vers l'option -* _callback_delete_pointer_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_delete_ : fonction appelée lorsque l'option est supprimée + (optionnel), paramètres : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_option *option_ : pointeur vers l'option +* _callback_delete_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_delete_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_delete_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque l'option est libérée -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle option de la section, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -4924,7 +4924,7 @@ struct t_config_option *option5 = NULL, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -4994,7 +4994,7 @@ _(corrigé dans la version 0.4.1)_. Rechercher une option dans une section d'un fichier de configuration. -Prototype : +Prototype : [source,C] ---- @@ -5004,17 +5004,17 @@ struct t_config_option *weechat_config_search_option ( const char *option_name); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration -* _section_ : pointeur vers la section -* _name_ : nom de l'option à rechercher +* _config_file_ : pointeur vers le fichier de configuration +* _section_ : pointeur vers la section +* _name_ : nom de l'option à rechercher -Valeur de retour : +Valeur de retour : * pointeur vers l'option trouvée, NULL si l'option n'a pas été trouvée -Exemple en C : +Exemple en C : [source,C] ---- @@ -5022,7 +5022,7 @@ struct t_config_option *option = weechat_config_search_option (config_file, section, "option"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5038,7 +5038,7 @@ option = weechat.config_search_option(config_file, section, "option") Rechercher une section et une option dans un fichier de configuration ou une section. -Prototype : +Prototype : [source,C] ---- @@ -5049,17 +5049,17 @@ void weechat_config_search_section_option (struct t_config_file *config_file, struct t_config_option **option_found); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration -* _section_ : pointeur vers la section -* _option_name_ : nom de l'option -* _section_ : pointeur vers un pointeur sur une section, sera alimenté avec le +* _config_file_ : pointeur vers le fichier de configuration +* _section_ : pointeur vers la section +* _option_name_ : nom de l'option +* _section_ : pointeur vers un pointeur sur une section, sera alimenté avec le pointeur vers la section de l'option trouvée -* _option_ : pointeur vers un pointeur sur une option, sera alimenté avec le +* _option_ : pointeur vers un pointeur sur une option, sera alimenté avec le pointeur vers l'option trouvée -Exemple en C : +Exemple en C : [source,C] ---- @@ -5089,7 +5089,7 @@ Cette fonction n'est pas disponible dans l'API script. Retourner des infos sur fichier/section/option pour une option avec le nom complet. -Prototype : +Prototype : [source,C] ---- @@ -5100,20 +5100,20 @@ void weechat_config_search_with_string (const char *option_name, char **pos_option_name); ---- -Paramètres : +Paramètres : -* _option_name_ : nom complet de l'option (format : "fichier.section.option") -* _config_file_ : pointeur vers un pointeur sur un fichier de configuration, +* _option_name_ : nom complet de l'option (format : "fichier.section.option") +* _config_file_ : pointeur vers un pointeur sur un fichier de configuration, sera alimenté avec le pointeur vers le fichier de configuration de l'option trouvée -* _section_ : pointeur vers un pointeur sur une section, sera alimenté avec le +* _section_ : pointeur vers un pointeur sur une section, sera alimenté avec le pointeur vers la section de l'option trouvée -* _option_ : pointeur vers un pointeur sur une option, sera alimenté avec le +* _option_ : pointeur vers un pointeur sur une option, sera alimenté avec le pointeur vers l'option trouvée -* _pos_option_name_ : pointeur vers un pointeur sur une chaîne, sera alimenté +* _pos_option_name_ : pointeur vers un pointeur sur une chaîne, sera alimenté avec le pointeur vers le nom de l'option trouvée -Exemple en C : +Exemple en C : [source,C] ---- @@ -5144,23 +5144,23 @@ Cette fonction n'est pas disponible dans l'API script. Vérifier si un texte est "vrai" ou "faux", au sens booléen. -Prototype : +Prototype : [source,C] ---- int weechat_config_string_to_boolean (const char *text); ---- -Paramètres : +Paramètres : -* _text_ : texte à analyser +* _text_ : texte à analyser -Valeur de retour : +Valeur de retour : * 1 si le texte est "vrai" ("on", "yes", "y", "true", "t", "1") * 0 si le texte est "faux" ("off", "no", "n", "false", "f", "0") -Exemple en C : +Exemple en C : [source,C] ---- @@ -5174,7 +5174,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5190,7 +5190,7 @@ if weechat.config_string_to_boolean(text): Réinitialiser une option à sa valeur par défaut. -Prototype : +Prototype : [source,C] ---- @@ -5198,20 +5198,20 @@ int weechat_config_option_reset (struct t_config_option *option, int run_callback); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option -* _run_callback_ : 1 pour appeler le "callback" si la valeur de l'option est +* _option_ : pointeur vers l'option +* _run_callback_ : 1 pour appeler le "callback" si la valeur de l'option est changée, sinon 0 -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_OPTION_SET_OK_CHANGED_ si la valeur de l'option a été réinitialisée * _WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE_ si la valeur n'a pas changé * _WEECHAT_CONFIG_OPTION_SET_ERROR_ en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -5229,7 +5229,7 @@ switch (weechat_config_option_reset (option, 1)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5250,7 +5250,7 @@ elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_ERROR: Affecter une nouvelle valeur pour une option. -Prototype : +Prototype : [source,C] ---- @@ -5258,20 +5258,20 @@ int weechat_config_option_set (struct t_config_option *option, const char *value, int run_callback); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option -* _value_ : nouvelle valeur pour l'option -* _run_callback_ : 1 pour appeler le "callback" si la valeur de l'option est +* _option_ : pointeur vers l'option +* _value_ : nouvelle valeur pour l'option +* _run_callback_ : 1 pour appeler le "callback" si la valeur de l'option est changée, sinon 0 -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_OPTION_SET_OK_CHANGED_ si la valeur de l'option a été changée * _WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE_ si la valeur n'a pas changé * _WEECHAT_CONFIG_OPTION_SET_ERROR_ en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -5289,7 +5289,7 @@ switch (weechat_config_option_set (option, "nouvelle_valeur", 1)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5310,7 +5310,7 @@ elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_ERROR: Affecter "null" (valeur indéfinie) à une option. -Prototype : +Prototype : [source,C] ---- @@ -5318,23 +5318,23 @@ int weechat_config_option_set_null (struct t_config_option *option, int run_callback); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option -* _run_callback_ : 1 pour appeler le "callback" si la valeur de l'option est +* _option_ : pointeur vers l'option +* _run_callback_ : 1 pour appeler le "callback" si la valeur de l'option est changée (elle n'était pas "null"), sinon 0 [NOTE] Vous pouvez affecter "null" à une option seulement si c'est autorisé pour l'option (voir <<_config_new_option,config_new_option>>). -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_OPTION_SET_OK_CHANGED_ si la valeur de l'option a été changée * _WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE_ si la valeur n'a pas changé * _WEECHAT_CONFIG_OPTION_SET_ERROR_ en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -5352,7 +5352,7 @@ switch (weechat_config_option_set_null (option, 1)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5373,18 +5373,18 @@ elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_ERROR: Réinitialiser ou supprimer une option. -Prototype : +Prototype : [source,C] ---- int weechat_config_option_unset (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET_ si la valeur de l'option n'a pas été réinitialisée @@ -5393,7 +5393,7 @@ Valeur de retour : * _WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED_ si l'option a été supprimée * _WEECHAT_CONFIG_OPTION_UNSET_ERROR_ en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -5414,7 +5414,7 @@ switch (weechat_config_option_unset (option)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5437,7 +5437,7 @@ elif rc == weechat.WEECHAT_CONFIG_OPTION_UNSET_ERROR: Renommer une option. -Prototype : +Prototype : [source,C] ---- @@ -5445,19 +5445,19 @@ void weechat_config_option_rename (struct t_config_option *option, const char *new_name); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option -* _new_name_ : nouveau nom pour l'option +* _option_ : pointeur vers l'option +* _new_name_ : nouveau nom pour l'option -Exemple en C : +Exemple en C : [source,C] ---- weechat_config_option_rename (option, "nouveau_nom"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5472,7 +5472,7 @@ weechat.config_option_rename(option, "nouveau_nom") Retourner un pointeur vers une propriété de l'option. -Prototype : +Prototype : [source,C] ---- @@ -5480,32 +5480,32 @@ void *weechat_config_option_get_pointer (struct t_config_option *option, const char *property); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option -* _property_ : nom de la propriété : -** _config_file_ : pointeur vers le fichier de configuration +* _option_ : pointeur vers l'option +* _property_ : nom de la propriété : +** _config_file_ : pointeur vers le fichier de configuration (_struct t_config_file *_) -** _section_ : pointeur vers la section (_struct t_config_section *_) -** _name_ : nom de l'option (_char *_) -** _parent_name_ : nom de l'option parente (_char *_) _(WeeChat ≥ 1.4)_ -** _type_ : type de l'option (_int *_) -** _description_ : description de l'option (_char *_) -** _string_values_ : valeurs sous forme de chaîne (_char *_) -** _min_ : valeur minimum (_int *_) -** _max_ : valeur maximum (_int *_) -** _default_value_ : valeur par défaut (dépend du type) -** _value_ : valeur courante (dépend du type) -** _prev_option_ : pointeur vers l'option précédente +** _section_ : pointeur vers la section (_struct t_config_section *_) +** _name_ : nom de l'option (_char *_) +** _parent_name_ : nom de l'option parente (_char *_) _(WeeChat ≥ 1.4)_ +** _type_ : type de l'option (_int *_) +** _description_ : description de l'option (_char *_) +** _string_values_ : valeurs sous forme de chaîne (_char *_) +** _min_ : valeur minimum (_int *_) +** _max_ : valeur maximum (_int *_) +** _default_value_ : valeur par défaut (dépend du type) +** _value_ : valeur courante (dépend du type) +** _prev_option_ : pointeur vers l'option précédente (_struct t_config_option *_) -** _next_option_ : pointeur vers l'option suivante +** _next_option_ : pointeur vers l'option suivante (_struct t_config_option *_) -Valeur de retour : +Valeur de retour : * pointeur vers la propriété demandée -Exemple en C : +Exemple en C : [source,C] ---- @@ -5519,23 +5519,23 @@ Cette fonction n'est pas disponible dans l'API script. Vérifier si une option est "null" (valeur non définie). -Prototype : +Prototype : [source,C] ---- int weechat_config_option_is_null (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour : +Valeur de retour : * 1 si la valeur de l'option est "null" * 0 si la valeur de l'option n'est pas "null" -Exemple en C : +Exemple en C : [source,C] ---- @@ -5549,7 +5549,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5565,23 +5565,23 @@ if weechat.config_option_is_null(option): Vérifier si la valeur par défaut d'une option est "null" (valeur non définie). -Prototype : +Prototype : [source,C] ---- int weechat_config_option_default_is_null (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour : +Valeur de retour : * 1 si la valeur par défaut de l'option est "null" * 0 si la valeur par défaut de l'option n'est pas "null" -Exemple en C : +Exemple en C : [source,C] ---- @@ -5595,7 +5595,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5611,25 +5611,25 @@ if weechat.config_option_default_is_null(option): Retourner la valeur booléenne de l'option. -Prototype : +Prototype : [source,C] ---- int weechat_config_boolean (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de l'option : +Valeur de retour, selon le type de l'option : -* _boolean_ : valeur booléenne de l'option (0 ou 1) -* _integer_ : 0 -* _string_ : 0 -* _color_ : 0 +* _boolean_ : valeur booléenne de l'option (0 ou 1) +* _integer_ : 0 +* _string_ : 0 +* _color_ : 0 -Exemple en C : +Exemple en C : [source,C] ---- @@ -5644,7 +5644,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5661,25 +5661,25 @@ if weechat.config_boolean(option): Retourner la valeur booléenne par défaut de l'option. -Prototype : +Prototype : [source,C] ---- int weechat_config_boolean_default (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de 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_ : 0 -* _string_ : 0 -* _color_ : 0 +* _boolean_ : valeur booléenne par défaut de l'option (0 ou 1) +* _integer_ : 0 +* _string_ : 0 +* _color_ : 0 -Exemple en C : +Exemple en C : [source,C] ---- @@ -5694,7 +5694,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5711,25 +5711,25 @@ if weechat.config_boolean_default(option): Retourner la valeur entière de l'option. -Prototype : +Prototype : [source,C] ---- int weechat_config_integer (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de 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 +* _boolean_ : valeur booléenne de l'option (0 ou 1) +* _integer_ : valeur entière de l'option +* _string_ : 0 +* _color_ : index de la couleur -Exemple en C : +Exemple en C : [source,C] ---- @@ -5737,7 +5737,7 @@ struct t_config_option *option = weechat_config_get ("plugin.section.option"); int value = weechat_config_integer (option); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5753,25 +5753,25 @@ value = weechat.config_integer(option) Retourner la valeur entière par défaut de l'option. -Prototype : +Prototype : [source,C] ---- int weechat_config_integer_default (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de 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 +* _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 -Exemple en C : +Exemple en C : [source,C] ---- @@ -5779,7 +5779,7 @@ struct t_config_option *option = weechat_config_get ("plugin.section.option"); int value = weechat_config_integer_default (option); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5795,26 +5795,26 @@ value = weechat.config_integer_default(option) Retourner la valeur de l'option, sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- const char *weechat_config_string (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de l'option : +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 +* _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 -* _string_ : valeur de l'option sous forme de chaîne -* _color_ : nom de la couleur +* _string_ : valeur de l'option sous forme de chaîne +* _color_ : nom de la couleur -Exemple en C : +Exemple en C : [source,C] ---- @@ -5822,7 +5822,7 @@ struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *value = weechat_config_string (option); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5838,26 +5838,26 @@ value = weechat.config_string(option) Retourner la valeur par défaut de l'option, sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- const char *weechat_config_string_default (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de l'option : +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 +* _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 -* _string_ : valeur par défaut de l'option sous forme de chaîne -* _color_ : nom de la couleur par défaut +* _string_ : valeur par défaut de l'option sous forme de chaîne +* _color_ : nom de la couleur par défaut -Exemple en C : +Exemple en C : [source,C] ---- @@ -5865,7 +5865,7 @@ struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *value = weechat_config_string_default (option); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5881,25 +5881,25 @@ value = weechat.config_string_default(option) Retourner la valeur de l'option, sous forme de couleur. -Prototype : +Prototype : [source,C] ---- const char *weechat_config_color (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de l'option : +Valeur de retour, selon le type de l'option : -* _boolean_ : NULL -* _integer_ : NULL -* _string_ : NULL -* _color_ : nom de la couleur +* _boolean_ : NULL +* _integer_ : NULL +* _string_ : NULL +* _color_ : nom de la couleur -Exemple en C : +Exemple en C : [source,C] ---- @@ -5907,7 +5907,7 @@ struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *color = weechat_config_color (option); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5923,25 +5923,25 @@ value = weechat.config_color(option) Retourner la valeur par défaut de l'option, sous forme de couleur. -Prototype : +Prototype : [source,C] ---- const char *weechat_config_color_default (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de l'option : +Valeur de retour, selon le type de l'option : -* _boolean_ : NULL -* _integer_ : NULL -* _string_ : NULL -* _color_ : nom de la couleur par défaut +* _boolean_ : NULL +* _integer_ : NULL +* _string_ : NULL +* _color_ : nom de la couleur par défaut -Exemple en C : +Exemple en C : [source,C] ---- @@ -5949,7 +5949,7 @@ struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *color = weechat_config_color_default (option); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5967,7 +5967,7 @@ value = weechat.config_color_default(option) (cette fonction doit être appelée uniquement dans un "callback" "write" ou "write_default" pour une section). -Prototype : +Prototype : [source,C] ---- @@ -5975,12 +5975,12 @@ void weechat_config_write_option (struct t_config_file *config_file, struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration -* _option_ : pointeur vers l'option +* _config_file_ : pointeur vers le fichier de configuration +* _option_ : pointeur vers l'option -Exemple en C : +Exemple en C : [source,C] ---- @@ -5997,7 +5997,7 @@ my_section_write_cb (const void *pointer, void *data, } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6017,7 +6017,7 @@ def my_section_write_cb(data, config_file, section_name): appelée uniquement dans un "callback" "write" ou "write_default" pour une section). -Prototype : +Prototype : [source,C] ---- @@ -6026,14 +6026,14 @@ void weechat_config_write_line (struct t_config_file *config_file, const char *value, ...); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration -* _option_name_ : nom de l'option -* _value_ : valeur (si NULL, alors la ligne est écrite avec le nom de la - section, par exemple : "[section]") +* _config_file_ : pointeur vers le fichier de configuration +* _option_name_ : nom de l'option +* _value_ : valeur (si NULL, alors la ligne est écrite avec le nom de la + section, par exemple : "[section]") -Exemple en C : +Exemple en C : [source,C] ---- @@ -6051,7 +6051,7 @@ my_section_write_cb (const void *pointer, void *data, } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6069,24 +6069,24 @@ def my_section_write_cb(data, config_file, section_name): Écrire un fichier de configuration sur le disque. -Prototype : +Prototype : [source,C] ---- int weechat_config_write (struct t_config_file *config_file); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration. +* _config_file_ : pointeur vers le fichier de configuration. -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_WRITE_OK_ si la configuration a été écrite * _WEECHAT_CONFIG_WRITE_MEMORY_ERROR_ s'il n'y a pas eu suffisamment de mémoire * _WEECHAT_CONFIG_WRITE_ERROR_ si une autre erreur s'est produite -Exemple en C : +Exemple en C : [source,C] ---- @@ -6104,7 +6104,7 @@ switch (weechat_config_write (config_file)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6125,24 +6125,24 @@ elif rc == weechat.WEECHAT_CONFIG_WRITE_ERROR: Lire un fichier de configuration depuis le disque. -Prototype : +Prototype : [source,C] ---- int weechat_config_read (struct t_config_file *config_file); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration +* _config_file_ : pointeur vers le fichier de configuration -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_READ_OK_ si la configuration a été chargée * _WEECHAT_CONFIG_READ_MEMORY_ERROR_ s'il n'y a pas eu suffisamment de mémoire * _WEECHAT_CONFIG_READ_FILE_NOT_FOUND_ si le fichier n'a pas été trouvé -Exemple en C : +Exemple en C : [source,C] ---- @@ -6160,7 +6160,7 @@ switch (weechat_config_read (config_file)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6181,24 +6181,24 @@ elif rc == weechat.WEECHAT_CONFIG_READ_FILE_NOT_FOUND: Relire un fichier de configuration depuis le disque. -Prototype : +Prototype : [source,C] ---- int weechat_config_reload (struct t_config_file *config_file); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration +* _config_file_ : pointeur vers le fichier de configuration -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_READ_OK_ si la configuration a été rechargée * _WEECHAT_CONFIG_READ_MEMORY_ERROR_ s'il n'y a pas eu suffisamment de mémoire * _WEECHAT_CONFIG_READ_FILE_NOT_FOUND_ si le fichier n'a pas été trouvé -Exemple en C : +Exemple en C : [source,C] ---- @@ -6216,7 +6216,7 @@ switch (weechat_config_reload (config_file)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6237,25 +6237,25 @@ elif rc == weechat.WEECHAT_CONFIG_READ_FILE_NOT_FOUND: Supprimer une option. -Prototype : +Prototype : [source,C] ---- void weechat_config_option_free (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Exemple en C : +Exemple en C : [source,C] ---- weechat_config_option_free (option); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6270,25 +6270,25 @@ weechat.config_option_free(option) Supprimer toutes les options dans une section. -Prototype : +Prototype : [source,C] ---- void weechat_config_section_free_options (struct t_config_section *section); ---- -Paramètres : +Paramètres : -* _section_ : pointeur vers la section +* _section_ : pointeur vers la section -Exemple en C : +Exemple en C : [source,C] ---- weechat_config_section_free_options (section); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6303,25 +6303,25 @@ weechat.config_section_free_options(section) Supprimer une section. -Prototype : +Prototype : [source,C] ---- void weechat_config_section_free (struct t_config_section *section); ---- -Paramètres : +Paramètres : -* _section_ : pointeur vers la section +* _section_ : pointeur vers la section -Exemple en C : +Exemple en C : [source,C] ---- weechat_config_section_free (section); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6336,25 +6336,25 @@ weechat.config_section_free(section) Supprimer un fichier de configuration. -Prototype : +Prototype : [source,C] ---- void weechat_config_free (struct t_config_file *config_file); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration +* _config_file_ : pointeur vers le fichier de configuration -Exemple en C : +Exemple en C : [source,C] ---- weechat_config_free (config_file); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6369,29 +6369,29 @@ weechat.config_free(config_file) Rechercher une option avec le nom complet. -Prototype : +Prototype : [source,C] ---- struct t_config_option *weechat_config_get (const char *option_name); ---- -Paramètres : +Paramètres : -* _option_name_ : nom complet de l'option (format : "fichier.section.option") +* _option_name_ : nom complet de l'option (format : "fichier.section.option") -Valeur de retour : +Valeur de retour : * pointeur vers l'option trouvée, NULL si l'option n'a pas été trouvée -Exemple en C : +Exemple en C : [source,C] ---- struct t_config_option *option = weechat_config_get ("weechat.look.item_time_format"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6407,23 +6407,23 @@ option = weechat.config_get("weechat.look.item_time_format") Rechercher une option dans le fichier de configuration des extensions (plugins.conf). -Prototype : +Prototype : [source,C] ---- const char *weechat_config_get_plugin (const char *option_name); ---- -Paramètres : +Paramètres : -* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe +* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe "plugins.var.xxx." (où "xxx" est le nom de l'extension courante) -Valeur de retour : +Valeur de retour : * valeur de l'option trouvée, NULL si l'option n'a pas été trouvée -Exemple en C : +Exemple en C : [source,C] ---- @@ -6432,7 +6432,7 @@ Exemple en C : char *value = weechat_config_get_plugin ("option"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6448,23 +6448,23 @@ value = weechat.config_get_plugin("option") Vérifier si une option existe dans le fichier de configuration des extensions (plugins.conf). -Prototype : +Prototype : [source,C] ---- int weechat_config_is_set_plugin (const char *option_name); ---- -Paramètres : +Paramètres : -* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe +* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe "plugins.var.xxx." (où "xxx" est le nom de l'extension courante) -Valeur de retour : +Valeur de retour : * 1 si l'option est définie, 0 si l'option n'existe pas -Exemple en C : +Exemple en C : [source,C] ---- @@ -6478,7 +6478,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6499,27 +6499,27 @@ else: Affecter une nouvelle valeur pour une option dans le fichier de configuration des extensions (plugins.conf). -Prototype : +Prototype : [source,C] ---- int weechat_config_set_plugin (const char *option_name, const char *value); ---- -Paramètres : +Paramètres : -* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe +* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe "plugins.var.xxx." (où "xxx" est le nom de l'extension courante) -* _value_ : nouvelle valeur pour l'option +* _value_ : nouvelle valeur pour l'option -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_OPTION_SET_OK_CHANGED_ si la valeur de l'option a été changée * _WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE_ si la valeur n'a pas changé * _WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND_ si l'option n'a pas été trouvée * _WEECHAT_CONFIG_OPTION_SET_ERROR_ en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -6540,7 +6540,7 @@ switch (weechat_config_set_plugin ("option", "valeur_test")) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6566,7 +6566,7 @@ _WeeChat ≥ 0.3.5._ Affecter une description pour une option dans le fichier de configuration des extensions (plugins.conf). -Prototype : +Prototype : [source,C] ---- @@ -6574,24 +6574,24 @@ void weechat_config_set_desc_plugin (const char *option_name, const char *description); ---- -Paramètres : +Paramètres : -* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe +* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe "plugins.desc.xxx." (où "xxx" est le nom de l'extension courante) -* _description_ : description pour l'option +* _description_ : description pour l'option [NOTE] Ce n'est pas un problème si l'option (plugins.var.xxx.option_name) n'existe pas. Une création future de cette option utilisera cette description. -Exemple en C : +Exemple en C : [source,C] ---- weechat_config_set_desc_plugin ("option", "description de l'option"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6608,19 +6608,19 @@ if int(version) >= 0x00030500: Supprimer une option du fichier de configuration des extensions (plugins.conf). -Prototype : +Prototype : [source,C] ---- int weechat_config_unset_plugin (const char *option_name); ---- -Paramètres : +Paramètres : -* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe +* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe "plugins.var.xxx." (où "xxx" est le nom de l'extension courante) -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET_ si la valeur de l'option n'a pas été réinitialisée @@ -6629,7 +6629,7 @@ Valeur de retour : * _WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED_ si l'option a été supprimée * _WEECHAT_CONFIG_OPTION_UNSET_ERROR_ en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -6650,7 +6650,7 @@ switch (weechat_config_unset_plugin ("option")) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6685,28 +6685,28 @@ Contrairement à la commande `/key bind`, cette fonction ne changera jamais une association de touche existante, seulement des nouvelles touches seront créées. Pour supprimer une association de touche, utilisez <<_key_unbind,key_unbind>>. -Prototype : +Prototype : [source,C] ---- int weechat_key_bind (const char *context, struct t_hashtable *keys); ---- -Paramètres : +Paramètres : -* _context_ : contexte pour les touches : -** _default_ : contexte par défaut (actions courantes) -** _search_ : contexte de recherche (lors de la recherche de texte dans le +* _context_ : contexte pour les touches : +** _default_ : contexte par défaut (actions courantes) +** _search_ : contexte de recherche (lors de la recherche de texte dans le tampon) -** _cursor_ : mouvement libre du curseur à l'écran -** _mouse_ : touches pour les évènements de souris -* _keys_ : table de hachage avec les associations de touches +** _cursor_ : mouvement libre du curseur à l'écran +** _mouse_ : touches pour les évènements de souris +* _keys_ : table de hachage avec les associations de touches -Valeur de retour : +Valeur de retour : * nombre d'associations de touches ajoutées -Exemple en C : +Exemple en C : [source,C] ---- @@ -6725,7 +6725,7 @@ if (keys) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6749,24 +6749,24 @@ Supprimer une/des association(s) de touche(s). Lors de l'appel à cette fonction, assurez-vous que vous n'allez pas supprimer une touche définie par l'utilisateur. -Prototype : +Prototype : [source,C] ---- int weechat_key_unbind (const char *context, const char *key); ---- -Paramètres : +Paramètres : -* _context_ : contexte pour les touches (voir <<_key_bind,key_bind>>) -* _key_ : touche à supprimer ou la valeur spéciale "area:XXX" pour supprimer +* _context_ : contexte pour les touches (voir <<_key_bind,key_bind>>) +* _key_ : touche à supprimer ou la valeur spéciale "area:XXX" pour supprimer toutes les touches ayant _XXX_ comme première ou deuxième zone -Valeur de retour : +Valeur de retour : * nombre d'associations de touches supprimées -Exemples en C : +Exemples en C : [source,C] ---- @@ -6777,7 +6777,7 @@ weechat_key_unbind ("mouse", "@chat(plugin.buffer):button1"); weechat_key_unbind ("mouse", "area:chat(plugin.buffer)"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6802,23 +6802,23 @@ Fonctions pour afficher du texte dans les tampons. Retourner un préfixe. -Prototype : +Prototype : [source,C] ---- const char *weechat_prefix (const char *prefix); ---- -Paramètres : +Paramètres : -* _prefix_ : nom du préfixe (voir le tableau ci-dessous) +* _prefix_ : nom du préfixe (voir le tableau ci-dessous) -Valeur de retour : +Valeur de retour : * valeur du préfixe (chaîne avec le préfixe et des codes couleur), chaîne vide si le préfixe n'a pas été trouvé -Liste des préfixes : +Liste des préfixes : [width="70%",cols="^2m,^1,^3,5",options="header"] |=== @@ -6833,14 +6833,14 @@ Liste des préfixes : [NOTE] Les valeurs et couleurs peuvent être configurées avec la commande `/set`. -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (NULL, "%sCeci est une erreur...", weechat_prefix ("error")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6855,78 +6855,78 @@ weechat.prnt("", "%sCeci est une erreur..." % weechat.prefix("error")) Retourner une chaîne avec un code couleur pour affichage. -Prototype : +Prototype : [source,C] ---- const char *weechat_color (const char *color_name); ---- -Paramètres : +Paramètres : -* _color_name_ : nom de la couleur, parmi : +* _color_name_ : nom de la couleur, parmi : ** le nom d'une option de couleur WeeChat (de weechat.color.xxx), par exemple _chat_delimiters_ -** le nom d'une option (format : fichier.section.option), par exemple +** le nom d'une option (format : fichier.section.option), par exemple _irc.color.message_quit_ (_WeeChat ≥ 1.2_) ** une couleur avec des attributs/fond optionnels (voir ci-dessous) -** un attribut : -*** _bold_ : activer le gras -*** _-bold_ : désactiver le gras -*** _reverse_ : activer la vidéo inverse -*** _-reverse_ : désactiver la vidéo inverse -*** _italic_ : activer l'italique -*** _-italic_ : désactiver l'italique -*** _underline_ : activer le souligné -*** _-underline_ : désactiver le souligné -*** _emphasis_ : activer/désactiver la mise en valeur du texte (note : cela ne +** un attribut : +*** _bold_ : activer le gras +*** _-bold_ : désactiver le gras +*** _reverse_ : activer la vidéo inverse +*** _-reverse_ : désactiver la vidéo inverse +*** _italic_ : activer l'italique +*** _-italic_ : désactiver l'italique +*** _underline_ : activer le souligné +*** _-underline_ : désactiver le souligné +*** _emphasis_ : activer/désactiver la mise en valeur du texte (note : cela ne devrait être utilisé que dans les barres, car WeeChat utilise la mise en valeur du texte lors de la recherche de texte dans le tampon) _(WeeChat ≥ 0.4.2)_ -** nom d'une couleur de barre : -*** _bar_fg_ : couleur de texte pour la barre -*** _bar_delim_ : couleur des délimiteurs pour la barre -*** _bar_bg_ : couleur de fond pour la barre -** réinitialisation : -*** _reset_ : réinitialiser la couleur et les attributs -*** _resetcolor_ : réinitialiser la couleur (garder les attributs) +** nom d'une couleur de barre : +*** _bar_fg_ : couleur de texte pour la barre +*** _bar_delim_ : couleur des délimiteurs pour la barre +*** _bar_bg_ : couleur de fond pour la barre +** réinitialisation : +*** _reset_ : réinitialiser la couleur et les attributs +*** _resetcolor_ : réinitialiser la couleur (garder les attributs) _(WeeChat ≥ 0.3.6)_ -Le format de la couleur est : attributs (optionnel) + nom de couleur + ",fond" -(optionnel). Les attributs possibles sont : +Le format de la couleur est : attributs (optionnel) + nom de couleur + ",fond" +(optionnel). Les attributs possibles sont : -* `+*+` : texte gras -* `+!+` : mode vidéo inverse -* `+/+` : italique -* `+_+` : texte souligné -* `+|+` : garder les attributs : ne pas réinitialiser +* `+*+` : texte gras +* `+!+` : mode vidéo inverse +* `+/+` : italique +* `+_+` : texte souligné +* `+|+` : garder les attributs : ne pas réinitialiser gras/inverse/italique/souligné lors du changement de couleur _(WeeChat ≥ 0.3.6)_ -Exemples : +Exemples : -* `+yellow+` : jaune -* `+_green+` : vert souligné -* `+*214+` : orange gras -* `+yellow,red+` : jaune sur rouge -* `+|cyan+` : cyan (et garder tout attribut définit précédemment) +* `+yellow+` : jaune +* `+_green+` : vert souligné +* `+*214+` : orange gras +* `+yellow,red+` : jaune sur rouge +* `+|cyan+` : cyan (et garder tout attribut définit précédemment) -Valeur de retour : +Valeur de retour : * chaîne avec le code couleur, ou une chaîne vide si la couleur n'a pas été trouvée -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "Couleur : %sbleu %scouleur par défaut %sjaune sur rouge", +weechat_printf (NULL, "Couleur : %sbleu %scouleur par défaut %sjaune sur rouge", weechat_color ("blue"), weechat_color ("chat"), weechat_color ("yellow,red")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6934,7 +6934,7 @@ Script (Python) : value = weechat.color(color_name) # exemple -weechat.prnt("", "Couleur : %sbleu %scouleur par défaut %sjaune sur rouge" +weechat.prnt("", "Couleur : %sbleu %scouleur par défaut %sjaune sur rouge" % (weechat.color("blue"), weechat.color("chat"), weechat.color("yellow,red"))) ---- @@ -6942,7 +6942,7 @@ weechat.prnt("", "Couleur : %sbleu %scouleur par défaut %sjaune sur rouge" Afficher un message sur un tampon. -Prototype : +Prototype : [source,C] ---- @@ -6950,7 +6950,7 @@ void weechat_printf (struct t_gui_buffer *buffer, const char *message, ...); ---- Cette fonction est un raccourci vers la fonction printf_date_tags. Ces deux appels -donnent exactement le même résultat : +donnent exactement le même résultat : [source,C] ---- @@ -6958,17 +6958,17 @@ weechat_printf (buffer, "message"); weechat_printf_date_tags (buffer, 0, NULL, "message"); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon, si NULL, le message est affiché sur le +* _buffer_ : pointeur vers le tampon, si NULL, le message est affiché sur le tampon WeeChat -* _message_ : message à afficher +* _message_ : message à afficher [NOTE] La première tabulation dans le message ("\t") est utilisée pour séparer le préfixe du message. + Si votre message contient des tabulations et si vous ne voulez pas de préfixe, -utilisez un espace, une tabulation, puis le message : cela désactivera le +utilisez un espace, une tabulation, puis le message : cela désactivera le préfixe (l'espace avant la tabulation ne sera pas affiché). [NOTE] @@ -6976,7 +6976,7 @@ Avec deux tabulations ("\t") au début du message, l'heure ne sera pas affichée et le message n'aura pas d'alignement. De plus, la date dans le message sera positionnée à 0. -Exemple en C : +Exemple en C : [source,C] ---- @@ -6988,7 +6988,7 @@ weechat_printf (buffer, "\t\tMessage sans heure/alignement"); weechat_printf (buffer, "\t\t"); /* ligne vide (sans heure) */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7012,7 +7012,7 @@ La fonction s'appelle "print" dans les scripts ("prnt" en Python). Afficher un message sur un tampon, en utilisant une date et des étiquettes personnalisées. -Prototype : +Prototype : [source,C] ---- @@ -7020,19 +7020,19 @@ void weechat_printf_date_tags (struct t_gui_buffer *buffer, time_t date, const char *tags, const char *message, ...); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon, si NULL, le message est affiché sur le +* _buffer_ : pointeur vers le tampon, si NULL, le message est affiché sur le tampon Weechat -* _date_ : date pour le message (0 signifie la date/heure courante) -* _tags_ : liste d'étiquettes séparées par des virgules (NULL signifie aucune +* _date_ : date pour le message (0 signifie la date/heure courante) +* _tags_ : liste d'étiquettes séparées par des virgules (NULL signifie aucune étiquette) -* _message_ : message à afficher +* _message_ : message à afficher Voir le chapitre sur les étiquettes des lignes dans le _Guide utilisateur WeeChat_ pour une liste des étiquettes couramment utilisées dans WeeChat. -Exemple en C : +Exemple en C : [source,C] ---- @@ -7040,7 +7040,7 @@ weechat_printf_date_tags (NULL, time (NULL) - 120, "notify_message", "Message il y a 2 minutes avec une étiquette 'notify_message'"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7061,7 +7061,7 @@ Python). Afficher un message sur une ligne d'un tampon avec contenu libre. -Prototype : +Prototype : [source,C] ---- @@ -7069,24 +7069,24 @@ void weechat_printf_y (struct t_gui_buffer *buffer, int y, const char *message, ...); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _y_ : numéro de ligne (la première ligne est 0); une valeur négative affiche - une ligne après la dernière ligne affichée : la valeur absolue de _y_ est le +* _buffer_ : pointeur vers le tampon +* _y_ : numéro de ligne (la première ligne est 0); une valeur négative affiche + une ligne après la dernière ligne affichée : la valeur absolue de _y_ est le nombre de lignes après la dernière ligne (par exemple -1 est immédiatement après la dernière ligne, -2 est 2 lignes après la dernière ligne) _(WeeChat ≥ 1.0)_ -* _message_ : message à afficher +* _message_ : message à afficher -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf_y (buffer, 2, "Mon message sur la 3ème ligne"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7104,25 +7104,25 @@ La fonction s'appelle "print_y" dans les scripts ("prnt_y" en Python). Écrire un message dans le fichier de log WeeChat (weechat.log). -Prototype : +Prototype : [source,C] ---- void weechat_log_printf (const char *message, ...); ---- -Paramètres : +Paramètres : -* _message_ : message à écrire +* _message_ : message à écrire -Exemple en C : +Exemple en C : [source,C] ---- weechat_log_printf ("Mon message dans le fichier log"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7151,13 +7151,13 @@ trouvé et exécuté avant les autres "hooks". Cela est pratique pour les modificateurs, car l'ordre d'exécution est important. Pour définir une priorité, vous devez utiliser cette syntaxe, pour un paramètre -où la priorité est autorisée : "nnn|nom" où "nnn" est un entier positif ou nul +où la priorité est autorisée : "nnn|nom" où "nnn" est un entier positif ou nul avec la priorité et "nom" le nom pour le paramètre (la priorité n'apparaît pas dans le nom, elle est automatiquement retirée de la chaîne). La priorité par défaut est 1000. -Exemple en C : +Exemple en C : [source,C] ---- @@ -7165,7 +7165,7 @@ Exemple en C : weechat_hook_modifier ("2000|input_text_display", &modifier_cb, NULL, NULL); ---- -Les types de "hooks" suivants autorisent une priorité : command, command_run, +Les types de "hooks" suivants autorisent une priorité : command, command_run, signal, hsignal, config, completion, modifier, info, info_hashtable, infolist, hdata, focus. @@ -7175,7 +7175,7 @@ _Mis à jour dans la 1.5, 1.7._ Accrocher une commande. -Prototype : +Prototype : [source,C] ---- @@ -7194,30 +7194,30 @@ struct t_hook *weechat_hook_command (const char *command, void *callback_data); ---- -Paramètres : +Paramètres : -* _command_ : nom de la commande +* _command_ : nom de la commande (priorité autorisée, voir la note sur la <<hook_priority,priorité>>) -* _description_ : description de la commande (affiché avec `/help command`) -* _args_ : paramètres pour la commande (affichés avec `/help command`) -* _args_description_ : description des paramètres (affichée avec +* _description_ : description de la commande (affiché avec `/help command`) +* _args_ : paramètres pour la commande (affichés avec `/help command`) +* _args_description_ : description des paramètres (affichée avec `/help command`) -* _completion_ : modèle pour la complétion de la commande (voir le format ci-dessous) -* _callback_ : fonction appelée lorsque la commande est utilisée, paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_gui_buffer *buffer_ : tampon où la commande est exécutée -** _int argc_ : nombre de paramètres passés à la commande -** _char **argv_ : paramètres pour la commande -** _char **argv_eol_ : paramètres pour la commande (jusqu'à fin de ligne pour +* _completion_ : modèle pour la complétion de la commande (voir le format ci-dessous) +* _callback_ : fonction appelée lorsque la commande est utilisée, paramètres et + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_gui_buffer *buffer_ : tampon où la commande est exécutée +** _int argc_ : nombre de paramètres passés à la commande +** _char **argv_ : paramètres pour la commande +** _char **argv_eol_ : paramètres pour la commande (jusqu'à fin de ligne pour chaque paramètre) -** valeur de retour : +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé @@ -7227,37 +7227,37 @@ séparés par des espaces. Plusieurs complétions sont possibles pour un paramè séparées par `+|+`. Plusieurs modèles de complétions sont possibles pour une même commande, séparés par `+||+`. -Le format de la complétion peut être : +Le format de la complétion peut être : -* _%(nom)_ : la complétion _nom_ -* _%(nom:paramètres)_ : la complétion _nom_ avec des _paramètres_ envoyés au +* _%(nom)_ : la complétion _nom_ +* _%(nom:paramètres)_ : la complétion _nom_ avec des _paramètres_ envoyés au « callback » _(WeeChat ≥ 1.7)_ -* toute chaîne : elle est utilisée telle quelle dans la complétion +* toute chaîne : elle est utilisée telle quelle dans la complétion Par exemple le modèle `list || add %(filters_names) || del %(filters_names)|-all` -complètera avec les valeurs suivantes dans les paramètres de commande : +complètera avec les valeurs suivantes dans les paramètres de commande : -* premier paramètre : `list`, `add` et `del` -* second paramètre, cela dépend du premier paramètre : -** `list` : rien -** `add` : noms des filtres -** `del` : noms des filtres et `-all` +* premier paramètre : `list`, `add` et `del` +* second paramètre, cela dépend du premier paramètre : +** `list` : rien +** `add` : noms des filtres +** `del` : noms des filtres et `-all` -Les codes complétions par défaut sont : +Les codes complétions par défaut sont : include::autogen/plugin_api/completions.adoc[] -Codes spéciaux : +Codes spéciaux : -* `+%%command+` : réutiliser le modèle de complétion de la commande _command_ -* `+%-+` : arrêter la complétion -* `+%*+` : répéter la dernière complétion +* `+%%command+` : réutiliser le modèle de complétion de la commande _command_ +* `+%-+` : arrêter la complétion +* `+%*+` : répéter la dernière complétion -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -7287,14 +7287,14 @@ struct t_hook *my_command_hook = ---- Par exemple, si la commande appelée est `/command abc def ghi`, alors _argv_ et -_argv_eol_ ont les valeurs suivantes : +_argv_eol_ ont les valeurs suivantes : -* _argv_ : +* _argv_ : ** _argv[0]_ == "/command" ** _argv[1]_ == "abc" ** _argv[2]_ == "def" ** _argv[3]_ == "ghi" -* _argv_eol_ : +* _argv_eol_ : ** _argv_eol[0]_ == "/command abc def ghi" ** _argv_eol[1]_ == "abc def ghi" ** _argv_eol[2]_ == "def ghi" @@ -7302,7 +7302,7 @@ _argv_eol_ ont les valeurs suivantes : Pour les scripts, _args_ a la valeur "abc def ghi". -Script (Python) : +Script (Python) : [source,python] ---- @@ -7333,7 +7333,7 @@ _Mis à jour dans la 1.5, 1.7._ Accrocher une complétion. -Prototype : +Prototype : [source,C] ---- @@ -7348,30 +7348,30 @@ struct t_hook *weechat_hook_completion (const char *completion_item, void *callback_data); ---- -Paramètres : +Paramètres : -* _completion_item_ : nom de l'objet de complétion, après vous pouvez utiliser +* _completion_item_ : nom de l'objet de complétion, après vous pouvez utiliser _%(nom)_ (ou _%(nom:paramètres)_ avec WeeChat ≥ 1.7) dans une commande (paramètre _completion_) (priorité autorisée, voir la note sur la <<hook_priority,priorité>>) -* _description_ : description de la complétion -* _callback_ : fonction appelée lorsque la complétion est utilisée +* _description_ : description de la complétion +* _callback_ : fonction appelée lorsque la complétion est utilisée (l'utilisateur est en train de compléter quelque chose qui fait appel à cette - complétion), paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *completion_item_ : nom de la complétion (avec WeeChat ≥ 1.7 il - peut inclure des paramètres, avec le format : _nom:paramètres_) -** _struct t_gui_buffer *buffer_ : tampon où la complétion est effectuée -** _struct t_gui_completion *completion_ : structure utilisée pour ajouter + complétion), paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *completion_item_ : nom de la complétion (avec WeeChat ≥ 1.7 il + peut inclure des paramètres, avec le format : _nom:paramètres_) +** _struct t_gui_buffer *buffer_ : tampon où la complétion est effectuée +** _struct t_gui_completion *completion_ : structure utilisée pour ajouter les mots pour la complétion (voir <<_hook_completion_list_add,hook_completion_list_add>>) -** valeur de retour : +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé @@ -7387,15 +7387,15 @@ Le "callback" doit seulement appeler la fonction et ne doit *PAS* mettre à jour la ligne de commande. + Pour mettre à jour la ligne de commande quand kbd:[Tab] est pressé, vous pouvez utiliser la fonction <<_hook_command_run,hook_command_run>> -avec la commande : `/input complete_next` (et vous devez retourner +avec la commande : `/input complete_next` (et vous devez retourner _WEECHAT_RC_OK_EAT_ si votre "callback" a mis à jour la ligne de commande, de sorte que WeeChat n'exécute pas la complétion). -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -7416,7 +7416,7 @@ struct t_hook *my_completion_hook = weechat_hook_completion ("extension_item", &my_completion_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7439,7 +7439,7 @@ _WeeChat ≥ 0.3.4._ Retourner la valeur d'une propriété de la complétion sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- @@ -7447,15 +7447,15 @@ const char *weechat_hook_completion_get_string (struct t_gui_completion *complet const char *property); ---- -Paramètres : +Paramètres : -* _completion_ : pointeur vers la complétion -* _property_ : nom de la propriété : -** _base_command_ : commande utilisée pour la complétion -** _base_word_ : le mot qui va être complété -** _args_ : paramètres de la commande (incluant le mot de base "base_word") +* _completion_ : pointeur vers la complétion +* _property_ : nom de la propriété : +** _base_command_ : commande utilisée pour la complétion +** _base_word_ : le mot qui va être complété +** _args_ : paramètres de la commande (incluant le mot de base "base_word") -Exemple en C : +Exemple en C : [source,C] ---- @@ -7474,7 +7474,7 @@ my_completion_cb (const void *pointer, void *data, const char *completion_item, } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7494,7 +7494,7 @@ def my_completion_cb(data, completion_item, buffer, completion): Ajouter un mot pour une complétion. -Prototype : +Prototype : [source,C] ---- @@ -7504,26 +7504,26 @@ void weechat_hook_completion_list_add (struct t_gui_completion *completion, const char *where); ---- -Paramètres : +Paramètres : -* _completion_ : pointeur vers la complétion -* _word_ : mot à ajouter -* _nick_completion_ : 1 si le mot est un pseudo, sinon 0 -* _where_ : position où sera inséré le mot dans la liste : -** _WEECHAT_LIST_POS_SORT_ : n'importe où, pour maintenir la liste triée -** _WEECHAT_LIST_POS_BEGINNING_ : au début de la liste -** _WEECHAT_LIST_POS_END_ : à la fin de la liste +* _completion_ : pointeur vers la complétion +* _word_ : mot à ajouter +* _nick_completion_ : 1 si le mot est un pseudo, sinon 0 +* _where_ : position où sera inséré le mot dans la liste : +** _WEECHAT_LIST_POS_SORT_ : n'importe où, pour maintenir la liste triée +** _WEECHAT_LIST_POS_BEGINNING_ : au début de la liste +** _WEECHAT_LIST_POS_END_ : à la fin de la liste -Exemple en C : voir <<_hook_completion,hook_completion>>. +Exemple en C : voir <<_hook_completion,hook_completion>>. -Script (Python) : +Script (Python) : [source,python] ---- # prototype weechat.hook_completion_list_add(completion, word, nick_completion, where) -# exemple : voir la fonction hook_completion ci-dessus +# exemple : voir la fonction hook_completion ci-dessus ---- ==== hook_command_run @@ -7532,7 +7532,7 @@ _Mis à jour dans la 1.5._ Intercepter une commande lorsqu'elle est exécutée par WeeChat. -Prototype : +Prototype : [source,C] ---- @@ -7545,23 +7545,23 @@ struct t_hook *weechat_hook_command_run (const char *command, void *callback_data); ---- -Paramètres : +Paramètres : -* _command_ : commande à intercepter (le caractère joker `+*+` est autorisé) +* _command_ : commande à intercepter (le caractère joker `+*+` est autorisé) (priorité autorisée, voir la note sur la <<hook_priority,priorité>>) -* _callback_ : fonction appelée lorsque la commande est exécutée, paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_gui_buffer *buffer_ : tampon où la commande est exécutée -** _const char *command_ : la commande exécutée, avec ses paramètres -** valeur de retour : +* _callback_ : fonction appelée lorsque la commande est exécutée, paramètres et + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_gui_buffer *buffer_ : tampon où la commande est exécutée +** _const char *command_ : la commande exécutée, avec ses paramètres +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_OK_EAT_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé @@ -7570,11 +7570,11 @@ Paramètres : Le "callback" peut retourner _WEECHAT_RC_OK_ ou _WEECHAT_RC_OK_EAT_ (la commande ne sera pas exécutée par WeeChat après le "callback"). -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -7591,7 +7591,7 @@ struct t_hook *my_command_run_hook = &my_command_run_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7612,7 +7612,7 @@ _Mis à jour dans la 1.5._ Accrocher un minuteur (fonction appelée à intervalles réguliers). -Prototype : +Prototype : [source,C] ---- @@ -7626,36 +7626,36 @@ struct t_hook *weechat_hook_timer (long interval, void *callback_data); ---- -Paramètres : +Paramètres : -* _interval_ : intervalle entre deux appels (en millisecondes, donc 1000 = 1 +* _interval_ : intervalle entre deux appels (en millisecondes, donc 1000 = 1 seconde) -* _align_second_ : alignement sur la seconde. Par exemple, si la date courante +* _align_second_ : alignement sur la seconde. Par exemple, si la date courante est 09:00, si l'intervalle est 60000 (60 secondes), et que align_second = 60, alors le minuteur sera appelé chaque minute quand la seconde sera 0 -* _max_calls_ : nombre maximum d'appels au minuteur (si 0, le minuteur n'a pas +* _max_calls_ : nombre maximum d'appels au minuteur (si 0, le minuteur n'a pas de fin) -* _callback_ : fonction appelée quand le délai est atteint, paramètres et valeur - de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _int remaining_calls_ : nombre d'appels restants (-1 si le minuteur n'a pas +* _callback_ : fonction appelée quand le délai est atteint, paramètres et valeur + de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _int remaining_calls_ : nombre d'appels restants (-1 si le minuteur n'a pas de fin) -** valeur de retour : +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -7671,7 +7671,7 @@ struct t_hook *my_timer_hook = weechat_hook_timer (20 * 1000, 0, 0, &my_timer_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7693,7 +7693,7 @@ _Mis à jour dans la 1.3, 1.5._ Accrocher un descripteur de fichier (fichier ou socket). -Prototype : +Prototype : [source,C] ---- @@ -7708,33 +7708,33 @@ struct t_hook *weechat_hook_fd (int fd, void *callback_data); ---- -Paramètres : +Paramètres : -* _fd_ : descripteur de fichier -* _flag_read_ : 1 = intercepter un évènement de lecture, 0 = ignorer -* _flag_write_ : 1 = intercepter un évènement d'écriture, 0 = ignorer -* _flag_exception_ : 1 = intercepter un évènement d'exception, 0 = ignorer - (_WeeChat ≥ 1.3_ : ce paramètre est ignoré et n'est plus utilisé) -* _callback_ : fonction appelée lorsqu'un des évènements sélectionnés se - produit pour le fichier (ou le socket), paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _int fd_ : descripteur de fichier -** valeur de retour : +* _fd_ : descripteur de fichier +* _flag_read_ : 1 = intercepter un évènement de lecture, 0 = ignorer +* _flag_write_ : 1 = intercepter un évènement d'écriture, 0 = ignorer +* _flag_exception_ : 1 = intercepter un évènement d'exception, 0 = ignorer + (_WeeChat ≥ 1.3_ : ce paramètre est ignoré et n'est plus utilisé) +* _callback_ : fonction appelée lorsqu'un des évènements sélectionnés se + produit pour le fichier (ou le socket), paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _int fd_ : descripteur de fichier +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -7751,7 +7751,7 @@ int sock = socket (AF_INET, SOCK_STREAM, 0); struct t_hook *my_fd_hook = weechat_hook_fd (sock, 1, 0, 0, &my_fd_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7782,7 +7782,7 @@ commande), ou si vous souhaitez utiliser le shell, vous pouvez utiliser la fonction <<_hook_process_hashtable,hook_process_hashtable>> avec les paramètres dans la table de hachage _options_ _(WeeChat ≥ 0.4.0)_. -Prototype : +Prototype : [source,C] ---- @@ -7799,46 +7799,46 @@ struct t_hook *weechat_hook_process (const char *command, ---- -Paramètres : +Paramètres : -* _command_ : commande à lancer dans le processus fils, URL _(WeeChat ≥ 0.3.7)_ +* _command_ : commande à lancer dans le processus fils, URL _(WeeChat ≥ 0.3.7)_ ou fonction _(WeeChat ≥ 1.5)_ (voir ci-dessous) -* _timeout_ : timeout pour la commande (en millisecondes) : après ce délai, le +* _timeout_ : timeout pour la commande (en millisecondes) : après ce délai, le processus fils est tué (0 signifie pas de limite) -* _callback_ : fonction appelée quand des données du fils sont disponibles, or - ou quand le fils s'est terminé, paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *command_ : commande exécutée par le fils -** _int return_code_ : code retour : -*** _>= 0_ : code retour du fils pour une commande, et pour l'URL, les valeurs - possibles sont : -**** _0_ : transfert ok -**** _1_ : URL invalide -**** _2_ : erreur de transfert -**** _3_ : pas assez de mémoire -**** _4_ : erreur avec un fichier -*** _< 0_ : -**** _WEECHAT_HOOK_PROCESS_RUNNING_ : données disponibles, mais le fils tourne +* _callback_ : fonction appelée quand des données du fils sont disponibles, or + ou quand le fils s'est terminé, paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *command_ : commande exécutée par le fils +** _int return_code_ : code retour : +*** _>= 0_ : code retour du fils pour une commande, et pour l'URL, les valeurs + possibles sont : +**** _0_ : transfert ok +**** _1_ : URL invalide +**** _2_ : erreur de transfert +**** _3_ : pas assez de mémoire +**** _4_ : erreur avec un fichier +*** _< 0_ : +**** _WEECHAT_HOOK_PROCESS_RUNNING_ : données disponibles, mais le fils tourne toujours -**** _WEECHAT_HOOK_PROCESS_ERROR_ : erreur en lançant la commande +**** _WEECHAT_HOOK_PROCESS_ERROR_ : erreur en lançant la commande **** _WEECHAT_HOOK_PROCESS_CHILD_: le "callback" est appelé dans le processus fils -** _out_ : sortie standard de la commande (stdout) -** _err_ : erreurs de la commande (stderr) -** valeur de retour : +** _out_ : sortie standard de la commande (stdout) +** _err_ : erreurs de la commande (stderr) +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ *** code retour du processus fils (dans le cas d'une fonction avec "func:" dans la commande) -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur @@ -7846,12 +7846,12 @@ Lorsque la commande est terminée, ou si le timeout est atteint, WeeChat supprimera automatiquement le "hook" (et tuera le processus s'il tourne toujours). -La commande peut être une URL avec le format : "url:http://www.example.com", +La commande peut être une URL avec le format : "url:http://www.example.com", pour télécharger le contenu de l'URL _(WeeChat ≥ 0.3.7)_. Des options pour l'URL sont possibles avec la fonction <<_hook_process_hashtable,hook_process_hashtable>>. -La commande peut aussi être le nom d'une fonction avec le format : "func:nom", +La commande peut aussi être le nom d'une fonction avec le format : "func:nom", pour exécuter la fonction "nom" _(WeeChat ≥ 1.5)_. Cette fonction reçoit un paramètre (_data_) et doit retourner une chaîne de caractères, qui sera envoyée au "callback". + @@ -7869,17 +7869,17 @@ sur la page https://weechat.org/dev/info [NOTE] La taille du tampon pour l'envoi des données au "callback" est de 64 Ko (il y a -2 tampons : un pour stdout et un pour stderr). +2 tampons : un pour stdout et un pour stderr). Si la sortie du processus fils (stdout ou stderr) est plus longue que 64 Ko, le "callback" sera appelé plusieurs fois. [IMPORTANT] Même si la plupart du temps le "callback" n'est appelé qu'une seule fois, vous -devez vous assurer que plusieurs appels au "callback" sont ok dans votre code : +devez vous assurer que plusieurs appels au "callback" sont ok dans votre code : vous devez concaténer les données issues de plusieurs appels et n'utiliser les données que lorsque le code retour est positif ou nul. -Exemple en C : +Exemple en C : [source,C] ---- @@ -7901,12 +7901,12 @@ my_process_cb (const void *pointer, void *data, const char *command, if (out) { - weechat_printf (NULL, "stdout : %s", out); + weechat_printf (NULL, "stdout : %s", out); } if (err) { - weechat_printf (NULL, "stderr : %s", err); + weechat_printf (NULL, "stderr : %s", err); } return WEECHAT_RC_OK; @@ -7946,12 +7946,12 @@ my_process_cb (const void *pointer, void *data, const char *command, if (out) { - weechat_printf (NULL, "stdout : %s", out); + weechat_printf (NULL, "stdout : %s", out); } if (err) { - weechat_printf (NULL, "stderr : %s", err); + weechat_printf (NULL, "stderr : %s", err); } return WEECHAT_RC_OK; @@ -7962,7 +7962,7 @@ struct t_hook *my_process_hook = weechat_hook_process ("func:get_status", 5000, &my_process_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7977,9 +7977,9 @@ def my_process_cb(data, command, return_code, out, err): if return_code >= 0: weechat.prnt("", "return_code = %d" % return_code) if out != "": - weechat.prnt("", "stdout : %s" % out) + weechat.prnt("", "stdout : %s" % out) if err != "": - weechat.prnt("", "stderr : %s" % err) + weechat.prnt("", "stderr : %s" % err) return weechat.WEECHAT_RC_OK hook = weechat.hook_process("ls", 5000, "my_process_cb", "") @@ -7997,9 +7997,9 @@ def my_process_cb(data, command, return_code, out, err): if return_code >= 0: weechat.prnt("", "return_code = %d" % return_code) if out != "": - weechat.prnt("", "stdout : %s" % out) + weechat.prnt("", "stdout : %s" % out) if err != "": - weechat.prnt("", "stderr : %s" % err) + weechat.prnt("", "stderr : %s" % err) return weechat.WEECHAT_RC_OK hook = weechat.hook_process("func:get_status", 5000, "my_process_cb", "") @@ -8012,7 +8012,7 @@ _WeeChat ≥ 0.3.7, mis à jour dans la 1.5._ Accrocher un processus (lancé par un fork) en utilisant des options dans une table de hachage, et intercepter sa sortie. -Prototype : +Prototype : [source,C] ---- @@ -8030,14 +8030,14 @@ struct t_hook *weechat_hook_process_hashtable (const char *command, ---- Les paramètres sont les mêmes que ceux de la fonction -<<_hook_process,hook_process>>, avec un paramètre supplémentaire : +<<_hook_process,hook_process>>, avec un paramètre supplémentaire : -* _options_ : options pour la commande exécutée; la table de hachage est +* _options_ : options pour la commande exécutée; la table de hachage est dupliquée dans la fonction, donc il est possible de la supprimer après cet appel Pour une commande standard (ne commençant pas par "url:"), les options suivantes -sont disponibles : +sont disponibles : [width="100%",cols="^1,1,3",options="header"] |=== @@ -8046,7 +8046,7 @@ sont disponibles : | argN (N ≥ 1) + _(WeeChat ≥ 0.4.0)_ | toute chaîne | - Paramètres pour la commande ; si aucun paramètre n'est donné avec ces options, + Paramètres pour la commande ; si aucun paramètre n'est donné avec ces options, la commande sera automatiquement découpée comme le fait le shell (et donc les paramètres de la commande sont lus dans le paramètre _command_). @@ -8066,32 +8066,32 @@ sont disponibles : | detached + _(WeeChat ≥ 1.0)_ | (non utilisée) | - Lancer le process dans un mode détaché : stdout et stderr sont redirigés vers + Lancer le process dans un mode détaché : stdout et stderr sont redirigés vers _/dev/null_. |=== Pour la commande "url:...", les options suivantes sont disponibles (voir -`man curl_easy_setopt` pour une description de chaque option) : +`man curl_easy_setopt` pour une description de chaque option) : include::autogen/plugin_api/url_options.adoc[] [NOTE] ^(1)^ Lorsque des constantes sont disponibles, elles doivent être utilisées comme valeur pour l'option. Pour les options avec le type "mask", le format -est : "valeur1+valeur2+valeur3". +est : "valeur1+valeur2+valeur3". Pour l'URL, deux options supplémentaires (chaînes) sont autorisées, pour le -fichier en entrée/sortie : +fichier en entrée/sortie : -* _file_in_ : fichier à lire pour envoyer avec l'URL (envoi de fichier "post") -* _file_out_ : écrire l'URL/fichier dans ce fichier (au lieu de la sortie +* _file_in_ : fichier à lire pour envoyer avec l'URL (envoi de fichier "post") +* _file_out_ : écrire l'URL/fichier dans ce fichier (au lieu de la sortie standard) -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -8112,18 +8112,18 @@ my_process_cb (const void *pointer, void *data, const char *command, if (out) { - weechat_printf (NULL, "stdout : %s", out); + weechat_printf (NULL, "stdout : %s", out); } if (err) { - weechat_printf (NULL, "stderr : %s", err); + weechat_printf (NULL, "stderr : %s", err); } return WEECHAT_RC_OK; } -/* exemple 1 : téléchargement d'une URL */ +/* exemple 1 : téléchargement d'une URL */ struct t_hashtable *options = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, WEECHAT_HASHTABLE_STRING, @@ -8139,7 +8139,7 @@ if (options) weechat_hashtable_free (options); } -/* exemple 2 : exécution d'un programme de notification avec le message de quelqu'un */ +/* exemple 2 : exécution d'un programme de notification avec le message de quelqu'un */ struct t_hashtable *options_cmd1 = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, WEECHAT_HASHTABLE_STRING, @@ -8158,7 +8158,7 @@ if (options_cmd1) weechat_hashtable_free (options_cmd1); } -/* exemple 3 : appeler le shell pour exécuter la commande (la commande doit être SURE) */ +/* exemple 3 : appeler le shell pour exécuter la commande (la commande doit être SURE) */ struct t_hashtable *options_cmd2 = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, WEECHAT_HASHTABLE_STRING, @@ -8176,7 +8176,7 @@ if (options_cmd2) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -8191,17 +8191,17 @@ def my_process_cb(data, command, return_code, out, err): if return_code >= 0: weechat.prnt("", "return_code = %d" % return_code) if out != "": - weechat.prnt("", "stdout : %s" % out) + weechat.prnt("", "stdout : %s" % out) if err != "": - weechat.prnt("", "stderr : %s" % err) + weechat.prnt("", "stderr : %s" % err) return weechat.WEECHAT_RC_OK -# exemple 1 : téléchargement d'une URL +# exemple 1 : téléchargement d'une URL hook1 = weechat.hook_process_hashtable("url:https://weechat.org/", {"file_out": "/tmp/weechat.org.html"}, 20000, "my_process_cb", "") -# exemple 2 : exécution d'un programme de notification avec le message de quelqu'un +# exemple 2 : exécution d'un programme de notification avec le message de quelqu'un hook2 = weechat.hook_process_hashtable("my-notify-command", {"arg1": "-from", "arg2": nick, @@ -8209,7 +8209,7 @@ hook2 = weechat.hook_process_hashtable("my-notify-command", "arg4": message}, # paramètre non sûr 20000, "my_process_cb", "") -# exemple 3 : appeler le shell pour exécuter la commande (la commande doit être SURE) +# exemple 3 : appeler le shell pour exécuter la commande (la commande doit être SURE) hook3 = weechat.hook_process_hashtable("sh", {"arg1": "-c", "arg2": "ls -l /tmp | grep something"}, @@ -8222,7 +8222,7 @@ _Mis à jour dans la 1.5._ Accrocher une connexion (connexion à une machine distante en tâche de fond). -Prototype : +Prototype : [source,C] ---- @@ -8247,67 +8247,67 @@ struct t_hook *weechat_hook_connect (const char *proxy, void *callback_data); ---- -Paramètres : +Paramètres : -* _proxy_ : nom du proxy à utiliser pour la connexion (optionnel, NULL signifie +* _proxy_ : nom du proxy à utiliser pour la connexion (optionnel, NULL signifie une connexion sans proxy) -* _address_ : nom ou adresse IP de la machine à laquelle se connecter -* _port_ : numéro de port -* _ipv6_ : 1 pour utiliser IPv6 (avec repli sur IPv4), 0 pour utiliser seulement +* _address_ : nom ou adresse IP de la machine à laquelle se connecter +* _port_ : numéro de port +* _ipv6_ : 1 pour utiliser IPv6 (avec repli sur IPv4), 0 pour utiliser seulement IPv4 -* _retry_ : numéro de nouvelle tentative, utilisé pour se rabattre sur les +* _retry_ : numéro de nouvelle tentative, utilisé pour se rabattre sur les adresses IPv4 si la connexion IPv6 échoue -* _gnutls_sess_ : session GnuTLS (optionnel) -* _gnutls_cb_ : callback pour GnuTLS (optionnel) -* _gnutls_dhkey_size_ : taille de clé utilisée pour l'échange de clé +* _gnutls_sess_ : session GnuTLS (optionnel) +* _gnutls_cb_ : callback pour GnuTLS (optionnel) +* _gnutls_dhkey_size_ : taille de clé utilisée pour l'échange de clé Diffie-Hellman (GnuTLS) -* _gnutls_priorities_ : priorités pour gnutls (pour la syntaxe, voir la +* _gnutls_priorities_ : priorités pour gnutls (pour la syntaxe, voir la documentation de la fonction _gnutls_priority_init_ dans le manuel gnutls), - les valeurs de base sont : + les valeurs de base sont : ** _PERFORMANCE_ ** _NORMAL_ (défaut) ** _SECURE128_ ** _SECURE256_ ** _EXPORT_ ** _NONE_ -* _local_hostname_ : nom de machine local à utiliser pour la connexion +* _local_hostname_ : nom de machine local à utiliser pour la connexion (optionnel) -* _callback_ : fonction appelée lorsque la connexion est ok ou a échoué, - paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _int status_ : statut de connexion : -*** _WEECHAT_HOOK_CONNECT_OK_ : connexion ok -*** _WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND_ : adresse non trouvée -*** _WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND_ : adresse IP non trouvée -*** _WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED_ : connexion refusée -*** _WEECHAT_HOOK_CONNECT_PROXY_ERROR_ : erreur avec le proxy -*** _WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR_ : erreur avec le nom local -*** _WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR_ : erreur d'initialisation GnuTLS -*** _WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR_ : erreur avec la +* _callback_ : fonction appelée lorsque la connexion est ok ou a échoué, + paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _int status_ : statut de connexion : +*** _WEECHAT_HOOK_CONNECT_OK_ : connexion ok +*** _WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND_ : adresse non trouvée +*** _WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND_ : adresse IP non trouvée +*** _WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED_ : connexion refusée +*** _WEECHAT_HOOK_CONNECT_PROXY_ERROR_ : erreur avec le proxy +*** _WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR_ : erreur avec le nom local +*** _WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR_ : erreur d'initialisation GnuTLS +*** _WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR_ : erreur avec la "poignée de main" GnuTLS -*** _WEECHAT_HOOK_CONNECT_MEMORY_ERROR_ : mémoire insuffisante -*** _WEECHAT_HOOK_CONNECT_TIMEOUT_ : temps maximum dépassé -*** _WEECHAT_HOOK_CONNECT_SOCKET_ERROR_ : erreur de création socket -** _gnutls_rc_ : valeur retour de _gnutls_handshake()_ -** _sock_ : socket utilisé pour la connexion -** _const char *error_ : valeur retour de _gnutls_strerror(gnutls_rc)_ -** _const char *ip_address_ : adresse IP trouvée -** valeur de retour : +*** _WEECHAT_HOOK_CONNECT_MEMORY_ERROR_ : mémoire insuffisante +*** _WEECHAT_HOOK_CONNECT_TIMEOUT_ : temps maximum dépassé +*** _WEECHAT_HOOK_CONNECT_SOCKET_ERROR_ : erreur de création socket +** _gnutls_rc_ : valeur retour de _gnutls_handshake()_ +** _sock_ : socket utilisé pour la connexion +** _const char *error_ : valeur retour de _gnutls_strerror(gnutls_rc)_ +** _const char *ip_address_ : adresse IP trouvée +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -8362,7 +8362,7 @@ struct t_hook *my_connect_hook = weechat_hook_connect (NULL, &my_connect_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -8406,7 +8406,7 @@ _Mis à jour dans la 0.4.3, 1.0, 1.5._ Intercepter un message affiché. -Prototype : +Prototype : [source,C] ---- @@ -8428,44 +8428,44 @@ struct t_hook *weechat_hook_print (struct t_gui_buffer *buffer, void *callback_data); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon, si NULL, les messages de tous les tampons +* _buffer_ : pointeur vers le tampon, si NULL, les messages de tous les tampons sont interceptés -* _tags_ : intercepter seulement les messages avec ces étiquettes (optionnel) : -** avec WeeChat ≥ 0.4.3 : liste d'étiquettes (séparées par des virgules) qui +* _tags_ : intercepter seulement les messages avec ces étiquettes (optionnel) : +** avec WeeChat ≥ 0.4.3 : liste d'étiquettes (séparées par des virgules) qui doivent être dans le message ("ou" logique); il est possible de combiner plusieurs étiquettes sous forme d'un "et" logique avec le séparateur `+++`; le caractère joker `+*+` est autorisé dans les étiquettes -** avec WeeChat ≤ 0.4.2 : liste d'étiquettes (séparées par des virgules) qui +** avec WeeChat ≤ 0.4.2 : liste d'étiquettes (séparées par des virgules) qui doivent toutes être dans le message ("et" logique) -* _message_ : seulement les messages contenant cette chaîne seront interceptés +* _message_ : seulement les messages contenant cette chaîne seront interceptés (optionnel, insensible à la casse) -* _strip_colors_ : si 1, les couleurs seront supprimées du message affiché, +* _strip_colors_ : si 1, les couleurs seront supprimées du message affiché, avant d'appeler le "callback" -* _callback_ : fonction appelée lorsqu'un message est affiché, paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_gui_buffer *buffer_ : pointeur vers le tampon -** _time_t date_ : date -** _int tags_count_ : nombre d'étiquettes de la ligne -** _const char **tags_ : tableau avec les étiquettes de la ligne -** _int displayed_ : 1 si la ligne est affichée, 0 si elle est filtrée (cachée) -** _int highlight_ : 1 si la ligne contient un highlight, sinon 0 -** _const char *prefix_ : préfixe -** _const char *message_ : message -** valeur de retour : +* _callback_ : fonction appelée lorsqu'un message est affiché, paramètres et + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_gui_buffer *buffer_ : pointeur vers le tampon +** _time_t date_ : date +** _int tags_count_ : nombre d'étiquettes de la ligne +** _const char **tags_ : tableau avec les étiquettes de la ligne +** _int displayed_ : 1 si la ligne est affichée, 0 si elle est filtrée (cachée) +** _int highlight_ : 1 si la ligne contient un highlight, sinon 0 +** _const char *prefix_ : préfixe +** _const char *message_ : message +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur @@ -8473,10 +8473,10 @@ Valeur de retour : Dans les scripts, avec WeeChat ≥ 1.0, les paramètres du callback _displayed_ et _highlight_ sont des entiers (avec WeeChat ≤ 0.4.3, ils étaient des chaînes). + Pour être compatible avec toutes les versions, il est recommandé de convertir -le paramètre en entier avant de le tester, par exemple en Python : +le paramètre en entier avant de le tester, par exemple en Python : `if int(highlight):`. -Exemple en C : +Exemple en C : [source,C] ---- @@ -8495,7 +8495,7 @@ struct t_hook *my_print_hook = weechat_hook_print (NULL, NULL, NULL, 1, &my_print_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -8518,7 +8518,7 @@ _Mis à jour dans la 1.5._ S'accrocher à un signal. -Prototype : +Prototype : [source,C] ---- @@ -8532,38 +8532,38 @@ struct t_hook *weechat_hook_signal (const char *signal, void *callback_data); ---- -Paramètres : +Paramètres : -* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé +* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé (priorité autorisée, voir la note sur la <<hook_priority,priorité>>) (voir le tableau ci-dessous) -* _callback_ : fonction appelée quand le signal est reçu, paramètres et valeur - de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *signal_ : signal reçu -** _const char *type_data_ : type de donnée reçu avec le signal : -*** _WEECHAT_HOOK_SIGNAL_STRING_ : chaîne de caractères -*** _WEECHAT_HOOK_SIGNAL_INT_ : nombre entier -*** _WEECHAT_HOOK_SIGNAL_POINTER_ : pointeur -** _void *signal_data_ : données envoyées avec le signal -** valeur de retour : +* _callback_ : fonction appelée quand le signal est reçu, paramètres et valeur + de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *signal_ : signal reçu +** _const char *type_data_ : type de donnée reçu avec le signal : +*** _WEECHAT_HOOK_SIGNAL_STRING_ : chaîne de caractères +*** _WEECHAT_HOOK_SIGNAL_INT_ : nombre entier +*** _WEECHAT_HOOK_SIGNAL_POINTER_ : pointeur +** _void *signal_data_ : données envoyées avec le signal +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_OK_EAT_ (arrêter l'envoi du signal immédiatement) _(WeeChat ≥ 0.4.0)_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Liste des signaux envoyés par WeeChat et les extensions : +Liste des signaux envoyés par WeeChat et les extensions : [width="100%",cols="^1,^3,^4,5",options="header"] |=== @@ -8571,106 +8571,106 @@ Liste des signaux envoyés par WeeChat et les extensions : | aspell | aspell_suggest + _(WeeChat ≥ 0.4.0)_ | - Pointeur : tampon. | + Pointeur : tampon. | Nouvelles suggestions pour un mot mal orthographié. | guile | guile_script_loaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script scheme chargé. | guile | guile_script_unloaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script scheme déchargé. | guile | guile_script_installed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | + Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | Script(s) scheme installé(s). | guile | guile_script_removed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de scripts supprimés (séparés par des virgules). | + Chaîne : liste de scripts supprimés (séparés par des virgules). | Script(s) scheme supprimé(s). | irc | xxx,irc_in_yyy ^(1)^ | - Chaîne : message. | + Chaîne : message. | Message IRC du serveur (avant utilisation par l'extension irc, signal envoyé uniquement si le message n'est *pas* ignoré). | irc | xxx,irc_in2_yyy ^(1)^ | - Chaîne : message. | + Chaîne : message. | Message IRC du serveur (après utilisation par l'extension irc, signal envoyé uniquement si le message n'est *pas* ignoré). | irc | xxx,irc_raw_in_yyy ^(1)^ + _(WeeChat ≥ 0.3.2)_ | - Chaîne : message. | + Chaîne : message. | Message IRC du serveur (avant utilisation par l'extension irc, signal envoyé même si le message est ignoré). | irc | xxx,irc_raw_in2_yyy ^(1)^ + _(WeeChat ≥ 0.3.2)_ | - Chaîne : message. | + Chaîne : message. | Message IRC du serveur (après utilisation par l'extension irc, signal envoyé même si le message est ignoré). | irc | xxx,irc_out1_yyy ^(1)^ + _(WeeChat ≥ 0.3.7)_ | - Chaîne : message. | + Chaîne : message. | Message IRC envoyé au serveur (avant découpage automatique pour tenir dans les 512 octets). | irc | xxx,irc_out_yyy ^(1)^ | - Chaîne : message. | + Chaîne : message. | Message IRC envoyé au serveur (après découpage automatique pour tenir dans les 512 octets). | irc | xxx,irc_outtags_yyy ^(1)^ + _(WeeChat ≥ 0.3.4)_ | - Chaîne : étiquettes + ";" + message. | + Chaîne : étiquettes + ";" + message. | Étiquettes + message IRC envoyé au serveur. | irc | irc_ctcp | - Chaîne : message. | + Chaîne : message. | CTCP reçu. | irc | irc_dcc | - Chaîne : message. | + Chaîne : message. | Nouveau DCC. | irc | irc_pv | - Chaîne : message. | + Chaîne : message. | Message privé reçu. | irc | irc_channel_opened | - Pointeur : tampon. | + Pointeur : tampon. | Canal ouvert. | irc | irc_pv_opened | - Pointeur : tampon. | + Pointeur : tampon. | Discussion privée ouverte. | irc | irc_server_opened + _(WeeChat ≥ 0.3.7)_ | - Pointeur : tampon. | + Pointeur : tampon. | Tampon du serveur ouvert. | irc | irc_server_connecting | - Chaîne : nom du serveur. | + Chaîne : nom du serveur. | Connexion en cours au serveur. | irc | irc_server_connected | - Chaîne : nom du serveur. | + Chaîne : nom du serveur. | Connecté au serveur. | irc | irc_server_disconnected | - Chaîne : nom du serveur. | + Chaîne : nom du serveur. | Déconnecté du serveur. | irc | irc_ignore_removing | - Pointeur : ignore. | + Pointeur : ignore. | Suppression d'un ignore en cours. | irc | irc_ignore_removed | @@ -8679,283 +8679,283 @@ Liste des signaux envoyés par WeeChat et les extensions : | irc | irc_notify_join + _(WeeChat ≥ 0.3.8)_ | - Chaîne : nom du serveur + "," + pseudo. | + Chaîne : nom du serveur + "," + pseudo. | Un pseudo dans la liste de notifications a rejoint le serveur. | irc | irc_notify_quit + _(WeeChat ≥ 0.3.8)_ | - Chaîne : nom du serveur + "," + pseudo. | + Chaîne : nom du serveur + "," + pseudo. | Un pseudo dans la liste de notifications a quitté le serveur. | irc | irc_notify_away + _(WeeChat ≥ 0.3.8)_ | - Chaîne : nom du serveur + "," + pseudo + "," + message d'absence. | + Chaîne : nom du serveur + "," + pseudo + "," + message d'absence. | Un pseudo dans la liste de notifications est maintenant absent sur le serveur. | irc | irc_notify_still_away + _(WeeChat ≥ 0.3.8)_ | - Chaîne : nom du serveur + "," + pseudo + "," + message d'absence. | + Chaîne : nom du serveur + "," + pseudo + "," + message d'absence. | Un pseudo dans la liste de notifications est toujours absent sur le serveur (le message d'absence a changé). | irc | irc_notify_back + _(WeeChat ≥ 0.3.8)_ | - Chaîne : nom du serveur + "," + pseudo. | + Chaîne : nom du serveur + "," + pseudo. | Un pseudo dans la liste de notifications est de retour (statut d'absence supprimé). | javascript | javascript_script_loaded + _(WeeChat ≥ 1.2)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script javascript chargé. | javascript | javascript_script_unloaded + _(WeeChat ≥ 1.2)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script javascript déchargé. | javascript | javascript_script_installed + _(WeeChat ≥ 1.2)_ | - Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | + Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | Script(s) javascript installé(s). | javascript | javascript_script_removed + _(WeeChat ≥ 1.2)_ | - Chaîne : liste de scripts supprimés (séparés par des virgules). | + Chaîne : liste de scripts supprimés (séparés par des virgules). | Script(s) javascript supprimé(s). | logger | logger_start | - Pointeur : tampon. | + Pointeur : tampon. | Démarrage de l'enregistrement sur disque pour le tampon. | logger | logger_stop | - Pointeur : tampon. | + Pointeur : tampon. | Fin de l'enregistrement sur disque pour le tampon. | logger | logger_backlog | - Pointeur : tampon. | + Pointeur : tampon. | Affichage du backlog pour le tampon. | lua | lua_script_loaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script lua chargé. | lua | lua_script_unloaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script lua déchargé. | lua | lua_script_installed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | + Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | Script(s) lua installé(s). | lua | lua_script_removed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de scripts supprimés (séparés par des virgules). | + Chaîne : liste de scripts supprimés (séparés par des virgules). | Script(s) lua supprimé(s). | perl | perl_script_loaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script perl chargé. | perl | perl_script_unloaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script perl déchargé. | perl | perl_script_installed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | + Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | Script(s) perl installé(s). | perl | perl_script_removed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de scripts supprimés (séparés par des virgules). | + Chaîne : liste de scripts supprimés (séparés par des virgules). | Script(s) perl supprimé(s). | python | python_script_loaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script python chargé. | python | python_script_unloaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script python déchargé. | python | python_script_installed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | + Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | Script(s) python installé(s). | python | python_script_removed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de scripts supprimés (séparés par des virgules). | + Chaîne : liste de scripts supprimés (séparés par des virgules). | Script(s) python supprimé(s). | relay | relay_client_connecting + _(WeeChat ≥ 1.0)_ | - Pointeur : client relay. | + Pointeur : client relay. | Un client relay est en train de se connecter. | relay | relay_client_waiting_auth + _(WeeChat ≥ 1.0)_ | - Pointeur : client relay. | + Pointeur : client relay. | Attente de l'authentification d'un client relay. | relay | relay_client_auth_ok + _(WeeChat ≥ 1.0)_ | - Pointeur : client relay. | + Pointeur : client relay. | Authentification réussie d'un client relay. | relay | relay_client_connected + _(WeeChat ≥ 1.0)_ | - Pointeur : client relay. | + Pointeur : client relay. | Un client relay est connecté. | relay | relay_client_auth_failed + _(WeeChat ≥ 1.0)_ | - Pointeur : client relay. | + Pointeur : client relay. | L'authentification d'un client relay a échoué. | relay | relay_client_disconnected + _(WeeChat ≥ 1.0)_ | - Pointeur : client relay. | + Pointeur : client relay. | Un client relay est déconnecté. | ruby | ruby_script_loaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script ruby chargé. | ruby | ruby_script_unloaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script ruby déchargé. | ruby | ruby_script_installed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | + Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | Script(s) ruby installé(s). | ruby | ruby_script_removed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de scripts supprimés (séparés par des virgules). | + Chaîne : liste de scripts supprimés (séparés par des virgules). | Script(s) ruby supprimé(s). | tcl | tcl_script_loaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script tcl chargé. | tcl | tcl_script_unloaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script tcl déchargé. | tcl | tcl_script_installed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | + Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | Script(s) tcl installé(s). | tcl | tcl_script_removed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de scripts supprimés (séparés par des virgules). | + Chaîne : liste de scripts supprimés (séparés par des virgules). | Script(s) tcl supprimé(s). | weechat | buffer_opened | - Pointeur : tampon. | + Pointeur : tampon. | Tampon ouvert. | weechat | buffer_closing | - Pointeur : tampon. | + Pointeur : tampon. | Fermeture du tampon en cours. | weechat | buffer_closed | - Pointeur : tampon. | + Pointeur : tampon. | Tampon fermé. | weechat | buffer_cleared | - Pointeur : tampon. | + Pointeur : tampon. | Tampon vidé. | weechat | buffer_hidden | - Pointeur : tampon. | + Pointeur : tampon. | Tampon masqué. | weechat | buffer_unhidden | - Pointeur : tampon. | + Pointeur : tampon. | Tampon démasqué. | weechat | buffer_line_added + _(WeeChat ≥ 0.3.7)_ | - Pointeur : ligne. | + Pointeur : ligne. | Ligne ajoutée dans un tampon. | weechat | buffer_lines_hidden | - Pointeur : tampon. | + Pointeur : tampon. | Lignes cachées dans le tampon. | weechat | buffer_localvar_added | - Pointeur : tampon. | + Pointeur : tampon. | Variable locale ajoutée. | weechat | buffer_localvar_changed | - Pointeur : tampon. | + Pointeur : tampon. | Variable locale modifiée. | weechat | buffer_localvar_removed | - Pointeur : tampon. | + Pointeur : tampon. | Variable locale supprimée. | weechat | buffer_merged | - Pointeur : tampon. | + Pointeur : tampon. | Tampon mélangé. | weechat | buffer_unmerged | - Pointeur : tampon. | + Pointeur : tampon. | Le tampon n'est plus mélangé. | weechat | buffer_moved | - Pointeur : tampon. | + Pointeur : tampon. | Tampon déplacé. | weechat | buffer_renamed | - Pointeur : tampon. | + Pointeur : tampon. | Tampon renommé. | weechat | buffer_switch | - Pointeur : tampon. | + Pointeur : tampon. | Basculement vers un autre tampon. | weechat | buffer_title_changed | - Pointeur : tampon. | + Pointeur : tampon. | Titre du tampon changé. | weechat | buffer_type_changed | - Pointeur : tampon. | + Pointeur : tampon. | Type de tampon changé. | weechat | buffer_zoomed + _(WeeChat ≥ 0.4.3)_ | - Pointeur : tampon. | + Pointeur : tampon. | Zoom sur un tampon mélangé. | weechat | buffer_unzoomed + _(WeeChat ≥ 0.4.3)_ | - Pointeur : tampon. | + Pointeur : tampon. | Fin du zoom sur un tampon mélangé. | weechat | day_changed + _(WeeChat ≥ 0.3.2)_ | - Chaîne : nouvelle date, format : "2010-01-31". | + Chaîne : nouvelle date, format : "2010-01-31". | Le jour de la date système a changé. | weechat | debug_dump | - Chaîne : nom d'extension. | + Chaîne : nom d'extension. | Requête de "dump". | weechat | debug_libs | @@ -8963,11 +8963,11 @@ Liste des signaux envoyés par WeeChat et les extensions : Affichage des bibliothèques externes utilisées. | weechat | filter_added | - Pointeur : filtre. | + Pointeur : filtre. | Filtre ajouté. | weechat | filter_removing | - Pointeur : filtre. | + Pointeur : filtre. | Suppression de filtre en cours. | weechat | filter_removed | @@ -8991,42 +8991,42 @@ Liste des signaux envoyés par WeeChat et les extensions : Coller de lignes en cours. | weechat | input_search | - Pointeur : tampon. | + Pointeur : tampon. | Recherche de texte dans le tampon. | weechat | input_text_changed | - Pointeur : tampon. | + Pointeur : tampon. | Texte modifié dans la barre "input". | weechat | input_text_cursor_moved | - Pointeur : tampon. | + Pointeur : tampon. | Curseur déplacé dans la barre "input". | weechat | key_bind | - Chaîne : touche. | + Chaîne : touche. | Touche ajoutée. | weechat | key_unbind | - Chaîne : touche. | + Chaîne : touche. | Touche supprimée. | weechat | key_pressed | - Chaîne : touche appuyée. | + Chaîne : touche appuyée. | Touche appuyée. | weechat | key_combo_default + _(WeeChat ≥ 1.0)_ | - Chaîne : combinaison de touches. | + Chaîne : combinaison de touches. | Combinaison de touches dans le contexte _default_. | weechat | key_combo_search + _(WeeChat ≥ 1.0)_ | - Chaîne : combinaison de touches. | + Chaîne : combinaison de touches. | Combinaison de touches dans le contexte _search_. | weechat | key_combo_cursor + _(WeeChat ≥ 1.0)_ | - Chaîne : combinaison de touches. | + Chaîne : combinaison de touches. | Combinaison de touches dans le contexte _cursor_. | weechat | mouse_enabled + @@ -9041,42 +9041,42 @@ Liste des signaux envoyés par WeeChat et les extensions : | weechat | nicklist_group_added + _(WeeChat ≥ 0.3.2)_ | - Chaîne : pointeur tampon + "," + nom du groupe. | + Chaîne : pointeur tampon + "," + nom du groupe. | Groupe ajouté dans la liste des pseudos. | weechat | nicklist_group_changed + _(WeeChat ≥ 0.3.4)_ | - Chaîne : pointeur tampon + "," + nom du groupe. | + Chaîne : pointeur tampon + "," + nom du groupe. | Groupe modifié dans la liste des pseudos. | weechat | nicklist_group_removing + _(WeeChat ≥ 0.4.1)_ | - Chaîne : pointeur tampon + "," + nom du groupe. | + Chaîne : pointeur tampon + "," + nom du groupe. | Suppression du groupe de la liste des pseudos. | weechat | nicklist_group_removed + _(WeeChat ≥ 0.3.2)_ | - Chaîne : pointeur tampon + "," + nom du groupe. | + Chaîne : pointeur tampon + "," + nom du groupe. | Groupe supprimé de la liste des pseudos. | weechat | nicklist_nick_added + _(WeeChat ≥ 0.3.2)_ | - Chaîne : pointeur tampon + "," + pseudo. | + Chaîne : pointeur tampon + "," + pseudo. | Pseudo ajouté dans la liste des pseudos. | weechat | nicklist_nick_changed + _(WeeChat ≥ 0.3.4)_ | - Chaîne : pointeur tampon + "," + pseudo. | + Chaîne : pointeur tampon + "," + pseudo. | Pseudo modifié dans la liste des pseudos. | weechat | nicklist_nick_removing + _(WeeChat ≥ 0.4.1)_ | - Chaîne : pointeur tampon + "," + pseudo. | + Chaîne : pointeur tampon + "," + pseudo. | Suppression du pseudo de la liste des pseudos. | weechat | nicklist_nick_removed + _(WeeChat ≥ 0.3.2)_ | - Chaîne : pointeur tampon + "," + pseudo. | + Chaîne : pointeur tampon + "," + pseudo. | Pseudo supprimé de la liste des pseudos. | weechat | partial_completion | @@ -9085,16 +9085,16 @@ Liste des signaux envoyés par WeeChat et les extensions : | weechat | plugin_loaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers l'extension chargée. | + Chaîne : chemin vers l'extension chargée. | Extension chargée. | weechat | plugin_unloaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : nom de l'extension déchargée (exemple : "irc"). | + Chaîne : nom de l'extension déchargée (exemple : "irc"). | Extension déchargée. | weechat | quit | - Chaîne : paramètres pour le /quit. | + Chaîne : paramètres pour le /quit. | La commande `/quit` a été exécutée par l'utilisateur. | weechat | signal_sighup + @@ -9118,7 +9118,7 @@ Liste des signaux envoyés par WeeChat et les extensions : Signal SIGWINCH reçu (le terminal a été redimensionné). | weechat | upgrade | - Chaîne : "quit" si le paramètre "-quit" a été donné pour /upgrade, sinon NULL. | + Chaîne : "quit" si le paramètre "-quit" a été donné pour /upgrade, sinon NULL. | La commande `/upgrade` a été exécutée par l'utilisateur. | weechat | upgrade_ended + @@ -9127,87 +9127,87 @@ Liste des signaux envoyés par WeeChat et les extensions : Fin du processus de mise à jour (commande `/upgrade`). | weechat | weechat_highlight | - Chaîne : message avec le préfixe. | + Chaîne : message avec le préfixe. | Un highlight est survenu. | weechat | weechat_pv | - Chaîne : message avec le préfixe. | + Chaîne : message avec le préfixe. | Un message privé a été affiché. | weechat | window_closing + _(WeeChat ≥ 0.3.6)_ | - Pointeur : fenêtre. | + Pointeur : fenêtre. | Fermeture de la fenêtre en cours. | weechat | window_closed + _(WeeChat ≥ 0.3.6)_ | - Pointeur : fenêtre. | + Pointeur : fenêtre. | Fenêtre fermée. | weechat | window_opened + _(WeeChat ≥ 0.4.1)_ | - Pointeur : fenêtre. | + Pointeur : fenêtre. | Fenêtre ouverte. | weechat | window_scrolled | - Pointeur : fenêtre. | + Pointeur : fenêtre. | Défilement dans la fenêtre. | weechat | window_switch + _(WeeChat ≥ 0.3.7)_ | - Pointeur : fenêtre. | + Pointeur : fenêtre. | Basculement vers une autre fenêtre. | weechat | window_zoom | - Pointeur : fenêtre courante. | + Pointeur : fenêtre courante. | Zoom en cours sur la fenêtre. | weechat | window_zoomed | - Pointeur : fenêtre courante. | + Pointeur : fenêtre courante. | Zoom effectué sur la fenêtre. | weechat | window_unzoom | - Pointeur : fenêtre courante. | + Pointeur : fenêtre courante. | Fin du zoom en cours sur la fenêtre. | weechat | window_unzoomed | - Pointeur : fenêtre courante. | + Pointeur : fenêtre courante. | Fin du zoom effectué sur la fenêtre. | xfer | xfer_add | - Pointeur : infolist avec l'info xfer. | + Pointeur : infolist avec l'info xfer. | Nouveau xfer. | xfer | xfer_send_ready | - Pointeur : infolist avec l'info xfer. | + Pointeur : infolist avec l'info xfer. | Xfer prêt. | xfer | xfer_accept_resume | - Pointeur : infolist avec l'info xfer. | + Pointeur : infolist avec l'info xfer. | Accepter la reprise xfer. | xfer | xfer_send_accept_resume | - Pointeur : infolist avec l'info xfer. | + Pointeur : infolist avec l'info xfer. | Reprise xfer acceptée. | xfer | xfer_start_resume | - Pointeur : infolist avec l'info xfer. | + Pointeur : infolist avec l'info xfer. | Redémarrage. | xfer | xfer_resume_ready | - Pointer : infolist avec l'info xfer. | + Pointer : infolist avec l'info xfer. | Redémarrage prêt. | xfer | xfer_ended + _(WeeChat ≥ 0.3.2)_ | - Pointer : infolist avec l'info xfer. | + Pointer : infolist avec l'info xfer. | Le xfer s'est terminé. |=== [NOTE] ^(1)^ _xxx_ est le nom du serveur IRC, _yyy_ est le nom d'une commande IRC. -Exemple en C : +Exemple en C : [source,C] ---- @@ -9224,7 +9224,7 @@ struct t_hook *my_signal_hook = weechat_hook_signal ("quit", &my_signal_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9246,7 +9246,7 @@ _Mis à jour dans la 1.0._ Envoyer un signal. -Prototype : +Prototype : [source,C] ---- @@ -9254,29 +9254,29 @@ int weechat_hook_signal_send (const char *signal, const char *type_data, void *signal_data); ---- -Paramètres : +Paramètres : -* _signal_ : signal à envoyer -* _type_data_ : type de données à envoyer avec le signal (voir +* _signal_ : signal à envoyer +* _type_data_ : type de données à envoyer avec le signal (voir <<_hook_signal,hook_signal>>) -* _signal_data_ : données envoyées avec le signal +* _signal_data_ : données envoyées avec le signal -Valeur de retour _(WeeChat ≥ 1.0)_ : +Valeur de retour _(WeeChat ≥ 1.0)_ : * code retour du dernier "callback" exécuté (_WEECHAT_RC_OK_ si aucun "callback" - n'a été exécuté) : + n'a été exécuté) : ** _WEECHAT_RC_OK_ ** _WEECHAT_RC_OK_EAT_ ** _WEECHAT_RC_ERROR_ -Exemple en C : +Exemple en C : [source,C] ---- int rc = weechat_hook_signal_send ("mon_signal", WEECHAT_HOOK_SIGNAL_STRING, ma_chaine); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9296,14 +9296,14 @@ votre extension/script). Le paramètre est un pointeur vers le tampon. -Exemple en C : +Exemple en C : [source,C] ---- weechat_hook_signal_send ("logger_backlog", WEECHAT_HOOK_SIGNAL_POINTER, buffer); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9313,7 +9313,7 @@ weechat.hook_signal_send("logger_backlog", weechat.WEECHAT_HOOK_SIGNAL_POINTER, [[signals_xxx_script_install]] ===== Signaux xxx_script_install -Cinq signaux peuvent être envoyés pour installer un script, selon le langage : +Cinq signaux peuvent être envoyés pour installer un script, selon le langage : * _perl_script_install_ * _python_script_install_ @@ -9323,7 +9323,7 @@ Cinq signaux peuvent être envoyés pour installer un script, selon le langage : * _guile_script_install_ * _javascript_script_install_ -Le "callback" effectuera les actions suivantes lorsqu'il recevra le signal : +Le "callback" effectuera les actions suivantes lorsqu'il recevra le signal : . déchargement et suppression du script installé . déplacement du nouveau script vers le répertoire _~/.weechat/xxx/_ (où _xxx_ @@ -9336,7 +9336,7 @@ Ces signaux sont utilisés par l'extension _script_ pour installer des scripts. Le paramètre est une chaîne avec le chemin vers le script à installer. -Exemple en C : +Exemple en C : [source,C] ---- @@ -9344,7 +9344,7 @@ weechat_hook_signal_send ("python_script_install", WEECHAT_HOOK_SIGNAL_STRING, "/home/xxx/.weechat/test.py"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9356,7 +9356,7 @@ weechat.hook_signal_send("python_script_install", WEECHAT_HOOK_SIGNAL_STRING, ===== Signaux xxx_script_remove Cinq signaux peuvent être envoyés pour supprimer une liste de scripts, selon le -langage : +langage : * _perl_script_remove_ * _python_script_remove_ @@ -9374,7 +9374,7 @@ Ces signaux sont utilisés par l'extension _script_ pour supprimer des scripts. Le paramètre est une chaîne avec une liste de scripts à supprimer (séparés par des virgules, nom du script sans le chemin, par exemple _script.py_). -Exemple en C : +Exemple en C : [source,C] ---- @@ -9383,7 +9383,7 @@ weechat_hook_signal_send ("python_script_remove", WEECHAT_HOOK_SIGNAL_STRING, "test.py,script.py"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9400,25 +9400,25 @@ _WeeChat ≥ 0.3.4, mis à jour dans la 1.5._ Le signal "irc_input_send" peut être envoyé pour simuler une entrée de texte dans un tampon irc (serveur, canal ou privé). -Le paramètre est une chaîne avec le format suivant : +Le paramètre est une chaîne avec le format suivant : * nom interne du serveur (requis) * point-virgule * nom de canal (optionnel) * point-virgule -* liste d'options séparées par des virgules (optionnel) : -** _priority_high_ : file d'attente avec haute priorité (comme les messages - utilisateur) ; c'est la priorité par défaut -** _priority_low_ : file d'attente avec basse priorité (comme les messages +* liste d'options séparées par des virgules (optionnel) : +** _priority_high_ : file d'attente avec haute priorité (comme les messages + utilisateur) ; c'est la priorité par défaut +** _priority_low_ : file d'attente avec basse priorité (comme les messages envoyés automatiquement par WeeChat) -** _user_message_ : forcer un message utilisateur (ne pas exécuter de commande) +** _user_message_ : forcer un message utilisateur (ne pas exécuter de commande) * point-virgule * liste d'étiquettes (séparées par des virgules) utilisées lors de l'envoi du message (optionnel) * point-virgule * texte ou commande (requis) -Exemples en C : +Exemples en C : [source,C] ---- @@ -9431,7 +9431,7 @@ weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING, "freenode;;priority_low;;/whois FlashCode"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9450,7 +9450,7 @@ _WeeChat ≥ 0.3.4, mis à jour dans la 1.5._ S'accrocher à un hsignal (signal avec une table de hachage). -Prototype : +Prototype : [source,C] ---- @@ -9463,34 +9463,34 @@ struct t_hook *weechat_hook_hsignal (const char *signal, void *callback_data); ---- -Paramètres : +Paramètres : -* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé +* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé (priorité autorisée, voir la note sur la <<hook_priority,priorité>>) (voir le tableau ci-dessous) -* _callback_ : fonction appelée quand le signal est reçu, paramètres et valeur - de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *signal_ : signal reçu -** _struct t_hashtable *hashtable_ : table de hachage -** valeur de retour : +* _callback_ : fonction appelée quand le signal est reçu, paramètres et valeur + de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *signal_ : signal reçu +** _struct t_hashtable *hashtable_ : table de hachage +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_OK_EAT_ (arrêter l'envoi du signal immédiatement) _(WeeChat ≥ 0.4.0)_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Liste des hsignaux envoyés par WeeChat et les extensions : +Liste des hsignaux envoyés par WeeChat et les extensions : [width="100%",cols="^1,^3,5,5",options="header"] |=== @@ -9503,44 +9503,44 @@ Liste des hsignaux envoyés par WeeChat et les extensions : | weechat | nicklist_group_added + _(WeeChat ≥ 0.4.1)_ | - _buffer_ (_struct t_gui_buffer *_) : tampon + - _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + - _group_ (_struct t_gui_nick_group *_) : groupe | + _buffer_ (_struct t_gui_buffer *_) : tampon + + _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + + _group_ (_struct t_gui_nick_group *_) : groupe | Groupe ajouté dans la liste de pseudos. | weechat | nicklist_nick_added + _(WeeChat ≥ 0.4.1)_ | - _buffer_ (_struct t_gui_buffer *_) : tampon + - _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + - _nick_ (_struct t_gui_nick *_) : pseudo | + _buffer_ (_struct t_gui_buffer *_) : tampon + + _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + + _nick_ (_struct t_gui_nick *_) : pseudo | Pseudo ajouté dans la liste de pseudos. | weechat | nicklist_group_removing + _(WeeChat ≥ 0.4.1)_ | - _buffer_ (_struct t_gui_buffer *_) : tampon + - _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + - _group_ (_struct t_gui_nick_group *_) : groupe | + _buffer_ (_struct t_gui_buffer *_) : tampon + + _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + + _group_ (_struct t_gui_nick_group *_) : groupe | Suppression d'un groupe de la liste de pseudos. | weechat | nicklist_nick_removing + _(WeeChat ≥ 0.4.1)_ | - _buffer_ (_struct t_gui_buffer *_) : tampon + - _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + - _nick_ (_struct t_gui_nick *_) : pseudo | + _buffer_ (_struct t_gui_buffer *_) : tampon + + _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + + _nick_ (_struct t_gui_nick *_) : pseudo | Suppression d'un pseudo de la liste de pseudos. | weechat | nicklist_group_changed + _(WeeChat ≥ 0.4.1)_ | - _buffer_ (_struct t_gui_buffer *_) : tampon + - _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + - _group_ (_struct t_gui_nick_group *_) : groupe | + _buffer_ (_struct t_gui_buffer *_) : tampon + + _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + + _group_ (_struct t_gui_nick_group *_) : groupe | Groupe changé dans la liste de pseudos. | weechat | nicklist_nick_changed + _(WeeChat ≥ 0.4.1)_ | - _buffer_ (_struct t_gui_buffer *_) : tampon + - _parent_group_ (_struct t_gui_nick_group *_) : parent + - _nick_ (_struct t_gui_nick *_) : pseudo | + _buffer_ (_struct t_gui_buffer *_) : tampon + + _parent_group_ (_struct t_gui_nick_group *_) : parent + + _nick_ (_struct t_gui_nick *_) : pseudo | Pseudo changé dans la liste de pseudos. |=== @@ -9548,7 +9548,7 @@ Liste des hsignaux envoyés par WeeChat et les extensions : ^(1)^ _xxx_ est l'argument "signal" utilisé dans la redirection, _yyy_ est le modèle de redirection ("pattern"). -Exemple en C : +Exemple en C : [source,C] ---- @@ -9564,7 +9564,7 @@ struct t_hook *my_hsignal_hook = weechat_hook_hsignal ("test", &my_hsignal_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9585,27 +9585,27 @@ _WeeChat ≥ 0.3.4, mis à jour dans la 1.0._ Envoyer un hsignal (signal avec table de hachage). -Prototype : +Prototype : [source,C] ---- int weechat_hook_hsignal_send (const char *signal, struct t_hashtable *hashtable); ---- -Paramètres : +Paramètres : -* _signal_ : signal à envoyer -* _hashtable_ : table de hachage +* _signal_ : signal à envoyer +* _hashtable_ : table de hachage -Valeur de retour _(WeeChat ≥ 1.0)_ : +Valeur de retour _(WeeChat ≥ 1.0)_ : * code retour du dernier "callback" exécuté (_WEECHAT_RC_OK_ si aucun "callback" - n'a été exécuté) : + n'a été exécuté) : ** _WEECHAT_RC_OK_ ** _WEECHAT_RC_OK_EAT_ ** _WEECHAT_RC_ERROR_ -Exemple en C : +Exemple en C : [source,C] ---- @@ -9623,7 +9623,7 @@ if (hashtable) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9643,12 +9643,12 @@ Le hsignal "irc_redirect_command" peut être envoyé pour rediriger la sortie d'une commande irc vers un "callback". Le paramètre est une table de hachage avec les entrées suivantes (les clés et -valeurs sont des chaînes) : +valeurs sont des chaînes) : -* _server_ : nom interne du serveur (requis) -* _pattern_ : modèle de redirection à utiliser (requis), soit un par défaut +* _server_ : nom interne du serveur (requis) +* _pattern_ : modèle de redirection à utiliser (requis), soit un par défaut (défini par l'extension irc), ou un modèle utilisateur (voir - <<hsignal_irc_redirect_pattern>>), les modèles par défaut sont : + <<hsignal_irc_redirect_pattern>>), les modèles par défaut sont : ** _ison_ ** _list_ ** _mode_channel_ @@ -9665,14 +9665,14 @@ valeurs sont des chaînes) : ** _who_ ** _whois_ ** _whowas_ -* _signal_ : nom du signal (requis) -* _count_ : nombre de fois que la redirection sera exécutée (optionnel, 1 par +* _signal_ : nom du signal (requis) +* _count_ : nombre de fois que la redirection sera exécutée (optionnel, 1 par défaut) -* _string_ : chaîne qui doit être dans les messages irc reçus (optionnel, mais +* _string_ : chaîne qui doit être dans les messages irc reçus (optionnel, mais recommandé, si une chaîne peut être utilisée pour identifier les messages) -* _timeout_ : temps d'attente maximum pour la redirection, en secondes +* _timeout_ : temps d'attente maximum pour la redirection, en secondes (optionnel, 60 par défaut) -* _cmd_filter_ : liste de commandes irc (séparées par des virgules) à filtrer +* _cmd_filter_ : liste de commandes irc (séparées par des virgules) à filtrer (seules ces commandes seront transmises au "callback", les autres seront ignorées) (optionnel) @@ -9684,18 +9684,18 @@ Ce hsignal a le nom _irc_redirection_xxx_yyy_ où _xxx_ est le _signal_ et _yyy_ le _pattern_ utilisé. La table de hachage envoyée dans le hsignal a le contenu suivant (les clés et -valeurs sont des chaînes) : +valeurs sont des chaînes) : -* _output_ : sortie de la commande (les messages sont séparés par "\n") -* _output_size_ : nombre d'octets dans _output_ (sous forme de chaîne) -* _error_ : chaîne d'erreur (si une erreur s'est produite) : -** _timeout_ : redirection stoppée après le délai maximum dépassé -* _server_ : nom interne du serveur -* _pattern_ : modèle de redirection -* _signal_ : nom du signal -* _command_ : commande redirigée +* _output_ : sortie de la commande (les messages sont séparés par "\n") +* _output_size_ : nombre d'octets dans _output_ (sous forme de chaîne) +* _error_ : chaîne d'erreur (si une erreur s'est produite) : +** _timeout_ : redirection stoppée après le délai maximum dépassé +* _server_ : nom interne du serveur +* _pattern_ : modèle de redirection +* _signal_ : nom du signal +* _command_ : commande redirigée -Exemple en C : +Exemple en C : [source,C] ---- @@ -9727,7 +9727,7 @@ if (hashtable) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9753,21 +9753,21 @@ Le hsignal "irc_redirect_pattern" peut être envoyé pour créer un modèle de redirection irc (voir <<hsignal_irc_redirect_command>>). Le paramètre est une table de hachage avec les entrées suivantes (les clés et -valeurs sont des chaînes) : +valeurs sont des chaînes) : -* _pattern_ : nom du modèle (requis) -* _timeout_ : temps d'attente maximum pour le modèle, en secondes (optionnel, 60 +* _pattern_ : nom du modèle (requis) +* _timeout_ : temps d'attente maximum pour le modèle, en secondes (optionnel, 60 par défaut) -* _cmd_start_ : liste de commandes (séparées par des virgules) démarrant la +* _cmd_start_ : liste de commandes (séparées par des virgules) démarrant la redirection (optionnel) -* _cmd_stop_ : liste de commandes (séparées par des virgules) stoppant la +* _cmd_stop_ : liste de commandes (séparées par des virgules) stoppant la redirection (requis) -* _cmd_extra_ : liste de commandes (séparées par des virgules) pouvant être +* _cmd_extra_ : liste de commandes (séparées par des virgules) pouvant être reçues après les commandes de stop (optionnel) Pour chaque commande dans _cmd_start_, _cmd_stop_ et _cmd_extra_, il est possible de donner un entier avec la position de la chaîne "string" qui doit -être trouvée dans le message reçu, par exemple : +être trouvée dans le message reçu, par exemple : ---- 352:1,354,401:1 @@ -9781,7 +9781,7 @@ Le modèle est détruit dès qu'il est utilisé dans une redirection. Si vous av besoin du modèle pour plusieurs redirections, vous devez créer un modèle pour chaque redirection. -Exemple en C : +Exemple en C : [source,C] ---- @@ -9807,7 +9807,7 @@ if (hashtable) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9827,7 +9827,7 @@ _Mis à jour dans la 1.5._ S'accrocher à une option de configuration. -Prototype : +Prototype : [source,C] ---- @@ -9840,33 +9840,33 @@ struct t_hook *weechat_hook_config (const char *option, void *callback_data); ---- -Paramètres : +Paramètres : -* _option_ : option, le format est le nom complet, celui utilisé avec la - commande `/set` (par exemple : `weechat.look.item_time_format`), le caractère +* _option_ : option, le format est le nom complet, celui utilisé avec la + commande `/set` (par exemple : `weechat.look.item_time_format`), le caractère joker `+*+` est autorisé (priorité autorisée, voir la note sur la <<hook_priority,priorité>>) -* _callback_ : fonction appelée lorsque l'option de configuration est modifiée, - paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *option_ : nom de l'option -** _const char *value_ : nouvelle valeur pour l'option -** valeur de retour : +* _callback_ : fonction appelée lorsque l'option de configuration est modifiée, + paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *option_ : nom de l'option +** _const char *value_ : nouvelle valeur pour l'option +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -9883,7 +9883,7 @@ struct t_hook *my_config_hook = weechat_hook_config ("weechat.look.item_time_for &my_config_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9905,7 +9905,7 @@ _Mis à jour dans la 1.5._ Accrocher un modificateur. -Prototype : +Prototype : [source,C] ---- @@ -9919,32 +9919,32 @@ struct t_hook *weechat_hook_modifier (const char *modifier, void *callback_data); ---- -Paramètres : +Paramètres : -* _modifier_ : nom du modificateur, liste des modificateurs utilisés par WeeChat +* _modifier_ : nom du modificateur, liste des modificateurs utilisés par WeeChat ou des extensions (priorité autorisée, voir la note sur la <<hook_priority,priorité>>) (voir le tableau ci-dessous) -* _callback_ : fonction appelée lorsque le modificateur est utilisé, paramètres - et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *modifier_ : nom du modificateur -** _const char *modifier_data_ : données pour le modificateur -** _const char *string_ : chaîne à modifier -** valeur de retour : nouvelle chaîne -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_ : fonction appelée lorsque le modificateur est utilisé, paramètres + et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *modifier_ : nom du modificateur +** _const char *modifier_data_ : données pour le modificateur +** _const char *string_ : chaîne à modifier +** valeur de retour : nouvelle chaîne +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Liste des modificateurs utilisés par WeeChat et les extensions : +Liste des modificateurs utilisés par WeeChat et les extensions : [width="100%",cols="^2,3,4,4",options="header"] |=== @@ -9983,8 +9983,8 @@ Liste des modificateurs utilisés par WeeChat et les extensions : | irc_command_auth + _(WeeChat ≥ 0.4.1)_ | Nom du serveur | - Commande d'authentification (par exemple : `+/msg nickserv identify password+`). | - Commande avec le mot de passe caché (par exemple : `+/msg nickserv identify ********+`). + Commande d'authentification (par exemple : `+/msg nickserv identify password+`). | + Commande avec le mot de passe caché (par exemple : `+/msg nickserv identify ********+`). | irc_message_auth + _(WeeChat ≥ 0.4.1)_ | @@ -10068,7 +10068,7 @@ Liste des modificateurs utilisés par WeeChat et les extensions : ^(1)^ _xxx_ est un nom de commande IRC. + ^(2)^ _yyy_ est le nom de la barre. -Exemple en C : +Exemple en C : [source,C] ---- @@ -10098,7 +10098,7 @@ struct t_hook *my_modifier_hook = weechat_hook_modifier ("weechat_print", &my_modifier_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10116,7 +10116,7 @@ hook = weechat.hook_modifier("weechat_print", "my_modifier_cb", "") Exécuter un ou plusieurs modificateurs. -Prototype : +Prototype : [source,C] ---- @@ -10125,17 +10125,17 @@ char *weechat_hook_modifier_exec (const char *modifier, const char *string); ---- -Paramètres : +Paramètres : -* _modifier_ : nom du modificateur -* _modifier_data_ : données du modificateur -* _string_ : chaîne à modifier +* _modifier_ : nom du modificateur +* _modifier_data_ : données du modificateur +* _string_ : chaîne à modifier -Valeur de retour : +Valeur de retour : * chaîne modifiée, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -10143,7 +10143,7 @@ char *new_string = weechat_hook_modifier_exec ("mon_modifier", mes_donnees, ma_chaine); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10160,7 +10160,7 @@ _Mis à jour dans la 1.5._ Accrocher une information (le "callback" prend et retourne une chaîne). -Prototype : +Prototype : [source,C] ---- @@ -10175,32 +10175,32 @@ struct t_hook *weechat_hook_info (const char *info_name, void *callback_data); ---- -Paramètres : +Paramètres : -* _info_name_ : nom de l'information +* _info_name_ : nom de l'information (priorité autorisée, voir la note sur la <<hook_priority,priorité>>) -* _description_ : description -* _args_description_ : description des paramètres (optionnel, peut être NULL) -* _callback_ : fonction appelée quand l'information est demandée, paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *info_name_ : nom de l'information -** _const char *arguments_ : paramètres additionnels, dépendant de +* _description_ : description +* _args_description_ : description des paramètres (optionnel, peut être NULL) +* _callback_ : fonction appelée quand l'information est demandée, paramètres et + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *info_name_ : nom de l'information +** _const char *arguments_ : paramètres additionnels, dépendant de l'information -** valeur de retour : valeur de l'information demandée -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +** valeur de retour : valeur de l'information demandée +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -10219,7 +10219,7 @@ struct t_hook *my_info_hook = weechat_hook_info ("mon_info", &my_info_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10242,7 +10242,7 @@ _WeeChat ≥ 0.3.4, mis à jour dans la 1.5._ Accrocher une information (le "callback" prend et retourne une table de hachage). -Prototype : +Prototype : [source,C] ---- @@ -10258,35 +10258,35 @@ struct t_hook *weechat_hook_info_hashtable (const char *info_name, void *callback_data); ---- -Paramètres : +Paramètres : -* _info_name_ : nom de l'information +* _info_name_ : nom de l'information (priorité autorisée, voir la note sur la <<hook_priority,priorité>>) -* _description_ : description -* _args_description_ : description de la table de hachage attendue +* _description_ : description +* _args_description_ : description de la table de hachage attendue (optionnel, peut être NULL) -* _output_description_ : description de la table de hachage retournée par le +* _output_description_ : description de la table de hachage retournée par le "callback" (optionnel, peut être NULL) -* _callback_ : fonction appelée quand l'information est demandée, paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *info_name_ : nom de l'information -** _struct t_hashtable *hashtable_ : table de hachage, dépendant de +* _callback_ : fonction appelée quand l'information est demandée, paramètres et + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *info_name_ : nom de l'information +** _struct t_hashtable *hashtable_ : table de hachage, dépendant de l'information -** valeur de retour : table de hachage demandée -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +** valeur de retour : table de hachage demandée +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -10306,7 +10306,7 @@ struct t_hook *my_info_hook = weechat_hook_info_hashtable ("mon_info_hashtable", &my_info_hashtable_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10328,10 +10328,10 @@ hook = weechat.hook_info_hashtable("mon_info_hashtable", "Une information", _Mis à jour dans la 1.5._ -Accrocher une infolist : le "callback" retournera un pointeur vers l'infolist +Accrocher une infolist : le "callback" retournera un pointeur vers l'infolist demandée. -Prototype : +Prototype : [source,C] ---- @@ -10348,34 +10348,34 @@ struct t_hook *weechat_hook_infolist (const char *infolist_name, void *callback_data); ---- -Paramètres : +Paramètres : -* _infolist_name_ : nom de l'infolist +* _infolist_name_ : nom de l'infolist (priorité autorisée, voir la note sur la <<hook_priority,priorité>>) -* _description_ : description -* _pointer_description_ : description du pointeur (optionnel, peut être NULL) -* _args_description_ : description des paramètres (optionnel, peut être NULL) -* _callback_ : fonction appelée quand l'infolist est demandée, paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *infolist_name_ : nom de l'infolist -** _void *pointer_ : pointeur vers un objet que l'infolist doit retourner (pour +* _description_ : description +* _pointer_description_ : description du pointeur (optionnel, peut être NULL) +* _args_description_ : description des paramètres (optionnel, peut être NULL) +* _callback_ : fonction appelée quand l'infolist est demandée, paramètres et + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *infolist_name_ : nom de l'infolist +** _void *pointer_ : pointeur vers un objet que l'infolist doit retourner (pour obtenir uniquement cet objet dans l'infolist) -** _const char *arguments_ : paramètres additionnels, dépendant de l'infolist -** valeur de retour : infolist demandée -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +** _const char *arguments_ : paramètres additionnels, dépendant de l'infolist +** valeur de retour : infolist demandée +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -10399,7 +10399,7 @@ struct t_hook *my_infolist = weechat_hook_infolist ("mon_infolist", &my_infolist_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10422,9 +10422,9 @@ hook = weechat.hook_infolist("mon_infolist", "Mon infolist", _Mis à jour dans la 1.5._ -Accrocher un hdata : le "callback" retournera un pointeur vers le hdata demandé. +Accrocher un hdata : le "callback" retournera un pointeur vers le hdata demandé. -Prototype : +Prototype : [source,C] ---- @@ -10437,29 +10437,29 @@ struct t_hook *weechat_hook_hdata (const char *hdata_name, void *callback_data); ---- -Paramètres : +Paramètres : -* _hdata_name_ : nom du hdata +* _hdata_name_ : nom du hdata (priorité autorisée, voir la note sur la <<hook_priority,priorité>>) -* _description_ : description -* _callback_ : fonction appelée quand le hdata est demandé, paramètres et valeur - de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *hdata_name_ : nom du hdata -** valeur de retour : hdata demandé -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _description_ : description +* _callback_ : fonction appelée quand le hdata est demandé, paramètres et valeur + de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *hdata_name_ : nom du hdata +** valeur de retour : hdata demandé +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -10487,10 +10487,10 @@ Cette fonction n'est pas disponible dans l'API script. _Mis à jour dans la 1.5._ -Accrocher un focus : évènement souris ou touche du clavier pressée dans le mode +Accrocher un focus : évènement souris ou touche du clavier pressée dans le mode "curseur" (mouvement libre du curseur). -Prototype : +Prototype : [source,C] ---- @@ -10502,38 +10502,38 @@ struct t_hook *weechat_hook_focus (const char *area, void *callback_data); ---- -Paramètres : +Paramètres : -* _area_ : "chat" pour la zone de discussion, ou un nom d'objet de barre +* _area_ : "chat" pour la zone de discussion, ou un nom d'objet de barre (priorité autorisée, voir la note sur la <<hook_priority,priorité>>) -* _callback_ : fonction appelée quand le focus est fait, paramètres et valeur de - retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_hashtable *info_ : table de hachage avec les informations sur le +* _callback_ : fonction appelée quand le focus est fait, paramètres et valeur de + retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_hashtable *info_ : table de hachage avec les informations sur le focus et les chaînes retournées par les autres appels aux "callbacks" de focus (avec plus haute priorité) (voir le tableau ci-dessous) -** valeur de retour : soit le pointeur vers la table de hachage "info" (avec la +** valeur de retour : soit le pointeur vers la table de hachage "info" (avec la table de hachage complétée), ou un pointeur vers une nouvelle table de hachage (créée par le "callback", avec clés et valeurs de type "string"), le contenu de cette nouvelle table de hachage sera ajouté à _info_ pour les autres appels aux "callbacks" focus -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé [IMPORTANT] -Pour un geste de souris, votre "callback" sera appelé deux fois : la première +Pour un geste de souris, votre "callback" sera appelé deux fois : la première lorsque le bouton est pressé (ici la zone correspond à vôtre zone), la seconde fois lorsque le bouton est relâché, et la zone peut ne pas correspondre à la -vôtre : donc vous devez *toujours* tester dans le "callback" si la zone +vôtre : donc vous devez *toujours* tester dans le "callback" si la zone correspond avant d'utiliser les informations de la table de hachage. Contenu de la table de hachage envoyée au "callback" (les clés et valeurs sont -de type "string") : +de type "string") : [width="100%",cols="5,5,8,3",options="header"] |=== @@ -10632,7 +10632,7 @@ de type "string") : |=== [NOTE] -^(1)^ Il y a les mêmes clés suffixées par "2" (c'est-à-dire : "_x2", "_y2", +^(1)^ Il y a les mêmes clés suffixées par "2" (c'est-à-dire : "_x2", "_y2", "_window2", ...) avec l'information sur le second point (pratique seulement pour les gestes de souris, pour savoir où le bouton de la souris a été relâché). + @@ -10641,7 +10641,7 @@ relâché). + ^(4)^ Il s'agit de la date lorsque WeeChat ajoute la ligne dans le tampon (supérieure ou égale à "_chat_line_date"). -Informations additionnelles pour l'objet de barre "buffer_nicklist" : +Informations additionnelles pour l'objet de barre "buffer_nicklist" : [width="60%",cols="1,1,5",options="header"] |=== @@ -10657,11 +10657,11 @@ Informations additionnelles pour l'objet de barre "buffer_nicklist" : pour cet objet de barre (donc par exemple si l'extension est "irc", ces infos ne seront disponibles que sur les tampons irc). -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -10679,7 +10679,7 @@ struct t_hook *my_focus = weechat_hook_focus ("buffer_nicklist", &my_focus_nicklist_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10697,11 +10697,11 @@ hook = weechat.hook_focus("buffer_nicklist", "my_focus_nicklist_cb", "") ==== hook_set -_WeeChat ≥ 0.3.9 (script : WeeChat ≥ 0.4.3)._ +_WeeChat ≥ 0.3.9 (script : WeeChat ≥ 0.4.3)._ Affecter une valeur à une propriété d'un hook. -Prototype : +Prototype : [source,C] ---- @@ -10709,13 +10709,13 @@ void weechat_hook_set (struct t_hook *hook, const char *property, const char *value); ---- -Paramètres : +Paramètres : -* _hook_ : quelque chose d'accroché avec "weechat_hook_xxx()" -* _property_ : nom de la propriété (voir le tableau ci-dessous) -* _value_ : nouvelle valeur pour la propriété +* _hook_ : quelque chose d'accroché avec "weechat_hook_xxx()" +* _property_ : nom de la propriété (voir le tableau ci-dessous) +* _value_ : nouvelle valeur pour la propriété -Propriétés : +Propriétés : [width="100%",cols="^2,2,2,5",options="header"] |=== @@ -10739,12 +10739,12 @@ Propriétés : | signal + _(WeeChat ≥ 1.0)_ | _process_, _process_hashtable_ | - numéro de signal ou un de ces noms : `hup`, `int`, `quit`, `kill`, `term`, + numéro de signal ou un de ces noms : `hup`, `int`, `quit`, `kill`, `term`, `usr1`, `usr2` | Envoyer un signal au proces.sus fils |=== -Exemple en C : +Exemple en C : [source,C] ---- @@ -10755,7 +10755,7 @@ struct t_hook *my_command_hook = weechat_hook_set (my_command_hook, "subplugin", "test"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10777,18 +10777,18 @@ weechat.hook_set(hook, "stdin_close", "") # facultatif Décrocher quelque chose qui est a été accroché. -Prototype : +Prototype : [source,C] ---- void weechat_unhook (struct t_hook *hook); ---- -Paramètres : +Paramètres : -* _hook_ : quelque chose accroché avec "weechat_hook_xxx()" +* _hook_ : quelque chose accroché avec "weechat_hook_xxx()" -Exemple en C : +Exemple en C : [source,C] ---- @@ -10797,7 +10797,7 @@ struct t_hook *my_hook = weechat_hook_command ( /* ... */ ); weechat_unhook (my_hook); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10814,26 +10814,26 @@ _Mis à jour dans la 1.5._ Décrocher tout ce qui a été accroché par l'extension courante. -Prototype : +Prototype : [source,C] ---- void weechat_unhook_all (const char *subplugin); ---- -Paramètres : +Paramètres : -* _subplugin_ : si non NULL, décrocher uniquement les "hooks" qui ont ce +* _subplugin_ : si non NULL, décrocher uniquement les "hooks" qui ont ce "subplugin" défini (ce paramètre n'est pas disponible dans l'API script) -Exemple en C : +Exemple en C : [source,C] ---- weechat_unhook_all (NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10855,7 +10855,7 @@ _Mis à jour dans la 1.5._ Ouvrir un nouveau tampon. -Prototype : +Prototype : [source,C] ---- @@ -10873,44 +10873,44 @@ struct t_gui_buffer *weechat_buffer_new (const char *name, void *close_callback_data); ---- -Paramètres : +Paramètres : -* _name_ : nom du tampon (doit être unique pour l'extension) -* _input_callback_ : fonction appelée lorsque du texte saisi est envoyé au - tampon, paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_gui_buffer *buffer_ : pointeur vers le tampon -** _const char *input_data_ : données en entrée -** valeur de retour : +* _name_ : nom du tampon (doit être unique pour l'extension) +* _input_callback_ : fonction appelée lorsque du texte saisi est envoyé au + tampon, paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_gui_buffer *buffer_ : pointeur vers le tampon +** _const char *input_data_ : données en entrée +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _input_callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé +* _input_callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _input_callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _input_callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le tampon est fermé -* _close_callback_ : fonction appelée lorsque le tampon est fermé, paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_gui_buffer *buffer_ : pointeur vers le tampon -** valeur de retour : +* _close_callback_ : fonction appelée lorsque le tampon est fermé, paramètres et + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_gui_buffer *buffer_ : pointeur vers le tampon +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _close_callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé +* _close_callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _close_callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _close_callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le tampon est fermé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau tampon, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -10918,7 +10918,7 @@ int my_input_cb (const void *pointer, void *data, struct t_gui_buffer *buffer, const char *input_data) { - weechat_printf (buffer, "Texte : %s", input_data); + weechat_printf (buffer, "Texte : %s", input_data); return WEECHAT_RC_OK; } @@ -10935,7 +10935,7 @@ struct t_gui_buffer *my_buffer = weechat_buffer_new ("mon_buffer", &my_close_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10945,7 +10945,7 @@ buffer = weechat.buffer_new(name, input_callback, input_callback_data, # exemple def my_input_cb(data, buffer, input_data): - weechat.prnt(buffer, "Texte : %s" % input_data) + weechat.prnt(buffer, "Texte : %s" % input_data) return weechat.WEECHAT_RC_OK def my_close_cb(data, buffer): @@ -10960,25 +10960,25 @@ buffer = weechat.buffer_new("mon_buffer", "my_input_cb", "", "my_close_cb", "") Retourner un pointeur vers le tampon courant (le tampon affiché par la fenêtre courante). -Prototype : +Prototype : [source,C] ---- struct t_gui_buffer *weechat_current_buffer (); ---- -Valeur de retour : +Valeur de retour : * pointeur vers le tampon courant -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (weechat_current_buffer (), "Texte sur le tampon courant"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10995,7 +10995,7 @@ _Mis à jour dans la 1.0._ Rechercher un tampon par l'extension et/ou le nom. -Prototype : +Prototype : [source,C] ---- @@ -11003,21 +11003,21 @@ struct t_gui_buffer *weechat_buffer_search (const char *plugin, const char *name); ---- -Paramètres : +Paramètres : -* _plugin_ : nom de l'extension, la valeur spéciale suivante est autorisée : -** `+==+` : le nom utilisé est le nom complet du tampon (par exemple : +* _plugin_ : nom de l'extension, la valeur spéciale suivante est autorisée : +** `+==+` : le nom utilisé est le nom complet du tampon (par exemple : `irc.freenode.#weechat` au lieu de `freenode.#weechat`) _(WeeChat ≥ 1.0)_ -* _name_ : nom du tampon, si c'est NULL ou une chaîne vide, le tampon courant +* _name_ : nom du tampon, si c'est NULL ou une chaîne vide, le tampon courant est retourné (tampon affiché par la fenêtre courante); si le nom commence par `(?i)`, la recherche est insensible à la casse _(WeeChat ≥ 1.0)_ -Valeur de retour : +Valeur de retour : * pointeur vers le tampon trouvé, NULL s'il n'a pas été trouvé -Exemples en C : +Exemples en C : [source,C] ---- @@ -11025,7 +11025,7 @@ struct t_gui_buffer *buffer1 = weechat_buffer_search ("irc", "freenode.#weechat" struct t_gui_buffer *buffer2 = weechat_buffer_search ("==", "irc.freenode.#test"); /* WeeChat ≥ 1.0 */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11041,25 +11041,25 @@ buffer = weechat.buffer_search("mon_extension", "mon_tampon") Rechercher le tampon principal de WeeChat (tampon _core_, premier tampon affiché lorsque WeeChat démarre). -Prototype : +Prototype : [source,C] ---- struct t_gui_buffer *weechat_buffer_search_main (); ---- -Valeur de retour : +Valeur de retour : * pointeur vers le tampon principal WeeChat (tampon _core_) -Exemple en C : +Exemple en C : [source,C] ---- struct t_gui_buffer *weechat_buffer = weechat_buffer_search_main (); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11074,18 +11074,18 @@ buffer = weechat.buffer_search_main() Effacer le contenu d'un tampon. -Prototype : +Prototype : [source,C] ---- void weechat_buffer_clear (struct t_gui_buffer *buffer); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon +* _buffer_ : pointeur vers le tampon -Exemple en C : +Exemple en C : [source,C] ---- @@ -11097,7 +11097,7 @@ if (my_buffer) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11114,18 +11114,18 @@ if buffer != "": Fermer un tampon. -Prototype : +Prototype : [source,C] ---- void weechat_buffer_close (struct t_gui_buffer *buffer); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon +* _buffer_ : pointeur vers le tampon -Exemple en C : +Exemple en C : [source,C] ---- @@ -11136,7 +11136,7 @@ struct t_gui_buffer *my_buffer = weechat_buffer_new ("mon_tampon", weechat_buffer_close (my_buffer); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11151,11 +11151,11 @@ weechat.buffer_close(buffer) ==== buffer_merge -Mélanger le tampon avec un autre tampon : les deux tampons continueront +Mélanger le tampon avec un autre tampon : les deux tampons continueront d'exister chacun de leur côté, mais avec le même numéro, et WeeChat affichera les lignes des deux tampons (lignes mélangées). -Prototype : +Prototype : [source,C] ---- @@ -11163,12 +11163,12 @@ void weechat_buffer_merge (struct t_gui_buffer *buffer, struct t_gui_buffer *target_buffer); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _target_buffer_ : tampon cible avec lequel on doit mélanger +* _buffer_ : pointeur vers le tampon +* _target_buffer_ : tampon cible avec lequel on doit mélanger -Exemple en C : +Exemple en C : [source,C] ---- @@ -11177,7 +11177,7 @@ weechat_buffer_merge (weechat_current_buffer (), weechat_buffer_search_main ()); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11193,7 +11193,7 @@ weechat.buffer_merge(weechat.current_buffer(), weechat.buffer_search_main()) Supprimer le mélange d'un tampon. -Prototype : +Prototype : [source,C] ---- @@ -11201,20 +11201,20 @@ void weechat_buffer_unmerge (struct t_gui_buffer *buffer, int number); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _number_ : numéro cible pour le tampon détaché, s'il est < 1, alors le tampon +* _buffer_ : pointeur vers le tampon +* _number_ : numéro cible pour le tampon détaché, s'il est < 1, alors le tampon sera déplacé vers le numéro du tampon + 1 -Exemple en C : +Exemple en C : [source,C] ---- weechat_buffer_unmerge (weechat_current_buffer (), 1); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11229,7 +11229,7 @@ weechat.buffer_unmerge(weechat.current_buffer(), 1) Retourner une valeur entière pour une propriété du tampon. -Prototype : +Prototype : [source,C] ---- @@ -11237,72 +11237,72 @@ int weechat_buffer_get_integer (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _property_ : nom de la propriété : -** _number_ : numéro du tampon (commence à 1) -** _layout_number_ : numéro du tampon sauvegardé dans le "layout" -** _layout_number_merge_order_ : ordre du tampon mélangé pour le "layout" -** _short_name_is_set_ : 1 si le nom court est défini, 0 si non défini -** _type_ : type de tampon (0 : formaté, 1 : contenu libre) -** _notify_ : niveau de notification du tampon -** _num_displayed_ : nombre de fenêtres affichant ce tampon -** _active_ : 2 si le tampon est le seul actif (mélangé), 1 si le tampon est +* _buffer_ : pointeur vers le tampon +* _property_ : nom de la propriété : +** _number_ : numéro du tampon (commence à 1) +** _layout_number_ : numéro du tampon sauvegardé dans le "layout" +** _layout_number_merge_order_ : ordre du tampon mélangé pour le "layout" +** _short_name_is_set_ : 1 si le nom court est défini, 0 si non défini +** _type_ : type de tampon (0 : formaté, 1 : contenu libre) +** _notify_ : niveau de notification du tampon +** _num_displayed_ : nombre de fenêtres affichant ce tampon +** _active_ : 2 si le tampon est le seul actif (mélangé), 1 si le tampon est actif, 0 si le tampon est mélangé et n'est pas sélectionné -** _hidden_ : 1 si le tampon est caché, sinon 0 +** _hidden_ : 1 si le tampon est caché, sinon 0 _(WeeChat ≥ 1.0)_ -** _zoomed_ : 1 si le tampon est mélangé et zoomé, sinon 0 +** _zoomed_ : 1 si le tampon est mélangé et zoomé, sinon 0 _(WeeChat ≥ 1.0)_ -** _print_hooks_enabled_ : 1 si les hooks "print" sont activés, sinon 0 -** _day_change_ : 1 si les messages de changement de jour sont affichés, sinon 0 +** _print_hooks_enabled_ : 1 si les hooks "print" sont activés, sinon 0 +** _day_change_ : 1 si les messages de changement de jour sont affichés, sinon 0 _(WeeChat ≥ 0.4.3)_ -** _clear_ : 1 si le tampon peut être effacé avec la commande `/buffer clear`, +** _clear_ : 1 si le tampon peut être effacé avec la commande `/buffer clear`, sinon 0 _(WeeChat ≥ 1.0)_ -** _filter_ : 1 si les filtres sont activés sur le tampon, sinon 0 +** _filter_ : 1 si les filtres sont activés sur le tampon, sinon 0 _(WeeChat ≥ 1.0)_ -** _lines_hidden_ : 1 si au moins une ligne est cachée dans le tampon +** _lines_hidden_ : 1 si au moins une ligne est cachée dans le tampon (filtrée), ou 0 si toutes les lignes sont affichées -** _prefix_max_length_ : longueur maximale du préfixe dans ce tampon -** _time_for_each_line_ : 1 si l'heure est affichée pour chaque ligne du tampon +** _prefix_max_length_ : longueur maximale du préfixe dans ce tampon +** _time_for_each_line_ : 1 si l'heure est affichée pour chaque ligne du tampon (par défaut), sinon 0 -** _nicklist_ : 1 si la liste de pseudos est activée, sinon 0 -** _nicklist_case_sensitive_ : 1 si les pseudos sont sensibles à la casse, +** _nicklist_ : 1 si la liste de pseudos est activée, sinon 0 +** _nicklist_case_sensitive_ : 1 si les pseudos sont sensibles à la casse, sinon 0 -** _nicklist_max_length_ : longueur maximale d'un pseudo -** _nicklist_display_groups_ : 1 si les groupes sont affichés, sinon 0 -** _nicklist_count_ : nombre de pseudos et groupes dans la liste de pseudos -** _nicklist_groups_count_ : nombre de groupes dans la liste de pseudos -** _nicklist_nicks_count_ : nombre de pseudos dans la liste de pseudos -** _nicklist_visible_count_ : nombre de pseudos/groupes affichés -** _input_ : 1 si la zone de saisie est activée, sinon 0 -** _input_get_unknown_commands_ : 1 si les commandes inconnues sont envoyées +** _nicklist_max_length_ : longueur maximale d'un pseudo +** _nicklist_display_groups_ : 1 si les groupes sont affichés, sinon 0 +** _nicklist_count_ : nombre de pseudos et groupes dans la liste de pseudos +** _nicklist_groups_count_ : nombre de groupes dans la liste de pseudos +** _nicklist_nicks_count_ : nombre de pseudos dans la liste de pseudos +** _nicklist_visible_count_ : nombre de pseudos/groupes affichés +** _input_ : 1 si la zone de saisie est activée, sinon 0 +** _input_get_unknown_commands_ : 1 si les commandes inconnues sont envoyées au "callback input", sinon 0 -** _input_size_ : taille de la zone de saisie (en octets) -** _input_length_ : longueur de la zone de saisie (nombre de caractères) -** _input_pos_ : position du curseur dans la zone de saisie -** _input_1st_display_ : premier caractère affiché à l'écran -** _num_history_ : nombre de commandes dans l'historique -** _text_search_ : type de recherche de texte : -*** 0 : pas de recherche en cours -*** 1 : recherche arrière (vers les messages les plus anciens) -*** 2 : recherche avant (vers les messages les plus récents) -** _text_search_exact_ : 1 si la recherche de texte est sensible à la casse -** _text_search_found_ : 1 si du texte a été trouvé, sinon 0 - -Valeur de retour : +** _input_size_ : taille de la zone de saisie (en octets) +** _input_length_ : longueur de la zone de saisie (nombre de caractères) +** _input_pos_ : position du curseur dans la zone de saisie +** _input_1st_display_ : premier caractère affiché à l'écran +** _num_history_ : nombre de commandes dans l'historique +** _text_search_ : type de recherche de texte : +*** 0 : pas de recherche en cours +*** 1 : recherche arrière (vers les messages les plus anciens) +*** 2 : recherche avant (vers les messages les plus récents) +** _text_search_exact_ : 1 si la recherche de texte est sensible à la casse +** _text_search_found_ : 1 si du texte a été trouvé, sinon 0 + +Valeur de retour : * valeur entière de la propriété -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "mon numéro de tampon est : %d", +weechat_printf (NULL, "mon numéro de tampon est : %d", weechat_buffer_get_integer (mon_tampon, "number")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11310,14 +11310,14 @@ Script (Python) : value = weechat.buffer_get_integer(buffer, property) # exemple -weechat.prnt("", "mon numéro de tampon est : %d" % weechat.buffer_get_integer(my_buffer, "number")) +weechat.prnt("", "mon numéro de tampon est : %d" % weechat.buffer_get_integer(my_buffer, "number")) ---- ==== buffer_get_string Retourner la valeur d'une propriété du tampon sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- @@ -11325,45 +11325,45 @@ const char *weechat_buffer_get_string (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _property_ : nom de la propriété : -** _plugin_ : nom de l'extension qui a créé ce tampon ("core" pour le tampon +* _buffer_ : pointeur vers le tampon +* _property_ : nom de la propriété : +** _plugin_ : nom de l'extension qui a créé ce tampon ("core" pour le tampon principal WeeChat) -** _name_ : nom du tampon -** _full_name_ : nom complet du tampon ("extension.nom") _(WeeChat ≥ 0.3.7)_ -** _short_name_ : nom court du tampon (note : utilisé pour l'affichage +** _name_ : nom du tampon +** _full_name_ : nom complet du tampon ("extension.nom") _(WeeChat ≥ 0.3.7)_ +** _short_name_ : nom court du tampon (note : utilisé pour l'affichage seulement et peut être changé par l'utilisateur, il ne doit pas être utilisé pour trouver le nom du tampon, utilisez à la place _name_, _full_name_ ou bien la variable locale _channel_) -** _title_ : titre du tampon -** _input_ : texte saisi -** _text_search_input_ : texte saisi sauvegardé avant la recherche de texte -** _highlight_words_ : liste des mots pour le highlight -** _highlight_regex_ : expression régulière POSIX étendue pour le highlight -** _highlight_tags_restrict_ : restreindre les highlights aux messages +** _title_ : titre du tampon +** _input_ : texte saisi +** _text_search_input_ : texte saisi sauvegardé avant la recherche de texte +** _highlight_words_ : liste des mots pour le highlight +** _highlight_regex_ : expression régulière POSIX étendue pour le highlight +** _highlight_tags_restrict_ : restreindre les highlights aux messages comportant ces étiquettes -** _highlight_tags_ : forcer le highlight pour les messages avec ces étiquettes -** _hotlist_max_level_nicks_ : niveau maximum pour la hotlist pour certains +** _highlight_tags_ : forcer le highlight pour les messages avec ces étiquettes +** _hotlist_max_level_nicks_ : niveau maximum pour la hotlist pour certains pseudos -** _localvar_xxx_ : contenu de la variable locale "xxx" (remplacer "xxx" par le +** _localvar_xxx_ : contenu de la variable locale "xxx" (remplacer "xxx" par le nom de la variable locale à lire) -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de chaîne -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "nom / nom court du tampon sont : %s / %s", +weechat_printf (NULL, "nom / nom court du tampon sont : %s / %s", weechat_buffer_get_string (my_buffer, "name"), weechat_buffer_get_string (my_buffer, "short_name")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11371,7 +11371,7 @@ Script (Python) : value = weechat.buffer_get_string(buffer, property) # exemple -weechat.prnt("", "nom / nom court du tampon sont : %s / %s" +weechat.prnt("", "nom / nom court du tampon sont : %s / %s" % (weechat.buffer_get_string(my_buffer, "name"), weechat.buffer_get_string(my_buffer, "short_name"))) ---- @@ -11380,7 +11380,7 @@ weechat.prnt("", "nom / nom court du tampon sont : %s / %s" Retourner la valeur d'une propriété sous forme d'un pointeur. -Prototype : +Prototype : [source,C] ---- @@ -11388,27 +11388,27 @@ void *weechat_buffer_pointer (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _property_ : nom de la propriété : -** _plugin_ : pointeur vers l'extension qui a créé le tampon (NULL pour le +* _buffer_ : pointeur vers le tampon +* _property_ : nom de la propriété : +** _plugin_ : pointeur vers l'extension qui a créé le tampon (NULL pour le tampon principal WeeChat) -** _highlight_regex_compiled_ : expression régulière _highlight_regex_ compilée +** _highlight_regex_compiled_ : expression régulière _highlight_regex_ compilée -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de pointeur -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "pointeur vers l'extension de mon tampon : %lx", +weechat_printf (NULL, "pointeur vers l'extension de mon tampon : %lx", weechat_buffer_get_pointer (mon_tampon, "plugin")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11416,14 +11416,14 @@ Script (Python) : value = weechat.buffer_get_pointer(buffer, property) # exemple -weechat.prnt("", "pointeur vers l'extension de mon tampon : %s" % weechat.buffer_get_pointer(my_buffer, "plugin")) +weechat.prnt("", "pointeur vers l'extension de mon tampon : %s" % weechat.buffer_get_pointer(my_buffer, "plugin")) ---- ==== buffer_set Affecter une valeur à une propriété d'un tampon. -Prototype : +Prototype : [source,C] ---- @@ -11431,13 +11431,13 @@ void weechat_buffer_set (struct t_gui_buffer *buffer, const char *property, const char *value); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _property_ : nom de la propriété (voir le tableau ci-dessous) -* _value_ : nouvelle valeur pour la propriété +* _buffer_ : pointeur vers le tampon +* _property_ : nom de la propriété (voir le tableau ci-dessous) +* _value_ : nouvelle valeur pour la propriété -Propriétés : +Propriétés : [width="100%",cols="^2,4,8",options="header"] |=== @@ -11445,31 +11445,31 @@ Propriétés : | hotlist | "+", "-", WEECHAT_HOTLIST_LOW, WEECHAT_HOTLIST_MESSAGE, WEECHAT_HOTLIST_PRIVATE, WEECHAT_HOTLIST_HIGHLIGHT, "-1" | - "+" : active la hotlist (option globale, le pointeur vers le tampon n'est pas + "+" : active la hotlist (option globale, le pointeur vers le tampon n'est pas utilisé) + - "-" : désactive la hotlist (option globale, le pointeur vers le tampon n'est + "-" : désactive la hotlist (option globale, le pointeur vers le tampon n'est pas utilisé) + - priorité : ajouter ce tampon dans la hotlist avec cette priorité + - "-1" : supprimer ce tampon de la hotlist _(WeeChat ≥ 1.0)_. + priorité : ajouter ce tampon dans la hotlist avec cette priorité + + "-1" : supprimer ce tampon de la hotlist _(WeeChat ≥ 1.0)_. | completion_freeze | "0" ou "1" | - "0" : pas de gel de la complétion (valeur par défaut) + "0" : pas de gel de la complétion (valeur par défaut) (option globale, le pointeur vers le tampon n'est pas utilisé) + - "1" : ne pas arrêter la complétion lorsque la ligne de commande est mise à + "1" : ne pas arrêter la complétion lorsque la ligne de commande est mise à jour (option globale, le pointeur vers le tampon n'est pas utilisé). | unread | - | Définit le marqueur de données non lues après la dernière ligne du tampon. | display | "1" ou "auto" | - "1" : basculer vers ce tampon dans la fenêtre active + - "auto" : basculer vers ce tampon dans la fenêtre active, le marqueur de + "1" : basculer vers ce tampon dans la fenêtre active + + "auto" : basculer vers ce tampon dans la fenêtre active, le marqueur de données non lues n'est pas réinitialisé. | hidden + _(WeeChat ≥ 1.0)_ | "0" ou "1" | - "0" : démasquer le tampon + - "1" : masquer le tampon. + "0" : démasquer le tampon + + "1" : masquer le tampon. | number | numéro | Déplace le tampon vers ce numéro. @@ -11481,12 +11481,12 @@ Propriétés : Change le nom court du tampon. | type | "formatted" ou "free" | - Définit le type de tampon : "formatted" (pour afficher les messages d'une + Définit le type de tampon : "formatted" (pour afficher les messages d'une discussion), ou "free" (pour du contenu libre); lorsque la valeur est "free", la propriété _clear_ est forcée à "0" _(WeeChat ≥ 1.0)_. | notify | "0", "1", "2", "3" | - Définit le niveau de notification du tampon : "0" = ne jamais ajouter à la + Définit le niveau de notification du tampon : "0" = ne jamais ajouter à la hotlist, "1" = ajouter pour les highlights seulement, "2" = ajouter pour les highlights et les messages, "3" = ajouter pour tous les messages. @@ -11503,13 +11503,13 @@ Propriétés : _(WeeChat ≥ 1.0)_ | "0" ou "1" | "0" pour empêcher l'utilisateur d'effacer le tampon avec la commande `/buffer clear`, "1" pour autoriser l'utilisateur à effacer le tampon (par - défaut pour un nouveau tampon) (note : même lorsque la valeur est "0", le + défaut pour un nouveau tampon) (note : même lorsque la valeur est "0", le tampon peut toujours être effacé avec la fonction <<_buffer_clear,buffer_clear>>). | filter + _(WeeChat ≥ 1.0)_ | "0" or "1" | - "0" : désactiver les filtres sur le tampon + - "1" : activer les filtres sur le tampon. + "0" : désactiver les filtres sur le tampon + + "1" : activer les filtres sur le tampon. | title | toute chaîne | Change le titre du tampon. @@ -11532,7 +11532,7 @@ Propriétés : | highlight_words | "-" ou une liste de mots séparés par des virgules | "-" est une valeur spéciale pour désactiver tout highlight sur ce tampon, ou - une liste de mots à mettre en valeur dans ce tampon, par exemple : + une liste de mots à mettre en valeur dans ce tampon, par exemple : "abc,def,ghi". | highlight_words_add | liste de mots séparés par des virgules | @@ -11549,17 +11549,17 @@ Propriétés : | highlight_tags_restrict | liste d'étiquettes séparées par des virgules | Restreindre les highlights aux messages avec ces étiquettes dans ce tampon (il est possible de combiner plusieurs étiquettes sous forme d'un "et" logique - avec le séparateur "+", par exemple : "nick_toto+irc_action"). + avec le séparateur "+", par exemple : "nick_toto+irc_action"). | highlight_tags | liste d'étiquettes séparées par des virgules | Forcer le highlight pour les messages avec ces étiquettes dans ce tampon (il est possible de combiner plusieurs étiquettes sous forme d'un "et" logique - avec le séparateur "+", par exemple : "nick_toto+irc_action"). + avec le séparateur "+", par exemple : "nick_toto+irc_action"). | hotlist_max_level_nicks | liste de "pseudo:niveau" séparés par des virgules | Liste de pseudos avec niveau max pour la hotlist sur ce tampon (le niveau peut - être : -1 : jamais dans la hotlist, 0 : faible, 1 : message, 2 : privé, - 3 : highlight), par exemple : "joe:2,mike:-1,robert:-1" (joe ne produira + être : -1 : jamais dans la hotlist, 0 : faible, 1 : message, 2 : privé, + 3 : highlight), par exemple : "joe:2,mike:-1,robert:-1" (joe ne produira jamais de highlight sur le tampon, mike et robert ne changeront jamais la hotlist). @@ -11597,7 +11597,7 @@ Propriétés : Supprime la variable locale _xxx_. |=== -Exemple en C : +Exemple en C : [source,C] ---- @@ -11617,7 +11617,7 @@ weechat_buffer_set (mon_tampon, "localvar_set_toto", "abc"); weechat_buffer_set (mon_tampon, "localvar_del_toto", NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11646,7 +11646,7 @@ weechat.buffer_set(my_buffer, "localvar_del_toto", "") Affecter un pointeur à une propriété d'un tampon. -Prototype : +Prototype : [source,C] ---- @@ -11654,25 +11654,25 @@ void weechat_buffer_set_pointer (struct t_gui_buffer *buffer, const char *proper void *pointer); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _property_ : nom de la propriété : -** _close_callback_ : définit la fonction "callback" de fermeture du tampon -** _close_callback_data_ : définit les données pour le "callback" de fermeture +* _buffer_ : pointeur vers le tampon +* _property_ : nom de la propriété : +** _close_callback_ : définit la fonction "callback" de fermeture du tampon +** _close_callback_data_ : définit les données pour le "callback" de fermeture du tampon -** _input_callback_ : définit la fonction de "callback" pour les données en +** _input_callback_ : définit la fonction de "callback" pour les données en entrée -** _input_callback_data_ : définit les données pour le "callback" des données +** _input_callback_data_ : définit les données pour le "callback" des données en entrée -** _nickcmp_callback_ : définit la fonction "callback" de comparaison de pseudos +** _nickcmp_callback_ : définit la fonction "callback" de comparaison de pseudos (ce "callback" est appelé lors de la recherche d'un pseudo dans la liste des pseudos) _(WeeChat ≥ 0.3.9)_ -** _nickcmp_callback_data_ : définit les données pour le "callback" de +** _nickcmp_callback_data_ : définit les données pour le "callback" de comparaison de pseudos _(WeeChat ≥ 0.3.9)_ -* _pointer_ : nouvelle valeur de pointeur pour la propriété +* _pointer_ : nouvelle valeur de pointeur pour la propriété -Prototypes pour les "callbacks" : +Prototypes pour les "callbacks" : [source,C] ---- @@ -11687,7 +11687,7 @@ int nickcmp_callback (const void *pointer, void *data, const char *nick1, const char *nick2); ---- -Exemple en C : +Exemple en C : [source,C] ---- @@ -11709,7 +11709,7 @@ Cette fonction n'est pas disponible dans l'API script. Remplacer les variables locales dans une chaîne par leurs valeurs, en utilisant les variables locales du tampon. -Prototype : +Prototype : [source,C] ---- @@ -11717,16 +11717,16 @@ char *weechat_buffer_string_replace_local_var (struct t_gui_buffer *buffer, const char *string); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _string_ : chaîne avec du texte et des variables locales, au format "$var" +* _buffer_ : pointeur vers le tampon +* _string_ : chaîne avec du texte et des variables locales, au format "$var" -Valeur de retour : +Valeur de retour : * chaîne avec les valeurs des variables locales -Exemple en C : +Exemple en C : [source,C] ---- @@ -11737,7 +11737,7 @@ char *str = weechat_buffer_string_replace_local_var (mon_tampon, /* str contient "test avec abc" */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11756,26 +11756,26 @@ _WeeChat ≥ 0.3.5._ Vérifier si le tampon correspond à la liste de tampons. -Prototype : +Prototype : [source,C] ---- int weechat_buffer_match_list (struct t_gui_buffer *buffer, const char *string); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _string_ : liste de tampons, séparés par des virgules : +* _buffer_ : pointeur vers le tampon +* _string_ : liste de tampons, séparés par des virgules : ** `+*+` signifie tous les tampons ** un nom commençant par `+!+` est exclu ** le caractère joker `+*+` est autorisé dans le nom -Valeur de retour : +Valeur de retour : * 1 si le tampon correspond à la liste de tampons, 0 sinon -Exemple en C : +Exemple en C : [source,C] ---- @@ -11789,7 +11789,7 @@ if (buffer) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11814,25 +11814,25 @@ Fonctions pour interroger les fenêtres. Retourner le pointeur vers la fenêtre courante. -Prototype : +Prototype : [source,C] ---- struct t_gui_window *weechat_current_window (); ---- -Valeur de retour : +Valeur de retour : * pointeur vers la fenêtre courante -Exemple en C : +Exemple en C : [source,C] ---- struct t_gui_window *current_window = weechat_current_window (); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11849,32 +11849,32 @@ _WeeChat ≥ 0.3.5._ Retourner le pointeur vers la fenêtre affichant un tampon. -Prototype : +Prototype : [source,C] ---- struct t_gui_window *weechat_window_search_with_buffer (struct t_gui_buffer *buffer); ---- -Paramètre : +Paramètre : -* _buffer_ : pointeur vers le tampon +* _buffer_ : pointeur vers le tampon -Valeur de retour : +Valeur de retour : * pointeur vers la fenêtre affichant un tampon (NULL si aucune fenêtre n'affiche ce tampon) -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (NULL, - "fenêtre affichant le tampon core : %lx", + "fenêtre affichant le tampon core : %lx", weechat_window_search_with_buffer (weechat_buffer_search_main ())); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11882,7 +11882,7 @@ Script (Python) : window = weechat.window_search_with_buffer(buffer) # exemple -weechat.prnt("", "fenêtre affichant le tampon core : %s" +weechat.prnt("", "fenêtre affichant le tampon core : %s" % weechat.window_search_with_buffer(weechat.buffer_search_main())) ---- @@ -11890,7 +11890,7 @@ weechat.prnt("", "fenêtre affichant le tampon core : %s" Retourner la valeur entière d'une propriété de la fenêtre. -Prototype : +Prototype : [source,C] ---- @@ -11898,50 +11898,50 @@ int weechat_window_get_integer (struct t_gui_window *window, const char *property); ---- -Paramètres : +Paramètres : -* _window_ : pointeur vers la fenêtre -* _property_ : nom de la propriété : -** _number_ : numéro de la fenêtre (commence à 1) -** _win_x_ : position X de la fenêtre dans le terminal (la première colonne est +* _window_ : pointeur vers la fenêtre +* _property_ : nom de la propriété : +** _number_ : numéro de la fenêtre (commence à 1) +** _win_x_ : position X de la fenêtre dans le terminal (la première colonne est 0) -** _win_y_ : position Y de la fenêtre dans le terminal (la première ligne est +** _win_y_ : position Y de la fenêtre dans le terminal (la première ligne est 0) -** _win_width_ : largeur de la fenêtre, en caractères -** _win_height_ : hauteur de la fenêtre, en caractères -** _win_width_pct_ : taille en pourcentage, en comparaison avec la fenêtre +** _win_width_ : largeur de la fenêtre, en caractères +** _win_height_ : hauteur de la fenêtre, en caractères +** _win_width_pct_ : taille en pourcentage, en comparaison avec la fenêtre parente (par exemple 50 indique une largeur de moitié) -** _win_height_pct_ : taille en pourcentage, en comparaison avec la fenêtre +** _win_height_pct_ : taille en pourcentage, en comparaison avec la fenêtre parente (par exemple 50 indique une hauteur de moitié) -** _win_chat_x_ : position X de la fenêtre de discussion ("chat") dans le +** _win_chat_x_ : position X de la fenêtre de discussion ("chat") dans le terminal (la première colonne est 0) -** _win_chat_y_ : position Y de la fenêtre de discussion ("chat") dans le +** _win_chat_y_ : position Y de la fenêtre de discussion ("chat") dans le terminal (la première ligne est 0) -** _win_chat_width_ : largeur de la fenêtre de discussion ("chat"), en +** _win_chat_width_ : largeur de la fenêtre de discussion ("chat"), en caractères -** _win_chat_height_ : hauteur de la fenêtre de discussion ("chat"), en +** _win_chat_height_ : hauteur de la fenêtre de discussion ("chat"), en caractères -** _first_line_displayed_ : 1 si la première du tampon est affichée à l'écran, +** _first_line_displayed_ : 1 si la première du tampon est affichée à l'écran, sinon 0 -** _scrolling_ : 1 s'il y a un défilement en cours dans la fenêtre (la dernière +** _scrolling_ : 1 s'il y a un défilement en cours dans la fenêtre (la dernière ligne n'est pas affichée) -** _lines_after_ : nombre de lignes non affichées après la dernière ligne +** _lines_after_ : nombre de lignes non affichées après la dernière ligne affichée (lors d'un défilement) -Valeur de retour : +Valeur de retour : * valeur entière de la propriété -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "la fenêtre courante est en position (x,y) : (%d,%d)", +weechat_printf (NULL, "la fenêtre courante est en position (x,y) : (%d,%d)", weechat_window_get_integer (weechat_current_window (), "win_x"), weechat_window_get_integer (weechat_current_window (), "win_y")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11949,7 +11949,7 @@ Script (Python) : value = weechat.window_get_integer(window, property) # exemple -weechat.prnt("", "la fenêtre courante est en position (x,y) : (%d,%d)" +weechat.prnt("", "la fenêtre courante est en position (x,y) : (%d,%d)" % (weechat.window_get_integer(weechat.current_window(), "win_x"), weechat.window_get_integer(weechat.current_window(), "win_y"))) ---- @@ -11962,7 +11962,7 @@ Retourner la valeur d'une propriété de la fenêtre sous forme d'une chaîne. Cette fonction n'est pas utilisée aujourd'hui, elle est réservée pour une version future. -Prototype : +Prototype : [source,C] ---- @@ -11970,12 +11970,12 @@ int weechat_window_get_string (struct t_gui_window *window, const char *property); ---- -Paramètres : +Paramètres : -* _window_ : pointeur vers la fenêtre -* _property_ : nom de la propriété +* _window_ : pointeur vers la fenêtre +* _property_ : nom de la propriété -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de chaîne @@ -11983,7 +11983,7 @@ Valeur de retour : Retourner la valeur d'une propriété, sous forme d'un pointeur. -Prototype : +Prototype : [source,C] ---- @@ -11991,27 +11991,27 @@ void *weechat_window_get_pointer (struct t_gui_window *window, const char *property); ---- -Paramètres : +Paramètres : -* _window_ : pointeur vers la fenêtre -* _property_ : nom de la propriété : -** _current_ : pointeur vers la fenêtre courante -** _buffer_ : pointeur vers le tampon affiché par la fenêtre +* _window_ : pointeur vers la fenêtre +* _property_ : nom de la propriété : +** _current_ : pointeur vers la fenêtre courante +** _buffer_ : pointeur vers le tampon affiché par la fenêtre -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de pointeur -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (NULL, - "tampon affiché dans la fenêtre courante : %lx", + "tampon affiché dans la fenêtre courante : %lx", weechat_window_get_pointer (weechat_current_window (), "buffer")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12019,7 +12019,7 @@ Script (Python) : value = weechat.window_get_pointer(window, property) # exemple -weechat.prnt("", "tampon affiché dans la fenêtre courante : %s" +weechat.prnt("", "tampon affiché dans la fenêtre courante : %s" % weechat.window_get_pointer(weechat.current_window(), "buffer")) ---- @@ -12027,27 +12027,27 @@ weechat.prnt("", "tampon affiché dans la fenêtre courante : %s" Définir le titre du terminal. -Prototype : +Prototype : [source,C] ---- void weechat_window_set_title (const char *title); ---- -Paramètres : +Paramètres : -* _title_ : nouveau titre pour le terminal (NULL pour réinitialiser le titre) ; +* _title_ : nouveau titre pour le terminal (NULL pour réinitialiser le titre) ; la chaîne est évaluée, donc les variables comme `${info:version}` peuvent être utilisées (voir <<_string_eval_expression,string_eval_expression>>) -Exemple en C : +Exemple en C : [source,C] ---- weechat_window_set_title ("nouveau titre ici"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12067,7 +12067,7 @@ Fonctions pour la liste des pseudos. Ajouter un groupe dans la liste des pseudos. -Prototype : +Prototype : [source,C] ---- @@ -12078,35 +12078,35 @@ struct t_gui_nick_group *weechat_nicklist_add_group (struct t_gui_buffer *buffer int visible); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _parent_group_ : pointeur vers le parent du groupe, NULL si le groupe n'a pas +* _buffer_ : pointeur vers le tampon +* _parent_group_ : pointeur vers le parent du groupe, NULL si le groupe n'a pas de parent (racine de la liste des pseudos) -* _name_ : nom du groupe -* _color_ : nom de l'option contenant la couleur : +* _name_ : nom du groupe +* _color_ : nom de l'option contenant la couleur : ** une option WeeChat, par exemple _weechat.color.nicklist_group_ ** une couleur avec un fond optionnel, par exemple _yellow_ ou _yellow,red_ -** nom d'une couleur de barre : -*** _bar_fg_ : couleur de texte pour la barre -*** _bar_delim_ : couleur des délimiteurs pour la barre -*** _bar_bg_ : couleur de fond pour la barre -* _visible_ : -** _1_ : le groupe et ses sous-groupes/pseudos sont visibles -** _0_ : le groupe et ses sous-groupes/pseudos sont cachés +** nom d'une couleur de barre : +*** _bar_fg_ : couleur de texte pour la barre +*** _bar_delim_ : couleur des délimiteurs pour la barre +*** _bar_bg_ : couleur de fond pour la barre +* _visible_ : +** _1_ : le groupe et ses sous-groupes/pseudos sont visibles +** _0_ : le groupe et ses sous-groupes/pseudos sont cachés [NOTE] Le nom du groupe peut commencer par un ou plusieurs chiffres, suivis d'un pipe ("|"), puis du nom du groupe. Quand une telle chaîne est trouvée au début, elle est utilisée pour trier les groupes dans la liste des pseudos. Par exemple les -groupes "1|test" et "2|abc" seront affichés dans cet ordre : "test" en premier, +groupes "1|test" et "2|abc" seront affichés dans cet ordre : "test" en premier, puis "abc" en second. -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau groupe, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -12118,7 +12118,7 @@ struct t_gui_nick_group *my_group = 1); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12134,7 +12134,7 @@ group = weechat.nicklist_add_group(my_buffer, my_parent_group, "groupe_test", Rechercher un groupe dans la liste des pseudos. -Prototype : +Prototype : [source,C] ---- @@ -12143,18 +12143,18 @@ struct t_gui_nick_group *weechat_nicklist_search_group (struct t_gui_buffer *buf const char *name); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _from_group_ : recherche depuis ce groupe seulement, si NULL, alors recherche +* _buffer_ : pointeur vers le tampon +* _from_group_ : recherche depuis ce groupe seulement, si NULL, alors recherche dans toute la liste des pseudos -* _name_ : nom du groupes à rechercher +* _name_ : nom du groupes à rechercher -Valeur de retour : +Valeur de retour : * pointeur vers le groupe trouvé, NULL s'il n'est pas trouvé -Exemple en C : +Exemple en C : [source,C] ---- @@ -12162,7 +12162,7 @@ struct t_gui_nick_group *ptr_group = weechat_nicklist_search_group (my_buffer, NULL, "groupe_test"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12177,7 +12177,7 @@ group = weechat.nicklist_search_group(my_buffer, "", "groupe_test") Ajouter un pseudo dans un groupe. -Prototype : +Prototype : [source,C] ---- @@ -12190,35 +12190,35 @@ struct t_gui_nick_group *weechat_nicklist_add_nick (struct t_gui_buffer *buffer, int visible); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _group_ : pointeur vers le groupe -* _name_ : nom du pseudo -* _color_ : nom de l'option contenant la couleur pour le pseudo : +* _buffer_ : pointeur vers le tampon +* _group_ : pointeur vers le groupe +* _name_ : nom du pseudo +* _color_ : nom de l'option contenant la couleur pour le pseudo : ** une option WeeChat, par exemple _weechat.color.nicklist_group_ ** une couleur avec un fond optionnel, par exemple _yellow_ ou _yellow,red_ -** nom d'une couleur de barre : -*** _bar_fg_ : couleur de texte pour la barre -*** _bar_delim_ : couleur des délimiteurs pour la barre -*** _bar_bg_ : couleur de fond pour la barre -* _prefix_ : préfixe affiché avant le pseudo -* _prefix_color_ : nom de l'option contenant la couleur pour le préfixe : +** nom d'une couleur de barre : +*** _bar_fg_ : couleur de texte pour la barre +*** _bar_delim_ : couleur des délimiteurs pour la barre +*** _bar_bg_ : couleur de fond pour la barre +* _prefix_ : préfixe affiché avant le pseudo +* _prefix_color_ : nom de l'option contenant la couleur pour le préfixe : ** une option WeeChat, par exemple _weechat.color.nicklist_group_ ** une couleur avec un fond optionnel, par exemple _yellow_ ou _yellow,red_ -** nom d'une couleur de barre : -*** _bar_fg_ : couleur de texte pour la barre -*** _bar_delim_ : couleur des délimiteurs pour la barre -*** _bar_bg_ : couleur de fond pour la barre -* _visible_ : -** _1_ : le pseudo est visible -** _0_ : le pseudo est caché +** nom d'une couleur de barre : +*** _bar_fg_ : couleur de texte pour la barre +*** _bar_delim_ : couleur des délimiteurs pour la barre +*** _bar_bg_ : couleur de fond pour la barre +* _visible_ : +** _1_ : le pseudo est visible +** _0_ : le pseudo est caché -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau pseudo, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -12230,7 +12230,7 @@ struct t_gui_nick *my_nick = 1); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12249,7 +12249,7 @@ nick = weechat.nicklist_add_nick(my_buffer, my_group, "test_nick", color, "@", " Rechercher un pseudo dans la liste des pseudos. -Prototype : +Prototype : [source,C] ---- @@ -12258,18 +12258,18 @@ struct t_gui_nick *weechat_nicklist_search_nick (struct t_gui_buffer *buffer, const char *name); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _from_group_ : recherche depuis ce groupe seulement, si NULL, alors recherche +* _buffer_ : pointeur vers le tampon +* _from_group_ : recherche depuis ce groupe seulement, si NULL, alors recherche dans toute la liste des pseudos -* _name_ : nom du pseudo à rechercher +* _name_ : nom du pseudo à rechercher -Valeur de retour : +Valeur de retour : * pointeur vers le pseudo trouvé, NULL s'il n'est pas trouvé -Exemple en C : +Exemple en C : [source,C] ---- @@ -12277,7 +12277,7 @@ struct t_gui_nick *ptr_nick = weechat_nicklist_search_nick (my_buffer, NULL, "test_nick"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12292,7 +12292,7 @@ nick = weechat.nicklist_search_nick(my_buffer, "", "test_nick") Supprimer un groupe de la liste des pseudos. -Prototype : +Prototype : [source,C] ---- @@ -12300,20 +12300,20 @@ void weechat_nicklist_remove_group (struct t_gui_buffer *buffer, struct t_gui_nick_group *group); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _group_ : pointeur vers le groupe à supprimer (tous les sous-groupes/pseudos +* _buffer_ : pointeur vers le tampon +* _group_ : pointeur vers le groupe à supprimer (tous les sous-groupes/pseudos seront supprimés également) -Exemple en C : +Exemple en C : [source,C] ---- weechat_nicklist_remove_group (my_buffer, my_group); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12328,7 +12328,7 @@ weechat.nicklist_remove_group(my_buffer, my_group) Supprimer un pseudo de la liste des pseudos. -Prototype : +Prototype : [source,C] ---- @@ -12336,19 +12336,19 @@ void weechat_nicklist_remove_nick (struct t_gui_buffer *buffer, struct t_gui_nick *nick); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _nick_ : pointeur vers le pseudo à supprimer +* _buffer_ : pointeur vers le tampon +* _nick_ : pointeur vers le pseudo à supprimer -Exemple en C : +Exemple en C : [source,C] ---- weechat_nicklist_remove_nick (my_buffer, my_nick); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12363,25 +12363,25 @@ weechat.nicklist_remove_nick(my_buffer, my_nick) Supprimer tous les groupes/pseudos de la liste des pseudos. -Prototype : +Prototype : [source,C] ---- void weechat_nicklist_remove_all (struct t_gui_buffer *buffer); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon +* _buffer_ : pointeur vers le tampon -Exemple en C : +Exemple en C : [source,C] ---- weechat_nicklist_remove_all (my_buffer); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12399,7 +12399,7 @@ _WeeChat ≥ 0.3.7._ Retourner le prochain groupe ou pseudo de la liste des pseudos (utilisé principalement pour afficher la liste des pseudos). -Prototype : +Prototype : [source,C] ---- @@ -12408,13 +12408,13 @@ void weechat_nicklist_get_next_item (struct t_gui_buffer *buffer, struct t_gui_nick **nick); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _group_ : pointeur vers un pointeur sur le groupe -* _nick_ : pointeur vers un pointeur sur le pseudo +* _buffer_ : pointeur vers le tampon +* _group_ : pointeur vers un pointeur sur le groupe +* _nick_ : pointeur vers un pointeur sur le pseudo -Exemple en C : +Exemple en C : [source,C] ---- @@ -12449,7 +12449,7 @@ _WeeChat ≥ 0.3.4._ Retourner une valeur entière pour une propriété du groupe. -Prototype : +Prototype : [source,C] ---- @@ -12458,26 +12458,26 @@ int weechat_nicklist_group_get_integer (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _group_ : pointeur vers le groupe -* _property_ : nom de la propriété : -** _visible_ : 1 si le groupe est visible, sinon 0 -** _level_ : niveau du groupe (la racine est 0) +* _buffer_ : pointeur vers le tampon +* _group_ : pointeur vers le groupe +* _property_ : nom de la propriété : +** _visible_ : 1 si le groupe est visible, sinon 0 +** _level_ : niveau du groupe (la racine est 0) -Valeur de retour : +Valeur de retour : * valeur entière de la propriété -Exemple en C : +Exemple en C : [source,C] ---- int visible = weechat_nicklist_group_get_integer (buffer, group, "visible"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12494,7 +12494,7 @@ _WeeChat ≥ 0.3.4._ Retourner la valeur d'une propriété du groupe sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- @@ -12503,26 +12503,26 @@ const char *weechat_nicklist_group_get_string (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _group_ : pointeur vers le groupe -* _property_ : nom de la propriété : -** _name_ : nom du groupe -** _color_ : couleur du groupe dans la liste des pseudos +* _buffer_ : pointeur vers le tampon +* _group_ : pointeur vers le groupe +* _property_ : nom de la propriété : +** _name_ : nom du groupe +** _color_ : couleur du groupe dans la liste des pseudos -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de chaîne -Exemple en C : +Exemple en C : [source,C] ---- const char *color = weechat_nicklist_group_get_string (buffer, group, "color"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12539,7 +12539,7 @@ _WeeChat ≥ 0.3.4._ Retourner la valeur d'une propriété du groupe sous forme d'un pointeur. -Prototype : +Prototype : [source,C] ---- @@ -12548,25 +12548,25 @@ void *weechat_nicklist_group_get_pointer (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _group_ : pointeur vers le groupe -* _property_ : nom de la propriété : -** _parent_ : pointeur vers le groupe parent +* _buffer_ : pointeur vers le tampon +* _group_ : pointeur vers le groupe +* _property_ : nom de la propriété : +** _parent_ : pointeur vers le groupe parent -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de pointeur -Exemple en C : +Exemple en C : [source,C] ---- struct t_gui_nick_group *parent = weechat_nicklist_group_get_pointer (buffer, group, "parent"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12583,7 +12583,7 @@ _WeeChat ≥ 0.3.4._ Affecter une valeur à une propriété d'un groupe. -Prototype : +Prototype : [source,C] ---- @@ -12593,14 +12593,14 @@ void weechat_nicklist_group_set (struct t_gui_buffer *buffer, const char *value); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _group_ : pointeur vers le groupe -* _property_ : nom de la propriété (voir le tableau ci-dessous) -* _value_ : nouvelle valeur pour la propriété +* _buffer_ : pointeur vers le tampon +* _group_ : pointeur vers le groupe +* _property_ : nom de la propriété (voir le tableau ci-dessous) +* _value_ : nouvelle valeur pour la propriété -Propriétés : +Propriétés : [width="100%",cols="^2,4,8",options="header"] |=== @@ -12614,7 +12614,7 @@ Propriétés : "0" = groupe caché, "1" = groupe visible. |=== -Exemples en C : +Exemples en C : [source,C] ---- @@ -12628,7 +12628,7 @@ weechat_nicklist_group_set (buffer, group, "color", "yellow"); weechat_nicklist_group_set (buffer, group, "visible", "0"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12653,7 +12653,7 @@ _WeeChat ≥ 0.3.4._ Retourner une valeur entière pour une propriété du pseudo. -Prototype : +Prototype : [source,C] ---- @@ -12662,25 +12662,25 @@ int weechat_nicklist_nick_get_integer (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _nick_ : pointeur vers le pseudo -* _property_ : nom de la propriété : -** _visible_ : 1 si le pseudo est visible, sinon 0 +* _buffer_ : pointeur vers le tampon +* _nick_ : pointeur vers le pseudo +* _property_ : nom de la propriété : +** _visible_ : 1 si le pseudo est visible, sinon 0 -Valeur de retour : +Valeur de retour : * valeur entière de la propriété -Exemple en C : +Exemple en C : [source,C] ---- int visible = weechat_nicklist_nick_get_integer (buffer, nick, "visible"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12697,7 +12697,7 @@ _WeeChat ≥ 0.3.4._ Retourner la valeur d'une propriété du pseudo sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- @@ -12706,28 +12706,28 @@ const char *weechat_nicklist_nick_get_string (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _nick_ : pointeur vers le pseudo -* _property_ : nom de la propriété : -** _name_ : nom du pseudo -** _color_ : couleur du pseudo dans la liste des pseudos -** _prefix_ : préfixe du pseudo -** _prefix_color_ : couleur du préfixe dans la liste des pseudos +* _buffer_ : pointeur vers le tampon +* _nick_ : pointeur vers le pseudo +* _property_ : nom de la propriété : +** _name_ : nom du pseudo +** _color_ : couleur du pseudo dans la liste des pseudos +** _prefix_ : préfixe du pseudo +** _prefix_color_ : couleur du préfixe dans la liste des pseudos -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de chaîne -Exemple en C : +Exemple en C : [source,C] ---- const char *color = weechat_nicklist_nick_get_string (buffer, nick, "color"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12744,7 +12744,7 @@ _WeeChat ≥ 0.3.4._ Retourner la valeur d'une propriété du pseudo sous forme d'un pointeur. -Prototype : +Prototype : [source,C] ---- @@ -12753,25 +12753,25 @@ void *weechat_nicklist_nick_get_pointer (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _nick_ : pointeur vers le pseudo -* _property_ : nom de la propriété : -** _group_ : pointeur vers le groupe contenant ce pseudo +* _buffer_ : pointeur vers le tampon +* _nick_ : pointeur vers le pseudo +* _property_ : nom de la propriété : +** _group_ : pointeur vers le groupe contenant ce pseudo -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de pointeur -Exemple en C : +Exemple en C : [source,C] ---- struct t_gui_nick_group *group = weechat_nicklist_nick_get_pointer (buffer, nick, "group"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12788,7 +12788,7 @@ _WeeChat ≥ 0.3.4._ Affecter une valeur à une propriété d'un pseudo. -Prototype : +Prototype : [source,C] ---- @@ -12798,14 +12798,14 @@ void weechat_nicklist_nick_set (struct t_gui_buffer *buffer, const char *value); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _nick_ : pointeur vers le pseudo -* _property_ : nom de la propriété (voir le tableau ci-dessous) -* _value_ : nouvelle valeur pour la propriété +* _buffer_ : pointeur vers le tampon +* _nick_ : pointeur vers le pseudo +* _property_ : nom de la propriété (voir le tableau ci-dessous) +* _value_ : nouvelle valeur pour la propriété -Propriétés : +Propriétés : [width="100%",cols="^2,4,8",options="header"] |=== @@ -12826,7 +12826,7 @@ Propriétés : "0" = pseudo caché, "1" = pseudo visible. |=== -Exemples en C : +Exemples en C : [source,C] ---- @@ -12843,7 +12843,7 @@ weechat_nicklist_nick_set (buffer, nick, "prefix_color", "yellow"); weechat_nicklist_nick_set (buffer, nick, "visible", "0"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12874,29 +12874,29 @@ Fonctions pour les barres. Rechercher un objet de barre. -Prototype : +Prototype : [source,C] ---- struct t_gui_bar_item *weechat_bar_item_search (const char *name); ---- -Paramètres : +Paramètres : -* _name_ : nom de l'objet de barre +* _name_ : nom de l'objet de barre -Valeur de retour : +Valeur de retour : * pointeur vers l'objet de barre trouvé, NULL s'il n'a pas été trouvé -Exemple en C : +Exemple en C : [source,C] ---- struct t_gui_bar_item *bar_item = weechat_bar_item_search ("myitem"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12913,7 +12913,7 @@ _Mis à jour dans la 0.4.2, 1.5._ Créer un nouvel objet de barre. -Prototype : +Prototype : [source,C] ---- @@ -12928,34 +12928,34 @@ struct t_gui_bar_item *weechat_bar_item_new (const char *name, void *build_callback_data); ---- -Paramètres : +Paramètres : -* _name_ : nom de l'objet de barre -* _build_callback_ : fonction appelée lorsque l'objet est construit, paramètres - et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_gui_bar_item *item_ : pointeur vers l'objet de barre -** _struct t_gui_window *window_ : pointeur vers la fenêtre (NULL lors d'un +* _name_ : nom de l'objet de barre +* _build_callback_ : fonction appelée lorsque l'objet est construit, paramètres + et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_gui_bar_item *item_ : pointeur vers l'objet de barre +** _struct t_gui_window *window_ : pointeur vers la fenêtre (NULL lors d'un appel pour une barre "root") -** _struct t_gui_buffer *buffer_ : tampon affiché dans la fenêtre (si la fenêtre +** _struct t_gui_buffer *buffer_ : tampon affiché dans la fenêtre (si la fenêtre est NULL alors c'est le tampon courant) ou tampon passé dans l'objet de - barre avec la syntaxe : "@buffer:item" _(WeeChat ≥ 0.4.2)_ -** _struct t_hashtable *extra_info_ : toujours NULL (le paramètre est réservé + barre avec la syntaxe : "@buffer:item" _(WeeChat ≥ 0.4.2)_ +** _struct t_hashtable *extra_info_ : toujours NULL (le paramètre est réservé pour une version future) _(WeeChat ≥ 0.4.2)_ -** valeur de retour : contenu de l'objet de barre -* _build_callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé +** valeur de retour : contenu de l'objet de barre +* _build_callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _build_callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _build_callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque l'objet de barre est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouvel objet de barre, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -12974,11 +12974,11 @@ struct t_gui_bar_item *my_item = weechat_bar_item_new ("myitem", NULL, NULL); ---- -Script (Python) : +Script (Python) : [IMPORTANT] Pour la compatibilité avec les versions ≤ 0.4.1, le "callback" par défaut a -seulement 3 paramètres : _data_, _item_ et _window_ (pas de _buffer_ et +seulement 3 paramètres : _data_, _item_ et _window_ (pas de _buffer_ et _extra_info_). + Pour utiliser le callback avec tous les paramètres, vous devez ajouter "(extra)" avant le nom, voir l'exemple ci-dessous (supporté seulement dans @@ -13007,25 +13007,25 @@ bar_item2 = weechat.bar_item_new("(extra)myitem2", "my_build_callback2", "") # Mettre à jour le contenu d'un objet de barre, en appelant son "callback" de construction. -Prototype : +Prototype : [source,C] ---- void weechat_bar_item_update (const char *name); ---- -Paramètres : +Paramètres : -* _name_ : nom de l'objet de barre +* _name_ : nom de l'objet de barre -Exemple en C : +Exemple en C : [source,C] ---- weechat_bar_item_update ("myobjet"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13040,25 +13040,25 @@ weechat.bar_item_update("myitem") Supprimer un objet de barre. -Prototype : +Prototype : [source,C] ---- void weechat_bar_item_remove (struct t_gui_bar_item *item); ---- -Paramètres : +Paramètres : -* _item_ : bar item pointer +* _item_ : bar item pointer -Exemple en C : +Exemple en C : [source,C] ---- weechat_bar_item_remove (&my_item); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13073,29 +13073,29 @@ weechat.bar_item_remove(myitem) Rechercher une barre. -Prototype : +Prototype : [source,C] ---- struct t_gui_bar *weechat_bar_search (const char *name); ---- -Paramètres : +Paramètres : -* _name_ : nom de la barre +* _name_ : nom de la barre -Valeur de retour : +Valeur de retour : * pointeur vers la barre trouvée, NULL si elle n'est pas trouvée -Exemple en C : +Exemple en C : [source,C] ---- struct t_gui_bar *bar = weechat_bar_search ("my_barre"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13110,7 +13110,7 @@ bar = weechat.bar_search("mybar") Créer une nouvelle barre. -Prototype : +Prototype : [source,C] ---- @@ -13131,59 +13131,59 @@ struct t_gui_bar *weechat_bar_new (const char *name, const char *items); ---- -Paramètres : - -* _name_ : nom de la barre -* _hidden_ : -** _on_ : la barre est cachée -** _off_ : la barre est visible -* _priority_ : priorité de la barre (nombre entier) -* _type_ : -** _root_ : la barre est affichée une seule fois, hors des fenêtres -** _window_ : la barre est affichée dans chaque fenêtre -* _condition_ : condition pour afficher la barre : -** _active_ : la barre est affichée dans la fenêtre active seulement -** _inactive_ : la barre est affichée dans les fenêtres inactives seulement -** _nicklist_ : la barre est affichée dans les fenêtres possédant une liste des +Paramètres : + +* _name_ : nom de la barre +* _hidden_ : +** _on_ : la barre est cachée +** _off_ : la barre est visible +* _priority_ : priorité de la barre (nombre entier) +* _type_ : +** _root_ : la barre est affichée une seule fois, hors des fenêtres +** _window_ : la barre est affichée dans chaque fenêtre +* _condition_ : condition pour afficher la barre : +** _active_ : la barre est affichée dans la fenêtre active seulement +** _inactive_ : la barre est affichée dans les fenêtres inactives seulement +** _nicklist_ : la barre est affichée dans les fenêtres possédant une liste des pseudos -** expression évaluée : voir le chapitre sur les barres dans le +** expression évaluée : voir le chapitre sur les barres dans le _Guide utilisateur WeeChat_ -* _position_ : _top_ (en haut), _bottom_ (en bas), _left_ (à gauche) ou _right_ +* _position_ : _top_ (en haut), _bottom_ (en bas), _left_ (à gauche) ou _right_ (à droite) -* _filling_top_bottom_ : -** _horizontal_ : les objets sont remplis horizontalement (avec un espace +* _filling_top_bottom_ : +** _horizontal_ : les objets sont remplis horizontalement (avec un espace entre chaque objet) -** _vertical_ : les objets sont remplis verticalement (avec une nouvelle ligne +** _vertical_ : les objets sont remplis verticalement (avec une nouvelle ligne entre chaque objet) -** _columns_horizontal_ : les objets sont remplis horizontalement, affichés +** _columns_horizontal_ : les objets sont remplis horizontalement, affichés sous forme de colonnes -** _columns_vertical_ : les objets sont remplis verticalement, affichés sous +** _columns_vertical_ : les objets sont remplis verticalement, affichés sous forme de colonnes -* _filling_left_right_ : -** _horizontal_ : les objets sont remplis horizontalement (avec un espace +* _filling_left_right_ : +** _horizontal_ : les objets sont remplis horizontalement (avec un espace entre chaque objet) -** _vertical_ : les objets sont remplis verticalement (avec une nouvelle ligne +** _vertical_ : les objets sont remplis verticalement (avec une nouvelle ligne entre chaque objet) -** _columns_horizontal_ : les objets sont remplis horizontalement, affichés +** _columns_horizontal_ : les objets sont remplis horizontalement, affichés sous forme de colonnes -** _columns_vertical_ : les objets sont remplis verticalement, affichés sous +** _columns_vertical_ : les objets sont remplis verticalement, affichés sous forme de colonnes -* _size_ : taille de la barre en caractères (0 indique une taille automatique) -* _size_max_ : taille maximum de la barre (0 pour pas de maximum) -* _color_fg_ : couleur du texte dans la barre -* _color_delim_ : couleur pour les délimiteurs dans la barre -* _color_bg_ : couleur de fond pour la barre -* _separator_ : -** _on_ : la barre a un séparateur avec les autres fenêtres/barres -** _off_ : pas de séparateur -* _items_ : liste des objets dans la barre, séparés par une virgule (espace +* _size_ : taille de la barre en caractères (0 indique une taille automatique) +* _size_max_ : taille maximum de la barre (0 pour pas de maximum) +* _color_fg_ : couleur du texte dans la barre +* _color_delim_ : couleur pour les délimiteurs dans la barre +* _color_bg_ : couleur de fond pour la barre +* _separator_ : +** _on_ : la barre a un séparateur avec les autres fenêtres/barres +** _off_ : pas de séparateur +* _items_ : liste des objets dans la barre, séparés par une virgule (espace entre les objets), ou "+" (objets collés) -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle barre, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -13204,7 +13204,7 @@ struct t_gui_bar *my_bar = weechat_bar_new ("mybar", "time,buffer_number+buffer_name"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13222,7 +13222,7 @@ bar = weechat.bar_new("mybar", "off", "100", "window", "", "top", "horizontal", Affecter une nouvelle valeur pour une propriété de la barre. -Prototype : +Prototype : [source,C] ---- @@ -13230,26 +13230,26 @@ int weechat_bar_set (struct t_gui_bar *bar, const char *property, const char *value); ---- -Paramètres : +Paramètres : -* _bar_ : pointeur vers la barre -* _property_ : name, hidden, priority, conditions, position, filling_top_bottom, +* _bar_ : pointeur vers la barre +* _property_ : name, hidden, priority, conditions, position, filling_top_bottom, filling_left_right, size, size_max, color_fg, color_delim, color_bg, separator, items (voir <<_bar_new,bar_new>>) -* _value_ : nouvelle valeur pour la propriété +* _value_ : nouvelle valeur pour la propriété -Valeur de retour : +Valeur de retour : * 1 si la valeur a été affectée, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- weechat_bar_set (my_bar, "position", "bottom"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13264,25 +13264,25 @@ weechat.bar_set(my_bar, "position", "bottom") Mettre à jour le contenu d'une barre à l'écran. -Prototype : +Prototype : [source,C] ---- void weechat_bar_update (const char *name); ---- -Paramètres : +Paramètres : -* _name_ : nom de la barre +* _name_ : nom de la barre -Exemple en C : +Exemple en C : [source,C] ---- weechat_bar_update ("mybar"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13297,25 +13297,25 @@ weechat.bar_update("mybar") Supprimer une barre. -Prototype : +Prototype : [source,C] ---- void weechat_bar_remove (struct t_gui_bar *bar); ---- -Paramètres : +Paramètres : -* _bar_ : pointeur vers la barre +* _bar_ : pointeur vers la barre -Exemple en C : +Exemple en C : [source,C] ---- weechat_bar_remove (my_bar); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13337,26 +13337,26 @@ _Mis à jour dans la 1.1._ Exécuter une commande ou envoyer du texte au tampon. -Prototype : +Prototype : [source,C] ---- int weechat_command (struct t_gui_buffer *buffer, const char *command); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon (la commande est exécutée sur ce tampon, +* _buffer_ : pointeur vers le tampon (la commande est exécutée sur ce tampon, NULL pour le tampon courant) -* _command_ : commande à exécuter (si elle commence par "/"), ou texte à +* _command_ : commande à exécuter (si elle commence par "/"), ou texte à envoyer au tampon -Valeur de retour : (_WeeChat ≥ 1.1_) +Valeur de retour : (_WeeChat ≥ 1.1_) * _WEECHAT_RC_OK_ si ok * _WEECHAT_RC_ERROR_ si erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -13365,7 +13365,7 @@ rc = weechat_command (weechat_buffer_search ("irc", "freenode.#weechat"), "/whois FlashCode"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13389,7 +13389,7 @@ Fonctions pour le réseau. Cette fonction est bloquante sur l'appel à connect(), donc elle doit être appelée sans un processus issu d'un "fork", pour ne pas bloquer WeeChat. -Prototype : +Prototype : [source,C] ---- @@ -13399,18 +13399,18 @@ int weechat_network_pass_proxy (const char *proxy, int port); ---- -Paramètres : +Paramètres : -* _proxy_ : nom du proxy à utiliser -* _sock_ : socket à utiliser -* _address_ : adresse (nom de machine ou adresse IP) -* _port_ : port +* _proxy_ : nom du proxy à utiliser +* _sock_ : socket à utiliser +* _address_ : adresse (nom de machine ou adresse IP) +* _port_ : port -Valeur de retour : +Valeur de retour : * 1 si la connexion est ok, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -13437,7 +13437,7 @@ _Mis à jour dans la 0.4.3._ Cette fonction est bloquante sur l'appel à connect(), donc elle doit être appelée sans un processus issu d'un "fork", pour ne pas bloquer WeeChat. -Prototype : +Prototype : [source,C] ---- @@ -13446,17 +13446,17 @@ int weechat_network_connect_to (const char *proxy, socklen_t address_length); ---- -Paramètres : +Paramètres : -* _proxy_ : nom du proxy à utiliser -* _address_ : adresse où se connecter (avec le port) -* _address_length_ : longueur du paramètre _address_ +* _proxy_ : nom du proxy à utiliser +* _address_ : adresse où se connecter (avec le port) +* _address_length_ : longueur du paramètre _address_ -Valeur de retour : +Valeur de retour : * numéro de socket (>= 0) si la connexion est OK, -1 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -13490,39 +13490,39 @@ Fonctions pour obtenir des informations. Retourner une information, sous forme de chaîne, de WeeChat ou d'une extension. -Prototype : +Prototype : [source,C] ---- const char *weechat_info_get (const char *info_name, const char *arguments); ---- -Paramètres : +Paramètres : -* _info_name_ : nom de l'information à lire (voir le tableau ci-dessous) -* _arguments_ : paramètres pour l'information demandée (optionnels, NULL si +* _info_name_ : nom de l'information à lire (voir le tableau ci-dessous) +* _arguments_ : paramètres pour l'information demandée (optionnels, NULL si aucun paramètre n'est nécessaire) -Valeur de retour : +Valeur de retour : * chaîne avec l'information demandée, NULL en cas d'erreur -Infos : +Infos : include::autogen/plugin_api/infos.adoc[] -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "La version de WeeChat est : %s (compilée le %s)", +weechat_printf (NULL, "La version de WeeChat est : %s (compilée le %s)", weechat_info_get ("version", NULL), weechat_info_get ("date", NULL)); -weechat_printf (NULL, "Le répertoire de WeeChat est : %s", +weechat_printf (NULL, "Le répertoire de WeeChat est : %s", weechat_info_get ("weechat_dir", NULL)); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13530,9 +13530,9 @@ Script (Python) : value = weechat.info_get(info_name, arguments) # exemple -weechat.prnt("", "La version de WeeChat est : %s (compilée le %s)" +weechat.prnt("", "La version de WeeChat est : %s (compilée le %s)" % (weechat.info_get("version", ""), weechat.info_get("date", "")) -weechat.prnt("", "Le répertoire de WeeChat est : %s" % weechat.info_get("weechat_dir", "")) +weechat.prnt("", "Le répertoire de WeeChat est : %s" % weechat.info_get("weechat_dir", "")) ---- ==== info_get_hashtable @@ -13542,7 +13542,7 @@ _WeeChat ≥ 0.3.4._ Retourner une information, sous forme de table de hachage, de WeeChat ou d'une extension. -Prototype : +Prototype : [source,C] ---- @@ -13550,21 +13550,21 @@ struct t_hashtable *weechat_info_get_hashtable (const char *info_name, struct t_hashtable *hashtable); ---- -Paramètres : +Paramètres : -* _info_name_ : nom de l'information à lire (voir le tableau ci-dessous) -* _hashtable_ : table de hachage avec les paramètres (dépendant de l'information +* _info_name_ : nom de l'information à lire (voir le tableau ci-dessous) +* _hashtable_ : table de hachage avec les paramètres (dépendant de l'information demandée) (optionnel, NULL si aucun paramètre n'est nécessaire) -Valeur de retour : +Valeur de retour : * table de hachage avec l'information demandée, NULL en cas d'erreur -Infos : +Infos : include::autogen/plugin_api/infos_hashtable.adoc[] -Exemple en C : +Exemple en C : [source,C] ---- @@ -13584,7 +13584,7 @@ if (hashtable_in) hashtable_out = weechat_info_get_hashtable ("irc_message_parse", hashtable_in); /* - * maintenant hashtable_out a les clés/valeurs suivantes : + * maintenant hashtable_out a les clés/valeurs suivantes : * "tags" : "time=2015-06-27T16:40:35.000Z" * "message_without_tags": ":nick!user@host PRIVMSG #weechat :hello!" * "nick" : "nick" @@ -13607,7 +13607,7 @@ if (hashtable_in) Voir le _Guide pour Scripts WeeChat_ pour plus d'infos sur la sortie de "irc_message_parse". -Script (Python) : +Script (Python) : [source,python] ---- @@ -13616,7 +13616,7 @@ dict = weechat.info_get_hashtable(info_name, dict_in) # exemple dict_in = {"message": ":nick!user@host PRIVMSG #weechat :message ici"} -weechat.prnt("", "message analysé : %s" +weechat.prnt("", "message analysé : %s" % weechat.info_get_hashtable("irc_message_parse", dict_in)) ---- @@ -13630,38 +13630,38 @@ Par exemple, l'infolist "irc_server" a N objets (N est le nombre de serveurs IRC définis). Pour chaque objet, il y a des variables, comme "name", "buffer", "is_connected", ... -Chaque variable a un type et une valeur. Les types possibles sont : +Chaque variable a un type et une valeur. Les types possibles sont : -* _integer_ : nombre entier -* _string_ : chaîne de caractères -* _pointer_ : pointeur -* _buffer_ : tampon avec une taille fixe, peut contenir n'importe quel type de +* _integer_ : nombre entier +* _string_ : chaîne de caractères +* _pointer_ : pointeur +* _buffer_ : tampon avec une taille fixe, peut contenir n'importe quel type de données -* _time_ : date/heure +* _time_ : date/heure ==== infolist_new Créer une "infolist". -Prototype : +Prototype : [source,C] ---- struct t_infolist *weechat_infolist_new (); ---- -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle "infolist" -Exemple en C : +Exemple en C : [source,C] ---- struct t_infolist *infolist = weechat_infolist_new (); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13676,29 +13676,29 @@ infolist = weechat.infolist_new() Ajouter un objet dans l'infolist. -Prototype : +Prototype : [source,C] ---- struct t_infolist_item *weechat_infolist_new_item (struct t_infolist *infolist); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist +* _infolist_ : pointeur vers l'infolist -Valeur de retour : +Valeur de retour : * pointeur vers le nouvel objet -Exemple en C : +Exemple en C : [source,C] ---- struct t_infolist_item *item = weechat_infolist_new_item (infolist); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13713,7 +13713,7 @@ item = weechat.infolist_new_item(infolist) Ajouter une variable de type "integer" dans l'objet de l'infolist. -Prototype : +Prototype : [source,C] ---- @@ -13722,17 +13722,17 @@ struct t_infolist_var *weechat_infolist_new_var_integer (struct t_infolist_item int value); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'objet de l'infolist -* _name_ : nom de la variable -* _value_ : valeur +* _item_ : pointeur vers l'objet de l'infolist +* _name_ : nom de la variable +* _value_ : valeur -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle variable -Exemple en C : +Exemple en C : [source,C] ---- @@ -13741,7 +13741,7 @@ struct t_infolist_var *var = weechat_infolist_new_var_integer (item, 123); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13756,7 +13756,7 @@ var = weechat.infolist_new_var_integer(item, "mon_entier", 123) Ajouter une variable de type "string" dans l'objet de l'infolist. -Prototype : +Prototype : [source,C] ---- @@ -13765,17 +13765,17 @@ struct t_infolist_var *weechat_infolist_new_var_string (struct t_infolist_item * const char *value); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'objet de l'infolist -* _name_ : nom de la variable -* _value_ : valeur +* _item_ : pointeur vers l'objet de l'infolist +* _name_ : nom de la variable +* _value_ : valeur -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle variable -Exemple en C : +Exemple en C : [source,C] ---- @@ -13784,7 +13784,7 @@ struct t_infolist_var *var = weechat_infolist_new_var_string (item, "valeur"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13799,7 +13799,7 @@ var = weechat.infolist_new_var_string(item, "ma_chaine", "valeur") Ajouter une variable de type "pointer" dans l'objet de l'infolist. -Prototype : +Prototype : [source,C] ---- @@ -13808,17 +13808,17 @@ struct t_infolist_var *weechat_infolist_new_var_pointer (struct t_infolist_item void *pointer); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'objet de l'infolist -* _name_ : nom de la variable -* _pointer_ : pointeur +* _item_ : pointeur vers l'objet de l'infolist +* _name_ : nom de la variable +* _pointer_ : pointeur -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle variable -Exemple en C : +Exemple en C : [source,C] ---- @@ -13827,7 +13827,7 @@ struct t_infolist_var *var = weechat_infolist_new_var_pointer (item, &pointer); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13842,7 +13842,7 @@ var = weechat.infolist_new_var_pointer(item, "mon_pointeur", pointer) Ajouter une variable de type "buffer" dans l'objet de l'infolist. -Prototype : +Prototype : [source,C] ---- @@ -13852,18 +13852,18 @@ struct t_infolist_var *weechat_infolist_new_var_buffer (struct t_infolist_item * int size); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'objet de l'infolist -* _name_ : nom de la variable -* _pointer_ : pointeur -* _size_ : taille du tampon +* _item_ : pointeur vers l'objet de l'infolist +* _name_ : nom de la variable +* _pointer_ : pointeur +* _size_ : taille du tampon -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle variable -Exemple en C : +Exemple en C : [source,C] ---- @@ -13882,7 +13882,7 @@ Cette fonction n'est pas disponible dans l'API script. Ajouter une variable de type "time" dans l'objet de l'infolist. -Prototype : +Prototype : [source,C] ---- @@ -13891,17 +13891,17 @@ struct t_infolist_var *weechat_infolist_new_var_time (struct t_infolist_item *it time_t time); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'objet de l'infolist -* _name_ : nom de la variable -* _time_ : valeur +* _item_ : pointeur vers l'objet de l'infolist +* _name_ : nom de la variable +* _time_ : valeur -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle variable -Exemple en C : +Exemple en C : [source,C] ---- @@ -13910,7 +13910,7 @@ struct t_infolist_var *var = weechat_infolist_new_var_time (item, time (NULL)); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13934,7 +13934,7 @@ Au lieu d'utiliser une grosse infolist, il est préférable d'utiliser un hdata (mais l'infolist peut contenir plus de données que le hdata, qui contient des données brutes), voir <<hdata,hdata>>. -Prototype : +Prototype : [source,C] ---- @@ -13943,30 +13943,30 @@ struct t_infolist *weechat_infolist_get (const char *infolist_name, const char *arguments); ---- -Paramètres : +Paramètres : -* _infolist_name_ : nom de l'infolist à lire (voir le tableau ci-dessous) -* _pointer_ : pointeur vers un objet, pour n'obtenir que celui-ci dans +* _infolist_name_ : nom de l'infolist à lire (voir le tableau ci-dessous) +* _pointer_ : pointeur vers un objet, pour n'obtenir que celui-ci dans l'infolist (optionnel, peut être NULL) -* _arguments_ : paramètres pour l'infolist demandée (optionnels, NULL si aucun +* _arguments_ : paramètres pour l'infolist demandée (optionnels, NULL si aucun paramètre n'est nécessaire) -Valeur de retour : +Valeur de retour : * pointeur vers l'infolist, NULL en cas d'erreur -Infolists : +Infolists : include::autogen/plugin_api/infolists.adoc[] -Exemple en C : +Exemple en C : [source,C] ---- struct t_infolist *infolist = weechat_infolist_get ("irc_server", NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13983,23 +13983,23 @@ Déplacer le "curseur" vers l'objet suivant dans l'infolist. Le premier appel à cette fonction sur une infolist déplace le curseur sur le premier objet de l'infolist. -Prototype : +Prototype : [source,C] ---- int weechat_infolist_next (struct t_infolist *infolist); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist +* _infolist_ : pointeur vers l'infolist -Valeur de retour : +Valeur de retour : * 1 si le curseur a été déplacé sur l'objet suivant, 0 si la fin de la liste a été atteinte -Exemple en C : +Exemple en C : [source,C] ---- @@ -14013,7 +14013,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14034,23 +14034,23 @@ Déplacer le "curseur" vers l'objet précédent dans l'infolist. Le premier appe cette fonction sur une infolist déplace le curseur sur le dernier objet de l'infolist. -Prototype : +Prototype : [source,C] ---- int weechat_infolist_prev (struct t_infolist *infolist); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist +* _infolist_ : pointeur vers l'infolist -Valeur de retour : +Valeur de retour : * 1 si le curseur a été déplacé sur l'objet précédent, 0 si le début de liste a été atteint -Exemple en C : +Exemple en C : [source,C] ---- @@ -14064,7 +14064,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14083,25 +14083,25 @@ else: Réinitialiser le "curseur" de l'infolist. -Prototype : +Prototype : [source,C] ---- void weechat_infolist_reset_item_cursor (struct t_infolist *infolist); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist +* _infolist_ : pointeur vers l'infolist -Exemple en C : +Exemple en C : [source,C] ---- weechat_infolist_reset_item_cursor (infolist); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14118,7 +14118,7 @@ _WeeChat ≥ 0.4.3._ Chercher une variable dans l'objet courant de l'infolist. -Prototype : +Prototype : [source,C] ---- @@ -14126,16 +14126,16 @@ struct t_infolist_var *weechat_infolist_search_var (struct t_infolist *infolist, const char *name); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist -* _name_ : nom de la variable +* _infolist_ : pointeur vers l'infolist +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * pointeur vers la variable trouvée, NULL si la variable n'est pas trouvée -Exemple en C : +Exemple en C : [source,C] ---- @@ -14146,7 +14146,7 @@ if (weechat_infolist_search_var (infolist, "name")) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14163,34 +14163,34 @@ if weechat.infolist_search_var(infolist, "name"): Retourner la liste des champs pour l'objet courant de l'infolist. -Prototype : +Prototype : [source,C] ---- const char *weechat_infolist_fields (struct t_infolist *infolist); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist +* _infolist_ : pointeur vers l'infolist -Valeur de retour : +Valeur de retour : * chaîne avec la liste des champs pour l'objet courant de l'infolist. La liste, séparée par des virgules, contient la lettre pour le type, suivi du nom de la - variable. Les types sont : "i" (nombre entier), "s" (chaîne), "p" (pointeur), + variable. Les types sont : "i" (nombre entier), "s" (chaîne), "p" (pointeur), "b" (buffer), "t" (date/heure). -Exemple en C : +Exemple en C : [source,C] ---- const char *fields = weechat_infolist_fields (infolist); -/* fields contient quelque chose comme : +/* fields contient quelque chose comme : "i:mon_entier,s:ma_chaine,p:mon_pointeur,b:mon_buffer,t:ma_date" */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14199,7 +14199,7 @@ fields = weechat.infolist_fields(infolist) # exemple fields = weechat.infolist_fields(infolist) -# fields contient quelque chose comme : +# fields contient quelque chose comme : # "i:mon_entier,s:ma_chaine,p:mon_pointeur,b:mon_buffer,t:ma_date" ---- @@ -14208,23 +14208,23 @@ fields = weechat.infolist_fields(infolist) Retourner la valeur de la variable de l'objet courant de l'infolist, sous forme d'entier. -Prototype : +Prototype : [source,C] ---- int weechat_infolist_integer (struct t_infolist *infolist, const char *var); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist -* _var_ : nom de la variable (doit être de type "integer") +* _infolist_ : pointeur vers l'infolist +* _var_ : nom de la variable (doit être de type "integer") -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme d'entier -Exemple en C : +Exemple en C : [source,C] ---- @@ -14232,7 +14232,7 @@ weechat_printf (NULL, "entier = %d", weechat_infolist_integer (infolist, "mon_entier")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14248,23 +14248,23 @@ weechat.prnt("", "entier = %d" % weechat.infolist_integer(infolist, "mon_entier" Retourner la valeur de la variable de l'objet courant de l'infolist, sous forme de chaîne de caractères. -Prototype : +Prototype : [source,C] ---- const char *weechat_infolist_string (struct t_infolist *infolist, const char *var); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist -* _var_ : nom de la variable (doit être de type "string") +* _infolist_ : pointeur vers l'infolist +* _var_ : nom de la variable (doit être de type "string") -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de chaîne -Exemple en C : +Exemple en C : [source,C] ---- @@ -14272,7 +14272,7 @@ weechat_printf (NULL, "chaîne = %s", weechat_infolist_string (infolist, "ma_chaine")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14288,23 +14288,23 @@ weechat.prnt("", "chaîne = %s" % weechat.infolist_string(infolist, "ma_chaine") Retourner la valeur de la variable de l'objet courant de l'infolist, sous forme de pointeur. -Prototype : +Prototype : [source,C] ---- void *weechat_infolist_pointer (struct t_infolist *infolist, const char *var); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist -* _var_ : nom de la variable (doit être de type "pointer") +* _infolist_ : pointeur vers l'infolist +* _var_ : nom de la variable (doit être de type "pointer") -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de pointeur -Exemple en C : +Exemple en C : [source,C] ---- @@ -14312,7 +14312,7 @@ weechat_printf (NULL, "pointeur = 0x%lx", weechat_infolist_pointer (infolist, "mon_pointeur")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14328,7 +14328,7 @@ weechat.prnt("", "pointeur = 0x%s" % weechat.infolist_pointer(infolist, "mon_poi Retourner la valeur de la variable de l'objet courant de l'infolist, sous forme de tampon de données. -Prototype : +Prototype : [source,C] ---- @@ -14336,18 +14336,18 @@ void *weechat_infolist_buffer (struct t_infolist *infolist, const char *var, int *size); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist -* _var_ : nom de la variable (doit être de type "buffer") -* _size_ : pointeur vers une variable entière, qui sera alimenté avec la taille +* _infolist_ : pointeur vers l'infolist +* _var_ : nom de la variable (doit être de type "buffer") +* _size_ : pointeur vers une variable entière, qui sera alimenté avec la taille de la zone -Valeur de retour : +Valeur de retour : * pointeur vers le tampon de données -Exemple en C : +Exemple en C : [source,C] ---- @@ -14365,23 +14365,23 @@ Cette fonction n'est pas disponible dans l'API script. Retourner la valeur de la variable de l'objet courant de l'infolist, sous forme de date/heure. -Prototype : +Prototype : [source,C] ---- time_t weechat_infolist_time (struct t_infolist *infolist, const char *var); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist -* _var_ : nom de la variable (doit être de type "time") +* _infolist_ : pointeur vers l'infolist +* _var_ : nom de la variable (doit être de type "time") -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de date/heure -Exemple en C : +Exemple en C : [source,C] ---- @@ -14389,7 +14389,7 @@ weechat_printf (NULL, "date/heure = %ld", weechat_infolist_time (infolist, "mon_time")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14404,25 +14404,25 @@ weechat.prnt("", "date/heure = %ld" % weechat.infolist_time(infolist, "mon_time" Supprimer une infolist. -Prototype : +Prototype : [source,C] ---- void weechat_infolist_free (struct t_infolist *infolist); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist +* _infolist_ : pointeur vers l'infolist -Exemple en C : +Exemple en C : [source,C] ---- weechat_infolist_free (infolist); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14455,16 +14455,16 @@ Créer un "hdata". .hdata vs infolist ==== Le "hdata" est un moyen rapide de lire des données de WeeChat ou des extensions. -Il est similaire à l'infolist, mais il y a quelques différences : +Il est similaire à l'infolist, mais il y a quelques différences : -* Il est plus rapide et utilise moins de mémoire : accès direct aux données sans +* Il est plus rapide et utilise moins de mémoire : accès direct aux données sans duplication. -* Il peut contenir des informations différentes de l'infolist : il contient +* Il peut contenir des informations différentes de l'infolist : il contient seulement les données brutes des structures (l'infolist peut ajouter des données supplémentaires pour plus de commodité). ==== -Prototype : +Prototype : [source,C] ---- @@ -14477,35 +14477,35 @@ struct t_hdata *weechat_hdata_new (const char *hdata_name, const char *var_prev, void *callback_update_data); ---- -Paramètres : +Paramètres : -* _hdata_name_ : nom du hdata -* _var_prev_ : nom de la variable dans la structure qui est un pointeur vers +* _hdata_name_ : nom du hdata +* _var_prev_ : nom de la variable dans la structure qui est un pointeur vers l'élément précédent dans la liste (peut être NULL si une telle variable n'existe pas) -* _var_next_ : nom de la variable dans la structure qui est un pointeur vers +* _var_next_ : nom de la variable dans la structure qui est un pointeur vers l'élément suivant dans la liste (peut être NULL si une telle variable n'existe pas) -* _create_allowed_ : 1 si la création de structure est autorisée, sinon 0 +* _create_allowed_ : 1 si la création de structure est autorisée, sinon 0 _(WeeChat ≥ 0.4.0)_ -* _delete_allowed_ : 1 si la suppression de structure est autorisée, sinon 0 +* _delete_allowed_ : 1 si la suppression de structure est autorisée, sinon 0 _(WeeChat ≥ 0.3.9)_ -* _callback_update_ : fonction appelée pour mettre à jour des données dans le +* _callback_update_ : fonction appelée pour mettre à jour des données dans le hdata, peut être NULL si aucune mise à jour n'est autorisée - _(WeeChat ≥ 0.3.9)_, paramètres et valeur de retour : -** _void *data_ : pointeur -** _struct t_hdata *hdata_ : pointeur vers le hdata -** _struct t_hashtable *hashtable_ : table de hachage avec les variables à + _(WeeChat ≥ 0.3.9)_, paramètres et valeur de retour : +** _void *data_ : pointeur +** _struct t_hdata *hdata_ : pointeur vers le hdata +** _struct t_hashtable *hashtable_ : table de hachage avec les variables à mettre à jour (voir <<_hdata_update,hdata_update>>) -** valeur de retour : nombre de variables mises à jour -* _callback_update_data_ : pointeur donné au "callback" lorsqu'il est appelé par +** valeur de retour : nombre de variables mises à jour +* _callback_update_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat _(WeeChat ≥ 0.3.9)_ -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hdata" -Exemple en C : +Exemple en C : [source,C] ---- @@ -14521,7 +14521,7 @@ _WeeChat ≥ 0.3.6._ Créer une nouvelle variable dans le hdata. -Prototype : +Prototype : [source,C] ---- @@ -14529,12 +14529,12 @@ void weechat_hdata_new_var (struct t_hdata *hdata, const char *name, int offset, int update_allowed, const char *array_size, const char *hdata_name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _name_ : nom de la variable -* _offset_ : position (offset) de la variable dans la structure -* _type_ : type de la variable, un parmi ceux-ci : +* _hdata_ : pointeur vers le hdata +* _name_ : nom de la variable +* _offset_ : position (offset) de la variable dans la structure +* _type_ : type de la variable, un parmi ceux-ci : ** WEECHAT_HDATA_CHAR ** WEECHAT_HDATA_INTEGER ** WEECHAT_HDATA_LONG @@ -14544,20 +14544,20 @@ Paramètres : ** WEECHAT_HDATA_TIME ** WEECHAT_HDATA_HASHTABLE ** WEECHAT_HDATA_OTHER -* _update_allowed_ : 1 si la mise à jour de la variable est autorisée, sinon 0 +* _update_allowed_ : 1 si la mise à jour de la variable est autorisée, sinon 0 _(WeeChat ≥ 0.3.9)_ -* _array_size_ : non NULL seulement si la variable est un tableau, et peut - être : _(WeeChat ≥ 0.3.9)_ -** nom d'une variable du hdata : cette variable sera utilisée comme taille de +* _array_size_ : non NULL seulement si la variable est un tableau, et peut + être : _(WeeChat ≥ 0.3.9)_ +** nom d'une variable du hdata : cette variable sera utilisée comme taille de tableau (taille dynamique pour le tableau) -** entier (sous forme de chaîne) : taille fixe pour le tableau -** _*_ : taille automatique : la taille est calculée en examinant les valeurs, +** entier (sous forme de chaîne) : taille fixe pour le tableau +** _*_ : taille automatique : la taille est calculée en examinant les valeurs, lorsque le premier NULL est trouvé (seulement pour le type string, pointer ou hashtable) -* _hdata_name_ : nom d'un hdata (si c'est un pointeur vers une structure qui a +* _hdata_name_ : nom d'un hdata (si c'est un pointeur vers une structure qui a un hdata) -Exemple en C : +Exemple en C : [source,C] ---- @@ -14584,7 +14584,7 @@ weechat_hdata_new_var (hdata, "prev", offsetof (struct t_myplugin_list, prev), W weechat_hdata_new_var (hdata, "next", offsetof (struct t_myplugin_list, next), WEECHAT_HDATA_POINTER, 0, NULL, "myplugin_list"); ---- -La macro "WEECHAT_HDATA_VAR" peut être utilisée pour raccourcir le code : +La macro "WEECHAT_HDATA_VAR" peut être utilisée pour raccourcir le code : [source,C] ---- @@ -14606,23 +14606,23 @@ _WeeChat ≥ 0.3.6, mis à jour dans la 1.0._ Créer un nouveau pointer vers une liste dans le hdata. -Prototype : +Prototype : [source,C] ---- void weechat_hdata_new_list (struct t_hdata *hdata, const char *name, void *pointer, int flags); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _name_ : nom de la variable -* _pointer_ : pointeur vers la liste -* _flags_ : combinaison des valeurs suivantes : _(WeeChat ≥ 1.0)_ -** _WEECHAT_HDATA_LIST_CHECK_POINTERS_ : liste utilisée pour vérifier les +* _hdata_ : pointeur vers le hdata +* _name_ : nom de la variable +* _pointer_ : pointeur vers la liste +* _flags_ : combinaison des valeurs suivantes : _(WeeChat ≥ 1.0)_ +** _WEECHAT_HDATA_LIST_CHECK_POINTERS_ : liste utilisée pour vérifier les pointeurs -Exemple en C : +Exemple en C : [source,C] ---- @@ -14652,7 +14652,7 @@ weechat_hdata_new_list (hdata, "buffers", &buffers, WEECHAT_HDATA_LIST_CHECK_POI weechat_hdata_new_list (hdata, "last_buffer", &last_buffer, 0); ---- -La macro "WEECHAT_HDATA_LIST" peut être utilisée pour raccourcir le code : +La macro "WEECHAT_HDATA_LIST" peut être utilisée pour raccourcir le code : [source,C] ---- @@ -14675,33 +14675,33 @@ avec la position (offset) des variables dans la structure. Cela signifie que vous aurez besoin de ce hdata et d'un pointeur vers un objet WeeChat ou d'une extension pour lire des données. -Prototype : +Prototype : [source,C] ---- struct t_hdata *weechat_hdata_get (const char *hdata_name); ---- -Paramètres : +Paramètres : -* _hdata_name_ : nom du hdata (voir la liste ci-dessous) +* _hdata_name_ : nom du hdata (voir la liste ci-dessous) -Valeur de retour : +Valeur de retour : * pointeur vers le hdata, NULL en cas d'erreur -Liste des hdata : +Liste des hdata : include::autogen/plugin_api/hdata.adoc[] -Exemple en C : +Exemple en C : [source,C] ---- struct t_hdata *hdata = weechat_hdata_get ("irc_server"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14718,30 +14718,30 @@ _WeeChat ≥ 0.3.6._ Retourner la position (offset) de la variable dans le hdata. -Prototype : +Prototype : [source,C] ---- int weechat_hdata_get_var_offset (struct t_hdata *hdata, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _name_ : nom de la variable +* _hdata_ : pointeur vers le hdata +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * position (offset) de la variable, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- int offset = weechat_hdata_get_var_offset (hdata, "name"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14758,23 +14758,23 @@ _WeeChat ≥ 0.3.6._ Retourner le type de la variable dans le hdata (sous forme d'entier). -Prototype : +Prototype : [source,C] ---- int weechat_hdata_get_var_type (struct t_hdata *hdata, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _name_ : nom de la variable +* _hdata_ : pointeur vers le hdata +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * type de la variable, -1 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -14823,30 +14823,30 @@ _WeeChat ≥ 0.3.6._ Retourner le type de la variable dans le hdata (sous forme de chaîne). -Prototype : +Prototype : [source,C] ---- const char *weechat_hdata_get_var_type_string (struct t_hdata *hdata, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _name_ : nom de la variable +* _hdata_ : pointeur vers le hdata +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * type de la variable, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (NULL, "type = %s", weechat_hdata_get_var_type_string (hdata, "name")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14863,32 +14863,32 @@ _WeeChat ≥ 0.3.9._ Retourner la taille du tableau pour la variable dans le hdata. -Prototype : +Prototype : [source,C] ---- int weechat_hdata_get_var_array_size (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * taille du tableau pour la variable, -1 si la variable n'est pas un tableau ou en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- int array_size = weechat_hdata_get_var_array_size (hdata, pointer, "name"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14906,7 +14906,7 @@ _WeeChat ≥ 0.3.9._ Retourner la taille du tableau pour la variable dans le hdata (sous forme de chaîne). -Prototype : +Prototype : [source,C] ---- @@ -14914,25 +14914,25 @@ const char *weechat_hdata_get_var_count_array_size (struct t_hdata *hdata, void const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * taille du tableau pour la variable sous forme de chaîne, -1 si la variable n'est pas un tableau ou en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- const char *array_size = weechat_hdata_get_var_array_size_string (hdata, pointer, "name"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14949,30 +14949,30 @@ _WeeChat ≥ 0.3.6._ Retourner le hdata pour la variable dans le hdata. -Prototype : +Prototype : [source,C] ---- const char *weechat_hdata_get_var_hdata (struct t_hdata *hdata, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _name_ : nom de la variable +* _hdata_ : pointeur vers le hdata +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * hdata pour la variable, NULL si pas de hdata ou en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (NULL, "hdata = %s", weechat_hdata_get_var_hdata (hdata, "name")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14989,24 +14989,24 @@ _WeeChat ≥ 0.3.6._ Retourner un pointeur vers le contenu de la variable dans le hdata. -Prototype : +Prototype : [source,C] ---- void *weechat_hdata_get_var (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * pointeur vers le contenu de la variable, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -15025,24 +15025,24 @@ _WeeChat ≥ 0.3.6._ Retourner un pointeur vers le contenu de la variable dans le hdata, en utilisant une position (offset). -Prototype : +Prototype : [source,C] ---- void *weechat_hdata_get_var_at_offset (struct t_hdata *hdata, void *pointer, int offset); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _offset_ : position (offset) de la variable +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _offset_ : position (offset) de la variable -Valeur de retour : +Valeur de retour : * pointeur vers le contenu de la variable, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -15061,23 +15061,23 @@ _WeeChat ≥ 0.3.6._ Retourner un pointeur de liste du hdata. -Prototype : +Prototype : [source,C] ---- void *weechat_hdata_get_list (struct t_hdata *hdata, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _name_ : nom de la liste +* _hdata_ : pointeur vers le hdata +* _name_ : nom de la liste -Valeur de retour : +Valeur de retour : * pointeur vers la liste, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -15085,7 +15085,7 @@ struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffers = weechat_hdata_get_list (hdata, "gui_buffers"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15103,28 +15103,28 @@ _WeeChat ≥ 0.3.7, mis à jour dans la 1.0._ Vérifier si un pointeur est valide pour un hdata et un pointeur de liste. -Prototype : +Prototype : [source,C] ---- int weechat_hdata_check_pointer (struct t_hdata *hdata, void *list, void *pointer); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _list_ : pointeur vers une liste; si NULL _(WeeChat ≥ 1.0)_, le pointeur est +* _hdata_ : pointeur vers le hdata +* _list_ : pointeur vers une liste; si NULL _(WeeChat ≥ 1.0)_, le pointeur est vérifié avec les listes dans le hdata qui ont le drapeau "vérifier les pointeurs" (voir <<_hdata_new_list,hdata_new_list>>), et s'il n'y a pas de telle liste, le pointeur est considéré comme valide -* _pointer_ : pointeur à vérifier +* _pointer_ : pointeur à vérifier -Valeur de retour : +Valeur de retour : * 1 si le pointeur est dans la liste, 0 si non trouvé -Exemple en C : +Exemple en C : [source,C] ---- @@ -15142,7 +15142,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15165,25 +15165,25 @@ _WeeChat ≥ 0.3.6._ Déplacer le pointeur vers un autre élément dans la liste. -Prototype : +Prototype : [source,C] ---- void *weechat_hdata_move (struct t_hdata *hdata, void *pointer, int count); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _count_ : nombre de saut(s) à exécuter (entier négatif ou positif, différent +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _count_ : nombre de saut(s) à exécuter (entier négatif ou positif, différent de 0) -Valeur de retour : +Valeur de retour : * pointeur vers l'élément atteint, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -15198,7 +15198,7 @@ if (buffer) buffer = weechat_hdata_move (hdata, buffer, -1); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15221,32 +15221,32 @@ if buffer: _WeeChat ≥ 0.4.1._ -Chercher un élément dans la liste : l'expression _search_ est évaluée pour +Chercher un élément dans la liste : l'expression _search_ est évaluée pour chaque élément dans la liste, jusqu'à trouver l'élément (ou la fin de la liste). -Prototype : +Prototype : [source,C] ---- void *weechat_hdata_search (struct t_hdata *hdata, void *pointer, const char *search, int move); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _search_ : expression à évaluer, le pointeur par défaut dans l'expression est +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _search_ : expression à évaluer, le pointeur par défaut dans l'expression est le nom du hdata (et ce pointeur change pour chaque élément dans la liste); pour l'aide sur l'expression, voir la commande `/eval` dans le _Guide utilisateur WeeChat_ -* _move_ : nombre de saut(s) à exécuter après une recherche infructueuse (entier +* _move_ : nombre de saut(s) à exécuter après une recherche infructueuse (entier négatif ou positif, différent de 0) -Valeur de retour : +Valeur de retour : * pointeur vers l'élément trouvé, ou NULL si non trouvé -Exemple en C : +Exemple en C : [source,C] ---- @@ -15261,7 +15261,7 @@ if (server) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15285,33 +15285,33 @@ _WeeChat ≥ 0.3.7._ Retourner la valeur de la variable dans la structure en utilisant le hdata, sous forme de caractère. -Prototype : +Prototype : [source,C] ---- char weechat_hdata_char (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (doit être de type "char"); pour les tableaux, +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (doit être de type "char"); pour les tableaux, le nom peut être "N|name" où N est un index dans le tableau (démarrant à 0), - par exemple : "2|name" + par exemple : "2|name" -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de caractère -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (NULL, "letter = %c", weechat_hdata_char (hdata, pointer, "letter")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15329,26 +15329,26 @@ _WeeChat ≥ 0.3.6._ Retourner la valeur de la variable dans la structure en utilisant le hdata, sous forme d'entier. -Prototype : +Prototype : [source,C] ---- int weechat_hdata_integer (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (doit être de type "integer"); pour les tableaux, +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (doit être de type "integer"); pour les tableaux, le nom peut être "N|name" où N est un index dans le tableau (démarrant à 0), - par exemple : "2|name" + par exemple : "2|name" -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme d'entier -Exemple en C : +Exemple en C : [source,C] ---- @@ -15357,7 +15357,7 @@ struct t_gui_buffer *buffer = weechat_buffer_search_main (); weechat_printf (NULL, "number = %d", weechat_hdata_integer (hdata, buffer, "number")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15377,33 +15377,33 @@ _WeeChat ≥ 0.3.6._ Retourner la valeur de la variable dans la structure en utilisant le hdata, sous forme d'entier long. -Prototype : +Prototype : [source,C] ---- long weechat_hdata_long (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (doit être de type "long"); pour les tableaux, +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (doit être de type "long"); pour les tableaux, le nom peut être "N|name" où N est un index dans le tableau (démarrant à 0), - par exemple : "2|name" + par exemple : "2|name" -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme d'entier long -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (NULL, "longvar = %ld", weechat_hdata_long (hdata, pointer, "longvar")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15421,26 +15421,26 @@ _WeeChat ≥ 0.3.6._ Retourner la valeur de la variable dans la structure en utilisant le hdata, sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- const char *weechat_hdata_string (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (doit être de type "string"); pour les tableaux, +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (doit être de type "string"); pour les tableaux, le nom peut être "N|name" où N est un index dans le tableau (démarrant à 0), - par exemple : "2|name" + par exemple : "2|name" -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de chaîne -Exemple en C : +Exemple en C : [source,C] ---- @@ -15449,7 +15449,7 @@ struct t_gui_buffer *buffer = weechat_buffer_search_main (); weechat_printf (NULL, "name = %s", weechat_hdata_string (hdata, buffer, "name")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15469,26 +15469,26 @@ _WeeChat ≥ 0.3.6._ Retourner la valeur de la variable dans la structure en utilisant le hdata, sous forme de pointeur. -Prototype : +Prototype : [source,C] ---- void *weechat_hdata_pointer (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (doit être de type "pointeur"); pour les tableaux, +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (doit être de type "pointeur"); pour les tableaux, le nom peut être "N|name" où N est un index dans le tableau (démarrant à 0), - par exemple : "2|name" + par exemple : "2|name" -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de pointeur -Exemple en C : +Exemple en C : [source,C] ---- @@ -15497,7 +15497,7 @@ struct t_gui_buffer *buffer = weechat_buffer_search_main (); weechat_printf (NULL, "lines = %lx", weechat_hdata_pointer (hdata, buffer, "lines")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15517,26 +15517,26 @@ _WeeChat ≥ 0.3.6._ Retourner la valeur de la variable dans la structure en utilisant le hdata, sous forme de date/heure. -Prototype : +Prototype : [source,C] ---- time_t weechat_hdata_time (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (doit être de type "time"); pour les tableaux, +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (doit être de type "time"); pour les tableaux, le nom peut être "N|name" où N est un index dans le tableau (démarrant à 0), - par exemple : "2|name" + par exemple : "2|name" -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de date/heure -Exemple en C : +Exemple en C : [source,C] ---- @@ -15561,7 +15561,7 @@ if (ptr) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15587,26 +15587,26 @@ _WeeChat ≥ 0.3.7._ Retourner la valeur de la variable dans la structure en utilisant le hdata, sous forme de table de hachage. -Prototype : +Prototype : [source,C] ---- struct t_hashtable *weechat_hdata_hashtable (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (doit être de type "hashtable"); pour les +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (doit être de type "hashtable"); pour les tableaux, le nom peut être "N|name" où N est un index dans le tableau - (démarrant à 0), par exemple : "2|name" + (démarrant à 0), par exemple : "2|name" -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de pointeur vers la table de hachage -Exemple en C : +Exemple en C : [source,C] ---- @@ -15617,7 +15617,7 @@ weechat_printf (NULL, "%d variables locales dans le tampon principal", weechat_hashtable_get_integer (hashtable, "items_count")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15628,7 +15628,7 @@ hashtable = weechat.hdata_hashtable(hdata, pointer, name) hdata = weechat.hdata_get("buffer") buffer = weechat.buffer_search_main() hash = weechat.hdata_hashtable(hdata, buffer, "local_variables") -weechat.prnt("", "variables locales dans le tampon principal :") +weechat.prnt("", "variables locales dans le tampon principal :") for key in hash: weechat.prnt("", " %s == %s" % (key, hash[key])) ---- @@ -15644,26 +15644,26 @@ Cette fonction ne peut être appelée que dans un "callback" de mise à jour (voir <<_hdata_new,hdata_new>> et <<_hdata_update,hdata_update>>), si la variable peut être mise à jour. -Prototype : +Prototype : [source,C] ---- int weechat_hdata_set (struct t_hdata *hdata, void *pointer, const char *name, const char *value); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (types autorisés : char, integer, long, string, +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (types autorisés : char, integer, long, string, pointer, time) -* _value_ : nouvelle valeur pour la variable +* _value_ : nouvelle valeur pour la variable -Valeur de retour : +Valeur de retour : * 1 si ok, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -15679,36 +15679,36 @@ _WeeChat ≥ 0.3.9._ Mettre à jour des données dans le hdata. -Prototype : +Prototype : [source,C] ---- int weechat_hdata_update (struct t_hdata *hdata, void *pointer, struct t_hashtable *hashtable); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _hashtable_ : variables à mettre à jour : les clés sont les noms des +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _hashtable_ : variables à mettre à jour : les clés sont les noms des variables, les valeurs sont les nouvelles valeurs pour les variables (clés et valeurs sont des chaînes de caractères), quelques clés spéciales sont - acceptées : -** clé `__create_allowed` (avec n'importe quelle valeur) : retourne 1 si la + acceptées : +** clé `__create_allowed` (avec n'importe quelle valeur) : retourne 1 si la création est autorisée pour la structure, sinon 0 _(WeeChat ≥ 0.4.0)_ -** clé `__delete_allowed` (avec n'importe quelle valeur) : retourne 1 si la +** clé `__delete_allowed` (avec n'importe quelle valeur) : retourne 1 si la suppression est autorisée pour la structure, sinon 0 -** clé `__update_allowed`, la valeur est le nom d'une variable : retourne 1 si +** clé `__update_allowed`, la valeur est le nom d'une variable : retourne 1 si la mise à jour est autorisée pour la variable, sinon 0 -** clé `__delete` (avec n'importe quelle valeur) : supprime la structure +** clé `__delete` (avec n'importe quelle valeur) : supprime la structure (si autorisé) -Valeur de retour : +Valeur de retour : * nombre de variables mises à jour -Exemple en C : +Exemple en C : [source,C] ---- @@ -15716,7 +15716,7 @@ Exemple en C : struct t_gui_lines *own_lines; struct t_gui_line *line; -struct t_gui_line_data *line_data; +struct t_gui_line_data *line_data; struct t_hdata *hdata; struct t_hashtable *hashtable; char str_date[64]; @@ -15745,14 +15745,14 @@ if (own_lines) } ---- -Script (Python) : +Script (Python) : [source,python] ---- # prototype count = weechat.hdata_update(hdata, pointer, hashtable) -# exemple : soustrait une heure sur le dernier message affiché dans le tampon courant +# exemple : soustrait une heure sur le dernier message affiché dans le tampon courant own_lines = weechat.hdata_pointer(weechat.hdata_get("buffer"), weechat.current_buffer(), "own_lines") if own_lines: line = weechat.hdata_pointer(weechat.hdata_get("lines"), own_lines, "last_line") @@ -15768,47 +15768,47 @@ _WeeChat ≥ 0.3.6._ Retourner une valeur pour une propriété d'un hdata sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- const char *weechat_hdata_get_string (struct t_hdata *hdata, const char *property); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _property_ : nom de la propriété : -** _var_keys_ : chaîne avec la liste des clés pour les variables du hdata - (format : "key1,key2,key3") -** _var_values_ : chaîne avec la liste des valeurs pour les variables du hdata - (format : "value1,value2,value3") -** _var_keys_values_ : chaîne avec la liste des clés et valeurs pour les - variables du hdata (format : "key1:value1,key2:value2,key3:value3") -** _var_prev_ : nom de la variable dans la structure qui est un pointeur vers +* _hdata_ : pointeur vers le hdata +* _property_ : nom de la propriété : +** _var_keys_ : chaîne avec la liste des clés pour les variables du hdata + (format : "key1,key2,key3") +** _var_values_ : chaîne avec la liste des valeurs pour les variables du hdata + (format : "value1,value2,value3") +** _var_keys_values_ : chaîne avec la liste des clés et valeurs pour les + variables du hdata (format : "key1:value1,key2:value2,key3:value3") +** _var_prev_ : nom de la variable dans la structure qui est un pointeur vers l'élément précédent dans la liste -** _var_next_ : nom de la variable dans la structure qui est un pointeur vers +** _var_next_ : nom de la variable dans la structure qui est un pointeur vers l'élément suivant dans la liste -** _list_keys_ : chaîne avec la liste des clés pour les listes du hdata - (format : "key1,key2,key3") -** _list_values_ : chaîne avec la liste des valeurs pour les listes du hdata - (format : "value1,value2,value3") -** _list_keys_values_ : chaîne avec la liste des clés et valeurs pour les listes - du hdata (format : "key1:value1,key2:value2,key3:value3") +** _list_keys_ : chaîne avec la liste des clés pour les listes du hdata + (format : "key1,key2,key3") +** _list_values_ : chaîne avec la liste des valeurs pour les listes du hdata + (format : "value1,value2,value3") +** _list_keys_values_ : chaîne avec la liste des clés et valeurs pour les listes + du hdata (format : "key1:value1,key2:value2,key3:value3") -Valeur de retour : +Valeur de retour : * valeur de la propriété sous forme de chaîne -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "variables dans le hdata : %s", weechat_hdata_get_string (hdata, "var_keys")); -weechat_printf (NULL, "listes dans le hdata : %s", weechat_hdata_get_string (hdata, "list_keys")); +weechat_printf (NULL, "variables dans le hdata : %s", weechat_hdata_get_string (hdata, "var_keys")); +weechat_printf (NULL, "listes dans le hdata : %s", weechat_hdata_get_string (hdata, "list_keys")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15816,8 +15816,8 @@ Script (Python) : value = weechat.hdata_get_string(hdata, property) # exemple -weechat.prnt("", "variables dans le hdata : %s" % weechat.hdata_get_string(hdata, "var_keys")) -weechat.prnt("", "listes dans le hdata : %s" % weechat.hdata_get_string(hdata, "list_keys")) +weechat.prnt("", "variables dans le hdata : %s" % weechat.hdata_get_string(hdata, "var_keys")) +weechat.prnt("", "listes dans le hdata : %s" % weechat.hdata_get_string(hdata, "list_keys")) ---- [[upgrade]] @@ -15831,7 +15831,7 @@ _Mis à jour dans la 1.5._ Créer ou lire un fichier pour la mise à jour. -Prototype : +Prototype : [source,C] ---- @@ -15845,34 +15845,34 @@ struct t_upgrade_file *upgrade_file_new (const char *filename, void *callback_read_data); ---- -Paramètres : +Paramètres : -* _filename_ : nom du fichier (l'extension ".upgrade" est ajoutée +* _filename_ : nom du fichier (l'extension ".upgrade" est ajoutée automatiquement par WeeChat) -* _callback_read_ : fonction appelée pour chaque objet lu dans le fichier de +* _callback_read_ : fonction appelée pour chaque objet lu dans le fichier de mise à jour (si NULL, le fichier pour la mise à jour est ouvert en - écriture), paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_upgrade_file *upgrade_file_ : pointeur vers le fichier de mise à + écriture), paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_upgrade_file *upgrade_file_ : pointeur vers le fichier de mise à jour -** _int object_id_ : identifiant de l'objet -** _struct t_infolist *infolist_ : infolist avec le contenu de l'objet -** valeur de retour : +** _int object_id_ : identifiant de l'objet +** _struct t_infolist *infolist_ : infolist avec le contenu de l'objet +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_read_pointer_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_read_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_read_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_read_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le fichier de mise à jour est fermé -Valeur de retour : +Valeur de retour : * pointeur vers le fichier de mise à jour -Exemple en C : +Exemple en C : [source,C] ---- @@ -15880,7 +15880,7 @@ struct t_upgrade_file *upgrade_file = weechat_upgrade_new ("mon_fichier", NULL, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15895,7 +15895,7 @@ upgrade_file = weechat.upgrade_new("mon_fichier", "", "") Écrire un objet dans le fichier de mise à jour. -Prototype : +Prototype : [source,C] ---- @@ -15904,17 +15904,17 @@ int weechat_upgrade_write_object (struct t_upgrade_file *upgrade_file, struct t_infolist *infolist); ---- -Paramètres : +Paramètres : -* _upgrade_file_ : pointeur vers le fichier de mise à jour -* _object_id_ : identifiant de l'objet -* _infolist_ : infolist à écrire dans le fichier +* _upgrade_file_ : pointeur vers le fichier de mise à jour +* _object_id_ : identifiant de l'objet +* _infolist_ : infolist à écrire dans le fichier -Valeur de retour : +Valeur de retour : * 1 si ok, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -15928,7 +15928,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15945,29 +15945,29 @@ _Mis à jour dans la 1.5._ Lire un fichier de mise à jour. -Prototype : +Prototype : [source,C] ---- int weechat_upgrade_read (struct t_upgrade_file *upgrade_file); ---- -Paramètres : +Paramètres : -* _upgrade_file_ : pointeur vers le fichier de mise à jour +* _upgrade_file_ : pointeur vers le fichier de mise à jour -Valeur de retour : +Valeur de retour : * 1 si ok, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- weechat_upgrade_read (upgrade_file); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15982,25 +15982,25 @@ weechat.upgrade_read(upgrade_file) Fermer un fichier de mise à jour. -Prototype : +Prototype : [source,C] ---- void weechat_upgrade_close (struct t_upgrade_file *upgrade_file); ---- -Paramètres : +Paramètres : -* _upgrade_file_ : pointeur vers le fichier de mise à jour +* _upgrade_file_ : pointeur vers le fichier de mise à jour -Exemple en C : +Exemple en C : [source,C] ---- weechat_upgrade_close (upgrade_file); ---- -Script (Python) : +Script (Python) : [source,python] ---- diff --git a/doc/fr/weechat_quickstart.fr.adoc b/doc/fr/weechat_quickstart.fr.adoc index e6c73c221..b7fb911e6 100644 --- a/doc/fr/weechat_quickstart.fr.adoc +++ b/doc/fr/weechat_quickstart.fr.adoc @@ -12,10 +12,10 @@ == Démarrer WeeChat Un émulateur de terminal recommandé pour X (mais pas obligatoire) est -rxvt-unicode : il a un bon support UTF-8, et aucun problème avec les +rxvt-unicode : il a un bon support UTF-8, et aucun problème avec les touches par défaut. -Lancer depuis votre shell : +Lancer depuis votre shell : ---- $ weechat @@ -24,19 +24,19 @@ $ weechat [[help_options]] == Aide en ligne / options -WeeChat dispose d'aide pour toutes les commandes, tapez simplement : +WeeChat dispose d'aide pour toutes les commandes, tapez simplement : ---- /help ---- -Pour avoir de l'aide sur une commande, tapez : +Pour avoir de l'aide sur une commande, tapez : ---- /help commande ---- -Pour modifier des options, tapez : +Pour modifier des options, tapez : ---- /set config.section.option valeur @@ -52,28 +52,28 @@ besoin de redémarrer WeeChat après avoir changé la configuration). Vous pouvez utiliser `/set` avec un nom partiel d'option et le caractère joker "*" au début ou à la fin pour afficher toutes les options contenant ces lettres. -Par exemple : +Par exemple : -* Afficher toutes les options (WeeChat et extensions) : +* Afficher toutes les options (WeeChat et extensions) : ---- /set ---- -* Afficher les options WeeChat : +* Afficher les options WeeChat : ---- /set weechat.* ---- -* Afficher les options de l'extension IRC : +* Afficher les options de l'extension IRC : ---- /set irc.* ---- -Vous pouvez afficher de l'aide sur une option avec `/help`, par exemple : +Vous pouvez afficher de l'aide sur une option avec `/help`, par exemple : ---- /help weechat.look.highlight @@ -96,7 +96,7 @@ valeur et applique les changements immédiatement. Le cœur de WeeChat ("core") ne fait qu'afficher les données à l'écran et interagir avec l'utilisateur, cela signifie que le cœur sans extension -n'a pas grand intérêt (utilisateurs fidèles : IRC faisait partie du cœur +n'a pas grand intérêt (utilisateurs fidèles : IRC faisait partie du cœur dans les versions ≤ 0.2.6). Tous les protocoles réseau comme IRC sont fournis sous forme d'extensions. @@ -107,13 +107,13 @@ devriez voir "irc" et d'autres extensions dans cette liste. [[add_irc_server]] == Ajouter un serveur IRC -Vous pouvez ajouter un serveur IRC avec la commande `/server`, par exemple : +Vous pouvez ajouter un serveur IRC avec la commande `/server`, par exemple : ---- /server add freenode chat.freenode.net ---- -Comme d'habitude, de l'aide est disponible si vous êtes perdus : +Comme d'habitude, de l'aide est disponible si vous êtes perdus : ---- /help server @@ -131,26 +131,26 @@ définie (non "null"). Sinon WeeChat utilise la valeur par défaut ("irc.server_default.xxx"). Par exemple il y a des pseudos par défaut (basés sur votre login un*x), et -vous pouvez les écraser pour le serveur freenode avec la commande suivante : +vous pouvez les écraser pour le serveur freenode avec la commande suivante : ---- /set irc.server.freenode.nicks "pseudo,pseudo2,pseudo3,pseudo4,pseudo5" ---- -Pour modifier le nom d'utilisateur et nom réel : +Pour modifier le nom d'utilisateur et nom réel : ---- /set irc.server.freenode.username "Mon nom d'utilisateur" /set irc.server.freenode.realname "Mon nom réel" ---- -Pour activer la connexion automatique au serveur lors du démarrage : +Pour activer la connexion automatique au serveur lors du démarrage : ---- /set irc.server.freenode.autoconnect on ---- -Pour se connecter avec SSL : +Pour se connecter avec SSL : ---- /set irc.server.freenode.addresses "chat.freenode.net/7000" @@ -158,7 +158,7 @@ Pour se connecter avec SSL : ---- Si SASL est disponible sur le serveur, vous pouvez l'utiliser pour -l'authentification (vous serez identifié avant de rejoindre les canaux) : +l'authentification (vous serez identifié avant de rejoindre les canaux) : ---- /set irc.server.freenode.sasl_username "pseudo" @@ -167,7 +167,7 @@ l'authentification (vous serez identifié avant de rejoindre les canaux) : Pour lancer une commande après connexion au serveur, par exemple pour s'authentifier auprès de nickserv (seulement si vous n'utilisez pas SASL pour -l'authentification) : +l'authentification) : ---- /set irc.server.freenode.command "/msg nickserv identify xxxxxxx" @@ -180,26 +180,26 @@ Plusieurs commandes dans l'option _command_ peuvent être séparées par `;` Si vous souhaitez protéger votre mot de passe dans les fichiers de configuration, vous pouvez utiliser les données sécurisées. -Définissez d'abord une phrase de chiffrement : +Définissez d'abord une phrase de chiffrement : ---- /secure passphrase this is my secret passphrase ---- -Puis ajoutez une donnée sécurisée avec votre mot de passe freenode : +Puis ajoutez une donnée sécurisée avec votre mot de passe freenode : ---- /secure set freenode_password xxxxxxx ---- Vous pouvez alors utiliser `+${sec.data.freenode_password}+` au lieu de votre -mot de passe dans les options IRC mentionnées ci-dessus, par exemple : +mot de passe dans les options IRC mentionnées ci-dessus, par exemple : ---- /set irc.server.freenode.sasl_password "${sec.data.freenode_password}" ---- -Pour rejoindre automatiquement des canaux lors de la connexion au serveur : +Pour rejoindre automatiquement des canaux lors de la connexion au serveur : ---- /set irc.server.freenode.autojoin "#canal1,#canal2" @@ -207,14 +207,14 @@ Pour rejoindre automatiquement des canaux lors de la connexion au serveur : Pour supprimer la valeur d'une option du serveur et utiliser sa valeur par défaut à la place, par exemple pour utiliser les pseudos par défaut -(irc.server_default.nicks) : +(irc.server_default.nicks) : ---- /set irc.server.freenode.nicks null ---- -Autres options : vous pouvez modifier les autres options avec la commande -suivante ("xxx" est le nom d'une option) : +Autres options : vous pouvez modifier les autres options avec la commande +suivante ("xxx" est le nom d'une option) : ---- /set irc.server.freenode.xxx valeur @@ -237,7 +237,7 @@ WeeChat. Pour basculer entre le tampon _core_ et les tampons des serveurs, il faut utiliser la touche kbd:[Ctrl+x]. Il est possible de désactiver le mélange des tampons serveurs pour avoir un -tampon distinct par serveur : +tampon distinct par serveur : ---- /set irc.look.server_buffer independent @@ -246,20 +246,20 @@ tampon distinct par serveur : [[join_part_irc_channels]] == Rejoindre/quitter les canaux IRC -Rejoindre un canal : +Rejoindre un canal : ---- /join #channel ---- -Quitter un canal (en laissant le tampon ouvert) : +Quitter un canal (en laissant le tampon ouvert) : ---- /part [message de fin] ---- Fermer un tampon serveur, canal ou privé (`/close` est un alias sur -`/buffer close`) : +`/buffer close`) : ---- /close @@ -268,7 +268,7 @@ Fermer un tampon serveur, canal ou privé (`/close` est un alias sur [WARNING] Fermer le tampon du serveur fermera tous les tampons canaux/privés. -Se déconnecter du serveur, sur le tampon du serveur : +Se déconnecter du serveur, sur le tampon du serveur : ---- /disconnect @@ -277,13 +277,13 @@ Se déconnecter du serveur, sur le tampon du serveur : [[irc_private_messages]] == Messages privés IRC -Ouvrir un tampon et envoyer un message à un autre utilisateur (pseudo _foo_) : +Ouvrir un tampon et envoyer un message à un autre utilisateur (pseudo _foo_) : ---- /query foo ceci est un message ---- -Fermer le tampon privé : +Fermer le tampon privé : ---- /close @@ -299,7 +299,7 @@ Une fenêtre ("window") est une vue sur un tampon. Par défaut il n'y a qu'une fenêtre affichant un tampon. Si vous divisez l'écran, vous verrez alors plusieurs fenêtres avec plusieurs tampons en même temps. -Commandes pour gérer les tampons et les fenêtres : +Commandes pour gérer les tampons et les fenêtres : ---- /buffer @@ -310,13 +310,13 @@ Commandes pour gérer les tampons et les fenêtres : avec /help) Par exemple, pour découper verticalement l'écran en une petite fenêtre -(1/3 de la largeur) et une large (2/3), utilisez la commande : +(1/3 de la largeur) et une large (2/3), utilisez la commande : ---- /window splitv 33 ---- -Pour supprimer le découpage : +Pour supprimer le découpage : ---- /window merge @@ -327,35 +327,35 @@ Pour supprimer le découpage : WeeChat utilise un certain nombre de touches par défaut. Toutes ces touches sont dans la documentation, mais vous devriez connaître au moins -les touches vitales : +les touches vitales : -- kbd:[Alt+←] / kbd:[Alt+→] ou kbd:[F5] / kbd:[F6] : aller au tampon +- kbd:[Alt+←] / kbd:[Alt+→] ou kbd:[F5] / kbd:[F6] : aller au tampon précédent/suivant -- kbd:[F7] / kbd:[F8] : aller à la fenêtre précédente/suivante (quand l'écran +- kbd:[F7] / kbd:[F8] : aller à la fenêtre précédente/suivante (quand l'écran est divisé) -- kbd:[F9] / kbd:[F10] : faire défiler la barre de titre -- kbd:[F11] / kbd:[F12] : faire défiler la liste des pseudos -- kbd:[Tab] : compléter le texte de la barre d'entrée, comme avec votre shell -- kbd:[PgUp] / kbd:[PgDn] : faire défiler le texte dans le tampon courant -- kbd:[Alt+a] : sauter au tampon avec de l'activité (dans la "hotlist") +- kbd:[F9] / kbd:[F10] : faire défiler la barre de titre +- kbd:[F11] / kbd:[F12] : faire défiler la liste des pseudos +- kbd:[Tab] : compléter le texte de la barre d'entrée, comme avec votre shell +- kbd:[PgUp] / kbd:[PgDn] : faire défiler le texte dans le tampon courant +- kbd:[Alt+a] : sauter au tampon avec de l'activité (dans la "hotlist") Selon votre clavier et/ou vos besoins, vous pouvez associer n'importe quelle touche à une commande avec la commande `/key`. Une touche utile est kbd:[Alt+k] pour trouver le code des touches. -Par exemple, pour associer kbd:[Alt+!] à la commande `/buffer close` : +Par exemple, pour associer kbd:[Alt+!] à la commande `/buffer close` : ---- /key bind (pressez alt-k) (pressez alt-!) /buffer close ---- -Vous aurez une ligne de commande qui ressemble à ceci : +Vous aurez une ligne de commande qui ressemble à ceci : ---- /key bind meta-! /buffer close ---- -Pour enlever la touche : +Pour enlever la touche : ---- /key unbind meta-! @@ -372,7 +372,7 @@ extensions ou des scripts). De nombreux scripts externes (de contributeurs) sont disponibles pour WeeChat, vous pouvez télécharger et installer les scripts avec la commande `/script`, -par exemple : +par exemple : ---- /script install iset.pl @@ -380,13 +380,13 @@ par exemple : Voir `/help script` pour plus d'infos. -Une liste des scripts est disponible avec `/script` ou à cette URL : +Une liste des scripts est disponible avec `/script` ou à cette URL : https://weechat.org/scripts [[more_doc]] == Plus de documentation Vous pouvez maintenant utiliser WeeChat et lire la FAQ/documentation pour -toute autre question : https://weechat.org/doc +toute autre question : https://weechat.org/doc Bon WeeChat ! diff --git a/doc/fr/weechat_relay_protocol.fr.adoc b/doc/fr/weechat_relay_protocol.fr.adoc index 6d41acf55..384efdbea 100644 --- a/doc/fr/weechat_relay_protocol.fr.adoc +++ b/doc/fr/weechat_relay_protocol.fr.adoc @@ -9,7 +9,7 @@ :docinfo1: -Ce document est une spécification du protocole Relay de WeeChat : le protocole +Ce document est une spécification du protocole Relay de WeeChat : le protocole utilisé pour relayer les données de WeeChat aux clients, qui sont surtout des interfaces distantes. @@ -20,18 +20,18 @@ interfaces distantes. [[terminology]] === Terminologie -Les termes suivants sont utilisés dans ce document : +Les termes suivants sont utilisés dans ce document : -* _relay_ : il s'agit de l'extension "relay" de WeeChat, qui agit comme un +* _relay_ : il s'agit de l'extension "relay" de WeeChat, qui agit comme un "serveur" et autorise les _clients_ à se connecter -* _client_ : il s'agit d'un autre logiciel, connecté au _relay_ via une +* _client_ : il s'agit d'un autre logiciel, connecté au _relay_ via une connexion réseau; dans la plupart des cas, ce _client_ est une interface distante. [[network_diagram]] === Diagramme réseau -Les _clients_ sont connectés au _relay_ comme dans le diagramme ci-dessous : +Les _clients_ sont connectés au _relay_ comme dans le diagramme ci-dessous : .... ┌──────────┐ Station de travail @@ -71,19 +71,19 @@ un _proxy IRC_ (non décrit dans ce document). [[commands]] == Commandes (client → relay) -Les commandes ont le format : "(id) commande paramètres\n". +Les commandes ont le format : "(id) commande paramètres\n". -Les champs sont : +Les champs sont : -* _id_ : identifiant du message (facultatif) qui sera envoyée dans la réponse de +* _id_ : identifiant du message (facultatif) qui sera envoyée dans la réponse de _relay_; elle doit être entre parenthèses, et ne doit pas commencer par un underscore ("_") (les identifiants commençant par un underscore sont réservés pour les messages _évènements_ de WeeChat) -* _commande_ : une commande (voir le tableau ci-dessous) -* _paramètres_ : paramètres facultatifs pour la commande (plusieurs paramètres +* _commande_ : une commande (voir le tableau ci-dessous) +* _paramètres_ : paramètres facultatifs pour la commande (plusieurs paramètres sont séparés par des espaces). -Liste des commandes disponibles (détail dans les chapitres suivants) : +Liste des commandes disponibles (détail dans les chapitres suivants) : [width="80%",cols="^3m,14",options="header"] |=== @@ -106,27 +106,27 @@ Initialiser la connexion avec _relay_. Il doit s'agir de la première commande envoyée à _relay_. Si elle n'est pas envoyée, _relay_ coupera la connexion à la première commande reçue, sans avertissement. -Syntaxe : +Syntaxe : ---- init [<option>=<valeur>,[<option>=<valeur>,...]] ---- -Paramètres : +Paramètres : -* _option_ : une des options suivantes : -** _password_ : mot de passe utilisé pour s'authentifier avec _relay_ (option +* _option_ : une des options suivantes : +** _password_ : mot de passe utilisé pour s'authentifier avec _relay_ (option _relay.network.password_ dans WeeChat) -** _compression_ : type de compression : -*** _zlib_ : activer la compression _zlib_ pour les messages envoyés par _relay_ +** _compression_ : type de compression : +*** _zlib_ : activer la compression _zlib_ pour les messages envoyés par _relay_ (activée par défaut si _relay_ supporte la compression _zlib_) -*** _off_ : désactiver la compression +*** _off_ : désactiver la compression [NOTE] Avec WeeChat ≥ 1.6, les virgules peuvent être échappées dans la valeur, par exemple `init password=foo\,bar` pour envoyer le mot de passe "foo,bar". -Exemples : +Exemples : ---- # initialiser et utiliser la compression zlib par défaut (si WeeChat la supporte) @@ -144,31 +144,31 @@ init password=mypass,compression=off Demander un _hdata_. -Syntaxe : +Syntaxe : ---- (id) hdata <chemin> [<clés>] ---- -Paramètres : +Paramètres : -* _chemin_ : chemin vers le hdata, avec le format : - "hdata:pointeur/var/var/.../var", la dernière variable est le hdata retourné : -** _hdata_ : nom du hdata -** _pointeur_ : pointeur ("0x12345") ou nom de liste (par exemple : +* _chemin_ : chemin vers le hdata, avec le format : + "hdata:pointeur/var/var/.../var", la dernière variable est le hdata retourné : +** _hdata_ : nom du hdata +** _pointeur_ : pointeur ("0x12345") ou nom de liste (par exemple : "gui_buffers") (nombre autorisé, voir ci-dessous) -** _var_ : un nom de variable dans le hdata parent (nom précédent dans le +** _var_ : un nom de variable dans le hdata parent (nom précédent dans le chemin) (nombre autorisé, voir ci-dessous) -* _clés_ : liste de clés (séparées par des virgules) à retourner dans le hdata +* _clés_ : liste de clés (séparées par des virgules) à retourner dans le hdata (si non spécifié, toutes les clés sont retournées, ce qui n'est pas recommandé avec les grosses structures hdata) Un nombre est autorisé après le pointeur et les variables, avec le format "(N)". -Les valeurs possibles sont : +Les valeurs possibles sont : -* nombre positif : itérer en utilisant l'élément suivant, N fois -* nombre négatif : itérer en utilisant l'élément précédent, N fois -* _*_ : itérer en utilisant l'élément suivant, jusqu'à la fin de la liste +* nombre positif : itérer en utilisant l'élément suivant, N fois +* nombre négatif : itérer en utilisant l'élément précédent, N fois +* _*_ : itérer en utilisant l'élément suivant, jusqu'à la fin de la liste [NOTE] Avec WeeChat ≥ 1.6, si le chemin vers le hdata est invalide ou si un pointeur @@ -176,7 +176,7 @@ NULL est trouvé, un hdata vide est retourné (voir l'exemple dans <<object_hdata,l'objet hdata>>). + Avec des versions plus anciennes, rien n'était retourné. -Exemples : +Exemples : ---- # demander tous les tampons, un hdata de type "buffer" est retourné @@ -200,18 +200,18 @@ hdata hotlist:gui_hotlist(*) Demander une _info_. -Syntaxe : +Syntaxe : ---- (id) info <nom> [<paramètres>] ---- -Paramètres : +Paramètres : -* _nom_ : nom de l'info à obtenir -* _paramètres_ : paramètres pour l'info (facultatif) +* _nom_ : nom de l'info à obtenir +* _paramètres_ : paramètres pour l'info (facultatif) -Exemple : +Exemple : ---- info version @@ -228,19 +228,19 @@ possible, utilisez plutôt la commande <<command_hdata,hdata>>, qui est un accè direct aux données (cela est plus rapide, utilise moins de mémoire et retourne des objets plus petits dans le message). -Syntaxe : +Syntaxe : ---- (id) infolist <nom> [<pointeur> [<paramètres>]] ---- -Paramètres : +Paramètres : -* _nom_ : nom de l'infolist à obtenir -* _pointeur_ : pointeur (facultatif) -* _paramètres_ : paramètres (facultatif) +* _nom_ : nom de l'infolist à obtenir +* _pointeur_ : pointeur (facultatif) +* _paramètres_ : paramètres (facultatif) -Exemple : +Exemple : ---- infolist buffer @@ -251,18 +251,18 @@ infolist buffer Demander une _nicklist_ (liste de pseudos), pour un ou tous les tampons. -Syntaxe : +Syntaxe : ---- (id) nicklist [<tampon>] ---- -Paramètres : +Paramètres : -* _tampon_ : pointeur (_0x12345_) ou nom complet du tampon (par exemple : +* _tampon_ : pointeur (_0x12345_) ou nom complet du tampon (par exemple : _core.weechat_ ou _irc.freenode.#weechat_) -Exemples : +Exemples : ---- # demander la liste de pseudos pour tous les tampons @@ -277,21 +277,21 @@ nicklist irc.freenode.#weechat Envoyer des données à un tampon. -Syntaxe : +Syntaxe : ---- input <tampon> <données> ---- -Paramètres : +Paramètres : -* _tampon_ : pointeur (_0x12345_) ou nom complet du tampon (par exemple : +* _tampon_ : pointeur (_0x12345_) ou nom complet du tampon (par exemple : _core.weechat_ ou _irc.freenode.#weechat_) -* _données_ : données à envoyer au tampon : si elles commencent par `/`, +* _données_ : données à envoyer au tampon : si elles commencent par `/`, cela sera exécuté comme une commande sur le tampon, sinon le texte est envoyé comme entrée sur le tampon -Exemples : +Exemples : ---- input core.weechat /help filter @@ -308,34 +308,34 @@ Synchroniser un ou plusieurs tampons, pour obtenir les mises à jour. [IMPORTANT] Il est recommandé d'utiliser cette commande immédiatement après avoir demandé les données des tampons (lignes, ...). Elle peut être envoyée dans le même -message (après un caractère de nouvelle ligne : "\n"). +message (après un caractère de nouvelle ligne : "\n"). -Syntaxe : +Syntaxe : ---- sync [<tampon>[,<tampon>...] <option>[,<option>...]] ---- -Paramètres : +Paramètres : -* _tampon_ : pointeur (_0x12345_) ou nom complet du tampon (par exemple : +* _tampon_ : pointeur (_0x12345_) ou nom complet du tampon (par exemple : _core.weechat_ ou _irc.freenode.#weechat_); le nom "*" peut être utilisé pour spécifier tous les tampons -* _options_ : un ou plusieurs mots-clés, séparés par des virgules (par défaut +* _options_ : un ou plusieurs mots-clés, séparés par des virgules (par défaut _buffers,upgrade,buffer,nicklist_ pour "*" et _buffer,nicklist_ pour un - tampon) : -** _buffers_ : recevoir les signaux à propos des tampons (ouverts/fermés, + tampon) : +** _buffers_ : recevoir les signaux à propos des tampons (ouverts/fermés, déplacés, renommés, mélangés, masqués/démasqués); peut être utilisé seulement avec "*" _(WeeChat ≥ 0.4.1)_ -** _upgrade_ : recevoir les signaux à propos de la mise à jour de WeeChat +** _upgrade_ : recevoir les signaux à propos de la mise à jour de WeeChat (mise à jour, fin de mise à jour); peut être utilisé seulement avec "*" _(WeeChat ≥ 0.4.1)_ -** _buffer_ : recevoir les signaux à propos du tampon (nouvelles lignes, type +** _buffer_ : recevoir les signaux à propos du tampon (nouvelles lignes, type changé, titre changé, variable locale ajoutée/supprimée, et les même signaux que _buffers_ pour le tampon) _(mis à jour dans la version 0.4.1)_ -** _nicklist_ : recevoir la liste de pseudos après des changements +** _nicklist_ : recevoir la liste de pseudos après des changements -Exemples : +Exemples : ---- # synchroniser tous les tampons avec la liste de pseudos @@ -368,29 +368,29 @@ Ceci retirera les _options_ pour les tampons. Si des options sont toujours actives pour les tampons, le client recevra toujours les mises à jour pour ces tampons. -Syntaxe : +Syntaxe : ---- desync [<tampon>[,<tampon>...] <option>[,<option>...]] ---- -Paramètres : +Paramètres : -* _tampon_ : pointeur (_0x12345_) ou nom complet du tampon (par exemple : +* _tampon_ : pointeur (_0x12345_) ou nom complet du tampon (par exemple : _core.weechat_ ou _irc.freenode.#weechat_); le nom "*" peut être utilisé pour spécifier tous les tampons -* _options_ : un ou plusieurs mots-clés, séparés par des virgules (le défaut est +* _options_ : un ou plusieurs mots-clés, séparés par des virgules (le défaut est _buffers,upgrade,buffer,nicklist_ pour "*" et _buffer,nicklist_ pour un tampon); voir <<command_sync,la commande sync>> pour les valeurs [NOTE] En utilisant le tampon "*", les autres tampons synchronisés (en utilisant un nom) sont gardés. + -Donc si vous envoyez : "sync *", puis "sync irc.freenode.#weechat", puis +Donc si vous envoyez : "sync *", puis "sync irc.freenode.#weechat", puis "desync *", les mises à jour sur le canal #weechat seront toujours envoyées par WeeChat (vous devez le retirer explicitement pour stopper les mises à jour). -Exemples : +Exemples : ---- # désynchroniser tous les tampons @@ -411,7 +411,7 @@ desync irc.freenode.#weechat [[command_test]] === test -Commande de test : WeeChat répondra avec différents objets. +Commande de test : WeeChat répondra avec différents objets. Cette commande est utile pour tester le décodage d'objets binaires retournés par WeeChat. @@ -421,19 +421,19 @@ Vous ne devez pas utiliser les pointeurs retournés par cette commande, ils ne sont pas valides. Cette commande doit être utilisée seulement pour tester le décodage d'un message envoyé par WeeChat. -Syntaxe : +Syntaxe : ---- test ---- -Exemple : +Exemple : ---- test ---- -Objets retournés (dans cet ordre) : +Objets retournés (dans cet ordre) : [width="80%",cols="^3,3m,5m",options="header"] |=== @@ -466,13 +466,13 @@ paramètres. Cette commande est pratique pour tester que la connexion avec WeeChat est toujours active et mesurer le temps de réponse. -Syntaxe : +Syntaxe : ---- ping [<paramètres>] ---- -Exemple : +Exemple : ---- ping 1370802127000 @@ -483,13 +483,13 @@ ping 1370802127000 Se déconnecter de _relay_. -Syntaxe : +Syntaxe : ---- quit ---- -Exemple : +Exemple : ---- quit @@ -499,7 +499,7 @@ quit == Messages (relay → client) Les messages sont envoyés sous forme de données binaires, en utilisant le format -suivant (avec la taille en octets) : +suivant (avec la taille en octets) : .... ┌────────╥─────────────╥────╥────────┬─────────╥───────╥────────┬─────────┐ @@ -513,16 +513,16 @@ suivant (avec la taille en octets) : 'taille' octets .... -* _taille_ (entier non signé) : nombre d'octets du message entier (en incluant +* _taille_ (entier non signé) : nombre d'octets du message entier (en incluant ce champ) -* _compression_ (octet) : drapeau : -** _0x00_ : les données qui suivent ne sont pas compressées -** _0x01_ : les données qui suivent sont compressées avec _zlib_ -* _id_ (chaîne) : l'identifiant envoyé par le client (avant le nom de la +* _compression_ (octet) : drapeau : +** _0x00_ : les données qui suivent ne sont pas compressées +** _0x01_ : les données qui suivent sont compressées avec _zlib_ +* _id_ (chaîne) : l'identifiant envoyé par le client (avant le nom de la commande); il peut être vide (chaîne avec une longueur de zéro sans contenu) si l'identifiant n'était pas donné dans la commande -* _type_ (3 caractères) : un type : 3 lettres (voir le tableau ci-dessous) -* _objet_ : un objet (voir tableau ci-dessous) +* _type_ (3 caractères) : un type : 3 lettres (voir le tableau ci-dessous) +* _objet_ : un objet (voir tableau ci-dessous) [[message_compression]] === Compression @@ -534,73 +534,73 @@ d'être utilisées. [[message_identifier]] === Identifiant -Il y a deux types d'identifiants (_id_) : +Il y a deux types d'identifiants (_id_) : -* _id_ envoyé par le _client_ : _relay_ répondra avec le même _id_ dans sa +* _id_ envoyé par le _client_ : _relay_ répondra avec le même _id_ dans sa réponse -* _id_ d'un évènement : pour certains évènements, _relay_ enverra un message au +* _id_ d'un évènement : pour certains évènements, _relay_ enverra un message au _client_ en utilisant un _id_ spécifique, commençant par underscore (voir le tableau ci-dessous) -Les identifiants réservés par WeeChat : +Les identifiants réservés par WeeChat : [width="100%",cols="5,5,3,4,7",options="header"] |=== | Identifiant | Reçu avec _sync_ | Données envoyées | Description | Action recommandée dans le client -| _buffer_opened | buffers / buffer | hdata : buffer | +| _buffer_opened | buffers / buffer | hdata : buffer | Tampon ouvert. | Ouvrir le tampon. -| _buffer_type_changed | buffers / buffer | hdata : buffer | +| _buffer_type_changed | buffers / buffer | hdata : buffer | Type de tampon changé. | Changer le type de tampon. -| _buffer_moved | buffers / buffer | hdata : buffer | +| _buffer_moved | buffers / buffer | hdata : buffer | Tampon déplacé. | Déplacer le tampon. -| _buffer_merged | buffers / buffer | hdata : buffer | +| _buffer_merged | buffers / buffer | hdata : buffer | Tampon mélangé. | Mélanger le tampon. -| _buffer_unmerged | buffers / buffer | hdata : buffer | +| _buffer_unmerged | buffers / buffer | hdata : buffer | Tampon sorti du mélange. | Sortir le tampon du mélange. -| _buffer_hidden | buffers / buffer | hdata : buffer | +| _buffer_hidden | buffers / buffer | hdata : buffer | Tampon masqué. | Masquer le le tampon. -| _buffer_unmerged | buffers / buffer | hdata : buffer | +| _buffer_unmerged | buffers / buffer | hdata : buffer | Tampon démasqué. | Démasquer le tampon. -| _buffer_renamed | buffers / buffer | hdata : buffer | +| _buffer_renamed | buffers / buffer | hdata : buffer | Tampon renommé. | Renommer le tampon. -| _buffer_title_changed | buffers / buffer | hdata : buffer | +| _buffer_title_changed | buffers / buffer | hdata : buffer | Titre du tampon changé. | Changer le titre du tampon. -| _buffer_localvar_added | buffers / buffer | hdata : buffer | +| _buffer_localvar_added | buffers / buffer | hdata : buffer | Variable locale ajoutée. | Ajouter la variable locale dans le tampon. -| _buffer_localvar_changed | buffers / buffer | hdata : buffer | +| _buffer_localvar_changed | buffers / buffer | hdata : buffer | Variable locale changée. | Changer la variable locale dans le tampon. -| _buffer_localvar_removed | buffers / buffer | hdata : buffer | +| _buffer_localvar_removed | buffers / buffer | hdata : buffer | Variable locale supprimée. | Supprimer la variable locale du tampon. -| _buffer_closing | buffers / buffer | hdata : buffer | +| _buffer_closing | buffers / buffer | hdata : buffer | Tampon qui se ferme. | Fermer le tampon. -| _buffer_cleared | buffer | hdata : buffer | +| _buffer_cleared | buffer | hdata : buffer | Tampon qui est vidé. | Vider le tampon. -| _buffer_line_added | buffer | hdata : line | +| _buffer_line_added | buffer | hdata : line | Ligne ajoutée dans le tampon. | Afficher la ligne dans le tampon. -| _nicklist | nicklist | hdata : nicklist_item | +| _nicklist | nicklist | hdata : nicklist_item | Liste de pseudos pour un tampon. | Remplacer la liste de pseudos. -| _nicklist_diff | nicklist | hdata : nicklist_item | +| _nicklist_diff | nicklist | hdata : nicklist_item | Différence de liste de pseudos pour un tampon . | Mettre à jour la liste de pseudos. -| _pong | (always) | chaîne : paramètres du ping | +| _pong | (always) | chaîne : paramètres du ping | Réponse à un "ping". | Mesurer le temps de réponse. | _upgrade | upgrade | (vide) | @@ -616,14 +616,14 @@ Les identifiants réservés par WeeChat : Ce message est envoyé au client lorsque le signal "buffer_opened" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== | Nom | Type | Description | number | entier | Numéro de tampon (≥ 1). -| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). -| short_name | chaîne | Nom court (exemple : _#weechat_). +| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). +| short_name | chaîne | Nom court (exemple : _#weechat_). | nicklist | entier | 1 si le tampon a une liste de pseudos, sinon 0. | title | chaîne | Titre du tampon. | local_variables | table de hachage | Variables locales. @@ -631,8 +631,8 @@ Données envoyées dans le hdata : | next_buffer | pointeur | Pointeur vers le tampon suivant. |=== -Exemple : canal _#weechat_ rejoint sur freenode, nouveau tampon -_irc.freenode.#weechat_ : +Exemple : canal _#weechat_ rejoint sur freenode, nouveau tampon +_irc.freenode.#weechat_ : [source,python] ---- @@ -659,18 +659,18 @@ hda: Ce message est envoyé au client lorsque le signal "buffer_moved" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== | Nom | Type | Description | number | entier | Numéro de tampon (≥ 1). -| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). +| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). | prev_buffer | pointeur | Pointeur vers le tampon précédent. | next_buffer | pointeur | Pointeur vers le tampon suivant. |=== -Exemple : tampon _irc.freenode.#weechat_ déplacé vers le numéro 2 : +Exemple : tampon _irc.freenode.#weechat_ déplacé vers le numéro 2 : [source,python] ---- @@ -692,18 +692,18 @@ hda: Ce message est envoyé au client lorsque le signal "buffer_merged" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== | Nom | Type | Description | number | entier | Numéro de tampon (≥ 1). -| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). +| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). | prev_buffer | pointeur | Pointeur vers le tampon précédent. | next_buffer | pointeur | Pointeur vers le tampon suivant. |=== -Exemple : tampon _irc.freenode.#weechat_ mélangé avec le tampon n°2 : +Exemple : tampon _irc.freenode.#weechat_ mélangé avec le tampon n°2 : [source,python] ---- @@ -725,18 +725,18 @@ hda: Ce message est envoyé au client lorsque le signal "buffer_unmerged" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== | Nom | Type | Description | number | entier | Numéro de tampon (≥ 1). -| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). +| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). | prev_buffer | pointeur | Pointeur vers le tampon précédent. | next_buffer | pointeur | Pointeur vers le tampon suivant. |=== -Exemple : tampon _irc.freenode.#weechat_ sorti du mélange : +Exemple : tampon _irc.freenode.#weechat_ sorti du mélange : [source,python] ---- @@ -760,18 +760,18 @@ _WeeChat ≥ 1.0._ Ce message est envoyé au client lorsque le signal "buffer_hidden" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== | Nom | Type | Description | number | entier | Numéro de tampon (≥ 1). -| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). +| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). | prev_buffer | pointeur | Pointeur vers le tampon précédent. | next_buffer | pointeur | Pointeur vers le tampon suivant. |=== -Exemple : tampon _irc.freenode.#weechat_ masqué : +Exemple : tampon _irc.freenode.#weechat_ masqué : [source,python] ---- @@ -795,18 +795,18 @@ _WeeChat ≥ 1.0._ Ce message est envoyé au client lorsque le signal "buffer_unhidden" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== | Nom | Type | Description | number | entier | Numéro de tampon (≥ 1). -| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). +| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). | prev_buffer | pointeur | Pointeur vers le tampon précédent. | next_buffer | pointeur | Pointeur vers le tampon suivant. |=== -Exemple : tampon _irc.freenode.#weechat_ démasqué : +Exemple : tampon _irc.freenode.#weechat_ démasqué : [source,python] ---- @@ -828,18 +828,18 @@ hda: Ce message est envoyé au client lorsque le signal "buffer_renamed" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== | Nom | Type | Description | number | entier | Numéro de tampon (≥ 1). -| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). -| short_name | chaîne | Nom court (exemple : _#weechat_). +| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). +| short_name | chaîne | Nom court (exemple : _#weechat_). | local_variables | table de hachage | Variables locales. |=== -Exemple : tampon privé renommé de _FlashCode_ en _Flash2_ : +Exemple : tampon privé renommé de _FlashCode_ en _Flash2_ : [source,python] ---- @@ -862,17 +862,17 @@ hda: Ce message est envoyé au client lorsque le signal "buffer_title_changed" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== | Nom | Type | Description | number | entier | Numéro de tampon (≥ 1). -| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). +| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). | title | chaîne | Titre du tampon. |=== -Exemple : titre changé sur le canal _#weechat_ : +Exemple : titre changé sur le canal _#weechat_ : [source,python] ---- @@ -895,16 +895,16 @@ _WeeChat ≥ 1.0._ Ce message est envoyé au client lorsque le signal "buffer_cleared" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== | Nom | Type | Description | number | entier | Numéro de tampon (≥ 1). -| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). +| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). |=== -Exemple : tampon _irc.freenode.#weechat_ vidé : +Exemple : tampon _irc.freenode.#weechat_ vidé : [source,python] ---- @@ -924,18 +924,18 @@ hda: Ce message est envoyé au client lorsque le signal "buffer_type_changed" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== | Nom | Type | Description | number | entier | Numéro de tampon (≥ 1). -| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). -| type | entier | Type de tampon : 0 = formaté (par défaut), 1 = contenu libre. +| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). +| type | entier | Type de tampon : 0 = formaté (par défaut), 1 = contenu libre. |=== -Exemple : type de tampon _script.scripts_ changé de formaté (0) à contenu -libre (1) : +Exemple : type de tampon _script.scripts_ changé de formaté (0) à contenu +libre (1) : [source,python] ---- @@ -956,18 +956,18 @@ hda: Ce message est envoyé au client lorsque le signal "buffer_localvar_added" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== | Nom | Type | Description | number | entier | Numéro de tampon (≥ 1). -| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). +| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). | local_variables | table de hachage | Variables locales. |=== -Exemple : variable locale _test_ ajoutée dans le tampon -_irc.freenode.#weechat_ : +Exemple : variable locale _test_ ajoutée dans le tampon +_irc.freenode.#weechat_ : [source,python] ---- @@ -990,18 +990,18 @@ hda: Ce message est envoyé au client lorsque le signal "buffer_localvar_changed" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== | Nom | Type | Description | number | entier | Numéro de tampon (≥ 1). -| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). +| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). | local_variables | table de hachage | Variables locales. |=== -Exemple : variable locale _test_ mise à jour dans le tampon -_irc.freenode.#weechat_ : +Exemple : variable locale _test_ mise à jour dans le tampon +_irc.freenode.#weechat_ : [source,python] ---- @@ -1024,17 +1024,17 @@ hda: Ce message est envoyé au client lorsque le signal "buffer_localvar_removed" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== | Nom | Type | Description | number | entier | Numéro de tampon (≥ 1). -| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). +| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). | local_variables | table de hachage | Variables locales. |=== -Exemple : variable locale _test_ supprimée du tampon _irc.freenode.#weechat_ : +Exemple : variable locale _test_ supprimée du tampon _irc.freenode.#weechat_ : [source,python] ---- @@ -1056,7 +1056,7 @@ hda: Ce message est envoyé au client lorsque le signal "buffer_line_added" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== @@ -1071,8 +1071,8 @@ Données envoyées dans le hdata : | message | chaîne | Message. |=== -Exemple : nouveau message _hello!_ du pseudo _FlashCode_ sur le tampon -_irc.freenode.#weechat_ : +Exemple : nouveau message _hello!_ du pseudo _FlashCode_ sur le tampon +_irc.freenode.#weechat_ : [source,python] ---- @@ -1099,16 +1099,16 @@ hda: Ce message est envoyé au client lorsque le signal "buffer_closing" est envoyé par WeeChat. -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== | Nom | Type | Description | number | entier | Numéro de tampon (≥ 1). -| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). +| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_). |=== -Exemple : tampon _irc.freenode.#weechat_ en cours de fermeture par WeeChat : +Exemple : tampon _irc.freenode.#weechat_ en cours de fermeture par WeeChat : [source,python] ---- @@ -1133,7 +1133,7 @@ Lorsque de petites mises à jour sont faites sur la liste de pseudos (par exempl l'ajout d'un seul pseudo), un autre message avec l'identifiant __nicklist_diff_ est envoyé (voir ci-dessous). -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== @@ -1147,7 +1147,7 @@ Données envoyées dans le hdata : | prefix_color | chaîne | Couleur du préfixe (seulement pour un pseudo). |=== -Exemple : liste de pseudos pour le tampon _irc.freenode.#weechat_ : +Exemple : liste de pseudos pour le tampon _irc.freenode.#weechat_ : [source,python] ---- @@ -1222,7 +1222,7 @@ sur la liste de pseudos (groupes/pseudos ajoutés/supprimés/changés). Le messa contient les différences de la liste de pseudos (entre l'ancienne liste de pseudos et la nouvelle). -Données envoyées dans le hdata : +Données envoyées dans le hdata : [width="100%",cols="3m,2,10",options="header"] |=== @@ -1237,17 +1237,17 @@ Données envoyées dans le hdata : | prefix_color | chaîne | Couleur du préfixe (seulement pour un pseudo). |=== -La valeur de __diff_ peut être : +La valeur de __diff_ peut être : -* `+^+` : le groupe parent : le(s) groupe(s)/pseudo(s) après celui-ci sont liés à +* `+^+` : le groupe parent : le(s) groupe(s)/pseudo(s) après celui-ci sont liés à ce groupe -* `+++` : groupe/pseudo ajouté dans le groupe parent -* `+-+` : groupe/pseudo supprimé du groupe parent -* `+*+` : groupe/pseudo mis à jour dans le groupe parent +* `+++` : groupe/pseudo ajouté dans le groupe parent +* `+-+` : groupe/pseudo supprimé du groupe parent +* `+*+` : groupe/pseudo mis à jour dans le groupe parent -Exemple : pseudo _master_ ajouté dans le groupe _000|o_ (opérateurs de canel sur +Exemple : pseudo _master_ ajouté dans le groupe _000|o_ (opérateurs de canel sur un canal IRC), pseudos _nick1_ et _nick2_ ajoutés dans le groupe _999|..._ -(utilisateurs standard sur un canal IRC) : +(utilisateurs standard sur un canal IRC) : [source,python] ---- @@ -1315,7 +1315,7 @@ _WeeChat ≥ 0.4.2._ Ce message est envoyé au client lorsque _relay_ reçoit un message "ping". -Données envoyées dans la chaîne : paramètres reçus dans le message "ping". +Données envoyées dans la chaîne : paramètres reçus dans le message "ping". L'action recommandée dans le client est de mesurer le temps dé réponse et se déconnecter si le temps est très long. @@ -1346,14 +1346,14 @@ Ce message est envoyé au client lorsque WeeChat a terminé sa mise à jour. Il n'y a pas de données dans le message. -L'action recommandée dans le client est de se resynchroniser avec WeeChat : +L'action recommandée dans le client est de se resynchroniser avec WeeChat : envoyer à nouveau les commandes envoyées au démarrage après _init_. [[objects]] === Objets Les objets sont identifiés par 3 lettres, appelées _type_. Les types suivants -sont utilisés : +sont utilisés : [width="100%",cols="^2m,5,10",options="header"] |=== @@ -1367,7 +1367,7 @@ sont utilisés : | tim | Date/heure | 1 octet + longueur de la date/heure sous forme de chaîne | htb | Table de hachage | Variable | hda | Contenu du hdata | Variable -| inf | Info : nom + contenu | Variable +| inf | Info : nom + contenu | Variable | inl | Contenu de l'infolist | Variable | arr | Tableau d'objets | 3 octets (type) + nombre d'objets + données |=== @@ -1377,7 +1377,7 @@ sont utilisés : Un caractère signé est un octet. -Exemple : +Exemple : .... ┌────┐ @@ -1391,9 +1391,9 @@ Exemple : Un entier signé est stocké sur 4 octets, encodé au format "big-endian" (octet le plus significatif en premier). -Intervalle : -2147483648 à 2147483647. +Intervalle : -2147483648 à 2147483647. -Exemples : +Exemples : .... ┌────┬────┬────┬────┐ @@ -1411,9 +1411,9 @@ Exemples : Un entier long signé est encodé sous forme de chaîne de caractères, avec la longueur sur un octet. -Intervalle : -9223372036854775808 à 9223372036854775807. +Intervalle : -9223372036854775808 à 9223372036854775807. -Exemples : +Exemples : .... ┌────╥────┬────┬────┬────┬────┬────┬────┬────┬────┬────┐ @@ -1435,7 +1435,7 @@ long. '-' '1' '2' '3' '4' '5' '6' '7' '8' '9' '0' Une chaîne de caractère est une longueur (un entier sur 4 octets) + le contenu de la chaîne (sans le _\0_ final). -Exemple : +Exemple : .... ┌────┬────┬────┬────╥────┬────┬────┬────┬────┐ @@ -1445,7 +1445,7 @@ Exemple : longueur 'h' 'e' 'l' 'l' 'o' .... -Une chaîne vide a une longueur de zéro : +Une chaîne vide a une longueur de zéro : .... ┌────┬────┬────┬────┐ @@ -1455,7 +1455,7 @@ Une chaîne vide a une longueur de zéro : longueur .... -Une chaîne _NULL_ (pointeur NULL en C) a une longueur de -1 : +Une chaîne _NULL_ (pointeur NULL en C) a une longueur de -1 : .... ┌────┬────┬────┬────┐ @@ -1477,7 +1477,7 @@ tableau d'octets. Un pointeur est encodé sous forme de chaîne de caractère (hexadécimal), avec la longueur sur un octet. -Exemple : +Exemple : .... ┌────╥────┬────┬────┬────┬────┬────┬────┬────┬────┐ @@ -1487,7 +1487,7 @@ Exemple : long. '1' 'a' '2' 'b' '3' 'c' '4' 'd' '5' .... -Un pointeur _NULL_ a une longueur de 1 avec la valeur 0 : +Un pointeur _NULL_ a une longueur de 1 avec la valeur 0 : .... ┌────╥────┐ @@ -1503,7 +1503,7 @@ long. 0 La date/heure (nombre de secondes) est encodé sous forme de chaîne de caractères, avec la longueur sur un octet. -Exemple : +Exemple : .... ┌────╥────┬────┬────┬────┬────┬────┬────┬────┬────┬────┐ @@ -1526,7 +1526,7 @@ et valeurs de chaque élément. └───────────┴─────────────┴───────╨───────┴─────────╨─────╨───────┴─────────┘ .... -Exemple : +Exemple : .... ┌─────┬─────┬───╥──────┬─────╥──────┬─────┐ @@ -1554,19 +1554,19 @@ objets). ──╨────────┴─────────────────────╨─────┘ .... -* _h-path_ (chaîne) : chemin utilise pour atteindre le hdata (exemple : +* _h-path_ (chaîne) : chemin utilise pour atteindre le hdata (exemple : _buffer/lines/line/line_data_); le dernier élément du chemin est le hdata retourné -* _keys_ (chaînes) : chaîne avec une liste de _clé:type_ (séparés par des - virgules), exemple : _number:int,name:str_ -* _count_ (entier) : nombre d'objets -* _p-path_ : chemin avec les pointeurs vers les objets (le nombre de pointeurs +* _keys_ (chaînes) : chaîne avec une liste de _clé:type_ (séparés par des + virgules), exemple : _number:int,name:str_ +* _count_ (entier) : nombre d'objets +* _p-path_ : chemin avec les pointeurs vers les objets (le nombre de pointeurs ici est le nombre d'éléments dans le chemin) -* _values_ : liste de valeurs (le nombre de valeurs est le nombre de clés +* _values_ : liste de valeurs (le nombre de valeurs est le nombre de clés retournées pour le hdata) Exemple de hdata avec deux tampons (tampon "core" weechat et le serveur -freenode) et deux clés (_number_ et _full_name_) : +freenode) et deux clés (_number_ et _full_name_) : .... # commande @@ -1586,7 +1586,7 @@ hdata buffer:gui_buffers(*) number,full_name tampon 1 tampon 2 .... -Exemple de hdata avec les lignes du tampon "core" : +Exemple de hdata avec les lignes du tampon "core" : .... # commande @@ -1616,7 +1616,7 @@ hdata buffer:gui_buffers(*)/lines/first_line(*)/data ligne 2 lignes 3-50 .... -Exemple de hdata avec la liste des pseudos : +Exemple de hdata avec la liste des pseudos : .... # commande @@ -1660,7 +1660,7 @@ nicklist pseudo (@ChanServ) .... -Exemple de hdata vide (la hotlist est vide dans WeeChat) : +Exemple de hdata vide (la hotlist est vide dans WeeChat) : .... # commande @@ -1686,10 +1686,10 @@ caractères). └──────┴───────┘ .... -* _nom_ (chaîne) : nom de l'info -* _value_ (chaîne) : valeur +* _nom_ (chaîne) : nom de l'info +* _value_ (chaîne) : valeur -Exemple de l'info _version_ : +Exemple de l'info _version_ : .... ┌─────────┬───────────────────┐ @@ -1709,7 +1709,7 @@ variables). └──────┴───────╨────────╨─────╨────────┘ .... -Un élément est : +Un élément est : .... ┌───────╥────────┬────────┬─────────╥─────╥────────┬────────┬─────────┐ @@ -1717,16 +1717,16 @@ Un élément est : └───────╨────────┴────────┴─────────╨─────╨────────┴────────┴─────────┘ .... -* _name_ (chaîne) : nom de l'infolist (_buffer_, _window_, _bar_, ...) -* _count_ (entier) : nombre d'éléments -* _item_ : -** _count_ : nombre de variables dans l'élément -** _name_ : nom de variable -** _type_ : type de variable (_int_, _str_, ...) -** _value_ : valeur de la variable +* _name_ (chaîne) : nom de l'infolist (_buffer_, _window_, _bar_, ...) +* _count_ (entier) : nombre d'éléments +* _item_ : +** _count_ : nombre de variables dans l'élément +** _name_ : nom de variable +** _type_ : type de variable (_int_, _str_, ...) +** _value_ : valeur de la variable Exemple d'infolist avec deux tampons (tampon "core" weechat et le serveur -freenode) : +freenode) : .... # commande @@ -1752,7 +1752,7 @@ infolist buffer Un tableau est un type (3 octets) + nombre d'objets (entier sur 4 octets) + les données. -Exemple de tableau avec deux chaînes de caractères : +Exemple de tableau avec deux chaînes de caractères : .... ┌─────╥────┬────┬────┬────╥────┬────┬────┬────╥── @@ -1768,7 +1768,7 @@ Exemple de tableau avec deux chaînes de caractères : 'a' 'b' 'c' longueur 'd' 'e' .... -Exemple de tableau avec trois entiers : +Exemple de tableau avec trois entiers : .... ┌─────╥────┬────┬────┬────╥────┬────┬────┬────╥── @@ -1784,7 +1784,7 @@ Exemple de tableau avec trois entiers : 456 (0x1C8) 789 (0x315) .... -Un tableau _NULL_ : +Un tableau _NULL_ : .... ┌─────╥────┬────┬────┬────┐ diff --git a/doc/fr/weechat_scripting.fr.adoc b/doc/fr/weechat_scripting.fr.adoc index 6f7e314a8..088ffc7e1 100644 --- a/doc/fr/weechat_scripting.fr.adoc +++ b/doc/fr/weechat_scripting.fr.adoc @@ -12,7 +12,7 @@ Ce manuel documente le client de messagerie instantanée WeeChat, il fait partie de WeeChat. -La dernière version de ce document peut être téléchargée sur cette page : +La dernière version de ce document peut être téléchargée sur cette page : https://weechat.org/doc @@ -23,7 +23,7 @@ WeeChat (Wee Enhanced Environment for Chat) est un client de discussion libre, rapide et léger, conçu pour différents systèmes d'exploitation. Ce manuel documente la façon d'écrire des scripts pour WeeChat, en utilisant -l'un des langages de script supportés : +l'un des langages de script supportés : * python * perl @@ -61,7 +61,7 @@ l'API est la même pour les autres langages. * En raison d'une limitation de Ruby (15 paramètres maximum par fonction), la fonction `Weechat.config_new_option` reçoit les "callbacks" dans un tableau de 6 chaînes de caractères (3 callbacks + 3 chaînes de données), donc un appel à - cette fonction ressemble à ceci : + cette fonction ressemble à ceci : [source,ruby] ---- @@ -82,7 +82,7 @@ Weechat.config_new_option(config, section, "name", "string", "description of opt * Les fonctions sont appelées par `(weechat:xxx arg1 arg2 ...)`. * Les fonctions suivantes prennent une liste de paramètres en entrée (au lieu de plusieurs paramètres pour les autres fonctions), car le nombre de - paramètres excède la limite de Guile : + paramètres excède la limite de Guile : ** config_new_section ** config_new_option ** bar_new @@ -97,29 +97,29 @@ Weechat.config_new_option(config, section, "name", "string", "description of opt Tous les scripts WeeChat doivent s'enregistrer ("register") auprès de WeeChat, et cela doit être la première fonction WeeChat appelée dans le script. -Prototype : +Prototype : [source,python] ---- weechat.register(name, author, version, license, description, shutdown_function, charset) ---- -Paramètres : +Paramètres : -* _name_ : chaîne, nom interne du script -* _author_ : chaîne, nom de l'auteur -* _version_ : chaîne, version du script -* _license_ : chaîne, licence du script -* _description_ : chaîne, description courte du script -* _shutdown_function_ : chaîne, nom de la fonction appelée lorsque le script +* _name_ : chaîne, nom interne du script +* _author_ : chaîne, nom de l'auteur +* _version_ : chaîne, version du script +* _license_ : chaîne, licence du script +* _description_ : chaîne, description courte du script +* _shutdown_function_ : chaîne, nom de la fonction appelée lorsque le script est déchargé (peut être une chaîne vide) -* _charset_ : chaîne, jeu de caractères du script (si votre script est UTF-8, +* _charset_ : chaîne, jeu de caractères du script (si votre script est UTF-8, vous pouvez utiliser une valeur vide ici, car UTF-8 est le jeu de caractères par défaut) -Exemple, pour chaque langage : +Exemple, pour chaque langage : -* Python : +* Python : [source,python] ---- @@ -129,7 +129,7 @@ weechat.register("test_python", "FlashCode", "1.0", "GPL3", "Script de test", "" weechat.prnt("", "Bonjour, du script python !") ---- -* Perl : +* Perl : [source,perl] ---- @@ -137,7 +137,7 @@ weechat::register("test_perl", "FlashCode", "1.0", "GPL3", "Script de test", "", weechat::print("", "Bonjour, du script perl !"); ---- -* Ruby : +* Ruby : [source,ruby] ---- @@ -148,7 +148,7 @@ def weechat_init end ---- -* Lua : +* Lua : [source,lua] ---- @@ -156,7 +156,7 @@ weechat.register("test_lua", "FlashCode", "1.0", "GPL3", "Script de test", "", " weechat.print("", "Bonjour, du script lua !") ---- -* Tcl : +* Tcl : [source,tcl] ---- @@ -164,7 +164,7 @@ weechat::register "test_tcl" "FlashCode" "1.0" "GPL3" "Script de test" "" "" weechat::print "" "Bonjour, du script tcl !" ---- -* Guile (scheme) : +* Guile (scheme) : [source,lisp] ---- @@ -172,7 +172,7 @@ weechat::print "" "Bonjour, du script tcl !" (weechat:print "" "Bonjour, du script scheme !") ---- -* Javascript : +* Javascript : [source,javascript] ---- @@ -184,7 +184,7 @@ weechat.print("", "Bonjour, du script javascript !"); === Chargement du script Il est recommandé d'utiliser l'extension "script" pour charger les scripts, -par exemple : +par exemple : ---- /script load script.py @@ -196,7 +196,7 @@ par exemple : /script load script.js ---- -Chaque langage a également sa propre commande : +Chaque langage a également sa propre commande : ---- /python load script.py @@ -211,7 +211,7 @@ Chaque langage a également sa propre commande : Vous pouvez faire un lien dans le répertoire _langage/autoload_ pour charger automatiquement le script quand WeeChat démarre. -Par exemple en Python : +Par exemple en Python : ---- $ cd ~/.weechat/python/autoload @@ -227,15 +227,15 @@ dans le répertoire _autoload_ est automatiquement créé. L'API script est quasiment identique à l'API C. Vous pouvez consulter la _Référence API Extension WeeChat_ pour le détail de -chaque fonction de l'API : prototype, paramètres, valeurs de retour, exemples. +chaque fonction de l'API : prototype, paramètres, valeurs de retour, exemples. Il est important de bien faire la différence entre une _extension_ et un -_script_ : une _extension_ est un fichier binaire compilé et chargé avec la +_script_ : une _extension_ est un fichier binaire compilé et chargé avec la commande `/plugin`, tandis qu'un _script_ est un fichier texte chargé par une extension comme _python_ par la commande `/python`. Quand votre script _test.py_ appelle une fonction de l'API WeeChat, le chemin -est le suivant : +est le suivant : .... ┌──────────────────────┐ ╔══════════════════╗ @@ -246,7 +246,7 @@ test.py ─────► │ API script │ API C │ ─────► ║ .... Quand WeeChat appelle un "callback" dans votre script _test.py_, le chemin -est inversé : +est inversé : .... ╔══════════════════╗ ┌──────────────────────┐ @@ -272,7 +272,7 @@ convertira en pointeur réel avant d'appeler la fonction de l'API C. Une chaîne vide ou "0x0" sont autorisées, cela signifie le pointeur NULL en C. Par exemple, pour afficher un message sur le tampon core (tampon principal -WeeChat), vous pouvez faire : +WeeChat), vous pouvez faire : [source,python] ---- @@ -283,7 +283,7 @@ weechat.prnt("", "bonjour !") Dans beaucoup de fonctions, pour des raisons de vitesse, WeeChat ne vérifie pas si votre pointeur est correct ou pas. Il est de votre responsabilité de vérifier que vous donnez un pointeur valide, sinon vous pourriez voir un joli -rapport de crash ;) +rapport de crash ;) [[callbacks]] === Callbacks @@ -296,9 +296,9 @@ Les "callbacks" C utilisent un paramètre "data", qui est un pointeur. Dans l'API script, ce "data" est une chaîne de caractères avec n'importe quelle valeur (ce n'est pas un pointeur). -Exemple de callback, pour chaque langage : +Exemple de callback, pour chaque langage : -* Python : +* Python : [source,python] ---- @@ -309,7 +309,7 @@ def timer_cb(data, remaining_calls): weechat.hook_timer(1000, 0, 1, "timer_cb", "test") ---- -* Perl : +* Perl : [source,perl] ---- @@ -322,7 +322,7 @@ sub timer_cb { weechat::hook_timer(1000, 0, 1, "timer_cb", "test"); ---- -* Ruby : +* Ruby : [source,ruby] ---- @@ -334,7 +334,7 @@ end Weechat.hook_timer(1000, 0, 1, "timer_cb", "test"); ---- -* Lua : +* Lua : [source,lua] ---- @@ -346,7 +346,7 @@ end weechat.hook_timer(1000, 0, 1, "timer_cb", "test") ---- -* Tcl : +* Tcl : [source,tcl] ---- @@ -358,7 +358,7 @@ proc timer_cb { data remaining_calls } { weechat::hook_timer 1000 0 1 timer_cb test ---- -* Guile (scheme) : +* Guile (scheme) : [source,lisp] ---- @@ -370,7 +370,7 @@ weechat::hook_timer 1000 0 1 timer_cb test (weechat:hook_timer 1000 0 1 "timer_cb" "test") ---- -* Javascript : +* Javascript : [source,javascript] ---- @@ -391,7 +391,7 @@ _Référence API Extension WeeChat_. [[script_api_functions]] === Fonctions -Liste des fonctions de l'API script : +Liste des fonctions de l'API script : [width="75",cols="1,3",options="header"] |=== @@ -487,10 +487,10 @@ Liste des fonctions de l'API script : | affichage | prefix + color + - print (pour python : prnt) + - print_date_tags (pour python : + print (pour python : prnt) + + print_date_tags (pour python : prnt_date_tags) + - print_y (pour python : prnt_y) + + print_y (pour python : prnt_y) + log_print | hooks | @@ -627,7 +627,7 @@ Liste des fonctions de l'API script : [[script_api_constants]] === Constantes -Liste des constantes de l'API script : +Liste des constantes de l'API script : [width="75%",cols="1,3",options="header"] |=== @@ -706,7 +706,7 @@ Une chaîne vide est souvent utilisée pour travailler avec le tampon core WeeCh Pour les autres tampons, vous devez passer un pointeur (sous forme de chaîne, voir <<pointers,pointeurs>>). -Exemples : +Exemples : [source,python] ---- @@ -728,7 +728,7 @@ weechat.prnt("", "%smauvais paramètres" % weechat.prefix("error")) weechat.prnt("", "texte %sjaune sur bleu" % weechat.color("yellow,blue")) # chercher un tampon et afficher un message -# (le nom complet d'un tampon est extension.nom, par exemple : "irc.freenode.#weechat") +# (le nom complet d'un tampon est extension.nom, par exemple : "irc.freenode.#weechat") buffer = weechat.buffer_search("irc", "freenode.#weechat") weechat.prnt(buffer, "message sur le canal #weechat") @@ -748,7 +748,7 @@ Perl/Ruby/Lua/Tcl/Guile/Javascript et `prnt` en Python. Vous pouvez envoyer du texte ou une commande à un tampon. C'est exactement comme si vous tapiez le texte sur la ligne de commande et que vous pressiez [Enter]. -Exemples : +Exemples : [source,python] ---- @@ -766,11 +766,11 @@ weechat.command(buffer, "bonjour") Vous pouvez créer un nouveau tampon dans votre script, et l'utiliser pour afficher des messages. -Deux "callbacks" peuvent être appelés (ils sont optionnels) : un pour les données +Deux "callbacks" peuvent être appelés (ils sont optionnels) : un pour les données en entrée (quand vous tapez du texte et pressez [Enter] sur le tampon), l'autre est appelé lorsque le tampon est fermé (par exemple avec `/buffer close`). -Exemple : +Exemple : [source,python] ---- @@ -800,7 +800,7 @@ weechat.buffer_set(buffer, "localvar_set_no_log", "1") Vous pouvez lire des propriétés du tampon, sous forme de chaîne, entier ou pointeur. -Exemples : +Exemples : [source,python] ---- @@ -812,7 +812,7 @@ short_name = weechat.buffer_get_string(buffer, "short_name") ---- Il est possible d'ajouter, lire ou supprimer des variables locales dans le -tampon : +tampon : [source,python] ---- @@ -827,7 +827,7 @@ weechat.buffer_set(buffer, "localvar_del_myvar", "") ---- Pour voir les variables locales d'un tampon, exécutez cette commande dans -WeeChat : +WeeChat : ---- /buffer localvar @@ -842,7 +842,7 @@ WeeChat : Ajoutez une nouvelle commande avec `hook_command`. Vous pouvez utiliser une complétion personnalisée pour compléter les paramètres de votre commande. -Exemple : +Exemple : [source,python] ---- @@ -862,7 +862,7 @@ hook = weechat.hook_command("monfiltre", "description de mon filtre", "my_command_cb", "") ---- -Puis sous WeeChat : +Puis sous WeeChat : ---- /help monfiltre @@ -875,7 +875,7 @@ Puis sous WeeChat : Ajoutez un minuteur avec `hook_timer`. -Exemple : +Exemple : [source,python] ---- @@ -897,7 +897,7 @@ plusieurs fois. Pour le dernier appel à votre "callback", _rc_ est positionné à 0 ou une valeur positive, c'est le code retour de la commande. -Exemple : +Exemple : [source,python] ---- @@ -923,8 +923,8 @@ Pour télécharger une URL (ou poster vers une URL), vous devez utiliser la fonction `hook_process`, ou `hook_process_hashtable` si vous avez besoin d'options pour le transfert d'URL. -Exemple de transfert d'URL sans option : la page HTML sera reçue comme "out" -dans le "callback" (sortie standard du processus) : +Exemple de transfert d'URL sans option : la page HTML sera reçue comme "out" +dans le "callback" (sortie standard du processus) : [source,python] ---- @@ -936,7 +936,7 @@ def weechat_process_cb(data, command, rc, out, err): if out != "": weechat_version += out if int(rc) >= 0: - weechat.prnt("", "La version stable courante de WeeChat est : %s" % weechat_version) + weechat.prnt("", "La version stable courante de WeeChat est : %s" % weechat_version) return weechat.WEECHAT_RC_OK weechat.hook_process("url:https://weechat.org/dev/info/stable/", @@ -947,8 +947,8 @@ weechat.hook_process("url:https://weechat.org/dev/info/stable/", Toutes les infos disponibles à propos de WeeChat sont sur la page https://weechat.org/dev/info -Exemple de transfert d'URL avec une option : télécharger le dernier paquet de -développement WeeChat dans le fichier _/tmp/weechat-devel.tar.gz_ : +Exemple de transfert d'URL avec une option : télécharger le dernier paquet de +développement WeeChat dans le fichier _/tmp/weechat-devel.tar.gz_ : [source,python] ---- @@ -975,7 +975,7 @@ _Référence API Extension WeeChat_. La fonction `config_is_set_plugin` est utilisée pour vérifier si une option est définie ou pas, et `config_set_plugin` pour définir une option. -Exemple : +Exemple : [source,python] ---- @@ -995,7 +995,7 @@ for option, default_value in script_options.items(): Vous devez utiliser `hook_config` pour être notifié si l'utilisateur modifie certaines options du script. -Exemple : +Exemple : [source,python] ---- @@ -1025,19 +1025,19 @@ fonction du type de l'option, il faut appeler `config_string`, `config_boolean`, [source,python] ---- # chaîne -weechat.prnt("", "la valeur de l'option weechat.look.item_time_format est : %s" +weechat.prnt("", "la valeur de l'option weechat.look.item_time_format est : %s" % (weechat.config_string(weechat.config_get("weechat.look.item_time_format")))) # booléen -weechat.prnt("", "la valeur de l'option weechat.look.day_change est : %d" +weechat.prnt("", "la valeur de l'option weechat.look.day_change est : %d" % (weechat.config_boolean(weechat.config_get("weechat.look.day_change")))) # entier -weechat.prnt("", "la valeur de l'option weechat.look.scroll_page_percent est : %d" +weechat.prnt("", "la valeur de l'option weechat.look.scroll_page_percent est : %d" % (weechat.config_integer(weechat.config_get("weechat.look.scroll_page_percent")))) # couleur -weechat.prnt("", "la valeur de l'option weechat.color.chat_delimiters est : %s" +weechat.prnt("", "la valeur de l'option weechat.color.chat_delimiters est : %s" % (weechat.config_color(weechat.config_get("weechat.color.chat_delimiters")))) ---- @@ -1049,7 +1049,7 @@ weechat.prnt("", "la valeur de l'option weechat.color.chat_delimiters est : %s" L'extension IRC envoie deux signaux pour un message reçu (`xxx` est le nom interne du serveur IRC, `yyy` est le nom de la commande IRC comme JOIN, QUIT, -PRIVMSG, 301, ..) : +PRIVMSG, 301, ..) : xxxx,irc_in_yyy:: signal envoyé avant traitement du message @@ -1060,8 +1060,8 @@ xxx,irc_in2_yyy:: [source,python] ---- def join_cb(data, signal, signal_data): - # signal est par exemple : "freenode,irc_in2_join" - # signal_data est le message IRC, par exemple : ":nick!user@host JOIN :#canal" + # signal est par exemple : "freenode,irc_in2_join" + # signal_data est le message IRC, par exemple : ":nick!user@host JOIN :#canal" nick = weechat.info_get("irc_nick_from_host", signal_data) server = signal.split(",")[0] channel = signal_data.split(":")[-1] @@ -1104,8 +1104,8 @@ Vous pouvez analyser un message IRC avec l'info_hashtable appelée "irc_message_parse". Le résultat est une table de hachage avec les clés suivantes -(les exemples de valeurs sont construits avec ce message : -`@time=2015-06-27T16:40:35.000Z :nick!user@host PRIVMSG #weechat :hello!`) : +(les exemples de valeurs sont construits avec ce message : +`@time=2015-06-27T16:40:35.000Z :nick!user@host PRIVMSG #weechat :hello!`) : [width="100%",cols="1,^2,10,8",options="header"] |=== @@ -1193,7 +1193,7 @@ Le meilleur moyen de vérifier la version est de demander "version_number" et de faire une comparaison entre nombre entiers avec la version hexadécimale de la version. -Exemple : +Exemple : [source,python] ---- @@ -1209,7 +1209,7 @@ Les versions ≤ 0.3.1.1 retournent une chaîne vide pour _info_get("version_number")_, donc vous devez vérifier que la valeur de retour n'est *pas* vide. -Pour obtenir la version sous forme de chaîne : +Pour obtenir la version sous forme de chaîne : [source,python] ---- @@ -1222,8 +1222,8 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", "")) [source,python] ---- -# répertoire de WeeChat, par exemple : "/home/xxxx/.weechat" -weechat.prnt("", "Répertoire WeeChat : %s" % weechat.info_get("weechat_dir", "")) +# répertoire de WeeChat, par exemple : "/home/xxxx/.weechat" +weechat.prnt("", "Répertoire WeeChat : %s" % weechat.info_get("weechat_dir", "")) # inactivité clavier weechat.prnt("", "Inactivité depuis %s secondes" % weechat.info_get("inactivity", "")) @@ -1237,7 +1237,7 @@ weechat.prnt("", "Inactivité depuis %s secondes" % weechat.info_get("inactivity Vous pouvez lire une infolist construite par WeeChat ou d'autres extensions. -Exemple : +Exemple : [source,python] ---- diff --git a/doc/fr/weechat_tester.fr.adoc b/doc/fr/weechat_tester.fr.adoc index b0c7e6199..f426c9786 100644 --- a/doc/fr/weechat_tester.fr.adoc +++ b/doc/fr/weechat_tester.fr.adoc @@ -20,7 +20,7 @@ sont implémentées, elles doivent être testées, mais pour certaines fonctionnalités il y a trop de cas à tester et les développeurs ne peuvent pas tout tester. -Par exemple : l'extension charset introduite dans WeeChat WeeChat 0.2.2 : aucun +Par exemple : l'extension charset introduite dans WeeChat WeeChat 0.2.2 : aucun de nous (développeurs, contributeurs et testeurs) n'utilisait de canaux avec des caractères spéciaux dans leurs noms et quand la version 0.2.2 a été rendue disponible, nous avons reçu de nombreuses remontées d'utilisateurs russes. @@ -35,12 +35,12 @@ fonctionnalités (et à corriger des anciens bugs). [[prepare_system]] == Préparez votre système -Cela nous aiderait beaucoup si vous activiez les fichiers _core_ Linux : si +Cela nous aiderait beaucoup si vous activiez les fichiers _core_ Linux : si WeeChat se plante, Linux écrit un fichier _core_. Ce fichier contient des informations importantes pour le debug, pour savoir exactement où le problème se situe dans WeeChat). -Si vous utilisez le shell _bash_, ajoutez cette ligne dans votre _~/.bashrc_ : +Si vous utilisez le shell _bash_, ajoutez cette ligne dans votre _~/.bashrc_ : ---- ulimit -c unlimited @@ -53,7 +53,7 @@ ulimit -c unlimited Le code tout frais (avec les derniers bugs et fonctionnalités) est stocké dans GIT. -Vous pouvez décider de le construire manuellement (méthode recommandée) : +Vous pouvez décider de le construire manuellement (méthode recommandée) : * La version GIT peut être construite et installée en parallèle de la version stable, @@ -63,14 +63,14 @@ Vous pouvez décider de le construire manuellement (méthode recommandée) : [[get_sources]] === Obtenir et compiler les sources -Créez tout d'abord un répertoire, par exemple _weechat-git_ : +Créez tout d'abord un répertoire, par exemple _weechat-git_ : ---- $ mkdir ~/weechat-git $ cd ~/weechat-git ---- -Si vous avez git installé, vous pouvez cloner la base GIT (recommandé) : +Si vous avez git installé, vous pouvez cloner la base GIT (recommandé) : ---- $ git clone https://github.com/weechat/weechat.git @@ -81,7 +81,7 @@ $ cd weechat Plus tard, vous pourrez utiliser la commande `git pull` dans ce répertoire pour obtenir juste les deltas avec la version d'aujourd'hui. -Sinon vous pouvez installer le paquet _devel_ : +Sinon vous pouvez installer le paquet _devel_ : ---- $ wget https://weechat.org/files/src/weechat-devel.tar.bz2 @@ -89,7 +89,7 @@ $ tar xvjf weechat-devel.tar.bz2 $ cd weechat-devel ---- -Pour compiler les sources, cmake est recommandé : +Pour compiler les sources, cmake est recommandé : ---- $ mkdir build @@ -99,7 +99,7 @@ $ make $ make install ---- -Si vous n'avez pas cmake, il est toujours possible d'utiliser les autotools : +Si vous n'avez pas cmake, il est toujours possible d'utiliser les autotools : ---- $ ./autogen.sh @@ -111,12 +111,12 @@ $ make install [[install_binary_package]] === Obtenir un paquet binaire -Selon votre distribution Linux : +Selon votre distribution Linux : -* Debian : https://weechat.org/download/debian -* Gentoo : https://weechat.org/download -* ArchLinux : PKGBUILD depuis http://aur.archlinux.org/ -* autre : nous ne savons pas ! Eheh. +* Debian : https://weechat.org/download/debian +* Gentoo : https://weechat.org/download +* ArchLinux : PKGBUILD depuis http://aur.archlinux.org/ +* autre : nous ne savons pas ! Eheh. [[run]] @@ -125,14 +125,14 @@ Selon votre distribution Linux : Il est conseillé de lancer WeeChat avec un répertoire différent de la version stable, avec l'option `--dir`. -La commande est : +La commande est : ---- $ ~/weechat-git/bin/weechat ---- Si vous êtes encore éveillé, vous devriez voir une interface familière et -pouvoir vous vanter d'utiliser la version la plus récente possible de WeeChat ;) +pouvoir vous vanter d'utiliser la version la plus récente possible de WeeChat ;) Maintenant si vous obtenez un comportement étrange ou un plantage, n'hésitez pas à nous en avertir sur _#weechat_, serveur _chat.freenode.net_. diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc index e271e9fba..5d126e159 100644 --- a/doc/fr/weechat_user.fr.adoc +++ b/doc/fr/weechat_user.fr.adoc @@ -13,7 +13,7 @@ Ce manuel documente le client de messagerie instantanée WeeChat, il fait partie de WeeChat. -La dernière version de ce document peut être téléchargée sur cette page : +La dernière version de ce document peut être téléchargée sur cette page : https://weechat.org/doc @@ -26,7 +26,7 @@ rapide et léger, conçu pour différents systèmes d'exploitation. [[features]] === Fonctionnalités -Ses principales fonctionnalités sont les suivantes : +Ses principales fonctionnalités sont les suivantes : * multi-protocoles (principalement IRC) * connexion multi-serveurs (avec SSL, IPv6, proxy) @@ -42,12 +42,12 @@ Ses principales fonctionnalités sont les suivantes : * multi plates-formes (GNU/Linux, *BSD, MacOS X, Windows et d'autres systèmes) * 100% GPL, logiciel libre -La page d'accueil de WeeChat est ici : https://weechat.org/ +La page d'accueil de WeeChat est ici : https://weechat.org/ [[prerequisites]] === Prérequis -Pour installer WeeChat, vous devez avoir : +Pour installer WeeChat, vous devez avoir : * un système GNU/Linux (avec le compilateur et les outils associés pour le paquet des sources), ou un système compatible @@ -60,18 +60,18 @@ Pour installer WeeChat, vous devez avoir : [[binary_packages]] === Paquets binaires -Les paquets binaires sont disponibles pour beaucoup de distributions, dont : +Les paquets binaires sont disponibles pour beaucoup de distributions, dont : -* Arch Linux : `pacman -S weechat` -* Cygwin (Windows) : sélectionnez les paquets WeeChat dans setup.exe -* Debian (ou toute distribution compatible Debian) : +* Arch Linux : `pacman -S weechat` +* Cygwin (Windows) : sélectionnez les paquets WeeChat dans setup.exe +* Debian (ou toute distribution compatible Debian) : `apt-get install weechat-curses` -* Fedora Core : `dnf install weechat` -* Gentoo : `emerge weechat` -* Mandriva/RedHat (ou toute distribution compatible avec les RPM) : +* Fedora Core : `dnf install weechat` +* Gentoo : `emerge weechat` +* Mandriva/RedHat (ou toute distribution compatible avec les RPM) : `rpm -i /path/to/weechat-x.y.z-1.i386.rpm` -* openSUSE : `zypper in weechat` -* Sourcemage : `cast weechat` +* openSUSE : `zypper in weechat` +* Sourcemage : `cast weechat` Des paquets additionnels peuvent être utiles également, comme weechat-plugins. @@ -85,9 +85,9 @@ WeeChat peut être compilé avec cmake ou les autotools (cmake est la méthode recommandée). [NOTE] -Sous OS X, vous pouvez utiliser http://brew.sh/[Homebrew] : +Sous OS X, vous pouvez utiliser http://brew.sh/[Homebrew] : `brew install weechat --with-python --with-perl` -(pour l'aide : `brew info weechat`). +(pour l'aide : `brew info weechat`). [[dependencies]] ==== Dépendances @@ -136,7 +136,7 @@ avec la version 2.7, mais pas avec les versions ≤ 2.6 ou ≥ 3.0). [[compile_with_cmake]] ==== Compilation avec cmake -* Installation dans les répertoires systèmes (nécessite les droits _root_) : +* Installation dans les répertoires systèmes (nécessite les droits _root_) : ---- $ mkdir build @@ -146,7 +146,7 @@ $ make % make install (en root) ---- -* Installation dans un répertoire spécifique : +* Installation dans un répertoire spécifique : ---- $ mkdir build @@ -156,16 +156,16 @@ $ make $ make install ---- -Des options peuvent être utilisées pour cmake, avec le format : "-DOPTION=VALUE". +Des options peuvent être utilisées pour cmake, avec le format : "-DOPTION=VALUE". -Liste des options couramment utilisées : +Liste des options couramment utilisées : [width="100%",cols="2m,2,5m,12",options="header"] |=== | Option | Valeurs | Valeur par défaut | Description | CMAKE_BUILD_TYPE | `Debug`, `Release`, `RelWithDebInfo`, `MinSizeRel` | | - Type de construction : `Debug` (ou `RelWithDebInfo`) est recommandé si vous + Type de construction : `Debug` (ou `RelWithDebInfo`) est recommandé si vous utilisez une version de développement de WeeChat. | CMAKE_INSTALL_PREFIX | répertoire | /usr/local | @@ -268,13 +268,13 @@ Liste des options couramment utilisées : Compiler les tests. |=== -Les autres options peuvent être affichées avec cette commande : +Les autres options peuvent être affichées avec cette commande : ---- $ cmake -LA ---- -Ou avec l'interface Curses : +Ou avec l'interface Curses : ---- $ ccmake .. @@ -290,7 +290,7 @@ cmake. + La compilation avec les autotools requiert plus de dépendances et est plus lente qu'avec cmake. -* Installation dans les répertoires systèmes (nécessite les droits _root_) : +* Installation dans les répertoires systèmes (nécessite les droits _root_) : ---- $ ./autogen.sh @@ -301,7 +301,7 @@ $ make % make install (en root) ---- -* Installation dans un répertoire spécifique : +* Installation dans un répertoire spécifique : ---- $ ./autogen.sh @@ -313,7 +313,7 @@ $ make install ---- Des options peuvent être utilisées pour le script _configure_, elles peuvent -être affichées avec cette commande : +être affichées avec cette commande : ---- $ ./configure --help @@ -322,10 +322,10 @@ $ ./configure --help [[git_sources]] === Sources Git -Attention : les sources git sont réservés aux utilisateurs avancés : il se peut +Attention : les sources git sont réservés aux utilisateurs avancés : il se peut que WeeChat ne compile pas et qu'il soit très instable. Vous êtes prévenus ! -Pour récupérer les sources git, tapez cette commande : +Pour récupérer les sources git, tapez cette commande : ---- $ git clone https://github.com/weechat/weechat.git @@ -338,7 +338,7 @@ Suivez alors les instructions du paquet source (voir === Rapporter les plantages Si vous avez eu des plantages, ou si vous souhaitez rapporter tout plantage -futur de WeeChat, vous devez : +futur de WeeChat, vous devez : * Compiler avec les infos de debug (ou installer un paquet binaire avec les infos de debug). @@ -348,7 +348,7 @@ futur de WeeChat, vous devez : [[debug_info]] ==== Infos de debug -Si vous compilez avec cmake : +Si vous compilez avec cmake : ---- $ cmake .. -DCMAKE_BUILD_TYPE=Debug @@ -363,7 +363,7 @@ _weechat-dbg_. ==== Fichiers core Pour activer les fichiers _core_, vous pouvez utiliser l'option -<<option_weechat.startup.sys_rlimit,weechat.startup.sys_rlimit>> : +<<option_weechat.startup.sys_rlimit,weechat.startup.sys_rlimit>> : ---- /set weechat.startup.sys_rlimit "core:-1" @@ -373,13 +373,13 @@ Pour WeeChat ≤ 0.3.8 ou si vous voulez activer les fichiers core avant que WeeChat ne démarre, vous pouvez utiliser la commande `ulimit`. Par exemple sous Linux avec le shell _bash_, ajoutez cette ligne dans votre -`~/.bashrc` : +`~/.bashrc` : ---- ulimit -c unlimited ---- -Ou une taille maximum : +Ou une taille maximum : ---- ulimit -c 200000 @@ -394,14 +394,14 @@ Ce fichier est créé dans le répertoire où vous avez lancé WeeChat (ce n'est *pas* le répertoire où WeeChat est installé !). Par exemple si _weechat_ est installé dans _/usr/bin/_ et que le fichier -_core_ est dans _/home/xxx/_, alors lancez gdb avec cette commande : +_core_ est dans _/home/xxx/_, alors lancez gdb avec cette commande : ---- gdb /usr/bin/weechat /home/xxx/core ---- Puis sous gdb, utilisez la commande `bt full` pour afficher la trace. -Vous verrez quelque chose comme ceci : +Vous verrez quelque chose comme ceci : ---- (gdb) set logging file /tmp/crash.txt @@ -442,13 +442,13 @@ Merci pour votre aide ! Pour déboguer WeeChat qui tourne (par exemple si WeeChat semble bloqué), vous pouvez utiliser gdb avec l'identifiant du processus (remplacez _12345_ par le -PID du processus weechat) : +PID du processus weechat) : ---- gdb /usr/bin/weechat 12345 ---- -Ensuite comme pour un crash, utilisez la commande `bt full` : +Ensuite comme pour un crash, utilisez la commande `bt full` : ---- (gdb) bt full @@ -460,11 +460,11 @@ Ensuite comme pour un crash, utilisez la commande `bt full` : [[running_weechat]] === Lancer WeeChat -Paramètres de ligne de commande : +Paramètres de ligne de commande : include::cmdline_options.fr.adoc[] -Pour lancer WeeChat, tapez cette commande : +Pour lancer WeeChat, tapez cette commande : ---- $ weechat @@ -472,7 +472,7 @@ $ weechat Lorsque vous lancez WeeChat pour la première fois, un fichier de configuration par défaut est créé, avec les options par défaut. -Le fichier de configuration par défaut est : _~/.weechat/weechat.conf_. +Le fichier de configuration par défaut est : _~/.weechat/weechat.conf_. Vous pouvez éditer ce fichier pour configurer WeeChat à votre convenance ou vous pouvez modifier les paramètres dans WeeChat avec la commande `/set` @@ -484,7 +484,7 @@ vous pouvez modifier les paramètres dans WeeChat avec la commande `/set` WeeChat écrit ses fichiers de configuration et les autres données dans `~/.weechat` par défaut. -Les répertoires sont : +Les répertoires sont : [width="100%",cols="1m,3",options="header"] |=== @@ -511,12 +511,12 @@ Les répertoires sont : ^(1)^ Ce répertoire contient souvent seulement des liens symboliques vers les scripts dans le répertoire parent. -Les fichiers dans le répertoire principal sont : +Les fichiers dans le répertoire principal sont : [width="100%",cols="1m,3,6",options="header"] |=== | Fichier | Description | Données sensibles -| weechat.conf | Fichier de configuration principal de WeeChat | Possible (par exemple : liste des canaux sauvés dans la disposition des tampons). +| weechat.conf | Fichier de configuration principal de WeeChat | Possible (par exemple : liste des canaux sauvés dans la disposition des tampons). | sec.conf | Fichier de configuration avec les données sécurisées | *Oui, très sensibles*: ce fichier ne doit jamais être partagé avec quiconque. | plugins.conf | Fichier de configuration des extensions | Possible, cela dépend des extensions/scripts. | alias.conf | Fichier de configuration de l'extension _alias_ | Possible, cela dépend des alias. @@ -544,7 +544,7 @@ valeur et applique les changements immédiatement. [[screen_layout]] === Organisation de l'écran -Exemple de terminal avec WeeChat : +Exemple de terminal avec WeeChat : .... ▼ barre "title" @@ -573,20 +573,20 @@ Exemple de terminal avec WeeChat : ▲ barres "status" et "input" barre "nicklist" ▲ .... -L'écran est composé des zones suivantes : +L'écran est composé des zones suivantes : * zone de discussion (milieu de l'écran) avec les lignes de discussion, et - pour chaque ligne : + pour chaque ligne : ** heure ** préfixe (avant "|") ** message (après "|") -* barres autour de la zone de discussion, les barres par défaut sont : +* barres autour de la zone de discussion, les barres par défaut sont : ** barre _title_, au dessus de la zone de discussion ** barre _status_, sous la zone de discussion ** barre _input_, sous la barre de statut ** barre _nicklist_, sur la droite -La barre _status_ contient les objets (items) suivants par défaut : +La barre _status_ contient les objets (items) suivants par défaut : [width="100%",cols="^3,^4,10",options="header"] |=== @@ -599,26 +599,26 @@ La barre _status_ contient les objets (items) suivants par défaut : | buffer_modes | `+n` | Modes du canal IRC. | buffer_nicklist_count | `{4}` | Nombre de pseudos dans la liste des pseudos. | buffer_zoom | ! | `!` signifie que le tampon mélangé est zoomé, une valeur vide signifie que tous les tampons mélangés sont affichés. -| buffer_filter | `+*+` | Indicateur de filtrage : `+*+` signifie que des lignes sont filtrées (cachées), une valeur vide signifie que toutes les lignes sont affichées. +| buffer_filter | `+*+` | Indicateur de filtrage : `+*+` signifie que des lignes sont filtrées (cachées), une valeur vide signifie que toutes les lignes sont affichées. | scroll | `-PLUS(50)-` | Indicateur de scroll, avec le nombre de lignes sous la dernière ligne affichée. | lag | `[Lag: 2.5]` | Indicateur de "lag" (ralentissements réseau), en secondes (caché si le lag est faible). | hotlist | `[H: 4:#abc(2,5), 6]` | Liste des tampons où il y a de l'activité (messages non lus) (dans cet exemple, 2 highlights et 5 messages non lus sur _#abc_, un message non lu sur le tampon numéro 6). | completion | `abc(2) def(5)` | Liste des mots pour la complétion, avec le nombre de complétions possibles pour chaque mot. |=== -La barre _input_ contient les objets (items) suivants par défaut : +La barre _input_ contient les objets (items) suivants par défaut : [width="100%",cols="^3,^4,10",options="header"] |=== | Objet (item) | Exemple | Description -| input_prompt | `[@Flashy(i)]` | Prompt, pour irc : pseudo et modes (le mode "+i" signifie invisible sur freenode). +| input_prompt | `[@Flashy(i)]` | Prompt, pour irc : pseudo et modes (le mode "+i" signifie invisible sur freenode). | away | `(absent)` | Indicateur d'absence. -| input_search | `[Recherche (~ str,msg)]` | Indicateur de recherche de texte ("`~`" : insensible à la casse, "`==`" : sensible à la casse, "`str`" : recherche de chaîne, "`regex`" : recherche d'expression régulière, "`msg`" : recherche dans les messages, "`pre`" : recherche dans les préfixes, "`pre\|msg`" : recherche dans les préfixes et messages). +| input_search | `[Recherche (~ str,msg)]` | Indicateur de recherche de texte ("`~`" : insensible à la casse, "`==`" : sensible à la casse, "`str`" : recherche de chaîne, "`regex`" : recherche d'expression régulière, "`msg`" : recherche dans les messages, "`pre`" : recherche dans les préfixes, "`pre\|msg`" : recherche dans les préfixes et messages). | input_paste | `[Coller 7 lignes ? [ctrl-Y] Oui [ctrl-N] Non]` | Question à l'utilisateur pour coller des lignes. | input_text | `salut peter !` | Texte entré. |=== -Autres objets (non utilisés dans des barres par défaut) : +Autres objets (non utilisés dans des barres par défaut) : [width="100%",cols="^3,^4,10",options="header"] |=== @@ -643,21 +643,21 @@ des commandes ou d'envoyer du texte vers le tampon. ==== Syntaxe Les commandes débutent par un caractère "/", suivi du nom de la -commande. Par exemple pour afficher la liste de toutes les options : +commande. Par exemple pour afficher la liste de toutes les options : ---- /set ---- Le texte envoyé à un tampon est tout texte ne commençant pas par le -caractère "/", par exemple pour envoyer _bonjour_ sur le tampon courant : +caractère "/", par exemple pour envoyer _bonjour_ sur le tampon courant : ---- bonjour ---- Il est cependant possible de faire débuter un texte par "/" en le -doublant. Par exemple pour envoyer le texte `/set` sur le tampon courant : +doublant. Par exemple pour envoyer le texte `/set` sur le tampon courant : ---- //set @@ -668,7 +668,7 @@ doublant. Par exemple pour envoyer le texte `/set` sur le tampon courant : Pour certaines extensions comme IRC, il est possible d'utiliser des codes couleur et attributs comme suit (appuyer sur kbd:[Ctrl+c] puis sur la lettre qui -suit et éventuellement une valeur) : +suit et éventuellement une valeur) : [width="60%",cols="3,5",options="header"] |=== @@ -689,17 +689,17 @@ suit et éventuellement une valeur) : Le même code (sans le numéro pour kbd:[Ctrl+c], kbd:[c]) peut être utilisé pour stopper l'attribut défini. -Les codes couleur pour kbd:[Ctrl+c], kbd:[c] sont : +Les codes couleur pour kbd:[Ctrl+c], kbd:[c] sont : include::autogen/user/irc_colors.adoc[] [NOTE] Pour voir toutes les couleurs disponibles dans votre terminal, vous pouvez taper `/color` puis kbd:[Alt+c] dans WeeChat ou lancez cette commande dans le -terminal : `weechat --colors`. +terminal : `weechat --colors`. -Exemple : affichage de "bonjour tout le monde !" avec "bonjour" en bleu clair -gras, et "tout le monde" en rouge clair souligné : +Exemple : affichage de "bonjour tout le monde !" avec "bonjour" en bleu clair +gras, et "tout le monde" en rouge clair souligné : ---- ^Cc12^Cbbonjour ^Cb^Cc04^C_tout le monde^C_^Cc ! @@ -717,7 +717,7 @@ les barres et la zone de discussion (votre terminal doit supporter 256 couleurs pour pouvoir les utiliser dans WeeChat). Selon la valeur de la variable d'environnement _TERM_, vous pouvez avoir les -limites suivantes pour les couleurs dans WeeChat : +limites suivantes pour les couleurs dans WeeChat : [width="50%",cols="8,>2,>2",options="header"] |=== @@ -733,15 +733,15 @@ limites suivantes pour les couleurs dans WeeChat : Vous pouvez lancer `weechat --colors` ou utiliser la commande `/color` dans WeeChat pour afficher les limites de votre environnement. -Quelques valeurs recommandées pour _TERM_ si vous voulez 256 couleurs : +Quelques valeurs recommandées pour _TERM_ si vous voulez 256 couleurs : -* sous screen : _screen-256color_ -* sous tmux : _screen-256color_ ou _tmux-256color_ -* en dehors de screen/tmux : _xterm-256color_, _rxvt-256color_, +* sous screen : _screen-256color_ +* sous tmux : _screen-256color_ ou _tmux-256color_ +* en dehors de screen/tmux : _xterm-256color_, _rxvt-256color_, _putty-256color_, ... Si vous utilisez screen, vous pouvez ajouter cette ligne dans votre -_~/.screenrc_ : +_~/.screenrc_ : [NOTE] Vous devrez peut-être installer le paquet "ncurses-term" pour utiliser ces @@ -752,7 +752,7 @@ term screen-256color ---- Si votre variable _TERM_ a une valeur erronée et que WeeChat est déjà lancé, -vous pouvez la changer avec ces deux commandes : +vous pouvez la changer avec ces deux commandes : ---- /set env TERM screen-256color @@ -762,7 +762,7 @@ vous pouvez la changer avec ces deux commandes : [[colors_basic]] ==== Couleurs de base -Les couleurs de base dans WeeChat sont : +Les couleurs de base dans WeeChat sont : [width="50%",cols="^3m,8",options="header"] |=== @@ -800,13 +800,13 @@ touche kbd:[Alt+c], vous pouvez basculer temporairement vers les couleurs du terminal pour choisir une couleur. Par exemple si vous souhaitez afficher l'heure en orange dans le tampon, -faites : +faites : ---- /set weechat.color.chat_time 214 ---- -Ou si vous voulez un fond vert très foncé pour la barre de statut : +Ou si vous voulez un fond vert très foncé pour la barre de statut : ---- /set weechat.bar.status.color_bg 22 @@ -818,7 +818,7 @@ Ou si vous voulez un fond vert très foncé pour la barre de statut : Vous pouvez ajouter des alias de couleur avec la commande `/color alias` puis utiliser cet alias dans n'importe quelle option de couleur. -Par exemple : +Par exemple : ---- /color alias 214 orange @@ -829,22 +829,22 @@ Par exemple : ==== Attributs Il est possible d'utiliser des attributs pour les couleurs. Un ou plusieurs -attributs peuvent être ajoutés avant le nom ou le numéro de la couleur : +attributs peuvent être ajoutés avant le nom ou le numéro de la couleur : -* `+*+` : texte gras -* `+!+` : mode vidéo inverse -* `+/+` : italique -* `+_+` : texte souligné -* `+|+` : garder les attributs : ne pas réinitialiser gras/inverse/souligné lors +* `+*+` : texte gras +* `+!+` : mode vidéo inverse +* `+/+` : italique +* `+_+` : texte souligné +* `+|+` : garder les attributs : ne pas réinitialiser gras/inverse/souligné lors du changement de couleur -Par exemple si vous voulez votre pseudo en blanc souligné, faites : +Par exemple si vous voulez votre pseudo en blanc souligné, faites : ---- /set weechat.color.chat_nick_self _white ---- -Ou si vous voulez l'heure dans la barre de statut en orange souligné avec gras : +Ou si vous voulez l'heure dans la barre de statut en orange souligné avec gras : ---- /set weechat.color.status_time *_214 @@ -852,9 +852,9 @@ Ou si vous voulez l'heure dans la barre de statut en orange souligné avec gras Pour utiliser un attribut avec la couleur par défaut du terminal (-1), vous devez utiliser un nombre supérieur à la dernière couleur du terminal, par -exemple la couleur maximum de WeeChat : 99999. +exemple la couleur maximum de WeeChat : 99999. -Exemple de gras avec la couleur de texte du terminal : +Exemple de gras avec la couleur de texte du terminal : ---- /set weechat.color.status_time *99999 @@ -866,7 +866,7 @@ Exemple de gras avec la couleur de texte du terminal : Un tampon (_buffer_) est composé d'un numéro, un nom, des lignes affichées (ainsi que d'autres données). -Exemples de tampons : +Exemples de tampons : * tampon core (créé par WeeChat au démarrage, ne peut pas être fermé) * serveur irc (affiche les messages du serveur) @@ -880,7 +880,7 @@ fenêtres. Chaque fenêtre affiche un tampon. Un tampon peut être caché (affiché par aucune fenêtre) ou affiché par une ou plusieurs fenêtres. -Exemple de découpage horizontal (`/window splith`) : +Exemple de découpage horizontal (`/window splith`) : .... ▼ fenêtre n°2 (tampon n°4) @@ -912,7 +912,7 @@ Exemple de découpage horizontal (`/window splith`) : ▲ fenêtre n°1 (tampon n°3) .... -Exemple de découpage vertical (`/window splitv`) : +Exemple de découpage vertical (`/window splitv`) : .... ┌───────────────────────────────────────────────────────────────────────────┐ @@ -940,7 +940,7 @@ Exemple de découpage vertical (`/window splitv`) : ▲ fenêtre n°1 (tampon n°3) ▲ fenêtre n°2 (tampon n°4) .... -Exemple de découpage vertical + horizontal : +Exemple de découpage vertical + horizontal : .... ▼ fenêtre n°3 (tampon n°5) @@ -978,7 +978,7 @@ Exemple de découpage vertical + horizontal : [[lines_format]] ==== Format des lignes -Les lignes affichées dans les tampons formatés ont les champs suivants : +Les lignes affichées dans les tampons formatés ont les champs suivants : [width="100%",cols="2,2,10",options="header"] |=== @@ -987,8 +987,8 @@ Les lignes affichées dans les tampons formatés ont les champs suivants : | date/heure (print) | Non | Date/heure lorsque WeeChat affiche le message. | préfixe | Oui | Préfixe du message, couramment un pseudo. | message | Oui | Le message lui-même. -| affichée | Non | Booléen : vrai si la ligne est affichée, faux si la ligne est filtrée avec la commande <<command_weechat_filter,/filter>>. -| highlight | Non | Booléen : vrai si la ligne a un highlight, faux sinon. +| affichée | Non | Booléen : vrai si la ligne est affichée, faux si la ligne est filtrée avec la commande <<command_weechat_filter,/filter>>. +| highlight | Non | Booléen : vrai si la ligne a un highlight, faux sinon. | étiquettes | Avec `/debug tags` | Étiquettes associées avec la ligne (voir <<lines_tags,les étiquettes des lignes>>). |=== @@ -998,7 +998,7 @@ présentation (_pass:[weechat.look.*]_) et de couleur (_pass:[weechat.color.chat [[lines_tags]] ==== Étiquettes des lignes -WeeChat utilise des étiquettes (« tags ») dans les lignes pour différentes raisons : +WeeChat utilise des étiquettes (« tags ») dans les lignes pour différentes raisons : * highlight * niveau de notification @@ -1008,7 +1008,7 @@ WeeChat utilise des étiquettes (« tags ») dans les lignes pour différentes r Les étiquettes peuvent être affichées avec la commande `/debug tags` (même commande pour les cacher). -Les étiquettes couramment utilisées (liste non exhaustive) : +Les étiquettes couramment utilisées (liste non exhaustive) : [width="70%",cols="1m,4",options="header"] |=== @@ -1044,7 +1044,7 @@ texte. Les options de barre sont définies avec les options `weechat.bar.nom.option` où `nom` et le nom de la barre et `option` l'option pour cette barre. -Liste des options de barre : +Liste des options de barre : [width="100%",cols="2m,2,10",options="header"] |=== @@ -1061,19 +1061,19 @@ Liste des options de barre : _status_, _input_, _nicklist_) sont de type `window`. | position | `top`, `bottom`, `left`, `right` | - Position de la barre : au dessus/en dessous de la discussion, sur la + Position de la barre : au dessus/en dessous de la discussion, sur la gauche/droite. | priority | entier ≥ 0 | - Priorité de la barre : elle est utilisée pour ordonner les barres à l'écran, + Priorité de la barre : elle est utilisée pour ordonner les barres à l'écran, quand plusieurs barres utilisent le même type et position. + Les barres sont affichées depuis le bord de l'écran vers le centre. Une priorité plus haute affichera la barre au début, donc près du bord. + - Exemple : la barre _input_ a une priorité de 1000, donc elle est affichée + Exemple : la barre _input_ a une priorité de 1000, donc elle est affichée avant la barre _status_, qui a une priorité de 500. | size | entier ≥ 0 | - La taille de la barre : nombre de colonnes pour une position left/right, + La taille de la barre : nombre de colonnes pour une position left/right, nombre de lignes pour une position top/bottom. Une taille de `0` signifie automatique, donc la taille sera calculée en fonction du contenu affiché dans la barre. @@ -1093,8 +1093,8 @@ Liste des options de barre : | hidden | `on`, `off` | Lorsque l'option est `on`, la barre est cachée. + - Note : plutôt que de changer cette option, il est préférable d'utiliser la - commande `/bar`, par exemple : `/bar toggle nicklist` (voir la commande + Note : plutôt que de changer cette option, il est préférable d'utiliser la + commande `/bar`, par exemple : `/bar toggle nicklist` (voir la commande <<command_weechat_bar,/bar>>). | separator | `on`, `off` | @@ -1131,7 +1131,7 @@ de barre avec la couleur des délimiteurs définie dans la barre (option _color_delim_). Exemple de barre avec les objets -"[time],buffer_number+:+buffer_plugin+.+buffer_name" : +"[time],buffer_number+:+buffer_plugin+.+buffer_name" : .... ┌───────────────────────────────────────────────────────────────────────────┐ @@ -1140,15 +1140,15 @@ Exemple de barre avec les objets .... Une syntaxe spéciale peut être utilisée pour forcer le tampon utilisé lors de -l'affichage de l'objet de barre : "@tampon:objet" (où "tampon" est le nom +l'affichage de l'objet de barre : "@tampon:objet" (où "tampon" est le nom complet du tampon et "objet" est le nom d'un objet de barre). Ceci peut être pratique dans les barres "root", pour afficher un objet de barre pour un tampon qui n'est pas affiché dans la fenêtre courante (ou même pas affiché du tout). -Exemple : liste de pseudos de bitlbee dans une barre "root" (si la barre -s'appelle _bitlist_ et si le serveur bitlbee s'appelle _bitlbee_) : +Exemple : liste de pseudos de bitlbee dans une barre "root" (si la barre +s'appelle _bitlist_ et si le serveur bitlbee s'appelle _bitlbee_) : ---- /set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" @@ -1157,25 +1157,25 @@ s'appelle _bitlist_ et si le serveur bitlbee s'appelle _bitlbee_) : [[bar_filling]] ==== Remplissage -Il y a quatre types de remplissage : +Il y a quatre types de remplissage : -* `horizontal` : les objets sont affichés horizontalement, de gauche à droite. +* `horizontal` : les objets sont affichés horizontalement, de gauche à droite. S'il y a des retours à la ligne dans les objets, un espace est utilisé pour séparer les lignes. -* `vertical` : les objets sont affichés de haut en bas. S'il y a des retours à +* `vertical` : les objets sont affichés de haut en bas. S'il y a des retours à la ligne dans les objets, une nouvelle ligne est utilisée pour séparer les lignes. -* `columns_horizontal` : les objets sont affichés en utilisant des colonnes, où +* `columns_horizontal` : les objets sont affichés en utilisant des colonnes, où le texte est aligné à gauche. Le premier objet est en haut à gauche, le second est sur la même ligne, sur la droite. -* `columns_vertical` : les objets sont affichés en utilisant des colonnes, où +* `columns_vertical` : les objets sont affichés en utilisant des colonnes, où le texte est aligné à gauche. Le premier objet est en haut à gauche, le second est sur la ligne en dessous. Les barres par défaut _title_, _status_ et _input_ ont un remplissage _horizontal_, et la barre par défaut _nicklist_ a un remplissage _vertical_. -Quelques exemples de remplissage pour la barre _nicklist_ : +Quelques exemples de remplissage pour la barre _nicklist_ : .... ┌───────────────────────────────────────────────────────────────────────┐ @@ -1241,35 +1241,35 @@ Quelques exemples de remplissage pour la barre _nicklist_ : L'option _conditions_ est une chaîne qui est évaluée pour savoir si la barre doit être affichée ou non. -La chaîne peut être : +La chaîne peut être : -* _active_ : la fenêtre doit être active -* _inactive_ : la fenêtre doit être inactive -* _nicklist_ : le tampon affiché dans la fenêtre doit avoir une liste de pseudos -* une expression : elle est évaluée comme booléen (voir la commande +* _active_ : la fenêtre doit être active +* _inactive_ : la fenêtre doit être inactive +* _nicklist_ : le tampon affiché dans la fenêtre doit avoir une liste de pseudos +* une expression : elle est évaluée comme booléen (voir la commande <<command_weechat_eval,/eval>>) -Pour une expression, les variables suivantes sont disponibles : +Pour une expression, les variables suivantes sont disponibles : -* `+${active}+` : vrai si la fenêtre est active -* `+${inactive}+` : vrai si la fenêtre est inactive -* `+${nicklist}+` : vrai si le tampon affiché dans la fenêtre a une liste de +* `+${active}+` : vrai si la fenêtre est active +* `+${inactive}+` : vrai si la fenêtre est inactive +* `+${nicklist}+` : vrai si le tampon affiché dans la fenêtre a une liste de pseudos -Les pointeurs suivants sont disponibles : +Les pointeurs suivants sont disponibles : -* `+${window}+` : la fenêtre où la condition est évaluée -* `+${buffer}+` : le tampon de la fenêtre où la condition est évaluée +* `+${window}+` : la fenêtre où la condition est évaluée +* `+${buffer}+` : le tampon de la fenêtre où la condition est évaluée Exemple pour afficher la liste de pseudos dans tous les tampons possédant une -liste de pseudos, et seulement si la largeur de fenêtre est supérieurs à 100 : +liste de pseudos, et seulement si la largeur de fenêtre est supérieurs à 100 : ---- /set weechat.bar.nicklist.conditions "${nicklist} && ${window.win_width} > 100" ---- Même condition, mais afficher toujours la liste de pseudos sur le tampon -_&bitlbee_ (même si la fenêtre est petite) : +_&bitlbee_ (même si la fenêtre est petite) : ---- /set weechat.bar.nicklist.conditions "${nicklist} && (${window.win_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" @@ -1281,11 +1281,11 @@ _&bitlbee_ (même si la fenêtre est petite) : Un affichage spécial, appelé "dépouillé" (_bare display_) peut être utilisé pour un clic facile sur les URLs longs et la sélection de texte (avec la souris). -L'affichage dépouillé a les caractéristiques suivantes : +L'affichage dépouillé a les caractéristiques suivantes : -* Il n'affiche que le contenu du tampon courant : pas de découpage de fenêtres +* Il n'affiche que le contenu du tampon courant : pas de découpage de fenêtres ni de barre (pas de titre, liste de pseudos, statut, ligne de commande, ...). -* Le support souris de WeeChat est désactivé (s'il avait été activé) : vous +* Le support souris de WeeChat est désactivé (s'il avait été activé) : vous pouvez utiliser votre souris comme vous le faites dans le terminal pour cliquer sur les URLs et sélectionner du texte. * Ncurses n'est pas utilisé, par conséquent les URLs ne sont pas coupés en fin @@ -1302,7 +1302,7 @@ Le format de l'heure peut être personnalisé avec l'option L'affichage dépouillé peut être activé pour un temps donné en utilisant la commande <<command_weechat_window,/window>>. -Si WeeChat ressemble à ceci : +Si WeeChat ressemble à ceci : .... ┌───────────────────────────────────────────────────────────────────────────┐ @@ -1329,7 +1329,7 @@ Si WeeChat ressemble à ceci : └───────────────────────────────────────────────────────────────────────────┘ .... -L'écran ressemblera à ça en mode dépouillé : +L'écran ressemblera à ça en mode dépouillé : .... ┌───────────────────────────────────────────────────────────────────────────┐ @@ -1366,12 +1366,12 @@ entendu cela suppose que votre terminal permet le clic sur les URLs). ==== Configurer les niveaux de notification Quatre niveaux sont possibles dans les messages affichés dans les tampons, du -moins important au plus important : +moins important au plus important : -* _low_ : message avec faible importance (par exemple un join/part/quit irc) -* _message_ : message d'un utilisateur -* _private_ : message dans un tampon privé -* _highlight_ : message avec highlight +* _low_ : message avec faible importance (par exemple un join/part/quit irc) +* _message_ : message d'un utilisateur +* _private_ : message dans un tampon privé +* _highlight_ : message avec highlight Chaque tampon a un niveau de notification, qui est utilisé pour décider quels messages ajouteront le tampon dans la hotlist. @@ -1390,20 +1390,20 @@ la valeur par défaut est _all_. |=== Le niveau de notification peut être défini pour un ensemble de tampons, par -exemple tous les tampons du serveur irc "freenode" : +exemple tous les tampons du serveur irc "freenode" : ---- /set weechat.notify.irc.freenode message ---- -Définir le niveau de notification _highlight_ sur le canal "#weechat" seulement : +Définir le niveau de notification _highlight_ sur le canal "#weechat" seulement : ---- /set weechat.notify.irc.freenode.#weechat highlight ---- Le niveau de notification pour un tampon peut aussi être défini avec la -commande `/buffer` : +commande `/buffer` : ---- /buffer notify highlight @@ -1417,17 +1417,17 @@ par tampon ou groupe de tampons (comme des serveurs IRC). La propriété de tampon "hotlist_max_level_nicks" peut être définie avec une liste de pseudos et pour chaque pseudo le niveau maximal de hotlist à déclencher, -les niveaux possibles sont : +les niveaux possibles sont : -* -1 : pas de changement dans la hotlist pour ce pseudo -* 0 : faible priorité (comme les messages join/part) -* 1 : message -* 2 : message privé -* 3 : highlight (en réalité inutile, car il s'agit déjà du niveau maximal par +* -1 : pas de changement dans la hotlist pour ce pseudo +* 0 : faible priorité (comme les messages join/part) +* 1 : message +* 2 : message privé +* 3 : highlight (en réalité inutile, car il s'agit déjà du niveau maximal par défaut pour tous les messages) Par exemple pour désactiver les « highlights » de "joe" et "mike" sur le tampon -courant : +courant : ---- /buffer set hotlist_max_level_nicks_add joe:2,mike:2 @@ -1436,7 +1436,7 @@ courant : [NOTE] La propriété de tampon "hotlist_max_level_nicks" n'est pas sauvegardée dans la configuration. + -Vous pouvez facilement la sauvegarder avec le script _buffer_autoset.py_ : vous +Vous pouvez facilement la sauvegarder avec le script _buffer_autoset.py_ : vous pouvez l'installer avec `/script install buffer_autoset.py` et obtenir de l'aide avec `/help autosetbuffer`. @@ -1452,7 +1452,7 @@ contiennent votre pseudo, par conséquent le highlight dépend du tampon Vous pouvez ajouter d'autres mots à mettre en valeur avec l'option <<option_weechat.look.highlight,weechat.look.highlight>>, par exemple pour mettre -en valeur votre pseudo, "mot1", "mot2" et tous les mots commençants par "test" : +en valeur votre pseudo, "mot1", "mot2" et tous les mots commençants par "test" : ---- /set weechat.look.highlight mot1,mot2,test* @@ -1461,7 +1461,7 @@ en valeur votre pseudo, "mot1", "mot2" et tous les mots commençants par "test" Si vous avez besoin d'une règle plus spécifique pour un mot, vous pouvez utiliser des expressions régulières avec l'option <<option_weechat.look.highlight_regex,weechat.look.highlight_regex>>, -par exemple pour mettre en valeur les mots "flashcode", "flashcöde" et "flashy" : +par exemple pour mettre en valeur les mots "flashcode", "flashcöde" et "flashy" : ---- /set weechat.look.highlight_regex flashc[oö]de|flashy @@ -1484,7 +1484,7 @@ Les étiquettes sont séparées par des virgules, et plusieurs étiquettes peuve être séparées par "+" pour faire un "et" logique entre elles. Par exemple pour mettre en valeur tous les messages du pseudo "FlashCode" et -toutes les notices des pseudos commençant par "toto" : +toutes les notices des pseudos commençant par "toto" : ---- /set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" @@ -1497,7 +1497,7 @@ Vous pouvez forcer le highlight en utilisant une expression regulière avec la propriété de tampon "highlight_regex". Par exemple pour forcer le highlight sur tous les messages dans le canal -courant : +courant : ---- /buffer set highlight_regex .* @@ -1506,7 +1506,7 @@ courant : [NOTE] La propriété de tampon "highlight_regex" n'est pas sauvegardée dans la configuration. + -Vous pouvez facilement la sauvegarder avec le script _buffer_autoset.py_ : vous +Vous pouvez facilement la sauvegarder avec le script _buffer_autoset.py_ : vous pouvez l'installer avec `/script install buffer_autoset.py` et obtenir de l'aide avec `/help autosetbuffer`. @@ -1555,13 +1555,13 @@ avec `/help autosetbuffer`. | kbd:[Ctrl+y] | Coller le contenu du presse-papiers interne. | `/input clipboard_paste` | kbd:[Ctrl+_] | Défaire la dernière action sur la ligne de commande. | `/input undo` | kbd:[Alt+_] | Refaire la dernière action sur la ligne de commande. | `/input redo` -| kbd:[Tab] | Compléter la commande ou le pseudo (kbd:[Tab] de nouveau : trouver la complétion suivante). | `/input complete_next` +| kbd:[Tab] | Compléter la commande ou le pseudo (kbd:[Tab] de nouveau : trouver la complétion suivante). | `/input complete_next` | kbd:[Shift+Tab] | Sans complétion, effectue une complétion partielle. Avec une complétion en cours, complète avec la complétion précédente. | `/input complete_previous` | kbd:[Enter] + kbd:[Ctrl+j] + - kbd:[Ctrl+m] | Exécuter la commande ou envoyer le message (en mode recherche : arrêter la recherche). | `/input return` -| kbd:[↑] | Rappeler la commande précédente (en mode recherche : chercher plus haut). | `/input history_previous` -| kbd:[↓] | Rappeler la commande suivante (en mode recherche : chercher plus bas). | `/input history_next` + kbd:[Ctrl+m] | Exécuter la commande ou envoyer le message (en mode recherche : arrêter la recherche). | `/input return` +| kbd:[↑] | Rappeler la commande précédente (en mode recherche : chercher plus haut). | `/input history_previous` +| kbd:[↓] | Rappeler la commande suivante (en mode recherche : chercher plus bas). | `/input history_next` | kbd:[Ctrl+↑] | Rappeler la commande précédente dans l'historique global (commun à tous les tampons). | `/input history_global_previous` | kbd:[Ctrl+↓] | Rappeler la commande suivante dans l'historique global (commun à tous les tampons). | `/input history_global_next` | kbd:[Alt+d] | Effacer le mot suivant (la chaîne supprimée est copiée dans le presse-papiers interne). | `/input delete_next_word` @@ -1580,7 +1580,7 @@ avec `/help autosetbuffer`. | kbd:[Ctrl+s], kbd:[Ctrl+u] | Positionner le marqueur de données non lues sur tous les tampons. | `/input set_unread` | kbd:[Ctrl+x] | Changer de tampon courant si plusieurs tampons sont attachés avec le même numéro. | `/input switch_active_buffer` -| kbd:[Alt+x] | Zoomer sur le tampon mélangé (kbd:[Alt+x] de nouveau : afficher tous les tampons mélangés). | `/input zoom_merged_buffer` +| kbd:[Alt+x] | Zoomer sur le tampon mélangé (kbd:[Alt+x] de nouveau : afficher tous les tampons mélangés). | `/input zoom_merged_buffer` | kbd:[PgUp] | Monter d'une page dans l'historique du tampon. | `/window page_up` | kbd:[PgDn] | Descendre d'une page dans l'historique du tampon. | `/window page_down` | kbd:[Alt+PgUp] | Monter de quelques lignes dans l'historique du tampon. | `/window scroll_up` @@ -1603,7 +1603,7 @@ avec `/help autosetbuffer`. | kbd:[F12] | Descendre d'une page dans la liste des pseudos. | `/bar scroll nicklist * +100%` | kbd:[Alt+F11] | Aller au début de la liste des pseudos. | `/bar scroll nicklist * b` | kbd:[Alt+F12] | Aller à la fin de la liste des pseudos. | `/bar scroll nicklist * e` -| kbd:[Alt+a] | Sauter au prochain tampon avec activité (avec priorité : highlight, message, autre). | `/input jump_smart` +| kbd:[Alt+a] | Sauter au prochain tampon avec activité (avec priorité : highlight, message, autre). | `/input jump_smart` | kbd:[Alt+h] | Vider la hotlist (notification d'activité sur les autres tampons). | `/input hotlist_clear` | kbd:[Alt+j], kbd:[Alt+f] | Sauter au premier tampon. | `/buffer -` @@ -1633,7 +1633,7 @@ avec `/help autosetbuffer`. kbd:[Alt+b] | Équilibrer la taille de toutes les fenêtres. | `/window balance` | kbd:[Alt+w], kbd:[Alt+s] | Échanger les tampons de deux fenêtres. | `/window swap` -| kbd:[Alt+z] | Zoomer sur la fenêtre courante (kbd:[Alt+z] de nouveau : restaurer l'état initial des fenêtres, avant le zoom). | `/window zoom` +| kbd:[Alt+z] | Zoomer sur la fenêtre courante (kbd:[Alt+z] de nouveau : restaurer l'état initial des fenêtres, avant le zoom). | `/window zoom` | kbd:[Alt+<] | Sauter au tampon précédent dans la liste des tampons visités. | `/input jump_previously_visited_buffer` | kbd:[Alt+>] | Sauter au tampon suivant dans la liste des tampons visités. | `/input jump_next_visited_buffer` | kbd:[Alt+/] | Sauter au dernier tampon affiché (avant le dernier saut vers un tampon). | `/input jump_last_buffer_displayed` @@ -1650,9 +1650,9 @@ pressé pour chercher du texte dans le tampon). [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== | Touche | Description | Commande -| kbd:[Ctrl+r] | Basculer le type de recherche : chaîne (par défaut), expression régulière. | `/input search_switch_regex` +| kbd:[Ctrl+r] | Basculer le type de recherche : chaîne (par défaut), expression régulière. | `/input search_switch_regex` | kbd:[Alt+c] | Basculer la casse exacte pour la recherche. | `/input search_switch_case` -| kbd:[Tab] | Basculer la recherche dans : les messages (par défaut), les préfixes, les préfixes + messages. | `/input search_switch_where` +| kbd:[Tab] | Basculer la recherche dans : les messages (par défaut), les préfixes, les préfixes + messages. | `/input search_switch_where` | kbd:[↑] | Chercher la ligne précédente. | `/input search_previous` | kbd:[↓] | Chercher la ligne suivante. | `/input search_next` | kbd:[Enter] + @@ -1740,14 +1740,14 @@ terminal local, et à distance via une connexion ssh, avec ou sans screen/tmux. [[mouse_enable]] ==== Activer la souris -Pour activer la souris au démarrage : +Pour activer la souris au démarrage : ---- /set weechat.look.mouse on ---- Pour activer la souris maintenant, appuyez sur kbd:[Alt+m] ou lancez la commande -suivante : +suivante : ---- /mouse enable @@ -1755,7 +1755,7 @@ suivante : Il est possible de désactiver temporairement la souris, et associer ça à une touche. Par exemple la touche kbd:[Alt+%] pour désactiver la souris pendant 10 -secondes : +secondes : ---- /key bind meta-% /mouse toggle 10 @@ -1785,7 +1785,7 @@ utilisant le contexte "mouse" (pour la syntaxe voir la commande Un nom d'évènement consiste en un modificateur (facultatif), un bouton/roulette et un geste (facultatif). Les différents éléments sont séparés par "-". -Liste des modificateurs : +Liste des modificateurs : [width="50%",cols="3m,4",options="header"] |=== @@ -1795,7 +1795,7 @@ Liste des modificateurs : | ctrl-alt | Touches kbd:[Ctrl] + kbd:[Alt] |=== -Liste des boutons/roulette : +Liste des boutons/roulette : [width="50%",cols="3m,4",options="header"] |=== @@ -1808,7 +1808,7 @@ Liste des boutons/roulette : | wheeldown | Roulette (bas) |=== -Liste des gestes (seulement pour les boutons, pas la roulette) : +Liste des gestes (seulement pour les boutons, pas la roulette) : [width="50%",cols="3m,4",options="header"] |=== @@ -1824,7 +1824,7 @@ Liste des gestes (seulement pour les boutons, pas la roulette) : |=== Liste des évènements incomplets (seulement pour les boutons, pratique pour les -extensions/scripts) : +extensions/scripts) : [width="50%",cols="3m,4",options="header"] |=== @@ -1833,7 +1833,7 @@ extensions/scripts) : | event-drag | La souris a bougé avec le bouton pressé |=== -Exemples d'évènements : +Exemples d'évènements : * `button1` * `ctrl-button1` @@ -1887,18 +1887,18 @@ secrète (voir l'option [[secured_data_encryption]] ===== Chiffrement -Le chiffrement des données se fait en 3 étapes : +Le chiffrement des données se fait en 3 étapes : . Dériver une clé de la phrase secrète (avec du salage en option). . Calculer la somme de contrôle des données à chiffrer. -. Chiffrer la somme de contrôle + les données (la sortie est : sel + somme de +. Chiffrer la somme de contrôle + les données (la sortie est : sel + somme de contrôle et données chiffrées). [NOTE] Le mode de chiffrement par bloc est _CFB_. Le résultat est stocké sous forme d'une chaîne hexadécimale dans le fichier -_sec.conf_, par exemple : +_sec.conf_, par exemple : ---- [data] @@ -1909,7 +1909,7 @@ freenode = "53B1C86FCDA28FC122A95B0456ABD79B5AB74654F21C3D099A6CCA8173239EEA5953 [[secured_data_decryption]] ===== Déchiffrement -Le déchiffrement des données se fait en 3 étapes : +Le déchiffrement des données se fait en 3 étapes : . Dériver une clé en utilisant le sel et la phrase secrète. . Déchiffrer la somme de contrôle et les données. @@ -1920,7 +1920,7 @@ Le déchiffrement des données se fait en 3 étapes : ==== Gérer les données sécurisées Pour ajouter une donnée sécurisée, utilisez la commande `/secure set`, par -exemple un mot de passe pour le serveur IRC _freenode_ : +exemple un mot de passe pour le serveur IRC _freenode_ : ---- /secure set freenode motdepasse @@ -1928,20 +1928,20 @@ exemple un mot de passe pour le serveur IRC _freenode_ : Pour plus de confort, les données sécurisées peuvent être affichées dans un tampon dédié (touche kbd:[Alt+v] sur le tampon pour voir les valeurs), faites -simplement : +simplement : ---- /secure ---- Les données sécurisées peuvent être utilisées dans quelques options qui peuvent -contenir des données sensibles comme un mot de passe, en utilisant ce format : +contenir des données sensibles comme un mot de passe, en utilisant ce format : "${sec.data.xxx}" où "xxx" est le nom de la donnée sécurisée (utilisé dans la commande `/secure set xxx ...`). + Pour une liste complète des options supportées, voir `/help secure`. Pour utiliser le mot de passe _freenode_, par exemple avec -<<irc_sasl_authentication,l'authentification SASL>> : +<<irc_sasl_authentication,l'authentification SASL>> : ---- /set irc.server.freenode.sasl_password "${sec.data.freenode}" @@ -1953,7 +1953,7 @@ Pour utiliser le mot de passe _freenode_, par exemple avec [[sec_options]] ==== Options des données sécurisées (sec.conf) -Sections : +Sections : [width="100%",cols="3m,6m,16",options="header"] |=== @@ -1962,14 +1962,14 @@ Sections : | data | <<command_weechat_secure,/secure>> | Données sécurisées. |=== -Options : +Options : include::autogen/user/sec_options.adoc[] [[weechat_options]] ==== Options WeeChat (weechat.conf) -Sections : +Sections : [width="100%",cols="3m,6m,16",options="header"] |=== @@ -1997,7 +1997,7 @@ Sections : | key_mouse | <<command_weechat_key,/key>> | Touches pour le contexte "mouse". |=== -Options : +Options : include::autogen/user/weechat_options.adoc[] @@ -2018,7 +2018,7 @@ démarre, et il est possible de charger et décharger des extensions pendant que WeeChat tourne. Il est important de bien faire la différence entre une _extension_ et un -_script_ : une _extension_ est un fichier binaire compilé et chargé avec la +_script_ : une _extension_ est un fichier binaire compilé et chargé avec la commande `/plugin`, tandis qu'un _script_ est un fichier texte chargé par une extension comme _python_ par la commande `/python`. @@ -2027,7 +2027,7 @@ extension, ou afficher les extensions chargées. Quand une extension est déchargée, tous les tampons créés par cette extension sont automatiquement fermés. -Exemples pour charger, décharger et afficher les extensions : +Exemples pour charger, décharger et afficher les extensions : ---- /plugin load irc @@ -2035,7 +2035,7 @@ Exemples pour charger, décharger et afficher les extensions : /plugin list ---- -Les extensions par défaut sont : +Les extensions par défaut sont : [width="100%",cols="^1,5",options="header"] |=== @@ -2084,7 +2084,7 @@ Il est possible d'utiliser plusieurs langages par tampon. [[aspell_options]] ==== Options (aspell.conf) -Sections : +Sections : [width="100%",cols="3m,6m,16",options="header"] |=== @@ -2096,7 +2096,7 @@ Sections : | option | /set aspell.option.* | <<aspell_speller_options,Options du vérificateur d'orthographe>> (les options peuvent être ajoutées/supprimées dans la section). |=== -Options : +Options : include::autogen/user/aspell_options.adoc[] @@ -2112,13 +2112,13 @@ Les options du vérificateur d'orthographe peuvent être définies en ajoutant d options dans la section "option" de la configuration aspell. Le nom de l'option est une option de configuration aspell. La liste des options -peut être trouvée par la commande suivante sous le shell : +peut être trouvée par la commande suivante sous le shell : ---- $ aspell config ---- -Par exemple, pour activer l'option "ignore-case" : +Par exemple, pour activer l'option "ignore-case" : ---- /set aspell.option.ignore-case "true" @@ -2134,7 +2134,7 @@ Pour activer les suggestions, vous devez modifier l'option _aspell.check.suggestions_ avec un entier ≥ 0 et ajouter l'objet de barre "aspell_suggest" à une barre, par exemple _status_. -Exemple de suggestions avec un dictionnaire anglais (`en`) : +Exemple de suggestions avec un dictionnaire anglais (`en`) : .... │[12:55] [6] [irc/freenode] 3:#test(+n){4} [print,prone,prune] │ @@ -2142,7 +2142,7 @@ Exemple de suggestions avec un dictionnaire anglais (`en`) : └─────────────────────────────────────────────────────────────────────────────────┘ .... -Exemple de suggestions avec des dictionnaires anglais et français (`en,fr`) : +Exemple de suggestions avec des dictionnaires anglais et français (`en,fr`) : .... │[12:55] [6] [irc/freenode] 3:#test(+n){4} [print,prone,prune/prime,primer,primé] │ @@ -2159,17 +2159,17 @@ un jeu de caractères. Il y a un jeu de caractère par défaut pour le décodage/encodage, et un spécifique pour les tampons (ou groupes de tampons). -Cette extension est facultative, mais recommandée : si elle n'est pas chargée, +Cette extension est facultative, mais recommandée : si elle n'est pas chargée, WeeChat pourra uniquement lire/écrire des données UTF-8. L'extension Charset devrait être automatiquement chargée par WeeChat au -démarrage. Pour s'assurer que l'extension est bien chargée, essayez : +démarrage. Pour s'assurer que l'extension est bien chargée, essayez : ---- /charset ---- -Si la commande n'est pas trouvée, alors chargez l'extension avec la commande : +Si la commande n'est pas trouvée, alors chargez l'extension avec la commande : ---- /plugin load charset @@ -2183,16 +2183,16 @@ terminal et l'interne. Le jeu de caractères du terminal dépend de votre locale, et l'interne est UTF-8. -Par exemple : +Par exemple : .... -charset : terminal : ISO-8859-15, interne : UTF-8 +charset : terminal : ISO-8859-15, interne : UTF-8 .... [[charset_options]] ==== Options (charset.conf) -Sections : +Sections : [width="100%",cols="3m,6m,16",options="header"] |=== @@ -2204,7 +2204,7 @@ Sections : /set charset.encode.* | Jeu de caractère de décodage par tampon (les options peuvent être ajoutées/supprimées dans la section). |=== -Options : +Options : include::autogen/user/charset_options.adoc[] @@ -2219,7 +2219,7 @@ include::autogen/user/charset_commands.adoc[] Pour modifier les jeux de caractères de décodage et d'encodage globaux, utilisez la commande `/set`. -Par exemple : +Par exemple : ---- /set charset.default.decode ISO-8859-15 @@ -2239,13 +2239,13 @@ Pour modifier le jeu de caractères d'un serveur IRC, utilisez la commande Si vous donnez seulement le jeu de caractères, alors vous modifiez en même temps les valeurs de décodage et d'encodage. -Par exemple : +Par exemple : ---- /charset ISO-8859-15 ---- -Ce qui est équivalent à : +Ce qui est équivalent à : ---- /charset decode ISO-8859-15 @@ -2256,13 +2256,13 @@ Pour modifier le jeu de caractères d'un canal IRC (ou d'une conversation privée), utilisez la même commande que pour le serveur, mais sur le tampon du canal (ou du privé). -Pour définir le jeu de caractères pour tous les canaux/privés d'un serveur IRC : +Pour définir le jeu de caractères pour tous les canaux/privés d'un serveur IRC : ---- /set charset.encode.irc.freenode ISO-8859-15 ---- -Pour voir tous les jeux de caractères utilisés, utilisez la commande suivante : +Pour voir tous les jeux de caractères utilisés, utilisez la commande suivante : ---- /set charset.* @@ -2283,7 +2283,7 @@ d'afficher la sortie localement, ou de l'envoyer à un tampon. [[exec_options]] ==== Options (exec.conf) -Sections : +Sections : [width="100%",cols="3m,6m,16",options="header"] |=== @@ -2292,7 +2292,7 @@ Sections : | color | /set exec.color.* | Couleurs. |=== -Options : +Options : include::autogen/user/exec_options.adoc[] @@ -2312,35 +2312,35 @@ Le tube FIFO est dans le répertoire _~/.weechat/_ et s'appelle _weechat_fifo_ par défaut. La syntaxe pour envoyer des commandes ou du texte dans le tube FIFO est une -des suivantes : +des suivantes : .... plugin.buffer *texte ou commande ici *texte ou commande ici .... -Quelques exemples : +Quelques exemples : -* Changer le pseudo sur freenode en "autrepseudo" : +* Changer le pseudo sur freenode en "autrepseudo" : ---- $ echo 'irc.server.freenode */nick autrepseudo' >~/.weechat/weechat_fifo ---- -* Envoyer un message sur le canal IRC #weechat : +* Envoyer un message sur le canal IRC #weechat : ---- $ echo 'irc.freenode.#weechat *bonjour !' >~/.weechat/weechat_fifo ---- -* Envoyer un message sur le tampon courant : +* Envoyer un message sur le tampon courant : ---- $ echo '*bonjour !' >~/.weechat/weechat_fifo ---- * Envoyer deux commandes pour décharger/recharger les scripts Python (vous devez - les séparer par "\n") : + les séparer par "\n") : ---- $ printf '%b' '*/python unload\n*/python autoload\n' >~/.weechat/weechat_fifo @@ -2349,7 +2349,7 @@ $ printf '%b' '*/python unload\n*/python autoload\n' >~/.weechat/weechat_fifo [[fifo_options]] ==== Options (fifo.conf) -Sections : +Sections : [width="100%",cols="3m,6m,16",options="header"] |=== @@ -2357,7 +2357,7 @@ Sections : | file | /set fifo.file.* | Contrôle du tube FIFO. |=== -Options : +Options : include::autogen/user/fifo_options.adoc[] @@ -2379,14 +2379,14 @@ compris la discussion directe (DCC chat) et le transfert de fichier DCC [[irc_command_line_options]] ==== Options de ligne de commande -Il est possible de passer une URL pour un ou plusieurs serveurs, comme suit : +Il est possible de passer une URL pour un ou plusieurs serveurs, comme suit : ---- irc[6][s]://[pseudo[:mot_passe]@]irc.example.org[:port][/canal][,canal[...]] ---- Exemple pour rejoindre _#weechat_ et _#toto_ sur le serveur _chat.freenode.net_, -port par défaut (6667), avec le pseudo _nono_ : +port par défaut (6667), avec le pseudo _nono_ : ---- $ weechat irc://nono@chat.freenode.net/#weechat,#toto @@ -2395,7 +2395,7 @@ $ weechat irc://nono@chat.freenode.net/#weechat,#toto [[irc_options]] ==== Options (irc.conf) -Sections : +Sections : [width="100%",cols="3m,6m,16",options="header"] |=== @@ -2411,7 +2411,7 @@ Sections : /set irc.server.* | Serveurs. |=== -Options : +Options : include::autogen/user/irc_options.adoc[] @@ -2426,10 +2426,10 @@ include::autogen/user/irc_commands.adoc[] Lors de la connexion à un serveur IRC avec SSL, WeeChat vérifie par défaut que la connexion est entièrement de confiance. -Quelques options sont utilisées pour contrôler la connexion SSL : +Quelques options sont utilisées pour contrôler la connexion SSL : weechat.network.gnutls_ca_file:: - chemin vers le fichier avec les certificats de confiance (par défaut : + chemin vers le fichier avec les certificats de confiance (par défaut : "%h/ssl/CAs.pem") irc.server.xxx.ssl_cert:: @@ -2437,7 +2437,7 @@ irc.server.xxx.ssl_cert:: pseudo (par exemple CertFP sur oftc, voir ci-dessous) irc.server.xxx.ssl_dhkey_size:: - taille de clé utilisée pour l'échange de clé Diffie-Hellman (par défaut : + taille de clé utilisée pour l'échange de clé Diffie-Hellman (par défaut : 2048) irc.server.xxx.ssl_verify:: @@ -2450,9 +2450,9 @@ et peut échouer, même si cela pouvait être OK dans les versions inférieures 0.3.1. [[irc_connect_oftc_with_certificate]] -===== Premier exemple : se connecter à oftc en vérifiant le certificat +===== Premier exemple : se connecter à oftc en vérifiant le certificat -* Importer le certificat sous le shell : +* Importer le certificat sous le shell : ---- $ mkdir -p ~/.weechat/ssl @@ -2462,16 +2462,16 @@ $ wget -O ~/.weechat/ssl/CAs.pem http://www.spi-inc.org/ca/spi-cacert.crt [NOTE] Il est possible de concaténer plusieurs certificats dans le fichier CAs.pem. -* Sous WeeChat, avec le serveur "oftc" déjà ajouté : +* Sous WeeChat, avec le serveur "oftc" déjà ajouté : ---- /connect oftc ---- [[irc_connect_oftc_with_certfp]] -===== Second exemple : se connecter à oftc en utilisant CertFP +===== Second exemple : se connecter à oftc en utilisant CertFP -* Créer le certificat sous le shell : +* Créer le certificat sous le shell : ---- $ mkdir -p ~/.weechat/ssl @@ -2479,7 +2479,7 @@ $ cd ~/.weechat/ssl $ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem ---- -* Sous WeeChat, avec le serveur "oftc" déjà ajouté : +* Sous WeeChat, avec le serveur "oftc" déjà ajouté : ---- /set irc.server.oftc.ssl_cert "%h/ssl/nick.pem" @@ -2493,26 +2493,26 @@ Pour plus d'informations, consulter http://www.oftc.net/oftc/NickServ/CertFP ==== Authentification avec SASL WeeChat supporte l'authentification avec SASL, en utilisant différents -mécanismes : +mécanismes : -* _plain_ : mot de passe en clair (par défaut) -* _ecdsa-nist256p-challenge_ : challenge avec clé publique/privée -* _external_ : certificat SSL côté client -* _dh-blowfish_ : mot de passe chiffré avec blowfish (*non sûr*, non recommandé) -* _dh-aes_ : mot de passe chiffré avec AES (*non sûr*, non recommandé) +* _plain_ : mot de passe en clair (par défaut) +* _ecdsa-nist256p-challenge_ : challenge avec clé publique/privée +* _external_ : certificat SSL côté client +* _dh-blowfish_ : mot de passe chiffré avec blowfish (*non sûr*, non recommandé) +* _dh-aes_ : mot de passe chiffré avec AES (*non sûr*, non recommandé) [NOTE] La librairie "gcrypt" est requise lors de la compilation de WeeChat pour utiliser le mécanisme "dh-blowfish" (voir <<dependencies,les dépendances>>). -Les options dans le serveur sont : +Les options dans le serveur sont : -* _sasl_mechanism_ : mécanisme à utiliser (voir ci-dessus) -* _sasl_timeout_ : délai d'attente maximum (en secondes) pour l'authentification -* _sasl_fail_ : action à effectuer si l'authentification échoue -* _sasl_username_ : nom d'utilisateur (pseudo) -* _sasl_password_ : mot de passe -* _sasl_key_ : fichier avec la clé privée ECC (pour le mécanisme +* _sasl_mechanism_ : mécanisme à utiliser (voir ci-dessus) +* _sasl_timeout_ : délai d'attente maximum (en secondes) pour l'authentification +* _sasl_fail_ : action à effectuer si l'authentification échoue +* _sasl_username_ : nom d'utilisateur (pseudo) +* _sasl_password_ : mot de passe +* _sasl_key_ : fichier avec la clé privée ECC (pour le mécanisme _ecdsa-nist256p-challenge_) [[irc_sasl_ecdsa_nist256p_challenge]] @@ -2522,13 +2522,13 @@ Vous devez générer une clé privée pour vous authentifier avec le mécanisme ECDSA-NIST256P-CHALLENGE (aucun mot de passe n'est requis lors de la connexion). -Vous pouvez générer la clé avec cette commande : +Vous pouvez générer la clé avec cette commande : ---- $ openssl ecparam -genkey -name prime256v1 >~/.weechat/ecdsa.pem ---- -Récupérez la clé publique (encodée en base64) avec cette commande : +Récupérez la clé publique (encodée en base64) avec cette commande : ---- $ openssl ec -noout -text -conv_form compressed -in ~/.weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64 @@ -2536,7 +2536,7 @@ $ openssl ec -noout -text -conv_form compressed -in ~/.weechat/ecdsa.pem | grep Connectez-vous au serveur, identifiez vous (par exemple avec "nickserv identify") et définissez la clé publique dans votre compte, en -utilisant nickserv (remplacez la valeur base64 par votre clé publique) : +utilisant nickserv (remplacez la valeur base64 par votre clé publique) : ---- /connect freenode @@ -2544,7 +2544,7 @@ utilisant nickserv (remplacez la valeur base64 par votre clé publique) : /msg nickserv set pubkey Av8k1FOGetUDq7sPMBfufSIZ5c2I/QYWgiwHtNXkVe/q ---- -Configurez les options SASL dans le serveur : +Configurez les options SASL dans le serveur : ---- /set irc.server.freenode.sasl_mechanism ecdsa-nist256p-challenge @@ -2552,7 +2552,7 @@ Configurez les options SASL dans le serveur : /set irc.server.freenode.sasl_key "%h/ecdsa.pem" ---- -Reconnectez-vous au serveur : +Reconnectez-vous au serveur : ---- /reconnect freenode @@ -2565,45 +2565,45 @@ En plus du SSL, les serveurs Freenode supportent les connexions avec TOR (https://www.torproject.org/), un réseau de tunnels virtuels qui permet aux personnes et groupes d'améliorer leur vie privée et sécurité sur Internet. -En premier lieu, installez TOR. Pour Debian (et dérivés) : +En premier lieu, installez TOR. Pour Debian (et dérivés) : ---- $ sudo apt-get install tor ---- Sous WeeChat vous devez ajouter un proxy socks5 pour le service TOR (le nom/IP -et port dépend de votre configuration de TOR) : +et port dépend de votre configuration de TOR) : ---- /proxy add tor socks5 127.0.0.1 9050 ---- -Maintenant, ajoutez un nouveau serveur, par exemple : +Maintenant, ajoutez un nouveau serveur, par exemple : ---- /server add freenode-tor p4fsi4ockecnea7l.onion ---- -Définissez le proxy pour TOR : +Définissez le proxy pour TOR : ---- /set irc.server.freenode-tor.proxy "tor" ---- -Définissez l'authentification SASL : +Définissez l'authentification SASL : ---- /set irc.server.freenode-tor.sasl_username "votre_pseudo" /set irc.server.freenode-tor.sasl_password "votre_mot_de_passe" ---- -Et enfin, la connexion au serveur : +Et enfin, la connexion au serveur : ---- /connect freenode-tor ---- -Pour plus d'informations à propos de Freenode et TOR : +Pour plus d'informations à propos de Freenode et TOR : http://freenode.net/irc_servers.shtml#tor [[irc_smart_filter_join_part_quit]] @@ -2613,28 +2613,28 @@ Un filtre intelligent est disponible pour filtrer les messages join/part/quit lorsque le pseudo n'a rien dit durant les X dernières minutes sur le canal. Le filtre intelligent est activé par défaut, mais vous devez ajouter un filtre -pour cacher les lignes sur les tampons, par exemple : +pour cacher les lignes sur les tampons, par exemple : ---- /filter add irc_smart * irc_smart_filter * ---- Il est possible de créer un filtre pour un canal seulement ou plusieurs canaux -commençant par le même nom (voir `/help filter`) : +commençant par le même nom (voir `/help filter`) : ---- /filter add irc_smart_weechat irc.freenode.#weechat irc_smart_filter * /filter add irc_smart_weechats irc.freenode.#weechat* irc_smart_filter * ---- -Vous pouvez cacher seulement les join ou part/quit avec les options suivantes : +Vous pouvez cacher seulement les join ou part/quit avec les options suivantes : ---- /set irc.look.smart_filter_join on /set irc.look.smart_filter_quit on ---- -Vous pouvez modifier le délai (en minutes) : +Vous pouvez modifier le délai (en minutes) : ---- /set irc.look.smart_filter_delay 5 @@ -2650,41 +2650,41 @@ Il est possible de personnaliser les réponses CTCP, ou de bloquer certaines demandes CTCP (ne pas y répondre). Par exemple, pour personnaliser la réponse au CTCP "VERSION", utilisez la -commande suivante : +commande suivante : ---- /set irc.ctcp.version "Je suis sous WeeChat $version, ça déchire !" ---- Si vous voulez bloquer le CTCP "VERSION" (ne pas répondre à une demande), alors -affectez une chaîne vide : +affectez une chaîne vide : ---- /set irc.ctcp.version "" ---- Même un CTCP inconnu peut être personnalisé, par exemple vous pouvez répondre -au CTCP "BLABLA" : +au CTCP "BLABLA" : ---- /set irc.ctcp.blabla "C'est ma réponse au CTCP BLABLA" ---- Il est possible de personnaliser le CTCP pour un seul serveur, en utilisant son -nom interne avant le nom du CTCP : +nom interne avant le nom du CTCP : ---- /set irc.ctcp.freenode.version "WeeChat $version (pour freenode)" ---- -Si vous voulez restaurer la réponse CTCP standard, alors supprimez l'option : +Si vous voulez restaurer la réponse CTCP standard, alors supprimez l'option : ---- /unset irc.ctcp.version ---- Les codes suivants peuvent être utilisés dans les chaînes et sont -automatiquement remplacées par WeeChat lors de la réponse au CTCP : +automatiquement remplacées par WeeChat lors de la réponse au CTCP : [width="100%",cols="^2l,4,8",options="header"] |=== @@ -2707,7 +2707,7 @@ automatiquement remplacées par WeeChat lors de la réponse au CTCP : connue seulement si WeeChat a été compilé dans le dépôt git et si git était installé. -Si les options CTCP ne sont pas définies (par défaut), les réponses CTCP sont : +Si les options CTCP ne sont pas définies (par défaut), les réponses CTCP sont : [width="100%",cols="^2,4,8",options="header"] |=== @@ -2727,7 +2727,7 @@ Il est possible de personnaliser le tampon cible pour les messages IRC (le tampon utilisé pour afficher le message) avec les options `+irc.msgbuffer.*+`. Pour certains messages IRC (voir la liste ci-dessous), vous pouvez utiliser -la valeur : +la valeur : current:: tampon courant (si c'est un tampon IRC, sinon sur le tampon du serveur) @@ -2745,7 +2745,7 @@ weechat:: Lorsque l'option n'est pas définie (par défaut), WeeChat choisira le tampon approprié, généralement le tampon du serveur ou du canal. -Liste non exhaustive des messages ou alias que vous pouvez paramétrer : +Liste non exhaustive des messages ou alias que vous pouvez paramétrer : [width="60%",cols="^1m,^3m,8",options="header"] |=== @@ -2827,28 +2827,28 @@ Les autres messages numériques peuvent être paramétrés de la même manière. Le message peut être préfixé par le nom du serveur pour être spécifique à un serveur IRC (par exemple: `freenode.whois`). -Quelques exemples : +Quelques exemples : -* Afficher le résultat de `/whois` sur le tampon privé : +* Afficher le résultat de `/whois` sur le tampon privé : ---- /set irc.msgbuffer.whois private ---- -* Restaurer le tampon par défaut pour whois (tampon du serveur) : +* Restaurer le tampon par défaut pour whois (tampon du serveur) : ---- /unset irc.msgbuffer.whois ---- * Afficher une invitation sur le tampon courant, pour le serveur "freenode" -seulement : +seulement : ---- /set irc.msgbuffer.freenode.invite current ---- -* Afficher le message "303" (ison) sur le tampon "core" WeeChat : +* Afficher le message "303" (ison) sur le tampon "core" WeeChat : ---- /set irc.msgbuffer.303 weechat @@ -2863,7 +2863,7 @@ fichiers, avec des options sur comment et quoi sauvegarder. [[logger_options]] ==== Options (logger.conf) -Sections : +Sections : [width="100%",cols="3m,6m,16",options="header"] |=== @@ -2875,7 +2875,7 @@ Sections : | mask | /set logger.mask.* | Masque de nom de fichier par tampon (les options peuvent être ajoutées/supprimées dans la section). |=== -Options : +Options : include::autogen/user/logger_options.adoc[] @@ -2895,37 +2895,37 @@ Les niveaux possibles vont de 0 à 9. Zéro signifie "ne rien enregistrer" et 9 signifie "enregistrer tous les messages". Les extensions utilisent différent niveaux pour les messages affichés. -L'extension IRC utilise les niveaux suivants : +L'extension IRC utilise les niveaux suivants : -* niveau 1 : message d'un utilisateur (sur un canal ou en privé) -* niveau 2 : changement de pseudo (vous ou quelqu'un d'autre) -* niveau 3 : tout message du serveur (sauf join/part/quit) -* niveau 4 : message join/part/quit du serveur +* niveau 1 : message d'un utilisateur (sur un canal ou en privé) +* niveau 2 : changement de pseudo (vous ou quelqu'un d'autre) +* niveau 3 : tout message du serveur (sauf join/part/quit) +* niveau 4 : message join/part/quit du serveur Donc si vous affectez le niveau 3 pour un canal IRC, WeeChat enregistrera tous les messages sauf les join/part/quit. -Quelques exemples : +Quelques exemples : -* Affecter le niveau 3 pour le canal IRC #weechat : +* Affecter le niveau 3 pour le canal IRC #weechat : ---- /set logger.level.irc.freenode.#weechat 3 ---- -* Affecter le niveau 3 pour le tampon serveur freenode : +* Affecter le niveau 3 pour le tampon serveur freenode : ---- /set logger.level.irc.server.freenode 3 ---- -* Affecter le niveau 3 pour tous les canaux sur le serveur freenode : +* Affecter le niveau 3 pour tous les canaux sur le serveur freenode : ---- /set logger.level.irc.freenode 3 ---- -* Affecter le niveau 2 pour tous les tampons IRC : +* Affecter le niveau 2 pour tous les tampons IRC : ---- /set logger.level.irc 2 @@ -2936,14 +2936,14 @@ Quelques exemples : Il est possible de définir un masque de nom de fichier pour chaque tampon, et d'utiliser les variables locales du tampon pour construire le nom de fichier. -Pour voir les variables du tampon courant : +Pour voir les variables du tampon courant : ---- /buffer localvar ---- Par exemple, sur le tampon "irc.freenode.#weechat", WeeChat cherchera un masque -avec le nom de l'option, dans cet ordre : +avec le nom de l'option, dans cet ordre : ---- logger.mask.irc.freenode.#weechat @@ -2960,13 +2960,13 @@ serveurs IRC ("logger.mask.irc.freenode") ou pour une extension ===== Fichiers de log par date Pour avoir des fichiers de log par date, vous pouvez utiliser des marqueurs -dans le masque (voir `man strftime` pour le format), par exemple : +dans le masque (voir `man strftime` pour le format), par exemple : ---- /set logger.file.mask "%Y/%m/$plugin.$name.weechatlog" ---- -Vous obtiendrez les fichiers suivants : +Vous obtiendrez les fichiers suivants : .... ~/.weechat/ @@ -2984,13 +2984,13 @@ Vous obtiendrez les fichiers suivants : [[logger_irc_files_by_server_channel]] ===== Fichiers de log IRC par serveur et canal -Si vous voulez un répertoire par serveur IRC et un fichier par canal dedans : +Si vous voulez un répertoire par serveur IRC et un fichier par canal dedans : ---- /set logger.mask.irc "irc/$server/$channel.weechatlog" ---- -Vous obtiendrez les fichiers suivants : +Vous obtiendrez les fichiers suivants : .... ~/.weechat/ @@ -3010,17 +3010,17 @@ Vous obtiendrez les fichiers suivants : === Extension Relay L'extension Relay est utilisée pour relayer des données via le réseau, en -utilisant divers protocoles : +utilisant divers protocoles : -* _irc_ : proxy IRC : utilisé pour partager la connexions aux serveurs IRC avec +* _irc_ : proxy IRC : utilisé pour partager la connexions aux serveurs IRC avec un ou plusieurs autres clients IRC -* _weechat_ : protocole utilisé par les interfaces distantes (par exemple +* _weechat_ : protocole utilisé par les interfaces distantes (par exemple QWeeChat ou weechat-android). [[relay_options]] ==== Options (relay.conf) -Sections : +Sections : [width="100%",cols="3m,6m,16",options="header"] |=== @@ -3033,7 +3033,7 @@ Sections : /set relay.port.* | Ports utilisés pour le relai (protocoles irc et weechat) (les options peuvent être ajoutées/supprimées dans la section). |=== -Options : +Options : include::autogen/user/relay_options.adoc[] @@ -3046,7 +3046,7 @@ include::autogen/user/relay_commands.adoc[] ==== Mot de passe Il est fortement recommandé de définir un mot de passe pour le relai, avec la -commande : +commande : ---- /set relay.network.password "motdepasse" @@ -3063,7 +3063,7 @@ le préfixe "ssl." dans le nom du protocole. Le fichier par défaut pour le certificat/clé est _~/.weechat/ssl/relay.pem_ (option <<option_relay.network.ssl_cert_key,relay.network.ssl_cert_key>>). -Vous pouvez créer le certificat et la clé privée avec les commandes suivantes : +Vous pouvez créer le certificat et la clé privée avec les commandes suivantes : ---- $ mkdir -p ~/.weechat/ssl @@ -3072,7 +3072,7 @@ $ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out rel ---- Si WeeChat tourne déjà, vous pouvez recharger le certificat et clé privée avec la -commande : +commande : ---- /relay sslcertkey @@ -3081,7 +3081,7 @@ commande : [[relay_irc_proxy]] ==== IRC proxy -L'extension Relay peut agir comme un proxy IRC : elle simulera un serveur IRC, +L'extension Relay peut agir comme un proxy IRC : elle simulera un serveur IRC, et vous pourrez vous connecter sur WeeChat avec n'importe quel autre client IRC (y compris WeeChat lui-même). @@ -3089,19 +3089,19 @@ Vous pouvez définir un port par serveur IRC, ou bien un port générique pour t les serveurs. Lors de l'utilisation d'un port pour tous les serveurs, le client doit envoyer -le nom interne du serveur dans la commande IRC "PASS", avec le format : +le nom interne du serveur dans la commande IRC "PASS", avec le format : ---- PASS serveur:motdepasse ---- -Exemple : proxy IRC avec SSL pour tout serveur (le client choisira) : +Exemple : proxy IRC avec SSL pour tout serveur (le client choisira) : ---- /relay add ssl.irc 8000 ---- -Exemple : proxy IRC sans SSL seulement pour le serveur "freenode" : +Exemple : proxy IRC sans SSL seulement pour le serveur "freenode" : ---- /relay add irc.freenode 8000 @@ -3118,13 +3118,13 @@ L'extension Relay peut envoyer les données à une interface distante en utilisant le protocole WeeChat. Vous pouvez vous connecter avec une interface distante, voir la liste sur la -page de téléchargement : https://weechat.org/download +page de téléchargement : https://weechat.org/download [IMPORTANT] WeeChat lui-même ne peut PAS se connecter sur un autre WeeChat avec ce protocole. -Par exemple : +Par exemple : ---- /relay add weechat 9000 @@ -3145,7 +3145,7 @@ poignée de main et si l'origine est autorisée (voir l'option <<option_relay.network.websocket_allowed_origins,relay.network.websocket_allowed_origins>>). Un WebSocket peut être ouvert dans une page HTML5 avec une seule ligne de -JavaScript : +JavaScript : [source,js] ---- @@ -3159,7 +3159,7 @@ _weechat_). [[scripts_plugins]] === Extensions Scripts -WeeChat fournit 7 extensions pour scripts : Python, Perl, Ruby, Lua, Tcl, +WeeChat fournit 7 extensions pour scripts : Python, Perl, Ruby, Lua, Tcl, Guile (scheme) et Javascript. Ces extensions peuvent charger, exécuter et décharger des scripts pour ces langages. @@ -3167,7 +3167,7 @@ langages. Une autre extension appelée "script" est un gestionnaire de scripts et est utilisé pour charger/décharger des scripts pour n'importe quel langage, et installer/supprimer des scripts du dépôt WeeChat, qui sont visibles à cette -URL : https://weechat.org/scripts +URL : https://weechat.org/scripts Pour plus d'informations sur comment écrire des scripts, ou sur l'API WeeChat pour les scripts, merci de lire le _Le Guide pour Scripts WeeChat_. @@ -3175,7 +3175,7 @@ WeeChat pour les scripts, merci de lire le _Le Guide pour Scripts WeeChat_. [[script_options]] ==== Options Script (script.conf) -Sections : +Sections : [width="100%",cols="3m,6m,16",options="header"] |=== @@ -3185,7 +3185,7 @@ Sections : | scripts | /set script.scripts.* | Options pour le téléchargement des scripts. |=== -Options : +Options : include::autogen/user/script_options.adoc[] @@ -3232,7 +3232,7 @@ include::autogen/user/javascript_commands.adoc[] [[trigger_plugin]] === Extension Trigger -Trigger est le couteau suisse de WeeChat : il peut accrocher différentes choses +Trigger est le couteau suisse de WeeChat : il peut accrocher différentes choses (signal, modificateur, print, ...), changer le contenu des données, et exécuter une ou plusieurs commandes. Une condition peut être utilisée pour empêcher le trigger de s'exécuter dans certaines circonstances. @@ -3244,7 +3244,7 @@ dans la _Référence API Extension WeeChat_. [[trigger_options]] ==== Options (trigger.conf) -Sections : +Sections : [width="100%",cols="3m,6m,16",options="header"] |=== @@ -3256,7 +3256,7 @@ Sections : /set trigger.trigger.* | Options des triggers. |=== -Options : +Options : include::autogen/user/trigger_options.adoc[] @@ -3269,7 +3269,7 @@ include::autogen/user/trigger_commands.adoc[] ==== Anatomie d'un trigger Un trigger a les options suivantes (les noms sont -`trigger.trigger.<nom>.<option>`) : +`trigger.trigger.<nom>.<option>`) : [width="100%",cols="2m,2,10",options="header"] |=== @@ -3288,7 +3288,7 @@ Un trigger a les options suivantes (les noms sont Les paramètres pour le "hook", ils dépendent du type de hook utilisé. | conditions | chaîne | - Conditions pour exécuter le trigger : elles sont évaluées (voir la commande + Conditions pour exécuter le trigger : elles sont évaluées (voir la commande <<command_weechat_eval,/eval>>). | regex | chaîne | @@ -3311,7 +3311,7 @@ Un trigger a les options suivantes (les noms sont rarement utilisées). |=== -Par exemple, le trigger _beep_ par défaut a les options suivantes : +Par exemple, le trigger _beep_ par défaut a les options suivantes : ---- trigger.trigger.beep.enabled = on @@ -3329,9 +3329,9 @@ trigger.trigger.beep.post_action = none Lorsque le callback d'un trigger est appelé, les actions suivantes sont exécutées, dans cet ordre, si les triggers sont globalement activés et si le -trigger lui-même est activé : +trigger lui-même est activé : -. vérifier les conditions du trigger : si faux, sortir +. vérifier les conditions du trigger : si faux, sortir . remplacer du texte dans le trigger en utilisant des expressions régulières . exécuter la/les commande(s) . sortir avec un code retour (sauf pour les "hooks" _modifier_ et _focus_) @@ -3395,8 +3395,8 @@ points-virgules. | timer | 1. intervalle, en millisecondes (obligatoire) + - 2. alignement sur la seconde (par défaut : 0) + - 3. nombre maximum d'appels (par défaut : 0, qui signifie "sans fin") | + 2. alignement sur la seconde (par défaut : 0) + + 3. nombre maximum d'appels (par défaut : 0, qui signifie "sans fin") | `+3600000+` + `+60000;0;5+` @@ -3423,8 +3423,8 @@ Elles sont évaluées, et les données disponibles dans le callback peuvent êtr utilisées (voir <<trigger_callback_data,données dans les callbacks>> et la commande <<command_weechat_eval,/eval>>). -Exemple : le trigger _beep_ par défaut utilise cette condition pour faire un -beep seulement sur un highlight ou un message privé : +Exemple : le trigger _beep_ par défaut utilise cette condition pour faire un +beep seulement sur un highlight ou un message privé : ---- ${tg_highlight} || ${tg_msg_pv} @@ -3436,10 +3436,10 @@ ${tg_highlight} || ${tg_msg_pv} L'expression régulière est utilisée pour modifier des variables dans la table de hachage du callback. -Le format est : "/regex/remplacement" ou "/regex/remplacement/var" (où _var_ est +Le format est : "/regex/remplacement" ou "/regex/remplacement/var" (où _var_ est une variable de la table de hachage). + Si _var_ n'est pas spécifiée, la variable par défaut est utilisée, elle dépend -du type de hook : +du type de hook : [width="50%",cols="4,5m",options="header"] |=== @@ -3456,29 +3456,29 @@ du type de hook : |=== Plusieurs expressions régulières peuvent être séparées par un espace, par -exemple : "/regex1/remplacement1/var1 /regex2/remplacement2/var2". +exemple : "/regex1/remplacement1/var1 /regex2/remplacement2/var2". Le caractère "/" peut être remplacé par tout caractère (un ou plusieurs caractères identiques). -Les groupes de correspondance peuvent être utilisés dans le "remplacement" : +Les groupes de correspondance peuvent être utilisés dans le "remplacement" : -* `+${re:0}+` à `+${re:99}+` : `+${re:0}+` est la correspondance complète, `+${re:1}+` +* `+${re:0}+` à `+${re:99}+` : `+${re:0}+` est la correspondance complète, `+${re:1}+` à `+${re:99}+` sont les groupes capturés -* `+${re:+}+` : la dernière correspondance (avec le numéro le plus élevé) -* `+${hide:c,${re:N}}+` : la correspondance "N" avec tous les caractères - remplacés par "c" (exemple : `+${hide:*,${re:2}}+` est le groupe n°2 avec tous +* `+${re:+}+` : la dernière correspondance (avec le numéro le plus élevé) +* `+${hide:c,${re:N}}+` : la correspondance "N" avec tous les caractères + remplacés par "c" (exemple : `+${hide:*,${re:2}}+` est le groupe n°2 avec tous les caractères remplacés par `+*+`). -Exemple : utiliser du gras pour les mots entre "*" : +Exemple : utiliser du gras pour les mots entre "*" : ---- /\*(\S+)\*/*${color:bold}${re:1}${color:-bold}*/ ---- -Exemple : le trigger par défaut _server_pass_ utilise cette expression régulière +Exemple : le trigger par défaut _server_pass_ utilise cette expression régulière pour cacher le mot de passe dans les commandes `/server` et `/connect` (les -caractères des mots de passe sont remplacés par `+*+`) : +caractères des mots de passe sont remplacés par `+*+`) : ---- ==^(/(server|connect) .*-(sasl_)?password=)(\S+)(.*)==${re:1}${hide:*,${re:4}}${re:5} @@ -3498,8 +3498,8 @@ Plusieurs commandes peuvent être séparées par des points-virgules. Elle est évaluée (voir la commande <<command_weechat_eval,/eval>>) et le texte remplacé avec l'expression régulière peut être utilisé dans la commande. -Exemple : le trigger par défaut _beep_ utilise cette commande pour produire un -beep (BEL) : +Exemple : le trigger par défaut _beep_ utilise cette commande pour produire un +beep (BEL) : ---- /print -beep @@ -3509,7 +3509,7 @@ beep (BEL) : ==== Données dans les callbacks Les données reçues dans les callbacks sont stockées dans des tables de hachage -(pointeurs et chaînes) et peuvent être utilisées dans les options suivantes : +(pointeurs et chaînes) et peuvent être utilisées dans les options suivantes : * _conditions_ * _regex_ @@ -3518,7 +3518,7 @@ Les données reçues dans les callbacks sont stockées dans des tables de hachag Le contenu des tables de hachage dépend du type de hook. Une manière pratique de voir les données dans le trigger est d'ouvrir le tampon -moniteur des triggers : +moniteur des triggers : ---- /trigger monitor @@ -3527,7 +3527,7 @@ moniteur des triggers : [[trigger_data_signal]] ===== Signal -Le callback "signal" définit les variables suivantes dans la table de hachage : +Le callback "signal" définit les variables suivantes dans la table de hachage : [width="100%",cols="3m,2,14",options="header"] |=== @@ -3537,17 +3537,17 @@ Le callback "signal" définit les variables suivantes dans la table de hachage : |=== Si le signal contient un message IRC, le message est analysé et les données -suivantes sont ajoutées dans la table de hachage : +suivantes sont ajoutées dans la table de hachage : [width="100%",cols="3m,2,14",options="header"] |=== | Variable | Type | Description -| server | chaîne | Nom du serveur (exemple : "freenode"). +| server | chaîne | Nom du serveur (exemple : "freenode"). | tags | chaîne | Étiquettes dans le message (rarement utilisées). | message_without_tags | chaîne | Message sans les étiquettes. | nick | chaîne | Pseudo. | host | chaîne | Nom d'hôte. -| command | chaîne | Commande IRC (exemple : "PRIVMSG", "NOTICE", ...). +| command | chaîne | Commande IRC (exemple : "PRIVMSG", "NOTICE", ...). | channel | chaîne | Canal IRC. | arguments | chaîne | Paramètres de la commande (inclut la valeur de _channel_). | text | chaîne | Texte (par exemple message utilisateur). @@ -3559,7 +3559,7 @@ suivantes sont ajoutées dans la table de hachage : Lorsque la donnée est un pointeur, la variable `tg_signal_data` peut être utilisée comme ceci pour lire une propriété hdata (dans cet exemple il s'agit -d'un pointeur sur un tampon) : +d'un pointeur sur un tampon) : ---- ${buffer[${tg_signal_data}].full_name} @@ -3568,7 +3568,7 @@ ${buffer[${tg_signal_data}].full_name} [[trigger_data_hsignal]] ===== Hsignal -Le callback "hsignal" définit les variables suivantes dans la table de hachage : +Le callback "hsignal" définit les variables suivantes dans la table de hachage : [width="100%",cols="3m,2,14",options="header"] |=== @@ -3577,12 +3577,12 @@ Le callback "hsignal" définit les variables suivantes dans la table de hachage |=== La table de hachage contient toutes les clés/valeurs de la table de hachage -reçue (type : chaîne/chaîne). +reçue (type : chaîne/chaîne). [[trigger_data_modifier]] ===== Modifier -Le callback "modifier" définit les variables suivantes dans la table de hachage : +Le callback "modifier" définit les variables suivantes dans la table de hachage : [width="100%",cols="3m,2,14",options="header"] |=== @@ -3595,7 +3595,7 @@ Le callback "modifier" définit les variables suivantes dans la table de hachage Pour le modificateur _weechat_print_, les variables en utilisant les étiquettes du message sont ajoutées (voir le <<trigger_data_print,hook print>> ci-dessous), -ainsi que les variables suivantes : +ainsi que les variables suivantes : [width="100%",cols="3m,2,14",options="header"] |=== @@ -3616,13 +3616,13 @@ données supplémentaires sont ajoutées dans la table de hachage (voir le [[trigger_data_print]] ===== Print -Le callback "print" définit les variables suivantes dans la table de hachage : +Le callback "print" définit les variables suivantes dans la table de hachage : [width="100%",cols="3m,2,14",options="header"] |=== | Variable | Type | Description | buffer | pointeur | Tampon. -| tg_date | chaîne | Date/heure du message (format : `YYYY-MM-DD hh:mm:ss`). +| tg_date | chaîne | Date/heure du message (format : `YYYY-MM-DD hh:mm:ss`). | tg_displayed | chaîne | "1" si affiché, "0" si ligne filtrée. | tg_highlight | chaîne | "1" si highlight, sinon "0". | tg_prefix | chaîne | Préfixe. @@ -3632,7 +3632,7 @@ Le callback "print" définit les variables suivantes dans la table de hachage : |=== Variables définies avec les étiquettes du message (elles sont définies aussi -pour le modificateur _weechat_print_) : +pour le modificateur _weechat_print_) : [width="100%",cols="3m,2,14",options="header"] |=== @@ -3641,7 +3641,7 @@ pour le modificateur _weechat_print_) : | tg_tags_count | chaîne | Nombre d'étiquettes dans le message. | tg_tag_nick | chaîne | Pseudo (depuis l'étiquette "nick_xxx"). | tg_tag_prefix_nick | chaîne | Couleur du pseudo dans le préfixe (depuis l'étiquette "prefix_nick_ccc"). -| tg_tag_host | chaîne | Nom d'utilisateur et hôte, format : utilisateur@hôte (depuis l'étiquette "host_xxx"). +| tg_tag_host | chaîne | Nom d'utilisateur et hôte, format : utilisateur@hôte (depuis l'étiquette "host_xxx"). | tg_tag_notify | chaîne | Niveau de notification (_none_, _message_, _private_, _highlight_). | tg_notify | chaîne | Niveau de notification, si différent de _none_. | tg_msg_pv | chaîne | "1" pour un message privé, sinon "0". @@ -3650,7 +3650,7 @@ pour le modificateur _weechat_print_) : [[trigger_data_command]] ===== Command -Le callback "command" définit les variables suivantes dans la table de hachage : +Le callback "command" définit les variables suivantes dans la table de hachage : [width="100%",cols="3m,2,14",options="header"] |=== @@ -3664,7 +3664,7 @@ Le callback "command" définit les variables suivantes dans la table de hachage ===== Command_run Le callback "command_run" définit les variables suivantes dans la table de -hachage : +hachage : [width="100%",cols="3m,2,14",options="header"] |=== @@ -3676,19 +3676,19 @@ hachage : [[trigger_data_timer]] ===== Timer -Le callback "timer" définit les variables suivantes dans la table de hachage : +Le callback "timer" définit les variables suivantes dans la table de hachage : [width="100%",cols="3m,2,14",options="header"] |=== | Variable | Type | Description | tg_remaining_calls | chaîne | Nombre d'appels restants. -| tg_date | chaîne | Date/heure courante (format : `YYYY-MM-DD hh:mm:ss`). +| tg_date | chaîne | Date/heure courante (format : `YYYY-MM-DD hh:mm:ss`). |=== [[trigger_data_config]] ===== Config -Le callback "config" définit les variables suivantes dans la table de hachage : +Le callback "config" définit les variables suivantes dans la table de hachage : [width="100%",cols="3m,2,14",options="header"] |=== @@ -3700,7 +3700,7 @@ Le callback "config" définit les variables suivantes dans la table de hachage : [[trigger_data_focus]] ===== Focus -Le callback "focus" définit les variables suivantes dans la table de hachage : +Le callback "focus" définit les variables suivantes dans la table de hachage : [width="100%",cols="3m,2,14",options="header"] |=== @@ -3710,7 +3710,7 @@ Le callback "focus" définit les variables suivantes dans la table de hachage : |=== La table de hachage contient toutes les clés/valeurs de la table de hachage -reçue (type : chaîne/chaîne). +reçue (type : chaîne/chaîne). [[trigger_examples]] ==== Exemples @@ -3718,7 +3718,7 @@ reçue (type : chaîne/chaîne). [[trigger_example_url_color]] ===== Couleur pour les URLs -Afficher les URLs en vert : +Afficher les URLs en vert : ---- /trigger add url_color modifier weechat_print "${tg_notify}" "==\S+://\S+==${color:green}${re:0}${color:reset}==" @@ -3733,7 +3733,7 @@ régulière complexe. ===== Pong auto sur les requêtes ping Lorsque quelqu'un envoie un "ping" dans un tampon privé, le trigger répondra -automatiquement avec un `pong` : +automatiquement avec un `pong` : ---- /trigger add pong print "" "${type} == private && ${tg_message} == ping" "" "pong" @@ -3743,7 +3743,7 @@ automatiquement avec un `pong` : ===== Disposition réceptive Les triggers suivants peuvent être utilisées pour personnaliser l'affichage -lorsque la taille du terminal change : +lorsque la taille du terminal change : ---- /trigger add resize_small signal signal_sigwinch "${info:term_width} < 100" "" "/bar hide nicklist" @@ -3764,18 +3764,18 @@ Et la barre est restaurée lorsque la largeur du terminal est supérieure ou ===== Sauvegarde automatique de la configuration Vous pouvez sauvegarder automatiquement les fichiers de configuration -(`+*.conf+`), par example chaque heure : +(`+*.conf+`), par example chaque heure : ---- /trigger add cfgsave timer 3600000;0;0 "" "" "/mute /save" ---- -Les paramètres pour le minuteur sont : +Les paramètres pour le minuteur sont : -* _3600000_ : 3600 * 1000 millisecondes, le callback est appelé toutes les +* _3600000_ : 3600 * 1000 millisecondes, le callback est appelé toutes les heures -* _0_ : alignement sur la seconde (pas d'alignement ici) -* _0_ : nombre maximum d'appels (0 = pas de fin pour le minuteur) +* _0_ : alignement sur la seconde (pas d'alignement ici) +* _0_ : nombre maximum d'appels (0 = pas de fin pour le minuteur) La commande `/mute /save` sauvegarde silencieusement les fichiers de configuration (rien n'est affiché sur le tampon "core"). @@ -3783,7 +3783,7 @@ configuration (rien n'est affiché sur le tampon "core"). [[xfer_plugin]] === Extension Xfer -L'extension Xfer permet : +L'extension Xfer permet : * la discussion directe (entre deux machines, sans serveur), par exemple le "DCC Chat" via l'extension IRC @@ -3792,7 +3792,7 @@ L'extension Xfer permet : [[xfer_options]] ==== Options (xfer.conf) -Sections : +Sections : [width="100%",cols="3m,6m,16",options="header"] |=== @@ -3803,7 +3803,7 @@ Sections : | file | /set xfer.file.* | Options pour les fichiers envoyés/reçus. |=== -Options : +Options : include::autogen/user/xfer_options.adoc[] @@ -3818,12 +3818,12 @@ include::autogen/user/xfer_commands.adoc[] Avant de faire appel au support, merci de lire la documentation et la FAQ de WeeChat. -Pour le support via IRC, sur le serveur _chat.freenode.net_ : +Pour le support via IRC, sur le serveur _chat.freenode.net_ : -* canaux officiels (avec les développeurs) : +* canaux officiels (avec les développeurs) : ** _#weechat_ (Anglais) ** _#weechat-fr_ (Français) -* canaux non officiels : +* canaux non officiels : ** _#weechat-de_ (Allemand) -Pour les autres formes de support, voir : https://weechat.org/dev/support +Pour les autres formes de support, voir : https://weechat.org/dev/support diff --git a/doc/it/weechat_plugin_api.it.adoc b/doc/it/weechat_plugin_api.it.adoc index 681854471..9c72d35f4 100644 --- a/doc/it/weechat_plugin_api.it.adoc +++ b/doc/it/weechat_plugin_api.it.adoc @@ -15930,7 +15930,7 @@ Esempio in C: struct t_gui_lines *own_lines; struct t_gui_line *line; -struct t_gui_line_data *line_data; +struct t_gui_line_data *line_data; struct t_hdata *hdata; struct t_hashtable *hashtable; char str_date[64]; diff --git a/doc/ja/weechat_plugin_api.ja.adoc b/doc/ja/weechat_plugin_api.ja.adoc index 7a40ab6c9..f2556e4b7 100644 --- a/doc/ja/weechat_plugin_api.ja.adoc +++ b/doc/ja/weechat_plugin_api.ja.adoc @@ -15398,7 +15398,7 @@ C 言語での使用例: struct t_gui_lines *own_lines; struct t_gui_line *line; -struct t_gui_line_data *line_data; +struct t_gui_line_data *line_data; struct t_hdata *hdata; struct t_hashtable *hashtable; char str_date[64]; |