Documentation tells you to use buildall.sh, neglects to mention some dependencies

[Zireael07]

Documentation only calls out clang and ld-wasm (which btw is lld on Manjaro Linux), via trial and error I discovered there are two more:

• wabt (wat2wasm is used)
• tsc

[Zireael07]

Oh, and to run unbundled you need to use the server.py in the root, not in /examples. Trying to use the latter leads to lots of errors where it can't find /lib-js/index.js, seemingly treating it as a subfolder of examples and not root?

[JohnDog3112]

As far as I can tell, the documentation does point out both wat2wasm and tsc, though it could probably be more concise.

For instance, this segment: https://github.com/twiddlingbits/twr-wasm/blob/main/examples/readme.md seems to only reference clang and wasm-ld as you mentioned above, however it did mention that server.py needs to be ran from root.

Additionally, the getting started segment describing instillation mentions clang and wasm-ld as required dependencies, but it later mentions typescript as an optional dependency and links to the full dependency list. Although, it needs to be revised a bit since it only references it for Windows instillation.

Lastly, you get the building from source page which does include the full dependency list, though, it only states you need wat2wasm and TypeScript not the specific packages that contain it.

As for needing to run server.py from root, I believe server.py is mainly there because it is only used for examples even though the examples pull from a root folder in their unbundled forms. This might change later, but for now it'll probably stay like that.

As for the documentation, I'll add more references to the building from source page as needed so people aren't missing dependencies when trying to run the examples from source. Also, feel free to comment with any other documentation pages I might have missed.

[Zireael07]

This is pretty unclear as I assumed "building from source" section in the online pages refers to building the library itself, not the examples.

I found that tsc is NOT optional since you can't run buildall.sh successfully without it.

The readme.md in the examples folder, at least in my copy, says to run /example/server.py and not ./server.py - for me personally, only the latter works, the former results in a ton of errors