WebAssembly / spec

WebAssembly specification, reference interpreter, and test suite.
https://webassembly.github.io/spec/
Other
3.13k stars 445 forks source link

Missing ability to access built older versions of the WebAssembly specification in archivable form #1736

Open 20kdc opened 7 months ago

20kdc commented 7 months ago

There does not appear to be a simple way to access built older versions of the WebAssembly specification, particularly 1.0, in archivable form (the various builds, i.e. PDF etc.)

I was at least able to find the W3C version of the core specification ( https://www.w3.org/TR/wasm-core-1/# ), but that appears to be all, and it doesn't appear to have any standardized archival download readily available.

Why care about 1.0?

There are two main use-cases I can think of for the WebAssembly 1.0 specification:

It is thus important to keep available the specification versions that actually apply to these targets.

Workaround

A present workaround is to use the mirrors generated by WebAssembly project proposals that were forked from late-stage 1.0, i.e. https://webassembly.github.io/multi-value/core/_download/WebAssembly.pdf -- however, there are still some differences, so this is probably not a definitive 1.0.

Ms2ger commented 7 months ago

Going forward, all new versions will be available at https://www.w3.org/standards/history/wasm-core-2/

rossberg commented 7 months ago

I agree they should be made available here (especially since the w3c site will probably only have the inferior single-page HTML version). We have talked about this in the past, but never took action.

FWIW, you should be able to at least build the old releases of the spec by checking out this repo at specific release tags, e.g., wg-1.0 for Wasm 1.0. However, there may have been some bitrot, as both Sphinx and Bikeshed have a tendency to break our setup when they release major updates (though you can probably ignore the latter).