Add script prototypes and examples in plugin API reference

1 files changed, 2260 insertions, 347 deletions

diff --git a/doc/fr/weechat_plugin_api.fr.txt b/doc/fr/weechat_plugin_api.fr.txt
index 634fbd84d..537c7bc71 100644
--- a/doc/fr/weechat_plugin_api.fr.txt
+++ b/doc/fr/weechat_plugin_api.fr.txt
@@ -21,8 +21,8 @@ Ce manuel documente l'API WeeChat des extensions, utilisée par les extensions
 en C pour interagir avec le coeur de WeeChat.
 
 [[plugins_in_weechat]]
-Extensions dans in WeeChat
---------------------------
+Extensions dans WeeChat
+-----------------------
 
 Une extension est un programme C qui peut appeler des fonctions WeeChat
 définies dans une interface.
@@ -211,9 +211,22 @@ weechat_plugin_end (struct t_weechat_plugin *plugin)
 }
 ----------------------------------------
 
-[[c_plugin_api]]
-API extension C
----------------
+[[plugin_api]]
+API extension
+-------------
+
+Les chapîtres ci-dessous décrivent les fonctions de l'API, classées par
+catégorie.
+
+Pour chaque fonction, on donne :
+
+* une description de la fonction,
+* le prototype en C,
+* le détail des paramètres,
+* la valeur de retour,
+* un exemple en C,
+* un exemple en script Python (la syntaxe pour les autres langages de script est
+  similaire).
 
 [[plugins]]
 Extensions
@@ -242,13 +255,25 @@ Valeur de retour :
 * nom de l'extension, "core" pour le coeur de WeeChat (si le pointeur vers
   l'extension est NULL)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 const char *name = weechat_plugin_get_name (plugin);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+name = weechat.plugin_get_name(plugin)
+
+# exemple
+plugin = weechat.buffer_get_pointer(weechat.current_buffer(), "plugin")
+name = weechat.plugin_get_name(plugin)
+----------------------------------------
+
 [[strings]]
 Chaînes de caractères
 ~~~~~~~~~~~~~~~~~~~~~
@@ -275,13 +300,24 @@ Paramètres :
 
 * 'charset' : nouveau jeu de caractères à utiliser
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_charset_set (plugin, "iso-8859-1");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.charset_set(charset)
+
+# exemple
+weechat.charset_set("iso-8859-1")
+----------------------------------------
+
 weechat_iconv_to_internal
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -303,15 +339,26 @@ Valeur de retour :
 
 * chaîne convertie (doit être libérée par un appel à "free" après utilisation)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-char *str = weechat_iconv_to_internal (plugin, "iso-8859-1", "iso string : é à");
+char *str = weechat_iconv_to_internal (plugin, "iso-8859-1", "chaîne iso : é à");
 /* ... */
 free (str);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+str = weechat.iconv_to_internal(charset, string)
+
+# exemple
+str = weechat.iconv_to_internal("iso-8859-1", "chaîne iso : é à")
+----------------------------------------
+
 weechat_iconv_from_internal
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -333,15 +380,26 @@ Valeur de retour :
 
 * chaîne convertie (doit être libérée par un appel à "free" après utilisation)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-char *str = weechat_iconv_from_internal ("iso-8859-1", "utf-8 string : é à");
+char *str = weechat_iconv_from_internal ("iso-8859-1", "chaîne utf-8 : é à");
 /* ... */
 free (str);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+str = weechat.iconv_from_internal(charset, string)
+
+# exemple
+str = weechat.iconv_from_internal("iso-8859-1", "chaîne utf-8 : é à")
+----------------------------------------
+
 weechat_gettext
 ^^^^^^^^^^^^^^^
 
@@ -362,11 +420,22 @@ Valeur de retour :
 
 * chaîne traduite
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-char *str = weechat_gettext ("hello !");
+char *str = weechat_gettext ("hello");
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+str = weechat.gettext(string)
+
+# exemple
+str = weechat.gettext("hello")
 ----------------------------------------
 
 weechat_ngettext
@@ -394,13 +463,25 @@ Valeur de retour :
 
 * chaîne traduite
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 char *str = weechat_ngettext ("file", "files", num_files);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+str = weechat.ngettext(string, plural, count)
+
+# exemple
+num_files = 2
+str = weechat.ngettext("file", "files", num_files)
+----------------------------------------
+
 weechat_strndup
 ^^^^^^^^^^^^^^^
 
@@ -422,7 +503,7 @@ Valeur de retour :
 
 * chaîne dupliquée (doit être libérée par un appel à "free" après utilisation)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -447,7 +528,7 @@ Paramètres :
 
 * 'string' : chaîne à convertir
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -471,7 +552,7 @@ Paramètres :
 
 * 'string' : chaîne à convertir
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -503,7 +584,7 @@ Valeur de retour :
 ** zéro si string1 == string2
 ** positive si string1 > string2
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -539,7 +620,7 @@ Valeur de retour :
 ** zéro si string1 == string2
 ** positive si string1 > string2
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -567,7 +648,7 @@ Valeur de retour :
 
 * pointeur vers la chaîne trouvée, ou NULL si non trouvée
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -597,7 +678,7 @@ Valeur de retour :
 
 * 1 si la chaîne correspond au masque, sinon 0
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -631,7 +712,7 @@ Valeur de retour :
 * chaîne avec 'search' remplacée par 'replace' (doit être libérée par un appel
   à "free" après utilisation)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -663,7 +744,7 @@ Valeur de retour :
 * chaîne sans les apostrophes/guillemets au début et à la fin (doit être
   libérée par un appel à "free" après utilisation)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -698,7 +779,7 @@ Valeur de retour :
 * chaîne avec les caractères supprimés (doit être libérée par un appel à "free"
   après utilisation)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -730,7 +811,7 @@ Valeur de retour :
 
 * 1 si la chaîne a un ou plusieurs "highlights", sinon 0
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -760,7 +841,7 @@ Valeur de retour :
 * expression régulière, sous forme de chaîne (doit être libérée par un appel à
   "free" après utilisation)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -788,7 +869,7 @@ 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 argument contiendra toutes les
+* '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)
 * '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
@@ -840,7 +921,7 @@ Paramètres :
 
 * 'split_string' : chaîne découpée par <<_weechat_string_split>>
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -874,7 +955,7 @@ Valeur de retour :
 * chaîne construite avec la chaîne découpée (doit être libérée par un appel à
   "free" après utilisation)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -910,7 +991,7 @@ Valeur de retour :
 * tableau de chaînes, NULL en cas de problème (doit être libéré par un appel à
   <<_weechat_free_split_command>> après utilisation)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -937,7 +1018,7 @@ Paramètres :
 
 * 'split_command' : commande éclatée par <<_weechat_string_split_command>>
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1030,6 +1111,17 @@ char *str = weechat_string_remove_color (ma_chaine2, "?");
 free (str);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+str = weechat.string_remove_color(string, replacement)
+
+# exemple
+str = weechat.string_remove_color(ma_chaine, "?")
+----------------------------------------
+
 [[utf-8]]
 UTF-8
 ~~~~~
@@ -1057,7 +1149,7 @@ 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 :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1089,7 +1181,7 @@ Valeur de retour :
 
 * 1 si la chaîne UTF-8 est valide, sinon 0
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1122,7 +1214,7 @@ Paramètres :
 * 'string' : chaîne
 * 'replacement' : caractère de remplacement pour les caractères non valides
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1152,7 +1244,7 @@ Valeur de retour :
 * pointeur vers le caractère UTF-8 précédent, NULL si non trouvé (début de
   chaîne atteint)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1180,7 +1272,7 @@ Valeur de retour :
 * pointeur vers le caractère UTF-8 suivant, NULL si non trouvé (fin de la
   chaîne atteinte)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1207,7 +1299,7 @@ Valeur de retour :
 
 * taille du caractère UTF-8 (en octets)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1234,7 +1326,7 @@ Valeur de retour :
 
 * longueur de la chaîne UTF-8 (nombre de caractères UTF-8)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1263,7 +1355,7 @@ Valeur de retour :
 
 * longueur de la chaîne UTF-8 (nombre de caractères UTF-8)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1291,7 +1383,7 @@ Valeur de retour :
 
 * nombre de caractères nécessaires pour afficher la chaîne UTF-8 sur l'écran
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1322,7 +1414,7 @@ Valeur de retour :
 ** zéro si char1 == char2
 ** positive si char1 > char2
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1350,7 +1442,7 @@ Valeur de retour :
 
 * nombre de caractères nécessaires pour afficher le caractère UTF-8 sur l'écran
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1379,7 +1471,7 @@ 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)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1408,7 +1500,7 @@ Valeur de retour :
 
 * position réelle (en octets)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1436,7 +1528,7 @@ Valeur de retour :
 
 * position (en nombre de caractères)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1464,7 +1556,7 @@ Valeur de retour :
 
 * chaîne dupliquée (doit être libérée avec un appel à "free" après utilisation)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1500,16 +1592,27 @@ Valeur de retour :
 
 * 1 si le répertoire est créé, 0 en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-if (!weechat_mkdir_home ("temp"))
