From 69cb06ed45ef2a26d7f5a3259df743f76bf53021 Mon Sep 17 00:00:00 2001 From: Gabriel Schneider Date: Thu, 1 Oct 2026 00:23:38 -0300 Subject: The docs describe the pager that landed: pardes - and its +Pager pane, a terminal's PAGER, command panes' cat, Pager pardes|off, and pty/run no longer waiting in one Co-Authored-By: Claude Opus 5.5 --- docs/typ/reference.typ | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) (limited to 'docs/typ/reference.typ') diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ index 28f0c756..08fb1d83 100644 --- a/docs/typ/reference.typ +++ b/docs/typ/reference.typ @@ -296,6 +296,7 @@ word clicked in a tag does. The same lines go in the startup file [`Verbose`], [on: a builtin announces its name on the message row], [`MessageAnimation`], [on: messages ease in and dissolve], [`MessageLinger`, `MessageFall`, `MessageDissolve`], [800, 180, 150 milliseconds, at most 60000], + [`Pager pardes|off`], [`pardes`: what a terminal's commands page through, `pardes -`; `off` leaves `PAGER` and `GIT_PAGER` as the environment has them. It applies to terminals started after it], [`Placement acme|pardes`], [`acme`: where new panes go (#doc("tags", section: "new-panes"))], [`BootShell keep|replace`], [`keep`; `replace` closes the untouched lone shell a dragged document lands beside], [`LookWord search|list`], [`search`: a looked-at word selects its next place, or lists all in `+Search`], @@ -642,7 +643,8 @@ Terminal panes also have #file("pty/"): open: #cmd("exec 3<>$m/pane/$n/pty/run; echo make >&3; cat <&3; exec 3<&-") The answer's first line is the header: `exit N` then the command's output (as the screen showed it: no colour, tabs expanded to blanks, `\r` - progress collapsed, trailing blanks dropped; the last 64 KiB, `exit N cut M` when M bytes were left + progress collapsed, trailing blanks dropped; a paging command's text + goes to a `+Pager` pane through the terminal's `pardes -` pager; the last 64 KiB, `exit N cut M` when M bytes were left out, bare `cut` when the start scrolled away or was cleared). Or: `busy: is running` (bare `busy` when text is typed at the prompt), `exit ?` (no status reported, not a success), `error not run` (the shell refused the line, e.g. a fish syntax error), `error shell gone`, `error no prompt marks`, and on a command pane `error a command runs here, not a shell` (`error command done; not a shell` once it ended). A line written @@ -708,6 +710,14 @@ at 200, ending in `…`. Control characters become spaces. `-Dembed-sources=true`; `EffectCode ` lists an effect's files under `/virtual`. += pardes - + +`pardes -` reads stdin to its end, strips terminal escapes (colour, +hyperlinks, a man page's overstrike), and shows it in a `+Pager` pane: +inside a pardes pane, a clean `/+Pager` in the outer session, +returning at once; outside one, a new editor whose first pane it is. Input +past a file's size limit is cut, and the pane says so at its end. + = Other ways in The scripting chapter's rule (a mount, else plan9port's `9p`) covers most -- cgit v1.3