Add doc for some signals and hsignals in plugin API reference

Doc for signals:
- logger_backlog
- xxx_script_install
- xxx_script_remove
- irc_input_send

Doc for hsignals:
- irc_redirect_command
- irc_redirect_pattern

9 files changed, 969 insertions, 13 deletions

diff --git a/doc/en/CMakeLists.txt b/doc/en/CMakeLists.txt
index c688bd312..3859504c3 100644
--- a/doc/en/CMakeLists.txt
+++ b/doc/en/CMakeLists.txt
@@ -32,7 +32,7 @@ INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_user.en.html DESTINATION ${SHA
 # plugin API reference
 ADD_CUSTOM_COMMAND(
   OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_plugin_api.en.html
-  COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=3 -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_plugin_api.en.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_plugin_api.en.txt
+  COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=4 -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_plugin_api.en.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_plugin_api.en.txt
   DEPENDS
   ${CMAKE_CURRENT_SOURCE_DIR}/weechat_plugin_api.en.txt
   ${CMAKE_CURRENT_SOURCE_DIR}/autogen/plugin_api/*.txt
diff --git a/doc/en/Makefile.am b/doc/en/Makefile.am
index e33990bd0..40ca4d0f5 100644
--- a/doc/en/Makefile.am
+++ b/doc/en/Makefile.am
@@ -43,7 +43,7 @@ weechat_user.en.html: weechat_user.en.txt $(wildcard autogen/user/*.txt)
 
 # plugin API reference
 weechat_plugin_api.en.html: weechat_plugin_api.en.txt $(wildcard autogen/plugin_api/*.txt)
-	$(ASCIIDOC) -a toc -a toclevels=3 -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_plugin_api.en.html weechat_plugin_api.en.txt
+	$(ASCIIDOC) -a toc -a toclevels=4 -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_plugin_api.en.html weechat_plugin_api.en.txt
 
 # scripting guide
 weechat_scripting.en.html: weechat_scripting.en.txt
diff --git a/doc/en/weechat_plugin_api.en.txt b/doc/en/weechat_plugin_api.en.txt
index ff6add99e..d9f657df4 100644
--- a/doc/en/weechat_plugin_api.en.txt
+++ b/doc/en/weechat_plugin_api.en.txt
@@ -6765,6 +6765,154 @@ weechat.hook_signal_send(signal, type_data, signal_data)
 weechat.hook_signal_send("my_signal", weechat.WEECHAT_HOOK_SIGNAL_STRING, my_string)
 ----------------------------------------
 
+[[signal_logger_backlog]]
+Signal logger_backlog
++++++++++++++++++++++
+
+The signal "logger_backlog" can be sent to display backlog (chat history) in
+buffer (for example if you open your own buffer in your plugin/script).
+
+Argument is a pointer to buffer.
+
+C example:
+
+[source,C]
+----------------------------------------
+weechat_hook_signal_send ("logger_backlog", WEECHAT_HOOK_SIGNAL_POINTER, buffer);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+weechat.hook_signal_send("logger_backlog", weechat.WEECHAT_HOOK_SIGNAL_POINTER, buffer)
+----------------------------------------
+
+[[signals_xxx_script_install]]
+Signals xxx_script_install
+++++++++++++++++++++++++++
+
+Five signals can be sent to install a script, according to language:
+
+* 'perl_script_install'
+* 'python_script_install'
+* 'ruby_script_install'
+* 'lua_script_install'
+* 'tcl_script_install'
+
+The callback will do following actions when receiving signal:
+
+. unload and remove installed script
+. move new script to directory '~/.weechat/xxx/' (where 'xxx' is language) 
+. create link to new script in directory '~/.weechat/xxx/autoload/'
+. load new script
+
+These signals are used by script 'weeget.py' to install scripts.
+
+Argument is a string with path to script to install.
+
+C example:
+
+[source,C]
+----------------------------------------
+weechat_hook_signal_send ("python_script_install", WEECHAT_HOOK_SIGNAL_STRING,
+                          "/home/xxx/.weechat/test.py");
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+weechat.hook_signal_send("python_script_install", WEECHAT_HOOK_SIGNAL_STRING,
+                         "/home/xxx/.weechat/test.py")
+----------------------------------------
+
+[[signals_xxx_script_remove]]
+Signals xxx_script_remove
++++++++++++++++++++++++++
+
+Five signals can be sent to remove list of scripts, according to language:
+
+* 'perl_script_remove'
+* 'python_script_remove'
+* 'ruby_script_remove'
+* 'lua_script_remove'
+* 'tcl_script_remove'
+
+For each script in list, the callback will unload then remove script.
+
+These signals are used by script 'weeget.py' to remove scripts.
+
+Argument is a string with comma-separated list of script to remove (script
+is name without path, for example 'script.py').
+
+C example:
+
+[source,C]
+----------------------------------------
+/* unload and remove scripts test.py and script.py */
+weechat_hook_signal_send ("python_script_remove", WEECHAT_HOOK_SIGNAL_STRING,
+                          "test.py,script.py");
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# unload and remove scripts test.py and script.py
+weechat.hook_signal_send("python_script_remove", WEECHAT_HOOK_SIGNAL_STRING,
+                         "test.py,script.py")
+----------------------------------------
+
+[[signal_irc_input_send]]
+Signal irc_input_send
++++++++++++++++++++++
+
+_New in version 0.3.4._
+
+The signal "irc_input_send" can be sent to simulate input in an irc buffer
+(server, channel or private).
+
+Argument is a string with following format:
+
+* internal server name (required)
+* semicolon
+* channel name (optional)
+* semicolon
+* flags used when sending message (optional, default is 1):
+** '1': queue with high priority (like user messages)
+** '2': queue with low priority (like messages automatically sent by WeeChat)
+* semicolon
+* comma-separated list of tags used when sending message (optional)
+* semicolon
+* text or command (required)
+
+C examples:
+
+[source,C]
+----------------------------------------
+/* say "Hello!" on freenode server, #weechat channel */
+weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING,
+                          "freenode;#weechat;1;;Hello!");
+
+/* send command "/whois FlashCode" on freenode server, with low priority */
+weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING,
+                          "freenode;;2;;/whois FlashCode");
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# say "Hello!" on freenode server, #weechat channel
+weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
+                         "freenode;#weechat;1;;Hello!")
+
+# send command "/whois FlashCode" on freenode server, with low priority
+weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
+                         "freenode;;2;;/whois FlashCode")
+----------------------------------------
+
 weechat_hook_hsignal
 ^^^^^^^^^^^^^^^^^^^^
 
