buflist: add variable "${hotlist_priority_number}" (integer version of "${hotlist_priority}")

1 files changed, 38 insertions, 37 deletions

diff --git a/doc/sr/includes/autogen_user_commands.sr.adoc b/doc/sr/includes/autogen_user_commands.sr.adoc
index 54a861984..6078b9206 100644
--- a/doc/sr/includes/autogen_user_commands.sr.adoc
+++ b/doc/sr/includes/autogen_user_commands.sr.adoc
@@ -2285,51 +2285,52 @@ scroll_unread: скролује на непрочитани маркер
           bar
           refresh
 
- enable: укључује buflist
-disable: искључује buflist
- toggle: пребацује buflist
-    bar: додаје „buflist” траку
-refresh: форсира освежавање ставки траке (buflist, buflist2 и buflist3)
-
-Линије са баферима се приказују употребом израчунавања стринга (погледајте /help eval за формат), са следећим опцијама:
-  - buflist.look.display_conditions: услови под којима се бафер приказује у листи
-  - buflist.format.buffer: формат за бафер који није текући бафер
-  - buflist.format.buffer_current: формат за текући бафер
-
-У овим опцијама је могуће коришћење следећих променљивих:
-  - подаци ставке траке (погледајте hdata „bar_item” у документацији API за комплетну листу), на пример:
+ enable: enable buflist
+disable: disable buflist
+ toggle: toggle buflist
+    bar: add the "buflist" bar
+refresh: force the refresh of the bar items (buflist, buflist2 and buflist3)
+
+The lines with buffers are displayed using string evaluation (see /help eval for the format), with these options:
+  - buflist.look.display_conditions: conditions to display a buffer in the list
+  - buflist.format.buffer: format for a buffer which is not current buffer
+  - buflist.format.buffer_current: format for the current buffer
+
+The following variables can be used in these options:
+  - bar item data (see hdata "bar_item" in API doc for a complete list), for example:
     - ${bar_item.name}
