diff --git a/tools/chatgui/src/emojitabbar.h b/tools/chatgui/src/emojitabbar.h
index 353fdfce4..601e01049 100644
--- a/tools/chatgui/src/emojitabbar.h
+++ b/tools/chatgui/src/emojitabbar.h
@@ -1,4 +1,5 @@
-/* Отрисовка вкладок категорий EmojiPanel с собственным стилем выбранной вкладки. */
+/* GUI-вкладки категорий EmojiPanel: обработка выбора/геометрия остаются у QTabBar, рисование текста/подчёркивания — здесь.
+ * Используется QTabWidget::setTabBar; собственные цвета фиксированы (белый/синий/серый), не зависят от palette. */
 #pragma once
 
 #include <QTabBar>
@@ -6,8 +7,11 @@
 class EmojiTabBar : public QTabBar {
     Q_OBJECT
 public:
+    /* parent владеет виджетом; отключает стандартную базовую линию, растяжение вкладок и кнопки прокрутки. */
     explicit EmojiTabBar(QWidget *parent = nullptr);
 
 protected:
+    /* Полностью рисует bar по tabRect/tabText/currentIndex: текст, синее подчёркивание и нижний разделитель.
+     * event не используется, базовый paintEvent не вызывается; значки/close-кнопки в этой отрисовке не поддерживаются. */
     void paintEvent(QPaintEvent *event) override;
 };