guile: new script plugin for scheme (task #7289)

5 files changed, 125 insertions, 51 deletions

diff --git a/doc/fr/autogen/plugin_api/completions.txt b/doc/fr/autogen/plugin_api/completions.txt
index eb090fc45..370e0b52d 100644
--- a/doc/fr/autogen/plugin_api/completions.txt
+++ b/doc/fr/autogen/plugin_api/completions.txt
@@ -8,6 +8,8 @@
 
 | aspell | aspell_langs | liste des langues supportées pour aspell
 
+| guile | guile_script | liste des scripts
+
 | irc | irc_channel | canal IRC courant
 
 | irc | irc_channel_nicks_hosts | pseudos et noms d'hôtes du canal IRC courant
diff --git a/doc/fr/autogen/plugin_api/infolists.txt b/doc/fr/autogen/plugin_api/infolists.txt
index fca6e7ea1..fc05a383e 100644
--- a/doc/fr/autogen/plugin_api/infolists.txt
+++ b/doc/fr/autogen/plugin_api/infolists.txt
@@ -4,6 +4,8 @@
 
 | alias | alias | liste des alias | pointeur vers l'alias (optionnel) | nom d'alias (peut démarrer ou se terminer par "*" comme joker) (optionnel)
 
+| guile | guile_script | liste des scripts | pointeur vers le script (optionnel) | nom de script (peut démarrer ou se terminer par "*" comme joker) (optionnel)
+
 | irc | irc_channel | liste des canaux pour un serveur IRC | pointeur vers le canal (optionnel) | serveur,canal (le canal est optionnel)
 
 | irc | irc_ignore | liste des ignores IRC | pointeur vers l'ignore (optionnel) | -
diff --git a/doc/fr/autogen/user/guile_commands.txt b/doc/fr/autogen/user/guile_commands.txt
new file mode 100644
index 000000000..7e4a99e62
--- /dev/null
+++ b/doc/fr/autogen/user/guile_commands.txt
@@ -0,0 +1,20 @@
+[[command_guile_guile]]
+[command]*`guile`* lister/charger/décharger des scripts::
+........................................
+/guile  list|listfull [<nom>]
+        load <fichier>
+        autoload
+        reload|unload [<nom>]
+
+    list: lister les scripts chargés
+listfull: lister les scripts chargés (verbeux)
+    load: charger un script
+autoload: charger tous les scripts dans le répertoire "autoload"
+  reload: recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload")
+  unload: décharger un script (si pas de nom donné, décharger tous les scripts)
+ fichier: script (fichier) à charger
+     nom: nom de script (nom utilisé dans l'appel à la fonction "register")
+
+Sans paramètre, cette commande liste les scripts chargés.
+........................................
+
diff --git a/doc/fr/weechat_scripting.fr.txt b/doc/fr/weechat_scripting.fr.txt
index e3672f7b2..32173cfd9 100644
--- a/doc/fr/weechat_scripting.fr.txt
+++ b/doc/fr/weechat_scripting.fr.txt
@@ -18,7 +18,14 @@ WeeChat (Wee Enhanced Environment for Chat) est un client de discussion libre,
 rapide et léger, conçu pour différents systèmes d'exploitation.
 
 Ce manuel documente la façon d'écrire des scripts pour WeeChat, en utilisant
-l'un des cinq langages de script supportés : perl, python, ruby, lua ou tcl.
+l'un des langages de script supportés :
+
+* python
+* perl
+* ruby
+* lua
+* tcl
+* guile (scheme)
 
 [NOTE]
 La majorité des exemples de cette documentation sont écrits en Python, mais
@@ -32,20 +39,45 @@ Scripts dans WeeChat
 Spécificités des langages
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Quelques choses sont spécifiques aux langages :
+Python
+^^^^^^
 
-* perl :
-** les fonctions sont appelées par `weechat::xxx(arg1, arg2, ...);`
-* python :
-** vous devez utiliser `import weechat`
-** les fonctions `print*` se nomment `prnt*` en python (car 'print' est un mot
-   clé réservé)
-** les fonctions sont appelées par `weechat.xxx(arg1, arg2, ...)`
-* ruby :
-** vous devez définir 'weechat_init' et appeler 'register' dedans
-** les fonctions sont appelées par `Weechat.xxx(arg1, arg2, ...)`
-* tcl :
-** les fonctions sont appelées par `weechat::xxx arg1 arg2 ...`
+* Vous devez utiliser `import weechat`
+* Les fonctions `print*` se nomment `prnt*` en python (car 'print' est un mot
+  clé réservé)
+* Les fonctions sont appelées par `weechat.xxx(arg1, arg2, ...)`
+
+Perl
+^^^^
+
+* Les fonctions sont appelées par `weechat::xxx(arg1, arg2, ...);`
+
+Ruby
+^^^^
+
+* Vous devez définir 'weechat_init' et appeler 'register' dedans
+* Les fonctions sont appelées par `Weechat.xxx(arg1, arg2, ...)`
+
+Lua
+^^^
+
+* Les fonctions sont appelées par `weechat.xxx(arg1, arg2, ...)`
+
+Tcl
+^^^
+
+* Les fonctions sont appelées par `weechat::xxx arg1 arg2 ...`
+
+Guile (scheme)
+^^^^^^^^^^^^^^
+
+* Les fonctions sont appelées par `(weechat:xxx arg1 arg2 ...)`
+* Les fonctions suivantes prennent une liste de paramètres en entrée (au lieu
+  de plusieurs paramètres pour les autres fonctions), car le nombre de
+  paramètres excède la limite de Guile :
+** config_new_section
+** config_new_option
+** bar_new
 
 [[register_function]]
 Fonction register
@@ -76,14 +108,6 @@ Paramètres :
 
 Exemple, pour chaque langage :
 
-* perl :
-
-[source,perl]
-----------------------------------------
-weechat::register("test_perl", "FlashCode", "1.0", "GPL3", "Script de test", "", "");
-weechat::print("", "Bonjour, du script perl !");
-----------------------------------------
-
 * python :
 
 [source,python]
@@ -94,6 +118,14 @@ weechat.register("test_python", "FlashCode", "1.0", "GPL3", "Script de test", ""
 weechat.prnt("", "Bonjour, du script python !")
 ----------------------------------------
 
+* perl :
+
+[source,perl]
+----------------------------------------
+weechat::register("test_perl", "FlashCode", "1.0", "GPL3", "Script de test", "", "");
+weechat::print("", "Bonjour, du script perl !");
+----------------------------------------
+
 * ruby :
 
 [source,ruby]
@@ -115,12 +147,20 @@ weechat.print("", "Bonjour, du script lua !")
 
 * tcl :
 
-// [source,tcl]
+[source,tcl]
 ----------------------------------------
 weechat::register "test_tcl" "FlashCode" "1.0" "GPL3" "Script de test" "" ""
 weechat::print "" "Bonjour, du script tcl !"
 ----------------------------------------
 
+* guile (scheme):
+
+[source,lisp]
+----------------------------------------
+(weechat:register "test_scheme" "FlashCode" "1.0" "GPL3" "Script de test" "" "")
+(weechat:print "" "Bonjour, du script scheme !")
+----------------------------------------
+
 [[load_script]]
 Chargement du script
 ~~~~~~~~~~~~~~~~~~~~
@@ -128,11 +168,12 @@ Chargement du script
 Vous devez utiliser la commande, dépendant du langage :
 
 ----------------------------------------
-/perl load perl/script.pl
 /python load python/script.py
+/perl load perl/script.pl
 /ruby load ruby/script.rb
 /lua load lua/script.lua
 /tcl load tcl/script.tcl
+/guile load guile/script.scm
 ----------------------------------------
 
 Vous pouvez faire un lien dans le répertoire 'langage/autoload' pour charger
diff --git a/doc/fr/weechat_user.fr.txt b/doc/fr/weechat_user.fr.txt
index ae4a135dd..641c57633 100644
--- a/doc/fr/weechat_user.fr.txt
+++ b/doc/fr/weechat_user.fr.txt
@@ -88,23 +88,24 @@ Dépendances
 Le tableau suivant liste les paquets qui sont requis ou optionnels pour
 compiler WeeChat.
 
-[width="80%",cols="4,^2,13",options="header"]
+[width="100%",cols="5,^3,^3,13",options="header"]
 |========================================
-| Paquet ^(1)^            | Requis | Fonctionnalité
-| cmake                   | *oui*  | construction (autotools toujours possible, mais cmake est recommandé)
-| libncursesw5-dev ^(2)^  | *oui*  | interface ncurses
-| gettext                 | non    | internationalisation (traduction des messages; la langue de base est l'anglais)
-| libgcrypt11-dev         | non    | authentification SASL avec le serveur IRC, en utilisant le mécanisme DH-BLOWFISH
-| libgnutls-dev (≥ 2.2.0) | non    | connexion SSL au serveur IRC
-| ca-certificates         | no     | certificats pour les connexions SSL
-| libaspell-dev           | non    | extension aspell
-| libperl-dev             | non    | extension perl
-| python-dev              | non    | extension python
-| ruby1.8-dev             | non    | extension ruby
-| liblua5.1-0-dev         | non    | extension lua
-| tcl-dev (≥ 8.5)         | non    | extension tcl
-| asciidoc (≥ 8.5.0)      | non    | construction de la documentation (fichiers HTML)
-| source-highlight        | non    | coloration des sources dans la documentation HTML
+| Paquet ^(1)^           | Version   | Requis | Fonctionnalité
+| cmake                  |           | *oui*  | construction (autotools toujours possible, mais cmake est recommandé)
+| libncursesw5-dev ^(2)^ |           | *oui*  | interface ncurses
+| gettext                |           |        | internationalisation (traduction des messages; la langue de base est l'anglais)
+| libgcrypt11-dev        |           |        | authentification SASL avec le serveur IRC, en utilisant le mécanisme DH-BLOWFISH
+| libgnutls-dev          | ≥ 2.2.0   |        | connexion SSL au serveur IRC
+| ca-certificates        |           |        | certificats pour les connexions SSL
+| libaspell-dev          |           |        | extension aspell
+| python-dev             | 2.5 → 2.7 |        | extension python
+| libperl-dev            |           |        | extension perl
+| ruby1.8-dev            |           |        | extension ruby
+| liblua5.1-0-dev        |           |        | extension lua
+| tcl-dev                | ≥ 8.5     |        | extension tcl
+| guile-1.8-dev          |           |        | extention guile (scheme)
+| asciidoc               | ≥ 8.5.0   |        | construction de la documentation (fichiers HTML)
+| source-highlight       |           |        | coloration des sources dans la documentation HTML
 |========================================
 
 [NOTE]
@@ -1020,7 +1021,7 @@ WeeChat tourne.
 Il est important de bien faire la différence entre une 'extension' et un
 'script' : une 'extension' est un fichier binaire compilé et chargé avec la
 commande `/plugin`, tandis qu'un 'script' est un fichier texte chargé par une
-extension comme 'perl' par la commande `perl`.
+extension comme 'python' par la commande `/python`.
 
 Vous pouvez utiliser la commande `/plugin` pour charger/décharger une
 extension, ou afficher les extensions chargées.
@@ -1049,11 +1050,12 @@ Les extensions par défaut sont :
 | logger    | Enregistrement des tampons dans des fichiers
 | relay     | Relai de données via le réseau (proxy IRC)
 | rmodifier | Modification des chaînes de "modifier" avec des expressions régulières
-| perl      | Interface (API) pour scripts Perl
 | python    | Interface (API) pour scripts Python
+| perl      | Interface (API) pour scripts Perl
 | ruby      | Interface (API) pour scripts Ruby
 | lua       | Interface (API) pour scripts Lua
 | tcl       | Interface (API) pour scripts Tcl
+| guile     | Interface (API) pour scripts Guile (scheme)
 | xfer      | Transfert de fichier et discussion directe
 |========================================
 
@@ -1258,11 +1260,11 @@ $ echo 'irc.freenode.#weechat *bonjour !' >~/.weechat/weechat_fifo_12345
 $ echo '*bonjour !' >~/.weechat/weechat_fifo_12345
 ----------------------------------------
 
-* envoyer deux commandes pour décharger/recharger les scripts Perl (vous devez
+* envoyer deux commandes pour décharger/recharger les scripts Python (vous devez
   les séparer par "\n") :
 
 ----------------------------------------
-$ echo -e '*/perl unload\n*/perl autoload' >~/.weechat/weechat_fifo_12345
+$ echo -e '*/python unload\n*/python autoload' >~/.weechat/weechat_fifo_12345
 ----------------------------------------
 
 Vous pouvez écrire un script qui envoie les commandes à tous les WeeChat qui
@@ -1971,7 +1973,8 @@ sera : `/oper nick ********`.
 Extensions Scripts
 ~~~~~~~~~~~~~~~~~~
 
-WeeChat fournit 5 extensions pour scripts : Perl, Python, Ruby, Lua et Tcl.
+WeeChat fournit 6 extensions pour scripts : Python, Perl, Ruby, Lua, Tcl et
+Guile (scheme).
 Ces extensions peuvent charger, exécuter et décharger des scripts pour ces
 langages.
 
@@ -1981,18 +1984,18 @@ WeeChat pour les scripts, merci de lire le 'Le Guide pour Scripts WeeChat'.
 Vous pouvez trouver des scripts pour WeeChat ici :
 http://www.weechat.org/scripts
 
-[[perl_commands]]
-Commandes Perl
-^^^^^^^^^^^^^^
-
-include::autogen/user/perl_commands.txt[]
-
 [[python_commands]]
 Commandes Python
 ^^^^^^^^^^^^^^^^
 
 include::autogen/user/python_commands.txt[]
 
+[[perl_commands]]
+Commandes Perl
+^^^^^^^^^^^^^^
+
+include::autogen/user/perl_commands.txt[]
+
 [[ruby_commands]]
 Commandes Ruby
 ^^^^^^^^^^^^^^
@@ -2011,6 +2014,12 @@ Commandes Tcl
 
 include::autogen/user/tcl_commands.txt[]
 
+[[guile_commands]]
+Commandes Guile
+^^^^^^^^^^^^^^^
+
+include::autogen/user/guile_commands.txt[]
+
 [[xfer_plugin]]
 Extension Xfer
 ~~~~~~~~~~~~~~