From 4c2125ecf47588d33f9894c1fdf2833d0512f3b4 Mon Sep 17 00:00:00 2001 From: Gabriel Schneider Date: Fri, 6 Nov 2026 03:20:04 -0300 Subject: client #2, one frontend a session: the daemon answers `other ` for an attach to a session attached already (as it did for one of the other kind), so a second `pardes --attach` or `pardes-gui --attach` on this machine is a replica client through the replica socket, the path a remote one takes; a session tells the daemon its clients (SO_PEERCRED on each replica socket, at every join and leave) and `--ps` lists `client ` under it; the tty's per-terminal Screens (Screen.create/drop/destroy, primary, its stub and Killed slot), the Poster and its `from` input, the Gui's window-fields swap (window_fields, GuiWindow, copyWindow, freshWindow, follow, route, openAnotherWindow, closeView, windowsOpen, closeOtherWindows, resumeWindows), drawOthers and every harness's extra terminals (snapshot.zig's `start ... views=N` and `view `, e2e_harness's initView and drainOthers, PARDES_TEST_VIEWS in both frontends, the GUI feed's `view;`, the monkey's --views) go; the pump draws the one view this process shows (views.shown), through drawOne when a client's input was the last; an Upgrade from a build that kept a second terminal of its own lets it go (its stub told it is detached) and closes its view; deleted: views.snap, views-term.snap and views-pan.snap with their goldens (the in-process second terminal they drove is gone; views.zig's unit tests keep the per-view cursor, layout, register, sizing, closing and panning behaviour, test/replicas.zig and the soak the views of clients); the two views.zig tests that drew through drawOthers draw through drawOne; daemon.py's second terminal is a client listed by --ps, typed into in both terminals, detached from inside and closed; its second window a client listed by --ps and closed; the reference and next-daemon.md say so; no golden changes; gates: core-test 956/956 both, behaviour-test 248/248 both, unit-test 1487/1488 tui and 1530/1531 gui, pane-test 171/172 both, snap all 102 ok, process-test 0 of 37 failed on both, hxdiff 19 and hxparity 6 mismatches (the base's names), hxgolf 0, replicas, addon-test, gui-golden and monkey-gui 0 of 1 failed, daemon.py main, --window-clients and --gui ok, soak local pass (differ, mispred, view_bad, lost 0) Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge --- docs/typ/reference.typ | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) (limited to 'docs/typ') diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ index 972d5794..be157082 100644 --- a/docs/typ/reference.typ +++ b/docs/typ/reference.typ @@ -1111,7 +1111,7 @@ to its end before the write is answered, and one that finds nothing fails, `--no-prefix` diff's paths are kept. - *Sessions.* `pardes --ps` prints what the daemon keeps: each session (its pid, terminal or window, attached or detached, name) with the pids - and commands of the shells it holds, then the shells no session holds, + and commands of its clients and of the shells it holds, then the shells no session holds, which #word("Adopt") takes. `--kill=NAME` ends that session and its shells (a TERM, then a KILL 2 s later; unsaved changes are lost), `--kill-all` every session and every kept shell; with no daemon running @@ -1120,13 +1120,15 @@ to its end before the write is answered, and one that finds nothing fails, for `pardes`, a window's for `pardes-gui`), or with none detached the only session of that kind; a second `--detach=NAME` while NAME runs (a plain session is named by its pid) says so in words - and exits 1. A session attached already takes another view, up to four: - each terminal or window its own layout, focus, cursors, selections, - modes, scroll and jumps, over the panes, texts, tags, terminals, - messages and registers they share. A terminal pane shown in two takes the - size of the view that typed into it last; a shorter view shows the - rows down to its cursor, an arrow in the gutter when rows are above. #word("Detach"), or a terminal closing, lets that view go and - leaves the others. With none + and exits 1. A session attached already is joined as a client, as one of + the other kind or on another machine is (`--attach=SOCKET:NAME`, its own + process, listed under the session by `--ps`), up to four clients: each + terminal or window its own layout, focus, cursors, selections, modes, + scroll and jumps, over the panes, texts, tags, terminals, messages and + registers they share. A terminal pane shown in two takes the size of the + view that typed into it last; a shorter view shows the rows down to its + cursor, an arrow in the gutter when rows are above. #word("Detach"), or a + terminal closing, lets that client go and leaves the others. With none attached, `size C R` sets the screen, messages clear by the clock, and a pty reports its size in pixels at the last cell size (8×16 before any), as CSI 14, 16 and 18 t do. Attaching from another machine is gone until -- cgit v1.3