Skip to content

Commit

Permalink
Reorganize the "Canonical Built-ins" section of Explainer.md.
Browse files Browse the repository at this point in the history
This moves the signatures for the canonical builtins out of prose paragraphs
and into tables, which highlights them and simplifies the prose.

This also adds "conceptual signatures". The canonical ABI signatures are
useful when one is writing compilers or bindings generators or other tools,
while the conceptual signatures are useful for people seeking to
understand what these builtins do at a conceptual level, before thinking
about how all the various values are lowered into `i32`s.

And, the conceptual signatures in theory are independent of the ABI, so
they could be reused when new ABIs are added.

This is a follow-up to WebAssembly#407; I've re-added the
`canon` ebpf for now, removed the "Binary encoding immediates" table rows,
and tidied up the signatures to avoid using `...`.
  • Loading branch information
sunfishcode committed Nov 14, 2024
1 parent 5a34794 commit f21b912
Showing 1 changed file with 300 additions and 52 deletions.
Loading

0 comments on commit f21b912

Please sign in to comment.