doc: add question about buflist customization

1 files changed, 28 insertions, 0 deletions

diff --git a/doc/en/weechat_faq.en.adoc b/doc/en/weechat_faq.en.adoc
index f0b2ef0e6..0ac901d2c 100644
--- a/doc/en/weechat_faq.en.adoc
+++ b/doc/en/weechat_faq.en.adoc
@@ -227,6 +227,34 @@ For example to use kbd:[F1], kbd:[F2], kbd:[Alt+F1] and kbd:[Alt+F2]:
 Keys "meta-OP" and "meta-OQ" may be different in your terminal. To find key
 code press kbd:[Alt+k] then key.
 
+[[customize_buflist]]
+=== How can I customize the list of buffers list, like the color of the active buffer?
+
+You can browse all buflist options with the command:
+
+----
+/fset buflist
+----
+
+The background of the active buffer is blue by default, you can change it
+like this, for example to `red`:
+
+----
+/set buflist.format.buffer_current "${color:,red}${format_buffer}"
+----
+
+[NOTE]
+There's a comma before the color name "red" because it is used as the background,
+not the text color. +
+You can also use any numeric color instead of `red`,
+like `237` for dark gray.
+
+The buflist plugin provides lot of options that you can customize, please read
+the help on each option.
+
+There's also a wiki page with examples of advanced buflist configuration:
+https://github.com/weechat/weechat/wiki/buflist
+
 [[customize_prefix]]
 === How can I reduce length of nicks or remove nick alignment in chat area?