Docs for 0.24: Ctrl-i's fallbacks (SPC j i, SPC j o, the side buttons), a terminal's text edited as a copy, a tag's typed path surviving Esc, Get's order of refusals, the init file's errors when saved, --wait and --detach in words; the CHANGELOG's 0.24 section, the directory window moved there from 0.23

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

1 files changed, 5 insertions, 3 deletions

diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ
index 4c80eaea..578e7ea8 100644
--- a/docs/typ/guide.typ
+++ b/docs/typ/guide.typ
@@ -55,7 +55,7 @@ the next pane down the column.
 
 #pairs(
   [#key("Ctrl-w") #key("h")], [the keyboard to the pane on the left; #key("j") below, #key("k") above, #key("l") right],
-  [#keys("Ctrl-o", "Ctrl-i")], [back and forward through the places you jumped to (the jump list), this file's first: another file's only once it has none left that way (#word("JumpScope") `all`: every place in order)],
+  [#keys("Ctrl-o", "Ctrl-i")], [back and forward through the places you jumped to (the jump list), this file's first: another file's only once it has none left that way (#word("JumpScope") `all`: every place in order). #key("Ctrl-i") needs the kitty keyboard protocol or the GUI, being #key("Tab") elsewhere: there use #key("SPC j i") and #key("SPC j o"), or the mouse's side buttons],
 )
 
 Raw mode sends almost every key to the program. Leave it (#key("Ctrl-b"))
@@ -102,8 +102,7 @@ in a pane's tag quits too.
 
 #pairs(
   [#key(":")], [the keyboard to the tag, on #word("Save") the first time; #key("Tab") runs it, #key(":") comes back],
-  // TODO(round40): final wording for Esc then Enter on an edited path.
-  [edit the path, #key("Enter")], [the next #word("Save") writes to the new path],
+  [edit the path, #key("Enter")], [renames: the next #word("Save") writes there; the typed path survives #key("Esc"), pending, and a second #key("Esc") drops it],
   [#word("Collapse")], [folds the pane to its tag],
   [drag the box], [up or down resizes; onto another column moves the pane],
 )
@@ -195,6 +194,9 @@ takes the rows: #key("k") above, #key("j") below.
 - #word("Filter") maps the program's colours through the theme.
 - #word("Petscii") draws a program's images as glyph art instead of pixels.
 - In raw mode Ctrl-V types what you yanked, Ctrl-Shift-V the clipboard.
+- In normal mode, editing a terminal's text edits a copy, and the first
+  edit says so: #key("Tab") or #btn("B2") runs it, and the program's next
+  drawing replaces it.
 - A program that tracks the mouse gets #btn("B1") and the wheel;
   #btn("B2") and #btn("B3") stay pardes's. Hold Shift to swap.
 - #word("Repl") `python` in its tag makes #btn("B2") on a `.py` pane send the text