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

5 files changed, 129 insertions, 54 deletions

diff --git a/doc/it/autogen/plugin_api/completions.txt b/doc/it/autogen/plugin_api/completions.txt
index 8d145f62b..3d8b2a5cc 100644
--- a/doc/it/autogen/plugin_api/completions.txt
+++ b/doc/it/autogen/plugin_api/completions.txt
@@ -8,6 +8,8 @@
 
 | aspell | aspell_langs | elenco di lingue supportate per aspell
 
+| guile | guile_script | elenco degli script
+
 | irc | irc_channel | canale IRC corrente
 
 | irc | irc_channel_nicks_hosts | nick e host del canale IRC corrente
diff --git a/doc/it/autogen/plugin_api/infolists.txt b/doc/it/autogen/plugin_api/infolists.txt
index 70cfd165f..7dcf002ef 100644
--- a/doc/it/autogen/plugin_api/infolists.txt
+++ b/doc/it/autogen/plugin_api/infolists.txt
@@ -4,6 +4,8 @@
 
 | alias | alias | elenco di alias | puntatore all'alias (opzionale) | nome alias (può iniziare o terminare con "*" come carattere jolly) (opzionale)
 
+| guile | guile_script | elenco degli script | puntatore allo script (opzionale) | nome script (può iniziare o terminare con "*" come carattere jolly) (opzionale)
+
 | irc | irc_channel | elenco dei canali per un server IRC | puntatore al canale (opzionale) | server,canale (canale è opzionale)
 
 | irc | irc_ignore | elenco di ignore IRC | puntatore all'ignore (opzionale) | -
diff --git a/doc/it/autogen/user/guile_commands.txt b/doc/it/autogen/user/guile_commands.txt
new file mode 100644
index 000000000..989c5e3fa
--- /dev/null
+++ b/doc/it/autogen/user/guile_commands.txt
@@ -0,0 +1,20 @@
+[[command_guile_guile]]
+[command]*`guile`* elenca/carica/scarica script::
+........................................
+/guile  list|listfull [<nome>]
+        load <nomefile>
+        autoload
+        reload|unload [<nome>]
+
+     list: elenca i plugin caricati
+ listfull: elenca i plugin caricati (dettagliato)
+     load: carica un plugin
+ autoload: carica automaticamente i plugin nella cartella utente o di sistema
+   reload: ricarica un plugin (se non specificato, scarica i plugin e li ricarica automaticamente)
+   unload: scarica uno o tutti i plugin
+nome_file: (file) script da caricare
+     nome: il nome di uno script (usato nella chiamata alla funzione "register")
+
+Senza argomento, questo comando elenca tutti i plugin caricati.
+........................................
+
diff --git a/doc/it/weechat_scripting.it.txt b/doc/it/weechat_scripting.it.txt
index 0f72b68b2..912c10552 100644
--- a/doc/it/weechat_scripting.it.txt
+++ b/doc/it/weechat_scripting.it.txt
@@ -17,9 +17,16 @@ Introduzione
 WeeChat (Wee Enhanced Environment for Chat) è un client di chat libero,
 veloce e leggero, realizzato per molti sistemi operativi.
 
-Questo manuale documenta i metodi per la realizzazione di script per
-WeeChat, utilizzando uno dei cinque linguaggi di script supportati: perl,
-python, ruby, lua o tcl.
+// TRANSLATION MISSING
+This manual documents way to write scripts for WeeChat, using one of supported
+script languages:
+
+* python
+* perl
+* ruby
+* lua
+* tcl
+* guile (scheme)
 
 [NOTE]
 Quasi tutti gli esempi in questo manuale sono scritti in Python, ma l'API
@@ -33,20 +40,46 @@ Script in WeeChat
 Specifiche per i linguaggi
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Alcune cose sono specifiche per i linguaggi:
+Python
+^^^^^^
 
-* perl:
-** le funzioni sono chiamate con `weechat::xxx(arg1, arg2, ...);`
-* python:
-** è necessario `import weechat`
-** le funzioni `print*` sono chiamate `prnt*` in python (dato che 'print'
-   è una parola riservata)
-** le funzioni sono chiamate con `weechat.xxx(arg1, arg2, ...)`
-* ruby:
-** è necessario definire 'weechat_init' e chiamare 'register' all'interno
-** le funzioni sono chiamate con `Weechat.xxx(arg1, arg2, ...)`
-* tcl:
-** le funzioni sono chiamate con `weechat::xxx arg1 arg2 ...`
+* E necessario `import weechat`
+* Le funzioni `print*` sono chiamate `prnt*` in python (dato che 'print'
+  è una parola riservata)
+* Le funzioni sono chiamate con `weechat.xxx(arg1, arg2, ...)`
+
+Perl
+^^^^
+
+* Le funzioni sono chiamate con `weechat::xxx(arg1, arg2, ...);`
+
+Ruby
+^^^^
+
+* E necessario definire 'weechat_init' e chiamare 'register' all'interno
+* Le funzioni sono chiamate con `Weechat.xxx(arg1, arg2, ...)`
+
+Lua
+^^^
+
+* Le funzioni sono chiamate con `weechat.xxx(arg1, arg2, ...)`
+
+Tcl
+^^^
+
+* Le funzioni sono chiamate con `weechat::xxx arg1 arg2 ...`
+
+Guile (scheme)
+^^^^^^^^^^^^^^
+
+// TRANSLATION MISSING
+* Functions are called with `(weechat:xxx arg1 arg2 ...)`
+* Following functions take one list of arguments (instead of many arguments
+  for other functions), because number of arguments exceed number of allowed
+  arguments in Guile:
+** config_new_section
+** config_new_option
+** bar_new
 
 [[register_function]]
 Registrare una funzione
