|  | 
| 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