Document Esc and Ctrl bracket mode exits

2026-06-21 22:29:20 +02:00
parent 2e60a0961c
commit d5c31a92c5
4 changed files with 23 additions and 5 deletions
@@ -121,14 +121,18 @@ selection entry, leader rails, tool commands, save/quit, and recoverability.
 Text-entry mode for ordinary typing. `mim` starts in Normal mode; Insert mode is
 entered explicitly with `i`, `a`, `o`, or another visible command. In Insert mode,
 `Space` commits a literal space immediately and `Tab` inserts spaces by default
-(expandtab, matching the dotfiles Neovim baseline). Physical keyboards may use
-conventional direct keys such as Escape as aliases back to Normal, but those
-aliases are optional accelerators, not required controls.
+(expandtab, matching the dotfiles Neovim baseline). Escape returns to Normal;
+Ctrl-[ is the same terminal byte and is documented as the Ctrl-capable SSH alias.
+This preserves ordinary spaces and avoids reviving a Space-prefix escape chord.
+If a client exposes neither Esc nor Ctrl-[, it is missing the mobile SSH
+accelerator tier required for safe Insert-mode recovery; use the client's Esc
+toolbar or an attached-keyboard path rather than overloading literal text input.

 ### Select mode

-Selection-building mode. Movement extends the active selection by default.
-Vertical movement preserves a preferred cursor column across ragged lines,
+Selection-building mode. Escape or Ctrl-[ returns to Normal. Movement extends the
+active selection by default. Vertical movement preserves a preferred cursor
+column across ragged lines,
 clamping only to the current line length until horizontal/editing motion resets
 that preference. Semantic object selections live behind the match/object rail
 (`m w`, `m l`, `m i`, `m p`, etc.) so bare `h/j/k/l`, word motions, arrows, and