aboutsummaryrefslogtreecommitdiff
path: root/docs/history
diff options
context:
space:
mode:
authorGravatar zinc <zinc@downsta.ir> 2026-10-14 09:32:37 +0000
committerGravatar zinc <zinc@downsta.ir> 2026-10-14 09:32:37 +0000
commit35adc61f0b3d9e5748102df77655b90fa29eeb36 (patch)
treedfd45391b69c828e40ab69cc23dbb5bf5405e47d /docs/history
parenttodo: record the reverted unchecked trial and what it showed (diff)
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.
Diffstat (limited to 'docs/history')
-rw-r--r--docs/history/README.md1
1 files changed, 1 insertions, 0 deletions
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