From 59f3f59cc8bdd7c012050cd2e1d4cbb41b473642 Mon Sep 17 00:00:00 2001 From: Gabriel Schneider Date: Thu, 1 Oct 2026 13:33:31 -0300 Subject: Show, don't tell: the guide, the tutor, scripting, setup and the landing lead show an example first and cut the prose it makes redundant; the reference's 9P tree and REPLs name Look and Exec Co-Authored-By: Claude Opus 5.5 --- docs/typ/reference.typ | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) (limited to 'docs/typ/reference.typ') diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ index 71005349..1ae38767 100644 --- a/docs/typ/reference.typ +++ b/docs/typ/reference.typ @@ -20,8 +20,8 @@ it names, or else run it as a shell line. The files #file("look") and README the one-screen summary (src/fs-help.txt) @other-files index a line per pane: serial kind dirty name column @rules status pid, version, panes @other-files -look write a line: a right click at the pane with the keyboard; read: the serials touched @look-and-exec -exec write a line: a middle click there; read: the serials touched @look-and-exec +look write a line: a #word("Look") at the pane with the keyboard; read: the serials touched @look-and-exec +exec write a line: an #word("Exec") there; read: the serials touched @look-and-exec pager write a directory: its one +Pager, made or emptied; read: its serial @pardes-stdin log the event log; write follow to wait for more @log screen the rendered screen as JSON @on-screen @@ -56,8 +56,8 @@ pane/ the panes @pa scroll 0 or 1; a write scrolls the pane @flags errors write-only: text for the directory's +Errors @panes event the pane's clicks and keys, as acme's event file @event - look a right click at this pane @look-and-exec - exec a middle click at this pane @look-and-exec + look a #word("Look") at this pane @look-and-exec + exec an #word("Exec") at this pane @look-and-exec tagexec a word clicked in this pane's tag @look-and-exec pty/ terminals only @pty ctl winsize, sig, exec @pty @@ -216,7 +216,7 @@ files. that is there but will not open fails the write and is named: `look: : permission denied`. A zero column is refused, `file:0:0` included: columns count from 1. -- A whole line of a diff pane written to #file("look") is the look a right-click on its first column makes. The line is matched in the +- A whole line of a diff pane written to #file("look") is the #word("Look") on its first column. The line is matched in the pane from its cursor row on, wrapping, and the first match wins. - On a PDF pane `:P:H` is hit H of the pane's search on page P, as `file.pdf:P:H` is; a hit not there, or any H with no search active, is a @@ -744,7 +744,7 @@ back as a record: run it through #file("ctl") instead. == REPLs #word("Repl") `python` on a terminal's #file("ctl") (or in its tag) binds it as -that language's REPL: a middle-click or #key("Tab") on a `.py` body +that language's REPL: #word("Exec") (or #key("Tab")) on a `.py` body then types the text into the REPL instead of running it; builtin words, tag words, #word("Exec") `` and #raw("@`cmd`") words still run. #word("Repl") takes the languages a code fence names (ada, bash, c, c_sharp, clojure, -- cgit v1.3