A look at a directory opens a pane listing it, as acme's directory window: named dir/, its entries in acme's columns (bytewise, dotfiles kept, a directory's marked /), a look at an entry from there, Get or a look again reads it again, never dirty, Save refused; DirLook terminal keeps ls in a terminal

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

1 files changed, 4 insertions, 3 deletions

diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index 29f535ee..a7ac997e 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -403,6 +403,7 @@ word clicked in a tag does. The same lines go in the startup file
   [#word("Placement") `acme|pardes`], [`acme`: where new panes go (#doc("fs", section: "placement"))],
   [#word("BootShell") `keep|replace`], [`keep`; `replace` closes the untouched lone shell a dragged document lands beside],
   [#word("LookWord") `search|list`], [`search`: a word given to #word("Look") selects its next place, or lists all in `+Search`],
+  [#word("DirLook") `pane|terminal`], [`pane`: #word("Look") on a directory opens a pane listing it, as acme's directory window (#doc("reference", section: "from-acme")); `terminal` types `ls` into a terminal idle there, else opens one],
   [#word("TermImages") `real|petscii`], [`real`: a new terminal draws its program's kitty graphics (yazi's previews) as pixels where the shell can; #word("Petscii") flips one terminal; a tty under a terminal without kitty graphics draws them as glyph art either way],
   [#word("Shell") `<name or path>`], [`$SHELL` when it is executable, else `/bin/sh`: the shell the next terminal and command pane run; a bare name is searched for in the usual bin directories, not `$PATH`; bare #word("Shell"): `$SHELL` if it is executable, else `/bin/sh`],
   [#word("DumpDir") `<dir>`], [`$XDG_DATA_HOME/pardes`, else `~/.local/share/pardes`: where #word("Dump") writes, an absolute or `~` path to a directory that may be written (made if missing); a relative one, or one under a directory that may not be written, is refused; bare returns to the default],
@@ -564,7 +565,7 @@ makes its column the active one (a folded pane stays folded); `no such pane`, or
 while a column or workspace tag has the keyboard.
 
 *Pane ctl.* Reading it gives acme's status line: serial, tag length, body
-length, isdir (0), dirty, width in cells, font, tab width, undo available,
+length, isdir (1 for a directory pane, else 0), dirty, width in cells, font, tab width, undo available,
 redo available, then `current`/`notcurrent`, a REPL's id if bound,
 `collapsed` when it is, and for a PDF `fit:width|height
 tint:disabled|filtered|full`. It
@@ -1026,13 +1027,13 @@ with Client(sys.argv[1]) as c:    # a socket path, or (ip, port)
   [`addr` reset on first open], [#file("addr") is the pane's; no open resets it (write `0`)],
   [OTRUNC on `data` ignored], [`: > data` deletes the addressed text; OTRUNC on #file("body") (`9p write`) replaces it all],
   [event flags 1, 2, 4, 8], [1, 4 and 8; never 2, so no expansion record follows],
-  [`Get`], [`get` on the pane's #file("ctl")],
+  [`Get`], [`get` on the pane's #file("ctl"); `Get` itself only in a directory pane],
   [`Put`, `Delete`], [#word("Save"); a #word("Del") that does not ask],
   [`Snarf`, `Cut`, `Paste`], [refused: the chords, #key("y"), #key("p")],
   [acme's other builtins], [refused: `Putall`, `Zerox`, `Sort`, `Load`, `ID`, `Send`, `Tab`, `Indent`, `Local`, `Incl`, `Abort`],
   [Edit], [no `< | >`, `X`, `Y`, `b B D e r w f`, no `\1`-`\9`; an alternation takes the first branch that matches, not the longest (#doc("fs", section: "edit"))],
   [`win`], [#word("Tty") is a VT terminal pane; #file("pty/run") runs a line at its prompt and answers `exit N` and the output; with #word("Repl") bound, #word("Exec") on a source pane types the text into it],
-  [a directory window], [#word("Look") on a directory types `ls` into a terminal idle there, else opens one],
+  [a directory window], [as acme's: a text pane named `dir/` (#file("index") kind `text`, #file("ctl") isdir 1), its entries in columns sorted bytewise, dotfiles shown, a directory's marked `/`; blanks pad the columns where acme's tabs do; a #word("Look") at an entry is from that directory, `Get` or a look at it again reads it again, and an edit is kept until then rather than lost to a resize; never dirty, #word("Save") refuses it; #word("DirLook") `terminal` types `ls` into a terminal there instead],
   [the plumber], [none: #word("Look") on an `http://` or `https://` URL runs `xdg-open` (`open` on macOS); files, addresses and directories follow built-in rules],
   [#key("Esc") selects what was typed], [#key("Esc") leaves insert mode, or goes back a pane (#doc("tags", section: "modes"))],
 )