gen-funcs-sigs

Documentation

Overview

gen-funcs-sigs reads the canonical per-function markdown docs under `docs/funcs/*.md` and emits `rts/signatures_gen.go` - the sorted list of public builtin signature strings the runtime loads at init.

Pre-codegen, signatures lived twice: once in `rts/signatures.go` as Go literals, and once in `docs/funcs/<name>.md` under `## Signature`. A drift gate test kept them in sync. With this tool, the markdown doc is the single source of truth and `signatures.go` only carries the init logic + a tiny hand-maintained list of internal `_rad_*` signatures that have no public docs.

Pipeline:

docs/funcs/*.md   ── source of truth
      │
      ▼ gen-funcs-sigs  (this tool)
rts/signatures_gen.go  ── generated, checked into git
      │
      ▼ rts.init  (at runtime)
parses each signature string into a Typing

Usage:

go run ./tools/gen-funcs-sigs

Defaults assume invocation from the repo root. Pass `-source` and `-out` to override.