buflist: improve help on option buflist.look.sort

20 files changed, 81 insertions, 50 deletions

diff --git a/doc/de/includes/autogen_user_options.de.adoc b/doc/de/includes/autogen_user_options.de.adoc
index 56be7d699..b65996d9c 100644
--- a/doc/de/includes/autogen_user_options.de.adoc
+++ b/doc/de/includes/autogen_user_options.de.adoc
@@ -1807,7 +1807,7 @@
 ** Standardwert: `+""+`
 
 * [[option_buflist.look.sort]] *buflist.look.sort*
-** Beschreibung: pass:none[durch Kommata getrennte Liste von Feldern um die Buffer zu sortieren; jedes Feld ist entweder eine hdata Variable von Buffer ("var"), eine hdata Variable vom Typ IRC Server ("irc_server.var") oder eine hdata Variable vom Typ IRC Channel ("irc_channel.var"); wird das "-" Zeichen vor einem Feld angewendet, wird die Ausgabe umgekehrt, um bei einem Vergleich nicht zwischen Groß- und Kleinschreibung zu unterscheiden wird das Zeichen  "~" verwendet; Beispiel: "-~short_name" sortiert die Buffer nach ihrem Kurznamen, wobei dies invertiert passiert und nicht zwischen Groß-oder Kleinschreibung unterschieden wird (Hinweis: der Inhalt ist evaluiert, nur der Pointer der bar_item kann genutzt werden, Beispiel "bar_item.name")]
+** Beschreibung: pass:none[comma-separated list of fields to sort buffers; each field is a hdata variable of buffer ("var"), a hdata variable of IRC server ("irc_server.var") or a hdata variable of IRC channel ("irc_channel.var"); char "-" can be used before field to reverse order, char "~" can be used to do a case insensitive comparison; example: "-~short_name" for case insensitive and reverse sort on buffer short name (note: the content is evaluated, before being split into fields, but at that time "bar_item" is the only variable that can be used, to distinguish between different buflist items, for example "${bar_item.name}")]
 ** Typ: Zeichenkette
 ** Werte: beliebige Zeichenkette
 ** Standardwert: `+"number,-active"+`
diff --git a/doc/en/includes/autogen_user_options.en.adoc b/doc/en/includes/autogen_user_options.en.adoc
index 41a23e50e..20f2978a9 100644
--- a/doc/en/includes/autogen_user_options.en.adoc
+++ b/doc/en/includes/autogen_user_options.en.adoc
@@ -1807,7 +1807,7 @@
 ** default value: `+""+`
 
 * [[option_buflist.look.sort]] *buflist.look.sort*
-** description: pass:none[comma-separated list of fields to sort buffers; each field is a hdata variable of buffer ("var"), a hdata variable of IRC server ("irc_server.var") or a hdata variable of IRC channel ("irc_channel.var"); char "-" can be used before field to reverse order, char "~" can be used to do a case insensitive comparison; example: "-~short_name" for case insensitive and reverse sort on buffer short name (note: content is evaluated, only the pointer to bar_item can be used, for example "bar_item.name")]
+** description: pass:none[comma-separated list of fields to sort buffers; each field is a hdata variable of buffer ("var"), a hdata variable of IRC server ("irc_server.var") or a hdata variable of IRC channel ("irc_channel.var"); char "-" can be used before field to reverse order, char "~" can be used to do a case insensitive comparison; example: "-~short_name" for case insensitive and reverse sort on buffer short name (note: the content is evaluated, before being split into fields, but at that time "bar_item" is the only variable that can be used, to distinguish between different buflist items, for example "${bar_item.name}")]
 ** type: string
 ** values: any string
 ** default value: `+"number,-active"+`
