Add questions in FAQ about voice filtering and check of away nicks

5 files changed, 271 insertions, 75 deletions

diff --git a/doc/de/weechat_faq.de.txt b/doc/de/weechat_faq.de.txt
index 5055c888c..c1ad71f54 100644
--- a/doc/de/weechat_faq.de.txt
+++ b/doc/de/weechat_faq.de.txt
@@ -263,6 +263,26 @@ IRC
 ---
 
 
+[[ignore_vs_filter]]
+Was ist der Unterschied zwischen dem Befehl /ignore und /filter?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Der Befehl `/ignore` ist ein IRC-Befehl und beeinflusst somit nur die IRC-Buffer
+(Server und Channel).
+Durch den Befehl kann man bestimmte Nicks oder Hostnamen von Usern eines Servers oder
+von Channels ignorieren (Der Befehl wird nicht auf den Inhalt der Meldung angewandt).
+Zutreffende Meldungen werden, bevor sie Angezeigt werden, von der IRC-Erweiterung gelöscht
+(Du wirst sie niemals zu Gesicht bekommen).
+
+Der Befehl `/filter` ist ein Kern-Befehl (A.d.Ü.: wird in WeeChat ausgeführt und
+nicht an den Server gesendet) und beeinflußt somit jeden Buffer.
+Dieser Befehl eröffnet die Möglichkeit bestimmte Zeilen in Buffern, mittels Tags und
+regulären Ausdrücken nach Präfix und Zeileninhalt zu filtern.
+Die Darstellung von gefilterte Zeilen wird nur unterdrückt, die Zeilen werden nicht gelöscht.
+Du kannst diese Zeilen sichtbar machen indem Du den Filter deaktivierst (Voreinstellung zum
+Aktivieren/Deaktivieren der Filter: Alt-Taste + "=").
+
+
 [[filter_irc_join_part_quit]]
 Wie kann ich join/part/quit Meldungen in den IRC Channels filtern (A.d.ü.: unterdrücken)?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -287,24 +307,43 @@ Entsprechend der WeeChat-Version:
    (Hilfe mit: `/help filter`)
 
 
-[[ignore_vs_filter]]
-Was ist der Unterschied zwischen dem Befehl /ignore und /filter?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+[[filter_voice_messages]]
+How can I filter voice messages (eg on Bitlbee server)?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Der Befehl `/ignore` ist ein IRC-Befehl und beeinflusst somit nur die IRC-Buffer
-(Server und Channel).
-Durch den Befehl kann man bestimmte Nicks oder Hostnamen von Usern eines Servers oder
-von Channels ignorieren (Der Befehl wird nicht auf den Inhalt der Meldung angewandt).
-Zutreffende Meldungen werden, bevor sie Angezeigt werden, von der IRC-Erweiterung gelöscht
-(Du wirst sie niemals zu Gesicht bekommen).
+It's not easy to filter voice messages, because voice mode can be set with other
+modes in same IRC message.
 
-Der Befehl `/filter` ist ein Kern-Befehl (A.d.Ü.: wird in WeeChat ausgeführt und
-nicht an den Server gesendet) und beeinflußt somit jeden Buffer.
-Dieser Befehl eröffnet die Möglichkeit bestimmte Zeilen in Buffern, mittels Tags und
-regulären Ausdrücken nach Präfix und Zeileninhalt zu filtern.
-Die Darstellung von gefilterte Zeilen wird nur unterdrückt, die Zeilen werden nicht gelöscht.
-Du kannst diese Zeilen sichtbar machen indem Du den Filter deaktivierst (Voreinstellung zum
-Aktivieren/Deaktivieren der Filter: Alt-Taste + "=").
+If you want to do that, it's probably because Bitlbee is using voice to show
+away users, and you are flooded with voice messages. Therefore, you can change
+that and let WeeChat use a special color for away nicks in nicklist.
+
+On channel '&bitlbee', do:
+----------------------------------------
+set away_devoice false
+----------------------------------------
+
+For checking away nicks in WeeChat, see question about
+<<color_away_nicks,away nicks>>.
+
+
+[[color_away_nicks]]
+How can I see away nicks in nicklist?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You have to set option 'irc.network.away_check' to a positive value (minutes
+between each check of away nicks).
+
+You can set option 'irc.network.away_check_max_nicks' to limit away check on
+small channels only.
+
+For example, check every 5 minutes for away nicks, for channels with max 25
+nicks:
+
+----------------------------------------
+/set irc.network.away_check 5
+/set irc.network.away_check_max_nicks 25
+----------------------------------------
 
 
 [[highlight_notification]]
