core: add an example with a more complex regex in /help filter

6 files changed, 135 insertions, 123 deletions

diff --git a/doc/de/autogen/user/weechat_commands.asciidoc b/doc/de/autogen/user/weechat_commands.asciidoc
index 8c2253605..10f3f1683 100644
--- a/doc/de/autogen/user/weechat_commands.asciidoc
+++ b/doc/de/autogen/user/weechat_commands.asciidoc
@@ -309,56 +309,58 @@ Beispiele (Bedingungen):
          rename <name> <new_name>
          del <name>|-all
 
-   list: alle Filter auflisten
- enable: Filter wird aktiviert (Filter werden standardmäßig aktiviert)
-disable: Filter deaktivieren
- toggle: Filter umschalten
-   name: Name des Filters ("@" = aktiviert/deaktiviert alle Filter im aktuellen Buffer)
-    add: Filter hinzufügen
- rename: benennt einen Filter um
-    del: Filter entfernen
-   -all: entfernt alle Filter
- buffer: durch Kommata getrennte Liste von Buffer in denen der Filter aktiv sein soll:
-         - ist der vollständige Name eines Buffer inklusive seiner Erweiterung (Beispiel: "irc.freenode.#weechat")
-         - "*" bedeutet, alle Buffer
-         - beginnt ein Name mit '!' wird für diesen Buffer kein Filter genutzt
-         - Platzhalter "*" kann verwendet werden
-   tags: durch Kommata getrennte Liste von Schlagwörtern. Zum Beispiel: "irc_join,irc_part,irc_quit"
-         - logisch "und": mittels "+" zwischen den Tags (zum Beispiel: "nick_toto+irc_action")
-         - Platzhalter "*" kann verwendet werden
-         - wird ein Tag mit '!' eingeleitet, dann muss dieser Tag NICHT in der Nachricht enthalten sein
-  regex: erweiterter regulärer POSIX Ausdruck, um in einer Zeile zu suchen
-         - das Präfix (z.B. Nick) wird mittels '\t' von der Nachricht getrennt. Sonderzeichen wie '|' müssen mit einer Escapesequenz : '\|' eingebunden werden)
-         - wird ein regulärer Ausdruck mit '!' eingeleitet dann wird das übereinstimmende Ergebnis umgekehrt (nutze '\!' um mit '!' zu beginnen)
-         - es werden zwei reguläre Ausdrücke erstellt: Der erste für den Präfix und der zweite für die eigentliche Nachricht
-         - reguläre Ausdrücke unterscheiden nicht zwischen Groß- und Kleinschreibung. Um zwischen Groß- und Kleinschreibung zu unterscheiden müssen diese mit "(?-i)" eingeleitet werden.
-
-Mit der Tastenvoreinstellung alt+'=' kann die Filterfunktion (de-)aktiviert werden.
-
-Die am häufigsten gebrauchten Schlagwörter lauten:
-  no_filter, no_highlight, no_log, log0..log9 (log Level),
+   list: list all filters
+ enable: enable filters (filters are enabled by default)
+disable: disable filters
+ toggle: toggle filters
+   name: filter name ("@" = enable/disable all filters in current buffer)
+    add: add a filter
+ rename: rename a filter
+    del: delete a filter
+   -all: delete all filters
+ buffer: comma separated list of buffers where filter is active:
+         - this is full name including plugin (example: "irc.freenode.#weechat" or "irc.server.freenode")
+         - "*" means all buffers
+         - a name starting with '!' is excluded
+         - wildcard "*" is allowed
+   tags: comma separated list of tags, for example "irc_join,irc_part,irc_quit"
+         - logical "and": use "+" between tags (for example: "nick_toto+irc_action")
+         - wildcard "*" is allowed
+         - if tag starts with '!', then it is excluded and must NOT be in message
+  regex: POSIX extended regular expression to search in line
+         - use '\t' to separate prefix from message, special chars like '|' must be escaped: '\|'
+         - if regex starts with '!', then matching result is reversed (use '\!' to start with '!')
+         - two regular expressions are created: one for prefix and one for message
+         - regex are case insensitive, they can start by "(?-i)" to become case sensitive
+
+The default key alt+'=' toggles filtering on/off.
+
+Tags most commonly used:
+  no_filter, no_highlight, no_log, log0..log9 (log level),
   notify_none, notify_message, notify_private, notify_highlight,
