summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/next-daemon.md41
-rw-r--r--docs/typ/reference.typ4
2 files changed, 27 insertions, 18 deletions
diff --git a/docs/next-daemon.md b/docs/next-daemon.md
index 3d4c8a08..e7ddcf5f 100644
--- a/docs/next-daemon.md
+++ b/docs/next-daemon.md
@@ -314,15 +314,23 @@ the ponytail lens:
workspace tag, prompts, messages, registers (decided), the macro being
recorded, look-hover (one pointer at a time), mouse sweeps, query
panes, search state, settings and theme, the effect and input queues,
- `needs_frame` (any change draws every view).
+ `needs_frame` (any change draws every view). A `.name` prompt (a
+ file's name drafted in its tag) is the view's that opened it
+ (`Pane.prompt_view`): only that view's focus leaving the pane drops it,
+ and its closing.
- **A terminal shown at two sizes** takes the size of the view that typed
into it last (`Pane.sized_by`, set by a key or a paste; a new pane's is
its maker's; a closed view's goes to the next to sync it). The others show
it at that size: `sync` resizes no pty for them, and `pane.cols/rows`
stay the terminal's own, so the terminal code's invariant (pane size is
- the emulator's) holds. ponytail: a smaller view sees its top rows, cut;
- panning to the cursor as tmux does is the upgrade, if a small view must
- follow a shell it never types into.
+ the emulator's) holds. A view shorter than the terminal is passed down
+ its top rows as far as keeps its cursor's row in sight, as tmux shows a
+ bigger window in a smaller client (`Pane.pan`, terminal.panFor: per view,
+ made in the step and again when a view is drawn out of turn, read where
+ the body's rows start, `Pane.scroll` and the body walk), an arrow in its
+ gutter's first row saying rows are above; a shell's prompt, at the
+ bottom, is never out of sight. ponytail: a panned view's mouse reports to
+ the terminal's program and its kitty images are placed as unpanned.
- **Panes come and go under parked views.** A view keeps the serial of
each slot when it goes out; unparked, the ids whose serial changed leave
its layout and its keyboard moves to its first pane left. A pane focused
@@ -390,8 +398,6 @@ the ponytail lens:
named in a path yet (a script's focus or layout is that view's).
- Every change draws every view (`needs_frame` is the session's); a
view's own dirtiness waits for a measurement that wants it.
- - Prompts are the pane's: a `.name` prompt drafted in one view is
- closed by another view's step, where that pane has not the keyboard.
- Dump, Restore and Handover keep one view, the live one.
- **What proved wrong in the design.** "Views" in the design were a
struct the core reads through; the swap made them cheaper and kept every
@@ -433,21 +439,24 @@ Two views (not gated): every frame draws both, so a change costs two
renders; a view switch copies ~60 fields and each pane's share, a few
microseconds.
-Gates, on the line rebased onto main's tty throughput fix (qzsouslm):
+Gates, on the line rebased onto main's screen-state terminals (mnlwlpvk):
-- `zig build replay -Dplatform=tty`: 112 snapshot scripts pass (the 110,
- views.snap and views-term.snap), their 130 tapes replay in all three
- replicas (390 runs, 29,355 digests); 20 monkey seeds at one view (60
- runs, 14,010 digests) and 20 at three views (60 runs, 9,720 digests);
- no divergence, no panic. views.snap: 75 digests a replica,
- views-term.snap 35.
-- Unit tests: tty 1478 of 1498 pass, 20 skipped; GUI 1549 of 1560, 9
+- `zig build replay -Dplatform=tty`: 113 snapshot scripts pass (the 110,
+ views.snap, views-term.snap and views-pan.snap), their 131 tapes replay
+ in all three replicas (393 runs, 29,436 digests); 20 monkey seeds at one
+ view (60 runs, 14,004 digests) and 20 at three views (60 runs, 9,666
+ digests); no divergence, no panic. views.snap: 75 digests a replica,
+ views-term.snap 35. core-test: 1117 of 1135, 18 skipped.
+- Unit tests (on qzsouslm): tty 1478 of 1498 pass, 20 skipped; GUI 1549 of 1560, 9
skipped and 2 failed, the same two that fail on phase 1's line (`tagline
pointer mapping retains physical grips...` and `a tag caret past its
- row's end glides...`). The views' own: 7 (own cursor, scroll, mode,
+ row's end glides...`). The views' own: 8 (own cursor, scroll, mode,
layout and focus; an edit and a register shared; a terminal sized by its
last typist; views closing; the other views drawn leave the digest; a
- view keeps its place in a text another edits).
+ view keeps its place in a text another edits; a short view keeps a tall
+ terminal's cursor in sight). views-pan.snap: a shell sized for the tall
+ view, its prompt and last lines in the short one under an arrow, then
+ typed into from the short one and sized for it.
- test/fs.py passes (with a TMPDIR short enough for the 9P sockets'
paths). test/daemon.py: 20 detach and attach cycles, then a second
terminal on the attached session, both drawn, detached from inside and
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index 190adba7..ce2a45f1 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -1018,8 +1018,8 @@ to its end before the write is answered, and one that finds nothing fails,
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
+ 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
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),