@@ -6793,7 +6941,7 @@ Arguments:
 | Plugin | Signal | Arguments
 
 | irc | irc_redirection_xxx_yyy ^(1)^ |
-  redirection output
+  redirection output (see <<hsignal_irc_redirect_command>>)
 |========================================
 
 [NOTE]
@@ -6887,6 +7035,169 @@ weechat.hook_hsignal_send(signal, hashtable)
 weechat.hook_hsignal_send("my_hsignal", { "key": "value" })
 ----------------------------------------
 
+[[hsignal_irc_redirect_command]]
+Hsignal irc_redirect_command
+++++++++++++++++++++++++++++
+
+_New in version 0.3.4._
+
+The hsignal "irc_redirect_command" can be sent to redirect output of irc
+command to a callback.
+
+Argument is a hashtable with following entries (keys and values are string):
+
+* 'server': internal server name (required)
+* 'pattern': redirect pattern to use (required), either a default one (defined
+  by irc plugin), or a user pattern (see <<hsignal_irc_redirect_pattern>>),
+  default patterns are:
+** 'ison'
+** 'list'
+** 'mode_channel'
+** 'mode_channel_ban' ("mode #channel b")
+** 'mode_channel_ban_exception' ("mode #channel e")
+** 'mode_channel_invite' ("mode #channel I")
+** 'mode_user'
+** 'names'
+** 'ping'
+** 'time'
+** 'topic'
+** 'userhost'
+** 'who'
+** 'whois'
+** 'whowas'
+* 'signal': signal name (required)
+* 'count': number of times redirection will work (optional, 1 by default)
+* 'string': string that must be in irc messages received (optional, but
+  recommended, if a string can be used to identify messages)
+* 'timeout': timeout for redirect, in seconds (optional, 60 by default)
+* 'cmd_filter': comma-separated list of irc commands to filter (only these
+  commands will be sent to callbacks, other will be ignored) (optional)
+
+Immediately after sending this hsignal, you must send command to irc server,
+and redirection will be used for this command.
+
+C example:
+
+[source,C]
+----------------------------------------
+int
+test_whois_cb (void *data, const char *signal, struct t_hashtable *hashtable)
+{
+    weechat_printf (NULL, "error = %s", weechat_hashtable_get (hashtable, "error"));
+    weechat_printf (NULL, "output = %s", weechat_hashtable_get (hashtable, "output"));
+    return WEECHAT_RC_OK;
+}
+
+weechat_hook_hsignal ("irc_redirection_test_whois", &test_whois_cb, NULL);
+struct t_hashtable *hashtable = weechat_hashtable_new (8,
+                                                       WEECHAT_HASHTABLE_STRING,
+                                                       WEECHAT_HASHTABLE_INTEGER,
+                                                       NULL,
+                                                       NULL);
+if (hashtable)
+{
+    weechat_hashtable_set (hashtable, "server", "freenode");
+    weechat_hashtable_set (hashtable, "pattern", "whois");
+    weechat_hashtable_set (hashtable, "signal", "test");
+    weechat_hashtable_set (hashtable, "string", "FlashCode");
+    weechat_hook_hsignal_send ("irc_redirect_command", hashtable);
+    weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING,
+                              "freenode;;2;;/whois FlashCode");
+    weechat_hashtable_free (hashtable);
+}
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+def test_whois_cb(data, signal, hashtable):
+    weechat.prnt("", "error = %s" % hashtable["error"])
+    weechat.prnt("", "output = %s" % hashtable["output"])
+    return weechat.WEECHAT_RC_OK
+}
+
+weechat.hook_hsignal ("irc_redirection_test_whois", "test_whois_cb", "")
+weechat.hook_hsignal_send("irc_redirect_command",
+                          { "server": "freenode", "pattern": "whois", "signal": "test",
+                            "string": "FlashCode" })
+weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
+                         "freenode;;2;;/whois FlashCode")
+----------------------------------------
+
+[[hsignal_irc_redirect_pattern]]
+Hsignal irc_redirect_pattern
+++++++++++++++++++++++++++++
+
+_New in version 0.3.4._
+
+The hsignal "irc_redirect_pattern" can be sent to create a pattern for irc
+redirect (see <<hsignal_irc_redirect_command>>).
+
+Argument is a hashtable with following entries (keys and values are string):
+
+* 'pattern': name of pattern (required)
+* 'timeout': default timeout for pattern, in seconds (optional, 60 by default)
+* 'cmd_start': comma-separated list of commands starting redirect (optional)
+* 'cmd_stop': comma-separated list of commands stopping redirect (required)
+* 'cmd_extra': comma-separated list of commands that may be received
+  after stop commands (optional)
+
+For each command in 'cmd_start', 'cmd_stop' and 'cmd_extra', it is possible to
+give integer with position of "string" that must be found in received message,
+for example:
+
+----------------------------------------
+352:1,354,401:1
+----------------------------------------
+
+For commands 352 and 401, "string" must be found in received message,
+as first argument.
+
+[IMPORTANT]
+The pattern is destroyed when it is used by a redirection. If you need pattern
+for many redirections, you must create pattern before each redirect.
+
+C example:
+
+[source,C]
+----------------------------------------
+struct t_hashtable *hashtable = weechat_hashtable_new (8,
+                                                       WEECHAT_HASHTABLE_STRING,
+                                                       WEECHAT_HASHTABLE_INTEGER,
+                                                       NULL,
+                                                       NULL);
+if (hashtable)
+{
+    weechat_hashtable_set (hashtable, "pattern", "my_whois");
+    weechat_hashtable_set (hashtable, "timeout", "30");
+    weechat_hashtable_set (hashtable, "cmd_start", "311:1");
+    weechat_hashtable_set (hashtable, "cmd_stop", "318:1,401:1,402:1,431:1,461");
+    weechat_hashtable_set (hashtable, "cmd_extra", "318:1");
+    weechat_hook_hsignal_send ("irc_redirect_pattern", hashtable);
+    /*
+     * now redirect irc whois command with hsignal irc_redirect_command,
+     * using pattern "my_whois"
+     */
+    /* ... */
+    weechat_hashtable_free (hashtable);
+}
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+weechat.hook_hsignal_send("irc_redirect_pattern",
+                          { "pattern": "my_whois", "timeout": "30",
+                            "cmd_start": "311:1",
+                            "cmd_stop": "318:1,401:1,402:1,431:1,461",
+                            "cmd_extra": "318:1" })
+# now redirect irc whois command with hsignal irc_redirect_command
+# using pattern "my_whois"
+# ...
+----------------------------------------
+
 weechat_hook_config
 ^^^^^^^^^^^^^^^^^^^
 
