Skip to content

Commit

Permalink
Use README.md as documentation
Browse files Browse the repository at this point in the history
* This requires at least Rust 1.54.
  • Loading branch information
jgosmann committed Feb 8, 2023
1 parent 4939b23 commit 6a8cfd9
Show file tree
Hide file tree
Showing 3 changed files with 3 additions and 38 deletions.
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
### Changed

* Minimum version of bindgen bumped to 0.63.0 to allow building with `cross`.
* Set minimum required Rust version to 1.54.


## [0.2.0] - 2021-04-30
Expand Down
1 change: 1 addition & 0 deletions Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ license = "MIT OR Apache-2.0"
name = "libalgobsec-sys"
readme = "README.md"
repository = "https://github.com/jgosmann/libalgobsec-sys"
rust-version = "1.54"
version = "0.3.0+1.4.8.0"

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
Expand Down
39 changes: 1 addition & 38 deletions src/lib.rs
Original file line number Diff line number Diff line change
@@ -1,41 +1,4 @@
//! Unsafe bindings to the [Bosch BSEC library](https://www.bosch-sensortec.com/software-tools/software/bsec/).
//!
//! ## Important license information
//!
//! The BSEC library is proprietary. Thus, it cannot be included in this crate and
//! its documentation need to be obtained separately. You are responsible for
//! adhering to that license in your products despite the source code of this crate
//! to generate the necessary bindings is published under a permissive license.
//!
//! Note that the source code of this crate does not contain any of the BSEC source
//! code, API declartions, or documentation.
//!
//! * [BSEC website to obtain your copy](https://www.bosch-sensortec.com/software-tools/software/bsec/)
//! * [BSEC license terms at the time of writing](https://www.bosch-sensortec.com/media/boschsensortec/downloads/bsec/2017-07-17_clickthrough_license_terms_environmentalib_sw_clean.pdf)
//!
//!
//! ## Usage
//!
//! To be able to use this crate it needs to know where to find the BSEC header
//! files and library on your system. These paths are provided as the configuration
//! options `bsec_include_path` and `bsec_library_path` to the Rust compiler.
//!
//! You can do this by creating a `.cargo/config` file in your crate with the
//! following content (adjust the paths accordingly):
//!
//! ```toml
//! [build]
//! rustflags = [
//! '--cfg', 'bsec_include_path="/path/to/BSEC_1.4.8.0_Generic_Release/algo/normal_version/inc"',
//! '--cfg', 'bsec_library_path="/path/to/BSEC_1.4.8.0_Generic_Release/algo/normal_version/bin/target-arch"',
//! ]
//! ```
//!
//! ## Building local BSEC documentation
//!
//! If you build the documentation locally with `cargo doc`, after the above setup,
//! BSEC documentation extracted from the header files will be included.
#![doc = include_str!("../README.md")]
#![allow(non_camel_case_types)]
#![allow(non_snake_case)]
#![allow(non_upper_case_globals)]
Expand Down

0 comments on commit 6a8cfd9

Please sign in to comment.