From 142307d4cd091311104b951a18269b7c01c62dd5 Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Thu, 4 Sep 2025 22:02:04 +0530 Subject: [PATCH] Add some footnotes explaining what features native cursors have --- docs/multiple-cursors-protocol.rst | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/docs/multiple-cursors-protocol.rst b/docs/multiple-cursors-protocol.rst index 5c457fff9..59a7984ee 100644 --- a/docs/multiple-cursors-protocol.rst +++ b/docs/multiple-cursors-protocol.rst @@ -12,8 +12,8 @@ the same changes at multiple locations in a file and the editor shows you cursors at each of the locations. In a terminal context editors typically implement this by showing some Unicode glyph at each location instead of the actual cursor. This is sub-optimal since actual cursors implemented by the -terminal have many niceties like smooth animation, auto adjust colors, etc. To -address this and other use cases, this protocol allows terminal programs to +terminal have many niceties like smooth animation [anim]_, auto adjust colors [rv]_, +etc. To address this and other use cases, this protocol allows terminal programs to request that the terminal display multiple cursors at specific locations on the screen. @@ -236,3 +236,16 @@ Interaction with other terminal controls and state ephemeral and on screen only, not in scrollback. This allows terminals to avoid the extra overhead of adjusting positions of the extra cursors on every scroll. + + +Footnotes +------------- + +.. [anim] kitty allows the cursor blink to be :opt:`animated + ` using any CSS easing function. This cannot be + implemented using fake cursors. + +.. [rv] kitty has a special "reverse video" color mode for cursors where the + color of the cursor and the text under the cursor is adjusted based on the + color of the cell under the cursor. This also cannot be implemented using + fake cursors.