bytecodealliance / bytecodealliance/wasm-tools
wit-parser: Doc comments on interface imports/export world items are discarded
Open
wit
- Dominant language
- Rust
- Stars
- 1.8k
- Forks
- 351
- Avg merge
- 16h 57m
- Merged PRs (30d)
- 38
Description
```wit
interface i {}
world w {
/// this is lost
import i;
}
```
These comments are discarded during parsing, meaning e.g. [this](https://github.com/WebAssembly/wasi-http/blob/ed620562ee1d089a20aa67cd7790782d03f2f505/wit/proxy.wit#L44-L47) doesn't survive a round-trip through binary WIT encoding.
I spent a little time trying to fix this but I think it needs a breaking change to the package metadata serialization format.
Contributor guide
Assessment
This issue has not been assessed yet.