Commit c78f996ff9
Changed files (1)
doc/langref.html.in
@@ -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#}