diff --git a/doc/fr/includes/autogen_user_options.fr.adoc b/doc/fr/includes/autogen_user_options.fr.adoc
index 3c80de870..fac0ce690 100644
--- a/doc/fr/includes/autogen_user_options.fr.adoc
+++ b/doc/fr/includes/autogen_user_options.fr.adoc
@@ -1807,7 +1807,7 @@
 ** valeur par défaut: `+""+`
 
 * [[option_buflist.look.sort]] *buflist.look.sort*
-** description: pass:none[liste de champs séparés par des virgules pour trier les tampons ; chaque champ est une variable hdata du tampon ("var"), une variable hdata du serveur IRC ("irc_server.var") ou une variable hdata du canal IRC ("irc_channel.var") ; le caractère "-" peut être utilisé pour inverser l'ordre, le caractère "~" peut être utilisé pour effectuer une comparaison insensible à la casse ; exemple : "-~short_name" pour un tri inverse insensible à la casse sur le nom court du tampon (note : le contenu est évalué, seul le pointeur vers bar_item peut être utilisé, par exemple "bar_item.name")]
+** description: pass:none[liste de champs séparés par des virgules pour trier les tampons ; chaque champ est une variable hdata du tampon ("var"), une variable hdata du serveur IRC ("irc_server.var") ou une variable hdata du canal IRC ("irc_channel.var") ; le caractère "-" peut être utilisé pour inverser l'ordre, le caractère "~" peut être utilisé pour effectuer une comparaison insensible à la casse ; exemple : "-~short_name" pour un tri inverse insensible à la casse sur le nom court du tampon (note : le contenu est évalué, avant d'être découpé en champs, mais à cet instant "bar_item" est la seule variable qui peut être utilisée, pour distinguer les différents objets de barre buflist, par exemple "${bar_item.name}")]
 ** type: chaîne
 ** valeurs: toute chaîne
 ** valeur par défaut: `+"number,-active"+`
diff --git a/doc/it/includes/autogen_user_options.it.adoc b/doc/it/includes/autogen_user_options.it.adoc
index 8fb4a6f6e..1835d498d 100644
--- a/doc/it/includes/autogen_user_options.it.adoc
+++ b/doc/it/includes/autogen_user_options.it.adoc
@@ -1807,7 +1807,7 @@
 ** valore predefinito: `+""+`
 
 * [[option_buflist.look.sort]] *buflist.look.sort*
-** descrizione: pass:none[comma-separated list of fields to sort buffers; each field is a hdata variable of buffer ("var"), a hdata variable of IRC server ("irc_server.var") or a hdata variable of IRC channel ("irc_channel.var"); char "-" can be used before field to reverse order, char "~" can be used to do a case insensitive comparison; example: "-~short_name" for case insensitive and reverse sort on buffer short name (note: content is evaluated, only the pointer to bar_item can be used, for example "bar_item.name")]
+** descrizione: pass:none[comma-separated list of fields to sort buffers; each field is a hdata variable of buffer ("var"), a hdata variable of IRC server ("irc_server.var") or a hdata variable of IRC channel ("irc_channel.var"); char "-" can be used before field to reverse order, char "~" can be used to do a case insensitive comparison; example: "-~short_name" for case insensitive and reverse sort on buffer short name (note: the content is evaluated, before being split into fields, but at that time "bar_item" is the only variable that can be used, to distinguish between different buflist items, for example "${bar_item.name}")]
 ** tipo: stringa
 ** valori: qualsiasi stringa
 ** valore predefinito: `+"number,-active"+`
diff --git a/doc/ja/includes/autogen_user_options.ja.adoc b/doc/ja/includes/autogen_user_options.ja.adoc
index db2bcf75d..9d0e3d54b 100644
--- a/doc/ja/includes/autogen_user_options.ja.adoc
+++ b/doc/ja/includes/autogen_user_options.ja.adoc
@@ -1807,7 +1807,7 @@
 ** デフォルト値: `+""+`
 
 * [[option_buflist.look.sort]] *buflist.look.sort*