-  nick_xxx (xxx ist der Nickname), prefix_nick_ccc (ccc ist die Farbe mit der der Nick dargestellt wird),
-  host_xxx (xxx ist der Username + Host),
-  irc_xxx (xxx ist durch einen IRC-Befehl/-Nummer zu ersetzen, siehe /server raw oder /debug tags)
+  nick_xxx (xxx is nick in message), prefix_nick_ccc (ccc is color of nick),
+  host_xxx (xxx is username + host in message),
+  irc_xxx (xxx is command name or number, see /server raw or /debug tags),
   irc_numeric, irc_error, irc_action, irc_ctcp, irc_ctcp_reply, irc_smart_filter, away_info.
-Mittels "/debug tags" kann man sich die Tags jeder einzelnen Zeile darstellen lassen.
+To see tags for lines in buffers: /debug tags
 
-Beispiele:
-  aktiviert den intelligenten IRC Filter für alle Buffer:
+Examples:
+  use IRC smart filter on all buffers:
     /filter add irc_smart * irc_smart_filter *
-  aktiviert den intelligenten IRC Filter für alle Buffer, außer Buffer die "#weechat" im Namen tragen:
+  use IRC smart filter on all buffers except those with "#weechat" in name:
     /filter add irc_smart *,!*#weechat* irc_smart_filter *
-  filtert alle IRC join/part/quit Nachrichten:
+  filter all IRC join/part/quit messages:
     /filter add joinquit * irc_join,irc_part,irc_quit *
-  filtert Nicks wenn diese den Channel betreten oder durch den Befehl "/names" angezeigt werden:
+  filter nicks displayed when joining channels or with /names:
     /filter add nicks * irc_366 *
-  filtert Nick "toto" im IRC Channel #weechat:
+  filter nick "toto" on IRC channel #weechat:
     /filter add toto irc.freenode.#weechat nick_toto *
-  filtert IRC join/action Nachrichten von Nick "toto":
+  filter IRC join/action messages from nick "toto":
     /filter add toto * nick_toto+irc_join,nick_toto+irc_action *
-  filtert Zeilen die "weechat sucks" im IRC Channel #weechat enthalten:
+  filter lines containing "weechat sucks" on IRC channel #weechat:
     /filter add sucks irc.freenode.#weechat * weechat sucks
+  filter lines that are strictly equal to "WeeChat sucks" on all buffers:
+    /filter add sucks2 * * (?-i)^WeeChat sucks$
 ----
 
 [[command_weechat_help]]
diff --git a/doc/en/autogen/user/weechat_commands.asciidoc b/doc/en/autogen/user/weechat_commands.asciidoc
index 7e0c8faab..4ac65a137 100644
--- a/doc/en/autogen/user/weechat_commands.asciidoc
+++ b/doc/en/autogen/user/weechat_commands.asciidoc
@@ -359,6 +359,8 @@ Examples:
     /filter add toto * nick_toto+irc_join,nick_toto+irc_action *
   filter lines containing "weechat sucks" on IRC channel #weechat:
     /filter add sucks irc.freenode.#weechat * weechat sucks
+  filter lines that are strictly equal to "WeeChat sucks" on all buffers:
+    /filter add sucks2 * * (?-i)^WeeChat sucks$
 ----
 
 [[command_weechat_help]]
diff --git a/doc/fr/autogen/user/weechat_commands.asciidoc b/doc/fr/autogen/user/weechat_commands.asciidoc
index 5063c1f4c..369df32b9 100644
--- a/doc/fr/autogen/user/weechat_commands.asciidoc
+++ b/doc/fr/autogen/user/weechat_commands.asciidoc
@@ -359,6 +359,8 @@ Exemples :
     /filter add toto * nick_toto+irc_join,nick_toto+irc_action *
   filtrer les lignes contenant "weechat sucks" sur le canal IRC #weechat :
     /filter add sucks irc.freenode.#weechat * weechat sucks
+  filtrer les lignes qui sont strictement égales à "WeeChat sucks" sur tous les tampons :
+    /filter add sucks2 * * (?-i)^WeeChat sucks$
 ----
 
 [[command_weechat_help]]
diff --git a/doc/it/autogen/user/weechat_commands.asciidoc b/doc/it/autogen/user/weechat_commands.asciidoc
index cb46e90ba..5186aa026 100644
--- a/doc/it/autogen/user/weechat_commands.asciidoc
+++ b/doc/it/autogen/user/weechat_commands.asciidoc
@@ -359,6 +359,8 @@ Examples:
     /filter add toto * nick_toto+irc_join,nick_toto+irc_action *
   filter lines containing "weechat sucks" on IRC channel #weechat:
     /filter add sucks irc.freenode.#weechat * weechat sucks
