authorgravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2024-04-07 14:13:03-07:00
committergravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2024-04-07 14:13:03-07:00
logc78f996ff986b8843f328e1f083547c538ac865b
treec333b04473380e45d8427cb95b17a97d6216ed3b
parent129de47a71b954b1118ce188f7032ad726491f53

langref: update async functions section

1 files changed, 10 insertions(+), 4 deletions(-)

doc/langref.html.in+10-4
......@@ -8014,10 +8014,16 @@ test "global assembly" {
80148014 {#header_close#}
80158015
80168016 {#header_open|Async Functions#}
8017 <p>Async functions are being temporarily regressed and will be
8018 <a href="https://github.com/ziglang/zig/issues/6025">restored before Zig
8019 0.11.0 is tagged</a>. I apologize for the instability. Please use Zig 0.10.0 with
8020 the <code>-fstage1</code> flag for now if you need this feature.</p>
8017 <p>Async functions regressed with the release of 0.11.0. Their future in
8018 the Zig language is unclear due to multiple unsolved problems:</p>
8019 <ul>
8020 <li>LLVM's lack of ability to optimize them.</li>
8021 <li>Third-party debuggers' lack of ability to debug them.</li>
8022 <li><a href="https://github.com/ziglang/zig/issues/5913">The cancellation problem</a>.</li>
8023 <li>Async function pointers preventing the stack size from being known.</li>
8024 </ul>
8025 <p>These problems are surmountable, but it will take time. The Zig team
8026 is currently focused on other priorities.</p>
80218027 {#header_close#}
80228028
80238029 {#header_open|Builtin Functions|2col#}