diff --git a/doc/fr/CMakeLists.txt b/doc/fr/CMakeLists.txt
index 4dd2870c1..4ed993f55 100644
--- a/doc/fr/CMakeLists.txt
+++ b/doc/fr/CMakeLists.txt
@@ -32,7 +32,7 @@ INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_user.fr.html DESTINATION ${SHA
 # plugin API reference
 ADD_CUSTOM_COMMAND(
   OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_plugin_api.fr.html
-  COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=3 -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_plugin_api.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_plugin_api.fr.txt
+  COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=4 -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_plugin_api.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_plugin_api.fr.txt
   DEPENDS
   ${CMAKE_CURRENT_SOURCE_DIR}/weechat_plugin_api.fr.txt
   ${CMAKE_CURRENT_SOURCE_DIR}/autogen/plugin_api/*.txt
diff --git a/doc/fr/Makefile.am b/doc/fr/Makefile.am
index 02e92e9be..f7b2db1ba 100644
--- a/doc/fr/Makefile.am
+++ b/doc/fr/Makefile.am
@@ -43,7 +43,7 @@ weechat_user.fr.html: weechat_user.fr.txt $(wildcard autogen/user/*.txt)
 
 # plugin API reference
 weechat_plugin_api.fr.html: weechat_plugin_api.fr.txt $(wildcard autogen/plugin_api/*.txt)
-	$(ASCIIDOC) -a toc -a toclevels=3 -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_plugin_api.fr.html weechat_plugin_api.fr.txt
+	$(ASCIIDOC) -a toc -a toclevels=4 -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_plugin_api.fr.html weechat_plugin_api.fr.txt
 
 # scripting guide
 weechat_scripting.fr.html: weechat_scripting.fr.txt
diff --git a/doc/fr/weechat_plugin_api.fr.txt b/doc/fr/weechat_plugin_api.fr.txt
index 783747a51..8404a24d2 100644
--- a/doc/fr/weechat_plugin_api.fr.txt
+++ b/doc/fr/weechat_plugin_api.fr.txt
@@ -4693,7 +4693,7 @@ Script (Python) :
 value = weechat.config_option_string(option)
 
 # exemple
-value = weechat.config_option_string(option):
+value = weechat.config_option_string(option)
 ----------------------------------------
 
 weechat_config_string_default
@@ -4731,7 +4731,7 @@ Script (Python) :
 value = weechat.config_option_string_default(option)
 
 # exemple
-value = weechat.config_option_string_default(option):
+value = weechat.config_option_string_default(option)
 ----------------------------------------
 
 weechat_config_color
@@ -4769,7 +4769,7 @@ Script (Python) :
 value = weechat.config_option_color(option)
 
 # exemple
-value = weechat.config_option_color(option):
+value = weechat.config_option_color(option)
 ----------------------------------------
 
 weechat_config_color_default
@@ -4808,7 +4808,7 @@ Script (Python) :
 value = weechat.config_option_color_default(option)
 
 # exemple
-value = weechat.config_option_color_default(option):
+value = weechat.config_option_color_default(option)
 ----------------------------------------
 
 weechat_config_write_option
@@ -6850,6 +6850,162 @@ weechat.hook_signal_send(signal, type_data, signal_data)
 weechat.hook_signal_send("mon_signal", weechat.WEECHAT_HOOK_SIGNAL_STRING, ma_chaine)
 ----------------------------------------
 
+[[signal_logger_backlog]]
+Signal logger_backlog
++++++++++++++++++++++
+
+Le signal "logger_backlog" peut être envoyé pour afficher l'historique de
+discussion dans le tampon (par exemple si vous ouvrez votre propre tampon dans
+votre extension/script).
+
+Le paramètre est un pointeur vers le tampon.
+
+Exemple en C :
+
+[source,C]
+----------------------------------------
+weechat_hook_signal_send ("logger_backlog", WEECHAT_HOOK_SIGNAL_POINTER, buffer);
+----------------------------------------
+
+Script (Python) :
+
+[source,python]
+----------------------------------------
+weechat.hook_signal_send("logger_backlog", weechat.WEECHAT_HOOK_SIGNAL_POINTER, buffer)
+----------------------------------------
+
+[[signals_xxx_script_install]]
+Signaux xxx_script_install
+++++++++++++++++++++++++++
+
+Cinq signaux peuvent être envoyés pour installer un script, selon le langage :
+
+* 'perl_script_install'
+* 'python_script_install'
+* 'ruby_script_install'
+* 'lua_script_install'
+* 'tcl_script_install'
+
+Le "callback" effectuera les actions suivantes lorsqu'il recevra le signal :
+
+. déchargement et suppression du script installé
+. déplacement du nouveau script vers le répertoire '~/.weechat/xxx/' (où 'xxx'
+  est le langage) 
+. création d'un lien vers le nouveau script dans le répertoire
+  '~/.weechat/xxx/autoload/'
+. chargement du nouveau script
+
+Ces signaux sont utilisés par le script 'weeget.py' pour installer des scripts.
+
+Le paramètre est une chaîne avec le chemin vers le script à installer.
+
+Exemple en C :
+
+[source,C]
+----------------------------------------
+weechat_hook_signal_send ("python_script_install", WEECHAT_HOOK_SIGNAL_STRING,
+                          "/home/xxx/.weechat/test.py");
+----------------------------------------
+
+Script (Python) :
+
+[source,python]
+----------------------------------------
+weechat.hook_signal_send("python_script_install", WEECHAT_HOOK_SIGNAL_STRING,
+                         "/home/xxx/.weechat/test.py")
+----------------------------------------
+
+[[signals_xxx_script_remove]]
+Signaux xxx_script_remove
++++++++++++++++++++++++++
+
+Cinq signaux peuvent être envoyés pour supprimer une liste de scripts, selon le
+langage :
+
+* 'perl_script_remove'
+* 'python_script_remove'
+* 'ruby_script_remove'
+* 'lua_script_remove'
+* 'tcl_script_remove'
+
+Pour chaque script dans la liste, le "callback" déchargera et supprimera le
+script.
+
+Ces signaux sont utilisés par le script 'weeget.py' pour supprimer des scripts.
+
+Le paramètre est une chaîne avec une liste de scripts à supprimer (séparés par
+des virgules, nom du script sans le chemin, par exemple 'script.py').
+
+Exemple en C :
+
+[source,C]
+----------------------------------------
+/* décharge et supprime les scripts test.py et script.py */
+weechat_hook_signal_send ("python_script_remove", WEECHAT_HOOK_SIGNAL_STRING,
+                          "test.py,script.py");
+----------------------------------------
+
+Script (Python) :
+
+[source,python]
+----------------------------------------
+# décharge et supprime les scripts test.py et script.py
+weechat.hook_signal_send("python_script_remove", WEECHAT_HOOK_SIGNAL_STRING,
+                         "test.py,script.py")
+----------------------------------------
+
+[[signal_irc_input_send]]
+Signal irc_input_send
++++++++++++++++++++++
+
+_Nouveau dans la version 0.3.4._
+
+Le signal "irc_input_send" peut être envoyé pour simuler une entrée de texte
+dans un tampon irc (serveur, canal ou privé).
+
+Le paramètre est une chaîne avec le format suivant :
+
+* nom interne du serveur (requis)
+* point-virgule
+* nom de canal (optionnel)
+* point-virgule
+* drapeaux utilisés lors de l'envoi du message (optionnel, 1 par
+  défaut) :
+** '1' : file d'attente avec haute priorité (comme les messages utilisateur)
+** '2' : file d'attente avec basse priorité (comme les messages envoyés
+   automatiquement par WeeChat)
+* point-virgule
+* liste d'étiquettes (séparées par des virgules) utilisées lors de l'envoi du
+  du message (optionnel)
+* point-virgule
+* texte ou commande (requis)
+
+Exemples en C :
+
+[source,C]
+----------------------------------------
+/* dis "Bonjour !" sur le serveur freenode, canal #weechat */
+weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING,
+                          "freenode;#weechat;1;;Bonjour !");
+
+/* envoie la commande "/whois FlashCode" sur le canal freenode, en basse priorité */
+weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING,
+                          "freenode;;2;;/whois FlashCode");
+----------------------------------------
+
+Script (Python) :
+
+[source,python]
+----------------------------------------
+# dis "Bonjour !" sur le serveur freenode, canal #weechat
+weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
+                         "freenode;#weechat;1;;Bonjour !")
+
+# envoie la commande "/whois FlashCode" sur le canal freenode, en basse priorité
+weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
+                         "freenode;;2;;/whois FlashCode")
+----------------------------------------
+
 weechat_hook_hsignal
 ^^^^^^^^^^^^^^^^^^^^
 
