doc: add "beep" trigger in question about highlights (FAQ)

6 files changed, 85 insertions, 6 deletions

diff --git a/doc/de/weechat_faq.de.asciidoc b/doc/de/weechat_faq.de.asciidoc
index 99699c574..fbf201d5a 100644
--- a/doc/de/weechat_faq.de.asciidoc
+++ b/doc/de/weechat_faq.de.asciidoc
@@ -701,7 +701,21 @@ Für Weechat ≤ 0.3.3, lauten die Optionen 'irc.network.away_check' und
 [[highlight_notification]]
 === Wie kann ich mich darüber informieren lassen falls mich jemand in einem Channel highlighted
 
-Dazu kann man ein Skript nutzen wie z.B. 'beep.pl' oder 'launcher.pl'.
+// TRANSLATION MISSING
+With WeeChat ≥ 1.0, there is a default trigger "beep" which sends a 'BEL' to
+the terminal on a highlight or private message. Thus you can configure your
+terminal (or multiplexer like screen/tmux) to run a command or play a sound
+when a 'BEL' occurs.
+
+// TRANSLATION MISSING
+Or you can add a command in "beep" trigger:
+
+----
+/set trigger.trigger.beep.command "/print -beep;/exec -bg /Pfad/zum/Befehl Argumente"
+----
+
+// TRANSLATION MISSING
+With an older WeeChat, you can use a script like 'beep.pl' or 'launcher.pl'.
 
 Beim Skript 'launcher.pl' müssen noch die Befehle angepasst werden:
 
diff --git a/doc/en/weechat_faq.en.asciidoc b/doc/en/weechat_faq.en.asciidoc
index c34a824fa..45a2c48e3 100644
--- a/doc/en/weechat_faq.en.asciidoc
+++ b/doc/en/weechat_faq.en.asciidoc
@@ -663,7 +663,18 @@ For WeeChat ≤ 0.3.3, options are 'irc.network.away_check' and
 [[highlight_notification]]
 === How can I be warned when someone highlights me on a channel?
 
-You can use a script like 'beep.pl' or 'launcher.pl'.
+With WeeChat ≥ 1.0, there is a default trigger "beep" which sends a 'BEL' to
+the terminal on a highlight or private message. Thus you can configure your
+terminal (or multiplexer like screen/tmux) to run a command or play a sound
+when a 'BEL' occurs.
+
+Or you can add a command in "beep" trigger:
+
+----
+/set trigger.trigger.beep.command "/print -beep;/exec -bg /path/to/command arguments"
+----
+
+With an older WeeChat, you can use a script like 'beep.pl' or 'launcher.pl'.
 
 For 'launcher.pl', you have to setup command:
 
diff --git a/doc/fr/weechat_faq.fr.asciidoc b/doc/fr/weechat_faq.fr.asciidoc
index 24584ff8f..897be9288 100644
--- a/doc/fr/weechat_faq.fr.asciidoc
+++ b/doc/fr/weechat_faq.fr.asciidoc
@@ -691,7 +691,19 @@ Pour WeeChat ≤ 0.3.3, les options sont 'irc.network.away_check' et
 [[highlight_notification]]
 === Comment être averti lorsque quelqu'un prononce mon pseudo sur un canal ?
 
-Vous pouvez utiliser un script comme 'beep.pl' ou 'launcher.pl'.
+Avec WeeChat ≥ 1.0, il y a un trigger "beep" qui envoie 'BEL' au terminal sur
+un highlight ou un message privé. Par conséquent vous pouvez configurer votre
+terminal (ou multiplexeur comme screen/tmux) pour lancer une commande ou jouer
+un son lorsque le 'BEL' se produit.
+
+Ou vous pouvez ajouter une commande dans le trigger "beep" :
+
+----
+/set trigger.trigger.beep.command "/print -beep;/exec -bg /chemin/vers/commande paramètres"
+----
+
+Avec un WeeChat plus ancien, vous pouvez utiliser un script comme 'beep.pl' or
+'launcher.pl'.
 
 Pour 'launcher.pl', vous devez configurer la commande :
 
