|
1 | 1 | //===-- README.txt - Notes for WebAssembly code gen -----------------------===// |
2 | 2 |
|
3 | | -This WebAssembly backend is presently in a very early stage of development. |
4 | | -The code should build and not break anything else, but don't expect a lot more |
5 | | -at this point. |
| 3 | +This WebAssembly backend is presently under development. |
6 | 4 |
|
7 | | -For more information on WebAssembly itself, see the design documents: |
8 | | - * https://github.com/WebAssembly/design/blob/master/README.md |
| 5 | +Currently the easiest way to use it is through Emscripten, which provides a |
| 6 | +compilation environment that includes standard libraries, tools, and packaging |
| 7 | +for producing WebAssembly applications that can run in browsers and other |
| 8 | +environments. For more information, see the Emscripten documentation in |
| 9 | +general, and this page in particular: |
| 10 | + * https://github.com/kripken/emscripten/wiki/New-WebAssembly-Backend |
9 | 11 |
|
10 | | -The following documents contain some information on the planned semantics and |
11 | | -binary encoding of WebAssembly itself: |
| 12 | +Other ways of using this backend, such as via a standalone "clang", are also |
| 13 | +under development, though they are not generally usable yet. |
| 14 | + |
| 15 | +For more information on WebAssembly itself, see the home page: |
| 16 | + * https://webassembly.github.io/ |
| 17 | + |
| 18 | +The following documents contain some information on the semantics and binary |
| 19 | +encoding of WebAssembly itself: |
12 | 20 | * https://github.com/WebAssembly/design/blob/master/Semantics.md |
13 | 21 | * https://github.com/WebAssembly/design/blob/master/BinaryEncoding.md |
14 | 22 |
|
15 | 23 | The backend is built, tested and archived on the following waterfall: |
16 | 24 | https://wasm-stat.us |
17 | 25 |
|
18 | | -The backend's bringup is done using the GCC torture test suite first since it |
19 | | -doesn't require C library support. Current known failures are in |
| 26 | +The backend's bringup is done in part by using the GCC torture test suite, since |
| 27 | +it doesn't require C library support. Current known failures are in |
20 | 28 | known_gcc_test_failures.txt, all other tests should pass. The waterfall will |
21 | 29 | turn red if not. Once most of these pass, further testing will use LLVM's own |
22 | 30 | test suite. The tests can be run locally using: |
|
0 commit comments