doc: improve description of tags "notify_xxx" in chapter on lines tags (user's guide) (issue #1529)

1 files changed, 11 insertions, 5 deletions

diff --git a/doc/en/weechat_user.en.adoc b/doc/en/weechat_user.en.adoc
index 368eb227e..ecd4a655c 100644
--- a/doc/en/weechat_user.en.adoc
+++ b/doc/en/weechat_user.en.adoc
@@ -1108,11 +1108,11 @@ Tags commonly used (non-exhaustive list):
 | no_filter        | Line can not be filtered.
 | no_highlight     | No highlight is possible on line.
 | no_log           | Line is not written in log file.
-| log0 ... log9    | Level of log for line (see `/help logger`).
-| notify_none      | Buffer with line is not added to hotlist.
-| notify_message   | Buffer with line is added to hotlist with level "message".
-| notify_private   | Buffer with line is added to hotlist with level "private".
-| notify_highlight | Buffer with line is added to hotlist with level "highlight".
+| log0 … log9      | Level of log for line (see `/help logger`).
+| notify_none      | The line must not be added to hotlist. ^(1)^
+| notify_message   | The line is a user message. ^(1)^
+| notify_private   | The line is a private message. ^(1)^
+| notify_highlight | The line is a message with highlight. ^(1)^
 | self_msg         | Self message.
 | nick_xxx         | Message is from nick "xxx".
 | prefix_nick_ccc  | Prefix is a nick with color "ccc".
@@ -1127,6 +1127,12 @@ Tags commonly used (non-exhaustive list):
 | away_info        | Message with away info.
 |===
 
+[NOTE]
+^(1)^ When no tag "notify_xxx" is present, the default level is "low". If a tag
+"notify_xxx" is present, the real notify level can be different, for example
+if a max hotlist level is used for a nick, the notify level can be lower than
+the value in the tag.
+
 [[bars]]
 === Bars