summaryrefslogtreecommitdiff
path: root/docs/typ/building.typ
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-12 10:56:42 -0300
committerGabriel Schneider <[email protected]>2026-11-17 12:15:01 -0300
commitf2b02c455f2bcdfb905a015eefbb630a28b4b12e (patch)
treec344c7ad42ec288dd5e1ebd0eb6d25f5aa2fbccc /docs/typ/building.typ
parentfc38c73c59f7855a4caad8aa4d3bb8e023309c13 (diff)
downloadpardes-f2b02c455f2bcdfb905a015eefbb630a28b4b12e.tar.gz
pardes-f2b02c455f2bcdfb905a015eefbb630a28b4b12e.zip
addons: an addon can hand the frontend a GPU scene (ABI 3.1), and a snake drawn by shaders does; a commit's patch keeps its own +Diff pane; a real ZLS checked through the window build
ABI 3.1 appends an optional `gpu` callback and its context to pa_paint: one self-contained sketchbook SGPU v1 scene for the pane, at most 4 MiB, copied during the call, the last successful call winning. The SDL frontend runs it on its own GPU through sketchbook's executor and composites its target texture into the pane; replicas carry the scene beside the authoritative pane frame; cells and rasters stay the fallback for terminals, older hosts and frontends without an executor. addons/snake_shader is such an addon (`zig build snake-shader`, the SnakeShader word: a board that follows its pane, buffered turns, a CRT look), with test/gpu_snake.py, test/gpu_snake_interaction.py and test/gpu_upgrade.py. Commit patches open as `+Diff-<short-hash>` and reuse only their own commit's pane, so another paged patch no longer replaces one already open. The language-server client looks in the standard per-user bin directory, which desktop launchers often leave out of PATH, and takes an empty answer that beats the startup progress notification onto the wire; test/real_zls.py checks imports, hover, references, rename previews, diagnostics and completion against a real ZLS from a private home. The dump's schema reader skips two fields older builds persisted, and a replica's shadow of a kind ticks when the authority's does. The reference, the guide, the building and setup notes and the changelog say so. The working copy as it stood on 2026-11-12; message written by Claude from the diff, at the author's request.
Diffstat (limited to 'docs/typ/building.typ')
-rw-r--r--docs/typ/building.typ15
1 files changed, 13 insertions, 2 deletions
diff --git a/docs/typ/building.typ b/docs/typ/building.typ
index 31019116..6bf7dfce 100644
--- a/docs/typ/building.typ
+++ b/docs/typ/building.typ
@@ -41,8 +41,10 @@ system takes the SDK SDL needs with `-Dmacos-sdk=<path>`.
A bare `zig build` installs into the prefix (`zig-out`, or `--prefix
<dir>`) and copies the binaries into `~/.local/bin`; `-Dhome-install=false`
leaves that copy out. Zig 0.17 keeps the prefix from the build script, so
-`--prefix` alone no longer stops it. With `-Dplatform` nothing is copied,
-so always pass `-Dplatform` while developing. Test, benchmark and run steps build what they need
+`--prefix` alone no longer stops it. With `-Dplatform` binaries are not copied. The `image`, `pdf` and
+`addons` steps also install into `$XDG_DATA_HOME/pardes/addons` (else
+`~/.local/share/pardes/addons`); `-Dhome-install=false` skips that copy.
+Pass `-Dplatform` and `-Dhome-install=false` while developing. Test, benchmark and run steps build what they need
without installing. `pardes --version` prints `pardes <version>` (from
`build.zig.zon`), plus the commit for release builds and the `~/.local`
install, and on a second line the build's semantics hash, which a replica
@@ -183,6 +185,15 @@ zig build cheatsheet render the cheatsheet PDF (needs typst)
- `python3 -B test/agent_session.py <pardes> --ready 'text' --min-rows N -- command args` drives an interactive command in a private shell and checks
it through 9P.
+The optional real-server check
+`python3 -B test/real_zls.py GUI_BINARY ZLS_BINARY OUTPUT_DIRECTORY`
+uses a private home and a restricted desktop `PATH`. It checks a build-module
+import as the first query without retries, standard and relative imports,
+paths with spaces, imported symbols,
+hover, references, rename previews, diagnostics and completion while editing.
+It requires Zig and ZLS; `core-test -Dtest-filter=lsp_client` checks the
+protocol client's own tests without installed language servers.
+
== Release gates
A release passes all of these first: `unit-test` with `-Dplatform=tui` and