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

2020-07-20 21:48:20 +02:00 · 2020-07-20 21:48:20 +02:00 · 5bf571c60f
commit 5bf571c60f
parent e0e905ca7f
6 changed files with 87 additions and 30 deletions
--- a/doc/de/weechat_user.de.adoc
+++ b/doc/de/weechat_user.de.adoc
@ -1124,11 +1124,15 @@ Tags die häufig verwendet werden (keine vollständige Auflistung):
 | no_filter        | Zeile kann nicht gefiltert werden.
 | no_highlight     | die Zeile kann nicht gehiglighted werden.
 | no_log           | Zeile wird nicht in die Log-Datei geschrieben.
-| log0 ... log9    | Grad der Protokollierung (siehe `/help logger`).
-| notify_none      | Buffer welche die Zeile enthält wird nicht zur Hotlist hinzufügt.
-| notify_message   | Buffer welche die Zeile enthält wird mit der Stufe "message" zur Hotlist hinzugefügt.
-| notify_private   | Buffer welche die Zeile enthält wird mit der Stufe "private" zur Hotlist hinzugefügt.
-| notify_highlight | Buffer welche die Zeile enthält wird mit der Stufe "highlight" zur Hotlist hinzugefügt.
+| log0 … log9      | Grad der Protokollierung (siehe `/help logger`).
+// TRANSLATION MISSING
+| notify_none      | The line must not be added to hotlist. ^(1)^
+// TRANSLATION MISSING
+| notify_message   | The line is a user message. ^(1)^
+// TRANSLATION MISSING
+| notify_private   | The line is a private message. ^(1)^
+// TRANSLATION MISSING
+| notify_highlight | The line is a message with highlight. ^(1)^
 | self_msg         | eigene Nachricht.
 | nick_xxx         | Nachricht ist vom Nick "xxx".
 | prefix_nick_ccc  | Präfix für den Nick mit der Farbe "ccc".
@ -1143,6 +1147,13 @@ Tags die häufig verwendet werden (keine vollständige Auflistung):
 | away_info        | Nachricht mit "away" Information.
 |===

