summaryrefslogtreecommitdiff
path: root/docs/typ/guide.typ
diff options
context:
space:
mode:
Diffstat (limited to 'docs/typ/guide.typ')
-rw-r--r--docs/typ/guide.typ27
1 files changed, 22 insertions, 5 deletions
diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ
index 58e5d907..56fe3ebd 100644
--- a/docs/typ/guide.typ
+++ b/docs/typ/guide.typ
@@ -43,7 +43,7 @@ steps raw, normal, insert.
[#mode-box(" ") normal], [#key("Esc"): back to the previous pane (#word("Last")), unlike helix. #key("Shift-Esc"): the same.],
[#mode-box("^") insert], [#key("Esc"): back to normal. #key("Shift-Esc"): out of insert and back to the previous pane.],
[#mode-box("$") raw], [#key("Esc"): back to the previous pane. #key("Shift-Esc"): an Esc to the program. Either way the terminal stays raw. #word("ProgramEsc") `on` swaps them back: #key("Esc") goes to the program, except at a shell prompt with nothing typed on it, and #key("Shift-Esc") always goes back.],
- [a PDF], [#key("Esc"): clears the selection and the search highlights. #key("Shift-Esc"): back to the previous pane.],
+ [a PDF], [#key("Esc"): clears the selection and the search highlights, and with none shown goes back to the previous pane. #key("Shift-Esc"): back at once.],
)
In acme, Esc selects the text typed since the last click; here it leaves
@@ -343,12 +343,29 @@ cheatsheet (#doc("cheatsheet")) say so.
```
pardes --detach=work & a session with no screen of its own
pardes --attach=work show it here
+pardes-gui --attach=work a window session's window again
+pardes --ps every session the daemon keeps, and its shells
+pardes --kill=work end it and its shells (--kill-all: every one)
```
-The session owns the panes, shells and files; frontends come and go, and
-all of them see the same screen. #word("Attach") `work` (#key("SPC s a"))
-switches this window to it; #word("Detach") (#key("SPC s D")) leaves it
-running.
+#word("Detach") (#key("SPC s D")) lets the terminal or the window go and
+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. 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
+leaves once nothing is kept. After a rebuild, #word("Upgrade")
+(#key("SPC s U")) moves a running session onto the pardes now installed
+where it was started from, in place: its text and undo, its views, its
+terminals with their running shells, and its terminals and windows come
+along, and the daemon moves too. A build that cannot read the session
+hands it back to the one that ran it.
= Config <config>