diff options
| author | blasty <blasty@local> | 2026-07-25 20:19:34 +0200 |
|---|---|---|
| committer | blasty <blasty@local> | 2026-07-25 20:19:34 +0200 |
| commit | baf599e143dbf23f33886ba03a60c5d9f3c19078 (patch) | |
| tree | e6d9193f66ea8ef69ee4c65dd6e4ca67efce07d2 /docs | |
| parent | nav: tell the user something is happening when Esc needs a decompile (diff) | |
| download | ida-tui-baf599e143dbf23f33886ba03a60c5d9f3c19078.tar.gz ida-tui-baf599e143dbf23f33886ba03a60c5d9f3c19078.tar.xz ida-tui-baf599e143dbf23f33886ba03a60c5d9f3c19078.zip | |
nav: bind back to backspace as well — a bare Esc isn't reliable in a terminal
Esc-to-go-back needed two presses. It looked like the decomp pane was swallowing
the first one, but the RPC state dump before/after a single Esc settles it:
nav_depth 3 -> 3 action_back never ran
cursor.col 19 -> 20 +1 column, i.e. `right`
modal null nothing was up to eat the key
The keypress arrived as a right-arrow. \x1b is both Escape and the lead byte of
every arrow/function-key sequence (ESC [ C is right), so a terminal or tmux that
merges a lone Esc with what follows delivers something else entirely. Nothing in
the nav path touches cursor_x and there is no widget-level escape binding on the
code views, so this was never application logic — I spent two commits looking in
the wrong place before asking for the dump.
Bind back to "escape,backspace". Backspace is unambiguous, so going back never
depends on a byte the terminal can reinterpret; Esc still works wherever it's
delivered intact. tmux users generally want `set -sg escape-time 10` regardless.
docs/TEXTUAL_NOTES.md records the symptom and, more usefully, the triage: check
nav_depth in the state dump first — if the action never ran, it's the input
layer, not the logic.
Verified: backspace in the pseudocode pane takes nav 3 -> 2 and reloads the
previous function. Suite 192/0.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/TEXTUAL_NOTES.md | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/docs/TEXTUAL_NOTES.md b/docs/TEXTUAL_NOTES.md index 4bf7fcb..6f486ce 100644 --- a/docs/TEXTUAL_NOTES.md +++ b/docs/TEXTUAL_NOTES.md @@ -80,3 +80,31 @@ Hard-won Textual behaviour and the patterns this app relies on. Pairs with failures. Re-run on a warm session before trusting a regression. - Edits mutate the `.i64` — revert renames (via API) for idempotency; use a PID-unique temp name to dodge collisions from a prior crashed run. + + +## A bare Esc is ambiguous in a terminal + +Symptom: `Esc` (bound to history-back) appears to do nothing, and only a *second* +press works. It looks like a widget is swallowing the first one. + +It isn't. `\x1b` is both the Escape key AND the lead byte of every arrow / +function-key sequence (`ESC [ C` is right-arrow). If the terminal or tmux merges +a lone Esc with what follows, the app receives a different key entirely. + +Confirmed on a live session via the RPC `state` dump, before and after one Esc: + + nav_depth 3 -> 3 (action_back never ran) + cursor.col 19 -> 20 (+1 column == `right`) + +The keypress arrived as a right-arrow. Nothing in the nav path touches +`cursor_x`, and `modal` was null, so no widget-level binding was involved. + +Two consequences: + +* Don't debug this in application code. Check `nav_depth` in the state dump + first: if the action didn't run at all, it's the input layer, not the logic. +* tmux's `escape-time` (default 500ms) is the usual culprit; `set -sg + escape-time 10` normally fixes it. + +`back` is therefore bound to `escape,backspace`. Backspace is unambiguous, so +history navigation never depends on a byte the terminal can reinterpret. |
