Update script API in doc (developer guide)

2 files changed, 218 insertions, 2622 deletions

diff --git a/doc/fr/dev/plugin_api.fr.xml b/doc/fr/dev/plugin_api.fr.xml
index 2710aec03..9ccfa416e 100644
--- a/doc/fr/dev/plugin_api.fr.xml
+++ b/doc/fr/dev/plugin_api.fr.xml
@@ -26,6 +26,6 @@ along with this program.  If not, see <http://www.gnu.org/licenses/>.
   
   &plugin_c_api.fr.xml;
   
-  <!-- &plugin_script_api.fr.xml; -->
+  &plugin_script_api.fr.xml;
   
 </chapter>
diff --git a/doc/fr/dev/plugin_script_api.fr.xml b/doc/fr/dev/plugin_script_api.fr.xml
index 97cd230e9..508ab36d0 100644
--- a/doc/fr/dev/plugin_script_api.fr.xml
+++ b/doc/fr/dev/plugin_script_api.fr.xml
@@ -25,8 +25,8 @@ along with this program.  If not, see <http://www.gnu.org/licenses/>.
   <title>Extensions pour scripts</title>
   
   <para>
-    Quatre extensions sont fournies en standard avec WeeChat pour utiliser
-    des langages de script : Perl, Python, Ruby et Lua.
+    Cinq extensions sont fournies en standard avec WeeChat pour utiliser
+    des langages de script : Perl, Python, Ruby, Lua et Tcl.
   </para>
   
   <section id="secChargerDechargerScripts">
@@ -35,9 +35,9 @@ along with this program.  If not, see <http://www.gnu.org/licenses/>.
     <para>
       Les scripts sont chargés et déchargés avec les commandes
       <command>/perl</command>, <command>/python</command>,
-      <command>/ruby</command> et <command>/lua</command>
-      (tapez <command>/help</command> dans WeeChat pour obtenir
-      de l'aide sur les commandes).
+      <command>/ruby</command>, <command>/lua</command>
+      et <command>/tcl</command> (tapez <command>/help</command> dans WeeChat
+      pour obtenir de l'aide sur les commandes).
     </para>
     
     <para>
@@ -91,6 +91,18 @@ along with this program.  If not, see <http://www.gnu.org/licenses/>.
             <command><userinput>/lua</userinput></command>
           </para>
         </listitem>
+        <listitem>
+          <para>
+            Charger un script Tcl :
+            <command><userinput>/tcl load /tmp/essai.tcl</userinput></command>
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Lister les scripts Tcl chargés :
+            <command><userinput>/tcl</userinput></command>
+          </para>
+        </listitem>
       </itemizedlist>
     </para>
     
@@ -106,7 +118,10 @@ along with this program.  If not, see <http://www.gnu.org/licenses/>.
         Dans un script Perl WeeChat, toutes les fonctions et variables
         de l'interface sont préfixées par "<literal>weechat::</literal>".
         Exemple :
-<screen>weechat::register("test", "1.0", "end_test", "Script perl WeeChat");</screen>
+<screen>
+weechat::register("test", "Auteur &lt;auteur\@domaine.com&gt;", "1.0",
+                  "GPL3", "Description du script", "au_revoir", "");
+</screen>
       </para>
       
     </section>
@@ -123,7 +138,10 @@ along with this program.  If not, see <http://www.gnu.org/licenses/>.
         Toutes les fonctions et variables de l'interface sont préfixées
         par "<literal>weechat.</literal>".
         Exemple :
-<screen>weechat.register("test", "1.0", "end_test", "Script python WeeChat")</screen>
+<screen>
+weechat.register("test", "Auteur &lt;auteur@domaine.com&gt;", "1.0",
+                 "GPL3", "Description du script", "au_revoir", "")
+</screen>
       </para>
       
     </section>
@@ -139,14 +157,9 @@ along with this program.  If not, see <http://www.gnu.org/licenses/>.
         Exemple :
 <screen>
 def weechat_init
-    Weechat.register("test", "1.0", "end_test", "Script ruby WeeChat")
-    Weechat.add_command_handler("commande", "ma_commande")
-    return Weechat::PLUGIN_RC_OK
-end
-
-def ma_commande(server, args)
-    Weechat.print("ma commande")
-    return Weechat::PLUGIN_RC_OK
+    Weechat.register("test", "Auteur &lt;auteur@domaine.com&gt;", "1.0",
+                     "GPL3", "Description du script", "au_revoir", "")
+    return Weechat::WEECHAT_RC_OK
 end
 </screen>
       </para>
@@ -169,2705 +182,288 @@ end
         suffixées par "<literal>()</literal>".
         Exemple :
 <screen>
-function message_handler(server, args)
-   weechat.print("Je suis un message handler")
-   return weechat.PLUGIN_RC_OK()
-end
-</screen>
-      </para>
-      
-    </section>
-    
-  </section>
-  
-  <section id="secInterfaceWeeChatScripts">
-    <title>Interface WeeChat / scripts</title>
-    
-    <section id="sec_script_register">
-      <title>register</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::register(nom, version, fonction_de_fin, description,
-          [charset]);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.register(nom, version, fonction_de_fin, description,
-          [charset])
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.register(nom, version, fonction_de_fin, description,
-          [charset])
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.register(nom, version, fonction_de_fin, description,
-          [charset])
-        </command>
-      </para>
-      <para>
-        C'est la première fonction à appeler dans le script.
-        Tout script pour WeeChat doit appeler cette fonction.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>nom</option> : nom unique pour identifier le script
-              (chaque script doit avoir un nom différent)
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>version</option> : version du script
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>fonction_de_fin</option> : fonction appelée quand
-              le script est déchargé (paramètre facultatif, une chaîne
-              vide signifiant qu'il n'y a pas de fonction à appeler)
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>description</option> : brève description du script
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>charset</option> : jeu de caractères du script, à
-              préciser si le script n'est pas écrit en UTF-8
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si le script a été enregistré, 0 si une erreur
-        s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::register("essai", "1.0", "fin_essai", "Script d'essai !", "ISO-8859-1");
-
-# python
-weechat.register("essai", "1.0", "fin_essai", "Script d'essai !", "ISO-8859-1")
-
-# ruby
-Weechat.register("essai", "1.0", "fin_essai", "Script d'essai !", "ISO-8859-1")
-
--- lua
-weechat.register("essai", "1.0", "fin_essai", "Script d'essai !", "ISO-8859-1")
-</screen>
-      </para>
-    </section>
-    
-    <section id="sec_script_set_charset">
-      <title>set_charset</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::set_charset(charset);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.set_charset(charset)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.set_charsetr(charset)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.set_charset(charset)
-        </command>
-      </para>
-      <para>
-        Change le jeu de caractères du script.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>charset</option> : nouveau jeu de caractères
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si le nouveau jeu de caractères a été
-        mis en place, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::set_charset("ISO-8859-1");
-
-# python
-weechat.set_charset("ISO-8859-1")
-
-# ruby
-Weechat.set_charset("ISO-8859-1")
-
--- lua
-weechat.set_charset("ISO-8859-1")
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_print">
-      <title>print</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::print(message, [canal, [serveur]])
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.prnt(message, [canal, [serveur]])
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.print(message, [canal, [serveur]])
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.print(message, [canal, [serveur]])
-        </command>
-      </para>
-      <para>
-        Affiche un message sur un tampon WeeChat, identifié par le
-        serveur et le canal.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>message</option> : message à afficher
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>canal</option> : nom du canal pour trouver le
-              tampon dans lequel afficher
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>serveur</option> : nom interne du serveur pour
-              trouver le tampon dans lequel afficher
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Pour afficher du texte en couleur, voir
-        <xref linkend="secAPI_print" />.
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::print("message");
-weechat::print("message", "#weechat");
-weechat::print("message", "#weechat", "freenode");
-weechat::print("test: \x0305 rouge \x0F normal");
-
-# python
-weechat.prnt("message")
-weechat.prnt("message", "#weechat")
-weechat.prnt("message", "#weechat", "freenode")
-
-# ruby
-Weechat.print("message")
-Weechat.print("message", "#weechat")
-Weechat.print("message", "#weechat", "freenode")
-
--- lua
-weechat.print("message")
-weechat.print("message", "#weechat")
-weechat.print("message", "#weechat", "freenode")
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_print_server">
-      <title>print_server</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::print_server(message)
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.print_server(message)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.print_server(message)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.print_server(message)
-        </command>
-      </para>
-      <para>
-        Affiche un message sur le tampon serveur.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>message</option> : message à afficher
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Pour afficher du texte en couleur, voir
-        <xref linkend="secAPI_print" />.
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::print_server("message");
-weechat::print_server("test: \x0305 rouge \x0F normal");
-
-# python
-weechat.print_server("message")
-
-# ruby
-Weechat.print_server("message")
-
--- lua
-weechat.print_server("message")
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_log">
-      <title>log</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::log(message, [canal, [serveur]]);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.log(message, [canal, [serveur]])
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.log(message, [canal, [serveur]])
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.log(message, [canal, [serveur]])
-        </command>
-      </para>
-      <para>
-        Ecrit un message dans le fichier de log pour un serveur ou un
-        canal.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>message</option> : message
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>canal</option> : nom du canal pour trouver le
-              log du tampon
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>serveur</option> : nom interne du serveur pour
-              trouver le log du tampon
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::log("message", "#weechat", "freenode");
-
-# python
-weechat.log("message", "#weechat", "freenode")
-
-# ruby
-Weechat.log("message", "#weechat", "freenode")
-
--- lua
-weechat.log("message", "#weechat", "freenode")
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_add_message_handler">
-      <title>add_message_handler</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::add_message_handler(message, fonction);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.add_message_handler(message, fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.add_message_handler(message, fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.add_message_handler(message, fonction)
-        </command>
-      </para>
-      <para>
-        Ajoute un gestionnaire de messages IRC, appelé dès qu'un message
-        IRC est reçu.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>message</option> : nom du message IRC pour lequel la
-              fonction est appelée.
-              Pour connaître la liste des messages IRC disponibles, merci
-              de consulter les <acronym>RFC</acronym>s
-              <ulink url="http://www.ietf.org/rfc/rfc1459.txt">1459</ulink>
-              et
-              <ulink url="http://www.ietf.org/rfc/rfc2812.txt">2812</ulink>.
-              De plus, vous pouvez utiliser un nom spécial, préfixé par
-              "weechat_" pour capturer des évènements spéciaux
-              (voir <xref linkend="secAPI_msg_handler_add" />).
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>fonction</option> : fonction appelée lorsque le
-              message est reçu
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::add_message_handler("privmsg", "ma_fonction");
-sub ma_fonction
-{
-    weechat::print("serveur=$_[0]");
-    ($null, $canal, $message) = split ":",$_[1],3;
-    ($masque, $null, $canal) = split " ", $canal;
-    weechat::print("masque=$masque, canal=$canal, msg=$message");
-    return weechat::PLUGIN_RC_OK;
-}
-
-# python
-weechat.add_message_handler("privmsg", "ma_fonction")
-def ma_fonction(serveur, args):
-    weechat.prnt("serveur="+serveur)
-    null, canal, message = string.split(args, ":", 2)
-    masque, null, canal = string.split(string.strip(canal), " ", 2)
-    weechat.prnt("masque="+masque+", canal="+canal+", message="+message)
-    return weechat.PLUGIN_RC_OK
-
-# ruby
-Weechat.add_message_handler("privmsg", "ma_fonction")
-def ma_fonction(server, args)
-    Weechat.print("serveur=#{server}, args=#{args}")
-    return Weechat::PLUGIN_RC_OK
-end
-
--- lua
-weechat.add_message_handler("privmsg", "ma_fonction")
-function ma_fonction(server, args)
-    weechat.print("serveur=" .. server .. ", args=" .. args)
-    return weechat.PLUGIN_RC_OK()
-end
-</screen>
-      </para>
-      <para>
-        Note : la fonction appelée lorsque le message est reçu doit
-        renvoyer une des valeurs suivantes :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <literal>PLUGIN_RC_KO</literal> : la fonction a échoué
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <literal>PLUGIN_RC_OK</literal> : la fonction a réussi
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <literal>PLUGIN_RC_OK_IGNORE_WEECHAT</literal> : le message
-              ne sera pas transmis à WeeChat
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <literal>PLUGIN_RC_OK_IGNORE_PLUGINS</literal> : le message
-              ne sera pas transmis à d'autres extensions
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <literal>PLUGIN_RC_OK_IGNORE_ALL</literal> : le message
-              ne sera ni transmis à WeeChat ni à d'autres extensions
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <literal>PLUGIN_RC_OK_WITH_HIGHLIGHT</literal> : la fonction
-              a réussi et provoque un "highlight" sur le message reçu
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-    </section>
-    
-    <section id="secScript_add_command_handler">
-      <title>add_command_handler</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::add_command_handler(commande, fonction,
-          [description, arguments, arguments_description,
-          modele_completion]);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.add_command_handler(commande, fonction,
-          [description, arguments, arguments_description,
-          modele_completion])
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.add_command_handler(commande, fonction,
-          [description, arguments, arguments_description,
-          modele_completion])
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.add_command_handler(commande, fonction,
-          [description, arguments, arguments_description,
-          modele_completion])
-        </command>
-      </para>
-      <para>
-        Ajoute un gestionnaire de commande WeeChat, appelé dès que
-        l'utilisateur utilise la commande (par exemple /commande).
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>commande</option> : nom de la nouvelle commande,
-              qui peut être une commande déjà existante (attention la
-              commande remplacée ne sera plus disponible jusqu'à ce que
-              le script soit déchargé)
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>fonction</option> : fonction appelée lorsque la
-              commande est exécutée
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>arguments</option> : brève description des
-              paramètres de la commande (affichée par /help commande)
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>arguments_description</option> : longue description
-              des paramètres de la commande (affichée par /help commande)
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>modele_completion</option> : modèle pour la
-              complétion sous la forme "<literal>abc|%w def|%i</literal>"
-              qui signifie "abc" ou une commande WeeChat pour le premier
-              paramètre, et "def" ou une commande IRC pour le deuxième.
-              (voir <xref linkend="secAPI_cmd_handler_add" />)
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::add_command_handler("commande", "ma_commande");
-sub ma_commande
-{
-    weechat::print("serveur=$_[0], args=$_[1]");
-    return weechat::PLUGIN_RC_OK;
-}
-
-# python
-weechat.add_command_handler("commande", "ma_commande")
-def ma_commande(serveur, args):
-    weechat.prnt("serveur="+serveur+", args="+args)
-    return weechat.PLUGIN_RC_OK
-
-# ruby
-Weechat.add_command_handler("commande", "ma_commande")
-def ma_commande(server, args)
-    Weechat.print("serveur=#{server} args=#{args}")
-    return Weechat::PLUGIN_RC_OK
-end
-
--- lua
-weechat.add_command_handler("commande", "ma_commande")
-def my_command(server, args)
-    weechat.print("serveur="..server..", args="..args)
-    return weechat.PLUGIN_RC_OK()
-end
-</screen>
-      </para>
-      <para>
-        Notes : la fonction appelée lorsque la commande est exécutée
-        doit renvoyer une des valeurs suivantes :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <literal>PLUGIN_RC_KO</literal> : la fonction a échoué
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <literal>PLUGIN_RC_OK</literal> : la fonction a réussi
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-    </section>
-    
-    <section id="secScript_add_timer_handler">
-      <title>add_timer_handler</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::add_timer_handler(intervalle, fonction);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.add_timer_handler(intervalle, fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.add_timer_handler(intervalle, fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.add_timer_handler(intervalle, fonction)
-        </command>
-      </para>
-      <para>
-        Ajoute un gestionnaire de temps, qui appelle périodiquement une
-        fonction.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>intervalle</option> : intervalle (en secondes)
-              entre deux appels de la fonction.
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>fonction</option> : fonction appelée
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::add_timer_handler(60, "mon_timer");
-sub mon_timer
-{
-    weechat::print("ceci est le timer handler");
-    return weechat::PLUGIN_RC_OK;
-}
-
-# python
-weechat.add_timer_handler(60, "mon_timer")
-def mon_timer():
-    weechat.prnt("ceci est le timer handler")
-    return weechat.PLUGIN_RC_OK
-
-# ruby
-Weechat.add_timer_handler(60, "mon_timer")
-def mon_timer()
-    Weechat.print("ceci est le timer handler")
-    return Weechat::PLUGIN_RC_OK
-end
-
--- lua
-weechat.add_timer_handler(60, "mon_timer")
-function mon_timer()
-    weechat.print("ceci est le timer handler")
-    return weechat.PLUGIN_RC_OK()
-end
-</screen>
-      </para>
-      <para>
-        Note : la fonction appelée doit renvoyer une des valeurs
-        suivantes :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <literal>PLUGIN_RC_KO</literal> : la fonction a échoué
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <literal>PLUGIN_RC_OK</literal> : la fonction a réussi
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-    </section>
-    
-    <section id="secScript_add_keyboard_handler">
-      <title>add_keyboard_handler</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::add_keyboard_handler(fonction);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.add_keyboard_handler(fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.add_keyboard_handler(fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.add_keyboard_handler(fonction)
-        </command>
-      </para>
-      <para>
-        Ajoute un gestionnaire de clavier, appelé dès qu'une touche est
-        pressée.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>fonction</option> : fonction appelée
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::add_keyboard_handler("mon_clavier");
-sub mon_clavier
-{
-    my $key = shift;
-    my $input_before = shift;
-    my $input_after = shift;
-    weechat::print("gestionnaire clavier: key = '$key', "
-                   ."entrée avant = '$input_before' "
-                   ."après = '$input_after'");
-    return weechat::PLUGIN_RC_OK;
-}
-
-# python
-weechat.add_keyboard_handler("mon_clavier")
-def mon_clavier(key, input_before, input_after):
-    weechat.prnt("gestionnaire clavier: touche = '%s', " \
-                 "entrée avant = '%s' après = '%s'"
-                 %(key, input_before, input_after))
-    return weechat.PLUGIN_RC_OK
-
-# ruby
-Weechat.add_keyboard_handler("mon_clavier")
-def mon_clavier(key, input_before, input_after)
-    Weechat.print("gestionnaire clavier: touche = '#{key}', " \
-                  "entrée avant = '#{input_before}' " \
-                  "après = '#{input_after}'")
-    return Weechat::PLUGIN_RC_OK
-end
-
--- lua
-weechat.add_keyboard_handler("mon_clavier")
-function mon_clavier(key, input_before, input_after)
-    weechat.print("gestionnaire clavier: touche = '"..key..
-                  "', entrée avant = '"..input_before..
-                  "' après = '"..input_after.."'")
-    return weechat.PLUGIN_RC_OK()
-end
-</screen>
-      </para>
-      <para>
-        Note : la fonction appelée doit renvoyer une des valeurs
-        suivantes :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <literal>PLUGIN_RC_KO</literal> : la fonction a échoué
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <literal>PLUGIN_RC_OK</literal> : la fonction a réussi
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-    </section>
-    
-    <section id="secScript_add_event_handler">
-      <title>add_event_handler</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::add_event_handler(évènement, fonction);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.add_event_handler(évènement, fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.add_event_handler(évènement, fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.add_event_handler(évènement, fonction)
-        </command>
-      </para>
-      <para>
-        Ajoute un gestionnaire d'évènement, appelé dès qu'un évènement se
-        produit.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>évènement</option> : évènement
-              (voir <xref linkend="secAPI_event_handler_add" />)
-            </para>
-          </listitem>
-        </itemizedlist>
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>fonction</option> : fonction appelée
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::add_event_handler("buffer_open", "mon_evenement");
-sub mon_evenement
-{
-    weechat::print("buffer open");
-    return weechat::PLUGIN_RC_OK;
-}
-
-# python
-weechat.add_event_handler("buffer_open", "mon_evenement")
-def mon_evenement():
-    weechat.prnt("buffer open")
-    return weechat.PLUGIN_RC_OK
-
-# ruby
-Weechat.add_event_handler("buffer_open", "mon_evenement")
-def mon_evenement()
-    Weechat.print("buffer open")
-    return Weechat::PLUGIN_RC_OK
-end
-
--- lua
-weechat.add_event_handler("buffer_open", "mon_evenement")
-function mon_evenement()
-    weechat.print("buffer open")
-    return weechat.PLUGIN_RC_OK()
-end
+weechat.register("test", "Auteur &lt;auteur@domaine.com&gt;", "1.0",
+                 "GPL3", "Description du script", "au_revoir", "")
 </screen>
       </para>
-      <para>
-        Note : la fonction appelée doit renvoyer une des valeurs
-        suivantes :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <literal>PLUGIN_RC_KO</literal> : la fonction a échoué
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <literal>PLUGIN_RC_OK</literal> : la fonction a réussi
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-    </section>
-    
-    <section id="secScript_remove_handler">
-      <title>remove_handler</title>
       
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::remove_handler(nom, fonction);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.remove_handler(nom, fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.remove_handler(nom, fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.remove_handler(nom, fonction)
-        </command>
-      </para>
-      <para>
-        Supprime un gestionnaire de message ou de commande.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>nom</option> : nom du message IRC ou de la commande
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>fonction</option> : fonction associée
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::remove_handler("commande", "ma_commande");
-
-# python
-weechat.remove_handler("commande", "ma_commande")
-
-# ruby
-Weechat.remove_handler("commande", "ma_commande")
-
--- lua
-weechat.remove_handler("commande", "ma_commande")
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_remove_timer_handler">
-      <title>remove_timer_handler</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::remove_timer_handler(fonction);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.remove_timer_handler(fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.remove_timer_handler(fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.remove_timer_handler(fonction)
-        </command>
-      </para>
-      <para>
-        Supprime un gestionnaire de temps.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>fonction</option> : fonction
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::remove_timer_handler("mon_timer");
-
-# python
-weechat.remove_timer_handler("mon_timer")
-
-# ruby
-Weechat.remove_timer_handler("mon_timer")
-
--- lua
-weechat.remove_timer_handler("mon_timer")
-</screen>
-      </para>
     </section>
     
-    <section id="secScript_remove_keyboard_handler">
-      <title>remove_keyboard_handler</title>
+    <section id="secScriptTcl">
+      <title>Tcl</title>
       
       <para>
-        Prototype Perl :
-        <command>
-          weechat::remove_keyboard_handler(fonction);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.remove_keyboard_handler(fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.remove_keyboard_handler(fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.remove_keyboard_handler(fonction)
-        </command>
-      </para>
-      <para>
-        Supprime un gestionnaire de clavier.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>fonction</option> : fonction
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
+        Dans un script Tcl WeeChat, toutes les fonctions de l'interface
+        sont préfixées par "<literal>weechat::</literal>".
+        Les variables sont préfixées par "<literal>$weechat::</literal>".
+        Exemple :
 <screen>
-# perl
-weechat::remove_keyboard_handler("mon_clavier");
-
-# python
-weechat.remove_keyboard_handler("mon_clavier")
-
-# ruby
-Weechat.remove_keyboard_handler("mon_clavier")
-
--- lua
-weechat.remove_keyboard_handler("mon_clavier")
+weechat::register "test" "Auteur &lt;auteur@domaine.com&gt;" "1.0" "GPL3" "Description du script" "au_revoir" ""
 </screen>
       </para>
-    </section>
-    
-    <section id="secScript_remove_event_handler">
-      <title>remove_event_handler</title>
       
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::remove_event_handler(fonction);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.remove_event_handler(fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.remove_event_handler(fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.remove_event_handler(fonction)
-        </command>
-      </para>
-      <para>
-        Supprime un gestionnaire d'évènement.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>fonction</option> : fonction
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::remove_event_handler("mon_evenement");
-
-# python
-weechat.remove_event_handler("mon_evenement")
-
-# ruby
-Weechat.remove_event_handler("mon_evenement")
-
--- lua
-weechat.remove_event_handler("mon_evenement")
-</screen>
-      </para>
     </section>
     
-    <section id="secScript_add_modifier">
-      <title>add_modifier</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::add_modifier(type, message, fonction);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.add_modifier(type, message, fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.add_modifier(type, message, fonction)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.add_modifier(type, message, fonction)
-        </command>
-      </para>
-      <para>
-        Ajoute un modifieur de messages.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>type</option> : type de modifieur :
-              <informaltable colsep="0" frame="none">
-                <tgroup cols="2">
-                  <thead>
-                    <row>
-                      <entry>Type</entry>
-                      <entry>Description</entry>
-                    </row>
-                  </thead>
-                  <tbody>
-                    <row>
-                      <entry><literal>irc_in</literal></entry>
-                      <entry>appelé pour chaque message IRC reçu</entry>
-                    </row>
-                    <row>
-                      <entry><literal>irc_user</literal></entry>
-                      <entry>
-                        appelé pour chaque message (ou commande) envoyé par
-                        l'utilisateur (avant traitement et affichage par
-                        WeeChat)
-                      </entry>
-                    </row>
-                    <row>
-                      <entry><literal>irc_out</literal></entry>
-                      <entry>
-                        appelé pour chaque message sortant juste avant
-                        envoi au serveur IRC (y compris pour les messages
-                        envoyés automatiquement et de manière transparente
-                        par WeeChat)
-                      </entry>
-                    </row>
-                  </tbody>
-                </tgroup>
-              </informaltable>
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>message</option> : nom du message IRC pour lequel la
-              fonction est appelée (utilisé uniquement pour les types
-              "irc_in" et "irc_out").
-              Pour connaître la liste des messages IRC disponibles, merci
-              de consulter les <acronym>RFC</acronym>s
-              <ulink url="http://www.ietf.org/rfc/rfc1459.txt">1459</ulink>
-              et
-              <ulink url="http://www.ietf.org/rfc/rfc2812.txt">2812</ulink>.
-              La valeur spéciale "*" signifie tous les messages (pas de
-              filtre).
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>fonction</option> : fonction appelée
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::add_modifier("irc_in", "privmsg", "mod_in");
-weechat::add_modifier("irc_out", "privmsg", "mod_out");
-sub mod_in
-{
-    return "$_[1] [modifier IN]";
-}
-sub mod_out
-{
-    return "$_[1] [modifier OUT]";
-}
-
-# python
-weechat.add_modifier("irc_in", "privmsg", "mod_in")
-weechat.add_modifier("irc_out", "privmsg", "mod_out")
-def mod_in(serveur, args):
-    return args + " [modifier IN]"
-def mod_out(serveur, args):
-    return args + " [modifier OUT]"
-
-# ruby
-Weechat.add_modifier("irc_in", "privmsg", "mod_in")
-Weechat.add_modifier("irc_out", "privmsg", "mod_out")
-def mod_in(server, args)
-    return args + " [modifier IN]"
-end
-def mod_out(server, args)
-    return args + " [modifier OUT]"
-end
-
--- lua
-weechat.add_modifier("irc_in", "privmsg", "mod_in")
-weechat.add_modifier("irc_out", "privmsg", "mod_out")
-function mod_in(server, args)
-    return args .. " [modifier IN]"
-end
-function mod_out(server, args)
-    return args .. " [modifier OUT]"
-end
-</screen>
-      </para>
-    </section>
+  </section>
+  
+  <section id="secInterfaceWeeChatScripts">
+    <title>Interface WeeChat / scripts</title>
     
-    <section id="secScript_remove_modifier">
-      <title>remove_modifier</title>
+    <section id="sec_script_register">
+      <title>register</title>
       
       <para>
         Prototype Perl :
         <command>
-          weechat::remove_modifier(type, message, fonction);
+          weechat::register(nom, auteur, version, licence, description,
+          fonction_de_fin, charset);
         </command>
       </para>
       <para>
         Prototype Python :
         <command>
-          weechat.remove_handler(type, message, fonction)
+          weechat.register(nom, auteur, version, licence, description,
+          fonction_de_fin, charset)
         </command>
       </para>
       <para>
         Prototype Ruby :
         <command>
-          Weechat.remove_handler(type, message, fonction)
+          Weechat.register(nom, auteur, version, licence, description,
+          fonction_de_fin, charset)
         </command>
       </para>
       <para>
         Prototype Lua :
         <command>
-          weechat.remove_handler(type, message, fonction)
-        </command>
-      </para>
-      <para>
-        Supprime un modifieur de messages.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>type</option> : type de modifieur
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>message</option> : message traité par le modifieur
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>fonction</option> : fonction associée
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::remove_modifier("irc_in", "privmsg", "mod_in");
-
-# python
-weechat.remove_modifier("irc_in", "privmsg", "mod_in")
-
-# ruby
-Weechat.remove_modifier("irc_in", "privmsg", "mod_in")
-
--- lua
-weechat.remove_modifier("irc_in", "privmsg", "mod_in")
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_command">
-      <title>command</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::command(commande, [canal, [serveur]]);
+          weechat.register(nom, auteur, version, licence, description,
+          fonction_de_fin, charset)
         </command>
       </para>
       <para>
-        Prototype Python :
-        <command>
-          weechat.command(commande, [canal, [serveur]])
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
+        Prototype Tcl :
         <command>
-          Weechat.command(commande, [canal, [serveur]])
+          weechat::register nom auteur version licence description
+          fonction_de_fin charset
         </command>
       </para>
       <para>
-        Prototype Lua :
-        <command>
-          weechat.command(commande, [canal, [serveur]])
-        </command>
-      </para>
-      <para>
-        Exécute une commande ou envoie un message à un canal.
+        C'est la première fonction à appeler dans le script.
+        Tout script pour WeeChat doit appeler cette fonction.
       </para>
       <para>
         Paramètres :
         <itemizedlist>
           <listitem>
             <para>
-              <option>commande</option> : la commande à exécuter
+              <option>nom</option> : nom unique pour identifier le script
+              (chaque script doit avoir un nom différent)
             </para>
           </listitem>
           <listitem>
             <para>
-              <option>canal</option> : nom du canal où exécuter la
-              commande
+              <option>auteur</option> : chaîne avec l'auteur (peut include
+              nom, pseudo, e-mail, etc...)
             </para>
           </listitem>
           <listitem>
             <para>
-              <option>serveur</option> : nom interne du serveur où
-              exécuter la commande
+              <option>version</option> : version du script
             </para>
           </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::command("bonjour tout le monde !");
-weechat::command("/kick toto merci de quitter ce canal", "#weechat");
-weechat::command("/nick newnick", "", "freenode");
-
-# python
-weechat.command("bonjour tout le monde !")
-weechat.command("/kick toto merci de quitter ce canal", "#weechat")
-weechat.command("/nick newnick", "", "freenode")
-
-# ruby
-Weechat.command("bonjour tout le monde !")
-Weechat.command("/kick toto merci de quitter ce canal", "#weechat")
-Weechat.command("/nick newnick", "", "freenode")
-
--- lua
-weechat.command("bonjour tout le monde !")
-weechat.command("/kick toto merci de quitter ce canal", "#weechat")
-weechat.command("/nick newnick", "", "freenode")
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_get_info">
-      <title>get_info</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::get_info(nom, [serveur]);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.get_info(nom, [serveur])
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.get_info(nom, [serveur])
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.get_info(nom, [serveur])
-        </command>
-      </para>
-      <para>
-        Renvoie une information sur WeeChat ou un canal.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
           <listitem>
             <para>
-              <option>nom</option> : nom de l'info à obtenir
-              (voir <xref linkend="secAPI_get_info" />)
+              <option>description</option> : brève description du script
             </para>
           </listitem>
           <listitem>
             <para>
-              <option>serveur</option> : nom interne du serveur où
-              récupérer l'information (si nécessaire)
+              <option>fonction_de_fin</option> : fonction appelée quand
+              le script est déchargé (paramètre facultatif, une chaîne
+              vide signifiant qu'il n'y a pas de fonction à appeler)
             </para>
           </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : l'information demandée, chaîne vide si une
-        erreur s'est produite ou que l'information n'a pas été trouvée.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-$version = get_info("version");
-$nick = get_info("nick", "freenode");
-
-# python
-version = weechat.get_info("version")
-nick = weechat.get_info("nick", "freenode")
-
-# ruby
-version = Weechat.get_info("version")
-nick = Weechat.get_info("nick", "freenode")
-
--- lua
-version = weechat.get_info("version")
-nick = weechat.get_info("nick", "freenode")
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_get_dcc_info">
-      <title>get_dcc_info</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::get_dcc_info();
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.get_dcc_info()
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.get_dcc_info()
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.get_dcc_info()
-        </command>
-      </para>
-      <para>
-        Renvoie la liste des DCC en cours ou terminés.
-      </para>
-      <para>
-        Valeur renvoyée : la liste des DCC
-        (voir <xref linkend="secAPI_get_dcc_info" />).
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-my @dccs = weechat::get_dcc_info();
-if (@dccs)
-{
-    foreach my $dcc (@dccs)
-    {
-        while (my ($key, $value) = each %$dcc)
-        {
-            weechat::print("$key = '$value'");
-        }
-    }
-}
-else
-{
-    weechat::print("pas de DCC");
-}
-
-# python
-dccs = weechat.get_dcc_info()
-if dccs != None:
-    if dccs == []:
-        weechat.prnt("pas de DCC")
-    else:
-        for d in dccs:
-            for b in d.keys():
-                weechat.prnt("%s = '%s'" %(b, d[b]))
-else:
-    weechat.prnt("erreur de lecture des DCC")
-
-# ruby
-dccs = Weechat.get_dcc_info()
-if dccs != nil   
-    if dccs == []
-        Weechat.print("pas de DCC")
-    else
-        dccs.each do |m|
-            m.each do |key, value|
-                Weechat.print("#{key} = '#{value}'")
-            end
-        end
-    end
-else
-    Weechat.print("erreur de lecture des DCC")
-end
-
--- lua
-dccs = weechat.get_dcc_info()
-if dccs ~= nil then
-    if dccs then
-        dcc, dccinfos = next (dccs, nil)
-        while (dcc) do
-            key, value = next (dccinfos, nil)
-            while (key) do
-                weechat.print(key.." = '"..value.."'")
-                key, value = next (dccinfos, key)
-            end
-            dcc, dccinfos = next (dccs, dcc)
-        end 
-    else
-        weechat.print("pas de DCC")
-    end
-else
-    weechat.print("erreur de lecture des DCC")
-end
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_get_server_info">
-      <title>get_server_info</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::get_server_info();
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.get_server_info()
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.get_server_info()
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.get_server_info()
-        </command>
-      </para>
-      <para>
-        Renvoie la liste des serveurs IRC (connectés ou non).
-      </para>
-      <para>
-        Valeur renvoyée : la liste des serveurs IRC (connectés ou non)
-        (voir <xref linkend="secAPI_get_server_info" />).
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-my $servers = weechat::get_server_info();
-if ($servers)
-{
-    while (my ($srvname, $srvinfos) = each %$servers)
-    {
-        while (my ($key, $value) = each %$srvinfos)
-        {
-            weechat::print("$srvname -> $key = '$value'");
-        }
-    }
-}
-else
-{
-    weechat::print("pas de serveur");
-}
-
-# python
-servers = weechat.get_server_info()
-if servers != None:
-    if servers == {}:
-        weechat.prnt("pas de serveur")
-    else:
-        for s in servers:
-            for i in servers[s]:
-                weechat.prnt("%s -> %s = '%s'" % (s, i, str(servers[s][i])))
-else:
-    weechat.prnt("erreur de lecture des serveurs")
-
-# ruby
-servers = Weechat.get_server_info()
-if servers != nil
-    if servers == []
-        Weechat.print("pas de serveur")
-    else
-        servers.each do |n, s|
-            s.each do |key, value|
-                Weechat.print("#{n} -> #{key} = '#{value}'")
-            end
-        end
-    end
-else
-    Weechat.print("erreur de lecture des serveurs")
-end
-
--- lua
-servers = weechat.get_server_info()
-if servers ~= nil then
-    if servers then
-        srv, srvinfos = next (servers, nil)
-        while (srv) do
-            key, value = next (srvinfos, nil)
-            while (key) do
-                weechat.print(srv.." -> "..key.." = '"..value.."'")
-                key, value = next (srvinfos, key)
-            end	
-            srv, srvinfos = next (servers, srv)
-        end
-    else
-        weechat.print("pas de serveur")
-    end
-else
-    weechat.print("erreur de lecture des serveurs")
-end
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_get_channel_info">
-      <title>get_channel_info</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::get_channel_info(serveur);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.get_channel_info(serveur)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.get_channel_info(serveur)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.get_channel_info(serveur)
-        </command>
-      </para>
-      <para>
-        Renvoie la liste des canaux IRC pour un serveur.
-      </para>
-      <para>
-        Valeur renvoyée : la liste des canaux IRC du serveur
-        (voir <xref linkend="secAPI_get_channel_info" />).
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-my $channels = weechat::get_channel_info(weechat::get_info("server"));
-if ($channels)
-{
-    while (my ($channame, $chaninfos) = each %$channels)
-    {
-        while (my ($key, $value) = each %$chaninfos)
-        {
-            weechat::print("$channame -> $key = '$value'");
-        }
-    }
-}
-else
-{
-    weechat::print("pas de canal");
-}
-
-# python
-chans = weechat.get_channel_info(weechat.get_info("server"))
-if chans != None:
-    if chans == {}:
-        weechat.prnt("pas de canal")
-    else:
-        for s in chans:
-            for i in chans[s]:
-                weechat.prnt("%s -> %s = '%s'" % (s, i, str(chans[s][i])))
-else:
-    weechat.prnt("erreur de lecture des canaux")
-
-# ruby
-channels = Weechat.get_channel_info(Weechat.get_info("server"))
-if channels != nil
-    if channels == {}
-        Weechat.print("pas de canal")
-    else
-        channels.each do |n, c|
-            c.each do |key, value|
-                Weechat.print("#{n} -> #{key} = '#{value}'")
-            end
-        end
-    end
-else
-    Weechat.print("erreur de lecture des canaux")
-end
-
--- lua
-chans = weechat.get_channel_info(weechat.get_info("server"))
-if chans ~= nil then
-    if chans then
-        chan, chaninfos = next (chans, nil)
-        while (chan) do
-            key, value = next (chaninfos, nil)
-            while (key) do
-                weechat.print(chan.." -> "..key.." = '"..value.."'")
-                key, value = next (chaninfos, key)
-            end
-            chan, chaninfos = next (chans, chan)
-        end
-    else
-        weechat.print("pas de canal")
-    end
-else
-    weechat.print("erreur de lecture des canaux")
-end
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_get_nick_info">
-      <title>get_nick_info</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::get_nick_info(serveur, canal);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.get_nick_info(serveur, canal)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.get_nick_info(serveur, canal)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.get_nick_info(serveur, canal)
-        </command>
-      </para>
-      <para>
-        Renvoie la liste des pseudos pour un canal.
-      </para>
-      <para>
-        Valeur renvoyée : la liste des pseudos présents sur le canal
-        (voir <xref linkend="secAPI_get_nick_info" />).
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-my $nicks = weechat::get_nick_info("freenode", "#weechat");
-if ($nicks)
-{
-    while (my ($nickname, $nickinfos) = each %$nicks)
-    {
-        while ( my ($key, $value) = each %$nickinfos)
-        {
-            weechat::print("$nickname -> $key = '$value'");
-        }
-    }
-}
-else
-{
-    weechat::print("pas de pseudo");
-}
-
-# python
-nicks = weechat.get_nick_info("freenode", "#weechat")
-if nicks != None:
-    if nicks == {}:
-        weechat.prnt("pas de pseudo")
-    else:
-        for n in nicks:
-            for f in nicks[n]:
-                weechat.prnt("%s -> %s = '%s'" % (n, f, str(nicks[n][f])))
-else:
-    weechat.prnt("erreur de lecture des pseudos")
-
-# ruby
-nicks = Weechat.get_nick_info("freenode", "#weechat")
-if nicks != nil
-    if nicks == {}
-        Weechat.print("pas de pseudo")
-    else
-        nicks.each do |nk, nattr|
-            nattr.each do |key, value|
-                Weechat.print("#{nk} -> #{key} = '#{value}'")
-            end
-        end
-    end
-else
-    Weechat.print("erreur de lecture des pseudos")
-end
-
--- lua
-nicks = weechat.get_nick_info("freenode", "#weechat")
-if nicks ~= nil then
-    if nicks then	
-        nick, nickinfos = next (nicks, nil)
-        while (nick) do
-            key, value = next (nickinfos, nil)
-            while (key) do
-                weechat.print(nick.." -> "..key.." = '"..value.."'")
-                key, value = next (nickinfos, key)
-            end
-            nick, nickinfos = next (nicks, nick)
-        end
-    else
-        weechat.print("pas de pseudo")
-    end
-else
-    weechat.print("erreur de lecture des pseudos")
-end
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_get_config">
-      <title>get_config</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::get_config(option);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.get_config(option)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.get_config(option)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.get_config(option)
-        </command>
-      </para>
-      <para>
-        Renvoie la valeur d'une option de configuration WeeChat.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
           <listitem>
             <para>
-              <option>option</option> : nom de l'option
+              <option>charset</option> : jeu de caractères du script, à
+              préciser si le script n'est PAS écrit en UTF-8 (vous pouvez
+              laisser blanc pour un script UTF-8, c'est le jeu de caractère
+              par défaut)
             </para>
           </listitem>
         </itemizedlist>
       </para>
       <para>
-        Valeur renvoyée : la valeur de l'option, chaîne vide si l'option
-        n'a pas été trouvée.
+        Valeur renvoyée : 1 si le script a été enregistré, 0 si une erreur
+        s'est produite.
       </para>
       <para>
         Exemples :
 <screen>
 # perl
-$valeur1 = weechat::get_config("look_nicklist");
-$valeur2 = weechat::get_config("freenode.server_autojoin");
+weechat::register("test", "Auteur &lt;auteur\@domaine.com&gt;", "1.0",
+                  "GPL3", "Description du script", "au_revoir", "");
 
 # python
-valeur1 = weechat.get_config("look_nicklist")
-valeur2 = weechat.get_config("freenode.server_autojoin")
+weechat.register("test", "Auteur &lt;auteur@domaine.com&gt;", "1.0",
+                 "GPL3", "Description du script", "au_revoir", "")
 
 # ruby
-valeur1 = Weechat.get_config("look_nicklist")
-valeur2 = Weechat.get_config("freenode.server_autojoin")
+Weechat.register("test", "Auteur &lt;auteur@domaine.com&gt;", "1.0",
+                 "GPL3", "Description du script", "au_revoir", "")
 
 -- lua
-valeur1 = weechat.get_config("look_nicklist")
-valeur2 = weechat.get_config("freenode.server_autojoin")
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_set_config">
-      <title>set_config</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::set_config(option, valeur);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.set_config(option, valeur)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.set_config(option, valeur)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.set_config(option, valeur)
-        </command>
-      </para>
-      <para>
-        Modifie la valeur d'une option de configuration WeeChat.
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>option</option> : nom de l'option
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>valeur</option> : la nouvelle valeur pour
-              l'option
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est
-        produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::set_config("look_nicklist", "off");
-weechat::set_config("freenode.server_autojoin", "#weechat");
-
-# python
-weechat.set_config("look_nicklist", "off")
-weechat.set_config("freenode.server_autojoin", "#weechat")
+weechat.register("test", "Auteur &lt;auteur@domaine.com&gt;", "1.0",
+                 "GPL3", "Description du script", "au_revoir", "")
 
-# ruby
-Weechat.set_config("look_nicklist", "off")
-Weechat.set_config("freenode.server_autojoin", "#weechat")
-
--- lua
-weechat.set_config("look_nicklist", "off")
-weechat.set_config("freenode.server_autojoin", "#weechat")
+# tcl
+weechat::register "test" "Auteur &lt;auteur@domaine.com&gt;" "1.0" "GPL3" "Description du script" "au_revoir" ""
 </screen>
       </para>
     </section>
-    
-    <section id="secScript_get_plugin_config">
-      <title>get_plugin_config</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::get_plugin_config(option);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.get_plugin_config(option)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.get_plugin_config(option)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.get_plugin_config(option)
-        </command>
-      </para>
-      <para>
-        Renvoie la valeur d'une option de l'extension.
-        L'option est lue depuis le fichier
-        "<literal>~/.weechat/plugins.rc</literal>" et est
-        sous cette forme :
-        "<literal>extension.script.option=valeur</literal>"
-        (NB : le nom de l'extension et du script sont ajoutés
-        automatiquement).
-      </para>
-      <para>
-        Paramètres :
-        <itemizedlist>
-          <listitem>
-            <para>
-              <option>option</option> : nom de l'option
-            </para>
-          </listitem>
-        </itemizedlist>
-      </para>
-      <para>
-        Valeur renvoyée : la valeur de l'option, chaîne vide si l'option
-        n'a pas été trouvée.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-$valeur = weechat::get_plugin_config("ma_variable");
-
-# python
-valeur = weechat.get_plugin_config("ma_variable")
-
-# ruby
-valeur = Weechat.get_plugin_config("ma_variable")
 
--- lua
-valeur = weechat.get_plugin_config("ma_variable")
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_set_plugin_config">
-      <title>set_plugin_config</title>
+    <section id="secOther_functions">
+      <title>Autres fonctions</title>
       
       <para>
-        Prototype Perl :
-        <command>
-          weechat::set_plugin_config(option, valeur);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.set_plugin_config(option, valeur)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.set_plugin_config(option, valeur)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.set_plugin_config(option, valeur)
-        </command>
-      </para>
-      <para>
-        Modifie la valeur d'une option de l'extension.
-        L'option est écrite dans le fichier
-        "<literal>~/.weechat/plugins.rc</literal>" et est
-        sous cette forme :
-        "<literal>extension.script.option=valeur</literal>"
-        (NB : le nom de l'extension et du script sont rajoutés
-        automatiquement).
-      </para>
-      <para>
-        Paramètres :
+        Les fonctions suivantes sont dans l'API scripts (pour la description,
+        voir <xref linkend="secPluginCApi" />).
         <itemizedlist>
-          <listitem>
-            <para>
-              <option>option</option> : nom de l'option
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <option>valeur</option> : la nouvelle valeur pour
-              l'option
-            </para>
-          </listitem>
+          <listitem><para>plugin_get_name</para></listitem>
+          <listitem><para>set_charset</para></listitem>
+          <listitem><para>plugin_get_name</para></listitem>
+          <listitem><para>charset_set</para></listitem>
+          <listitem><para>iconv_to_internal</para></listitem>
+          <listitem><para>iconv_from_internal</para></listitem>
+          <listitem><para>gettext</para></listitem>
+          <listitem><para>ngettext</para></listitem>
+          <listitem><para>string_remove_color</para></listitem>
+          <listitem><para>mkdir_home</para></listitem>
+          <listitem><para>mkdir</para></listitem>
+          <listitem><para>mkdir_parents</para></listitem>
+          <listitem><para>list_new</para></listitem>
+          <listitem><para>list_add</para></listitem>
+          <listitem><para>list_search</para></listitem>
+          <listitem><para>list_casesearch</para></listitem>
+          <listitem><para>list_get</para></listitem>
+          <listitem><para>list_set</para></listitem>
+          <listitem><para>list_next</para></listitem>
+          <listitem><para>list_prev</para></listitem>
+          <listitem><para>list_string</para></listitem>
+          <listitem><para>list_size</para></listitem>
+          <listitem><para>list_remove</para></listitem>
+          <listitem><para>list_remove_all</para></listitem>
+          <listitem><para>list_free</para></listitem>
+          <listitem><para>config_new</para></listitem>
+          <listitem><para>config_new_section</para></listitem>
+          <listitem><para>config_search_section</para></listitem>
+          <listitem><para>config_new_option</para></listitem>
+          <listitem><para>config_search_option</para></listitem>
+          <listitem><para>config_string_to_boolean</para></listitem>
+          <listitem><para>config_option_reset</para></listitem>
+          <listitem><para>config_option_set</para></listitem>
+          <listitem><para>config_option_set_null</para></listitem>
+          <listitem><para>config_option_unset</para></listitem>
+          <listitem><para>config_option_rename</para></listitem>
+          <listitem><para>config_option_is_null</para></listitem>
+          <listitem><para>config_option_default_is_null</para></listitem>
+          <listitem><para>config_boolean</para></listitem>
+          <listitem><para>config_boolean_default</para></listitem>
+          <listitem><para>config_integer</para></listitem>
+          <listitem><para>config_integer_default</para></listitem>
+          <listitem><para>config_string</para></listitem>
+          <listitem><para>config_string_default</para></listitem>
+          <listitem><para>config_color</para></listitem>
+          <listitem><para>config_color_default</para></listitem>
+          <listitem><para>config_write_option</para></listitem>
+          <listitem><para>config_write_line</para></listitem>
+          <listitem><para>config_write</para></listitem>
+          <listitem><para>config_read</para></listitem>
+          <listitem><para>config_reload</para></listitem>
+          <listitem><para>config_option_free</para></listitem>
+          <listitem><para>config_section_free_options</para></listitem>
+          <listitem><para>config_section_free</para></listitem>
+          <listitem><para>config_free</para></listitem>
+          <listitem><para>config_get</para></listitem>
+          <listitem><para>config_get_plugin</para></listitem>
+          <listitem><para>config_set_plugin</para></listitem>
+          <listitem><para>config_unset_plugin</para></listitem>
+          <listitem><para>prefix</para></listitem>
+          <listitem><para>color</para></listitem>
+          <listitem><para>print</para></listitem>
+          <listitem><para>print_date_tags</para></listitem>
+          <listitem><para>print_y</para></listitem>
+          <listitem><para>log_print</para></listitem>
+          <listitem><para>hook_command</para></listitem>
+          <listitem><para>hook_command_run</para></listitem>
+          <listitem><para>hook_timer</para></listitem>
+          <listitem><para>hook_fd</para></listitem>
+          <listitem><para>hook_process</para></listitem>
+          <listitem><para>hook_connect</para></listitem>
+          <listitem><para>hook_print</para></listitem>
+          <listitem><para>hook_signal</para></listitem>
+          <listitem><para>hook_signal_send</para></listitem>
+          <listitem><para>hook_config</para></listitem>
+          <listitem><para>hook_completion</para></listitem>
+          <listitem><para>hook_completion_list_add</para></listitem>
+          <listitem><para>hook_modifier</para></listitem>
+          <listitem><para>hook_modifier_exec</para></listitem>
+          <listitem><para>hook_info</para></listitem>
+          <listitem><para>hook_infolist</para></listitem>
+          <listitem><para>unhook</para></listitem>
+          <listitem><para>unhook_all</para></listitem>
+          <listitem><para>buffer_new</para></listitem>
+          <listitem><para>buffer_search</para></listitem>
+          <listitem><para>current_buffer</para></listitem>
+          <listitem><para>buffer_clear</para></listitem>
+          <listitem><para>buffer_close</para></listitem>
+          <listitem><para>buffer_get_integer</para></listitem>
+          <listitem><para>buffer_get_string</para></listitem>
+          <listitem><para>buffer_get_pointer</para></listitem>
+          <listitem><para>buffer_set</para></listitem>
+          <listitem><para>current_window</para></listitem>
+          <listitem><para>window_get_integer</para></listitem>
+          <listitem><para>window_get_string</para></listitem>
+          <listitem><para>window_get_pointer</para></listitem>
+          <listitem><para>nicklist_add_group</para></listitem>
+          <listitem><para>nicklist_search_group</para></listitem>
+          <listitem><para>nicklist_add_nick</para></listitem>
+          <listitem><para>nicklist_search_nick</para></listitem>
+          <listitem><para>nicklist_remove_group</para></listitem>
+          <listitem><para>nicklist_remove_nick</para></listitem>
+          <listitem><para>nicklist_remove_all</para></listitem>
+          <listitem><para>bar_item_search</para></listitem>
+          <listitem><para>bar_item_new</para></listitem>
+          <listitem><para>bar_item_update</para></listitem>
+          <listitem><para>bar_item_remove</para></listitem>
+          <listitem><para>bar_search</para></listitem>
+          <listitem><para>bar_new</para></listitem>
+          <listitem><para>bar_set</para></listitem>
+          <listitem><para>bar_update</para></listitem>
+          <listitem><para>bar_remove</para></listitem>
+          <listitem><para>command</para></listitem>
+          <listitem><para>info_get</para></listitem>
+          <listitem><para>infolist_new</para></listitem>
+          <listitem><para>infolist_new_var_integer</para></listitem>
+          <listitem><para>infolist_new_var_string</para></listitem>
+          <listitem><para>infolist_new_var_pointer</para></listitem>
+          <listitem><para>infolist_new_var_time</para></listitem>
+          <listitem><para>infolist_get</para></listitem>
+          <listitem><para>infolist_next</para></listitem>
+          <listitem><para>infolist_prev</para></listitem>
+          <listitem><para>infolist_fields</para></listitem>
+          <listitem><para>infolist_integer</para></listitem>
+          <listitem><para>infolist_string</para></listitem>
+          <listitem><para>infolist_pointer</para></listitem>
+          <listitem><para>infolist_time</para></listitem>
+          <listitem><para>infolist_free</para></listitem>
+          <listitem><para>upgrade_new</para></listitem>
+          <listitem><para>upgrade_write_object</para></listitem>
+          <listitem><para>upgrade_read</para></listitem>
+          <listitem><para>upgrade_close</para></listitem>
         </itemizedlist>
       </para>
-      <para>
-        Valeur renvoyée : 1 si succès, 0 si une erreur s'est
-        produite.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::set_plugin_config("ma_variable", "valeur");
-
-# python
-weechat.set_plugin_config("ma_variable", "valeur")
-
-# ruby
-Weechat.set_plugin_config("ma_variable", "valeur")
-
--- lua
-weechat.set_plugin_config("ma_variable", "valeur")
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_get_irc_color">
-      <title>get_irc_color</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::get_irc_color(color);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.get_irc_color(color)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.get_irc_color(color)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.get_irc_color(color)
-        </command>
-      </para>
-      <para>
-        Renvoie le numéro d'une couleur IRC avec son nom.
-      </para>
-      <para>
-        Valeur renvoyée : numéro de la couleur IRC, -1 si la couleur
-        n'est pas trouvée (voir <xref linkend="secAPI_get_irc_color" />).
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-my $color_blue = weechat::get_irc_color("blue");
-
-# python
-color_blue = weechat.get_irc_color("blue")
-
-# ruby
-color_blue = Weechat.get_irc_color("blue")
-
--- lua
-color_blue = weechat.get_irc_color("blue")
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_input_color">
-      <title>input_color</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::input_color(color);
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.input_color(color)
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.input_color(color)
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.input_color(color)
-        </command>
-      </para>
-      <para>
-        Ajoute de la couleur dans la zone de saisie.
-      </para>
-      <para>
-        Valeur renvoyée : aucune.
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-weechat::input_color(weechat::get_irc_color("blue"), 10, 5);
-
-# python
-weechat.input_color(weechat.get_irc_color("blue"), 10, 5)
-
-# ruby
-Weechat.input_color(Weechat.get_irc_color("blue"), 10, 5)
-
--- lua
-weechat.input_color(weechat.get_irc_color("blue"), 10, 5)
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_get_window_info">
-      <title>get_window_info</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::get_window_info();
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.get_window_info()
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.get_window_info()
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.get_window_info()
-        </command>
-      </para>
-      <para>
-        Renvoie la liste des fenêtres WeeChat.
-      </para>
-      <para>
-        Valeur renvoyée : liste des fenêtres WeeChat
-        (voir <xref linkend="secAPI_get_window_info" />).
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-my @wf = weechat::get_window_info();
-if (@wf)
-{
-    weechat::print("**** infos fenêtres ****");
-    foreach my $w (@wf)
-    {
-        while ( my ($key, $value) = each %$w)
-        {
-            weechat::print(" > $key => $value");
-        }
-        weechat::print("----------------------");
-    }
-}
-else
-{
-    weechat::print("**** pas d'info fenêtre ****");
-}
-
-# python
-wf = weechat.get_window_info()
-if wf != None and wf != []:
-    weechat.prnt ("**** infos fenêtres ****")
-    for w in wf:
-        for i in w:
-            weechat.prnt (" > %s => %s" % (i, w[i]))
-        weechat.prnt ("----------------------")
-else:
-    weechat.prnt ("**** pas d'info sur les fenêtres ****")
-
-# ruby
-wf = Weechat.get_window_info()
-if wf != nil and wf != []   
-    Weechat.print("**** infos fenêtres ****")
-    wf.each do |w|
-        w.each do |key, value|
-            Weechat.print(" > #{key} => #{value}")
-        end
-        Weechat.print("----------------------")
-    end
-else
-    Weechat.print("**** pas d'info sur les fenêtres ****")
-end
-
--- lua
-wf = weechat.get_window_info()
-if wf then
-    weechat.print ("**** infos fenêtres ****")
-    w, winfos = next (wf, nil)
-    while (w) do
-        key, value = next (winfos, nil)
-        while (key) do
-            weechat.print(" > " .. key .. " => " .. value)
-            key, value = next (winfos, key)
-        end
-        weechat.print ("----------------------")
-        w, winfos = next (wf, w)
-    end
-else
-    weechat.print("**** pas d'info sur les fenêtres ****")
-end
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_get_buffer_info">
-      <title>get_buffer_info</title>
-      
-      <para>
-        Prototype Perl :
-        <command>
-          weechat::get_buffer_info();
-        </command>
-      </para>
-      <para>
-        Prototype Python :
-        <command>
-          weechat.get_buffer_info()
-        </command>
-      </para>
-      <para>
-        Prototype Ruby :
-        <command>
-          Weechat.get_buffer_info()
-        </command>
-      </para>
-      <para>
-        Prototype Lua :
-        <command>
-          weechat.get_buffer_info()
-        </command>
-      </para>
-      <para>
-        Renvoie la liste des tampons WeeChat.
-      </para>
-      <para>
-        Valeur renvoyée : liste des tampons WeeChat
-        (voir <xref linkend="secAPI_get_buffer_info" />).
-      </para>
-      <para>
-        Exemples :
-<screen>
-# perl
-my $bf = weechat::get_buffer_info();
-if ($bf)
-{
-    while ( my ($nobuf, $binfos) = each %$bf)
-    {
-        while ( my ($key, $value) = each %$binfos)
-        {
-            weechat::print(" > $key => $value");
-        }
-        weechat::print("----------------------");
-    }
-}
-else
-{
-    weechat::print("**** pas d'info sur les tampons ****");
-}
-
-# python
-bf = weechat.get_buffer_info()
-if bf != None and bf != {}:
-    for b in bf:
-        weechat.prnt ("**** info pour tampon buffer no %d ****" % b)
-        for c in bf[b]:
-            weechat.prnt (" > %s => %s" % (c, bf[b][c]))
-        weechat.prnt ("----------------------")
-else:
-    weechat.prnt ("**** pas d'info sur les tampons ****")
-
-# ruby
-bf = Weechat.get_buffer_info()
-if bf != nil and bf != {}
-    bf.each do |n, c|
-        Weechat.print("**** info pour tampon no #{n} ****")
-        c.each do |key, value|
-            Weechat.print(" > #{key} => #{value}")
-        end
-        Weechat.print("----------------------")
-    end
-else
-    Weechat.print("**** pas d'info sur les tampons ****")
-end
-
--- lua
-bf = weechat.get_buffer_info()
-if bf then
-    b, binfos = next (bf, nil)
-    while (b) do
-        weechat.print("**** info pour tampon no " .. b .. " ****")
-        key, value = next (binfos, nil)
-        while (key) do
-            weechat.print(" > " .. key .. " => " .. value)
-            key, value = next (binfos, key)
-        end
-        weechat.print ("----------------------")
-        b, infos = next (bf, b)
-    end
-else
-    weechat.print("**** pas d'info sur les tampons ****")
-end
-</screen>
-      </para>
-    </section>
-    
-    <section id="secScript_get_buffer_data">
-      <title>get_buffer_data</title>
       
-      <para>
-        Perl prototype:
-        <command>
-          weechat::get_buffer_data(server, channel);
-        </command>
-      </para>
-      <para>
-        Python prototype:
-        <command>
-          weechat.get_buffer_data(server, channel)
-        </command>
-      </para>
-      <para>
-        Ruby prototype:
-        <command>
-          Weechat.get_buffer_data(server, channel)
-        </command>
-      </para>
-      <para>
-        Lua prototype:
-        <command>
-          weechat.get_buffer_data(server, channel)
-        </command>
-      </para>
-      <para>
-        Return content of buffer.
-      </para>
-      <para>
-        Return value: list of lines for buffer
-        (see <xref linkend="secAPI_get_buffer_data" />).
-      </para>
-      <para>
-        Examples:
-<screen>
-# perl
-my $server = weechat::get_info("server");
-my $channel = weechat::get_info("channel");
-my @bc = weechat::get_buffer_data($server, $channel);
-if (@bc)
-{
-    weechat::print("**** buffer data for '$channel'\@'$server' ****");
-    foreach my $l (@bc) {
-        while ( my ($key, $value) = each %$l) {
-            weechat::print(" > $key => $value");
-        }
-        weechat::print("----------------------");
-    }
-}
-else
-{
-    weechat::print("**** no buffer data ****");
-}
-
-# python
-server = weechat.get_info("server")
-channel = weechat.get_info("channel")
-bc = weechat.get_buffer_data(server, channel)
-if bc != None and bc != []:
-    weechat.prnt ("**** buffer data for '%s'@'%s' ****" % (channel, server))
-    for l in bc:
-        for i in l:
-            weechat.prnt (" > %s => %s" % (i, l[i]))
-        weechat.prnt ("----------------------")
-else:
-    weechat.prnt ("**** no buffer data ****")
-
-# ruby
-server = Weechat.get_info("server")
-channel = Weechat.get_info("channel")
-bc = Weechat.get_buffer_data(server, channel)
-if bc != nil and bc != []   
-    Weechat.print("**** buffer data for '#{channel}'@'#{server}' ****")
-    bc.each do |l|
-        l.each do |key, value|
-            Weechat.print(" > #{key} => #{value}")
-        end
-        Weechat.print("----------------------")
-    end
-else
-    Weechat.print("**** no buffer data ****")
-end
-
--- lua
-server = weechat.get_info("server")
-channel = weechat.get_info("channel")
-bc = weechat.get_buffer_data(server, channel)
-if bc then
-    b, bdatas = next (bc, nil)
-    weechat.print("**** buffer data for '" .. channel .. "'@'" .. server .. "' ****")
-    while (b) do 
-        key, value = next (bdatas, nil)
-        while (key) do
-            weechat.print(" > " .. key .. " => " .. value)
-            key, value = next (bdatas, key)
-        end
-        weechat.print ("----------------------")
-        b, bdatas = next (bc, b)
-    end
-else
-    weechat.print("**** no buffer data ****")
-end
-</screen>
-      </para>
     </section>
     
   </section>