+  filter lines that are strictly equal to "WeeChat sucks" on all buffers:
+    /filter add sucks2 * * (?-i)^WeeChat sucks$
 ----
 
 [[command_weechat_help]]
diff --git a/doc/ja/autogen/user/weechat_commands.asciidoc b/doc/ja/autogen/user/weechat_commands.asciidoc
index d15160366..beb56d532 100644
--- a/doc/ja/autogen/user/weechat_commands.asciidoc
+++ b/doc/ja/autogen/user/weechat_commands.asciidoc
@@ -309,56 +309,58 @@ hdata と変数の名前については、"プラグイン API リファレン�
          rename <name> <new_name>
          del <name>|-all
 
-   list: 全てのフィルタをリストアップ
- enable: フィルタを有効化 (フィルタはデフォルトで有効になっています)
-disable: フィルタを無効化
- toggle: フィルタの有効無効を切り替え
-   name: フィルタの名前 ("@" = 現在のバッファに設定されている全てのフィルタを有効化/無効化)
-    add: フィルタを追加
- rename: フィルタをリネーム
-    del: フィルタを削除
-   -all: 全てのフィルタを削除
- buffer: フィルタが有効化されているバッファのコンマ区切りリスト:
-         - これはプラグイン名を含む完全な名前です (例: "irc.freenode.#weechat" または "irc.server.freenode")
-         - "*" は全てのバッファを意味します
-         - 名前が '!' から始まるものは除外されます
-         - ワイルドカード '*' を使うことができます
-   tags: タグのコンマ区切りリスト、例えば "irc_join,irc_part,irc_quit"
-         - 論理積 "and": タグ同士を "+" でつなげてください (例: "nick_toto+irc_action")
-         - ワイルドカード '*' を使うことができます
-         - タグを '!' で始めると、そのタグが付けられたメッセージとそのタグを含むメッセージはフィルタされません
-  regex: 行単位検索の正規表現
-         - '\t' を使うと、プレフィックスをメッセージから分離できます。'|' 等の特別な文字は '\|' のようにエスケープしなければいけません
-         - 正規表現の最初に '!' が含まれる場合は、マッチ結果が反転されます (最初の '!' にマッチさせたければ、'\!' を使ってください)
-         - 2 種類の正規表現があります: 一方はプレフィックス用、他方はメッセージ用
-         - 正規表現は大文字小文字を区別しません、"(?-i)" から始まる場合は区別します
-
-デフォルトではキー alt+'=' でフィルタリングの on/off を切り替えられます。
-
-よく使われるタグ:
-  no_filter、no_highlight、no_log、log0..log9 (ログレベル)、
-  notify_none、notify_message、notify_private、notify_highlight、
-  nick_xxx (xxx はメッセージのニックネーム部分)、prefix_nick_ccc (ccc はニックネームの色)、
-  host_xxx (xxx はメッセージのユーザ名 + ホスト名部分)、
-  irc_xxx (xxx はコマンド名又は番号、/server raw または /debug tags で確認)、
-  irc_numeric、irc_error、irc_action、irc_ctcp、irc_ctcp_reply、irc_smart_filter、away_info。
-バッファ内でタグを見るには: /debug tags
-
-例:
-  全てのバッファで IRC スマートフィルタを使用:
+   list: list all filters
+ enable: enable filters (filters are enabled by default)
+disable: disable filters
+ toggle: toggle filters
+   name: filter name ("@" = enable/disable all filters in current buffer)
+    add: add a filter
+ rename: rename a filter
+    del: delete a filter
+   -all: delete all filters
+ buffer: comma separated list of buffers where filter is active:
+         - this is full name including plugin (example: "irc.freenode.#weechat" or "irc.server.freenode")
+         - "*" means all buffers
+         - a name starting with '!' is excluded
+         - wildcard "*" is allowed
+   tags: comma separated list of tags, for example "irc_join,irc_part,irc_quit"
+         - logical "and": use "+" between tags (for example: "nick_toto+irc_action")
+         - wildcard "*" is allowed
+         - if tag starts with '!', then it is excluded and must NOT be in message
+  regex: POSIX extended regular expression to search in line
+         - use '\t' to separate prefix from message, special chars like '|' must be escaped: '\|'
+         - if regex starts with '!', then matching result is reversed (use '\!' to start with '!')
+         - two regular expressions are created: one for prefix and one for message
+         - regex are case insensitive, they can start by "(?-i)" to become case sensitive
+
+The default key alt+'=' toggles filtering on/off.
+
+Tags most commonly used:
+  no_filter, no_highlight, no_log, log0..log9 (log level),
+  notify_none, notify_message, notify_private, notify_highlight,
+  nick_xxx (xxx is nick in message), prefix_nick_ccc (ccc is color of nick),
+  host_xxx (xxx is username + host in message),
+  irc_xxx (xxx is command name or number, see /server raw or /debug tags),
+  irc_numeric, irc_error, irc_action, irc_ctcp, irc_ctcp_reply, irc_smart_filter, away_info.
+To see tags for lines in buffers: /debug tags
+
+Examples:
+  use IRC smart filter on all buffers:
     /filter add irc_smart * irc_smart_filter *
