From f13f84044be1bd18160f4845a739592219638862 Mon Sep 17 00:00:00 2001 From: zinc Date: Wed, 14 Oct 2026 09:28:59 +0000 Subject: docs: remove temporary notes and fix onboarding drift - delete TASKLIST.md and docs/design/handoff.md; the handoff content lives in README.md - move docs/BOOTSTRAP-OWNERSHIP.md to docs/history/ and index it in docs/history/README.md - point ONBOARD.md, docs/BORROW.md and the ticked TODO.md item at the new path - ONBOARD.md section 9 no longer mentions TASKLIST.md - ONBOARD.md section 3 and 4 markers are now `// ...` (line comments lost their colon) verified from a clean build: make clean, make (fixpoint 376903 words), the section 0-7 commands (section 4 after the marker fix), and the rejection suites. make check was started but did not complete (stopped before it finished). --- docs/design/handoff.md | 20 -------------------- 1 file changed, 20 deletions(-) delete mode 100644 docs/design/handoff.md (limited to 'docs/design') diff --git a/docs/design/handoff.md b/docs/design/handoff.md deleted file mode 100644 index 0b08048..0000000 --- a/docs/design/handoff.md +++ /dev/null @@ -1,20 +0,0 @@ -# implementation notes - -this note summarizes implemented language and tooling features that were previously tracked across design documents. feature details live in the project readme and examples. - -## language and library - -- struct methods and static functions support typed parameters and return types. the existing untyped form remains available. -- `src/lib/std.zc` groups helpers in structs of static functions, called with `Group.name(args)`. `Text`, `Bytes`, `Host`, `Arena` and `Buf` provide string, byte, host, arena and buffer helpers. linux `syscall` is host-only and bypasses vm checks. -- tagged enums support payload members, constructors that return owned enum pointers, and `case member(fields)` bindings in ordinary `switch` statements. omitted members produce a warning when there is no `default`. -- struct values can cross native calls on x86-64 sysv and linux arm64 aapcs64 for the interpreter, o3, llvm and jit paths described in the readme. apple arm64 remains unchecked. - -## language server - -the language server runs the compiler in check mode, so diagnostics and semantic highlighting use the same parser and symbol tables as compilation. hover supports declarations, parameters, locals, built-ins and documented keywords. it does not follow declarations reached through `include` yet. - -## optimization - -o3 remains the explicit way to request native regions; automatic tiering was dropped. llvm inlining and global copy propagation are implemented. see [tiering](tiering.md) for the rationale and [struct-by-value](struct-by-value.md) for native aggregate limits. - -the runtime memory map is generated from a preset. fixed code and compiler tables have finite capacity; the heap grows within the configured machine memory. see the project readme's memory map section for the current build controls. -- cgit v1.2.3