-** 説明: pass:none[comma-separated list of fields to sort buffers; each field is a hdata variable of buffer ("var"), a hdata variable of IRC server ("irc_server.var") or a hdata variable of IRC channel ("irc_channel.var"); char "-" can be used before field to reverse order, char "~" can be used to do a case insensitive comparison; example: "-~short_name" for case insensitive and reverse sort on buffer short name (note: content is evaluated, only the pointer to bar_item can be used, for example "bar_item.name")]
+** 説明: pass:none[comma-separated list of fields to sort buffers; each field is a hdata variable of buffer ("var"), a hdata variable of IRC server ("irc_server.var") or a hdata variable of IRC channel ("irc_channel.var"); char "-" can be used before field to reverse order, char "~" can be used to do a case insensitive comparison; example: "-~short_name" for case insensitive and reverse sort on buffer short name (note: the content is evaluated, before being split into fields, but at that time "bar_item" is the only variable that can be used, to distinguish between different buflist items, for example "${bar_item.name}")]
 ** タイプ: 文字列
 ** 値: 未制約文字列
 ** デフォルト値: `+"number,-active"+`
diff --git a/doc/pl/includes/autogen_user_options.pl.adoc b/doc/pl/includes/autogen_user_options.pl.adoc
index 34c850338..1a24b2667 100644
--- a/doc/pl/includes/autogen_user_options.pl.adoc
+++ b/doc/pl/includes/autogen_user_options.pl.adoc
@@ -1807,7 +1807,7 @@
 ** domyślna wartość: `+""+`
 
 * [[option_buflist.look.sort]] *buflist.look.sort*
-** opis: pass:none[oddzielona przecinkami lista pól do sortowania buforów; każde pole to zmienna hdata bufora ("var"), zmienna hdata serwera IRC ("irc_server.var") lub zmienna hdata kanału IRC ("irc_channel.var"); znak "-" użyty przed nazwą pola odwraca kolejność, znak "~" może zostać użyty do porównań niewrażliwych na wielkość liter; przykład: "-~short_name" dla sortowania odwrotnego, niewrażliwego na wielkość liter po skróconej nazwie bufora (uwaga: zawartość jest przetwarzana, tylko wskaźnik na bar_item może zostać użyty, na przykład "bar_item.name")]
+** opis: pass:none[comma-separated list of fields to sort buffers; each field is a hdata variable of buffer ("var"), a hdata variable of IRC server ("irc_server.var") or a hdata variable of IRC channel ("irc_channel.var"); char "-" can be used before field to reverse order, char "~" can be used to do a case insensitive comparison; example: "-~short_name" for case insensitive and reverse sort on buffer short name (note: the content is evaluated, before being split into fields, but at that time "bar_item" is the only variable that can be used, to distinguish between different buflist items, for example "${bar_item.name}")]
 ** typ: ciąg
 ** wartości: dowolny ciąg
 ** domyślna wartość: `+"number,-active"+`
diff --git a/po/cs.po b/po/cs.po
index 0c37fcebc..895019126 100644
--- a/po/cs.po
+++ b/po/cs.po
@@ -21,7 +21,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: WeeChat\n"
 "Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
-"POT-Creation-Date: 2021-03-17 21:46+0100\n"
+"POT-Creation-Date: 2021-03-21 09:32+0100\n"
 "PO-Revision-Date: 2021-02-06 15:55+0100\n"
 "Last-Translator: Ondřej Súkup <mimi.vx@gmail.com>\n"
 "Language-Team: weechat-dev <weechat-dev@nongnu.org>\n"
@@ -5116,8 +5116,10 @@ msgid ""
 "var\") or a hdata variable of IRC channel (\"irc_channel.var\"); char \"-\" "
 "can be used before field to reverse order, char \"~\" can be used to do a "
 "case insensitive comparison; example: \"-~short_name\" for case insensitive "
