Update the documentation about C/C++ toolchain limitations.

Document that `setjmp`/`longjmp` and C++ exceptions are unsupported, and
update the documentation about the function signature mismatch bug to
reflect that it's now just a warning rather than a fatal error.
This commit is contained in:
Dan Gohman
2019-04-18 05:45:09 -07:00
parent 69e44caa29
commit 29c2616484

View File

@@ -51,9 +51,14 @@ To make things easier, we provide
[prebuilt packages](https://github.com/CraneStation/wasi-sdk/releases) [prebuilt packages](https://github.com/CraneStation/wasi-sdk/releases)
that provide builds of Clang and sysroot libraries. that provide builds of Clang and sysroot libraries.
Note that C++ support has a notable WASI doesn't yet support `setjmp`/`longjmp` or C++ exceptions, as it is
[bug](https://bugs.llvm.org/show_bug.cgi?id=40412) in clang which affects waiting for [unwinding support in WebAssembly].
<iostream> in libcxx. This will be fixed in future versions.
[unwinding support in WebAssembly]: https://github.com/WebAssembly/exception-handling/
Some C++ programs, particularly those using `<iostream>`, may see warnings
about function signature mismatches; this is a
[known bug](https://bugs.llvm.org/show_bug.cgi?id=40412).
## How can I run programs that use WASI? ## How can I run programs that use WASI?