Further revisions

Author: Mark-Simulacrum

RELEASES.md

@@ -9,7 +9,6 @@ Language
 - [Lower pattern bindings in the order they're written and base drop order on primary bindings' order](https://github.com/rust-lang/rust/pull/143764)
 - [Stabilize declaration of C-style variadic functions for `sysv64`, `win64`, `efiapi`, and `aapcs` ABIs](https://github.com/rust-lang/rust/pull/144066).
   This brings these ABIs in line with the C ABI: variadic functions can be declared in extern blocks but not defined.
-- [Always require coroutine captures to be drop-live](https://github.com/rust-lang/rust/pull/144156)
 - [Add `dangling_pointers_from_locals` lint to warn against dangling pointers from local variables](https://github.com/rust-lang/rust/pull/144322)
 - [Upgrade `semicolon_in_expressions_from_macros` from warn to deny](https://github.com/rust-lang/rust/pull/144369)
 - [Stabilize LoongArch32 inline assembly](https://github.com/rust-lang/rust/pull/144402)
@@ -22,7 +21,6 @@ Language
 Compiler
 --------
 
-- [Error on invalid `#[link]` attributes](https://github.com/rust-lang/rust/pull/143193)
 - [Don't warn on never-to-any `as` casts as unreachable](https://github.com/rust-lang/rust/pull/144804)
 
 <a id="1.91.0-Platform-Support"></a>
@@ -43,10 +41,10 @@ for more information on Rust's tiered platform support.
 
 Libraries
 ---------
+
 - [Print thread ID in panic message](https://github.com/rust-lang/rust/pull/115746)
 - [Fix overly restrictive lifetime in `core::panic::Location::file` return type](https://github.com/rust-lang/rust/pull/132087)
 - [Guarantee parameter order for `_by()` variants of `min` / `max`/ `minmax` in `std::cmp`](https://github.com/rust-lang/rust/pull/139357)
-- [Implement Sum and Product for `Saturating<u*>`](https://github.com/rust-lang/rust/pull/144275)
 - [Document assumptions about `Clone` and `Eq` traits](https://github.com/rust-lang/rust/pull/144330/)
 
 <a id="1.91.0-Stabilized-APIs"></a>
@@ -110,6 +108,10 @@ Stabilized APIs
 - [`impl Debug for windows::ffi::EncodeWide<'_>`](https://doc.rust-lang.org/stable/std/os/windows/ffi/struct.EncodeWide.html#impl-Debug-for-EncodeWide%3C'_%3E)
 - [`str::ceil_char_boundary`](https://doc.rust-lang.org/stable/std/primitive.str.html#method.ceil_char_boundary)
 - [`str::floor_char_boundary`](https://doc.rust-lang.org/stable/std/primitive.str.html#method.floor_char_boundary)
+- [`impl Sum for Saturating<u{N}>`](https://doc.rust-lang.org/stable/std/num/struct.Saturating.html#impl-Sum-for-Saturating%3Cu32%3E)
+- [`impl Sum<&u{N}> for Saturating<u{N}>`](https://doc.rust-lang.org/stable/std/num/struct.Saturating.html#impl-Sum%3C%26Saturating%3Cu32%3E%3E-for-Saturating%3Cu32%3E)
+- [`impl Product for Saturating<u{N}>`](https://doc.rust-lang.org/stable/std/num/struct.Saturating.html#impl-Product-for-Saturating%3Cu32%3E)
+- [`impl Product<&u{N}> for Saturating<u{N}>`](https://doc.rust-lang.org/stable/std/num/struct.Saturating.html#impl-Product%3C%26Saturating%3Cu32%3E%3E-for-Saturating%3Cu32%3E)
 
 These previously stable APIs are now stable in const contexts:
 
@@ -135,15 +137,12 @@ Cargo
   ([build cache doc](https://doc.rust-lang.org/nightly/cargo/reference/build-cache.html))
   [#15833](https://github.com/rust-lang/cargo/pull/15833)
   [#15840](https://github.com/rust-lang/cargo/pull/15840)
-- 🎉 Stabilize `build.build-dir`.
-  This config sets the directory where intermediate build artifacts are stored.
-  These artifacts are produced by Cargo and rustc during the build process.
-  End users usually won't need to interact with them, and the layout inside
-  `build-dir` is an implementation detail that may change without notice.
-  ([config doc](https://doc.rust-lang.org/nightly/cargo/reference/config.html#buildbuild-dir))
-  ([build cache doc](https://doc.rust-lang.org/nightly/cargo/reference/build-cache.html))
-  [#15833](https://github.com/rust-lang/cargo/pull/15833)
-  [#15840](https://github.com/rust-lang/cargo/pull/15840)
+- The `--target` flag and the `build.target` configuration can now take literal
+  `"host-tuple"` string, which will internally be substituted by the host
+  machine's target triple.
+  [#15838](https://github.com/rust-lang/cargo/pull/15838)
+  [#16003](https://github.com/rust-lang/cargo/pull/16003)
+  [#16032](https://github.com/rust-lang/cargo/pull/16032)
 
 <a id="1.91.0-Rustdoc"></a>
 
@@ -156,16 +155,18 @@ Rustdoc
 
 Compatibility Notes
 -------------------
+- [Always require coroutine captures to be drop-live](https://github.com/rust-lang/rust/pull/144156)
 - [Apple: Always pass SDK root when linking with `cc`, and pass it via `SDKROOT` env var](https://github.com/rust-lang/rust/pull/131477). This should fix linking issues with `rustc` running inside Xcode. Libraries in `/usr/local/lib` may no longer be linked automatically, if you develop or use a crate that relies on this, you should explicitly set `cargo::rustc-link-search=/usr/local/lib` in a `build.rs` script.
 - [Relaxed bounds in associated type bound position like in `TraitRef<AssocTy: ?Sized>` are now correctly forbidden](https://github.com/rust-lang/rust/pull/135331)
 - [Add unstable `#[sanitize(xyz = "on|off")]` built-in attribute that shadows procedural macros with the same name](https://github.com/rust-lang/rust/pull/142681)
 - [Fix the drop checker being more permissive for bindings declared with let-else](https://github.com/rust-lang/rust/pull/143028)
-- [Error on invalid `#[should_panic]` attributes](https://github.com/rust-lang/rust/pull/143808)
+- [Be more strict when parsing attributes, erroring on many invalid attributes](https://github.com/rust-lang/rust/pull/144689)
+    - [Error on invalid `#[should_panic]` attributes](https://github.com/rust-lang/rust/pull/143808)
+    - [Error on invalid `#[link]` attributes](https://github.com/rust-lang/rust/pull/143193)
 - [Mark all deprecation lints in name resolution as deny-by-default and also report in dependencies](https://github.com/rust-lang/rust/pull/143929)
 - The lint `semicolon_in_expressions_from_macros`, for `macro_rules!` macros in expression position that expand to end in a semicolon (`;`), is now deny-by-default. It was already warn-by-default, and a future compatibility warning (FCW) that warned even in dependencies. This lint will become a hard error in the future.
 - [Trait impl modifiers (e.g., `unsafe`, `!`, `default`) in inherent impls are no longer syntactically valid](https://github.com/rust-lang/rust/pull/144386)
 - [Start reporting future breakage for `ILL_FORMED_ATTRIBUTE_INPUT` in dependencies](https://github.com/rust-lang/rust/pull/144544)
-- [Be more strict when parsing attributes, erroring on many invalid attributes](https://github.com/rust-lang/rust/pull/144689)
 - [Restrict the scope of temporaries created by the macros `pin!`, `format_args!`, `write!`, and `writeln!` in `if let` scrutinees in Rust Edition 2024.](https://github.com/rust-lang/rust/pull/145342) This applies [Rust Edition 2024's `if let` temporary scope rules](https://doc.rust-lang.org/edition-guide/rust-2024/temporary-if-let-scope.html) to these temporaries, which previously could live past the `if` expression regardless of Edition.
 - [Invalid numeric literal suffixes in tuple indexing, tuple struct indexing, and struct field name positions are now correctly rejected](https://github.com/rust-lang/rust/pull/145463)
 - [Closures marked with the keyword `static` are now syntactically invalid](https://github.com/rust-lang/rust/pull/145604)
@@ -178,12 +179,20 @@ Cargo compatibility notes:
   when `build.build-dir` is set. These tarballs were previously included due to
   an oversight and are now treated as intermediate artifacts.
   To get `.crate` tarballs as final artifacts, use `cargo package`.
-  In the next version, this change will apply regardless of `build.build-dir`.
+  In a future version, this change will apply regardless of `build.build-dir`.
   [#15910](https://github.com/rust-lang/cargo/pull/15910)
 - Adjust Cargo messages to match rustc diagnostic style.
   This changes some of the terminal colors used by Cargo messages.
   [#15928](https://github.com/rust-lang/cargo/pull/15928)
-
+- Tools and projects relying on the
+  [internal details of Cargo's `build-dir`](https://doc.rust-lang.org/cargo/reference/build-cache.html)
+  may not work for users changing their `build-dir` layout.
+  For those doing so, we'd recommend proactively testing these cases
+  particularly as we are considering changing the default location of the `build-dir` in the future
+  ([cargo#16147](https://github.com/rust-lang/cargo/issues/16147)).
+  If you can't migrate off of Cargo's internal details,
+  we'd like to learn more about your use case as we prepare to change the layout of the `build-dir`
+  ([cargo#15010](https://github.com/rust-lang/cargo/issues/15010)).
 
 <a id="1.91.0-Internal-Changes"></a>
 
@@ -476,7 +485,7 @@ Language
   This allows using boolean literals as `cfg` predicates, e.g. `#[cfg(true)]` and `#[cfg(false)]`.
 - [Fully de-stabilize the `#[bench]` attribute](https://github.com/rust-lang/rust/pull/134273). Usage of `#[bench]` without `#![feature(custom_test_frameworks)]` already triggered a deny-by-default future-incompatibility lint since Rust 1.77, but will now become a hard error.
 - [Add warn-by-default `dangerous_implicit_autorefs` lint against implicit autoref of raw pointer dereference.](https://github.com/rust-lang/rust/pull/123239)
-  The lint [will be bumped to deny-by-default](https://github.com/rust-lang/rust/pull/141661) in the next version of Rust.
+  The lint [will be bumped to deny-by-default](https://github.com/rust-lang/rust/pull/141661) in a future version of Rust.
 - [Add `invalid_null_arguments` lint to prevent invalid usage of null pointers.](https://github.com/rust-lang/rust/pull/119220)
   This lint is uplifted from `clippy::invalid_null_ptr_usage`.
 - [Change trait impl candidate preference for builtin impls and trivial where-clauses.](https://github.com/rust-lang/rust/pull/138176)