feature req: handle #![doc]

[joshka]

#![doc] and various versions gated with feature flags etc are useful for:

• including examples from a file into the lib docs using include_str! / include-doc)
• documenting features in the cargo.toml using document_features

E.g.:

//! # Example
//! ```rust
#![doc = include_str!("../examples/hello_world.rs")]
//! ```
//! # Features
#![cfg_attr(feature = "document-features", doc = document_features::document_features!())]

Currently these render as empty in the readme.

[orium]

Once #177 is done this should be relatively easy to do.

[joshka]

Noted - thanks!

[AdamStrojek]

Here is another example how this feature can be useful, automatic generation of package version in documentation:

#![doc = concat!(env!("CARGO_PKG_NAME"), " = \"", env!("CARGO_PKG_VERSION"), "\"")]

Is there any progress on that? Maybe I can help in implementing this feature?

[joshka]

I tend to write cargo add <my-crate> instead of adding cargo.toml instructions in docs, which side-steps that particular problem.