@@ -6878,7 +7034,7 @@ Paramètres :
 | Extension | Signal | Paramètres
 
 | irc | irc_redirection_xxx_yyy ^(1)^ |
-  sortie de la redirection
+  sortie de la redirection (voir <<hsignal_irc_redirect_command>>)
 |========================================
 
 [NOTE]
@@ -6973,6 +7129,178 @@ weechat.hook_hsignal_send(signal, hashtable)
 weechat.hook_hsignal_send("my_hsignal", { "clé": "valeur" })
 ----------------------------------------
 
+[[hsignal_irc_redirect_command]]
+Hsignal irc_redirect_command
+++++++++++++++++++++++++++++
+
+_Nouveau dans la version 0.3.4._
+
+Le hsignal "irc_redirect_command" peut être envoyé pour rediriger la sortie
+d'une commande irc vers un "callback".
+
+Le paramètre est une hashtable avec les entrées suivantes (les clés et valeurs
+sont des chaînes) :
+
+* 'server' : nom interne du serveur (requis)
+* 'pattern' : modèle de redirection à utiliser (requis), soit un par défaut
+  (défini par l'extension irc), ou un modèle utilisateur (voir
+  <<hsignal_irc_redirect_pattern>>), les modèles par défaut sont :
+** 'ison'
+** 'list'
+** 'mode_channel'
+** 'mode_channel_ban' ("mode #channel b")
+** 'mode_channel_ban_exception' ("mode #channel e")
+** 'mode_channel_invite' ("mode #channel I")
+** 'mode_user'
+** 'names'
+** 'ping'
+** 'time'
+** 'topic'
+** 'userhost'
+** 'who'
+** 'whois'
+** 'whowas'
+* 'signal' : nom du signal (requis)
+* 'count' : nombre de fois que la redirection sera exécutée (optionnel, 1 par
+  défaut)
+* 'string' : chaîne qui doit être dans les messages irc reçus (optionnel, mais
+  recommandé, si une chaîne peut être utilisée pour identifier les messages)
+* 'timeout' : temps d'attente maxi pour la redirection, en secondes (optionnel,
+  60 par défaut)
+* 'cmd_filter' : liste de commandes irc (séparées par des virgules) à filtrer
+  (seules ces commandes seront transmises au "callback", les autres seront
+  ignorées) (optionnel)
+
+Immédiatement après l'envoi de ce hsignal, vous devez envoyer la commande au
+serveur irc, et la redirection sera utilisée pour cette commande.
+
+Exemple en C :
+
+[source,C]
+----------------------------------------
+int
+test_whois_cb (void *data, const char *signal, struct t_hashtable *hashtable)
+{
+    weechat_printf (NULL, "erreur = %s", weechat_hashtable_get (hashtable, "error"));
+    weechat_printf (NULL, "sortie = %s", weechat_hashtable_get (hashtable, "output"));
+    return WEECHAT_RC_OK;
+}
+
+weechat_hook_hsignal ("irc_redirection_test_whois", &test_whois_cb, NULL);
+struct t_hashtable *hashtable = weechat_hashtable_new (8,
+                                                       WEECHAT_HASHTABLE_STRING,
+                                                       WEECHAT_HASHTABLE_INTEGER,
+                                                       NULL,
+                                                       NULL);
+if (hashtable)
+{
+    weechat_hashtable_set (hashtable, "server", "freenode");
+    weechat_hashtable_set (hashtable, "pattern", "whois");
+    weechat_hashtable_set (hashtable, "signal", "test");
+    weechat_hashtable_set (hashtable, "string", "FlashCode");
+    weechat_hook_hsignal_send ("irc_redirect_command", hashtable);
+    weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING,
+                              "freenode;;2;;/whois FlashCode");
+    weechat_hashtable_free (hashtable);
+}
+----------------------------------------
+
+Script (Python) :
+
+[source,python]
+----------------------------------------
+def test_whois_cb(data, signal, hashtable):
+    weechat.prnt("", "erreur = %s" % hashtable["error"])
+    weechat.prnt("", "sortie = %s" % hashtable["output"])
+    return weechat.WEECHAT_RC_OK
+}
+
+weechat.hook_hsignal ("irc_redirection_test_whois", "test_whois_cb", "")
+weechat.hook_hsignal_send("irc_redirect_command",
+                          { "server": "freenode", "pattern": "whois", "signal": "test",
+                            "string": "FlashCode" })
+weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
+                         "freenode;;2;;/whois FlashCode")
+----------------------------------------
+
+[[hsignal_irc_redirect_pattern]]
+Hsignal irc_redirect_pattern
+++++++++++++++++++++++++++++
+
+_Nouveau dans la version 0.3.4._
+
+Le hsignal "irc_redirect_pattern" peut être envoyé pour créer un modèle de
+redirection irc (voir <<hsignal_irc_redirect_command>>).
+
+Le paramètre est une hashtable avec les entrées suivantes (les clés et valeurs
+sont des chaînes) :
+
+* 'pattern' : nom du modèle (requis)
+* 'timeout' : temps d'attente maxi pour le modèle, en secondes (optionnel, 60
+  par défaut)
+* 'cmd_start' : liste de commandes (séparées par des virgules) démarrant la
+  redirection (optionnel)
+* 'cmd_stop' : liste de commandes (séparées par des virgules) stoppant la
+  redirection (requis)
+* 'cmd_extra' : liste de commandes (séparées par des virgules) pouvant être
+  reçues après les commandes de stop (optionnel)
+
+Pour chaque commande dans 'cmd_start', 'cmd_stop' et 'cmd_extra', il est
+possible de donner un entier avec la position de la chaîne "string" qui doit
+être trouvée dans le message reçu, par exemple :
+
+----------------------------------------
+352:1,354,401:1
+----------------------------------------
+
+Pour les commandes 352 et 401, la chaîne "string" doit être trouvée dans le
+message reçu, comme premier paramètre.
+
+[IMPORTANT]
+Le modèle est détruit dès qu'il est utilisé dans une redirection. Si vous avez
+besoin du modèle pour plusieurs redirections, vous devez créer un modèle pour
+chaque redirection.
+
+Exemple en C :
+
+[source,C]
+----------------------------------------
+struct t_hashtable *hashtable = weechat_hashtable_new (8,
+                                                       WEECHAT_HASHTABLE_STRING,
+                                                       WEECHAT_HASHTABLE_INTEGER,
+                                                       NULL,
+                                                       NULL);
+if (hashtable)
+{
+    weechat_hashtable_set (hashtable, "pattern", "my_whois");
+    weechat_hashtable_set (hashtable, "timeout", "30");
+    weechat_hashtable_set (hashtable, "cmd_start", "311:1");
+    weechat_hashtable_set (hashtable, "cmd_stop", "318:1,401:1,402:1,431:1,461");
+    weechat_hashtable_set (hashtable, "cmd_extra", "318:1");
+    weechat_hook_hsignal_send ("irc_redirect_pattern", hashtable);
+    /*
+     * rediriger maintenant la commande irc whois avec le hsignal irc_redirect_command,
+     * en utilisant le modèle "my_whois"
+     */
+    /* ... */
+    weechat_hashtable_free (hashtable);
+}
+----------------------------------------
+
+Script (Python) :
+
+[source,python]
+----------------------------------------
+weechat.hook_hsignal_send("irc_redirect_pattern",
+                          { "pattern": "my_whois", "timeout": "30",
+                            "cmd_start": "311:1",
+                            "cmd_stop": "318:1,401:1,402:1,431:1,461",
+                            "cmd_extra": "318:1" })
+# rediriger maintenant la commande irc whois avec le hsignal irc_redirect_command,
+# en utilisant le modèle "my_whois"
+# ...
+----------------------------------------
+
 weechat_hook_config
 ^^^^^^^^^^^^^^^^^^^
 
