From 63fcebd285e283b8250bd9a6dd67eb393cd5b599 Mon Sep 17 00:00:00 2001
From: Delice0 <59118341+Delice0@users.noreply.github.com>
Date: Fri, 26 Dec 2025 19:32:58 +0100
Subject: [PATCH] Clarify pixel_scroll scrollback scope

---
 docs/overview.rst           | 4 +++-
 kitty/options/definition.py | 5 +++--
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/docs/overview.rst b/docs/overview.rst
index f30e40c75..4cdf1f09e 100644
--- a/docs/overview.rst
+++ b/docs/overview.rst
@@ -212,7 +212,9 @@ your :file:`kitty.conf`::
 
    pixel_scroll yes
 
-You can further tune the sensitivity with :opt:`touch_scroll_multiplier`.
+You can further tune the sensitivity with :opt:`touch_scroll_multiplier`. Note
+that this only affects scrolling kitty's own scrollback, not applications
+running inside the terminal that handle their own scrolling.
 
 However, |kitty| has an extra, neat feature. Sometimes you need to explore the scrollback
 buffer in more detail, maybe search for some text or refer to it side-by-side
diff --git a/kitty/options/definition.py b/kitty/options/definition.py
index 6061dc997..1ae9ac9b0 100644
--- a/kitty/options/definition.py
+++ b/kitty/options/definition.py
@@ -593,8 +593,9 @@ opt('pixel_scroll', 'no',
     option_type='to_bool', ctype='bool',
     long_text='''
 Enable per-pixel scrolling for high precision input devices (for example
-touchpads). When enabled, scrollback can move by sub-line increments instead of
-only whole lines.
+touchpads). When enabled, kitty's own scrollback can move by sub-line increments
+instead of only whole lines. This does not affect applications running inside
+the terminal (for example full-screen TUIs) that handle scrolling themselves.
 '''
     )
 egr()  # }}}