I have a written a bit of rust by now, but one problem I always seem to encounter it that the features a create supports never seem to be documented. Neither what features are available, what they each do or which are default. Is that really the case, or am I missing something?

I constantly seem to include something from the docs, only to be told by the compiler that it does not exist, and then I have to open the source for the create to figure out if it's hidden behind a feature flag.

Also, is it really true that I can't disable a single feature from the default set, without having to copy the default list and manually removing it?

top 3 comments

sorted by: hot top controversial new old

[–] hunger@programming.dev 13 points 2 years ago

https://docs.rs/document-features/latest/document_features/ helps to document features.

But yes, features are under-documented.

[–] Vorpal@programming.dev 11 points 2 years ago

A few crates do document this, but it is often missing indeed.

Sometimes I have seen it documented as comments in Cargo.toml as well.

[–] somegeek@programming.dev 2 points 2 years ago

Yep. I guess that's the case for now.