Skip to content

Fix doc inaccuracies: VT byte 23 event and kitty setup#6

Merged
alganet merged 1 commit into
mainfrom
docs-fix
Jun 13, 2026
Merged

Fix doc inaccuracies: VT byte 23 event and kitty setup#6
alganet merged 1 commit into
mainfrom
docs-fix

Conversation

@alganet

@alganet alganet commented Jun 13, 2026

Copy link
Copy Markdown
Owner

docs/hid.md claimed VT byte 23 (ETB / Ctrl+W) maps to ctrl-bksp, in both the byte→event table and the Control Byte Collisions table. The VT code keeps the Ctrl+letter identity and emits ctrl-w (hid.sh: 1..26 → ctrl-<letter+96>); the ctrl-bksp remap for byte 23 exists only in kitty "func" mode (hid.sh:389). Correct both rows to ctrl-w and reword the prose to explain that on terminals which send 23 for Ctrl+Backspace it also surfaces as ctrl-w in VT, and to use the kitty protocol to disambiguate. Verified: _tuish_resolve_event "E 23" → ctrl-w, "E 8" → ctrl-bksp.

docs/tui.md listed the kitty keyboard (ESC[>9u) in the "configured at startup" table, but tuish_init never sends it and TUISH_PROTOCOL defaults to vt. Remove that row and add a note that kitty mode is opt-in via tuish_kitty_on (probed, with VT fallback) and restored by tuish_kitty_off / tuish_fini.

docs/hid.md claimed VT byte 23 (ETB / Ctrl+W) maps to `ctrl-bksp`, in
both the byte→event table and the Control Byte Collisions table. The VT
code keeps the Ctrl+letter identity and emits `ctrl-w` (hid.sh: 1..26 →
ctrl-<letter+96>); the `ctrl-bksp` remap for byte 23 exists only in kitty
"func" mode (hid.sh:389). Correct both rows to `ctrl-w` and reword the
prose to explain that on terminals which send 23 for Ctrl+Backspace it
also surfaces as `ctrl-w` in VT, and to use the kitty protocol to
disambiguate. Verified: _tuish_resolve_event "E 23" → ctrl-w, "E 8" →
ctrl-bksp.

docs/tui.md listed the kitty keyboard (ESC[>9u) in the "configured at
startup" table, but tuish_init never sends it and TUISH_PROTOCOL defaults
to vt. Remove that row and add a note that kitty mode is opt-in via
tuish_kitty_on (probed, with VT fallback) and restored by
tuish_kitty_off / tuish_fini.
@alganet
alganet merged commit 03ae7d7 into main Jun 13, 2026
19 of 20 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant