Documentation not showing up through rust-analyzer when include_str! is used

[udoprog]

The way documentation is defined for certain functions prevents it from showing up through rust-analyzer (see screenshot).

This is what you see when you use into_make_service():

This is what you see when you use into_make_service_with_connect_info():

I don't know if this should count as a rust-analyzer issue, but it could be worth considering to improve usability of APIs with the current state of tooling.

[davidpdrsn]

Hm thats kinda annoying 😕 Its definitely a rust-analyzer bug. Using #[doc = include_str!(...)] was highlighted as a use case in the announcement of Rust 1.54 so I'd be sad having to remove it. On the other hand I understand the frustration. Docs are read more times than they're written.

Would you mind filing an issue with rust-analyzer?

[udoprog]

Just looked, here are the related issues:

• Support #[doc = include_str!(...)] in hover documentation rust-lang/rust-analyzer#11137
• Support macro expansion inside attribute rust-lang/rust-analyzer#8092

[davidpdrsn]

I'll close this for now. I think its up to RA to fix this and at least seems they're aware of the issue.