summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md16
1 files changed, 10 insertions, 6 deletions
diff --git a/README.md b/README.md
index 8e4e430..3a4384a 100644
--- a/README.md
+++ b/README.md
@@ -873,15 +873,19 @@ renderer migration work and the optional addon boundary.
## The boundary
Host and sketch are built by the same `zig build`, so ordinary Zig types cross
-it (slices, tagged unions, `std.mem.Allocator`). `abi.hash`, a comptime hash
-of every shared type's layout and of the zig version, backend and optimize
+it (slices, tagged unions, `std.mem.Allocator`). `abi.hash`, a hash of
+every shared type's layout and of the zig version, backend and optimize
mode, guards against the real hazards: a host refuses a library built
against different definitions, or by another compiler or mode (`zig build
run` beside `zig build lib --watch -Doptimize=fast`: Zig's own calling
-convention differs between them), and says what differs. Everything that outlives
-a call lives in host memory, since host code is never unloaded. Only the
-recorded `Event` and the reflected `Layout` are `extern`, because they are
-written to disk.
+convention differs between them), and says what differs. The layout half
+costs half a second of comptime, so a small program (`src/abi_hash.zig`)
+computes it once per change of the abi sources, at build time, and host and
+sketches import the number; it is computed for the build machine in Debug,
+so a layout change seen only by another target or mode is not caught.
+Everything that outlives a call lives in host memory, since host code is
+never unloaded. Only the recorded `Event` and the reflected `Layout` are
+`extern`, because they are written to disk.
`zig build test` in this directory runs the unit tests, a headless reload
through `dlopen`, where a counter sketch changes its layout mid-run and keeps