summaryrefslogtreecommitdiff
path: root/docs/design.typ
diff options
context:
space:
mode:
Diffstat (limited to 'docs/design.typ')
-rw-r--r--docs/design.typ8
1 files changed, 6 insertions, 2 deletions
diff --git a/docs/design.typ b/docs/design.typ
index ff013f49..bd8b767c 100644
--- a/docs/design.typ
+++ b/docs/design.typ
@@ -253,8 +253,12 @@ zig-tree-sitter + 26 grammars — all pinned
through `zig fetch` and wired in `build.zig`. Generated during the build:
`highlights.scm` → an options module; the vendored helix/zed theme
sources → the generated half of the theme ring; the tracked `.zig` sources →
-the web shell's read-only archive; eight GLSL shaders → SPIR-V. The tutor and
-the embedded font are plain `@embedFile`s, not codegen. Debug builds are
+the web shell's read-only archive; eight GLSL shaders → SPIR-V. That last one is
+the only build input wanting a tool a stock machine lacks (`glslc`), so it is
+also the only one whose output is committed: `zig build shaders` writes
+`shaders/prebuilt/*.spv` and `-Dprebuilt-shaders` embeds that copy rather than
+shelling out, which is what lets a gui build need nothing but a C toolchain. The
+tutor and the embedded font are plain `@embedFile`s, not codegen. Debug builds are
incremental for the seconds-loop; release builds are the product.
= What is deliberately absent