feat: keep feature documentation inline with manifests (#329)

https://docs.rs/git-actor

cargo-features.md

@@ -84,8 +84,7 @@ The library powering the command-line interface.
 
 ### git-actor
 
-* **local-time-support**
-   - Make `Signature` initializers using the local time (with UTC offset) available.
+Documented in [its documnetation](https://docs.rs/git-actor).
 
 ### git-features
 

git-actor/Cargo.toml

@@ -13,10 +13,9 @@ doctest = false
 
 [features]
 serde1 = ["serde", "bstr/serde1"]
-local-time-support = ["git-features/time"]
 
-[package.metadata.docs.rs]
-all-features = true
+## Make `Signature` initializers use the local time (with UTC offset) available.
+local-time-support = ["git-features/time"]
 
 [dependencies]
 git-features = { version = "^0.19.1", path = "../git-features", optional = true }
@@ -27,6 +26,12 @@ nom = { version = "7", default-features = false, features = ["std"]}
 itoa = "1.0.1"
 serde = { version = "1.0.114", optional = true, default-features = false, features = ["derive"]}
 
+document-features = { version = "0.1", optional = true }
+
 [dev-dependencies]
 pretty_assertions = "1.0.0"
 git-testtools = { path = "../tests/tools"}
+
+[package.metadata.docs.rs]
+features = ["document-features"]
+all-features = true

git-actor/src/lib.rs

@@ -1,4 +1,10 @@
 //! This crate provides ways of identifying an actor within the git repository both in shared/mutable and mutable variants.
+//!
+//! ## Feature Flags
+#![cfg_attr(
+    feature = "document-features",
+    cfg_attr(doc, doc = ::document_features::document_features!())
+)]
 #![forbid(unsafe_code)]
 #![deny(rust_2018_idioms, missing_docs)]
 use bstr::{BStr, BString};