-"and reverse sort on buffer short name (note: content is evaluated, only the "
-"pointer to bar_item can be used, for example \"bar_item.name\")"
+"and reverse sort on buffer short name (note: the content is evaluated, "
+"before being split into fields, but at that time \"bar_item\" is the only "
+"variable that can be used, to distinguish between different buflist items, "
+"for example \"${bar_item.name}\")"
 msgstr ""
 
 msgid ""
diff --git a/po/de.po b/po/de.po
index 99becc6ab..2ba0b9972 100644
--- a/po/de.po
+++ b/po/de.po
@@ -24,7 +24,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: WeeChat\n"
 "Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
-"POT-Creation-Date: 2021-03-17 21:56+0100\n"
+"POT-Creation-Date: 2021-03-21 09:32+0100\n"
 "PO-Revision-Date: 2021-03-20 06:35+0100\n"
 "Last-Translator: Nils Görs <weechatter@arcor.de>\n"
 "Language-Team: German <kde-i18n-de@kde.org>\n"
@@ -6209,14 +6209,17 @@ msgstr ""
 "benutzerdefinierte Variablen genutzt werden und dadurch eine Aktualisierung "
 "erforderlich wird"
 
+#, fuzzy
 msgid ""
 "comma-separated list of fields to sort buffers; each field is a hdata "
 "variable of buffer (\"var\"), a hdata variable of IRC server (\"irc_server."
 "var\") or a hdata variable of IRC channel (\"irc_channel.var\"); char \"-\" "
 "can be used before field to reverse order, char \"~\" can be used to do a "
 "case insensitive comparison; example: \"-~short_name\" for case insensitive "
-"and reverse sort on buffer short name (note: content is evaluated, only the "
-"pointer to bar_item can be used, for example \"bar_item.name\")"
+"and reverse sort on buffer short name (note: the content is evaluated, "
+"before being split into fields, but at that time \"bar_item\" is the only "
+"variable that can be used, to distinguish between different buflist items, "
+"for example \"${bar_item.name}\")"
 msgstr ""
 "durch Kommata getrennte Liste von Feldern um die Buffer zu sortieren; jedes "
 "Feld ist entweder eine hdata Variable von Buffer (\"var\"), eine hdata "
diff --git a/po/es.po b/po/es.po
index 149b184f2..2bb279ee1 100644
--- a/po/es.po
+++ b/po/es.po
@@ -22,7 +22,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: WeeChat\n"
 "Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
-"POT-Creation-Date: 2021-03-17 21:46+0100\n"
+"POT-Creation-Date: 2021-03-21 09:32+0100\n"
 "PO-Revision-Date: 2021-02-06 15:55+0100\n"
 "Last-Translator: Elián Hanisch <lambdae2@gmail.com>\n"
 "Language-Team: weechat-dev <weechat-dev@nongnu.org>\n"
@@ -5315,8 +5315,10 @@ msgid ""
 "var\") or a hdata variable of IRC channel (\"irc_channel.var\"); char \"-\" "
 "can be used before field to reverse order, char \"~\" can be used to do a "
 "case insensitive comparison; example: \"-~short_name\" for case insensitive "
-"and reverse sort on buffer short name (note: content is evaluated, only the "
-"pointer to bar_item can be used, for example \"bar_item.name\")"
+"and reverse sort on buffer short name (note: the content is evaluated, "
+"before being split into fields, but at that time \"bar_item\" is the only "
+"variable that can be used, to distinguish between different buflist items, "
+"for example \"${bar_item.name}\")"
 msgstr ""
 
 msgid ""
diff --git a/po/fr.po b/po/fr.po
index 13d81a557..ae49f8911 100644
--- a/po/fr.po
+++ b/po/fr.po
@@ -21,8 +21,8 @@ msgid ""
 msgstr ""
 "Project-Id-Version: WeeChat\n"
 "Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
-"POT-Creation-Date: 2021-03-17 21:46+0100\n"
-"PO-Revision-Date: 2021-03-17 21:47+0100\n"
+"POT-Creation-Date: 2021-03-21 09:32+0100\n"
+"PO-Revision-Date: 2021-03-21 09:32+0100\n"
 "Last-Translator: Sébastien Helleu <flashcode@flashtux.org>\n"
 "Language-Team: weechat-dev <weechat-dev@nongnu.org>\n"
 "Language: fr\n"
