doc: add question about terminal focus in FAQ

6 files changed, 149 insertions, 0 deletions

diff --git a/doc/de/weechat_faq.de.txt b/doc/de/weechat_faq.de.txt
index 5ae5d612d..7df01525a 100644
--- a/doc/de/weechat_faq.de.txt
+++ b/doc/de/weechat_faq.de.txt
@@ -339,6 +339,31 @@ und um zu Highlight-Nachrichten zu springen: key[alt-p] / key[alt-n].
 
 Siehe Benutzeranleitung für weitere Informationen zu dieser Funktion (Standardtastenbelegung).
 
+// TRANSLATION MISSING
+[[terminal_focus]]
+=== How can I execute commands when terminal gets/loses focus?
+
+You must enable the focus events with a special code sent to terminal.
+
+*Important*:
+
+* Currently, *only* 'xterm' seems to support this feature.
+* It does *not* work under screen/tmux.
+
+To send the code when WeeChat is starting:
+
+----
+/set weechat.startup.command_after_plugins "/print -stdout \033[?1004h\n"
+----
+
+And then you bind two keys for the focus (replace the `/print` commands by the
+commands of your choice):
+
+----
+/key bind meta2-I /print -core focus
+/key bind meta2-O /print -core unfocus
+----
+
 [[key_bindings]]
 == Tastaturbelegung
 
diff --git a/doc/en/weechat_faq.en.txt b/doc/en/weechat_faq.en.txt
index a12f4019c..a15062bc2 100644
--- a/doc/en/weechat_faq.en.txt
+++ b/doc/en/weechat_faq.en.txt
@@ -319,6 +319,30 @@ And jump to highlights: key[alt-p] / key[alt-n].
 
 See user's guide for more info about this feature (default key bindings).
 
+[[terminal_focus]]
+=== How can I execute commands when terminal gets/loses focus?
+
+You must enable the focus events with a special code sent to terminal.
+
+*Important*:
+
+* Currently, *only* 'xterm' seems to support this feature.
+* It does *not* work under screen/tmux.
+
+To send the code when WeeChat is starting:
+
+----
+/set weechat.startup.command_after_plugins "/print -stdout \033[?1004h\n"
+----
+
+And then you bind two keys for the focus (replace the `/print` commands by the
+commands of your choice):
+
+----
+/key bind meta2-I /print -core focus
+/key bind meta2-O /print -core unfocus
+----
+
 [[key_bindings]]
 == Key bindings
 
diff --git a/doc/fr/weechat_faq.fr.txt b/doc/fr/weechat_faq.fr.txt
index 67c843515..6bd8cf590 100644
--- a/doc/fr/weechat_faq.fr.txt
+++ b/doc/fr/weechat_faq.fr.txt
@@ -335,6 +335,31 @@ Et sauter aux highlights : key[alt-p] / key[alt-n].
 Voir le guide utilisateur pour plus d'information sur cette fonctionnalité
 (raccourcis clavier par défaut).
 
+[[terminal_focus]]
+=== Comment puis-je exécuter des commandes lorsque le terminal obtient/perd le focus ?
+
+Vous devez activer les évènements du focus avec un code spécial envoyé au
+terminal.
+
+*Important* :
+
+* Actuellement, *seulement* 'xterm' semble supporter cette fonctionnalité.
+* Cela ne fonctionne *pas* sous screen/tmux.
+
+Pour envoyer le code au démarrage de WeeChat :
+
+----
+/set weechat.startup.command_after_plugins "/print -stdout \033[?1004h\n"
+----
+
+Puis associez deux touches pour le focus (remplacez les commandes `/print` par
+les commandes de votre choix):
+
+----
+/key bind meta2-I /print -core focus
+/key bind meta2-O /print -core unfocus
+----
+
 [[key_bindings]]
 == Raccourcis clavier
 
diff --git a/doc/it/weechat_faq.it.txt b/doc/it/weechat_faq.it.txt
index 532981c3d..8a77f62fb 100644
--- a/doc/it/weechat_faq.it.txt
+++ b/doc/it/weechat_faq.it.txt
@@ -334,6 +334,31 @@ E per passare alle notifiche: key[alt-p] / key[alt-n].
 Consultare la guida per l'utente per maggiori informazioni su questa funzione
 (combinazioni tasti predefiniti).
 
+// TRANSLATION MISSING
+[[terminal_focus]]
+=== How can I execute commands when terminal gets/loses focus?
+
+You must enable the focus events with a special code sent to terminal.
+
+*Important*:
+
+* Currently, *only* 'xterm' seems to support this feature.
+* It does *not* work under screen/tmux.
+
+To send the code when WeeChat is starting:
+
+----
+/set weechat.startup.command_after_plugins "/print -stdout \033[?1004h\n"
+----
+
+And then you bind two keys for the focus (replace the `/print` commands by the
+commands of your choice):
+
+----
+/key bind meta2-I /print -core focus
+/key bind meta2-O /print -core unfocus
+----
+
 [[key_bindings]]
 == Associazioni dei tasti
 
diff --git a/doc/ja/weechat_faq.ja.txt b/doc/ja/weechat_faq.ja.txt
index 4242ca2e4..9bdc50b57 100644
--- a/doc/ja/weechat_faq.ja.txt
+++ b/doc/ja/weechat_faq.ja.txt
@@ -323,6 +323,31 @@ term screen-256color
 
 この機能に関するより詳しい情報はユーザーガイドを参照してください (デフォルトのキー割り当て)。
 
+// TRANSLATION MISSING
+[[terminal_focus]]
+=== How can I execute commands when terminal gets/loses focus?
+
+You must enable the focus events with a special code sent to terminal.
+
+*Important*:
+
+* Currently, *only* 'xterm' seems to support this feature.
+* It does *not* work under screen/tmux.
+
+To send the code when WeeChat is starting:
+
+----
+/set weechat.startup.command_after_plugins "/print -stdout \033[?1004h\n"
+----
+
+And then you bind two keys for the focus (replace the `/print` commands by the
+commands of your choice):
+
+----
+/key bind meta2-I /print -core focus
+/key bind meta2-O /print -core unfocus
+----
+
 [[key_bindings]]
 == キー割り当て
 
diff --git a/doc/pl/weechat_faq.pl.txt b/doc/pl/weechat_faq.pl.txt
index d854ee149..ceb9ca34d 100644
--- a/doc/pl/weechat_faq.pl.txt
+++ b/doc/pl/weechat_faq.pl.txt
@@ -323,6 +323,31 @@ Poruszanie się między podświetleniami: key[alt-p] / key[alt-n].
 
 Po więcej informacji zajrzyj do poradnika użytkownika (domyślne skróty klawiszowe).
 
+// TRANSLATION MISSING
+[[terminal_focus]]
+=== How can I execute commands when terminal gets/loses focus?
+
+You must enable the focus events with a special code sent to terminal.
+
+*Important*:
+
+* Currently, *only* 'xterm' seems to support this feature.
+* It does *not* work under screen/tmux.
+
+To send the code when WeeChat is starting:
+
+----
+/set weechat.startup.command_after_plugins "/print -stdout \033[?1004h\n"
+----
+
+And then you bind two keys for the focus (replace the `/print` commands by the
+commands of your choice):
+
+----
+/key bind meta2-I /print -core focus
+/key bind meta2-O /print -core unfocus
+----
+
 [[key_bindings]]
 == Przypisania klawiszy