From 35adc61f0b3d9e5748102df77655b90fa29eeb36 Mon Sep 17 00:00:00 2001 From: zinc Date: Wed, 14 Oct 2026 09:32:37 +0000 Subject: document the standard library api every public declaration in src/lib/std.zc has a comment directly above it, so the language server can show it. comments only; no code changed. the comments now match the bodies: Host.env and Bytes.env report the characters copied (at most n - 1), capture drops output past 256 characters, and Buf.set can raise the length past the current end. adds examples/std_tour.zc, which calls one or two functions from each group, and points the README standard-library section at it. --- docs/history/README.md | 1 + 1 file changed, 1 insertion(+) (limited to 'docs') diff --git a/docs/history/README.md b/docs/history/README.md index ead4aa0..d3977c4 100644 --- a/docs/history/README.md +++ b/docs/history/README.md @@ -54,3 +54,4 @@ the code folders are snapshots. they're not built or tested from here, the top l - 51 llvm-inline-stdlib: llvm inlining of o3 calls, stdlib text and num helpers, host syscalls through SYS_RAW, and the fuzz campaign's findings - 52 closures: closure calls work (the block is never run; a call into a heap closure goes through its entry word), captures chain through enclosing closures, and the closure test joins the suite - 53 typed source: every function, local and global in the compiler, the runtime and the language server is typed (zc0's image does not change), and the extension caches diagnostics by a sha256 of the tree they cover +- 54 stdlib docs: the standard library api in src/lib/std.zc is documented, every public declaration has a comment above it, and examples/std_tour.zc calls one or two functions from each group -- cgit v1.2.3