Skip to content

Adjust some documentation for threading intrinsics #674

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lukewagner merged 2 commits into from
Jul 1, 2026
+8 −6
Merged

Adjust some documentation for threading intrinsics #674

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
885d805
Synchronize `Binary.md` threading intrinsics
alexcrichton Jul 1, 2026
9d86663
Flag `thread.yield` under the async feature gate
alexcrichton Jul 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 6 additions & 4 deletions design/mvp/Binary.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -302,7 +302,6 @@ canon ::= 0x00 0x00 f:<core:funcidx> opts:<opts> ft:<typeidx> => (canon lift
| 0x05 => (canon task.cancel (core func)) 🔀
| 0x0a v:<valtype> i:<u32> => (canon context.get v i (core func)) 🔀
| 0x0b v:<valtype> i:<u32> => (canon context.set v i (core func)) 🔀
| 0x0c cancel?:<cancel?> => (canon thread.yield cancel? (core func)) 🔀
| 0x06 async?:<async?> => (canon subtask.cancel async? (core func)) 🔀
| 0x0d => (canon subtask.drop (core func)) 🔀
| 0x0e t:<typeidx> => (canon stream.new t (core func)) 🔀
Expand All @@ -329,10 +328,13 @@ canon ::= 0x00 0x00 f:<core:funcidx> opts:<opts> ft:<typeidx> => (canon lift
| 0x23 => (canon waitable.join (core func)) 🔀
| 0x26 => (canon thread.index (core func)) 🧵
| 0x27 ft:<typeidx> tbl:<core:tableidx> => (canon thread.new-indirect ft tbl (core func)) 🧵
| 0x28 cancel?:<cancel?> => (canon thread.switch-to cancel? (core func)) 🧵
| 0x28 => (canon thread.resume-later (core func)) 🧵
| 0x29 cancel?:<cancel?> => (canon thread.suspend cancel? (core func)) 🧵
| 0x2a => (canon thread.resume-later (core func)) 🧵
| 0x2b cancel?:<cancel?> => (canon thread.yield-to cancel? (core func)) 🧵
| 0x0c cancel?:<cancel?> => (canon thread.yield cancel? (core func)) 🔀
| 0x2a cancel?:<cancel?> => (canon thread.suspend-then-resume cancel? (core func)) 🧵
| 0x2b cancel?:<cancel?> => (canon thread.yield-then-resume cancel? (core func)) 🧵
| 0x2c cancel?:<cancel?> => (canon thread.suspend-then-promote cancel? (core func)) 🧵
| 0x2d cancel?:<cancel?> => (canon thread.yield-then-promote cancel? (core func)) 🧵
| 0x40 shared?:<sh?> ft:<typeidx> => (canon thread.spawn-ref shared? ft (core func)) 🧵②
| 0x41 shared?:<sh?> ft:<typeidx> tbl:<core:tableidx> => (canon thread.spawn-indirect shared? ft tbl (core func)) 🧵②
| 0x42 shared?:<sh?> => (canon thread.available-parallelism shared? (core func)) 🧵②
Expand Down
4 changes: 2 additions & 2 deletions design/mvp/CanonicalABI.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ specified here.
* [`canon thread.new-indirect`](#-canon-threadnew-indirect) 🧵
* [`canon thread.resume-later`](#-canon-threadresume-later) 🧵
* [`canon thread.suspend`](#-canon-threadsuspend) 🧵
* [`canon thread.yield`](#-canon-threadyield) 🧵
* [`canon thread.yield`](#-canon-threadyield) 🔀
* [`canon thread.suspend-then-resume`](#-canon-threadsuspend-then-resume) 🧵
* [`canon thread.yield-then-resume`](#-canon-threadyield-then-resume) 🧵
* [`canon thread.suspend-then-promote`](#-canon-threadsuspend-then-promote) 🧵
Expand Down Expand Up @@ -4948,7 +4948,7 @@ cancellation, they can omit `cancellable` so that cancellation is instead
delivered at a later `cancellable` call.


### 🧵 `canon thread.yield`
### 🔀 `canon thread.yield`

For a canonical definition:
```wat
Expand Down
Loading