-  名前に "#weechat" を含むバッファを除いた全てのバッファで IRC スマートフィルタを使用:
+  use IRC smart filter on all buffers except those with "#weechat" in name:
     /filter add irc_smart *,!*#weechat* irc_smart_filter *
-  全ての IRC join/part/quit メッセージをフィルタ:
+  filter all IRC join/part/quit messages:
     /filter add joinquit * irc_join,irc_part,irc_quit *
-  チャンネルに入った時や /names で表示されるニックネームをフィルタ:
+  filter nicks displayed when joining channels or with /names:
     /filter add nicks * irc_366 *
-  IRC チャンネル #weechat で "toto" を含むニックネームをフィルタ:
+  filter nick "toto" on IRC channel #weechat:
     /filter add toto irc.freenode.#weechat nick_toto *
-  ニックネーム "toto" からの IRC の参加/アクションメッセージをフィルタ:
+  filter IRC join/action messages from nick "toto":
     /filter add toto * nick_toto+irc_join,nick_toto+irc_action *
-  IRC チャンネル #weechat で "weechat sucks" を含む行をフィルタ:
+  filter lines containing "weechat sucks" on IRC channel #weechat:
     /filter add sucks irc.freenode.#weechat * weechat sucks
+  filter lines that are strictly equal to "WeeChat sucks" on all buffers:
+    /filter add sucks2 * * (?-i)^WeeChat sucks$
 ----
 
 [[command_weechat_help]]
diff --git a/doc/pl/autogen/user/weechat_commands.asciidoc b/doc/pl/autogen/user/weechat_commands.asciidoc
index 546da04c0..bb1d29357 100644
--- a/doc/pl/autogen/user/weechat_commands.asciidoc
+++ b/doc/pl/autogen/user/weechat_commands.asciidoc
@@ -309,56 +309,58 @@ Examples (conditions):
          rename <nazwa> <nowa_nazwa>
          del <nazwa>|-all
 
-   list: wyświetla wszystkie filtry
- enable: włącza filtry (filtry są domyślnie włączone)
-disable: wyłącza filtry
- toggle: przełącza filtry
-  nazwa: nazwa filtru ("@" = włącza/wyłącza wszystkie filtry w obecnym buforze)
-    add: dodaje filtr
- rename: zmienia nazwę filtru
-    del: usuwa filtr
-   -all: usuwa wszystkie filtry
- bufor: oddzielona przecinkami lisa buforów, dla których filtr jest aktywny:
-         - jest to pełna nazwa zawierająca wtyczkę (przykład: "irc.freenode.#weechat")
-         - "*" oznacza wszystkie bufory
-         - nazwa zaczynająca się od '!' jest wykluczana
-         - nazwa może zaczynać się lub kończyć '*', aby dopasować wiele buforów
-   tagi: lista tagów oddzielona przecinkiem, np: "irc_join,irc_part,irc_quit"
-         - logiczne "i": użyj "+" pomiędzy tagami (na przykład: "nick_toto+irc_action")
-         - dozwolony jest znak "*"
-         - jeśli tag zaczyna się od '!', wtedy jest on wykluczony i NIE może znajdować się w wiadomości
-  regex: rozszerzone wyrażenie regularne POSIX do wyszukania w linii
-         - użyj '\t' do oddzielenia prefiksu od wiadomości, znaki specjalne jak '|' muszą zostać poprzedzone '\' np: '\|'
-         - jeśli wyrażenie zaczyna się od '!', wtedy pasujący wynik jest odwracany (użyj '\!', aby zacząć od '!')
-         - dwa wyrażenia są tworzone: jedno dla prefiksu, drugie dla wiadomości
-         - wielkość znaków nie ma znaczenia dla wyrażeń, jeśli zaczynają się od "(?-i)" wielkość znaków ma znaczenie
-
-Domyślny skrót klawiszowy alt+'=' włącza/wyłącza filtrowanie.
-
-Najczęściej używane tagi:
-  no_filter, no_highlight, no_log, log0..log9 (poziom logowania),
+   list: list all filters
+ enable: enable filters (filters are enabled by default)
+disable: disable filters
+ toggle: toggle filters
+   name: filter name ("@" = enable/disable all filters in current buffer)
+    add: add a filter
+ rename: rename a filter
+    del: delete a filter
+   -all: delete all filters
+ buffer: comma separated list of buffers where filter is active:
+         - this is full name including plugin (example: "irc.freenode.#weechat" or "irc.server.freenode")
+         - "*" means all buffers
+         - a name starting with '!' is excluded
+         - wildcard "*" is allowed
+   tags: comma separated list of tags, for example "irc_join,irc_part,irc_quit"
+         - logical "and": use "+" between tags (for example: "nick_toto+irc_action")
+         - wildcard "*" is allowed
+         - if tag starts with '!', then it is excluded and must NOT be in message
+  regex: POSIX extended regular expression to search in line
+         - use '\t' to separate prefix from message, special chars like '|' must be escaped: '\|'
+         - if regex starts with '!', then matching result is reversed (use '\!' to start with '!')
+         - two regular expressions are created: one for prefix and one for message
+         - regex are case insensitive, they can start by "(?-i)" to become case sensitive
+
+The default key alt+'=' toggles filtering on/off.
+
+Tags most commonly used:
+  no_filter, no_highlight, no_log, log0..log9 (log level),
   notify_none, notify_message, notify_private, notify_highlight,
-  nick_xxx (xxx to nick w wiadomości), prefix_nick_ccc (ccc to kolor nicka),
-  host_xxx (xxx to nazwa użytkownika + host w wiadomości),
-  irc_xxx (xxx ito nazwa komendy lub numer, zobacz /server raw lub /debug tags),
+  nick_xxx (xxx is nick in message), prefix_nick_ccc (ccc is color of nick),
+  host_xxx (xxx is username + host in message),
+  irc_xxx (xxx is command name or number, see /server raw or /debug tags),
   irc_numeric, irc_error, irc_action, irc_ctcp, irc_ctcp_reply, irc_smart_filter, away_info.
-Aby zobaczyć listę tagów w liniach buforów wykonaj: /debug tags
+To see tags for lines in buffers: /debug tags
 
-Przykłady:
-  użyj inteligentnego filtru we wszystkich buforach IRC:
+Examples:
+  use IRC smart filter on all buffers:
     /filter add irc_smart * irc_smart_filter *
-  użyj inteligentnego filtru we wszystkich buforach IRC poza tymi zawierającymi "#weechat" w nazwie:
+  use IRC smart filter on all buffers except those with "#weechat" in name:
     /filter add irc_smart *,!*#weechat* irc_smart_filter *
-  filtruj wszystkie wiadomości IRC o join/part/quit:
+  filter all IRC join/part/quit messages:
     /filter add joinquit * irc_join,irc_part,irc_quit *
-  filtruj nicki wyświetlane przy wejściu na kanał albo za pomocą /names:
+  filter nicks displayed when joining channels or with /names:
     /filter add nicks * irc_366 *
-  filtruj nick "toto" na kanale IRC #weechat:
+  filter nick "toto" on IRC channel #weechat:
     /filter add toto irc.freenode.#weechat nick_toto *
-  filtruj wejścia/akcje IRC od użytkownika "toto":
+  filter IRC join/action messages from nick "toto":
     /filter add toto * nick_toto+irc_join,nick_toto+irc_action *
-  filtruj linie zawierające fraze "weechat sucks" na kanale IRC #weechat:
+  filter lines containing "weechat sucks" on IRC channel #weechat:
     /filter add sucks irc.freenode.#weechat * weechat sucks
+  filter lines that are strictly equal to "WeeChat sucks" on all buffers:
+    /filter add sucks2 * * (?-i)^WeeChat sucks$
 ----
 
 [[command_weechat_help]]