summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/effects.md4
-rw-r--r--docs/helix-keys.md4
-rw-r--r--docs/macos.md8
-rw-r--r--docs/next-daemon.md22
-rw-r--r--docs/next-pdfrender.md2
-rw-r--r--docs/next-tests.md6
-rw-r--r--docs/render-pipeline.md10
-rw-r--r--docs/shared-libs.md2
-rw-r--r--docs/site/README4
-rw-r--r--docs/typ/README14
-rw-r--r--docs/typ/building.typ16
-rw-r--r--docs/typ/builtins-gui.json2
-rw-r--r--docs/typ/builtins-tui.json (renamed from docs/typ/builtins-tty.json)2
-rw-r--r--docs/typ/builtins.typ2
-rw-r--r--docs/typ/cheatsheet.typ12
-rw-r--r--docs/typ/guide.typ12
-rw-r--r--docs/typ/install.typ2
-rw-r--r--docs/typ/reference.typ17
-rw-r--r--docs/typ/style.typ12
-rw-r--r--docs/typ/themes.typ4
-rw-r--r--docs/ui-review.md10
21 files changed, 84 insertions, 83 deletions
diff --git a/docs/effects.md b/docs/effects.md
index 894bd75d..1c1a9cac 100644
--- a/docs/effects.md
+++ b/docs/effects.md
@@ -266,13 +266,13 @@ it does in a pixel shell.
| # | effect | switch | state | review material | verdict |
|---|---|---|---|---|---|
-| T2 | cursor jump trail | `JumpTrail on\|off` (off) | a jump of three cells or more leaves 3 to 5 cells of trail behind the cursor, their ground drawn toward the text's colour in OKLab, most beside it, fading in 120 ms; truecolor terminals (vaxis's answer or COLORTERM); never the cursor's cell, a selection or outside the focused body; off under Motion off; a few cells a frame | .scratch/render/tty/trail/ (pyte replay of a real tty session at 60 fps: trail-forge.mp4, zooms) | pending |
+| T2 | cursor jump trail | `JumpTrail on\|off` (off) | a jump of three cells or more leaves 3 to 5 cells of trail behind the cursor, their ground drawn toward the text's colour in OKLab, most beside it, fading in 120 ms; truecolor terminals (vaxis's answer or COLORTERM); never the cursor's cell, a selection or outside the focused body; off under Motion off; a few cells a frame | .scratch/render/tty/trail/ (pyte replay of a real tui session at 60 fps: trail-forge.mp4, zooms) | pending |
| T1 chip shadow | `ChipShadow on\|off` (off) | a notice chip casts a shadow a cell right and down in its body: half blocks (▌ ▀ ▘) in a darker ground on blank cells, the ground 35% darker (OKLab) under text; never the cursor, a selection, a tag or another chip; truecolor only | .scratch/render/tty/shadow/ (forge, acme; zooms) | pending |
| T4 ordered swap | `PanelDissolve` (off) | the terminal's dissolve swaps each changed cell once at its place in a 4x4 Bayer matrix (shifted per pane), an even patterned screen instead of noise; hit-testing follows the same order | .scratch/render/tty/dissolve/ (ordered-swap-sim: the matrix applied to two real frames; see note) | pending |
| T7 thumb flash | `ThumbFlash on\|off` (off) | a pane whose view moves has its scroll thumb drawn toward the text's colour, 60% at once and back over 250 ms (quadratic); the thumb only, never a focus indicator; truecolor only; a few cells a frame while it fades | .scratch/render/tty/thumb-flash.mp4, thumb-flash-strip.png (pyte replay, forge) | pending |
| T3 wipe | `PanelCurtain` (off) | the curtain becomes a wipe, left to right: new grid behind the head, old ahead, and a soft edge of two columns whose ink and ground sit 2/3 and 1/3 of the way to the old ground (OKLab; a palette colour steps at the half); only the head's columns change a frame; the head's cells are not hit-testable until settled | .scratch/render/tty/wipe/ (curtain-gui.mp4, curtain-edge-zoom.png) | pending |
-Note on T4's material: a pane opening in a tty session recorded through
+Note on T4's material: a pane opening in a tui session recorded through
pyte did not animate (PanelSlide did not either there), so the review
material applies the same matrix to two real frames of that session; the
unit test holds the order (a 4x4 block reveals exactly t x 16 cells).
diff --git a/docs/helix-keys.md b/docs/helix-keys.md
index 04aa60dd..b172caab 100644
--- a/docs/helix-keys.md
+++ b/docs/helix-keys.md
@@ -133,7 +133,7 @@ language-backend queries, and the shell pipe.
| `Alt-c` | move active terminal to a fresh column (outside raw tty) | helix `Alt-c` is change-noyank; the pardes window op wins (do-not-touch contract). `Alt-d` + `i` covers the behavior | waived (`alt-c-window-op`) |
| `Space` (normal, body) | starts the pardes LEADER: a key path runs the same builtin words used by tags and the topbar. The main groups are `f` files, `h` docs, `c` columns, `t` toggles/effects, `a` panel animations, `s` session, `j` jumps, `l` language, and `w` directional focus; `SPC ?` lists every path and `<prefix> ?` lists one group in `+Help`. Neither `Exit` (quits the editor, acme's Exit) nor `Kill` (stops the commands pardes typed into terminals, acme's Kill) has a leader path: both are the topbar's and the root `ctl`'s. The pending path appears on the active pane's transient body/message row. Esc or an unmapped key abandons it. Paths, Help rows, and dispatch are all generated from the builtin registry at comptime; the leader applies only to a BODY in normal mode because tags and tty programs own their input | pardes-specific; helix spends Space on pickers/LSP (section C), while pardes uses acme-style executable words |
| `SPC y` `SPC Y` `SPC p` `SPC P` `SPC R` | helix's clipboard menu on helix's own letters: yank the selection to the system clipboard (`ClipYank`) or the PRIMARY selection alone (`ClipYankMain`), paste the system clipboard after (`ClipPaste`) / before (`ClipPasteBefore`) the selection, replace the selection with it (`ClipReplace`) | the same as `"+y`, `"+p`, `"+P`, `"+R`: register `+` (and `*`) IS the desktop's clipboard, the only register that reaches it. `SPC y` writes `+` alone, as helix's does, not the default register too. Builtins rather than bare chords because a leader path names a builtin: they land in Help's index and are executable words like every other verb. The clipboard holds one text, so N values go out joined by newlines, as helix sends them. On a tty the write is OSC 52 out and the READ is OSC 52 back, which many terminals refuse or gate — so `SPC y` works there and `SPC p` can be a no-op | out of corpus |
-| a paste from the OUTER terminal | one `Event.paste`, spliced in at the cursor | the tty shell enables bracketed paste and coalesces `paste_start`..`paste_end` into a single event; before that the bytes arrived as individual key presses and normal mode RAN them, which is how a pasted `d` deleted a line. The bytes deliberately never enter the yank register — clipboard and default register are separate stores in both directions | pardes-specific |
+| a paste from the OUTER terminal | one `Event.paste`, spliced in at the cursor | the tui shell enables bracketed paste and coalesces `paste_start`..`paste_end` into a single event; before that the bytes arrived as individual key presses and normal mode RAN them, which is how a pasted `d` deleted a line. The bytes deliberately never enter the yank register — clipboard and default register are separate stores in both directions | pardes-specific |
| `/` (a text) | a query pane under the pane (`src/Query.zig`): a `+Search` whose line 1 is the query, typed into; helix's regex with smart case, every match tinted and ticked on the rail as you type (the pane's places, `src/Places.zig`), the first after the cursor selected (helix's incremental preview). `Ctrl-n`/`Ctrl-p` step while typing; Enter lands, fills `/` and keeps the rows as text; Esc while typing restores the text and closes the pane. Line 1's first word names the source (`/`, `Find`, `Grep`, `Recent`, `Panes`, `Symbols`, `All`, `Refs`, `Def`, `Impl`, `Diagnostics`), helix's pickers as one pane. A terminal's and a PDF's `/` keep the notice-band prompt and its `+Search` | helix's `/` semantics (regex, smart case, preview); the pane is pardes' | pardes-specific |
| `n` / `N` | next / previous match of the text's places when a query pane fed them (a `/`, a list's places in this text: refs, diagnostics, a Grep's hits), round the ends without a message; else the last search register's regex in the current text, as before; counts repeat | only the primary selection is replaced; in select mode each match is added and becomes primary. Named registers work. `*` sets the pattern from selections with word boundaries (`Alt-*` without) and seeds the text's query pane with it, the keyboard staying. The former Look ring is `LookNext` / `LookPrev`, `SPC j n` / `SPC j p`. PDFs retain their location-result navigation | helix-verified |
@@ -341,7 +341,7 @@ text.
| `Ctrl-u` | kill to line start | | helix-verified (phase 5) |
| `Ctrl-k` | kill to line end | | helix-verified (phase 5) |
| `Ctrl-h` | delete prev char (Backspace alias) | | helix-verified (phase 5) |
-| `Ctrl-d` / `Delete` | delete next char; at line end joins the next line up | `Key.delete` (0xF0009) added + `mapKey` in tty.zig/gui.zig (vaxis + SDLK) + `forwardKey` sends `ESC[3~` in tty mode | helix-verified (phase 5) |
+| `Ctrl-d` / `Delete` | delete next char; at line end joins the next line up | `Key.delete` (0xF0009) added + `mapKey` in tui.zig/gui.zig (vaxis + SDLK) + `forwardKey` sends `ESC[3~` in tty mode | helix-verified (phase 5) |
| `Ctrl-j` | insert newline (Enter alias) | | helix-verified (phase 5) |
| `Home` / `End` | line start / line end past-the-last-char (`goto_line_end_newline`) | file panes (terminal insert cursor rides its run, as before) | helix-verified (phase 5) |
| `PageUp` / `PageDown` | cursor page up / down, col kept (clamped to line) | file panes | helix-verified (phase 5) |
diff --git a/docs/macos.md b/docs/macos.md
index 3ee55d0a..ddd7eee1 100644
--- a/docs/macos.md
+++ b/docs/macos.md
@@ -77,7 +77,7 @@ fourteen are filled in (`src/macos.zig:1761`).
The machine-local half of those methods is no longer this file's. `forkShell`,
`writeFileBytes` and `writeFd` live in `src/host_io.zig` and are shared with
-the tty shell, the SDL shell and the detached daemon; `src/macos.zig` calls
+the tui shell, the SDL shell and the detached daemon; `src/macos.zig` calls
them (`:1807`, `:1823`, `:1848`, `:1863`) and its own copies, together with the
four `extern "c"` declarations they needed (`forkpty`, `execv`, `chdir`,
`_exit`), are gone. Two `extern "c"` declarations remain here: `setenv`, and
@@ -473,7 +473,7 @@ has none:
between fork and exec can deadlock on the heap a pty reader thread was
holding. Every pane is emulated by the bundled VT, so the value describes
pardes and never the terminal pardes was started from; `-Dplatform=gui` and
- the tty shell take the same path, where the difference is only that their
+ the tui shell take the same path, where the difference is only that their
launcher usually happened to set something. The names come from
`config.child_term` / `child_colorterm` / `child_term_program`, and `TERM`
is deliberately `xterm-256color` rather than a name with no installed
@@ -586,7 +586,7 @@ theme it cannot.
showed *nothing at all*: with `native_images` false the core assumes a terminal
that cannot draw pixels and degrades a document to counted page turns, and this
host never set it. It does now — this shell draws pixels, which is a fact
-rather than a question (the tty backend has to ask the terminal about
+rather than a question (the tui backend has to ask the terminal about
kitty-graphics support; the SDL one just says yes, as we do).
The transport is `pardes_image_s`, walked with `pardes_frame_images` /
@@ -1122,7 +1122,7 @@ used for the table and is not folded into the direct-path claim.
## Not implemented
- **The `lsp` effect.** Needs a worker plus a snapshot of the pane's path and
- content taken *before* it starts, as `LspJob` in `tty.zig` does; the core
+ content taken *before* it starts, as `LspJob` in `tui.zig` does; the core
keeps editing while a query is in flight. Until then every query is answered
with an EMPTY `lsp_resp` rather than dropped — dropping one leaves the
keystroke that asked (insert-mode Tab after a dot) waiting forever, and dead
diff --git a/docs/next-daemon.md b/docs/next-daemon.md
index 5537bf1a..9865e315 100644
--- a/docs/next-daemon.md
+++ b/docs/next-daemon.md
@@ -448,7 +448,7 @@ microseconds.
Gates, on the line rebased onto main's screen-state terminals (mnlwlpvk):
-- `zig build replay -Dplatform=tty`: 113 snapshot scripts pass (the 110,
+- `zig build replay -Dplatform=tui`: 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
@@ -488,9 +488,9 @@ Everything of ours lives in `/root/pardes-test`, nothing outside it.
```sh
export PATH=$HOME/.local/bin:$PATH
E='env -u PARDES_PID -u PARDES_PANE -u PARDES_9P'
- $E zig build -Dplatform=tty -Dtarget=x86_64-freebsd.15.0 >log 2>&1
+ $E zig build -Dplatform=tui -Dtarget=x86_64-freebsd.15.0 >log 2>&1
# zig-out/bin/pardes-freebsd-x86_64
- $E zig build test-install -Dplatform=tty -Dtarget=x86_64-freebsd.15.0 >log 2>&1
+ $E zig build test-install -Dplatform=tui -Dtarget=x86_64-freebsd.15.0 >log 2>&1
# zig-out/test/{main,panes,kitty,9p,fonts,...}, named for their root files
```
@@ -760,7 +760,7 @@ thread start in the render).
## Tty throughput notes
-Found and fixed 2026-10-29 (`src/tty/tty.zig`, `waitInput`).
+Found and fixed 2026-10-29 (`src/tui/tui.zig`, `waitInput`).
- **What the 1 GB `yes` cell measures is mostly the kernel.** A pty's
output processing (ONLCR, a `\n` made `\r\n`) costs the writer about
@@ -907,7 +907,7 @@ against that tty, is the Tty throughput notes' keystroke-to-present.
tapes, plus real vim, nvim, htop, less and btop sessions recorded
through a pty. Its corpus and recorder are in `.scratch/daemon/term`.
- **Numbers** (ReleaseFast: `PARDES_SCREEN_STATE=<dir> zig build core-test
- -Dplatform=tty -Doptimize=ReleaseFast -Dtest-filter=screen_state`, which
+ -Dplatform=tui -Doptimize=ReleaseFast -Dtest-filter=screen_state`, which
runs under std.testing's checking allocator):
- Encode, 200x60, every row new: p50 250 us, p99 487 us, 29.8 KB.
- Encode, 200x60, nothing new: p50 71 us, p99 139 us, 534 bytes. That
@@ -2180,7 +2180,7 @@ scripts are in `.scratch/daemon/remote/t2/`.
`terminal.cellAt` (the final gate's notes, at the end).
The gates, once at the end (Debug unless said):
-- `zig build unit-test -Dplatform=tty` passes, its perf gate too;
+- `zig build unit-test -Dplatform=tui` passes, its perf gate too;
`-Dplatform=gui` 1563 of 1575, 10 skipped, and the two that fail on main
already (`tagline pointer mapping...`, `a tag caret past its row's
end...`).
@@ -2800,7 +2800,7 @@ The hook for the remote client (its `Replica` and stream as they are):
Measured.
-- **The harness** (`zig build replicas -Dplatform=tty -- --echo`): one
+- **The harness** (`zig build replicas -Dplatform=tui -- --echo`): one
authority and one replica over part A's delayed, jittered link, the
authority's pty a shell played in the harness (`FakeShell`): a line
editor at a prompt with pardes's marks and Tab completion, and the
@@ -2885,7 +2885,7 @@ The gates:
rendered otherwise than predicted; it passes at 20 seeds, Debug and
ReleaseFast. `zig build replicas` passes at 20 seeds, ReleaseFast (and 4
in Debug).
-- Unit tests tty (`zig build unit-test -Dplatform=tty`, its perf gate
+- Unit tests tty (`zig build unit-test -Dplatform=tui`, its perf gate
too), the full `core-test`, and the 113 snapshot scripts pass; the GUI
build's echo tests pass (`core-test -Dplatform=gui`).
@@ -2957,7 +2957,7 @@ the installed (ReleaseSafe) binaries through the suites that start a real
pardes.
Gates, Debug unless said:
-- `core-test`, `unit-test -Dplatform=tty` (its perf gate too), `snap`
+- `core-test`, `unit-test -Dplatform=tui` (its perf gate too), `snap`
(113/113), `replay`, `replicas` (no divergence, no wrong delta at
30/80/207 ms), `9p-io-test`, `fs-test`, `test/daemon.py` (20 cycles),
`test/daemon.py --upgrade`, `test/fs.py`: all pass.
@@ -3209,7 +3209,7 @@ Gates (Debug unless said; scripts and logs in `.scratch/daemon/amort/`):
- **Suites**, once at the end: `core-test` (its run beside the box
measurements had the 9P failure above; again, all pass), `unit-test
- -Dplatform=tty` (its perf gate, and shared-libs-check, which now refuses
+ -Dplatform=tui` (its perf gate, and shared-libs-check, which now refuses
a second zstd too), `snap` 113 of 113, `replay` (113 scripts, 20 monkey
seeds, none panicked or diverged), `replicas`, `9p-io-test`, `fs-test`,
`test/daemon.py` 20 cycles (its far clients included), `--upgrade`
@@ -3521,7 +3521,7 @@ Gates (Debug unless said; scripts and logs in `.scratch/daemon/guirep/`):
cycles, a second window detached alone): pass, Debug and ReleaseSafe
(SDL's offscreen driver).
- **Suites**, once at the end (before the tests' fix and the rebase below):
- `core-test -Dplatform=tty`, `unit-test -Dplatform=tty` (its perf gate),
+ `core-test -Dplatform=tui`, `unit-test -Dplatform=tui` (its perf gate),
`snap` 113 of 113, `replay` (113 scripts, 20 monkey seeds, none panicked
or diverged), `replicas`, `9p-io-test`, `fs-test`, `test/daemon.py` 20
cycles, `--window-clients`, `--upgrade` (unstamped Debug to stamped),
diff --git a/docs/next-pdfrender.md b/docs/next-pdfrender.md
index e006aa48..4c8565d8 100644
--- a/docs/next-pdfrender.md
+++ b/docs/next-pdfrender.md
@@ -217,7 +217,7 @@ Look.
`mupdf-check` (25, the lanes test among them); unit filters `PDF`, `pdf`,
`off the loop`, `kept pages`, `page sizes off the loop`, `watch`,
`JumpScope`, `Back`, `jump`, `Jump`, `Recent`, `a PDF's jumps`: green. The
-snapshot suite (`zig build snap -Dplatform=tty`): all 110 scripts. The tty
+snapshot suite (`zig build snap -Dplatform=tui`): all 110 scripts. The tty
compiles (the suite builds it). The two baseline failures were not run.
## Open questions and positions
diff --git a/docs/next-tests.md b/docs/next-tests.md
index a3f298ff..a16a7cf9 100644
--- a/docs/next-tests.md
+++ b/docs/next-tests.md
@@ -52,7 +52,7 @@ agent's survey. The `e2e` line (kbdin, mousein) is its first step.
Each backend's own (2026-11-04, the user: an effect's test is the
backend's):
- - **`zig build process-test -Dplatform=tty` drives `pardes`, `-Dplatform=gui`
+ - **`zig build process-test -Dplatform=tui` drives `pardes`, `-Dplatform=gui`
drives `pardes-gui`,** hidden (PARDES_TEST, SDL_VIDEO_DRIVER=offscreen,
no display of the user's) on a pty of its own and a 160x50 grid.
`Detached.frame()` waits for the window to say it is idle and reads its
@@ -168,7 +168,7 @@ What the M left need, most first:
a host performs the effect. A Session option that performs saves (and
keeps pty writes) unlocks a group in each area.
- **A real host (T2):** terminals' output and shells, command panes
- finishing, Tty and pty/ctl exec, a missing interpreter.
+ finishing, Term and pty/ctl exec, a missing interpreter.
- **Image panes:** they need the decoder worker Session does not start.
- **LSP:** a fake language server.
- **Not reached yet:** jumps and Back/Forward, Zerox, Get, Restore,
@@ -193,7 +193,7 @@ Traps the migrators found in Session, each now in its tests' code:
`p.panes[`, `.file.?`, `p.rects` and the like.
2. Migrate, in the order the code is to be rewritten: ninep/ctl.zig (its
checks only), test/pdf.zig (step 3 of the pane-kinds plan),
- pardes.zig and test/panes.zig, replica, the gui and tty shells,
+ pardes.zig and test/panes.zig, replica, the gui and tui shells,
host_io. A migrated test must fail on a build broken on purpose.
3. Gaps: a test for each documented behaviour with none.
4. Delete the M and X tests the new ones cover.
diff --git a/docs/render-pipeline.md b/docs/render-pipeline.md
index 9d41f7fa..ba5d131e 100644
--- a/docs/render-pipeline.md
+++ b/docs/render-pipeline.md
@@ -27,7 +27,7 @@ Ticks (`Event.tick`) are produced by six different clocks:
| shell | who ticks | cadence |
|---|---|---|
-| tty | `tickWatch` thread: nanosleep 16 ms **after** the wait asked, then `postEvent(.tick)` (tty.zig:1513) | 16 ms + frame time: drifts slow, worse over ssh |
+| tty | `tickWatch` thread: nanosleep 16 ms **after** the wait asked, then `postEvent(.tick)` (tui.zig:1513) | 16 ms + frame time: drifts slow, worse over ssh |
| gui | `AnimationClock.due` in `postPresent` re-arms `now+16ms` (gui.zig:203, 221, 4095) | a tick only once ≥16 ms have passed since the re-arm: at 144 Hz every 3rd frame (20.8 ms) → animations ~25% slow; at 120 Hz every 2nd; a slow frame slows them further |
| gui grid mode | every `poll_frame` while active (gui.zig ~4114) | as fast as the loop |
| web | JS rAF fixed-step bank, capped (app.mjs:566) | correct average rate, always ticking |
@@ -38,7 +38,7 @@ So the same animation runs at different speeds per shell. Everything counts
16 ms frames (`layout.Animation.frame_ms`, layout.zig:2041).
Acknowledgement is also per shell: tty `postPresent` acks the tracks it drew
-(tty.zig:1187), GUI acks then ticks (`finishPresentedAnimationFrame`), grid mode
+(tui.zig:1187), GUI acks then ticks (`finishPresentedAnimationFrame`), grid mode
acks `&.{}`, macOS acks via `pardes_frame_presented`, **web never acks**.
### 1.2 Core render (`Pardes.render`, pardes.zig:5950), in code order
@@ -83,7 +83,7 @@ set `cell.hover`, 378-385 — a side channel for macOS glass).
### 1.4 Shells
-- **tty** (tty.zig:1100): `panel_compositor.compose` rewrites cells for
+- **tty** (tui.zig:1100): `panel_compositor.compose` rewrites cells for
slide/zoom/dissolve/vertical → `paintCells` (win.clear + every cell) → kitty
images (hidden while geometry moves) → cursor → `vx.render` (vaxis diffs
against its last screen, wraps in sync 2026). Layers are ignored.
@@ -698,8 +698,8 @@ character effects (ascii…typewriter) → not a GUI effect (terminal track).
### 9.2 Terminal track (tty, cell-native; separate, smaller)
-Where: presentation-only cell rewrites in the tty shell after the canonical
-grid (`tty/panel_compositor.zig` grows into the tty compositor), never in the
+Where: presentation-only cell rewrites in the tui shell after the canonical
+grid (`tui/panel_compositor.zig` grows into the tty compositor), never in the
canonical grid, so 9P/goldens stay clean with effects off. Gated on truecolor
(vaxis caps / COLORTERM) — static effects may quantise to 256, animated ones
turn off below truecolor. Safe glyph set by default (░▒▓ ▀▄▌▐ ▖▗▘▝);
diff --git a/docs/shared-libs.md b/docs/shared-libs.md
index ce0c7d3f..0a78f207 100644
--- a/docs/shared-libs.md
+++ b/docs/shared-libs.md
@@ -13,7 +13,7 @@ The policy (2026-09-24):
would clobber a patch made in zig-pkg.
- **This file lists what is shared, and where the policy could not be met.**
-`zig build shared-libs-check -Dplatform=tty|gui` (it also runs with every
+`zig build shared-libs-check -Dplatform=tui|gui` (it also runs with every
`unit-test`) reads the linked binary's ELF symbol table. It fails when a family
the build chose against is linked again: stb_image's PNG, JPEG or inflate
beside wuffs, a second stb_image, stb_image_write's deflate, a second zlib, or
diff --git a/docs/site/README b/docs/site/README
index 41804163..2a9989ff 100644
--- a/docs/site/README
+++ b/docs/site/README
@@ -15,13 +15,13 @@ docs/site: the pardes website, built from docs/typ
is true it shows placeholder.svg instead.
casts/casts.toml the terminal recordings (asciicast v2), in order: name,
title, caption, cols, rows, ready; casts/N.cast each.
- test/record_casts.py records them from a tty pardes
+ test/record_casts.py records them from a tui pardes
and writes this file.
Build (from the repo root):
typst compile --root . --format bundle --features bundle,html docs/site/site.typ OUT
- zig build site -Dplatform=tty --prefix DIR # DIR/share/doc/pardes/site/
+ zig build site -Dplatform=tui --prefix DIR # DIR/share/doc/pardes/site/
Every page sits at the top of OUT and every link is relative, so the site
works from file:// and from any static server. The only prose of the
diff --git a/docs/typ/README b/docs/typ/README
index 9d3913c0..d246c3ed 100644
--- a/docs/typ/README
+++ b/docs/typ/README
@@ -26,10 +26,10 @@ the topics, since the book and the HTML hold them all.
Build (from the repo root):
typst compile --ignore-system-fonts docs/typ/cheatsheet-a4.typ
- zig build cheatsheet -Dplatform=tty --prefix DIR # DIR/share/doc/pardes/cheatsheet.pdf
+ zig build cheatsheet -Dplatform=tui --prefix DIR # DIR/share/doc/pardes/cheatsheet.pdf
typst compile --root . --ignore-system-fonts docs/typ/book.typ
typst compile --root . --format bundle --features bundle,html docs/site/site.typ OUT
- zig build site -Dplatform=tty --prefix DIR # DIR/share/doc/pardes/site/
+ zig build site -Dplatform=tui --prefix DIR # DIR/share/doc/pardes/site/
(--root . because book and HTML read the tutor from src/tutor.txt.)
The contract for content files
@@ -45,7 +45,7 @@ new function instead.
word(w) a builtin or tag word, drawn as a chip on the tag's
ground; a builtin links to its entry in the Builtins
chapter wherever that chapter is in the same output.
- #word("Save") #word("Tty+bash")
+ #word("Save") #word("Term+bash")
key(k) one press, or a sequence of presses separated by
spaces, drawn as one pill (Ctrl + w, g › g).
Modifiers: Ctrl-, Alt-, Shift-.
@@ -59,7 +59,7 @@ new function instead.
#chord("B2", "B1") #chord("B1", "B2", "B3")
tag(words, path:)
a whole default tagline; words must be a default tag.
- #tag("Save Tty Collapse Del", path: "/home/me/notes.txt")
+ #tag("Save Term Collapse Del", path: "/home/me/notes.txt")
addr(a) a look address. #addr("file:12:5")
file(p) a 9P path. #file("pane/N/addr")
cmd(c) a shell line, as a block. #cmd("echo Save > $m/pane/$n/ctl")
@@ -102,12 +102,12 @@ new function instead.
Builtins
--------
-builtins-tty.json and builtins-gui.json are every builtin of the terminal
+builtins-tui.json and builtins-gui.json are every builtin of the terminal
and the window build (name, leader, Help's other shortcuts, arg, scope,
-setting, choices, doc), written by `zig build builtins-json -Dplatform=tty`
+setting, choices, doc), written by `zig build builtins-json -Dplatform=tui`
and `-Dplatform=gui` from the registry and the Help rows
(src/builtins_json.zig). style.typ merges them, marking each word "both",
-"tty" or "gui". The doc steps refresh their build's file first, and each
+"tui" or "gui". The doc steps refresh their build's file first, and each
build's unit-test fails when its file is stale. #word takes a name from
either file. builtins.typ draws it as the
glossary; `everyday`, `internals` and `builtin-groups` in style.typ say
diff --git a/docs/typ/building.typ b/docs/typ/building.typ
index c6ca4e36..24229f08 100644
--- a/docs/typ/building.typ
+++ b/docs/typ/building.typ
@@ -17,7 +17,7 @@ builds MuPDF and is on by default (`-Dmupdf=false` drops it). 9P over QUIC
#pairs(
[`zig build`], [the terminal shell and the SDL window together, *installed into `~/.local/bin`* (`pardes` and `pardes-gui`)],
- [`zig build -Dplatform=tty`], [the terminal shell alone],
+ [`zig build -Dplatform=tui`], [the terminal shell alone],
[`zig build -Dplatform=gui`], [the SDL3 window alone],
[`zig build web -Dplatform=web -Dtarget=wasm32-freestanding -Ddump=<file>`], [a freestanding wasm core plus vanilla JavaScript (`docs/web.md`)],
[`zig build -Dplatform=macos`], [an AppKit and CoreText app over a static `libpardes.a` (`docs/macos.md`)],
@@ -45,7 +45,7 @@ there; its namespace is in `src/esp32p4_gpio.zig`.
`zig build --help` lists the options for the selected platform.
#pairs(
- [`-Dplatform`], [`tty`, `gui`, `web`, `macos`, `esp32p4`; absent: the tty and SDL shells together, installed into `~/.local`],
+ [`-Dplatform`], [`tui`, `gui`, `web`, `macos`, `esp32p4`; absent: the tui and SDL shells together, installed into `~/.local`],
[`-Dstatic`], [bool, `false`],
[`-Dquic`], [bool, `false`: 9P over QUIC with system OpenSSL 3.6+],
[`-Dmupdf`], [bool; on natively, off for web and esp32p4],
@@ -75,7 +75,7 @@ zig build core-test core tests without native shell tests
zig build pane-test pane, output, PDF and namespace integration tests
zig build kitty-test kitty graphics conformance of terminal panes, at the core
zig build kitty-harness kitty graphics through a pane end to end (a fake kitty
- terminal outside on the tty, the GPU capture on the gui;
+ terminal outside on the tui, the GPU capture on the gui;
kitten icat and chafa too when installed)
zig build syntax-test tree-sitter tests without building the editor
zig build syntax deterministic per-byte highlighting snapshots
@@ -104,7 +104,7 @@ zig build cheatsheet render the cheatsheet PDF (needs typst)
reading its diff, never all), `snap -- --no-retry` makes the first
failure decisive. Snapshot scripts can use `snap9p` to capture core cells
through 9P.
-- `zig build monkey -Dplatform=tty -- <seeds> [steps] [--from=N] [--out=DIR] [--keep]` writes one random script per seed and keeps any
+- `zig build monkey -Dplatform=tui -- <seeds> [steps] [--from=N] [--out=DIR] [--keep]` writes one random script per seed and keeps any
that panics; a seed always makes the same script. Each crash found gets a
fix and a regression script in `test/snapshots/`.
- The tutor's practice blocks (`# keys:`, `# before`, `# after` in
@@ -126,10 +126,10 @@ zig build cheatsheet render the cheatsheet PDF (needs typst)
== Release gates
-A release passes all of these first: `unit-test` with `-Dplatform=tty` and
+A release passes all of these first: `unit-test` with `-Dplatform=tui` and
with `-Dplatform=gui`, `core-test`, `behaviour-test`, `process-test`, `snap`, the GUI goldens
(`python3 -B test/gui_golden.py <a Debug pardes-gui>`, a hidden window),
-`web`, and the ReleaseSafe tty and ReleaseFast gui builds. The committed
+`web`, and the ReleaseSafe tui and ReleaseFast gui builds. The committed
`docs/typ/cheatsheet-a4.pdf` is rendered again when the docs change.
= Sending patches <patches>
@@ -142,7 +142,7 @@ Mail patches to the list `~gbrls/[email protected]`; it is the preferred way to
= The core and its shells
-One core, five shells (tty, gui, web, macos, esp32p4). The core owns
+One core, five shells (tui, gui, web, macos, esp32p4). The core owns
editing, layout, rendering and the virtual filesystem it serves over 9P; a shell turns native
input into `pardes.Event`, presents `pardes.Surface`, and performs host
effects such as spawning processes.
@@ -165,7 +165,7 @@ effects such as spawning processes.
that the tests use. Comptime decides what a build has (`pardes.platform`,
`hosted`, `can_attach`, `terminal_panes`, `pdf_enabled`); the vtable
decides who serves it.
-- The root module is chosen by platform: `main.zig` (tty, gui),
+- The root module is chosen by platform: `main.zig` (tui, gui),
`web.zig`, `macos.zig`, `esp32p4.zig`. The web and macOS shells are
libraries whose host owns `main()`.
- `memory.limits` is the one home for capacities that differ on the ESP32-P4
diff --git a/docs/typ/builtins-gui.json b/docs/typ/builtins-gui.json
index c7553186..a78c2af0 100644
--- a/docs/typ/builtins-gui.json
+++ b/docs/typ/builtins-gui.json
@@ -137,6 +137,7 @@
{"name": "Tab", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "A tab's width in cells, 1 through 16, in every pane; bare, it says the width."},
{"name": "Tagbottom", "leader": "SPC t b", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Each pane's tag goes at its foot rather than its head, on or off."},
{"name": "TaglineSize", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "Scale the tag font, a percentage."},
+ {"name": "Term", "leader": "SPC n t", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "A shell in the calling pane's directory, raw from the first frame."},
{"name": "TermImages", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "real, petscii", "doc": "How a new terminal draws its program's kitty graphics: real, as pixels where it can, or petscii, as glyph art."},
{"name": "Theme", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "Switch to the named theme."},
{"name": "ThemeFile", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Load a theme from a file."},
@@ -145,7 +146,6 @@
{"name": "Togglettymode", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Switch this terminal between raw program input and normal editor mode."},
{"name": "TreeContext", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Show the declarations enclosing the top row at the pane's head, on or off."},
{"name": "TreeContextTagStyle", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A pane's TreeContext rows draw in the tag's style, on or off."},
- {"name": "Tty", "leader": "SPC n t", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "A shell in the calling pane's directory, raw from the first frame."},
{"name": "Tutor", "leader": "SPC h t", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the tutor, a document to work through."},
{"name": "Unattach", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Unattach a pane from the pane it answers for: it stays where it is, a pane of its own, and the next search from that pane opens another under it."},
{"name": "Undo", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "acme's Undo and Redo: step the pane's body back or forward through its edits, from a tag, a pane ctl or exec."},
diff --git a/docs/typ/builtins-tty.json b/docs/typ/builtins-tui.json
index 613627a7..7592a745 100644
--- a/docs/typ/builtins-tty.json
+++ b/docs/typ/builtins-tui.json
@@ -120,6 +120,7 @@
{"name": "SyntaxBold", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Keywords and the like are drawn bold, on or off."},
{"name": "Tab", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "A tab's width in cells, 1 through 16, in every pane; bare, it says the width."},
{"name": "Tagbottom", "leader": "SPC t b", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Each pane's tag goes at its foot rather than its head, on or off."},
+ {"name": "Term", "leader": "SPC n t", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "A shell in the calling pane's directory, raw from the first frame."},
{"name": "TermImages", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "real, petscii", "doc": "How a new terminal draws its program's kitty graphics: real, as pixels where it can, or petscii, as glyph art."},
{"name": "Theme", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "Switch to the named theme."},
{"name": "ThemeFile", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Load a theme from a file."},
@@ -128,7 +129,6 @@
{"name": "Togglettymode", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Switch this terminal between raw program input and normal editor mode."},
{"name": "TreeContext", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Show the declarations enclosing the top row at the pane's head, on or off."},
{"name": "TreeContextTagStyle", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A pane's TreeContext rows draw in the tag's style, on or off."},
- {"name": "Tty", "leader": "SPC n t", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "A shell in the calling pane's directory, raw from the first frame."},
{"name": "Tutor", "leader": "SPC h t", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the tutor, a document to work through."},
{"name": "Unattach", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Unattach a pane from the pane it answers for: it stays where it is, a pane of its own, and the next search from that pane opens another under it."},
{"name": "Undo", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "acme's Undo and Redo: step the pane's body back or forward through its edits, from a tag, a pane ctl or exec."},
diff --git a/docs/typ/builtins.typ b/docs/typ/builtins.typ
index 8375d5de..be069823 100644
--- a/docs/typ/builtins.typ
+++ b/docs/typ/builtins.typ
@@ -1,5 +1,5 @@
// Every builtin: the words you click in a tag (Exec runs them) or type as
-// commands. The entries come from docs/typ/builtins-tty.json and
+// commands. The entries come from docs/typ/builtins-tui.json and
// builtins-gui.json, which
// `zig build builtins-json` writes from the registry and the Help rows,
// so this chapter and Help cannot drift.
diff --git a/docs/typ/cheatsheet.typ b/docs/typ/cheatsheet.typ
index a70b56e2..0e984efe 100644
--- a/docs/typ/cheatsheet.typ
+++ b/docs/typ/cheatsheet.typ
@@ -25,10 +25,10 @@ One button: Alt/Option-click is #btn("B2"), Cmd/Super-click #btn("B3"), sweeps t
== Tags
#tag("Newcol Joincol Find Grep Help Changelog Tutor Dump Themes Config Debug Exit")
-#tag("New Tty Find Grep Joincol Delcol")
-#tag("Save Tty Collapse Del", path: "/home/me/notes.txt")
-#tag("Tty+bash Save Mode Filter Collapse Del", path: "/home/me/src")
-#tag("Tty PdfSections PdfTint PdfFit Collapse Del", path: "manual.pdf [1/12]")
+#tag("New Term Find Grep Joincol Delcol")
+#tag("Save Term Collapse Del", path: "/home/me/notes.txt")
+#tag("Term+bash Save Mode Filter Collapse Del", path: "/home/me/src")
+#tag("Term PdfSections PdfTint PdfFit Collapse Del", path: "manual.pdf [1/12]")
- #word("Del") over unsaved text refuses once; again discards. #word("Del") `j`: rows below. #key("SPC d") between two panes takes #key("k") (rows above) or #key("j") (below), asking only if you pause.
- #word("Undo") #word("Redo") #word("Edit") #word("Mode") work typed anywhere. #doc("tags")
@@ -91,7 +91,7 @@ Helix-style: motions *select*, then an edit acts on the selection. Mode box: bla
key("SPC s s"), [declarations],
key("SPC f c"), word("Config"),
key("SPC d"), word("Del"),
- key("SPC n t"), word("Tty"),
+ key("SPC n t"), word("Term"),
key("SPC w"), word("Window"),
key("SPC j j"), word("Last"),
key("SPC j l"), word("Jumplist"),
@@ -111,7 +111,7 @@ Helix-style: motions *select*, then an edit acts on the selection. Mode box: bla
)
== Terminals and commands
-- #key("Ctrl-b"): raw (`$`) or normal. #word("Mode") cycles raw, normal, insert. #word("Filter"), #word("Tty+bash").
+- #key("Ctrl-b"): raw (`$`) or normal. #word("Mode") cycles raw, normal, insert. #word("Filter"), #word("Term+bash").
- #btn("B2") on a non-builtin line runs it in a *command pane*: #tag("Kill Save Collapse Del", path: "/home/me/src (make) exit 0")
- #word("Kill") `make` stops it; #word("Exit") quits. #word("Repl") `python`: `.py` clicks go to it.
diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ
index 74a0df86..d45f5cc5 100644
--- a/docs/typ/guide.typ
+++ b/docs/typ/guide.typ
@@ -32,7 +32,7 @@ Each pane keeps its own mode. The box left of its tag shows it.
#pairs(
[#mode-box(" ") normal], [keys move and select; an edit acts on the selection. File and PDF panes start here, and so does a terminal from #key("Alt-n").],
[#mode-box("^") insert], [keys type. #keys("i", "a", "o") and the rest enter it.],
- [#mode-box("$") raw, terminals only], [keys go to the program. A terminal from #word("Tty"), the shell a bare `pardes` starts with, and a command pane start here.],
+ [#mode-box("$") raw, terminals only], [keys go to the program. A terminal from #word("Term"), the shell a bare `pardes` starts with, and a command pane start here.],
)
#key("Ctrl-b") switches a terminal between raw and normal. In normal,
@@ -93,8 +93,8 @@ the registers. #key("SPC y") and #key("SPC p") use the system clipboard.
= Tags <tags>
#tag("Newcol Joincol Find Grep Help Changelog Tutor Dump Themes Config Debug Exit")
-#tag("New Tty Find Grep Joincol Delcol")
-#tag("Save Tty Collapse Del", path: "/home/me/notes.txt")
+#tag("New Term Find Grep Joincol Delcol")
+#tag("Save Term Collapse Del", path: "/home/me/notes.txt")
A tag is text with undo. Type `make` into one and #word("Exec") it, or
delete the words you never use. Any word runs from any tag: #word("Exit")
@@ -227,10 +227,10 @@ do nothing.
= Terminals <terminals>
-#tag("Tty+bash Save Mode Filter Collapse Del", path: "/home/me/src")
+#tag("Term+bash Save Mode Filter Collapse Del", path: "/home/me/src")
-- #word("Tty") opens a terminal in the pane's directory, #key("Alt-n") one in
- the session's directory; #word("Tty+bash") picks the shell.
+- #word("Term") opens a terminal in the pane's directory, #key("Alt-n") one in
+ the session's directory; #word("Term+bash") picks the shell.
- #word("Del") closes a terminal and its shell at once, running or not, and
a shell that exits closes its pane.
- #word("Save") writes the scrollback to a path it asks for.
diff --git a/docs/typ/install.typ b/docs/typ/install.typ
index d97d30f7..7489d069 100644
--- a/docs/typ/install.typ
+++ b/docs/typ/install.typ
@@ -20,6 +20,6 @@
With Zig 0.17 (the build fetches everything else; once that is
downloaded, a first build from a clean cache took 62 seconds on 16 cores):
-#cmd("# pardes, in a terminal\nzig build -Dplatform=tty --prefix ~/.local")
+#cmd("# pardes, in a terminal\nzig build -Dplatform=tui --prefix ~/.local")
#cmd("# pardes-gui, its own window\nzig build -Dplatform=gui --prefix ~/.local")
Then run `pardes` or `pardes FILE`.
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index b272306c..0669780a 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -39,7 +39,7 @@ tagexec a word clicked in the workspace tag @co
col/ the columns @columns-and-tags
<n>/ column <n>; rmdir closes it when empty @columns-and-tags
tag its tag
- ctl its builtins (Delcol Joincol New Tty)
+ ctl its builtins (Delcol Joincol New Term)
exec a word clicked in its tag
pane/ the panes @panes
new open it to make a pane; read answers the serial @panes
@@ -291,6 +291,7 @@ A line written to #file("exec") is #word("Exec"):
`Abort`) are refused, `invalid: acme's Snarf is not a pardes builtin: ...`,
never run as commands. So is a GUI-only builtin (#word("Fonts")) on
another frontend.
+- `Tty` is #word("Term")'s old name, run as it, `Tty+fish` too.
- Anything else is a command line (a typo ends `exit 127`), at most 1024 bytes, run as the guide
says (#doc("tags", section: "command-panes")): typed into a terminal idle
at an empty prompt, else run in a command pane. #file("exec") reads back
@@ -399,7 +400,7 @@ Writes take settings and session builtins (`scope = .session` in
rows (`size: too small for the panes, each its tag and 2 rows`). A bad
`size` is refused quoting the value it got (`"5 2"`).
-A word that takes its argument after a `+` (#word("Tty+bash")) works on a ctl as
+A word that takes its argument after a `+` (#word("Term+bash")) works on a ctl as
in a tag. A write is refused whole, before anything runs, in Plan 9's
words:
`unknown control message "X"`, `wrong #args in control message "X"`, `bad value in control message ...`, or a word of the other ctl: `not a session control message "Undo": write it to pane/<n>/ctl`, `... "Delcol": write it to col/<serial>/ctl`, `not a window control message "X": write it to /ctl`. A builtin that would open a prompt (#word("Save") on a scratch)
@@ -431,7 +432,7 @@ word clicked in a tag does. The same lines go in the startup file
[#word("LookWord") `search|list`], [`search`: a word given to #word("Look") selects its next place, or lists all in `+Search`],
[#word("DirLook") `pane|terminal`], [`pane`: #word("Look") on a directory opens a pane listing it, as acme's directory window (#doc("reference", section: "from-acme")); `terminal` types `ls` into a terminal idle there, else opens one],
[#word("JumpScope") `file|all`], [`file`: #word("Back") and #word("Forward") keep to the focused pane's file, that pane's places first, then the file's in another pane, and go to another file only when the file has no place left that way; from a terminal or a pane with no file they step through every place; `all`: every place, in the order it was jumped to],
- [#word("TermImages") `real|petscii`], [`real`: a new terminal draws its program's kitty graphics (yazi's previews) as pixels where the shell can; #word("Petscii") flips one terminal; a tty under a terminal without kitty graphics draws them as glyph art either way],
+ [#word("TermImages") `real|petscii`], [`real`: a new terminal draws its program's kitty graphics (yazi's previews) as pixels where the shell can; #word("Petscii") flips one terminal; a tui under a terminal without kitty graphics draws them as glyph art either way],
[#word("Shell") `<name or path>`], [`$SHELL` when it is executable, else `/bin/sh`: the shell the next terminal and command pane run; a bare name is searched for in the usual bin directories, not `$PATH`; bare #word("Shell"): `$SHELL` if it is executable, else `/bin/sh`],
[#word("DumpDir") `<dir>`], [`$XDG_DATA_HOME/pardes`, else `~/.local/share/pardes`: where #word("Dump") writes, an absolute or `~` path to a directory that may be written (made if missing); a relative one, or one under a directory that may not be written, is refused; bare returns to the default],
[#word("TreeContext")], [off: sticky declaration headers in a source pane (per pane, dumped)],
@@ -500,7 +501,7 @@ and leave one under its tag and two rows (`Newcol: no space for a column: the pa
alone and uses up no column serial.
#file("/col/<n>/ctl") takes #word("Delcol"), #word("Joincol"),
-#word("New") and #word("Tty") for that column; #file("/col/<n>/exec") is
+#word("New") and #word("Term") for that column; #file("/col/<n>/exec") is
a click in its tag; `rmdir /col/<n>` closes an empty column (one with
panes: ENOTEMPTY). Closing a column's last pane leaves it empty (the
keyboard goes to its tag, #file("focus") reads empty, the log says only
@@ -534,7 +535,7 @@ tag would (#doc("fs", section: "placement")): in the active column,
filling it if empty, else the bottom half of its last pane. A session
holds 64 panes (`no space for a pane: 64 max`), and every pane keeps its
tag and 2 rows (`no space for a pane in that column: each keeps its tag and 2 rows`); both are ENOSPC, for this open and for #word("Look"), #word("Exec"),
-#word("New") or #word("Tty") alike. A #file("pane/new") whose column is
+#word("New") or #word("Term") alike. A #file("pane/new") whose column is
full takes its rows from a pane in another column that has them, last
column first, as acme does, and is refused only when no pane anywhere can
give them. `rmdir /pane/<n>` closes the pane, unsaved or not.
@@ -608,7 +609,7 @@ takes:
below), #word("Save") `[path]` (bare, on a `+`-named pane that is no output,
such as `+Tutor`, it asks for a path; making the directories the file goes in first,
whichever name it writes), #word("Collapse"), #word("Undo")/#word("Redo")
- (256 steps each), #word("Find") `pat`, #word("Edit") `...`, #word("Tty") `[shell]` (a new terminal
+ (256 steps each), #word("Find") `pat`, #word("Edit") `...`, #word("Term") `[shell]` (a new terminal
in its directory), #word("Delcol") for its column, and
#word("Left")/#word("Right")/#word("Up")/#word("Down"), which give the
keyboard to the pane beside it that way, up from a column's top pane to
@@ -988,7 +989,7 @@ asked, else the active column (last typed or left-clicked in,
dropped into, its tag given the keyboard, or given the last new pane),
never a new column. An empty column it takes whole; #word("New") and
#file("pane/new") take the bottom half of the column's last pane; a pane
-opened from a pane's text (#word("Look"), #word("Tty"), #key("Alt-n")) goes under
+opened from a pane's text (#word("Look"), #word("Term"), #key("Alt-n")) goes under
the pane with the most blank rows, or halves the biggest. #word("New") in a
pane's tag names its `+New` in that pane's directory and column; from a
column tag, in that column and the session's directory. A command pane
@@ -1162,7 +1163,7 @@ with Client(sys.argv[1]) as c: # a socket path, or (ip, port)
[`Font`, `Send`, `ID`], [#word("Font"); #word("Repl") and #word("Exec"); `$winid`],
[acme's other builtins], [refused: `Sort`, `Local`, `Abort` (plan9port's debugging word)],
[Edit], [every acme command but `B <cmd`, `D <cmd` and the `'` address; no `\1`-`\9`, and an alternation takes the first branch that matches, not the longest; a failing `< | >` command changes nothing, where acme puts in what it wrote (#doc("fs", section: "edit"))],
- [`win`], [#word("Tty") is a VT terminal pane; #file("pty/run") runs a line at its prompt and answers `exit N` and the output; with #word("Repl") bound, #word("Exec") on a source pane types the text into it],
+ [`win`], [#word("Term") is a VT terminal pane; #file("pty/run") runs a line at its prompt and answers `exit N` and the output; with #word("Repl") bound, #word("Exec") on a source pane types the text into it],
[a directory window], [as acme's: a text pane named `dir/` (#file("index") kind `text`, #file("ctl") isdir 1), its entries in columns sorted bytewise, dotfiles shown, a directory's marked `/`; blanks pad the columns where acme's tabs do; a #word("Look") at an entry is from that directory, `Get` or a look at it again reads it again, and an edit is kept until then rather than lost to a resize; never dirty, #word("Save") refuses it; #word("DirLook") `terminal` types `ls` into a terminal there instead],
[the plumber], [none: #word("Look") on an `http://` or `https://` URL runs `xdg-open` (`open` on macOS); files, addresses and directories follow built-in rules],
[#key("Esc") selects what was typed], [#key("Esc") leaves insert mode, or goes back a pane (#doc("tags", section: "modes"))],
diff --git a/docs/typ/style.typ b/docs/typ/style.typ
index b5c2ff85..e2eafc87 100644
--- a/docs/typ/style.typ
+++ b/docs/typ/style.typ
@@ -186,16 +186,16 @@
/// Every builtin of either build, written by `zig build builtins-json`
/// from the registry and the Help rows (src/builtins_json.zig), a file per
/// build: name, leader, also (Help's other shortcuts), arg, scope, setting,
-/// choices, doc. Merged here, each with `platforms`: "both", "tty" (the
+/// choices, doc. Merged here, each with `platforms`: "both", "tui" (the
/// terminal only) or "gui" (the window only).
#let builtin-data = {
- let tty = json("builtins-tty.json")
+ let tui = json("builtins-tui.json")
let gui = json("builtins-gui.json")
- let in-tty = tty.map(b => b.name)
+ let in-tui = tui.map(b => b.name)
let in-gui = gui.map(b => b.name)
- let all = (tty + gui.filter(b => b.name not in in-tty)).sorted(key: b => b.name)
+ let all = (tui + gui.filter(b => b.name not in in-tui)).sorted(key: b => b.name)
all.map(b => {
- b.insert("platforms", if b.name in in-tty and b.name in in-gui { "both" } else if b.name in in-tty { "tty" } else { "gui" })
+ b.insert("platforms", if b.name in in-tui and b.name in in-gui { "both" } else if b.name in in-tui { "tui" } else { "gui" })
b
})
}
@@ -367,7 +367,7 @@
/// The newcomer's words, first in the glossary; every other builtin goes
/// under its group below. Each must be in builtins.json.
#let everyday = ("Look", "Exec", "Save", "Undo", "Redo", "New", "Newcol", "Del", "Delcol",
- "Tty", "Kill", "Find", "Grep", "Recent", "Dump", "Restore", "Exit", "Help", "Tutor", "Themes", "Config")
+ "Term", "Kill", "Find", "Grep", "Recent", "Dump", "Restore", "Exit", "Help", "Tutor", "Themes", "Config")
/// Debugging and developer words, last whatever their leader path.
#let internals = ("Debug", "EffectCode", "Lspwhy", "Messages", "DumpConfig", "DumpThemes")
diff --git a/docs/typ/themes.typ b/docs/typ/themes.typ
index edfaa7ad..6dc92b3b 100644
--- a/docs/typ/themes.typ
+++ b/docs/typ/themes.typ
@@ -39,7 +39,7 @@ syntax identity but are not exact ports; their sources are in
pane's and column's tags shift tone on tone rather than invert: dark
palettes keep dark tags, light ones light tags. The file name in a pane's
path, and `+Search` and the like, take a distinct hue at the same
-brightness as the tag text; a terminal's tag tints its #word("Tty") word
+brightness as the tag text; a terminal's tag tints its #word("Term") word
instead.
Every native palette sets its own ANSI colours, so a terminal's indexed
@@ -110,7 +110,7 @@ take `null`, so older files stay valid:
#pairs(
[`tag_active_bg`, `tag_active_fg`], [the focused pane's tag; a ground closer than 1.25:1 to `tag_bg` is pushed further the way it leans, as far as its text keeps its contrast. Absent: `tag_bg`, `tag_fg`],
- [`tag_name_fg`, `tag_active_name_fg`], [the file name's or a terminal's #word("Tty") tint, in normal and focused tags. Absent: the tag's foreground],
+ [`tag_name_fg`, `tag_active_name_fg`], [the file name's or a terminal's #word("Term") tint, in normal and focused tags. Absent: the tag's foreground],
[`column_box`, `column_box_dim`], [a column's grip held (and its drag rail), and at rest. Absent: `num`; a mix of `column_box` and `tag_bg`],
[`border`], [quiet separators, lifted to 1.6:1 when under 1.5:1 off the page. Absent: `scroll_track`],
[`empty_col`], [a column with no pane, under its tag (acme: white). Absent: `border`],
diff --git a/docs/ui-review.md b/docs/ui-review.md
index 2d785ed8..5c15e950 100644
--- a/docs/ui-review.md
+++ b/docs/ui-review.md
@@ -41,7 +41,7 @@ sent to the user's session.
## Compact rails, classic palettes and workspace pets
`New` now belongs to column tags only. Pane tags keep their local save,
-terminal and close actions: `Tty` opens a terminal, and `Mode`
+terminal and close actions: `Term` opens a terminal, and `Mode`
cycles raw input, normal editing and insert mode. Historical
default pane tails upgrade during Restore; explicitly customized text remains
owned by the user.
@@ -83,7 +83,7 @@ the native contrast tests.
## PDF and terminal tag cleanup
-PDFs now use `filename.pdf [page/total] Tty Del PdfSections PdfTint PdfFit Collapse`,
+PDFs now use `filename.pdf [page/total] Term Del PdfSections PdfTint PdfFit Collapse`,
keeping sections and tint commands visible without the long generated
control/status prefix. Terminal tags include `Mode`, which cycles the body mode
even when invoked from an edited tag. Ctrl-B keeps its two-way toggle.
@@ -101,10 +101,10 @@ The follow-up adds editable workspace and column command rows, compact pane
tags, staged buffer-name edits, and caret reveal for long tags. See [editable tags](typ/guide.typ) for the
exact interaction and save-target rules.
-`test/column_tags.py` exercises isolated SDL and TTY sessions against the same
+`test/column_tags.py` exercises isolated SDL and TUI sessions against the same
Agave source. It sends actual host input bytes while observing through 9P:
header typing and selection replacement, UTF-8 deletion, inactive-column
-`New`/`Tty`, pane-tail edits, filename cancellation, terminal input, and
+`New`/`Term`, pane-tail edits, filename cancellation, terminal input, and
custom-tag Dump/Restore. Source bytes remain unchanged. Input goes through
the host PTY parser; compact SDL pixel coordinates are covered separately by
round-trip mapping tests, not claimed as physical SDL mouse automation.
@@ -175,7 +175,7 @@ python3 -B test/ui_review.py zig-out/ui-review/bin/pardes-gui \
For subsequent palette captures, add `--skip-lsp`. To repeat LSP work without
rebuilding dependencies, use `--cargo-target /path/to/previous/cargo-target`.
Cargo runs offline and stores build output in that isolated directory.
-For the TTY pass, use the TTY binary and add `--tty`. The script requires
+For the TUI pass, use the TUI binary and add `--tty`. The script requires
Find/Grep results and observed terminal output, fails missing or malformed
SDL captures, and writes `report.json` with the actual outcomes. LSP absence
or failure is recorded separately rather than passing as a successful popup.