bytecodealliance / bytecodealliance/wasm-tools

wit-parser: Doc comments on interface imports/export world items are discarded

Open
#2,294 0 comments 0 reactions 0 assignees View on GitHub
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.