gst-plugin-version-helper: Add README.md and fix up docs

This commit is contained in:
Sebastian Dröge 2021-06-29 00:23:09 +03:00
parent 23219c3c09
commit b5375d2f21
2 changed files with 41 additions and 1 deletions

40
version-helper/README.md Normal file
View file

@ -0,0 +1,40 @@
# gst-plugin-version-helper [![crates.io](https://img.shields.io/crates/v/gst-plugin-version-helper.svg)](https://crates.io/crates/gst-plugin-version-helper) [![docs.rs](https://docs.rs/gst-plugin-version-helper/badge.svg)](https://docs.rs/gst-plugin-version-helper)
Extracts release for [GStreamer](https://gstreamer.freedesktop.org) plugin metadata
See the [documentation](https://docs.rs/gst-plugin-version-helper) for details.
This function is supposed to be used as follows in the `build.rs` of a crate that implements a
plugin:
```rust,ignore
gst_plugin_version_helper::get_info();
```
Inside `lib.rs` of the plugin, the information provided by `get_info` are usable as follows:
```rust,ignore
gst::plugin_define!(
the_plugin_name,
env!("CARGO_PKG_DESCRIPTION"),
plugin_init,
concat!(env!("CARGO_PKG_VERSION"), "-", env!("COMMIT_ID")),
"The Plugin's License",
env!("CARGO_PKG_NAME"),
env!("CARGO_PKG_NAME"),
env!("CARGO_PKG_REPOSITORY"),
env!("BUILD_REL_DATE")
);
## LICENSE
`gst-plugin-version-helper` is licensed under the MIT license ([LICENSE](LICENSE) or
http://opensource.org/licenses/MIT).
## Contribution
Any kinds of contributions are welcome as a pull request.
Unless you explicitly state otherwise, any contribution intentionally
submitted for inclusion in `gst-plugin-version-helper` by you shall be licensed
under the MIT license as above, without any additional terms or conditions.

View file

@ -17,7 +17,7 @@
//! Inside `lib.rs` of the plugin, the information provided by `get_info` are usable as follows:
//!
//! ```rust,ignore
//! plugin_define!(
//! gst::plugin_define!(
//! the_plugin_name,
//! env!("CARGO_PKG_DESCRIPTION"),
//! plugin_init,