@@ -6074,8 +6074,10 @@ msgid ""
 "var\") or a hdata variable of IRC channel (\"irc_channel.var\"); char \"-\" "
 "can be used before field to reverse order, char \"~\" can be used to do a "
 "case insensitive comparison; example: \"-~short_name\" for case insensitive "
-"and reverse sort on buffer short name (note: content is evaluated, only the "
-"pointer to bar_item can be used, for example \"bar_item.name\")"
+"and reverse sort on buffer short name (note: the content is evaluated, "
+"before being split into fields, but at that time \"bar_item\" is the only "
+"variable that can be used, to distinguish between different buflist items, "
+"for example \"${bar_item.name}\")"
 msgstr ""
 "liste de champs séparés par des virgules pour trier les tampons ; chaque "
 "champ est une variable hdata du tampon (\"var\"), une variable hdata du "
@@ -6084,8 +6086,9 @@ msgstr ""
 "l'ordre, le caractère \"~\" peut être utilisé pour effectuer une comparaison "
 "insensible à la casse ; exemple : \"-~short_name\" pour un tri inverse "
 "insensible à la casse sur le nom court du tampon (note : le contenu est "
-"évalué, seul le pointeur vers bar_item peut être utilisé, par exemple "
-"\"bar_item.name\")"
+"évalué, avant d'être découpé en champs, mais à cet instant \"bar_item\" est "
+"la seule variable qui peut être utilisée, pour distinguer les différents "
+"objets de barre buflist, par exemple \"${bar_item.name}\")"
 
 msgid ""
 "number of buflist bar items that can be used; the item names are: \"buflist"
diff --git a/po/hu.po b/po/hu.po
index d4e3ca057..2121bcb35 100644
--- a/po/hu.po
+++ b/po/hu.po
@@ -20,7 +20,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: WeeChat\n"
 "Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
-"POT-Creation-Date: 2021-03-17 21:46+0100\n"
+"POT-Creation-Date: 2021-03-21 09:32+0100\n"
 "PO-Revision-Date: 2021-02-06 15:55+0100\n"
 "Last-Translator: Andras Voroskoi <voroskoi@frugalware.org>\n"
 "Language-Team: weechat-dev <weechat-dev@nongnu.org>\n"
@@ -4653,8 +4653,10 @@ msgid ""
 "var\") or a hdata variable of IRC channel (\"irc_channel.var\"); char \"-\" "
 "can be used before field to reverse order, char \"~\" can be used to do a "
 "case insensitive comparison; example: \"-~short_name\" for case insensitive "
-"and reverse sort on buffer short name (note: content is evaluated, only the "
-"pointer to bar_item can be used, for example \"bar_item.name\")"
+"and reverse sort on buffer short name (note: the content is evaluated, "
+"before being split into fields, but at that time \"bar_item\" is the only "
+"variable that can be used, to distinguish between different buflist items, "
+"for example \"${bar_item.name}\")"
 msgstr ""
 
 msgid ""
diff --git a/po/it.po b/po/it.po
index 984799c2d..2aa7e375c 100644
--- a/po/it.po
+++ b/po/it.po
@@ -20,7 +20,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: WeeChat\n"
 "Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
-"POT-Creation-Date: 2021-03-17 21:46+0100\n"
+"POT-Creation-Date: 2021-03-21 09:32+0100\n"
 "PO-Revision-Date: 2021-02-06 15:55+0100\n"
 "Last-Translator: Esteban I. Ruiz Moreno <exio4.com@gmail.com>\n"
 "Language-Team: weechat-dev <weechat-dev@nongnu.org>\n"
