The docs take round 32: petscii words in terminal and image tags, open records and EMFILE, ThemeFile failures and replays, trailing-colon looks, pty/run after clear, no-text addr refusals, held log reads at Restore, pardes - in one open, and a detached pty in pixels

Co-Authored-By: Claude Opus 5.5 <[email protected]>

1 files changed, 8 insertions, 1 deletions

diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ
index c145f9b0..39ecc865 100644
--- a/docs/typ/guide.typ
+++ b/docs/typ/guide.typ
@@ -184,6 +184,10 @@ A terminal is a pane like any other.
 - #word("Save") asks for a path on the pane's notice band and writes the
   terminal's scrollback there as text; `Save path` writes it at once.
 - #word("Filter") maps the program's colours through the theme.
+- A terminal showing kitty graphics (yazi's previews) shows `petscii:on` or
+  `petscii:off` in its tag. #word("Petscii") toggles it: on draws the
+  program's images as glyph art instead of host pixels, off goes back to
+  pixels. A terminal with no images shows the word only while it is on.
 - The `+New` scratch a bare `pardes` starts under its shell runs its
   commands in that terminal's current directory, following its `cd`.
 - A paging command in a terminal (`git log`, `man`) opens its text in a
@@ -286,7 +290,10 @@ and all. Bare `--detach` names the session after its pid; bare `--attach`
 needs exactly one session; a second `--detach=NAME` while NAME runs says so
 and exits 1. Every attached frontend sees the same screen,
 at the smallest common size. With none attached, `size C R` on the root
-ctl sets the screen and messages clear by the clock. A detached session
+ctl sets the screen and messages clear by the clock, and a pane's pty
+reports its size in pixels at the last frontend's cell size (8×16 before
+any frontend attached), so programs like yazi still size their images;
+CSI 14, 16 and 18 t answer the same. A detached session
 ends when its last pane closes, as any session does.
 
 = Config <config>