Skip to content

Commit 3c0cb6d

Browse files
d-e-s-odanielocfb
authored andcommitted
Detail minimum supported Rust version policy
There is rough consensus in the Rust ecosystem that bumps of the compiler version are not considered breaking changes as per semantic versioning, as the compiler version is not part of the public API contract, and because it would cause way too much churn if incompatible releases were published all the time. However, to make that behavior at somewhat more predictable to users, most crates define a policy that they adhere to (for lack of an ecosystem wide suggestion, as is currently discussed here rust-lang/libs-team#72, among other places). This change defines such a policy for both libbpf-rs and libbpf-cargo. Moving forward, we will support the most recent six stable minor version releases ("N - 5"), at a minimum. At a release cadence of every 6 weeks, that provides more than half a year of buffer. This policy is not set in stone and is based on what we can currently support. Signed-off-by: Daniel Müller <[email protected]>
1 parent a8a72ac commit 3c0cb6d

File tree

2 files changed

+8
-2
lines changed

2 files changed

+8
-2
lines changed

libbpf-cargo/README.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,10 @@ libbpf-cargo = "0.20"
1717

1818
See [full documentation here](https://docs.rs/libbpf-cargo).
1919

20-
This crate adheres to Cargo's [semantic versioning rules][cargo-semver].
20+
This crate adheres to Cargo's [semantic versioning rules][cargo-semver]. At a
21+
minimum, it builds with the most recent Rust stable release minus five minor
22+
versions ("N - 5"). E.g., assuming the most recent Rust stable is `1.68`, the
23+
crate is guaranteed to build with `1.63` and higher.
2124

2225
## Contributing
2326

libbpf-rs/README.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,10 @@ libbpf-rs = "0.20"
1717

1818
See [full documentation here](https://docs.rs/libbpf-rs).
1919

20-
This crate adheres to Cargo's [semantic versioning rules][cargo-semver].
20+
This crate adheres to Cargo's [semantic versioning rules][cargo-semver]. At a
21+
minimum, it builds with the most recent Rust stable release minus five minor
22+
versions ("N - 5"). E.g., assuming the most recent Rust stable is `1.68`, the
23+
crate is guaranteed to build with `1.63` and higher.
2124

2225
## Contributing
2326

0 commit comments

Comments
 (0)