diff --git a/doc/it/weechat_faq.it.asciidoc b/doc/it/weechat_faq.it.asciidoc
index 00b48382e..1cea14fbc 100644
--- a/doc/it/weechat_faq.it.asciidoc
+++ b/doc/it/weechat_faq.it.asciidoc
@@ -697,7 +697,21 @@ Per WeeChat ≤ 0.3.3, le opzioni sono 'irc.network.away_check' e
 [[highlight_notification]]
 === Come posso essere avvisato quando qualcuno mi cerca in un canale?
 
-È possibile usare script come 'beep.pl" o 'launcher.pl'.
+// TRANSLATION MISSING
+With WeeChat ≥ 1.0, there is a default trigger "beep" which sends a 'BEL' to
+the terminal on a highlight or private message. Thus you can configure your
+terminal (or multiplexer like screen/tmux) to run a command or play a sound
+when a 'BEL' occurs.
+
+// TRANSLATION MISSING
+Or you can add a command in "beep" trigger:
+
+----
+/set trigger.trigger.beep.command "/print -beep;/exec -bg /path/del/comando argomenti"
+----
+
+// TRANSLATION MISSING
+With an older WeeChat, you can use a script like 'beep.pl' or 'launcher.pl'.
 
 Per 'launcher.pl', bisogna impostare il comando:
 
diff --git a/doc/ja/weechat_faq.ja.asciidoc b/doc/ja/weechat_faq.ja.asciidoc
index 72f96b6e4..3a7694c57 100644
--- a/doc/ja/weechat_faq.ja.asciidoc
+++ b/doc/ja/weechat_faq.ja.asciidoc
@@ -661,7 +661,21 @@ WeeChat 0.3.3 以下では、オプション名が 'irc.network.away_check' と
 [[highlight_notification]]
 === どうすればあるチャンネルで自分が呼ばれたら警告できますか。
 
-'beep.pl' や 'launcher.pl' 等のスクリプトを使ってください。
+// TRANSLATION MISSING
+With WeeChat ≥ 1.0, there is a default trigger "beep" which sends a 'BEL' to
+the terminal on a highlight or private message. Thus you can configure your
+terminal (or multiplexer like screen/tmux) to run a command or play a sound
+when a 'BEL' occurs.
+
+// TRANSLATION MISSING
+Or you can add a command in "beep" trigger:
+
+----
+/set trigger.trigger.beep.command "/print -beep;/exec -bg /path/to/command arguments"
+----
+
+// TRANSLATION MISSING
+With an older WeeChat, you can use a script like 'beep.pl' or 'launcher.pl'.
 
 'launcher.pl' の場合、コマンドの設定が必要です:
 
diff --git a/doc/pl/weechat_faq.pl.asciidoc b/doc/pl/weechat_faq.pl.asciidoc
index 72a95376b..19e712e18 100644
--- a/doc/pl/weechat_faq.pl.asciidoc
+++ b/doc/pl/weechat_faq.pl.asciidoc
@@ -669,7 +669,21 @@ Dla WeeChat ≤ 0.3.3, opcje te to 'irc.network.away_check' oraz
 [[highlight_notification]]
 === Jak mogę zostać powiadomiony, jeśli ktoś będzie chciał przyciągnąć moją uwagę na kanale?
 
-Możesz użyć skryptu jak 'beep.pl' lub 'launcher.pl'.
+// TRANSLATION MISSING
+With WeeChat ≥ 1.0, there is a default trigger "beep" which sends a 'BEL' to
+the terminal on a highlight or private message. Thus you can configure your
+terminal (or multiplexer like screen/tmux) to run a command or play a sound
+when a 'BEL' occurs.
+
+// TRANSLATION MISSING
+Or you can add a command in "beep" trigger:
+
+----
+/set trigger.trigger.beep.command "/print -beep;/exec -bg /ścieżka/do/komendy argumenty"
+----
+
+// TRANSLATION MISSING
+With an older WeeChat, you can use a script like 'beep.pl' or 'launcher.pl'.
 
 Dla 'launcher.pl', należ przeprowadzić konfigurację: