#cargo-toml #documentation #features #rustdoc #macro

macro document-features

Extract documentation for the feature flags from comments in Cargo.toml

11 releases

0.2.10 Jul 12, 2024
0.2.8 Dec 29, 2023
0.2.7 Dec 21, 2022
0.2.6 Sep 24, 2022
0.2.1 Feb 12, 2022

#122 in Development tools

Download history 140113/week @ 2024-08-06 162661/week @ 2024-08-13 181222/week @ 2024-08-20 120096/week @ 2024-08-27 130692/week @ 2024-09-03 126890/week @ 2024-09-10 145985/week @ 2024-09-17 154532/week @ 2024-09-24 161294/week @ 2024-10-01 165954/week @ 2024-10-08 171536/week @ 2024-10-15 163986/week @ 2024-10-22 180310/week @ 2024-10-29 194557/week @ 2024-11-05 195993/week @ 2024-11-12 215816/week @ 2024-11-19

817,603 downloads per month
Used in 1,733 crates (298 directly)

MIT/Apache

33KB
765 lines

Document your crate's feature flags

Crates.io Documentation

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

Contributions are welcome. We accept pull requests and bug reports.

License

MIT OR Apache-2.0

Dependencies

~170KB