diff --git a/doc/it/CMakeLists.txt b/doc/it/CMakeLists.txt
index a19d6e1b6..1ba1eb85a 100644
--- a/doc/it/CMakeLists.txt
+++ b/doc/it/CMakeLists.txt
@@ -32,7 +32,7 @@ INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_user.it.html DESTINATION ${SHA
 # plugin API reference
 ADD_CUSTOM_COMMAND(
   OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_plugin_api.it.html
-  COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=3 -a toc-title='Indice' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_plugin_api.it.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_plugin_api.it.txt
+  COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=4 -a toc-title='Indice' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_plugin_api.it.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_plugin_api.it.txt
   DEPENDS
   ${CMAKE_CURRENT_SOURCE_DIR}/weechat_plugin_api.it.txt
   ${CMAKE_CURRENT_SOURCE_DIR}/autogen/plugin_api/*.txt
diff --git a/doc/it/Makefile.am b/doc/it/Makefile.am
index c8d7ef3ad..0db3eaed5 100644
--- a/doc/it/Makefile.am
+++ b/doc/it/Makefile.am
@@ -42,7 +42,7 @@ weechat_user.it.html: weechat_user.it.txt $(wildcard autogen/user/*.txt)
 
 # plugin API reference
 weechat_plugin_api.it.html: weechat_plugin_api.it.txt $(wildcard autogen/plugin_api/*.txt)
-	$(ASCIIDOC) -a toc -a toclevels=3 -a toc-title='Indice' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_plugin_api.it.html weechat_plugin_api.it.txt
+	$(ASCIIDOC) -a toc -a toclevels=4 -a toc-title='Indice' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_plugin_api.it.html weechat_plugin_api.it.txt
 
 # scripting guide
 weechat_scripting.it.html: weechat_scripting.it.txt
diff --git a/doc/it/weechat_plugin_api.it.txt b/doc/it/weechat_plugin_api.it.txt
index 414b8fffd..07e631548 100644
--- a/doc/it/weechat_plugin_api.it.txt
+++ b/doc/it/weechat_plugin_api.it.txt
@@ -6827,6 +6827,158 @@ weechat.hook_signal_send(signal, type_data, signal_data)
 weechat.hook_signal_send("my_signal", weechat.WEECHAT_HOOK_SIGNAL_STRING, my_string)
 ----------------------------------------
 
+// TRANSLATION MISSING
+[[signal_logger_backlog]]
+Signal logger_backlog
++++++++++++++++++++++
+
+The signal "logger_backlog" can be sent to display backlog (chat history) in
+buffer (for example if you open your own buffer in your plugin/script).
+
+Argument is a pointer to buffer.
+
+C example:
+
+[source,C]
+----------------------------------------
+weechat_hook_signal_send ("logger_backlog", WEECHAT_HOOK_SIGNAL_POINTER, buffer);
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+weechat.hook_signal_send("logger_backlog", weechat.WEECHAT_HOOK_SIGNAL_POINTER, buffer)
+----------------------------------------
+
+// TRANSLATION MISSING
+[[signals_xxx_script_install]]
+Signals xxx_script_install
+++++++++++++++++++++++++++
+
+Five signals can be sent to install a script, according to language:
+
+* 'perl_script_install'
+* 'python_script_install'
+* 'ruby_script_install'
+* 'lua_script_install'
+* 'tcl_script_install'
+
+The callback will do following actions when receiving signal:
+
+. unload and remove installed script
+. move new script to directory '~/.weechat/xxx/' (where 'xxx' is language) 
+. create link to new script in directory '~/.weechat/xxx/autoload/'
+. load new script
+
+These signals are used by script 'weeget.py' to install scripts.
+
+Argument is a string with path to script to install.
+
+C example:
+
+[source,C]
+----------------------------------------
+weechat_hook_signal_send ("python_script_install", WEECHAT_HOOK_SIGNAL_STRING,
+                          "/home/xxx/.weechat/test.py");
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+weechat.hook_signal_send("python_script_install", WEECHAT_HOOK_SIGNAL_STRING,
+                         "/home/xxx/.weechat/test.py")
+----------------------------------------
+
+// TRANSLATION MISSING
+[[signals_xxx_script_remove]]
+Signals xxx_script_remove
++++++++++++++++++++++++++
+
+Five signals can be sent to remove list of scripts, according to language:
+
+* 'perl_script_remove'
+* 'python_script_remove'
+* 'ruby_script_remove'
+* 'lua_script_remove'
+* 'tcl_script_remove'
+
+For each script in list, the callback will unload then remove script.
+
+These signals are used by script 'weeget.py' to remove scripts.
+
+Argument is a string with comma-separated list of script to remove (script
+is name without path, for example 'script.py').
+
+C example:
+
+[source,C]
+----------------------------------------
+/* unload and remove scripts test.py and script.py */
+weechat_hook_signal_send ("python_script_remove", WEECHAT_HOOK_SIGNAL_STRING,
+                          "test.py,script.py");
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# unload and remove scripts test.py and script.py
+weechat.hook_signal_send("python_script_remove", WEECHAT_HOOK_SIGNAL_STRING,
+                         "test.py,script.py")
+----------------------------------------
+
+// TRANSLATION MISSING
+[[signal_irc_input_send]]
+Signal irc_input_send
++++++++++++++++++++++
+
+_New in version 0.3.4._
+
+The signal "irc_input_send" can be sent to simulate input in an irc buffer
+(server, channel or private).
+
+Argument is a string with following format:
+
+* internal server name (required)
+* semicolon
+* channel name (optional)
+* semicolon
+* flags used when sending message (optional, default is 1):
+** '1': queue with high priority (like user messages)
+** '2': queue with low priority (like messages automatically sent by WeeChat)
+* semicolon
+* comma-separated list of tags used when sending message (optional)
+* semicolon
+* text or command (required)
+
+C examples:
+
+[source,C]
+----------------------------------------
+/* say "Hello!" on freenode server, #weechat channel */
+weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING,
+                          "freenode;#weechat;1;;Hello!");
+
+/* send command "/whois FlashCode" on freenode server, with low priority */
+weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING,
+                          "freenode;;2;;/whois FlashCode");
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+# say "Hello!" on freenode server, #weechat channel
+weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
+                         "freenode;#weechat;1;;Hello!")
+
+# send command "/whois FlashCode" on freenode server, with low priority
+weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
+                         "freenode;;2;;/whois FlashCode")
+----------------------------------------
+
 weechat_hook_hsignal
 ^^^^^^^^^^^^^^^^^^^^
 
