From 1a185e7027349271fef1ff3975789bc36bbf9372 Mon Sep 17 00:00:00 2001
From: Kovid Goyal <kovid@kovidgoyal.net>
Date: Thu, 26 Feb 2026 19:11:00 +0530
Subject: [PATCH] ...

---
 kitty/options/definition.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/kitty/options/definition.py b/kitty/options/definition.py
index abf9ed0a9..0c24ca30a 100644
--- a/kitty/options/definition.py
+++ b/kitty/options/definition.py
@@ -1462,7 +1462,9 @@ opt('window_drag_tolerance', '2', option_type='float', ctype='double', long_text
 Control dragging window borders to resize kitty windows. This is the tolerance in pts
 for the region around window borders where pressing the left mouse button
 will start the dragging of window borders. Use a large negative value such as -200 to disable
-dragging of borders.
+dragging of borders. Note that because kitty uses layouts, dragging borders does not
+actually resize the window itself, but instead, the layout row/column/slot, which can result
+in multiple windows getting resized.
 ''')
 egr()  # }}}