From 5d5bbe9b96821a38b4f9ab44f15e38d5ac3f8f99 Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Sun, 15 Oct 2023 21:59:04 +0530 Subject: [PATCH] Add a paragraph on legacy xterm compat for pointer shapes --- docs/pointer-shapes.rst | 12 ++++++++++++ kitty_tests/screen.py | 2 ++ 2 files changed, 14 insertions(+) diff --git a/docs/pointer-shapes.rst b/docs/pointer-shapes.rst index b751d86a3..20b95148c 100644 --- a/docs/pointer-shapes.rst +++ b/docs/pointer-shapes.rst @@ -149,3 +149,15 @@ characters from the set ``a-z0-9_-``. #. zoom-out .. end list of shape css names + + +Legacy xterm compatibility +---------------------------- + +The original xterm proposal for this escape code used shape names from the +file:`X11/cursorfont.h` header on X11 based systems. Terminal implementations +wishing to maintain compatibility with xterm can also implement these names as +aliases for the CSS based names defined in the :ref:`pointer_shape_names` table. + +The simplest mode of operation of this escape code, which is no leading +optional char and a single shape name is compatible with xterm. diff --git a/kitty_tests/screen.py b/kitty_tests/screen.py index d9ac8d67a..541e56f65 100644 --- a/kitty_tests/screen.py +++ b/kitty_tests/screen.py @@ -1212,3 +1212,5 @@ class TestScreen(BaseTest): t('>default,help', 'help') t('<', 'default') t('<', '0') + t('=left_ptr', 'default') + t('=fleur', 'move')