From 242f09606fe16237d08d33a1db20880be1125497 Mon Sep 17 00:00:00 2001 From: Eric Huss Date: Sun, 8 Apr 2018 10:40:50 -0700 Subject: [PATCH] Clarify -Z minimal-versions. --- src/doc/src/reference/unstable.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/doc/src/reference/unstable.md b/src/doc/src/reference/unstable.md index a598032eb..c5989df51 100644 --- a/src/doc/src/reference/unstable.md +++ b/src/doc/src/reference/unstable.md @@ -155,6 +155,12 @@ When a `Cargo.lock` file is generated, the `-Z minimal-versions` flag will resolve the dependencies to the minimum semver version that will satisfy the requirements (instead of the greatest version). +The intended use-case of this flag is to check, during continuous integration, +that the versions specified in Cargo.toml are a correct reflection of the +minimum versions that you are actually using. That is, if Cargo.toml says +`foo = "1.0.0"` that you don't accidentally depend on features added only in +`foo 1.5.0`. + ### out-dir * Original Issue: [#4875](https://github.com/rust-lang/cargo/issues/4875) -- 2.30.2