diff options
author | Alon Zakai <alonzakai@gmail.com> | 2016-03-18 21:36:25 -0700 |
---|---|---|
committer | Alon Zakai <alonzakai@gmail.com> | 2016-03-18 21:36:25 -0700 |
commit | ae4d2f092bbe973542c18a2b948838ac79af1f39 (patch) | |
tree | e15d72ab3460d823cea7c2d4cb40b26defd77a8c | |
parent | abc902c1037ca26293bcd25d100c5256afe4c282 (diff) | |
download | binaryen-ae4d2f092bbe973542c18a2b948838ac79af1f39.tar.gz binaryen-ae4d2f092bbe973542c18a2b948838ac79af1f39.tar.bz2 binaryen-ae4d2f092bbe973542c18a2b948838ac79af1f39.zip |
readme update
-rw-r--r-- | README.md | 14 |
1 files changed, 1 insertions, 13 deletions
@@ -23,7 +23,7 @@ This repository contains code that builds the following tools in `bin/`: * **asm2wasm**: An asm.js-to-WebAssembly compiler, built on Emscripten's asm optimizer infrastructure. This is used by Emscripten in Binaryen mode when it uses Emscripten's fastcomp asm.js backend. * **wasm2asm**: A WebAssembly-to-asm.js compiler, the reverse of `asm2wasm`. This is a work in progress. * **s2wasm**: A compiler from the `.s` format emitted by the new WebAssembly backend being developed in LLVM. This is used by Emscripten in Binaryen mode when it integrates with the new LLVM backend. - * **wasm.js**: A WebAssembly-to-JavaScript bridge. wasm.js contains Binaryen components compiled to JavaScript, including the interpreter, `asm2wasm`, the S-Expression parser, etc., which allow you to load WebAssembly and execute it even if the browser doesn't have native support yet. Having `asm2wasm` also gives the option to take an asm.js build and execute it as WebAssembly, which is useful for testing. + * **wasm.js**: wasm.js contains Binaryen components compiled to JavaScript, including the interpreter, `asm2wasm`, the S-Expression parser, etc., which allow you to load WebAssembly and execute it even if the browser doesn't have native support yet. This can be useful as a (slow) polyfill. Usage instructions for each are below. @@ -107,18 +107,6 @@ On Linux and Mac you should see pretty colors as in that image. Set `COLORS=0` i Pass `--debug` on the command line to see debug info, about asm.js functions as they are parsed, etc. `--debug=2` will show even more info. -### wasm.js - -Update your emscripten configuration file, setting the `BINARYEN_ROOT` variable to point to the directory containing binaryen. - -Run Emscripten's `emcc` command, passing it an additional flag: - -``` -emcc -s BINARYEN=1 [whatever other emcc flags you want] -``` - -The `BINARYEN` flag tells it to emit code using `wasm.js`, and the `BINARYEN_ROOT` config variable tells where to find `wasm.js` itself. The output `*.js` file will then contain the entire polyfill (`asm2wasm` translator + `wasm.js` interpreter). The asm.js code will be in `*.asm.js`. - ### C/C++ Source ⇒ asm2wasm ⇒ WebAssembly When using `emcc` with the `BINARYEN` option, it will use Binaryen to build to WebAssembly. See the [emscripten wiki](https://github.com/kripken/emscripten/wiki/WebAssembly) for more details. |