core: add syntax "@buffer:item" in bar items to force the buffer used when displaying the bar item (task #12717)

2 files changed, 23 insertions, 0 deletions

diff --git a/doc/ja/autogen/plugin_api/hdata.txt b/doc/ja/autogen/plugin_api/hdata.txt
index 135cc2b21..9d4542e8e 100644
--- a/doc/ja/autogen/plugin_api/hdata.txt
+++ b/doc/ja/autogen/plugin_api/hdata.txt
@@ -426,6 +426,7 @@
   'items_count' (integer) +
   'items_subcount' (pointer) +
   'items_array' (pointer) +
+  'items_buffer' (pointer) +
   'items_prefix' (pointer) +
   'items_name' (pointer) +
   'items_suffix' (pointer) +
diff --git a/doc/ja/weechat_user.ja.txt b/doc/ja/weechat_user.ja.txt
index 0b60c9ff7..a438db5ea 100644
--- a/doc/ja/weechat_user.ja.txt
+++ b/doc/ja/weechat_user.ja.txt
@@ -719,6 +719,11 @@ WeeChat を起動したターミナルの例:
 
 バーアイテムのリストは `/bar listitems` コマンドで表示されます。
 
+// TRANSLATION MISSING
+Before or after item name, you can use chars (that are not alphanumeric, "-" or
+"_"). They will be displayed before/after item with the delimiters color
+defined in bar (option 'color_delim').
+
 アイテムを含むバーの例 "[time],buffer_number+:+buffer_plugin+.+buffer_name":
 
 ........................................
@@ -727,6 +732,23 @@ WeeChat を起動したターミナルの例:
 └─────────────────────────────────────────────────────────────────────────────────────────┘
 ........................................
 
+// TRANSLATION MISSING
+A special syntax can be used to force the buffer used when displaying the bar
+item: "@buffer:item" (where "buffer" is the full name of buffer and "item" is
+the name of a bar item).
+
+// TRANSLATION MISSING
+This is useful in root bars, to display item for a specific buffer which is
+not displayed in the current window (or even not displayed at all).
+
+// TRANSLATION MISSING
+Example: nicklist of bitlbee in a root bar (if the bar is called
+'bitlist' and if bitlbee server is called 'bitlbee'):
+
+----------------------------------------
+/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist"
+----------------------------------------
+
 [[bar_filling]]
 ==== フィリング ====