rust-lang/futures-rs

Document what features are required for feature-gated items

Closed this issue · 1 comments

One way to document this would be to use doc(cfg(feature = ...))) as described at https://users.rust-lang.org/t/how-to-document-optional-features-in-api-docs/64577/3, but I don't know how that would work with the large amount of re-exporting this workspace does.

This has already been done (e.g., see https://docs.rs/futures-util/latest/futures_util/#modules), but there are some issues that it doesn't work well in the re-export (i.e. documentation of futures), and the scope of features with the same name is different in futures and futures-util. Some of these should be fixed automatically as a side effect of other work for 0.4 (#2804), but I would accept patches if you have ideas for improvements.