`bindgen`: C javadoc comments are not Markdown-escaped, triggering `rustdoc` warnings

[ojeda]

Example from the CI: https://github.com/Rust-for-Linux/linux/runs/2700777736?check_suite_focus=true#step:60:35.

Reported at rust-lang/rust-bindgen#2057.

[nbdd0121]

Do we need these comments? We can just --no-doc-comments.

[ojeda]

I guess not, though I thought it would be nice to report it to the bindgen folks.

We can mark this as a GFI then if we go for that.

[pvdrz]

Now bindgen has a parse callback to handle commands but this requires using a build script and AFAIK rust-for-linux uses the CLI instead. Would it be possible to move to using a build script?

[ojeda]

If you mean using it as a library, then yeah, it would be possible.