diff --git a/doc/en/weechat_faq.en.txt b/doc/en/weechat_faq.en.txt
index b242c704a..e4f187a71 100644
--- a/doc/en/weechat_faq.en.txt
+++ b/doc/en/weechat_faq.en.txt
@@ -247,6 +247,24 @@ IRC
 ---
 
 
+[[ignore_vs_filter]]
+What is the difference between the /ignore and /filter commands?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The `/ignore` command is an IRC command, so it applies only for IRC buffers
+(servers and channels).
+It lets you ignore some nicks or hostnames of users for a server or channel
+(command will not apply on content of messages).
+Matching messages are deleted by IRC plugin before display (so you'll
+never see them).
+
+The `/filter` command is a core command, so it applies to any buffer.
+It lets you filter some lines in buffers with tags or regular expression for
+prefix and content of line.
+Filtered lines are only hidden, not deleted, and you can see them if you
+disable filters (by default, the key alt + "=" toggles filters).
+
+
 [[filter_irc_join_part_quit]]
 How can I filter join/part/quit messages on IRC channels?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -271,22 +289,43 @@ According to WeeChat version:
    (`/help filter` for help)
 
 
-[[ignore_vs_filter]]
-What is the difference between the /ignore and /filter commands?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+[[filter_voice_messages]]
+How can I filter voice messages (eg on Bitlbee server)?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The `/ignore` command is an IRC command, so it applies only for IRC buffers
-(servers and channels).
-It lets you ignore some nicks or hostnames of users for a server or channel
-(command will not apply on content of messages).
-Matching messages are deleted by IRC plugin before display (so you'll
-never see them).
+It's not easy to filter voice messages, because voice mode can be set with other
+modes in same IRC message.
 
-The `/filter` command is a core command, so it applies to any buffer.
-It lets you filter some lines in buffers with tags or regular expression for
-prefix and content of line.
-Filtered lines are only hidden, not deleted, and you can see them if you
-disable filters (by default, the key alt + "=" toggles filters).
+If you want to do that, it's probably because Bitlbee is using voice to show
+away users, and you are flooded with voice messages. Therefore, you can change
+that and let WeeChat use a special color for away nicks in nicklist.
+
+On channel '&bitlbee', do:
+----------------------------------------
+set away_devoice false
+----------------------------------------
+
+For checking away nicks in WeeChat, see question about
+<<color_away_nicks,away nicks>>.
+
+
+[[color_away_nicks]]
+How can I see away nicks in nicklist?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You have to set option 'irc.network.away_check' to a positive value (minutes
+between each check of away nicks).
+
+You can set option 'irc.network.away_check_max_nicks' to limit away check on
+small channels only.
+
+For example, check every 5 minutes for away nicks, for channels with max 25
+nicks:
+
+----------------------------------------
+/set irc.network.away_check 5
+/set irc.network.away_check_max_nicks 25
+----------------------------------------
 
 
 [[highlight_notification]]
diff --git a/doc/fr/weechat_faq.fr.txt b/doc/fr/weechat_faq.fr.txt
index 481a2f3c5..2f0182c07 100644
--- a/doc/fr/weechat_faq.fr.txt
+++ b/doc/fr/weechat_faq.fr.txt
@@ -257,6 +257,26 @@ IRC
 ---
 
 
