diff options
| author | Gabriel Schneider <[email protected]> | 2026-10-29 17:58:06 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-10-29 19:38:53 -0300 |
| commit | 74286e81e88a6df7586ead9e8bcd503d44446a85 (patch) | |
| tree | 0c03cdcc8cd61096d53d6610ef0f0fc9698cfb6e /docs/typ | |
| parent | 3a5db21504a653cc5e97b98edad59a6262a3b8e9 (diff) | |
| download | pardes-74286e81e88a6df7586ead9e8bcd503d44446a85.tar.gz pardes-74286e81e88a6df7586ead9e8bcd503d44446a85.zip | |
docs: views in the guide and reference (a session attached already takes another view, up to four; Detach lets one go); phase 4 notes in docs/next-daemon.md; tty: Screen.hungUp reads a test terminal's fd as the test build has it
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to 'docs/typ')
| -rw-r--r-- | docs/typ/guide.typ | 6 | ||||
| -rw-r--r-- | docs/typ/reference.typ | 11 |
2 files changed, 14 insertions, 3 deletions
diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ index 5dea0522..40802ed9 100644 --- a/docs/typ/guide.typ +++ b/docs/typ/guide.typ @@ -350,7 +350,11 @@ pardes-gui --attach=work a window session's window again leaves the session running, its panes, shells and files kept; so does a terminal that closes. `pardes --attach` takes it back in any terminal, `pardes-gui --attach` a window session's window: a terminal session takes -a terminal, a window session a window. A session is named by `--9p=` or +a terminal, a window session a window. Attached already, it takes another +view: each terminal or window has its own columns, focus, cursors and +scroll over the same panes, texts and registers, and a terminal shown in +two takes the size of the one that last typed into it. #word("Detach") in +one lets only that one go. A session is named by `--9p=` or `--detach=`, else its pid. A session killed outright leaves its shells running; #word("Adopt") in another takes them in as terminal panes, what they showed gone. One `pardes --daemon` per user keeps all of it, and diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ index c95a574a..190adba7 100644 --- a/docs/typ/reference.typ +++ b/docs/typ/reference.typ @@ -1011,9 +1011,16 @@ to its end before the write is answered, and one that finds nothing fails, `--no-prefix` diff's paths are kept. - *Sessions.* Bare `--detach` names the session after its pid; bare `--attach` needs exactly one detached session of its kind (a terminal's - for `pardes`, a window's for `pardes-gui`); a second `--detach=NAME` + 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. One terminal or window shows a session at a time. With none + 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 smaller view shows its top + rows. #word("Detach"), or a terminal closing, lets that view 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 |
