The guide walks a newcomer through pardes day to day, and the cheatsheet says what Esc and Shift-Esc really do

Co-Authored-By: Claude Opus 5.5 <[email protected]>

1 files changed, 6 insertions, 8 deletions

diff --git a/docs/typ/cheatsheet.typ b/docs/typ/cheatsheet.typ
index d9c3f573..5069614a 100644
--- a/docs/typ/cheatsheet.typ
+++ b/docs/typ/cheatsheet.typ
@@ -4,8 +4,6 @@
 // against the registry, the keymap and the default tags.
 #import "style.typ": key, btn, chord, word, tag, addr, file, cmd, doc
 
-= pardes #h(1fr) _acme's tags and three buttons, helix's keys, terminals as panes, the editor as a 9P filesystem_
-
 == The mouse
 / #btn("B1"): select, and focus the pane. On a tag: type there.
 / #btn("B2"): *execute* the word or selection: a builtin, else a shell line.
@@ -46,7 +44,7 @@ Typed anywhere, then #btn("B3") or #key("Enter"):
 Addresses are sam's: `#n`, `/re/`, `?re?`, `$`, `a,b`. #doc("fs", section: "look-and-exec")
 
 == Keys: normal mode
-Helix-style: motions *select*, then an edit acts on the selection. Mode box: blank normal, `^` insert, `$` tty.
+Helix-style: motions *select*, then an edit acts on the selection. Mode box: blank normal, `^` insert, `$` raw terminal.
 #table(columns: 2,
   [#key("h j k l") #key("w b e")], [move; words select],
   [#key("g g") #key("g e")], [first line, last line],
@@ -71,9 +69,9 @@ Helix-style: motions *select*, then an edit acts on the selection. Mode box: bla
 
 == Keys: panes
 #table(columns: 2,
-  [#key("Ctrl-w") #key("h j k l")], [focus a neighbour (anywhere)],
-  [#key("Esc")], [normal mode: hop to the previous pane],
-  [#key("Shift-Esc")], [leave, whatever Esc means here],
+  [#key("Ctrl-w") #key("h j k l")], [focus a neighbour (not in insert or raw `$`)],
+  [#key("Esc")], [back to the previous pane (from raw `$` only at an empty shell prompt)],
+  [#key("Shift-Esc")], [back to the previous pane from raw `$` or a PDF; in a terminal's normal mode, into raw],
   [#key("Ctrl-o") #key("Ctrl-i")], [jump history back, forward],
   [#key("Alt-n")], [new terminal below],
   [#key("Alt-c")], [move the pane to a new column],
@@ -97,8 +95,8 @@ Helix-style: motions *select*, then an edit acts on the selection. Mode box: bla
 )
 
 == Terminals and commands
-- A terminal is a pane. #key("Ctrl-b") toggles raw input (`$`) and editor mode, where the same keys move over its text, prompts hidden.
-- Raw: keys go to the program; #key("Esc") at a shell prompt hops away, #key("Shift-Esc") always.
+- A terminal is a pane. #key("Ctrl-b") switches it between raw (`$`) and normal mode, where the same keys move over its text, prompts hidden.
+- Raw: keys go to the program; #key("Esc") at an empty shell prompt goes back to the previous pane, #key("Shift-Esc") always.
 - #word("Mode") cycles raw, normal, insert. #word("Filter") maps its colours to the theme. #word("Tty+bash") opens another on that shell.
 - #btn("B2") on any non-builtin line (`make`, `git log`) runs it with #word("Shell") `-c` in the pane's directory, in a *command pane*: #tag("Kill Save Collapse Del", path: "/home/me/src (make) exit 0")
 - #word("Kill") stops what pardes started (`Kill make`: those lines); #word("Exit") quits.