The docs take round 35: cloud9's errno table, Restore's parser words, insert after a match, LookWord list rows, the last-run awk without exit, command pane directories, rename previews, listings that keep the keyboard, set-value toggles, pty/run one line a write, /pager resolving, PDF :N:H, skipped directories and Lspinfo

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

1 files changed, 13 insertions, 5 deletions

diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ
index 1079b763..9f45350b 100644
--- a/docs/typ/guide.typ
+++ b/docs/typ/guide.typ
@@ -116,7 +116,10 @@ column's last pane; a pane opened from a pane's text (a look, #word("Tty"),
 biggest; a command pane goes to the last column. #word("New") in a pane's
 tag opens a `+New` scratch named in that pane's directory, in that pane's
 column; from a column tag, in that column and the session's directory.
-Every new pane but a command pane takes the keyboard. No pane is made
+Every new pane takes the keyboard, except a command pane and a listing
+(`+Search`, #word("Recent"), #word("Jumplist"), #word("Themes"), `Fonts`),
+which opens below the pane that asked and leaves it the keyboard, so
+#keys("n", "N") walk the listing and #key("Tab") runs a row. No pane is made
 shorter than its tag and two rows; where there is no room the pane is
 refused. `Placement pardes` instead fills an empty column whose tag asked
 or has the keyboard, puts a scratch or a shell under the pane that asked,
@@ -136,7 +139,8 @@ a terminal there. A URL opens in the browser. #word("Find") `name` lists the fil
 below the pane's directory whose names hold it; #word("Grep") `text` lists
 the lines that contain that text, literally (ASCII case aside, no regular
 expression), in files under every pane's directory. Both land in `+Search`,
-a place per row for #btn("B3").
+a place per row for #btn("B3"); a directory the walk cannot open is
+skipped, and the list ends `N directories skipped: permission denied`.
 
 A relative path is looked for where the click was, then where you have
 been: first in the looking pane's own directory, then in the directory of
@@ -154,7 +158,9 @@ command pane, a terminal of its own:
 
 #tag("Kill Save Collapse Del", path: "/home/me/src (make) exit 0")
 
-Its tag says `running`, then `exit N`. The next command for the same
+Its tag says `running`, then `exit N`. Its directory is the one it
+started in, and relative looks in it resolve there, whatever the command
+did with `cd`. The next command for the same
 directory reuses a command pane that has finished (from a column tag, only
 one in that column), below what it showed; a pane still running, or one a
 background job still prints to, is never reused, so a second command
@@ -278,8 +284,10 @@ turns one off):
 One answer jumps; several open a list where #key("Enter") on a row goes
 there. In insert mode #key("Tab") after a `.` lists the candidate
 declarations and inserts nothing. A format or a rename within the file is
-one undo step; a rename that reaches other files opens a preview instead
-of changing them.
+one undo step. A rename that reaches other files applies nothing: it opens
+a `+Search` preview of the edits, telling the server first of every open
+file of its language so those are included. A server is `not started yet`
+until its first query.
 
 = Sessions <sessions>