+if (!weechat_mkdir_home ("temp", 0755))
 {
     /* erreur */
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.mkdir_home(directory, mode)
+
+# exemple
+weechat.mkdir_home("temp", 0755)
+----------------------------------------
+
 weechat_mkdir
 ^^^^^^^^^^^^^
 
@@ -1531,16 +1634,27 @@ Valeur de retour :
 
 * 1 si le répertoire est créé, 0 en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-if (!weechat_mkdir ("/tmp/mydir"))
+if (!weechat_mkdir ("/tmp/mydir", 0755))
 {
     /* erreur */
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.mkdir(directory, mode)
+
+# exemple
+weechat.mkdir("/tmp/mydir", 0755)
+----------------------------------------
+
 weechat_mkdir_parents
 ^^^^^^^^^^^^^^^^^^^^^
 
@@ -1562,16 +1676,27 @@ Valeur de retour :
 
 * 1 si le répertoire est créé, 0 en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-if (!weechat_mkdir_parents ("/tmp/my/dir"))
+if (!weechat_mkdir_parents ("/tmp/my/dir", 0755))
 {
     /* erreur */
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.mkdir_parents(directory, mode)
+
+# exemple
+weechat.mkdir_parents("/tmp/my/dir", 0755)
+----------------------------------------
+
 weechat_exec_on_files
 ^^^^^^^^^^^^^^^^^^^^^
 
@@ -1598,7 +1723,7 @@ Paramètres :
 ** 'void *data' : pointeur
 ** 'const char *filename' : nom de fichier trouvé
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1639,7 +1764,7 @@ Valeur de retour :
 * zéro si tv1 == tv2
 * +1 si tv1 > tv2
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1670,7 +1795,7 @@ Valeur de retour :
 
 * différence en millisecondes
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1694,7 +1819,7 @@ Paramètres :
 * 'tv' : structure "timeval"
 * 'interval' : intervalle (en millisecondes)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1723,13 +1848,24 @@ Valeur de retour :
 
 * pointeur vers la nouvelle liste
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_weelist *list = weechat_list_new ();
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+list = weechat.list_new()
+
+# exemple
+list = weechat.list_new()
+----------------------------------------
+
 weechat_list_add
 ^^^^^^^^^^^^^^^^
 
@@ -1759,7 +1895,7 @@ Valeur de retour :
 
 * pointeur vers le nouvel élément
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -1767,6 +1903,17 @@ struct t_weelist_item *my_item =
     weechat_list_add (list, "ma donnée", WEECHAT_LIST_POS_SORT, NULL);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+item = weechat.list_add(list, data, where, user_data)
+
+# exemple
+item = weechat.list_add(list, "ma donnée", weechat.WEECHAT_LIST_POS_SORT, "")
+----------------------------------------
+
 weechat_list_search
 ^^^^^^^^^^^^^^^^^^^
 
@@ -1789,13 +1936,24 @@ Valeur de retour :
 
 * pointeur vers l'élément trouvé, NULL si aucun élément n'a été trouvé
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_weelist_item *item = weechat_list_search (list, "ma donnée");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+item = weechat.list_search(list, data)
+
+# exemple
+item = weechat.list_search(list, "ma donnée")
+----------------------------------------
+
 weechat_list_casesearch
 ^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -1818,13 +1976,24 @@ Valeur de retour :
 
 * pointeur vers l'élément trouvé, NULL si aucun élément n'a été trouvé
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_weelist_item *item = weechat_list_casesearch (list, "ma donnée");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+item = weechat.list_casesearch(list, data)
+
+# exemple
+item = weechat.list_casesearch(list, "ma donnée")
+----------------------------------------
+
 weechat_list_get
 ^^^^^^^^^^^^^^^^
 
@@ -1847,13 +2016,24 @@ Valeur de retour :
 
 * pointeur vers l'élément trouvé, NULL si aucun élément n'a été trouvé
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_weelist_item *item = weechat_list_get (list, 0); /* premier élément */
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+item = weechat.list_get(list, position)
+
+# exemple
+item = weechat.list_get(list, 0)
+----------------------------------------
+
 weechat_list_set
 ^^^^^^^^^^^^^^^^
 
@@ -1871,13 +2051,24 @@ Paramètres :
 * 'item' : pointeur vers l'élément
 * 'value' : nouvelle valeur pour l'élément
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_list_set (item, "nouvelle donnée");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.list_set(item, value)
+
+# exemple
+weechat.list_set(item, "nouvelle donnée")
+----------------------------------------
+
 weechat_list_next
 ^^^^^^^^^^^^^^^^^
 
@@ -1899,11 +2090,22 @@ Valeur de retour :
 * pointeur vers l'élément suivant, NULL si le pointeur était sur le dernier
   élément de la liste
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-struct t_weelist_item *next_item = weechat_list_next_item (item);
+struct t_weelist_item *next_item = weechat_list_next (item);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+item = weechat.list_next(item)
+
+# exemple
+item = weechat.list_next(item)
 ----------------------------------------
 
 weechat_list_prev
@@ -1927,11 +2129,22 @@ 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 :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-struct t_weelist_item *prev_item = weechat_list_prev_item (item);
+struct t_weelist_item *prev_item = weechat_list_prev (item);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+item = weechat.list_prev(item)
+
+# exemple
+item = weechat.list_prev(item)
 ----------------------------------------
 
 weechat_list_string
@@ -1954,11 +2167,22 @@ Valeur de retour :
 
 * valeur de l'élément
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-char *value = weechat_list_string (item);
+weechat_printf (NULL, "valeur de l'item : %s", weechat_list_string (item));
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.list_string(item)
+
+# exemple
+weechat.prnt("", "valeur de l'item : %s" % weechat.list_string(item))
 ----------------------------------------
 
 weechat_list_size
@@ -1981,11 +2205,22 @@ Valeur de retour :
 
 * taille de la liste (nombre d'éléments), 0 si la liste est vide
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-int size = weechat_list_size (list);
+weechat_printf (NULL, "taille de la liste : %d", weechat_list_size (list));
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+size = weechat.list_size(list)
+
+# exemple
+weechat.prnt("", "taille de la liste : %d" % weechat.list_size(list))
 ----------------------------------------
 
 weechat_list_remove
@@ -2006,13 +2241,24 @@ Paramètres :
 * 'weelist' : pointeur vers la liste
 * 'item' : pointeur vers l'élément
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_list_remove (list, item);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.list_remove(list, item)
+
+# exemple
+weechat.list_remove(list, item)
+----------------------------------------
+
 weechat_list_remove_all
 ^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2029,13 +2275,24 @@ Paramètres :
 
 * 'weelist' : pointeur vers la liste
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_list_remove_all (list);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.list_remove_all(list)
+
+# exemple
+weechat.list_remove_all(list)
+----------------------------------------
+
 weechat_list_free
 ^^^^^^^^^^^^^^^^^
 
@@ -2052,13 +2309,24 @@ Paramètres :
 
 * 'weelist' : pointeur vers la liste
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_list_free (list);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.list_free(list)
+
+# exemple
+weechat.list_free(list)
+----------------------------------------
+
 [[configuration_files]]
 Fichiers de configuration
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -2101,7 +2369,7 @@ l'appel à la fonction <<_weechat_write_config>>. Vous ne devriez appeler cette
 fonction qu'après avoir créé les sections (avec <<_weechat_config_new_section>>)
 et les options (avec <<_weechat_config_new_option>>).
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -2118,6 +2386,21 @@ struct t_config_file *config_file = weechat_config_new ("test",
                                                         NULL);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+config_file = weechat.config_new(name, calback_reload, callback_reload_data)
+
+# exemple
+def my_config_reload_cb(data, config_file):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+config_file = weechat.config_new("test", "my_config_reload_cb", "")
+----------------------------------------
+
 weechat_config_new_section
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2223,12 +2506,12 @@ Valeur de retour :
 * pointeur vers la nouvelle section du fichier de configuration, NULL en cas
   d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-ma_section_read_cb (void *data, struct t_config_file *config_file,
+my_section_read_cb (void *data, struct t_config_file *config_file,
                     struct t_config_section *section, const char *option_name,
                     const char *value)
 {
@@ -2238,7 +2521,7 @@ ma_section_read_cb (void *data, struct t_config_file *config_file,
 }
 
 int
-ma_section_write_cb (void *data, struct t_config_file *config_file,
+my_section_write_cb (void *data, struct t_config_file *config_file,
                      const char *section_name)
 {
     /* ... */
@@ -2247,7 +2530,7 @@ ma_section_write_cb (void *data, struct t_config_file *config_file,
 }
 
 int
-ma_section_write_default_cb (void *data, struct t_config_file *config_file,
+my_section_write_default_cb (void *data, struct t_config_file *config_file,
                              const char *section_name)
 {
     /* ... */
@@ -2256,7 +2539,7 @@ ma_section_write_default_cb (void *data, struct t_config_file *config_file,
 }
 
 int
-ma_section_create_option_cb (void *data, struct t_config_file *config_file,
+my_section_create_option_cb (void *data, struct t_config_file *config_file,
                              struct t_config_section *section,
                              const char *option_name, const char *value)
 {
@@ -2266,7 +2549,7 @@ ma_section_create_option_cb (void *data, struct t_config_file *config_file,
 }
 
 int
-ma_section_delete_option_cb (void *data, struct t_config_file *config_file,
+my_section_delete_option_cb (void *data, struct t_config_file *config_file,
                              struct t_config_section *section,
                              struct t_config_option *option)
 {
@@ -2288,11 +2571,52 @@ struct t_config_section *new_section1 =
    options nécessitent un callback pour la lecture/écriture */
 struct t_config_section *new_section2 =
     weechat_config_new_section (config_file, "section2", 1, 1,
-                                &ma_section_read_cb, NULL,
-                                &ma_section_write_cb, NULL,
-                                &ma_section_write_default_cb, NULL,
-                                &ma_section_create_option_cb, NULL,
-                                &ma_section_delete_option_cb, NULL);
+                                &my_section_read_cb, NULL,
+                                &my_section_write_cb, NULL,
+                                &my_section_write_default_cb, NULL,
+                                &my_section_create_option_cb, NULL,
+                                &my_section_delete_option_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+section = weechat.config_new_section(config_file, name,
+    user_can_add_options, user_can_delete_options,
+    callback_read, callback_read_data,
+    callback_write, callback_write_data,
+    callback_create_option, callback_create_option_data,
+    callback_delete_option, callback_delete_option_data)
+
+# exemple
+def my_section_read_cb(data, config_file, section, option_name, value):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+def my_section_write_cb(data, config_file, section_name):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+def my_section_write_default_cb(data, config_file, section_name):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+def my_section_create_option_cb(data, config_file, section, option_name, value):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+def my_section_delete_option_cb(data, config_file, section, option):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+section = weechat.config_new_section(config_file, "section1", 1, 1,
+    "my_section_read_cb", "",
+    "my_section_write_cb", "",
+    "my_section_write_default_cb", "",
+    "my_section_create_option_cb", "",
+    "my_section_delete_option_cb", "")
 ----------------------------------------
 
 weechat_config_search_section
@@ -2318,7 +2642,7 @@ Valeur de retour :
 
 * pointeur vers la section trouvée, ou NULL si la section n'a pas été trouvée
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -2326,6 +2650,17 @@ struct t_config_section *section = weechat_config_search_section (config_file,
                                                                   "section");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+section = weechat.config_search_section(config_file, section_name)
+
+# exemple
+section = weechat.config_search_section(config_file, "section")
+----------------------------------------
+
 weechat_config_new_option
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2403,14 +2738,14 @@ Valeur de retour :
 
 * pointeur vers la nouvelle option de la section, NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-/* boolean */
+/* booléen */
 struct t_config_option *option1 =
-    weechat_config_new_option (config_file, section,
-                               "option1", "Mon option, type booléen"
+    weechat_config_new_option (config_file, section, "option1", "boolean",
+                               "Mon option, type booléen"
                                NULL, /* valeurs sous forme de chaînes */
                                0, 0, /* min, max */
                                "on", /* défaut */
@@ -2420,10 +2755,10 @@ struct t_config_option *option1 =
                                NULL, NULL, /* callback de changement de valeur */
                                NULL, NULL); /* callback de suppression de l'option */
 
-/* integer */
+/* entier */
 struct t_config_option *option2 =
-    weechat_config_new_option (config_file, section,
-                               "option2", "Mon option, type entier"
+    weechat_config_new_option (config_file, section, "option2", "integer",
+                               "Mon option, type entier"
                                NULL, /* valeurs sous forme de chaînes */
                                0, 100, /* min, max */
                                "15", /* défaut */
@@ -2433,10 +2768,9 @@ struct t_config_option *option2 =
                                NULL, NULL, /* callback de changement de valeur */
                                NULL, NULL); /* callback de suppression de l'option */
 
-/* integer (with string values) */
+/* entier (avec valeurs sous forme de chaînes) */
 struct t_config_option *option3 =
-    weechat_config_new_option (config_file, section,
-                               "option3",
+    weechat_config_new_option (config_file, section, "option3", "integer",
                                "Mon option, type entier "
                                "(avec valeurs sous forme de chaînes)"
                                "top|bottom|left|right", /* valeurs sous forme de chaînes */
@@ -2448,10 +2782,10 @@ struct t_config_option *option3 =
                                NULL, NULL, /* callback de changement de valeur */
                                NULL, NULL); /* callback de suppression de l'option */
 
-/* string */
+/* chaîne */
 struct t_config_option *option4 =
-    weechat_config_new_option (config_file, section,
-                               "option4", "Mon option, type chaîne"
+    weechat_config_new_option (config_file, section, "option4", "string",
+                               "Mon option, type chaîne"
                                NULL, /* valeurs sous forme de chaînes */
                                0, 0, /* min, max */
                                "test", /* défaut */
@@ -2461,10 +2795,10 @@ struct t_config_option *option4 =
                                NULL, NULL, /* callback de changement de valeur */
                                NULL, NULL); /* callback de suppression de l'option */
 
-/* color */
+/* couleur */
 struct t_config_option *option5 =
-    weechat_config_new_option (config_file, section,
-                               "option5", "Mon option, type couleur"
+    weechat_config_new_option (config_file, section, "option5", "color",
+                               "Mon option, type couleur"
                                NULL, /* valeurs sous forme de chaînes */
                                0, 0, /* min, max */
                                "lightblue", /* défaut */
@@ -2475,6 +2809,67 @@ struct t_config_option *option5 =
                                NULL, NULL); /* callback de suppression de l'option */
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+option = weechat.config_new_option(config_file, section, name, type, description,
+    string_values, min, max, default_value, value, null_value_allowed,
+    callback_check_value, callback_check_value_data,
+    callback_change, callback_change_data,
+    callback_delete, callback_delete_data)
+
+# exemple
+def option4_check_value_cb(data, option, value):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+def option4_change_cb(data, option):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+def option4_delete_cb(data, option):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+option1 = weechat.config_new_option(config_file, section, "option1", "boolean",
+    "Mon option, type booléen",
+    "", 0, 0, "on", "on", 0,
+    "", "",
+    "", "",
+    "", "")
+
+option2 = weechat.config_new_option(config_file, section, "option2", "integer",
+    "Mon option, type entier",
+    "", 0, 100, "15", "15", 0,
+    "", "",
+    "", "",
+    "", "")
+
+option3 = weechat.config_new_option(config_file, section, "option3", "integer",
+    "Mon option, type entier (avec valeurs sous forme de chaînes)",
+    "top|bottom|left|right",
+    0, 0, "bottom", "bottom", 0,
+    "", "",
+    "", "",
+    "", "")
+
+option4 = weechat.config_new_option(config_file, section, "option4", "string",
+    "Mon option, type chaîne",
+    "", 0, 0, "test", "test", 1,
+    "option4_check_value_cb", ""
+    "option4_change_cb", "",
+    "option4_delete_cb", "")
+
+option5 = weechat.config_new_option(config_file, section, "option5", "color",
+    "Mon option, type couleur",
+    "", 0, 100, "lightblue", "lightblue", 0,
+    "", "",
+    "", "",
+    "", "")
+----------------------------------------
+
 weechat_config_search_option
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2500,7 +2895,7 @@ Valeur de retour :
 
 * pointeur vers l'option trouvée, NULL si l'option n'a pas été trouvée
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -2508,6 +2903,17 @@ struct t_config_option *option =
     weechat_config_search_option (config_file, section, "option");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+option = weechat.config_search_option(config_file, section, option_name)
+
+# exemple
+option = weechat.config_search_option(config_file, section, "option")
+----------------------------------------
+
 weechat_config_search_with_string
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2534,7 +2940,7 @@ Paramètres :
 * 'option' : pointeur vers un pointeur sur une option, sera alimenté avec le
   pointeur vers l'option trouvée
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -2577,7 +2983,7 @@ 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 :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -2591,6 +2997,18 @@ else
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.config_string_to_boolean(text)
+
+# exemple
+if weechat.config_string_to_boolean(text):
+    # ...
+----------------------------------------
+
 weechat_config_option_reset
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2617,7 +3035,7 @@ Valeur de retour :
 * 'WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE' si la valeur n'a pas changé
 * 'WEECHAT_CONFIG_OPTION_SET_ERROR' en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -2635,6 +3053,23 @@ switch (weechat_config_option_reset (option, 1))
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+rc = weechat.config_option_reset(option, run_callback)
+
+# exemple
+rc = weechat.config_option_reset(option, 1)
+if rc == weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_ERROR:
+    # ...
+----------------------------------------
+
 weechat_config_option_set
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2661,11 +3096,11 @@ Valeur de retour :
 * 'WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE' si la valeur n'a pas changé
 * 'WEECHAT_CONFIG_OPTION_SET_ERROR' en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-switch (weechat_config_option_set (option, "new_value", 1))
+switch (weechat_config_option_set (option, "nouvelle_valeur", 1))
 {
     case WEECHAT_CONFIG_OPTION_SET_OK_CHANGED:
         /* .... */
@@ -2679,6 +3114,23 @@ switch (weechat_config_option_set (option, "new_value", 1))
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+rc = weechat.config_option_set(option, value, run_callback)
+
+# exemple
+rc = weechat.config_option_set(option, "nouvelle_valeur", 1)
+if rc == weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_ERROR:
+    # ...
+----------------------------------------
+
 weechat_config_option_set_null
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2708,7 +3160,7 @@ Valeur de retour :
 * 'WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE' si la valeur n'a pas changé
 * 'WEECHAT_CONFIG_OPTION_SET_ERROR' en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -2726,6 +3178,23 @@ switch (weechat_config_option_set_null (option, 1))
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+rc = weechat.config_option_set_null(option, run_callback)
+
+# exemple
+rc = weechat.config_option_set_null(option, 1)
+if rc == weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_ERROR:
+    # ...
+----------------------------------------
+
 weechat_config_option_unset
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2751,7 +3220,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 :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -2772,6 +3241,25 @@ switch (weechat_config_option_unset (option))
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+rc = weechat.config_option_unset(option)
+
+# exemple
+rc = weechat.config_option_unset(option)
+if rc == weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_RESET:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_UNSET_ERROR:
+    # ...
+----------------------------------------
+
 weechat_config_option_rename
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2790,13 +3278,24 @@ Paramètres :
 * 'option' : pointeur vers l'option
 * 'new_name' : nouveau nom pour l'option
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_config_option_rename (option, "nouveau_nom");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.config_option_rename(option, new_name)
+
+# exemple
+weechat.config_option_rename(option, "nouveau_nom")
+----------------------------------------
+
 weechat_config_option_get_pointer
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2834,7 +3333,7 @@ Valeur de retour :
 
 * pointeur vers la propriété demandée
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -2862,20 +3361,79 @@ Valeur de retour :
 * 1 si la valeur de l'option est "null"
 * 0 si la valeur de l'option n'est pas "null"
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 if (weechat_config_option_is_null (option))
 {
-    /* value is "null" */
+    /* la valeur est "null" */
+}
+else
+{
+    /* la valeur n'est pas "null" */
+}
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.config_option_is_null(option)
+
+# exemple
+if weechat.config_option_is_null(option):
+    # ...
+----------------------------------------
+
+weechat_config_option_default_is_null
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Vérifie si la valeur par défaut d'une option est "null" (valeur non définie).
+
+Prototype :
+
+[source,C]
+----------------------------------------
+int weechat_config_option_default_is_null (struct t_config_option *option);
+----------------------------------------
+
+Paramètres :
+
+* 'option' : pointeur vers l'option
+
+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 :
+
+[source,C]
+----------------------------------------
+if (weechat_config_option_default_is_null (option))
+{
+    /* la valeur par défaut est "null" */
 }
 else
 {
-    /* value is not "null" */
+    /* la valeur par défaut n'est pas "null" */
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.config_option_default_is_null(option)
+
+# exemple
+if weechat.config_option_default_is_null(option):
+    # ...
+----------------------------------------
+
 weechat_config_boolean
 ^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2896,7 +3454,7 @@ Valeur de retour :
 
 * valeur booléenne de l'option (0 ou 1)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -2910,6 +3468,18 @@ else
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.config_option_boolean(option)
+
+# exemple
+if weechat.config_option_boolean(option):
+    # ...
+----------------------------------------
+
 weechat_config_boolean_default
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2930,7 +3500,7 @@ Valeur de retour :
 
 * valeur booléenne par défaut de l'option (0 ou 1)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -2944,6 +3514,18 @@ else
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.config_option_boolean_default(option)
+
+# exemple
+if weechat.config_option_boolean_default(option):
+    # ...
+----------------------------------------
+
 weechat_config_integer
 ^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2964,13 +3546,25 @@ Valeur de retour :
 
 * valeur entière de l'option
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int value = weechat_config_integer (option);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.config_option_integer(option)
+
+# exemple
+if weechat.config_option_integer(option):
+    # ...
+----------------------------------------
+
 weechat_config_integer_default
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2991,13 +3585,25 @@ Valeur de retour :
 
 * valeur entière par défaut de l'option
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int value = weechat_config_integer_default (option);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.config_option_integer_default(option)
+
+# exemple
+if weechat.config_option_integer_default(option):
+    # ...
+----------------------------------------
+
 weechat_config_string
 ^^^^^^^^^^^^^^^^^^^^^
 
@@ -3018,13 +3624,24 @@ Valeur de retour :
 
 * valeur de l'option, sous forme de chaîne
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 const char *value = weechat_config_string (option);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.config_option_string(option)
+
+# exemple
+value = weechat.config_option_string(option):
+----------------------------------------
+
 weechat_config_string_default
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -3045,13 +3662,24 @@ Valeur de retour :
 
 * valeur par défaut de l'option, sous forme de chaîne
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 const char *value = weechat_config_string_default (option);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.config_option_string_default(option)
+
+# exemple
+value = weechat.config_option_string_default(option):
+----------------------------------------
+
 weechat_config_color
 ^^^^^^^^^^^^^^^^^^^^
 
@@ -3072,13 +3700,24 @@ Valeur de retour :
 
 * valeur de l'option sous forme de couleur (chaîne avec le nom de la couleur)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 const char *color = weechat_config_color (option);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.config_option_color(option)
+
+# exemple
+value = weechat.config_option_color(option):
+----------------------------------------
+
 weechat_config_color_default
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -3100,13 +3739,24 @@ Valeur de retour :
 * valeur par défaut de l'option sous forme de couleur (chaîne avec le nom de la
   couleur)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 const char *color = weechat_config_color_default (option);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.config_option_color_default(option)
+
+# exemple
+value = weechat.config_option_color_default(option):
+----------------------------------------
+
 weechat_config_write_option
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -3127,12 +3777,12 @@ Paramètres :
 * 'config_file' : pointeur vers le fichier de configuration
 * 'option' : pointeur vers l'option
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-ma_section_write_cb (void *data, struct t_config_file *config_file,
+my_section_write_cb (void *data, struct t_config_file *config_file,
                      const char *section_name)
 {
     weechat_config_write_line (config_file, "ma_section", NULL);
@@ -3143,6 +3793,20 @@ ma_section_write_cb (void *data, struct t_config_file *config_file,
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.config_write_option(config_file, option)
+
+# exemple
+def my_section_write_cb(data, config_file, section_name):
+    weechat.config_write_line(config_file, "ma_section", "")
+    weechat.config_write_option(config_file, option)
+    return weechat.WEECHAT_RC_OK
+----------------------------------------
+
 weechat_config_write_line
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -3164,25 +3828,39 @@ 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 example : "[section]")
+  section, par exemple : "[section]")
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-ma_section_write_cb (void *data, struct t_config_file *config_file,
+my_section_write_cb (void *data, struct t_config_file *config_file,
                      const char *section_name)
 {
     weechat_config_write_line (config_file, "ma_section", NULL);
     
     weechat_config_write_line (config_file, "option", "%s;%d",
-                               "value", 123);
+                               "valeur", 123);
                                
     return WEECHAT_RC_OK;
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.config_write_line(config_file, option_name, value)
+
+# exemple
+def my_section_write_cb(data, config_file, section_name):
+    weechat.config_write_line(config_file, "ma_section", "")
+    weechat.config_write_line(config_file, "option", "valeur")
+    return weechat.WEECHAT_RC_OK
+----------------------------------------
+
 weechat_config_write
 ^^^^^^^^^^^^^^^^^^^^
 
@@ -3205,7 +3883,7 @@ Valeur de retour :
 * '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 :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -3223,6 +3901,23 @@ switch (weechat_config_write (config_file))
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+rc = weechat.config_write(config_file)
+
+# exemple
+rc = weechat.config_write(config_file)
+if rc == weechat.WEECHAT_CONFIG_WRITE_OK:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_WRITE_ERROR:
+    # ...
+----------------------------------------
+
 weechat_config_read
 ^^^^^^^^^^^^^^^^^^^
 
@@ -3245,7 +3940,7 @@ Valeur de retour :
 * '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 :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -3263,6 +3958,23 @@ switch (weechat_config_read (config_file))
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+rc = weechat.config_read(config_file)
+
+# exemple
+rc = weechat.config_read(config_file)
+if rc == weechat.WEECHAT_CONFIG_READ_OK:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_READ_MEMORY_ERROR:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_READ_FILE_NOT_FOUND:
+    # ...
+----------------------------------------
+
 weechat_config_reload
 ^^^^^^^^^^^^^^^^^^^^^
 
@@ -3285,7 +3997,7 @@ Valeur de retour :
 * '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 :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -3303,6 +4015,23 @@ switch (weechat_config_reload (config_file))
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+rc = weechat.config_reload(config_file)
+
+# exemple
+rc = weechat.config_reload(config_file)
+if rc == weechat.WEECHAT_CONFIG_READ_OK:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_READ_MEMORY_ERROR:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_READ_FILE_NOT_FOUND:
+    # ...
+----------------------------------------
+
 weechat_config_option_free
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -3319,13 +4048,24 @@ Paramètres :
 
 * 'option' : pointeur vers l'option
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_config_option_free (option);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.config_option_free(option)
+
+# exemple
+weechat.config_option_free(option)
+----------------------------------------
+
 weechat_config_section_free_options
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -3342,13 +4082,24 @@ Paramètres :
 
 * 'section' : pointeur vers la section
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_config_section_free_options (section);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.config_section_free_options(section)
+
+# exemple
+weechat.config_section_free_options(section)
+----------------------------------------
+
 weechat_config_section_free
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -3365,13 +4116,22 @@ Paramètres :
 
 * 'section' : pointeur vers la section
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_config_section_free (section);
 ----------------------------------------
 
+[source,python]
+----------------------------------------
+# prototype
+weechat.config_section_free(section)
+
+# exemple
+weechat.config_section_free(section)
+----------------------------------------
+
 weechat_config_free
 ^^^^^^^^^^^^^^^^^^^
 
@@ -3388,13 +4148,24 @@ Paramètres :
 
 * 'config_file' : pointeur vers le fichier de configuration
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_config_free (config_file);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.config_free(config_file)
+
+# exemple
+weechat.config_free(config_file)
+----------------------------------------
+
 weechat_config_get
 ^^^^^^^^^^^^^^^^^^
 
@@ -3415,13 +4186,24 @@ Valeur de retour :
 
 * pointeur vers l'option trouvée, NULL si l'option n'a pas été trouvée
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_config_option *option = weechat_config_get ("weechat.look.item_time_format");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+option = weechat.config_get(option_name)
+
+# exemple
+option = weechat.config_get("weechat.look.item_time_format")
+----------------------------------------
+
 weechat_config_get_plugin
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -3444,7 +4226,7 @@ Valeur de retour :
 
 * valeur de l'option trouvée, NULL si l'option n'a pas été trouvée
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -3453,6 +4235,17 @@ Exemple :
 char *value = weechat_config_get_plugin ("option");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.config_get_plugin(option_name)
+
+# exemple
+value = weechat.config_get_plugin("option")
+----------------------------------------
+
 weechat_config_is_set_plugin
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -3475,7 +4268,7 @@ Valeur de retour :
 
 * 1 si l'option est définie, 0 si l'option n'existe pas
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -3489,6 +4282,22 @@ else
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.config_is_set_plugin(option_name)
+
+# exemple
+if weechat.config_is_set_plugin("option"):
+    # l'option existe
+    # ...
+else:
+    # l'option n'existe pas
+    # ...
+----------------------------------------
+
 weechat_config_set_plugin
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -3515,7 +4324,7 @@ Valeur de retour :
 * '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 :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -3536,6 +4345,25 @@ switch (weechat_config_set_plugin ("option", "valeur_test"))
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+rc = weechat.config_set_plugin(option_name, value)
+
+# exemple
+rc = weechat.config_is_set_plugin("option", "valeur_test")
+if rc == weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_ERROR:
+    # ...
+----------------------------------------
+
 weechat_config_unset_plugin
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -3562,7 +4390,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 :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -3583,6 +4411,25 @@ switch (weechat_config_unset_plugin ("option"))
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+rc = weechat.config_unset_plugin(option_name)
+
+# exemple
+rc = weechat.config_unset_plugin("option")
+if rc == weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_RESET:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED:
+    # ...
+elif rc == weechat.WEECHAT_CONFIG_OPTION_UNSET_ERROR:
+    # ...
+----------------------------------------
+
 [[display]]
 Affichage
 ~~~~~~~~~
@@ -3605,14 +4452,14 @@ Paramètres :
 
 * 'prefix' : nom du préfixe :
 
-[width="60%",cols="^2,^1,^2,5",options="header"]
+[width="70%",cols="^2,^1,^3,5",options="header"]
 |========================================
-| Préfixe   | Valeur | Couleur     | Description
-| 'error'   | `=!=`  | jaune       | message d'erreur
-| 'network' | `--`   | violet      | message du réseau
-| 'action'  | `*`    | blanc       | action personnelle
-| 'join'    | `-->`  | vert clair  | quelqu'un a rejoint la discussion
-| 'quit'    | `<--`  | rouge clair | quelqu'un a quitté la discussion
+| Préfixe   | Valeur | Couleur                   | Description
+| 'error'   | `=!=`  | jaune ("yellow")          | message d'erreur
+| 'network' | `--`   | violet ("magenta")        | message du réseau
+| 'action'  | `*`    | blanc ("white")           | action personnelle
+| 'join'    | `-->`  | vert clair ("lightgreen") | quelqu'un a rejoint la discussion
+| 'quit'    | `<--`  | rouge clair ("lightred")  | quelqu'un a quitté la discussion
 |========================================
 
 [NOTE]
@@ -3623,13 +4470,24 @@ 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é
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_printf (NULL, "%sCeci est une erreur...", weechat_prefix ("error"));
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.prefix(prefix)
+
+# exemple
+weechat.prnt("", "%sCeci est une erreur..." % weechat.prefix("error"))
+----------------------------------------
+
 weechat_color
 ^^^^^^^^^^^^^
 
@@ -3666,16 +4524,28 @@ Valeur de retour :
 * chaîne avec le code couleur, ou un code couleur de réinitialisation si la
   couleur n'a pas été trouvée
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-weechat_printf (NULL, "Color : %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):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.color(color_name)
+
+# exemple
+weechat.prnt("", "%sCouleur : %sbleu %scouleur par défaut %sjaune sur rouge"
+    % (weechat.color("blue"), weechat.color("chat"), weechat.color("yellow,red")))
+----------------------------------------
+
 weechat_printf
 ^^^^^^^^^^^^^^
 
@@ -3694,7 +4564,7 @@ Paramètres :
   tampon WeeChat
 * 'message' : message à afficher
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -3702,6 +4572,21 @@ weechat_printf (NULL, "Bonjour sur le tampon WeeChat");
 weechat_printf (buffer, "Bonjour sur ce tampon");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.prnt(buffer, message)
+
+# exemple
+weechat.prnt("", "Bonjour sur le tampon WeeChat")
+weechat.prnt(buffer, "Bonjour sur ce tampon")
+----------------------------------------
+
+[NOTE]
+La fonction s'appelle "print" dans les scripts ("prnt" en Python).
+
 weechat_printf_date
 ^^^^^^^^^^^^^^^^^^^
 
@@ -3722,7 +4607,7 @@ Paramètres :
 * 'date' : date pour le message
 * 'message' : message à afficher
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -3749,7 +4634,7 @@ Paramètres :
 * 'tags' : liste d'étiquettes ("tags") séparées par des virgules
 * 'message' : message à afficher
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -3779,7 +4664,7 @@ Paramètres :
 * 'tags' : liste d'étiquettes ("tags") séparées par des virgules
 * 'message' : message à afficher
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -3787,6 +4672,23 @@ weechat_printf_date_tags (NULL, time (NULL) - 120, "notify_message",
                           "Message il y a 2 minutes avec une étiquette 'notify_message'");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.prnt_date_tags(buffer, date, tags, message)
+
+# exemple
+time = int(time.time())
+weechat.prnt_date_tags("", time - 120, "notify_message",
+    "Message il y a 2 minutes avec une étiquette 'notify_message'")
+----------------------------------------
+
+[NOTE]
+La fonction s'appelle "print_date_tags" dans les scripts ("prnt_date_tags" en
+Python).
+
 weechat_printf_y
 ^^^^^^^^^^^^^^^^
 
@@ -3806,13 +4708,27 @@ Paramètres :
 * 'y' : numéro de ligne (la première ligne est 0)
 * 'message' : message à afficher
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_printf_y (buffer, 2, "Mon message sur la 3ème ligne");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.prnt_y(buffer, y, message)
+
+# exemple
+weechat.prnt_y("", 2, "Mon message sur la 3ème ligne")
+----------------------------------------
+
+[NOTE]
+La fonction s'appelle "print_y" dans les scripts ("prnt_y" en Python).
+
 weechat_log_printf
 ^^^^^^^^^^^^^^^^^^
 
@@ -3829,13 +4745,27 @@ Paramètres :
 
 * 'message' : message à écrire
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_log_printf ("Mon message dans le fichier log");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.log_print(message)
+
+# exemple
+weechat.log_print("Mon message dans le fichier log")
+----------------------------------------
+
+[NOTE]
+La fonction s'appelle "log_print" dans les scripts.
+
 [[hooks]]
 Hooks
 ~~~~~
@@ -3856,7 +4786,8 @@ struct t_hook *weechat_hook_command (const char *command,
                                      const char *completion,
                                      int (*callback)(void *data,
                                                      struct t_gui_buffer *buffer,
-                                                     int argc, char **argv,
+                                                     int argc,
+                                                     char **argv,
                                                      char **argv_eol),
                                      void *callback_data);
 ----------------------------------------
@@ -3896,13 +4827,13 @@ Valeur de retour :
 
 * pointeur vers le nouveau "hook", NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-ma_commande_cb (void *data, struct t_gui_buffer *buffer, int argc,
-                char **argv, char **argv_eol)
+my_command_cb (void *data, struct t_gui_buffer *buffer, int argc,
+               char **argv, char **argv_eol)
 {
     /* ... */
     return WEECHAT_RC_OK;
@@ -3919,7 +4850,7 @@ struct t_hook *my_command_hook =
                           "[add nom extension.tampon tags regex] | "
                           "[del nom|-all]",
                           /* description des paramètres */
-                          "description of arguments...",
+                          "description des paramètres...",
                           /* complétion */
                           "list"
                           " || enable %(filters_names)"
@@ -3928,7 +4859,7 @@ struct t_hook *my_command_hook =
                           " || add %(filters_names) %(buffers_plugins_names)|*"
                           " || del %(filters_names)|-all",
                           /* callback */
-                          &ma_commande_cb,
+                          &my_command_cb,
                           /* callback_data */
                           NULL);
 ----------------------------------------
@@ -3945,6 +4876,33 @@ argv_eol contiendront les valeurs suivantes :
 ** 'argv_eol[1]' == "def ghi"
 ** 'argv_eol[2]' == "ghi"
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+hook = weechat.hook_command(command, description, args, args_description,
+    completion, callback, callback_data)
+
+# exemple
+def my_command_cb(data, buffer, args):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+hook = weechat.hook_command("monfiltre", "description de monfiltre",
+    "[list] | [enable|disable|toggle [name]] | "
+    "[add name plugin.buffer tags regex] | "
+    "[del name|-all]",
+    "description des paramètres...",
+    "list"
+    " || enable %(filters_names)"
+    " || disable %(filters_names)"
+    " || toggle %(filters_names)"
+    " || add %(filters_names) %(buffers_plugins_names)|*"
+    " || del %(filters_names)|-all",
+    "my_command_cb", "")
+----------------------------------------
+
 weechat_hook_command_run
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -3980,13 +4938,12 @@ Valeur de retour :
 
 * pointeur vers le nouveau "hook", NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-ma_commande_interceptee_cb (void *data, struct t_gui_buffer *buffer,
-                            const char *command)
+my_command_run_cb (void *data, struct t_gui_buffer *buffer, const char *command)
 {
     weechat_printf (NULL,
                     "Vous voulez compléter ? Je mange la commande, ahah !");
@@ -3995,7 +4952,22 @@ ma_commande_interceptee_cb (void *data, struct t_gui_buffer *buffer,
 
 struct t_hook *my_command_run_hook =
     weechat_hook_command_run ("/input complete*",
-                              &ma_commande_interceptee_cb, NULL);
+                              &my_command_run_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+hook = weechat.hook_command_run(command, callback, callback_data)
+
+# exemple
+def my_command_run_cb(data, buffer, command):
+    weechat.prnt("", "Vous voulez compléter ? Je mange la commande, ahah !")
+    return weechat.WEECHAT_RC_OK_EAT
+
+hook = weechat.hook_command_run("/input complete*", "my_command_run_cb", "")
 ----------------------------------------
 
 weechat_hook_timer
@@ -4035,12 +5007,12 @@ Valeur de retour :
 
 * pointeur vers le nouveau "hook", NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-mon_timer_cb (void *data, int remaining_calls)
+my_timer_cb (void *data, int remaining_calls)
 {
     /* ... */
     return WEECHAT_RC_OK;
@@ -4048,7 +5020,23 @@ mon_timer_cb (void *data, int remaining_calls)
 
 /* timer appelé toutes les 20 secondes */
 struct t_hook *my_timer_hook =
-    weechat_hook_timer (20 * 1000, 0, 0, &mon_timer_cb, NULL);
+    weechat_hook_timer (20 * 1000, 0, 0, &my_timer_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+hook = weechat.hook_timer(interval, align_second, max_calls, callback, callback_data)
+
+# exemple
+def my_timer_cb(data, remaining_calls):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+# timer appelé toutes les 20 secondes
+hook = weechat.hook_timer(20 * 1000, 0, 0, "my_timer_cb", "")
 ----------------------------------------
 
 weechat_hook_fd
@@ -4064,7 +5052,8 @@ struct t_hook *weechat_hook_fd (int fd,
                                 int flag_read,
                                 int flag_write,
                                 int flag_exception,
-                                int (*callback)(void *data, int fd),
+                                int (*callback)(void *data,
+                                                int fd),
                                 void *callback_data);
 ----------------------------------------
 
@@ -4085,12 +5074,12 @@ Valeur de retour :
 
 * pointeur vers le nouveau "hook", NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-mon_fd_cb (void *data, int fd)
+my_fd_cb (void *data, int fd)
 {
     /* ... */
     return WEECHAT_RC_OK;
@@ -4099,7 +5088,23 @@ mon_fd_cb (void *data, int fd)
 int sock = socket (AF_INET, SOCK_STREAM, 0);
 /* définir les options de la socket */
 /* ... */
-struct t_hook *my_fd_hook = weechat_hook_fd (sock, 1, 0, 0, &mon_fd_cb, NULL);
+struct t_hook *my_fd_hook = weechat_hook_fd (sock, 1, 0, 0, &my_fd_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+hook = weechat.hook_fd(fd, flag_read, flag_write, flag_exception, callback, callback_data)
+
+# exemple
+def my_fd_cb(data, fd):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+sock = ...
+hook = weechat.hook_fd(sock, 1, 0, 0, "my_fd_cb", "")
 ----------------------------------------
 
 weechat_hook_process
@@ -4145,21 +5150,21 @@ Valeur de retour :
 
 * pointeur vers le nouveau "hook", NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-mon_processus_cb (void *data, const char *command, int return_code,
-                  const char *out, const char *err)
+my_process_cb (void *data, const char *command, int return_code,
+               const char *out, const char *err)
 {
     if (return_code == WEECHAT_HOOK_PROCESS_ERROR)
     {
         weechat_printf (NULL, "Erreur avec la commande '%s'", command);
-        return;
+        return WEECHAT_RC_OK;
     }
     
-    if (return_code &gt;= 0)
+    if (return_code >= 0)
     {
         weechat_printf (NULL, "return_code = %d", return_code);
     }
@@ -4177,8 +5182,31 @@ mon_processus_cb (void *data, const char *command, int return_code,
     return WEECHAT_RC_OK;
 }
 
-struct t_hook *mon_process_hook = weechat_hook_process ("ls", 5000,
-                                                        &mon_processus_cb, NULL);
+struct t_hook *my_process_hook = weechat_hook_process ("ls", 5000,
+                                                       &my_process_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+hook = weechat.hook_process(command, timeout, callback, callback_data)
+
+# exemple
+def my_process_cb(data, command, return_code, out, err):
+    if return_code == weechat.WEECHAT_HOOK_PROCESS_ERROR:
+        weechat.prnt("", "Erreur avec la commande '%s'" % command)
+        return weechat.WEECHAT_RC_OK
+    if return_code >= 0:
+        weechat.prnt("", "return_code = %d" % return_code)
+    if out != "":
+        weechat.prnt("", "stdout: %s" % out)
+    if err != "":
+        weechat.prnt("", "stderr: %s" % err)
+    return weechat.WEECHAT_RC_OK
+
+hook = weechat.hook_process("ls", 5000, "my_process_cb", "")
 ----------------------------------------
 
 weechat_hook_connect
@@ -4231,12 +5259,12 @@ Valeur de retour :
 
 * pointeur vers le nouveau "hook", NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-ma_connexion_cb (void *data, int status, const char *ip_address)
+my_connect_cb (void *data, int status, const char *ip_address)
 {
     switch (status)
     {
@@ -4271,9 +5299,42 @@ ma_connexion_cb (void *data, int status, const char *ip_address)
     return WEECHAT_RC_OK;
 }
 
-struct t_hook *mon_connect_hook = weechat_hook_connect ("my.server.org", 1234,
-                                                        sock, 0, NULL, NULL,
-                                                        &ma_connexion_cb, NULL);
+struct t_hook *my_connect_hook = weechat_hook_connect ("my.server.org", 1234,
+                                                       sock, 0, NULL, NULL,
+                                                       &my_connect_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+hook = weechat.hook_connect(address, port, sock, ipv6, local_hostname,
+    callback, callback_data)
+
+# exemple
+def my_connect_cb(data, status, ip_address):
+    if status == WEECHAT_HOOK_CONNECT_OK:
+        # ...
+    elif status == WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND:
+        # ...
+    elif status == WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND:
+        # ...
+    elif status == WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED:
+        # ...
+    elif status == WEECHAT_HOOK_CONNECT_PROXY_ERROR:
+        # ...
+    elif status == WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR:
+        # ...
+    elif status == WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR:
+        # ...
+    elif status == WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR:
+        # ...
+    elif status == WEECHAT_HOOK_CONNECT_MEMORY_ERROR:
+        # ...
+    return weechat.WEECHAT_RC_OK
+
+hook = weechat.hook_connect("my.server.org", 1234, sock, 0, "", "my_connect_cb", "")
 ----------------------------------------
 
 weechat_hook_print
@@ -4328,23 +5389,39 @@ Valeur de retour :
 
 * pointeur vers le nouveau "hook", NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-mon_print_cb (void *data, struct t_gui_buffer *buffer, time_t date,
-              int tags_count, const char **tags,
-              int displayed, int highlight,
-              const char *prefix, const char *message)
+my_print_cb (void *data, struct t_gui_buffer *buffer, time_t date,
+             int tags_count, const char **tags,
+             int displayed, int highlight,
+             const char *prefix, const char *message)
 {
     /* ... */
     return WEECHAT_RC_OK;
 }
 
 /* intercepter tous les messages, de tous les tampons, sans couleur */
-struct t_hook *mon_print_hook =
-    weechat_hook_print (NULL, NULL, NULL, 1, &mon_print_cb, NULL);
+struct t_hook *my_print_hook =
+    weechat_hook_print (NULL, NULL, NULL, 1, &my_print_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+hook = weechat.hook_print(buffer, tags, message, strip_colors, callback, callback_data)
+
+# exemple
+def my_print_cb(data, buffer, date, tags, displayed, highlight, prefix, message):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+# intercepter tous les messages, de tous les tampons, sans couleur
+hook = weechat.hook_print("", "", "", 1, "my_print_cb", "")
 ----------------------------------------
 
 weechat_hook_signal
@@ -4562,21 +5639,37 @@ Valeur de retour :
 
 * pointeur vers le nouveau "hook", NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-mon_signal_cb (void *data, const char *signal, const char *type_data,
-               void *signal_data)
+my_signal_cb (void *data, const char *signal, const char *type_data,
+              void *signal_data)
 {
     /* ... */
     return WEECHAT_RC_OK;
 }
 
 /* intercepter le signal "quit" */
-struct t_hook *mon_signal_hook = weechat_hook_signal ("quit",
-                                                      &mon_signal_cb, NULL);
+struct t_hook *my_signal_hook = weechat_hook_signal ("quit",
+                                                     &my_signal_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+hook = weechat.hook_signal(signal, callback, callback_data)
+
+# exemple
+def my_signal_cb(data, signal, type_data, signal_data):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+# intercepter le signal "quit"
+hook = weechat.hook_signal("quit", "my_signal_cb", "")
 ----------------------------------------
 
 weechat_hook_signal_send
@@ -4599,13 +5692,24 @@ Paramètres :
   <<_weechat_hook_signal>>)
 * 'signal_data' : données envoyées avec le signal
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_hook_signal_send ("mon_signal", WEECHAT_HOOK_SIGNAL_STRING, ma_chaine);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.hook_signal_send(signal, type_data, signal_data)
+
+# exemple
+weechat.hook_signal_send("mon_signal", weechat.WEECHAT_HOOK_SIGNAL_STRING, ma_chaine)
+----------------------------------------
+
 weechat_hook_config
 ^^^^^^^^^^^^^^^^^^^
 
@@ -4638,20 +5742,36 @@ Valeur de retour :
 
 * pointeur vers le nouveau "hook", NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-ma_config_cb (void *data, const char *option, const char *value)
+my_config_cb (void *data, const char *option, const char *value)
 {
     /* ... */
     return WEECHAT_RC_OK;
 }
 
-/* catch changes to option "weechat.look.item_time_format" */
-struct t_hook *mon_config_hook = weechat_hook_config ("weechat.look.item_time_format",
-                                                      &ma_config_cb, NULL);
+/* intercepter les changements de l'option "weechat.look.item_time_format" */
+struct t_hook *my_config_hook = weechat_hook_config ("weechat.look.item_time_format",
+                                                     &my_config_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+hook = weechat.hook_config(option, callback, callback_data)
+
+# exemple
+def my_config_cb(data, option, value):
+    # ...
+    return weechat.WEECHAT_RC_OK
+
+# intercepter les changements de l'option "weechat.look.item_time_format"
+hook = weechat.hook_config("weechat.look.item_time_format", "my_config_cb", "")
 ----------------------------------------
 
 weechat_hook_completion
@@ -4695,24 +5815,40 @@ Valeur de retour :
 
 * pointeur vers le nouveau "hook", NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-ma_completion_cb (void *data, const char *completion_item,
+my_completion_cb (void *data, const char *completion_item,
                   struct t_gui_buffer *buffer,
                   struct t_gui_completion *completion)
 {
-    weechat_hook_completion_list_add (completion, "word1",
+    weechat_hook_completion_list_add (completion, "mot1",
                                       0, WEECHAT_LIST_POS_SORT);
-    weechat_hook_completion_list_add (completion, "test_word2",
+    weechat_hook_completion_list_add (completion, "test_mot2",
                                       0, WEECHAT_LIST_POS_SORT);
     return WEECHAT_RC_OK;
 }
 
-struct t_hook *mon_completion_hook = weechat_hook_completion ("monextension_item",
-                                                              &ma_completion_cb, NULL);
+struct t_hook *my_completion_hook = weechat_hook_completion ("xtension_item",
+                                                             &my_completion_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+hook = weechat.hook_completion(completion_item, callback, callback_data)
+
+# exemple
+def my_completion_cb(data, completion_item, buffer, completion):
+    weechat.hook_completion_list_add(completion, "mot1", 0, weechat.WEECHAT_LIST_POS_SORT)
+    weechat.hook_completion_list_add(completion, "test_mot2", 0, weechat.WEECHAT_LIST_POS_SORT)
+    return weechat.WEECHAT_RC_OK
+
+hook = weechat.hook_completion("extension_item", "my_completion_cb", "")
 ----------------------------------------
 
 weechat_hook_completion_list_add
@@ -4740,7 +5876,17 @@ Paramètres :
 ** 'WEECHAT_LIST_POS_BEGINNING' : au début de la liste
 ** 'WEECHAT_LIST_POS_END' : à la fin de la liste
 
-Exemple : voir <<_weechat_hook_completion>>.
+Exemple en C : voir <<_weechat_hook_completion>>.
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.hook_completion_list_add(completion, word, nick_completion, where)
+
+# exemple : voir la fonction hook_completion ci-dessus
+----------------------------------------
 
 weechat_hook_modifier
 ^^^^^^^^^^^^^^^^^^^^^
@@ -4845,14 +5991,14 @@ Valeur de retour :
 
 * pointeur vers le nouveau "hook", NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 char *
-mon_modifier_cb (void *data, const char *modifier,
-                 const char *modifier_data,
-                 const char *string)
+my_modifier_cb (void *data, const char *modifier,
+                const char *modifier_data,
+                const char *string)
 {
     char *result;
     int length;
@@ -4871,8 +6017,22 @@ mon_modifier_cb (void *data, const char *modifier,
     return result;
 }
 
-struct t_hook *mon_modifier_hook = weechat_hook_modifier ("weechat_print",
-                                                          &mon_modifier_cb, NULL);
+struct t_hook *my_modifier_hook = weechat_hook_modifier ("weechat_print",
+                                                         &my_modifier_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+hook = weechat.hook_modifier(modifier, callback, callback_data)
+
+# exemple
+def my_modifier_cb(data, modifier, modifier_data, string):
+    return "%s xxx" % string
+
+hook = weechat.hook_modifier("weechat_print", "my_modifier_cb", "")
 ----------------------------------------
 
 weechat_hook_modifier_exec
@@ -4900,7 +6060,7 @@ Valeur de retour :
 * chaîne modifiée, NULL si aucun changement n'a été fait dans la chaîne par le
   ou les "modifieurs"
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -4908,6 +6068,17 @@ char *new_string = weechat_hook_modifier_exec ("mon_modifier",
                                                mes_donnees, ma_chaine);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.hook_modifier_exec(modifier, modifier_data, string)
+
+# exemple
+weechat.hook_modifier_exec("mon_modifier", mes_donnees, ma_chaine)
+----------------------------------------
+
 weechat_hook_info
 ^^^^^^^^^^^^^^^^^
 
@@ -4941,21 +6112,35 @@ Valeur de retour :
 
 * pointeur vers le nouveau "hook", NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 const char *
-mon_info_cb (void *data, const char *info_name, const char *arguments)
+my_info_cb (void *data, const char *info_name, const char *arguments)
 {
     /* ... */
     return pointeur_vers_chaine;
 }
 
 /* ajoute l'information "mon_info" */
-struct t_hook *mon_info_hook = weechat_hook_info ("mon_info",
-                                                  "Une information",
-                                                  &mon_info_cb, NULL);
+struct t_hook *my_info_hook = weechat_hook_info ("mon_info",
+                                                 "Une information",
+                                                 &my_info_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+hook = weechat.hook_info(info_name, description, callback, callback_data)
+
+# exemple
+def my_info_cb(data, info_name, arguments):
+    return "some_info"
+
+hook = weechat.hook_info("mon_info", "Une information", "my_info_cb", "")
 ----------------------------------------
 
 weechat_hook_infolist
@@ -4993,13 +6178,13 @@ Valeur de retour :
 
 * pointeur vers le nouveau "hook", NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_infolist *
-mon_infolist_cb (void *data, const char *infolist_name, void *pointer,
-                 const char *arguments)
+my_infolist_cb (void *data, const char *infolist_name, void *pointer,
+                const char *arguments)
 {
     struct t_infolist *mon_infolist;
     
@@ -5010,9 +6195,25 @@ mon_infolist_cb (void *data, const char *infolist_name, void *pointer,
 }
 
 /* ajoute l'infolist "mon_infolist" */
-struct t_hook *mon_infolist = weechat_hook_infolist ("mon_infolist",
-                                                     "Mon infolist",
-                                                     &mon_infolist_cb, NULL);
+struct t_hook *my_infolist = weechat_hook_infolist ("mon_infolist",
+                                                    "Mon infolist",
+                                                    &my_infolist_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+hook = weechat.hook_infolist(infolist_name, description, callback, callback_data)
+
+# exemple
+def my_infolist_cb(data, infolist_name, pointer, arguments):
+    # build infolist
+    # ...
+    return my_infolist
+
+hook = weechat.hook_infolist("mon_infolist", "Mon infolist", "my_infolist_cb", "")
 ----------------------------------------
 
 weechat_unhook
@@ -5031,13 +6232,24 @@ Paramètres :
 
 * 'hook' : quelque chose d'accroché avec "weechat_hook_xxx()"
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-struct t_hook *mon_hook = weechat_hook_command ( /* ... */ );
+struct t_hook *my_hook = weechat_hook_command ( /* ... */ );
 /* ... */
-weechat_unhook (mon_hook);
+weechat_unhook (my_hook);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.unhook(hook)
+
+# exemple
+weechat.unhook(my_hook)
 ----------------------------------------
 
 weechat_unhook_all
@@ -5052,13 +6264,24 @@ Prototype :
 void weechat_unhook_all ();
 ----------------------------------------
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_unhook_all ();
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.unhook_all()
+
+# exemple
+weechat.unhook_all()
+----------------------------------------
+
 [[buffers]]
 Buffers
 ~~~~~~~
@@ -5104,19 +6327,19 @@ Valeur de retour :
 
 * pointeur vers le nouveau tampon, NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-mon_input_cb (void *data, struct t_gui_buffer *buffer, const char *input_data)
+my_input_cb (void *data, struct t_gui_buffer *buffer, const char *input_data)
 {
     weechat_printf (buffer, "Texte : %s", input_data);
     return WEECHAT_RC_OK;
 }
 
 int
-mon_close_cb (void *data, struct t_gui_buffer *buffer)
+my_close_cb (void *data, struct t_gui_buffer *buffer)
 {
     weechat_printf (NULL, "Le tampon '%s' va être fermé !",
                     weechat_buffer_get_string (buffer, "name"));
@@ -5124,8 +6347,28 @@ mon_close_cb (void *data, struct t_gui_buffer *buffer)
 }
 
 struct t_gui_buffer *my_buffer = weechat_buffer_new ("mon_buffer",
-                                                     &mon_input_cb, NULL,
-                                                     &mon_close_cb, NULL);
+                                                     &my_input_cb, NULL,
+                                                     &my_close_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+buffer = weechat.buffer_new(name, input_callback, input_callback_data,
+    close_callback, close_callback_data)
+
+# exemple
+def my_input_cb(data, buffer, input_data):
+    weechat.prnt(buffer, "Texte : %s" % input_data)
+    return weechat.WEECHAT_RC_OK
+
+def my_close_cb(data, buffer):
+    weechat.prnt("", "Le tampon '%s' va être fermé !" % weechat.buffer_get_strinf(buffer, "name"))
+    return weechat.WEECHAT_RC_OK
+
+buffer = weechat.buffer_new("mon_buffer", "my_input_cb", "", "my_close_cb", "")
 ----------------------------------------
 
 weechat_current_buffer
@@ -5145,13 +6388,24 @@ Valeur de retour :
 
 * pointeur vers le tampon courant
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_printf (weechat_current_buffer (), "Texte sur le tampon courant");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+buffer = weechat.current_buffer()
+
+# exemple
+weechat.prnt(weechat.current_buffer(), "Texte sur le tampon courant")
+----------------------------------------
+
 weechat_buffer_search
 ^^^^^^^^^^^^^^^^^^^^^
 
@@ -5175,7 +6429,7 @@ Valeur de retour :
 
 * pointeur vers le tampon trouvé, NULL s'il n'a pas été trouvé
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -5183,6 +6437,17 @@ struct t_gui_buffer *my_buffer = weechat_buffer_search ("mon_extension",
                                                         "mon_tampon");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+buffer = weechat.buffer_search(plugin, name)
+
+# exemple
+buffer = weechat.buffer_search("mon_extension", "mon_tampon")
+----------------------------------------
+
 weechat_buffer_search_main
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -5200,13 +6465,24 @@ Valeur de retour :
 
 * pointeur vers le tampon principal WeeChat (tampon 'core')
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_gui_buffer *weechat_buffer = weechat_buffer_search_main ();
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+buffer = weechat.buffer_search_main()
+
+# exemple
+buffer = weechat.buffer_search_main()
+----------------------------------------
+
 weechat_buffer_clear
 ^^^^^^^^^^^^^^^^^^^^
 
@@ -5223,18 +6499,31 @@ Paramètres :
 
 * 'buffer' : pointeur vers le tampon
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-struct t_gui_buffer *mon_tampon = weechat_buffer_search ("mon_extension",
-                                                         "mon_tampon");
-if (mon_tampon)
+struct t_gui_buffer *my_buffer = weechat_buffer_search ("mon_extension",
+                                                        "mon_tampon");
+if (my_buffer)
 {
     weechat_buffer_clear (my_buffer);
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.buffer_clear(buffer)
+
+# exemple
+buffer = weechat.buffer_search("mon_extension", "mon_tampon")
+if buffer != "":
+    weechat.buffer_clear(buffer)
+----------------------------------------
+
 weechat_buffer_close
 ^^^^^^^^^^^^^^^^^^^^
 
@@ -5251,15 +6540,28 @@ Paramètres :
 
 * 'buffer' : pointeur vers le tampon
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-struct t_gui_buffer *mon_tampon = weechat_buffer_new ("mon_tampon",
-                                                      &mon_input_cb, NULL,
-                                                      &mon_close_cb, NULL);
+struct t_gui_buffer *my_buffer = weechat_buffer_new ("mon_tampon",
+                                                     &my_input_cb, NULL,
+                                                     &my_close_cb, NULL);
 /* ... */
-weechat_buffer_close (mon_tampon);
+weechat_buffer_close (my_buffer);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.buffer_close(buffer)
+
+# exemple
+buffer = weechat.buffer_new("mon_tampon", "my_input_cb", "", "my_close_cb", "")
+# ...
+weechat.buffer_close(buffer)
 ----------------------------------------
 
 weechat_buffer_merge
@@ -5282,15 +6584,27 @@ Paramètres :
 * 'buffer' : pointeur vers le tampon
 * 'target_buffer' : tampon cible avec lequel on doit mélanger
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-/* mélange le tampon courant avec le tampon "core" */
+/* mélanger le tampon courant avec le tampon "core" */
 weechat_buffer_merge (weechat_current_buffer (),
                       weechat_buffer_search_main ());
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.buffer_merge(buffer, target_buffer)
+
+# exemple
+# mélanger le tampon courant avec le tampon "core"
+weechat.buffer_merge(weechat.current_buffer(), weechat.buffer_search_main())
+----------------------------------------
+
 weechat_buffer_unmerge
 ^^^^^^^^^^^^^^^^^^^^^^
 
@@ -5310,13 +6624,24 @@ Paramètres :
 * '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 :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_buffer_unmerge (weechat_current_buffer (), 1);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.buffer_unmerge(buffer, number)
+
+# exemple
+weechat.buffer_unmerge(weechat.current_buffer(), 1)
+----------------------------------------
+
 weechat_buffer_get_integer
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -5353,7 +6678,7 @@ Valeur de retour :
 
 * valeur entière de la propriété
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -5361,6 +6686,17 @@ weechat_printf (NULL, "mon numéro de tampon est : %d",
                 weechat_buffer_get_integer (mon_tampon, "number"));
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+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_buffer_get_string
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -5391,15 +6727,28 @@ Valeur de retour :
 
 * valeur de la propriété, sous forme de chaîne
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-weechat_printf (NULL, "name / short name of buffer are : %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):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.buffer_get_string(buffer, property)
+
+# exemple
+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")))
+----------------------------------------
+
 weechat_buffer_get_pointer
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -5424,7 +6773,7 @@ Valeur de retour :
 
 * valeur de la propriété, sous forme de pointeur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -5432,6 +6781,17 @@ weechat_printf (NULL, "pointeur vers l'extension de mon tampon : %lx",
                 weechat_buffer_get_pointer (mon_tampon, "plugin"));
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.buffer_get_pointer(buffer, property)
+
+# exemple
+weechat.prnt("", "pointeur vers l'extension de mon tampon : %lx" % weechat.buffer_get_pointer(my_buffer, "plugin"))
+----------------------------------------
+
 weechat_buffer_set
 ^^^^^^^^^^^^^^^^^^
 
@@ -5539,26 +6899,51 @@ Paramètres :
   supprime la variable locale 'xxx'
 |========================================
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-/* désactive la hotlist (pour tous les tampons) */
+/* désactiver la hotlist (pour tous les tampons) */
 weechat_buffer_set (NULL, "hotlist", "-");
 
-/* active à nouveaula hotlist */
+/* activer à nouveaula hotlist */
 weechat_buffer_set (NULL, "hotlist", "+");
 
-/* change le nom du tampon */
+/* changer le nom du tampon */
 weechat_buffer_set (mon_tampon, "name", "nouveau_nom");
 
-/* ajoute une variable locale "toto" avec la valeur "abc" */
+/* ajouter une variable locale "toto" avec la valeur "abc" */
 weechat_buffer_set (mon_tampon, "localvar_set_toto", "abc");
 
-/* supprime la variable locale "toto" */
+/* supprimer la variable locale "toto" */
 weechat_buffer_set (mon_tampon, "localvar_del_toto", NULL);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.buffer_set(buffer, property, value)
+
+# exemples
+
+# désactiver la hotlist (pour tous les tampons)
+weechat.buffer_set("", "hotlist", "-")
+
+# activer à nouveau la hotlist
+weechat.buffer_set("", "hotlist", "+")
+
+# changer le nom du tampon
+weechat.buffet_set(my_buffer, "name", "my_new_name")
+
+# ajouter une variable locale "toto" avec la valeur "abc"
+weechat.buffet_set(my_buffer, "localvar_set_toto", "abc")
+
+# supprimer la variable locale "toto"
+weechat.buffet_set(my_buffer, "localvar_del_toto", "")
+----------------------------------------
+
 weechat_buffer_set_pointer
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -5584,18 +6969,18 @@ Paramètres :
 ** 'input_callback_data' : définit les données pour le "callback" des données
    en entrée
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-mon_close_cb (void *data, struct t_gui_buffer *buffer)
+my_close_cb (void *data, struct t_gui_buffer *buffer)
 {
     /* ... */
     return WEECHAT_RC_OK;
 }
 
-weechat_buffer_set_pointer (mon_tampon, "close_callback", &mon_close_cb);
+weechat_buffer_set_pointer (mon_tampon, "close_callback", &my_close_cb);
 ----------------------------------------
 
 weechat_buffer_string_replace_local_var
@@ -5621,7 +7006,7 @@ Valeur de retour :
 
 * chaîne avec les valeurs des variables locales
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -5632,6 +7017,19 @@ char *str = weechat_buffer_string_replace_local_var (mon_tampon,
 /* str contient "test avec abc" */
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.buffer_string_replace_local_var(buffer, string)
+
+# exemple
+weechat.buffer_set(my_buffer, "localvar_set_toto", "abc")
+str = weechat.buffer_string_replace_local_var(my_buffer, "test avec $toto")
+# str contient "test avec abc"
+----------------------------------------
+
 [[windows]]
 Fenêtres
 ~~~~~~~~
@@ -5654,13 +7052,24 @@ Valeur de retour :
 
 * pointeur vers la fenêtre courante
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_gui_window *current_window = weechat_current_window ();
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+window = weechat.current_window()
+
+# exemple
+current_window = weechat.current_window()
+----------------------------------------
+
 weechat_window_get_integer
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -5707,7 +7116,7 @@ Valeur de retour :
 
 * valeur entière de la propriété
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -5716,6 +7125,19 @@ weechat_printf (NULL, "la fenêtre courante est en position (x,y) : (%d,%d)",
                 weechat_window_get_integer (weechat_current_window (), "win_y"));
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.window_get_integer(window, property)
+
+# exemple
+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")))
+----------------------------------------
+
 weechat_window_get_string
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -5766,7 +7188,7 @@ Valeur de retour :
 
 * valeur de la propriété, sous forme de pointeur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -5775,6 +7197,52 @@ weechat_printf (NULL,
                 weechat_window_get_pointer (weechat_current_window (), "buffer"));
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.window_get_pointer(window, property)
+
+# exemple
+weechat.prnt("", "tampon affiché dans la fenêtre courante : %lx"
+    % weechat.window_get_pointer(weechat.current_window(), "buffer"))
+----------------------------------------
+
+weechat_window_set_title
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Définit le titre du terminal.
+
+Prototype :
+
+[source,C]
+----------------------------------------
+void weechat_window_set_title (const char *title);
+----------------------------------------
+
+Paramètres :
+
+* 'title': nouveau titre pour le terminal (NULL pour réinitialiser le titre)
+
+Exemple en C :
+
+[source,C]
+----------------------------------------
+weechat_window_set_title ("nouveau titre ici");
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.window_set_title(window, title)
+
+# exemple
+weechat.window_set_title("nouveau titre ici")
+----------------------------------------
+
 [[nicklist]]
 Nicklist
 ~~~~~~~~
@@ -5825,18 +7293,30 @@ Valeur de retour :
 
 * pointeur vers le nouveau groupe, NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-struct t_gui_nick_group *mon_group =
-    weechat_nicklist_add_group (mon_tampon,
-                                mon_groupe_parent,
+struct t_gui_nick_group *my_group =
+    weechat_nicklist_add_group (my_buffer,
+                                my_parent_group,
                                 "groupe_test",
                                 "weechat.color.nicklist_group",
                                 1);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+group = weechat.nicklist_add_group(buffer, parent_group, name, color, visible)
+
+# exemple
+group = weechat.nicklist_add_group(my_buffer, my_parent_group, "groupe_test",
+    "weechat.color.nicklist_group", 1)
+----------------------------------------
+
 weechat_nicklist_search_group
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -5862,12 +7342,23 @@ Valeur de retour :
 
 * pointeur vers le groupe trouvé, NULL s'il n'est pas trouvé
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_gui_nick_group *ptr_group = weechat_nicklist_search_group (my_buffer,
-                                                                    NULL, "test_group");
+                                                                    NULL, "groupe_test");
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+group = weechat.nicklist_search_group(buffer, from_group, name)
+
+# exemple
+group = weechat.nicklist_search_group(my_buffer, "", "groupe_test")
 ----------------------------------------
 
 weechat_nicklist_add_nick
@@ -5916,7 +7407,7 @@ Valeur de retour :
 
 * pointeur vers le nouveau pseudo, NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -5928,6 +7419,21 @@ struct t_gui_nick *my_nick =
                                1);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+nick = weechat.nicklist_add_nick(buffer, group, name, color, prefix, prefix_color, visible)
+
+# exemple
+if nick_away:
+    color = "weechat.color.nicklist_away"
+else:
+    color = "bar_fg"
+nick = weechat.nicklist_add_nick(my_buffer, my_group, "test_nick", color, "@", "lightgreen", 1)
+----------------------------------------
+
 weechat_nicklist_search_nick
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -5953,7 +7459,7 @@ Valeur de retour :
 
 * pointeur vers le pseudo trouvé, NULL s'il n'est pas trouvé
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -5961,6 +7467,17 @@ struct t_gui_nick *ptr_nick = weechat_nicklist_search_nick (my_buffer,
                                                             NULL, "test_nick");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+nick = weechat.nicklist_search_nick(buffer, from_group, name)
+
+# exemple
+nick = weechat.nicklist_search_nick(my_buffer, "", "test_nick")
+----------------------------------------
+
 weechat_nicklist_remove_group
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -5980,13 +7497,24 @@ Paramètres :
 * 'group' : pointeur vers le groupe à supprimer (tous les sous-groupes/pseudos
   seront supprimés également)
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_nicklist_remove_group (my_buffer, my_group);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.nicklist_remove_group(buffer, group)
+
+# exemple
+weechat.nicklist_remove_group(my_buffer, my_group)
+----------------------------------------
+
 weechat_nicklist_remove_nick
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -6005,13 +7533,24 @@ Paramètres :
 * 'buffer' : pointeur vers le tampon
 * 'nick' : pointeur vers le pseudo à supprimer
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_nicklist_remove_nick (my_buffer, my_nick);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.nicklist_remove_nick(buffer, nick)
+
+# exemple
+weechat.nicklist_remove_nick(my_buffer, my_nick)
+----------------------------------------
+
 weechat_nicklist_remove_all
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -6028,13 +7567,24 @@ Paramètres :
 
 * 'buffer' : pointeur vers le tampon
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_nicklist_remove_all (my_buffer);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.nicklist_remove_all(buffer)
+
+# exemple
+weechat.nicklist_remove_all(my_buffer)
+----------------------------------------
+
 [[bars]]
 Barres
 ~~~~~~
@@ -6061,13 +7611,24 @@ Valeur de retour :
 
 * pointeur vers l'objet de barre trouvé, NULL s'il n'a pas été trouvé
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_gui_bar_item *bar_item = weechat_bar_item_search ("myitem");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+bar_item = weechat.bar_item_search(name)
+
+# exemple
+bar_item = weechat.bar_item_search("myitem")
+----------------------------------------
+
 weechat_bar_item_new
 ^^^^^^^^^^^^^^^^^^^^
 
@@ -6096,23 +7657,37 @@ Valeur de retour :
 
 * pointeur vers le nouvel objet de barre, NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 char *
-mon_callback (void *data,
-              struct t_gui_bar_item *item,
-              struct t_gui_window *window)
+my_build_callback (void *data,
+                   struct t_gui_bar_item *item,
+                   struct t_gui_window *window)
 {
     return strdup ("mon contenu");
 }
 
-struct t_gui_bar_item *my_item = weechat_bar_item_new ("monobjet",
-                                                       &mon_callback,
+struct t_gui_bar_item *my_item = weechat_bar_item_new ("myitem",
+                                                       &my_build_callback,
                                                        NULL);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+bar_item = weechat.bar_item_new(name, build_callback, build_callback_data)
+
+# exemple
+def my_build_callback(data, item, window):
+    return "my content"
+
+bar_item = weechat.bar_item_new("myitem", "my_build_callback", "")
+----------------------------------------
+
 weechat_bar_item_update
 ^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -6130,11 +7705,22 @@ Paramètres :
 
 * 'name' : nom de l'objet de barre
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-weechat_bar_item_update ("monobjet");
+weechat_bar_item_update ("myobjet");
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.bar_item_update(name)
+
+# exemple
+weechat.bar_item_update("myitem")
 ----------------------------------------
 
 weechat_bar_item_remove
@@ -6153,13 +7739,24 @@ Paramètres :
 
 * 'item' : bar item pointer
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_bar_item_remove (&my_item);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.bar_item_remove(item)
+
+# exemple
+weechat.bar_item_remove(myitem)
+----------------------------------------
+
 weechat_bar_search
 ^^^^^^^^^^^^^^^^^^
 
@@ -6180,13 +7777,24 @@ Valeur de retour :
 
 * pointeur vers la barre trouvée, NULL si elle n'est pas trouvée
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_gui_bar *bar = weechat_bar_search ("my_barre");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+bar = weechat.bar_search(name)
+
+# exemple
+bar = weechat.bar_search("mybar")
+----------------------------------------
+
 weechat_bar_new
 ^^^^^^^^^^^^^^^
 
@@ -6263,7 +7871,7 @@ Valeur de retour :
 
 * pointeur vers la nouvelle barre, NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -6284,6 +7892,20 @@ struct t_gui_bar *my_bar = weechat_bar_new ("mybar",
                                             "time,buffer_number+buffer_name");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+bar = weechat.bar_new(name, hidden, priority, type, condition, position,
+    filling_top_bottom, filling_left_right, size, size_max,
+    color_fg, color_delim, color_bg, separator, items)
+
+# exemple
+bar = weechat.bar_new("mybar", "off", 100, "window", "", "top", "horizontal", "vertical",
+    "0", "5", "default", "cyan", "blue", "off", "time,buffer_number+buffer_name")
+----------------------------------------
+
 weechat_bar_set
 ^^^^^^^^^^^^^^^
 
@@ -6309,11 +7931,22 @@ Valeur de retour :
 
 * 1 si la valeur a été affectée, 0 en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-weechat_bar_set (ma_barre, "position", "bottom");
+weechat_bar_set (my_bar, "position", "bottom");
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.bar_set(bar, property, value)
+
+# exemple
+weechat.bar_set(my_bar, "position", "bottom")
 ----------------------------------------
 
 weechat_bar_update
@@ -6332,11 +7965,22 @@ Paramètres :
 
 * 'name' : nom de la barre
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-weechat_bar_update ("ma_barre");
+weechat_bar_update ("mybar");
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.bar_update(name)
+
+# exemple
+weechat.bar_update("mybar")
 ----------------------------------------
 
 weechat_bar_remove
@@ -6355,11 +7999,22 @@ Paramètres :
 
 * 'bar' : pointeur vers la barre
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-weechat_bar_remove (ma_barre);
+weechat_bar_remove (my_bar);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.bar_remove(bar)
+
+# exemple
+weechat.bar_remove(my_bar)
 ----------------------------------------
 
 [[commands]]
@@ -6387,7 +8042,7 @@ Paramètres :
 * 'command' : commande à exécuter (si elle commence par "/"), ou texte à
   envoyer au tampon
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -6395,6 +8050,17 @@ weechat_command (weechat_buffer_search ("irc", "freenode.#weechat"),
                  "/whois FlashCode");
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.command(buffer, command)
+
+# exemple
+weechat.command(weechat.buffer_search("irc", "freenode.#weechat"), "/whois FlashCode")
+----------------------------------------
+
 [[network]]
 Réseau
 ~~~~~~
@@ -6427,7 +8093,7 @@ Valeur de retour :
 
 * 1 si la connexion est ok, 0 en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -6467,7 +8133,7 @@ Valeur de retour :
 
 * 1 si la connexion est ok, 0 en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -6520,7 +8186,7 @@ Valeur de retour :
 
 * chaîne avec l'information demandée, NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -6531,6 +8197,19 @@ weechat_printf (NULL, "Le répertoire de WeeChat est : %s",
                 weechat_info_get ("weechat_dir"));
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.info_get(info_name, arguments)
+
+# exemple
+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"))
+----------------------------------------
+
 [[infolists]]
 Infolists
 ~~~~~~~~~
@@ -6567,13 +8246,24 @@ Valeur de retour :
 
 * pointeur vers la nouvelle "infolist"
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_infolist *infolist = weechat_infolist_new ();
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+infolist = weechat.infolist_new()
+
+# exemple
+infolist = weechat.infolist_new()
+----------------------------------------
+
 weechat_infolist_new_item
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -6594,13 +8284,24 @@ Valeur de retour :
 
 * pointeur vers le nouvel objet
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_infolist_item *item = weechat_infolist_new_item (infolist);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+item = weechat.infolist_new_item(infolist)
+
+# exemple
+item = weechat.infolist_new_item(infolist)
+----------------------------------------
+
 weechat_infolist_new_var_integer
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -6625,13 +8326,24 @@ Valeur de retour :
 
 * pointeur vers la nouvelle variable
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-struct t_infolist_var *var = weechat_infolist_new_variable_integer (item,
-                                                                    "mon_entier",
-                                                                    123);
+struct t_infolist_var *var = weechat_infolist_new_var_integer (item,
+                                                               "mon_entier",
+                                                               123);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+var = weechat.infolist_new_var_integer(item, name, value)
+
+# exemple
+var = weechat.infolist_new_var_integer(item, "mon_entier", 123)
 ----------------------------------------
 
 weechat_infolist_new_var_string
@@ -6658,13 +8370,24 @@ Valeur de retour :
 
 * pointeur vers la nouvelle variable
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-struct t_infolist_var *var = weechat_infolist_new_variable_integer (item,
-                                                                    "ma_chaine",
-                                                                    "valeur");
+struct t_infolist_var *var = weechat_infolist_new_var_string (item,
+                                                              "ma_chaine",
+                                                              "valeur");
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+var = weechat.infolist_new_var_string(item, name, value)
+
+# exemple
+var = weechat.infolist_new_var_string(item, "ma_chaine", "valeur")
 ----------------------------------------
 
 weechat_infolist_new_var_pointer
@@ -6691,13 +8414,24 @@ Valeur de retour :
 
 * pointeur vers la nouvelle variable
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-struct t_infolist_var *var = weechat_infolist_new_variable_pointer (item,
-                                                                    "mon_pointer",
-                                                                    xo&quelque_chose);
+struct t_infolist_var *var = weechat_infolist_new_var_pointer (item,
+                                                               "mon_pointeur",
+                                                               &pointer);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+var = weechat.infolist_new_var_pointer(item, name, pointer)
+
+# exemple
+var = weechat.infolist_new_var_pointer(item, "mon_pointeur", pointer)
 ----------------------------------------
 
 weechat_infolist_new_var_buffer
@@ -6726,16 +8460,16 @@ Valeur de retour :
 
 * pointeur vers la nouvelle variable
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 char buffer[256];
 /* ... */
-struct t_infolist_var *var = weechat_infolist_new_variable_buffer (item,
-                                                                   "mon_buffer",
-                                                                   &buffer,
-                                                                   sizeof (buffer));
+struct t_infolist_var *var = weechat_infolist_new_var_buffer (item,
+                                                              "mon_buffer",
+                                                              buffer,
+                                                              sizeof (buffer));
 ----------------------------------------
 
 weechat_infolist_new_var_time
@@ -6762,13 +8496,24 @@ Valeur de retour :
 
 * pointeur vers la nouvelle variable
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-struct t_infolist_var *var = weechat_infolist_new_variable_time (item,
-                                                                 "mon_time",
-                                                                 time (NULL));
+struct t_infolist_var *var = weechat_infolist_new_var_time (item,
+                                                            "mon_time",
+                                                            time (NULL));
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+var = weechat.infolist_new_var_time(item, name, time)
+
+# exemple
+var = weechat.infolist_new_var_time(item, "mon_time", int(time.time()))
 ----------------------------------------
 
 weechat_infolist_get
@@ -6798,13 +8543,24 @@ Valeur de retour :
 
 * pointeur vers l'infolist, NULL en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_infolist *infolist = weechat_infolist_get ("irc_server", NULL, NULL);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+infolist = weechat.infolist_get(infolist_name, pointer, arguments)
+
+# exemple
+infolist = weechat.infolist_get("irc_server, "", "")
+----------------------------------------
+
 weechat_infolist_next
 ^^^^^^^^^^^^^^^^^^^^^
 
@@ -6828,7 +8584,7 @@ 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 :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -6842,6 +8598,21 @@ else
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+rc = weechat.infolist_next(infolist)
+
+# exemple
+rc = weechat.infolist_next(infolist)
+if rc:
+    # lecture des variables dans l'objet...
+else:
+    # pas d'autre objet disponible
+----------------------------------------
+
 weechat_infolist_prev
 ^^^^^^^^^^^^^^^^^^^^^
 
@@ -6865,7 +8636,7 @@ 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 :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -6879,6 +8650,21 @@ else
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+rc = weechat.infolist_prev(infolist)
+
+# exemple
+rc = weechat.infolist_prev(infolist)
+if rc:
+    # lecture des variables dans l'objet
+else:
+    # pas d'autre objet disponible
+----------------------------------------
+
 weechat_infolist_reset_item_cursor
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -6895,13 +8681,24 @@ Paramètres :
 
 * 'infolist' : pointeur vers l'infolist
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_infolist_reset_item_cursor (infolist);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.infolist_reset_item_cursor(infolist)
+
+# exemple
+weechat.infolist_reset_item_cursor(infolist)
+----------------------------------------
+
 weechat_infolist_fields
 ^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -6925,7 +8722,7 @@ Valeur de retour :
   variable. Les types sont : "i" (nombre entier), "s" (chaîne), "p" (pointeur),
   "b" (buffer), "t" (date/heure).
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -6934,6 +8731,19 @@ const char *fields = weechat_infolist_fields (infolist);
    "i:mon_entier,s:ma_chaine,p:mon_pointeur,b:mon_buffer,t:ma_date" */
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+fields = weechat.infolist_fields(infolist)
+
+# exemple
+fields = weechat.infolist_fields(infolist)
+# fields contient quelque chose comme :
+# "i:mon_entier,s:ma_chaine,p:mon_pointeur,b:mon_buffer,t:ma_date"
+----------------------------------------
+
 weechat_infolist_integer
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -6956,7 +8766,7 @@ Valeur de retour :
 
 * valeur de la variable, sous forme d'entier
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -6964,6 +8774,17 @@ weechat_printf (NULL, "entier = %d",
                 weechat_infolist_integer (infolist, "mon_entier"));
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.infolist_integer(infolist, var)
+
+# exemple
+weechat.prnt("", "entier = %d" % weechat.infolist_integer(infolist, "mon_entier"))
+----------------------------------------
+
 weechat_infolist_string
 ^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -6986,7 +8807,7 @@ Valeur de retour :
 
 * valeur de la variable, sous forme de chaîne
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -6994,6 +8815,17 @@ weechat_printf (NULL, "chaîne = %s",
                 weechat_infolist_string (infolist, "ma_chaine"));
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.infolist_string(infolist, var)
+
+# exemple
+weechat.prnt("", "chaîne = %s" % weechat.infolist_string(infolist, "ma_chaine"))
+----------------------------------------
+
 weechat_infolist_pointer
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -7016,12 +8848,23 @@ Valeur de retour :
 
 * valeur de la variable, sous forme de pointeur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_printf (NULL, "pointeur = 0x%lx",
-                weechat_infolist_pointer (infolist, "mon_pointer"));
+                weechat_infolist_pointer (infolist, "mon_pointeur"));
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.infolist_pointer(infolist, var)
+
+# exemple
+weechat.prnt("", "pointeur = 0x%lx" % weechat.infolist_pointer(infolist, "mon_pointeur"))
 ----------------------------------------
 
 weechat_infolist_buffer
@@ -7049,7 +8892,7 @@ Valeur de retour :
 
 * pointeur vers le "buffer"
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -7081,14 +8924,25 @@ Valeur de retour :
 
 * valeur de la variable, sous forme de date/heure
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
-weechat_printf (NULL, "date/heure = 0x%ld",
+weechat_printf (NULL, "date/heure = %ld",
                 weechat_infolist_time (infolist, "mon_time"));
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+value = weechat.infolist_time(infolist, var)
+
+# exemple
+weechat.prnt("", "date/heure = %ld" % weechat.infolist_time(infolist, "mon_time"))
+----------------------------------------
+
 weechat_infolist_free
 ^^^^^^^^^^^^^^^^^^^^^
 
@@ -7105,13 +8959,24 @@ Paramètres :
 
 * 'infolist' : pointeur vers l'infolist
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_infolist_free (infolist);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.infolist_free(infolist)
+
+# exemple
+weechat.infolist_free(infolist)
+----------------------------------------
+
 [[upgrade]]
 Mise à jour
 ~~~~~~~~~~~
@@ -7142,13 +9007,24 @@ Valeur de retour :
 
 * pointeur vers le fichier de mise à jour
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 struct t_upgrade_file *upgrade_file = weechat_upgrade_new ("mon_fichier", 1);
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+upgrade_file = weechat.upgrade_new(filename, write)
+
+# exemple
+upgrade_file = weechat.upgrade_new("mon_fichier", 1)
+----------------------------------------
+
 weechat_upgrade_write_object
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -7173,7 +9049,7 @@ Valeur de retour :
 
 * 1 si ok, 0 en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
@@ -7187,6 +9063,17 @@ else
 }
 ----------------------------------------
 
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.upgrade_write_object(upgrade_file, object_id, infolist)
+
+# exemple
+weechat.upgrade_write_object(upgrade_file, 1, infolist)
+----------------------------------------
+
 weechat_upgrade_read
 ^^^^^^^^^^^^^^^^^^^^
 
@@ -7216,20 +9103,35 @@ Valeur de retour :
 
 * 1 si ok, 0 en cas d'erreur
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 int
-mon_upgrade_read_cb (struct t_upgrade_file *upgrade_file,
-                     int object_id,
-                     struct t_infolist *infolist)
+my_upgrade_read_cb (struct t_upgrade_file *upgrade_file,
+                    int object_id,
+                    struct t_infolist *infolist)
 {
     /* lecture des variables... */
     return WEECHAT_RC_OK;
 }
 
-weechat_upgrade_read (upgrade_file, &mon_upgrade_read_cb, NULL);
+weechat_upgrade_read (upgrade_file, &my_upgrade_read_cb, NULL);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.upgrade_read(upgrade_file, callback_read, callback_read_data)
+
+# exemple
+def my_upgrade_read_cb(upgrade_file, object_id, infolist):
+    # read variables...
+    return weechat.WEECHAT_RC_OK
+
+weechat.upgrade_read(upgrade_file, "my_upgrade_read_cb", ""))
 ----------------------------------------
 
 weechat_upgrade_close
@@ -7248,9 +9150,20 @@ Paramètres :
 
 * 'upgrade_file' : pointeur vers le fichier de mise à jour
 
-Exemple :
+Exemple en C :
 
 [source,C]
 ----------------------------------------
 weechat_upgrade_close (upgrade_file);
 ----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# prototype
+weechat.upgrade_close(upgrade_file)
+
+# exemple
+weechat.upgrade_close(upgrade_file)
+----------------------------------------