normal Esc toggles document/terminal focus

1 files changed, 7 insertions, 2 deletions

diff --git a/src/tutor.txt b/src/tutor.txt
index 71a8fabb..6721e9e8 100644
--- a/src/tutor.txt
+++ b/src/tutor.txt
@@ -225,7 +225,9 @@
    TTY     ($)  the REAL shell — prompts + typed input shown, and keys
                 go straight to the pty as terminal input.
 
- ESC:    insert -> normal.  (A plain Esc never reaches tty.)
+ ESC:    insert -> normal; from body NORMAL it hops between the last
+         document and last terminal (the same Toggleterm as SPC w t).
+         In raw TTY it still goes to the program.
  Ctrl-b: toggles TTY on a terminal by default; SHIFT-ESC is the same
          toggle, where the host reports modifiers on Escape. Those are
          the ONLY ways in or out.
@@ -490,6 +492,8 @@
    Ctrl-w h/j/k/l   focus the pane left/down/up/right (SPC w h/j/k/l
                     does the same; Ctrl-w also reaches a tty pane,
                     where SPC belongs to the shell)
+   Esc              hop between the last document and last terminal
+                    (body normal mode; the same builtin as SPC w t)
    Alt-n            new terminal below the active one
    Alt-c            move the active terminal into a fresh column
 
@@ -554,12 +558,13 @@
                     the selection; the mode+path selects but never edits;
                     k off the TOPMOST tagline = the top bar, j back down)
                 zt zz zb  Ctrl-d/u  Ctrl-f  Ctrl-w hjkl  Alt-n/c
+                Esc = last document <-> last terminal (body normal)
                 SPC = the leader: a key path runs a builtin (SPC ? lists
                 them; SPC k Kill, SPC d Del, SPC f s Save, SPC f f Find,
                 SPC w hjkl focus, SPC w t file <-> terminal)
 
  vs Helix: no multi-cursor; selection is LINE-first (x), plus v chars.
- vs Vim:  no verb+noun (dw); motions only move; Esc never reaches tty.
+ vs Vim:  no verb+noun (dw); motions only move; body-normal Esc hops focus.
  vs both: a terminal is just a pane; the same keys edit text and
           navigate the shell screen, and the tty toggle reuses the
           shell's own prompt to position you precisely.