-  - подаци о прозору, у коме се трака приказује (не постоји прозор у кореним тракама, погледајте hdata „window” у документацији API за комплетну листу), на пример:
+  - window data, where the bar item is displayed (there's no window in root bars, see hdata "window" in API doc for a complete list), for example:
     - ${window.number}
     - ${window.buffer.full_name}
-  - подаци о баферу (погледајте hdata „buffer” у API доку за комплетну листу), на пример:
+  - buffer data (see hdata "buffer" in API doc for a complete list), for example:
     - ${buffer.number}
     - ${buffer.name}
     - ${buffer.full_name}
     - ${buffer.short_name}
     - ${buffer.nicklist_nicks_count}
-  - irc_server: подаци о IRC серверу, дефинисани су само за IRC бафер (погледајте hdata „irc_server” у документацији API)
-  - irc_channel: подаци о IRC каналу, дефинисани су само за бафер IRC канала (погледајте hdata „irc_channel” у документацији API)
-  - buflist додаје још неке променљиве како би се олакшала употреба:
-    - ${format_buffer}: израчуната вредност опције buflist.format.buffer; ово може да се користи у опцији buflist.format.buffer_current да би се, на пример, променила само боја позадине
-    - ${current_buffer}: логичка вредност („0” или „1”), „1” ако је ово текући бафер; може да се користи у услову: ${if:${current_buffer}?...:...}
-    - ${merged}: логичка вредност („0” или „1”), „1” ако је бафер спојен са барем још једним другим бафером; може да се користи у услову: ${if:${merged}?...:...}
-    - ${format_number}: увучени број са граничником (израчуната вредност опције buflist.format.number)
-    - ${number}: увучени број, на пример „1” ако постоји између 10 и 99 бафера; заспојене бафере, ова променљива се поставља на број првог бафера и размаке за наредне бафере са под истим бројем
-    - ${number2}: увучени број, на пример „ 1” ако постоји између 10 и 99 бафера
-    - ${number_displayed}: „1” ако се број приказује, у супротном „0”
-    - ${indent}: увлачење за име (бафери канала и приватни бафери се увлаче) (израчуната вредност опције buflist.format.indent)
-    - ${format_nick_prefix}: обојени префикс надимка за канал (израчуната вредност опције buflist.format.nick_prefix)
-    - ${color_nick_prefix}: боја префикса надимка за канал (постављена је само ако је опција buflist.look.nick_prefix укључена)
-    - ${nick_prefix}: префикс надимка за канал (постављена је само ако је опција buflist.look.nick_prefix укључена)
-    - ${format_name}: форматирано име (израчуната вредност опције buflist.format.name)
-    - ${name}: кратко име (ако је постављено), има вредност имена ако није постављено
-    - ${color_hotlist}: боја која зависи ид највишег нивоа бафера у врућој листи (израчуната вредност опције buflist.format.hotlist_xxx где је xxx ниво)
-    - ${format_hotlist}: форматирана врућа листа (израчуната вредност опције buflist.format.hotlist)
-    - ${hotlist}: сирова врућа листа
-    - ${hotlist_priority}: „none”, „low”, „message”, „private” или „highlight”
-    - ${format_lag}: кашњење за бафер IRC сервера, празна у случају да нема кашњења (израчуната вредност опције buflist.format.lag)
-    - ${format_tls_version}: индикатор TLS верзије за серверски бафер, празно за канале (резултат израчунавања опције buflist.format.tls_version)
+  - irc_server: IRC server data, defined only on an IRC buffer (see hdata "irc_server" in API doc)
+  - irc_channel: IRC channel data, defined only on an IRC channel buffer (see hdata "irc_channel" in API doc)
+  - extra variables added by buflist for convenience:
+    - ${format_buffer}: the evaluated value of option buflist.format.buffer; this can be used in option buflist.format.buffer_current to just change the background color for example
+    - ${current_buffer}: a boolean ("0" or "1"), "1" if this is the current buffer; it can be used in a condition: ${if:${current_buffer}?...:...}
+    - ${merged}: a boolean ("0" or "1"), "1" if the buffer is merged with at least another buffer; it can be used in a condition: ${if:${merged}?...:...}
+    - ${format_number}: indented number with separator (evaluation of option buflist.format.number)
+    - ${number}: indented number, for example " 1" if there are between 10 and 99 buffers; for merged buffers, this variable is set with number for the first buffer and spaces for the next buffers with same number
+    - ${number2}: indented number, for example " 1" if there are between 10 and 99 buffers
+    - ${number_displayed}: "1" if the number is displayed, otherwise "0"
+    - ${indent}: indentation for name (channel and private buffers are indented) (evaluation of option buflist.format.indent)
+    - ${format_nick_prefix}: colored nick prefix for a channel (evaluation of option buflist.format.nick_prefix)
+    - ${color_nick_prefix}: color of nick prefix for a channel (set only if the option buflist.look.nick_prefix is enabled)
+    - ${nick_prefix}: nick prefix for a channel (set only if the option buflist.look.nick_prefix is enabled)
+    - ${format_name}: formatted name (evaluation of option buflist.format.name)
+    - ${name}: the short name (if set), with a fallback on the name
+    - ${color_hotlist}: the color depending on the highest hotlist level for the buffer (evaluation of option buflist.format.hotlist_xxx where xxx is the level)
+    - ${format_hotlist}: the formatted hotlist (evaluation of option buflist.format.hotlist)
+    - ${hotlist}: the raw hotlist
+    - ${hotlist_priority}: "none", "low", "message", "private" or "highlight"
+    - ${hotlist_priority_number}: -1 = none, 0 = low, 1 = message, 2 = private, 3 = highlight
+    - ${format_lag}: the lag for an IRC server buffer, empty if there's no lag (evaluation of option buflist.format.lag)
+    - ${format_tls_version}: indicator of TLS version for a server buffer, empty for channels (evaluation of option buflist.format.tls_version)
 ----
 // end::buflist_commands[]