rust
/
cargo
mirror of https://github.com/rust-lang/cargo
0
0
Fork 0
Code Issues Releases Wiki Activity

Auto merge of #13751 - epage:msrv-docs, r=weihanglo 

docs(ref): Update unstable docs for msrv-policy
This commit is contained in:
bors 2024-04-13 13:35:46 +00:00
parent 8dd6db4f12 079f4d12e3
commit 29189d9908
1 changed files with 18 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
src/doc/src/reference/unstable.md
View File

@ -327,8 +327,24 @@ Documentation updates:
## msrv-policy
- [#9930](https://github.com/rust-lang/cargo/issues/9930) (MSRV-aware resolver)
The `msrv-policy` feature enables experiments in MSRV-aware policy for cargo in
preparation for an upcoming RFC.
Catch-all unstable feature for MSRV-aware cargo features under
[RFC 2495](https://github.com/rust-lang/rfcs/pull/2495).
### MSRV-aware cargo add
This was stabilized in 1.79 in [#13608](https://github.com/rust-lang/cargo/pull/13608).
### MSRV-aware resolver
By default, `-Zmsrv-policy` enables an MSRV-aware resolver.
The resolver will prefer dependencies with a `package.rust-version` that is the same or older than your project's MSRV.
Your project's MSRV is determined by taking the lowest `package.rust-version` set among your workspace members.
If there is none set, your toolchain version will be used with the intent to pick up the version from rustup's `rust-toolchain.toml`, if present.
MSRV-incompatible dependencies can still be selected by:
- Setting the dependency's version requirement too high
- Specifying the version to `cargo update` with `--precise`
- Passing `--ignore-rust-version`
## precise-pre-release