@@ -5452,8 +5452,10 @@ msgid ""
 "var\") or a hdata variable of IRC channel (\"irc_channel.var\"); char \"-\" "
 "can be used before field to reverse order, char \"~\" can be used to do a "
 "case insensitive comparison; example: \"-~short_name\" for case insensitive "
-"and reverse sort on buffer short name (note: content is evaluated, only the "
-"pointer to bar_item can be used, for example \"bar_item.name\")"
+"and reverse sort on buffer short name (note: the content is evaluated, "
+"before being split into fields, but at that time \"bar_item\" is the only "
+"variable that can be used, to distinguish between different buflist items, "
+"for example \"${bar_item.name}\")"
 msgstr ""
 
 msgid ""
diff --git a/po/ja.po b/po/ja.po
index 620da7a1d..0f89eaa67 100644
--- a/po/ja.po
+++ b/po/ja.po
@@ -20,7 +20,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: WeeChat\n"
 "Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
-"POT-Creation-Date: 2021-03-17 21:46+0100\n"
+"POT-Creation-Date: 2021-03-21 09:32+0100\n"
 "PO-Revision-Date: 2021-02-06 15:55+0100\n"
 "Last-Translator: AYANOKOUZI, Ryuunosuke <i38w7i3@yahoo.co.jp>\n"
 "Language-Team: Japanese <https://github.com/l/weechat/tree/master/"
@@ -5768,8 +5768,10 @@ msgid ""
 "var\") or a hdata variable of IRC channel (\"irc_channel.var\"); char \"-\" "
 "can be used before field to reverse order, char \"~\" can be used to do a "
 "case insensitive comparison; example: \"-~short_name\" for case insensitive "
-"and reverse sort on buffer short name (note: content is evaluated, only the "
-"pointer to bar_item can be used, for example \"bar_item.name\")"
+"and reverse sort on buffer short name (note: the content is evaluated, "
+"before being split into fields, but at that time \"bar_item\" is the only "
+"variable that can be used, to distinguish between different buflist items, "
+"for example \"${bar_item.name}\")"
 msgstr ""
 "バッファをソートする際に考慮するフィールドのコンマ区切りリスト; 各フィールド"
 "はバッファの hdata 変数 (\"var\")、IRC サーバの hdata 変数 (\"irc_server.var"
diff --git a/po/pl.po b/po/pl.po
index 97f8aedb0..62e7078f9 100644
--- a/po/pl.po
+++ b/po/pl.po
@@ -22,7 +22,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: WeeChat\n"
 "Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
-"POT-Creation-Date: 2021-03-17 21:46+0100\n"
+"POT-Creation-Date: 2021-03-21 09:32+0100\n"
 "PO-Revision-Date: 2021-03-14 13:37+0100\n"
 "Last-Translator: Krzysztof Korościk <soltys@soltys.info>\n"
 "Language-Team: Polish <kde-i18n-doc@kde.org>\n"
@@ -5928,14 +5928,17 @@ msgstr ""
 "ustawione są jakieś zmienne używane do formatowania wymagające odpowiedniego "
 "odświeżania"
 
+#, fuzzy
 msgid ""
 "comma-separated list of fields to sort buffers; each field is a hdata "
 "variable of buffer (\"var\"), a hdata variable of IRC server (\"irc_server."
 "var\") or a hdata variable of IRC channel (\"irc_channel.var\"); char \"-\" "
 "can be used before field to reverse order, char \"~\" can be used to do a "
 "case insensitive comparison; example: \"-~short_name\" for case insensitive "
-"and reverse sort on buffer short name (note: content is evaluated, only the "
-"pointer to bar_item can be used, for example \"bar_item.name\")"
+"and reverse sort on buffer short name (note: the content is evaluated, "
+"before being split into fields, but at that time \"bar_item\" is the only "
+"variable that can be used, to distinguish between different buflist items, "
+"for example \"${bar_item.name}\")"
 msgstr ""
 "oddzielona przecinkami lista pól do sortowania buforów; każde pole to "
 "zmienna hdata bufora (\"var\"), zmienna hdata serwera IRC (\"irc_server.var"
diff --git a/po/pt.po b/po/pt.po
index d1e0cfe02..f76a87949 100644
--- a/po/pt.po
+++ b/po/pt.po
@@ -20,7 +20,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: WeeChat\n"
 "Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
-"POT-Creation-Date: 2021-03-17 21:46+0100\n"
+"POT-Creation-Date: 2021-03-21 09:32+0100\n"
 "PO-Revision-Date: 2021-02-06 15:55+0100\n"
 "Last-Translator: Vasco Almeida <vascomalmeida@sapo.pt>\n"
 "Language-Team: Portuguese <>\n"
@@ -5719,8 +5719,10 @@ msgid ""
 "var\") or a hdata variable of IRC channel (\"irc_channel.var\"); char \"-\" "
 "can be used before field to reverse order, char \"~\" can be used to do a "
 "case insensitive comparison; example: \"-~short_name\" for case insensitive "
-"and reverse sort on buffer short name (note: content is evaluated, only the "
-"pointer to bar_item can be used, for example \"bar_item.name\")"
+"and reverse sort on buffer short name (note: the content is evaluated, "
+"before being split into fields, but at that time \"bar_item\" is the only "
+"variable that can be used, to distinguish between different buflist items, "
+"for example \"${bar_item.name}\")"
 msgstr ""
 
 msgid ""
diff --git a/po/pt_BR.po b/po/pt_BR.po
index edddfd862..97a5d8dde 100644
--- a/po/pt_BR.po
+++ b/po/pt_BR.po
@@ -21,7 +21,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: WeeChat\n"
 "Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
-"POT-Creation-Date: 2021-03-17 21:46+0100\n"
+"POT-Creation-Date: 2021-03-21 09:32+0100\n"
 "PO-Revision-Date: 2021-03-05 20:43+0100\n"
 "Last-Translator: Érico Nogueira <ericonr@disroot.org>\n"
 "Language-Team: weechat-dev <weechat-dev@nongnu.org>\n"
@@ -5268,8 +5268,10 @@ msgid ""
 "var\") or a hdata variable of IRC channel (\"irc_channel.var\"); char \"-\" "
 "can be used before field to reverse order, char \"~\" can be used to do a "
 "case insensitive comparison; example: \"-~short_name\" for case insensitive "
-"and reverse sort on buffer short name (note: content is evaluated, only the "
-"pointer to bar_item can be used, for example \"bar_item.name\")"
+"and reverse sort on buffer short name (note: the content is evaluated, "
+"before being split into fields, but at that time \"bar_item\" is the only "
+"variable that can be used, to distinguish between different buflist items, "
+"for example \"${bar_item.name}\")"
 msgstr ""
 
 msgid ""
diff --git a/po/ru.po b/po/ru.po
index 447a5557e..d9a5ac5cb 100644
--- a/po/ru.po
+++ b/po/ru.po
@@ -21,7 +21,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: WeeChat\n"
 "Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
-"POT-Creation-Date: 2021-03-17 21:46+0100\n"
+"POT-Creation-Date: 2021-03-21 09:32+0100\n"
 "PO-Revision-Date: 2021-02-06 15:55+0100\n"
 "Last-Translator: Aleksey V Zapparov AKA ixti <ixti@member.fsf.org>\n"
 "Language-Team: weechat-dev <weechat-dev@nongnu.org>\n"
@@ -4688,8 +4688,10 @@ msgid ""
 "var\") or a hdata variable of IRC channel (\"irc_channel.var\"); char \"-\" "
 "can be used before field to reverse order, char \"~\" can be used to do a "
 "case insensitive comparison; example: \"-~short_name\" for case insensitive "