+[[ignore_vs_filter]]
+Quelle est la différence entre les commandes /ignore et /filter ?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+La commande `/ignore` est une commande IRC, donc elle s'applique uniquement aux
+tampons IRC (serveurs et canaux).
+Elle permet d'ignorer des pseudos ou nom d'hôtes pour un serveur ou un canal
+(la commande ne s'applique pas au contenu des messages).
+Les messages corespondants sont supprimés par l'extension IRC avant affichage
+(donc vous ne les verrez jamais).
+
+La commande `/filter` est une commande "core", donc elle s'applique à n"importe
+quel tampon.
+Elle permet de filtrer des lignes dans les tampons à l'aide de tags ou
+d'expression régulière pour le préfixe et contenu de la ligne.
+Les lignes filtrées sont simplement cachées, pas supprimées, et il est possible
+de les voir en désactivant les filtres (par défaut, la touche alt + "="
+active/désactive les filtres).
+
+
 [[filter_irc_join_part_quit]]
 Comment puis-je filter les messages join/part/quit sur les canaux IRC ?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -282,24 +302,44 @@ Selon la version de WeeChat :
    (`/help filter` pour l'aide)
 
 
-[[ignore_vs_filter]]
-Quelle est la différence entre les commandes /ignore et /filter ?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+[[filter_voice_messages]]
+Comment puis-je filtrer les messages voice (par exemple sur le serveur Bitlbee) ?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-La commande `/ignore` est une commande IRC, donc elle s'applique uniquement aux
-tampons IRC (serveurs et canaux).
-Elle permet d'ignorer des pseudos ou nom d'hôtes pour un serveur ou un canal
-(la commande ne s'applique pas au contenu des messages).
-Les messages corespondants sont supprimés par l'extension IRC avant affichage
-(donc vous ne les verrez jamais).
+Il n'est pas facile de filtrer les messages voice, car le mode voice peut être
+positionné avec d'autres modes dans le même message IRC.
 
-La commande `/filter` est une commande "core", donc elle s'applique à n"importe
-quel tampon.
-Elle permet de filtrer des lignes dans les tampons à l'aide de tags ou
-d'expression régulière pour le préfixe et contenu de la ligne.
-Les lignes filtrées sont simplement cachées, pas supprimées, et il est possible
-de les voir en désactivant les filtres (par défaut, la touche alt + "="
-active/désactive les filtres).
+Si vous souhaitez faire cela, c'est probablement parce que Bitlbee utilise le
+voice pour montrer les utilisateurs absents, et vous recevez plein de messages
+voice. Par conséquent, vous pouvez changer cela et laisser WeeChat utiliser une
+couleur spéciale pour les pseudos absents dans la liste des pseudos.
+
+Sur le canal '&bitlbee', faites :
+----------------------------------------
+set away_devoice false
+----------------------------------------
+
+Pour vérifier les pseudos absents dans WeeChat, voir la question à propos des
+<<color_away_nicks,pseudos absents>>.
+
+
+[[color_away_nicks]]
+Comment puis-je voir les pseudos absents dans la liste des pseudos ?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Vous devez positionner l'option 'irc.network.away_check' avec une valeur
+positive (minutes entre chaque vérification des pseudos absents).
+
+Vous pouvez aussi positionner l'option 'irc.network.away_check_max_nicks' pour
+limiter la vérification d'absence sur les petits canaux seulement.
+
+Par exemple, pour vérifier les pseudos absents toutes les 5 minutes, pour les
+canaux avec maximum 25 pseudos :
+
+----------------------------------------
+/set irc.network.away_check 5
+/set irc.network.away_check_max_nicks 25
+----------------------------------------
 
 
 [[highlight_notification]]
diff --git a/doc/it/weechat_faq.it.txt b/doc/it/weechat_faq.it.txt
index 9301db377..f19d47d9f 100644
--- a/doc/it/weechat_faq.it.txt
+++ b/doc/it/weechat_faq.it.txt
@@ -252,6 +252,25 @@ IRC
 ---
 
 
+[[ignore_vs_filter]]
+Qual è la differenza tra i comandi /ignore e /filter?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Il comando `/ignore` è un comando IRC, per cui è utile solo per i buffer
+IRC (server e canali).
+Consente di ignorare alcuni nick o nomi host di utenti per un server o per
+un canale (il comando non viene applicato sul contenuto dei messaggi).
+I messaggi corrispondenti vengono eliminati dal plugin IRC prima di
+essere visualizzati (perciò non verranno mai mostrati).
+
+Il comando `/filter` è un comando core, perciò funziona per qualsiasi
+buffer. Esso consente di filtrare alcune righe nei buffer mediante tag
+o espressioni regolari per il prefisso ed il contenuto delle righe.
+Le righe filtrate vengono solo nascoste, non eliminate, ed è possibile
+visualizzarle se i filtri vengono disabilitati (il comando predefinito
+alt +  "=" abilita/disabilita i filtri).
+
+
 [[filter_irc_join_part_quit]]
 Come posso filtrare i messaggi di entrata/uscita/abbandono sui canali IRC?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -278,23 +297,43 @@ A seconda della versione di WeeChat:
    (`/help filter` per aiuto)
 
 
-[[ignore_vs_filter]]
-Qual è la differenza tra i comandi /ignore e /filter?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+[[filter_voice_messages]]
+How can I filter voice messages (eg on Bitlbee server)?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Il comando `/ignore` è un comando IRC, per cui è utile solo per i buffer
-IRC (server e canali).
-Consente di ignorare alcuni nick o nomi host di utenti per un server o per
-un canale (il comando non viene applicato sul contenuto dei messaggi).
-I messaggi corrispondenti vengono eliminati dal plugin IRC prima di
-essere visualizzati (perciò non verranno mai mostrati).
+It's not easy to filter voice messages, because voice mode can be set with other
+modes in same IRC message.
 
-Il comando `/filter` è un comando core, perciò funziona per qualsiasi
-buffer. Esso consente di filtrare alcune righe nei buffer mediante tag
-o espressioni regolari per il prefisso ed il contenuto delle righe.
-Le righe filtrate vengono solo nascoste, non eliminate, ed è possibile
-visualizzarle se i filtri vengono disabilitati (il comando predefinito
-alt +  "=" abilita/disabilita i filtri).
+If you want to do that, it's probably because Bitlbee is using voice to show
+away users, and you are flooded with voice messages. Therefore, you can change
+that and let WeeChat use a special color for away nicks in nicklist.
+
+On channel '&bitlbee', do:
+----------------------------------------
+set away_devoice false
+----------------------------------------
+
+For checking away nicks in WeeChat, see question about
+<<color_away_nicks,away nicks>>.
+
+
+[[color_away_nicks]]
+How can I see away nicks in nicklist?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You have to set option 'irc.network.away_check' to a positive value (minutes
+between each check of away nicks).
+
+You can set option 'irc.network.away_check_max_nicks' to limit away check on
+small channels only.
+
+For example, check every 5 minutes for away nicks, for channels with max 25
+nicks:
+
+----------------------------------------
+/set irc.network.away_check 5
+/set irc.network.away_check_max_nicks 25
+----------------------------------------
 
 
 [[highlight_notification]]
diff --git a/doc/pl/weechat_faq.pl.txt b/doc/pl/weechat_faq.pl.txt
index d7f3de529..5d33181c0 100644
--- a/doc/pl/weechat_faq.pl.txt
+++ b/doc/pl/weechat_faq.pl.txt
@@ -248,6 +248,24 @@ IRC
 ---
 
 
+[[ignore_vs_filter]]
+Jaka jest różnica między komendami/ignore i /filter ?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Komenda `/ignore` jest komendą IRC, zatem odnosi się tylko do buforów IRC
+(serwery i kanały).
+Pozwala ignorować niektóre nicki lub hosty użytkowników serwera lub kanału
+(komendy nie stotuje się do treści wiadomości).
+Pasujące wiadomości są usuwane przez wtyczkę IRC przed wyświetleniem (nigdy
+ich nie zobaczysz).
+
+Komenda `/filter` jest komenda rdzenia, zatem odnosi się do dowolnego bufora.
+Pozwala filtrować niektóre linie w buforach za pomocą tagów lub wyrażeń
+regularnych dla przedrostków i zawartości lini.
+Filtrowane linie są tylko ukrywane, nie usuwane, można je zobaczyć wyłączając
+filtry (domyślnie alt + "=" zmienia stan filtrów).
+
+
 [[filter_irc_join_part_quit]]
 Jak moge filtrować wiadomości o wejściu/opuszczeniu/wyjściu na kanałach IRC?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -272,22 +290,43 @@ W zależności od wersji WeeChat:
    (`/help filter` dla pomocy)
 
 
-[[ignore_vs_filter]]
-Jaka jest różnica między komendami/ignore i /filter ?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+[[filter_voice_messages]]
+How can I filter voice messages (eg on Bitlbee server)?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Komenda `/ignore` jest komendą IRC, zatem odnosi się tylko do buforów IRC
-(serwery i kanały).
-Pozwala ignorować niektóre nicki lub hosty użytkowników serwera lub kanału
-(komendy nie stotuje się do treści wiadomości).
-Pasujące wiadomości są usuwane przez wtyczkę IRC przed wyświetleniem (nigdy
-ich nie zobaczysz).
+It's not easy to filter voice messages, because voice mode can be set with other
+modes in same IRC message.
 
-Komenda `/filter` jest komenda rdzenia, zatem odnosi się do dowolnego bufora.
-Pozwala filtrować niektóre linie w buforach za pomocą tagów lub wyrażeń
-regularnych dla przedrostków i zawartości lini.
-Filtrowane linie są tylko ukrywane, nie usuwane, można je zobaczyć wyłączając
-filtry (domyślnie alt + "=" zmienia stan filtrów).
+If you want to do that, it's probably because Bitlbee is using voice to show
+away users, and you are flooded with voice messages. Therefore, you can change
+that and let WeeChat use a special color for away nicks in nicklist.
+
+On channel '&bitlbee', do:
+----------------------------------------
+set away_devoice false
+----------------------------------------
+
+For checking away nicks in WeeChat, see question about
+<<color_away_nicks,away nicks>>.
+
+
+[[color_away_nicks]]
+How can I see away nicks in nicklist?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You have to set option 'irc.network.away_check' to a positive value (minutes
+between each check of away nicks).
+
+You can set option 'irc.network.away_check_max_nicks' to limit away check on
+small channels only.
+
+For example, check every 5 minutes for away nicks, for channels with max 25
+nicks:
+
+----------------------------------------
+/set irc.network.away_check 5
+/set irc.network.away_check_max_nicks 25
+----------------------------------------
 
 
 [[highlight_notification]]