summaryrefslogtreecommitdiff
path: root/docs/typ/guide.typ
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-10-01 09:43:37 -0300
committerGabriel Schneider <[email protected]>2026-10-01 09:47:18 -0300
commit802de4f12f125abc261c58bdb5385f6be3ad469a (patch)
tree7dba19dcdfb2153e9dfa1d1e99b0697aabd49613 /docs/typ/guide.typ
parent51df4b01f4ea8768b14048841f1c5fdd75128cd3 (diff)
downloadpardes-802de4f12f125abc261c58bdb5385f6be3ad469a.tar.gz
pardes-802de4f12f125abc261c58bdb5385f6be3ad469a.zip
Shift-Esc always backs out: in every mode and pane it goes to the previous pane, as Esc does from normal, and a raw program never sees it; Ctrl-b alone toggles raw
Shift-Esc switched a terminal in normal or insert mode into raw, so the one key meant to get out of anything got a script or a person into a program instead. It is now handled before any mode: an open prompt is closed, insert mode left, a pending count dropped, and Last runs, the pane keeping its mode (a raw terminal stays raw). Ctrl-b is the only switch between raw and normal. The keymap's two chords become one, back_out; the cheatsheet row, the guide's mode table and the tutor say so, and the tty and builtins goldens are re-recorded. Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to 'docs/typ/guide.typ')
-rw-r--r--docs/typ/guide.typ6
1 files changed, 3 insertions, 3 deletions
diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ
index 8bab9e56..6d140da7 100644
--- a/docs/typ/guide.typ
+++ b/docs/typ/guide.typ
@@ -27,13 +27,13 @@ copy from. #word("Mode") in the tag steps raw, normal, insert. Esc and
Shift-Esc depend on the mode:
#pairs(
- [normal], [#key("Esc"): back to the previous pane (#word("Last")). #key("Shift-Esc"): the same, except in a terminal, where it switches to raw.],
- [insert], [#key("Esc"): back to normal. #key("Shift-Esc"): the same, except in a terminal, where it switches to raw.],
+ [normal], [#key("Esc"): back to the previous pane (#word("Last")). #key("Shift-Esc"): the same.],
+ [insert], [#key("Esc"): back to normal. #key("Shift-Esc"): out of insert and back to the previous pane.],
[raw `$`], [#key("Esc"): to the program, except at a shell prompt with nothing typed on it, where it goes back to the previous pane. #key("Shift-Esc"): always back to the previous pane. Either way the terminal stays `$`.],
[a PDF], [#key("Esc"): clears the selection and the search highlights. #key("Shift-Esc"): back to the previous pane.],
)
-In short, #key("Shift-Esc") is as Esc, but always back to the previous pane from raw `$` or a PDF, and into raw from a terminal's normal or insert mode. "A shell prompt with nothing
+In short, #key("Shift-Esc") is the Esc nothing swallows: in every mode and pane it goes back to the previous pane, as Esc does from normal, and a raw program never sees it. #key("Ctrl-b") alone switches a terminal between raw and normal. "A shell prompt with nothing
typed on it" is one pardes knows from the prompt marks it injects into bash
and fish (and, for other shells, from no program holding the terminal).
"The previous pane" is the last other pane on the jump list; with none, the