+// TRANSLATION MISSING
+[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

--- 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

--- a/doc/fr/weechat_user.fr.adoc
+++ b/doc/fr/weechat_user.fr.adoc
@ -1138,11 +1138,11 @@ Les étiquettes couramment utilisées (liste non exhaustive) :
 | no_filter        | La ligne ne peut pas être filtrée.
 | no_highlight     | Aucun highlight n'est possible sur cette ligne.
 | no_log           | La ligne n'est pas écrite dans le fichier de log.
-| log0 ... log9    | Niveau de log pour la ligne (voir `/help logger`).
-| notify_none      | Le tampon avec la ligne ne sera pas ajouté à la "hotlist".
-| notify_message   | Le tampon avec la ligne sera ajouté à la "hotlist" avec le niveau "message".
-| notify_private   | Le tampon avec la ligne sera ajouté à la "hotlist" avec le niveau "private".
-| notify_highlight | Le tampon avec la ligne sera ajouté à la "hotlist" avec le niveau "highlight".
+| log0 … log9      | Niveau de log pour la ligne (voir `/help logger`).
+| notify_none      | La ligne ne doit pas être ajoutée à la "hotlist". ^(1)^
+| notify_message   | La ligne est un message utilisateur. ^(1)^
+| notify_private   | La ligne est un message privé. ^(1)^
+| notify_highlight | La ligne est un message avec un highlight. ^(1)^
 | self_msg         | Message de soi-même.
 | nick_xxx         | Le message vient du pseudo "xxx".
 | prefix_nick_ccc  | Le préfixe est un pseudo avec la couleur "ccc".
@ -1157,6 +1157,13 @@ Les étiquettes couramment utilisées (liste non exhaustive) :
 | away_info        | Message avec une info d'absence.
 |===

+[NOTE]
+^(1)^ Lorsque aucune étiquette "notify_xxx" n'est présente, le niveau de
+notification par défaut est "low". Si une étiquette "notify_xxx" est présente,
+le niveau de notification réel peut être différent, par exemple si un niveau
+maximum de hotlist est utilisé pour un pseudo, le niveau de notification peut
+être inférieur à la valeur de l'étiquette.
+
 [[bars]]
 === Barres

--- a/doc/it/weechat_user.it.adoc
+++ b/doc/it/weechat_user.it.adoc
@ -1188,11 +1188,15 @@ Tag usati di frequente (elenco non esaustivo):
 | no_filter        | La riga non può essere filtrata.
 | no_highlight     | Evidenziazione non possibile sulla riga.
 | no_log           | La riga non viene scritta nel file di log.
-| log0 ... log9    | Livello di log per la riga (consultare `/help logger`).
-| notify_none      | Il buffer con la riga non viene aggiunto alla hotlist.
-| notify_message   | Il buffer con la riga viene aggiunto alla hotlist con il livello "message".
-| notify_private   | Il buffer con la riga viene aggiunto alla hotlist con il livello "private".
-| notify_highlight | Il buffer con la riga viene aggiunto alla hotlist con il livello "higlight".
+| log0 … log9      | Livello di log per la riga (consultare `/help logger`).
+// TRANSLATION MISSING
+| notify_none      | The line must not be added to hotlist. ^(1)^
+// TRANSLATION MISSING
+| notify_message   | The line is a user message. ^(1)^
+// TRANSLATION MISSING
+| notify_private   | The line is a private message. ^(1)^
+// TRANSLATION MISSING
+| notify_highlight | The line is a message with highlight. ^(1)^
 // TRANSLATION MISSING
 | self_msg         | Self message.
 | nick_xxx         | Il messaggio viene dal nick "xxx".
@ -1209,6 +1213,13 @@ Tag usati di frequente (elenco non esaustivo):
 | away_info        | Messagio con informazioni sull'assenza.
 |===

+// TRANSLATION MISSING
+[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.
+
 // TRANSLATION MISSING
 [[bars]]
 === Bars
--- a/doc/ja/weechat_user.ja.adoc
+++ b/doc/ja/weechat_user.ja.adoc
@ -1123,11 +1123,15 @@ WeeChat は様々な目的で各行にタグを付けます:
 | no_filter        | フィルタできない行
 | no_highlight     | ハイライトできない行
 | no_log           | ログファイルに書き込まれない行
-| log0 ... log9    | 行に対するログレベル (`/help logger` を参照)
-| notify_none      | この行を含むバッファはホットリストに追加されません
-| notify_message   | この行を含むバッファは "message" レベルでホットリストに追加されます
-| notify_private   | この行を含むバッファは "private" レベルでホットリストに追加されます
-| notify_highlight | この行を含むバッファは "highlight" レベルでホットリストに追加されます
+| log0 … log9      | 行に対するログレベル (`/help logger` を参照)
+// TRANSLATION MISSING
+| notify_none      | The line must not be added to hotlist. ^(1)^
+// TRANSLATION MISSING
+| notify_message   | The line is a user message. ^(1)^
+// TRANSLATION MISSING
+| notify_private   | The line is a private message. ^(1)^
+// TRANSLATION MISSING
+| notify_highlight | The line is a message with highlight. ^(1)^
 | self_msg         | 自分のメッセージ
 | nick_xxx         | ニックネーム "xxx" からのメッセージ
 | prefix_nick_ccc  | プレフィックスを色 "ccc" のニックネームにします
@ -1142,6 +1146,13 @@ WeeChat は様々な目的で各行にタグを付けます:
 | away_info        | 離席状態のメッセージ
 |===

+// TRANSLATION MISSING
+[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]]
 === バー

--- a/doc/pl/weechat_user.pl.adoc
+++ b/doc/pl/weechat_user.pl.adoc
@ -1117,11 +1117,15 @@ Popularnie używane tagi  (niepełna lista):
 | no_filter        | Linia nie może być filtrowana.
 | no_highlight     | Podświetlenia nie są dozwolone w tej linii.
 | no_log           | Linia nie jest zapisywana w logu.
-| log0 ... log9    | Poziom logowania dla linii (zobacz `/help logger`).
-| notify_none      | Bufor z linią nie dodana do hotlisty.
-| notify_message   | Bufor z linia dodaną do hotlisty z poziomem "message".
-| notify_private   | Bufor z linia dodaną do hotlisty z poziomem "private".
-| notify_highlight | Bufor z linia dodaną do hotlisty z poziomem "highlight".
+| log0 … log9      | Poziom logowania dla linii (zobacz `/help logger`).
+// TRANSLATION MISSING
+| notify_none      | The line must not be added to hotlist. ^(1)^
+// TRANSLATION MISSING
+| notify_message   | The line is a user message. ^(1)^
+// TRANSLATION MISSING
+| notify_private   | The line is a private message. ^(1)^
+// TRANSLATION MISSING
+| notify_highlight | The line is a message with highlight. ^(1)^
 | self_msg         | Własna wiadomość.
 | nick_xxx         | Wiadomość od nicku "xxx".
 | prefix_nick_ccc  | Prefiks to nick o kolorze "ccc".
@ -1136,6 +1140,13 @@ Popularnie używane tagi  (niepełna lista):
 | away_info        | Wiadomość z powodem nieobecności.
 |===

+// TRANSLATION MISSING
+[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]]
 === Paski