Allow list of buffers in command /filter (exclusion with prefix "!") (task #10880)

1 files changed, 23 insertions, 17 deletions

diff --git a/doc/en/autogen/user/weechat_commands.txt b/doc/en/autogen/user/weechat_commands.txt
index 3baa49ef3..d329ec8b5 100644
--- a/doc/en/autogen/user/weechat_commands.txt
+++ b/doc/en/autogen/user/weechat_commands.txt
@@ -163,23 +163,27 @@ windows: display windows tree
 ........................................
 /filter  list
          enable|disable|toggle [<name>]
-         add <name> <plugin.buffer> <tags> <regex>
+         add <name> <buffer>[,<buffer>...] <tags> <regex>
          del <name>|-all
 
-         list: list all filters
-       enable: enable filters (filters are enabled by default)
-      disable: disable filters
-       toggle: toggle filters
-         name: filter name
-          add: add a filter
-          del: delete a filter
-         -all: delete all filters
-plugin.buffer: plugin and buffer where filter is active ("*" for all buffers)
-         tags: comma separated list of tags, for example: "irc_join,irc_part,irc_quit"
-        regex: 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 '!')
-               note: two regex are created: one for prefix and one for message
+   list: list all filters
+ enable: enable filters (filters are enabled by default)
+disable: disable filters
+ toggle: toggle filters
+   name: filter name
+    add: add 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")
+         - "*" means all buffers
+         - a name starting with '!' is excluded
+         - name can start or end with '*' to match many buffers
+   tags: comma separated list of tags, for example: "irc_join,irc_part,irc_quit"
+  regex: 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
 
 The default key alt+'=' toggles filtering on/off.
 
@@ -191,8 +195,10 @@ Tags most commonly used:
   irc_numeric, irc_error, irc_action, irc_ctcp, irc_ctcp_reply, irc_smart_filter, away_info.
 
 Examples:
-  use IRC smart filter for join/part/quit messages:
+  use IRC smart filter on all buffers:
     /filter add irc_smart * irc_smart_filter *
+  use IRC smart filter on all buffers except those with "#weechat" in name:
+    /filter add irc_smart *,!*#weechat* irc_smart_filter *
   filter all IRC join/part/quit messages:
     /filter add joinquit * irc_join,irc_part,irc_quit *
   filter nicks displayed when joining channels or with /names:
@@ -421,7 +427,7 @@ Without argument, all files (WeeChat and plugins) are saved.
 ........................................
 /set  [<option> [<value>]]
 
-option: name of an option (can start or end with "*" to list many options)
+option: name of an option (can start or end with '*' to list many options)
  value: new value for option
 
 New value can be, according to variable type: