[PATCH] D100888: [WebAssembly] Update README. NFC.
Sam Clegg via Phabricator via llvm-commits
llvm-commits at lists.llvm.org
Tue Apr 20 13:48:08 PDT 2021
sbc100 created this revision.
Herald added subscribers: wingo, ecnelises, sunfish, hiraditya, jgravelle-google, dschuff.
sbc100 requested review of this revision.
Herald added subscribers: llvm-commits, aheejin.
Herald added a project: LLVM.
This is just a cleanup of the very high level stuff. I'm sure there is
more to update here but I'll leave that to others and/or a followup.
Repository:
rG LLVM Github Monorepo
https://reviews.llvm.org/D100888
Files:
llvm/lib/Target/WebAssembly/README.txt
Index: llvm/lib/Target/WebAssembly/README.txt
===================================================================
--- llvm/lib/Target/WebAssembly/README.txt
+++ llvm/lib/Target/WebAssembly/README.txt
@@ -1,19 +1,11 @@
//===-- README.txt - Notes for WebAssembly code gen -----------------------===//
-This WebAssembly backend is presently under development.
-
-The most notable feature which is not yet stable is the ".o" file format.
-".o" file support is needed for many common ways of using LLVM, such as
-using it through "clang -c", so this backend is not yet considered widely
-usable. However, this backend is usable within some language toolchain
-packages:
-
Emscripten provides a C/C++ compilation environment that includes standard
libraries, tools, and packaging for producing WebAssembly applications that
-can run in browsers and other environments. For more information, see the
-Emscripten documentation in general, and this page in particular:
+can run in browsers and other environments.
- * https://github.com/kripken/emscripten/wiki/New-WebAssembly-Backend
+wasi-sdk provides a more minimal C/C++ SDK based on clang, llvm and a libc based
+on musl, for producing WebAssemmbly applictions that use the WASI ABI.
Rust provides WebAssembly support integrated into Cargo. There are two
main options:
@@ -25,20 +17,6 @@
For more information, see:
* https://www.hellorust.com/
-
-This backend does not yet support debug info. Full DWARF support needs a
-design for how DWARF should be represented in WebAssembly. Sourcemap support
-has an existing design and some corresponding browser implementations, so it
-just needs implementing in LLVM.
-
-Work-in-progress documentation for the ".o" file format is here:
-
- * https://github.com/WebAssembly/tool-conventions/blob/master/Linking.md
-
-A corresponding linker implementation is also under development:
-
- * https://lld.llvm.org/WebAssembly.html
-
For more information on WebAssembly itself, see the home page:
* https://webassembly.github.io/
@@ -50,13 +28,6 @@
The backend is built, tested and archived on the following waterfall:
https://wasm-stat.us
-The backend's bringup is done in part by using the GCC torture test suite, since
-it doesn't require C library support. Current known failures are in
-known_gcc_test_failures.txt, all other tests should pass. The waterfall will
-turn red if not. Once most of these pass, further testing will use LLVM's own
-test suite. The tests can be run locally using:
- https://github.com/WebAssembly/waterfall/blob/master/src/compile_torture_tests.py
-
Some notes on ways that the generated code could be improved follow:
//===---------------------------------------------------------------------===//
-------------- next part --------------
A non-text attachment was scrubbed...
Name: D100888.338985.patch
Type: text/x-patch
Size: 2750 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/llvm-commits/attachments/20210420/b6101e14/attachment.bin>
More information about the llvm-commits
mailing list