Identify SS3 in the docs

This commit is contained in:
Kovid Goyal 2021-01-12 14:35:36 +05:30
parent 7ba57ebf62
commit e06b48a344
No known key found for this signature in database
GPG Key ID: 06BC317B515ACE7C

View File

@ -235,13 +235,13 @@ These keys are encoded using three schemes::
CSI number ; modifier ~ CSI number ; modifier ~
CSI 1 ; modifier {ABCDFHPQRS} CSI 1 ; modifier {ABCDFHPQRS}
ESC O {ABCDFHPQRS} SS3 {ABCDFHPQRS}
In the above, if there are no modifiers, the modifier parameter is omitted. In the above, if there are no modifiers, the modifier parameter is omitted.
The modifier value is encoded as described in the :ref:`modifiers` section, The modifier value is encoded as described in the :ref:`modifiers` section,
above. When the second form is used, the number is always ``1`` and must be above. When the second form is used, the number is always ``1`` and must be
omitted if the modifiers field is also absent. The third form becomes the omitted if the modifiers field is also absent. The third form becomes the
second form when modifiers are present. second form when modifiers are present (``SS3 is the bytes 0x1b 0x4f``).
These sequences must match entries in the terminfo database for maximum These sequences must match entries in the terminfo database for maximum
compatibility. The table below lists the key, its terminfo entry name and compatibility. The table below lists the key, its terminfo entry name and
@ -428,7 +428,7 @@ Bugs in fixterms
* No way to disambiguate :kbd:`Esc` keypresses, other than using 8-bit controls * No way to disambiguate :kbd:`Esc` keypresses, other than using 8-bit controls
which are undesirable for other reasons which are undesirable for other reasons
* Incorrectly claims special keys are sometimes encoded using ``CSI letter`` encodings when it * Incorrectly claims special keys are sometimes encoded using ``CSI letter`` encodings when it
is actually ``ESC O letter``. is actually ``SS3 letter``.
* ``Enter`` and ``F3`` are both assigned the number 13. * ``Enter`` and ``F3`` are both assigned the number 13.
* :kbd:`ctrl+shift+tab`` should be ``CSI 9 ; 6 u`` not ``CSI 1 ; 5 Z`` * :kbd:`ctrl+shift+tab`` should be ``CSI 9 ; 6 u`` not ``CSI 1 ; 5 Z``
(shift+tab is not a separate key from tab) (shift+tab is not a separate key from tab)