From: Eric Huss <eric@huss.org>
Date: Sun, 8 Apr 2018 17:40:50 +0000 (-0700)
Subject: Clarify -Z minimal-versions.
X-Git-Tag: archive/raspbian/0.35.0-2+rpi1~3^2^2^2^2^2^2^2~22^2~1^2~86^2~1
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=242f09606fe16237d08d33a1db20880be1125497;p=cargo.git

Clarify -Z minimal-versions.
---

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)