summaryrefslogtreecommitdiff
path: root/docs/typ
diff options
context:
space:
mode:
Diffstat (limited to 'docs/typ')
-rw-r--r--docs/typ/guide.typ6
-rw-r--r--docs/typ/reference.typ11
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