langref: update async functions section

This commit is contained in:
Andrew Kelley 2024-04-07 14:13:03 -07:00
parent 129de47a71
commit c78f996ff9

View File

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