From d1ae17a8e01e69a6bcb61be31b0d0a4ca4285618 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Helleu?= <flashcode@flashtux.org>
Date: Sun, 26 May 2024 14:37:48 +0200
Subject: [PATCH] core: add note about lag in buflist in upgrade guidelines

---
 UPGRADING.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/UPGRADING.md b/UPGRADING.md
index 1cc8743d6..77ee1352e 100644
--- a/UPGRADING.md
+++ b/UPGRADING.md
@@ -14,6 +14,21 @@ The following relay options have been renamed:
 - relay.color.status_waiting_auth → relay.color.status_authenticating
 - relay.weechat.commands → relay.network.commands (new default value: `*,!quit`)
 
+### Lag in buflist
+
+The lag is now stored in all IRC buffers: server (like it always has been),
+channels and private buffers.
+
+Consequently, if you use `${format_lag}` in buflist options, this lag will be
+displayed on server and all channels and private buffers.
+
+If you want to display the lag only on server buffer in buflist, you can use
+such format:
+
+```text
+${if:${type}==server?${format_lag}}
+```
+
 ### Color of IRC channel modes
 
 The option `irc.color.item_channel_modes` has been moved to core and renamed to