-"and reverse sort on buffer short name (note: content is evaluated, only the "
-"pointer to bar_item can be used, for example \"bar_item.name\")"
+"and reverse sort on buffer short name (note: the content is evaluated, "
+"before being split into fields, but at that time \"bar_item\" is the only "
+"variable that can be used, to distinguish between different buflist items, "
+"for example \"${bar_item.name}\")"
 msgstr ""
 
 msgid ""
diff --git a/po/tr.po b/po/tr.po
index dd304eae9..c8d76ce84 100644
--- a/po/tr.po
+++ b/po/tr.po
@@ -20,7 +20,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: WeeChat\n"
 "Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
-"POT-Creation-Date: 2021-03-17 21:46+0100\n"
+"POT-Creation-Date: 2021-03-21 09:32+0100\n"
 "PO-Revision-Date: 2021-02-06 15:55+0100\n"
 "Last-Translator: Hasan Kiran <sunder67@hotmail.com>\n"
 "Language-Team: weechat-dev <weechat-dev@nongnu.org>\n"
@@ -4257,8 +4257,10 @@ msgid ""
 "var\") or a hdata variable of IRC channel (\"irc_channel.var\"); char \"-\" "
 "can be used before field to reverse order, char \"~\" can be used to do a "
 "case insensitive comparison; example: \"-~short_name\" for case insensitive "
-"and reverse sort on buffer short name (note: content is evaluated, only the "
-"pointer to bar_item can be used, for example \"bar_item.name\")"
+"and reverse sort on buffer short name (note: the content is evaluated, "
+"before being split into fields, but at that time \"bar_item\" is the only "
+"variable that can be used, to distinguish between different buflist items, "
+"for example \"${bar_item.name}\")"
 msgstr ""
 
 msgid ""
diff --git a/po/weechat.pot b/po/weechat.pot
index cf1717b4f..519d4cdb5 100644
--- a/po/weechat.pot
+++ b/po/weechat.pot
@@ -21,7 +21,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: WeeChat\n"
 "Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
-"POT-Creation-Date: 2021-03-17 21:46+0100\n"
+"POT-Creation-Date: 2021-03-21 09:32+0100\n"
 "PO-Revision-Date: 2014-08-16 10:27+0200\n"
 "Last-Translator: Sébastien Helleu <flashcode@flashtux.org>\n"
 "Language-Team: weechat-dev <weechat-dev@nongnu.org>\n"
@@ -4240,8 +4240,10 @@ msgid ""
 "var\") or a hdata variable of IRC channel (\"irc_channel.var\"); char \"-\" "
 "can be used before field to reverse order, char \"~\" can be used to do a "
 "case insensitive comparison; example: \"-~short_name\" for case insensitive "
-"and reverse sort on buffer short name (note: content is evaluated, only the "
-"pointer to bar_item can be used, for example \"bar_item.name\")"
+"and reverse sort on buffer short name (note: the content is evaluated, "
+"before being split into fields, but at that time \"bar_item\" is the only "
+"variable that can be used, to distinguish between different buflist items, "
+"for example \"${bar_item.name}\")"
 msgstr ""
 
 msgid ""
diff --git a/src/plugins/buflist/buflist-config.c b/src/plugins/buflist/buflist-config.c
index 0e30d4c37..ffd9a1877 100644
--- a/src/plugins/buflist/buflist-config.c
+++ b/src/plugins/buflist/buflist-config.c
@@ -598,8 +598,10 @@ buflist_config_init ()
            "char \"~\" can be used to do a case insensitive comparison; "
            "example: \"-~short_name\" for case insensitive and reverse "
            "sort on buffer short name "
-           "(note: content is evaluated, only the pointer to bar_item can be "
-           "used, for example \"bar_item.name\")"),
+           "(note: the content is evaluated, before being split into fields, "
+           "but at that time \"bar_item\" is the only variable that can be "
+           "used, to distinguish between different buflist items, for example "
+           "\"${bar_item.name}\")"),
         NULL, 0, 0, "number,-active", NULL, 0,
         NULL, NULL, NULL,
         &buflist_config_change_sort, NULL, NULL,