RELEASES.md

   1 Version 1.66.1 (2023-01-10)
   2 ===========================
   3
   4 - Added validation of SSH host keys for git URLs in Cargo ([CVE-2022-46176](https://www.cve.org/CVERecord?id=CVE-2022-46176))
   5
   6 Version 1.66.0 (2022-12-15)
   7 ==========================
   8
   9 Language
  10 --------
  11 - [Permit specifying explicit discriminants on all `repr(Int)` enums](https://github.com/rust-lang/rust/pull/95710/)
  12   ```rust
  13   #[repr(u8)]
  14   enum Foo {
  15       A(u8) = 0,
  16       B(i8) = 1,
  17       C(bool) = 42,
  18   }
  19   ```
  20 - [Allow transmutes between the same type differing only in lifetimes](https://github.com/rust-lang/rust/pull/101520/)
  21 - [Change constant evaluation errors from a deny-by-default lint to a hard error](https://github.com/rust-lang/rust/pull/102091/)
  22 - [Trigger `must_use` on `impl Trait` for supertraits](https://github.com/rust-lang/rust/pull/102287/)
  23   This makes `impl ExactSizeIterator` respect the existing `#[must_use]` annotation on `Iterator`.
  24 - [Allow `..=X` in patterns](https://github.com/rust-lang/rust/pull/102275/)
  25 - [Uplift `clippy::for_loops_over_fallibles` lint into rustc](https://github.com/rust-lang/rust/pull/99696/)
  26 - [Stabilize `sym` operands in inline assembly](https://github.com/rust-lang/rust/pull/103168/)
  27 - [Update to Unicode 15](https://github.com/rust-lang/rust/pull/101912/)
  28 - [Opaque types no longer imply lifetime bounds](https://github.com/rust-lang/rust/pull/95474/)
  29   This is a soundness fix which may break code that was erroneously relying on this behavior.
  30
  31 Compiler
  32 --------
  33 - [Add armv5te-none-eabi and thumbv5te-none-eabi tier 3 targets](https://github.com/rust-lang/rust/pull/101329/)
  34   - Refer to Rust's [platform support page][platform-support-doc] for more
  35     information on Rust's tiered platform support.
  36 - [Add support for linking against macOS universal libraries](https://github.com/rust-lang/rust/pull/98736)
  37
  38 Libraries
  39 ---------
  40 - [Fix `#[derive(Default)]` on a generic `#[default]` enum adding unnecessary `Default` bounds](https://github.com/rust-lang/rust/pull/101040/)
  41 - [Update to Unicode 15](https://github.com/rust-lang/rust/pull/101821/)
  42
  43 Stabilized APIs
  44 ---------------
  45
  46 - [`proc_macro::Span::source_text`](https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.source_text)
  47 - [`uX::{checked_add_signed, overflowing_add_signed, saturating_add_signed, wrapping_add_signed}`](https://doc.rust-lang.org/stable/std/primitive.u8.html#method.checked_add_signed)
  48 - [`iX::{checked_add_unsigned, overflowing_add_unsigned, saturating_add_unsigned, wrapping_add_unsigned}`](https://doc.rust-lang.org/stable/std/primitive.i8.html#method.checked_add_unsigned)
  49 - [`iX::{checked_sub_unsigned, overflowing_sub_unsigned, saturating_sub_unsigned, wrapping_sub_unsigned}`](https://doc.rust-lang.org/stable/std/primitive.i8.html#method.checked_sub_unsigned)
  50 - [`BTreeSet::{first, last, pop_first, pop_last}`](https://doc.rust-lang.org/stable/std/collections/struct.BTreeSet.html#method.first)
  51 - [`BTreeMap::{first_key_value, last_key_value, first_entry, last_entry, pop_first, pop_last}`](https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.first_key_value)
  52 - [Add `AsFd` implementations for stdio lock types on WASI.](https://github.com/rust-lang/rust/pull/101768/)
  53 - [`impl TryFrom<Vec<T>> for Box<[T; N]>`](https://doc.rust-lang.org/stable/std/boxed/struct.Box.html#impl-TryFrom%3CVec%3CT%2C%20Global%3E%3E-for-Box%3C%5BT%3B%20N%5D%2C%20Global%3E)
  54 - [`core::hint::black_box`](https://doc.rust-lang.org/stable/std/hint/fn.black_box.html)
  55 - [`Duration::try_from_secs_{f32,f64}`](https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.try_from_secs_f32)
  56 - [`Option::unzip`](https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.unzip)
  57 - [`std::os::fd`](https://doc.rust-lang.org/stable/std/os/fd/index.html)
  58
  59
  60 Rustdoc
  61 -------
  62
  63 - [Add Rustdoc warning for invalid HTML tags in the documentation](https://github.com/rust-lang/rust/pull/101720/)
  64
  65 Cargo
  66 -----
  67
  68 - [Added `cargo remove` to remove dependencies from Cargo.toml](https://doc.rust-lang.org/nightly/cargo/commands/cargo-remove.html)
  69 - [`cargo publish` now waits for the new version to be downloadable before exiting](https://github.com/rust-lang/cargo/pull/11062)
  70
  71 See [detailed release notes](https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-166-2022-12-15) for more.
  72
  73 Compatibility Notes
  74 -------------------
  75
  76 - [Only apply `ProceduralMasquerade` hack to older versions of `rental`](https://github.com/rust-lang/rust/pull/94063/)
  77 - [Don't export `__heap_base` and `__data_end` on wasm32-wasi.](https://github.com/rust-lang/rust/pull/102385/)
  78 - [Don't export `__wasm_init_memory` on WebAssembly.](https://github.com/rust-lang/rust/pull/102426/)
  79 - [Only export `__tls_*` on wasm32-unknown-unknown.](https://github.com/rust-lang/rust/pull/102440/)
  80 - [Don't link to `libresolv` in libstd on Darwin](https://github.com/rust-lang/rust/pull/102766/)
  81 - [Update libstd's libc to 0.2.135 (to make `libstd` no longer pull in `libiconv.dylib` on Darwin)](https://github.com/rust-lang/rust/pull/103277/)
  82 - [Opaque types no longer imply lifetime bounds](https://github.com/rust-lang/rust/pull/95474/)
  83   This is a soundness fix which may break code that was erroneously relying on this behavior.
  84 - [Make `order_dependent_trait_objects` show up in future-breakage reports](https://github.com/rust-lang/rust/pull/102635/)
  85 - [Change std::process::Command spawning to default to inheriting the parent's signal mask](https://github.com/rust-lang/rust/pull/101077/)
  86
  87 Internal Changes
  88 ----------------
  89
  90 These changes do not affect any public interfaces of Rust, but they represent
  91 significant improvements to the performance or internals of rustc and related
  92 tools.
  93
  94 - [Enable BOLT for LLVM compilation](https://github.com/rust-lang/rust/pull/94381/)
  95 - [Enable LTO for rustc_driver.so](https://github.com/rust-lang/rust/pull/101403/)
  96
  97 Version 1.65.0 (2022-11-03)
  98 ==========================
  99
 100 Language
 101 --------
 102 - [Error on `as` casts of enums with `#[non_exhaustive]` variants](https://github.com/rust-lang/rust/pull/92744/)
 103 - [Stabilize `let else`](https://github.com/rust-lang/rust/pull/93628/)
 104 - [Stabilize generic associated types (GATs)](https://github.com/rust-lang/rust/pull/96709/)
 105 - [Add lints `let_underscore_drop` and `let_underscore_lock` from Clippy](https://github.com/rust-lang/rust/pull/97739/)
 106 - [Stabilize `break`ing from arbitrary labeled blocks ("label-break-value")](https://github.com/rust-lang/rust/pull/99332/)
 107 - [Uninitialized integers, floats, and raw pointers are now considered immediate UB](https://github.com/rust-lang/rust/pull/98919/).
 108   Usage of `MaybeUninit` is the correct way to work with uninitialized memory.
 109 - [Stabilize raw-dylib for Windows x86_64, aarch64, and thumbv7a](https://github.com/rust-lang/rust/pull/99916/)
 110 - [Do not allow `Drop` impl on foreign ADTs](https://github.com/rust-lang/rust/pull/99576/)
 111
 112 Compiler
 113 --------
 114 - [Stabilize -Csplit-debuginfo on Linux](https://github.com/rust-lang/rust/pull/98051/)
 115 - [Use niche-filling optimization even when multiple variants have data](https://github.com/rust-lang/rust/pull/94075/)
 116 - [Associated type projections are now verified to be well-formed prior to resolving the underlying type](https://github.com/rust-lang/rust/pull/99217/#issuecomment-1209365630)
 117 - [Stringify non-shorthand visibility correctly](https://github.com/rust-lang/rust/pull/100350/)
 118 - [Normalize struct field types when unsizing](https://github.com/rust-lang/rust/pull/101831/)
 119 - [Update to LLVM 15](https://github.com/rust-lang/rust/pull/99464/)
 120 - [Fix aarch64 call abi to correctly zeroext when needed](https://github.com/rust-lang/rust/pull/97800/)
 121 - [debuginfo: Generalize C++-like encoding for enums](https://github.com/rust-lang/rust/pull/98393/)
 122 - [Add `special_module_name` lint](https://github.com/rust-lang/rust/pull/94467/)
 123 - [Add support for generating unique profraw files by default when using `-C instrument-coverage`](https://github.com/rust-lang/rust/pull/100384/)
 124 - [Allow dynamic linking for iOS/tvOS targets](https://github.com/rust-lang/rust/pull/100636/)
 125
 126 New targets:
 127
 128 - [Add armv4t-none-eabi as a tier 3 target](https://github.com/rust-lang/rust/pull/100244/)
 129 - [Add powerpc64-unknown-openbsd and riscv64-unknown-openbsd as tier 3 targets](https://github.com/rust-lang/rust/pull/101025/)
 130   - Refer to Rust's [platform support page][platform-support-doc] for more
 131     information on Rust's tiered platform support.
 132
 133 Libraries
 134 ---------
 135
 136 - [Don't generate `PartialEq::ne` in derive(PartialEq)](https://github.com/rust-lang/rust/pull/98655/)
 137 - [Windows RNG: Use `BCRYPT_RNG_ALG_HANDLE` by default](https://github.com/rust-lang/rust/pull/101325/)
 138 - [Forbid mixing `System` with direct system allocator calls](https://github.com/rust-lang/rust/pull/101394/)
 139 - [Document no support for writing to non-blocking stdio/stderr](https://github.com/rust-lang/rust/pull/101416/)
 140 - [`std::layout::Layout` size must not overflow `isize::MAX` when rounded up to `align`](https://github.com/rust-lang/rust/pull/95295)
 141   This also changes the safety conditions on `Layout::from_size_align_unchecked`.
 142
 143 Stabilized APIs
 144 ---------------
 145
 146 - [`std::backtrace::Backtrace`](https://doc.rust-lang.org/stable/std/backtrace/struct.Backtrace.html)
 147 - [`Bound::as_ref`](https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.as_ref)
 148 - [`std::io::read_to_string`](https://doc.rust-lang.org/stable/std/io/fn.read_to_string.html)
 149 - [`<*const T>::cast_mut`](https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.cast_mut)
 150 - [`<*mut T>::cast_const`](https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.cast_const)
 151
 152 These APIs are now stable in const contexts:
 153
 154 - [`<*const T>::offset_from`](https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.offset_from)
 155 - [`<*mut T>::offset_from`](https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.offset_from)
 156
 157 Cargo
 158 -----
 159
 160 - [Apply GitHub fast path even for partial hashes](https://github.com/rust-lang/cargo/pull/10807/)
 161 - [Do not add home bin path to PATH if it's already there](https://github.com/rust-lang/cargo/pull/11023/)
 162 - [Take priority into account within the pending queue](https://github.com/rust-lang/cargo/pull/11032/).
 163   This slightly optimizes job scheduling by Cargo, with typically small improvements on larger crate graph builds.
 164
 165 Compatibility Notes
 166 -------------------
 167
 168 - [`std::layout::Layout` size must not overflow `isize::MAX` when rounded up to `align`](https://github.com/rust-lang/rust/pull/95295).
 169   This also changes the safety conditions on `Layout::from_size_align_unchecked`.
 170 - [`PollFn` now only implements `Unpin` if the closure is `Unpin`](https://github.com/rust-lang/rust/pull/102737).
 171   This is a possible breaking change if users were relying on the blanket unpin implementation.
 172   See discussion on the PR for details of why this change was made.
 173 - [Drop ExactSizeIterator impl from std::char::EscapeAscii](https://github.com/rust-lang/rust/pull/99880)
 174   This is a backwards-incompatible change to the standard library's surface
 175   area, but is unlikely to affect real world usage.
 176 - [Do not consider a single repeated lifetime eligible for elision in the return type](https://github.com/rust-lang/rust/pull/103450)
 177   This behavior was unintentionally changed in 1.64.0, and this release reverts that change by making this an error again.
 178 - [Reenable disabled early syntax gates as future-incompatibility lints](https://github.com/rust-lang/rust/pull/99935/)
 179 - [Update the minimum external LLVM to 13](https://github.com/rust-lang/rust/pull/100460/)
 180 - [Don't duplicate file descriptors into stdio fds](https://github.com/rust-lang/rust/pull/101426/)
 181 - [Sunset RLS](https://github.com/rust-lang/rust/pull/100863/)
 182 - [Deny usage of `#![cfg_attr(..., crate_type = ...)]` to set the crate type](https://github.com/rust-lang/rust/pull/99784/)
 183   This strengthens the forward compatibility lint deprecated_cfg_attr_crate_type_name to deny.
 184 - [`llvm-has-rust-patches` allows setting the build system to treat the LLVM as having Rust-specific patches](https://github.com/rust-lang/rust/pull/101072)
 185   This option may need to be set for distributions that are building Rust with a patched LLVM via `llvm-config`, not the built-in LLVM.
 186 - Combining three or more languages (e.g. Objective C, C++ and Rust) into one binary may hit linker limitations when using `lld`. For more information, see [issue 102754][102754].
 187
 188 [102754]: https://github.com/rust-lang/rust/issues/102754
 189
 190 Internal Changes
 191 ----------------
 192
 193 These changes do not affect any public interfaces of Rust, but they represent
 194 significant improvements to the performance or internals of rustc and related
 195 tools.
 196
 197 - [Add `x.sh` and `x.ps1` shell scripts](https://github.com/rust-lang/rust/pull/99992/)
 198 - [compiletest: use target cfg instead of hard-coded tables](https://github.com/rust-lang/rust/pull/100260/)
 199 - [Use object instead of LLVM for reading bitcode from rlibs](https://github.com/rust-lang/rust/pull/98100/)
 200 - [Enable MIR inlining for optimized compilations](https://github.com/rust-lang/rust/pull/91743)
 201   This provides a 3-10% improvement in compiletimes for real world crates. See [perf results](https://perf.rust-lang.org/compare.html?start=aedf78e56b2279cc869962feac5153b6ba7001ed&end=0075bb4fad68e64b6d1be06bf2db366c30bc75e1&stat=instructions:u).
 202
 203 Version 1.64.0 (2022-09-22)
 204 ===========================
 205
 206 Language
 207 --------
 208 - [Unions with mutable references or tuples of allowed types are now allowed](https://github.com/rust-lang/rust/pull/97995/)
 209 - It is now considered valid to deallocate memory pointed to by a shared reference `&T` [if every byte in `T` is inside an `UnsafeCell`](https://github.com/rust-lang/rust/pull/98017/)
 210 - Unused tuple struct fields are now warned against in an allow-by-default lint, [`unused_tuple_struct_fields`](https://github.com/rust-lang/rust/pull/95977/), similar to the existing warning for unused struct fields. This lint will become warn-by-default in the future.
 211
 212 Compiler
 213 --------
 214 - [Add Nintendo Switch as tier 3 target](https://github.com/rust-lang/rust/pull/88991/)
 215   - Refer to Rust's [platform support page][platform-support-doc] for more
 216     information on Rust's tiered platform support.
 217 - [Only compile `#[used]` as llvm.compiler.used for ELF targets](https://github.com/rust-lang/rust/pull/93718/)
 218 - [Add the `--diagnostic-width` compiler flag to define the terminal width.](https://github.com/rust-lang/rust/pull/95635/)
 219 - [Add support for link-flavor `rust-lld` for iOS, tvOS and watchOS](https://github.com/rust-lang/rust/pull/98771/)
 220
 221 Libraries
 222 ---------
 223 - [Remove restrictions on compare-exchange memory ordering.](https://github.com/rust-lang/rust/pull/98383/)
 224 - You can now `write!` or `writeln!` into an `OsString`: [Implement `fmt::Write` for `OsString`](https://github.com/rust-lang/rust/pull/97915/)
 225 - [Make RwLockReadGuard covariant](https://github.com/rust-lang/rust/pull/96820/)
 226 - [Implement `FusedIterator` for `std::net::[Into]Incoming`](https://github.com/rust-lang/rust/pull/97300/)
 227 - [`impl<T: AsRawFd> AsRawFd for {Arc,Box}<T>`](https://github.com/rust-lang/rust/pull/97437/)
 228 - [`ptr::copy` and `ptr::swap` are doing untyped copies](https://github.com/rust-lang/rust/pull/97712/)
 229 - [Add cgroupv1 support to `available_parallelism`](https://github.com/rust-lang/rust/pull/97925/)
 230 - [Mitigate many incorrect uses of `mem::uninitialized`](https://github.com/rust-lang/rust/pull/99182/)
 231
 232 Stabilized APIs
 233 ---------------
 234
 235 - [`future::IntoFuture`](https://doc.rust-lang.org/stable/std/future/trait.IntoFuture.html)
 236 - [`future::poll_fn`](https://doc.rust-lang.org/stable/std/future/fn.poll_fn.html)
 237 - [`task::ready!`](https://doc.rust-lang.org/stable/std/task/macro.ready.html)
 238 - [`num::NonZero*::checked_mul`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroUsize.html#method.checked_mul)
 239 - [`num::NonZero*::checked_pow`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroUsize.html#method.checked_pow)
 240 - [`num::NonZero*::saturating_mul`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroUsize.html#method.saturating_mul)
 241 - [`num::NonZero*::saturating_pow`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroUsize.html#method.saturating_pow)
 242 - [`num::NonZeroI*::abs`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroIsize.html#method.abs)
 243 - [`num::NonZeroI*::checked_abs`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroIsize.html#method.checked_abs)
 244 - [`num::NonZeroI*::overflowing_abs`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroIsize.html#method.overflowing_abs)
 245 - [`num::NonZeroI*::saturating_abs`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroIsize.html#method.saturating_abs)
 246 - [`num::NonZeroI*::unsigned_abs`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroIsize.html#method.unsigned_abs)
 247 - [`num::NonZeroI*::wrapping_abs`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroIsize.html#method.wrapping_abs)
 248 - [`num::NonZeroU*::checked_add`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroUsize.html#method.checked_add)
 249 - [`num::NonZeroU*::checked_next_power_of_two`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroUsize.html#method.checked_next_power_of_two)
 250 - [`num::NonZeroU*::saturating_add`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroUsize.html#method.saturating_add)
 251 - [`os::unix::process::CommandExt::process_group`](https://doc.rust-lang.org/stable/std/os/unix/process/trait.CommandExt.html#tymethod.process_group)
 252 - [`os::windows::fs::FileTypeExt::is_symlink_dir`](https://doc.rust-lang.org/stable/std/os/windows/fs/trait.FileTypeExt.html#tymethod.is_symlink_dir)
 253 - [`os::windows::fs::FileTypeExt::is_symlink_file`](https://doc.rust-lang.org/stable/std/os/windows/fs/trait.FileTypeExt.html#tymethod.is_symlink_file)
 254
 255 These types were previously stable in `std::ffi`, but are now also available in `core` and `alloc`:
 256
 257 - [`core::ffi::CStr`](https://doc.rust-lang.org/stable/core/ffi/struct.CStr.html)
 258 - [`core::ffi::FromBytesWithNulError`](https://doc.rust-lang.org/stable/core/ffi/struct.FromBytesWithNulError.html)
 259 - [`alloc::ffi::CString`](https://doc.rust-lang.org/stable/alloc/ffi/struct.CString.html)
 260 - [`alloc::ffi::FromVecWithNulError`](https://doc.rust-lang.org/stable/alloc/ffi/struct.FromVecWithNulError.html)
 261 - [`alloc::ffi::IntoStringError`](https://doc.rust-lang.org/stable/alloc/ffi/struct.IntoStringError.html)
 262 - [`alloc::ffi::NulError`](https://doc.rust-lang.org/stable/alloc/ffi/struct.NulError.html)
 263
 264 These types were previously stable in `std::os::raw`, but are now also available in `core::ffi` and `std::ffi`:
 265
 266 - [`ffi::c_char`](https://doc.rust-lang.org/stable/std/ffi/type.c_char.html)
 267 - [`ffi::c_double`](https://doc.rust-lang.org/stable/std/ffi/type.c_double.html)
 268 - [`ffi::c_float`](https://doc.rust-lang.org/stable/std/ffi/type.c_float.html)
 269 - [`ffi::c_int`](https://doc.rust-lang.org/stable/std/ffi/type.c_int.html)
 270 - [`ffi::c_long`](https://doc.rust-lang.org/stable/std/ffi/type.c_long.html)
 271 - [`ffi::c_longlong`](https://doc.rust-lang.org/stable/std/ffi/type.c_longlong.html)
 272 - [`ffi::c_schar`](https://doc.rust-lang.org/stable/std/ffi/type.c_schar.html)
 273 - [`ffi::c_short`](https://doc.rust-lang.org/stable/std/ffi/type.c_short.html)
 274 - [`ffi::c_uchar`](https://doc.rust-lang.org/stable/std/ffi/type.c_uchar.html)
 275 - [`ffi::c_uint`](https://doc.rust-lang.org/stable/std/ffi/type.c_uint.html)
 276 - [`ffi::c_ulong`](https://doc.rust-lang.org/stable/std/ffi/type.c_ulong.html)
 277 - [`ffi::c_ulonglong`](https://doc.rust-lang.org/stable/std/ffi/type.c_ulonglong.html)
 278 - [`ffi::c_ushort`](https://doc.rust-lang.org/stable/std/ffi/type.c_ushort.html)
 279
 280 These APIs are now usable in const contexts:
 281
 282 - [`slice::from_raw_parts`](https://doc.rust-lang.org/stable/core/slice/fn.from_raw_parts.html)
 283
 284 Cargo
 285 -----
 286 - [Packages can now inherit settings from the workspace so that the settings
 287   can be centralized in one place.](https://github.com/rust-lang/cargo/pull/10859) See
 288   [`workspace.package`](https://doc.rust-lang.org/nightly/cargo/reference/workspaces.html#the-workspacepackage-table)
 289   and
 290   [`workspace.dependencies`](https://doc.rust-lang.org/nightly/cargo/reference/workspaces.html#the-workspacedependencies-table)
 291   for more details on how to define these common settings.
 292 - [Cargo commands can now accept multiple `--target` flags to build for
 293   multiple targets at once](https://github.com/rust-lang/cargo/pull/10766), and the
 294   [`build.target`](https://doc.rust-lang.org/nightly/cargo/reference/config.html#buildtarget)
 295   config option may now take an array of multiple targets.
 296 - [The `--jobs` argument can now take a negative number to count backwards from
 297   the max CPUs.](https://github.com/rust-lang/cargo/pull/10844)
 298 - [`cargo add` will now update `Cargo.lock`.](https://github.com/rust-lang/cargo/pull/10902)
 299 - [Added](https://github.com/rust-lang/cargo/pull/10838) the
 300   [`--crate-type`](https://doc.rust-lang.org/nightly/cargo/commands/cargo-rustc.html#option-cargo-rustc---crate-type)
 301   flag to `cargo rustc` to override the crate type.
 302 - [Significantly improved the performance fetching git dependencies from GitHub
 303   when using a hash in the `rev` field.](https://github.com/rust-lang/cargo/pull/10079)
 304
 305 Misc
 306 ----
 307 - [The `rust-analyzer` rustup component is now available on the stable channel.](https://github.com/rust-lang/rust/pull/98640/)
 308
 309 Compatibility Notes
 310 -------------------
 311 - The minimum required versions for all `-linux-gnu` targets are now at least kernel 3.2 and glibc 2.17, for targets that previously supported older versions: [Increase the minimum linux-gnu versions](https://github.com/rust-lang/rust/pull/95026/)
 312 - [Network primitives are now implemented with the ideal Rust layout, not the C system layout](https://github.com/rust-lang/rust/pull/78802/). This can cause problems when transmuting the types.
 313 - [Add assertion that `transmute_copy`'s `U` is not larger than `T`](https://github.com/rust-lang/rust/pull/98839/)
 314 - [A soundness bug in `BTreeMap` was fixed](https://github.com/rust-lang/rust/pull/99413/) that allowed data it was borrowing to be dropped before the container.
 315 - [The Drop behavior of C-like enums cast to ints has changed](https://github.com/rust-lang/rust/pull/96862/). These are already discouraged by a compiler warning.
 316 - [Relate late-bound closure lifetimes to parent fn in NLL](https://github.com/rust-lang/rust/pull/98835/)
 317 - [Errors at const-eval time are now in future incompatibility reports](https://github.com/rust-lang/rust/pull/97743/)
 318 - On the `thumbv6m-none-eabi` target, some incorrect `asm!` statements were erroneously accepted if they used the high registers (r8 to r14) as an input/output operand. [This is no longer accepted](https://github.com/rust-lang/rust/pull/99155/).
 319 - [`impl Trait` was accidentally accepted as the associated type value of return-position `impl Trait`](https://github.com/rust-lang/rust/pull/97346/), without fulfilling all the trait bounds of that associated type, as long as the hidden type satisfies said bounds. This has been fixed.
 320
 321 Internal Changes
 322 ----------------
 323
 324 These changes do not affect any public interfaces of Rust, but they represent
 325 significant improvements to the performance or internals of rustc and related
 326 tools.
 327
 328 - Windows builds now use profile-guided optimization, providing 10-20% improvements to compiler performance: [Utilize PGO for windows x64 rustc dist builds](https://github.com/rust-lang/rust/pull/96978/)
 329 - [Stop keeping metadata in memory before writing it to disk](https://github.com/rust-lang/rust/pull/96544/)
 330 - [compiletest: strip debuginfo by default for mode=ui](https://github.com/rust-lang/rust/pull/98140/)
 331 - Many improvements to generated code for derives, including performance improvements:
 332   - [Don't use match-destructuring for derived ops on structs.](https://github.com/rust-lang/rust/pull/98446/)
 333   - [Many small deriving cleanups](https://github.com/rust-lang/rust/pull/98741/)
 334   - [More derive output improvements](https://github.com/rust-lang/rust/pull/98758/)
 335   - [Clarify deriving code](https://github.com/rust-lang/rust/pull/98915/)
 336   - [Final derive output improvements](https://github.com/rust-lang/rust/pull/99046/)
 337   - [Stop injecting `#[allow(unused_qualifications)]` in generated `derive` implementations](https://github.com/rust-lang/rust/pull/99485/)
 338   - [Improve `derive(Debug)`](https://github.com/rust-lang/rust/pull/98190/)
 339 - [Bump to clap 3](https://github.com/rust-lang/rust/pull/98213/)
 340 - [fully move dropck to mir](https://github.com/rust-lang/rust/pull/98641/)
 341 - [Optimize `Vec::insert` for the case where `index == len`.](https://github.com/rust-lang/rust/pull/98755/)
 342 - [Convert rust-analyzer to an in-tree tool](https://github.com/rust-lang/rust/pull/99603/)
 343
 344 Version 1.63.0 (2022-08-11)
 345 ==========================
 346
 347 Language
 348 --------
 349 - [Remove migrate borrowck mode for pre-NLL errors.][95565]
 350 - [Modify MIR building to drop repeat expressions with length zero.][95953]
 351 - [Remove label/lifetime shadowing warnings.][96296]
 352 - [Allow explicit generic arguments in the presence of `impl Trait` args.][96868]
 353 - [Make `cenum_impl_drop_cast` warnings deny-by-default.][97652]
 354 - [Prevent unwinding when `-C panic=abort` is used regardless of declared ABI.][96959]
 355 - [lub: don't bail out due to empty binders.][97867]
 356
 357 Compiler
 358 --------
 359 - [Stabilize the `bundle` native library modifier,][95818] also removing the
 360   deprecated `static-nobundle` linking kind.
 361 - [Add Apple WatchOS compile targets\*.][95243]
 362 - [Add a Windows application manifest to rustc-main.][96737]
 363
 364 \* Refer to Rust's [platform support page][platform-support-doc] for more
 365    information on Rust's tiered platform support.
 366
 367 Libraries
 368 ---------
 369 - [Implement `Copy`, `Clone`, `PartialEq` and `Eq` for `core::fmt::Alignment`.][94530]
 370 - [Extend `ptr::null` and `null_mut` to all thin (including extern) types.][94954]
 371 - [`impl Read and Write for VecDeque<u8>`.][95632]
 372 - [STD support for the Nintendo 3DS.][95897]
 373 - [Use rounding in float to Duration conversion methods.][96051]
 374 - [Make write/print macros eagerly drop temporaries.][96455]
 375 - [Implement internal traits that enable `[OsStr]::join`.][96881]
 376 - [Implement `Hash` for `core::alloc::Layout`.][97034]
 377 - [Add capacity documentation for `OsString`.][97202]
 378 - [Put a bound on collection misbehavior.][97316]
 379 - [Make `std::mem::needs_drop` accept `?Sized`.][97675]
 380 - [`impl Termination for Infallible` and then make the `Result` impls of `Termination` more generic.][97803]
 381 - [Document Rust's stance on `/proc/self/mem`.][97837]
 382
 383 Stabilized APIs
 384 ---------------
 385
 386 - [`array::from_fn`]
 387 - [`Box::into_pin`]
 388 - [`BinaryHeap::try_reserve`]
 389 - [`BinaryHeap::try_reserve_exact`]
 390 - [`OsString::try_reserve`]
 391 - [`OsString::try_reserve_exact`]
 392 - [`PathBuf::try_reserve`]
 393 - [`PathBuf::try_reserve_exact`]
 394 - [`Path::try_exists`]
 395 - [`Ref::filter_map`]
 396 - [`RefMut::filter_map`]
 397 - [`NonNull::<[T]>::len`][`NonNull::<slice>::len`]
 398 - [`ToOwned::clone_into`]
 399 - [`Ipv6Addr::to_ipv4_mapped`]
 400 - [`unix::io::AsFd`]
 401 - [`unix::io::BorrowedFd<'fd>`]
 402 - [`unix::io::OwnedFd`]
 403 - [`windows::io::AsHandle`]
 404 - [`windows::io::BorrowedHandle<'handle>`]
 405 - [`windows::io::OwnedHandle`]
 406 - [`windows::io::HandleOrInvalid`]
 407 - [`windows::io::HandleOrNull`]
 408 - [`windows::io::InvalidHandleError`]
 409 - [`windows::io::NullHandleError`]
 410 - [`windows::io::AsSocket`]
 411 - [`windows::io::BorrowedSocket<'handle>`]
 412 - [`windows::io::OwnedSocket`]
 413 - [`thread::scope`]
 414 - [`thread::Scope`]
 415 - [`thread::ScopedJoinHandle`]
 416
 417 These APIs are now usable in const contexts:
 418
 419 - [`array::from_ref`]
 420 - [`slice::from_ref`]
 421 - [`intrinsics::copy`]
 422 - [`intrinsics::copy_nonoverlapping`]
 423 - [`<*const T>::copy_to`]
 424 - [`<*const T>::copy_to_nonoverlapping`]
 425 - [`<*mut T>::copy_to`]
 426 - [`<*mut T>::copy_to_nonoverlapping`]
 427 - [`<*mut T>::copy_from`]
 428 - [`<*mut T>::copy_from_nonoverlapping`]
 429 - [`str::from_utf8`]
 430 - [`Utf8Error::error_len`]
 431 - [`Utf8Error::valid_up_to`]
 432 - [`Condvar::new`]
 433 - [`Mutex::new`]
 434 - [`RwLock::new`]
 435
 436 Cargo
 437 -----
 438 - [Stabilize the `--config path` command-line argument.][cargo/10755]
 439 - [Expose rust-version in the environment as `CARGO_PKG_RUST_VERSION`.][cargo/10713]
 440
 441 Compatibility Notes
 442 -------------------
 443
 444 - [`#[link]` attributes are now checked more strictly,][96885] which may introduce
 445   errors for invalid attribute arguments that were previously ignored.
 446 - [Rounding is now used when converting a float to a `Duration`.][96051] The converted
 447   duration can differ slightly from what it was.
 448
 449 Internal Changes
 450 ----------------
 451
 452 These changes provide no direct user facing benefits, but represent significant
 453 improvements to the internals and overall performance of rustc
 454 and related tools.
 455
 456 - [Prepare Rust for LLVM opaque pointers.][94214]
 457
 458 [94214]: https://github.com/rust-lang/rust/pull/94214/
 459 [94530]: https://github.com/rust-lang/rust/pull/94530/
 460 [94954]: https://github.com/rust-lang/rust/pull/94954/
 461 [95243]: https://github.com/rust-lang/rust/pull/95243/
 462 [95565]: https://github.com/rust-lang/rust/pull/95565/
 463 [95632]: https://github.com/rust-lang/rust/pull/95632/
 464 [95818]: https://github.com/rust-lang/rust/pull/95818/
 465 [95897]: https://github.com/rust-lang/rust/pull/95897/
 466 [95953]: https://github.com/rust-lang/rust/pull/95953/
 467 [96051]: https://github.com/rust-lang/rust/pull/96051/
 468 [96296]: https://github.com/rust-lang/rust/pull/96296/
 469 [96455]: https://github.com/rust-lang/rust/pull/96455/
 470 [96737]: https://github.com/rust-lang/rust/pull/96737/
 471 [96868]: https://github.com/rust-lang/rust/pull/96868/
 472 [96881]: https://github.com/rust-lang/rust/pull/96881/
 473 [96885]: https://github.com/rust-lang/rust/pull/96885/
 474 [96959]: https://github.com/rust-lang/rust/pull/96959/
 475 [97034]: https://github.com/rust-lang/rust/pull/97034/
 476 [97202]: https://github.com/rust-lang/rust/pull/97202/
 477 [97316]: https://github.com/rust-lang/rust/pull/97316/
 478 [97652]: https://github.com/rust-lang/rust/pull/97652/
 479 [97675]: https://github.com/rust-lang/rust/pull/97675/
 480 [97803]: https://github.com/rust-lang/rust/pull/97803/
 481 [97837]: https://github.com/rust-lang/rust/pull/97837/
 482 [97867]: https://github.com/rust-lang/rust/pull/97867/
 483 [cargo/10713]: https://github.com/rust-lang/cargo/pull/10713/
 484 [cargo/10755]: https://github.com/rust-lang/cargo/pull/10755/
 485
 486 [`array::from_fn`]: https://doc.rust-lang.org/stable/std/array/fn.from_fn.html
 487 [`Box::into_pin`]: https://doc.rust-lang.org/stable/std/boxed/struct.Box.html#method.into_pin
 488 [`BinaryHeap::try_reserve_exact`]: https://doc.rust-lang.org/stable/alloc/collections/binary_heap/struct.BinaryHeap.html#method.try_reserve_exact
 489 [`BinaryHeap::try_reserve`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.try_reserve
 490 [`OsString::try_reserve`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.try_reserve
 491 [`OsString::try_reserve_exact`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.try_reserve_exact
 492 [`PathBuf::try_reserve`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.try_reserve
 493 [`PathBuf::try_reserve_exact`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.try_reserve_exact
 494 [`Path::try_exists`]: https://doc.rust-lang.org/stable/std/path/struct.Path.html#method.try_exists
 495 [`Ref::filter_map`]: https://doc.rust-lang.org/stable/std/cell/struct.Ref.html#method.filter_map
 496 [`RefMut::filter_map`]: https://doc.rust-lang.org/stable/std/cell/struct.RefMut.html#method.filter_map
 497 [`NonNull::<slice>::len`]: https://doc.rust-lang.org/stable/std/ptr/struct.NonNull.html#method.len
 498 [`ToOwned::clone_into`]: https://doc.rust-lang.org/stable/std/borrow/trait.ToOwned.html#method.clone_into
 499 [`Ipv6Addr::to_ipv4_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4_mapped
 500 [`unix::io::AsFd`]: https://doc.rust-lang.org/stable/std/os/unix/io/trait.AsFd.html
 501 [`unix::io::BorrowedFd<'fd>`]: https://doc.rust-lang.org/stable/std/os/unix/io/struct.BorrowedFd.html
 502 [`unix::io::OwnedFd`]: https://doc.rust-lang.org/stable/std/os/unix/io/struct.OwnedFd.html
 503 [`windows::io::AsHandle`]: https://doc.rust-lang.org/stable/std/os/windows/io/trait.AsHandle.html
 504 [`windows::io::BorrowedHandle<'handle>`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.BorrowedHandle.html
 505 [`windows::io::OwnedHandle`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.OwnedHandle.html
 506 [`windows::io::HandleOrInvalid`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.HandleOrInvalid.html
 507 [`windows::io::HandleOrNull`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.HandleOrNull.html
 508 [`windows::io::InvalidHandleError`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.InvalidHandleError.html
 509 [`windows::io::NullHandleError`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.NullHandleError.html
 510 [`windows::io::AsSocket`]: https://doc.rust-lang.org/stable/std/os/windows/io/trait.AsSocket.html
 511 [`windows::io::BorrowedSocket<'handle>`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.BorrowedSocket.html
 512 [`windows::io::OwnedSocket`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.OwnedSocket.html
 513 [`thread::scope`]: https://doc.rust-lang.org/stable/std/thread/fn.scope.html
 514 [`thread::Scope`]: https://doc.rust-lang.org/stable/std/thread/struct.Scope.html
 515 [`thread::ScopedJoinHandle`]: https://doc.rust-lang.org/stable/std/thread/struct.ScopedJoinHandle.html
 516
 517 [`array::from_ref`]: https://doc.rust-lang.org/stable/std/array/fn.from_ref.html
 518 [`slice::from_ref`]: https://doc.rust-lang.org/stable/std/slice/fn.from_ref.html
 519 [`intrinsics::copy`]: https://doc.rust-lang.org/stable/std/intrinsics/fn.copy.html
 520 [`intrinsics::copy_nonoverlapping`]: https://doc.rust-lang.org/stable/std/intrinsics/fn.copy_nonoverlapping.html
 521 [`<*const T>::copy_to`]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.copy_to
 522 [`<*const T>::copy_to_nonoverlapping`]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.copy_to_nonoverlapping
 523 [`<*mut T>::copy_to`]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.copy_to-1
 524 [`<*mut T>::copy_to_nonoverlapping`]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
 525 [`<*mut T>::copy_from`]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.copy_from
 526 [`<*mut T>::copy_from_nonoverlapping`]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.copy_from_nonoverlapping
 527 [`str::from_utf8`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8.html
 528 [`Utf8Error::error_len`]: https://doc.rust-lang.org/stable/std/str/struct.Utf8Error.html#method.error_len
 529 [`Utf8Error::valid_up_to`]: https://doc.rust-lang.org/stable/std/str/struct.Utf8Error.html#method.valid_up_to
 530 [`Condvar::new`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.new
 531 [`Mutex::new`]: https://doc.rust-lang.org/stable/std/sync/struct.Mutex.html#method.new
 532 [`RwLock::new`]: https://doc.rust-lang.org/stable/std/sync/struct.RwLock.html#method.new
 533
 534 Version 1.62.1 (2022-07-19)
 535 ==========================
 536
 537 Rust 1.62.1 addresses a few recent regressions in the compiler and standard
 538 library, and also mitigates a CPU vulnerability on Intel SGX.
 539
 540 * [The compiler fixed unsound function coercions involving `impl Trait` return types.][98608]
 541 * [The compiler fixed an incremental compilation bug with `async fn` lifetimes.][98890]
 542 * [Windows added a fallback for overlapped I/O in synchronous reads and writes.][98950]
 543 * [The `x86_64-fortanix-unknown-sgx` target added a mitigation for the
 544   MMIO stale data vulnerability][98126], advisory [INTEL-SA-00615].
 545
 546 [98608]: https://github.com/rust-lang/rust/issues/98608
 547 [98890]: https://github.com/rust-lang/rust/issues/98890
 548 [98950]: https://github.com/rust-lang/rust/pull/98950
 549 [98126]: https://github.com/rust-lang/rust/pull/98126
 550 [INTEL-SA-00615]: https://www.intel.com/content/www/us/en/security-center/advisory/intel-sa-00615.html
 551
 552 Version 1.62.0 (2022-06-30)
 553 ==========================
 554
 555 Language
 556 --------
 557
 558 - [Stabilize `#[derive(Default)]` on enums with a `#[default]` variant][94457]
 559 - [Teach flow sensitive checks that visibly uninhabited call expressions never return][93313]
 560 - [Fix constants not getting dropped if part of a diverging expression][94775]
 561 - [Support unit struct/enum variant in destructuring assignment][95380]
 562 - [Remove mutable_borrow_reservation_conflict lint and allow the code pattern][96268]
 563 - [`const` functions may now specify `extern "C"` or `extern "Rust"`][95346]
 564
 565 Compiler
 566 --------
 567
 568 - [linker: Stop using whole-archive on dependencies of dylibs][96436]
 569 - [Make `unaligned_references` lint deny-by-default][95372]
 570   This lint is also a future compatibility lint, and is expected to eventually
 571   become a hard error.
 572 - [Only add codegen backend to dep info if -Zbinary-dep-depinfo is used][93969]
 573 - [Reject `#[thread_local]` attribute on non-static items][95006]
 574 - [Add tier 3 `aarch64-pc-windows-gnullvm` and `x86_64-pc-windows-gnullvm` targets\*][94872]
 575 - [Implement a lint to warn about unused macro rules][96150]
 576 - [Promote `x86_64-unknown-none` target to Tier 2\*][95705]
 577
 578 \* Refer to Rust's [platform support page][platform-support-doc] for more
 579    information on Rust's tiered platform support.
 580
 581 Libraries
 582 ---------
 583
 584 - [Windows: Use a pipe relay for chaining pipes][95841]
 585 - [Replace Linux Mutex and Condvar with futex based ones.][95035]
 586 - [Replace RwLock by a futex based one on Linux][95801]
 587 - [std: directly use pthread in UNIX parker implementation][96393]
 588
 589 Stabilized APIs
 590 ---------------
 591
 592 - [`bool::then_some`]
 593 - [`f32::total_cmp`]
 594 - [`f64::total_cmp`]
 595 - [`Stdin::lines`]
 596 - [`windows::CommandExt::raw_arg`]
 597 - [`impl<T: Default> Default for AssertUnwindSafe<T>`]
 598 - [`From<Rc<str>> for Rc<[u8]>`][rc-u8-from-str]
 599 - [`From<Arc<str>> for Arc<[u8]>`][arc-u8-from-str]
 600 - [`FusedIterator for EncodeWide`]
 601 - [RDM intrinsics on aarch64][stdarch/1285]
 602
 603 Clippy
 604 ------
 605
 606 - [Create clippy lint against unexpectedly late drop for temporaries in match scrutinee expressions][94206]
 607
 608 Cargo
 609 -----
 610
 611 - Added the `cargo add` command for adding dependencies to `Cargo.toml` from
 612   the command-line.
 613   [docs](https://doc.rust-lang.org/nightly/cargo/commands/cargo-add.html)
 614 - Package ID specs now support `name@version` syntax in addition to the
 615   previous `name:version` to align with the behavior in `cargo add` and other
 616   tools. `cargo install` and `cargo yank` also now support this syntax so the
 617   version does not need to passed as a separate flag.
 618 - The `git` and `registry` directories in Cargo's home directory (usually
 619   `~/.cargo`) are now marked as cache directories so that they are not
 620   included in backups or content indexing (on Windows).
 621 - Added automatic `@` argfile support, which will use "response files" if the
 622   command-line to `rustc` exceeds the operating system's limit.
 623
 624 Compatibility Notes
 625 -------------------
 626
 627 - `cargo test` now passes `--target` to `rustdoc` if the specified target is
 628   the same as the host target.
 629   [#10594](https://github.com/rust-lang/cargo/pull/10594)
 630 - [rustdoc: doctests are now run on unexported `macro_rules!` macros, matching other private items][96630]
 631 - [rustdoc: Remove .woff font files][96279]
 632 - [Enforce Copy bounds for repeat elements while considering lifetimes][95819]
 633 - [Windows: Fix potentinal unsoundness by aborting if `File` reads or writes cannot
 634   complete synchronously][95469].
 635
 636 Internal Changes
 637 ----------------
 638
 639 - [Unify ReentrantMutex implementations across all platforms][96042]
 640
 641 These changes provide no direct user facing benefits, but represent significant
 642 improvements to the internals and overall performance of rustc
 643 and related tools.
 644
 645 [93313]: https://github.com/rust-lang/rust/pull/93313/
 646 [93969]: https://github.com/rust-lang/rust/pull/93969/
 647 [94206]: https://github.com/rust-lang/rust/pull/94206/
 648 [94457]: https://github.com/rust-lang/rust/pull/94457/
 649 [94775]: https://github.com/rust-lang/rust/pull/94775/
 650 [94872]: https://github.com/rust-lang/rust/pull/94872/
 651 [95006]: https://github.com/rust-lang/rust/pull/95006/
 652 [95035]: https://github.com/rust-lang/rust/pull/95035/
 653 [95346]: https://github.com/rust-lang/rust/pull/95346/
 654 [95372]: https://github.com/rust-lang/rust/pull/95372/
 655 [95380]: https://github.com/rust-lang/rust/pull/95380/
 656 [95431]: https://github.com/rust-lang/rust/pull/95431/
 657 [95469]: https://github.com/rust-lang/rust/pull/95469/
 658 [95705]: https://github.com/rust-lang/rust/pull/95705/
 659 [95801]: https://github.com/rust-lang/rust/pull/95801/
 660 [95819]: https://github.com/rust-lang/rust/pull/95819/
 661 [95841]: https://github.com/rust-lang/rust/pull/95841/
 662 [96042]: https://github.com/rust-lang/rust/pull/96042/
 663 [96150]: https://github.com/rust-lang/rust/pull/96150/
 664 [96268]: https://github.com/rust-lang/rust/pull/96268/
 665 [96279]: https://github.com/rust-lang/rust/pull/96279/
 666 [96393]: https://github.com/rust-lang/rust/pull/96393/
 667 [96436]: https://github.com/rust-lang/rust/pull/96436/
 668 [96557]: https://github.com/rust-lang/rust/pull/96557/
 669 [96630]: https://github.com/rust-lang/rust/pull/96630/
 670
 671 [`bool::then_some`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then_some
 672 [`f32::total_cmp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.total_cmp
 673 [`f64::total_cmp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.total_cmp
 674 [`Stdin::lines`]: https://doc.rust-lang.org/stable/std/io/struct.Stdin.html#method.lines
 675 [`impl<T: Default> Default for AssertUnwindSafe<T>`]: https://doc.rust-lang.org/stable/std/panic/struct.AssertUnwindSafe.html#impl-Default
 676 [rc-u8-from-str]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#impl-From%3CRc%3Cstr%3E%3E
 677 [arc-u8-from-str]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#impl-From%3CArc%3Cstr%3E%3E
 678 [stdarch/1285]: https://github.com/rust-lang/stdarch/pull/1285
 679 [`windows::CommandExt::raw_arg`]: https://doc.rust-lang.org/stable/std/os/windows/process/trait.CommandExt.html#tymethod.raw_arg
 680 [`FusedIterator for EncodeWide`]: https://doc.rust-lang.org/stable/std/os/windows/ffi/struct.EncodeWide.html#impl-FusedIterator
 681
 682 Version 1.61.0 (2022-05-19)
 683 ==========================
 684
 685 Language
 686 --------
 687
 688 - [`const fn` signatures can now include generic trait bounds][93827]
 689 - [`const fn` signatures can now use `impl Trait` in argument and return position][93827]
 690 - [Function pointers can now be created, cast, and passed around in a `const fn`][93827]
 691 - [Recursive calls can now set the value of a function's opaque `impl Trait` return type][94081]
 692
 693 Compiler
 694 --------
 695
 696 - [Linking modifier syntax in `#[link]` attributes and on the command line, as well as the `whole-archive` modifier specifically, are now supported][93901]
 697 - [The `char` type is now described as UTF-32 in debuginfo][89887]
 698 - The [`#[target_feature]`][target_feature] attribute [can now be used with aarch64 features][90621]
 699 - X86 [`#[target_feature = "adx"]` is now stable][93745]
 700
 701 Libraries
 702 ---------
 703
 704 - [`ManuallyDrop<T>` is now documented to have the same layout as `T`][88375]
 705 - [`#[ignore = "…"]` messages are printed when running tests][92714]
 706 - [Consistently show absent stdio handles on Windows as NULL handles][93263]
 707 - [Make `std::io::stdio::lock()` return `'static` handles.][93965] Previously, the creation of locked handles to stdin/stdout/stderr would borrow the handles being locked, which prevented writing `let out = std::io::stdout().lock();` because `out` would outlive the return value of `stdout()`. Such code now works, eliminating a common pitfall that affected many Rust users.
 708 - [`Vec::from_raw_parts` is now less restrictive about its inputs][95016]
 709 - [`std::thread::available_parallelism` now takes cgroup quotas into account.][92697] Since `available_parallelism` is often used to create a thread pool for parallel computation, which may be CPU-bound for performance, `available_parallelism` will return a value consistent with the ability to use that many threads continuously, if possible. For instance, in a container with 8 virtual CPUs but quotas only allowing for 50% usage, `available_parallelism` will return 4.
 710
 711 Stabilized APIs
 712 ---------------
 713
 714 - [`Pin::static_mut`]
 715 - [`Pin::static_ref`]
 716 - [`Vec::retain_mut`]
 717 - [`VecDeque::retain_mut`]
 718 - [`Write` for `Cursor<[u8; N]>`][cursor-write-array]
 719 - [`std::os::unix::net::SocketAddr::from_pathname`]
 720 - [`std::process::ExitCode`] and [`std::process::Termination`]. The stabilization of these two APIs now makes it possible for programs to return errors from `main` with custom exit codes.
 721 - [`std::thread::JoinHandle::is_finished`]
 722
 723 These APIs are now usable in const contexts:
 724
 725 - [`<*const T>::offset` and `<*mut T>::offset`][ptr-offset]
 726 - [`<*const T>::wrapping_offset` and `<*mut T>::wrapping_offset`][ptr-wrapping_offset]
 727 - [`<*const T>::add` and `<*mut T>::add`][ptr-add]
 728 - [`<*const T>::sub` and `<*mut T>::sub`][ptr-sub]
 729 - [`<*const T>::wrapping_add` and `<*mut T>::wrapping_add`][ptr-wrapping_add]
 730 - [`<*const T>::wrapping_sub` and `<*mut T>::wrapping_sub`][ptr-wrapping_sub]
 731 - [`<[T]>::as_mut_ptr`][slice-as_mut_ptr]
 732 - [`<[T]>::as_ptr_range`][slice-as_ptr_range]
 733 - [`<[T]>::as_mut_ptr_range`][slice-as_mut_ptr_range]
 734
 735 Cargo
 736 -----
 737
 738 No feature changes, but see compatibility notes.
 739
 740 Compatibility Notes
 741 -------------------
 742
 743 - Previously native static libraries were linked as `whole-archive` in some cases, but now rustc tries not to use `whole-archive` unless explicitly requested. This [change][93901] may result in linking errors in some cases. To fix such errors, native libraries linked from the command line, build scripts, or [`#[link]` attributes][link-attr] need to
 744   - (more common) either be reordered to respect dependencies between them (if `a` depends on `b` then `a` should go first and `b` second)
 745   - (less common) or be updated to use the [`+whole-archive`] modifier.
 746 - [Catching a second unwind from FFI code while cleaning up from a Rust panic now causes the process to abort][92911]
 747 - [Proc macros no longer see `ident` matchers wrapped in groups][92472]
 748 - [The number of `#` in `r#` raw string literals is now required to be less than 256][95251]
 749 - [When checking that a dyn type satisfies a trait bound, supertrait bounds are now enforced][92285]
 750 - [`cargo vendor` now only accepts one value for each `--sync` flag][cargo/10448]
 751 - [`cfg` predicates in `all()` and `any()` are always evaluated to detect errors, instead of short-circuiting.][94295] The compatibility considerations here arise in nightly-only code that used the short-circuiting behavior of `all` to write something like `cfg(all(feature = "nightly", syntax-requiring-nightly))`, which will now fail to compile. Instead, use either `cfg_attr(feature = "nightly", ...)` or nested uses of `cfg`.
 752 - [bootstrap: static-libstdcpp is now enabled by default, and can now be disabled when llvm-tools is enabled][94832]
 753
 754 Internal Changes
 755 ----------------
 756
 757 These changes provide no direct user facing benefits, but represent significant
 758 improvements to the internals and overall performance of rustc
 759 and related tools.
 760
 761 - [debuginfo: Refactor debuginfo generation for types][94261]
 762 - [Remove the everybody loops pass][93913]
 763
 764 [88375]: https://github.com/rust-lang/rust/pull/88375/
 765 [89887]: https://github.com/rust-lang/rust/pull/89887/
 766 [90621]: https://github.com/rust-lang/rust/pull/90621/
 767 [92285]: https://github.com/rust-lang/rust/pull/92285/
 768 [92472]: https://github.com/rust-lang/rust/pull/92472/
 769 [92697]: https://github.com/rust-lang/rust/pull/92697/
 770 [92714]: https://github.com/rust-lang/rust/pull/92714/
 771 [92911]: https://github.com/rust-lang/rust/pull/92911/
 772 [93263]: https://github.com/rust-lang/rust/pull/93263/
 773 [93745]: https://github.com/rust-lang/rust/pull/93745/
 774 [93827]: https://github.com/rust-lang/rust/pull/93827/
 775 [93901]: https://github.com/rust-lang/rust/pull/93901/
 776 [93913]: https://github.com/rust-lang/rust/pull/93913/
 777 [93965]: https://github.com/rust-lang/rust/pull/93965/
 778 [94081]: https://github.com/rust-lang/rust/pull/94081/
 779 [94261]: https://github.com/rust-lang/rust/pull/94261/
 780 [94295]: https://github.com/rust-lang/rust/pull/94295/
 781 [94832]: https://github.com/rust-lang/rust/pull/94832/
 782 [95016]: https://github.com/rust-lang/rust/pull/95016/
 783 [95251]: https://github.com/rust-lang/rust/pull/95251/
 784 [`+whole-archive`]: https://doc.rust-lang.org/stable/rustc/command-line-arguments.html#linking-modifiers-whole-archive
 785 [`Pin::static_mut`]: https://doc.rust-lang.org/stable/std/pin/struct.Pin.html#method.static_mut
 786 [`Pin::static_ref`]: https://doc.rust-lang.org/stable/std/pin/struct.Pin.html#method.static_ref
 787 [`Vec::retain_mut`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.retain_mut
 788 [`VecDeque::retain_mut`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.retain_mut
 789 [`std::os::unix::net::SocketAddr::from_pathname`]: https://doc.rust-lang.org/stable/std/os/unix/net/struct.SocketAddr.html#method.from_pathname
 790 [`std::process::ExitCode`]: https://doc.rust-lang.org/stable/std/process/struct.ExitCode.html
 791 [`std::process::Termination`]: https://doc.rust-lang.org/stable/std/process/trait.Termination.html
 792 [`std::thread::JoinHandle::is_finished`]: https://doc.rust-lang.org/stable/std/thread/struct.JoinHandle.html#method.is_finished
 793 [cargo/10448]: https://github.com/rust-lang/cargo/pull/10448/
 794 [cursor-write-array]: https://doc.rust-lang.org/stable/std/io/struct.Cursor.html#impl-Write-4
 795 [link-attr]: https://doc.rust-lang.org/stable/reference/items/external-blocks.html#the-link-attribute
 796 [ptr-add]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.add
 797 [ptr-offset]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.offset
 798 [ptr-sub]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.sub
 799 [ptr-wrapping_add]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.wrapping_add
 800 [ptr-wrapping_offset]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.wrapping_offset
 801 [ptr-wrapping_sub]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.wrapping_sub
 802 [slice-as_mut_ptr]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.as_mut_ptr
 803 [slice-as_mut_ptr_range]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.as_mut_ptr_range
 804 [slice-as_ptr_range]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.as_ptr_range
 805 [target_feature]: https://doc.rust-lang.org/reference/attributes/codegen.html#the-target_feature-attribute
 806
 807
 808 Version 1.60.0 (2022-04-07)
 809 ==========================
 810
 811 Language
 812 --------
 813 - [Stabilize `#[cfg(panic = "...")]` for either `"unwind"` or `"abort"`.][93658]
 814 - [Stabilize `#[cfg(target_has_atomic = "...")]` for each integer size and `"ptr"`.][93824]
 815
 816 Compiler
 817 --------
 818 - [Enable combining `+crt-static` and `relocation-model=pic` on `x86_64-unknown-linux-gnu`][86374]
 819 - [Fixes wrong `unreachable_pub` lints on nested and glob public reexport][87487]
 820 - [Stabilize `-Z instrument-coverage` as `-C instrument-coverage`][90132]
 821 - [Stabilize `-Z print-link-args` as `--print link-args`][91606]
 822 - [Add new Tier 3 target `mips64-openwrt-linux-musl`\*][92300]
 823 - [Add new Tier 3 target `armv7-unknown-linux-uclibceabi` (softfloat)\*][92383]
 824 - [Fix invalid removal of newlines from doc comments][92357]
 825 - [Add kernel target for RustyHermit][92670]
 826 - [Deny mixing bin crate type with lib crate types][92933]
 827 - [Make rustc use `RUST_BACKTRACE=full` by default][93566]
 828 - [Upgrade to LLVM 14][93577]
 829
 830 \* Refer to Rust's [platform support page][platform-support-doc] for more
 831    information on Rust's tiered platform support.
 832
 833 Libraries
 834 ---------
 835 - [Guarantee call order for `sort_by_cached_key`][89621]
 836 - [Improve `Duration::try_from_secs_f32`/`f64` accuracy by directly processing exponent and mantissa][90247]
 837 - [Make `Instant::{duration_since, elapsed, sub}` saturating][89926]
 838 - [Remove non-monotonic clocks workarounds in `Instant::now`][89926]
 839 - [Make `BuildHasherDefault`, `iter::Empty` and `future::Pending` covariant][92630]
 840
 841 Stabilized APIs
 842 ---------------
 843 - [`Arc::new_cyclic`][arc_new_cyclic]
 844 - [`Rc::new_cyclic`][rc_new_cyclic]
 845 - [`slice::EscapeAscii`][slice_escape_ascii]
 846 - [`<[u8]>::escape_ascii`][slice_u8_escape_ascii]
 847 - [`u8::escape_ascii`][u8_escape_ascii]
 848 - [`Vec::spare_capacity_mut`][vec_spare_capacity_mut]
 849 - [`MaybeUninit::assume_init_drop`][assume_init_drop]
 850 - [`MaybeUninit::assume_init_read`][assume_init_read]
 851 - [`i8::abs_diff`][i8_abs_diff]
 852 - [`i16::abs_diff`][i16_abs_diff]
 853 - [`i32::abs_diff`][i32_abs_diff]
 854 - [`i64::abs_diff`][i64_abs_diff]
 855 - [`i128::abs_diff`][i128_abs_diff]
 856 - [`isize::abs_diff`][isize_abs_diff]
 857 - [`u8::abs_diff`][u8_abs_diff]
 858 - [`u16::abs_diff`][u16_abs_diff]
 859 - [`u32::abs_diff`][u32_abs_diff]
 860 - [`u64::abs_diff`][u64_abs_diff]
 861 - [`u128::abs_diff`][u128_abs_diff]
 862 - [`usize::abs_diff`][usize_abs_diff]
 863 - [`Display for io::ErrorKind`][display_error_kind]
 864 - [`From<u8> for ExitCode`][from_u8_exit_code]
 865 - [`Not for !` (the "never" type)][not_never]
 866 - [_Op_`Assign<$t> for Wrapping<$t>`][wrapping_assign_ops]
 867 - [`arch::is_aarch64_feature_detected!`][is_aarch64_feature_detected]
 868
 869 Cargo
 870 -----
 871 - [Port cargo from `toml-rs` to `toml_edit`][cargo/10086]
 872 - [Stabilize `-Ztimings` as `--timings`][cargo/10245]
 873 - [Stabilize namespaced and weak dependency features.][cargo/10269]
 874 - [Accept more `cargo:rustc-link-arg-*` types from build script output.][cargo/10274]
 875 - [cargo-new should not add ignore rule on Cargo.lock inside subdirs][cargo/10379]
 876
 877 Misc
 878 ----
 879 - [Ship docs on Tier 2 platforms by reusing the closest Tier 1 platform docs][92800]
 880 - [Drop rustc-docs from complete profile][93742]
 881 - [bootstrap: tidy up flag handling for llvm build][93918]
 882
 883 Compatibility Notes
 884 -------------------
 885 - [Remove compiler-rt linking hack on Android][83822]
 886 - [Mitigations for platforms with non-monotonic clocks have been removed from
 887   `Instant::now`][89926]. On platforms that don't provide monotonic clocks, an
 888   instant is not guaranteed to be greater than an earlier instant anymore.
 889 - [`Instant::{duration_since, elapsed, sub}` do not panic anymore on underflow,
 890   saturating to `0` instead][89926]. In the real world the panic happened mostly
 891   on platforms with buggy monotonic clock implementations rather than catching
 892   programming errors like reversing the start and end times. Such programming
 893   errors will now results in `0` rather than a panic.
 894 - In a future release we're planning to increase the baseline requirements for
 895   the Linux kernel to version 3.2, and for glibc to version 2.17. We'd love
 896   your feedback in [PR #95026][95026].
 897
 898 Internal Changes
 899 ----------------
 900
 901 These changes provide no direct user facing benefits, but represent significant
 902 improvements to the internals and overall performance of rustc
 903 and related tools.
 904
 905 - [Switch all libraries to the 2021 edition][92068]
 906
 907 [83822]: https://github.com/rust-lang/rust/pull/83822
 908 [86374]: https://github.com/rust-lang/rust/pull/86374
 909 [87487]: https://github.com/rust-lang/rust/pull/87487
 910 [89621]: https://github.com/rust-lang/rust/pull/89621
 911 [89926]: https://github.com/rust-lang/rust/pull/89926
 912 [90132]: https://github.com/rust-lang/rust/pull/90132
 913 [90247]: https://github.com/rust-lang/rust/pull/90247
 914 [91606]: https://github.com/rust-lang/rust/pull/91606
 915 [92068]: https://github.com/rust-lang/rust/pull/92068
 916 [92300]: https://github.com/rust-lang/rust/pull/92300
 917 [92357]: https://github.com/rust-lang/rust/pull/92357
 918 [92383]: https://github.com/rust-lang/rust/pull/92383
 919 [92630]: https://github.com/rust-lang/rust/pull/92630
 920 [92670]: https://github.com/rust-lang/rust/pull/92670
 921 [92800]: https://github.com/rust-lang/rust/pull/92800
 922 [92933]: https://github.com/rust-lang/rust/pull/92933
 923 [93566]: https://github.com/rust-lang/rust/pull/93566
 924 [93577]: https://github.com/rust-lang/rust/pull/93577
 925 [93658]: https://github.com/rust-lang/rust/pull/93658
 926 [93742]: https://github.com/rust-lang/rust/pull/93742
 927 [93824]: https://github.com/rust-lang/rust/pull/93824
 928 [93918]: https://github.com/rust-lang/rust/pull/93918
 929 [95026]: https://github.com/rust-lang/rust/pull/95026
 930
 931 [cargo/10086]: https://github.com/rust-lang/cargo/pull/10086
 932 [cargo/10245]: https://github.com/rust-lang/cargo/pull/10245
 933 [cargo/10269]: https://github.com/rust-lang/cargo/pull/10269
 934 [cargo/10274]: https://github.com/rust-lang/cargo/pull/10274
 935 [cargo/10379]: https://github.com/rust-lang/cargo/pull/10379
 936
 937 [arc_new_cyclic]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.new_cyclic
 938 [rc_new_cyclic]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.new_cyclic
 939 [slice_escape_ascii]: https://doc.rust-lang.org/stable/std/slice/struct.EscapeAscii.html
 940 [slice_u8_escape_ascii]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.escape_ascii
 941 [u8_escape_ascii]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.escape_ascii
 942 [vec_spare_capacity_mut]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.spare_capacity_mut
 943 [assume_init_drop]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_drop
 944 [assume_init_read]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_read
 945 [i8_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.abs_diff
 946 [i16_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.abs_diff
 947 [i32_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.abs_diff
 948 [i64_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.abs_diff
 949 [i128_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.abs_diff
 950 [isize_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.abs_diff
 951 [u8_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.abs_diff
 952 [u16_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.abs_diff
 953 [u32_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.abs_diff
 954 [u64_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.abs_diff
 955 [u128_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.abs_diff
 956 [usize_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.abs_diff
 957 [display_error_kind]: https://doc.rust-lang.org/stable/std/io/enum.ErrorKind.html#impl-Display
 958 [from_u8_exit_code]: https://doc.rust-lang.org/stable/std/process/struct.ExitCode.html#impl-From%3Cu8%3E
 959 [not_never]: https://doc.rust-lang.org/stable/std/primitive.never.html#impl-Not
 960 [wrapping_assign_ops]: https://doc.rust-lang.org/stable/std/num/struct.Wrapping.html#trait-implementations
 961 [is_aarch64_feature_detected]: https://doc.rust-lang.org/stable/std/arch/macro.is_aarch64_feature_detected.html
 962
 963 Version 1.59.0 (2022-02-24)
 964 ==========================
 965
 966 Language
 967 --------
 968
 969 - [Stabilize default arguments for const parameters and remove the ordering restriction for type and const parameters][90207]
 970 - [Stabilize destructuring assignment][90521]
 971 - [Relax private in public lint on generic bounds and where clauses of trait impls][90586]
 972 - [Stabilize asm! and global_asm! for x86, x86_64, ARM, Aarch64, and RISC-V][91728]
 973
 974 Compiler
 975 --------
 976
 977 - [Stabilize new symbol mangling format, leaving it opt-in (-Csymbol-mangling-version=v0)][90128]
 978 - [Emit LLVM optimization remarks when enabled with `-Cremark`][90833]
 979 - [Fix sparc64 ABI for aggregates with floating point members][91003]
 980 - [Warn when a `#[test]`-like built-in attribute macro is present multiple times.][91172]
 981 - [Add support for riscv64gc-unknown-freebsd][91284]
 982 - [Stabilize `-Z emit-future-incompat` as `--json future-incompat`][91535]
 983 - [Soft disable incremental compilation][94124]
 984
 985 This release disables incremental compilation, unless the user has explicitly
 986 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
 987 This is due to a known and relatively frequently occurring bug in incremental
 988 compilation, which causes builds to issue internal compiler errors. This
 989 particular bug is already fixed on nightly, but that fix has not yet rolled out
 990 to stable and is deemed too risky for a direct stable backport.
 991
 992 As always, we encourage users to test with nightly and report bugs so that we
 993 can track failures and fix issues earlier.
 994
 995 See [94124] for more details.
 996
 997 [94124]: https://github.com/rust-lang/rust/issues/94124
 998
 999 Libraries
1000 ---------
1001
1002 - [Remove unnecessary bounds for some Hash{Map,Set} methods][91593]
1003
1004 Stabilized APIs
1005 ---------------
1006
1007 - [`std::thread::available_parallelism`][available_parallelism]
1008 - [`Result::copied`][result-copied]
1009 - [`Result::cloned`][result-cloned]
1010 - [`arch::asm!`][asm]
1011 - [`arch::global_asm!`][global_asm]
1012 - [`ops::ControlFlow::is_break`][is_break]
1013 - [`ops::ControlFlow::is_continue`][is_continue]
1014 - [`TryFrom<char> for u8`][try_from_char_u8]
1015 - [`char::TryFromCharError`][try_from_char_err]
1016   implementing `Clone`, `Debug`, `Display`, `PartialEq`, `Copy`, `Eq`, `Error`
1017 - [`iter::zip`][zip]
1018 - [`NonZeroU8::is_power_of_two`][is_power_of_two8]
1019 - [`NonZeroU16::is_power_of_two`][is_power_of_two16]
1020 - [`NonZeroU32::is_power_of_two`][is_power_of_two32]
1021 - [`NonZeroU64::is_power_of_two`][is_power_of_two64]
1022 - [`NonZeroU128::is_power_of_two`][is_power_of_two128]
1023 - [`NonZeroUsize::is_power_of_two`][is_power_of_two_usize]
1024 - [`DoubleEndedIterator for ToLowercase`][lowercase]
1025 - [`DoubleEndedIterator for ToUppercase`][uppercase]
1026 - [`TryFrom<&mut [T]> for [T; N]`][tryfrom_ref_arr]
1027 - [`UnwindSafe for Once`][unwindsafe_once]
1028 - [`RefUnwindSafe for Once`][refunwindsafe_once]
1029 - [armv8 neon intrinsics for aarch64][stdarch/1266]
1030
1031 Const-stable:
1032
1033 - [`mem::MaybeUninit::as_ptr`][muninit_ptr]
1034 - [`mem::MaybeUninit::assume_init`][muninit_init]
1035 - [`mem::MaybeUninit::assume_init_ref`][muninit_init_ref]
1036 - [`ffi::CStr::from_bytes_with_nul_unchecked`][cstr_from_bytes]
1037
1038 Cargo
1039 -----
1040
1041 - [Stabilize the `strip` profile option][cargo/10088]
1042 - [Stabilize future-incompat-report][cargo/10165]
1043 - [Support abbreviating `--release` as `-r`][cargo/10133]
1044 - [Support `term.quiet` configuration][cargo/10152]
1045 - [Remove `--host` from cargo {publish,search,login}][cargo/10145]
1046
1047 Compatibility Notes
1048 -------------------
1049
1050 - [Refactor weak symbols in std::sys::unix][90846]
1051   This may add new, versioned, symbols when building with a newer glibc, as the
1052   standard library uses weak linkage rather than dynamically attempting to load
1053   certain symbols at runtime.
1054 - [Deprecate crate_type and crate_name nested inside `#![cfg_attr]`][83744]
1055   This adds a future compatibility lint to supporting the use of cfg_attr
1056   wrapping either crate_type or crate_name specification within Rust files;
1057   it is recommended that users migrate to setting the equivalent command line
1058   flags.
1059 - [Remove effect of `#[no_link]` attribute on name resolution][92034]
1060   This may expose new names, leading to conflicts with preexisting names in a
1061   given namespace and a compilation failure.
1062 - [Cargo will document libraries before binaries.][cargo/10172]
1063 - [Respect doc=false in dependencies, not just the root crate][cargo/10201]
1064 - [Weaken guarantee around advancing underlying iterators in zip][83791]
1065 - [Make split_inclusive() on an empty slice yield an empty output][89825]
1066 - [Update std::env::temp_dir to use GetTempPath2 on Windows when available.][89999]
1067 - [unreachable! was updated to match other formatting macro behavior on Rust 2021][92137]
1068
1069 Internal Changes
1070 ----------------
1071
1072 These changes provide no direct user facing benefits, but represent significant
1073 improvements to the internals and overall performance of rustc
1074 and related tools.
1075
1076 - [Fix many cases of normalization-related ICEs][91255]
1077 - [Replace dominators algorithm with simple Lengauer-Tarjan][85013]
1078 - [Store liveness in interval sets for region inference][90637]
1079
1080 - [Remove `in_band_lifetimes` from the compiler and standard library, in preparation for removing this
1081   unstable feature.][91867]
1082
1083 [91867]: https://github.com/rust-lang/rust/issues/91867
1084 [83744]: https://github.com/rust-lang/rust/pull/83744/
1085 [83791]: https://github.com/rust-lang/rust/pull/83791/
1086 [85013]: https://github.com/rust-lang/rust/pull/85013/
1087 [89825]: https://github.com/rust-lang/rust/pull/89825/
1088 [89999]: https://github.com/rust-lang/rust/pull/89999/
1089 [90128]: https://github.com/rust-lang/rust/pull/90128/
1090 [90207]: https://github.com/rust-lang/rust/pull/90207/
1091 [90521]: https://github.com/rust-lang/rust/pull/90521/
1092 [90586]: https://github.com/rust-lang/rust/pull/90586/
1093 [90637]: https://github.com/rust-lang/rust/pull/90637/
1094 [90833]: https://github.com/rust-lang/rust/pull/90833/
1095 [90846]: https://github.com/rust-lang/rust/pull/90846/
1096 [91003]: https://github.com/rust-lang/rust/pull/91003/
1097 [91172]: https://github.com/rust-lang/rust/pull/91172/
1098 [91255]: https://github.com/rust-lang/rust/pull/91255/
1099 [91284]: https://github.com/rust-lang/rust/pull/91284/
1100 [91535]: https://github.com/rust-lang/rust/pull/91535/
1101 [91593]: https://github.com/rust-lang/rust/pull/91593/
1102 [91728]: https://github.com/rust-lang/rust/pull/91728/
1103 [91878]: https://github.com/rust-lang/rust/pull/91878/
1104 [91896]: https://github.com/rust-lang/rust/pull/91896/
1105 [91926]: https://github.com/rust-lang/rust/pull/91926/
1106 [91984]: https://github.com/rust-lang/rust/pull/91984/
1107 [92020]: https://github.com/rust-lang/rust/pull/92020/
1108 [92034]: https://github.com/rust-lang/rust/pull/92034/
1109 [92137]: https://github.com/rust-lang/rust/pull/92137/
1110 [92483]: https://github.com/rust-lang/rust/pull/92483/
1111 [cargo/10088]: https://github.com/rust-lang/cargo/pull/10088/
1112 [cargo/10133]: https://github.com/rust-lang/cargo/pull/10133/
1113 [cargo/10145]: https://github.com/rust-lang/cargo/pull/10145/
1114 [cargo/10152]: https://github.com/rust-lang/cargo/pull/10152/
1115 [cargo/10165]: https://github.com/rust-lang/cargo/pull/10165/
1116 [cargo/10172]: https://github.com/rust-lang/cargo/pull/10172/
1117 [cargo/10201]: https://github.com/rust-lang/cargo/pull/10201/
1118 [cargo/10269]: https://github.com/rust-lang/cargo/pull/10269/
1119
1120 [cstr_from_bytes]: https://doc.rust-lang.org/stable/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked
1121 [muninit_ptr]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.as_ptr
1122 [muninit_init]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init
1123 [muninit_init_ref]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
1124 [unwindsafe_once]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#impl-UnwindSafe
1125 [refunwindsafe_once]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#impl-RefUnwindSafe
1126 [tryfrom_ref_arr]: https://doc.rust-lang.org/stable/std/convert/trait.TryFrom.html#impl-TryFrom%3C%26%27_%20mut%20%5BT%5D%3E
1127 [lowercase]: https://doc.rust-lang.org/stable/std/char/struct.ToLowercase.html#impl-DoubleEndedIterator
1128 [uppercase]: https://doc.rust-lang.org/stable/std/char/struct.ToUppercase.html#impl-DoubleEndedIterator
1129 [try_from_char_err]: https://doc.rust-lang.org/stable/std/char/struct.TryFromCharError.html
1130 [available_parallelism]: https://doc.rust-lang.org/stable/std/thread/fn.available_parallelism.html
1131 [result-copied]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.copied
1132 [result-cloned]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.cloned
1133 [asm]: https://doc.rust-lang.org/stable/core/arch/macro.asm.html
1134 [global_asm]: https://doc.rust-lang.org/stable/core/arch/macro.global_asm.html
1135 [is_break]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html#method.is_break
1136 [is_continue]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html#method.is_continue
1137 [try_from_char_u8]: https://doc.rust-lang.org/stable/std/primitive.char.html#impl-TryFrom%3Cchar%3E
1138 [zip]: https://doc.rust-lang.org/stable/std/iter/fn.zip.html
1139 [is_power_of_two8]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU8.html#method.is_power_of_two
1140 [is_power_of_two16]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU16.html#method.is_power_of_two
1141 [is_power_of_two32]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU32.html#method.is_power_of_two
1142 [is_power_of_two64]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU64.html#method.is_power_of_two
1143 [is_power_of_two128]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU128.html#method.is_power_of_two
1144 [is_power_of_two_usize]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroUsize.html#method.is_power_of_two
1145 [stdarch/1266]: https://github.com/rust-lang/stdarch/pull/1266
1146
1147 Version 1.58.1 (2022-01-19)
1148 ===========================
1149
1150 * Fix race condition in `std::fs::remove_dir_all` ([CVE-2022-21658])
1151 * [Handle captured arguments in the `useless_format` Clippy lint][clippy/8295]
1152 * [Move `non_send_fields_in_send_ty` Clippy lint to nursery][clippy/8075]
1153 * [Fix wrong error message displayed when some imports are missing][91254]
1154 * [Fix rustfmt not formatting generated files from stdin][92912]
1155
1156 [CVE-2022-21658]: https://www.cve.org/CVERecord?id=CVE-2022-21658
1157 [91254]: https://github.com/rust-lang/rust/pull/91254
1158 [92912]: https://github.com/rust-lang/rust/pull/92912
1159 [clippy/8075]: https://github.com/rust-lang/rust-clippy/pull/8075
1160 [clippy/8295]: https://github.com/rust-lang/rust-clippy/pull/8295
1161
1162 Version 1.58.0 (2022-01-13)
1163 ==========================
1164
1165 Language
1166 --------
1167
1168 - [Format strings can now capture arguments simply by writing `{ident}` in the string.][90473] This works in all macros accepting format strings. Support for this in `panic!` (`panic!("{ident}")`) requires the 2021 edition; panic invocations in previous editions that appear to be trying to use this will result in a warning lint about not having the intended effect.
1169 - [`*const T` pointers can now be dereferenced in const contexts.][89551]
1170 - [The rules for when a generic struct implements `Unsize` have been relaxed.][90417]
1171
1172 Compiler
1173 --------
1174
1175 - [Add LLVM CFI support to the Rust compiler][89652]
1176 - [Stabilize -Z strip as -C strip][90058]. Note that while release builds already don't add debug symbols for the code you compile, the compiled standard library that ships with Rust includes debug symbols, so you may want to use the `strip` option to remove these symbols to produce smaller release binaries. Note that this release only includes support in rustc, not directly in cargo.
1177 - [Add support for LLVM coverage mapping format versions 5 and 6][91207]
1178 - [Emit LLVM optimization remarks when enabled with `-Cremark`][90833]
1179 - [Update the minimum external LLVM to 12][90175]
1180 - [Add `x86_64-unknown-none` at Tier 3*][89062]
1181 - [Build musl dist artifacts with debuginfo enabled][90733]. When building release binaries using musl, you may want to use the newly stabilized strip option to remove these debug symbols, reducing the size of your binaries.
1182 - [Don't abort compilation after giving a lint error][87337]
1183 - [Error messages point at the source of trait bound obligations in more places][89580]
1184
1185 \* Refer to Rust's [platform support page][platform-support-doc] for more
1186    information on Rust's tiered platform support.
1187
1188 Libraries
1189 ---------
1190
1191 - [All remaining functions in the standard library have `#[must_use]` annotations where appropriate][89692], producing a warning when ignoring their return value. This helps catch mistakes such as expecting a function to mutate a value in place rather than return a new value.
1192 - [Paths are automatically canonicalized on Windows for operations that support it][89174]
1193 - [Re-enable debug checks for `copy` and `copy_nonoverlapping`][90041]
1194 - [Implement `RefUnwindSafe` for `Rc<T>`][87467]
1195 - [Make RSplit<T, P>: Clone not require T: Clone][90117]
1196 - [Implement `Termination` for `Result<Infallible, E>`][88601]. This allows writing `fn main() -> Result<Infallible, ErrorType>`, for a program whose successful exits never involve returning from `main` (for instance, a program that calls `exit`, or that uses `exec` to run another program).
1197
1198 Stabilized APIs
1199 ---------------
1200
1201 - [`Metadata::is_symlink`]
1202 - [`Path::is_symlink`]
1203 - [`{integer}::saturating_div`]
1204 - [`Option::unwrap_unchecked`]
1205 - [`Result::unwrap_unchecked`]
1206 - [`Result::unwrap_err_unchecked`]
1207 - [`File::options`]
1208
1209 These APIs are now usable in const contexts:
1210
1211 - [`Duration::new`]
1212 - [`Duration::checked_add`]
1213 - [`Duration::saturating_add`]
1214 - [`Duration::checked_sub`]
1215 - [`Duration::saturating_sub`]
1216 - [`Duration::checked_mul`]
1217 - [`Duration::saturating_mul`]
1218 - [`Duration::checked_div`]
1219
1220 Cargo
1221 -----
1222
1223 - [Add --message-format for install command][cargo/10107]
1224 - [Warn when alias shadows external subcommand][cargo/10082]
1225
1226 Rustdoc
1227 -------
1228
1229 - [Show all Deref implementations recursively in rustdoc][90183]
1230 - [Use computed visibility in rustdoc][88447]
1231
1232 Compatibility Notes
1233 -------------------
1234
1235 - [Try all stable method candidates first before trying unstable ones][90329]. This change ensures that adding new nightly-only methods to the Rust standard library will not break code invoking methods of the same name from traits outside the standard library.
1236 - Windows: [`std::process::Command` will no longer search the current directory for executables.][87704]
1237 - [All proc-macro backward-compatibility lints are now deny-by-default.][88041]
1238 - [proc_macro: Append .0 to unsuffixed float if it would otherwise become int token][90297]
1239 - [Refactor weak symbols in std::sys::unix][90846]. This optimizes accesses to glibc functions, by avoiding the use of dlopen. This does not increase the [minimum expected version of glibc](https://doc.rust-lang.org/nightly/rustc/platform-support.html). However, software distributions that use symbol versions to detect library dependencies, and which take weak symbols into account in that analysis, may detect rust binaries as requiring newer versions of glibc.
1240 - [rustdoc now rejects some unexpected semicolons in doctests][91026]
1241
1242 Internal Changes
1243 ----------------
1244
1245 These changes provide no direct user facing benefits, but represent significant
1246 improvements to the internals and overall performance of rustc
1247 and related tools.
1248
1249 - [Implement coherence checks for negative trait impls][90104]
1250 - [Add rustc lint, warning when iterating over hashmaps][89558]
1251 - [Optimize live point computation][90491]
1252 - [Enable verification for 1/32nd of queries loaded from disk][90361]
1253 - [Implement version of normalize_erasing_regions that allows for normalization failure][91255]
1254
1255 [87337]: https://github.com/rust-lang/rust/pull/87337/
1256 [87467]: https://github.com/rust-lang/rust/pull/87467/
1257 [87704]: https://github.com/rust-lang/rust/pull/87704/
1258 [88041]: https://github.com/rust-lang/rust/pull/88041/
1259 [88447]: https://github.com/rust-lang/rust/pull/88447/
1260 [88601]: https://github.com/rust-lang/rust/pull/88601/
1261 [89062]: https://github.com/rust-lang/rust/pull/89062/
1262 [89174]: https://github.com/rust-lang/rust/pull/89174/
1263 [89551]: https://github.com/rust-lang/rust/pull/89551/
1264 [89558]: https://github.com/rust-lang/rust/pull/89558/
1265 [89580]: https://github.com/rust-lang/rust/pull/89580/
1266 [89652]: https://github.com/rust-lang/rust/pull/89652/
1267 [90041]: https://github.com/rust-lang/rust/pull/90041/
1268 [90058]: https://github.com/rust-lang/rust/pull/90058/
1269 [90104]: https://github.com/rust-lang/rust/pull/90104/
1270 [90117]: https://github.com/rust-lang/rust/pull/90117/
1271 [90175]: https://github.com/rust-lang/rust/pull/90175/
1272 [90183]: https://github.com/rust-lang/rust/pull/90183/
1273 [90297]: https://github.com/rust-lang/rust/pull/90297/
1274 [90329]: https://github.com/rust-lang/rust/pull/90329/
1275 [90361]: https://github.com/rust-lang/rust/pull/90361/
1276 [90417]: https://github.com/rust-lang/rust/pull/90417/
1277 [90473]: https://github.com/rust-lang/rust/pull/90473/
1278 [90491]: https://github.com/rust-lang/rust/pull/90491/
1279 [90733]: https://github.com/rust-lang/rust/pull/90733/
1280 [90833]: https://github.com/rust-lang/rust/pull/90833/
1281 [90846]: https://github.com/rust-lang/rust/pull/90846/
1282 [91026]: https://github.com/rust-lang/rust/pull/91026/
1283 [91207]: https://github.com/rust-lang/rust/pull/91207/
1284 [91255]: https://github.com/rust-lang/rust/pull/91255/
1285 [cargo/10082]: https://github.com/rust-lang/cargo/pull/10082/
1286 [cargo/10107]: https://github.com/rust-lang/cargo/pull/10107/
1287 [`Metadata::is_symlink`]: https://doc.rust-lang.org/stable/std/fs/struct.Metadata.html#method.is_symlink
1288 [`Path::is_symlink`]: https://doc.rust-lang.org/stable/std/path/struct.Path.html#method.is_symlink
1289 [`{integer}::saturating_div`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.saturating_div
1290 [`Option::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.unwrap_unchecked
1291 [`Result::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_unchecked
1292 [`Result::unwrap_err_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_err_unchecked
1293 [`File::options`]: https://doc.rust-lang.org/stable/std/fs/struct.File.html#method.options
1294 [`Duration::new`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.new
1295
1296 Version 1.57.0 (2021-12-02)
1297 ==========================
1298
1299 Language
1300 --------
1301
1302 - [Macro attributes may follow `#[derive]` and will see the original (pre-`cfg`) input.][87220]
1303 - [Accept curly-brace macros in expressions, like `m!{ .. }.method()` and `m!{ .. }?`.][88690]
1304 - [Allow panicking in constant evaluation.][89508]
1305 - [Ignore derived `Clone` and `Debug` implementations during dead code analysis.][85200]
1306
1307 Compiler
1308 --------
1309
1310 - [Create more accurate debuginfo for vtables.][89597]
1311 - [Add `armv6k-nintendo-3ds` at Tier 3\*.][88529]
1312 - [Add `armv7-unknown-linux-uclibceabihf` at Tier 3\*.][88952]
1313 - [Add `m68k-unknown-linux-gnu` at Tier 3\*.][88321]
1314 - [Add SOLID targets at Tier 3\*:][86191] `aarch64-kmc-solid_asp3`, `armv7a-kmc-solid_asp3-eabi`, `armv7a-kmc-solid_asp3-eabihf`
1315
1316 \* Refer to Rust's [platform support page][platform-support-doc] for more
1317    information on Rust's tiered platform support.
1318
1319 Libraries
1320 ---------
1321
1322 - [Avoid allocations and copying in `Vec::leak`][89337]
1323 - [Add `#[repr(i8)]` to `Ordering`][89507]
1324 - [Optimize `File::read_to_end` and `read_to_string`][89582]
1325 - [Update to Unicode 14.0][89614]
1326 - [Many more functions are marked `#[must_use]`][89692], producing a warning
1327   when ignoring their return value. This helps catch mistakes such as expecting
1328   a function to mutate a value in place rather than return a new value.
1329
1330 Stabilised APIs
1331 ---------------
1332
1333 - [`[T; N]::as_mut_slice`][`array::as_mut_slice`]
1334 - [`[T; N]::as_slice`][`array::as_slice`]
1335 - [`collections::TryReserveError`]
1336 - [`HashMap::try_reserve`]
1337 - [`HashSet::try_reserve`]
1338 - [`String::try_reserve`]
1339 - [`String::try_reserve_exact`]
1340 - [`Vec::try_reserve`]
1341 - [`Vec::try_reserve_exact`]
1342 - [`VecDeque::try_reserve`]
1343 - [`VecDeque::try_reserve_exact`]
1344 - [`Iterator::map_while`]
1345 - [`iter::MapWhile`]
1346 - [`proc_macro::is_available`]
1347 - [`Command::get_program`]
1348 - [`Command::get_args`]
1349 - [`Command::get_envs`]
1350 - [`Command::get_current_dir`]
1351 - [`CommandArgs`]
1352 - [`CommandEnvs`]
1353
1354 These APIs are now usable in const contexts:
1355
1356 - [`hint::unreachable_unchecked`]
1357
1358 Cargo
1359 -----
1360
1361 - [Stabilize custom profiles][cargo/9943]
1362
1363 Compatibility notes
1364 -------------------
1365
1366 - [Ignore derived `Clone` and `Debug` implementations during dead code analysis.][85200]
1367   This will break some builds that set `#![deny(dead_code)]`.
1368
1369 Internal changes
1370 ----------------
1371 These changes provide no direct user facing benefits, but represent significant
1372 improvements to the internals and overall performance of rustc
1373 and related tools.
1374
1375 - [Added an experimental backend for codegen with `libgccjit`.][87260]
1376
1377 [85200]: https://github.com/rust-lang/rust/pull/85200/
1378 [86191]: https://github.com/rust-lang/rust/pull/86191/
1379 [87220]: https://github.com/rust-lang/rust/pull/87220/
1380 [87260]: https://github.com/rust-lang/rust/pull/87260/
1381 [88321]: https://github.com/rust-lang/rust/pull/88321/
1382 [88529]: https://github.com/rust-lang/rust/pull/88529/
1383 [88690]: https://github.com/rust-lang/rust/pull/88690/
1384 [88952]: https://github.com/rust-lang/rust/pull/88952/
1385 [89337]: https://github.com/rust-lang/rust/pull/89337/
1386 [89507]: https://github.com/rust-lang/rust/pull/89507/
1387 [89508]: https://github.com/rust-lang/rust/pull/89508/
1388 [89582]: https://github.com/rust-lang/rust/pull/89582/
1389 [89597]: https://github.com/rust-lang/rust/pull/89597/
1390 [89614]: https://github.com/rust-lang/rust/pull/89614/
1391 [89692]: https://github.com/rust-lang/rust/issues/89692/
1392 [cargo/9943]: https://github.com/rust-lang/cargo/pull/9943/
1393 [`array::as_mut_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_mut_slice
1394 [`array::as_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_slice
1395 [`collections::TryReserveError`]: https://doc.rust-lang.org/std/collections/struct.TryReserveError.html
1396 [`HashMap::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_map/struct.HashMap.html#method.try_reserve
1397 [`HashSet::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_set/struct.HashSet.html#method.try_reserve
1398 [`String::try_reserve`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve
1399 [`String::try_reserve_exact`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve_exact
1400 [`Vec::try_reserve`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve
1401 [`Vec::try_reserve_exact`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve_exact
1402 [`VecDeque::try_reserve`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve
1403 [`VecDeque::try_reserve_exact`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve_exact
1404 [`Iterator::map_while`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.map_while
1405 [`iter::MapWhile`]: https://doc.rust-lang.org/std/iter/struct.MapWhile.html
1406 [`proc_macro::is_available`]: https://doc.rust-lang.org/proc_macro/fn.is_available.html
1407 [`Command::get_program`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_program
1408 [`Command::get_args`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_args
1409 [`Command::get_envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_envs
1410 [`Command::get_current_dir`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_current_dir
1411 [`CommandArgs`]: https://doc.rust-lang.org/std/process/struct.CommandArgs.html
1412 [`CommandEnvs`]: https://doc.rust-lang.org/std/process/struct.CommandEnvs.html
1413
1414 Version 1.56.1 (2021-11-01)
1415 ===========================
1416
1417 - New lints to detect the presence of bidirectional-override Unicode
1418   codepoints in the compiled source code ([CVE-2021-42574])
1419
1420 [CVE-2021-42574]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-42574
1421
1422 Version 1.56.0 (2021-10-21)
1423 ========================
1424
1425 Language
1426 --------
1427
1428 - [The 2021 Edition is now stable.][rust#88100]
1429   See [the edition guide][rust-2021-edition-guide] for more details.
1430 - [The pattern in `binding @ pattern` can now also introduce new bindings.][rust#85305]
1431 - [Union field access is permitted in `const fn`.][rust#85769]
1432
1433 [rust-2021-edition-guide]: https://doc.rust-lang.org/nightly/edition-guide/rust-2021/index.html
1434
1435 Compiler
1436 --------
1437
1438 - [Upgrade to LLVM 13.][rust#87570]
1439 - [Support memory, address, and thread sanitizers on aarch64-unknown-freebsd.][rust#88023]
1440 - [Allow specifying a deployment target version for all iOS targets][rust#87699]
1441 - [Warnings can be forced on with `--force-warn`.][rust#87472]
1442   This feature is primarily intended for usage by `cargo fix`, rather than end users.
1443 - [Promote `aarch64-apple-ios-sim` to Tier 2\*.][rust#87760]
1444 - [Add `powerpc-unknown-freebsd` at Tier 3\*.][rust#87370]
1445 - [Add `riscv32imc-esp-espidf` at Tier 3\*.][rust#87666]
1446
1447 \* Refer to Rust's [platform support page][platform-support-doc] for more
1448 information on Rust's tiered platform support.
1449
1450 Libraries
1451 ---------
1452
1453 - [Allow writing of incomplete UTF-8 sequences via stdout/stderr on Windows.][rust#83342]
1454   The Windows console still requires valid Unicode, but this change allows
1455   splitting a UTF-8 character across multiple write calls. This allows, for
1456   instance, programs that just read and write data buffers (e.g. copying a file
1457   to stdout) without regard for Unicode or character boundaries.
1458 - [Prefer `AtomicU{64,128}` over Mutex for Instant backsliding protection.][rust#83093]
1459   For this use case, atomics scale much better under contention.
1460 - [Implement `Extend<(A, B)>` for `(Extend<A>, Extend<B>)`][rust#85835]
1461 - [impl Default, Copy, Clone for std::io::Sink and std::io::Empty][rust#86744]
1462 - [`impl From<[(K, V); N]>` for all collections.][rust#84111]
1463 - [Remove `P: Unpin` bound on impl Future for Pin.][rust#81363]
1464 - [Treat invalid environment variable names as non-existent.][rust#86183]
1465   Previously, the environment functions would panic if given a variable name
1466   with an internal null character or equal sign (`=`). Now, these functions will
1467   just treat such names as non-existent variables, since the OS cannot represent
1468   the existence of a variable with such a name.
1469
1470 Stabilised APIs
1471 ---------------
1472
1473 - [`std::os::unix::fs::chroot`]
1474 - [`UnsafeCell::raw_get`]
1475 - [`BufWriter::into_parts`]
1476 - [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]
1477   These APIs were previously stable in `std`, but are now also available in `core`.
1478 - [`Vec::shrink_to`]
1479 - [`String::shrink_to`]
1480 - [`OsString::shrink_to`]
1481 - [`PathBuf::shrink_to`]
1482 - [`BinaryHeap::shrink_to`]
1483 - [`VecDeque::shrink_to`]
1484 - [`HashMap::shrink_to`]
1485 - [`HashSet::shrink_to`]
1486
1487 These APIs are now usable in const contexts:
1488
1489 - [`std::mem::transmute`]
1490 - [`[T]::first`][`slice::first`]
1491 - [`[T]::split_first`][`slice::split_first`]
1492 - [`[T]::last`][`slice::last`]
1493 - [`[T]::split_last`][`slice::split_last`]
1494
1495 Cargo
1496 -----
1497
1498 - [Cargo supports specifying a minimum supported Rust version in Cargo.toml.][`rust-version`]
1499   This has no effect at present on dependency version selection.
1500   We encourage crates to specify their minimum supported Rust version, and we encourage CI systems
1501   that support Rust code to include a crate's specified minimum version in the test matrix for that
1502   crate by default.
1503
1504 Compatibility notes
1505 -------------------
1506
1507 - [Update to new argument parsing rules on Windows.][rust#87580]
1508   This adjusts Rust's standard library to match the behavior of the standard
1509   libraries for C/C++. The rules have changed slightly over time, and this PR
1510   brings us to the latest set of rules (changed in 2008).
1511 - [Disallow the aapcs calling convention on aarch64][rust#88399]
1512   This was already not supported by LLVM; this change surfaces this lack of
1513   support with a better error message.
1514 - [Make `SEMICOLON_IN_EXPRESSIONS_FROM_MACROS` warn by default][rust#87385]
1515 - [Warn when an escaped newline skips multiple lines.][rust#87671]
1516 - [Calls to `libc::getpid` / `std::process::id` from `Command::pre_exec`
1517    may return different values on glibc <= 2.24.][rust#81825]
1518    Rust now invokes the `clone3` system call directly, when available, to use new functionality
1519    available via that system call. Older versions of glibc cache the result of `getpid`, and only
1520    update that cache when calling glibc's clone/fork functions, so a direct system call bypasses
1521    that cache update. glibc 2.25 and newer no longer cache `getpid` for exactly this reason.
1522
1523 Internal changes
1524 ----------------
1525 These changes provide no direct user facing benefits, but represent significant
1526 improvements to the internals and overall performance of rustc
1527 and related tools.
1528
1529 - [LLVM is compiled with PGO in published x86_64-unknown-linux-gnu artifacts.][rust#88069]
1530   This improves the performance of most Rust builds.
1531 - [Unify representation of macros in internal data structures.][rust#88019]
1532   This change fixes a host of bugs with the handling of macros by the compiler,
1533   as well as rustdoc.
1534
1535 [`std::os::unix::fs::chroot`]: https://doc.rust-lang.org/stable/std/os/unix/fs/fn.chroot.html
1536 [`UnsafeCell::raw_get`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.raw_get
1537 [`BufWriter::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.BufWriter.html#method.into_parts
1538 [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]: https://github.com/rust-lang/rust/pull/84662
1539 [`Vec::shrink_to`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.shrink_to
1540 [`String::shrink_to`]: https://doc.rust-lang.org/stable/std/string/struct.String.html#method.shrink_to
1541 [`OsString::shrink_to`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.shrink_to
1542 [`PathBuf::shrink_to`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.shrink_to
1543 [`BinaryHeap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.shrink_to
1544 [`VecDeque::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.shrink_to
1545 [`HashMap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_map/struct.HashMap.html#method.shrink_to
1546 [`HashSet::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_set/struct.HashSet.html#method.shrink_to
1547 [`std::mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
1548 [`slice::first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first
1549 [`slice::split_first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first
1550 [`slice::last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last
1551 [`slice::split_last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last
1552 [`rust-version`]: https://doc.rust-lang.org/nightly/cargo/reference/manifest.html#the-rust-version-field
1553 [rust#87671]: https://github.com/rust-lang/rust/pull/87671
1554 [rust#86183]: https://github.com/rust-lang/rust/pull/86183
1555 [rust#87385]: https://github.com/rust-lang/rust/pull/87385
1556 [rust#88100]: https://github.com/rust-lang/rust/pull/88100
1557 [rust#85305]: https://github.com/rust-lang/rust/pull/85305
1558 [rust#88069]: https://github.com/rust-lang/rust/pull/88069
1559 [rust#87472]: https://github.com/rust-lang/rust/pull/87472
1560 [rust#87699]: https://github.com/rust-lang/rust/pull/87699
1561 [rust#87570]: https://github.com/rust-lang/rust/pull/87570
1562 [rust#88023]: https://github.com/rust-lang/rust/pull/88023
1563 [rust#87760]: https://github.com/rust-lang/rust/pull/87760
1564 [rust#87370]: https://github.com/rust-lang/rust/pull/87370
1565 [rust#87580]: https://github.com/rust-lang/rust/pull/87580
1566 [rust#83342]: https://github.com/rust-lang/rust/pull/83342
1567 [rust#83093]: https://github.com/rust-lang/rust/pull/83093
1568 [rust#85835]: https://github.com/rust-lang/rust/pull/85835
1569 [rust#86744]: https://github.com/rust-lang/rust/pull/86744
1570 [rust#81363]: https://github.com/rust-lang/rust/pull/81363
1571 [rust#84111]: https://github.com/rust-lang/rust/pull/84111
1572 [rust#85769]: https://github.com/rust-lang/rust/pull/85769#issuecomment-854363720
1573 [rust#88399]: https://github.com/rust-lang/rust/pull/88399
1574 [rust#81825]: https://github.com/rust-lang/rust/pull/81825#issuecomment-808406918
1575 [rust#88019]: https://github.com/rust-lang/rust/pull/88019
1576 [rust#87666]: https://github.com/rust-lang/rust/pull/87666
1577
1578 Version 1.55.0 (2021-09-09)
1579 ============================
1580
1581 Language
1582 --------
1583 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
1584   will end at the maximum value of the integer.][83918]
1585 - [You can now explicitly import the prelude of different editions
1586   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
1587
1588 Compiler
1589 --------
1590 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
1591
1592 \* Refer to Rust's [platform support page][platform-support-doc] for more
1593    information on Rust's tiered platform support.
1594
1595 Libraries
1596 ---------
1597
1598 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
1599   These improvements should in general provide faster string parsing of floats,
1600   no longer reject certain valid floating point values, and reduce
1601   the produced code size for non-stripped artifacts.
1602 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
1603
1604 Stabilised APIs
1605 ---------------
1606
1607 - [`Bound::cloned`]
1608 - [`Drain::as_str`]
1609 - [`IntoInnerError::into_error`]
1610 - [`IntoInnerError::into_parts`]
1611 - [`MaybeUninit::assume_init_mut`]
1612 - [`MaybeUninit::assume_init_ref`]
1613 - [`MaybeUninit::write`]
1614 - [`array::map`]
1615 - [`ops::ControlFlow`]
1616 - [`x86::_bittest`]
1617 - [`x86::_bittestandcomplement`]
1618 - [`x86::_bittestandreset`]
1619 - [`x86::_bittestandset`]
1620 - [`x86_64::_bittest64`]
1621 - [`x86_64::_bittestandcomplement64`]
1622 - [`x86_64::_bittestandreset64`]
1623 - [`x86_64::_bittestandset64`]
1624
1625 The following previously stable functions are now `const`.
1626
1627 - [`str::from_utf8_unchecked`]
1628
1629
1630 Cargo
1631 -----
1632 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
1633   rustc in parallel such as when using `cargo test`.][cargo/9675]
1634 - [The package definition in `cargo metadata` now includes the `"default_run"`
1635   field from the manifest.][cargo/9550]
1636 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
1637 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
1638   of packages.][cargo/9663]
1639
1640 Rustdoc
1641 -------
1642 - [Added "Go to item on exact match" search option.][85876]
1643 - [The "Implementors" section on traits no longer shows redundant
1644   method definitions.][85970]
1645 - [Trait implementations are toggled open by default.][86260] This should make the
1646   implementations more searchable by tools like `CTRL+F` in your browser.
1647 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
1648   through type aliases.][86334]
1649 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
1650   "Trait Implementations" section.][86513]
1651
1652
1653 Compatibility Notes
1654 -------------------
1655 - [std functions that return an `io::Error` will no longer use the
1656   `ErrorKind::Other` variant.][85746] This is to better reflect that these
1657   kinds of errors could be categorised [into newer more specific `ErrorKind`
1658   variants][79965], and that they do not represent a user error.
1659 - [Using environment variable names with `process::Command` on Windows now
1660   behaves as expected.][85270] Previously using envionment variables with
1661   `Command` would cause them to be ASCII-uppercased.
1662 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
1663   with `rustdoc::`][86849]
1664 - `RUSTFLAGS` is no longer set for build scripts. Build scripts
1665   should use `CARGO_ENCODED_RUSTFLAGS` instead. See the
1666   [documentation](https://doc.rust-lang.org/nightly/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
1667   for more details.
1668
1669 [86849]: https://github.com/rust-lang/rust/pull/86849
1670 [86513]: https://github.com/rust-lang/rust/pull/86513
1671 [86334]: https://github.com/rust-lang/rust/pull/86334
1672 [86260]: https://github.com/rust-lang/rust/pull/86260
1673 [85970]: https://github.com/rust-lang/rust/pull/85970
1674 [85876]: https://github.com/rust-lang/rust/pull/85876
1675 [83572]: https://github.com/rust-lang/rust/pull/83572
1676 [86294]: https://github.com/rust-lang/rust/pull/86294
1677 [86858]: https://github.com/rust-lang/rust/pull/86858
1678 [86761]: https://github.com/rust-lang/rust/pull/86761
1679 [85746]: https://github.com/rust-lang/rust/pull/85746
1680 [85270]: https://github.com/rust-lang/rust/pull/85270
1681 [83918]: https://github.com/rust-lang/rust/pull/83918
1682 [79965]: https://github.com/rust-lang/rust/pull/79965
1683 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
1684 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
1685 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
1686 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
1687 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
1688 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
1689 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
1690 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
1691 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
1692 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
1693 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
1694 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
1695 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
1696 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
1697 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
1698 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
1699 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
1700 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
1701 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
1702 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
1703 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
1704 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
1705
1706
1707 Version 1.54.0 (2021-07-29)
1708 ============================
1709
1710 Language
1711 -----------------------
1712
1713 - [You can now use macros for values in some built-in attributes.][83366]
1714   This primarily allows you to call macros within the `#[doc]` attribute. For
1715   example, to include external documentation in your crate, you can now write
1716   the following:
1717   ```rust
1718   #![doc = include_str!("README.md")]
1719   ```
1720
1721 - [You can now cast between unsized slice types (and types which contain
1722   unsized slices) in `const fn`.][85078]
1723 - [You can now use multiple generic lifetimes with `impl Trait` where the
1724    lifetimes don't explicitly outlive another.][84701] In code this means
1725    that you can now have `impl Trait<'a, 'b>` where as before you could
1726    only have `impl Trait<'a, 'b> where 'b: 'a`.
1727
1728 Compiler
1729 -----------------------
1730
1731 - [Rustc will now search for custom JSON targets in
1732   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
1733   directory.][83800] You can find your sysroot directory by running
1734   `rustc --print sysroot`.
1735 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
1736 - [You can now use `#[target_feature]` on safe functions when targeting
1737   WebAssembly platforms.][84988]
1738 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
1739 - [Added tier 3\* support for `bpfel-unknown-none`
1740    and `bpfeb-unknown-none`.][79608]
1741 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
1742
1743 \* Refer to Rust's [platform support page][platform-support-doc] for more
1744    information on Rust's tiered platform support.
1745
1746 Libraries
1747 -----------------------
1748
1749 - [`panic::panic_any` will now `#[track_caller]`.][85745]
1750 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
1751 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
1752 - [The implementations of vendor intrinsics in core::arch have been
1753    significantly refactored.][83278] The main user-visible changes are
1754    a 50% reduction in the size of libcore.rlib and stricter validation
1755    of constant operands passed to intrinsics. The latter is technically
1756    a breaking change, but allows Rust to more closely match the C vendor
1757    intrinsics API.
1758
1759 Stabilized APIs
1760 ---------------
1761
1762 - [`BTreeMap::into_keys`]
1763 - [`BTreeMap::into_values`]
1764 - [`HashMap::into_keys`]
1765 - [`HashMap::into_values`]
1766 - [`arch::wasm32`]
1767 - [`VecDeque::binary_search`]
1768 - [`VecDeque::binary_search_by`]
1769 - [`VecDeque::binary_search_by_key`]
1770 - [`VecDeque::partition_point`]
1771
1772 Cargo
1773 -----
1774
1775 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
1776   the dependency graph.][cargo/9520]
1777 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
1778   in the tree ][cargo/9499]
1779 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
1780   macro dependencies.][cargo/9488]
1781 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
1782   This variable points to a directory that integration tests and benches
1783   can use as a "scratchpad" for testing filesystem operations.
1784
1785 Compatibility Notes
1786 -------------------
1787 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
1788 - [Previously unsound code is no longer permitted where different constructors in branches
1789   could require different lifetimes.][85574]
1790 - As previously mentioned the [`std::arch` intrinsics now uses stricter const checking][83278]
1791   than before and may reject some previously accepted code.
1792 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
1793    when compiled with `codegen-units = 1`.][86063]
1794
1795 [85574]: https://github.com/rust-lang/rust/issues/85574
1796 [86831]: https://github.com/rust-lang/rust/issues/86831
1797 [86063]: https://github.com/rust-lang/rust/issues/86063
1798 [79608]: https://github.com/rust-lang/rust/pull/79608
1799 [84988]: https://github.com/rust-lang/rust/pull/84988
1800 [84701]: https://github.com/rust-lang/rust/pull/84701
1801 [84072]: https://github.com/rust-lang/rust/pull/84072
1802 [85745]: https://github.com/rust-lang/rust/pull/85745
1803 [84744]: https://github.com/rust-lang/rust/pull/84744
1804 [85078]: https://github.com/rust-lang/rust/pull/85078
1805 [84717]: https://github.com/rust-lang/rust/pull/84717
1806 [83800]: https://github.com/rust-lang/rust/pull/83800
1807 [83366]: https://github.com/rust-lang/rust/pull/83366
1808 [83278]: https://github.com/rust-lang/rust/pull/83278
1809 [85292]: https://github.com/rust-lang/rust/pull/85292
1810 [82834]: https://github.com/rust-lang/rust/pull/82834
1811 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
1812 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
1813 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
1814 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
1815 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
1816 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
1817 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
1818 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
1819 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
1820 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
1821 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
1822
1823 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
1824
1825 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
1826
1827 Version 1.53.0 (2021-06-17)
1828 ============================
1829
1830 Language
1831 -----------------------
1832 - [You can now use unicode for identifiers.][83799] This allows multilingual
1833   identifiers but still doesn't allow glyphs that are not considered characters
1834   such as `◆` or `🦀`. More specifically you can now use any identifier that
1835   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
1836   is the same standard as languages like Python, however Rust uses NFC
1837   normalization which may be different from other languages.
1838 - [You can now specify "or patterns" inside pattern matches.][79278]
1839   Previously you could only use `|` (OR) on complete patterns. E.g.
1840   ```rust
1841   let x = Some(2u8);
1842   // Before
1843   matches!(x, Some(1) | Some(2));
1844   // Now
1845   matches!(x, Some(1 | 2));
1846   ```
1847 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
1848   has the same semantics as the `:pat` matcher. This is to allow `:pat`
1849   to change semantics to being a pattern fragment in a future edition.
1850
1851 Compiler
1852 -----------------------
1853 - [Updated the minimum external LLVM version to LLVM 10.][83387]
1854 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
1855 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
1856
1857 \* Refer to Rust's [platform support page][platform-support-doc] for more
1858 information on Rust's tiered platform support.
1859
1860 Libraries
1861 -----------------------
1862 - [Abort messages will now forward to `android_set_abort_message` on
1863   Android platforms when available.][81469]
1864 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
1865 - [Arrays of any length now implement `IntoIterator`.][84147]
1866   Currently calling `.into_iter()` as a method on an array will
1867   return `impl Iterator<Item=&T>`, but this may change in a
1868   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
1869   directly on arrays will provide `impl Iterator<Item=T>` as expected.
1870 - [`leading_zeros`, and `trailing_zeros` are now available on all
1871   `NonZero` integer types.][84082]
1872 - [`{f32, f64}::from_str` now parse and print special values
1873   (`NaN`, `-0`) according to IEEE 754.][78618]
1874 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
1875 - [Add the `BITS` associated constant to all numeric types.][82565]
1876
1877 Stabilised APIs
1878 ---------------
1879 - [`AtomicBool::fetch_update`]
1880 - [`AtomicPtr::fetch_update`]
1881 - [`BTreeMap::retain`]
1882 - [`BTreeSet::retain`]
1883 - [`BufReader::seek_relative`]
1884 - [`DebugStruct::non_exhaustive`]
1885 - [`Duration::MAX`]
1886 - [`Duration::ZERO`]
1887 - [`Duration::is_zero`]
1888 - [`Duration::saturating_add`]
1889 - [`Duration::saturating_mul`]
1890 - [`Duration::saturating_sub`]
1891 - [`ErrorKind::Unsupported`]
1892 - [`Option::insert`]
1893 - [`Ordering::is_eq`]
1894 - [`Ordering::is_ge`]
1895 - [`Ordering::is_gt`]
1896 - [`Ordering::is_le`]
1897 - [`Ordering::is_lt`]
1898 - [`Ordering::is_ne`]
1899 - [`OsStr::is_ascii`]
1900 - [`OsStr::make_ascii_lowercase`]
1901 - [`OsStr::make_ascii_uppercase`]
1902 - [`OsStr::to_ascii_lowercase`]
1903 - [`OsStr::to_ascii_uppercase`]
1904 - [`Peekable::peek_mut`]
1905 - [`Rc::decrement_strong_count`]
1906 - [`Rc::increment_strong_count`]
1907 - [`Vec::extend_from_within`]
1908 - [`array::from_mut`]
1909 - [`array::from_ref`]
1910 - [`cmp::max_by_key`]
1911 - [`cmp::max_by`]
1912 - [`cmp::min_by_key`]
1913 - [`cmp::min_by`]
1914 - [`f32::is_subnormal`]
1915 - [`f64::is_subnormal`]
1916
1917 Cargo
1918 -----------------------
1919 - [Cargo now supports git repositories where the default `HEAD` branch is not
1920   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
1921   which can handle default branches correctly.
1922 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
1923 - [The `authors` field is no longer included in `Cargo.toml` for new
1924   projects.][cargo/9282]
1925
1926 Rustdoc
1927 -----------------------
1928 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
1929   without hyperlinks.][81764]
1930
1931 Compatibility Notes
1932 -------------------
1933 - [Implement token-based handling of attributes during expansion][82608]
1934 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
1935   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
1936   to confusion and potential security vulnerabilities and [is no
1937   longer recommended][ietf6943].
1938 - [The added `BITS` constant may conflict with external definitions.][85667]
1939   In particular, this was known to be a problem in the `lexical-core` crate,
1940   but they have published fixes for semantic versions 0.4 through 0.7. To
1941   update this dependency alone, use `cargo update -p lexical-core`.
1942 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
1943
1944 Internal Only
1945 -------------
1946 These changes provide no direct user facing benefits, but represent significant
1947 improvements to the internals and overall performance of rustc and
1948 related tools.
1949
1950 - [Rework the `std::sys::windows::alloc` implementation.][83065]
1951 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
1952 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
1953 - [Rework rustdoc const type][82873]
1954
1955 [85667]: https://github.com/rust-lang/rust/pull/85667
1956 [83386]: https://github.com/rust-lang/rust/pull/83386
1957 [82771]: https://github.com/rust-lang/rust/pull/82771
1958 [84147]: https://github.com/rust-lang/rust/pull/84147
1959 [84082]: https://github.com/rust-lang/rust/pull/84082
1960 [83799]: https://github.com/rust-lang/rust/pull/83799
1961 [83681]: https://github.com/rust-lang/rust/pull/83681
1962 [83652]: https://github.com/rust-lang/rust/pull/83652
1963 [83387]: https://github.com/rust-lang/rust/pull/83387
1964 [82873]: https://github.com/rust-lang/rust/pull/82873
1965 [82864]: https://github.com/rust-lang/rust/pull/82864
1966 [82608]: https://github.com/rust-lang/rust/pull/82608
1967 [82565]: https://github.com/rust-lang/rust/pull/82565
1968 [80525]: https://github.com/rust-lang/rust/pull/80525
1969 [79278]: https://github.com/rust-lang/rust/pull/79278
1970 [78618]: https://github.com/rust-lang/rust/pull/78618
1971 [77704]: https://github.com/rust-lang/rust/pull/77704
1972 [83941]: https://github.com/rust-lang/rust/pull/83941
1973 [83065]: https://github.com/rust-lang/rust/pull/83065
1974 [81764]: https://github.com/rust-lang/rust/pull/81764
1975 [81469]: https://github.com/rust-lang/rust/pull/81469
1976 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
1977 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
1978 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
1979 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
1980 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
1981 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
1982 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
1983 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
1984 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
1985 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
1986 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
1987 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
1988 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
1989 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
1990 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
1991 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
1992 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
1993 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
1994 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
1995 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
1996 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
1997 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
1998 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
1999 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
2000 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
2001 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
2002 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
2003 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
2004 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
2005 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
2006 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
2007 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
2008 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
2009 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
2010 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
2011 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
2012 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
2013 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
2014 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
2015 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
2016 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
2017
2018
2019 Version 1.52.1 (2021-05-10)
2020 ============================
2021
2022 This release disables incremental compilation, unless the user has explicitly
2023 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
2024
2025 This is due to the widespread, and frequently occurring, breakage encountered by
2026 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
2027 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
2028 newly added incremental verification are still present in past stable versions,
2029 and are not yet fixed on any channel. These bugs can lead to miscompilation of
2030 Rust binaries.
2031
2032 These problems only affect incremental builds, so release builds with Cargo
2033 should not be affected unless the user has explicitly opted into incremental.
2034 Debug and check builds are affected.
2035
2036 See [84970] for more details.
2037
2038 [84970]: https://github.com/rust-lang/rust/issues/84970
2039
2040 Version 1.52.0 (2021-05-06)
2041 ============================
2042
2043 Language
2044 --------
2045 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
2046   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
2047   is allowed by default, and may become a warning or hard error in a
2048   future edition.
2049 - [You can now cast mutable references to arrays to a pointer of the same type as
2050   the element.][81479]
2051
2052 Compiler
2053 --------
2054 - [Upgraded the default LLVM to LLVM 12.][81451]
2055
2056 Added tier 3\* support for the following targets.
2057
2058 - [`s390x-unknown-linux-musl`][82166]
2059 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
2060 - [`powerpc-unknown-openbsd`][82733]
2061
2062 \* Refer to Rust's [platform support page][platform-support-doc] for more
2063 information on Rust's tiered platform support.
2064
2065 Libraries
2066 ---------
2067 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
2068 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
2069 - [`Arc<impl Error>` now implements `error::Error`.][80553]
2070 - [All integer division and remainder operations are now `const`.][80962]
2071
2072 Stabilised APIs
2073 -------------
2074 - [`Arguments::as_str`]
2075 - [`char::MAX`]
2076 - [`char::REPLACEMENT_CHARACTER`]
2077 - [`char::UNICODE_VERSION`]
2078 - [`char::decode_utf16`]
2079 - [`char::from_digit`]
2080 - [`char::from_u32_unchecked`]
2081 - [`char::from_u32`]
2082 - [`slice::partition_point`]
2083 - [`str::rsplit_once`]
2084 - [`str::split_once`]
2085
2086 The following previously stable APIs are now `const`.
2087
2088 - [`char::len_utf8`]
2089 - [`char::len_utf16`]
2090 - [`char::to_ascii_uppercase`]
2091 - [`char::to_ascii_lowercase`]
2092 - [`char::eq_ignore_ascii_case`]
2093 - [`u8::to_ascii_uppercase`]
2094 - [`u8::to_ascii_lowercase`]
2095 - [`u8::eq_ignore_ascii_case`]
2096
2097 Rustdoc
2098 -------
2099 - [Rustdoc lints are now treated as a tool lint, meaning that
2100   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
2101   Using the old style is still allowed, and will become a warning in
2102   a future release.
2103 - [Rustdoc now supports argument files.][82261]
2104 - [Rustdoc now generates smart punctuation for documentation.][79423]
2105 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
2106   ```markdown
2107   - [x] Complete
2108   - [ ] Todo
2109   ```
2110
2111 Misc
2112 ----
2113 - [You can now pass multiple filters to tests.][81356] E.g.
2114   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
2115 - [Rustup now distributes PDB symbols for the `std` library on Windows,
2116   allowing you to see `std` symbols when debugging.][82218]
2117
2118 Internal Only
2119 -------------
2120 These changes provide no direct user facing benefits, but represent significant
2121 improvements to the internals and overall performance of rustc and
2122 related tools.
2123
2124 - [Check the result cache before the DepGraph when ensuring queries][81855]
2125 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
2126 - [Only store a LocalDefId in some HIR nodes][81611]
2127 - [Store HIR attributes in a side table][79519]
2128
2129 Compatibility Notes
2130 -------------------
2131 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
2132 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
2133 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
2134 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
2135   languages in code blocks.][78429]
2136 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
2137 - [Changes in how proc macros handle whitespace may lead to panics when used
2138   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
2139 - [Turn `#[derive]` into a regular macro attribute][79078]
2140
2141 [84136]: https://github.com/rust-lang/rust/issues/84136
2142 [80763]: https://github.com/rust-lang/rust/pull/80763
2143 [82166]: https://github.com/rust-lang/rust/pull/82166
2144 [82121]: https://github.com/rust-lang/rust/pull/82121
2145 [81879]: https://github.com/rust-lang/rust/pull/81879
2146 [82261]: https://github.com/rust-lang/rust/pull/82261
2147 [82218]: https://github.com/rust-lang/rust/pull/82218
2148 [82216]: https://github.com/rust-lang/rust/pull/82216
2149 [82202]: https://github.com/rust-lang/rust/pull/82202
2150 [81855]: https://github.com/rust-lang/rust/pull/81855
2151 [81766]: https://github.com/rust-lang/rust/pull/81766
2152 [81744]: https://github.com/rust-lang/rust/pull/81744
2153 [81611]: https://github.com/rust-lang/rust/pull/81611
2154 [81479]: https://github.com/rust-lang/rust/pull/81479
2155 [81451]: https://github.com/rust-lang/rust/pull/81451
2156 [81356]: https://github.com/rust-lang/rust/pull/81356
2157 [80962]: https://github.com/rust-lang/rust/pull/80962
2158 [80553]: https://github.com/rust-lang/rust/pull/80553
2159 [80527]: https://github.com/rust-lang/rust/pull/80527
2160 [79519]: https://github.com/rust-lang/rust/pull/79519
2161 [79423]: https://github.com/rust-lang/rust/pull/79423
2162 [79208]: https://github.com/rust-lang/rust/pull/79208
2163 [78429]: https://github.com/rust-lang/rust/pull/78429
2164 [82733]: https://github.com/rust-lang/rust/pull/82733
2165 [82594]: https://github.com/rust-lang/rust/pull/82594
2166 [79078]: https://github.com/rust-lang/rust/pull/79078
2167 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
2168 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
2169 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
2170 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
2171 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
2172 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
2173 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
2174 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
2175 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
2176 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
2177 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
2178 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
2179 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
2180 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
2181 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
2182 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
2183 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
2184 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
2185 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
2186 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
2187 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
2188 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
2189
2190 Version 1.51.0 (2021-03-25)
2191 ============================
2192
2193 Language
2194 --------
2195 - [You can now parameterize items such as functions, traits, and `struct`s by constant
2196   values in addition to by types and lifetimes.][79135] Also known as "const generics"
2197   E.g. you can now write the following. Note: Only values of primitive integers,
2198   `bool`, or `char` types are currently permitted.
2199   ```rust
2200   struct GenericArray<T, const LENGTH: usize> {
2201       inner: [T; LENGTH]
2202   }
2203
2204   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
2205       const fn last(&self) -> Option<&T> {
2206           if LENGTH == 0 {
2207               None
2208           } else {
2209               Some(&self.inner[LENGTH - 1])
2210           }
2211       }
2212   }
2213   ```
2214
2215
2216 Compiler
2217 --------
2218
2219 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
2220   This option controls whether debug information is split across multiple files
2221   or packed into a single file. **Note** This option is unstable on other platforms.
2222 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
2223   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
2224 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
2225 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
2226
2227 \* Refer to Rust's [platform support page][platform-support-doc] for more
2228 information on Rust's tiered platform support.
2229
2230 Libraries
2231 ---------
2232
2233 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
2234 - [`str` now implements `AsMut<str>`.][80279]
2235 - [`u64` and `u128` now implement `From<char>`.][79502]
2236 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
2237 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
2238 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
2239 - [`io::Empty` now implements `io::Seek`.][78044]
2240 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
2241   `T: ?Sized` types.][80764]
2242 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
2243
2244
2245 Stabilized APIs
2246 ---------------
2247
2248 - [`Arc::decrement_strong_count`]
2249 - [`Arc::increment_strong_count`]
2250 - [`Once::call_once_force`]
2251 - [`Peekable::next_if_eq`]
2252 - [`Peekable::next_if`]
2253 - [`Seek::stream_position`]
2254 - [`array::IntoIter`]
2255 - [`panic::panic_any`]
2256 - [`ptr::addr_of!`]
2257 - [`ptr::addr_of_mut!`]
2258 - [`slice::fill_with`]
2259 - [`slice::split_inclusive_mut`]
2260 - [`slice::split_inclusive`]
2261 - [`slice::strip_prefix`]
2262 - [`slice::strip_suffix`]
2263 - [`str::split_inclusive`]
2264 - [`sync::OnceState`]
2265 - [`task::Wake`]
2266 - [`VecDeque::range`]
2267 - [`VecDeque::range_mut`]
2268
2269 Cargo
2270 -----
2271 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
2272   codegen option.][cargo/9112]
2273 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
2274   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
2275   to avoid unifying features of dependencies where that unification could be unwanted.
2276   Such as using the same dependency with a `std` feature in a build scripts and
2277   proc-macros, while using the `no-std` feature in the final binary. See the
2278   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
2279
2280 Rustdoc
2281 -------
2282
2283 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
2284 - [You can now provide a `--default-theme` flag which sets the default theme to use for
2285   documentation.][79642]
2286
2287 Various improvements to intra-doc links:
2288
2289 - [You can link to non-path primitives such as `slice`.][80181]
2290 - [You can link to associated items.][74489]
2291 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
2292
2293 Misc
2294 ----
2295 - [You can now pass `--include-ignored` to tests (e.g. with
2296   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
2297
2298 Compatibility Notes
2299 -------------------
2300
2301 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
2302 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
2303   could fail.][80579]
2304 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
2305   for the distributed artifacts.][81521]
2306     - `armv5te-unknown-linux-gnueabi`
2307     - `sparc64-unknown-linux-gnu`
2308     - `thumbv7neon-unknown-linux-gnueabihf`
2309     - `armv7-unknown-linux-gnueabi`
2310     - `x86_64-unknown-linux-gnux32`
2311 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
2312
2313 Internal Only
2314 -------------
2315
2316 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
2317
2318 [79135]: https://github.com/rust-lang/rust/pull/79135
2319 [74489]: https://github.com/rust-lang/rust/pull/74489
2320 [76934]: https://github.com/rust-lang/rust/pull/76934
2321 [79570]: https://github.com/rust-lang/rust/pull/79570
2322 [80181]: https://github.com/rust-lang/rust/pull/80181
2323 [79642]: https://github.com/rust-lang/rust/pull/79642
2324 [80945]: https://github.com/rust-lang/rust/pull/80945
2325 [80279]: https://github.com/rust-lang/rust/pull/80279
2326 [80053]: https://github.com/rust-lang/rust/pull/80053
2327 [79502]: https://github.com/rust-lang/rust/pull/79502
2328 [75180]: https://github.com/rust-lang/rust/pull/75180
2329 [81521]: https://github.com/rust-lang/rust/pull/81521
2330 [80968]: https://github.com/rust-lang/rust/pull/80968
2331 [80959]: https://github.com/rust-lang/rust/pull/80959
2332 [80718]: https://github.com/rust-lang/rust/pull/80718
2333 [80653]: https://github.com/rust-lang/rust/pull/80653
2334 [80579]: https://github.com/rust-lang/rust/pull/80579
2335 [79998]: https://github.com/rust-lang/rust/pull/79998
2336 [78044]: https://github.com/rust-lang/rust/pull/78044
2337 [81455]: https://github.com/rust-lang/rust/pull/81455
2338 [80764]: https://github.com/rust-lang/rust/pull/80764
2339 [80749]: https://github.com/rust-lang/rust/pull/80749
2340 [80662]: https://github.com/rust-lang/rust/pull/80662
2341 [79134]: https://github.com/rust-lang/rust/pull/79134
2342 [80966]: https://github.com/rust-lang/rust/pull/80966
2343 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
2344 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
2345 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
2346 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
2347 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
2348 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
2349 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
2350 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
2351 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
2352 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
2353 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
2354 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
2355 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
2356 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
2357 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
2358 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
2359 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
2360 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
2361 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
2362 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
2363 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
2364 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
2365 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
2366
2367 Version 1.50.0 (2021-02-11)
2368 ============================
2369
2370 Language
2371 -----------------------
2372 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
2373   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
2374 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
2375
2376 Compiler
2377 -----------------------
2378 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
2379 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
2380 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
2381 - [Dropped support for all cloudabi targets.][78439]
2382
2383 \* Refer to Rust's [platform support page][platform-support-doc] for more
2384 information on Rust's tiered platform support.
2385
2386 Libraries
2387 -----------------------
2388
2389 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
2390 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
2391 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
2392   This value cannot be a valid file descriptor, and now means `Option<File>` takes
2393   up the same amount of space as `File`.
2394
2395 Stabilized APIs
2396 ---------------
2397
2398 - [`bool::then`]
2399 - [`btree_map::Entry::or_insert_with_key`]
2400 - [`f32::clamp`]
2401 - [`f64::clamp`]
2402 - [`hash_map::Entry::or_insert_with_key`]
2403 - [`Ord::clamp`]
2404 - [`RefCell::take`]
2405 - [`slice::fill`]
2406 - [`UnsafeCell::get_mut`]
2407
2408 The following previously stable methods are now `const`.
2409
2410 - [`IpAddr::is_ipv4`]
2411 - [`IpAddr::is_ipv6`]
2412 - [`IpAddr::is_unspecified`]
2413 - [`IpAddr::is_loopback`]
2414 - [`IpAddr::is_multicast`]
2415 - [`Ipv4Addr::octets`]
2416 - [`Ipv4Addr::is_loopback`]
2417 - [`Ipv4Addr::is_private`]
2418 - [`Ipv4Addr::is_link_local`]
2419 - [`Ipv4Addr::is_multicast`]
2420 - [`Ipv4Addr::is_broadcast`]
2421 - [`Ipv4Addr::is_documentation`]
2422 - [`Ipv4Addr::to_ipv6_compatible`]
2423 - [`Ipv4Addr::to_ipv6_mapped`]
2424 - [`Ipv6Addr::segments`]
2425 - [`Ipv6Addr::is_unspecified`]
2426 - [`Ipv6Addr::is_loopback`]
2427 - [`Ipv6Addr::is_multicast`]
2428 - [`Ipv6Addr::to_ipv4`]
2429 - [`Layout::size`]
2430 - [`Layout::align`]
2431 - [`Layout::from_size_align`]
2432 - `pow` for all integer types.
2433 - `checked_pow` for all integer types.
2434 - `saturating_pow` for all integer types.
2435 - `wrapping_pow` for all integer types.
2436 - `next_power_of_two` for all unsigned integer types.
2437 - `checked_next_power_of_two` for all unsigned integer types.
2438
2439 Cargo
2440 -----------------------
2441
2442 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
2443   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
2444 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
2445   contents of that directory for changes.][cargo/8973]
2446 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
2447
2448 Misc
2449 ----
2450
2451 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
2452 - [Running tests will now print the total time taken to execute.][75752]
2453
2454 Compatibility Notes
2455 -------------------
2456
2457 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
2458   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
2459 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
2460   unhygenic `macro_rules!` macros.][79472]
2461 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
2462   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
2463 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
2464 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
2465   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
2466 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
2467
2468 [74989]: https://github.com/rust-lang/rust/pull/74989
2469 [79261]: https://github.com/rust-lang/rust/pull/79261
2470 [79896]: https://github.com/rust-lang/rust/pull/79896
2471 [79484]: https://github.com/rust-lang/rust/pull/79484
2472 [79472]: https://github.com/rust-lang/rust/pull/79472
2473 [79270]: https://github.com/rust-lang/rust/pull/79270
2474 [79003]: https://github.com/rust-lang/rust/pull/79003
2475 [78864]: https://github.com/rust-lang/rust/pull/78864
2476 [78636]: https://github.com/rust-lang/rust/pull/78636
2477 [78439]: https://github.com/rust-lang/rust/pull/78439
2478 [78343]: https://github.com/rust-lang/rust/pull/78343
2479 [78296]: https://github.com/rust-lang/rust/pull/78296
2480 [78068]: https://github.com/rust-lang/rust/pull/78068
2481 [75752]: https://github.com/rust-lang/rust/pull/75752
2482 [74699]: https://github.com/rust-lang/rust/pull/74699
2483 [78142]: https://github.com/rust-lang/rust/pull/78142
2484 [77484]: https://github.com/rust-lang/rust/pull/77484
2485 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
2486 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
2487 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
2488 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
2489 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
2490 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
2491 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
2492 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
2493 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
2494 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
2495 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
2496 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
2497 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
2498 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
2499 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
2500 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
2501 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
2502 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
2503 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
2504 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
2505 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
2506 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
2507 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
2508 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
2509 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
2510 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
2511 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
2512 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
2513 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
2514 [`btree_map::Entry::or_insert_with_key`]: https://doc.rust-lang.org/stable/std/collections/btree_map/enum.Entry.html#method.or_insert_with_key
2515 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
2516 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
2517 [`hash_map::Entry::or_insert_with_key`]: https://doc.rust-lang.org/stable/std/collections/hash_map/enum.Entry.html#method.or_insert_with_key
2518 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
2519
2520
2521 Version 1.49.0 (2020-12-31)
2522 ============================
2523
2524 Language
2525 -----------------------
2526
2527 - [Unions can now implement `Drop`, and you can now have a field in a union
2528   with `ManuallyDrop<T>`.][77547]
2529 - [You can now cast uninhabited enums to integers.][76199]
2530 - [You can now bind by reference and by move in patterns.][76119] This
2531   allows you to selectively borrow individual components of a type. E.g.
2532   ```rust
2533   #[derive(Debug)]
2534   struct Person {
2535       name: String,
2536       age: u8,
2537   }
2538
2539   let person = Person {
2540       name: String::from("Alice"),
2541       age: 20,
2542   };
2543
2544   // `name` is moved out of person, but `age` is referenced.
2545   let Person { name, ref age } = person;
2546   println!("{} {}", name, age);
2547   ```
2548
2549 Compiler
2550 -----------------------
2551
2552 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
2553 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
2554 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
2555 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
2556 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
2557 - [Output from threads spawned in tests is now captured.][78227]
2558 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
2559
2560 \* Refer to Rust's [platform support page][platform-support-doc] for more
2561 information on Rust's tiered platform support.
2562
2563 Libraries
2564 -----------------------
2565
2566 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
2567 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
2568
2569 Stabilized APIs
2570 ---------------
2571
2572 - [`slice::select_nth_unstable`]
2573 - [`slice::select_nth_unstable_by`]
2574 - [`slice::select_nth_unstable_by_key`]
2575
2576 The following previously stable methods are now `const`.
2577
2578 - [`Poll::is_ready`]
2579 - [`Poll::is_pending`]
2580
2581 Cargo
2582 -----------------------
2583 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
2584 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
2585 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
2586   variable will be set if the crate being built is one the user selected to build, either
2587   with `-p` or through defaults.
2588 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
2589
2590
2591 Compatibility Notes
2592 -------------------
2593
2594 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
2595 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
2596 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
2597   Previously such invalid or unused attributes could be ignored.
2598 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
2599   read [this post about the changes][rustdoc-ws-post] for more details.
2600 - [Trait bounds are no longer inferred for associated types.][79904]
2601
2602 Internal Only
2603 -------------
2604 These changes provide no direct user facing benefits, but represent significant
2605 improvements to the internals and overall performance of rustc and
2606 related tools.
2607
2608 - [rustc's internal crates are now compiled using the `initial-exec` Thread
2609   Local Storage model.][78201]
2610 - [Calculate visibilities once in resolve.][78077]
2611 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
2612 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
2613
2614
2615 [75991]: https://github.com/rust-lang/rust/pull/75991
2616 [78951]: https://github.com/rust-lang/rust/pull/78951
2617 [78848]: https://github.com/rust-lang/rust/pull/78848
2618 [78746]: https://github.com/rust-lang/rust/pull/78746
2619 [78376]: https://github.com/rust-lang/rust/pull/78376
2620 [78228]: https://github.com/rust-lang/rust/pull/78228
2621 [78227]: https://github.com/rust-lang/rust/pull/78227
2622 [78201]: https://github.com/rust-lang/rust/pull/78201
2623 [78109]: https://github.com/rust-lang/rust/pull/78109
2624 [78077]: https://github.com/rust-lang/rust/pull/78077
2625 [77997]: https://github.com/rust-lang/rust/pull/77997
2626 [77703]: https://github.com/rust-lang/rust/pull/77703
2627 [77547]: https://github.com/rust-lang/rust/pull/77547
2628 [77015]: https://github.com/rust-lang/rust/pull/77015
2629 [76199]: https://github.com/rust-lang/rust/pull/76199
2630 [76119]: https://github.com/rust-lang/rust/pull/76119
2631 [75914]: https://github.com/rust-lang/rust/pull/75914
2632 [79004]: https://github.com/rust-lang/rust/pull/79004
2633 [78676]: https://github.com/rust-lang/rust/pull/78676
2634 [79904]: https://github.com/rust-lang/rust/issues/79904
2635 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
2636 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
2637 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
2638 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
2639 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
2640 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
2641 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
2642 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
2643 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
2644 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
2645
2646 Version 1.48.0 (2020-11-19)
2647 ==========================
2648
2649 Language
2650 --------
2651
2652 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
2653   is still rejected *semantically*, but can now be parsed by procedural macros.
2654
2655 Compiler
2656 --------
2657 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
2658   `rustc` whether to link its own C runtime and libraries or to rely on a external
2659   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
2660 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
2661   Note: If you're using cargo you must explicitly pass the `--target` flag.
2662 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
2663
2664 \* Refer to Rust's [platform support page][platform-support-doc] for more
2665 information on Rust's tiered platform support.
2666
2667 Libraries
2668 ---------
2669 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
2670   and `&Stderr`.][76275]
2671 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
2672 - [The `matches!` macro now supports having a trailing comma.][74880]
2673 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
2674 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
2675
2676 Stabilized APIs
2677 ---------------
2678 - [`slice::as_ptr_range`]
2679 - [`slice::as_mut_ptr_range`]
2680 - [`VecDeque::make_contiguous`]
2681 - [`future::pending`]
2682 - [`future::ready`]
2683
2684 The following previously stable methods are now `const fn`'s:
2685
2686 - [`Option::is_some`]
2687 - [`Option::is_none`]
2688 - [`Option::as_ref`]
2689 - [`Result::is_ok`]
2690 - [`Result::is_err`]
2691 - [`Result::as_ref`]
2692 - [`Ordering::reverse`]
2693 - [`Ordering::then`]
2694
2695 Cargo
2696 -----
2697
2698 Rustdoc
2699 -------
2700 - [You can now link to items in `rustdoc` using the intra-doc link
2701   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
2702   a link to `std::future`'s documentation. See ["Linking to items by
2703   name"][intradoc-links] for more information.
2704 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
2705   when searching through `rustdoc`'s UI.][75740]
2706
2707 Compatibility Notes
2708 -------------------
2709 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
2710   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
2711   promoted to `'static` lifetime any more inside `const fn`s.
2712 - [Associated type bindings on trait objects are now verified to meet the bounds
2713   declared on the trait when checking that they implement the trait.][27675]
2714 - [When trait bounds on associated types or opaque types are ambiguous, the
2715   compiler no longer makes an arbitrary choice on which bound to use.][54121]
2716 - [Fixed recursive nonterminals not being expanded in macros during
2717   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
2718   correctly handling recursive nonterminal tokens.
2719 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
2720 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
2721   in places where they have no effect.][73461]
2722 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
2723   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
2724 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
2725   disallow zero-initialization.][71274]
2726 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
2727 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
2728   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
2729   see the [`catch_unwind`] documentation for further information.
2730
2731
2732
2733 Internal Only
2734 -------------
2735 These changes provide no direct user facing benefits, but represent significant
2736 improvements to the internals and overall performance of rustc and
2737 related tools.
2738
2739 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
2740   You can continue building with `make` by setting `ninja=false` in
2741   your `config.toml`.
2742 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
2743 - [Made `ensure_sufficient_stack()` non-generic][76680]
2744
2745 [78143]: https://github.com/rust-lang/rust/issues/78143
2746 [76680]: https://github.com/rust-lang/rust/pull/76680/
2747 [76030]: https://github.com/rust-lang/rust/pull/76030/
2748 [70212]: https://github.com/rust-lang/rust/pull/70212/
2749 [27675]: https://github.com/rust-lang/rust/issues/27675/
2750 [54121]: https://github.com/rust-lang/rust/issues/54121/
2751 [71274]: https://github.com/rust-lang/rust/pull/71274/
2752 [77386]: https://github.com/rust-lang/rust/pull/77386/
2753 [77153]: https://github.com/rust-lang/rust/pull/77153/
2754 [77055]: https://github.com/rust-lang/rust/pull/77055/
2755 [76275]: https://github.com/rust-lang/rust/pull/76275/
2756 [76310]: https://github.com/rust-lang/rust/pull/76310/
2757 [76420]: https://github.com/rust-lang/rust/pull/76420/
2758 [76158]: https://github.com/rust-lang/rust/pull/76158/
2759 [75857]: https://github.com/rust-lang/rust/pull/75857/
2760 [75585]: https://github.com/rust-lang/rust/pull/75585/
2761 [75740]: https://github.com/rust-lang/rust/pull/75740/
2762 [75502]: https://github.com/rust-lang/rust/pull/75502/
2763 [74880]: https://github.com/rust-lang/rust/pull/74880/
2764 [74922]: https://github.com/rust-lang/rust/pull/74922/
2765 [74430]: https://github.com/rust-lang/rust/pull/74430/
2766 [74194]: https://github.com/rust-lang/rust/pull/74194/
2767 [73461]: https://github.com/rust-lang/rust/pull/73461/
2768 [73166]: https://github.com/rust-lang/rust/pull/73166/
2769 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
2770 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
2771 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
2772 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
2773 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
2774 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
2775 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
2776 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
2777 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
2778 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
2779 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
2780 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
2781 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
2782 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
2783 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
2784
2785
2786 Version 1.47.0 (2020-10-08)
2787 ==========================
2788
2789 Language
2790 --------
2791 - [Closures will now warn when not used.][74869]
2792
2793 Compiler
2794 --------
2795 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
2796   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
2797   platforms.
2798 - [Upgraded to LLVM 11.][73526]
2799 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
2800 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
2801 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
2802
2803 \* Refer to Rust's [platform support page][platform-support-doc] for more
2804 information on Rust's tiered platform support.
2805
2806 Libraries
2807 ---------
2808 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
2809 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
2810   those of length less than 33.][74060]
2811 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
2812 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
2813   `PartialEq`, and `PartialOrd`.][73583]
2814
2815 Stabilized APIs
2816 ---------------
2817 - [`Ident::new_raw`]
2818 - [`Range::is_empty`]
2819 - [`RangeInclusive::is_empty`]
2820 - [`Result::as_deref`]
2821 - [`Result::as_deref_mut`]
2822 - [`Vec::leak`]
2823 - [`pointer::offset_from`]
2824 - [`f32::TAU`]
2825 - [`f64::TAU`]
2826
2827 The following previously stable APIs have now been made const.
2828
2829 - [The `new` method for all `NonZero` integers.][73858]
2830 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
2831   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
2832   methods for all integers.][73858]
2833 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
2834   signed integers.][73858]
2835 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
2836   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
2837   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
2838   `is_ascii_control` methods for `char` and `u8`.][73858]
2839
2840 Cargo
2841 -----
2842 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
2843   You can override this by setting the following in your `Cargo.toml`.
2844   ```toml
2845   [profile.release.build-override]
2846   opt-level = 3
2847   ```
2848 - [`cargo-help` will now display man pages for commands rather just the
2849   `--help` text.][cargo/8456]
2850 - [`cargo-metadata` now emits a `test` field indicating if a target has
2851   tests enabled.][cargo/8478]
2852 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
2853 - [`cargo-publish` will now use an alternative registry by default if it's the
2854   only registry specified in `package.publish`.][cargo/8571]
2855
2856 Misc
2857 ----
2858 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
2859   type based search.][75366]
2860 - [Added the Ayu theme to rustdoc.][71237]
2861
2862 Compatibility Notes
2863 -------------------
2864 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
2865 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
2866 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
2867   help to preserve more span information.][73084] These changes may cause
2868   compilation errors if your macro was unhygenic or didn't correctly handle
2869   `Delimiter::None`.
2870 - [Moved support for the CloudABI target to tier 3.][75568]
2871 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
2872 - [Added the `rustc-docs` component.][75560] This allows you to install
2873   and read the documentation for the compiler internal APIs. (Currently only
2874   available for `x86_64-unknown-linux-gnu`.)
2875
2876 Internal Only
2877 --------
2878
2879 - [Improved default settings for bootstrapping in `x.py`.][73964] You can read details about this change in the ["Changes to `x.py` defaults"](https://blog.rust-lang.org/inside-rust/2020/08/30/changes-to-x-py-defaults.html) post on the Inside Rust blog.
2880
2881 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
2882 [75048]: https://github.com/rust-lang/rust/pull/75048/
2883 [74163]: https://github.com/rust-lang/rust/pull/74163/
2884 [71237]: https://github.com/rust-lang/rust/pull/71237/
2885 [74869]: https://github.com/rust-lang/rust/pull/74869/
2886 [73858]: https://github.com/rust-lang/rust/pull/73858/
2887 [75716]: https://github.com/rust-lang/rust/pull/75716/
2888 [75560]: https://github.com/rust-lang/rust/pull/75560/
2889 [75568]: https://github.com/rust-lang/rust/pull/75568/
2890 [75366]: https://github.com/rust-lang/rust/pull/75366/
2891 [75204]: https://github.com/rust-lang/rust/pull/75204/
2892 [74650]: https://github.com/rust-lang/rust/pull/74650/
2893 [74419]: https://github.com/rust-lang/rust/pull/74419/
2894 [73964]: https://github.com/rust-lang/rust/pull/73964/
2895 [74021]: https://github.com/rust-lang/rust/pull/74021/
2896 [74060]: https://github.com/rust-lang/rust/pull/74060/
2897 [73893]: https://github.com/rust-lang/rust/pull/73893/
2898 [73526]: https://github.com/rust-lang/rust/pull/73526/
2899 [73583]: https://github.com/rust-lang/rust/pull/73583/
2900 [73084]: https://github.com/rust-lang/rust/pull/73084/
2901 [73197]: https://github.com/rust-lang/rust/pull/73197/
2902 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
2903 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
2904 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
2905 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
2906 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
2907 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
2908 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
2909 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
2910 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
2911 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
2912 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
2913 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
2914 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
2915 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
2916
2917
2918 Version 1.46.0 (2020-08-27)
2919 ==========================
2920
2921 Language
2922 --------
2923 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
2924 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
2925   const functions.][73862]
2926 - [The `#[track_caller]` attribute can now be added to functions to use the
2927   function's caller's location information for panic messages.][72445]
2928 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
2929   `x.0.0` over `(x.0).0`.
2930 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
2931   You currently can't use `mem::transmute` in constant functions.
2932
2933 Compiler
2934 --------
2935 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
2936 - [Enabled static "Position Independent Executables" by default
2937   for `x86_64-unknown-linux-musl`.][70740]
2938
2939 Libraries
2940 ---------
2941 - [`mem::forget` is now a `const fn`.][73887]
2942 - [`String` now implements `From<char>`.][73466]
2943 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
2944   integer types.][73032]
2945 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
2946 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
2947   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
2948 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
2949 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
2950 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
2951
2952 Stabilized APIs
2953 ---------------
2954 - [`Option::zip`]
2955 - [`vec::Drain::as_slice`]
2956
2957 Cargo
2958 -----
2959 Added a number of new environment variables that are now available when
2960 compiling your crate.
2961
2962 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
2963   the specific binary being compiled and the name of the crate.
2964 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
2965 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
2966
2967 Compatibility Notes
2968 -------------------
2969 - [The target configuration option `abi_blacklist` has been renamed
2970   to `unsupported_abis`.][74150] The old name will still continue to work.
2971 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
2972   This was previously accepted but will become a hard error in a future release.
2973 - [Rustc will fail to compile if you have a struct with
2974   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
2975   allowed on `enum`s.
2976 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
2977   ensure that spans have the correct information, and may cause breakage if you
2978   were relying on receiving spans with dummy information.
2979 - [The InnoSetup installer for Windows is no longer available.][72569] This was
2980   a legacy installer that was replaced by a MSI installer a few years ago but
2981   was still being built.
2982 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
2983 - [Rustc will no longer accept overlapping trait implementations that only
2984   differ in how the lifetime was bound.][72493]
2985 - [Rustc now correctly relates the lifetime of an existential associated
2986   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
2987   you to pass a shorter lifetime than expected.
2988 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
2989   The library will need to be installed for `rustc` to work, even though we
2990   expect it to be already available on most systems.
2991 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
2992   under QEMU.][74820]
2993 - [Pretty printing of some tokens in procedural macros changed.][75453] The
2994   exact output returned by rustc's pretty printing is an unstable
2995   implementation detail: we recommend any macro relying on it to switch to a
2996   more robust parsing system.
2997
2998 [75453]: https://github.com/rust-lang/rust/issues/75453/
2999 [74820]: https://github.com/rust-lang/rust/issues/74820/
3000 [74420]: https://github.com/rust-lang/rust/issues/74420/
3001 [74109]: https://github.com/rust-lang/rust/pull/74109/
3002 [74150]: https://github.com/rust-lang/rust/pull/74150/
3003 [73862]: https://github.com/rust-lang/rust/pull/73862/
3004 [73887]: https://github.com/rust-lang/rust/pull/73887/
3005 [73466]: https://github.com/rust-lang/rust/pull/73466/
3006 [73516]: https://github.com/rust-lang/rust/pull/73516/
3007 [73293]: https://github.com/rust-lang/rust/pull/73293/
3008 [73007]: https://github.com/rust-lang/rust/pull/73007/
3009 [73032]: https://github.com/rust-lang/rust/pull/73032/
3010 [72920]: https://github.com/rust-lang/rust/pull/72920/
3011 [72569]: https://github.com/rust-lang/rust/pull/72569/
3012 [72583]: https://github.com/rust-lang/rust/pull/72583/
3013 [72584]: https://github.com/rust-lang/rust/pull/72584/
3014 [72717]: https://github.com/rust-lang/rust/pull/72717/
3015 [72437]: https://github.com/rust-lang/rust/pull/72437/
3016 [72445]: https://github.com/rust-lang/rust/pull/72445/
3017 [72486]: https://github.com/rust-lang/rust/pull/72486/
3018 [72493]: https://github.com/rust-lang/rust/pull/72493/
3019 [72331]: https://github.com/rust-lang/rust/pull/72331/
3020 [71896]: https://github.com/rust-lang/rust/pull/71896/
3021 [71660]: https://github.com/rust-lang/rust/pull/71660/
3022 [71322]: https://github.com/rust-lang/rust/pull/71322/
3023 [70740]: https://github.com/rust-lang/rust/pull/70740/
3024 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
3025 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
3026 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
3027 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
3028 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
3029
3030
3031 Version 1.45.2 (2020-08-03)
3032 ==========================
3033
3034 * [Fix bindings in tuple struct patterns][74954]
3035 * [Fix track_caller integration with trait objects][74784]
3036
3037 [74954]: https://github.com/rust-lang/rust/issues/74954
3038 [74784]: https://github.com/rust-lang/rust/issues/74784
3039
3040
3041 Version 1.45.1 (2020-07-30)
3042 ==========================
3043
3044 * [Fix const propagation with references.][73613]
3045 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
3046 * [Avoid spurious implicit region bound.][74509]
3047 * [Install clippy on x.py install][74457]
3048
3049 [73613]: https://github.com/rust-lang/rust/pull/73613
3050 [73078]: https://github.com/rust-lang/rust/issues/73078
3051 [74509]: https://github.com/rust-lang/rust/pull/74509
3052 [74457]: https://github.com/rust-lang/rust/pull/74457
3053
3054
3055 Version 1.45.0 (2020-07-16)
3056 ==========================
3057
3058 Language
3059 --------
3060 - [Out of range float to int conversions using `as` has been defined as a saturating
3061   conversion.][71269] This was previously undefined behaviour, but you can use the
3062    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
3063    may be desirable in rare performance sensitive situations.
3064 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
3065   using `u64`.][70705]
3066 - [Function like procedural macros can now be used in expression, pattern, and  statement
3067   positions.][68717] This means you can now use a function-like procedural macro
3068   anywhere you can use a declarative (`macro_rules!`) macro.
3069
3070 Compiler
3071 --------
3072 - [You can now override individual target features through the `target-feature`
3073   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
3074   equivalent to `-C target-feature=+avx2,+fma`.
3075 - [Added the `force-unwind-tables` flag.][69984] This option allows
3076   rustc to always generate unwind tables regardless of panic strategy.
3077 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
3078   to include LLVM bitcode into generated `rlib`s (this is on by default).
3079 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
3080 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
3081 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
3082 - [Upgraded to LLVM 10.][67759]
3083
3084 \* Refer to Rust's [platform support page][platform-support-doc] for more
3085 information on Rust's tiered platform support.
3086
3087
3088 Libraries
3089 ---------
3090 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
3091   and `Ord`.][72239]
3092 - [`proc_macro::TokenStream` now implements `Default`.][72234]
3093 - [You can now use `char` with
3094   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
3095   a range of codepoints.][72413] E.g.
3096   you can now write the following;
3097   ```rust
3098   for ch in 'a'..='z' {
3099       print!("{}", ch);
3100   }
3101   println!();
3102   // Prints "abcdefghijklmnopqrstuvwxyz"
3103   ```
3104 - [`OsString` now implements `FromStr`.][71662]
3105 - [The `saturating_neg` method has been added to all signed integer primitive
3106   types, and the `saturating_abs` method has been added for all integer
3107   primitive types.][71886]
3108 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
3109   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
3110   or `Path`.][71447]
3111 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
3112 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
3113   integer types.][69813]
3114 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
3115   integer types.][72324]
3116 - [The `fetch_update` method has been added to all atomic integer types.][71843]
3117
3118 Stabilized APIs
3119 ---------------
3120 - [`Arc::as_ptr`]
3121 - [`BTreeMap::remove_entry`]
3122 - [`Rc::as_ptr`]
3123 - [`rc::Weak::as_ptr`]
3124 - [`rc::Weak::from_raw`]
3125 - [`rc::Weak::into_raw`]
3126 - [`str::strip_prefix`]
3127 - [`str::strip_suffix`]
3128 - [`sync::Weak::as_ptr`]
3129 - [`sync::Weak::from_raw`]
3130 - [`sync::Weak::into_raw`]
3131 - [`char::UNICODE_VERSION`]
3132 - [`Span::resolved_at`]
3133 - [`Span::located_at`]
3134 - [`Span::mixed_site`]
3135 - [`unix::process::CommandExt::arg0`]
3136
3137 Cargo
3138 -----
3139
3140 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
3141   time.][cargo/8066]
3142
3143 Misc
3144 ----
3145 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
3146   `~~outdated information~~` becomes "~~outdated information~~".
3147 - [Added an emoji to Rustdoc's deprecated API message.][72014]
3148
3149 Compatibility Notes
3150 -------------------
3151 - [Trying to self initialize a static value (that is creating a value using
3152   itself) is unsound and now causes a compile error.][71140]
3153 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
3154   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
3155 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
3156   previously undocumented and not intended for public use. Rustdoc still provides
3157   a non-zero exit code on errors.
3158 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
3159   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
3160   flags while cargo is adding `embed-bitcode` itself. The recommended way to
3161   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
3162   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
3163
3164 Internals Only
3165 --------------
3166 - [Make clippy a git subtree instead of a git submodule][70655]
3167 - [Unify the undo log of all snapshot types][69464]
3168
3169 [71848]: https://github.com/rust-lang/rust/issues/71848/
3170 [73420]: https://github.com/rust-lang/rust/issues/73420/
3171 [72324]: https://github.com/rust-lang/rust/pull/72324/
3172 [71843]: https://github.com/rust-lang/rust/pull/71843/
3173 [71886]: https://github.com/rust-lang/rust/pull/71886/
3174 [72234]: https://github.com/rust-lang/rust/pull/72234/
3175 [72239]: https://github.com/rust-lang/rust/pull/72239/
3176 [72397]: https://github.com/rust-lang/rust/pull/72397/
3177 [72413]: https://github.com/rust-lang/rust/pull/72413/
3178 [72014]: https://github.com/rust-lang/rust/pull/72014/
3179 [72062]: https://github.com/rust-lang/rust/pull/72062/
3180 [72094]: https://github.com/rust-lang/rust/pull/72094/
3181 [72133]: https://github.com/rust-lang/rust/pull/72133/
3182 [67759]: https://github.com/rust-lang/rust/pull/67759/
3183 [71900]: https://github.com/rust-lang/rust/pull/71900/
3184 [71928]: https://github.com/rust-lang/rust/pull/71928/
3185 [71662]: https://github.com/rust-lang/rust/pull/71662/
3186 [71716]: https://github.com/rust-lang/rust/pull/71716/
3187 [71447]: https://github.com/rust-lang/rust/pull/71447/
3188 [71269]: https://github.com/rust-lang/rust/pull/71269/
3189 [71095]: https://github.com/rust-lang/rust/pull/71095/
3190 [71140]: https://github.com/rust-lang/rust/pull/71140/
3191 [70655]: https://github.com/rust-lang/rust/pull/70655/
3192 [70705]: https://github.com/rust-lang/rust/pull/70705/
3193 [69984]: https://github.com/rust-lang/rust/pull/69984/
3194 [69813]: https://github.com/rust-lang/rust/pull/69813/
3195 [69464]: https://github.com/rust-lang/rust/pull/69464/
3196 [68717]: https://github.com/rust-lang/rust/pull/68717/
3197 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
3198 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
3199 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
3200 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
3201 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
3202 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
3203 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
3204 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
3205 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
3206 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
3207 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
3208 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
3209 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
3210 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
3211 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
3212 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
3213 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
3214
3215
3216 Version 1.44.1 (2020-06-18)
3217 ===========================
3218
3219 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
3220 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
3221 * [Fix crashes when finding backtrace on macOS.][71397]
3222 * [Clippy applies lint levels into different files.][clippy/5356]
3223
3224 [71397]: https://github.com/rust-lang/rust/issues/71397
3225 [73078]: https://github.com/rust-lang/rust/issues/73078
3226 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
3227 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
3228
3229
3230 Version 1.44.0 (2020-06-04)
3231 ==========================
3232
3233 Language
3234 --------
3235 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
3236 - [Added the `unused_braces` lint.][70081]
3237
3238 **Syntax-only changes**
3239
3240 - [Expansion-driven outline module parsing][69838]
3241 ```rust
3242 #[cfg(FALSE)]
3243 mod foo {
3244     mod bar {
3245         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
3246     }
3247 }
3248 ```
3249
3250 These are still rejected semantically, so you will likely receive an error but
3251 these changes can be seen and parsed by macros and conditional compilation.
3252
3253 Compiler
3254 --------
3255 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
3256   Additionally when in incremental mode rustc defaults to 256 codegen units.
3257 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
3258   a panic is thrown.][67502]
3259 - [Added tier 3\* support for the `aarch64-unknown-none` and
3260   `aarch64-unknown-none-softfloat` targets.][68334]
3261 - [Added tier 3 support for `arm64-apple-tvos` and
3262   `x86_64-apple-tvos` targets.][68191]
3263
3264
3265 Libraries
3266 ---------
3267 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
3268   `vec![]` to be able to be used in `const` contexts.
3269 - [`convert::Infallible` now implements `Hash`.][70281]
3270 - [`OsString` now implements `DerefMut` and `IndexMut` returning
3271   a `&mut OsStr`.][70048]
3272 - [Unicode 13 is now supported.][69929]
3273 - [`String` now implements `From<&mut str>`.][69661]
3274 - [`IoSlice` now implements `Copy`.][69403]
3275 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
3276 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
3277 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
3278   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
3279   integer types.][69373]
3280
3281 Stabilized APIs
3282 ---------------
3283 - [`PathBuf::with_capacity`]
3284 - [`PathBuf::capacity`]
3285 - [`PathBuf::clear`]
3286 - [`PathBuf::reserve`]
3287 - [`PathBuf::reserve_exact`]
3288 - [`PathBuf::shrink_to_fit`]
3289 - [`f32::to_int_unchecked`]
3290 - [`f64::to_int_unchecked`]
3291 - [`Layout::align_to`]
3292 - [`Layout::pad_to_align`]
3293 - [`Layout::array`]
3294 - [`Layout::extend`]
3295
3296 Cargo
3297 -----
3298 - [Added the `cargo tree` command which will print a tree graph of
3299   your dependencies.][cargo/8062] E.g.
3300   ```
3301     mdbook v0.3.2 (/Users/src/rust/mdbook)
3302   ├── ammonia v3.0.0
3303   │   ├── html5ever v0.24.0
3304   │   │   ├── log v0.4.8
3305   │   │   │   └── cfg-if v0.1.9
3306   │   │   ├── mac v0.1.1
3307   │   │   └── markup5ever v0.9.0
3308   │   │       ├── log v0.4.8 (*)
3309   │   │       ├── phf v0.7.24
3310   │   │       │   └── phf_shared v0.7.24
3311   │   │       │       ├── siphasher v0.2.3
3312   │   │       │       └── unicase v1.4.2
3313   │   │       │           [build-dependencies]
3314   │   │       │           └── version_check v0.1.5
3315   ...
3316   ```
3317   You can also display dependencies on multiple versions of the same crate with
3318   `cargo tree -d` (short for `cargo tree --duplicates`).
3319
3320 Misc
3321 ----
3322 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
3323   the version in the sidebar.][69494]
3324
3325 Compatibility Notes
3326 -------------------
3327 - [Rustc now correctly generates static libraries on Windows GNU targets with
3328   the `.a` extension, rather than the previous `.lib`.][70937]
3329 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
3330 - [The `file_name` property in JSON output of macro errors now points the actual
3331   source file rather than the previous format of `<NAME macros>`.][70969]
3332   **Note:** this may not point to a file that actually exists on the user's system.
3333 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
3334 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
3335   not allow zero initialization such as `NonZeroU8`.][66059] This was
3336   previously a warning.
3337 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
3338   operator has been defined as a saturating operation.][71269] This was previously
3339   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
3340   continue using the current behaviour, which may be desirable in rare performance
3341   sensitive situations.
3342
3343 Internal Only
3344 -------------
3345 These changes provide no direct user facing benefits, but represent significant
3346 improvements to the internals and overall performance of rustc and
3347 related tools.
3348
3349 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
3350 - [Replace big JS dict with JSON parsing.][71250]
3351
3352 [69373]: https://github.com/rust-lang/rust/pull/69373/
3353 [66059]: https://github.com/rust-lang/rust/pull/66059/
3354 [68191]: https://github.com/rust-lang/rust/pull/68191/
3355 [68899]: https://github.com/rust-lang/rust/pull/68899/
3356 [71147]: https://github.com/rust-lang/rust/pull/71147/
3357 [71250]: https://github.com/rust-lang/rust/pull/71250/
3358 [70937]: https://github.com/rust-lang/rust/pull/70937/
3359 [70969]: https://github.com/rust-lang/rust/pull/70969/
3360 [70632]: https://github.com/rust-lang/rust/pull/70632/
3361 [70281]: https://github.com/rust-lang/rust/pull/70281/
3362 [70345]: https://github.com/rust-lang/rust/pull/70345/
3363 [70048]: https://github.com/rust-lang/rust/pull/70048/
3364 [70081]: https://github.com/rust-lang/rust/pull/70081/
3365 [70156]: https://github.com/rust-lang/rust/pull/70156/
3366 [71269]: https://github.com/rust-lang/rust/pull/71269/
3367 [69838]: https://github.com/rust-lang/rust/pull/69838/
3368 [69929]: https://github.com/rust-lang/rust/pull/69929/
3369 [69661]: https://github.com/rust-lang/rust/pull/69661/
3370 [69778]: https://github.com/rust-lang/rust/pull/69778/
3371 [69494]: https://github.com/rust-lang/rust/pull/69494/
3372 [69403]: https://github.com/rust-lang/rust/pull/69403/
3373 [69033]: https://github.com/rust-lang/rust/pull/69033/
3374 [68692]: https://github.com/rust-lang/rust/pull/68692/
3375 [68334]: https://github.com/rust-lang/rust/pull/68334/
3376 [67502]: https://github.com/rust-lang/rust/pull/67502/
3377 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
3378 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
3379 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
3380 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
3381 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
3382 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
3383 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
3384 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
3385 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
3386 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
3387 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
3388 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
3389 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
3390
3391
3392 Version 1.43.1 (2020-05-07)
3393 ===========================
3394
3395 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
3396 * [Fixed the stabilization of AVX-512 features.][71473]
3397 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
3398
3399 [71430]: https://github.com/rust-lang/rust/pull/71430
3400 [71473]: https://github.com/rust-lang/rust/issues/71473
3401 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
3402
3403
3404 Version 1.43.0 (2020-04-23)
3405 ==========================
3406
3407 Language
3408 --------
3409 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
3410   the type inferred correctly.][68129]
3411 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
3412
3413 **Syntax only changes**
3414 - [Allow `type Foo: Ord` syntactically.][69361]
3415 - [Fuse associated and extern items up to defaultness.][69194]
3416 - [Syntactically allow `self` in all `fn` contexts.][68764]
3417 - [Merge `fn` syntax + cleanup item parsing.][68728]
3418 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
3419   For example, you may now write:
3420   ```rust
3421   macro_rules! mac_trait {
3422       ($i:item) => {
3423           trait T { $i }
3424       }
3425   }
3426   mac_trait! {
3427       fn foo() {}
3428   }
3429   ```
3430
3431 These are still rejected *semantically*, so you will likely receive an error but
3432 these changes can be seen and parsed by macros and
3433 conditional compilation.
3434
3435
3436 Compiler
3437 --------
3438 - [You can now pass multiple lint flags to rustc to override the previous
3439   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
3440   everything in the `unused` lint group except `unused-variables` which
3441   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
3442   everything in the `unused` lint group **including** `unused-variables` since
3443   the allow flag is specified before the deny flag (and therefore overridden).
3444 - [rustc will now prefer your system MinGW libraries over its bundled libraries
3445   if they are available on `windows-gnu`.][67429]
3446 - [rustc now buffers errors/warnings printed in JSON.][69227]
3447
3448 Libraries
3449 ---------
3450 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
3451   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
3452   respectively.][69538] **Note** These conversions are only available when `N`
3453   is `0..=32`.
3454 - [You can now use associated constants on floats and integers directly, rather
3455   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
3456   `f32::NAN` with no imports.
3457 - [`u8::is_ascii` is now `const`.][68984]
3458 - [`String` now implements `AsMut<str>`.][68742]
3459 - [Added the `primitive` module to `std` and `core`.][67637] This module
3460   reexports Rust's primitive types. This is mainly useful in macros
3461   where you want avoid these types being shadowed.
3462 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
3463 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
3464
3465 Stabilized APIs
3466 ---------------
3467 - [`Once::is_completed`]
3468 - [`f32::LOG10_2`]
3469 - [`f32::LOG2_10`]
3470 - [`f64::LOG10_2`]
3471 - [`f64::LOG2_10`]
3472 - [`iter::once_with`]
3473
3474 Cargo
3475 -----
3476 - [You can now set config `[profile]`s in your `.cargo/config`, or through
3477   your environment.][cargo/7823]
3478 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
3479   executable path when running integration tests or benchmarks.][cargo/7697]
3480   `<name>` is the name of your binary as-is e.g. If you wanted the executable
3481   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
3482
3483 Misc
3484 ----
3485 - [Certain checks in the `const_err` lint were deemed unrelated to const
3486   evaluation][69185], and have been moved to the `unconditional_panic` and
3487   `arithmetic_overflow` lints.
3488
3489 Compatibility Notes
3490 -------------------
3491
3492 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
3493   has been a warning since 1.36.0.
3494 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
3495   led to some instances being accepted, and now correctly emits a hard error.
3496
3497 [69340]: https://github.com/rust-lang/rust/pull/69340
3498
3499 Internal Only
3500 -------------
3501 These changes provide no direct user facing benefits, but represent significant
3502 improvements to the internals and overall performance of `rustc` and
3503 related tools.
3504
3505 - [All components are now built with `opt-level=3` instead of `2`.][67878]
3506 - [Improved how rustc generates drop code.][67332]
3507 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
3508 - [traits: preallocate 2 Vecs of known initial size][69022]
3509 - [Avoid exponential behaviour when relating types][68772]
3510 - [Skip `Drop` terminators for enum variants without drop glue][68943]
3511 - [Improve performance of coherence checks][68966]
3512 - [Deduplicate types in the generator witness][68672]
3513 - [Invert control in struct_lint_level.][68725]
3514
3515 [67332]: https://github.com/rust-lang/rust/pull/67332/
3516 [67429]: https://github.com/rust-lang/rust/pull/67429/
3517 [67637]: https://github.com/rust-lang/rust/pull/67637/
3518 [67642]: https://github.com/rust-lang/rust/pull/67642/
3519 [67878]: https://github.com/rust-lang/rust/pull/67878/
3520 [67885]: https://github.com/rust-lang/rust/pull/67885/
3521 [68129]: https://github.com/rust-lang/rust/pull/68129/
3522 [68672]: https://github.com/rust-lang/rust/pull/68672/
3523 [68725]: https://github.com/rust-lang/rust/pull/68725/
3524 [68728]: https://github.com/rust-lang/rust/pull/68728/
3525 [68738]: https://github.com/rust-lang/rust/pull/68738/
3526 [68742]: https://github.com/rust-lang/rust/pull/68742/
3527 [68764]: https://github.com/rust-lang/rust/pull/68764/
3528 [68772]: https://github.com/rust-lang/rust/pull/68772/
3529 [68943]: https://github.com/rust-lang/rust/pull/68943/
3530 [68952]: https://github.com/rust-lang/rust/pull/68952/
3531 [68966]: https://github.com/rust-lang/rust/pull/68966/
3532 [68984]: https://github.com/rust-lang/rust/pull/68984/
3533 [69022]: https://github.com/rust-lang/rust/pull/69022/
3534 [69185]: https://github.com/rust-lang/rust/pull/69185/
3535 [69194]: https://github.com/rust-lang/rust/pull/69194/
3536 [69201]: https://github.com/rust-lang/rust/pull/69201/
3537 [69227]: https://github.com/rust-lang/rust/pull/69227/
3538 [69548]: https://github.com/rust-lang/rust/pull/69548/
3539 [69256]: https://github.com/rust-lang/rust/pull/69256/
3540 [69361]: https://github.com/rust-lang/rust/pull/69361/
3541 [69366]: https://github.com/rust-lang/rust/pull/69366/
3542 [69538]: https://github.com/rust-lang/rust/pull/69538/
3543 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
3544 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
3545 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
3546 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
3547 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
3548 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
3549 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
3550 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
3551
3552
3553 Version 1.42.0 (2020-03-12)
3554 ==========================
3555
3556 Language
3557 --------
3558 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
3559   ```rust
3560   fn foo(words: &[&str]) {
3561       match words {
3562           ["Hello", "World", "!", ..] => println!("Hello World!"),
3563           ["Foo", "Bar", ..] => println!("Baz"),
3564           rest => println!("{:?}", rest),
3565       }
3566   }
3567   ```
3568 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
3569   that you can create an enum that has the exact layout and ABI of the type
3570   it contains.
3571 - [You can now use outer attribute procedural macros on inline modules.][64273]
3572 - [There are some *syntax-only* changes:][67131]
3573    - `default` is syntactically allowed before items in `trait` definitions.
3574    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
3575      leave out their bodies in favor of `;`.
3576    - Bounds on associated types in `impl`s are now syntactically allowed
3577      (e.g. `type Foo: Ord;`).
3578    - `...` (the C-variadic type) may occur syntactically directly as the type of
3579       any function parameter.
3580
3581   These are still rejected *semantically*, so you will likely receive an error
3582   but these changes can be seen and parsed by procedural macros and
3583   conditional compilation.
3584
3585 Compiler
3586 --------
3587 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
3588 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
3589 - [`Option::{expect,unwrap}` and
3590    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
3591    pointing to the location where they were called, rather than
3592    `core`'s internals. ][67887]
3593
3594 \* Refer to Rust's [platform support page][platform-support-doc] for more
3595 information on Rust's tiered platform support.
3596
3597 Libraries
3598 ---------
3599 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
3600 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
3601    to implement `Sized`.][67935]
3602 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
3603 - [`Layout::new` is now `const`.][66254]
3604 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
3605
3606
3607 Stabilized APIs
3608 ---------------
3609 - [`CondVar::wait_while`]
3610 - [`CondVar::wait_timeout_while`]
3611 - [`DebugMap::key`]
3612 - [`DebugMap::value`]
3613 - [`ManuallyDrop::take`]
3614 - [`matches!`]
3615 - [`ptr::slice_from_raw_parts_mut`]
3616 - [`ptr::slice_from_raw_parts`]
3617
3618 Cargo
3619 -----
3620 - [You no longer need to include `extern crate proc_macro;` to be able to
3621   `use proc_macro;` in the `2018` edition.][cargo/7700]
3622
3623 Compatibility Notes
3624 -------------------
3625 - [`Error::description` has been deprecated, and its use will now produce a
3626   warning.][66919] It's recommended to use `Display`/`to_string` instead.
3627
3628 [68253]: https://github.com/rust-lang/rust/pull/68253/
3629 [68348]: https://github.com/rust-lang/rust/pull/68348/
3630 [67935]: https://github.com/rust-lang/rust/pull/67935/
3631 [68339]: https://github.com/rust-lang/rust/pull/68339/
3632 [68122]: https://github.com/rust-lang/rust/pull/68122/
3633 [64273]: https://github.com/rust-lang/rust/pull/64273/
3634 [67712]: https://github.com/rust-lang/rust/pull/67712/
3635 [67887]: https://github.com/rust-lang/rust/pull/67887/
3636 [67131]: https://github.com/rust-lang/rust/pull/67131/
3637 [67233]: https://github.com/rust-lang/rust/pull/67233/
3638 [66899]: https://github.com/rust-lang/rust/pull/66899/
3639 [66919]: https://github.com/rust-lang/rust/pull/66919/
3640 [66254]: https://github.com/rust-lang/rust/pull/66254/
3641 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
3642 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
3643 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
3644 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
3645 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
3646 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
3647 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
3648 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
3649 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
3650
3651
3652 Version 1.41.1 (2020-02-27)
3653 ===========================
3654
3655 * [Always check types of static items][69145]
3656 * [Always check lifetime bounds of `Copy` impls][69145]
3657 * [Fix miscompilation in callers of `Layout::repeat`][69225]
3658
3659 [69225]: https://github.com/rust-lang/rust/issues/69225
3660 [69145]: https://github.com/rust-lang/rust/pull/69145
3661
3662
3663 Version 1.41.0 (2020-01-30)
3664 ===========================
3665
3666 Language
3667 --------
3668
3669 - [You can now pass type parameters to foreign items when implementing
3670   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
3671 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
3672   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
3673   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
3674 - [You can now use any valid identifier in a `format_args` macro.][66847]
3675   Previously identifiers starting with an underscore were not allowed.
3676 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
3677   enum variants.][66183] These are still rejected semantically, but
3678   can be seen and parsed by procedural macros and conditional compilation.
3679 - [You can now define a Rust `extern "C"` function with `Box<T>` and use `T*` as the corresponding
3680   type on the C side.][62514] Please see [the documentation][box-memory-layout] for more information,
3681   including the important caveat about preferring to avoid `Box<T>` in Rust signatures for functions defined in C.
3682
3683 [box-memory-layout]: https://doc.rust-lang.org/std/boxed/index.html#memory-layout
3684
3685 Compiler
3686 --------
3687
3688 - [Rustc will now warn if you have unused loop `'label`s.][66325]
3689 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
3690 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
3691 - [You can now pass an arguments file passing the `@path` syntax
3692   to rustc.][66172] Note that the format differs somewhat from what is
3693   found in other tooling; please see [the documentation][argfile-docs] for
3694   more information.
3695 - [You can now provide `--extern` flag without a path, indicating that it is
3696   available from the search path or specified with an `-L` flag.][64882]
3697
3698 \* Refer to Rust's [platform support page][platform-support-doc] for more
3699 information on Rust's tiered platform support.
3700
3701 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
3702
3703 Libraries
3704 ---------
3705
3706 - [The `core::panic` module is now stable.][66771] It was already stable
3707   through `std`.
3708 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
3709   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
3710 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
3711
3712 Stabilized APIs
3713 ---------------
3714
3715 - [`Result::map_or`]
3716 - [`Result::map_or_else`]
3717 - [`std::rc::Weak::weak_count`]
3718 - [`std::rc::Weak::strong_count`]
3719 - [`std::sync::Weak::weak_count`]
3720 - [`std::sync::Weak::strong_count`]
3721
3722 Cargo
3723 -----
3724
3725 - [Cargo will now document all the private items for binary crates
3726   by default.][cargo/7593]
3727 - [`cargo-install` will now reinstall the package if it detects that it is out
3728   of date.][cargo/7560]
3729 - [Cargo.lock now uses a more git friendly format that should help to reduce
3730   merge conflicts.][cargo/7579]
3731 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
3732   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
3733   optimisation level to `2` for debug builds. You can also use
3734   `[profile.<profile>.build-override]` to override build scripts and
3735   their dependencies.
3736
3737 Misc
3738 ----
3739
3740 - [You can now specify `edition` in documentation code blocks to compile the block
3741   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
3742   should be compiled the 2018 edition of Rust.
3743 - [You can now provide custom themes to rustdoc with `--theme`, and check the
3744   current theme with `--check-theme`.][54733]
3745 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
3746
3747 Compatibility Notes
3748 -------------------
3749
3750 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
3751   Apple targets.][apple-32bit-drop] This means that the source code is still
3752   available to build, but the targets are no longer being tested and release
3753   binaries for those platforms will no longer be distributed by the Rust project.
3754   Please refer to the linked blog post for more information.
3755
3756 [54733]: https://github.com/rust-lang/rust/pull/54733/
3757 [61351]: https://github.com/rust-lang/rust/pull/61351/
3758 [62514]: https://github.com/rust-lang/rust/pull/62514/
3759 [67255]: https://github.com/rust-lang/rust/pull/67255/
3760 [66661]: https://github.com/rust-lang/rust/pull/66661/
3761 [66771]: https://github.com/rust-lang/rust/pull/66771/
3762 [66847]: https://github.com/rust-lang/rust/pull/66847/
3763 [66238]: https://github.com/rust-lang/rust/pull/66238/
3764 [66277]: https://github.com/rust-lang/rust/pull/66277/
3765 [66325]: https://github.com/rust-lang/rust/pull/66325/
3766 [66172]: https://github.com/rust-lang/rust/pull/66172/
3767 [66183]: https://github.com/rust-lang/rust/pull/66183/
3768 [65879]: https://github.com/rust-lang/rust/pull/65879/
3769 [65013]: https://github.com/rust-lang/rust/pull/65013/
3770 [64882]: https://github.com/rust-lang/rust/pull/64882/
3771 [64325]: https://github.com/rust-lang/rust/pull/64325/
3772 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
3773 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
3774 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
3775 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
3776 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
3777 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
3778 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
3779 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
3780 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
3781 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
3782 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
3783
3784 Version 1.40.0 (2019-12-19)
3785 ===========================
3786
3787 Language
3788 --------
3789 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
3790   `const` contexts.][65188] e.g.
3791
3792   ```rust
3793   pub struct Point(i32, i32);
3794
3795   const ORIGIN: Point = {
3796       let constructor = Point;
3797
3798       constructor(0, 0)
3799   };
3800   ```
3801
3802 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
3803   indicate that there may be variants or fields added in the future.][64639]
3804   For example this requires adding a wild-card branch (`_ => {}`) to any match
3805   statements on a non-exhaustive `enum`. [(RFC 2008)]
3806 - [You can now use function-like procedural macros in `extern` blocks and in
3807   type positions.][63931] e.g. `type Generated = macro!();`
3808 - [Function-like and attribute procedural macros can now emit
3809   `macro_rules!` items, so you can now have your macros generate macros.][64035]
3810 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
3811   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
3812   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
3813
3814 Compiler
3815 --------
3816 - [Added tier 3 support\* for the
3817   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
3818 - [Added tier 3 support for the
3819   `aarch64-unknown-none-softfloat` target.][64589]
3820 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
3821   `mips64el-unknown-linux-muslabi64` targets.][65843]
3822
3823 \* Refer to Rust's [platform support page][platform-support-doc] for more
3824   information on Rust's tiered platform support.
3825
3826 Libraries
3827 ---------
3828 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
3829
3830 Stabilized APIs
3831 ---------------
3832 - [`BTreeMap::get_key_value`]
3833 - [`HashMap::get_key_value`]
3834 - [`Option::as_deref_mut`]
3835 - [`Option::as_deref`]
3836 - [`Option::flatten`]
3837 - [`UdpSocket::peer_addr`]
3838 - [`f32::to_be_bytes`]
3839 - [`f32::to_le_bytes`]
3840 - [`f32::to_ne_bytes`]
3841 - [`f64::to_be_bytes`]
3842 - [`f64::to_le_bytes`]
3843 - [`f64::to_ne_bytes`]
3844 - [`f32::from_be_bytes`]
3845 - [`f32::from_le_bytes`]
3846 - [`f32::from_ne_bytes`]
3847 - [`f64::from_be_bytes`]
3848 - [`f64::from_le_bytes`]
3849 - [`f64::from_ne_bytes`]
3850 - [`mem::take`]
3851 - [`slice::repeat`]
3852 - [`todo!`]
3853
3854 Cargo
3855 -----
3856 - [Cargo will now always display warnings, rather than only on
3857   fresh builds.][cargo/7450]
3858 - [Feature flags (except `--all-features`) passed to a virtual workspace will
3859   now produce an error.][cargo/7507] Previously these flags were ignored.
3860 - [You can now publish `dev-dependencies` without including
3861   a `version`.][cargo/7333]
3862
3863 Misc
3864 ----
3865 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
3866   when running documentation tests with `rustdoc`.][63803]
3867
3868 Compatibility Notes
3869 -------------------
3870 - [As previously announced, any previous NLL warnings in the 2015 edition are
3871   now hard errors.][64221]
3872 - [The `include!` macro will now warn if it failed to include the
3873   entire file.][64284] The `include!` macro unintentionally only includes the
3874   first _expression_ in a file, and this can be unintuitive. This will become
3875   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
3876 - [Using `#[inline]` on function prototypes and consts now emits a warning under
3877   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
3878   or `extern` blocks now correctly emits a hard error.
3879
3880 [65294]: https://github.com/rust-lang/rust/pull/65294/
3881 [66103]: https://github.com/rust-lang/rust/pull/66103/
3882 [65843]: https://github.com/rust-lang/rust/pull/65843/
3883 [65188]: https://github.com/rust-lang/rust/pull/65188/
3884 [65092]: https://github.com/rust-lang/rust/pull/65092/
3885 [64589]: https://github.com/rust-lang/rust/pull/64589/
3886 [64639]: https://github.com/rust-lang/rust/pull/64639/
3887 [64221]: https://github.com/rust-lang/rust/pull/64221/
3888 [64284]: https://github.com/rust-lang/rust/pull/64284/
3889 [63931]: https://github.com/rust-lang/rust/pull/63931/
3890 [64035]: https://github.com/rust-lang/rust/pull/64035/
3891 [63674]: https://github.com/rust-lang/rust/pull/63674/
3892 [63803]: https://github.com/rust-lang/rust/pull/63803/
3893 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
3894 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
3895 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
3896 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
3897 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
3898 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
3899 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
3900 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
3901 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
3902 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
3903 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
3904 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
3905 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
3906 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
3907 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
3908 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
3909 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
3910 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
3911 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
3912 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
3913 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
3914 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
3915 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
3916 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
3917 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
3918
3919
3920 Version 1.39.0 (2019-11-07)
3921 ===========================
3922
3923 Language
3924 --------
3925 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
3926   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
3927 - [You can now use certain attributes on function, closure, and function pointer
3928   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
3929   `deny`, `forbid` as well as inert helper attributes used by procedural macro
3930   attributes applied to items. e.g.
3931   ```rust
3932   fn len(
3933       #[cfg(windows)] slice: &[u16],
3934       #[cfg(not(windows))] slice: &[u8],
3935   ) -> usize {
3936       slice.len()
3937   }
3938   ```
3939 - [You can now take shared references to bind-by-move patterns in the `if` guards
3940   of `match` arms.][63118] e.g.
3941   ```rust
3942   fn main() {
3943       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
3944
3945       match array {
3946           nums
3947   //      ---- `nums` is bound by move.
3948               if nums.iter().sum::<u8>() == 10
3949   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
3950           => {
3951               drop(nums);
3952   //          ----------- Legal as `nums` was bound by move and so we have ownership.
3953           }
3954           _ => unreachable!(),
3955       }
3956   }
3957   ```
3958
3959
3960
3961 Compiler
3962 --------
3963 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
3964 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
3965 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
3966   **Note** Cargo currently doesn't use this feature. Refer to
3967   [cargo#7315][cargo/7315] to track this feature's progress.
3968 - [You can now pass `--show-output` argument to test binaries to print the
3969   output of successful tests.][62600]
3970
3971
3972 \* Refer to Rust's [platform support page][platform-support-doc] for more
3973 information on Rust's tiered platform support.
3974
3975 Libraries
3976 ---------
3977 - [`Vec::new` and `String::new` are now `const` functions.][64028]
3978 - [`LinkedList::new` is now a `const` function.][63684]
3979 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
3980 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
3981   now `const`.][63786]
3982
3983 Stabilized APIs
3984 ---------------
3985 - [`Pin::into_inner`]
3986 - [`Instant::checked_duration_since`]
3987 - [`Instant::saturating_duration_since`]
3988
3989 Cargo
3990 -----
3991 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
3992 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
3993   `--all` is now deprecated.
3994
3995 Misc
3996 ----
3997 - [You can now pass `-Clinker` to rustdoc to control the linker used
3998   for compiling doctests.][63834]
3999
4000 Compatibility Notes
4001 -------------------
4002 - [Code that was previously accepted by the old borrow checker, but rejected by
4003   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
4004   previously a warning, and will also become a hard error in the Rust 2015
4005   edition in the 1.40.0 release.
4006 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
4007   run tests.][63827] This should improve performance when running a large
4008   amount of doctests.
4009 - [The `try!` macro will now issue a deprecation warning.][62672] It is
4010   recommended to use the `?` operator instead.
4011 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
4012   returned `0.0`.
4013
4014 [62600]: https://github.com/rust-lang/rust/pull/62600/
4015 [62672]: https://github.com/rust-lang/rust/pull/62672/
4016 [63118]: https://github.com/rust-lang/rust/pull/63118/
4017 [63209]: https://github.com/rust-lang/rust/pull/63209/
4018 [63402]: https://github.com/rust-lang/rust/pull/63402/
4019 [63565]: https://github.com/rust-lang/rust/pull/63565/
4020 [63595]: https://github.com/rust-lang/rust/pull/63595/
4021 [63684]: https://github.com/rust-lang/rust/pull/63684/
4022 [63698]: https://github.com/rust-lang/rust/pull/63698/
4023 [63770]: https://github.com/rust-lang/rust/pull/63770/
4024 [63786]: https://github.com/rust-lang/rust/pull/63786/
4025 [63827]: https://github.com/rust-lang/rust/pull/63827/
4026 [63834]: https://github.com/rust-lang/rust/pull/63834/
4027 [64010]: https://github.com/rust-lang/rust/pull/64010/
4028 [64028]: https://github.com/rust-lang/rust/pull/64028/
4029 [64334]: https://github.com/rust-lang/rust/pull/64334/
4030 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
4031 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
4032 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
4033 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
4034 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
4035 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
4036
4037 Version 1.38.0 (2019-09-26)
4038 ==========================
4039
4040 Language
4041 --------
4042 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
4043 - [The `#[deprecated]` attribute can now be used on macros.][62042]
4044
4045 Compiler
4046 --------
4047 - [Added pipelined compilation support to `rustc`.][62766] This will
4048   improve compilation times in some cases. For further information please refer
4049   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
4050 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
4051   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
4052   `x86_64-uwp-windows-msvc` targets.][60260]
4053 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
4054   `armv7-unknown-linux-musleabi` targets.][63107]
4055 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
4056 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
4057 - [Upgraded to LLVM 9.][62592]
4058
4059 \* Refer to Rust's [platform support page][platform-support-doc] for more
4060 information on Rust's tiered platform support.
4061
4062 Libraries
4063 ---------
4064 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
4065 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
4066   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
4067   is available at `std::clone::Clone`). This also makes all built-in macros
4068   available in `std`/`core` root. e.g. `std::include_bytes!`.
4069 - [`str::Chars` now implements `Debug`.][63000]
4070 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
4071 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
4072 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
4073 - [Added euclidean remainder and division operations (`div_euclid`,
4074   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
4075   `overflowing`, and `wrapping` versions are available for all
4076   integer primitives.
4077 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
4078   `PartialEq`.][61491]
4079 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
4080
4081 Stabilized APIs
4082 ---------------
4083 - [`<*const T>::cast`]
4084 - [`<*mut T>::cast`]
4085 - [`Duration::as_secs_f32`]
4086 - [`Duration::as_secs_f64`]
4087 - [`Duration::div_f32`]
4088 - [`Duration::div_f64`]
4089 - [`Duration::from_secs_f32`]
4090 - [`Duration::from_secs_f64`]
4091 - [`Duration::mul_f32`]
4092 - [`Duration::mul_f64`]
4093 - [`any::type_name`]
4094
4095 Cargo
4096 -----
4097 - [Added pipelined compilation support to `cargo`.][cargo/7143]
4098 - [You can now pass the `--features` option multiple times to enable
4099   multiple features.][cargo/7084]
4100
4101 Rustdoc
4102 -------
4103
4104 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
4105
4106 Misc
4107 ----
4108 - [`rustc` will now warn about some incorrect uses of
4109   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
4110
4111 Compatibility Notes
4112 -------------------
4113 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
4114   1.38.0.
4115 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
4116   issues][62896] with certain crates such as libc.
4117
4118 [60260]: https://github.com/rust-lang/rust/pull/60260/
4119 [61457]: https://github.com/rust-lang/rust/pull/61457/
4120 [61491]: https://github.com/rust-lang/rust/pull/61491/
4121 [61884]: https://github.com/rust-lang/rust/pull/61884/
4122 [61953]: https://github.com/rust-lang/rust/pull/61953/
4123 [62042]: https://github.com/rust-lang/rust/pull/62042/
4124 [62528]: https://github.com/rust-lang/rust/pull/62528/
4125 [62583]: https://github.com/rust-lang/rust/pull/62583/
4126 [62735]: https://github.com/rust-lang/rust/pull/62735/
4127 [62766]: https://github.com/rust-lang/rust/pull/62766/
4128 [62784]: https://github.com/rust-lang/rust/pull/62784/
4129 [62592]: https://github.com/rust-lang/rust/pull/62592/
4130 [62785]: https://github.com/rust-lang/rust/issues/62785/
4131 [62814]: https://github.com/rust-lang/rust/pull/62814/
4132 [62896]: https://github.com/rust-lang/rust/issues/62896/
4133 [63000]: https://github.com/rust-lang/rust/pull/63000/
4134 [63056]: https://github.com/rust-lang/rust/pull/63056/
4135 [63107]: https://github.com/rust-lang/rust/pull/63107/
4136 [63346]: https://github.com/rust-lang/rust/pull/63346/
4137 [63421]: https://github.com/rust-lang/rust/pull/63421/
4138 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
4139 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
4140 [63048]: https://github.com/rust-lang/rust/pull/63048
4141 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
4142 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
4143 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
4144 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
4145 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
4146 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
4147 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
4148 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
4149 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
4150 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
4151 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
4152 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
4153 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
4154
4155 Version 1.37.0 (2019-08-15)
4156 ==========================
4157
4158 Language
4159 --------
4160 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
4161   [`Box`][62228], or an [array][62235] and unused.
4162 - [You can now use the `cfg` and `cfg_attr` attributes on
4163   generic parameters.][61547]
4164 - [You can now use enum variants through type alias.][61682] e.g. You can
4165   write the following:
4166   ```rust
4167   type MyOption = Option<u8>;
4168
4169   fn increment_or_zero(x: MyOption) -> u8 {
4170       match x {
4171           MyOption::Some(y) => y + 1,
4172           MyOption::None => 0,
4173       }
4174   }
4175   ```
4176 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
4177   `const _: u32 = 5;`.
4178 - [You can now use `#[repr(align(X)]` on enums.][61229]
4179 - [The  `?` Kleene macro operator is now available in the
4180   2015 edition.][60932]
4181
4182 Compiler
4183 --------
4184 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
4185   and `-C profile-use` flags.][61268] For more information on how to use profile
4186   guided optimization, please refer to the [rustc book][rustc-book-pgo].
4187 - [The `rust-lldb` wrapper script should now work again.][61827]
4188
4189 Libraries
4190 ---------
4191 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
4192
4193 Stabilized APIs
4194 ---------------
4195 - [`BufReader::buffer`]
4196 - [`BufWriter::buffer`]
4197 - [`Cell::from_mut`]
4198 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
4199 - [`DoubleEndedIterator::nth_back`]
4200 - [`Option::xor`]
4201 - [`Wrapping::reverse_bits`]
4202 - [`i128::reverse_bits`]
4203 - [`i16::reverse_bits`]
4204 - [`i32::reverse_bits`]
4205 - [`i64::reverse_bits`]
4206 - [`i8::reverse_bits`]
4207 - [`isize::reverse_bits`]
4208 - [`slice::copy_within`]
4209 - [`u128::reverse_bits`]
4210 - [`u16::reverse_bits`]
4211 - [`u32::reverse_bits`]
4212 - [`u64::reverse_bits`]
4213 - [`u8::reverse_bits`]
4214 - [`usize::reverse_bits`]
4215
4216 Cargo
4217 -----
4218 - [`Cargo.lock` files are now included by default when publishing executable crates
4219   with executables.][cargo/7026]
4220 - [You can now specify `default-run="foo"` in `[package]` to specify the
4221   default executable to use for `cargo run`.][cargo/7056]
4222
4223 Misc
4224 ----
4225
4226 Compatibility Notes
4227 -------------------
4228 - [Using `...` for inclusive range patterns will now warn by default.][61342]
4229   Please transition your code to using the `..=` syntax for inclusive
4230   ranges instead.
4231 - [Using a trait object without the `dyn` will now warn by default.][61203]
4232   Please transition your code to use `dyn Trait` for trait objects instead.
4233
4234 [62228]: https://github.com/rust-lang/rust/pull/62228/
4235 [62235]: https://github.com/rust-lang/rust/pull/62235/
4236 [61802]: https://github.com/rust-lang/rust/pull/61802/
4237 [61827]: https://github.com/rust-lang/rust/pull/61827/
4238 [61547]: https://github.com/rust-lang/rust/pull/61547/
4239 [61682]: https://github.com/rust-lang/rust/pull/61682/
4240 [61268]: https://github.com/rust-lang/rust/pull/61268/
4241 [61342]: https://github.com/rust-lang/rust/pull/61342/
4242 [61347]: https://github.com/rust-lang/rust/pull/61347/
4243 [61100]: https://github.com/rust-lang/rust/pull/61100/
4244 [61203]: https://github.com/rust-lang/rust/pull/61203/
4245 [61229]: https://github.com/rust-lang/rust/pull/61229/
4246 [60932]: https://github.com/rust-lang/rust/pull/60932/
4247 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
4248 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
4249 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
4250 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
4251 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
4252 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
4253 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
4254 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
4255 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
4256 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
4257 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
4258 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
4259 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
4260 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
4261 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
4262 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
4263 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
4264 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
4265 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
4266 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
4267 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
4268 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
4269 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
4270
4271
4272 Version 1.36.0 (2019-07-04)
4273 ==========================
4274
4275 Language
4276 --------
4277 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
4278 - [The order of traits in trait objects no longer affects the semantics of that
4279   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
4280   `dyn fmt::Debug + Send`, where this was previously not the case.
4281
4282 Libraries
4283 ---------
4284 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
4285 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
4286 - [`mem::needs_drop` is now available as a const fn.][60364]
4287 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
4288 - [`String` now implements `BorrowMut<str>`.][60404]
4289 - [`io::Cursor` now implements `Default`.][60234]
4290 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
4291 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
4292   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
4293   environment has access to heap memory allocation.
4294 - [`String` now implements `From<&String>`.][59825]
4295 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
4296   return a tuple of each argument when there is multiple arguments.
4297 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
4298   not used.][59648]
4299
4300 Stabilized APIs
4301 ---------------
4302 - [`VecDeque::rotate_left`]
4303 - [`VecDeque::rotate_right`]
4304 - [`Iterator::copied`]
4305 - [`io::IoSlice`]
4306 - [`io::IoSliceMut`]
4307 - [`Read::read_vectored`]
4308 - [`Write::write_vectored`]
4309 - [`str::as_mut_ptr`]
4310 - [`mem::MaybeUninit`]
4311 - [`pointer::align_offset`]
4312 - [`future::Future`]
4313 - [`task::Context`]
4314 - [`task::RawWaker`]
4315 - [`task::RawWakerVTable`]
4316 - [`task::Waker`]
4317 - [`task::Poll`]
4318
4319 Cargo
4320 -----
4321 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
4322 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
4323
4324 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
4325
4326 Clippy
4327 ------
4328 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
4329
4330 Misc
4331 ----
4332
4333 Compatibility Notes
4334 -------------------
4335 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
4336   longer recommended, and will be deprecated in 1.39.0.
4337
4338 [60318]: https://github.com/rust-lang/rust/pull/60318/
4339 [60364]: https://github.com/rust-lang/rust/pull/60364/
4340 [60370]: https://github.com/rust-lang/rust/pull/60370/
4341 [60404]: https://github.com/rust-lang/rust/pull/60404/
4342 [60234]: https://github.com/rust-lang/rust/pull/60234/
4343 [60244]: https://github.com/rust-lang/rust/pull/60244/
4344 [58623]: https://github.com/rust-lang/rust/pull/58623/
4345 [59648]: https://github.com/rust-lang/rust/pull/59648/
4346 [59675]: https://github.com/rust-lang/rust/pull/59675/
4347 [59825]: https://github.com/rust-lang/rust/pull/59825/
4348 [59826]: https://github.com/rust-lang/rust/pull/59826/
4349 [59445]: https://github.com/rust-lang/rust/pull/59445/
4350 [59114]: https://github.com/rust-lang/rust/pull/59114/
4351 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
4352 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
4353 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
4354 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
4355 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
4356 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
4357 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
4358 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
4359 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
4360 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
4361 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
4362 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
4363 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
4364 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
4365 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
4366 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
4367 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
4368 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
4369 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
4370 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
4371
4372
4373 Version 1.35.0 (2019-05-23)
4374 ==========================
4375
4376 Language
4377 --------
4378 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
4379   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
4380 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
4381   ```rust
4382   unsafe fn call_unsafe(func: unsafe fn()) {
4383       func()
4384   }
4385
4386   pub fn main() {
4387       unsafe { call_unsafe(|| {}); }
4388   }
4389   ```
4390
4391
4392 Compiler
4393 --------
4394 - [Added the `armv6-unknown-freebsd-gnueabihf` and
4395   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
4396 - [Added the `wasm32-unknown-wasi` target.][59464]
4397
4398
4399 Libraries
4400 ---------
4401 - [`Thread` will now show its ID in `Debug` output.][59460]
4402 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
4403 - [`alloc::System` now implements `Default`.][59451]
4404 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
4405   last field.][59076]
4406 - [`char::{ToLowercase, ToUppercase}` now
4407   implement `ExactSizeIterator`.][58778]
4408 - [All `NonZero` numeric types now implement `FromStr`.][58717]
4409 - [Removed the `Read` trait bounds
4410   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
4411 - [You can now call the `dbg!` macro without any parameters to print the file
4412   and line where it is called.][57847]
4413 - [In place ASCII case conversions are now up to 4× faster.][59283]
4414   e.g. `str::make_ascii_lowercase`
4415 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
4416   and `Send`.][58369]
4417
4418 Stabilized APIs
4419 ---------------
4420 - [`f32::copysign`]
4421 - [`f64::copysign`]
4422 - [`RefCell::replace_with`]
4423 - [`RefCell::map_split`]
4424 - [`ptr::hash`]
4425 - [`Range::contains`]
4426 - [`RangeFrom::contains`]
4427 - [`RangeTo::contains`]
4428 - [`RangeInclusive::contains`]
4429 - [`RangeToInclusive::contains`]
4430 - [`Option::copied`]
4431
4432 Cargo
4433 -----
4434 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
4435   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
4436   platform specific.
4437
4438 Misc
4439 ----
4440 - [The Rust toolchain is now available natively for musl based distros.][58575]
4441
4442 [59460]: https://github.com/rust-lang/rust/pull/59460/
4443 [59464]: https://github.com/rust-lang/rust/pull/59464/
4444 [59500]: https://github.com/rust-lang/rust/pull/59500/
4445 [59512]: https://github.com/rust-lang/rust/pull/59512/
4446 [59580]: https://github.com/rust-lang/rust/pull/59580/
4447 [59283]: https://github.com/rust-lang/rust/pull/59283/
4448 [59451]: https://github.com/rust-lang/rust/pull/59451/
4449 [59076]: https://github.com/rust-lang/rust/pull/59076/
4450 [58778]: https://github.com/rust-lang/rust/pull/58778/
4451 [58717]: https://github.com/rust-lang/rust/pull/58717/
4452 [58369]: https://github.com/rust-lang/rust/pull/58369/
4453 [58423]: https://github.com/rust-lang/rust/pull/58423/
4454 [58080]: https://github.com/rust-lang/rust/pull/58080/
4455 [57847]: https://github.com/rust-lang/rust/pull/57847/
4456 [58575]: https://github.com/rust-lang/rust/pull/58575
4457 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
4458 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
4459 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
4460 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
4461 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
4462 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
4463 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
4464 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
4465 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
4466 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
4467 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
4468 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
4469
4470 Version 1.34.2 (2019-05-14)
4471 ===========================
4472
4473 * [Destabilize the `Error::type_id` function due to a security
4474    vulnerability][60785] ([CVE-2019-12083])
4475
4476 [60785]: https://github.com/rust-lang/rust/pull/60785
4477 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
4478
4479 Version 1.34.1 (2019-04-25)
4480 ===========================
4481
4482 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
4483 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
4484 * [Fix Clippy panic when checking some macros][clippy/3805]
4485
4486 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
4487 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
4488 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
4489
4490 Version 1.34.0 (2019-04-11)
4491 ==========================
4492
4493 Language
4494 --------
4495 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
4496   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
4497   but had no effect.
4498 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
4499   `#[attr{}]` procedural macros.][57367]
4500 - [You can now write `extern crate self as foo;`][57407] to import your
4501   crate's root into the extern prelude.
4502
4503
4504 Compiler
4505 --------
4506 - [You can now target `riscv64imac-unknown-none-elf` and
4507   `riscv64gc-unknown-none-elf`.][58406]
4508 - [You can now enable linker plugin LTO optimisations with
4509   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
4510   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
4511   boundaries.
4512 - [You can now target `powerpc64-unknown-freebsd`.][57809]
4513
4514
4515 Libraries
4516 ---------
4517 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
4518   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
4519   the `Hash` trait to create an iterator.
4520 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
4521   methods.][58421] Most notably you no longer require the `Ord` trait to create
4522   an iterator.
4523 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
4524   for all numeric types.][58044]
4525 - [Indexing a `str` is now generic over all types that
4526   implement `SliceIndex<str>`.][57604]
4527 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
4528   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
4529   produce a warning if their returning type is unused.
4530 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
4531   `overflowing_pow` are now available for all numeric types.][57873] These are
4532   equivalent to methods such as `wrapping_add` for the `pow` operation.
4533
4534
4535 Stabilized APIs
4536 ---------------
4537
4538 #### std & core
4539 * [`Any::type_id`]
4540 * [`Error::type_id`]
4541 * [`atomic::AtomicI16`]
4542 * [`atomic::AtomicI32`]
4543 * [`atomic::AtomicI64`]
4544 * [`atomic::AtomicI8`]
4545 * [`atomic::AtomicU16`]
4546 * [`atomic::AtomicU32`]
4547 * [`atomic::AtomicU64`]
4548 * [`atomic::AtomicU8`]
4549 * [`convert::Infallible`]
4550 * [`convert::TryFrom`]
4551 * [`convert::TryInto`]
4552 * [`iter::from_fn`]
4553 * [`iter::successors`]
4554 * [`num::NonZeroI128`]
4555 * [`num::NonZeroI16`]
4556 * [`num::NonZeroI32`]
4557 * [`num::NonZeroI64`]
4558 * [`num::NonZeroI8`]
4559 * [`num::NonZeroIsize`]
4560 * [`slice::sort_by_cached_key`]
4561 * [`str::escape_debug`]
4562 * [`str::escape_default`]
4563 * [`str::escape_unicode`]
4564 * [`str::split_ascii_whitespace`]
4565
4566 #### std
4567 * [`Instant::checked_add`]
4568 * [`Instant::checked_sub`]
4569 * [`SystemTime::checked_add`]
4570 * [`SystemTime::checked_sub`]
4571
4572 Cargo
4573 -----
4574 - [You can now use alternative registries to crates.io.][cargo/6654]
4575
4576 Misc
4577 ----
4578 - [You can now use the `?` operator in your documentation tests without manually
4579   adding `fn main() -> Result<(), _> {}`.][56470]
4580
4581 Compatibility Notes
4582 -------------------
4583 - [`Command::before_exec` is being replaced by the unsafe method
4584   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
4585 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
4586   can now use `const` functions in `static` variables.
4587
4588 [58370]: https://github.com/rust-lang/rust/pull/58370/
4589 [58406]: https://github.com/rust-lang/rust/pull/58406/
4590 [58421]: https://github.com/rust-lang/rust/pull/58421/
4591 [58166]: https://github.com/rust-lang/rust/pull/58166/
4592 [58044]: https://github.com/rust-lang/rust/pull/58044/
4593 [58057]: https://github.com/rust-lang/rust/pull/58057/
4594 [58059]: https://github.com/rust-lang/rust/pull/58059/
4595 [57809]: https://github.com/rust-lang/rust/pull/57809/
4596 [57873]: https://github.com/rust-lang/rust/pull/57873/
4597 [57604]: https://github.com/rust-lang/rust/pull/57604/
4598 [57367]: https://github.com/rust-lang/rust/pull/57367/
4599 [57407]: https://github.com/rust-lang/rust/pull/57407/
4600 [57425]: https://github.com/rust-lang/rust/pull/57425/
4601 [57106]: https://github.com/rust-lang/rust/pull/57106/
4602 [56470]: https://github.com/rust-lang/rust/pull/56470/
4603 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
4604 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
4605 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
4606 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
4607 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
4608 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
4609 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
4610 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
4611 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
4612 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
4613 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
4614 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
4615 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
4616 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
4617 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
4618 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
4619 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
4620 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
4621 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
4622 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
4623 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
4624 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
4625 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
4626 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
4627 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
4628 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
4629 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
4630 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
4631 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
4632 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
4633 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
4634
4635
4636 Version 1.33.0 (2019-02-28)
4637 ==========================
4638
4639 Language
4640 --------
4641 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
4642   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
4643 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
4644   E.g. You can have match statement on a `u8` that covers `0..=255` and
4645   you would no longer be required to have a `_ => unreachable!()` case.
4646 - [You can now have multiple patterns in `if let` and `while let`
4647   expressions.][57532] You can do this with the same syntax as a `match`
4648   expression. E.g.
4649   ```rust
4650   enum Creature {
4651       Crab(String),
4652       Lobster(String),
4653       Person(String),
4654   }
4655
4656   fn main() {
4657       let state = Creature::Crab("Ferris");
4658
4659       if let Creature::Crab(name) | Creature::Person(name) = state {
4660           println!("This creature's name is: {}", name);
4661       }
4662   }
4663   ```
4664 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
4665   this feature will by default produce a warning as this behaviour can be
4666   unintuitive. E.g. `if let _ = 5 {}`
4667 - [You can now use `let` bindings, assignments, expression statements,
4668   and irrefutable pattern destructuring in const functions.][57175]
4669 - [You can now call unsafe const functions.][57067] E.g.
4670   ```rust
4671   const unsafe fn foo() -> i32 { 5 }
4672   const fn bar() -> i32 {
4673       unsafe { foo() }
4674   }
4675   ```
4676 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
4677   E.g. `#[cfg_attr(all(), must_use, optimize)]`
4678 - [You can now specify a specific alignment with the `#[repr(packed)]`
4679   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
4680   with an alignment of 2 bytes and a size of 6 bytes.
4681 - [You can now import an item from a module as an `_`.][56303] This allows you to
4682   import a trait's impls, and not have the name in the namespace. E.g.
4683   ```rust
4684   use std::io::Read as _;
4685
4686   // Allowed as there is only one `Read` in the module.
4687   pub trait Read {}
4688   ```
4689 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
4690
4691 Compiler
4692 --------
4693 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
4694   command line argument.][56351]
4695 - [The minimum required LLVM version has been bumped to 6.0.][56642]
4696 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
4697 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
4698   tier 2 support.][57130] Visit the [platform support][platform-support] page for
4699   information on Rust's platform support.
4700 - [Added support for the `thumbv7neon-linux-androideabi` and
4701   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
4702 - [Added support for the `x86_64-unknown-uefi` target.][56769]
4703
4704 Libraries
4705 ---------
4706 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
4707   functions for all numeric types.][57566]
4708 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
4709   are now `const` functions for all numeric types.][57105]
4710 - [The methods `is_positive` and `is_negative` are now `const` functions for
4711   all signed numeric types.][57105]
4712 - [The `get` method for all `NonZero` types is now `const`.][57167]
4713 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
4714   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
4715   numeric types.][57234]
4716 - [`Ipv4Addr::new` is now a `const` function][57234]
4717
4718 Stabilized APIs
4719 ---------------
4720 - [`unix::FileExt::read_exact_at`]
4721 - [`unix::FileExt::write_all_at`]
4722 - [`Option::transpose`]
4723 - [`Result::transpose`]
4724 - [`convert::identity`]
4725 - [`pin::Pin`]
4726 - [`marker::Unpin`]
4727 - [`marker::PhantomPinned`]
4728 - [`Vec::resize_with`]
4729 - [`VecDeque::resize_with`]
4730 - [`Duration::as_millis`]
4731 - [`Duration::as_micros`]
4732 - [`Duration::as_nanos`]
4733
4734
4735 Cargo
4736 -----
4737 - [You can now publish crates that require a feature flag to compile with
4738   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
4739 - [Cargo should now rebuild a crate if a file was modified during the initial
4740   build.][cargo/6484]
4741
4742 Compatibility Notes
4743 -------------------
4744 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
4745   are now deprecated in the standard library, and their usage will now produce a warning.
4746   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
4747   methods instead.
4748 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
4749   downcasting.
4750 - [Libtest no longer creates a new thread for each test when
4751   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
4752
4753 [56243]: https://github.com/rust-lang/rust/pull/56243
4754 [56303]: https://github.com/rust-lang/rust/pull/56303/
4755 [56351]: https://github.com/rust-lang/rust/pull/56351/
4756 [56362]: https://github.com/rust-lang/rust/pull/56362
4757 [56642]: https://github.com/rust-lang/rust/pull/56642/
4758 [56769]: https://github.com/rust-lang/rust/pull/56769/
4759 [56805]: https://github.com/rust-lang/rust/pull/56805
4760 [56947]: https://github.com/rust-lang/rust/pull/56947/
4761 [57049]: https://github.com/rust-lang/rust/pull/57049/
4762 [57067]: https://github.com/rust-lang/rust/pull/57067/
4763 [57105]: https://github.com/rust-lang/rust/pull/57105
4764 [57130]: https://github.com/rust-lang/rust/pull/57130/
4765 [57167]: https://github.com/rust-lang/rust/pull/57167/
4766 [57175]: https://github.com/rust-lang/rust/pull/57175/
4767 [57234]: https://github.com/rust-lang/rust/pull/57234/
4768 [57332]: https://github.com/rust-lang/rust/pull/57332/
4769 [57465]: https://github.com/rust-lang/rust/pull/57465/
4770 [57532]: https://github.com/rust-lang/rust/pull/57532/
4771 [57535]: https://github.com/rust-lang/rust/pull/57535/
4772 [57566]: https://github.com/rust-lang/rust/pull/57566/
4773 [57615]: https://github.com/rust-lang/rust/pull/57615/
4774 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
4775 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
4776 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
4777 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
4778 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
4779 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
4780 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
4781 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
4782 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
4783 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
4784 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
4785 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
4786 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
4787 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
4788 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
4789 [platform-support]: https://forge.rust-lang.org/platform-support.html
4790
4791 Version 1.32.0 (2019-01-17)
4792 ==========================
4793
4794 Language
4795 --------
4796 #### 2018 edition
4797 - [You can now use the `?` operator in macro definitions.][56245] The `?`
4798   operator allows you to specify zero or one repetitions similar to the `*` and
4799   `+` operators.
4800 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
4801   now always resolve to the item (`enum`, `struct`, etc.) available in the
4802   module if present, before resolving to a external crate or an item the prelude.][56759]
4803   E.g.
4804   ```rust
4805   enum Color { Red, Green, Blue }
4806
4807   use Color::*;
4808   ```
4809
4810 #### All editions
4811 - [You can now match against `PhantomData<T>` types.][55837]
4812 - [You can now match against literals in macros with the `literal`
4813   specifier.][56072] This will match against a literal of any type.
4814   E.g. `1`, `'A'`, `"Hello World"`
4815 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
4816   ```rust
4817   struct Point(i32, i32);
4818
4819   impl Point {
4820       pub fn new(x: i32, y: i32) -> Self {
4821           Self(x, y)
4822       }
4823
4824       pub fn is_origin(&self) -> bool {
4825           match self {
4826               Self(0, 0) => true,
4827               _ => false,
4828           }
4829       }
4830   }
4831   ```
4832 - [Self can also now be used in type definitions.][56366] E.g.
4833   ```rust
4834   enum List<T>
4835   where
4836       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
4837   {
4838       Nil,
4839       Cons(T, Box<Self>) // likewise here
4840   }
4841   ```
4842 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
4843   a `impl Trait` or `dyn Trait` is returned and unused in the program.
4844
4845 Compiler
4846 --------
4847 - [The default allocator has changed from jemalloc to the default allocator on
4848   your system.][55238] The compiler itself on Linux & macOS will still use
4849   jemalloc, but programs compiled with it will use the system allocator.
4850 - [Added the `aarch64-pc-windows-msvc` target.][55702]
4851
4852 Libraries
4853 ---------
4854 - [`PathBuf` now implements `FromStr`.][55148]
4855 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
4856 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
4857   easily debug expressions in your rust program. E.g.
4858   ```rust
4859   let a = 2;
4860   let b = dbg!(a * 2) + 1;
4861   //      ^-- prints: [src/main.rs:4] a * 2 = 4
4862   assert_eq!(b, 5);
4863   ```
4864
4865 The following APIs are now `const` functions and can be used in a
4866 `const` context.
4867
4868 - [`Cell::as_ptr`]
4869 - [`UnsafeCell::get`]
4870 - [`char::is_ascii`]
4871 - [`iter::empty`]
4872 - [`ManuallyDrop::new`]
4873 - [`ManuallyDrop::into_inner`]
4874 - [`RangeInclusive::start`]
4875 - [`RangeInclusive::end`]
4876 - [`NonNull::as_ptr`]
4877 - [`slice::as_ptr`]
4878 - [`str::as_ptr`]
4879 - [`Duration::as_secs`]
4880 - [`Duration::subsec_millis`]
4881 - [`Duration::subsec_micros`]
4882 - [`Duration::subsec_nanos`]
4883 - [`CStr::as_ptr`]
4884 - [`Ipv4Addr::is_unspecified`]
4885 - [`Ipv6Addr::new`]
4886 - [`Ipv6Addr::octets`]
4887
4888 Stabilized APIs
4889 ---------------
4890 - [`i8::to_be_bytes`]
4891 - [`i8::to_le_bytes`]
4892 - [`i8::to_ne_bytes`]
4893 - [`i8::from_be_bytes`]
4894 - [`i8::from_le_bytes`]
4895 - [`i8::from_ne_bytes`]
4896 - [`i16::to_be_bytes`]
4897 - [`i16::to_le_bytes`]
4898 - [`i16::to_ne_bytes`]
4899 - [`i16::from_be_bytes`]
4900 - [`i16::from_le_bytes`]
4901 - [`i16::from_ne_bytes`]
4902 - [`i32::to_be_bytes`]
4903 - [`i32::to_le_bytes`]
4904 - [`i32::to_ne_bytes`]
4905 - [`i32::from_be_bytes`]
4906 - [`i32::from_le_bytes`]
4907 - [`i32::from_ne_bytes`]
4908 - [`i64::to_be_bytes`]
4909 - [`i64::to_le_bytes`]
4910 - [`i64::to_ne_bytes`]
4911 - [`i64::from_be_bytes`]
4912 - [`i64::from_le_bytes`]
4913 - [`i64::from_ne_bytes`]
4914 - [`i128::to_be_bytes`]
4915 - [`i128::to_le_bytes`]
4916 - [`i128::to_ne_bytes`]
4917 - [`i128::from_be_bytes`]
4918 - [`i128::from_le_bytes`]
4919 - [`i128::from_ne_bytes`]
4920 - [`isize::to_be_bytes`]
4921 - [`isize::to_le_bytes`]
4922 - [`isize::to_ne_bytes`]
4923 - [`isize::from_be_bytes`]
4924 - [`isize::from_le_bytes`]
4925 - [`isize::from_ne_bytes`]
4926 - [`u8::to_be_bytes`]
4927 - [`u8::to_le_bytes`]
4928 - [`u8::to_ne_bytes`]
4929 - [`u8::from_be_bytes`]
4930 - [`u8::from_le_bytes`]
4931 - [`u8::from_ne_bytes`]
4932 - [`u16::to_be_bytes`]
4933 - [`u16::to_le_bytes`]
4934 - [`u16::to_ne_bytes`]
4935 - [`u16::from_be_bytes`]
4936 - [`u16::from_le_bytes`]
4937 - [`u16::from_ne_bytes`]
4938 - [`u32::to_be_bytes`]
4939 - [`u32::to_le_bytes`]
4940 - [`u32::to_ne_bytes`]
4941 - [`u32::from_be_bytes`]
4942 - [`u32::from_le_bytes`]
4943 - [`u32::from_ne_bytes`]
4944 - [`u64::to_be_bytes`]
4945 - [`u64::to_le_bytes`]
4946 - [`u64::to_ne_bytes`]
4947 - [`u64::from_be_bytes`]
4948 - [`u64::from_le_bytes`]
4949 - [`u64::from_ne_bytes`]
4950 - [`u128::to_be_bytes`]
4951 - [`u128::to_le_bytes`]
4952 - [`u128::to_ne_bytes`]
4953 - [`u128::from_be_bytes`]
4954 - [`u128::from_le_bytes`]
4955 - [`u128::from_ne_bytes`]
4956 - [`usize::to_be_bytes`]
4957 - [`usize::to_le_bytes`]
4958 - [`usize::to_ne_bytes`]
4959 - [`usize::from_be_bytes`]
4960 - [`usize::from_le_bytes`]
4961 - [`usize::from_ne_bytes`]
4962
4963 Cargo
4964 -----
4965 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
4966 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
4967
4968 Misc
4969 ----
4970 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
4971
4972 Compatibility Notes
4973 -------------------
4974 - [The argument types for AVX's
4975   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
4976   been changed from `*const` to `*mut` as the previous implementation
4977   was unsound.
4978
4979
4980 [55148]: https://github.com/rust-lang/rust/pull/55148/
4981 [55238]: https://github.com/rust-lang/rust/pull/55238/
4982 [55280]: https://github.com/rust-lang/rust/pull/55280/
4983 [55610]: https://github.com/rust-lang/rust/pull/55610/
4984 [55663]: https://github.com/rust-lang/rust/pull/55663/
4985 [55702]: https://github.com/rust-lang/rust/pull/55702/
4986 [55837]: https://github.com/rust-lang/rust/pull/55837/
4987 [55843]: https://github.com/rust-lang/rust/pull/55843/
4988 [56072]: https://github.com/rust-lang/rust/pull/56072/
4989 [56245]: https://github.com/rust-lang/rust/pull/56245/
4990 [56365]: https://github.com/rust-lang/rust/pull/56365/
4991 [56366]: https://github.com/rust-lang/rust/pull/56366/
4992 [56395]: https://github.com/rust-lang/rust/pull/56395/
4993 [56759]: https://github.com/rust-lang/rust/pull/56759/
4994 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
4995 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
4996 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
4997 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
4998 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
4999 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
5000 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
5001 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
5002 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
5003 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
5004 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
5005 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
5006 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
5007 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
5008 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
5009 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
5010 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
5011 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
5012 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
5013 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
5014 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
5015 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
5016 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
5017 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
5018 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
5019 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
5020 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
5021 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
5022 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
5023 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
5024 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
5025 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
5026 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
5027 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
5028 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
5029 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
5030 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
5031 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
5032 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
5033 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
5034 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
5035 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
5036 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
5037 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
5038 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
5039 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
5040 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
5041 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
5042 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
5043 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
5044 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
5045 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
5046 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
5047 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
5048 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
5049 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
5050 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
5051 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
5052 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
5053 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
5054 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
5055 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
5056 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
5057 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
5058 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
5059 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
5060 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
5061 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
5062 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
5063 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
5064 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
5065 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
5066 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
5067 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
5068 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
5069 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
5070 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
5071 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
5072 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
5073 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
5074 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
5075 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
5076 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
5077 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
5078 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
5079 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
5080 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
5081 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
5082 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
5083 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
5084 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
5085 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
5086 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
5087
5088
5089 Version 1.31.1 (2018-12-20)
5090 ===========================
5091
5092 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
5093 - [Fix broken go-to-definition in RLS][rls/1171]
5094 - [Fix infinite loop on hover in RLS][rls/1170]
5095
5096 [56562]: https://github.com/rust-lang/rust/pull/56562
5097 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
5098 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
5099
5100 Version 1.31.0 (2018-12-06)
5101 ==========================
5102
5103 Language
5104 --------
5105 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
5106 - [New lifetime elision rules now allow for eliding lifetimes in functions and
5107   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
5108   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
5109   in structs.
5110 - [You can now define and use `const` functions.][54835] These are currently
5111   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
5112   [language reference][const-reference] for what exactly is available.
5113 - [You can now use tool lints, which allow you to scope lints from external
5114   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
5115 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
5116   a crate, not just in exported functions.][54451]
5117 - [You can now use parentheses in pattern matches.][54497]
5118
5119 Compiler
5120 --------
5121 - [Updated musl to 1.1.20][54430]
5122
5123 Libraries
5124 ---------
5125 - [You can now convert `num::NonZero*` types to their raw equivalents using the
5126   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
5127 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
5128   into `Option<&mut T>` using the `From` trait.][53218]
5129 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
5130
5131
5132 Stabilized APIs
5133 ---------------
5134 - [`slice::align_to`]
5135 - [`slice::align_to_mut`]
5136 - [`slice::chunks_exact`]
5137 - [`slice::chunks_exact_mut`]
5138 - [`slice::rchunks`]
5139 - [`slice::rchunks_mut`]
5140 - [`slice::rchunks_exact`]
5141 - [`slice::rchunks_exact_mut`]
5142 - [`Option::replace`]
5143
5144 Cargo
5145 -----
5146 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
5147 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
5148   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
5149
5150 [52813]: https://github.com/rust-lang/rust/pull/52813/
5151 [53218]: https://github.com/rust-lang/rust/pull/53218/
5152 [54057]: https://github.com/rust-lang/rust/pull/54057/
5153 [54240]: https://github.com/rust-lang/rust/pull/54240/
5154 [54430]: https://github.com/rust-lang/rust/pull/54430/
5155 [54451]: https://github.com/rust-lang/rust/pull/54451/
5156 [54497]: https://github.com/rust-lang/rust/pull/54497/
5157 [54778]: https://github.com/rust-lang/rust/pull/54778/
5158 [54835]: https://github.com/rust-lang/rust/pull/54835/
5159 [54870]: https://github.com/rust-lang/rust/pull/54870/
5160 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
5161 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
5162 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
5163 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
5164 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
5165 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
5166 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
5167 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
5168 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
5169 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
5170 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
5171 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
5172 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
5173 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
5174
5175 Version 1.30.1 (2018-11-08)
5176 ===========================
5177
5178 - [Fixed overflow ICE in rustdoc][54199]
5179 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
5180
5181 [54199]: https://github.com/rust-lang/rust/pull/54199
5182 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
5183
5184 Version 1.30.0 (2018-10-25)
5185 ==========================
5186
5187 Language
5188 --------
5189 - [Procedural macros are now available.][52081] These kinds of macros allow for
5190   more powerful code generation. There is a [new chapter available][proc-macros]
5191   in the Rust Programming Language book that goes further in depth.
5192 - [You can now use keywords as identifiers using the raw identifiers
5193   syntax (`r#`),][53236] e.g. `let r#for = true;`
5194 - [Using anonymous parameters in traits is now deprecated with a warning and
5195   will be a hard error in the 2018 edition.][53272]
5196 - [You can now use `crate` in paths.][54404] This allows you to refer to the
5197   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
5198 - [Using a external crate no longer requires being prefixed with `::`.][54404]
5199   Previously, using a external crate in a module without a use statement
5200   required `let json = ::serde_json::from_str(foo);` but can now be written
5201   as `let json = serde_json::from_str(foo);`.
5202 - [You can now apply the `#[used]` attribute to static items to prevent the
5203   compiler from optimising them away, even if they appear to be unused,][51363]
5204   e.g. `#[used] static FOO: u32 = 1;`
5205 - [You can now import and reexport macros from other crates with the `use`
5206   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
5207   the root module of the crate. If your macro relies on calling other local
5208   macros, it is recommended to export with the
5209   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
5210   those macros.
5211 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
5212   using the `vis` specifier.][53370]
5213 - [Non-macro attributes now allow all forms of literals, not just
5214   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
5215   write `#[attr(true)]`.
5216 - [You can now specify a function to handle a panic in the Rust runtime with the
5217   `#[panic_handler]` attribute.][51366]
5218
5219 Compiler
5220 --------
5221 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
5222 - [Added the `aarch64-unknown-netbsd` target][53165]
5223 - [Upgraded to LLVM 8.][53611]
5224
5225 Libraries
5226 ---------
5227 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
5228
5229 Stabilized APIs
5230 ---------------
5231 - [`Ipv4Addr::BROADCAST`]
5232 - [`Ipv4Addr::LOCALHOST`]
5233 - [`Ipv4Addr::UNSPECIFIED`]
5234 - [`Ipv6Addr::LOCALHOST`]
5235 - [`Ipv6Addr::UNSPECIFIED`]
5236 - [`Iterator::find_map`]
5237
5238   The following methods are replacement methods for `trim_left`, `trim_right`,
5239   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
5240   in 1.33.0:
5241 - [`str::trim_end_matches`]
5242 - [`str::trim_end`]
5243 - [`str::trim_start_matches`]
5244 - [`str::trim_start`]
5245
5246 Cargo
5247 ----
5248 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
5249 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
5250   equivalent to calling `rustdoc --error-format=json`.
5251 - [Cargo will now provide a progress bar for builds.][cargo/5995]
5252
5253 Misc
5254 ----
5255 - [`rustdoc` allows you to specify what edition to treat your code as with the
5256   `--edition` option.][54057]
5257 - [`rustdoc` now has the `--color` (specify whether to output color) and
5258   `--error-format` (specify error format, e.g. `json`) options.][53003]
5259 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
5260   debug symbols.][53774]
5261 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
5262   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
5263
5264 [50911]: https://github.com/rust-lang/rust/pull/50911/
5265 [51363]: https://github.com/rust-lang/rust/pull/51363/
5266 [51366]: https://github.com/rust-lang/rust/pull/51366/
5267 [52081]: https://github.com/rust-lang/rust/pull/52081/
5268 [53003]: https://github.com/rust-lang/rust/pull/53003/
5269 [53033]: https://github.com/rust-lang/rust/pull/53033/
5270 [53044]: https://github.com/rust-lang/rust/pull/53044/
5271 [53165]: https://github.com/rust-lang/rust/pull/53165/
5272 [53611]: https://github.com/rust-lang/rust/pull/53611/
5273 [53236]: https://github.com/rust-lang/rust/pull/53236/
5274 [53272]: https://github.com/rust-lang/rust/pull/53272/
5275 [53370]: https://github.com/rust-lang/rust/pull/53370/
5276 [53459]: https://github.com/rust-lang/rust/pull/53459/
5277 [53774]: https://github.com/rust-lang/rust/pull/53774/
5278 [53822]: https://github.com/rust-lang/rust/pull/53822/
5279 [54057]: https://github.com/rust-lang/rust/pull/54057/
5280 [54404]: https://github.com/rust-lang/rust/pull/54404/
5281 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
5282 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
5283 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
5284 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
5285
5286 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
5287 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
5288 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
5289 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
5290 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
5291 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
5292 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
5293 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
5294 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
5295 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
5296
5297
5298 Version 1.29.2 (2018-10-11)
5299 ===========================
5300
5301 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
5302 - The `rls-preview` component on the windows-gnu targets has been restored.
5303
5304 [54639]: https://github.com/rust-lang/rust/pull/54639
5305
5306
5307 Version 1.29.1 (2018-09-25)
5308 ===========================
5309
5310 Security Notes
5311 --------------
5312
5313 - The standard library's `str::repeat` function contained an out of bounds write
5314   caused by an integer overflow. This has been fixed by deterministically
5315   panicking when an overflow happens.
5316
5317   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
5318   us.
5319
5320
5321 Version 1.29.0 (2018-09-13)
5322 ==========================
5323
5324 Compiler
5325 --------
5326 - [Bumped minimum LLVM version to 5.0.][51899]
5327 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
5328 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
5329 - [Upgraded to LLVM 7.][51966]
5330
5331 Libraries
5332 ---------
5333 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
5334 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
5335 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
5336 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
5337   for `&str`.][51178]
5338 - [`Cell<T>` now allows `T` to be unsized.][50494]
5339 - [`SocketAddr` is now stable on Redox.][52656]
5340
5341 Stabilized APIs
5342 ---------------
5343 - [`Arc::downcast`]
5344 - [`Iterator::flatten`]
5345 - [`Rc::downcast`]
5346
5347 Cargo
5348 -----
5349 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
5350   `--locked` to disable this behavior.
5351 - [`cargo-install` will now allow you to cross compile an install
5352   using `--target`.][cargo/5614]
5353 - [Added the `cargo-fix` subcommand to automatically move project code from
5354   2015 edition to 2018.][cargo/5723]
5355 - [`cargo doc` can now optionally document private types using the
5356   `--document-private-items` flag.][cargo/5543]
5357
5358 Misc
5359 ----
5360 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
5361   the specified level to that level.][52354] For example `--cap-lints warn`
5362   will demote `deny` and `forbid` lints to `warn`.
5363 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
5364   fails and `101` if there is a panic.][52197]
5365 - [A preview of clippy has been made available through rustup.][51122]
5366   You can install the preview with `rustup component add clippy-preview`.
5367
5368 Compatibility Notes
5369 -------------------
5370 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
5371   Use `str::get_unchecked(begin..end)` instead.
5372 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
5373   Consider using the `home_dir` function from
5374   https://crates.io/crates/dirs instead.
5375 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
5376 - [`cfg` attributes and `--cfg` command line flags are now more
5377   strictly validated.][53893]
5378
5379 [53893]: https://github.com/rust-lang/rust/pull/53893/
5380 [52861]: https://github.com/rust-lang/rust/pull/52861/
5381 [51966]: https://github.com/rust-lang/rust/pull/51966/
5382 [52656]: https://github.com/rust-lang/rust/pull/52656/
5383 [52239]: https://github.com/rust-lang/rust/pull/52239/
5384 [52330]: https://github.com/rust-lang/rust/pull/52330/
5385 [52354]: https://github.com/rust-lang/rust/pull/52354/
5386 [52402]: https://github.com/rust-lang/rust/pull/52402/
5387 [52197]: https://github.com/rust-lang/rust/pull/52197/
5388 [51807]: https://github.com/rust-lang/rust/pull/51807/
5389 [51899]: https://github.com/rust-lang/rust/pull/51899/
5390 [51912]: https://github.com/rust-lang/rust/pull/51912/
5391 [51619]: https://github.com/rust-lang/rust/pull/51619/
5392 [51656]: https://github.com/rust-lang/rust/pull/51656/
5393 [51178]: https://github.com/rust-lang/rust/pull/51178/
5394 [51122]: https://github.com/rust-lang/rust/pull/51122
5395 [50494]: https://github.com/rust-lang/rust/pull/50494/
5396 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
5397 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
5398 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
5399 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
5400 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
5401 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
5402 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
5403
5404
5405 Version 1.28.0 (2018-08-02)
5406 ===========================
5407
5408 Language
5409 --------
5410 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
5411   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
5412   the inner type across Foreign Function Interface (FFI) boundaries.
5413 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
5414   and can now be used as identifiers.][51196]
5415 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
5416   stable.][51241] This will allow users to specify a global allocator for
5417   their program.
5418 - [Unit test functions marked with the `#[test]` attribute can now return
5419   `Result<(), E: Debug>` in addition to `()`.][51298]
5420 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
5421   allows macros to easily target lifetimes.
5422
5423 Compiler
5424 --------
5425 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
5426   prioritise making smaller binary sizes. `z` is the same as `s` with the
5427   exception that it does not vectorise loops, which typically results in an even
5428   smaller binary.
5429 - [The short error format is now stable.][49546] Specified with
5430   `--error-format=short` this option will provide a more compressed output of
5431   rust error messages.
5432 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
5433 - [Reduced the number of allocations in the macro parser.][50855] This can
5434   improve compile times of macro heavy crates on average by 5%.
5435
5436 Libraries
5437 ---------
5438 - [Implemented `Default` for `&mut str`.][51306]
5439 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
5440 - [Implemented `Extend` for `()`.][50234]
5441 - [The `Debug` implementation of `time::Duration` should now be more easily
5442   human readable.][50364] Previously a `Duration` of one second would printed as
5443   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
5444 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
5445   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
5446   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
5447   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
5448   for `PathBuf`.][50170]
5449 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
5450   and `Wrapping<i128>`.][50465]
5451 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
5452   possible.][51050] This can provide up to a 40% speed increase.
5453 - [Improved error messages when using `format!`.][50610]
5454
5455 Stabilized APIs
5456 ---------------
5457 - [`Iterator::step_by`]
5458 - [`Path::ancestors`]
5459 - [`SystemTime::UNIX_EPOCH`]
5460 - [`alloc::GlobalAlloc`]
5461 - [`alloc::Layout`]
5462 - [`alloc::LayoutErr`]
5463 - [`alloc::System`]
5464 - [`alloc::alloc`]
5465 - [`alloc::alloc_zeroed`]
5466 - [`alloc::dealloc`]
5467 - [`alloc::realloc`]
5468 - [`alloc::handle_alloc_error`]
5469 - [`btree_map::Entry::or_default`]
5470 - [`fmt::Alignment`]
5471 - [`hash_map::Entry::or_default`]
5472 - [`iter::repeat_with`]
5473 - [`num::NonZeroUsize`]
5474 - [`num::NonZeroU128`]
5475 - [`num::NonZeroU16`]
5476 - [`num::NonZeroU32`]
5477 - [`num::NonZeroU64`]
5478 - [`num::NonZeroU8`]
5479 - [`ops::RangeBounds`]
5480 - [`slice::SliceIndex`]
5481 - [`slice::from_mut`]
5482 - [`slice::from_ref`]
5483 - [`{Any + Send + Sync}::downcast_mut`]
5484 - [`{Any + Send + Sync}::downcast_ref`]
5485 - [`{Any + Send + Sync}::is`]
5486
5487 Cargo
5488 -----
5489 - [Cargo will now no longer allow you to publish crates with build scripts that
5490   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
5491   considered to be immutable.
5492
5493 Misc
5494 ----
5495 - [The `suggestion_applicability` field in `rustc`'s json output is now
5496   stable.][50486] This will allow dev tools to check whether a code suggestion
5497   would apply to them.
5498
5499 Compatibility Notes
5500 -------------------
5501 - [Rust will consider trait objects with duplicated constraints to be the same
5502   type as without the duplicated constraint.][51276] For example the below code will
5503   now fail to compile.
5504   ```rust
5505   trait Trait {}
5506
5507   impl Trait + Send {
5508       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
5509   }
5510
5511   impl Trait + Send + Send {
5512       fn test(&self) { println!("two"); }
5513   }
5514   ```
5515
5516 [49546]: https://github.com/rust-lang/rust/pull/49546/
5517 [50143]: https://github.com/rust-lang/rust/pull/50143/
5518 [50170]: https://github.com/rust-lang/rust/pull/50170/
5519 [50234]: https://github.com/rust-lang/rust/pull/50234/
5520 [50265]: https://github.com/rust-lang/rust/pull/50265/
5521 [50364]: https://github.com/rust-lang/rust/pull/50364/
5522 [50385]: https://github.com/rust-lang/rust/pull/50385/
5523 [50465]: https://github.com/rust-lang/rust/pull/50465/
5524 [50486]: https://github.com/rust-lang/rust/pull/50486/
5525 [50554]: https://github.com/rust-lang/rust/pull/50554/
5526 [50610]: https://github.com/rust-lang/rust/pull/50610/
5527 [50855]: https://github.com/rust-lang/rust/pull/50855/
5528 [51050]: https://github.com/rust-lang/rust/pull/51050/
5529 [51196]: https://github.com/rust-lang/rust/pull/51196/
5530 [51241]: https://github.com/rust-lang/rust/pull/51241/
5531 [51276]: https://github.com/rust-lang/rust/pull/51276/
5532 [51298]: https://github.com/rust-lang/rust/pull/51298/
5533 [51306]: https://github.com/rust-lang/rust/pull/51306/
5534 [51562]: https://github.com/rust-lang/rust/pull/51562/
5535 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
5536 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
5537 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
5538 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
5539 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
5540 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
5541 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
5542 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
5543 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
5544 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
5545 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
5546 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
5547 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
5548 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
5549 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
5550 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
5551 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
5552 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
5553 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
5554 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
5555 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
5556 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
5557 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
5558 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
5559 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
5560 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
5561 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
5562 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
5563 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
5564 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
5565
5566 Version 1.27.2 (2018-07-20)
5567 ===========================
5568
5569 Compatibility Notes
5570 -------------------
5571
5572 - The borrow checker was fixed to avoid potential unsoundness when using
5573   match ergonomics: [#52213][52213].
5574
5575 [52213]: https://github.com/rust-lang/rust/issues/52213
5576
5577 Version 1.27.1 (2018-07-10)
5578 ===========================
5579
5580 Security Notes
5581 --------------
5582
5583 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
5584   when running, which enabled executing code as some other user on a
5585   given machine. This release fixes that vulnerability; you can read
5586   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
5587
5588   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
5589
5590 Compatibility Notes
5591 -------------------
5592
5593 - The borrow checker was fixed to avoid an additional potential unsoundness when using
5594   match ergonomics: [#51415][51415], [#49534][49534].
5595
5596 [51415]: https://github.com/rust-lang/rust/issues/51415
5597 [49534]: https://github.com/rust-lang/rust/issues/49534
5598 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
5599 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
5600
5601 Version 1.27.0 (2018-06-21)
5602 ==========================
5603
5604 Language
5605 --------
5606 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
5607   be used as an identifier.
5608 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
5609   bare `Trait` syntax, and should make it clearer when being used in tandem with
5610   `impl Trait` because it is equivalent to the following syntax:
5611   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
5612   `Box<Trait> == Box<dyn Trait>`.
5613 - [Attributes on generic parameters such as types and lifetimes are
5614   now stable.][48851] e.g.
5615   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
5616 - [The `#[must_use]` attribute can now also be used on functions as well as
5617   types.][48925] It provides a lint that by default warns users when the
5618   value returned by a function has not been used.
5619
5620 Compiler
5621 --------
5622 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
5623
5624 Libraries
5625 ---------
5626 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
5627   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
5628   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
5629   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
5630   the `cfg` attribute.
5631 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
5632   std are now available in core.][49896]
5633 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
5634   to `Self`.][49630]
5635 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
5636   that the operation isn't done in place.
5637 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
5638   the `#[must_use]` attribute][49533] to warn about unused potentially
5639   expensive allocations.
5640
5641 Stabilized APIs
5642 ---------------
5643 - [`DoubleEndedIterator::rfind`]
5644 - [`DoubleEndedIterator::rfold`]
5645 - [`DoubleEndedIterator::try_rfold`]
5646 - [`Duration::from_micros`]
5647 - [`Duration::from_nanos`]
5648 - [`Duration::subsec_micros`]
5649 - [`Duration::subsec_millis`]
5650 - [`HashMap::remove_entry`]
5651 - [`Iterator::try_fold`]
5652 - [`Iterator::try_for_each`]
5653 - [`NonNull::cast`]
5654 - [`Option::filter`]
5655 - [`String::replace_range`]
5656 - [`Take::set_limit`]
5657 - [`hint::unreachable_unchecked`]
5658 - [`os::unix::process::parent_id`]
5659 - [`ptr::swap_nonoverlapping`]
5660 - [`slice::rsplit_mut`]
5661 - [`slice::rsplit`]
5662 - [`slice::swap_with_slice`]
5663
5664 Cargo
5665 -----
5666 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
5667   `readme`, and `repository` fields.][cargo/5386]
5668 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
5669 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
5670   a different directory than `target` for placing compilation artifacts.
5671 - [Cargo will be adding automatic target inference for binaries, benchmarks,
5672   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
5673   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
5674   where cargo would infer a binary, Cargo will produce a warning. You can
5675   disable this feature ahead of time by setting any of the following to false:
5676   `autobins`, `autobenches`, `autoexamples`, `autotests`.
5677 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
5678   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
5679
5680 Misc
5681 ----
5682 - [Added “The Rustc book” into the official documentation.][49707]
5683   [“The Rustc book”] documents and teaches how to use the rustc compiler.
5684 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
5685
5686 Compatibility Notes
5687 -------------------
5688 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
5689   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
5690   compile, `"".is_empty()` will still compile.
5691 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
5692   will only print the inner type.][48553] E.g.
5693   `print!("{:?}", AtomicBool::new(true))` will print `true`,
5694   not `AtomicBool(true)`.
5695 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
5696   could enter higher numbers but they were not supported by LLVM. Up to 512MB
5697   alignment should cover all use cases.
5698 - The `.description()` method on the `std::error::Error` trait
5699   [has been soft-deprecated][50163]. It is no longer required to implement it.
5700
5701 [48553]: https://github.com/rust-lang/rust/pull/48553/
5702 [48851]: https://github.com/rust-lang/rust/pull/48851/
5703 [48925]: https://github.com/rust-lang/rust/pull/48925/
5704 [49533]: https://github.com/rust-lang/rust/pull/49533/
5705 [49623]: https://github.com/rust-lang/rust/pull/49623/
5706 [49630]: https://github.com/rust-lang/rust/pull/49630/
5707 [49664]: https://github.com/rust-lang/rust/pull/49664/
5708 [49699]: https://github.com/rust-lang/rust/pull/49699/
5709 [49707]: https://github.com/rust-lang/rust/pull/49707/
5710 [49896]: https://github.com/rust-lang/rust/pull/49896/
5711 [49968]: https://github.com/rust-lang/rust/pull/49968/
5712 [50163]: https://github.com/rust-lang/rust/pull/50163
5713 [50177]: https://github.com/rust-lang/rust/pull/50177/
5714 [50378]: https://github.com/rust-lang/rust/pull/50378/
5715 [50423]: https://github.com/rust-lang/rust/pull/50423/
5716 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
5717 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
5718 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
5719 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
5720 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
5721 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
5722 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
5723 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
5724 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
5725 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
5726 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
5727 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
5728 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
5729 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
5730 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
5731 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
5732 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
5733 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
5734 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
5735 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
5736 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
5737 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
5738 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
5739 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
5740 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
5741 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
5742 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
5743 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
5744 [“The Rustc book”]: https://doc.rust-lang.org/rustc
5745
5746
5747 Version 1.26.2 (2018-06-05)
5748 ==========================
5749
5750 Compatibility Notes
5751 -------------------
5752
5753 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
5754
5755 [51117]: https://github.com/rust-lang/rust/issues/51117
5756
5757
5758 Version 1.26.1 (2018-05-29)
5759 ==========================
5760
5761 Tools
5762 -----
5763
5764 - [RLS now works on Windows.][50646]
5765 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
5766
5767
5768 Compatibility Notes
5769 --------
5770
5771 - [`fn main() -> impl Trait` no longer works for non-Termination
5772   trait.][50656]
5773   This reverts an accidental stabilization.
5774 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
5775 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
5776
5777 [50646]: https://github.com/rust-lang/rust/issues/50646
5778 [50656]: https://github.com/rust-lang/rust/pull/50656
5779 [50812]: https://github.com/rust-lang/rust/pull/50812
5780 [50950]: https://github.com/rust-lang/rust/issues/50950
5781 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
5782
5783 Version 1.26.0 (2018-05-10)
5784 ==========================
5785
5786 Language
5787 --------
5788 - [Closures now implement `Copy` and/or `Clone` if all captured variables
5789   implement either or both traits.][49299]
5790 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
5791 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
5792   lifetime can be elided.][49458]
5793 - [`impl Trait` is now stable allowing you to have abstract types in returns
5794    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
5795   `fn open(path: impl AsRef<Path>)`.
5796 - [Pattern matching will now automatically apply dereferences.][49394]
5797 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
5798 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
5799 - [A lot of operations are now available in a const context.][46882] E.g. You
5800   can now index into constant arrays, reference and dereference into constants,
5801   and use tuple struct constructors.
5802 - [Fixed entry slice patterns are now stable.][48516] E.g.
5803   ```rust
5804   let points = [1, 2, 3, 4];
5805   match points {
5806       [1, 2, 3, 4] => println!("All points were sequential."),
5807       _ => println!("Not all points were sequential."),
5808   }
5809   ```
5810
5811
5812 Compiler
5813 --------
5814 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
5815 - [Fixed exponential projection complexity on nested types.][48296]
5816   This can provide up to a ~12% reduction in compile times for certain crates.
5817 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
5818   to remap path prefixes outputted by the compiler.
5819 - [Added `powerpc-unknown-netbsd` target.][48281]
5820
5821 Libraries
5822 ---------
5823 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
5824 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
5825   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
5826 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
5827 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
5828 - [`ascii::escape_default` is now available in libcore.][48735]
5829 - [Trailing commas are now supported in std and core macros.][48056]
5830 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
5831 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
5832
5833 Stabilized APIs
5834 ---------------
5835 - [`*const T::add`]
5836 - [`*const T::copy_to_nonoverlapping`]
5837 - [`*const T::copy_to`]
5838 - [`*const T::read_unaligned`]
5839 - [`*const T::read_volatile`]
5840 - [`*const T::read`]
5841 - [`*const T::sub`]
5842 - [`*const T::wrapping_add`]
5843 - [`*const T::wrapping_sub`]
5844 - [`*mut T::add`]
5845 - [`*mut T::copy_to_nonoverlapping`]
5846 - [`*mut T::copy_to`]
5847 - [`*mut T::read_unaligned`]
5848 - [`*mut T::read_volatile`]
5849 - [`*mut T::read`]
5850 - [`*mut T::replace`]
5851 - [`*mut T::sub`]
5852 - [`*mut T::swap`]
5853 - [`*mut T::wrapping_add`]
5854 - [`*mut T::wrapping_sub`]
5855 - [`*mut T::write_bytes`]
5856 - [`*mut T::write_unaligned`]
5857 - [`*mut T::write_volatile`]
5858 - [`*mut T::write`]
5859 - [`Box::leak`]
5860 - [`FromUtf8Error::as_bytes`]
5861 - [`LocalKey::try_with`]
5862 - [`Option::cloned`]
5863 - [`btree_map::Entry::and_modify`]
5864 - [`fs::read_to_string`]
5865 - [`fs::read`]
5866 - [`fs::write`]
5867 - [`hash_map::Entry::and_modify`]
5868 - [`iter::FusedIterator`]
5869 - [`ops::RangeInclusive`]
5870 - [`ops::RangeToInclusive`]
5871 - [`process::id`]
5872 - [`slice::rotate_left`]
5873 - [`slice::rotate_right`]
5874 - [`String::retain`]
5875
5876
5877 Cargo
5878 -----
5879 - [Cargo will now output path to custom commands when `-v` is
5880   passed with `--list`][cargo/5041]
5881 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
5882
5883 Misc
5884 ----
5885 - [The second edition of "The Rust Programming Language" book is now recommended
5886   over the first.][48404]
5887
5888 Compatibility Notes
5889 -------------------
5890
5891 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
5892   syntax is now invalid.
5893   ```
5894   use std::ops::Fn as dyn;
5895   fn g(_: Box<dyn(std::fmt::Debug)>) {}
5896   ```
5897 - [The result of dereferences are no longer promoted to `'static`.][47408]
5898   e.g.
5899   ```rust
5900   fn main() {
5901       const PAIR: &(i32, i32) = &(0, 1);
5902       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
5903   }
5904   ```
5905 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
5906 - [`".e0"` will now no longer parse as `0.0` and will instead cause
5907   an error.][48235]
5908 - [Removed hoedown from rustdoc.][48274]
5909 - [Bounds on higher-kinded lifetimes a hard error.][48326]
5910
5911 [46882]: https://github.com/rust-lang/rust/pull/46882
5912 [47379]: https://github.com/rust-lang/rust/pull/47379
5913 [47408]: https://github.com/rust-lang/rust/pull/47408
5914 [47813]: https://github.com/rust-lang/rust/pull/47813
5915 [48056]: https://github.com/rust-lang/rust/pull/48056
5916 [48125]: https://github.com/rust-lang/rust/pull/48125
5917 [48235]: https://github.com/rust-lang/rust/pull/48235
5918 [48274]: https://github.com/rust-lang/rust/pull/48274
5919 [48281]: https://github.com/rust-lang/rust/pull/48281
5920 [48296]: https://github.com/rust-lang/rust/pull/48296
5921 [48326]: https://github.com/rust-lang/rust/pull/48326
5922 [48359]: https://github.com/rust-lang/rust/pull/48359
5923 [48404]: https://github.com/rust-lang/rust/pull/48404
5924 [48481]: https://github.com/rust-lang/rust/pull/48481
5925 [48516]: https://github.com/rust-lang/rust/pull/48516
5926 [48628]: https://github.com/rust-lang/rust/pull/48628
5927 [48629]: https://github.com/rust-lang/rust/pull/48629
5928 [48657]: https://github.com/rust-lang/rust/pull/48657
5929 [48735]: https://github.com/rust-lang/rust/pull/48735
5930 [48978]: https://github.com/rust-lang/rust/pull/48978
5931 [49101]: https://github.com/rust-lang/rust/pull/49101
5932 [49109]: https://github.com/rust-lang/rust/pull/49109
5933 [49162]: https://github.com/rust-lang/rust/pull/49162
5934 [49255]: https://github.com/rust-lang/rust/pull/49255
5935 [49299]: https://github.com/rust-lang/rust/pull/49299
5936 [49305]: https://github.com/rust-lang/rust/pull/49305
5937 [49394]: https://github.com/rust-lang/rust/pull/49394
5938 [49458]: https://github.com/rust-lang/rust/pull/49458
5939 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
5940 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
5941 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
5942 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
5943 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
5944 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
5945 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
5946 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
5947 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
5948 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
5949 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
5950 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
5951 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
5952 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
5953 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
5954 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
5955 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
5956 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
5957 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
5958 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
5959 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
5960 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
5961 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
5962 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
5963 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
5964 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
5965 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
5966 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
5967 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
5968 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
5969 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
5970 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
5971 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
5972 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
5973 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
5974 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
5975 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
5976 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
5977 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
5978 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
5979 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
5980 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
5981
5982
5983 Version 1.25.0 (2018-03-29)
5984 ==========================
5985
5986 Language
5987 --------
5988 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
5989 - [You can now use nested groups of imports.][47948]
5990   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
5991 - [You can now have `|` at the start of a match arm.][47947] e.g.
5992 ```rust
5993 enum Foo { A, B, C }
5994
5995 fn main() {
5996     let x = Foo::A;
5997     match x {
5998         | Foo::A
5999         | Foo::B => println!("AB"),
6000         | Foo::C => println!("C"),
6001     }
6002 }
6003 ```
6004
6005 Compiler
6006 --------
6007 - [Upgraded to LLVM 6.][47828]
6008 - [Added `-C lto=val` option.][47521]
6009 - [Added `i586-unknown-linux-musl` target][47282]
6010
6011 Libraries
6012 ---------
6013 - [Impl Send for `process::Command` on Unix.][47760]
6014 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
6015 - [`UnsafeCell::into_inner` is now safe.][47204]
6016 - [Implement libstd for CloudABI.][47268]
6017 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
6018 - [Implement `AsRef<Path>` for Component][46985]
6019 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
6020 - [Moved `Duration` to libcore.][46666]
6021
6022 Stabilized APIs
6023 ---------------
6024 - [`Location::column`]
6025 - [`ptr::NonNull`]
6026
6027 The following functions can now be used in a constant expression.
6028 eg. `static MINUTE: Duration = Duration::from_secs(60);`
6029 - [`Duration::new`][47300]
6030 - [`Duration::from_secs`][47300]
6031 - [`Duration::from_millis`][47300]
6032
6033 Cargo
6034 -----
6035 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
6036 - [`cargo new` now defaults to creating a binary crate, instead of a
6037   library crate.][cargo/5029]
6038
6039 Misc
6040 ----
6041 - [Rust by example is now shipped with new releases][46196]
6042
6043 Compatibility Notes
6044 -------------------
6045 - [Deprecated `net::lookup_host`.][47510]
6046 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
6047 - The borrow checker was sometimes incorrectly permitting overlapping borrows
6048   around indexing operations (see [#47349][47349]). This has been fixed (which also
6049   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
6050 - [Removed deprecated unstable attribute `#[simd]`.][47251]
6051
6052 [33903]: https://github.com/rust-lang/rust/pull/33903
6053 [47947]: https://github.com/rust-lang/rust/pull/47947
6054 [47948]: https://github.com/rust-lang/rust/pull/47948
6055 [47760]: https://github.com/rust-lang/rust/pull/47760
6056 [47790]: https://github.com/rust-lang/rust/pull/47790
6057 [47828]: https://github.com/rust-lang/rust/pull/47828
6058 [47398]: https://github.com/rust-lang/rust/pull/47398
6059 [47510]: https://github.com/rust-lang/rust/pull/47510
6060 [47521]: https://github.com/rust-lang/rust/pull/47521
6061 [47204]: https://github.com/rust-lang/rust/pull/47204
6062 [47251]: https://github.com/rust-lang/rust/pull/47251
6063 [47268]: https://github.com/rust-lang/rust/pull/47268
6064 [47282]: https://github.com/rust-lang/rust/pull/47282
6065 [47300]: https://github.com/rust-lang/rust/pull/47300
6066 [47349]: https://github.com/rust-lang/rust/pull/47349
6067 [46931]: https://github.com/rust-lang/rust/pull/46931
6068 [46985]: https://github.com/rust-lang/rust/pull/46985
6069 [47006]: https://github.com/rust-lang/rust/pull/47006
6070 [46830]: https://github.com/rust-lang/rust/pull/46830
6071 [46095]: https://github.com/rust-lang/rust/pull/46095
6072 [46666]: https://github.com/rust-lang/rust/pull/46666
6073 [46196]: https://github.com/rust-lang/rust/pull/46196
6074 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
6075 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
6076 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
6077 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
6078 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
6079
6080
6081 Version 1.24.1 (2018-03-01)
6082 ==========================
6083
6084  - [Do not abort when unwinding through FFI][48251]
6085  - [Emit UTF-16 files for linker arguments on Windows][48318]
6086  - [Make the error index generator work again][48308]
6087  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
6088
6089 [48251]: https://github.com/rust-lang/rust/issues/48251
6090 [48308]: https://github.com/rust-lang/rust/issues/48308
6091 [48318]: https://github.com/rust-lang/rust/issues/48318
6092 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
6093
6094
6095 Version 1.24.0 (2018-02-15)
6096 ==========================
6097
6098 Language
6099 --------
6100 - [External `sysv64` ffi is now available.][46528]
6101   eg. `extern "sysv64" fn foo () {}`
6102
6103 Compiler
6104 --------
6105 - [rustc now uses 16 codegen units by default for release builds.][46910]
6106   For the fastest builds, utilize `codegen-units=1`.
6107 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
6108 - [Add `aarch64-unknown-openbsd` support][46760]
6109
6110 Libraries
6111 ---------
6112 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
6113   improvement in performance in the majority of cases.
6114 - [`OsStr`'s `Debug` implementation is now lossless and consistent
6115   with Windows.][46798]
6116 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
6117 - [impl `From<bool>` for `AtomicBool`][46293]
6118 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
6119 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
6120 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
6121 - [float::from_bits now just uses transmute.][46012] This provides
6122   some optimisations from LLVM.
6123 - [Copied `AsciiExt` methods onto `char`][46077]
6124 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
6125 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
6126 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
6127 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
6128
6129 Stabilized APIs
6130 ---------------
6131 - [`RefCell::replace`]
6132 - [`RefCell::swap`]
6133 - [`atomic::spin_loop_hint`]
6134
6135 The following functions can now be used in a constant expression.
6136 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
6137
6138 - [`AtomicBool::new`][46287]
6139 - [`AtomicUsize::new`][46287]
6140 - [`AtomicIsize::new`][46287]
6141 - [`AtomicPtr::new`][46287]
6142 - [`Cell::new`][46287]
6143 - [`{integer}::min_value`][46287]
6144 - [`{integer}::max_value`][46287]
6145 - [`mem::size_of`][46287]
6146 - [`mem::align_of`][46287]
6147 - [`ptr::null`][46287]
6148 - [`ptr::null_mut`][46287]
6149 - [`RefCell::new`][46287]
6150 - [`UnsafeCell::new`][46287]
6151
6152 Cargo
6153 -----
6154 - [Added a `workspace.default-members` config that
6155   overrides implied `--all` in virtual workspaces.][cargo/4743]
6156 - [Enable incremental by default on development builds.][cargo/4817] Also added
6157   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
6158   per-project or global basis respectively.
6159
6160 Misc
6161 ----
6162
6163 Compatibility Notes
6164 -------------------
6165 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
6166 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
6167   in accordance with IETF RFC 4291 §2.2.
6168 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
6169 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
6170   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
6171 - [Leading zeros in tuple struct members is now an error][47084]
6172 - [`column!()` macro is one-based instead of zero-based][46977]
6173 - [`fmt::Arguments` can no longer be shared across threads][45198]
6174 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
6175 - [Cargo sets a different working directory for the compiler][cargo/4788]
6176
6177 [44884]: https://github.com/rust-lang/rust/pull/44884
6178 [45198]: https://github.com/rust-lang/rust/pull/45198
6179 [45506]: https://github.com/rust-lang/rust/pull/45506
6180 [45990]: https://github.com/rust-lang/rust/pull/45990
6181 [46012]: https://github.com/rust-lang/rust/pull/46012
6182 [46077]: https://github.com/rust-lang/rust/pull/46077
6183 [46094]: https://github.com/rust-lang/rust/pull/46094
6184 [46284]: https://github.com/rust-lang/rust/pull/46284
6185 [46287]: https://github.com/rust-lang/rust/pull/46287
6186 [46293]: https://github.com/rust-lang/rust/pull/46293
6187 [46528]: https://github.com/rust-lang/rust/pull/46528
6188 [46671]: https://github.com/rust-lang/rust/pull/46671
6189 [46713]: https://github.com/rust-lang/rust/pull/46713
6190 [46735]: https://github.com/rust-lang/rust/pull/46735
6191 [46760]: https://github.com/rust-lang/rust/pull/46760
6192 [46798]: https://github.com/rust-lang/rust/pull/46798
6193 [46828]: https://github.com/rust-lang/rust/pull/46828
6194 [46831]: https://github.com/rust-lang/rust/pull/46831
6195 [46833]: https://github.com/rust-lang/rust/pull/46833
6196 [46910]: https://github.com/rust-lang/rust/pull/46910
6197 [46977]: https://github.com/rust-lang/rust/pull/46977
6198 [47018]: https://github.com/rust-lang/rust/pull/47018
6199 [47080]: https://github.com/rust-lang/rust/pull/47080
6200 [47084]: https://github.com/rust-lang/rust/pull/47084
6201 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
6202 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
6203 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
6204 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
6205 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
6206 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
6207
6208
6209 Version 1.23.0 (2018-01-04)
6210 ==========================
6211
6212 Language
6213 --------
6214 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
6215 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
6216   Which should fix some confusing errors in some operations.
6217
6218 Compiler
6219 --------
6220 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
6221   undefined behavior.][45920]
6222 - [rustc now suggests renaming import if names clash.][45660]
6223 - [Display errors/warnings correctly when there are zero-width or
6224   wide characters.][45711]
6225 - [rustc now avoids unnecessary copies of arguments that are
6226   simple bindings][45380] This should improve memory usage on average by 5-10%.
6227 - [Updated musl used to build musl rustc to 1.1.17][45393]
6228
6229 Libraries
6230 ---------
6231 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
6232 - [Implement Hash for raw pointers to unsized types][45483]
6233 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
6234 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
6235 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
6236 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
6237   and `<*mut T>::as_mut`][44932]
6238 - [Optimized `Thread::{park, unpark}` implementation][45524]
6239 - [Improved `SliceExt::binary_search` performance.][45333]
6240 - [impl `FromIterator<()>` for `()`][45379]
6241 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
6242   is now deprecated.
6243
6244 Stabilized APIs
6245 ---------------
6246
6247 Cargo
6248 -----
6249 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
6250   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
6251 - [Added unit test checking to `cargo check`][cargo/4592]
6252 - [Cargo now lets you install a specific version
6253   using `cargo install --version`][cargo/4637]
6254
6255 Misc
6256 ----
6257 - [Releases now ship with the Cargo book documentation.][45692]
6258 - [rustdoc now prints rendering warnings on every run.][45324]
6259
6260 Compatibility Notes
6261 -------------------
6262 - [Changes have been made to type equality to make it more correct,
6263   in rare cases this could break some code.][45853] [Tracking issue for
6264   further information][45852]
6265 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
6266 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
6267   Android 9, the minimum supported version is Android 14.
6268 - [Bumped the minimum LLVM to 3.9][45326]
6269
6270 [44042]: https://github.com/rust-lang/rust/pull/44042
6271 [44932]: https://github.com/rust-lang/rust/pull/44932
6272 [45267]: https://github.com/rust-lang/rust/pull/45267
6273 [45324]: https://github.com/rust-lang/rust/pull/45324
6274 [45326]: https://github.com/rust-lang/rust/pull/45326
6275 [45333]: https://github.com/rust-lang/rust/pull/45333
6276 [45379]: https://github.com/rust-lang/rust/pull/45379
6277 [45380]: https://github.com/rust-lang/rust/pull/45380
6278 [45393]: https://github.com/rust-lang/rust/pull/45393
6279 [45435]: https://github.com/rust-lang/rust/pull/45435
6280 [45483]: https://github.com/rust-lang/rust/pull/45483
6281 [45524]: https://github.com/rust-lang/rust/pull/45524
6282 [45571]: https://github.com/rust-lang/rust/pull/45571
6283 [45580]: https://github.com/rust-lang/rust/pull/45580
6284 [45610]: https://github.com/rust-lang/rust/pull/45610
6285 [45660]: https://github.com/rust-lang/rust/pull/45660
6286 [45692]: https://github.com/rust-lang/rust/pull/45692
6287 [45711]: https://github.com/rust-lang/rust/pull/45711
6288 [45772]: https://github.com/rust-lang/rust/pull/45772
6289 [45852]: https://github.com/rust-lang/rust/issues/45852
6290 [45853]: https://github.com/rust-lang/rust/pull/45853
6291 [45887]: https://github.com/rust-lang/rust/pull/45887
6292 [45920]: https://github.com/rust-lang/rust/pull/45920
6293 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
6294 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
6295 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
6296
6297
6298 Version 1.22.1 (2017-11-22)
6299 ==========================
6300
6301 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
6302
6303 [46183]: https://github.com/rust-lang/rust/pull/46183
6304
6305 Version 1.22.0 (2017-11-22)
6306 ==========================
6307
6308 Language
6309 --------
6310 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
6311 - [Now accepts underscores in unicode escapes][43716]
6312 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
6313 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
6314
6315 Compiler
6316 --------
6317 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
6318 - [rustc will no longer inline in codegen units when compiling for debug][45075]
6319   This should decrease compile times for debug builds.
6320 - [strict memory alignment now enabled on ARMv6][45094]
6321 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
6322
6323 Libraries
6324 ---------
6325 - [Allow atomic operations up to 32 bits
6326   on `armv5te_unknown_linux_gnueabi`][44978]
6327 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
6328 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
6329 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
6330 - [Properly detect overflow in `Instant += Duration`.][44220]
6331 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
6332 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
6333 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
6334
6335 Stabilized APIs
6336 ---------------
6337
6338 Cargo
6339 -----
6340 - [Cargo will now build multi file examples in subdirectories of the `examples`
6341   folder that have a `main.rs` file.][cargo/4496]
6342 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
6343   the old format will continue to work and can be updated with `cargo update`.
6344 - [Now supports vendoring git repositories][cargo/3992]
6345
6346 Misc
6347 ----
6348 - [`libbacktrace` is now available on Apple platforms.][44251]
6349 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
6350   This now lets you specify that a given code example will fail to compile.
6351
6352 Compatibility Notes
6353 -------------------
6354 - [The minimum Android version that rustc can build for has been bumped
6355   to `4.0` from `2.3`][45656]
6356 - [Allowing `T op= &T` for numeric types has broken some type
6357   inference cases][45480]
6358
6359
6360 [42526]: https://github.com/rust-lang/rust/pull/42526
6361 [43716]: https://github.com/rust-lang/rust/pull/43716
6362 [43949]: https://github.com/rust-lang/rust/pull/43949
6363 [44015]: https://github.com/rust-lang/rust/pull/44015
6364 [44220]: https://github.com/rust-lang/rust/pull/44220
6365 [44251]: https://github.com/rust-lang/rust/pull/44251
6366 [44287]: https://github.com/rust-lang/rust/pull/44287
6367 [44303]: https://github.com/rust-lang/rust/pull/44303
6368 [44456]: https://github.com/rust-lang/rust/pull/44456
6369 [44466]: https://github.com/rust-lang/rust/pull/44466
6370 [44895]: https://github.com/rust-lang/rust/pull/44895
6371 [44966]: https://github.com/rust-lang/rust/pull/44966
6372 [44978]: https://github.com/rust-lang/rust/pull/44978
6373 [45041]: https://github.com/rust-lang/rust/pull/45041
6374 [45064]: https://github.com/rust-lang/rust/pull/45064
6375 [45075]: https://github.com/rust-lang/rust/pull/45075
6376 [45094]: https://github.com/rust-lang/rust/pull/45094
6377 [45095]: https://github.com/rust-lang/rust/pull/45095
6378 [45480]: https://github.com/rust-lang/rust/issues/45480
6379 [45656]: https://github.com/rust-lang/rust/pull/45656
6380 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
6381 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
6382 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
6383
6384
6385
6386
6387
6388
6389 Version 1.21.0 (2017-10-12)
6390 ==========================
6391
6392 Language
6393 --------
6394 - [You can now use static references for literals.][43838]
6395   Example:
6396   ```rust
6397   fn main() {
6398       let x: &'static u32 = &0;
6399   }
6400   ```
6401 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
6402   Example:
6403   ```rust
6404   my_macro!(Vec<i32>::new); // Always worked
6405   my_macro!(Vec::<i32>::new); // Now works
6406   ```
6407
6408 Compiler
6409 --------
6410 - [Upgraded jemalloc to 4.5.0][43911]
6411 - [Enabled unwinding panics on Redox][43917]
6412 - [Now runs LLVM in parallel during translation phase.][43506]
6413   This should reduce peak memory usage.
6414
6415 Libraries
6416 ---------
6417 - [Generate builtin impls for `Clone` for all arrays and tuples that
6418   are `T: Clone`][43690]
6419 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
6420 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
6421   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
6422
6423 Stabilized APIs
6424 ---------------
6425
6426 [`std::mem::discriminant`]
6427
6428 Cargo
6429 -----
6430 - [You can now call `cargo install` with multiple package names][cargo/4216]
6431 - [Cargo commands inside a virtual workspace will now implicitly
6432   pass `--all`][cargo/4335]
6433 - [Added a `[patch]` section to `Cargo.toml` to handle
6434   prepublication dependencies][cargo/4123] [RFC 1969]
6435 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
6436   like patterns][cargo/4270]
6437 - [Added the `--all-targets` option][cargo/4400]
6438 - [Using required dependencies as a feature is now deprecated and emits
6439   a warning][cargo/4364]
6440
6441
6442 Misc
6443 ----
6444 - [Cargo docs are moving][43916]
6445   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
6446 - [The rustdoc book is now available][43863]
6447   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
6448 - [Added a preview of RLS has been made available through rustup][44204]
6449   Install with `rustup component add rls-preview`
6450 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
6451   Previously only showed `std::os::unix`.
6452
6453 Compatibility Notes
6454 -------------------
6455 - [Changes in method matching against higher-ranked types][43880] This may cause
6456   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
6457 - [rustc's JSON error output's byte position start at top of file.][42973]
6458   Was previously relative to the rustc's internal `CodeMap` struct which
6459   required the unstable library `libsyntax` to correctly use.
6460 - [`unused_results` lint no longer ignores booleans][43728]
6461
6462 [42565]: https://github.com/rust-lang/rust/pull/42565
6463 [42973]: https://github.com/rust-lang/rust/pull/42973
6464 [43348]: https://github.com/rust-lang/rust/pull/43348
6465 [43459]: https://github.com/rust-lang/rust/pull/43459
6466 [43506]: https://github.com/rust-lang/rust/pull/43506
6467 [43540]: https://github.com/rust-lang/rust/pull/43540
6468 [43690]: https://github.com/rust-lang/rust/pull/43690
6469 [43728]: https://github.com/rust-lang/rust/pull/43728
6470 [43838]: https://github.com/rust-lang/rust/pull/43838
6471 [43863]: https://github.com/rust-lang/rust/pull/43863
6472 [43880]: https://github.com/rust-lang/rust/pull/43880
6473 [43911]: https://github.com/rust-lang/rust/pull/43911
6474 [43916]: https://github.com/rust-lang/rust/pull/43916
6475 [43917]: https://github.com/rust-lang/rust/pull/43917
6476 [44204]: https://github.com/rust-lang/rust/pull/44204
6477 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
6478 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
6479 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
6480 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
6481 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
6482 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
6483 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
6484 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
6485 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
6486
6487 Version 1.20.0 (2017-08-31)
6488 ===========================
6489
6490 Language
6491 --------
6492 - [Associated constants are now stabilised.][42809]
6493 - [A lot of macro bugs are now fixed.][42913]
6494
6495 Compiler
6496 --------
6497
6498 - [Struct fields are now properly coerced to the expected field type.][42807]
6499 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
6500   `wasm32-experimental-emscripten` target.
6501 - [Changed some of the error messages to be more helpful.][42033]
6502 - [Add support for RELRO(RELocation Read-Only) for platforms that support
6503   it.][43170]
6504 - [rustc now reports the total number of errors on compilation failure][43015]
6505   previously this was only the number of errors in the pass that failed.
6506 - [Expansion in rustc has been sped up 29x.][42533]
6507 - [added `msp430-none-elf` target.][43099]
6508 - [rustc will now suggest one-argument enum variant to fix type mismatch when
6509   applicable][43178]
6510 - [Fixes backtraces on Redox][43228]
6511 - [rustc now identifies different versions of same crate when absolute paths of
6512   different types match in an error message.][42826]
6513
6514 Libraries
6515 ---------
6516
6517
6518 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
6519 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
6520   tuples.][43011]
6521 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
6522   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
6523 - [Impl `Clone` for `DefaultHasher`.][42799]
6524 - [Impl `Sync` for `SyncSender`.][42397]
6525 - [Impl `FromStr` for `char`][42271]
6526 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
6527   NaN.][42431]
6528 - [allow messages in the `unimplemented!()` macro.][42155]
6529   ie. `unimplemented!("Waiting for 1.21 to be stable")`
6530 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
6531 - [Upgrade to Unicode 10.0.0][42999]
6532 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
6533 - [Skip the main thread's manual stack guard on Linux][43072]
6534 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in *O*(1) time][43077]
6535 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
6536   previously 2^15.
6537 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
6538
6539 Stabilized APIs
6540 ---------------
6541
6542 - [`CStr::into_c_string`]
6543 - [`CString::as_c_str`]
6544 - [`CString::into_boxed_c_str`]
6545 - [`Chain::get_mut`]
6546 - [`Chain::get_ref`]
6547 - [`Chain::into_inner`]
6548 - [`Option::get_or_insert_with`]
6549 - [`Option::get_or_insert`]
6550 - [`OsStr::into_os_string`]
6551 - [`OsString::into_boxed_os_str`]
6552 - [`Take::get_mut`]
6553 - [`Take::get_ref`]
6554 - [`Utf8Error::error_len`]
6555 - [`char::EscapeDebug`]
6556 - [`char::escape_debug`]
6557 - [`compile_error!`]
6558 - [`f32::from_bits`]
6559 - [`f32::to_bits`]
6560 - [`f64::from_bits`]
6561 - [`f64::to_bits`]
6562 - [`mem::ManuallyDrop`]
6563 - [`slice::sort_unstable_by_key`]
6564 - [`slice::sort_unstable_by`]
6565 - [`slice::sort_unstable`]
6566 - [`str::from_boxed_utf8_unchecked`]
6567 - [`str::as_bytes_mut`]
6568 - [`str::as_bytes_mut`]
6569 - [`str::from_utf8_mut`]
6570 - [`str::from_utf8_unchecked_mut`]
6571 - [`str::get_mut`]
6572 - [`str::get_unchecked_mut`]
6573 - [`str::get_unchecked`]
6574 - [`str::get`]
6575 - [`str::into_boxed_bytes`]
6576
6577
6578 Cargo
6579 -----
6580 - [Cargo API token location moved from `~/.cargo/config` to
6581   `~/.cargo/credentials`.][cargo/3978]
6582 - [Cargo will now build `main.rs` binaries that are in sub-directories of
6583   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
6584   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
6585 - [You can now specify version of a binary when installed through
6586   `cargo install` using `--vers`.][cargo/4229]
6587 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
6588   failure.][cargo/4248]
6589 - [Changed the convention around which file is the crate root.][cargo/4259]
6590
6591 Compatibility Notes
6592 -------------------
6593
6594 - [Functions with `'static` in their return types will now not be as usable as
6595   if they were using lifetime parameters instead.][42417]
6596 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
6597   takes the sign of NaN into account where previously didn't.][42430]
6598
6599 [42033]: https://github.com/rust-lang/rust/pull/42033
6600 [42155]: https://github.com/rust-lang/rust/pull/42155
6601 [42271]: https://github.com/rust-lang/rust/pull/42271
6602 [42397]: https://github.com/rust-lang/rust/pull/42397
6603 [42417]: https://github.com/rust-lang/rust/pull/42417
6604 [42430]: https://github.com/rust-lang/rust/pull/42430
6605 [42431]: https://github.com/rust-lang/rust/pull/42431
6606 [42533]: https://github.com/rust-lang/rust/pull/42533
6607 [42571]: https://github.com/rust-lang/rust/pull/42571
6608 [42613]: https://github.com/rust-lang/rust/pull/42613
6609 [42799]: https://github.com/rust-lang/rust/pull/42799
6610 [42807]: https://github.com/rust-lang/rust/pull/42807
6611 [42809]: https://github.com/rust-lang/rust/pull/42809
6612 [42822]: https://github.com/rust-lang/rust/pull/42822
6613 [42826]: https://github.com/rust-lang/rust/pull/42826
6614 [42854]: https://github.com/rust-lang/rust/pull/42854
6615 [42913]: https://github.com/rust-lang/rust/pull/42913
6616 [42999]: https://github.com/rust-lang/rust/pull/42999
6617 [43011]: https://github.com/rust-lang/rust/pull/43011
6618 [43015]: https://github.com/rust-lang/rust/pull/43015
6619 [43072]: https://github.com/rust-lang/rust/pull/43072
6620 [43077]: https://github.com/rust-lang/rust/pull/43077
6621 [43097]: https://github.com/rust-lang/rust/pull/43097
6622 [43099]: https://github.com/rust-lang/rust/pull/43099
6623 [43170]: https://github.com/rust-lang/rust/pull/43170
6624 [43178]: https://github.com/rust-lang/rust/pull/43178
6625 [43185]: https://github.com/rust-lang/rust/pull/43185
6626 [43228]: https://github.com/rust-lang/rust/pull/43228
6627 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
6628 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
6629 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
6630 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
6631 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
6632 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
6633 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
6634 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
6635 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
6636 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
6637 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
6638 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
6639 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
6640 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
6641 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
6642 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
6643 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
6644 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
6645 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
6646 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
6647 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
6648 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
6649 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
6650 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
6651 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
6652 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
6653 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
6654 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
6655 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
6656 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
6657 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
6658 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
6659 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
6660 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
6661 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
6662 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
6663 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
6664 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
6665
6666
6667 Version 1.19.0 (2017-07-20)
6668 ===========================
6669
6670 Language
6671 --------
6672
6673 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
6674   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
6675 - [Macro recursion limit increased to 1024 from 64.][41676]
6676 - [Added lint for detecting unused macros.][41907]
6677 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
6678   For example: `let x = loop { break 7; };`
6679 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
6680   contain `Copy` types and cannot have a `Drop` implementation.
6681   Example: `union Foo { bar: u8, baz: usize }`
6682 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
6683   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
6684
6685 Compiler
6686 --------
6687
6688 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
6689 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
6690   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
6691   you should use `--target armv7-linux-androideabi`.
6692 - [Fixed ICE when removing a source file between compilation sessions.][41873]
6693 - [Minor optimisation of string operations.][42037]
6694 - [Compiler error message is now `aborting due to previous error(s)` instead of
6695   `aborting due to N previous errors`][42150] This was previously inaccurate and
6696   would only count certain kinds of errors.
6697 - [The compiler now supports Visual Studio 2017][42225]
6698 - [The compiler is now built against LLVM 4.0.1 by default][42948]
6699 - [Added a lot][42264] of [new error codes][42302]
6700 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
6701   libraries with C Run-time Libraries(CRT) to be statically linked.
6702 - [Fixed various ARM codegen bugs][42740]
6703
6704 Libraries
6705 ---------
6706
6707 - [`String` now implements `FromIterator<Cow<'a, str>>` and
6708   `Extend<Cow<'a, str>>`][41449]
6709 - [`Vec` now implements `From<&mut [T]>`][41530]
6710 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
6711 - [`SplitWhitespace` now implements `Clone`][41659]
6712 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
6713   1.5x faster][41764]
6714 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
6715   macros, but for printing to stderr.
6716
6717 Stabilized APIs
6718 ---------------
6719
6720 - [`OsString::shrink_to_fit`]
6721 - [`cmp::Reverse`]
6722 - [`Command::envs`]
6723 - [`thread::ThreadId`]
6724
6725 Cargo
6726 -----
6727
6728 - [Build scripts can now add environment variables to the environment
6729   the crate is being compiled in.
6730   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
6731 - [Subcommands now replace the current process rather than spawning a new
6732   child process][cargo/3970]
6733 - [Workspace members can now accept glob file patterns][cargo/3979]
6734 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
6735   the members in a given workspace.][cargo/3988]
6736 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
6737 - [Target directory path is now in the cargo metadata][cargo/4022]
6738 - [Cargo no longer checks out a local working directory for the
6739   crates.io index][cargo/4026] This should provide smaller file size for the
6740   registry, and improve cloning times, especially on Windows machines.
6741 - [Added an `--exclude` option for excluding certain packages when using the
6742   `--all` option][cargo/4031]
6743 - [Cargo will now automatically retry when receiving a 5xx error
6744   from crates.io][cargo/4032]
6745 - [The `--features` option now accepts multiple comma or space
6746   delimited values.][cargo/4084]
6747 - [Added support for custom target specific runners][cargo/3954]
6748
6749 Misc
6750 ----
6751
6752 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
6753   Windows Debugger.
6754 - [Rust will now release XZ compressed packages][rust-installer/57]
6755 - [rustup will now prefer to download rust packages with
6756   XZ compression][rustup/1100] over GZip packages.
6757 - [Added the ability to escape `#` in rust documentation][41785] By adding
6758   additional `#`'s ie. `##` is now `#`
6759
6760 Compatibility Notes
6761 -------------------
6762
6763 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
6764 - [`-Z` flags are now no longer allowed to be used on the stable
6765   compiler.][41751] This has been a warning for a year previous to this.
6766 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
6767   longer works][42844]. Users should migrate to the built-in `check`
6768   command, which has been available since 1.16.
6769 - [Ending a float literal with `._` is now a hard error.
6770   Example: `42._` .][41946]
6771 - [Any use of a private `extern crate` outside of its module is now a
6772   hard error.][36886] This was previously a warning.
6773 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
6774   relative while the `::` prefix makes a path absolute, but was ignored and the
6775   path was relative regardless.
6776 - [Floating point constants in match patterns is now a hard error][36890]
6777   This was previously a warning.
6778 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
6779   match patterns is now a hard error][36891] This was previously a warning.
6780 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
6781   a warning.
6782 - [From the pound escape, lines consisting of multiple `#`s are
6783   now visible][41785]
6784 - [It is an error to re-export private enum variants][42460]. This is
6785   known to break a number of crates that depend on an older version of
6786   mustache.
6787 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
6788   to use it to find the linker, and the build will fail where it did
6789   not previously][42607]
6790
6791 [36886]: https://github.com/rust-lang/rust/issues/36886
6792 [36888]: https://github.com/rust-lang/rust/issues/36888
6793 [36890]: https://github.com/rust-lang/rust/issues/36890
6794 [36891]: https://github.com/rust-lang/rust/issues/36891
6795 [36892]: https://github.com/rust-lang/rust/issues/36892
6796 [37406]: https://github.com/rust-lang/rust/issues/37406
6797 [39983]: https://github.com/rust-lang/rust/pull/39983
6798 [41145]: https://github.com/rust-lang/rust/pull/41145
6799 [41192]: https://github.com/rust-lang/rust/pull/41192
6800 [41258]: https://github.com/rust-lang/rust/pull/41258
6801 [41370]: https://github.com/rust-lang/rust/pull/41370
6802 [41449]: https://github.com/rust-lang/rust/pull/41449
6803 [41530]: https://github.com/rust-lang/rust/pull/41530
6804 [41624]: https://github.com/rust-lang/rust/pull/41624
6805 [41656]: https://github.com/rust-lang/rust/pull/41656
6806 [41659]: https://github.com/rust-lang/rust/pull/41659
6807 [41676]: https://github.com/rust-lang/rust/pull/41676
6808 [41751]: https://github.com/rust-lang/rust/pull/41751
6809 [41764]: https://github.com/rust-lang/rust/pull/41764
6810 [41785]: https://github.com/rust-lang/rust/pull/41785
6811 [41873]: https://github.com/rust-lang/rust/pull/41873
6812 [41907]: https://github.com/rust-lang/rust/pull/41907
6813 [41946]: https://github.com/rust-lang/rust/pull/41946
6814 [42016]: https://github.com/rust-lang/rust/pull/42016
6815 [42037]: https://github.com/rust-lang/rust/pull/42037
6816 [42068]: https://github.com/rust-lang/rust/pull/42068
6817 [42150]: https://github.com/rust-lang/rust/pull/42150
6818 [42162]: https://github.com/rust-lang/rust/pull/42162
6819 [42225]: https://github.com/rust-lang/rust/pull/42225
6820 [42264]: https://github.com/rust-lang/rust/pull/42264
6821 [42302]: https://github.com/rust-lang/rust/pull/42302
6822 [42460]: https://github.com/rust-lang/rust/issues/42460
6823 [42607]: https://github.com/rust-lang/rust/issues/42607
6824 [42740]: https://github.com/rust-lang/rust/pull/42740
6825 [42844]: https://github.com/rust-lang/rust/issues/42844
6826 [42948]: https://github.com/rust-lang/rust/pull/42948
6827 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
6828 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
6829 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
6830 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
6831 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
6832 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
6833 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
6834 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
6835 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
6836 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
6837 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
6838 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
6839 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
6840 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
6841 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
6842 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
6843 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
6844 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
6845 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
6846 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
6847 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
6848 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
6849
6850
6851 Version 1.18.0 (2017-06-08)
6852 ===========================
6853
6854 Language
6855 --------
6856
6857 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
6858   make the item visible to just that module tree. Also accepts the keyword
6859   `crate` to make something public to the whole crate but not users of the
6860   library. Example: `pub(crate) mod utils;`. [RFC 1422].
6861 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
6862   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
6863 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
6864   types like `Write + Send`, trailing `+` are now supported in trait objects,
6865   and better error reporting for trait objects starting with `?Sized`.
6866 - [0e+10 is now a valid floating point literal][40589]
6867 - [Now warns if you bind a lifetime parameter to 'static][40734]
6868 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
6869   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
6870   representation in some cases.][40377]
6871
6872 Compiler
6873 --------
6874
6875 - [rustc can now emit mir with `--emit mir`][39891]
6876 - [Improved LLVM IR for trivial functions][40367]
6877 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
6878 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
6879   opportunities found through profiling
6880 - [Improved backtrace formatting when panicking][38165]
6881
6882 Libraries
6883 ---------
6884
6885 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
6886   iterator hasn't been advanced the original `Vec` is reassembled with no actual
6887   iteration or reallocation.
6888 - [Simplified HashMap Bucket interface][40561] provides performance
6889   improvements for iterating and cloning.
6890 - [Specialize Vec::from_elem to use calloc][40409]
6891 - [Fixed Race condition in fs::create_dir_all][39799]
6892 - [No longer caching stdio on Windows][40516]
6893 - [Optimized insertion sort in slice][40807] insertion sort in some cases
6894   2.50%~ faster and in one case now 12.50% faster.
6895 - [Optimized `AtomicBool::fetch_nand`][41143]
6896
6897 Stabilized APIs
6898 ---------------
6899
6900 - [`Child::try_wait`]
6901 - [`HashMap::retain`]
6902 - [`HashSet::retain`]
6903 - [`PeekMut::pop`]
6904 - [`TcpStream::peek`]
6905 - [`UdpSocket::peek`]
6906 - [`UdpSocket::peek_from`]
6907
6908 Cargo
6909 -----
6910
6911 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
6912   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
6913 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
6914 - [Added Android build support][cargo/3885]
6915 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
6916   of a certain type, for example `cargo build --bins` will build all
6917   binaries.
6918 - [Added support for haiku][cargo/3952]
6919
6920 Misc
6921 ----
6922
6923 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
6924 - [Rust now uses the official cross compiler for NetBSD][40612]
6925 - [rustdoc now accepts `#` at the start of files][40828]
6926 - [Fixed jemalloc support for musl][41168]
6927
6928 Compatibility Notes
6929 -------------------
6930
6931 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
6932   always placed after the sign if it exists and before the digits. With the `#`
6933   flag the zeroes are placed after the prefix and before the digits.
6934 - [Due to the struct field optimisation][40377], using `transmute` on structs
6935   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
6936   always been undefined behavior, but is now more likely to break in practice.
6937 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
6938   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
6939   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
6940 - [Overlapping inherent `impl`s are now a hard error][40728]
6941 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
6942 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
6943   `out.asm` and `out.ll` instead of only one of the filetypes.
6944 - [ calling a function that returns `Self` will no longer work][41805] when
6945   the size of `Self` cannot be statically determined.
6946 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
6947   this has caused a few regressions namely:
6948
6949   - Changed the link order of local static/dynamic libraries (respecting the
6950     order on given rather than having the compiler reorder).
6951   - Changed how MinGW is linked, native code linked to dynamic libraries
6952     may require manually linking to the gcc support library (for the native
6953     code itself)
6954
6955 [38165]: https://github.com/rust-lang/rust/pull/38165
6956 [39799]: https://github.com/rust-lang/rust/pull/39799
6957 [39891]: https://github.com/rust-lang/rust/pull/39891
6958 [40043]: https://github.com/rust-lang/rust/pull/40043
6959 [40241]: https://github.com/rust-lang/rust/pull/40241
6960 [40338]: https://github.com/rust-lang/rust/pull/40338
6961 [40367]: https://github.com/rust-lang/rust/pull/40367
6962 [40377]: https://github.com/rust-lang/rust/pull/40377
6963 [40409]: https://github.com/rust-lang/rust/pull/40409
6964 [40516]: https://github.com/rust-lang/rust/pull/40516
6965 [40556]: https://github.com/rust-lang/rust/pull/40556
6966 [40561]: https://github.com/rust-lang/rust/pull/40561
6967 [40589]: https://github.com/rust-lang/rust/pull/40589
6968 [40612]: https://github.com/rust-lang/rust/pull/40612
6969 [40723]: https://github.com/rust-lang/rust/pull/40723
6970 [40728]: https://github.com/rust-lang/rust/pull/40728
6971 [40731]: https://github.com/rust-lang/rust/pull/40731
6972 [40734]: https://github.com/rust-lang/rust/pull/40734
6973 [40805]: https://github.com/rust-lang/rust/pull/40805
6974 [40807]: https://github.com/rust-lang/rust/pull/40807
6975 [40828]: https://github.com/rust-lang/rust/pull/40828
6976 [40870]: https://github.com/rust-lang/rust/pull/40870
6977 [41085]: https://github.com/rust-lang/rust/pull/41085
6978 [41143]: https://github.com/rust-lang/rust/pull/41143
6979 [41168]: https://github.com/rust-lang/rust/pull/41168
6980 [41270]: https://github.com/rust-lang/rust/issues/41270
6981 [41469]: https://github.com/rust-lang/rust/pull/41469
6982 [41805]: https://github.com/rust-lang/rust/issues/41805
6983 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
6984 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
6985 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
6986 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
6987 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
6988 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
6989 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
6990 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
6991 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
6992 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
6993 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
6994 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
6995 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
6996 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
6997
6998
6999 Version 1.17.0 (2017-04-27)
7000 ===========================
7001
7002 Language
7003 --------
7004
7005 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
7006 * [Fields of structs may be initialized without duplicating the field/variable
7007   names][39761]. [RFC 1682]
7008 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
7009 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
7010   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
7011   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
7012   `'b`. Soundness fix.
7013 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
7014 * [Static variables may contain references to other statics][40027]
7015
7016 Compiler
7017 --------
7018
7019 * [Exit quickly on only `--emit dep-info`][40336]
7020 * [Make `-C relocation-model` more correctly determine whether the linker
7021   creates a position-independent executable][40245]
7022 * [Add `-C overflow-checks` to directly control whether integer overflow
7023   panics][40037]
7024 * [The rustc type checker now checks items on demand instead of in a single
7025   in-order pass][40008]. This is mostly an internal refactoring in support of
7026   future work, including incremental type checking, but also resolves [RFC
7027   1647], allowing `Self` to appear in `impl` `where` clauses.
7028 * [Optimize vtable loads][39995]
7029 * [Turn off vectorization for Emscripten targets][39990]
7030 * [Provide suggestions for unknown macros imported with `use`][39953]
7031 * [Fix ICEs in path resolution][39939]
7032 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
7033 * [Add clearer error message using `&str + &str`][39116]
7034
7035 Stabilized APIs
7036 ---------------
7037
7038 * [`Arc::into_raw`]
7039 * [`Arc::from_raw`]
7040 * [`Arc::ptr_eq`]
7041 * [`Rc::into_raw`]
7042 * [`Rc::from_raw`]
7043 * [`Rc::ptr_eq`]
7044 * [`Ordering::then`]
7045 * [`Ordering::then_with`]
7046 * [`BTreeMap::range`]
7047 * [`BTreeMap::range_mut`]
7048 * [`collections::Bound`]
7049 * [`process::abort`]
7050 * [`ptr::read_unaligned`]
7051 * [`ptr::write_unaligned`]
7052 * [`Result::expect_err`]
7053 * [`Cell::swap`]
7054 * [`Cell::replace`]
7055 * [`Cell::into_inner`]
7056 * [`Cell::take`]
7057
7058 Libraries
7059 ---------
7060
7061 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
7062 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
7063 * [`String` implements `FromIterator<&char>`][40028]
7064 * `Box` [implements][40009] a number of new conversions:
7065   `From<Box<str>> for String`,
7066   `From<Box<[T]>> for Vec<T>`,
7067   `From<Box<CStr>> for CString`,
7068   `From<Box<OsStr>> for OsString`,
7069   `From<Box<Path>> for PathBuf`,
7070   `Into<Box<str>> for String`,
7071   `Into<Box<[T]>> for Vec<T>`,
7072   `Into<Box<CStr>> for CString`,
7073   `Into<Box<OsStr>> for OsString`,
7074   `Into<Box<Path>> for PathBuf`,
7075   `Default for Box<str>`,
7076   `Default for Box<CStr>`,
7077   `Default for Box<OsStr>`,
7078   `From<&CStr> for Box<CStr>`,
7079   `From<&OsStr> for Box<OsStr>`,
7080   `From<&Path> for Box<Path>`
7081 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
7082 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
7083 * [Slightly optimize `slice::sort`][39538]
7084 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
7085 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
7086   `Box<str>` implements `From<&str>`][39438]
7087 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
7088   `From<(I, u16)> where I: Into<IpAddr>`][39372]
7089 * [`format!` estimates the needed capacity before writing a string][39356]
7090 * [Support unprivileged symlink creation in Windows][38921]
7091 * [`PathBuf` implements `Default`][38764]
7092 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
7093 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
7094   and poor hash functions.
7095
7096 Cargo
7097 -----
7098
7099 * [Add `cargo check --all`][cargo/3731]
7100 * [Add an option to ignore SSL revocation checking][cargo/3699]
7101 * [Add `cargo run --package`][cargo/3691]
7102 * [Add `required_features`][cargo/3667]
7103 * [Assume `build.rs` is a build script][cargo/3664]
7104 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
7105
7106 Misc
7107 ----
7108
7109 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
7110   `rustbook`][39633]
7111 * [The "Unstable Book" documents nightly-only features][ubook]
7112 * [Improve the style of the sidebar in rustdoc output][40265]
7113 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
7114 * [Fix MSP430 breakage due to `i128`][40257]
7115 * [Preliminary Solaris/SPARCv9 support][39903]
7116 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
7117   run without installing the MSVC runtime.
7118 * [`rustdoc --test` includes file names in test names][39788]
7119 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
7120   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
7121 * [Initial support for `aarch64-unknown-freebsd`][39491]
7122 * [Initial support for `i686-unknown-netbsd`][39426]
7123 * [This release no longer includes the old makefile build system][39431]. Rust
7124   is built with a custom build system, written in Rust, and with Cargo.
7125 * [Add Debug implementations for libcollection structs][39002]
7126 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
7127 * [`--test-threads=0` produces an error][38945]
7128 * [`rustup` installs documentation by default][40526]
7129 * [The Rust source includes NatVis visualizations][39843]. These can be used by
7130   WinDbg and Visual Studio to improve the debugging experience.
7131
7132 Compatibility Notes
7133 -------------------
7134
7135 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
7136   workaround, either use MSVC 2015 or run vcvars.bat.
7137 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
7138   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
7139   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
7140   fix.
7141 * [`format!` and `Display::to_string` panic if an underlying formatting
7142   implementation returns an error][40117]. Previously the error was silently
7143   ignored. It is incorrect for `write_fmt` to return an error when writing
7144   to a string.
7145 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
7146   crates were marked stable and could be accessed from the stable toolchain.
7147 * [Rust git source no longer includes vendored crates][39728]. Those that need
7148   to build with vendored crates should build from release tarballs.
7149 * [Fix inert attributes from `proc_macro_derives`][39572]
7150 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
7151   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
7152   build system.
7153 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
7154   existing code generally ignores the type of dead-code unless a type-hint is
7155   provided; this can cause surprising inference interactions particularly around
7156   defaulting. The new code uniformly ignores the result type of dead-code.
7157 * [Tuple-struct constructors with private fields are no longer visible][38932]
7158 * [Lifetime parameters that do not appear in the arguments are now considered
7159   early-bound][38897], resolving a soundness bug (#[32330]). The
7160   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
7161   April of 2016.
7162 * [rustdoc: fix doctests with non-feature crate attributes][38161]
7163 * [Make transmuting from fn item types to pointer-sized types a hard
7164   error][34198]
7165
7166 [27787]: https://github.com/rust-lang/rust/issues/27787
7167 [32330]: https://github.com/rust-lang/rust/issues/32330
7168 [34198]: https://github.com/rust-lang/rust/pull/34198
7169 [38161]: https://github.com/rust-lang/rust/pull/38161
7170 [38368]: https://github.com/rust-lang/rust/pull/38368
7171 [38584]: https://github.com/rust-lang/rust/issues/38584
7172 [38661]: https://github.com/rust-lang/rust/pull/38661
7173 [38764]: https://github.com/rust-lang/rust/pull/38764
7174 [38864]: https://github.com/rust-lang/rust/issues/38864
7175 [38897]: https://github.com/rust-lang/rust/pull/38897
7176 [38921]: https://github.com/rust-lang/rust/pull/38921
7177 [38932]: https://github.com/rust-lang/rust/pull/38932
7178 [38945]: https://github.com/rust-lang/rust/pull/38945
7179 [38981]: https://github.com/rust-lang/rust/pull/38981
7180 [39002]: https://github.com/rust-lang/rust/pull/39002
7181 [39116]: https://github.com/rust-lang/rust/pull/39116
7182 [39193]: https://github.com/rust-lang/rust/pull/39193
7183 [39265]: https://github.com/rust-lang/rust/pull/39265
7184 [39356]: https://github.com/rust-lang/rust/pull/39356
7185 [39372]: https://github.com/rust-lang/rust/pull/39372
7186 [39426]: https://github.com/rust-lang/rust/pull/39426
7187 [39431]: https://github.com/rust-lang/rust/pull/39431
7188 [39438]: https://github.com/rust-lang/rust/pull/39438
7189 [39440]: https://github.com/rust-lang/rust/pull/39440
7190 [39485]: https://github.com/rust-lang/rust/pull/39485
7191 [39491]: https://github.com/rust-lang/rust/pull/39491
7192 [39518]: https://github.com/rust-lang/rust/pull/39518
7193 [39538]: https://github.com/rust-lang/rust/pull/39538
7194 [39572]: https://github.com/rust-lang/rust/pull/39572
7195 [39633]: https://github.com/rust-lang/rust/pull/39633
7196 [39642]: https://github.com/rust-lang/rust/pull/39642
7197 [39728]: https://github.com/rust-lang/rust/pull/39728
7198 [39761]: https://github.com/rust-lang/rust/pull/39761
7199 [39788]: https://github.com/rust-lang/rust/pull/39788
7200 [39793]: https://github.com/rust-lang/rust/pull/39793
7201 [39837]: https://github.com/rust-lang/rust/pull/39837
7202 [39843]: https://github.com/rust-lang/rust/pull/39843
7203 [39851]: https://github.com/rust-lang/rust/pull/39851
7204 [39903]: https://github.com/rust-lang/rust/pull/39903
7205 [39939]: https://github.com/rust-lang/rust/pull/39939
7206 [39953]: https://github.com/rust-lang/rust/pull/39953
7207 [39960]: https://github.com/rust-lang/rust/pull/39960
7208 [39990]: https://github.com/rust-lang/rust/pull/39990
7209 [39995]: https://github.com/rust-lang/rust/pull/39995
7210 [40008]: https://github.com/rust-lang/rust/pull/40008
7211 [40009]: https://github.com/rust-lang/rust/pull/40009
7212 [40027]: https://github.com/rust-lang/rust/pull/40027
7213 [40028]: https://github.com/rust-lang/rust/pull/40028
7214 [40037]: https://github.com/rust-lang/rust/pull/40037
7215 [40117]: https://github.com/rust-lang/rust/pull/40117
7216 [40166]: https://github.com/rust-lang/rust/pull/40166
7217 [40245]: https://github.com/rust-lang/rust/pull/40245
7218 [40257]: https://github.com/rust-lang/rust/pull/40257
7219 [40261]: https://github.com/rust-lang/rust/pull/40261
7220 [40265]: https://github.com/rust-lang/rust/pull/40265
7221 [40319]: https://github.com/rust-lang/rust/pull/40319
7222 [40336]: https://github.com/rust-lang/rust/pull/40336
7223 [40526]: https://github.com/rust-lang/rust/pull/40526
7224 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
7225 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
7226 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
7227 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
7228 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
7229 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
7230 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
7231 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
7232 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
7233 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
7234 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
7235 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
7236 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
7237 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
7238 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
7239 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
7240 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
7241 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
7242 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
7243 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
7244 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
7245 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
7246 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
7247 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
7248 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
7249 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
7250 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
7251 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
7252 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
7253 [ubook]: https://doc.rust-lang.org/unstable-book/
7254
7255
7256 Version 1.16.0 (2017-03-16)
7257 ===========================
7258
7259 Language
7260 --------
7261
7262 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
7263 * [Uninhabitable enums (those without any variants) no longer permit wildcard
7264   match patterns][38069]
7265 * [Clean up semantics of `self` in an import list][38313]
7266 * [`Self` may appear in `impl` headers][38920]
7267 * [`Self` may appear in struct expressions][39282]
7268
7269 Compiler
7270 --------
7271
7272 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
7273   a `.rmeta` file containing only crate metadata][38571]. This can be
7274   used by tools like the Rust Language Service to perform
7275   metadata-only builds.
7276 * [Levenshtein based typo suggestions now work in most places, while
7277   previously they worked only for fields and sometimes for local
7278   variables][38927]. Together with the overhaul of "no
7279   resolution"/"unexpected resolution" errors (#[38154]) they result in
7280   large and systematic improvement in resolution diagnostics.
7281 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
7282   `U`][38670]
7283 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
7284 * [`rustc` no longer attempts to provide "consider using an explicit
7285   lifetime" suggestions][37057]. They were inaccurate.
7286
7287 Stabilized APIs
7288 ---------------
7289
7290 * [`VecDeque::truncate`]
7291 * [`VecDeque::resize`]
7292 * [`String::insert_str`]
7293 * [`Duration::checked_add`]
7294 * [`Duration::checked_sub`]
7295 * [`Duration::checked_div`]
7296 * [`Duration::checked_mul`]
7297 * [`str::replacen`]
7298 * [`str::repeat`]
7299 * [`SocketAddr::is_ipv4`]
7300 * [`SocketAddr::is_ipv6`]
7301 * [`IpAddr::is_ipv4`]
7302 * [`IpAddr::is_ipv6`]
7303 * [`Vec::dedup_by`]
7304 * [`Vec::dedup_by_key`]
7305 * [`Result::unwrap_or_default`]
7306 * [`<*const T>::wrapping_offset`]
7307 * [`<*mut T>::wrapping_offset`]
7308 * `CommandExt::creation_flags`
7309 * [`File::set_permissions`]
7310 * [`String::split_off`]
7311
7312 Libraries
7313 ---------
7314
7315 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
7316   their argument by `Borrow` parameter][37761]
7317 * [All public types in std implement `Debug`][38006]
7318 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
7319 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
7320 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
7321   Windows][38274]
7322 * [std: Fix partial writes in `LineWriter`][38062]
7323 * [std: Clamp max read/write sizes on Unix][38622]
7324 * [Use more specific panic message for `&str` slicing errors][38066]
7325 * [`TcpListener::set_only_v6` is deprecated][38304]. This
7326   functionality cannot be achieved in std currently.
7327 * [`writeln!`, like `println!`, now accepts a form with no string
7328   or formatting arguments, to just print a newline][38469]
7329 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
7330 * [Reduce the size of static data in `std_unicode::tables`][38781]
7331 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
7332   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
7333   `Display`][38909]
7334 * [`Duration` implements `Sum`][38712]
7335 * [`String` implements `ToSocketAddrs`][39048]
7336
7337 Cargo
7338 -----
7339
7340 * [The `cargo check` command does a type check of a project without
7341   building it][cargo/3296]
7342 * [crates.io will display CI badges from Travis and AppVeyor, if
7343   specified in Cargo.toml][cargo/3546]
7344 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
7345 * [Compilation profiles accept integer values for `debug`, in addition
7346   to `true` and `false`. These are passed to `rustc` as the value to
7347   `-C debuginfo`][cargo/3534]
7348 * [Implement `cargo --version --verbose`][cargo/3604]
7349 * [All builds now output 'dep-info' build dependencies compatible with
7350   make and ninja][cargo/3557]
7351 * [Build all workspace members with `build --all`][cargo/3511]
7352 * [Document all workspace members with `doc --all`][cargo/3515]
7353 * [Path deps outside workspace are not members][cargo/3443]
7354
7355 Misc
7356 ----
7357
7358 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
7359   the path to the Rust implementation][38589]
7360 * [The `armv7-linux-androideabi` target no longer enables NEON
7361   extensions, per Google's ABI guide][38413]
7362 * [The stock standard library can be compiled for Redox OS][38401]
7363 * [Rust has initial SPARC support][38726]. Tier 3. No builds
7364   available.
7365 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
7366   builds available.
7367 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
7368
7369 Compatibility Notes
7370 -------------------
7371
7372 * [Uninhabitable enums (those without any variants) no longer permit wildcard
7373   match patterns][38069]
7374 * In this release, references to uninhabited types can not be
7375   pattern-matched. This was accidentally allowed in 1.15.
7376 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
7377 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
7378   Windows][38274]
7379 * [Clean up semantics of `self` in an import list][38313]
7380 * Reimplemented lifetime elision. This change was almost entirely compatible
7381   with existing code, but it did close a number of small bugs and loopholes,
7382   as well as being more accepting in some other [cases][41105].
7383
7384 [37057]: https://github.com/rust-lang/rust/pull/37057
7385 [37761]: https://github.com/rust-lang/rust/pull/37761
7386 [38006]: https://github.com/rust-lang/rust/pull/38006
7387 [38051]: https://github.com/rust-lang/rust/pull/38051
7388 [38062]: https://github.com/rust-lang/rust/pull/38062
7389 [38622]: https://github.com/rust-lang/rust/pull/38622
7390 [38066]: https://github.com/rust-lang/rust/pull/38066
7391 [38069]: https://github.com/rust-lang/rust/pull/38069
7392 [38131]: https://github.com/rust-lang/rust/pull/38131
7393 [38154]: https://github.com/rust-lang/rust/pull/38154
7394 [38274]: https://github.com/rust-lang/rust/pull/38274
7395 [38304]: https://github.com/rust-lang/rust/pull/38304
7396 [38313]: https://github.com/rust-lang/rust/pull/38313
7397 [38327]: https://github.com/rust-lang/rust/pull/38327
7398 [38401]: https://github.com/rust-lang/rust/pull/38401
7399 [38413]: https://github.com/rust-lang/rust/pull/38413
7400 [38469]: https://github.com/rust-lang/rust/pull/38469
7401 [38559]: https://github.com/rust-lang/rust/pull/38559
7402 [38571]: https://github.com/rust-lang/rust/pull/38571
7403 [38580]: https://github.com/rust-lang/rust/pull/38580
7404 [38589]: https://github.com/rust-lang/rust/pull/38589
7405 [38670]: https://github.com/rust-lang/rust/pull/38670
7406 [38712]: https://github.com/rust-lang/rust/pull/38712
7407 [38726]: https://github.com/rust-lang/rust/pull/38726
7408 [38781]: https://github.com/rust-lang/rust/pull/38781
7409 [38798]: https://github.com/rust-lang/rust/pull/38798
7410 [38909]: https://github.com/rust-lang/rust/pull/38909
7411 [38920]: https://github.com/rust-lang/rust/pull/38920
7412 [38927]: https://github.com/rust-lang/rust/pull/38927
7413 [39048]: https://github.com/rust-lang/rust/pull/39048
7414 [39282]: https://github.com/rust-lang/rust/pull/39282
7415 [39379]: https://github.com/rust-lang/rust/pull/39379
7416 [41105]: https://github.com/rust-lang/rust/issues/41105
7417 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
7418 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
7419 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
7420 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
7421 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
7422 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
7423 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
7424 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
7425 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
7426 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
7427 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
7428 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
7429 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
7430 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
7431 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
7432 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
7433 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
7434 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
7435 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
7436 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
7437 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
7438 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
7439 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
7440 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
7441 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
7442 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
7443 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
7444 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
7445 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
7446
7447
7448 Version 1.15.1 (2017-02-09)
7449 ===========================
7450
7451 * [Fix IntoIter::as_mut_slice's signature][39466]
7452 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
7453
7454 [39466]: https://github.com/rust-lang/rust/pull/39466
7455 [39523]: https://github.com/rust-lang/rust/pull/39523
7456
7457
7458 Version 1.15.0 (2017-02-02)
7459 ===========================
7460
7461 Language
7462 --------
7463
7464 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
7465   stable. This allows popular code-generating crates like Serde and Diesel to
7466   work ergonomically. [RFC 1681].
7467 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
7468   with curly braces][36868]. Part of [RFC 1506].
7469 * [A number of minor changes to name resolution have been activated][37127].
7470   They add up to more consistent semantics, allowing for future evolution of
7471   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
7472   details of what is different. The breaking changes here have been transitioned
7473   through the [`legacy_imports`] lint since 1.14, with no known regressions.
7474 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
7475   bounds][38279]
7476 * [`?Sized` can be used in `where` clauses][37791]
7477 * [There is now a limit on the size of monomorphized types and it can be
7478   modified with the `#![type_size_limit]` crate attribute, similarly to
7479   the `#![recursion_limit]` attribute][37789]
7480
7481 Compiler
7482 --------
7483
7484 * [On Windows, the compiler will apply dllimport attributes when linking to
7485   extern functions][37973]. Additional attributes and flags can control which
7486   library kind is linked and its name. [RFC 1717].
7487 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
7488 * [The `--test` flag works with procedural macro crates][38107]
7489 * [Fix `extern "aapcs" fn` ABI][37814]
7490 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
7491 * [The `format!` expander recognizes incorrect `printf` and shell-style
7492   formatting directives and suggests the correct format][37613].
7493 * [Only report one error for all unused imports in an import list][37456]
7494
7495 Compiler Performance
7496 --------------------
7497
7498 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
7499 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
7500 * [Don't clone in `UnificationTable::probe`][37848]
7501 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
7502 * [Use small vectors in type walker][37760]
7503 * [Macro expansion performance was improved][37701]
7504 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
7505 * [Replace FNV with a faster hash function][37229]
7506
7507 Stabilized APIs
7508 ---------------
7509
7510 * [`std::iter::Iterator::min_by`]
7511 * [`std::iter::Iterator::max_by`]
7512 * [`std::os::*::fs::FileExt`]
7513 * [`std::sync::atomic::Atomic*::get_mut`]
7514 * [`std::sync::atomic::Atomic*::into_inner`]
7515 * [`std::vec::IntoIter::as_slice`]
7516 * [`std::vec::IntoIter::as_mut_slice`]
7517 * [`std::sync::mpsc::Receiver::try_iter`]
7518 * [`std::os::unix::process::CommandExt::before_exec`]
7519 * [`std::rc::Rc::strong_count`]
7520 * [`std::rc::Rc::weak_count`]
7521 * [`std::sync::Arc::strong_count`]
7522 * [`std::sync::Arc::weak_count`]
7523 * [`std::char::encode_utf8`]
7524 * [`std::char::encode_utf16`]
7525 * [`std::cell::Ref::clone`]
7526 * [`std::io::Take::into_inner`]
7527
7528 Libraries
7529 ---------
7530
7531 * [The standard sorting algorithm has been rewritten for dramatic performance
7532   improvements][38192]. It is a hybrid merge sort, drawing influences from
7533   Timsort. Previously it was a naive merge sort.
7534 * [`Iterator::nth` no longer has a `Sized` bound][38134]
7535 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
7536   performance.
7537 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
7538   and `char_indices().last()`][37882]
7539 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
7540 * [Chinese characters display correctly in `fmt::Debug`][37855]
7541 * [Derive `Default` for `Duration`][37699]
7542 * [Support creation of anonymous pipes on WinXP/2k][37677]
7543 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
7544 * [Don't pass overlapped handles to processes][38835]
7545
7546 Cargo
7547 -----
7548
7549 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
7550   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
7551   should instead check the variable at runtime with `std::env`. That the value
7552   was set at build time was a bug, and incorrect when cross-compiling. This
7553   change is known to cause breakage.
7554 * [Add `--all` flag to `cargo test`][cargo/3221]
7555 * [Compile statically against the MSVC CRT][cargo/3363]
7556 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
7557 * [Link OpenSSL statically on OSX][cargo/3311]
7558 * [Apply new fingerprinting to build dir outputs][cargo/3310]
7559 * [Test for bad path overrides with summaries][cargo/3336]
7560 * [Require `cargo install --vers` to take a semver version][cargo/3338]
7561 * [Fix retrying crate downloads for network errors][cargo/3348]
7562 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
7563 * [Emit more info on --message-format=json][cargo/3319]
7564 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
7565 * [Don't ignore errors in workspace manifest][cargo/3409]
7566 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
7567
7568 Tooling
7569 -------
7570
7571 * [Test runners (binaries built with `--test`) now support a `--list` argument
7572   that lists the tests it contains][38185]
7573 * [Test runners now support a `--exact` argument that makes the test filter
7574   match exactly, instead of matching only a substring of the test name][38181]
7575 * [rustdoc supports a `--playground-url` flag][37763]
7576 * [rustdoc provides more details about `#[should_panic]` errors][37749]
7577
7578 Misc
7579 ----
7580
7581 * [The Rust build system is now written in Rust][37817]. The Makefiles may
7582   continue to be used in this release by passing `--disable-rustbuild` to the
7583   configure script, but they will be deleted soon. Note that the new build
7584   system uses a different on-disk layout that will likely affect any scripts
7585   building Rust.
7586 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
7587   releases.
7588 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
7589 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
7590   releases.
7591
7592 Compatibility Notes
7593 -------------------
7594
7595 * [A number of minor changes to name resolution have been activated][37127].
7596   They add up to more consistent semantics, allowing for future evolution of
7597   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
7598   details of what is different. The breaking changes here have been transitioned
7599   through the [`legacy_imports`] lint since 1.14, with no known regressions.
7600 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
7601   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
7602   should instead check the variable at runtime with `std::env`. That the value
7603   was set at build time was a bug, and incorrect when cross-compiling. This
7604   change is known to cause breakage.
7605 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
7606   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
7607   1.10 and is now an error by default. It will become a hard error in the near
7608   future.
7609 * [The semantics relating modules to file system directories are changing in
7610   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
7611   lint, which is a warning in this release, and will become a hard error in the
7612   future.
7613 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
7614 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
7615   the underlying iterator][37834]
7616
7617 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
7618 [33685]: https://github.com/rust-lang/rust/issues/33685
7619 [36868]: https://github.com/rust-lang/rust/pull/36868
7620 [37127]: https://github.com/rust-lang/rust/pull/37127
7621 [37229]: https://github.com/rust-lang/rust/pull/37229
7622 [37456]: https://github.com/rust-lang/rust/pull/37456
7623 [37527]: https://github.com/rust-lang/rust/pull/37527
7624 [37602]: https://github.com/rust-lang/rust/pull/37602
7625 [37613]: https://github.com/rust-lang/rust/pull/37613
7626 [37615]: https://github.com/rust-lang/rust/pull/37615
7627 [37636]: https://github.com/rust-lang/rust/pull/37636
7628 [37627]: https://github.com/rust-lang/rust/pull/37627
7629 [37642]: https://github.com/rust-lang/rust/pull/37642
7630 [37677]: https://github.com/rust-lang/rust/pull/37677
7631 [37699]: https://github.com/rust-lang/rust/pull/37699
7632 [37701]: https://github.com/rust-lang/rust/pull/37701
7633 [37705]: https://github.com/rust-lang/rust/pull/37705
7634 [37749]: https://github.com/rust-lang/rust/pull/37749
7635 [37760]: https://github.com/rust-lang/rust/pull/37760
7636 [37763]: https://github.com/rust-lang/rust/pull/37763
7637 [37764]: https://github.com/rust-lang/rust/pull/37764
7638 [37789]: https://github.com/rust-lang/rust/pull/37789
7639 [37791]: https://github.com/rust-lang/rust/pull/37791
7640 [37814]: https://github.com/rust-lang/rust/pull/37814
7641 [37817]: https://github.com/rust-lang/rust/pull/37817
7642 [37834]: https://github.com/rust-lang/rust/pull/37834
7643 [37848]: https://github.com/rust-lang/rust/pull/37848
7644 [37855]: https://github.com/rust-lang/rust/pull/37855
7645 [37882]: https://github.com/rust-lang/rust/pull/37882
7646 [37888]: https://github.com/rust-lang/rust/pull/37888
7647 [37973]: https://github.com/rust-lang/rust/pull/37973
7648 [37979]: https://github.com/rust-lang/rust/pull/37979
7649 [38086]: https://github.com/rust-lang/rust/pull/38086
7650 [38107]: https://github.com/rust-lang/rust/pull/38107
7651 [38117]: https://github.com/rust-lang/rust/pull/38117
7652 [38134]: https://github.com/rust-lang/rust/pull/38134
7653 [38146]: https://github.com/rust-lang/rust/pull/38146
7654 [38181]: https://github.com/rust-lang/rust/pull/38181
7655 [38182]: https://github.com/rust-lang/rust/pull/38182
7656 [38185]: https://github.com/rust-lang/rust/pull/38185
7657 [38192]: https://github.com/rust-lang/rust/pull/38192
7658 [38279]: https://github.com/rust-lang/rust/pull/38279
7659 [38835]: https://github.com/rust-lang/rust/pull/38835
7660 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
7661 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
7662 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
7663 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
7664 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
7665 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
7666 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
7667 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
7668 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
7669 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
7670 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
7671 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
7672 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
7673 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
7674 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
7675 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
7676 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
7677 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
7678 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
7679 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
7680 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
7681 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
7682 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
7683 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
7684 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
7685 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
7686 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
7687 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
7688 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
7689 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
7690 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
7691 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
7692 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
7693 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
7694 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
7695 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
7696 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
7697
7698
7699 Version 1.14.0 (2016-12-22)
7700 ===========================
7701
7702 Language
7703 --------
7704
7705 * [`..` matches multiple tuple fields in enum variants, structs
7706   and tuples][36843]. [RFC 1492].
7707 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
7708 * [`use *` and `use ::*` both glob-import from the crate root][37367]
7709 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
7710   dereferencing][36822]
7711
7712 Compiler
7713 --------
7714
7715 * [Mark enums with non-zero discriminant as non-zero][37224]
7716 * [Lower-case `static mut` names are linted like other
7717   statics and consts][37162]
7718 * [Fix ICE on some macros in const integer positions
7719    (e.g. `[u8; m!()]`)][36819]
7720 * [Improve error message and snippet for "did you mean `x`"][36798]
7721 * [Add a panic-strategy field to the target specification][36794]
7722 * [Include LLVM version in `--version --verbose`][37200]
7723
7724 Compile-time Optimizations
7725 --------------------------
7726
7727 * [Improve macro expansion performance][37569]
7728 * [Shrink `Expr_::ExprInlineAsm`][37445]
7729 * [Replace all uses of SHA-256 with BLAKE2b][37439]
7730 * [Reduce the number of bytes hashed by `IchHasher`][37427]
7731 * [Avoid more allocations when compiling html5ever][37373]
7732 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
7733 * [Avoid some allocations in the macro parser][37318]
7734 * [Use a faster deflate setting][37298]
7735 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
7736   during interning of slices][37270]
7737 * [Optimize `write_metadata`][37267]
7738 * [Don't process obligation forest cycles when stalled][37231]
7739 * [Avoid many `CrateConfig` clones][37161]
7740 * [Optimize `Substs::super_fold_with`][37108]
7741 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
7742 * [Speed up `plug_leaks`][36917]
7743
7744 Libraries
7745 ---------
7746
7747 * [`println!()`, with no arguments, prints newline][36825].
7748   Previously, an empty string was required to achieve the same.
7749 * [`Wrapping` impls standard binary and unary operators, as well as
7750    the `Sum` and `Product` iterators][37356]
7751 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
7752   Vec<T>`][37326]
7753 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
7754   `VecDeque` iterators][37315]
7755 * [Improve `SipHasher` performance on small values][37312]
7756 * [Add Iterator trait TrustedLen to enable better FromIterator /
7757   Extend][37306]
7758 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
7759 * [`ReadDir` implements `Debug`][37221]
7760 * [Implement `RefUnwindSafe` for atomic types][37178]
7761 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
7762 * [Avoid allocations in `Decoder::read_str`][37064]
7763 * [`io::Error` implements `From<io::ErrorKind>`][37037]
7764 * [Impl `Debug` for raw pointers to unsized data][36880]
7765 * [Don't reuse `HashMap` random seeds][37470]
7766 * [The internal memory layout of `HashMap` is more cache-friendly, for
7767   significant improvements in some operations][36692]
7768 * [`HashMap` uses less memory on 32-bit architectures][36595]
7769 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
7770
7771 Cargo
7772 -----
7773
7774 * [Expose rustc cfg values to build scripts][cargo/3243]
7775 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
7776 * [Fix passing --features when testing multiple packages][cargo/3280]
7777 * [Use a single profile set per workspace][cargo/3249]
7778 * [Load `replace` sections from lock files][cargo/3220]
7779 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
7780
7781 Tooling
7782 -------
7783
7784 * [rustup is the recommended Rust installation method][1.14rustup]
7785 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
7786   S390x. These are [tier 2] platforms and may have major defects. Follow the
7787   instructions on the website to install, or add the targets to an existing
7788   installation with `rustup target add`. The new target triples are:
7789   - `mips-unknown-linux-gnu`
7790   - `mipsel-unknown-linux-gnu`
7791   - `mips64-unknown-linux-gnuabi64`
7792   - `mips64el-unknown-linux-gnuabi64 `
7793   - `powerpc-unknown-linux-gnu`
7794   - `powerpc64-unknown-linux-gnu`
7795   - `powerpc64le-unknown-linux-gnu`
7796   - `s390x-unknown-linux-gnu `
7797 * This release includes target (std) builds for ARM Linux running MUSL
7798   libc. These are [tier 2] platforms and may have major defects. Add the
7799   following triples to an existing rustup installation with `rustup target add`:
7800   - `arm-unknown-linux-musleabi`
7801   - `arm-unknown-linux-musleabihf`
7802   - `armv7-unknown-linux-musleabihf`
7803 * This release includes [experimental support for WebAssembly][1.14wasm], via
7804   the `wasm32-unknown-emscripten` target. This target is known to have major
7805   defects. Please test, report, and fix.
7806 * rustup no longer installs documentation by default. Run `rustup
7807   component add rust-docs` to install.
7808 * [Fix line stepping in debugger][37310]
7809 * [Enable line number debuginfo in releases][37280]
7810
7811 Misc
7812 ----
7813
7814 * [Disable jemalloc on aarch64/powerpc/mips][37392]
7815 * [Add support for Fuchsia OS][37313]
7816 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
7817
7818 Compatibility Notes
7819 -------------------
7820
7821 * [A number of forward-compatibility lints used by the compiler
7822   to gradually introduce language changes have been converted
7823   to deny by default][36894]:
7824   - ["use of inaccessible extern crate erroneously allowed"][36886]
7825   - ["type parameter default erroneously allowed in invalid location"][36887]
7826   - ["detects super or self keywords at the beginning of global path"][36888]
7827   - ["two overlapping inherent impls define an item with the same name
7828     were erroneously allowed"][36889]
7829   - ["floating-point constants cannot be used in patterns"][36890]
7830   - ["constants of struct or enum type can only be used in a pattern if
7831      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
7832   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
7833 * [Prohibit patterns in trait methods without bodies][37378]
7834 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
7835 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
7836 * [The `$crate` macro variable is accepted in fewer locations][37213]
7837 * [Impls specifying extra region requirements beyond the trait
7838   they implement are rejected][37167]
7839 * [Enums may not be unsized][37111]. Unsized enums are intended to
7840   work but never have. For now they are forbidden.
7841 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
7842
7843 [tier 2]: https://forge.rust-lang.org/platform-support.html
7844 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
7845 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
7846 [36430]: https://github.com/rust-lang/rust/pull/36430
7847 [36595]: https://github.com/rust-lang/rust/pull/36595
7848 [36692]: https://github.com/rust-lang/rust/pull/36692
7849 [36767]: https://github.com/rust-lang/rust/pull/36767
7850 [36794]: https://github.com/rust-lang/rust/pull/36794
7851 [36798]: https://github.com/rust-lang/rust/pull/36798
7852 [36819]: https://github.com/rust-lang/rust/pull/36819
7853 [36822]: https://github.com/rust-lang/rust/pull/36822
7854 [36825]: https://github.com/rust-lang/rust/pull/36825
7855 [36843]: https://github.com/rust-lang/rust/pull/36843
7856 [36880]: https://github.com/rust-lang/rust/pull/36880
7857 [36886]: https://github.com/rust-lang/rust/issues/36886
7858 [36887]: https://github.com/rust-lang/rust/issues/36887
7859 [36888]: https://github.com/rust-lang/rust/issues/36888
7860 [36889]: https://github.com/rust-lang/rust/issues/36889
7861 [36890]: https://github.com/rust-lang/rust/issues/36890
7862 [36891]: https://github.com/rust-lang/rust/issues/36891
7863 [36892]: https://github.com/rust-lang/rust/issues/36892
7864 [36894]: https://github.com/rust-lang/rust/pull/36894
7865 [36917]: https://github.com/rust-lang/rust/pull/36917
7866 [36993]: https://github.com/rust-lang/rust/pull/36993
7867 [37037]: https://github.com/rust-lang/rust/pull/37037
7868 [37064]: https://github.com/rust-lang/rust/pull/37064
7869 [37094]: https://github.com/rust-lang/rust/pull/37094
7870 [37108]: https://github.com/rust-lang/rust/pull/37108
7871 [37111]: https://github.com/rust-lang/rust/pull/37111
7872 [37161]: https://github.com/rust-lang/rust/pull/37161
7873 [37162]: https://github.com/rust-lang/rust/pull/37162
7874 [37167]: https://github.com/rust-lang/rust/pull/37167
7875 [37178]: https://github.com/rust-lang/rust/pull/37178
7876 [37200]: https://github.com/rust-lang/rust/pull/37200
7877 [37213]: https://github.com/rust-lang/rust/pull/37213
7878 [37221]: https://github.com/rust-lang/rust/pull/37221
7879 [37224]: https://github.com/rust-lang/rust/pull/37224
7880 [37230]: https://github.com/rust-lang/rust/pull/37230
7881 [37231]: https://github.com/rust-lang/rust/pull/37231
7882 [37247]: https://github.com/rust-lang/rust/pull/37247
7883 [37267]: https://github.com/rust-lang/rust/pull/37267
7884 [37270]: https://github.com/rust-lang/rust/pull/37270
7885 [37273]: https://github.com/rust-lang/rust/pull/37273
7886 [37280]: https://github.com/rust-lang/rust/pull/37280
7887 [37298]: https://github.com/rust-lang/rust/pull/37298
7888 [37306]: https://github.com/rust-lang/rust/pull/37306
7889 [37310]: https://github.com/rust-lang/rust/pull/37310
7890 [37312]: https://github.com/rust-lang/rust/pull/37312
7891 [37313]: https://github.com/rust-lang/rust/pull/37313
7892 [37315]: https://github.com/rust-lang/rust/pull/37315
7893 [37318]: https://github.com/rust-lang/rust/pull/37318
7894 [37322]: https://github.com/rust-lang/rust/pull/37322
7895 [37326]: https://github.com/rust-lang/rust/pull/37326
7896 [37351]: https://github.com/rust-lang/rust/pull/37351
7897 [37356]: https://github.com/rust-lang/rust/pull/37356
7898 [37367]: https://github.com/rust-lang/rust/pull/37367
7899 [37373]: https://github.com/rust-lang/rust/pull/37373
7900 [37378]: https://github.com/rust-lang/rust/pull/37378
7901 [37389]: https://github.com/rust-lang/rust/pull/37389
7902 [37392]: https://github.com/rust-lang/rust/pull/37392
7903 [37427]: https://github.com/rust-lang/rust/pull/37427
7904 [37439]: https://github.com/rust-lang/rust/pull/37439
7905 [37445]: https://github.com/rust-lang/rust/pull/37445
7906 [37470]: https://github.com/rust-lang/rust/pull/37470
7907 [37569]: https://github.com/rust-lang/rust/pull/37569
7908 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
7909 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
7910 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
7911 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
7912 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
7913 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
7914 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
7915
7916
7917 Version 1.13.0 (2016-11-10)
7918 ===========================
7919
7920 Language
7921 --------
7922
7923 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
7924   errors, like the `try!` macro, described in [RFC 0243].
7925 * [Stabilize macros in type position][36014]. Described in [RFC 873].
7926 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
7927 * [Fix `#[derive]` for empty tuple structs/variants][35728]
7928 * [Fix lifetime rules for 'if' conditions][36029]
7929 * [Avoid loading and parsing unconfigured non-inline modules][36482]
7930
7931 Compiler
7932 --------
7933
7934 * [Add the `-C link-arg` argument][36574]
7935 * [Remove the old AST-based backend from rustc_trans][35764]
7936 * [Don't enable NEON by default on armv7 Linux][35814]
7937 * [Fix debug line number info for macro expansions][35238]
7938 * [Do not emit "class method" debuginfo for types that are not
7939   DICompositeType][36008]
7940 * [Warn about multiple conflicting #[repr] hints][34623]
7941 * [When sizing DST, don't double-count nested struct prefixes][36351]
7942 * [Default RUST_MIN_STACK to 16MiB for now][36505]
7943 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
7944 * [Reject macros with empty repetitions to avoid infinite loop][36721]
7945 * [Expand macros without recursing to avoid stack overflows][36214]
7946
7947 Diagnostics
7948 -----------
7949
7950 * [Replace macro backtraces with labeled local uses][35702]
7951 * [Improve error message for misplaced doc comments][33922]
7952 * [Buffer unix and lock windows to prevent message interleaving][35975]
7953 * [Update lifetime errors to specifically note temporaries][36171]
7954 * [Special case a few colors for Windows][36178]
7955 * [Suggest `use self` when such an import resolves][36289]
7956 * [Be more specific when type parameter shadows primitive type][36338]
7957 * Many minor improvements
7958
7959 Compile-time Optimizations
7960 --------------------------
7961
7962 * [Compute and cache HIR hashes at beginning][35854]
7963 * [Don't hash types in loan paths][36004]
7964 * [Cache projections in trans][35761]
7965 * [Optimize the parser's last token handling][36527]
7966 * [Only instantiate #[inline] functions in codegen units referencing
7967   them][36524]. This leads to big improvements in cases where crates export
7968   define many inline functions without using them directly.
7969 * [Lazily allocate TypedArena's first chunk][36592]
7970 * [Don't allocate during default HashSet creation][36734]
7971
7972 Stabilized APIs
7973 ---------------
7974
7975 * [`checked_abs`]
7976 * [`wrapping_abs`]
7977 * [`overflowing_abs`]
7978 * [`RefCell::try_borrow`]
7979 * [`RefCell::try_borrow_mut`]
7980
7981 Libraries
7982 ---------
7983
7984 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
7985 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
7986   covariant][35354]
7987 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
7988 * [Implement `Debug` for `std::vec::IntoIter`][35707]
7989 * [`CString`: avoid excessive growth just to 0-terminate][35871]
7990 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
7991 * [Use arc4rand on FreeBSD][35884]
7992 * [memrchr: Correct aligned offset computation][35969]
7993 * [Improve Demangling of Rust Symbols][36059]
7994 * [Use monotonic time in condition variables][35048]
7995 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
7996 * [Implement conversion traits for `char`][35755]
7997 * [Fix illegal instruction caused by overflow in channel cloning][36104]
7998 * [Zero first byte of CString on drop][36264]
7999 * [Inherit overflow checks for sum and product][36372]
8000 * [Add missing Eq implementations][36423]
8001 * [Implement `Debug` for `DirEntry`][36631]
8002 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
8003   `errno`][36754]
8004 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
8005 * [Implement more traits for `std::io::ErrorKind`][35911]
8006 * [Optimize BinaryHeap bounds checking][36072]
8007 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
8008   `extend_with_element`][36355]
8009 * [Fix overflow checking in unsigned pow()][34942]
8010
8011 Cargo
8012 -----
8013
8014 * This release includes security fixes to both curl and OpenSSL.
8015 * [Fix transitive doctests when panic=abort][cargo/3021]
8016 * [Add --all-features flag to cargo][cargo/3038]
8017 * [Reject path-based dependencies in `cargo package`][cargo/3060]
8018 * [Don't parse the home directory more than once][cargo/3078]
8019 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
8020 * [Update OpenSSL to 1.0.2j][cargo/3121]
8021 * [Add license and license_file to cargo metadata output][cargo/3110]
8022 * [Make crates-io registry URL optional in config; ignore all changes to
8023   source.crates-io][cargo/3089]
8024 * [Don't download dependencies from other platforms][cargo/3123]
8025 * [Build transitive dev-dependencies when needed][cargo/3125]
8026 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
8027 * [Avoid updating registry when adding existing deps][cargo/3144]
8028 * [Warn about path overrides that won't work][cargo/3136]
8029 * [Use workspaces during `cargo install`][cargo/3146]
8030 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
8031 * [Add --message-format flag][cargo/3000]
8032 * [Pass target environment for rustdoc][cargo/3205]
8033 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
8034 * [Update curl and curl-sys][cargo/3241]
8035 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
8036
8037 Tooling
8038 -------
8039
8040 * [rustdoc: Add the `--sysroot` argument][36586]
8041 * [rustdoc: Fix a couple of issues with the search results][35655]
8042 * [rustdoc: remove the `!` from macro URLs and titles][35234]
8043 * [gdb: Fix pretty-printing special-cased Rust types][35585]
8044 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
8045
8046 Misc
8047 ----
8048
8049 * [Remove unmaintained style guide][35124]
8050 * [Add s390x support][36369]
8051 * [Initial work at Haiku OS support][36727]
8052 * [Add mips-uclibc targets][35734]
8053 * [Crate-ify compiler-rt into compiler-builtins][35021]
8054 * [Add rustc version info (git hash + date) to dist tarball][36213]
8055 * Many documentation improvements
8056
8057 Compatibility Notes
8058 -------------------
8059
8060 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
8061 * [Deny (by default) transmuting from fn item types to pointer-sized
8062   types][34923]. Continuing the long transition to zero-sized fn items,
8063   per [RFC 401].
8064 * [Fix `#[derive]` for empty tuple structs/variants][35728].
8065   Part of [RFC 1506].
8066 * [Issue deprecation warnings for safe accesses to extern statics][36173]
8067 * [Fix lifetime rules for 'if' conditions][36029].
8068 * [Inherit overflow checks for sum and product][36372].
8069 * [Forbid user-defined macros named "macro_rules"][36730].
8070
8071 [33922]: https://github.com/rust-lang/rust/pull/33922
8072 [34623]: https://github.com/rust-lang/rust/pull/34623
8073 [34923]: https://github.com/rust-lang/rust/pull/34923
8074 [34942]: https://github.com/rust-lang/rust/pull/34942
8075 [35021]: https://github.com/rust-lang/rust/pull/35021
8076 [35048]: https://github.com/rust-lang/rust/pull/35048
8077 [35074]: https://github.com/rust-lang/rust/pull/35074
8078 [35124]: https://github.com/rust-lang/rust/pull/35124
8079 [35234]: https://github.com/rust-lang/rust/pull/35234
8080 [35238]: https://github.com/rust-lang/rust/pull/35238
8081 [35354]: https://github.com/rust-lang/rust/pull/35354
8082 [35559]: https://github.com/rust-lang/rust/pull/35559
8083 [35585]: https://github.com/rust-lang/rust/pull/35585
8084 [35627]: https://github.com/rust-lang/rust/pull/35627
8085 [35655]: https://github.com/rust-lang/rust/pull/35655
8086 [35702]: https://github.com/rust-lang/rust/pull/35702
8087 [35707]: https://github.com/rust-lang/rust/pull/35707
8088 [35728]: https://github.com/rust-lang/rust/pull/35728
8089 [35734]: https://github.com/rust-lang/rust/pull/35734
8090 [35755]: https://github.com/rust-lang/rust/pull/35755
8091 [35761]: https://github.com/rust-lang/rust/pull/35761
8092 [35764]: https://github.com/rust-lang/rust/pull/35764
8093 [35814]: https://github.com/rust-lang/rust/pull/35814
8094 [35854]: https://github.com/rust-lang/rust/pull/35854
8095 [35871]: https://github.com/rust-lang/rust/pull/35871
8096 [35884]: https://github.com/rust-lang/rust/pull/35884
8097 [35911]: https://github.com/rust-lang/rust/pull/35911
8098 [35969]: https://github.com/rust-lang/rust/pull/35969
8099 [35975]: https://github.com/rust-lang/rust/pull/35975
8100 [36004]: https://github.com/rust-lang/rust/pull/36004
8101 [36008]: https://github.com/rust-lang/rust/pull/36008
8102 [36014]: https://github.com/rust-lang/rust/pull/36014
8103 [36029]: https://github.com/rust-lang/rust/pull/36029
8104 [36059]: https://github.com/rust-lang/rust/pull/36059
8105 [36072]: https://github.com/rust-lang/rust/pull/36072
8106 [36101]: https://github.com/rust-lang/rust/pull/36101
8107 [36104]: https://github.com/rust-lang/rust/pull/36104
8108 [36171]: https://github.com/rust-lang/rust/pull/36171
8109 [36173]: https://github.com/rust-lang/rust/pull/36173
8110 [36178]: https://github.com/rust-lang/rust/pull/36178
8111 [36213]: https://github.com/rust-lang/rust/pull/36213
8112 [36214]: https://github.com/rust-lang/rust/pull/36214
8113 [36264]: https://github.com/rust-lang/rust/pull/36264
8114 [36266]: https://github.com/rust-lang/rust/pull/36266
8115 [36289]: https://github.com/rust-lang/rust/pull/36289
8116 [36338]: https://github.com/rust-lang/rust/pull/36338
8117 [36351]: https://github.com/rust-lang/rust/pull/36351
8118 [36355]: https://github.com/rust-lang/rust/pull/36355
8119 [36369]: https://github.com/rust-lang/rust/pull/36369
8120 [36372]: https://github.com/rust-lang/rust/pull/36372
8121 [36423]: https://github.com/rust-lang/rust/pull/36423
8122 [36482]: https://github.com/rust-lang/rust/pull/36482
8123 [36505]: https://github.com/rust-lang/rust/pull/36505
8124 [36524]: https://github.com/rust-lang/rust/pull/36524
8125 [36527]: https://github.com/rust-lang/rust/pull/36527
8126 [36551]: https://github.com/rust-lang/rust/pull/36551
8127 [36574]: https://github.com/rust-lang/rust/pull/36574
8128 [36586]: https://github.com/rust-lang/rust/pull/36586
8129 [36592]: https://github.com/rust-lang/rust/pull/36592
8130 [36631]: https://github.com/rust-lang/rust/pull/36631
8131 [36721]: https://github.com/rust-lang/rust/pull/36721
8132 [36727]: https://github.com/rust-lang/rust/pull/36727
8133 [36730]: https://github.com/rust-lang/rust/pull/36730
8134 [36734]: https://github.com/rust-lang/rust/pull/36734
8135 [36754]: https://github.com/rust-lang/rust/pull/36754
8136 [36995]: https://github.com/rust-lang/rust/pull/36995
8137 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
8138 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
8139 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
8140 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
8141 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
8142 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
8143 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
8144 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
8145 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
8146 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
8147 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
8148 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
8149 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
8150 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
8151 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
8152 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
8153 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
8154 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
8155 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
8156 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
8157 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
8158 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
8159 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
8160 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
8161 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
8162 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
8163 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
8164 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
8165 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
8166 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
8167 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
8168 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
8169
8170
8171 Version 1.12.1 (2016-10-20)
8172 ===========================
8173
8174 Regression Fixes
8175 ----------------
8176
8177 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
8178 * [Confusion with double negation and booleans][36856]
8179 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
8180 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
8181 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
8182 * [Corrupted memory after updated to 1.12][36936]
8183 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
8184 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
8185 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
8186
8187 [36381]: https://github.com/rust-lang/rust/issues/36381
8188 [36856]: https://github.com/rust-lang/rust/issues/36856
8189 [36875]: https://github.com/rust-lang/rust/issues/36875
8190 [36924]: https://github.com/rust-lang/rust/issues/36924
8191 [36926]: https://github.com/rust-lang/rust/issues/36926
8192 [36936]: https://github.com/rust-lang/rust/issues/36936
8193 [37026]: https://github.com/rust-lang/rust/issues/37026
8194 [37112]: https://github.com/rust-lang/rust/issues/37112
8195 [37153]: https://github.com/rust-lang/rust/issues/37153
8196
8197
8198 Version 1.12.0 (2016-09-29)
8199 ===========================
8200
8201 Highlights
8202 ----------
8203
8204 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
8205   This translation pass is far simpler than the previous AST->LLVM pass, and
8206   creates opportunities to perform new optimizations directly on the MIR. It
8207   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
8208 * [`rustc` presents a new, more readable error format, along with
8209   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
8210   Most common editors supporting Rust have been updated to work with it. It was
8211   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
8212
8213 Compiler
8214 --------
8215
8216 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
8217   This translation pass is far simpler than the previous AST->LLVM pass, and
8218   creates opportunities to perform new optimizations directly on the MIR. It
8219   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
8220 * [Print the Rust target name, not the LLVM target name, with
8221   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
8222 * [The computation of `TypeId` is correct in some cases where it was previously
8223   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
8224 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
8225 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
8226   `--print relocation-models`, and `--print code-models` print the available
8227   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
8228   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
8229 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
8230   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
8231   These targets produce statically-linked binaries. There are no binary release
8232   builds yet though.
8233
8234 Diagnostics
8235 -----------
8236
8237 * [`rustc` presents a new, more readable error format, along with
8238   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
8239   Most common editors supporting Rust have been updated to work with it. It was
8240   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
8241 * [In error descriptions, references are now described in plain English,
8242   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
8243 * [In error type descriptions, unknown numeric types are named `{integer}` or
8244   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
8245 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
8246
8247 Language
8248 --------
8249
8250 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
8251 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
8252 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
8253   useful](https://github.com/rust-lang/rust/pull/34908)
8254 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
8255   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
8256 * [Semicolons are properly required as statement delimiters inside
8257   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
8258 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
8259
8260 Stabilized APIs
8261 ---------------
8262
8263 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
8264 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
8265 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
8266 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
8267 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
8268 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
8269 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
8270 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
8271 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
8272 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
8273   Both on Unix and Windows.
8274 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
8275 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
8276 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
8277 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
8278 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
8279 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
8280 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
8281 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
8282
8283 Libraries
8284 ---------
8285
8286 * [The `format!` macro and friends now allow a single argument to be formatted
8287   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
8288 * [The lifetime bounds on `[T]::binary_search_by` and
8289   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
8290 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
8291 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
8292 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
8293 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
8294 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
8295 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
8296 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
8297 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
8298   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
8299 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
8300   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
8301 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
8302 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
8303   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
8304 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
8305 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
8306 * [`mpsc::sync_channel` `Receiver`s return any available message before
8307   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
8308 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
8309 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
8310
8311 Cargo
8312 -----
8313
8314 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
8315 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
8316 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
8317 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
8318 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
8319 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
8320 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
8321 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
8322 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
8323 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
8324 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
8325 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
8326 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
8327 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
8328 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
8329 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
8330
8331 Performance
8332 -----------
8333
8334 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
8335 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
8336
8337 Tooling
8338 -------
8339
8340 * [Test binaries now support a `--test-threads` argument to specify the number
8341   of threads used to run tests, and which acts the same as the
8342   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
8343 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
8344 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
8345 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
8346 * [Rust releases now come with source packages that can be installed by rustup
8347   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
8348   The resulting source code can be used by tools and IDES, located in the
8349   sysroot under `lib/rustlib/src`.
8350
8351 Misc
8352 ----
8353
8354 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
8355 * Many minor improvements to the documentation.
8356 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
8357
8358 Compatibility Notes
8359 -------------------
8360
8361 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
8362   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
8363 * [When formatting strings, if "precision" is specified, the "fill",
8364   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
8365 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
8366
8367
8368 Version 1.11.0 (2016-08-18)
8369 ===========================
8370
8371 Language
8372 --------
8373
8374 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
8375 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
8376 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
8377 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
8378
8379 Stabilized APIs
8380 ---------------
8381
8382 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
8383 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
8384 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
8385 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
8386 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
8387 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
8388   (in libcore - previously stabilized in libstd)
8389 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
8390   (in libcore - previously stabilized in libstd)
8391 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
8392   (in libcore - previously stabilized in libstd)
8393 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
8394   (in libcore - previously stabilized in libstd)
8395 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
8396 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
8397 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
8398 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
8399
8400 Libraries
8401 ---------
8402
8403 * [The `thread_local!` macro supports multiple definitions in a single
8404    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
8405 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
8406 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
8407   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
8408 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
8409 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
8410 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
8411 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
8412
8413 Cargo
8414 -----
8415
8416 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
8417 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
8418 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
8419 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
8420 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
8421   and `-vv` prints warnings for all crates.
8422 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
8423 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
8424   This provides room for expansion by arbitrary tools.
8425 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
8426 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
8427 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
8428 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
8429 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
8430 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
8431 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
8432
8433 Performance
8434 -----------
8435
8436 * [Caching projections speeds up type check dramatically for some
8437   workloads](https://github.com/rust-lang/rust/pull/33816)
8438 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
8439   This hasher is faster, but is believed to provide sufficient
8440   protection from collision attacks.
8441 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
8442
8443 Rustdoc
8444 -------
8445
8446 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
8447 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
8448 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
8449 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
8450 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
8451
8452 Tooling
8453 -------
8454
8455 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
8456 * [When emitting debug info, rustc emits frame pointers for closures,
8457   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
8458 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
8459 * Many more errors have been given error codes and extended
8460   explanations
8461 * API documentation continues to be improved, with many new examples
8462
8463 Misc
8464 ----
8465
8466 * [rustc no longer hangs when dependencies recursively re-export
8467   submodules](https://github.com/rust-lang/rust/pull/34542)
8468 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
8469 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
8470   rewritten](https://github.com/rust-lang/rust/pull/33895)
8471 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
8472   No targets use this yet, but it works toward AVR support.
8473
8474 Compatibility Notes
8475 -------------------
8476
8477 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
8478 * [The new follow-set rules that place restrictions on `macro_rules!`
8479   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
8480   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
8481   and has been a warning since 1.10.
8482 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
8483   This causes breakage in some corner cases.
8484
8485
8486 Version 1.10.0 (2016-07-07)
8487 ===========================
8488
8489 Language
8490 --------
8491
8492 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
8493   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
8494 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
8495 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
8496 * [`panic!` can be converted to a runtime abort with the
8497   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
8498   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
8499 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
8500   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
8501   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
8502   Note that Cargo does not yet directly support cdylibs.
8503
8504 Stabilized APIs
8505 ---------------
8506
8507 * `os::windows::fs::OpenOptionsExt::access_mode`
8508 * `os::windows::fs::OpenOptionsExt::share_mode`
8509 * `os::windows::fs::OpenOptionsExt::custom_flags`
8510 * `os::windows::fs::OpenOptionsExt::attributes`
8511 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
8512 * `os::unix::fs::OpenOptionsExt::custom_flags`
8513 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
8514 * `Default for sync::Weak`
8515 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
8516 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
8517 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
8518 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
8519 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
8520 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
8521 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
8522 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
8523 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
8524 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
8525 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
8526 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
8527 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
8528 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
8529 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
8530 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
8531 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
8532 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
8533 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
8534 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
8535 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
8536 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
8537 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
8538 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
8539 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
8540 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
8541 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
8542 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
8543 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
8544 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
8545 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
8546 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
8547 * Read/Write/RawFd impls for `UnixStream`
8548 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
8549 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
8550 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
8551 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
8552 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
8553 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
8554 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
8555 * RawFd impls for `UnixListener`
8556 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
8557 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
8558 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
8559 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
8560 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
8561 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
8562 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
8563 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
8564 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
8565 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
8566 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
8567 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
8568 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
8569 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
8570 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
8571 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
8572 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
8573 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
8574 * RawFd impls for `UnixDatagram`
8575 * `{BTree,Hash}Map::values_mut`
8576 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
8577
8578 Libraries
8579 ---------
8580
8581 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
8582   The semantics of this minor method are subtle and probably not what
8583   most people want.
8584 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
8585 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
8586   will fall back to `/dev/urandom` temporarily to avoid blocking
8587   during early boot](https://github.com/rust-lang/rust/pull/33086).
8588 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
8589 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
8590 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
8591 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
8592 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
8593 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
8594   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
8595
8596 Cargo
8597 -----
8598 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
8599   This controls the runtime behavior of the `panic!` macro
8600   and can be either "unwind" (the default), or "abort".
8601   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
8602 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
8603 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
8604 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
8605   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
8606 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
8607 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
8608 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
8609   By default they are retried twice, which can be customized with the
8610   `net.retry` value in `.cargo/config`.
8611 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
8612 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
8613 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
8614 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
8615   Makes it possible to install multiple crates in parallel.
8616 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
8617 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
8618 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
8619 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
8620 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
8621 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
8622
8623 Performance
8624 -----------
8625
8626 * [rustc memory usage was reduced by refactoring the context used for
8627   type checking](https://github.com/rust-lang/rust/pull/33425).
8628 * [Speed up creation of `HashMap`s by caching the random keys used
8629   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
8630 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
8631 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
8632 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
8633   10x faster than the previous lookup tables.
8634 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
8635
8636 Usability
8637 ---------
8638
8639 * Many incremental improvements to documentation and rustdoc.
8640 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
8641 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
8642 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
8643 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
8644 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
8645 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
8646 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
8647
8648 Misc
8649 ----
8650
8651 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
8652 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
8653 * [`std` no longer prints backtraces on platforms where the running
8654   module must be loaded with `env::current_exe`, which can't be relied
8655   on](https://github.com/rust-lang/rust/pull/33554).
8656 * This release includes std binaries for the i586-unknown-linux-gnu,
8657   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
8658   i586 target is for old x86 hardware without SSE2, and the armv7
8659   target is for Android running on modern ARM architectures.
8660 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
8661   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
8662 * [On Unix the runtime aborts by calling `libc::abort` instead of
8663   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
8664 * [Rust is now bootstrapped from the previous release of Rust,
8665   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
8666
8667 Compatibility Notes
8668 -------------------
8669
8670 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
8671 * [`target_env` for Linux ARM targets is just `gnu`, not
8672   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
8673 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
8674 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
8675 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
8676   Affects how macros are parsed.
8677 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
8678 * [Feature-gated attributes on macro-generated macro invocations are
8679   now rejected](https://github.com/rust-lang/rust/pull/32791).
8680 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
8681   This caused some minor changes to type inference.
8682
8683
8684 Version 1.9.0 (2016-05-26)
8685 ==========================
8686
8687 Language
8688 --------
8689
8690 * The `#[deprecated]` attribute when applied to an API will generate
8691   warnings when used. The warnings may be suppressed with
8692   `#[allow(deprecated)]`. [RFC 1270].
8693 * [`fn` item types are zero sized, and each `fn` names a unique
8694   type][1.9fn]. This will break code that transmutes `fn`s, so calling
8695   `transmute` on a `fn` type will generate a warning for a few cycles,
8696   then will be converted to an error.
8697 * [Field and method resolution understand visibility, so private
8698   fields and methods cannot prevent the proper use of public fields
8699   and methods][1.9fv].
8700 * [The parser considers unicode codepoints in the
8701   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
8702
8703 Stabilized APIs
8704 ---------------
8705
8706 * [`std::panic`]
8707 * [`std::panic::catch_unwind`] (renamed from `recover`)
8708 * [`std::panic::resume_unwind`] (renamed from `propagate`)
8709 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
8710 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
8711 * [`str::is_char_boundary`]
8712 * [`<*const T>::as_ref`]
8713 * [`<*mut T>::as_ref`]
8714 * [`<*mut T>::as_mut`]
8715 * [`AsciiExt::make_ascii_uppercase`]
8716 * [`AsciiExt::make_ascii_lowercase`]
8717 * [`char::decode_utf16`]
8718 * [`char::DecodeUtf16`]
8719 * [`char::DecodeUtf16Error`]
8720 * [`char::DecodeUtf16Error::unpaired_surrogate`]
8721 * [`BTreeSet::take`]
8722 * [`BTreeSet::replace`]
8723 * [`BTreeSet::get`]
8724 * [`HashSet::take`]
8725 * [`HashSet::replace`]
8726 * [`HashSet::get`]
8727 * [`OsString::with_capacity`]
8728 * [`OsString::clear`]
8729 * [`OsString::capacity`]
8730 * [`OsString::reserve`]
8731 * [`OsString::reserve_exact`]
8732 * [`OsStr::is_empty`]
8733 * [`OsStr::len`]
8734 * [`std::os::unix::thread`]
8735 * [`RawPthread`]
8736 * [`JoinHandleExt`]
8737 * [`JoinHandleExt::as_pthread_t`]
8738 * [`JoinHandleExt::into_pthread_t`]
8739 * [`HashSet::hasher`]
8740 * [`HashMap::hasher`]
8741 * [`CommandExt::exec`]
8742 * [`File::try_clone`]
8743 * [`SocketAddr::set_ip`]
8744 * [`SocketAddr::set_port`]
8745 * [`SocketAddrV4::set_ip`]
8746 * [`SocketAddrV4::set_port`]
8747 * [`SocketAddrV6::set_ip`]
8748 * [`SocketAddrV6::set_port`]
8749 * [`SocketAddrV6::set_flowinfo`]
8750 * [`SocketAddrV6::set_scope_id`]
8751 * [`slice::copy_from_slice`]
8752 * [`ptr::read_volatile`]
8753 * [`ptr::write_volatile`]
8754 * [`OpenOptions::create_new`]
8755 * [`TcpStream::set_nodelay`]
8756 * [`TcpStream::nodelay`]
8757 * [`TcpStream::set_ttl`]
8758 * [`TcpStream::ttl`]
8759 * [`TcpStream::set_only_v6`]
8760 * [`TcpStream::only_v6`]
8761 * [`TcpStream::take_error`]
8762 * [`TcpStream::set_nonblocking`]
8763 * [`TcpListener::set_ttl`]
8764 * [`TcpListener::ttl`]
8765 * [`TcpListener::set_only_v6`]
8766 * [`TcpListener::only_v6`]
8767 * [`TcpListener::take_error`]
8768 * [`TcpListener::set_nonblocking`]
8769 * [`UdpSocket::set_broadcast`]
8770 * [`UdpSocket::broadcast`]
8771 * [`UdpSocket::set_multicast_loop_v4`]
8772 * [`UdpSocket::multicast_loop_v4`]
8773 * [`UdpSocket::set_multicast_ttl_v4`]
8774 * [`UdpSocket::multicast_ttl_v4`]
8775 * [`UdpSocket::set_multicast_loop_v6`]
8776 * [`UdpSocket::multicast_loop_v6`]
8777 * [`UdpSocket::set_multicast_ttl_v6`]
8778 * [`UdpSocket::multicast_ttl_v6`]
8779 * [`UdpSocket::set_ttl`]
8780 * [`UdpSocket::ttl`]
8781 * [`UdpSocket::set_only_v6`]
8782 * [`UdpSocket::only_v6`]
8783 * [`UdpSocket::join_multicast_v4`]
8784 * [`UdpSocket::join_multicast_v6`]
8785 * [`UdpSocket::leave_multicast_v4`]
8786 * [`UdpSocket::leave_multicast_v6`]
8787 * [`UdpSocket::take_error`]
8788 * [`UdpSocket::connect`]
8789 * [`UdpSocket::send`]
8790 * [`UdpSocket::recv`]
8791 * [`UdpSocket::set_nonblocking`]
8792
8793 Libraries
8794 ---------
8795
8796 * [`std::sync::Once` is poisoned if its initialization function
8797   fails][1.9o].
8798 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
8799 * [Most types implement `fmt::Debug`][1.9db].
8800 * [The default buffer size used by `BufReader` and `BufWriter` was
8801   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
8802   used by other languages.
8803 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
8804   `Duration` additionally implements `*=` and `/=`][1.9ta].
8805 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
8806 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
8807 * [`Chain` implements `BufRead`][1.9ch].
8808 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
8809
8810 Cargo
8811 -----
8812
8813 * [Cargo can now run concurrently][1.9cc].
8814 * [Top-level overrides allow specific revisions of crates to be
8815   overridden through the entire crate graph][1.9ct].  This is intended
8816   to make upgrades easier for large projects, by allowing crates to be
8817   forked temporarily until they've been upgraded and republished.
8818 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
8819 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
8820   on the commandline][1.9cf]. `rustc` arguments can also be specified
8821   in the `build.rustflags` configuration key.
8822
8823 Performance
8824 -----------
8825
8826 * [The time complexity of comparing variables for equivalence during type
8827   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
8828   to major compilation time improvement in some scenarios.
8829 * [`ToString` is specialized for `str`, giving it the same performance
8830   as `to_owned`][1.9ts].
8831 * [Spawning processes with `Command::output` no longer creates extra
8832   threads][1.9sp].
8833 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
8834   for C-like enums][1.9cl].
8835
8836 Misc
8837 ----
8838
8839 * [Passing the `--quiet` flag to a test runner will produce
8840   much-abbreviated output][1.9q].
8841 * The Rust Project now publishes std binaries for the
8842   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
8843   `i586-pc-windows-msvc` targets.
8844
8845 Compatibility Notes
8846 -------------------
8847
8848 * [`std::sync::Once` is poisoned if its initialization function
8849   fails][1.9o].
8850 * [It is illegal to define methods with the same name in overlapping
8851   inherent `impl` blocks][1.9sn].
8852 * [`fn` item types are zero sized, and each `fn` names a unique
8853   type][1.9fn]. This will break code that transmutes `fn`s, so calling
8854   `transmute` on a `fn` type will generate a warning for a few cycles,
8855   then will be converted to an error.
8856 * [Improvements to const evaluation may trigger new errors when integer
8857   literals are out of range][1.9ce].
8858
8859
8860 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
8861 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
8862 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
8863 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
8864 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
8865 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
8866 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
8867 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
8868 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
8869 [1.9db]: https://github.com/rust-lang/rust/pull/32054
8870 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
8871 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
8872 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
8873 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
8874 [1.9o]: https://github.com/rust-lang/rust/pull/32325
8875 [1.9q]: https://github.com/rust-lang/rust/pull/31887
8876 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
8877 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
8878 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
8879 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
8880 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
8881 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
8882 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
8883 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
8884 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
8885 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
8886 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
8887 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
8888 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
8889 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
8890 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
8891 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
8892 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
8893 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
8894 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
8895 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
8896 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
8897 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
8898 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
8899 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
8900 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
8901 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
8902 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
8903 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
8904 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
8905 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
8906 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
8907 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
8908 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
8909 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
8910 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
8911 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
8912 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
8913 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
8914 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
8915 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
8916 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
8917 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
8918 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
8919 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
8920 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
8921 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
8922 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
8923 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
8924 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
8925 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
8926 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
8927 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
8928 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
8929 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
8930 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
8931 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
8932 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
8933 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
8934 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
8935 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
8936 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
8937 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
8938 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
8939 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
8940 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
8941 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
8942 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
8943 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
8944 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
8945 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
8946 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
8947 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
8948 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
8949 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
8950 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
8951 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
8952 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
8953 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
8954 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
8955 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
8956 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
8957 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
8958 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
8959 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
8960 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
8961 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
8962 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
8963 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
8964 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
8965 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
8966 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
8967 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
8968 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
8969 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
8970
8971
8972 Version 1.8.0 (2016-04-14)
8973 ==========================
8974
8975 Language
8976 --------
8977
8978 * Rust supports overloading of compound assignment statements like
8979   `+=` by implementing the [`AddAssign`], [`SubAssign`],
8980   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
8981   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
8982   traits. [RFC 953].
8983 * Empty structs can be defined with braces, as in `struct Foo { }`, in
8984   addition to the non-braced form, `struct Foo;`. [RFC 218].
8985
8986 Libraries
8987 ---------
8988
8989 * Stabilized APIs:
8990   * [`str::encode_utf16`] (renamed from `utf16_units`)
8991   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
8992   * [`Ref::map`]
8993   * [`RefMut::map`]
8994   * [`ptr::drop_in_place`]
8995   * [`time::Instant`]
8996   * [`time::SystemTime`]
8997   * [`Instant::now`]
8998   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
8999   * [`Instant::elapsed`]
9000   * [`SystemTime::now`]
9001   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
9002   * [`SystemTime::elapsed`]
9003   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
9004   * [`SystemTimeError`]
9005   * [`SystemTimeError::duration`]
9006   * Various impls for `SystemTimeError`
9007   * [`UNIX_EPOCH`]
9008   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
9009     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
9010     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
9011 * [The `write!` and `writeln!` macros correctly emit errors if any of
9012   their arguments can't be formatted][1.8w].
9013 * [Various I/O functions support large files on 32-bit Linux][1.8l].
9014 * [The Unix-specific `raw` modules, which contain a number of
9015   redefined C types are deprecated][1.8r], including `os::raw::unix`,
9016   `os::raw::macos`, and `os::raw::linux`. These modules defined types
9017   such as `ino_t` and `dev_t`. The inconsistency of these definitions
9018   across platforms was making it difficult to implement `std`
9019   correctly. Those that need these definitions should use the `libc`
9020   crate. [RFC 1415].
9021 * The Unix-specific `MetadataExt` traits, including
9022   `os::unix::fs::MetadataExt`, which expose values such as inode
9023   numbers [no longer return platform-specific types][1.8r], but
9024   instead return widened integers. [RFC 1415].
9025 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
9026 * [Atomic loads and stores are not volatile][1.8a].
9027 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
9028
9029 Performance
9030 -----------
9031
9032 * [Inlining hash functions lead to a 3% compile-time improvement in
9033   some workloads][1.8h].
9034 * When using jemalloc, its symbols are [unprefixed so that it
9035   overrides the libc malloc implementation][1.8h]. This means that for
9036   rustc, LLVM is now using jemalloc, which results in a 6%
9037   compile-time improvement on a specific workload.
9038 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
9039
9040 Misc
9041 ----
9042
9043 * [32-bit MSVC builds finally implement unwinding][1.8ms].
9044   i686-pc-windows-msvc is now considered a tier-1 platform.
9045 * [The `--print targets` flag prints a list of supported targets][1.8t].
9046 * [The `--print cfg` flag prints the `cfg`s defined for the current
9047   target][1.8cf].
9048 * [`rustc` can be built with an new Cargo-based build system, written
9049   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
9050   build system. To enable it configure with `configure --rustbuild`.
9051 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
9052   variants while also indicating the total number of missing variants
9053   if more than 3][1.8m].
9054 * [Executable stacks are disabled on Linux and BSD][1.8nx].
9055 * The Rust Project now publishes binary releases of the standard
9056   library for a number of tier-2 targets:
9057   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
9058   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
9059   `x86_64-rumprun-netbsd`. These can be installed with
9060   tools such as [multirust][1.8mr].
9061
9062 Cargo
9063 -----
9064
9065 * [`cargo init` creates a new Cargo project in the current
9066   directory][1.8ci].  It is otherwise like `cargo new`.
9067 * [Cargo has configuration keys for `-v` and
9068   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
9069   `[term]` section of `.cargo/config`.
9070 * [Configuration keys that evaluate to strings or integers can be set
9071   via environment variables][1.8ce]. For example the `build.jobs` key
9072   can be set via `CARGO_BUILD_JOBS`. Environment variables take
9073   precedence over config files.
9074 * [Target-specific dependencies support Rust `cfg` syntax for
9075   describing targets][1.8cfg] so that dependencies for multiple
9076   targets can be specified together. [RFC 1361].
9077 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
9078   `RUSTDOC` take precedence over the `build.target-dir`,
9079   `build.rustc`, and `build.rustdoc` configuration values][1.8cfv].
9080 * [The child process tree is killed on Windows when Cargo is
9081   killed][1.8ck].
9082 * [The `build.target` configuration value sets the target platform,
9083   like `--target`][1.8ct].
9084
9085 Compatibility Notes
9086 -------------------
9087
9088 * [Unstable compiler flags have been further restricted][1.8u]. Since
9089   1.0 `-Z` flags have been considered unstable, and other flags that
9090   were considered unstable additionally required passing `-Z
9091   unstable-options` to access. Unlike unstable language and library
9092   features though, these options have been accessible on the stable
9093   release channel. Going forward, *new unstable flags will not be
9094   available on the stable release channel*, and old unstable flags
9095   will warn about their usage. In the future, all unstable flags will
9096   be unavailable on the stable release channel.
9097 * [It is no longer possible to `match` on empty enum variants using
9098   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
9099 * The Unix-specific `MetadataExt` traits, including
9100   `os::unix::fs::MetadataExt`, which expose values such as inode
9101   numbers [no longer return platform-specific types][1.8r], but
9102   instead return widened integers. [RFC 1415].
9103 * [Modules sourced from the filesystem cannot appear within arbitrary
9104   blocks, but only within other modules][1.8mf].
9105 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
9106 * On Unix, [stack overflow triggers a runtime abort instead of a
9107   SIGSEGV][1.8so].
9108 * [`Command::spawn` and its equivalents return an error if any of
9109   its command-line arguments contain interior `NUL`s][1.8n].
9110 * [Tuple and unit enum variants from other crates are in the type
9111   namespace][1.8tn].
9112 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
9113   type instead of `.a` files][1.8st]. Additionally, for the MSVC
9114   toolchain, `rustc` emits import libraries named `foo.dll.lib`
9115   instead of `foo.lib`.
9116
9117
9118 [1.8a]: https://github.com/rust-lang/rust/pull/30962
9119 [1.8b]: https://github.com/rust-lang/rust/pull/31123
9120 [1.8c]: https://github.com/rust-lang/rust/pull/31530
9121 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
9122 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
9123 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
9124 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
9125 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
9126 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
9127 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
9128 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
9129 [1.8cfv]: https://github.com/rust-lang/cargo/issues/2365
9130 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
9131 [1.8h]: https://github.com/rust-lang/rust/pull/31460
9132 [1.8l]: https://github.com/rust-lang/rust/pull/31668
9133 [1.8m]: https://github.com/rust-lang/rust/pull/31020
9134 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
9135 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
9136 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
9137 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
9138 [1.8n]: https://github.com/rust-lang/rust/pull/31056
9139 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
9140 [1.8r]: https://github.com/rust-lang/rust/pull/31551
9141 [1.8so]: https://github.com/rust-lang/rust/pull/31333
9142 [1.8st]: https://github.com/rust-lang/rust/pull/29520
9143 [1.8t]: https://github.com/rust-lang/rust/pull/31358
9144 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
9145 [1.8u]: https://github.com/rust-lang/rust/pull/31793
9146 [1.8v]: https://github.com/rust-lang/rust/pull/31757
9147 [1.8w]: https://github.com/rust-lang/rust/pull/31904
9148 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
9149 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
9150 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
9151 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
9152 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
9153 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
9154 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
9155 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
9156 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
9157 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
9158 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
9159 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
9160 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
9161 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
9162 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
9163 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
9164 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
9165 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
9166 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
9167 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
9168 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
9169 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
9170 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
9171 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
9172 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
9173 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
9174 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
9175 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
9176 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
9177 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
9178
9179
9180 Version 1.7.0 (2016-03-03)
9181 ==========================
9182
9183 Libraries
9184 ---------
9185
9186 * Stabilized APIs
9187   * `Path`
9188     * [`Path::strip_prefix`] (renamed from relative_from)
9189     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
9190   * `Ipv4Addr`
9191     * [`Ipv4Addr::is_loopback`]
9192     * [`Ipv4Addr::is_private`]
9193     * [`Ipv4Addr::is_link_local`]
9194     * [`Ipv4Addr::is_multicast`]
9195     * [`Ipv4Addr::is_broadcast`]
9196     * [`Ipv4Addr::is_documentation`]
9197   * `Ipv6Addr`
9198     * [`Ipv6Addr::is_unspecified`]
9199     * [`Ipv6Addr::is_loopback`]
9200     * [`Ipv6Addr::is_multicast`]
9201   * `Vec`
9202     * [`Vec::as_slice`]
9203     * [`Vec::as_mut_slice`]
9204   * `String`
9205     * [`String::as_str`]
9206     * [`String::as_mut_str`]
9207   * Slices
9208     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
9209     be the same length
9210     * `<[T]>::`[`sort_by_key`]
9211   * checked, saturated, and overflowing operations
9212     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
9213     * [`i32::saturating_mul`]
9214     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
9215     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
9216     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
9217     * [`u32::saturating_mul`]
9218     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
9219     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
9220     * and checked, saturated, and overflowing operations for other primitive types
9221   * FFI
9222     * [`ffi::IntoStringError`]
9223     * [`CString::into_string`]
9224     * [`CString::into_bytes`]
9225     * [`CString::into_bytes_with_nul`]
9226     * `From<CString> for Vec<u8>`
9227   * `IntoStringError`
9228     * [`IntoStringError::into_cstring`]
9229     * [`IntoStringError::utf8_error`]
9230     * `Error for IntoStringError`
9231   * Hashing
9232     * [`std::hash::BuildHasher`]
9233     * [`BuildHasher::Hasher`]
9234     * [`BuildHasher::build_hasher`]
9235     * [`std::hash::BuildHasherDefault`]
9236     * [`HashMap::with_hasher`]
9237     * [`HashMap::with_capacity_and_hasher`]
9238     * [`HashSet::with_hasher`]
9239     * [`HashSet::with_capacity_and_hasher`]
9240     * [`std::collections::hash_map::RandomState`]
9241     * [`RandomState::new`]
9242 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
9243   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
9244   from bytes is faster.
9245 * [The performance of `LineWriter` (and thus `io::stdout`) was
9246   improved by using `memchr` to search for newlines][1.7m].
9247 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
9248   `f64` variants were stabilized previously.
9249 * [`BTreeMap` was rewritten to use less memory and improve the performance
9250   of insertion and iteration, the latter by as much as 5x][1.7bm].
9251 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
9252   covariant over their contained type][1.7bt].
9253 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
9254   over their contained type][1.7ll].
9255 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
9256   searching methods.
9257 * [`Any` is implemented for unsized types][1.7a].
9258 * [`Hash` is implemented for `Duration`][1.7h].
9259
9260 Misc
9261 ----
9262
9263 * [When running tests with `--test`, rustdoc will pass `--cfg`
9264   arguments to the compiler][1.7dt].
9265 * [The compiler is built with RPATH information by default][1.7rpa].
9266   This means that it will be possible to run `rustc` when installed in
9267   unusual configurations without configuring the dynamic linker search
9268   path explicitly.
9269 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
9270   any RPATH entries (emitted with `-C rpath`) *not* take precedence
9271   over `LD_LIBRARY_PATH`.
9272
9273 Cargo
9274 -----
9275
9276 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
9277   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
9278 * [The `rerun-if-changed` build script directive no longer causes the
9279   build script to incorrectly run twice in certain scenarios][1.7rr].
9280
9281 Compatibility Notes
9282 -------------------
9283
9284 * Soundness fixes to the interactions between associated types and
9285   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
9286   code that violates the new rules. This is a significant change that
9287   is known to break existing code, so it has emitted warnings for the
9288   new error cases since 1.4 to give crate authors time to adapt. The
9289   details of what is changing are subtle; read the RFC for more.
9290 * [Several bugs in the compiler's visibility calculations were
9291   fixed][1.7v]. Since this was found to break significant amounts of
9292   code, the new errors will be emitted as warnings for several release
9293   cycles, under the `private_in_public` lint.
9294 * Defaulted type parameters were accidentally accepted in positions
9295   that were not intended. In this release, [defaulted type parameters
9296   appearing outside of type definitions will generate a
9297   warning][1.7d], which will become an error in future releases.
9298 * [Parsing "." as a float results in an error instead of 0][1.7p].
9299   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
9300 * [Borrows of closure parameters may not outlive the closure][1.7bc].
9301
9302 [1.7a]: https://github.com/rust-lang/rust/pull/30928
9303 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
9304 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
9305 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
9306 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
9307 [1.7d]: https://github.com/rust-lang/rust/pull/30724
9308 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
9309 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
9310 [1.7f]: https://github.com/rust-lang/rust/pull/30672
9311 [1.7h]: https://github.com/rust-lang/rust/pull/30818
9312 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
9313 [1.7m]: https://github.com/rust-lang/rust/pull/30381
9314 [1.7p]: https://github.com/rust-lang/rust/pull/30681
9315 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
9316 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
9317 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
9318 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
9319 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
9320 [1.7v]: https://github.com/rust-lang/rust/pull/29973
9321 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
9322 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
9323 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
9324 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
9325 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
9326 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
9327 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
9328 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
9329 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
9330 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
9331 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
9332 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
9333 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
9334 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
9335 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
9336 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
9337 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
9338 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
9339 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
9340 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
9341 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
9342 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
9343 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
9344 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
9345 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
9346 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
9347 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
9348 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
9349 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
9350 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
9351 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
9352 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
9353 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
9354 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
9355 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
9356 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
9357 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
9358 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
9359 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
9360 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
9361 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
9362 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
9363 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
9364 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
9365 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
9366 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
9367 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
9368 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
9369 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
9370 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
9371 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
9372 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
9373 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
9374 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
9375 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
9376 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
9377 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
9378 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
9379 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
9380 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
9381
9382
9383 Version 1.6.0 (2016-01-21)
9384 ==========================
9385
9386 Language
9387 --------
9388
9389 * The `#![no_std]` attribute causes a crate to not be linked to the
9390   standard library, but only the [core library][1.6co], as described
9391   in [RFC 1184]. The core library defines common types and traits but
9392   has no platform dependencies whatsoever, and is the basis for Rust
9393   software in environments that cannot support a full port of the
9394   standard library, such as operating systems. Most of the core
9395   library is now stable.
9396
9397 Libraries
9398 ---------
9399
9400 * Stabilized APIs:
9401   [`Read::read_exact`],
9402   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
9403   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
9404   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
9405   [`os::unix::fs::DirBuilderExt`],
9406   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
9407   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
9408   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
9409   [`collections::hash_map::Drain`],
9410   [`collections::hash_map::HashMap::drain`],
9411   [`collections::hash_set::Drain`],
9412   [`collections::hash_set::HashSet::drain`],
9413   [`collections::binary_heap::Drain`],
9414   [`collections::binary_heap::BinaryHeap::drain`],
9415   [`Vec::extend_from_slice`] (renamed from `push_all`),
9416   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
9417   [`RwLock::into_inner`],
9418   [`Iterator::min_by_key`] (renamed from `min_by`),
9419   [`Iterator::max_by_key`] (renamed from `max_by`).
9420 * The [core library][1.6co] is stable, as are most of its APIs.
9421 * [The `assert_eq!` macro supports arguments that don't implement
9422   `Sized`][1.6ae], such as arrays. In this way it behaves more like
9423   `assert!`.
9424 * Several timer functions that take duration in milliseconds [are
9425   deprecated in favor of those that take `Duration`][1.6ms]. These
9426   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
9427   `thread::park_timeout_ms`.
9428 * The algorithm by which `Vec` reserves additional elements was
9429   [tweaked to not allocate excessive space][1.6a] while still growing
9430   exponentially.
9431 * `From` conversions are [implemented from integers to floats][1.6f]
9432   in cases where the conversion is lossless. Thus they are not
9433   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
9434   or `f64`. They are also not implemented for `isize` and `usize`
9435   because the implementations would be platform-specific. `From` is
9436   also implemented from `f32` to `f64`.
9437 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
9438 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
9439 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
9440 * [`BinaryHeap` was refactored][1.6bh] for modest performance
9441   improvements.
9442 * Sorting slices that are already sorted [is 50% faster in some
9443   cases][1.6s].
9444
9445 Cargo
9446 -----
9447
9448 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
9449 * Cargo build scripts can specify their dependencies by emitting the
9450   [`rerun-if-changed`][1.6rr] key.
9451 * crates.io will reject publication of crates with dependencies that
9452   have a wildcard version constraint. Crates with wildcard
9453   dependencies were seen to cause a variety of problems, as described
9454   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
9455   warning.
9456 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
9457   release folder.  A variety of artifacts that Cargo failed to clean
9458   are now correctly deleted.
9459
9460 Misc
9461 ----
9462
9463 * The `unreachable_code` lint [warns when a function call's argument
9464   diverges][1.6dv].
9465 * The parser indicates [failures that may be caused by
9466   confusingly-similar Unicode characters][1.6uc]
9467 * Certain macro errors [are reported at definition time][1.6m], not
9468   expansion.
9469
9470 Compatibility Notes
9471 -------------------
9472
9473 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
9474   environment variable when locating crates. This was a pre-cargo
9475   feature for integrating with the package manager that was
9476   accidentally never removed.
9477 * [A number of bugs were fixed in the privacy checker][1.6p] that
9478   could cause previously-accepted code to break.
9479 * [Modules and unit/tuple structs may not share the same name][1.6ts].
9480 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
9481   struct pattern syntax (`Foo(..)`) can no longer be used to match
9482   unit structs. This is a warning now, but will become an error in
9483   future releases. Patterns that share the same name as a const are
9484   now an error.
9485 * A bug was fixed that causes [rustc not to apply default type
9486   parameters][1.6xc] when resolving certain method implementations of
9487   traits defined in other crates.
9488
9489 [1.6a]: https://github.com/rust-lang/rust/pull/29454
9490 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
9491 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
9492 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
9493 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
9494 [1.6co]: http://doc.rust-lang.org/core/index.html
9495 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
9496 [1.6f]: https://github.com/rust-lang/rust/pull/29129
9497 [1.6m]: https://github.com/rust-lang/rust/pull/29828
9498 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
9499 [1.6p]: https://github.com/rust-lang/rust/pull/29726
9500 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
9501 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
9502 [1.6s]: https://github.com/rust-lang/rust/pull/29675
9503 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
9504 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
9505 [1.6us]: https://github.com/rust-lang/rust/pull/29383
9506 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
9507 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
9508 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
9509 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
9510 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
9511 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
9512 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
9513 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
9514 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
9515 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
9516 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
9517 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
9518 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
9519 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
9520 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
9521 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
9522 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
9523 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
9524 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
9525 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
9526 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
9527 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
9528 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
9529 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
9530 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
9531 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
9532 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
9533 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
9534 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
9535 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
9536
9537
9538 Version 1.5.0 (2015-12-10)
9539 ==========================
9540
9541 * ~700 changes, numerous bugfixes
9542
9543 Highlights
9544 ----------
9545
9546 * Stabilized APIs:
9547   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
9548   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
9549   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
9550   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
9551   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
9552   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
9553   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
9554   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
9555   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
9556   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
9557   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
9558   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
9559   [`Path::read_link`], [`Path::symlink_metadata`],
9560   [`Utf8Error::valid_up_to`], [`Vec::resize`],
9561   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
9562   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
9563   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
9564   [`slice::split_first_mut`], [`slice::split_first`],
9565   [`slice::split_last_mut`], [`slice::split_last`],
9566   [`char::from_u32_unchecked`], [`fs::canonicalize`],
9567   [`str::MatchIndices`], [`str::RMatchIndices`],
9568   [`str::match_indices`], [`str::rmatch_indices`],
9569   [`str::slice_mut_unchecked`], [`string::ParseError`].
9570 * Rust applications hosted on crates.io can be installed locally to
9571   `~/.cargo/bin` with the [`cargo install`] command. Among other
9572   things this makes it easier to augment Cargo with new subcommands:
9573   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
9574   invoked as `cargo foo`.
9575 * Crates with wildcard (`*`) dependencies will [emit warnings when
9576   published][1.5w]. In 1.6 it will no longer be possible to publish
9577   crates with wildcard dependencies.
9578
9579 Breaking Changes
9580 ----------------
9581
9582 * The rules determining when a particular lifetime must outlive
9583   a particular value (known as '[dropck]') have been [modified
9584   to not rely on parametricity][1.5p].
9585 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
9586   and `Arc`][1.5a]. Because these smart pointer types implement
9587   `Deref`, this causes breakage in cases where the interior type
9588   contains methods of the same name.
9589 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
9590   that they could drop their content. Soundness fix.
9591 * All method invocations are [properly checked][1.5wf1] for
9592   [well-formedness][1.5wf2]. Soundness fix.
9593 * Traits whose supertraits contain `Self` are [not object
9594   safe][1.5o]. Soundness fix.
9595 * Target specifications support a [`no_default_libraries`][1.5nd]
9596   setting that controls whether `-nodefaultlibs` is passed to the
9597   linker, and in turn the `is_like_windows` setting no longer affects
9598   the `-nodefaultlibs` flag.
9599 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
9600 * The `#[inline]` and `#[repr]` attributes [can only appear
9601   in valid locations][1.5at].
9602 * Native libraries linked from the local crate are [passed to
9603   the linker before native libraries from upstream crates][1.5nl].
9604 * Two rarely-used attributes, `#[no_debug]` and
9605   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
9606 * Negation of unsigned integers, which has been a warning for
9607   several releases, [is now behind a feature gate and will
9608   generate errors][1.5nu].
9609 * The parser accidentally accepted visibility modifiers on
9610   enum variants, a bug [which has been fixed][1.5ev].
9611 * [A bug was fixed that allowed `use` statements to import unstable
9612   features][1.5use].
9613
9614 Language
9615 --------
9616
9617 * When evaluating expressions at compile-time that are not
9618   compile-time constants (const-evaluating expressions in non-const
9619   contexts), incorrect code such as overlong bitshifts and arithmetic
9620   overflow will [generate a warning instead of an error][1.5ce],
9621   delaying the error until runtime. This will allow the
9622   const-evaluator to be expanded in the future backwards-compatibly.
9623 * The `improper_ctypes` lint [no longer warns about using `isize` and
9624   `usize` in FFI][1.5ict].
9625
9626 Libraries
9627 ---------
9628
9629 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
9630   invariant][1.5c].
9631 * `Default` is [implemented for mutable slices][1.5d].
9632 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
9633 * There are now `From` conversions [between floating point
9634   types][1.5f] where the conversions are lossless.
9635 * There are now `From` conversions [between integer types][1.5i] where
9636   the conversions are lossless.
9637 * [`fs::Metadata` implements `Clone`][1.5fs].
9638 * The `parse` method [accepts a leading "+" when parsing
9639   integers][1.5pi].
9640 * [`AsMut` is implemented for `Vec`][1.5am].
9641 * The `clone_from` implementations for `String` and `BinaryHeap` [have
9642   been optimized][1.5cf] and no longer rely on the default impl.
9643 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
9644   `unsafe extern "C"` function types now [implement `Clone`,
9645   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
9646   `fmt::Debug` for up to 12 arguments][1.5fp].
9647 * [Dropping `Vec`s is much faster in unoptimized builds when the
9648   element types don't implement `Drop`][1.5dv].
9649 * A bug that caused in incorrect behavior when [combining `VecDeque`
9650   with zero-sized types][1.5vdz] was resolved.
9651 * [`PartialOrd` for slices is faster][1.5po].
9652
9653 Miscellaneous
9654 -------------
9655
9656 * [Crate metadata size was reduced by 20%][1.5md].
9657 * [Improvements to code generation reduced the size of libcore by 3.3
9658   MB and rustc's memory usage by 18MB][1.5m].
9659 * [Improvements to deref translation increased performance in
9660   unoptimized builds][1.5dr].
9661 * Various errors in trait resolution [are deduplicated to only be
9662   reported once][1.5te].
9663 * Rust has preliminary [support for rumprun kernels][1.5rr].
9664 * Rust has preliminary [support for NetBSD on amd64][1.5na].
9665
9666 [1.5use]: https://github.com/rust-lang/rust/pull/28364
9667 [1.5po]: https://github.com/rust-lang/rust/pull/28436
9668 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
9669 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
9670 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
9671 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
9672 [1.5md]: https://github.com/rust-lang/rust/pull/28521
9673 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
9674 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
9675 [1.5na]: https://github.com/rust-lang/rust/pull/28543
9676 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
9677 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
9678 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
9679 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
9680 [1.5te]: https://github.com/rust-lang/rust/pull/28645
9681 [1.5at]: https://github.com/rust-lang/rust/pull/28650
9682 [1.5am]: https://github.com/rust-lang/rust/pull/28663
9683 [1.5m]: https://github.com/rust-lang/rust/pull/28778
9684 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
9685 [1.5a]: https://github.com/rust-lang/rust/pull/28811
9686 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
9687 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
9688 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
9689 [1.5i]: https://github.com/rust-lang/rust/pull/28921
9690 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
9691 [1.5f]: https://github.com/rust-lang/rust/pull/29129
9692 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
9693 [1.5s]: https://github.com/rust-lang/rust/pull/29190
9694 [1.5d]: https://github.com/rust-lang/rust/pull/29245
9695 [1.5o]: https://github.com/rust-lang/rust/pull/29259
9696 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
9697 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
9698 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
9699 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
9700 [1.5c]: https://github.com/rust-lang/rust/pull/29110
9701 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
9702 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
9703 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
9704 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
9705 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
9706 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
9707 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
9708 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
9709 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
9710 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
9711 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
9712 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
9713 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
9714 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
9715 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
9716 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
9717 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
9718 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
9719 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
9720 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
9721 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
9722 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
9723 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
9724 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
9725 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
9726 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
9727 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
9728 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
9729 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
9730 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
9731 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
9732 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
9733 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
9734 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
9735 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
9736 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
9737 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
9738 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
9739 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
9740 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
9741 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
9742 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
9743 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
9744 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
9745 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
9746 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
9747 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
9748 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
9749 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
9750 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
9751 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
9752 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
9753 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
9754 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
9755
9756 Version 1.4.0 (2015-10-29)
9757 ==========================
9758
9759 * ~1200 changes, numerous bugfixes
9760
9761 Highlights
9762 ----------
9763
9764 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
9765   GNU) are now supported and recommended for use.
9766
9767 Breaking Changes
9768 ----------------
9769
9770 * [Several changes have been made to fix type soundness and improve
9771   the behavior of associated types][sound]. See [RFC 1214]. Although
9772   we have mostly introduced these changes as warnings this release, to
9773   become errors next release, there are still some scenarios that will
9774   see immediate breakage.
9775 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
9776   line breaks in addition to `\n`][crlf].
9777 * [Loans of `'static` lifetime extend to the end of a function][stat].
9778 * [`str::parse` no longer introduces avoidable rounding error when
9779   parsing floating point numbers. Together with earlier changes to
9780   float formatting/output, "round trips" like f.to_string().parse()
9781   now preserve the value of f exactly. Additionally, leading plus
9782   signs are now accepted][fp3].
9783
9784
9785 Language
9786 --------
9787
9788 * `use` statements that import multiple items [can now rename
9789   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
9790 * [Binops work correctly on fat pointers][binfat].
9791 * `pub extern crate`, which does not behave as expected, [issues a
9792   warning][pec] until a better solution is found.
9793
9794 Libraries
9795 ---------
9796
9797 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
9798   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
9799   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
9800   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
9801   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
9802   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
9803   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
9804   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
9805   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
9806   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
9807   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
9808   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
9809   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
9810   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
9811   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
9812   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
9813   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
9814   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
9815   [`thread::sleep`].
9816 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
9817   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
9818   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
9819   `f64::from_str_radix`.
9820 * [Reverse-searching strings is faster with the 'two-way'
9821   algorithm][s].
9822 * [`std::io::copy` allows `?Sized` arguments][cc].
9823 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
9824   [override `count`, `nth` and `last` with an *O*(1)
9825   implementation][it].
9826 * [`Default` is implemented for arrays up to `[T; 32]`][d].
9827 * [`IntoRawFd` has been added to the Unix-specific prelude,
9828   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
9829   prelude][pr].
9830 * [`Extend<String>` and `FromIterator<String` are both implemented for
9831   `String`][es].
9832 * [`IntoIterator` is implemented for references to `Option` and
9833   `Result`][into2].
9834 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
9835   Copy`][ext] as part of [RFC 839]. This will cause type inference
9836   breakage in rare situations.
9837 * [`BinaryHeap` implements `Debug`][bh2].
9838 * [`Borrow` and `BorrowMut` are implemented for fixed-size
9839   arrays][bm].
9840 * [`extern fn`s with the "Rust" and "C" ABIs implement common
9841   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
9842 * [String comparison is faster][faststr].
9843 * `&mut T` where `T: std::fmt::Write` [also implements
9844   `std::fmt::Write`][mutw].
9845 * [A stable regression in `VecDeque::push_back` and other
9846   capacity-altering methods that caused panics for zero-sized types
9847   was fixed][vd].
9848 * [Function pointers implement traits for up to 12 parameters][fp2].
9849
9850 Miscellaneous
9851 -------------
9852
9853 * The compiler [no longer uses the 'morestack' feature to prevent
9854   stack overflow][mm]. Instead it uses guard pages and stack
9855   probes (though stack probes are not yet implemented on any platform
9856   but Windows).
9857 * [The compiler matches traits faster when projections are involved][p].
9858 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
9859   `usize`][ffi].
9860 * [Cargo now displays useful information about what its doing during
9861   `cargo update`][cu].
9862
9863 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
9864 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
9865 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
9866 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
9867 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
9868 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
9869 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
9870 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
9871 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
9872 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
9873 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
9874 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
9875 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
9876 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
9877 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
9878 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
9879 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
9880 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
9881 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
9882 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
9883 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
9884 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
9885 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
9886 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
9887 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
9888 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
9889 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
9890 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
9891 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
9892 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
9893 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
9894 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
9895 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
9896 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
9897 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
9898 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
9899 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
9900 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
9901 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
9902 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
9903 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
9904 [bh2]: https://github.com/rust-lang/rust/pull/28156
9905 [binfat]: https://github.com/rust-lang/rust/pull/28270
9906 [bm]: https://github.com/rust-lang/rust/pull/28197
9907 [cc]: https://github.com/rust-lang/rust/pull/27531
9908 [crlf]: https://github.com/rust-lang/rust/pull/28034
9909 [cu]: https://github.com/rust-lang/cargo/pull/1931
9910 [d]: https://github.com/rust-lang/rust/pull/27825
9911 [dep]: https://github.com/rust-lang/rust/pull/28339
9912 [es]: https://github.com/rust-lang/rust/pull/27956
9913 [ext]: https://github.com/rust-lang/rust/pull/28094
9914 [faststr]: https://github.com/rust-lang/rust/pull/28338
9915 [ffi]: https://github.com/rust-lang/rust/pull/28779
9916 [fp]: https://github.com/rust-lang/rust/pull/28268
9917 [fp2]: https://github.com/rust-lang/rust/pull/28560
9918 [fp3]: https://github.com/rust-lang/rust/pull/27307
9919 [i]: https://github.com/rust-lang/rust/pull/27451
9920 [into2]: https://github.com/rust-lang/rust/pull/28039
9921 [it]: https://github.com/rust-lang/rust/pull/27652
9922 [mm]: https://github.com/rust-lang/rust/pull/27338
9923 [mutw]: https://github.com/rust-lang/rust/pull/28368
9924 [sound]: https://github.com/rust-lang/rust/pull/27641
9925 [p]: https://github.com/rust-lang/rust/pull/27866
9926 [pec]: https://github.com/rust-lang/rust/pull/28486
9927 [pr]: https://github.com/rust-lang/rust/pull/27896
9928 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
9929 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
9930 [s]: https://github.com/rust-lang/rust/pull/27474
9931 [stab]: https://github.com/rust-lang/rust/pull/28339
9932 [stat]: https://github.com/rust-lang/rust/pull/28321
9933 [vd]: https://github.com/rust-lang/rust/pull/28494
9934
9935 Version 1.3.0 (2015-09-17)
9936 ==============================
9937
9938 * ~900 changes, numerous bugfixes
9939
9940 Highlights
9941 ----------
9942
9943 * The [new object lifetime defaults][nold] have been [turned
9944   on][nold2] after a cycle of warnings about the change. Now types
9945   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
9946   being interpreted as `&'a Box<Trait+'a>` to `&'a
9947   Box<Trait+'static>`.
9948 * [The Rustonomicon][nom] is a new book in the official documentation
9949   that dives into writing unsafe Rust.
9950 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
9951   timekeeping is employed by other std APIs, as well as out-of-tree
9952   time crates.
9953
9954 Breaking Changes
9955 ----------------
9956
9957 * The [new object lifetime defaults][nold] have been [turned
9958   on][nold2] after a cycle of warnings about the change.
9959 * There is a known [regression][lr] in how object lifetime elision is
9960   interpreted, the proper solution for which is undetermined.
9961 * The `#[prelude_import]` attribute, an internal implementation
9962   detail, was accidentally stabilized previously. [It has been put
9963   behind the `prelude_import` feature gate][pi]. This change is
9964   believed to break no existing code.
9965 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
9966   [more sane for dynamically sized types][dst3]. Code that relied on
9967   the previous behavior is thought to be broken.
9968 * The `dropck` rules, which checks that destructors can't access
9969   destroyed values, [have been updated][dropck] to match the
9970   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
9971   cause some previously-compiling code to no longer build.
9972
9973 Language
9974 --------
9975
9976 * The [new object lifetime defaults][nold] have been [turned
9977   on][nold2] after a cycle of warnings about the change.
9978 * Semicolons may [now follow types and paths in
9979   macros](https://github.com/rust-lang/rust/pull/27000).
9980 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
9981   [more sane for dynamically sized types][dst3]. Code that relied on
9982   the previous behavior is not known to exist, and suspected to be
9983   broken.
9984 * `'static` variables [may now be recursive][st].
9985 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
9986   implementations correctly.
9987 * The `dropck` rules, which checks that destructors can't access
9988   destroyed values, [have been updated][dropck] to match the
9989   [RFC][dropckrfc].
9990
9991 Libraries
9992 ---------
9993
9994 * The [`Duration`] API, [has been stabilized][ds], as well as the
9995   `std::time` module, which presently contains only `Duration`.
9996 * `Box<str>` and `Box<[T]>` both implement `Clone`.
9997 * The owned C string, [`CString`], implements [`Borrow`] and the
9998   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
9999   these allow C strings to be borrowed and cloned in generic code.
10000 * [`CStr`] implements [`Debug`].
10001 * [`AtomicPtr`] implements [`Debug`].
10002 * [`Error`] trait objects [can be downcast to their concrete types][e]
10003   in many common configurations, using the [`is`], [`downcast`],
10004   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
10005   [`Any`] trait.
10006 * Searching for substrings now [employs the two-way algorithm][search]
10007   instead of doing a naive search. This gives major speedups to a
10008   number of methods, including [`contains`][sc], [`find`][sf],
10009   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
10010   [`ends_with`][sew] are also faster.
10011 * The performance of `PartialEq` for slices is [much faster][ps].
10012 * The [`Hash`] trait offers the default method, [`hash_slice`], which
10013   is overridden and optimized by the implementations for scalars.
10014 * The [`Hasher`] trait now has a number of specialized `write_*`
10015   methods for primitive types, for efficiency.
10016 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
10017   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
10018   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
10019   of [`std::error::Error::cause`][iec] also delegates to the inner
10020   error.
10021 * [`process::Child`][pc] gained the [`id`] method, which returns a
10022   `u32` representing the platform-specific process identifier.
10023 * The [`connect`] method on slices is deprecated, replaced by the new
10024   [`join`] method (note that both of these are on the *unstable*
10025   [`SliceConcatExt`] trait, but through the magic of the prelude are
10026   available to stable code anyway).
10027 * The [`Div`] operator is implemented for [`Wrapping`] types.
10028 * [`DerefMut` is implemented for `String`][dms].
10029 * Performance of SipHash (the default hasher for `HashMap`) is
10030   [better for long data][sh].
10031 * [`AtomicPtr`] implements [`Send`].
10032 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
10033   are now [specialized to use uninitialized buffers for increased
10034   performance][rte].
10035 * Lifetime parameters of foreign functions [are now resolved
10036   properly][f].
10037
10038 Misc
10039 ----
10040
10041 * Rust can now, with some coercion, [produce programs that run on
10042   Windows XP][xp], though XP is not considered a supported platform.
10043 * Porting Rust on Windows from the GNU toolchain to MSVC continues
10044   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
10045   recommended for use in 1.3, though should be fully-functional
10046   in the [64-bit 1.4 beta][b14].
10047 * On Fedora-based systems installation will [properly configure the
10048   dynamic linker][fl].
10049 * The compiler gained many new extended error descriptions, which can
10050   be accessed with the `--explain` flag.
10051 * The `dropck` pass, which checks that destructors can't access
10052   destroyed values, [has been rewritten][27261]. This fixes some
10053   soundness holes, and as such will cause some previously-compiling
10054   code to no longer build.
10055 * `rustc` now uses [LLVM to write archive files where possible][ar].
10056   Eventually this will eliminate the compiler's dependency on the ar
10057   utility.
10058 * Rust has [preliminary support for i686 FreeBSD][26959] (it has long
10059   supported FreeBSD on x86_64).
10060 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
10061   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
10062   more strict.
10063 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
10064   will kill the process instead of leaking][nlp].
10065
10066 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
10067 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
10068 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
10069 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
10070 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
10071 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
10072 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
10073 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
10074 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
10075 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
10076 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
10077 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
10078 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
10079 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
10080 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
10081 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
10082 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
10083 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
10084 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
10085 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
10086 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
10087 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
10088 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
10089 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
10090 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
10091 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
10092 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
10093 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
10094 [ar]: https://github.com/rust-lang/rust/pull/26926
10095 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
10096 [dms]: https://github.com/rust-lang/rust/pull/26241
10097 [27261]: https://github.com/rust-lang/rust/pull/27261
10098 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
10099 [ds]: https://github.com/rust-lang/rust/pull/26818
10100 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
10101 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
10102 [dst3]: https://github.com/rust-lang/rust/pull/27351
10103 [e]: https://github.com/rust-lang/rust/pull/24793
10104 [f]: https://github.com/rust-lang/rust/pull/26588
10105 [26959]: https://github.com/rust-lang/rust/pull/26959
10106 [fl]: https://github.com/rust-lang/rust-installer/pull/41
10107 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
10108 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
10109 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
10110 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
10111 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
10112 [lic]: https://github.com/rust-lang/rust/pull/26583
10113 [lnu]: https://github.com/rust-lang/rust/pull/27026
10114 [lr]: https://github.com/rust-lang/rust/issues/27248
10115 [lum]: https://github.com/rust-lang/rust/pull/26378
10116 [lur]: https://github.com/rust-lang/rust/pull/26783
10117 [nlp]: https://github.com/rust-lang/rust/pull/27176
10118 [nold2]: https://github.com/rust-lang/rust/pull/27045
10119 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
10120 [nom]: http://doc.rust-lang.org/nightly/nomicon/
10121 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
10122 [pi]: https://github.com/rust-lang/rust/pull/26699
10123 [ps]: https://github.com/rust-lang/rust/pull/26884
10124 [rte]: https://github.com/rust-lang/rust/pull/26950
10125 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
10126 [search]: https://github.com/rust-lang/rust/pull/26327
10127 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
10128 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
10129 [sh]: https://github.com/rust-lang/rust/pull/27280
10130 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
10131 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
10132 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
10133 [st]: https://github.com/rust-lang/rust/pull/26630
10134 [win1]: https://github.com/rust-lang/rust/pull/26569
10135 [win2]: https://github.com/rust-lang/rust/pull/26741
10136 [win3]: https://github.com/rust-lang/rust/pull/26741
10137 [win4]: https://github.com/rust-lang/rust/pull/27210
10138 [xp]: https://github.com/rust-lang/rust/pull/26569
10139
10140 Version 1.2.0 (2015-08-07)
10141 ==========================
10142
10143 * ~1200 changes, numerous bugfixes
10144
10145 Highlights
10146 ----------
10147
10148 * [Dynamically-sized-type coercions][dst] allow smart pointer types
10149   like `Rc` to contain types without a fixed size, arrays and trait
10150   objects, finally enabling use of `Rc<[T]>` and completing the
10151   implementation of DST.
10152 * [Parallel codegen][parcodegen] is now working again, which can
10153   substantially speed up large builds in debug mode; It also gets
10154   another ~33% speedup when bootstrapping on a 4 core machine (using 8
10155   jobs). It's not enabled by default, but will be "in the near
10156   future". It can be activated with the `-C codegen-units=N` flag to
10157   `rustc`.
10158 * This is the first release with [experimental support for linking
10159   with the MSVC linker and lib C on Windows (instead of using the GNU
10160   variants via MinGW)][win]. It is yet recommended only for the most
10161   intrepid Rustaceans.
10162 * Benchmark compilations are showing a 30% improvement in
10163   bootstrapping over 1.1.
10164
10165 Breaking Changes
10166 ----------------
10167
10168 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
10169   unicode case mapping, which is a previously-planned change in
10170   behavior and considered a bugfix.
10171 * [`mem::align_of`] now specifies [the *minimum alignment* for
10172   T][align], which is usually the alignment programs are interested
10173   in, and the same value reported by clang's
10174   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
10175   break real code.
10176 * [The `#[packed]` attribute is no longer silently accepted by the
10177   compiler][packed]. This attribute did nothing and code that
10178   mentioned it likely did not work as intended.
10179 * Associated type defaults are [now behind the
10180   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
10181   defaults *did not work*, but could be mentioned syntactically. As
10182   such this breakage has minimal impact.
10183
10184 Language
10185 --------
10186
10187 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
10188   matching against dereferenceable values.
10189
10190 Libraries
10191 ---------
10192
10193 * The [`Extend`] trait, which grows a collection from an iterator, is
10194   implemented over iterators of references, for `String`, `Vec`,
10195   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
10196   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
10197 * The [`iter::once`] function returns an iterator that yields a single
10198   element, and [`iter::empty`] returns an iterator that yields no
10199   elements.
10200 * The [`matches`] and [`rmatches`] methods on `str` return iterators
10201   over substring matches.
10202 * [`Cell`] and [`RefCell`] both implement `Eq`.
10203 * A number of methods for wrapping arithmetic are added to the
10204   integral types, [`wrapping_div`], [`wrapping_rem`],
10205   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
10206   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
10207   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
10208   type.. It is illegal for the default arithmetic operations in Rust
10209   to overflow; the desire to wrap must be explicit.
10210 * The `{:#?}` formatting specifier [displays the alternate,
10211   pretty-printed][debugfmt] form of the `Debug` formatter. This
10212   feature was actually introduced prior to 1.0 with little
10213   fanfare.
10214 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
10215   for writing data to formatted strings, similar to [`io::Write`].
10216 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
10217   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
10218   are used by code generators to emit implementations of [`Debug`].
10219 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
10220   methods that convert case, following Unicode case mapping.
10221 * It is now easier to handle poisoned locks. The [`PoisonError`]
10222   type, returned by failing lock operations, exposes `into_inner`,
10223   `get_ref`, and `get_mut`, which all give access to the inner lock
10224   guard, and allow the poisoned lock to continue to operate. The
10225   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
10226   poisoned lock without attempting to take the lock.
10227 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
10228   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
10229   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
10230   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
10231   `ChildStderr`.
10232 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
10233   malformed input.
10234
10235 Misc
10236 ----
10237
10238 * `rustc` employs smarter heuristics for guessing at [typos].
10239 * `rustc` emits more efficient code for [no-op conversions between
10240   unsafe pointers][nop].
10241 * Fat pointers are now [passed in pairs of immediate arguments][fat],
10242   resulting in faster compile times and smaller code.
10243
10244 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
10245 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
10246 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
10247 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
10248 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
10249 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
10250 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
10251 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
10252 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
10253 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
10254 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
10255 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
10256 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
10257 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
10258 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
10259 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
10260 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
10261 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
10262 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
10263 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
10264 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
10265 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
10266 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
10267 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
10268 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
10269 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
10270 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
10271 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
10272 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
10273 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
10274 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
10275 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
10276 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
10277 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
10278 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
10279 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
10280 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
10281 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
10282 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
10283 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
10284 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
10285 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
10286 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
10287 [align]: https://github.com/rust-lang/rust/pull/25646
10288 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
10289 [typos]: https://github.com/rust-lang/rust/pull/26087
10290 [nop]: https://github.com/rust-lang/rust/pull/26336
10291 [fat]: https://github.com/rust-lang/rust/pull/26411
10292 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
10293 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
10294 [packed]: https://github.com/rust-lang/rust/pull/25541
10295 [ad]: https://github.com/rust-lang/rust/pull/27382
10296 [win]: https://github.com/rust-lang/rust/pull/25350
10297
10298 Version 1.1.0 (2015-06-25)
10299 =========================
10300
10301 * ~850 changes, numerous bugfixes
10302
10303 Highlights
10304 ----------
10305
10306 * The [`std::fs` module has been expanded][fs] to expand the set of
10307   functionality exposed:
10308   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
10309     don't incur a syscall on some platforms.
10310   * A `symlink_metadata` function has been added.
10311   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
10312     access to all underlying information.
10313 * The compiler now contains extended explanations of many errors. When an error
10314   with an explanation occurs the compiler suggests using the `--explain` flag
10315   to read the explanation. Error explanations are also [available online][err-index].
10316 * Thanks to multiple [improvements][sk] to [type checking][pre], as
10317   well as other work, the time to bootstrap the compiler decreased by
10318   32%.
10319
10320 Libraries
10321 ---------
10322
10323 * The [`str::split_whitespace`] method splits a string on unicode
10324   whitespace boundaries.
10325 * On both Windows and Unix, new extension traits provide conversion of
10326   I/O types to and from the underlying system handles. On Unix, these
10327   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
10328   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
10329   `TcpListener`, and `UpdSocket`. Further implementations for
10330   `std::process` will be stabilized later.
10331 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
10332   Windows, symlinks can be created with
10333   `std::os::windows::symlink_dir` and
10334   `std::os::windows::symlink_file`.
10335 * The `mpsc::Receiver` type can now be converted into an iterator with
10336   `into_iter` on the [`IntoIterator`] trait.
10337 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
10338   implementation of the [`From`] trait.
10339 * The `Debug` implementation for `RangeFull` [creates output that is
10340   more consistent with other implementations][rf].
10341 * [`Debug` is implemented for `File`][file].
10342 * The `Default` implementation for `Arc` [no longer requires `Sync +
10343   Send`][arc].
10344 * [The `Iterator` methods `count`, `nth`, and `last` have been
10345   overridden for slices to have *O*(1) performance instead of *O*(*n*)][si].
10346 * Incorrect handling of paths on Windows has been improved in both the
10347   compiler and the standard library.
10348 * [`AtomicPtr` gained a `Default` implementation][ap].
10349 * In accordance with Rust's policy on arithmetic overflow `abs` now
10350   [panics on overflow when debug assertions are enabled][abs].
10351 * The [`Cloned`] iterator, which was accidentally left unstable for
10352   1.0 [has been stabilized][c].
10353 * The [`Incoming`] iterator, which iterates over incoming TCP
10354   connections, and which was accidentally unnamable in 1.0, [is now
10355   properly exported][inc].
10356 * [`BinaryHeap`] no longer corrupts itself [when functions called by
10357   `sift_up` or `sift_down` panic][bh].
10358 * The [`split_off`] method of `LinkedList` [no longer corrupts
10359   the list in certain scenarios][ll].
10360
10361 Misc
10362 ----
10363
10364 * Type checking performance [has improved notably][sk] with
10365   [multiple improvements][pre].
10366 * The compiler [suggests code changes][ch] for more errors.
10367 * rustc and it's build system have experimental support for [building
10368   toolchains against MUSL][m] instead of glibc on Linux.
10369 * The compiler defines the `target_env` cfg value, which is used for
10370   distinguishing toolchains that are otherwise for the same
10371   platform. Presently this is set to `gnu` for common GNU Linux
10372   targets and for MinGW targets, and `musl` for MUSL Linux targets.
10373 * The [`cargo rustc`][crc] command invokes a build with custom flags
10374   to rustc.
10375 * [Android executables are always position independent][pie].
10376 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
10377   with `Drop`][24935].
10378
10379 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
10380 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
10381 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
10382 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
10383 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
10384 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
10385 [rf]: https://github.com/rust-lang/rust/pull/24491
10386 [err-index]: https://doc.rust-lang.org/error-index.html
10387 [sk]: https://github.com/rust-lang/rust/pull/24615
10388 [pre]: https://github.com/rust-lang/rust/pull/25323
10389 [file]: https://github.com/rust-lang/rust/pull/24598
10390 [ch]: https://github.com/rust-lang/rust/pull/24683
10391 [arc]: https://github.com/rust-lang/rust/pull/24695
10392 [si]: https://github.com/rust-lang/rust/pull/24701
10393 [ap]: https://github.com/rust-lang/rust/pull/24834
10394 [m]: https://github.com/rust-lang/rust/pull/24777
10395 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
10396 [crc]: https://github.com/rust-lang/cargo/pull/1568
10397 [pie]: https://github.com/rust-lang/rust/pull/24953
10398 [abs]: https://github.com/rust-lang/rust/pull/25441
10399 [c]: https://github.com/rust-lang/rust/pull/25496
10400 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
10401 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
10402 [inc]: https://github.com/rust-lang/rust/pull/25522
10403 [bh]: https://github.com/rust-lang/rust/pull/25856
10404 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
10405 [ll]: https://github.com/rust-lang/rust/pull/26022
10406 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
10407 [24935]: https://github.com/rust-lang/rust/pull/24935
10408
10409 Version 1.0.0 (2015-05-15)
10410 ========================
10411
10412 * ~1500 changes, numerous bugfixes
10413
10414 Highlights
10415 ----------
10416
10417 * The vast majority of the standard library is now `#[stable]`. It is
10418   no longer possible to use unstable features with a stable build of
10419   the compiler.
10420 * Many popular crates on [crates.io] now work on the stable release
10421   channel.
10422 * Arithmetic on basic integer types now [checks for overflow in debug
10423   builds][overflow].
10424
10425 Language
10426 --------
10427
10428 * Several [restrictions have been added to trait coherence][coh] in
10429   order to make it easier for upstream authors to change traits
10430   without breaking downstream code.
10431 * Digits of binary and octal literals are [lexed more eagerly][lex] to
10432   improve error messages and macro behavior. For example, `0b1234` is
10433   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
10434 * Trait bounds [are always invariant][inv], eliminating the need for
10435   the `PhantomFn` and `MarkerTrait` lang items, which have been
10436   removed.
10437 * ["-" is no longer a valid character in crate names][cr], the `extern crate
10438   "foo" as bar` syntax has been replaced with `extern crate foo as
10439   bar`, and Cargo now automatically translates "-" in *package* names
10440   to underscore for the crate name.
10441 * [Lifetime shadowing is an error][lt].
10442 * [`Send` no longer implies `'static`][send-rfc].
10443 * [UFCS now supports trait-less associated paths][moar-ufcs] like
10444   `MyType::default()`.
10445 * Primitive types [now have inherent methods][prim-inherent],
10446   obviating the need for extension traits like `SliceExt`.
10447 * Methods with `Self: Sized` in their `where` clause are [considered
10448   object-safe][self-sized], allowing many extension traits like
10449   `IteratorExt` to be merged into the traits they extended.
10450 * You can now [refer to associated types][assoc-where] whose
10451   corresponding trait bounds appear only in a `where` clause.
10452 * The final bits of [OIBIT landed][oibit-final], meaning that traits
10453   like `Send` and `Sync` are now library-defined.
10454 * A [Reflect trait][reflect] was introduced, which means that
10455   downcasting via the `Any` trait is effectively limited to concrete
10456   types. This helps retain the potentially-important "parametricity"
10457   property: generic code cannot behave differently for different type
10458   arguments except in minor ways.
10459 * The `unsafe_destructor` feature is now deprecated in favor of the
10460   [new `dropck`][rfc769]. This change is a major reduction in unsafe
10461   code.
10462
10463 Libraries
10464 ---------
10465
10466 * The `thread_local` module [has been renamed to `std::thread`][th].
10467 * The methods of `IteratorExt` [have been moved to the `Iterator`
10468   trait itself][23300].
10469 * Several traits that implement Rust's conventions for type
10470   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
10471   [centralized in the `std::convert` module][con].
10472 * The `FromError` trait [was removed in favor of `From`][fe].
10473 * The basic sleep function [has moved to
10474   `std::thread::sleep_ms`][slp].
10475 * The `splitn` function now takes an `n` parameter that represents the
10476   number of items yielded by the returned iterator [instead of the
10477   number of 'splits'][spl].
10478 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
10479 * [Derived implementations of `PartialOrd` now order enums according
10480   to their explicitly-assigned discriminants][po].
10481 * [Methods for searching strings are generic over `Pattern`s][pat],
10482   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
10483   some others.
10484 * [In method resolution, object methods are resolved before inherent
10485   methods][meth].
10486 * [`String::from_str` has been deprecated in favor of the `From` impl,
10487   `String::from`][24517].
10488 * [`io::Error` implements `Sync`][ios].
10489 * [The `words` method on `&str` has been replaced with
10490   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
10491   a word?'
10492 * The new path and IO modules are complete and `#[stable]`. This
10493   was the major library focus for this cycle.
10494 * The path API was [revised][path-normalize] to normalize `.`,
10495   adjusting the tradeoffs in favor of the most common usage.
10496 * A large number of remaining APIs in `std` were also stabilized
10497   during this cycle; about 75% of the non-deprecated API surface
10498   is now stable.
10499 * The new [string pattern API][string-pattern] landed, which makes
10500   the string slice API much more internally consistent and flexible.
10501 * A new set of [generic conversion traits][conversion] replaced
10502   many existing ad hoc traits.
10503 * Generic numeric traits were [completely removed][num-traits]. This
10504   was made possible thanks to inherent methods for primitive types,
10505   and the removal gives maximal flexibility for designing a numeric
10506   hierarchy in the future.
10507 * The `Fn` traits are now related via [inheritance][fn-inherit]
10508   and provide ergonomic [blanket implementations][fn-blanket].
10509 * The `Index` and `IndexMut` traits were changed to
10510   [take the index by value][index-value], enabling code like
10511   `hash_map["string"]` to work.
10512 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
10513   `Copy` data is known to be `Clone` as well.
10514
10515 Misc
10516 ----
10517
10518 * Many errors now have extended explanations that can be accessed with
10519   the `--explain` flag to `rustc`.
10520 * Many new examples have been added to the standard library
10521   documentation.
10522 * rustdoc has received a number of improvements focused on completion
10523   and polish.
10524 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
10525 * Much headway was made on ecosystem-wide CI, making it possible
10526   to [compare builds for breakage][ci-compare].
10527
10528
10529 [crates.io]: http://crates.io
10530 [clo]: https://github.com/rust-lang/rust/pull/24034
10531 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
10532 [con]: https://github.com/rust-lang/rust/pull/23875
10533 [cr]: https://github.com/rust-lang/rust/pull/23419
10534 [fe]: https://github.com/rust-lang/rust/pull/23879
10535 [23300]: https://github.com/rust-lang/rust/pull/23300
10536 [inv]: https://github.com/rust-lang/rust/pull/23938
10537 [ios]: https://github.com/rust-lang/rust/pull/24133
10538 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
10539 [lt]: https://github.com/rust-lang/rust/pull/24057
10540 [meth]: https://github.com/rust-lang/rust/pull/24056
10541 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
10542 [po]: https://github.com/rust-lang/rust/pull/24270
10543 [24517]: https://github.com/rust-lang/rust/pull/24517
10544 [slp]: https://github.com/rust-lang/rust/pull/23949
10545 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
10546 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
10547 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
10548 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
10549 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
10550 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
10551 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
10552 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
10553 [self-sized]: https://github.com/rust-lang/rust/pull/22301
10554 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
10555 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
10556 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
10557 [reflect]: https://github.com/rust-lang/rust/pull/23712
10558 [conversion]: https://github.com/rust-lang/rfcs/pull/529
10559 [num-traits]: https://github.com/rust-lang/rust/pull/23549
10560 [index-value]: https://github.com/rust-lang/rust/pull/23601
10561 [rfc769]: https://github.com/rust-lang/rfcs/pull/769
10562 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
10563 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
10564 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
10565 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
10566 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
10567
10568
10569 Version 1.0.0-alpha.2 (2015-02-20)
10570 =====================================
10571
10572 * ~1300 changes, numerous bugfixes
10573
10574 * Highlights
10575
10576     * The various I/O modules were [overhauled][io-rfc] to reduce
10577       unnecessary abstractions and provide better interoperation with
10578       the underlying platform. The old `io` module remains temporarily
10579       at `std::old_io`.
10580     * The standard library now [participates in feature gating][feat],
10581       so use of unstable libraries now requires a `#![feature(...)]`
10582       attribute. The impact of this change is [described on the
10583       forum][feat-forum]. [RFC][feat-rfc].
10584
10585 * Language
10586
10587     * `for` loops [now operate on the `IntoIterator` trait][into],
10588       which eliminates the need to call `.iter()`, etc. to iterate
10589       over collections. There are some new subtleties to remember
10590       though regarding what sort of iterators various types yield, in
10591       particular that `for foo in bar { }` yields values from a move
10592       iterator, destroying the original collection. [RFC][into-rfc].
10593     * Objects now have [default lifetime bounds][obj], so you don't
10594       have to write `Box<Trait+'static>` when you don't care about
10595       storing references. [RFC][obj-rfc].
10596     * In types that implement `Drop`, [lifetimes must outlive the
10597       value][drop]. This will soon make it possible to safely
10598       implement `Drop` for types where `#[unsafe_destructor]` is now
10599       required. Read the [gorgeous RFC][drop-rfc] for details.
10600     * The fully qualified <T as Trait>::X syntax lets you set the Self
10601       type for a trait method or associated type. [RFC][ufcs-rfc].
10602     * References to types that implement `Deref<U>` now [automatically
10603       coerce to references][deref] to the dereferenced type `U`,
10604       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
10605       should eliminate many unsightly uses of `&*`, as when converting
10606       from references to vectors into references to
10607       slices. [RFC][deref-rfc].
10608     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
10609       `|:|`) is obsolete and closure kind is inferred from context.
10610     * [`Self` is a keyword][Self].
10611
10612 * Libraries
10613
10614     * The `Show` and `String` formatting traits [have been
10615       renamed][fmt] to `Debug` and `Display` to more clearly reflect
10616       their related purposes. Automatically getting a string
10617       conversion to use with `format!("{:?}", something_to_debug)` is
10618       now written `#[derive(Debug)]`.
10619     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
10620       OsStr}`, provide strings in platform-specific encodings for easier
10621       interop with system APIs. [RFC][osstr-rfc].
10622     * The `boxed::into_raw` and `Box::from_raw` functions [convert
10623       between `Box<T>` and `*mut T`][boxraw], a common pattern for
10624       creating raw pointers.
10625
10626 * Tooling
10627
10628     * Certain long error messages of the form 'expected foo found bar'
10629       are now [split neatly across multiple
10630       lines][multiline]. Examples in the PR.
10631     * On Unix Rust can be [uninstalled][un] by running
10632       `/usr/local/lib/rustlib/uninstall.sh`.
10633     * The `#[rustc_on_unimplemented]` attribute, requiring the
10634       'on_unimplemented' feature, lets rustc [display custom error
10635       messages when a trait is expected to be implemented for a type
10636       but is not][onun].
10637
10638 * Misc
10639
10640     * Rust is tested against a [LALR grammar][lalr], which parses
10641       almost all the Rust files that rustc does.
10642
10643 [boxraw]: https://github.com/rust-lang/rust/pull/21318
10644 [close]: https://github.com/rust-lang/rust/pull/21843
10645 [deref]: https://github.com/rust-lang/rust/pull/21351
10646 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
10647 [drop]: https://github.com/rust-lang/rust/pull/21972
10648 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
10649 [feat]: https://github.com/rust-lang/rust/pull/21248
10650 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
10651 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
10652 [fmt]: https://github.com/rust-lang/rust/pull/21457
10653 [into]: https://github.com/rust-lang/rust/pull/20790
10654 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
10655 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
10656 [lalr]: https://github.com/rust-lang/rust/pull/21452
10657 [multiline]: https://github.com/rust-lang/rust/pull/19870
10658 [obj]: https://github.com/rust-lang/rust/pull/22230
10659 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
10660 [onun]: https://github.com/rust-lang/rust/pull/20889
10661 [osstr]: https://github.com/rust-lang/rust/pull/21488
10662 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
10663 [Self]: https://github.com/rust-lang/rust/pull/22158
10664 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
10665 [un]: https://github.com/rust-lang/rust/pull/22256
10666
10667
10668 Version 1.0.0-alpha (2015-01-09)
10669 ==================================
10670
10671   * ~2400 changes, numerous bugfixes
10672
10673   * Highlights
10674
10675     * The language itself is considered feature complete for 1.0,
10676       though there will be many usability improvements and bugfixes
10677       before the final release.
10678     * Nearly 50% of the public API surface of the standard library has
10679       been declared 'stable'. Those interfaces are unlikely to change
10680       before 1.0.
10681     * The long-running debate over integer types has been
10682       [settled][ints]: Rust will ship with types named `isize` and
10683       `usize`, rather than `int` and `uint`, for pointer-sized
10684       integers. Guidelines will be rolled out during the alpha cycle.
10685     * Most crates that are not `std` have been moved out of the Rust
10686       distribution into the Cargo ecosystem so they can evolve
10687       separately and don't need to be stabilized as quickly, including
10688       'time', 'getopts', 'num', 'regex', and 'term'.
10689     * Documentation continues to be expanded with more API coverage, more
10690       examples, and more in-depth explanations. The guides have been
10691       consolidated into [The Rust Programming Language][trpl].
10692     * "[Rust By Example][rbe]" is now maintained by the Rust team.
10693     * All official Rust binary installers now come with [Cargo], the
10694       Rust package manager.
10695
10696 * Language
10697
10698     * Closures have been [completely redesigned][unboxed] to be
10699       implemented in terms of traits, can now be used as generic type
10700       bounds and thus monomorphized and inlined, or via an opaque
10701       pointer (boxed) as in the old system. The new system is often
10702       referred to as 'unboxed' closures.
10703     * Traits now support [associated types][assoc], allowing families
10704       of related types to be defined together and used generically in
10705       powerful ways.
10706     * Enum variants are [namespaced by their type names][enum].
10707     * [`where` clauses][where] provide a more versatile and attractive
10708       syntax for specifying generic bounds, though the previous syntax
10709       remains valid.
10710     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
10711       numeric types.
10712     * Rust [no longer has a runtime][rt] of any description, and only
10713       supports OS threads, not green threads.
10714     * At long last, Rust has been overhauled for 'dynamically-sized
10715       types' ([DST]), which integrates 'fat pointers' (object types,
10716       arrays, and `str`) more deeply into the type system, making it
10717       more consistent.
10718     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
10719       `..j` that produce range types and which, when combined with the
10720       `Index` operator and multidispatch, leads to a convenient slice
10721       notation, `[i..j]`.
10722     * The new range syntax revealed an ambiguity in the fixed-length
10723       array syntax, so now fixed length arrays [are written `[T;
10724       N]`][arrays].
10725     * The `Copy` trait is no longer implemented automatically. Unsafe
10726       pointers no longer implement `Sync` and `Send` so types
10727       containing them don't automatically either. `Sync` and `Send`
10728       are now 'unsafe traits' so one can "forcibly" implement them via
10729       `unsafe impl` if a type confirms to the requirements for them
10730       even though the internals do not (e.g. structs containing unsafe
10731       pointers like `Arc`). These changes are intended to prevent some
10732       footguns and are collectively known as [opt-in built-in
10733       traits][oibit] (though `Sync` and `Send` will soon become pure
10734       library types unknown to the compiler).
10735     * Operator traits now take their operands [by value][ops], and
10736       comparison traits can use multidispatch to compare one type
10737       against multiple other types, allowing e.g. `String` to be
10738       compared with `&str`.
10739     * `if let` and `while let` are no longer feature-gated.
10740     * Rust has adopted a more [uniform syntax for escaping unicode
10741       characters][unicode].
10742     * `macro_rules!` [has been declared stable][mac]. Though it is a
10743       flawed system it is sufficiently popular that it must be usable
10744       for 1.0. Effort has gone into [future-proofing][mac-future] it
10745       in ways that will allow other macro systems to be developed in
10746       parallel, and won't otherwise impact the evolution of the
10747       language.
10748     * The prelude has been [pared back significantly][prelude] such
10749       that it is the minimum necessary to support the most pervasive
10750       code patterns, and through [generalized where clauses][where]
10751       many of the prelude extension traits have been consolidated.
10752     * Rust's rudimentary reflection [has been removed][refl], as it
10753       incurred too much code generation for little benefit.
10754     * [Struct variants][structvars] are no longer feature-gated.
10755     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
10756       known as 'higher-ranked trait bounds', this crucially allows
10757       unboxed closures to work.
10758     * Macros invocations surrounded by parens or square brackets and
10759       not terminated by a semicolon are [parsed as
10760       expressions][macros], which makes expressions like `vec![1i32,
10761       2, 3].len()` work as expected.
10762     * Trait objects now implement their traits automatically, and
10763       traits that can be coerced to objects now must be [object
10764       safe][objsafe].
10765     * Automatically deriving traits is now done with `#[derive(...)]`
10766       not `#[deriving(...)]` for [consistency with other naming
10767       conventions][derive].
10768     * Importing the containing module or enum at the same time as
10769       items or variants they contain is [now done with `self` instead
10770       of `mod`][self], as in use `foo::{self, bar}`
10771     * Glob imports are no longer feature-gated.
10772     * The `box` operator and `box` patterns have been feature-gated
10773       pending a redesign. For now unique boxes should be allocated
10774       like other containers, with `Box::new`.
10775
10776 * Libraries
10777
10778     * A [series][coll1] of [efforts][coll2] to establish
10779       [conventions][coll3] for collections types has resulted in API
10780       improvements throughout the standard library.
10781     * New [APIs for error handling][err] provide ergonomic interop
10782       between error types, and [new conventions][err-conv] describe
10783       more clearly the recommended error handling strategies in Rust.
10784     * The `fail!` macro has been renamed to [`panic!`][panic] so that
10785       it is easier to discuss failure in the context of error handling
10786       without making clarifications as to whether you are referring to
10787       the 'fail' macro or failure more generally.
10788     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
10789       syscall when available.
10790     * The 'serialize' crate has been renamed 'rustc-serialize' and
10791       moved out of the distribution to Cargo. Although it is widely
10792       used now, it is expected to be superseded in the near future.
10793     * The `Show` formatter, typically implemented with
10794       `#[derive(Show)]` is [now requested with the `{:?}`
10795       specifier][show] and is intended for use by all types, for uses
10796       such as `println!` debugging. The new `String` formatter must be
10797       implemented by hand, uses the `{}` specifier, and is intended
10798       for full-fidelity conversions of things that can logically be
10799       represented as strings.
10800
10801 * Tooling
10802
10803     * [Flexible target specification][flex] allows rustc's code
10804       generation to be configured to support otherwise-unsupported
10805       platforms.
10806     * Rust comes with rust-gdb and rust-lldb scripts that launch their
10807       respective debuggers with Rust-appropriate pretty-printing.
10808     * The Windows installation of Rust is distributed with the
10809       MinGW components currently required to link binaries on that
10810       platform.
10811
10812 * Misc
10813
10814     * Nullable enum optimizations have been extended to more types so
10815       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
10816       space than the inner types themselves.
10817     * Work has begun on supporting AArch64.
10818
10819 [Cargo]: https://crates.io
10820 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
10821 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
10822 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
10823 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
10824 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
10825 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
10826 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
10827 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
10828 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
10829 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
10830 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
10831 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
10832 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
10833 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
10834 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
10835 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
10836 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
10837 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
10838 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
10839 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
10840 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
10841 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
10842 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
10843 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
10844 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
10845 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
10846 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
10847 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
10848 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
10849 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
10850 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
10851 [trpl]: https://doc.rust-lang.org/book/index.html
10852 [rbe]: http://rustbyexample.com/
10853
10854
10855 Version 0.12.0 (2014-10-09)
10856 =============================
10857
10858   * ~1900 changes, numerous bugfixes
10859
10860   * Highlights
10861
10862     * The introductory documentation (now called The Rust Guide) has
10863       been completely rewritten, as have a number of supplementary
10864       guides.
10865     * Rust's package manager, Cargo, continues to improve and is
10866       sometimes considered to be quite awesome.
10867     * Many API's in `std` have been reviewed and updated for
10868       consistency with the in-development Rust coding
10869       guidelines. The standard library documentation tracks
10870       stabilization progress.
10871     * Minor libraries have been moved out-of-tree to the rust-lang org
10872       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
10873       be installed with Cargo.
10874     * Lifetime elision allows lifetime annotations to be left off of
10875       function declarations in many common scenarios.
10876     * Rust now works on 64-bit Windows.
10877
10878   * Language
10879     * Indexing can be overloaded with the `Index` and `IndexMut`
10880       traits.
10881     * The `if let` construct takes a branch only if the `let` pattern
10882       matches, currently behind the 'if_let' feature gate.
10883     * 'where clauses', a more flexible syntax for specifying trait
10884       bounds that is more aesthetic, have been added for traits and
10885       free functions. Where clauses will in the future make it
10886       possible to constrain associated types, which would be
10887       impossible with the existing syntax.
10888     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
10889       the 'slicing_syntax' feature gate, and can be overloaded with
10890       the `Slice` or `SliceMut` traits.
10891     * The syntax for matching of sub-slices has been changed to use a
10892       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
10893       consistency with other uses of `..` and to future-proof
10894       potential additional uses of the syntax.
10895     * The syntax for matching inclusive ranges in patterns has changed
10896       from `0..3` to `0...4` to be consistent with the exclusive range
10897       syntax for slicing.
10898     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
10899       c]`) has been put behind the 'advanced_slice_patterns' feature
10900       gate and may be removed in the future.
10901     * Components of tuples and tuple structs can be extracted using
10902       the `value.0` syntax, currently behind the `tuple_indexing`
10903       feature gate.
10904     * The `#[crate_id]` attribute is no longer supported; versioning
10905       is handled by the package manager.
10906     * Renaming crate imports are now written `extern crate foo as bar`
10907       instead of `extern crate bar = foo`.
10908     * Renaming use statements are now written `use foo as bar` instead
10909       of `use bar = foo`.
10910     * `let` and `match` bindings and argument names in macros are now
10911       hygienic.
10912     * The new, more efficient, closure types ('unboxed closures') have
10913       been added under a feature gate, 'unboxed_closures'. These will
10914       soon replace the existing closure types, once higher-ranked
10915       trait lifetimes are added to the language.
10916     * `move` has been added as a keyword, for indicating closures
10917       that capture by value.
10918     * Mutation and assignment is no longer allowed in pattern guards.
10919     * Generic structs and enums can now have trait bounds.
10920     * The `Share` trait is now called `Sync` to free up the term
10921       'shared' to refer to 'shared reference' (the default reference
10922       type.
10923     * Dynamically-sized types have been mostly implemented,
10924       unifying the behavior of fat-pointer types with the rest of the
10925       type system.
10926     * As part of dynamically-sized types, the `Sized` trait has been
10927       introduced, which qualifying types implement by default, and
10928       which type parameters expect by default. To specify that a type
10929       parameter does not need to be sized, write `<Sized? T>`. Most
10930       types are `Sized`, notable exceptions being unsized arrays
10931       (`[T]`) and trait types.
10932     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
10933     * Lifetime bounds can now be applied to type parameters and object
10934       types.
10935     * The old, reference counted GC type, `Gc<T>` which was once
10936       denoted by the `@` sigil, has finally been removed. GC will be
10937       revisited in the future.
10938
10939   * Libraries
10940     * Library documentation has been improved for a number of modules.
10941     * Bit-vectors, collections::bitv has been modernized.
10942     * The url crate is deprecated in favor of
10943       http://github.com/servo/rust-url, which can be installed with
10944       Cargo.
10945     * Most I/O stream types can be cloned and subsequently closed from
10946       a different thread.
10947     * A `std::time::Duration` type has been added for use in I/O
10948       methods that rely on timers, as well as in the 'time' crate's
10949       `Timespec` arithmetic.
10950     * The runtime I/O abstraction layer that enabled the green thread
10951       scheduler to do non-thread-blocking I/O has been removed, along
10952       with the libuv-based implementation employed by the green thread
10953       scheduler. This will greatly simplify the future I/O work.
10954     * `collections::btree` has been rewritten to have a more
10955       idiomatic and efficient design.
10956
10957   * Tooling
10958     * rustdoc output now indicates the stability levels of API's.
10959     * The `--crate-name` flag can specify the name of the crate
10960       being compiled, like `#[crate_name]`.
10961     * The `-C metadata` specifies additional metadata to hash into
10962       symbol names, and `-C extra-filename` specifies additional
10963       information to put into the output filename, for use by the
10964       package manager for versioning.
10965     * debug info generation has continued to improve and should be
10966       more reliable under both gdb and lldb.
10967     * rustc has experimental support for compiling in parallel
10968       using the `-C codegen-units` flag.
10969     * rustc no longer encodes rpath information into binaries by
10970       default.
10971
10972   * Misc
10973     * Stack usage has been optimized with LLVM lifetime annotations.
10974     * Official Rust binaries on Linux are more compatible with older
10975       kernels and distributions, built on CentOS 5.10.
10976
10977
10978 Version 0.11.0 (2014-07-02)
10979 ==========================
10980
10981   * ~1700 changes, numerous bugfixes
10982
10983   * Language
10984     * ~[T] has been removed from the language. This type is superseded by
10985       the Vec<T> type.
10986     * ~str has been removed from the language. This type is superseded by
10987       the String type.
10988     * ~T has been removed from the language. This type is superseded by the
10989       Box<T> type.
10990     * @T has been removed from the language. This type is superseded by the
10991       standard library's std::gc::Gc<T> type.
10992     * Struct fields are now all private by default.
10993     * Vector indices and shift amounts are both required to be a `uint`
10994       instead of any integral type.
10995     * Byte character, byte string, and raw byte string literals are now all
10996       supported by prefixing the normal literal with a `b`.
10997     * Multiple ABIs are no longer allowed in an ABI string
10998     * The syntax for lifetimes on closures/procedures has been tweaked
10999       slightly: `<'a>|A, B|: 'b + K -> T`
11000     * Floating point modulus has been removed from the language; however it
11001       is still provided by a library implementation.
11002     * Private enum variants are now disallowed.
11003     * The `priv` keyword has been removed from the language.
11004     * A closure can no longer be invoked through a &-pointer.
11005     * The `use foo, bar, baz;` syntax has been removed from the language.
11006     * The transmute intrinsic no longer works on type parameters.
11007     * Statics now allow blocks/items in their definition.
11008     * Trait bounds are separated from objects with + instead of : now.
11009     * Objects can no longer be read while they are mutably borrowed.
11010     * The address of a static is now marked as insignificant unless the
11011       #[inline(never)] attribute is placed it.
11012     * The #[unsafe_destructor] attribute is now behind a feature gate.
11013     * Struct literals are no longer allowed in ambiguous positions such as
11014       if, while, match, and for..in.
11015     * Declaration of lang items and intrinsics are now feature-gated by
11016       default.
11017     * Integral literals no longer default to `int`, and floating point
11018       literals no longer default to `f64`. Literals must be suffixed with an
11019       appropriate type if inference cannot determine the type of the
11020       literal.
11021     * The Box<T> type is no longer implicitly borrowed to &mut T.
11022     * Procedures are now required to not capture borrowed references.
11023
11024   * Libraries
11025     * The standard library is now a "facade" over a number of underlying
11026       libraries. This means that development on the standard library should
11027       be speedier due to smaller crates, as well as a clearer line between
11028       all dependencies.
11029     * A new library, libcore, lives under the standard library's facade
11030       which is Rust's "0-assumption" library, suitable for embedded and
11031       kernel development for example.
11032     * A regex crate has been added to the standard distribution. This crate
11033       includes statically compiled regular expressions.
11034     * The unwrap/unwrap_err methods on Result require a Show bound for
11035       better error messages.
11036     * The return types of the std::comm primitives have been centralized
11037       around the Result type.
11038     * A number of I/O primitives have gained the ability to time out their
11039       operations.
11040     * A number of I/O primitives have gained the ability to close their
11041       reading/writing halves to cancel pending operations.
11042     * Reverse iterator methods have been removed in favor of `rev()` on
11043       their forward-iteration counterparts.
11044     * A bitflags! macro has been added to enable easy interop with C and
11045       management of bit flags.
11046     * A debug_assert! macro is now provided which is disabled when
11047       `--cfg ndebug` is passed to the compiler.
11048     * A graphviz crate has been added for creating .dot files.
11049     * The std::cast module has been migrated into std::mem.
11050     * The std::local_data api has been migrated from freestanding functions
11051       to being based on methods.
11052     * The Pod trait has been renamed to Copy.
11053     * jemalloc has been added as the default allocator for types.
11054     * The API for allocating memory has been changed to use proper alignment
11055       and sized deallocation
11056     * Connecting a TcpStream or binding a TcpListener is now based on a
11057       string address and a u16 port. This allows connecting to a hostname as
11058       opposed to an IP.
11059     * The Reader trait now contains a core method, read_at_least(), which
11060       correctly handles many repeated 0-length reads.
11061     * The process-spawning API is now centered around a builder-style
11062       Command struct.
11063     * The :? printing qualifier has been moved from the standard library to
11064       an external libdebug crate.
11065     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
11066       have been renamed to Eq/Ord.
11067     * The select/plural methods have been removed from format!. The escapes
11068       for { and } have also changed from \{ and \} to {{ and }},
11069       respectively.
11070     * The TaskBuilder API has been re-worked to be a true builder, and
11071       extension traits for spawning native/green tasks have been added.
11072
11073   * Tooling
11074     * All breaking changes to the language or libraries now have their
11075       commit message annotated with `[breaking-change]` to allow for easy
11076       discovery of breaking changes.
11077     * The compiler will now try to suggest how to annotate lifetimes if a
11078       lifetime-related error occurs.
11079     * Debug info continues to be improved greatly with general bug fixes and
11080       better support for situations like link time optimization (LTO).
11081     * Usage of syntax extensions when cross-compiling has been fixed.
11082     * Functionality equivalent to GCC & Clang's -ffunction-sections,
11083       -fdata-sections and --gc-sections has been enabled by default
11084     * The compiler is now stricter about where it will load module files
11085       from when a module is declared via `mod foo;`.
11086     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
11087       Syntax extensions are now discovered via a "plugin registrar" type
11088       which will be extended in the future to other various plugins.
11089     * Lints have been restructured to allow for dynamically loadable lints.
11090     * A number of rustdoc improvements:
11091       * The HTML output has been visually redesigned.
11092       * Markdown is now powered by hoedown instead of sundown.
11093       * Searching heuristics have been greatly improved.
11094       * The search index has been reduced in size by a great amount.
11095       * Cross-crate documentation via `pub use` has been greatly improved.
11096       * Primitive types are now hyperlinked and documented.
11097     * Documentation has been moved from static.rust-lang.org/doc to
11098       doc.rust-lang.org
11099     * A new sandbox, play.rust-lang.org, is available for running and
11100       sharing rust code examples on-line.
11101     * Unused attributes are now more robustly warned about.
11102     * The dead_code lint now warns about unused struct fields.
11103     * Cross-compiling to iOS is now supported.
11104     * Cross-compiling to mipsel is now supported.
11105     * Stability attributes are now inherited by default and no longer apply
11106       to intra-crate usage, only inter-crate usage.
11107     * Error message related to non-exhaustive match expressions have been
11108       greatly improved.
11109
11110
11111 Version 0.10 (2014-04-03)
11112 =========================
11113
11114   * ~1500 changes, numerous bugfixes
11115
11116   * Language
11117     * A new RFC process is now in place for modifying the language.
11118     * Patterns with `@`-pointers have been removed from the language.
11119     * Patterns with unique vectors (`~[T]`) have been removed from the
11120       language.
11121     * Patterns with unique strings (`~str`) have been removed from the
11122       language.
11123     * `@str` has been removed from the language.
11124     * `@[T]` has been removed from the language.
11125     * `@self` has been removed from the language.
11126     * `@Trait` has been removed from the language.
11127     * Headers on `~` allocations which contain `@` boxes inside the type for
11128       reference counting have been removed.
11129     * The semantics around the lifetimes of temporary expressions have changed,
11130       see #3511 and #11585 for more information.
11131     * Cross-crate syntax extensions are now possible, but feature gated. See
11132       #11151 for more information. This includes both `macro_rules!` macros as
11133       well as syntax extensions such as `format!`.
11134     * New lint modes have been added, and older ones have been turned on to be
11135       warn-by-default.
11136       * Unnecessary parentheses
11137       * Uppercase statics
11138       * Camel Case types
11139       * Uppercase variables
11140       * Publicly visible private types
11141       * `#[deriving]` with raw pointers
11142     * Unsafe functions can no longer be coerced to closures.
11143     * Various obscure macros such as `log_syntax!` are now behind feature gates.
11144     * The `#[simd]` attribute is now behind a feature gate.
11145     * Visibility is no longer allowed on `extern crate` statements, and
11146       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
11147     * Trailing commas are now allowed in argument lists and tuple patterns.
11148     * The `do` keyword has been removed, it is now a reserved keyword.
11149     * Default type parameters have been implemented, but are feature gated.
11150     * Borrowed variables through captures in closures are now considered soundly.
11151     * `extern mod` is now `extern crate`
11152     * The `Freeze` trait has been removed.
11153     * The `Share` trait has been added for types that can be shared among
11154       threads.
11155     * Labels in macros are now hygienic.
11156     * Expression/statement macro invocations can be delimited with `{}` now.
11157     * Treatment of types allowed in `static mut` locations has been tweaked.
11158     * The `*` and `.` operators are now overloadable through the `Deref` and
11159       `DerefMut` traits.
11160     * `~Trait` and `proc` no longer have `Send` bounds by default.
11161     * Partial type hints are now supported with the `_` type marker.
11162     * An `Unsafe` type was introduced for interior mutability. It is now
11163       considered undefined to transmute from `&T` to `&mut T` without using the
11164       `Unsafe` type.
11165     * The #[linkage] attribute was implemented for extern statics/functions.
11166     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
11167     * `Pod` was renamed to `Copy`.
11168
11169   * Libraries
11170     * The `libextra` library has been removed. It has now been decomposed into
11171       component libraries with smaller and more focused nuggets of
11172       functionality. The full list of libraries can be found on the
11173       documentation index page.
11174     * std: `std::condition` has been removed. All I/O errors are now propagated
11175       through the `Result` type. In order to assist with error handling, a
11176       `try!` macro for unwrapping errors with an early return and a lint for
11177       unused results has been added. See #12039 for more information.
11178     * std: The `vec` module has been renamed to `slice`.
11179     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
11180       This will become the only growable vector in the future.
11181     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
11182       are now found at `std::io::BufferedReader` instead of
11183       `std::io::buffered::BufferedReader`.
11184     * std: `print` and `println` are no longer in the prelude, the `print!` and
11185       `println!` macros are intended to be used instead.
11186     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
11187       attempts to statically prevent cycles.
11188     * std: The standard distribution is adopting the policy of pushing failure
11189       to the user rather than failing in libraries. Many functions (such as
11190       `slice::last()`) now return `Option<T>` instead of `T` + failing.
11191     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
11192       deriving mode: `#[deriving(Show)]`.
11193     * std: `ToStr` is now implemented for all types implementing `Show`.
11194     * std: The formatting trait methods now take `&self` instead of `&T`
11195     * std: The `invert()` method on iterators has been renamed to `rev()`
11196     * std: `std::num` has seen a reduction in the genericity of its traits,
11197       consolidating functionality into a few core traits.
11198     * std: Backtraces are now printed on task failure if the environment
11199       variable `RUST_BACKTRACE` is present.
11200     * std: Naming conventions for iterators have been standardized. More details
11201       can be found on the wiki's style guide.
11202     * std: `eof()` has been removed from the `Reader` trait. Specific types may
11203       still implement the function.
11204     * std: Networking types are now cloneable to allow simultaneous reads/writes.
11205     * std: `assert_approx_eq!` has been removed
11206     * std: The `e` and `E` formatting specifiers for floats have been added to
11207       print them in exponential notation.
11208     * std: The `Times` trait has been removed
11209     * std: Indications of variance and opting out of builtin bounds is done
11210       through marker types in `std::kinds::marker` now
11211     * std: `hash` has been rewritten, `IterBytes` has been removed, and
11212       `#[deriving(Hash)]` is now possible.
11213     * std: `SharedChan` has been removed, `Sender` is now cloneable.
11214     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
11215     * std: `Chan::new` is now `channel()`.
11216     * std: A new synchronous channel type has been implemented.
11217     * std: A `select!` macro is now provided for selecting over `Receiver`s.
11218     * std: `hashmap` and `trie` have been moved to `libcollections`
11219     * std: `run` has been rolled into `io::process`
11220     * std: `assert_eq!` now uses `{}` instead of `{:?}`
11221     * std: The equality and comparison traits have seen some reorganization.
11222     * std: `rand` has moved to `librand`.
11223     * std: `to_{lower,upper}case` has been implemented for `char`.
11224     * std: Logging has been moved to `liblog`.
11225     * collections: `HashMap` has been rewritten for higher performance and less
11226       memory usage.
11227     * native: The default runtime is now `libnative`. If `libgreen` is desired,
11228       it can be booted manually. The runtime guide has more information and
11229       examples.
11230     * native: All I/O functionality except signals has been implemented.
11231     * green: Task spawning with `libgreen` has been optimized with stack caching
11232       and various trimming of code.
11233     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
11234     * sync: The `extra::sync` module has been updated to modern rust (and moved
11235       to the `sync` library), tweaking and improving various interfaces while
11236       dropping redundant functionality.
11237     * sync: A new `Barrier` type has been added to the `sync` library.
11238     * sync: An efficient mutex for native and green tasks has been implemented.
11239     * serialize: The `base64` module has seen some improvement. It treats
11240       newlines better, has non-string error values, and has seen general
11241       cleanup.
11242     * fourcc: A `fourcc!` macro was introduced
11243     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
11244       hexadecimal literal.
11245
11246   * Tooling
11247     * `rustpkg` has been deprecated and removed from the main repository. Its
11248       replacement, `cargo`, is under development.
11249     * Nightly builds of rust are now available
11250     * The memory usage of rustc has been improved many times throughout this
11251       release cycle.
11252     * The build process supports disabling rpath support for the rustc binary
11253       itself.
11254     * Code generation has improved in some cases, giving more information to the
11255       LLVM optimization passes to enable more extensive optimizations.
11256     * Debuginfo compatibility with lldb on OSX has been restored.
11257     * The master branch is now gated on an android bot, making building for
11258       android much more reliable.
11259     * Output flags have been centralized into one `--emit` flag.
11260     * Crate type flags have been centralized into one `--crate-type` flag.
11261     * Codegen flags have been consolidated behind a `-C` flag.
11262     * Linking against outdated crates now has improved error messages.
11263     * Error messages with lifetimes will often suggest how to annotate the
11264       function to fix the error.
11265     * Many more types are documented in the standard library, and new guides
11266       were written.
11267     * Many `rustdoc` improvements:
11268       * code blocks are syntax highlighted.
11269       * render standalone markdown files.
11270       * the --test flag tests all code blocks by default.
11271       * exported macros are displayed.
11272       * re-exported types have their documentation inlined at the location of the
11273         first re-export.
11274       * search works across crates that have been rendered to the same output
11275         directory.
11276
11277
11278 Version 0.9 (2014-01-09)
11279 ==========================
11280
11281    * ~1800 changes, numerous bugfixes
11282
11283    * Language
11284       * The `float` type has been removed. Use `f32` or `f64` instead.
11285       * A new facility for enabling experimental features (feature gating) has
11286         been added, using the crate-level `#[feature(foo)]` attribute.
11287       * Managed boxes (@) are now behind a feature gate
11288         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
11289         standard library's `Gc` or `Rc` types instead.
11290       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
11291       * Jumping back to the top of a loop is now done with `continue` instead of
11292         `loop`.
11293       * Strings can no longer be mutated through index assignment.
11294       * Raw strings can be created via the basic `r"foo"` syntax or with matched
11295         hash delimiters, as in `r###"foo"###`.
11296       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
11297         called once.
11298       * The `&fn` type is now written `|args| -> ret` to match the literal form.
11299       * `@fn`s have been removed.
11300       * `do` only works with procs in order to make it obvious what the cost
11301         of `do` is.
11302       * Single-element tuple-like structs can no longer be dereferenced to
11303         obtain the inner value. A more comprehensive solution for overloading
11304         the dereference operator will be provided in the future.
11305       * The `#[link(...)]` attribute has been replaced with
11306         `#[crate_id = "name#vers"]`.
11307       * Empty `impl`s must be terminated with empty braces and may not be
11308         terminated with a semicolon.
11309       * Keywords are no longer allowed as lifetime names; the `self` lifetime
11310         no longer has any special meaning.
11311       * The old `fmt!` string formatting macro has been removed.
11312       * `printf!` and `printfln!` (old-style formatting) removed in favor of
11313         `print!` and `println!`.
11314       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
11315       * The `extern mod foo (name = "bar")` syntax has been removed. Use
11316         `extern mod foo = "bar"` instead.
11317       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
11318       * Macros can have attributes.
11319       * Macros can expand to items with attributes.
11320       * Macros can expand to multiple items.
11321       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
11322       * Comments may be nested.
11323       * Values automatically coerce to trait objects they implement, without
11324         an explicit `as`.
11325       * Enum discriminants are no longer an entire word but as small as needed to
11326         contain all the variants. The `repr` attribute can be used to override
11327         the discriminant size, as in `#[repr(int)]` for integer-sized, and
11328         `#[repr(C)]` to match C enums.
11329       * Non-string literals are not allowed in attributes (they never worked).
11330       * The FFI now supports variadic functions.
11331       * Octal numeric literals, as in `0o7777`.
11332       * The `concat!` syntax extension performs compile-time string concatenation.
11333       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
11334         removed as Rust no longer uses segmented stacks.
11335       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
11336       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
11337         not `*`; ignoring remaining fields of a struct is also done with `..`,
11338         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
11339       * `rustc` supports the "win64" calling convention via `extern "win64"`.
11340       * `rustc` supports the "system" calling convention, which defaults to the
11341         preferred convention for the target platform, "stdcall" on 32-bit Windows,
11342         "C" elsewhere.
11343       * The `type_overflow` lint (default: warn) checks literals for overflow.
11344       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
11345       * The `attribute_usage` lint (default: warn) warns about unknown
11346         attributes.
11347       * The `unknown_features` lint (default: warn) warns about unknown
11348         feature gates.
11349       * The `dead_code` lint (default: warn) checks for dead code.
11350       * Rust libraries can be linked statically to one another
11351       * `#[link_args]` is behind the `link_args` feature gate.
11352       * Native libraries are now linked with `#[link(name = "foo")]`
11353       * Native libraries can be statically linked to a rust crate
11354         (`#[link(name = "foo", kind = "static")]`).
11355       * Native OS X frameworks are now officially supported
11356         (`#[link(name = "foo", kind = "framework")]`).
11357       * The `#[thread_local]` attribute creates thread-local (not task-local)
11358         variables. Currently behind the `thread_local` feature gate.
11359       * The `return` keyword may be used in closures.
11360       * Types that can be copied via a memcpy implement the `Pod` kind.
11361       * The `cfg` attribute can now be used on struct fields and enum variants.
11362
11363    * Libraries
11364       * std: The `option` and `result` API's have been overhauled to make them
11365         simpler, more consistent, and more composable.
11366       * std: The entire `std::io` module has been replaced with one that is
11367         more comprehensive and that properly interfaces with the underlying
11368         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
11369         implemented.
11370       * std: `io::util` contains a number of useful implementations of
11371         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
11372         `ZeroReader`, `TeeReader`.
11373       * std: The reference counted pointer type `extra::rc` moved into std.
11374       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
11375         just a wrapper around it).
11376       * std: The `Either` type has been removed.
11377       * std: `fmt::Default` can be implemented for any type to provide default
11378         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
11379       * std: The `rand` API continues to be tweaked.
11380       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
11381         on failure in gdb, is now named `rust_fail`.
11382       * std: The `each_key` and `each_value` methods on `HashMap` have been
11383         replaced by the `keys` and `values` iterators.
11384       * std: Functions dealing with type size and alignment have moved from the
11385         `sys` module to the `mem` module.
11386       * std: The `path` module was written and API changed.
11387       * std: `str::from_utf8` has been changed to cast instead of allocate.
11388       * std: `starts_with` and `ends_with` methods added to vectors via the
11389         `ImmutableEqVector` trait, which is in the prelude.
11390       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
11391         if the index is out of bounds.
11392       * std: Task failure no longer propagates between tasks, as the model was
11393         complex, expensive, and incompatible with thread-based tasks.
11394       * std: The `Any` type can be used for dynamic typing.
11395       * std: `~Any` can be passed to the `fail!` macro and retrieved via
11396         `task::try`.
11397       * std: Methods that produce iterators generally do not have an `_iter`
11398         suffix now.
11399       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
11400         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
11401       * std: `util::ignore` renamed to `prelude::drop`.
11402       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
11403         trait.
11404       * std: `vec::raw` has seen a lot of cleanup and API changes.
11405       * std: The standard library no longer includes any C++ code, and very
11406         minimal C, eliminating the dependency on libstdc++.
11407       * std: Runtime scheduling and I/O functionality has been factored out into
11408         extensible interfaces and is now implemented by two different crates:
11409         libnative, for native threading and I/O; and libgreen, for green threading
11410         and I/O. This paves the way for using the standard library in more limited
11411         embedded environments.
11412       * std: The `comm` module has been rewritten to be much faster, have a
11413         simpler, more consistent API, and to work for both native and green
11414         threading.
11415       * std: All libuv dependencies have been moved into the rustuv crate.
11416       * native: New implementations of runtime scheduling on top of OS threads.
11417       * native: New native implementations of TCP, UDP, file I/O, process spawning,
11418         and other I/O.
11419       * green: The green thread scheduler and message passing types are almost
11420         entirely lock-free.
11421       * extra: The `flatpipes` module had bitrotted and was removed.
11422       * extra: All crypto functions have been removed and Rust now has a policy of
11423         not reimplementing crypto in the standard library. In the future crypto
11424         will be provided by external crates with bindings to established libraries.
11425       * extra: `c_vec` has been modernized.
11426       * extra: The `sort` module has been removed. Use the `sort` method on
11427         mutable slices.
11428
11429    * Tooling
11430       * The `rust` and `rusti` commands have been removed, due to lack of
11431         maintenance.
11432       * `rustdoc` was completely rewritten.
11433       * `rustdoc` can test code examples in documentation.
11434       * `rustpkg` can test packages with the argument, 'test'.
11435       * `rustpkg` supports arbitrary dependencies, including C libraries.
11436       * `rustc`'s support for generating debug info is improved again.
11437       * `rustc` has better error reporting for unbalanced delimiters.
11438       * `rustc`'s JIT support was removed due to bitrot.
11439       * Executables and static libraries can be built with LTO (-Z lto)
11440       * `rustc` adds a `--dep-info` flag for communicating dependencies to
11441         build tools.
11442
11443
11444 Version 0.8 (2013-09-26)
11445 ============================
11446
11447    * ~2200 changes, numerous bugfixes
11448
11449    * Language
11450       * The `for` loop syntax has changed to work with the `Iterator` trait.
11451       * At long last, unwinding works on Windows.
11452       * Default methods are ready for use.
11453       * Many trait inheritance bugs fixed.
11454       * Owned and borrowed trait objects work more reliably.
11455       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
11456       * rustc can omit emission of code for the `debug!` macro if it is passed
11457         `--cfg ndebug`
11458       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
11459         for foo.rs, then foo/mod.rs, and will generate an error when both are
11460         present.
11461       * Strings no longer contain trailing nulls. The new `std::c_str` module
11462         provides new mechanisms for converting to C strings.
11463       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
11464       * The FFI has been overhauled such that foreign functions are called directly,
11465         instead of through a stack-switching wrapper.
11466       * Calling a foreign function must be done through a Rust function with the
11467         `#[fixed_stack_segment]` attribute.
11468       * The `externfn!` macro can be used to declare both a foreign function and
11469         a `#[fixed_stack_segment]` wrapper at once.
11470       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
11471       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
11472       * `priv` is disallowed everywhere except for struct fields and enum variants.
11473       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
11474       * `ref` bindings in irrefutable patterns work correctly now.
11475       * `char` is now prevented from containing invalid code points.
11476       * Casting to `bool` is no longer allowed.
11477       * `\0` is now accepted as an escape in chars and strings.
11478       * `yield` is a reserved keyword.
11479       * `typeof` is a reserved keyword.
11480       * Crates may be imported by URL with `extern mod foo = "url";`.
11481       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
11482       * Static vectors can be initialized with repeating elements,
11483         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
11484       * Static structs can be initialized with functional record update,
11485         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
11486       * `cfg!` can be used to conditionally execute code based on the crate
11487         configuration, similarly to `#[cfg(...)]`.
11488       * The `unnecessary_qualification` lint detects unneeded module
11489         prefixes (default: allow).
11490       * Arithmetic operations have been implemented on the SIMD types in
11491         `std::unstable::simd`.
11492       * Exchange allocation headers were removed, reducing memory usage.
11493       * `format!` implements a completely new, extensible, and higher-performance
11494         string formatting system. It will replace `fmt!`.
11495       * `print!` and `println!` write formatted strings (using the `format!`
11496         extension) to stdout.
11497       * `write!` and `writeln!` write formatted strings (using the `format!`
11498         extension) to the new Writers in `std::rt::io`.
11499       * The library section in which a function or static is placed may
11500         be specified with `#[link_section = "..."]`.
11501       * The `proto!` syntax extension for defining bounded message protocols
11502         was removed.
11503       * `macro_rules!` is hygienic for `let` declarations.
11504       * The `#[export_name]` attribute specifies the name of a symbol.
11505       * `unreachable!` can be used to indicate unreachable code, and fails
11506         if executed.
11507
11508    * Libraries
11509       * std: Transitioned to the new runtime, written in Rust.
11510       * std: Added an experimental I/O library, `rt::io`, based on the new
11511         runtime.
11512       * std: A new generic `range` function was added to the prelude, replacing
11513         `uint::range` and friends.
11514       * std: `range_rev` no longer exists. Since range is an iterator it can be
11515         reversed with `range(lo, hi).invert()`.
11516       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
11517         renamed to `unwrap_or`.
11518       * std: The `iterator` module was renamed to `iter`.
11519       * std: Integral types now support the `checked_add`, `checked_sub`, and
11520         `checked_mul` operations for detecting overflow.
11521       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
11522         consistency.
11523       * std: Methods are standardizing on conventions for casting methods:
11524         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
11525         and cheap casts.
11526       * std: The `CString` type in `c_str` provides new ways to convert to and
11527         from C strings.
11528       * std: `DoubleEndedIterator` can yield elements in two directions.
11529       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
11530         two splices.
11531       * std: `str::from_bytes` renamed to `str::from_utf8`.
11532       * std: `pop_opt` and `shift_opt` methods added to vectors.
11533       * std: The task-local data interface no longer uses @, and keys are
11534         no longer function pointers.
11535       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
11536       * std: Added `SharedPort` to `comm`.
11537       * std: `Eq` has a default method for `ne`; only `eq` is required
11538         in implementations.
11539       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
11540         is required in implementations.
11541       * std: `is_utf8` performance is improved, impacting many string functions.
11542       * std: `os::MemoryMap` provides cross-platform mmap.
11543       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
11544         are not 'in-bounds' are considered undefined.
11545       * std: Many freestanding functions in `vec` removed in favor of methods.
11546       * std: Many freestanding functions on scalar types removed in favor of
11547         methods.
11548       * std: Many options to task builders were removed since they don't make
11549         sense in the new scheduler design.
11550       * std: More containers implement `FromIterator` so can be created by the
11551         `collect` method.
11552       * std: More complete atomic types in `unstable::atomics`.
11553       * std: `comm::PortSet` removed.
11554       * std: Mutating methods in the `Set` and `Map` traits have been moved into
11555         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
11556         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
11557         default implementations.
11558       * std: Various `from_str` functions were removed in favor of a generic
11559         `from_str` which is available in the prelude.
11560       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
11561       * extra: `dlist`, the doubly-linked list was modernized.
11562       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
11563       * extra: Added `glob` module, replacing `std::os::glob`.
11564       * extra: `rope` was removed.
11565       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
11566       * extra: `net`, and `timer` were removed. The experimental replacements
11567         are `std::rt::io::net` and `std::rt::io::timer`.
11568       * extra: Iterators implemented for `SmallIntMap`.
11569       * extra: Iterators implemented for `Bitv` and `BitvSet`.
11570       * extra: `SmallIntSet` removed. Use `BitvSet`.
11571       * extra: Performance of JSON parsing greatly improved.
11572       * extra: `semver` updated to SemVer 2.0.0.
11573       * extra: `term` handles more terminals correctly.
11574       * extra: `dbg` module removed.
11575       * extra: `par` module removed.
11576       * extra: `future` was cleaned up, with some method renames.
11577       * extra: Most free functions in `getopts` were converted to methods.
11578
11579    * Other
11580       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
11581       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
11582         similarly to gcc's `--march` flag.
11583       * rustc's performance compiling small crates is much better.
11584       * rustpkg has received many improvements.
11585       * rustpkg supports git tags as package IDs.
11586       * rustpkg builds into target-specific directories so it can be used for
11587         cross-compiling.
11588       * The number of concurrent test tasks is controlled by the environment
11589         variable RUST_TEST_TASKS.
11590       * The test harness can now report metrics for benchmarks.
11591       * All tools have man pages.
11592       * Programs compiled with `--test` now support the `-h` and `--help` flags.
11593       * The runtime uses jemalloc for allocations.
11594       * Segmented stacks are temporarily disabled as part of the transition to
11595         the new runtime. Stack overflows are possible!
11596       * A new documentation backend, rustdoc_ng, is available for use. It is
11597         still invoked through the normal `rustdoc` command.
11598
11599
11600 Version 0.7 (2013-07-03)
11601 =======================
11602
11603    * ~2000 changes, numerous bugfixes
11604
11605    * Language
11606       * `impl`s no longer accept a visibility qualifier. Put them on methods
11607         instead.
11608       * The borrow checker has been rewritten with flow-sensitivity, fixing
11609         many bugs and inconveniences.
11610       * The `self` parameter no longer implicitly means `&'self self`,
11611         and can be explicitly marked with a lifetime.
11612       * Overloadable compound operators (`+=`, etc.) have been temporarily
11613         removed due to bugs.
11614       * The `for` loop protocol now requires `for`-iterators to return `bool`
11615         so they compose better.
11616       * The `Durable` trait is replaced with the `'static` bounds.
11617       * Trait default methods work more often.
11618       * Structs with the `#[packed]` attribute have byte alignment and
11619         no padding between fields.
11620       * Type parameters bound by `Copy` must now be copied explicitly with
11621         the `copy` keyword.
11622       * It is now illegal to move out of a dereferenced unsafe pointer.
11623       * `Option<~T>` is now represented as a nullable pointer.
11624       * `@mut` does dynamic borrow checks correctly.
11625       * The `main` function is only detected at the topmost level of the crate.
11626         The `#[main]` attribute is still valid anywhere.
11627       * Struct fields may no longer be mutable. Use inherited mutability.
11628       * The `#[no_send]` attribute makes a type that would otherwise be
11629         `Send`, not.
11630       * The `#[no_freeze]` attribute makes a type that would otherwise be
11631         `Freeze`, not.
11632       * Unbounded recursion will abort the process after reaching the limit
11633         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
11634       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
11635         are never implicitly copyable.
11636       * `#[static_assert]` makes compile-time assertions about static bools.
11637       * At long last, 'argument modes' no longer exist.
11638       * The rarely used `use mod` statement no longer exists.
11639
11640    * Syntax extensions
11641       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
11642         argument list.
11643       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
11644         `Rand`, `Zero` and `ToStr` can all be automatically derived with
11645         `#[deriving(...)]`.
11646       * The `bytes!` macro returns a vector of bytes for string, u8, char,
11647         and unsuffixed integer literals.
11648
11649    * Libraries
11650       * The `core` crate was renamed to `std`.
11651       * The `std` crate was renamed to `extra`.
11652       * More and improved documentation.
11653       * std: `iterator` module for external iterator objects.
11654       * Many old-style (internal, higher-order function) iterators replaced by
11655         implementations of `Iterator`.
11656       * std: Many old internal vector and string iterators,
11657         incl. `any`, `all`. removed.
11658       * std: The `finalize` method of `Drop` renamed to `drop`.
11659       * std: The `drop` method now takes `&mut self` instead of `&self`.
11660       * std: The prelude no longer re-exports any modules, only types and traits.
11661       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
11662         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
11663       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
11664         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
11665       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
11666         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
11667       * std: Many types implement `Clone`.
11668       * std: `path` type renamed to `Path`.
11669       * std: `mut` module and `Mut` type removed.
11670       * std: Many standalone functions removed in favor of methods and iterators
11671         in `vec`, `str`. In the future methods will also work as functions.
11672       * std: `reinterpret_cast` removed. Use `transmute`.
11673       * std: ascii string handling in `std::ascii`.
11674       * std: `Rand` is implemented for ~/@.
11675       * std: `run` module for spawning processes overhauled.
11676       * std: Various atomic types added to `unstable::atomic`.
11677       * std: Various types implement `Zero`.
11678       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
11679       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
11680       * std: Added `os::mkdir_recursive`.
11681       * std: Added `os::glob` function performs filesystems globs.
11682       * std: `FuzzyEq` renamed to `ApproxEq`.
11683       * std: `Map` now defines `pop` and `swap` methods.
11684       * std: `Cell` constructors converted to static methods.
11685       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
11686       * extra: `flate` module moved from `std` to `extra`.
11687       * extra: `fileinput` module for iterating over a series of files.
11688       * extra: `Complex` number type and `complex` module.
11689       * extra: `Rational` number type and `rational` module.
11690       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
11691       * extra: `term` uses terminfo now, is more correct.
11692       * extra: `arc` functions converted to methods.
11693       * extra: Implementation of fixed output size variations of SHA-2.
11694
11695    * Tooling
11696       * `unused_variables` lint mode for unused variables (default: warn).
11697       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
11698         (default: warn).
11699       * `unused_mut` lint mode for identifying unused `mut` qualifiers
11700         (default: warn).
11701       * `dead_assignment` lint mode for unread variables (default: warn).
11702       * `unnecessary_allocation` lint mode detects some heap allocations that are
11703         immediately borrowed so could be written without allocating (default: warn).
11704       * `missing_doc` lint mode (default: allow).
11705       * `unreachable_code` lint mode (default: warn).
11706       * The `rusti` command has been rewritten and a number of bugs addressed.
11707       * rustc outputs in color on more terminals.
11708       * rustc accepts a `--link-args` flag to pass arguments to the linker.
11709       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
11710       * Compiling with `-g` will make the binary record information about
11711         dynamic borrowcheck failures for debugging.
11712       * rustdoc has a nicer stylesheet.
11713       * Various improvements to rustdoc.
11714       * Improvements to rustpkg (see the detailed release notes).
11715
11716
11717 Version 0.6 (2013-04-03)
11718 ========================
11719
11720    * ~2100 changes, numerous bugfixes
11721
11722    * Syntax changes
11723       * The self type parameter in traits is now spelled `Self`
11724       * The `self` parameter in trait and impl methods must now be explicitly
11725         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
11726       * Static methods no longer require the `static` keyword and instead
11727         are distinguished by the lack of a `self` parameter
11728       * Replaced the `Durable` trait with the `'static` lifetime
11729       * The old closure type syntax with the trailing sigil has been
11730         removed in favor of the more consistent leading sigil
11731       * `super` is a keyword, and may be prefixed to paths
11732       * Trait bounds are separated with `+` instead of whitespace
11733       * Traits are implemented with `impl Trait for Type`
11734         instead of `impl Type: Trait`
11735       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
11736       * The `export` keyword has finally been removed
11737       * The `move` keyword has been removed (see "Semantic changes")
11738       * The interior mutability qualifier on vectors, `[mut T]`, has been
11739         removed. Use `&mut [T]`, etc.
11740       * `mut` is no longer valid in `~mut T`. Use inherited mutability
11741       * `fail` is no longer a keyword. Use `fail!()`
11742       * `assert` is no longer a keyword. Use `assert!()`
11743       * `log` is no longer a keyword. use `debug!`, etc.
11744       * 1-tuples may be represented as `(T,)`
11745       * Struct fields may no longer be `mut`. Use inherited mutability,
11746         `@mut T`, `core::mut` or `core::cell`
11747       * `extern mod { ... }` is no longer valid syntax for foreign
11748         function modules. Use extern blocks: `extern { ... }`
11749       * Newtype enums removed. Use tuple-structs.
11750       * Trait implementations no longer support visibility modifiers
11751       * Pattern matching over vectors improved and expanded
11752       * `const` renamed to `static` to correspond to lifetime name,
11753         and make room for future `static mut` unsafe mutable globals.
11754       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
11755       * `Clone` implementations can be automatically generated with
11756         `#[deriving(Clone)]`
11757       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
11758         instead of `foo as Bar`.
11759       * Fixed length vector types are now written as `[int, .. 3]`
11760         instead of `[int * 3]`.
11761       * Fixed length vector types can express the length as a constant
11762         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
11763
11764    * Semantic changes
11765       * Types with owned pointers or custom destructors move by default,
11766         eliminating the `move` keyword
11767       * All foreign functions are considered unsafe
11768       * &mut is now unaliasable
11769       * Writes to borrowed @mut pointers are prevented dynamically
11770       * () has size 0
11771       * The name of the main function can be customized using #[main]
11772       * The default type of an inferred closure is &fn instead of @fn
11773       * `use` statements may no longer be "chained" - they cannot import
11774         identifiers imported by previous `use` statements
11775       * `use` statements are crate relative, importing from the "top"
11776         of the crate by default. Paths may be prefixed with `super::`
11777         or `self::` to change the search behavior.
11778       * Method visibility is inherited from the implementation declaration
11779       * Structural records have been removed
11780       * Many more types can be used in static items, including enums
11781         'static-lifetime pointers and vectors
11782       * Pattern matching over vectors improved and expanded
11783       * Typechecking of closure types has been overhauled to
11784         improve inference and eliminate unsoundness
11785       * Macros leave scope at the end of modules, unless that module is
11786         tagged with #[macro_escape]
11787
11788    * Libraries
11789       * Added big integers to `std::bigint`
11790       * Removed `core::oldcomm` module
11791       * Added pipe-based `core::comm` module
11792       * Numeric traits have been reorganized under `core::num`
11793       * `vec::slice` finally returns a slice
11794       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
11795       * Containers reorganized around traits in `core::container`
11796       * `core::dvec` removed, `~[T]` is a drop-in replacement
11797       * `core::send_map` renamed to `core::hashmap`
11798       * `std::map` removed; replaced with `core::hashmap`
11799       * `std::treemap` reimplemented as an owned balanced tree
11800       * `std::deque` and `std::smallintmap` reimplemented as owned containers
11801       * `core::trie` added as a fast ordered map for integer keys
11802       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
11803       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
11804         overload the comparison operators, whereas `TotalOrd` is used
11805         by certain container types
11806
11807    * Other
11808       * Replaced the 'cargo' package manager with 'rustpkg'
11809       * Added all-purpose 'rust' tool
11810       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
11811       * rustc now *attempts* to offer spelling suggestions
11812       * Improved support for ARM and Android
11813       * Preliminary MIPS backend
11814       * Improved foreign function ABI implementation for x86, x86_64
11815       * Various memory usage improvements
11816       * Rust code may be embedded in foreign code under limited circumstances
11817       * Inline assembler supported by new asm!() syntax extension.
11818
11819
11820 Version 0.5 (2012-12-21)
11821 ===========================
11822
11823    * ~900 changes, numerous bugfixes
11824
11825    * Syntax changes
11826       * Removed `<-` move operator
11827       * Completed the transition from the `#fmt` extension syntax to `fmt!`
11828       * Removed old fixed length vector syntax - `[T]/N`
11829       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
11830       * Macros may now expand to items and statements
11831       * `a.b()` is always parsed as a method call, never as a field projection
11832       * `Eq` and `IterBytes` implementations can be automatically generated
11833         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
11834       * Removed the special crate language for `.rc` files
11835       * Function arguments may consist of any irrefutable pattern
11836
11837    * Semantic changes
11838       * `&` and `~` pointers may point to objects
11839       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
11840       * Enum variants may be structs
11841       * Destructors can be added to all nominal types with the Drop trait
11842       * Structs and nullary enum variants may be constants
11843       * Values that cannot be implicitly copied are now automatically moved
11844         without writing `move` explicitly
11845       * `&T` may now be coerced to `*T`
11846       * Coercions happen in `let` statements as well as function calls
11847       * `use` statements now take crate-relative paths
11848       * The module and type namespaces have been merged so that static
11849         method names can be resolved under the trait in which they are
11850         declared
11851
11852    * Improved support for language features
11853       * Trait inheritance works in many scenarios
11854       * More support for explicit self arguments in methods - `self`, `&self`
11855         `@self`, and `~self` all generally work as expected
11856       * Static methods work in more situations
11857       * Experimental: Traits may declare default methods for the implementations
11858         to use
11859
11860    * Libraries
11861       * New condition handling system in `core::condition`
11862       * Timsort added to `std::sort`
11863       * New priority queue, `std::priority_queue`
11864       * Pipes for serializable types, `std::flatpipes'
11865       * Serialization overhauled to be trait-based
11866       * Expanded `getopts` definitions
11867       * Moved futures to `std`
11868       * More functions are pure now
11869       * `core::comm` renamed to `oldcomm`. Still deprecated
11870       * `rustdoc` and `cargo` are libraries now
11871
11872    * Misc
11873       * Added a preliminary REPL, `rusti`
11874       * License changed from MIT to dual MIT/APL2
11875
11876
11877 Version 0.4 (2012-10-15)
11878 ==========================
11879
11880    * ~2000 changes, numerous bugfixes
11881
11882    * Syntax
11883       * All keywords are now strict and may not be used as identifiers anywhere
11884       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
11885         'of', 'with', 'to', 'class'.
11886       * Classes are replaced with simpler structs
11887       * Explicit method self types
11888       * `ret` became `return` and `alt` became `match`
11889       * `import` is now `use`; `use is now `extern mod`
11890       * `extern mod { ... }` is now `extern { ... }`
11891       * `use mod` is the recommended way to import modules
11892       * `pub` and `priv` replace deprecated export lists
11893       * The syntax of `match` pattern arms now uses fat arrow (=>)
11894       * `main` no longer accepts an args vector; use `os::args` instead
11895
11896    * Semantics
11897       * Trait implementations are now coherent, ala Haskell typeclasses
11898       * Trait methods may be static
11899       * Argument modes are deprecated
11900       * Borrowed pointers are much more mature and recommended for use
11901       * Strings and vectors in the static region are stored in constant memory
11902       * Typestate was removed
11903       * Resolution rewritten to be more reliable
11904       * Support for 'dual-mode' data structures (freezing and thawing)
11905
11906    * Libraries
11907       * Most binary operators can now be overloaded via the traits in
11908         `core::ops'
11909       * `std::net::url` for representing URLs
11910       * Sendable hash maps in `core::send_map`
11911       * `core::task' gained a (currently unsafe) task-local storage API
11912
11913    * Concurrency
11914       * An efficient new intertask communication primitive called the pipe,
11915         along with a number of higher-level channel types, in `core::pipes`
11916       * `std::arc`, an atomically reference counted, immutable, shared memory
11917         type
11918       * `std::sync`, various exotic synchronization tools based on arcs and pipes
11919       * Futures are now based on pipes and sendable
11920       * More robust linked task failure
11921       * Improved task builder API
11922
11923    * Other
11924       * Improved error reporting
11925       * Preliminary JIT support
11926       * Preliminary work on precise GC
11927       * Extensive architectural improvements to rustc
11928       * Begun a transition away from buggy C++-based reflection (shape) code to
11929         Rust-based (visitor) code
11930       * All hash functions and tables converted to secure, randomized SipHash
11931
11932
11933 Version 0.3  (2012-07-12)
11934 ========================
11935
11936    * ~1900 changes, numerous bugfixes
11937
11938    * New coding conveniences
11939       * Integer-literal suffix inference
11940       * Per-item control over warnings, errors
11941       * #[cfg(windows)] and #[cfg(unix)] attributes
11942       * Documentation comments
11943       * More compact closure syntax
11944       * 'do' expressions for treating higher-order functions as
11945         control structures
11946       * *-patterns (wildcard extended to all constructor fields)
11947
11948    * Semantic cleanup
11949       * Name resolution pass and exhaustiveness checker rewritten
11950       * Region pointers and borrow checking supersede alias
11951         analysis
11952       * Init-ness checking is now provided by a region-based liveness
11953         pass instead of the typestate pass; same for last-use analysis
11954       * Extensive work on region pointers
11955
11956    * Experimental new language features
11957       * Slices and fixed-size, interior-allocated vectors
11958       * #!-comments for lang versioning, shell execution
11959       * Destructors and iface implementation for classes;
11960         type-parameterized classes and class methods
11961       * 'const' type kind for types that can be used to implement
11962         shared-memory concurrency patterns
11963
11964    * Type reflection
11965
11966    * Removal of various obsolete features
11967       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
11968                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
11969
11970       * Constructs: do-while loops ('do' repurposed), fn binding,
11971                     resources (replaced by destructors)
11972
11973    * Compiler reorganization
11974       * Syntax-layer of compiler split into separate crate
11975       * Clang (from LLVM project) integrated into build
11976       * Typechecker split into sub-modules
11977
11978    * New library code
11979       * New time functions
11980       * Extension methods for many built-in types
11981       * Arc: atomic-refcount read-only / exclusive-use shared cells
11982       * Par: parallel map and search routines
11983       * Extensive work on libuv interface
11984       * Much vector code moved to libraries
11985       * Syntax extensions: #line, #col, #file, #mod, #stringify,
11986         #include, #include_str, #include_bin
11987
11988    * Tool improvements
11989       * Cargo automatically resolves dependencies
11990
11991
11992 Version 0.2  (2012-03-29)
11993 =========================
11994
11995    * >1500 changes, numerous bugfixes
11996
11997    * New docs and doc tooling
11998
11999    * New port: FreeBSD x86_64
12000
12001    * Compilation model enhancements
12002       * Generics now specialized, multiply instantiated
12003       * Functions now inlined across separate crates
12004
12005    * Scheduling, stack and threading fixes
12006       * Noticeably improved message-passing performance
12007       * Explicit schedulers
12008       * Callbacks from C
12009       * Helgrind clean
12010
12011    * Experimental new language features
12012       * Operator overloading
12013       * Region pointers
12014       * Classes
12015
12016    * Various language extensions
12017       * C-callback function types: 'crust fn ...'
12018       * Infinite-loop construct: 'loop { ... }'
12019       * Shorten 'mutable' to 'mut'
12020       * Required mutable-local qualifier: 'let mut ...'
12021       * Basic glob-exporting: 'export foo::*;'
12022       * Alt now exhaustive, 'alt check' for runtime-checked
12023       * Block-function form of 'for' loop, with 'break' and 'ret'.
12024
12025    * New library code
12026       * AST quasi-quote syntax extension
12027       * Revived libuv interface
12028       * New modules: core::{future, iter}, std::arena
12029       * Merged per-platform std::{os*, fs*} to core::{libc, os}
12030       * Extensive cleanup, regularization in libstd, libcore
12031
12032
12033 Version 0.1  (2012-01-20)
12034 ===============================
12035
12036    * Most language features work, including:
12037       * Unique pointers, unique closures, move semantics
12038       * Interface-constrained generics
12039       * Static interface dispatch
12040       * Stack growth
12041       * Multithread task scheduling
12042       * Typestate predicates
12043       * Failure unwinding, destructors
12044       * Pattern matching and destructuring assignment
12045       * Lightweight block-lambda syntax
12046       * Preliminary macro-by-example
12047
12048    * Compiler works with the following configurations:
12049       * Linux: x86 and x86_64 hosts and targets
12050       * macOS: x86 and x86_64 hosts and targets
12051       * Windows: x86 hosts and targets
12052
12053    * Cross compilation / multi-target configuration supported.
12054
12055    * Preliminary API-documentation and package-management tools included.
12056
12057 Known issues:
12058
12059    * Documentation is incomplete.
12060
12061    * Performance is below intended target.
12062
12063    * Standard library APIs are subject to extensive change, reorganization.
12064
12065    * Language-level versioning is not yet operational - future code will
12066      break unexpectedly.