ayo/kitty
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add note about width test kitten

Browse source
This commit is contained in:
Kovid Goyal 2025-04-11 11:24:19 +05:30
parent 3a4d32b85b
commit 85c177bcb1
No known key found for this signature in database
GPG key ID: 06BC317B515ACE7C
1 changed files with 7 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
docs/text-sizing-protocol.rst
View file

@ -351,9 +351,8 @@ The algorithm for splitting text into cells
------------------------------------------------
.. note::
Notation: :code:`[start, stop, step]` means the integeres from :code:`start`
to :code:`stop` in increments of :code:`step`. When the step is not
specified, it defaults to one.
kitty comes with a utility to test terminal compliance with this algorithm.
Install kitty and run: ``kitten __width_test__`` in any terminal to test it.
Here, we specify how a terminal must split up text into cells, where a cell is
a width one unit in the character grid the terminal displays.
@ -405,6 +404,11 @@ It remains to specify how to calculate the width in cells of a Unicode
character. To do this, characters are divided into various classes, as
described by the rules below, in order of decreasing priority:
.. note::
Notation: :code:`[start, stop, step]` means the integeres from :code:`start`
to :code:`stop` in increments of :code:`step`. When the step is not
specified, it defaults to one.
#. Regional indicators: 26 characters starting at :code:`0x1F1E6`. These all
have width 2