Draft release notes for 1.97.0

[BoxyUwU]

NOTE: Use the 📝 links to edit those that have a relnotes-tracking-issue,
and they will be updated when we regenerate the notes periodically (manually).

---

Version 1.97.0 (2026-07-09)

Language

• Fallback {float} to f32 in some cases
  📝
• Consider Result<T, Uninhabited> and ControlFlow<Uninhabited, T> to be equivalent to T for must use lint
  📝
• Stabilize the div32, lam-bh, lamcas, ld-seq-sa and scq target features
  📝
• stabilize cfg(target_has_atomic_primitive_alignment)
  📝
• Allow trailing self in imports in more cases
  📝

Compiler

• Rust will use the v0 symbol mangling scheme by default
  📝

Platform Support

• NVPTX: Drop support for old architectures and old ISAs
  📝

Refer to Rust's platform support page
for more information on Rust's tiered platform support.

Libraries

Stabilized APIs

• Default for RepeatN
  📝
• Copy for ffi::FromBytesUntilNulError
  📝
• Send for std::fs::File on UEFI
  📝
• <{integer}>::isolate_highest_one
• <{integer}>::isolate_lowest_one
• NonZero<{integer}>::isolate_highest_one
• NonZero<{integer}>::isolate_lowest_one
  📝
• <{integer}>::bit_width
• NonZero<{integer}>::bit_width
  📝
• NonZero<{integer}>::highest_one
• NonZero<{integer}>::lowest_one
• <{integer}>::lowest_one
• <{integer}>::highest_one
  📝

These previously stable APIs are now stable in const contexts:

• char::is_control
  📝

Cargo

• feat(config): Stabilize resolver.lockfile-path config
• cargo clean: Add target directory validation
• feat(compile): Stabilize build.warnings
• Add -m shorthand for --manifest-path
• Remove curl dependency from crates-io crate

Rustdoc

• Stabilize --emit flag
  📝
• Stabilize --remap-path-prefix
  📝
  

Compatibility Notes

• Lint unused pub items in binary crates
  📝
• Prevent deref coercions in pin!, in order to prevent unsoundness. The most likely case where this might impact users is: writing pin!(x) where x has type &mut T will now always correctly produce a value of type Pin<&mut &mut T>, instead of sometimes allowing a coercion that produces a value of type Pin<&mut T>. This coercion was previously incorrectly allowed since Rust 1.88.0.
  📝
• deprecate std::char constants and functions
  📝
• Warn on linker output by default
  📝
• Remove hidden f64 methods which have been deprecated since 1.0
  📝
• report the varargs_without_pattern lint in deps
  📝
• Forbid passing generic arguments to module path segments even if the module reexports a generic enum variant
  📝
• Error on invalid macho link_section specifier
  📝
• The encoding of certain enums have changed. This is not a breaking change, as it only applies to enums without layout guarantees, but is noted here as we've seen people impacted from having made assumptions about the layout algorithm.
  📝
• Error on #[export_name = "..."] where the name is empty
  📝
• Syntactically reject tuple index shorthands in struct patterns
  📝
• validate #[link_name = "..."] & #[link(name = "...")] parameters
  📝
• On Windows, after calling shutdown on a socket to shut down the write side, attempting to write to the socket will now produce a BrokenPipe error rather than Other. Map WSAESHUTDOWN to io::ErrorKind::BrokenPipe
  📝

Internal Changes

These changes do not affect any public interfaces of Rust, but they represent
significant improvements to the performance or internals of rustc and related
tools.

[BoxyUwU]

@rustbot ping relnotes-interest-group

cc @rust-lang/release

[rustbot]

Hi relnotes-interest-group, this issue/PR could use some help in reviewing /
adjusting release notes. Could you take a look if available? Thanks <3

cc @alex-semenyuk @jieyouxu @joshtriplett @lcnr @traviscross

[theemathas]

The "stabilized API" section should probably be sorted in some sensible order in the final release notes.