From 61fe4ff00d0cc2e0f3f1bd6be2aedd9d39dc4673 Mon Sep 17 00:00:00 2001 From: Gabriel Schneider Date: Thu, 1 Oct 2026 07:14:38 -0300 Subject: 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 --- docs/typ/guide.typ | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) (limited to 'docs/typ/guide.typ') 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 -- cgit v1.3