@@ -6855,7 +7007,7 @@ Argomenti:
 | Plugin | Segnale | Argomenti
 
 | irc | irc_redirection_xxx_yyy ^(1)^ |
-  redirection output
+  redirection output (consultare <<hsignal_irc_redirect_command>>)
 |========================================
 
 [NOTE]
@@ -6949,6 +7101,171 @@ weechat.hook_hsignal_send(signal, hashtable)
 weechat.hook_hsignal_send("my_hsignal", { "key": "value" })
 ----------------------------------------
 
+// TRANSLATION MISSING
+[[hsignal_irc_redirect_command]]
+Hsignal irc_redirect_command
+++++++++++++++++++++++++++++
+
+_New in version 0.3.4._
+
+The hsignal "irc_redirect_command" can be sent to redirect output of irc
+command to a callback.
+
+Argument is a hashtable with following entries (keys and values are string):
+
+* 'server': internal server name (required)
+* 'pattern': redirect pattern to use (required), either a default one (defined
+  by irc plugin), or a user pattern (see <<hsignal_irc_redirect_pattern>>),
+  default patterns are:
+** 'ison'
+** 'list'
+** 'mode_channel'
+** 'mode_channel_ban' ("mode #channel b")
+** 'mode_channel_ban_exception' ("mode #channel e")
+** 'mode_channel_invite' ("mode #channel I")
+** 'mode_user'
+** 'names'
+** 'ping'
+** 'time'
+** 'topic'
+** 'userhost'
+** 'who'
+** 'whois'
+** 'whowas'
+* 'signal': signal name (required)
+* 'count': number of times redirection will work (optional, 1 by default)
+* 'string': string that must be in irc messages received (optional, but
+  recommended, if a string can be used to identify messages)
+* 'timeout': timeout for redirect, in seconds (optional, 60 by default)
+* 'cmd_filter': comma-separated list of irc commands to filter (only these
+  commands will be sent to callbacks, other will be ignored) (optional)
+
+Immediately after sending this hsignal, you must send command to irc server,
+and redirection will be used for this command.
+
+C example:
+
+[source,C]
+----------------------------------------
+int
+test_whois_cb (void *data, const char *signal, struct t_hashtable *hashtable)
+{
+    weechat_printf (NULL, "error = %s", weechat_hashtable_get (hashtable, "error"));
+    weechat_printf (NULL, "output = %s", weechat_hashtable_get (hashtable, "output"));
+    return WEECHAT_RC_OK;
+}
+
+weechat_hook_hsignal ("irc_redirection_test_whois", &test_whois_cb, NULL);
+struct t_hashtable *hashtable = weechat_hashtable_new (8,
+                                                       WEECHAT_HASHTABLE_STRING,
+                                                       WEECHAT_HASHTABLE_INTEGER,
+                                                       NULL,
+                                                       NULL);
+if (hashtable)
+{
+    weechat_hashtable_set (hashtable, "server", "freenode");
+    weechat_hashtable_set (hashtable, "pattern", "whois");
+    weechat_hashtable_set (hashtable, "signal", "test");
+    weechat_hashtable_set (hashtable, "string", "FlashCode");
+    weechat_hook_hsignal_send ("irc_redirect_command", hashtable);
+    weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING,
+                              "freenode;;2;;/whois FlashCode");
+    weechat_hashtable_free (hashtable);
+}
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+def test_whois_cb(data, signal, hashtable):
+    weechat.prnt("", "error = %s" % hashtable["error"])
+    weechat.prnt("", "output = %s" % hashtable["output"])
+    return weechat.WEECHAT_RC_OK
+}
+
+weechat.hook_hsignal ("irc_redirection_test_whois", "test_whois_cb", "")
+weechat.hook_hsignal_send("irc_redirect_command",
+                          { "server": "freenode", "pattern": "whois", "signal": "test",
+                            "string": "FlashCode" })
+weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
+                         "freenode;;2;;/whois FlashCode")
+----------------------------------------
+
+// TRANSLATION MISSING
+[[hsignal_irc_redirect_pattern]]
+Hsignal irc_redirect_pattern
+++++++++++++++++++++++++++++
+
+_New in version 0.3.4._
+
+The hsignal "irc_redirect_pattern" can be sent to create a pattern for irc
+redirect (see <<hsignal_irc_redirect_command>>).
+
+Argument is a hashtable with following entries (keys and values are string):
+
+* 'pattern': name of pattern (required)
+* 'timeout': default timeout for pattern in, seconds (optional, 60 by default)
+* 'cmd_start': comma-separated list of commands starting redirect (optional)
+* 'cmd_stop': comma-separated list of commands stopping redirect (required)
+* 'cmd_extra': comma-separated list of commands that may be received
+  after stop commands (optional)
+
+For each command in 'cmd_start', 'cmd_stop' and 'cmd_extra', it is possible to
+give integer with position of "string" that must be found in received message,
+for example:
+
+----------------------------------------
+352:1,354,401:1
+----------------------------------------
+
+For commands 352 and 401, "string" must be found in received message,
+as first argument.
+
+[IMPORTANT]
+The pattern is destroyed when it is used by a redirection. If you need pattern
+for many redirections, you must create pattern before each redirect.
+
+C example:
+
+[source,C]
+----------------------------------------
+struct t_hashtable *hashtable = weechat_hashtable_new (8,
+                                                       WEECHAT_HASHTABLE_STRING,
+                                                       WEECHAT_HASHTABLE_INTEGER,
+                                                       NULL,
+                                                       NULL);
+if (hashtable)
+{
+    weechat_hashtable_set (hashtable, "pattern", "my_whois");
+    weechat_hashtable_set (hashtable, "timeout", "30");
+    weechat_hashtable_set (hashtable, "cmd_start", "311:1");
+    weechat_hashtable_set (hashtable, "cmd_stop", "318:1,401:1,402:1,431:1,461");
+    weechat_hashtable_set (hashtable, "cmd_extra", "318:1");
+    weechat_hook_hsignal_send ("irc_redirect_pattern", hashtable);
+    /*
+     * now redirect irc whois command with hsignal irc_redirect_command,
+     * using pattern "my_whois"
+     */
+    /* ... */
+    weechat_hashtable_free (hashtable);
+}
+----------------------------------------
+
+Script (Python):
+
+[source,python]
+----------------------------------------
+weechat.hook_hsignal_send("irc_redirect_pattern",
+                          { "pattern": "my_whois", "timeout": "30",
+                            "cmd_start": "311:1",
+                            "cmd_stop": "318:1,401:1,402:1,431:1,461",
+                            "cmd_extra": "318:1" })
+# now redirect irc whois command with hsignal irc_redirect_command
+# using pattern "my_whois"
+# ...
+----------------------------------------
+
 weechat_hook_config
 ^^^^^^^^^^^^^^^^^^^