Extract documentation for the feature flags from comments in Cargo.toml
Rust
198
69 commits
updated Oct 24, 2025
This crate provides a macro that extracts documentation comments from Cargo.toml
To use this crate, add #![doc = document_features::document_features!()] in your crate documentation.
The document_features!() macro reads your Cargo.toml file, extracts feature comments and generates
a markdown string for your documentation.
Use ## and #! comments in your Cargo.toml to document features, for example:
[dependencies]
document-features = "0.2"
## ...
[features]
## The foo feature enables the `foo` functions
foo = []
## The bar feature enables the [`bar`] module
bar = []
#! ### Experimental features
#! The following features are experimental
## Activate the fusion reactor
fusion = []
These comments keep the feature definition and documentation next to each other, and they are then rendered into your crate documentation.
Check out the documentation for more details.
Contributions are welcome. We accept pull requests and bug reports.
MIT OR Apache-2.0
310 followers · starred Aug 2022
213 followers · starred Feb 2022
426 followers · starred Aug 2023
791 followers · starred Sep 2022
Extract documentation for the feature flags from comments in Cargo.toml
Rust
198
69 commits
updated Oct 24, 2025
This crate provides a macro that extracts documentation comments from Cargo.toml
To use this crate, add #![doc = document_features::document_features!()] in your crate documentation.
The document_features!() macro reads your Cargo.toml file, extracts feature comments and generates
a markdown string for your documentation.
Use ## and #! comments in your Cargo.toml to document features, for example:
[dependencies]
document-features = "0.2"
## ...
[features]
## The foo feature enables the `foo` functions
foo = []
## The bar feature enables the [`bar`] module
bar = []
#! ### Experimental features
#! The following features are experimental
## Activate the fusion reactor
fusion = []
These comments keep the feature definition and documentation next to each other, and they are then rendered into your crate documentation.
Check out the documentation for more details.
Contributions are welcome. We accept pull requests and bug reports.
MIT OR Apache-2.0
310 followers · starred Aug 2022
213 followers · starred Feb 2022
426 followers · starred Aug 2023
791 followers · starred Sep 2022