@@ -76,14 +109,6 @@ Argomenti:
 
 Esempio di script, per ogni linguaggio:
 
-* perl:
-
-[source,perl]
-----------------------------------------
-weechat::register("test_perl", "FlashCode", "1.0", "GPL3", "Test script", "", "");
-weechat::print("", "Hello, from perl script!");
-----------------------------------------
-
 * python:
 
 [source,python]
@@ -94,6 +119,14 @@ weechat.register("test_python", "FlashCode", "1.0", "GPL3", "Test script", "", "
 weechat.prnt("", "Hello, from python script!")
 ----------------------------------------
 
+* perl:
+
+[source,perl]
+----------------------------------------
+weechat::register("test_perl", "FlashCode", "1.0", "GPL3", "Test script", "", "");
+weechat::print("", "Hello, from perl script!");
+----------------------------------------
+
 * ruby:
 
 [source,ruby]
@@ -115,12 +148,20 @@ weechat.print("", "Hello, from lua script!")
 
 * tcl:
 
-// [source,tcl]
+[source,tcl]
 ----------------------------------------
 weechat::register "test_tcl" "FlashCode" "1.0" "GPL3" "Test script" "" ""
 weechat::print "" "Hello, from tcl script!"
 ----------------------------------------
 
+* guile (scheme):
+
+[source,lisp]
+----------------------------------------
+(weechat:register "test_scheme" "FlashCode" "1.0" "GPL3" "Test script" "" "")
+(weechat:print "" "Hello, from scheme script!")
+----------------------------------------
+
 [[load_script]]
 Caricare uno script
 ~~~~~~~~~~~~~~~~~~~
@@ -128,11 +169,12 @@ Caricare uno script
 Il comando da utilizzare, in base al linguaggio:
 
 ----------------------------------------
-/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
 ----------------------------------------
 
 È possibile creare un link nella cartella 'linguaggio/autoload' per caricare
diff --git a/doc/it/weechat_user.it.txt b/doc/it/weechat_user.it.txt
index c15b210b7..c9ec6f63f 100644
--- a/doc/it/weechat_user.it.txt
+++ b/doc/it/weechat_user.it.txt
@@ -90,23 +90,24 @@ Dipendenze
 La seguente tabella mostra l'elenco di pacchetti richiesti o opzionali per
 compilare WeeChat.
 
-[width="80%",cols="4,^2,13",options="header"]
+[width="100%",cols="5,^3,^3,13",options="header"]
 |========================================
-| Pacchetto ^(1)^         | Richiesto | Caratteristica
-| cmake                   | *sì*      | compilazione (ancora possibile con autotools, ma si raccomanda cmake)
-| libncursesw5-dev ^(2)^  | *sì*      | interfaccia ncurses
-| gettext                 | no        | internazionalizzazione (traduzione dei messaggi; la lingua base è l'inglese)
-| libgcrypt11-dev         | no        | autenticazione SASL per i server IRC che utilizzano il meccanismo DH-BLOWFISH
-| libgnutls-dev (≥ 2.2.0) | no        | connessione SSL al server IRC
-| ca-certificates         | no        | certificati per le connessioni SSL
-| libaspell-dev           | no        | plugin aspell
-| libperl-dev             | no        | plugin perl
-| python-dev              | no        | plugin python
-| ruby1.8-dev             | no        | plugin ruby
-| liblua5.1-0-dev         | no        | plugin lua
-| tcl-dev (≥ 8.5)         | no        | plugin tcl
-| asciidoc (≥ 8.5.0)      | no        | compilazione della documentazione (file HTML)
-| source-highlight        | no        | evidenziazione della sintassi per i sorgenti nella documentazione HTML
+| Pacchetto ^(1)^        | Versione  | Richiesto | Caratteristica
+| cmake                  |           | *sì*      | compilazione (ancora possibile con autotools, ma si raccomanda cmake)
+| libncursesw5-dev ^(2)^ |           | *sì*      | interfaccia ncurses
+| gettext                |           |           | internazionalizzazione (traduzione dei messaggi; la lingua base è l'inglese)
+| libgcrypt11-dev        |           |           | autenticazione SASL per i server IRC che utilizzano il meccanismo DH-BLOWFISH
+| libgnutls-dev          | ≥ 2.2.0   |           | connessione SSL al server IRC
+| ca-certificates        |           |           | certificati per le connessioni SSL
+| libaspell-dev          |           |           | plugin aspell
+| python-dev             | 2.5 → 2.7 |           | plugin python
+| libperl-dev            |           |           | plugin perl
+| ruby1.8-dev            |           |           | plugin ruby
+| liblua5.1-0-dev        |           |           | plugin lua
+| tcl-dev                | ≥ 8.5     |           | plugin tcl
+| guile-1.8-dev          |           |           | plugin guile (scheme)
+| asciidoc               | ≥ 8.5.0   |           | compilazione della documentazione (file HTML)
+| source-highlight       |           |           | evidenziazione della sintassi per i sorgenti nella documentazione HTML
 |========================================
 
 [NOTE]
@@ -1011,8 +1012,8 @@ I plugin trovati vengono caricati automaticamente all'avvio di WeeChat, ed
 
 È importante evidenziare la differenza tra un 'plugin' ed uno 'script': un
 'plugin' è un file binario compilato e caricato con il comando `/plugin`,
-mentre uno 'script' è un file di testo caricato con un plugin come 'perl'
-con il comando `/perl`.
+mentre uno 'script' è un file di testo caricato con un plugin come 'python'
+con il comando `/python`.
 
 È possibile utilizzare il comando `/plugin` per caricare/scaricare un plugin,
 oppure elencare tutti i plugin caricati.
@@ -1041,11 +1042,12 @@ I plugin predefiniti sono:
 | logger    | Registra i buffer su file
 | relay     | Relay dei dati via rete (proxy IRC)
 | rmodifier | Cambia le stringhe del modificatore con espressioni regolari
-| perl      | API per lo scripting in Perl
 | python    | API per lo scripting in Python
+| perl      | API per lo scripting in Perl
 | ruby      | API per lo scripting in Ruby
 | lua       | API per lo scripting in Lua
 | tcl       | API per lo scripting in TCL
+| guile     | API per lo scripting in Guile (scheme)
 | xfer      | Trasferimento file e chat diretta
 |=======================================
 
@@ -1244,11 +1246,11 @@ $ echo 'irc.freenode.#weechat *hello!' >~/.weechat/weechat_fifo_12345
 $ echo '*hello!' >~/.weechat/weechat_fifo_12345
 ----------------------------------------
 
-* inviare due comandi per scaricare/caricare gli script Perl (è necessario
+* inviare due comandi per scaricare/caricare gli script Python (è necessario
   separarli con "\n"):
 
 ----------------------------------------
-$ echo -e '*/perl unload\n*/perl autoload' >~/.weechat/weechat_fifo_12345
+$ echo -e '*/python unload\n*/python autoload' >~/.weechat/weechat_fifo_12345
 ----------------------------------------
 
 È possibile realizzare uno script per inviare un comando a tutte le istanze di
@@ -1956,7 +1958,8 @@ Se la riga di comando contiene: `/oper nick password` allora sullo schermo diven
 Plugin per gli script
 ~~~~~~~~~~~~~~~~~~~~~
 
-WeeChat fornisce 5 plugin per lo scripting: Perl, Python, Ruby, Lua, Tcl.
+WeeChat fornisce 6 plugin per lo scripting: Python, Perl, Ruby, Lua, Tcl, Guile
+(scheme).
 Questi plugin possono caricare, eseguire e scaricare gli script per questi
 linguaggi.
 
@@ -1965,18 +1968,18 @@ per gli script, consultare la 'Guida allo Scripting di WeeChat'.
 
 È possibile trovare alcuni script qui: http://www.weechat.org/scripts
 
-[[perl_commands]]
-Comandi Perl
-^^^^^^^^^^^^
-
-include::autogen/user/perl_commands.txt[]
-
 [[python_commands]]
 Comandi Python
 ^^^^^^^^^^^^^^
 
 include::autogen/user/python_commands.txt[]
 
+[[perl_commands]]
+Comandi Perl
+^^^^^^^^^^^^
+
+include::autogen/user/perl_commands.txt[]
+
 [[ruby_commands]]
 Comandi Ruby
 ^^^^^^^^^^^^
@@ -1995,6 +1998,12 @@ Comandi Tcl
 
 include::autogen/user/tcl_commands.txt[]
 
+[[guile_commands]]
+Comandi Guile
+^^^^^^^^^^^^^
+
+include::autogen/user/guile_commands.txt[]
+
 [[xfer_plugin]]
 Plugin Xfer
 ~~~~~~~~~~~