Docs don't include entries from features

[Zapeth]

I'm not experienced with rust package documentation so I might be missing something, but the documentation at https://docs.rs/glfw only lists the default code without any of the extra features (vulkan being the important one for me here).

[bvssvni]

I don't know how to include the other settings in the docs. Is there a feature for this, or it could already be a known issue?

[Zapeth]

Looking at other popular rust packages it at least looks like its possible, though I don't know to what extent -> https://docs.rs/tokio/0.2.18/tokio/process/index.html

I don't know the process behind publishing the documentation for a crate, but in regards to including elements of specific features I imagine something like cargo doc --features <all-features> and specific documentation markings for those elements in the code are necessary (perhaps you can see how its done in the example I linked above).

edit: It looks like they're using an experimental feature -> rust-lang/rust#43781

[bvssvni]

Is there a way to use experimental features with backward compatibility?

[Nemo157]

For that specific feature you can tell docs.rs to enable a cfg flag like here (along with enabling --all-features to build everything). Then only conditionally use the feature based on that cfg flag (#[cfg_attr(docsrs, doc(cfg(feature = "stream")))]). That means people building docs locally would not see the features highlighted, unless they build with RUSTDOCFLAGS=--cfg=docsrs cargo doc, but the online documentation would include it.