|
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