From 5f45abd311716de730817e724c6ac345be3b98a0 Mon Sep 17 00:00:00 2001
From: Delice0 <59118341+Delice0@users.noreply.github.com>
Date: Fri, 26 Dec 2025 14:28:02 +0100
Subject: [PATCH] Document pixel scrolling option

---
 docs/overview.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/overview.rst b/docs/overview.rst
index be315b8d5..f30e40c75 100644
--- a/docs/overview.rst
+++ b/docs/overview.rst
@@ -206,6 +206,14 @@ displays an interactive :opt:`scrollbar` along the right edge
 of the window that shows your current position in the scrollback. You can click
 and drag the scrollbar to quickly navigate through the history.
 
+If you use a high‑precision input device such as a touchpad, you can enable
+smooth, per‑pixel scrollback with :opt:`pixel_scroll`. For example, add this to
+your :file:`kitty.conf`::
+
+   pixel_scroll yes
+
+You can further tune the sensitivity with :opt:`touch_scroll_multiplier`.
+
 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
 while typing in a follow-up command. |kitty| allows you to do this by pressing