Skip to content

Commit d932634

Browse files
Some more wording tweaks
1 parent aed6b43 commit d932634

File tree

1 file changed

+10
-6
lines changed

1 file changed

+10
-6
lines changed

posts/2025-01-09-Rust-1.84.0.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -19,20 +19,23 @@ If you'd like to help us out by testing future releases, you might consider upda
1919

2020
## What's in 1.84.0 stable
2121

22-
### Cargo can use toolchain version for library version selection
22+
### Cargo considers Rust versions for dependency version selection
2323

2424
1.84.0 stabilizes the minimum supported Rust version (MSRV) aware resolver,
2525
which uses the declared [minimum supported Rust version](https://doc.rust-lang.org/cargo/reference/rust-version.html) from
2626
dependencies, if available, to improve package version selection. Rust version
2727
aware selection allows library authors to easily adopt newer Rust versions
28-
while avoiding breaking consumers needing compatibility with older toolchains.
28+
while avoiding breaking consumers who want to use older Rust compilers.
2929

3030
You can opt-in to the MSRV-aware resolver via [`.cargo/config.toml`](https://doc.rust-lang.org/cargo/reference/config.html#resolverincompatible-rust-versions):
31+
3132
```toml
3233
[resolver]
3334
incompatible-rust-versions = "fallback"
3435
```
36+
3537
Then when adding a dependency:
38+
3639
```console
3740
$ cargo add clap
3841
Updating crates.io index
@@ -44,6 +47,7 @@ warning: ignoring clap@4.5.23 (which requires rustc 1.74) to maintain demo's rus
4447
```
4548

4649
When [verifying the latest dependencies in CI](https://doc.rust-lang.org/cargo/guide/continuous-integration.html#verifying-latest-dependencies), you can override this:
50+
4751
```console
4852
$ CARGO_RESOLVER_INCOMPATIBLE_RUST_VERSIONS=allow cargo update
4953
Updating crates.io index
@@ -60,10 +64,10 @@ toolchain (and avoid running `cargo update`). Now, those users will be able to
6064
automatically use older library versions compatible with their older toolchain.
6165
In the future, we expect this to provide more flexibility for library authors
6266
to select their preferred support strategy for Rust versions, with the toolchain
63-
helping users on older toolchains avoid breakage.
67+
helping users on older toolchains avoid breakage. See also the [detailed guidance](https://doc.rust-lang.org/beta/cargo/reference/rust-version.html#setting-and-updating-rust-version)
68+
on what to consider when making a choice of supported version.
6469

65-
The new resolver will be enabled by default with the 2024 edition (expected to
66-
stabilize in 1.85), but can be enabled as of 1.84 by setting
70+
The new resolver will be enabled by default when optin into the 2024 edition (will stabilize in 1.85), but can be enabled as of 1.84 by setting
6771
[`package.resolver = "3"`](https://doc.rust-lang.org/cargo/reference/resolver.html#resolver-versions) in the Cargo.toml manifest file, or
6872
[`resolver.incompatible-rust-versions = "fallback"`](https://doc.rust-lang.org/cargo/reference/config.html#resolverincompatible-rust-versions) in the Cargo configuration file.
6973

@@ -93,7 +97,7 @@ engine used relatively esoteric code. It also improves our ability to detect
9397
where impls do *not* overlap, allowing more code to be written in some cases.
9498

9599
For more details, see a [previous blog post](https://blog.rust-lang.org/inside-rust/2024/12/04/trait-system-refactor-initiative.html)
96-
and the [stabilization report](https://github.com/rust-lang/rust/pull/130654)
100+
and the [stabilization report](https://github.com/rust-lang/rust/pull/130654).
97101

98102
[Crater]: https://github.com/rust-lang/crater/
99103

0 commit comments

Comments
 (0)