RELEASES.md

   1 Version 1.66.0 (2022-12-15)
   2 ==========================
   3
   4 Language
   5 --------
   6 - [Permit specifying explicit discriminants on all `repr(Int)` enums](https://github.com/rust-lang/rust/pull/95710/)
   7   ```rust
   8   #[repr(u8)]
   9   enum Foo {
  10       A(u8) = 0,
  11       B(i8) = 1,
  12       C(bool) = 42,
  13   }
  14   ```
  15 - [Allow transmutes between the same type differing only in lifetimes](https://github.com/rust-lang/rust/pull/101520/)
  16 - [Change constant evaluation errors from a deny-by-default lint to a hard error](https://github.com/rust-lang/rust/pull/102091/)
  17 - [Trigger `must_use` on `impl Trait` for supertraits](https://github.com/rust-lang/rust/pull/102287/)
  18   This makes `impl ExactSizeIterator` respect the existing `#[must_use]` annotation on `Iterator`.
  19 - [Allow `..=X` in patterns](https://github.com/rust-lang/rust/pull/102275/)
  20 - [Uplift `clippy::for_loops_over_fallibles` lint into rustc](https://github.com/rust-lang/rust/pull/99696/)
  21 - [Stabilize `sym` operands in inline assembly](https://github.com/rust-lang/rust/pull/103168/)
  22 - [Update to Unicode 15](https://github.com/rust-lang/rust/pull/101912/)
  23 - [Opaque types no longer imply lifetime bounds](https://github.com/rust-lang/rust/pull/95474/)
  24   This is a soundness fix which may break code that was erroneously relying on this behavior.
  25
  26 Compiler
  27 --------
  28 - [Add armv5te-none-eabi and thumbv5te-none-eabi tier 3 targets](https://github.com/rust-lang/rust/pull/101329/)
  29   - Refer to Rust's [platform support page][platform-support-doc] for more
  30     information on Rust's tiered platform support.
  31 - [Add support for linking against macOS universal libraries](https://github.com/rust-lang/rust/pull/98736)
  32
  33 Libraries
  34 ---------
  35 - [Fix `#[derive(Default)]` on a generic `#[default]` enum adding unnecessary `Default` bounds](https://github.com/rust-lang/rust/pull/101040/)
  36 - [Update to Unicode 15](https://github.com/rust-lang/rust/pull/101821/)
  37
  38 Stabilized APIs
  39 ---------------
  40
  41 - [`proc_macro::Span::source_text`](https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.source_text)
  42 - [`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)
  43 - [`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)
  44 - [`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)
  45 - [`BTreeSet::{first, last, pop_first, pop_last}`](https://doc.rust-lang.org/stable/std/collections/struct.BTreeSet.html#method.first)
  46 - [`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)
  47 - [Add `AsFd` implementations for stdio lock types on WASI.](https://github.com/rust-lang/rust/pull/101768/)
  48 - [`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)
  49 - [`core::hint::black_box`](https://doc.rust-lang.org/stable/std/hint/fn.black_box.html)
  50 - [`Duration::try_from_secs_{f32,f64}`](https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.try_from_secs_f32)
  51 - [`Option::unzip`](https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.unzip)
  52 - [`std::os::fd`](https://doc.rust-lang.org/stable/std/os/fd/index.html)
  53
  54
  55 Rustdoc
  56 -------
  57
  58 - [Add Rustdoc warning for invalid HTML tags in the documentation](https://github.com/rust-lang/rust/pull/101720/)
  59
  60 Cargo
  61 -----
  62
  63 - [Added `cargo remove` to remove dependencies from Cargo.toml](https://doc.rust-lang.org/nightly/cargo/commands/cargo-remove.html)
  64 - [`cargo publish` now waits for the new version to be downloadable before exiting](https://github.com/rust-lang/cargo/pull/11062)
  65
  66 See [detailed release notes](https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-166-2022-12-15) for more.
  67
  68 Compatibility Notes
  69 -------------------
  70
  71 - [Only apply `ProceduralMasquerade` hack to older versions of `rental`](https://github.com/rust-lang/rust/pull/94063/)
  72 - [Don't export `__heap_base` and `__data_end` on wasm32-wasi.](https://github.com/rust-lang/rust/pull/102385/)
  73 - [Don't export `__wasm_init_memory` on WebAssembly.](https://github.com/rust-lang/rust/pull/102426/)
  74 - [Only export `__tls_*` on wasm32-unknown-unknown.](https://github.com/rust-lang/rust/pull/102440/)
  75 - [Don't link to `libresolv` in libstd on Darwin](https://github.com/rust-lang/rust/pull/102766/)
  76 - [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/)
  77 - [Opaque types no longer imply lifetime bounds](https://github.com/rust-lang/rust/pull/95474/)
  78   This is a soundness fix which may break code that was erroneously relying on this behavior.
  79 - [Make `order_dependent_trait_objects` show up in future-breakage reports](https://github.com/rust-lang/rust/pull/102635/)
  80 - [Change std::process::Command spawning to default to inheriting the parent's signal mask](https://github.com/rust-lang/rust/pull/101077/)
  81
  82 Internal Changes
  83 ----------------
  84
  85 These changes do not affect any public interfaces of Rust, but they represent
  86 significant improvements to the performance or internals of rustc and related
  87 tools.
  88
  89 - [Enable BOLT for LLVM compilation](https://github.com/rust-lang/rust/pull/94381/)
  90 - [Enable LTO for rustc_driver.so](https://github.com/rust-lang/rust/pull/101403/)
  91
  92 Version 1.65.0 (2022-11-03)
  93 ==========================
  94
  95 Language
  96 --------
  97 - [Error on `as` casts of enums with `#[non_exhaustive]` variants](https://github.com/rust-lang/rust/pull/92744/)
  98 - [Stabilize `let else`](https://github.com/rust-lang/rust/pull/93628/)
  99 - [Stabilize generic associated types (GATs)](https://github.com/rust-lang/rust/pull/96709/)
 100 - [Add lints `let_underscore_drop` and `let_underscore_lock` from Clippy](https://github.com/rust-lang/rust/pull/97739/)
 101 - [Stabilize `break`ing from arbitrary labeled blocks ("label-break-value")](https://github.com/rust-lang/rust/pull/99332/)
 102 - [Uninitialized integers, floats, and raw pointers are now considered immediate UB](https://github.com/rust-lang/rust/pull/98919/).
 103   Usage of `MaybeUninit` is the correct way to work with uninitialized memory.
 104 - [Stabilize raw-dylib for Windows x86_64, aarch64, and thumbv7a](https://github.com/rust-lang/rust/pull/99916/)
 105 - [Do not allow `Drop` impl on foreign ADTs](https://github.com/rust-lang/rust/pull/99576/)
 106
 107 Compiler
 108 --------
 109 - [Stabilize -Csplit-debuginfo on Linux](https://github.com/rust-lang/rust/pull/98051/)
 110 - [Use niche-filling optimization even when multiple variants have data](https://github.com/rust-lang/rust/pull/94075/)
 111 - [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)
 112 - [Stringify non-shorthand visibility correctly](https://github.com/rust-lang/rust/pull/100350/)
 113 - [Normalize struct field types when unsizing](https://github.com/rust-lang/rust/pull/101831/)
 114 - [Update to LLVM 15](https://github.com/rust-lang/rust/pull/99464/)
 115 - [Fix aarch64 call abi to correctly zeroext when needed](https://github.com/rust-lang/rust/pull/97800/)
 116 - [debuginfo: Generalize C++-like encoding for enums](https://github.com/rust-lang/rust/pull/98393/)
 117 - [Add `special_module_name` lint](https://github.com/rust-lang/rust/pull/94467/)
 118 - [Add support for generating unique profraw files by default when using `-C instrument-coverage`](https://github.com/rust-lang/rust/pull/100384/)
 119 - [Allow dynamic linking for iOS/tvOS targets](https://github.com/rust-lang/rust/pull/100636/)
 120
 121 New targets:
 122
 123 - [Add armv4t-none-eabi as a tier 3 target](https://github.com/rust-lang/rust/pull/100244/)
 124 - [Add powerpc64-unknown-openbsd and riscv64-unknown-openbsd as tier 3 targets](https://github.com/rust-lang/rust/pull/101025/)
 125   - Refer to Rust's [platform support page][platform-support-doc] for more
 126     information on Rust's tiered platform support.
 127
 128 Libraries
 129 ---------
 130
 131 - [Don't generate `PartialEq::ne` in derive(PartialEq)](https://github.com/rust-lang/rust/pull/98655/)
 132 - [Windows RNG: Use `BCRYPT_RNG_ALG_HANDLE` by default](https://github.com/rust-lang/rust/pull/101325/)
 133 - [Forbid mixing `System` with direct system allocator calls](https://github.com/rust-lang/rust/pull/101394/)
 134 - [Document no support for writing to non-blocking stdio/stderr](https://github.com/rust-lang/rust/pull/101416/)
 135 - [`std::layout::Layout` size must not overflow `isize::MAX` when rounded up to `align`](https://github.com/rust-lang/rust/pull/95295)
 136   This also changes the safety conditions on `Layout::from_size_align_unchecked`.
 137
 138 Stabilized APIs
 139 ---------------
 140
 141 - [`std::backtrace::Backtrace`](https://doc.rust-lang.org/stable/std/backtrace/struct.Backtrace.html)
 142 - [`Bound::as_ref`](https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.as_ref)
 143 - [`std::io::read_to_string`](https://doc.rust-lang.org/stable/std/io/fn.read_to_string.html)
 144 - [`<*const T>::cast_mut`](https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.cast_mut)
 145 - [`<*mut T>::cast_const`](https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.cast_const)
 146
 147 These APIs are now stable in const contexts:
 148
 149 - [`<*const T>::offset_from`](https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.offset_from)
 150 - [`<*mut T>::offset_from`](https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.offset_from)
 151
 152 Cargo
 153 -----
 154
 155 - [Apply GitHub fast path even for partial hashes](https://github.com/rust-lang/cargo/pull/10807/)
 156 - [Do not add home bin path to PATH if it's already there](https://github.com/rust-lang/cargo/pull/11023/)
 157 - [Take priority into account within the pending queue](https://github.com/rust-lang/cargo/pull/11032/).
 158   This slightly optimizes job scheduling by Cargo, with typically small improvements on larger crate graph builds.
 159
 160 Compatibility Notes
 161 -------------------
 162
 163 - [`std::layout::Layout` size must not overflow `isize::MAX` when rounded up to `align`](https://github.com/rust-lang/rust/pull/95295).
 164   This also changes the safety conditions on `Layout::from_size_align_unchecked`.
 165 - [`PollFn` now only implements `Unpin` if the closure is `Unpin`](https://github.com/rust-lang/rust/pull/102737).
 166   This is a possible breaking change if users were relying on the blanket unpin implementation.
 167   See discussion on the PR for details of why this change was made.
 168 - [Drop ExactSizeIterator impl from std::char::EscapeAscii](https://github.com/rust-lang/rust/pull/99880)
 169   This is a backwards-incompatible change to the standard library's surface
 170   area, but is unlikely to affect real world usage.
 171 - [Do not consider a single repeated lifetime eligible for elision in the return type](https://github.com/rust-lang/rust/pull/103450)
 172   This behavior was unintentionally changed in 1.64.0, and this release reverts that change by making this an error again.
 173 - [Reenable disabled early syntax gates as future-incompatibility lints](https://github.com/rust-lang/rust/pull/99935/)
 174 - [Update the minimum external LLVM to 13](https://github.com/rust-lang/rust/pull/100460/)
 175 - [Don't duplicate file descriptors into stdio fds](https://github.com/rust-lang/rust/pull/101426/)
 176 - [Sunset RLS](https://github.com/rust-lang/rust/pull/100863/)
 177 - [Deny usage of `#![cfg_attr(..., crate_type = ...)]` to set the crate type](https://github.com/rust-lang/rust/pull/99784/)
 178   This strengthens the forward compatibility lint deprecated_cfg_attr_crate_type_name to deny.
 179 - [`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)
 180   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.
 181 - 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].
 182
 183 [102754]: https://github.com/rust-lang/rust/issues/102754
 184
 185 Internal Changes
 186 ----------------
 187
 188 These changes do not affect any public interfaces of Rust, but they represent
 189 significant improvements to the performance or internals of rustc and related
 190 tools.
 191
 192 - [Add `x.sh` and `x.ps1` shell scripts](https://github.com/rust-lang/rust/pull/99992/)
 193 - [compiletest: use target cfg instead of hard-coded tables](https://github.com/rust-lang/rust/pull/100260/)
 194 - [Use object instead of LLVM for reading bitcode from rlibs](https://github.com/rust-lang/rust/pull/98100/)
 195 - [Enable MIR inlining for optimized compilations](https://github.com/rust-lang/rust/pull/91743)
 196   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).
 197
 198 Version 1.64.0 (2022-09-22)
 199 ===========================
 200
 201 Language
 202 --------
 203 - [Unions with mutable references or tuples of allowed types are now allowed](https://github.com/rust-lang/rust/pull/97995/)
 204 - 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/)
 205 - 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.
 206
 207 Compiler
 208 --------
 209 - [Add Nintendo Switch as tier 3 target](https://github.com/rust-lang/rust/pull/88991/)
 210   - Refer to Rust's [platform support page][platform-support-doc] for more
 211     information on Rust's tiered platform support.
 212 - [Only compile `#[used]` as llvm.compiler.used for ELF targets](https://github.com/rust-lang/rust/pull/93718/)
 213 - [Add the `--diagnostic-width` compiler flag to define the terminal width.](https://github.com/rust-lang/rust/pull/95635/)
 214 - [Add support for link-flavor `rust-lld` for iOS, tvOS and watchOS](https://github.com/rust-lang/rust/pull/98771/)
 215
 216 Libraries
 217 ---------
 218 - [Remove restrictions on compare-exchange memory ordering.](https://github.com/rust-lang/rust/pull/98383/)
 219 - You can now `write!` or `writeln!` into an `OsString`: [Implement `fmt::Write` for `OsString`](https://github.com/rust-lang/rust/pull/97915/)
 220 - [Make RwLockReadGuard covariant](https://github.com/rust-lang/rust/pull/96820/)
 221 - [Implement `FusedIterator` for `std::net::[Into]Incoming`](https://github.com/rust-lang/rust/pull/97300/)
 222 - [`impl<T: AsRawFd> AsRawFd for {Arc,Box}<T>`](https://github.com/rust-lang/rust/pull/97437/)
 223 - [`ptr::copy` and `ptr::swap` are doing untyped copies](https://github.com/rust-lang/rust/pull/97712/)
 224 - [Add cgroupv1 support to `available_parallelism`](https://github.com/rust-lang/rust/pull/97925/)
 225 - [Mitigate many incorrect uses of `mem::uninitialized`](https://github.com/rust-lang/rust/pull/99182/)
 226
 227 Stabilized APIs
 228 ---------------
 229
 230 - [`future::IntoFuture`](https://doc.rust-lang.org/stable/std/future/trait.IntoFuture.html)
 231 - [`future::poll_fn`](https://doc.rust-lang.org/stable/std/future/fn.poll_fn.html)
 232 - [`task::ready!`](https://doc.rust-lang.org/stable/std/task/macro.ready.html)
 233 - [`num::NonZero*::checked_mul`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroUsize.html#method.checked_mul)
 234 - [`num::NonZero*::checked_pow`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroUsize.html#method.checked_pow)
 235 - [`num::NonZero*::saturating_mul`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroUsize.html#method.saturating_mul)
 236 - [`num::NonZero*::saturating_pow`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroUsize.html#method.saturating_pow)
 237 - [`num::NonZeroI*::abs`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroIsize.html#method.abs)
 238 - [`num::NonZeroI*::checked_abs`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroIsize.html#method.checked_abs)
 239 - [`num::NonZeroI*::overflowing_abs`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroIsize.html#method.overflowing_abs)
 240 - [`num::NonZeroI*::saturating_abs`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroIsize.html#method.saturating_abs)
 241 - [`num::NonZeroI*::unsigned_abs`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroIsize.html#method.unsigned_abs)
 242 - [`num::NonZeroI*::wrapping_abs`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroIsize.html#method.wrapping_abs)
 243 - [`num::NonZeroU*::checked_add`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroUsize.html#method.checked_add)
 244 - [`num::NonZeroU*::checked_next_power_of_two`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroUsize.html#method.checked_next_power_of_two)
 245 - [`num::NonZeroU*::saturating_add`](https://doc.rust-lang.org/stable/std/num/struct.NonZeroUsize.html#method.saturating_add)
 246 - [`os::unix::process::CommandExt::process_group`](https://doc.rust-lang.org/stable/std/os/unix/process/trait.CommandExt.html#tymethod.process_group)
 247 - [`os::windows::fs::FileTypeExt::is_symlink_dir`](https://doc.rust-lang.org/stable/std/os/windows/fs/trait.FileTypeExt.html#tymethod.is_symlink_dir)
 248 - [`os::windows::fs::FileTypeExt::is_symlink_file`](https://doc.rust-lang.org/stable/std/os/windows/fs/trait.FileTypeExt.html#tymethod.is_symlink_file)
 249
 250 These types were previously stable in `std::ffi`, but are now also available in `core` and `alloc`:
 251
 252 - [`core::ffi::CStr`](https://doc.rust-lang.org/stable/core/ffi/struct.CStr.html)
 253 - [`core::ffi::FromBytesWithNulError`](https://doc.rust-lang.org/stable/core/ffi/struct.FromBytesWithNulError.html)
 254 - [`alloc::ffi::CString`](https://doc.rust-lang.org/stable/alloc/ffi/struct.CString.html)
 255 - [`alloc::ffi::FromVecWithNulError`](https://doc.rust-lang.org/stable/alloc/ffi/struct.FromVecWithNulError.html)
 256 - [`alloc::ffi::IntoStringError`](https://doc.rust-lang.org/stable/alloc/ffi/struct.IntoStringError.html)
 257 - [`alloc::ffi::NulError`](https://doc.rust-lang.org/stable/alloc/ffi/struct.NulError.html)
 258
 259 These types were previously stable in `std::os::raw`, but are now also available in `core::ffi` and `std::ffi`:
 260
 261 - [`ffi::c_char`](https://doc.rust-lang.org/stable/std/ffi/type.c_char.html)
 262 - [`ffi::c_double`](https://doc.rust-lang.org/stable/std/ffi/type.c_double.html)
 263 - [`ffi::c_float`](https://doc.rust-lang.org/stable/std/ffi/type.c_float.html)
 264 - [`ffi::c_int`](https://doc.rust-lang.org/stable/std/ffi/type.c_int.html)
 265 - [`ffi::c_long`](https://doc.rust-lang.org/stable/std/ffi/type.c_long.html)
 266 - [`ffi::c_longlong`](https://doc.rust-lang.org/stable/std/ffi/type.c_longlong.html)
 267 - [`ffi::c_schar`](https://doc.rust-lang.org/stable/std/ffi/type.c_schar.html)
 268 - [`ffi::c_short`](https://doc.rust-lang.org/stable/std/ffi/type.c_short.html)
 269 - [`ffi::c_uchar`](https://doc.rust-lang.org/stable/std/ffi/type.c_uchar.html)
 270 - [`ffi::c_uint`](https://doc.rust-lang.org/stable/std/ffi/type.c_uint.html)
 271 - [`ffi::c_ulong`](https://doc.rust-lang.org/stable/std/ffi/type.c_ulong.html)
 272 - [`ffi::c_ulonglong`](https://doc.rust-lang.org/stable/std/ffi/type.c_ulonglong.html)
 273 - [`ffi::c_ushort`](https://doc.rust-lang.org/stable/std/ffi/type.c_ushort.html)
 274
 275 These APIs are now usable in const contexts:
 276
 277 - [`slice::from_raw_parts`](https://doc.rust-lang.org/stable/core/slice/fn.from_raw_parts.html)
 278
 279 Cargo
 280 -----
 281 - [Packages can now inherit settings from the workspace so that the settings
 282   can be centralized in one place.](https://github.com/rust-lang/cargo/pull/10859) See
 283   [`workspace.package`](https://doc.rust-lang.org/nightly/cargo/reference/workspaces.html#the-workspacepackage-table)
 284   and
 285   [`workspace.dependencies`](https://doc.rust-lang.org/nightly/cargo/reference/workspaces.html#the-workspacedependencies-table)
 286   for more details on how to define these common settings.
 287 - [Cargo commands can now accept multiple `--target` flags to build for
 288   multiple targets at once](https://github.com/rust-lang/cargo/pull/10766), and the
 289   [`build.target`](https://doc.rust-lang.org/nightly/cargo/reference/config.html#buildtarget)
 290   config option may now take an array of multiple targets.
 291 - [The `--jobs` argument can now take a negative number to count backwards from
 292   the max CPUs.](https://github.com/rust-lang/cargo/pull/10844)
 293 - [`cargo add` will now update `Cargo.lock`.](https://github.com/rust-lang/cargo/pull/10902)
 294 - [Added](https://github.com/rust-lang/cargo/pull/10838) the
 295   [`--crate-type`](https://doc.rust-lang.org/nightly/cargo/commands/cargo-rustc.html#option-cargo-rustc---crate-type)
 296   flag to `cargo rustc` to override the crate type.
 297 - [Significantly improved the performance fetching git dependencies from GitHub
 298   when using a hash in the `rev` field.](https://github.com/rust-lang/cargo/pull/10079)
 299
 300 Misc
 301 ----
 302 - [The `rust-analyzer` rustup component is now available on the stable channel.](https://github.com/rust-lang/rust/pull/98640/)
 303
 304 Compatibility Notes
 305 -------------------
 306 - 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/)
 307 - [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.
 308 - [Add assertion that `transmute_copy`'s `U` is not larger than `T`](https://github.com/rust-lang/rust/pull/98839/)
 309 - [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.
 310 - [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.
 311 - [Relate late-bound closure lifetimes to parent fn in NLL](https://github.com/rust-lang/rust/pull/98835/)
 312 - [Errors at const-eval time are now in future incompatibility reports](https://github.com/rust-lang/rust/pull/97743/)
 313 - 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/).
 314 - [`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.
 315
 316 Internal Changes
 317 ----------------
 318
 319 These changes do not affect any public interfaces of Rust, but they represent
 320 significant improvements to the performance or internals of rustc and related
 321 tools.
 322
 323 - 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/)
 324 - [Stop keeping metadata in memory before writing it to disk](https://github.com/rust-lang/rust/pull/96544/)
 325 - [compiletest: strip debuginfo by default for mode=ui](https://github.com/rust-lang/rust/pull/98140/)
 326 - Many improvements to generated code for derives, including performance improvements:
 327   - [Don't use match-destructuring for derived ops on structs.](https://github.com/rust-lang/rust/pull/98446/)
 328   - [Many small deriving cleanups](https://github.com/rust-lang/rust/pull/98741/)
 329   - [More derive output improvements](https://github.com/rust-lang/rust/pull/98758/)
 330   - [Clarify deriving code](https://github.com/rust-lang/rust/pull/98915/)
 331   - [Final derive output improvements](https://github.com/rust-lang/rust/pull/99046/)
 332   - [Stop injecting `#[allow(unused_qualifications)]` in generated `derive` implementations](https://github.com/rust-lang/rust/pull/99485/)
 333   - [Improve `derive(Debug)`](https://github.com/rust-lang/rust/pull/98190/)
 334 - [Bump to clap 3](https://github.com/rust-lang/rust/pull/98213/)
 335 - [fully move dropck to mir](https://github.com/rust-lang/rust/pull/98641/)
 336 - [Optimize `Vec::insert` for the case where `index == len`.](https://github.com/rust-lang/rust/pull/98755/)
 337 - [Convert rust-analyzer to an in-tree tool](https://github.com/rust-lang/rust/pull/99603/)
 338
 339 Version 1.63.0 (2022-08-11)
 340 ==========================
 341
 342 Language
 343 --------
 344 - [Remove migrate borrowck mode for pre-NLL errors.][95565]
 345 - [Modify MIR building to drop repeat expressions with length zero.][95953]
 346 - [Remove label/lifetime shadowing warnings.][96296]
 347 - [Allow explicit generic arguments in the presence of `impl Trait` args.][96868]
 348 - [Make `cenum_impl_drop_cast` warnings deny-by-default.][97652]
 349 - [Prevent unwinding when `-C panic=abort` is used regardless of declared ABI.][96959]
 350 - [lub: don't bail out due to empty binders.][97867]
 351
 352 Compiler
 353 --------
 354 - [Stabilize the `bundle` native library modifier,][95818] also removing the
 355   deprecated `static-nobundle` linking kind.
 356 - [Add Apple WatchOS compile targets\*.][95243]
 357 - [Add a Windows application manifest to rustc-main.][96737]
 358
 359 \* Refer to Rust's [platform support page][platform-support-doc] for more
 360    information on Rust's tiered platform support.
 361
 362 Libraries
 363 ---------
 364 - [Implement `Copy`, `Clone`, `PartialEq` and `Eq` for `core::fmt::Alignment`.][94530]
 365 - [Extend `ptr::null` and `null_mut` to all thin (including extern) types.][94954]
 366 - [`impl Read and Write for VecDeque<u8>`.][95632]
 367 - [STD support for the Nintendo 3DS.][95897]
 368 - [Use rounding in float to Duration conversion methods.][96051]
 369 - [Make write/print macros eagerly drop temporaries.][96455]
 370 - [Implement internal traits that enable `[OsStr]::join`.][96881]
 371 - [Implement `Hash` for `core::alloc::Layout`.][97034]
 372 - [Add capacity documentation for `OsString`.][97202]
 373 - [Put a bound on collection misbehavior.][97316]
 374 - [Make `std::mem::needs_drop` accept `?Sized`.][97675]
 375 - [`impl Termination for Infallible` and then make the `Result` impls of `Termination` more generic.][97803]
 376 - [Document Rust's stance on `/proc/self/mem`.][97837]
 377
 378 Stabilized APIs
 379 ---------------
 380
 381 - [`array::from_fn`]
 382 - [`Box::into_pin`]
 383 - [`BinaryHeap::try_reserve`]
 384 - [`BinaryHeap::try_reserve_exact`]
 385 - [`OsString::try_reserve`]
 386 - [`OsString::try_reserve_exact`]
 387 - [`PathBuf::try_reserve`]
 388 - [`PathBuf::try_reserve_exact`]
 389 - [`Path::try_exists`]
 390 - [`Ref::filter_map`]
 391 - [`RefMut::filter_map`]
 392 - [`NonNull::<[T]>::len`][`NonNull::<slice>::len`]
 393 - [`ToOwned::clone_into`]
 394 - [`Ipv6Addr::to_ipv4_mapped`]
 395 - [`unix::io::AsFd`]
 396 - [`unix::io::BorrowedFd<'fd>`]
 397 - [`unix::io::OwnedFd`]
 398 - [`windows::io::AsHandle`]
 399 - [`windows::io::BorrowedHandle<'handle>`]
 400 - [`windows::io::OwnedHandle`]
 401 - [`windows::io::HandleOrInvalid`]
 402 - [`windows::io::HandleOrNull`]
 403 - [`windows::io::InvalidHandleError`]
 404 - [`windows::io::NullHandleError`]
 405 - [`windows::io::AsSocket`]
 406 - [`windows::io::BorrowedSocket<'handle>`]
 407 - [`windows::io::OwnedSocket`]
 408 - [`thread::scope`]
 409 - [`thread::Scope`]
 410 - [`thread::ScopedJoinHandle`]
 411
 412 These APIs are now usable in const contexts:
 413
 414 - [`array::from_ref`]
 415 - [`slice::from_ref`]
 416 - [`intrinsics::copy`]
 417 - [`intrinsics::copy_nonoverlapping`]
 418 - [`<*const T>::copy_to`]
 419 - [`<*const T>::copy_to_nonoverlapping`]
 420 - [`<*mut T>::copy_to`]
 421 - [`<*mut T>::copy_to_nonoverlapping`]
 422 - [`<*mut T>::copy_from`]
 423 - [`<*mut T>::copy_from_nonoverlapping`]
 424 - [`str::from_utf8`]
 425 - [`Utf8Error::error_len`]
 426 - [`Utf8Error::valid_up_to`]
 427 - [`Condvar::new`]
 428 - [`Mutex::new`]
 429 - [`RwLock::new`]
 430
 431 Cargo
 432 -----
 433 - [Stabilize the `--config path` command-line argument.][cargo/10755]
 434 - [Expose rust-version in the environment as `CARGO_PKG_RUST_VERSION`.][cargo/10713]
 435
 436 Compatibility Notes
 437 -------------------
 438
 439 - [`#[link]` attributes are now checked more strictly,][96885] which may introduce
 440   errors for invalid attribute arguments that were previously ignored.
 441 - [Rounding is now used when converting a float to a `Duration`.][96051] The converted
 442   duration can differ slightly from what it was.
 443
 444 Internal Changes
 445 ----------------
 446
 447 These changes provide no direct user facing benefits, but represent significant
 448 improvements to the internals and overall performance of rustc
 449 and related tools.
 450
 451 - [Prepare Rust for LLVM opaque pointers.][94214]
 452
 453 [94214]: https://github.com/rust-lang/rust/pull/94214/
 454 [94530]: https://github.com/rust-lang/rust/pull/94530/
 455 [94954]: https://github.com/rust-lang/rust/pull/94954/
 456 [95243]: https://github.com/rust-lang/rust/pull/95243/
 457 [95565]: https://github.com/rust-lang/rust/pull/95565/
 458 [95632]: https://github.com/rust-lang/rust/pull/95632/
 459 [95818]: https://github.com/rust-lang/rust/pull/95818/
 460 [95897]: https://github.com/rust-lang/rust/pull/95897/
 461 [95953]: https://github.com/rust-lang/rust/pull/95953/
 462 [96051]: https://github.com/rust-lang/rust/pull/96051/
 463 [96296]: https://github.com/rust-lang/rust/pull/96296/
 464 [96455]: https://github.com/rust-lang/rust/pull/96455/
 465 [96737]: https://github.com/rust-lang/rust/pull/96737/
 466 [96868]: https://github.com/rust-lang/rust/pull/96868/
 467 [96881]: https://github.com/rust-lang/rust/pull/96881/
 468 [96885]: https://github.com/rust-lang/rust/pull/96885/
 469 [96959]: https://github.com/rust-lang/rust/pull/96959/
 470 [97034]: https://github.com/rust-lang/rust/pull/97034/
 471 [97202]: https://github.com/rust-lang/rust/pull/97202/
 472 [97316]: https://github.com/rust-lang/rust/pull/97316/
 473 [97652]: https://github.com/rust-lang/rust/pull/97652/
 474 [97675]: https://github.com/rust-lang/rust/pull/97675/
 475 [97803]: https://github.com/rust-lang/rust/pull/97803/
 476 [97837]: https://github.com/rust-lang/rust/pull/97837/
 477 [97867]: https://github.com/rust-lang/rust/pull/97867/
 478 [cargo/10713]: https://github.com/rust-lang/cargo/pull/10713/
 479 [cargo/10755]: https://github.com/rust-lang/cargo/pull/10755/
 480
 481 [`array::from_fn`]: https://doc.rust-lang.org/stable/std/array/fn.from_fn.html
 482 [`Box::into_pin`]: https://doc.rust-lang.org/stable/std/boxed/struct.Box.html#method.into_pin
 483 [`BinaryHeap::try_reserve_exact`]: https://doc.rust-lang.org/stable/alloc/collections/binary_heap/struct.BinaryHeap.html#method.try_reserve_exact
 484 [`BinaryHeap::try_reserve`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.try_reserve
 485 [`OsString::try_reserve`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.try_reserve
 486 [`OsString::try_reserve_exact`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.try_reserve_exact
 487 [`PathBuf::try_reserve`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.try_reserve
 488 [`PathBuf::try_reserve_exact`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.try_reserve_exact
 489 [`Path::try_exists`]: https://doc.rust-lang.org/stable/std/path/struct.Path.html#method.try_exists
 490 [`Ref::filter_map`]: https://doc.rust-lang.org/stable/std/cell/struct.Ref.html#method.filter_map
 491 [`RefMut::filter_map`]: https://doc.rust-lang.org/stable/std/cell/struct.RefMut.html#method.filter_map
 492 [`NonNull::<slice>::len`]: https://doc.rust-lang.org/stable/std/ptr/struct.NonNull.html#method.len
 493 [`ToOwned::clone_into`]: https://doc.rust-lang.org/stable/std/borrow/trait.ToOwned.html#method.clone_into
 494 [`Ipv6Addr::to_ipv4_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4_mapped
 495 [`unix::io::AsFd`]: https://doc.rust-lang.org/stable/std/os/unix/io/trait.AsFd.html
 496 [`unix::io::BorrowedFd<'fd>`]: https://doc.rust-lang.org/stable/std/os/unix/io/struct.BorrowedFd.html
 497 [`unix::io::OwnedFd`]: https://doc.rust-lang.org/stable/std/os/unix/io/struct.OwnedFd.html
 498 [`windows::io::AsHandle`]: https://doc.rust-lang.org/stable/std/os/windows/io/trait.AsHandle.html
 499 [`windows::io::BorrowedHandle<'handle>`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.BorrowedHandle.html
 500 [`windows::io::OwnedHandle`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.OwnedHandle.html
 501 [`windows::io::HandleOrInvalid`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.HandleOrInvalid.html
 502 [`windows::io::HandleOrNull`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.HandleOrNull.html
 503 [`windows::io::InvalidHandleError`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.InvalidHandleError.html
 504 [`windows::io::NullHandleError`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.NullHandleError.html
 505 [`windows::io::AsSocket`]: https://doc.rust-lang.org/stable/std/os/windows/io/trait.AsSocket.html
 506 [`windows::io::BorrowedSocket<'handle>`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.BorrowedSocket.html
 507 [`windows::io::OwnedSocket`]: https://doc.rust-lang.org/stable/std/os/windows/io/struct.OwnedSocket.html
 508 [`thread::scope`]: https://doc.rust-lang.org/stable/std/thread/fn.scope.html
 509 [`thread::Scope`]: https://doc.rust-lang.org/stable/std/thread/struct.Scope.html
 510 [`thread::ScopedJoinHandle`]: https://doc.rust-lang.org/stable/std/thread/struct.ScopedJoinHandle.html
 511
 512 [`array::from_ref`]: https://doc.rust-lang.org/stable/std/array/fn.from_ref.html
 513 [`slice::from_ref`]: https://doc.rust-lang.org/stable/std/slice/fn.from_ref.html
 514 [`intrinsics::copy`]: https://doc.rust-lang.org/stable/std/intrinsics/fn.copy.html
 515 [`intrinsics::copy_nonoverlapping`]: https://doc.rust-lang.org/stable/std/intrinsics/fn.copy_nonoverlapping.html
 516 [`<*const T>::copy_to`]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.copy_to
 517 [`<*const T>::copy_to_nonoverlapping`]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.copy_to_nonoverlapping
 518 [`<*mut T>::copy_to`]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.copy_to-1
 519 [`<*mut T>::copy_to_nonoverlapping`]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
 520 [`<*mut T>::copy_from`]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.copy_from
 521 [`<*mut T>::copy_from_nonoverlapping`]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.copy_from_nonoverlapping
 522 [`str::from_utf8`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8.html
 523 [`Utf8Error::error_len`]: https://doc.rust-lang.org/stable/std/str/struct.Utf8Error.html#method.error_len
 524 [`Utf8Error::valid_up_to`]: https://doc.rust-lang.org/stable/std/str/struct.Utf8Error.html#method.valid_up_to
 525 [`Condvar::new`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.new
 526 [`Mutex::new`]: https://doc.rust-lang.org/stable/std/sync/struct.Mutex.html#method.new
 527 [`RwLock::new`]: https://doc.rust-lang.org/stable/std/sync/struct.RwLock.html#method.new
 528
 529 Version 1.62.1 (2022-07-19)
 530 ==========================
 531
 532 Rust 1.62.1 addresses a few recent regressions in the compiler and standard
 533 library, and also mitigates a CPU vulnerability on Intel SGX.
 534
 535 * [The compiler fixed unsound function coercions involving `impl Trait` return types.][98608]
 536 * [The compiler fixed an incremental compilation bug with `async fn` lifetimes.][98890]
 537 * [Windows added a fallback for overlapped I/O in synchronous reads and writes.][98950]
 538 * [The `x86_64-fortanix-unknown-sgx` target added a mitigation for the
 539   MMIO stale data vulnerability][98126], advisory [INTEL-SA-00615].
 540
 541 [98608]: https://github.com/rust-lang/rust/issues/98608
 542 [98890]: https://github.com/rust-lang/rust/issues/98890
 543 [98950]: https://github.com/rust-lang/rust/pull/98950
 544 [98126]: https://github.com/rust-lang/rust/pull/98126
 545 [INTEL-SA-00615]: https://www.intel.com/content/www/us/en/security-center/advisory/intel-sa-00615.html
 546
 547 Version 1.62.0 (2022-06-30)
 548 ==========================
 549
 550 Language
 551 --------
 552
 553 - [Stabilize `#[derive(Default)]` on enums with a `#[default]` variant][94457]
 554 - [Teach flow sensitive checks that visibly uninhabited call expressions never return][93313]
 555 - [Fix constants not getting dropped if part of a diverging expression][94775]
 556 - [Support unit struct/enum variant in destructuring assignment][95380]
 557 - [Remove mutable_borrow_reservation_conflict lint and allow the code pattern][96268]
 558 - [`const` functions may now specify `extern "C"` or `extern "Rust"`][95346]
 559
 560 Compiler
 561 --------
 562
 563 - [linker: Stop using whole-archive on dependencies of dylibs][96436]
 564 - [Make `unaligned_references` lint deny-by-default][95372]
 565   This lint is also a future compatibility lint, and is expected to eventually
 566   become a hard error.
 567 - [Only add codegen backend to dep info if -Zbinary-dep-depinfo is used][93969]
 568 - [Reject `#[thread_local]` attribute on non-static items][95006]
 569 - [Add tier 3 `aarch64-pc-windows-gnullvm` and `x86_64-pc-windows-gnullvm` targets\*][94872]
 570 - [Implement a lint to warn about unused macro rules][96150]
 571 - [Promote `x86_64-unknown-none` target to Tier 2\*][95705]
 572
 573 \* Refer to Rust's [platform support page][platform-support-doc] for more
 574    information on Rust's tiered platform support.
 575
 576 Libraries
 577 ---------
 578
 579 - [Windows: Use a pipe relay for chaining pipes][95841]
 580 - [Replace Linux Mutex and Condvar with futex based ones.][95035]
 581 - [Replace RwLock by a futex based one on Linux][95801]
 582 - [std: directly use pthread in UNIX parker implementation][96393]
 583
 584 Stabilized APIs
 585 ---------------
 586
 587 - [`bool::then_some`]
 588 - [`f32::total_cmp`]
 589 - [`f64::total_cmp`]
 590 - [`Stdin::lines`]
 591 - [`windows::CommandExt::raw_arg`]
 592 - [`impl<T: Default> Default for AssertUnwindSafe<T>`]
 593 - [`From<Rc<str>> for Rc<[u8]>`][rc-u8-from-str]
 594 - [`From<Arc<str>> for Arc<[u8]>`][arc-u8-from-str]
 595 - [`FusedIterator for EncodeWide`]
 596 - [RDM intrinsics on aarch64][stdarch/1285]
 597
 598 Clippy
 599 ------
 600
 601 - [Create clippy lint against unexpectedly late drop for temporaries in match scrutinee expressions][94206]
 602
 603 Cargo
 604 -----
 605
 606 - Added the `cargo add` command for adding dependencies to `Cargo.toml` from
 607   the command-line.
 608   [docs](https://doc.rust-lang.org/nightly/cargo/commands/cargo-add.html)
 609 - Package ID specs now support `name@version` syntax in addition to the
 610   previous `name:version` to align with the behavior in `cargo add` and other
 611   tools. `cargo install` and `cargo yank` also now support this syntax so the
 612   version does not need to passed as a separate flag.
 613 - The `git` and `registry` directories in Cargo's home directory (usually
 614   `~/.cargo`) are now marked as cache directories so that they are not
 615   included in backups or content indexing (on Windows).
 616 - Added automatic `@` argfile support, which will use "response files" if the
 617   command-line to `rustc` exceeds the operating system's limit.
 618
 619 Compatibility Notes
 620 -------------------
 621
 622 - `cargo test` now passes `--target` to `rustdoc` if the specified target is
 623   the same as the host target.
 624   [#10594](https://github.com/rust-lang/cargo/pull/10594)
 625 - [rustdoc: doctests are now run on unexported `macro_rules!` macros, matching other private items][96630]
 626 - [rustdoc: Remove .woff font files][96279]
 627 - [Enforce Copy bounds for repeat elements while considering lifetimes][95819]
 628 - [Windows: Fix potentinal unsoundness by aborting if `File` reads or writes cannot
 629   complete synchronously][95469].
 630
 631 Internal Changes
 632 ----------------
 633
 634 - [Unify ReentrantMutex implementations across all platforms][96042]
 635
 636 These changes provide no direct user facing benefits, but represent significant
 637 improvements to the internals and overall performance of rustc
 638 and related tools.
 639
 640 [93313]: https://github.com/rust-lang/rust/pull/93313/
 641 [93969]: https://github.com/rust-lang/rust/pull/93969/
 642 [94206]: https://github.com/rust-lang/rust/pull/94206/
 643 [94457]: https://github.com/rust-lang/rust/pull/94457/
 644 [94775]: https://github.com/rust-lang/rust/pull/94775/
 645 [94872]: https://github.com/rust-lang/rust/pull/94872/
 646 [95006]: https://github.com/rust-lang/rust/pull/95006/
 647 [95035]: https://github.com/rust-lang/rust/pull/95035/
 648 [95346]: https://github.com/rust-lang/rust/pull/95346/
 649 [95372]: https://github.com/rust-lang/rust/pull/95372/
 650 [95380]: https://github.com/rust-lang/rust/pull/95380/
 651 [95431]: https://github.com/rust-lang/rust/pull/95431/
 652 [95469]: https://github.com/rust-lang/rust/pull/95469/
 653 [95705]: https://github.com/rust-lang/rust/pull/95705/
 654 [95801]: https://github.com/rust-lang/rust/pull/95801/
 655 [95819]: https://github.com/rust-lang/rust/pull/95819/
 656 [95841]: https://github.com/rust-lang/rust/pull/95841/
 657 [96042]: https://github.com/rust-lang/rust/pull/96042/
 658 [96150]: https://github.com/rust-lang/rust/pull/96150/
 659 [96268]: https://github.com/rust-lang/rust/pull/96268/
 660 [96279]: https://github.com/rust-lang/rust/pull/96279/
 661 [96393]: https://github.com/rust-lang/rust/pull/96393/
 662 [96436]: https://github.com/rust-lang/rust/pull/96436/
 663 [96557]: https://github.com/rust-lang/rust/pull/96557/
 664 [96630]: https://github.com/rust-lang/rust/pull/96630/
 665
 666 [`bool::then_some`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then_some
 667 [`f32::total_cmp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.total_cmp
 668 [`f64::total_cmp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.total_cmp
 669 [`Stdin::lines`]: https://doc.rust-lang.org/stable/std/io/struct.Stdin.html#method.lines
 670 [`impl<T: Default> Default for AssertUnwindSafe<T>`]: https://doc.rust-lang.org/stable/std/panic/struct.AssertUnwindSafe.html#impl-Default
 671 [rc-u8-from-str]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#impl-From%3CRc%3Cstr%3E%3E
 672 [arc-u8-from-str]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#impl-From%3CArc%3Cstr%3E%3E
 673 [stdarch/1285]: https://github.com/rust-lang/stdarch/pull/1285
 674 [`windows::CommandExt::raw_arg`]: https://doc.rust-lang.org/stable/std/os/windows/process/trait.CommandExt.html#tymethod.raw_arg
 675 [`FusedIterator for EncodeWide`]: https://doc.rust-lang.org/stable/std/os/windows/ffi/struct.EncodeWide.html#impl-FusedIterator
 676
 677 Version 1.61.0 (2022-05-19)
 678 ==========================
 679
 680 Language
 681 --------
 682
 683 - [`const fn` signatures can now include generic trait bounds][93827]
 684 - [`const fn` signatures can now use `impl Trait` in argument and return position][93827]
 685 - [Function pointers can now be created, cast, and passed around in a `const fn`][93827]
 686 - [Recursive calls can now set the value of a function's opaque `impl Trait` return type][94081]
 687
 688 Compiler
 689 --------
 690
 691 - [Linking modifier syntax in `#[link]` attributes and on the command line, as well as the `whole-archive` modifier specifically, are now supported][93901]
 692 - [The `char` type is now described as UTF-32 in debuginfo][89887]
 693 - The [`#[target_feature]`][target_feature] attribute [can now be used with aarch64 features][90621]
 694 - X86 [`#[target_feature = "adx"]` is now stable][93745]
 695
 696 Libraries
 697 ---------
 698
 699 - [`ManuallyDrop<T>` is now documented to have the same layout as `T`][88375]
 700 - [`#[ignore = "…"]` messages are printed when running tests][92714]
 701 - [Consistently show absent stdio handles on Windows as NULL handles][93263]
 702 - [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.
 703 - [`Vec::from_raw_parts` is now less restrictive about its inputs][95016]
 704 - [`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.
 705
 706 Stabilized APIs
 707 ---------------
 708
 709 - [`Pin::static_mut`]
 710 - [`Pin::static_ref`]
 711 - [`Vec::retain_mut`]
 712 - [`VecDeque::retain_mut`]
 713 - [`Write` for `Cursor<[u8; N]>`][cursor-write-array]
 714 - [`std::os::unix::net::SocketAddr::from_pathname`]
 715 - [`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.
 716 - [`std::thread::JoinHandle::is_finished`]
 717
 718 These APIs are now usable in const contexts:
 719
 720 - [`<*const T>::offset` and `<*mut T>::offset`][ptr-offset]
 721 - [`<*const T>::wrapping_offset` and `<*mut T>::wrapping_offset`][ptr-wrapping_offset]
 722 - [`<*const T>::add` and `<*mut T>::add`][ptr-add]
 723 - [`<*const T>::sub` and `<*mut T>::sub`][ptr-sub]
 724 - [`<*const T>::wrapping_add` and `<*mut T>::wrapping_add`][ptr-wrapping_add]
 725 - [`<*const T>::wrapping_sub` and `<*mut T>::wrapping_sub`][ptr-wrapping_sub]
 726 - [`<[T]>::as_mut_ptr`][slice-as_mut_ptr]
 727 - [`<[T]>::as_ptr_range`][slice-as_ptr_range]
 728 - [`<[T]>::as_mut_ptr_range`][slice-as_mut_ptr_range]
 729
 730 Cargo
 731 -----
 732
 733 No feature changes, but see compatibility notes.
 734
 735 Compatibility Notes
 736 -------------------
 737
 738 - 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
 739   - (more common) either be reordered to respect dependencies between them (if `a` depends on `b` then `a` should go first and `b` second)
 740   - (less common) or be updated to use the [`+whole-archive`] modifier.
 741 - [Catching a second unwind from FFI code while cleaning up from a Rust panic now causes the process to abort][92911]
 742 - [Proc macros no longer see `ident` matchers wrapped in groups][92472]
 743 - [The number of `#` in `r#` raw string literals is now required to be less than 256][95251]
 744 - [When checking that a dyn type satisfies a trait bound, supertrait bounds are now enforced][92285]
 745 - [`cargo vendor` now only accepts one value for each `--sync` flag][cargo/10448]
 746 - [`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`.
 747 - [bootstrap: static-libstdcpp is now enabled by default, and can now be disabled when llvm-tools is enabled][94832]
 748
 749 Internal Changes
 750 ----------------
 751
 752 These changes provide no direct user facing benefits, but represent significant
 753 improvements to the internals and overall performance of rustc
 754 and related tools.
 755
 756 - [debuginfo: Refactor debuginfo generation for types][94261]
 757 - [Remove the everybody loops pass][93913]
 758
 759 [88375]: https://github.com/rust-lang/rust/pull/88375/
 760 [89887]: https://github.com/rust-lang/rust/pull/89887/
 761 [90621]: https://github.com/rust-lang/rust/pull/90621/
 762 [92285]: https://github.com/rust-lang/rust/pull/92285/
 763 [92472]: https://github.com/rust-lang/rust/pull/92472/
 764 [92697]: https://github.com/rust-lang/rust/pull/92697/
 765 [92714]: https://github.com/rust-lang/rust/pull/92714/
 766 [92911]: https://github.com/rust-lang/rust/pull/92911/
 767 [93263]: https://github.com/rust-lang/rust/pull/93263/
 768 [93745]: https://github.com/rust-lang/rust/pull/93745/
 769 [93827]: https://github.com/rust-lang/rust/pull/93827/
 770 [93901]: https://github.com/rust-lang/rust/pull/93901/
 771 [93913]: https://github.com/rust-lang/rust/pull/93913/
 772 [93965]: https://github.com/rust-lang/rust/pull/93965/
 773 [94081]: https://github.com/rust-lang/rust/pull/94081/
 774 [94261]: https://github.com/rust-lang/rust/pull/94261/
 775 [94295]: https://github.com/rust-lang/rust/pull/94295/
 776 [94832]: https://github.com/rust-lang/rust/pull/94832/
 777 [95016]: https://github.com/rust-lang/rust/pull/95016/
 778 [95251]: https://github.com/rust-lang/rust/pull/95251/
 779 [`+whole-archive`]: https://doc.rust-lang.org/stable/rustc/command-line-arguments.html#linking-modifiers-whole-archive
 780 [`Pin::static_mut`]: https://doc.rust-lang.org/stable/std/pin/struct.Pin.html#method.static_mut
 781 [`Pin::static_ref`]: https://doc.rust-lang.org/stable/std/pin/struct.Pin.html#method.static_ref
 782 [`Vec::retain_mut`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.retain_mut
 783 [`VecDeque::retain_mut`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.retain_mut
 784 [`std::os::unix::net::SocketAddr::from_pathname`]: https://doc.rust-lang.org/stable/std/os/unix/net/struct.SocketAddr.html#method.from_pathname
 785 [`std::process::ExitCode`]: https://doc.rust-lang.org/stable/std/process/struct.ExitCode.html
 786 [`std::process::Termination`]: https://doc.rust-lang.org/stable/std/process/trait.Termination.html
 787 [`std::thread::JoinHandle::is_finished`]: https://doc.rust-lang.org/stable/std/thread/struct.JoinHandle.html#method.is_finished
 788 [cargo/10448]: https://github.com/rust-lang/cargo/pull/10448/
 789 [cursor-write-array]: https://doc.rust-lang.org/stable/std/io/struct.Cursor.html#impl-Write-4
 790 [link-attr]: https://doc.rust-lang.org/stable/reference/items/external-blocks.html#the-link-attribute
 791 [ptr-add]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.add
 792 [ptr-offset]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.offset
 793 [ptr-sub]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.sub
 794 [ptr-wrapping_add]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.wrapping_add
 795 [ptr-wrapping_offset]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.wrapping_offset
 796 [ptr-wrapping_sub]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.wrapping_sub
 797 [slice-as_mut_ptr]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.as_mut_ptr
 798 [slice-as_mut_ptr_range]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.as_mut_ptr_range
 799 [slice-as_ptr_range]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.as_ptr_range
 800 [target_feature]: https://doc.rust-lang.org/reference/attributes/codegen.html#the-target_feature-attribute
 801
 802
 803 Version 1.60.0 (2022-04-07)
 804 ==========================
 805
 806 Language
 807 --------
 808 - [Stabilize `#[cfg(panic = "...")]` for either `"unwind"` or `"abort"`.][93658]
 809 - [Stabilize `#[cfg(target_has_atomic = "...")]` for each integer size and `"ptr"`.][93824]
 810
 811 Compiler
 812 --------
 813 - [Enable combining `+crt-static` and `relocation-model=pic` on `x86_64-unknown-linux-gnu`][86374]
 814 - [Fixes wrong `unreachable_pub` lints on nested and glob public reexport][87487]
 815 - [Stabilize `-Z instrument-coverage` as `-C instrument-coverage`][90132]
 816 - [Stabilize `-Z print-link-args` as `--print link-args`][91606]
 817 - [Add new Tier 3 target `mips64-openwrt-linux-musl`\*][92300]
 818 - [Add new Tier 3 target `armv7-unknown-linux-uclibceabi` (softfloat)\*][92383]
 819 - [Fix invalid removal of newlines from doc comments][92357]
 820 - [Add kernel target for RustyHermit][92670]
 821 - [Deny mixing bin crate type with lib crate types][92933]
 822 - [Make rustc use `RUST_BACKTRACE=full` by default][93566]
 823 - [Upgrade to LLVM 14][93577]
 824
 825 \* Refer to Rust's [platform support page][platform-support-doc] for more
 826    information on Rust's tiered platform support.
 827
 828 Libraries
 829 ---------
 830 - [Guarantee call order for `sort_by_cached_key`][89621]
 831 - [Improve `Duration::try_from_secs_f32`/`f64` accuracy by directly processing exponent and mantissa][90247]
 832 - [Make `Instant::{duration_since, elapsed, sub}` saturating][89926]
 833 - [Remove non-monotonic clocks workarounds in `Instant::now`][89926]
 834 - [Make `BuildHasherDefault`, `iter::Empty` and `future::Pending` covariant][92630]
 835
 836 Stabilized APIs
 837 ---------------
 838 - [`Arc::new_cyclic`][arc_new_cyclic]
 839 - [`Rc::new_cyclic`][rc_new_cyclic]
 840 - [`slice::EscapeAscii`][slice_escape_ascii]
 841 - [`<[u8]>::escape_ascii`][slice_u8_escape_ascii]
 842 - [`u8::escape_ascii`][u8_escape_ascii]
 843 - [`Vec::spare_capacity_mut`][vec_spare_capacity_mut]
 844 - [`MaybeUninit::assume_init_drop`][assume_init_drop]
 845 - [`MaybeUninit::assume_init_read`][assume_init_read]
 846 - [`i8::abs_diff`][i8_abs_diff]
 847 - [`i16::abs_diff`][i16_abs_diff]
 848 - [`i32::abs_diff`][i32_abs_diff]
 849 - [`i64::abs_diff`][i64_abs_diff]
 850 - [`i128::abs_diff`][i128_abs_diff]
 851 - [`isize::abs_diff`][isize_abs_diff]
 852 - [`u8::abs_diff`][u8_abs_diff]
 853 - [`u16::abs_diff`][u16_abs_diff]
 854 - [`u32::abs_diff`][u32_abs_diff]
 855 - [`u64::abs_diff`][u64_abs_diff]
 856 - [`u128::abs_diff`][u128_abs_diff]
 857 - [`usize::abs_diff`][usize_abs_diff]
 858 - [`Display for io::ErrorKind`][display_error_kind]
 859 - [`From<u8> for ExitCode`][from_u8_exit_code]
 860 - [`Not for !` (the "never" type)][not_never]
 861 - [_Op_`Assign<$t> for Wrapping<$t>`][wrapping_assign_ops]
 862 - [`arch::is_aarch64_feature_detected!`][is_aarch64_feature_detected]
 863
 864 Cargo
 865 -----
 866 - [Port cargo from `toml-rs` to `toml_edit`][cargo/10086]
 867 - [Stabilize `-Ztimings` as `--timings`][cargo/10245]
 868 - [Stabilize namespaced and weak dependency features.][cargo/10269]
 869 - [Accept more `cargo:rustc-link-arg-*` types from build script output.][cargo/10274]
 870 - [cargo-new should not add ignore rule on Cargo.lock inside subdirs][cargo/10379]
 871
 872 Misc
 873 ----
 874 - [Ship docs on Tier 2 platforms by reusing the closest Tier 1 platform docs][92800]
 875 - [Drop rustc-docs from complete profile][93742]
 876 - [bootstrap: tidy up flag handling for llvm build][93918]
 877
 878 Compatibility Notes
 879 -------------------
 880 - [Remove compiler-rt linking hack on Android][83822]
 881 - [Mitigations for platforms with non-monotonic clocks have been removed from
 882   `Instant::now`][89926]. On platforms that don't provide monotonic clocks, an
 883   instant is not guaranteed to be greater than an earlier instant anymore.
 884 - [`Instant::{duration_since, elapsed, sub}` do not panic anymore on underflow,
 885   saturating to `0` instead][89926]. In the real world the panic happened mostly
 886   on platforms with buggy monotonic clock implementations rather than catching
 887   programming errors like reversing the start and end times. Such programming
 888   errors will now results in `0` rather than a panic.
 889 - In a future release we're planning to increase the baseline requirements for
 890   the Linux kernel to version 3.2, and for glibc to version 2.17. We'd love
 891   your feedback in [PR #95026][95026].
 892
 893 Internal Changes
 894 ----------------
 895
 896 These changes provide no direct user facing benefits, but represent significant
 897 improvements to the internals and overall performance of rustc
 898 and related tools.
 899
 900 - [Switch all libraries to the 2021 edition][92068]
 901
 902 [83822]: https://github.com/rust-lang/rust/pull/83822
 903 [86374]: https://github.com/rust-lang/rust/pull/86374
 904 [87487]: https://github.com/rust-lang/rust/pull/87487
 905 [89621]: https://github.com/rust-lang/rust/pull/89621
 906 [89926]: https://github.com/rust-lang/rust/pull/89926
 907 [90132]: https://github.com/rust-lang/rust/pull/90132
 908 [90247]: https://github.com/rust-lang/rust/pull/90247
 909 [91606]: https://github.com/rust-lang/rust/pull/91606
 910 [92068]: https://github.com/rust-lang/rust/pull/92068
 911 [92300]: https://github.com/rust-lang/rust/pull/92300
 912 [92357]: https://github.com/rust-lang/rust/pull/92357
 913 [92383]: https://github.com/rust-lang/rust/pull/92383
 914 [92630]: https://github.com/rust-lang/rust/pull/92630
 915 [92670]: https://github.com/rust-lang/rust/pull/92670
 916 [92800]: https://github.com/rust-lang/rust/pull/92800
 917 [92933]: https://github.com/rust-lang/rust/pull/92933
 918 [93566]: https://github.com/rust-lang/rust/pull/93566
 919 [93577]: https://github.com/rust-lang/rust/pull/93577
 920 [93658]: https://github.com/rust-lang/rust/pull/93658
 921 [93742]: https://github.com/rust-lang/rust/pull/93742
 922 [93824]: https://github.com/rust-lang/rust/pull/93824
 923 [93918]: https://github.com/rust-lang/rust/pull/93918
 924 [95026]: https://github.com/rust-lang/rust/pull/95026
 925
 926 [cargo/10086]: https://github.com/rust-lang/cargo/pull/10086
 927 [cargo/10245]: https://github.com/rust-lang/cargo/pull/10245
 928 [cargo/10269]: https://github.com/rust-lang/cargo/pull/10269
 929 [cargo/10274]: https://github.com/rust-lang/cargo/pull/10274
 930 [cargo/10379]: https://github.com/rust-lang/cargo/pull/10379
 931
 932 [arc_new_cyclic]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.new_cyclic
 933 [rc_new_cyclic]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.new_cyclic
 934 [slice_escape_ascii]: https://doc.rust-lang.org/stable/std/slice/struct.EscapeAscii.html
 935 [slice_u8_escape_ascii]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.escape_ascii
 936 [u8_escape_ascii]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.escape_ascii
 937 [vec_spare_capacity_mut]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.spare_capacity_mut
 938 [assume_init_drop]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_drop
 939 [assume_init_read]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_read
 940 [i8_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.abs_diff
 941 [i16_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.abs_diff
 942 [i32_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.abs_diff
 943 [i64_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.abs_diff
 944 [i128_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.abs_diff
 945 [isize_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.abs_diff
 946 [u8_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.abs_diff
 947 [u16_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.abs_diff
 948 [u32_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.abs_diff
 949 [u64_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.abs_diff
 950 [u128_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.abs_diff
 951 [usize_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.abs_diff
 952 [display_error_kind]: https://doc.rust-lang.org/stable/std/io/enum.ErrorKind.html#impl-Display
 953 [from_u8_exit_code]: https://doc.rust-lang.org/stable/std/process/struct.ExitCode.html#impl-From%3Cu8%3E
 954 [not_never]: https://doc.rust-lang.org/stable/std/primitive.never.html#impl-Not
 955 [wrapping_assign_ops]: https://doc.rust-lang.org/stable/std/num/struct.Wrapping.html#trait-implementations
 956 [is_aarch64_feature_detected]: https://doc.rust-lang.org/stable/std/arch/macro.is_aarch64_feature_detected.html
 957
 958 Version 1.59.0 (2022-02-24)
 959 ==========================
 960
 961 Language
 962 --------
 963
 964 - [Stabilize default arguments for const parameters and remove the ordering restriction for type and const parameters][90207]
 965 - [Stabilize destructuring assignment][90521]
 966 - [Relax private in public lint on generic bounds and where clauses of trait impls][90586]
 967 - [Stabilize asm! and global_asm! for x86, x86_64, ARM, Aarch64, and RISC-V][91728]
 968
 969 Compiler
 970 --------
 971
 972 - [Stabilize new symbol mangling format, leaving it opt-in (-Csymbol-mangling-version=v0)][90128]
 973 - [Emit LLVM optimization remarks when enabled with `-Cremark`][90833]
 974 - [Fix sparc64 ABI for aggregates with floating point members][91003]
 975 - [Warn when a `#[test]`-like built-in attribute macro is present multiple times.][91172]
 976 - [Add support for riscv64gc-unknown-freebsd][91284]
 977 - [Stabilize `-Z emit-future-incompat` as `--json future-incompat`][91535]
 978 - [Soft disable incremental compilation][94124]
 979
 980 This release disables incremental compilation, unless the user has explicitly
 981 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
 982 This is due to a known and relatively frequently occurring bug in incremental
 983 compilation, which causes builds to issue internal compiler errors. This
 984 particular bug is already fixed on nightly, but that fix has not yet rolled out
 985 to stable and is deemed too risky for a direct stable backport.
 986
 987 As always, we encourage users to test with nightly and report bugs so that we
 988 can track failures and fix issues earlier.
 989
 990 See [94124] for more details.
 991
 992 [94124]: https://github.com/rust-lang/rust/issues/94124
 993
 994 Libraries
 995 ---------
 996
 997 - [Remove unnecessary bounds for some Hash{Map,Set} methods][91593]
 998
 999 Stabilized APIs
1000 ---------------
1001
1002 - [`std::thread::available_parallelism`][available_parallelism]
1003 - [`Result::copied`][result-copied]
1004 - [`Result::cloned`][result-cloned]
1005 - [`arch::asm!`][asm]
1006 - [`arch::global_asm!`][global_asm]
1007 - [`ops::ControlFlow::is_break`][is_break]
1008 - [`ops::ControlFlow::is_continue`][is_continue]
1009 - [`TryFrom<char> for u8`][try_from_char_u8]
1010 - [`char::TryFromCharError`][try_from_char_err]
1011   implementing `Clone`, `Debug`, `Display`, `PartialEq`, `Copy`, `Eq`, `Error`
1012 - [`iter::zip`][zip]
1013 - [`NonZeroU8::is_power_of_two`][is_power_of_two8]
1014 - [`NonZeroU16::is_power_of_two`][is_power_of_two16]
1015 - [`NonZeroU32::is_power_of_two`][is_power_of_two32]
1016 - [`NonZeroU64::is_power_of_two`][is_power_of_two64]
1017 - [`NonZeroU128::is_power_of_two`][is_power_of_two128]
1018 - [`NonZeroUsize::is_power_of_two`][is_power_of_two_usize]
1019 - [`DoubleEndedIterator for ToLowercase`][lowercase]
1020 - [`DoubleEndedIterator for ToUppercase`][uppercase]
1021 - [`TryFrom<&mut [T]> for [T; N]`][tryfrom_ref_arr]
1022 - [`UnwindSafe for Once`][unwindsafe_once]
1023 - [`RefUnwindSafe for Once`][refunwindsafe_once]
1024 - [armv8 neon intrinsics for aarch64][stdarch/1266]
1025
1026 Const-stable:
1027
1028 - [`mem::MaybeUninit::as_ptr`][muninit_ptr]
1029 - [`mem::MaybeUninit::assume_init`][muninit_init]
1030 - [`mem::MaybeUninit::assume_init_ref`][muninit_init_ref]
1031 - [`ffi::CStr::from_bytes_with_nul_unchecked`][cstr_from_bytes]
1032
1033 Cargo
1034 -----
1035
1036 - [Stabilize the `strip` profile option][cargo/10088]
1037 - [Stabilize future-incompat-report][cargo/10165]
1038 - [Support abbreviating `--release` as `-r`][cargo/10133]
1039 - [Support `term.quiet` configuration][cargo/10152]
1040 - [Remove `--host` from cargo {publish,search,login}][cargo/10145]
1041
1042 Compatibility Notes
1043 -------------------
1044
1045 - [Refactor weak symbols in std::sys::unix][90846]
1046   This may add new, versioned, symbols when building with a newer glibc, as the
1047   standard library uses weak linkage rather than dynamically attempting to load
1048   certain symbols at runtime.
1049 - [Deprecate crate_type and crate_name nested inside `#![cfg_attr]`][83744]
1050   This adds a future compatibility lint to supporting the use of cfg_attr
1051   wrapping either crate_type or crate_name specification within Rust files;
1052   it is recommended that users migrate to setting the equivalent command line
1053   flags.
1054 - [Remove effect of `#[no_link]` attribute on name resolution][92034]
1055   This may expose new names, leading to conflicts with preexisting names in a
1056   given namespace and a compilation failure.
1057 - [Cargo will document libraries before binaries.][cargo/10172]
1058 - [Respect doc=false in dependencies, not just the root crate][cargo/10201]
1059 - [Weaken guarantee around advancing underlying iterators in zip][83791]
1060 - [Make split_inclusive() on an empty slice yield an empty output][89825]
1061 - [Update std::env::temp_dir to use GetTempPath2 on Windows when available.][89999]
1062 - [unreachable! was updated to match other formatting macro behavior on Rust 2021][92137]
1063
1064 Internal Changes
1065 ----------------
1066
1067 These changes provide no direct user facing benefits, but represent significant
1068 improvements to the internals and overall performance of rustc
1069 and related tools.
1070
1071 - [Fix many cases of normalization-related ICEs][91255]
1072 - [Replace dominators algorithm with simple Lengauer-Tarjan][85013]
1073 - [Store liveness in interval sets for region inference][90637]
1074
1075 - [Remove `in_band_lifetimes` from the compiler and standard library, in preparation for removing this
1076   unstable feature.][91867]
1077
1078 [91867]: https://github.com/rust-lang/rust/issues/91867
1079 [83744]: https://github.com/rust-lang/rust/pull/83744/
1080 [83791]: https://github.com/rust-lang/rust/pull/83791/
1081 [85013]: https://github.com/rust-lang/rust/pull/85013/
1082 [89825]: https://github.com/rust-lang/rust/pull/89825/
1083 [89999]: https://github.com/rust-lang/rust/pull/89999/
1084 [90128]: https://github.com/rust-lang/rust/pull/90128/
1085 [90207]: https://github.com/rust-lang/rust/pull/90207/
1086 [90521]: https://github.com/rust-lang/rust/pull/90521/
1087 [90586]: https://github.com/rust-lang/rust/pull/90586/
1088 [90637]: https://github.com/rust-lang/rust/pull/90637/
1089 [90833]: https://github.com/rust-lang/rust/pull/90833/
1090 [90846]: https://github.com/rust-lang/rust/pull/90846/
1091 [91003]: https://github.com/rust-lang/rust/pull/91003/
1092 [91172]: https://github.com/rust-lang/rust/pull/91172/
1093 [91255]: https://github.com/rust-lang/rust/pull/91255/
1094 [91284]: https://github.com/rust-lang/rust/pull/91284/
1095 [91535]: https://github.com/rust-lang/rust/pull/91535/
1096 [91593]: https://github.com/rust-lang/rust/pull/91593/
1097 [91728]: https://github.com/rust-lang/rust/pull/91728/
1098 [91878]: https://github.com/rust-lang/rust/pull/91878/
1099 [91896]: https://github.com/rust-lang/rust/pull/91896/
1100 [91926]: https://github.com/rust-lang/rust/pull/91926/
1101 [91984]: https://github.com/rust-lang/rust/pull/91984/
1102 [92020]: https://github.com/rust-lang/rust/pull/92020/
1103 [92034]: https://github.com/rust-lang/rust/pull/92034/
1104 [92137]: https://github.com/rust-lang/rust/pull/92137/
1105 [92483]: https://github.com/rust-lang/rust/pull/92483/
1106 [cargo/10088]: https://github.com/rust-lang/cargo/pull/10088/
1107 [cargo/10133]: https://github.com/rust-lang/cargo/pull/10133/
1108 [cargo/10145]: https://github.com/rust-lang/cargo/pull/10145/
1109 [cargo/10152]: https://github.com/rust-lang/cargo/pull/10152/
1110 [cargo/10165]: https://github.com/rust-lang/cargo/pull/10165/
1111 [cargo/10172]: https://github.com/rust-lang/cargo/pull/10172/
1112 [cargo/10201]: https://github.com/rust-lang/cargo/pull/10201/
1113 [cargo/10269]: https://github.com/rust-lang/cargo/pull/10269/
1114
1115 [cstr_from_bytes]: https://doc.rust-lang.org/stable/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked
1116 [muninit_ptr]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.as_ptr
1117 [muninit_init]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init
1118 [muninit_init_ref]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
1119 [unwindsafe_once]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#impl-UnwindSafe
1120 [refunwindsafe_once]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#impl-RefUnwindSafe
1121 [tryfrom_ref_arr]: https://doc.rust-lang.org/stable/std/convert/trait.TryFrom.html#impl-TryFrom%3C%26%27_%20mut%20%5BT%5D%3E
1122 [lowercase]: https://doc.rust-lang.org/stable/std/char/struct.ToLowercase.html#impl-DoubleEndedIterator
1123 [uppercase]: https://doc.rust-lang.org/stable/std/char/struct.ToUppercase.html#impl-DoubleEndedIterator
1124 [try_from_char_err]: https://doc.rust-lang.org/stable/std/char/struct.TryFromCharError.html
1125 [available_parallelism]: https://doc.rust-lang.org/stable/std/thread/fn.available_parallelism.html
1126 [result-copied]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.copied
1127 [result-cloned]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.cloned
1128 [asm]: https://doc.rust-lang.org/stable/core/arch/macro.asm.html
1129 [global_asm]: https://doc.rust-lang.org/stable/core/arch/macro.global_asm.html
1130 [is_break]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html#method.is_break
1131 [is_continue]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html#method.is_continue
1132 [try_from_char_u8]: https://doc.rust-lang.org/stable/std/primitive.char.html#impl-TryFrom%3Cchar%3E
1133 [zip]: https://doc.rust-lang.org/stable/std/iter/fn.zip.html
1134 [is_power_of_two8]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU8.html#method.is_power_of_two
1135 [is_power_of_two16]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU16.html#method.is_power_of_two
1136 [is_power_of_two32]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU32.html#method.is_power_of_two
1137 [is_power_of_two64]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU64.html#method.is_power_of_two
1138 [is_power_of_two128]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU128.html#method.is_power_of_two
1139 [is_power_of_two_usize]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroUsize.html#method.is_power_of_two
1140 [stdarch/1266]: https://github.com/rust-lang/stdarch/pull/1266
1141
1142 Version 1.58.1 (2022-01-19)
1143 ===========================
1144
1145 * Fix race condition in `std::fs::remove_dir_all` ([CVE-2022-21658])
1146 * [Handle captured arguments in the `useless_format` Clippy lint][clippy/8295]
1147 * [Move `non_send_fields_in_send_ty` Clippy lint to nursery][clippy/8075]
1148 * [Fix wrong error message displayed when some imports are missing][91254]
1149 * [Fix rustfmt not formatting generated files from stdin][92912]
1150
1151 [CVE-2022-21658]: https://www.cve.org/CVERecord?id=CVE-2022-21658
1152 [91254]: https://github.com/rust-lang/rust/pull/91254
1153 [92912]: https://github.com/rust-lang/rust/pull/92912
1154 [clippy/8075]: https://github.com/rust-lang/rust-clippy/pull/8075
1155 [clippy/8295]: https://github.com/rust-lang/rust-clippy/pull/8295
1156
1157 Version 1.58.0 (2022-01-13)
1158 ==========================
1159
1160 Language
1161 --------
1162
1163 - [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.
1164 - [`*const T` pointers can now be dereferenced in const contexts.][89551]
1165 - [The rules for when a generic struct implements `Unsize` have been relaxed.][90417]
1166
1167 Compiler
1168 --------
1169
1170 - [Add LLVM CFI support to the Rust compiler][89652]
1171 - [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.
1172 - [Add support for LLVM coverage mapping format versions 5 and 6][91207]
1173 - [Emit LLVM optimization remarks when enabled with `-Cremark`][90833]
1174 - [Update the minimum external LLVM to 12][90175]
1175 - [Add `x86_64-unknown-none` at Tier 3*][89062]
1176 - [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.
1177 - [Don't abort compilation after giving a lint error][87337]
1178 - [Error messages point at the source of trait bound obligations in more places][89580]
1179
1180 \* Refer to Rust's [platform support page][platform-support-doc] for more
1181    information on Rust's tiered platform support.
1182
1183 Libraries
1184 ---------
1185
1186 - [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.
1187 - [Paths are automatically canonicalized on Windows for operations that support it][89174]
1188 - [Re-enable debug checks for `copy` and `copy_nonoverlapping`][90041]
1189 - [Implement `RefUnwindSafe` for `Rc<T>`][87467]
1190 - [Make RSplit<T, P>: Clone not require T: Clone][90117]
1191 - [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).
1192
1193 Stabilized APIs
1194 ---------------
1195
1196 - [`Metadata::is_symlink`]
1197 - [`Path::is_symlink`]
1198 - [`{integer}::saturating_div`]
1199 - [`Option::unwrap_unchecked`]
1200 - [`Result::unwrap_unchecked`]
1201 - [`Result::unwrap_err_unchecked`]
1202 - [`File::options`]
1203
1204 These APIs are now usable in const contexts:
1205
1206 - [`Duration::new`]
1207 - [`Duration::checked_add`]
1208 - [`Duration::saturating_add`]
1209 - [`Duration::checked_sub`]
1210 - [`Duration::saturating_sub`]
1211 - [`Duration::checked_mul`]
1212 - [`Duration::saturating_mul`]
1213 - [`Duration::checked_div`]
1214
1215 Cargo
1216 -----
1217
1218 - [Add --message-format for install command][cargo/10107]
1219 - [Warn when alias shadows external subcommand][cargo/10082]
1220
1221 Rustdoc
1222 -------
1223
1224 - [Show all Deref implementations recursively in rustdoc][90183]
1225 - [Use computed visibility in rustdoc][88447]
1226
1227 Compatibility Notes
1228 -------------------
1229
1230 - [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.
1231 - Windows: [`std::process::Command` will no longer search the current directory for executables.][87704]
1232 - [All proc-macro backward-compatibility lints are now deny-by-default.][88041]
1233 - [proc_macro: Append .0 to unsuffixed float if it would otherwise become int token][90297]
1234 - [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.
1235 - [rustdoc now rejects some unexpected semicolons in doctests][91026]
1236
1237 Internal Changes
1238 ----------------
1239
1240 These changes provide no direct user facing benefits, but represent significant
1241 improvements to the internals and overall performance of rustc
1242 and related tools.
1243
1244 - [Implement coherence checks for negative trait impls][90104]
1245 - [Add rustc lint, warning when iterating over hashmaps][89558]
1246 - [Optimize live point computation][90491]
1247 - [Enable verification for 1/32nd of queries loaded from disk][90361]
1248 - [Implement version of normalize_erasing_regions that allows for normalization failure][91255]
1249
1250 [87337]: https://github.com/rust-lang/rust/pull/87337/
1251 [87467]: https://github.com/rust-lang/rust/pull/87467/
1252 [87704]: https://github.com/rust-lang/rust/pull/87704/
1253 [88041]: https://github.com/rust-lang/rust/pull/88041/
1254 [88447]: https://github.com/rust-lang/rust/pull/88447/
1255 [88601]: https://github.com/rust-lang/rust/pull/88601/
1256 [89062]: https://github.com/rust-lang/rust/pull/89062/
1257 [89174]: https://github.com/rust-lang/rust/pull/89174/
1258 [89551]: https://github.com/rust-lang/rust/pull/89551/
1259 [89558]: https://github.com/rust-lang/rust/pull/89558/
1260 [89580]: https://github.com/rust-lang/rust/pull/89580/
1261 [89652]: https://github.com/rust-lang/rust/pull/89652/
1262 [90041]: https://github.com/rust-lang/rust/pull/90041/
1263 [90058]: https://github.com/rust-lang/rust/pull/90058/
1264 [90104]: https://github.com/rust-lang/rust/pull/90104/
1265 [90117]: https://github.com/rust-lang/rust/pull/90117/
1266 [90175]: https://github.com/rust-lang/rust/pull/90175/
1267 [90183]: https://github.com/rust-lang/rust/pull/90183/
1268 [90297]: https://github.com/rust-lang/rust/pull/90297/
1269 [90329]: https://github.com/rust-lang/rust/pull/90329/
1270 [90361]: https://github.com/rust-lang/rust/pull/90361/
1271 [90417]: https://github.com/rust-lang/rust/pull/90417/
1272 [90473]: https://github.com/rust-lang/rust/pull/90473/
1273 [90491]: https://github.com/rust-lang/rust/pull/90491/
1274 [90733]: https://github.com/rust-lang/rust/pull/90733/
1275 [90833]: https://github.com/rust-lang/rust/pull/90833/
1276 [90846]: https://github.com/rust-lang/rust/pull/90846/
1277 [91026]: https://github.com/rust-lang/rust/pull/91026/
1278 [91207]: https://github.com/rust-lang/rust/pull/91207/
1279 [91255]: https://github.com/rust-lang/rust/pull/91255/
1280 [cargo/10082]: https://github.com/rust-lang/cargo/pull/10082/
1281 [cargo/10107]: https://github.com/rust-lang/cargo/pull/10107/
1282 [`Metadata::is_symlink`]: https://doc.rust-lang.org/stable/std/fs/struct.Metadata.html#method.is_symlink
1283 [`Path::is_symlink`]: https://doc.rust-lang.org/stable/std/path/struct.Path.html#method.is_symlink
1284 [`{integer}::saturating_div`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.saturating_div
1285 [`Option::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.unwrap_unchecked
1286 [`Result::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_unchecked
1287 [`Result::unwrap_err_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_err_unchecked
1288 [`File::options`]: https://doc.rust-lang.org/stable/std/fs/struct.File.html#method.options
1289 [`Duration::new`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.new
1290
1291 Version 1.57.0 (2021-12-02)
1292 ==========================
1293
1294 Language
1295 --------
1296
1297 - [Macro attributes may follow `#[derive]` and will see the original (pre-`cfg`) input.][87220]
1298 - [Accept curly-brace macros in expressions, like `m!{ .. }.method()` and `m!{ .. }?`.][88690]
1299 - [Allow panicking in constant evaluation.][89508]
1300 - [Ignore derived `Clone` and `Debug` implementations during dead code analysis.][85200]
1301
1302 Compiler
1303 --------
1304
1305 - [Create more accurate debuginfo for vtables.][89597]
1306 - [Add `armv6k-nintendo-3ds` at Tier 3\*.][88529]
1307 - [Add `armv7-unknown-linux-uclibceabihf` at Tier 3\*.][88952]
1308 - [Add `m68k-unknown-linux-gnu` at Tier 3\*.][88321]
1309 - [Add SOLID targets at Tier 3\*:][86191] `aarch64-kmc-solid_asp3`, `armv7a-kmc-solid_asp3-eabi`, `armv7a-kmc-solid_asp3-eabihf`
1310
1311 \* Refer to Rust's [platform support page][platform-support-doc] for more
1312    information on Rust's tiered platform support.
1313
1314 Libraries
1315 ---------
1316
1317 - [Avoid allocations and copying in `Vec::leak`][89337]
1318 - [Add `#[repr(i8)]` to `Ordering`][89507]
1319 - [Optimize `File::read_to_end` and `read_to_string`][89582]
1320 - [Update to Unicode 14.0][89614]
1321 - [Many more functions are marked `#[must_use]`][89692], producing a warning
1322   when ignoring their return value. This helps catch mistakes such as expecting
1323   a function to mutate a value in place rather than return a new value.
1324
1325 Stabilised APIs
1326 ---------------
1327
1328 - [`[T; N]::as_mut_slice`][`array::as_mut_slice`]
1329 - [`[T; N]::as_slice`][`array::as_slice`]
1330 - [`collections::TryReserveError`]
1331 - [`HashMap::try_reserve`]
1332 - [`HashSet::try_reserve`]
1333 - [`String::try_reserve`]
1334 - [`String::try_reserve_exact`]
1335 - [`Vec::try_reserve`]
1336 - [`Vec::try_reserve_exact`]
1337 - [`VecDeque::try_reserve`]
1338 - [`VecDeque::try_reserve_exact`]
1339 - [`Iterator::map_while`]
1340 - [`iter::MapWhile`]
1341 - [`proc_macro::is_available`]
1342 - [`Command::get_program`]
1343 - [`Command::get_args`]
1344 - [`Command::get_envs`]
1345 - [`Command::get_current_dir`]
1346 - [`CommandArgs`]
1347 - [`CommandEnvs`]
1348
1349 These APIs are now usable in const contexts:
1350
1351 - [`hint::unreachable_unchecked`]
1352
1353 Cargo
1354 -----
1355
1356 - [Stabilize custom profiles][cargo/9943]
1357
1358 Compatibility notes
1359 -------------------
1360
1361 - [Ignore derived `Clone` and `Debug` implementations during dead code analysis.][85200]
1362   This will break some builds that set `#![deny(dead_code)]`.
1363
1364 Internal changes
1365 ----------------
1366 These changes provide no direct user facing benefits, but represent significant
1367 improvements to the internals and overall performance of rustc
1368 and related tools.
1369
1370 - [Added an experimental backend for codegen with `libgccjit`.][87260]
1371
1372 [85200]: https://github.com/rust-lang/rust/pull/85200/
1373 [86191]: https://github.com/rust-lang/rust/pull/86191/
1374 [87220]: https://github.com/rust-lang/rust/pull/87220/
1375 [87260]: https://github.com/rust-lang/rust/pull/87260/
1376 [88321]: https://github.com/rust-lang/rust/pull/88321/
1377 [88529]: https://github.com/rust-lang/rust/pull/88529/
1378 [88690]: https://github.com/rust-lang/rust/pull/88690/
1379 [88952]: https://github.com/rust-lang/rust/pull/88952/
1380 [89337]: https://github.com/rust-lang/rust/pull/89337/
1381 [89507]: https://github.com/rust-lang/rust/pull/89507/
1382 [89508]: https://github.com/rust-lang/rust/pull/89508/
1383 [89582]: https://github.com/rust-lang/rust/pull/89582/
1384 [89597]: https://github.com/rust-lang/rust/pull/89597/
1385 [89614]: https://github.com/rust-lang/rust/pull/89614/
1386 [89692]: https://github.com/rust-lang/rust/issues/89692/
1387 [cargo/9943]: https://github.com/rust-lang/cargo/pull/9943/
1388 [`array::as_mut_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_mut_slice
1389 [`array::as_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_slice
1390 [`collections::TryReserveError`]: https://doc.rust-lang.org/std/collections/struct.TryReserveError.html
1391 [`HashMap::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_map/struct.HashMap.html#method.try_reserve
1392 [`HashSet::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_set/struct.HashSet.html#method.try_reserve
1393 [`String::try_reserve`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve
1394 [`String::try_reserve_exact`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve_exact
1395 [`Vec::try_reserve`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve
1396 [`Vec::try_reserve_exact`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve_exact
1397 [`VecDeque::try_reserve`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve
1398 [`VecDeque::try_reserve_exact`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve_exact
1399 [`Iterator::map_while`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.map_while
1400 [`iter::MapWhile`]: https://doc.rust-lang.org/std/iter/struct.MapWhile.html
1401 [`proc_macro::is_available`]: https://doc.rust-lang.org/proc_macro/fn.is_available.html
1402 [`Command::get_program`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_program
1403 [`Command::get_args`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_args
1404 [`Command::get_envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_envs
1405 [`Command::get_current_dir`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_current_dir
1406 [`CommandArgs`]: https://doc.rust-lang.org/std/process/struct.CommandArgs.html
1407 [`CommandEnvs`]: https://doc.rust-lang.org/std/process/struct.CommandEnvs.html
1408
1409 Version 1.56.1 (2021-11-01)
1410 ===========================
1411
1412 - New lints to detect the presence of bidirectional-override Unicode
1413   codepoints in the compiled source code ([CVE-2021-42574])
1414
1415 [CVE-2021-42574]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-42574
1416
1417 Version 1.56.0 (2021-10-21)
1418 ========================
1419
1420 Language
1421 --------
1422
1423 - [The 2021 Edition is now stable.][rust#88100]
1424   See [the edition guide][rust-2021-edition-guide] for more details.
1425 - [The pattern in `binding @ pattern` can now also introduce new bindings.][rust#85305]
1426 - [Union field access is permitted in `const fn`.][rust#85769]
1427
1428 [rust-2021-edition-guide]: https://doc.rust-lang.org/nightly/edition-guide/rust-2021/index.html
1429
1430 Compiler
1431 --------
1432
1433 - [Upgrade to LLVM 13.][rust#87570]
1434 - [Support memory, address, and thread sanitizers on aarch64-unknown-freebsd.][rust#88023]
1435 - [Allow specifying a deployment target version for all iOS targets][rust#87699]
1436 - [Warnings can be forced on with `--force-warn`.][rust#87472]
1437   This feature is primarily intended for usage by `cargo fix`, rather than end users.
1438 - [Promote `aarch64-apple-ios-sim` to Tier 2\*.][rust#87760]
1439 - [Add `powerpc-unknown-freebsd` at Tier 3\*.][rust#87370]
1440 - [Add `riscv32imc-esp-espidf` at Tier 3\*.][rust#87666]
1441
1442 \* Refer to Rust's [platform support page][platform-support-doc] for more
1443 information on Rust's tiered platform support.
1444
1445 Libraries
1446 ---------
1447
1448 - [Allow writing of incomplete UTF-8 sequences via stdout/stderr on Windows.][rust#83342]
1449   The Windows console still requires valid Unicode, but this change allows
1450   splitting a UTF-8 character across multiple write calls. This allows, for
1451   instance, programs that just read and write data buffers (e.g. copying a file
1452   to stdout) without regard for Unicode or character boundaries.
1453 - [Prefer `AtomicU{64,128}` over Mutex for Instant backsliding protection.][rust#83093]
1454   For this use case, atomics scale much better under contention.
1455 - [Implement `Extend<(A, B)>` for `(Extend<A>, Extend<B>)`][rust#85835]
1456 - [impl Default, Copy, Clone for std::io::Sink and std::io::Empty][rust#86744]
1457 - [`impl From<[(K, V); N]>` for all collections.][rust#84111]
1458 - [Remove `P: Unpin` bound on impl Future for Pin.][rust#81363]
1459 - [Treat invalid environment variable names as non-existent.][rust#86183]
1460   Previously, the environment functions would panic if given a variable name
1461   with an internal null character or equal sign (`=`). Now, these functions will
1462   just treat such names as non-existent variables, since the OS cannot represent
1463   the existence of a variable with such a name.
1464
1465 Stabilised APIs
1466 ---------------
1467
1468 - [`std::os::unix::fs::chroot`]
1469 - [`UnsafeCell::raw_get`]
1470 - [`BufWriter::into_parts`]
1471 - [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]
1472   These APIs were previously stable in `std`, but are now also available in `core`.
1473 - [`Vec::shrink_to`]
1474 - [`String::shrink_to`]
1475 - [`OsString::shrink_to`]
1476 - [`PathBuf::shrink_to`]
1477 - [`BinaryHeap::shrink_to`]
1478 - [`VecDeque::shrink_to`]
1479 - [`HashMap::shrink_to`]
1480 - [`HashSet::shrink_to`]
1481
1482 These APIs are now usable in const contexts:
1483
1484 - [`std::mem::transmute`]
1485 - [`[T]::first`][`slice::first`]
1486 - [`[T]::split_first`][`slice::split_first`]
1487 - [`[T]::last`][`slice::last`]
1488 - [`[T]::split_last`][`slice::split_last`]
1489
1490 Cargo
1491 -----
1492
1493 - [Cargo supports specifying a minimum supported Rust version in Cargo.toml.][`rust-version`]
1494   This has no effect at present on dependency version selection.
1495   We encourage crates to specify their minimum supported Rust version, and we encourage CI systems
1496   that support Rust code to include a crate's specified minimum version in the test matrix for that
1497   crate by default.
1498
1499 Compatibility notes
1500 -------------------
1501
1502 - [Update to new argument parsing rules on Windows.][rust#87580]
1503   This adjusts Rust's standard library to match the behavior of the standard
1504   libraries for C/C++. The rules have changed slightly over time, and this PR
1505   brings us to the latest set of rules (changed in 2008).
1506 - [Disallow the aapcs calling convention on aarch64][rust#88399]
1507   This was already not supported by LLVM; this change surfaces this lack of
1508   support with a better error message.
1509 - [Make `SEMICOLON_IN_EXPRESSIONS_FROM_MACROS` warn by default][rust#87385]
1510 - [Warn when an escaped newline skips multiple lines.][rust#87671]
1511 - [Calls to `libc::getpid` / `std::process::id` from `Command::pre_exec`
1512    may return different values on glibc <= 2.24.][rust#81825]
1513    Rust now invokes the `clone3` system call directly, when available, to use new functionality
1514    available via that system call. Older versions of glibc cache the result of `getpid`, and only
1515    update that cache when calling glibc's clone/fork functions, so a direct system call bypasses
1516    that cache update. glibc 2.25 and newer no longer cache `getpid` for exactly this reason.
1517
1518 Internal changes
1519 ----------------
1520 These changes provide no direct user facing benefits, but represent significant
1521 improvements to the internals and overall performance of rustc
1522 and related tools.
1523
1524 - [LLVM is compiled with PGO in published x86_64-unknown-linux-gnu artifacts.][rust#88069]
1525   This improves the performance of most Rust builds.
1526 - [Unify representation of macros in internal data structures.][rust#88019]
1527   This change fixes a host of bugs with the handling of macros by the compiler,
1528   as well as rustdoc.
1529
1530 [`std::os::unix::fs::chroot`]: https://doc.rust-lang.org/stable/std/os/unix/fs/fn.chroot.html
1531 [`UnsafeCell::raw_get`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.raw_get
1532 [`BufWriter::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.BufWriter.html#method.into_parts
1533 [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]: https://github.com/rust-lang/rust/pull/84662
1534 [`Vec::shrink_to`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.shrink_to
1535 [`String::shrink_to`]: https://doc.rust-lang.org/stable/std/string/struct.String.html#method.shrink_to
1536 [`OsString::shrink_to`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.shrink_to
1537 [`PathBuf::shrink_to`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.shrink_to
1538 [`BinaryHeap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.shrink_to
1539 [`VecDeque::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.shrink_to
1540 [`HashMap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_map/struct.HashMap.html#method.shrink_to
1541 [`HashSet::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_set/struct.HashSet.html#method.shrink_to
1542 [`std::mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
1543 [`slice::first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first
1544 [`slice::split_first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first
1545 [`slice::last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last
1546 [`slice::split_last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last
1547 [`rust-version`]: https://doc.rust-lang.org/nightly/cargo/reference/manifest.html#the-rust-version-field
1548 [rust#87671]: https://github.com/rust-lang/rust/pull/87671
1549 [rust#86183]: https://github.com/rust-lang/rust/pull/86183
1550 [rust#87385]: https://github.com/rust-lang/rust/pull/87385
1551 [rust#88100]: https://github.com/rust-lang/rust/pull/88100
1552 [rust#85305]: https://github.com/rust-lang/rust/pull/85305
1553 [rust#88069]: https://github.com/rust-lang/rust/pull/88069
1554 [rust#87472]: https://github.com/rust-lang/rust/pull/87472
1555 [rust#87699]: https://github.com/rust-lang/rust/pull/87699
1556 [rust#87570]: https://github.com/rust-lang/rust/pull/87570
1557 [rust#88023]: https://github.com/rust-lang/rust/pull/88023
1558 [rust#87760]: https://github.com/rust-lang/rust/pull/87760
1559 [rust#87370]: https://github.com/rust-lang/rust/pull/87370
1560 [rust#87580]: https://github.com/rust-lang/rust/pull/87580
1561 [rust#83342]: https://github.com/rust-lang/rust/pull/83342
1562 [rust#83093]: https://github.com/rust-lang/rust/pull/83093
1563 [rust#85835]: https://github.com/rust-lang/rust/pull/85835
1564 [rust#86744]: https://github.com/rust-lang/rust/pull/86744
1565 [rust#81363]: https://github.com/rust-lang/rust/pull/81363
1566 [rust#84111]: https://github.com/rust-lang/rust/pull/84111
1567 [rust#85769]: https://github.com/rust-lang/rust/pull/85769#issuecomment-854363720
1568 [rust#88399]: https://github.com/rust-lang/rust/pull/88399
1569 [rust#81825]: https://github.com/rust-lang/rust/pull/81825#issuecomment-808406918
1570 [rust#88019]: https://github.com/rust-lang/rust/pull/88019
1571 [rust#87666]: https://github.com/rust-lang/rust/pull/87666
1572
1573 Version 1.55.0 (2021-09-09)
1574 ============================
1575
1576 Language
1577 --------
1578 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
1579   will end at the maximum value of the integer.][83918]
1580 - [You can now explicitly import the prelude of different editions
1581   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
1582
1583 Compiler
1584 --------
1585 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
1586
1587 \* Refer to Rust's [platform support page][platform-support-doc] for more
1588    information on Rust's tiered platform support.
1589
1590 Libraries
1591 ---------
1592
1593 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
1594   These improvements should in general provide faster string parsing of floats,
1595   no longer reject certain valid floating point values, and reduce
1596   the produced code size for non-stripped artifacts.
1597 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
1598
1599 Stabilised APIs
1600 ---------------
1601
1602 - [`Bound::cloned`]
1603 - [`Drain::as_str`]
1604 - [`IntoInnerError::into_error`]
1605 - [`IntoInnerError::into_parts`]
1606 - [`MaybeUninit::assume_init_mut`]
1607 - [`MaybeUninit::assume_init_ref`]
1608 - [`MaybeUninit::write`]
1609 - [`array::map`]
1610 - [`ops::ControlFlow`]
1611 - [`x86::_bittest`]
1612 - [`x86::_bittestandcomplement`]
1613 - [`x86::_bittestandreset`]
1614 - [`x86::_bittestandset`]
1615 - [`x86_64::_bittest64`]
1616 - [`x86_64::_bittestandcomplement64`]
1617 - [`x86_64::_bittestandreset64`]
1618 - [`x86_64::_bittestandset64`]
1619
1620 The following previously stable functions are now `const`.
1621
1622 - [`str::from_utf8_unchecked`]
1623
1624
1625 Cargo
1626 -----
1627 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
1628   rustc in parallel such as when using `cargo test`.][cargo/9675]
1629 - [The package definition in `cargo metadata` now includes the `"default_run"`
1630   field from the manifest.][cargo/9550]
1631 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
1632 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
1633   of packages.][cargo/9663]
1634
1635 Rustdoc
1636 -------
1637 - [Added "Go to item on exact match" search option.][85876]
1638 - [The "Implementors" section on traits no longer shows redundant
1639   method definitions.][85970]
1640 - [Trait implementations are toggled open by default.][86260] This should make the
1641   implementations more searchable by tools like `CTRL+F` in your browser.
1642 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
1643   through type aliases.][86334]
1644 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
1645   "Trait Implementations" section.][86513]
1646
1647
1648 Compatibility Notes
1649 -------------------
1650 - [std functions that return an `io::Error` will no longer use the
1651   `ErrorKind::Other` variant.][85746] This is to better reflect that these
1652   kinds of errors could be categorised [into newer more specific `ErrorKind`
1653   variants][79965], and that they do not represent a user error.
1654 - [Using environment variable names with `process::Command` on Windows now
1655   behaves as expected.][85270] Previously using envionment variables with
1656   `Command` would cause them to be ASCII-uppercased.
1657 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
1658   with `rustdoc::`][86849]
1659 - `RUSTFLAGS` is no longer set for build scripts. Build scripts
1660   should use `CARGO_ENCODED_RUSTFLAGS` instead. See the
1661   [documentation](https://doc.rust-lang.org/nightly/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
1662   for more details.
1663
1664 [86849]: https://github.com/rust-lang/rust/pull/86849
1665 [86513]: https://github.com/rust-lang/rust/pull/86513
1666 [86334]: https://github.com/rust-lang/rust/pull/86334
1667 [86260]: https://github.com/rust-lang/rust/pull/86260
1668 [85970]: https://github.com/rust-lang/rust/pull/85970
1669 [85876]: https://github.com/rust-lang/rust/pull/85876
1670 [83572]: https://github.com/rust-lang/rust/pull/83572
1671 [86294]: https://github.com/rust-lang/rust/pull/86294
1672 [86858]: https://github.com/rust-lang/rust/pull/86858
1673 [86761]: https://github.com/rust-lang/rust/pull/86761
1674 [85746]: https://github.com/rust-lang/rust/pull/85746
1675 [85270]: https://github.com/rust-lang/rust/pull/85270
1676 [83918]: https://github.com/rust-lang/rust/pull/83918
1677 [79965]: https://github.com/rust-lang/rust/pull/79965
1678 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
1679 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
1680 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
1681 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
1682 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
1683 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
1684 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
1685 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
1686 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
1687 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
1688 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
1689 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
1690 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
1691 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
1692 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
1693 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
1694 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
1695 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
1696 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
1697 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
1698 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
1699 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
1700
1701
1702 Version 1.54.0 (2021-07-29)
1703 ============================
1704
1705 Language
1706 -----------------------
1707
1708 - [You can now use macros for values in some built-in attributes.][83366]
1709   This primarily allows you to call macros within the `#[doc]` attribute. For
1710   example, to include external documentation in your crate, you can now write
1711   the following:
1712   ```rust
1713   #![doc = include_str!("README.md")]
1714   ```
1715
1716 - [You can now cast between unsized slice types (and types which contain
1717   unsized slices) in `const fn`.][85078]
1718 - [You can now use multiple generic lifetimes with `impl Trait` where the
1719    lifetimes don't explicitly outlive another.][84701] In code this means
1720    that you can now have `impl Trait<'a, 'b>` where as before you could
1721    only have `impl Trait<'a, 'b> where 'b: 'a`.
1722
1723 Compiler
1724 -----------------------
1725
1726 - [Rustc will now search for custom JSON targets in
1727   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
1728   directory.][83800] You can find your sysroot directory by running
1729   `rustc --print sysroot`.
1730 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
1731 - [You can now use `#[target_feature]` on safe functions when targeting
1732   WebAssembly platforms.][84988]
1733 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
1734 - [Added tier 3\* support for `bpfel-unknown-none`
1735    and `bpfeb-unknown-none`.][79608]
1736 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
1737
1738 \* Refer to Rust's [platform support page][platform-support-doc] for more
1739    information on Rust's tiered platform support.
1740
1741 Libraries
1742 -----------------------
1743
1744 - [`panic::panic_any` will now `#[track_caller]`.][85745]
1745 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
1746 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
1747 - [The implementations of vendor intrinsics in core::arch have been
1748    significantly refactored.][83278] The main user-visible changes are
1749    a 50% reduction in the size of libcore.rlib and stricter validation
1750    of constant operands passed to intrinsics. The latter is technically
1751    a breaking change, but allows Rust to more closely match the C vendor
1752    intrinsics API.
1753
1754 Stabilized APIs
1755 ---------------
1756
1757 - [`BTreeMap::into_keys`]
1758 - [`BTreeMap::into_values`]
1759 - [`HashMap::into_keys`]
1760 - [`HashMap::into_values`]
1761 - [`arch::wasm32`]
1762 - [`VecDeque::binary_search`]
1763 - [`VecDeque::binary_search_by`]
1764 - [`VecDeque::binary_search_by_key`]
1765 - [`VecDeque::partition_point`]
1766
1767 Cargo
1768 -----
1769
1770 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
1771   the dependency graph.][cargo/9520]
1772 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
1773   in the tree ][cargo/9499]
1774 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
1775   macro dependencies.][cargo/9488]
1776 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
1777   This variable points to a directory that integration tests and benches
1778   can use as a "scratchpad" for testing filesystem operations.
1779
1780 Compatibility Notes
1781 -------------------
1782 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
1783 - [Previously unsound code is no longer permitted where different constructors in branches
1784   could require different lifetimes.][85574]
1785 - As previously mentioned the [`std::arch` intrinsics now uses stricter const checking][83278]
1786   than before and may reject some previously accepted code.
1787 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
1788    when compiled with `codegen-units = 1`.][86063]
1789
1790 [85574]: https://github.com/rust-lang/rust/issues/85574
1791 [86831]: https://github.com/rust-lang/rust/issues/86831
1792 [86063]: https://github.com/rust-lang/rust/issues/86063
1793 [79608]: https://github.com/rust-lang/rust/pull/79608
1794 [84988]: https://github.com/rust-lang/rust/pull/84988
1795 [84701]: https://github.com/rust-lang/rust/pull/84701
1796 [84072]: https://github.com/rust-lang/rust/pull/84072
1797 [85745]: https://github.com/rust-lang/rust/pull/85745
1798 [84744]: https://github.com/rust-lang/rust/pull/84744
1799 [85078]: https://github.com/rust-lang/rust/pull/85078
1800 [84717]: https://github.com/rust-lang/rust/pull/84717
1801 [83800]: https://github.com/rust-lang/rust/pull/83800
1802 [83366]: https://github.com/rust-lang/rust/pull/83366
1803 [83278]: https://github.com/rust-lang/rust/pull/83278
1804 [85292]: https://github.com/rust-lang/rust/pull/85292
1805 [82834]: https://github.com/rust-lang/rust/pull/82834
1806 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
1807 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
1808 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
1809 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
1810 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
1811 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
1812 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
1813 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
1814 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
1815 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
1816 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
1817
1818 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
1819
1820 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
1821
1822 Version 1.53.0 (2021-06-17)
1823 ============================
1824
1825 Language
1826 -----------------------
1827 - [You can now use unicode for identifiers.][83799] This allows multilingual
1828   identifiers but still doesn't allow glyphs that are not considered characters
1829   such as `◆` or `🦀`. More specifically you can now use any identifier that
1830   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
1831   is the same standard as languages like Python, however Rust uses NFC
1832   normalization which may be different from other languages.
1833 - [You can now specify "or patterns" inside pattern matches.][79278]
1834   Previously you could only use `|` (OR) on complete patterns. E.g.
1835   ```rust
1836   let x = Some(2u8);
1837   // Before
1838   matches!(x, Some(1) | Some(2));
1839   // Now
1840   matches!(x, Some(1 | 2));
1841   ```
1842 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
1843   has the same semantics as the `:pat` matcher. This is to allow `:pat`
1844   to change semantics to being a pattern fragment in a future edition.
1845
1846 Compiler
1847 -----------------------
1848 - [Updated the minimum external LLVM version to LLVM 10.][83387]
1849 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
1850 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
1851
1852 \* Refer to Rust's [platform support page][platform-support-doc] for more
1853 information on Rust's tiered platform support.
1854
1855 Libraries
1856 -----------------------
1857 - [Abort messages will now forward to `android_set_abort_message` on
1858   Android platforms when available.][81469]
1859 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
1860 - [Arrays of any length now implement `IntoIterator`.][84147]
1861   Currently calling `.into_iter()` as a method on an array will
1862   return `impl Iterator<Item=&T>`, but this may change in a
1863   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
1864   directly on arrays will provide `impl Iterator<Item=T>` as expected.
1865 - [`leading_zeros`, and `trailing_zeros` are now available on all
1866   `NonZero` integer types.][84082]
1867 - [`{f32, f64}::from_str` now parse and print special values
1868   (`NaN`, `-0`) according to IEEE 754.][78618]
1869 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
1870 - [Add the `BITS` associated constant to all numeric types.][82565]
1871
1872 Stabilised APIs
1873 ---------------
1874 - [`AtomicBool::fetch_update`]
1875 - [`AtomicPtr::fetch_update`]
1876 - [`BTreeMap::retain`]
1877 - [`BTreeSet::retain`]
1878 - [`BufReader::seek_relative`]
1879 - [`DebugStruct::non_exhaustive`]
1880 - [`Duration::MAX`]
1881 - [`Duration::ZERO`]
1882 - [`Duration::is_zero`]
1883 - [`Duration::saturating_add`]
1884 - [`Duration::saturating_mul`]
1885 - [`Duration::saturating_sub`]
1886 - [`ErrorKind::Unsupported`]
1887 - [`Option::insert`]
1888 - [`Ordering::is_eq`]
1889 - [`Ordering::is_ge`]
1890 - [`Ordering::is_gt`]
1891 - [`Ordering::is_le`]
1892 - [`Ordering::is_lt`]
1893 - [`Ordering::is_ne`]
1894 - [`OsStr::is_ascii`]
1895 - [`OsStr::make_ascii_lowercase`]
1896 - [`OsStr::make_ascii_uppercase`]
1897 - [`OsStr::to_ascii_lowercase`]
1898 - [`OsStr::to_ascii_uppercase`]
1899 - [`Peekable::peek_mut`]
1900 - [`Rc::decrement_strong_count`]
1901 - [`Rc::increment_strong_count`]
1902 - [`Vec::extend_from_within`]
1903 - [`array::from_mut`]
1904 - [`array::from_ref`]
1905 - [`cmp::max_by_key`]
1906 - [`cmp::max_by`]
1907 - [`cmp::min_by_key`]
1908 - [`cmp::min_by`]
1909 - [`f32::is_subnormal`]
1910 - [`f64::is_subnormal`]
1911
1912 Cargo
1913 -----------------------
1914 - [Cargo now supports git repositories where the default `HEAD` branch is not
1915   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
1916   which can handle default branches correctly.
1917 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
1918 - [The `authors` field is no longer included in `Cargo.toml` for new
1919   projects.][cargo/9282]
1920
1921 Rustdoc
1922 -----------------------
1923 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
1924   without hyperlinks.][81764]
1925
1926 Compatibility Notes
1927 -------------------
1928 - [Implement token-based handling of attributes during expansion][82608]
1929 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
1930   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
1931   to confusion and potential security vulnerabilities and [is no
1932   longer recommended][ietf6943].
1933 - [The added `BITS` constant may conflict with external definitions.][85667]
1934   In particular, this was known to be a problem in the `lexical-core` crate,
1935   but they have published fixes for semantic versions 0.4 through 0.7. To
1936   update this dependency alone, use `cargo update -p lexical-core`.
1937 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
1938
1939 Internal Only
1940 -------------
1941 These changes provide no direct user facing benefits, but represent significant
1942 improvements to the internals and overall performance of rustc and
1943 related tools.
1944
1945 - [Rework the `std::sys::windows::alloc` implementation.][83065]
1946 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
1947 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
1948 - [Rework rustdoc const type][82873]
1949
1950 [85667]: https://github.com/rust-lang/rust/pull/85667
1951 [83386]: https://github.com/rust-lang/rust/pull/83386
1952 [82771]: https://github.com/rust-lang/rust/pull/82771
1953 [84147]: https://github.com/rust-lang/rust/pull/84147
1954 [84082]: https://github.com/rust-lang/rust/pull/84082
1955 [83799]: https://github.com/rust-lang/rust/pull/83799
1956 [83681]: https://github.com/rust-lang/rust/pull/83681
1957 [83652]: https://github.com/rust-lang/rust/pull/83652
1958 [83387]: https://github.com/rust-lang/rust/pull/83387
1959 [82873]: https://github.com/rust-lang/rust/pull/82873
1960 [82864]: https://github.com/rust-lang/rust/pull/82864
1961 [82608]: https://github.com/rust-lang/rust/pull/82608
1962 [82565]: https://github.com/rust-lang/rust/pull/82565
1963 [80525]: https://github.com/rust-lang/rust/pull/80525
1964 [79278]: https://github.com/rust-lang/rust/pull/79278
1965 [78618]: https://github.com/rust-lang/rust/pull/78618
1966 [77704]: https://github.com/rust-lang/rust/pull/77704
1967 [83941]: https://github.com/rust-lang/rust/pull/83941
1968 [83065]: https://github.com/rust-lang/rust/pull/83065
1969 [81764]: https://github.com/rust-lang/rust/pull/81764
1970 [81469]: https://github.com/rust-lang/rust/pull/81469
1971 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
1972 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
1973 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
1974 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
1975 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
1976 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
1977 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
1978 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
1979 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
1980 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
1981 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
1982 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
1983 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
1984 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
1985 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
1986 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
1987 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
1988 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
1989 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
1990 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
1991 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
1992 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
1993 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
1994 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
1995 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
1996 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
1997 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
1998 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
1999 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
2000 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
2001 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
2002 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
2003 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
2004 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
2005 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
2006 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
2007 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
2008 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
2009 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
2010 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
2011 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
2012
2013
2014 Version 1.52.1 (2021-05-10)
2015 ============================
2016
2017 This release disables incremental compilation, unless the user has explicitly
2018 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
2019
2020 This is due to the widespread, and frequently occurring, breakage encountered by
2021 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
2022 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
2023 newly added incremental verification are still present in past stable versions,
2024 and are not yet fixed on any channel. These bugs can lead to miscompilation of
2025 Rust binaries.
2026
2027 These problems only affect incremental builds, so release builds with Cargo
2028 should not be affected unless the user has explicitly opted into incremental.
2029 Debug and check builds are affected.
2030
2031 See [84970] for more details.
2032
2033 [84970]: https://github.com/rust-lang/rust/issues/84970
2034
2035 Version 1.52.0 (2021-05-06)
2036 ============================
2037
2038 Language
2039 --------
2040 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
2041   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
2042   is allowed by default, and may become a warning or hard error in a
2043   future edition.
2044 - [You can now cast mutable references to arrays to a pointer of the same type as
2045   the element.][81479]
2046
2047 Compiler
2048 --------
2049 - [Upgraded the default LLVM to LLVM 12.][81451]
2050
2051 Added tier 3\* support for the following targets.
2052
2053 - [`s390x-unknown-linux-musl`][82166]
2054 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
2055 - [`powerpc-unknown-openbsd`][82733]
2056
2057 \* Refer to Rust's [platform support page][platform-support-doc] for more
2058 information on Rust's tiered platform support.
2059
2060 Libraries
2061 ---------
2062 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
2063 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
2064 - [`Arc<impl Error>` now implements `error::Error`.][80553]
2065 - [All integer division and remainder operations are now `const`.][80962]
2066
2067 Stabilised APIs
2068 -------------
2069 - [`Arguments::as_str`]
2070 - [`char::MAX`]
2071 - [`char::REPLACEMENT_CHARACTER`]
2072 - [`char::UNICODE_VERSION`]
2073 - [`char::decode_utf16`]
2074 - [`char::from_digit`]
2075 - [`char::from_u32_unchecked`]
2076 - [`char::from_u32`]
2077 - [`slice::partition_point`]
2078 - [`str::rsplit_once`]
2079 - [`str::split_once`]
2080
2081 The following previously stable APIs are now `const`.
2082
2083 - [`char::len_utf8`]
2084 - [`char::len_utf16`]
2085 - [`char::to_ascii_uppercase`]
2086 - [`char::to_ascii_lowercase`]
2087 - [`char::eq_ignore_ascii_case`]
2088 - [`u8::to_ascii_uppercase`]
2089 - [`u8::to_ascii_lowercase`]
2090 - [`u8::eq_ignore_ascii_case`]
2091
2092 Rustdoc
2093 -------
2094 - [Rustdoc lints are now treated as a tool lint, meaning that
2095   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
2096   Using the old style is still allowed, and will become a warning in
2097   a future release.
2098 - [Rustdoc now supports argument files.][82261]
2099 - [Rustdoc now generates smart punctuation for documentation.][79423]
2100 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
2101   ```markdown
2102   - [x] Complete
2103   - [ ] Todo
2104   ```
2105
2106 Misc
2107 ----
2108 - [You can now pass multiple filters to tests.][81356] E.g.
2109   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
2110 - [Rustup now distributes PDB symbols for the `std` library on Windows,
2111   allowing you to see `std` symbols when debugging.][82218]
2112
2113 Internal Only
2114 -------------
2115 These changes provide no direct user facing benefits, but represent significant
2116 improvements to the internals and overall performance of rustc and
2117 related tools.
2118
2119 - [Check the result cache before the DepGraph when ensuring queries][81855]
2120 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
2121 - [Only store a LocalDefId in some HIR nodes][81611]
2122 - [Store HIR attributes in a side table][79519]
2123
2124 Compatibility Notes
2125 -------------------
2126 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
2127 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
2128 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
2129 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
2130   languages in code blocks.][78429]
2131 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
2132 - [Changes in how proc macros handle whitespace may lead to panics when used
2133   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
2134 - [Turn `#[derive]` into a regular macro attribute][79078]
2135
2136 [84136]: https://github.com/rust-lang/rust/issues/84136
2137 [80763]: https://github.com/rust-lang/rust/pull/80763
2138 [82166]: https://github.com/rust-lang/rust/pull/82166
2139 [82121]: https://github.com/rust-lang/rust/pull/82121
2140 [81879]: https://github.com/rust-lang/rust/pull/81879
2141 [82261]: https://github.com/rust-lang/rust/pull/82261
2142 [82218]: https://github.com/rust-lang/rust/pull/82218
2143 [82216]: https://github.com/rust-lang/rust/pull/82216
2144 [82202]: https://github.com/rust-lang/rust/pull/82202
2145 [81855]: https://github.com/rust-lang/rust/pull/81855
2146 [81766]: https://github.com/rust-lang/rust/pull/81766
2147 [81744]: https://github.com/rust-lang/rust/pull/81744
2148 [81611]: https://github.com/rust-lang/rust/pull/81611
2149 [81479]: https://github.com/rust-lang/rust/pull/81479
2150 [81451]: https://github.com/rust-lang/rust/pull/81451
2151 [81356]: https://github.com/rust-lang/rust/pull/81356
2152 [80962]: https://github.com/rust-lang/rust/pull/80962
2153 [80553]: https://github.com/rust-lang/rust/pull/80553
2154 [80527]: https://github.com/rust-lang/rust/pull/80527
2155 [79519]: https://github.com/rust-lang/rust/pull/79519
2156 [79423]: https://github.com/rust-lang/rust/pull/79423
2157 [79208]: https://github.com/rust-lang/rust/pull/79208
2158 [78429]: https://github.com/rust-lang/rust/pull/78429
2159 [82733]: https://github.com/rust-lang/rust/pull/82733
2160 [82594]: https://github.com/rust-lang/rust/pull/82594
2161 [79078]: https://github.com/rust-lang/rust/pull/79078
2162 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
2163 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
2164 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
2165 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
2166 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
2167 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
2168 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
2169 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
2170 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
2171 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
2172 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
2173 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
2174 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
2175 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
2176 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
2177 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
2178 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
2179 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
2180 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
2181 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
2182 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
2183 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
2184
2185 Version 1.51.0 (2021-03-25)
2186 ============================
2187
2188 Language
2189 --------
2190 - [You can now parameterize items such as functions, traits, and `struct`s by constant
2191   values in addition to by types and lifetimes.][79135] Also known as "const generics"
2192   E.g. you can now write the following. Note: Only values of primitive integers,
2193   `bool`, or `char` types are currently permitted.
2194   ```rust
2195   struct GenericArray<T, const LENGTH: usize> {
2196       inner: [T; LENGTH]
2197   }
2198
2199   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
2200       const fn last(&self) -> Option<&T> {
2201           if LENGTH == 0 {
2202               None
2203           } else {
2204               Some(&self.inner[LENGTH - 1])
2205           }
2206       }
2207   }
2208   ```
2209
2210
2211 Compiler
2212 --------
2213
2214 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
2215   This option controls whether debug information is split across multiple files
2216   or packed into a single file. **Note** This option is unstable on other platforms.
2217 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
2218   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
2219 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
2220 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
2221
2222 \* Refer to Rust's [platform support page][platform-support-doc] for more
2223 information on Rust's tiered platform support.
2224
2225 Libraries
2226 ---------
2227
2228 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
2229 - [`str` now implements `AsMut<str>`.][80279]
2230 - [`u64` and `u128` now implement `From<char>`.][79502]
2231 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
2232 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
2233 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
2234 - [`io::Empty` now implements `io::Seek`.][78044]
2235 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
2236   `T: ?Sized` types.][80764]
2237 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
2238
2239
2240 Stabilized APIs
2241 ---------------
2242
2243 - [`Arc::decrement_strong_count`]
2244 - [`Arc::increment_strong_count`]
2245 - [`Once::call_once_force`]
2246 - [`Peekable::next_if_eq`]
2247 - [`Peekable::next_if`]
2248 - [`Seek::stream_position`]
2249 - [`array::IntoIter`]
2250 - [`panic::panic_any`]
2251 - [`ptr::addr_of!`]
2252 - [`ptr::addr_of_mut!`]
2253 - [`slice::fill_with`]
2254 - [`slice::split_inclusive_mut`]
2255 - [`slice::split_inclusive`]
2256 - [`slice::strip_prefix`]
2257 - [`slice::strip_suffix`]
2258 - [`str::split_inclusive`]
2259 - [`sync::OnceState`]
2260 - [`task::Wake`]
2261 - [`VecDeque::range`]
2262 - [`VecDeque::range_mut`]
2263
2264 Cargo
2265 -----
2266 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
2267   codegen option.][cargo/9112]
2268 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
2269   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
2270   to avoid unifying features of dependencies where that unification could be unwanted.
2271   Such as using the same dependency with a `std` feature in a build scripts and
2272   proc-macros, while using the `no-std` feature in the final binary. See the
2273   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
2274
2275 Rustdoc
2276 -------
2277
2278 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
2279 - [You can now provide a `--default-theme` flag which sets the default theme to use for
2280   documentation.][79642]
2281
2282 Various improvements to intra-doc links:
2283
2284 - [You can link to non-path primitives such as `slice`.][80181]
2285 - [You can link to associated items.][74489]
2286 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
2287
2288 Misc
2289 ----
2290 - [You can now pass `--include-ignored` to tests (e.g. with
2291   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
2292
2293 Compatibility Notes
2294 -------------------
2295
2296 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
2297 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
2298   could fail.][80579]
2299 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
2300   for the distributed artifacts.][81521]
2301     - `armv5te-unknown-linux-gnueabi`
2302     - `sparc64-unknown-linux-gnu`
2303     - `thumbv7neon-unknown-linux-gnueabihf`
2304     - `armv7-unknown-linux-gnueabi`
2305     - `x86_64-unknown-linux-gnux32`
2306 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
2307
2308 Internal Only
2309 -------------
2310
2311 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
2312
2313 [79135]: https://github.com/rust-lang/rust/pull/79135
2314 [74489]: https://github.com/rust-lang/rust/pull/74489
2315 [76934]: https://github.com/rust-lang/rust/pull/76934
2316 [79570]: https://github.com/rust-lang/rust/pull/79570
2317 [80181]: https://github.com/rust-lang/rust/pull/80181
2318 [79642]: https://github.com/rust-lang/rust/pull/79642
2319 [80945]: https://github.com/rust-lang/rust/pull/80945
2320 [80279]: https://github.com/rust-lang/rust/pull/80279
2321 [80053]: https://github.com/rust-lang/rust/pull/80053
2322 [79502]: https://github.com/rust-lang/rust/pull/79502
2323 [75180]: https://github.com/rust-lang/rust/pull/75180
2324 [81521]: https://github.com/rust-lang/rust/pull/81521
2325 [80968]: https://github.com/rust-lang/rust/pull/80968
2326 [80959]: https://github.com/rust-lang/rust/pull/80959
2327 [80718]: https://github.com/rust-lang/rust/pull/80718
2328 [80653]: https://github.com/rust-lang/rust/pull/80653
2329 [80579]: https://github.com/rust-lang/rust/pull/80579
2330 [79998]: https://github.com/rust-lang/rust/pull/79998
2331 [78044]: https://github.com/rust-lang/rust/pull/78044
2332 [81455]: https://github.com/rust-lang/rust/pull/81455
2333 [80764]: https://github.com/rust-lang/rust/pull/80764
2334 [80749]: https://github.com/rust-lang/rust/pull/80749
2335 [80662]: https://github.com/rust-lang/rust/pull/80662
2336 [79134]: https://github.com/rust-lang/rust/pull/79134
2337 [80966]: https://github.com/rust-lang/rust/pull/80966
2338 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
2339 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
2340 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
2341 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
2342 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
2343 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
2344 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
2345 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
2346 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
2347 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
2348 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
2349 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
2350 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
2351 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
2352 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
2353 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
2354 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
2355 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
2356 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
2357 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
2358 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
2359 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
2360 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
2361
2362 Version 1.50.0 (2021-02-11)
2363 ============================
2364
2365 Language
2366 -----------------------
2367 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
2368   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
2369 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
2370
2371 Compiler
2372 -----------------------
2373 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
2374 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
2375 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
2376 - [Dropped support for all cloudabi targets.][78439]
2377
2378 \* Refer to Rust's [platform support page][platform-support-doc] for more
2379 information on Rust's tiered platform support.
2380
2381 Libraries
2382 -----------------------
2383
2384 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
2385 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
2386 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
2387   This value cannot be a valid file descriptor, and now means `Option<File>` takes
2388   up the same amount of space as `File`.
2389
2390 Stabilized APIs
2391 ---------------
2392
2393 - [`bool::then`]
2394 - [`btree_map::Entry::or_insert_with_key`]
2395 - [`f32::clamp`]
2396 - [`f64::clamp`]
2397 - [`hash_map::Entry::or_insert_with_key`]
2398 - [`Ord::clamp`]
2399 - [`RefCell::take`]
2400 - [`slice::fill`]
2401 - [`UnsafeCell::get_mut`]
2402
2403 The following previously stable methods are now `const`.
2404
2405 - [`IpAddr::is_ipv4`]
2406 - [`IpAddr::is_ipv6`]
2407 - [`IpAddr::is_unspecified`]
2408 - [`IpAddr::is_loopback`]
2409 - [`IpAddr::is_multicast`]
2410 - [`Ipv4Addr::octets`]
2411 - [`Ipv4Addr::is_loopback`]
2412 - [`Ipv4Addr::is_private`]
2413 - [`Ipv4Addr::is_link_local`]
2414 - [`Ipv4Addr::is_multicast`]
2415 - [`Ipv4Addr::is_broadcast`]
2416 - [`Ipv4Addr::is_documentation`]
2417 - [`Ipv4Addr::to_ipv6_compatible`]
2418 - [`Ipv4Addr::to_ipv6_mapped`]
2419 - [`Ipv6Addr::segments`]
2420 - [`Ipv6Addr::is_unspecified`]
2421 - [`Ipv6Addr::is_loopback`]
2422 - [`Ipv6Addr::is_multicast`]
2423 - [`Ipv6Addr::to_ipv4`]
2424 - [`Layout::size`]
2425 - [`Layout::align`]
2426 - [`Layout::from_size_align`]
2427 - `pow` for all integer types.
2428 - `checked_pow` for all integer types.
2429 - `saturating_pow` for all integer types.
2430 - `wrapping_pow` for all integer types.
2431 - `next_power_of_two` for all unsigned integer types.
2432 - `checked_next_power_of_two` for all unsigned integer types.
2433
2434 Cargo
2435 -----------------------
2436
2437 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
2438   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
2439 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
2440   contents of that directory for changes.][cargo/8973]
2441 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
2442
2443 Misc
2444 ----
2445
2446 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
2447 - [Running tests will now print the total time taken to execute.][75752]
2448
2449 Compatibility Notes
2450 -------------------
2451
2452 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
2453   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
2454 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
2455   unhygenic `macro_rules!` macros.][79472]
2456 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
2457   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
2458 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
2459 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
2460   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
2461 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
2462
2463 [74989]: https://github.com/rust-lang/rust/pull/74989
2464 [79261]: https://github.com/rust-lang/rust/pull/79261
2465 [79896]: https://github.com/rust-lang/rust/pull/79896
2466 [79484]: https://github.com/rust-lang/rust/pull/79484
2467 [79472]: https://github.com/rust-lang/rust/pull/79472
2468 [79270]: https://github.com/rust-lang/rust/pull/79270
2469 [79003]: https://github.com/rust-lang/rust/pull/79003
2470 [78864]: https://github.com/rust-lang/rust/pull/78864
2471 [78636]: https://github.com/rust-lang/rust/pull/78636
2472 [78439]: https://github.com/rust-lang/rust/pull/78439
2473 [78343]: https://github.com/rust-lang/rust/pull/78343
2474 [78296]: https://github.com/rust-lang/rust/pull/78296
2475 [78068]: https://github.com/rust-lang/rust/pull/78068
2476 [75752]: https://github.com/rust-lang/rust/pull/75752
2477 [74699]: https://github.com/rust-lang/rust/pull/74699
2478 [78142]: https://github.com/rust-lang/rust/pull/78142
2479 [77484]: https://github.com/rust-lang/rust/pull/77484
2480 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
2481 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
2482 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
2483 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
2484 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
2485 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
2486 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
2487 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
2488 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
2489 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
2490 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
2491 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
2492 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
2493 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
2494 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
2495 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
2496 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
2497 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
2498 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
2499 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
2500 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
2501 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
2502 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
2503 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
2504 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
2505 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
2506 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
2507 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
2508 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
2509 [`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
2510 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
2511 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
2512 [`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
2513 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
2514
2515
2516 Version 1.49.0 (2020-12-31)
2517 ============================
2518
2519 Language
2520 -----------------------
2521
2522 - [Unions can now implement `Drop`, and you can now have a field in a union
2523   with `ManuallyDrop<T>`.][77547]
2524 - [You can now cast uninhabited enums to integers.][76199]
2525 - [You can now bind by reference and by move in patterns.][76119] This
2526   allows you to selectively borrow individual components of a type. E.g.
2527   ```rust
2528   #[derive(Debug)]
2529   struct Person {
2530       name: String,
2531       age: u8,
2532   }
2533
2534   let person = Person {
2535       name: String::from("Alice"),
2536       age: 20,
2537   };
2538
2539   // `name` is moved out of person, but `age` is referenced.
2540   let Person { name, ref age } = person;
2541   println!("{} {}", name, age);
2542   ```
2543
2544 Compiler
2545 -----------------------
2546
2547 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
2548 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
2549 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
2550 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
2551 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
2552 - [Output from threads spawned in tests is now captured.][78227]
2553 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
2554
2555 \* Refer to Rust's [platform support page][platform-support-doc] for more
2556 information on Rust's tiered platform support.
2557
2558 Libraries
2559 -----------------------
2560
2561 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
2562 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
2563
2564 Stabilized APIs
2565 ---------------
2566
2567 - [`slice::select_nth_unstable`]
2568 - [`slice::select_nth_unstable_by`]
2569 - [`slice::select_nth_unstable_by_key`]
2570
2571 The following previously stable methods are now `const`.
2572
2573 - [`Poll::is_ready`]
2574 - [`Poll::is_pending`]
2575
2576 Cargo
2577 -----------------------
2578 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
2579 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
2580 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
2581   variable will be set if the crate being built is one the user selected to build, either
2582   with `-p` or through defaults.
2583 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
2584
2585
2586 Compatibility Notes
2587 -------------------
2588
2589 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
2590 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
2591 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
2592   Previously such invalid or unused attributes could be ignored.
2593 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
2594   read [this post about the changes][rustdoc-ws-post] for more details.
2595 - [Trait bounds are no longer inferred for associated types.][79904]
2596
2597 Internal Only
2598 -------------
2599 These changes provide no direct user facing benefits, but represent significant
2600 improvements to the internals and overall performance of rustc and
2601 related tools.
2602
2603 - [rustc's internal crates are now compiled using the `initial-exec` Thread
2604   Local Storage model.][78201]
2605 - [Calculate visibilities once in resolve.][78077]
2606 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
2607 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
2608
2609
2610 [75991]: https://github.com/rust-lang/rust/pull/75991
2611 [78951]: https://github.com/rust-lang/rust/pull/78951
2612 [78848]: https://github.com/rust-lang/rust/pull/78848
2613 [78746]: https://github.com/rust-lang/rust/pull/78746
2614 [78376]: https://github.com/rust-lang/rust/pull/78376
2615 [78228]: https://github.com/rust-lang/rust/pull/78228
2616 [78227]: https://github.com/rust-lang/rust/pull/78227
2617 [78201]: https://github.com/rust-lang/rust/pull/78201
2618 [78109]: https://github.com/rust-lang/rust/pull/78109
2619 [78077]: https://github.com/rust-lang/rust/pull/78077
2620 [77997]: https://github.com/rust-lang/rust/pull/77997
2621 [77703]: https://github.com/rust-lang/rust/pull/77703
2622 [77547]: https://github.com/rust-lang/rust/pull/77547
2623 [77015]: https://github.com/rust-lang/rust/pull/77015
2624 [76199]: https://github.com/rust-lang/rust/pull/76199
2625 [76119]: https://github.com/rust-lang/rust/pull/76119
2626 [75914]: https://github.com/rust-lang/rust/pull/75914
2627 [79004]: https://github.com/rust-lang/rust/pull/79004
2628 [78676]: https://github.com/rust-lang/rust/pull/78676
2629 [79904]: https://github.com/rust-lang/rust/issues/79904
2630 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
2631 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
2632 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
2633 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
2634 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
2635 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
2636 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
2637 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
2638 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
2639 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
2640
2641 Version 1.48.0 (2020-11-19)
2642 ==========================
2643
2644 Language
2645 --------
2646
2647 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
2648   is still rejected *semantically*, but can now be parsed by procedural macros.
2649
2650 Compiler
2651 --------
2652 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
2653   `rustc` whether to link its own C runtime and libraries or to rely on a external
2654   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
2655 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
2656   Note: If you're using cargo you must explicitly pass the `--target` flag.
2657 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
2658
2659 \* Refer to Rust's [platform support page][platform-support-doc] for more
2660 information on Rust's tiered platform support.
2661
2662 Libraries
2663 ---------
2664 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
2665   and `&Stderr`.][76275]
2666 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
2667 - [The `matches!` macro now supports having a trailing comma.][74880]
2668 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
2669 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
2670
2671 Stabilized APIs
2672 ---------------
2673 - [`slice::as_ptr_range`]
2674 - [`slice::as_mut_ptr_range`]
2675 - [`VecDeque::make_contiguous`]
2676 - [`future::pending`]
2677 - [`future::ready`]
2678
2679 The following previously stable methods are now `const fn`'s:
2680
2681 - [`Option::is_some`]
2682 - [`Option::is_none`]
2683 - [`Option::as_ref`]
2684 - [`Result::is_ok`]
2685 - [`Result::is_err`]
2686 - [`Result::as_ref`]
2687 - [`Ordering::reverse`]
2688 - [`Ordering::then`]
2689
2690 Cargo
2691 -----
2692
2693 Rustdoc
2694 -------
2695 - [You can now link to items in `rustdoc` using the intra-doc link
2696   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
2697   a link to `std::future`'s documentation. See ["Linking to items by
2698   name"][intradoc-links] for more information.
2699 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
2700   when searching through `rustdoc`'s UI.][75740]
2701
2702 Compatibility Notes
2703 -------------------
2704 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
2705   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
2706   promoted to `'static` lifetime any more inside `const fn`s.
2707 - [Associated type bindings on trait objects are now verified to meet the bounds
2708   declared on the trait when checking that they implement the trait.][27675]
2709 - [When trait bounds on associated types or opaque types are ambiguous, the
2710   compiler no longer makes an arbitrary choice on which bound to use.][54121]
2711 - [Fixed recursive nonterminals not being expanded in macros during
2712   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
2713   correctly handling recursive nonterminal tokens.
2714 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
2715 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
2716   in places where they have no effect.][73461]
2717 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
2718   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
2719 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
2720   disallow zero-initialization.][71274]
2721 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
2722 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
2723   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
2724   see the [`catch_unwind`] documentation for further information.
2725
2726
2727
2728 Internal Only
2729 -------------
2730 These changes provide no direct user facing benefits, but represent significant
2731 improvements to the internals and overall performance of rustc and
2732 related tools.
2733
2734 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
2735   You can continue building with `make` by setting `ninja=false` in
2736   your `config.toml`.
2737 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
2738 - [Made `ensure_sufficient_stack()` non-generic][76680]
2739
2740 [78143]: https://github.com/rust-lang/rust/issues/78143
2741 [76680]: https://github.com/rust-lang/rust/pull/76680/
2742 [76030]: https://github.com/rust-lang/rust/pull/76030/
2743 [70212]: https://github.com/rust-lang/rust/pull/70212/
2744 [27675]: https://github.com/rust-lang/rust/issues/27675/
2745 [54121]: https://github.com/rust-lang/rust/issues/54121/
2746 [71274]: https://github.com/rust-lang/rust/pull/71274/
2747 [77386]: https://github.com/rust-lang/rust/pull/77386/
2748 [77153]: https://github.com/rust-lang/rust/pull/77153/
2749 [77055]: https://github.com/rust-lang/rust/pull/77055/
2750 [76275]: https://github.com/rust-lang/rust/pull/76275/
2751 [76310]: https://github.com/rust-lang/rust/pull/76310/
2752 [76420]: https://github.com/rust-lang/rust/pull/76420/
2753 [76158]: https://github.com/rust-lang/rust/pull/76158/
2754 [75857]: https://github.com/rust-lang/rust/pull/75857/
2755 [75585]: https://github.com/rust-lang/rust/pull/75585/
2756 [75740]: https://github.com/rust-lang/rust/pull/75740/
2757 [75502]: https://github.com/rust-lang/rust/pull/75502/
2758 [74880]: https://github.com/rust-lang/rust/pull/74880/
2759 [74922]: https://github.com/rust-lang/rust/pull/74922/
2760 [74430]: https://github.com/rust-lang/rust/pull/74430/
2761 [74194]: https://github.com/rust-lang/rust/pull/74194/
2762 [73461]: https://github.com/rust-lang/rust/pull/73461/
2763 [73166]: https://github.com/rust-lang/rust/pull/73166/
2764 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
2765 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
2766 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
2767 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
2768 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
2769 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
2770 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
2771 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
2772 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
2773 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
2774 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
2775 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
2776 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
2777 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
2778 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
2779
2780
2781 Version 1.47.0 (2020-10-08)
2782 ==========================
2783
2784 Language
2785 --------
2786 - [Closures will now warn when not used.][74869]
2787
2788 Compiler
2789 --------
2790 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
2791   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
2792   platforms.
2793 - [Upgraded to LLVM 11.][73526]
2794 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
2795 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
2796 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
2797
2798 \* Refer to Rust's [platform support page][platform-support-doc] for more
2799 information on Rust's tiered platform support.
2800
2801 Libraries
2802 ---------
2803 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
2804 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
2805   those of length less than 33.][74060]
2806 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
2807 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
2808   `PartialEq`, and `PartialOrd`.][73583]
2809
2810 Stabilized APIs
2811 ---------------
2812 - [`Ident::new_raw`]
2813 - [`Range::is_empty`]
2814 - [`RangeInclusive::is_empty`]
2815 - [`Result::as_deref`]
2816 - [`Result::as_deref_mut`]
2817 - [`Vec::leak`]
2818 - [`pointer::offset_from`]
2819 - [`f32::TAU`]
2820 - [`f64::TAU`]
2821
2822 The following previously stable APIs have now been made const.
2823
2824 - [The `new` method for all `NonZero` integers.][73858]
2825 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
2826   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
2827   methods for all integers.][73858]
2828 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
2829   signed integers.][73858]
2830 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
2831   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
2832   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
2833   `is_ascii_control` methods for `char` and `u8`.][73858]
2834
2835 Cargo
2836 -----
2837 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
2838   You can override this by setting the following in your `Cargo.toml`.
2839   ```toml
2840   [profile.release.build-override]
2841   opt-level = 3
2842   ```
2843 - [`cargo-help` will now display man pages for commands rather just the
2844   `--help` text.][cargo/8456]
2845 - [`cargo-metadata` now emits a `test` field indicating if a target has
2846   tests enabled.][cargo/8478]
2847 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
2848 - [`cargo-publish` will now use an alternative registry by default if it's the
2849   only registry specified in `package.publish`.][cargo/8571]
2850
2851 Misc
2852 ----
2853 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
2854   type based search.][75366]
2855 - [Added the Ayu theme to rustdoc.][71237]
2856
2857 Compatibility Notes
2858 -------------------
2859 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
2860 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
2861 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
2862   help to preserve more span information.][73084] These changes may cause
2863   compilation errors if your macro was unhygenic or didn't correctly handle
2864   `Delimiter::None`.
2865 - [Moved support for the CloudABI target to tier 3.][75568]
2866 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
2867 - [Added the `rustc-docs` component.][75560] This allows you to install
2868   and read the documentation for the compiler internal APIs. (Currently only
2869   available for `x86_64-unknown-linux-gnu`.)
2870
2871 Internal Only
2872 --------
2873
2874 - [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.
2875
2876 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
2877 [75048]: https://github.com/rust-lang/rust/pull/75048/
2878 [74163]: https://github.com/rust-lang/rust/pull/74163/
2879 [71237]: https://github.com/rust-lang/rust/pull/71237/
2880 [74869]: https://github.com/rust-lang/rust/pull/74869/
2881 [73858]: https://github.com/rust-lang/rust/pull/73858/
2882 [75716]: https://github.com/rust-lang/rust/pull/75716/
2883 [75560]: https://github.com/rust-lang/rust/pull/75560/
2884 [75568]: https://github.com/rust-lang/rust/pull/75568/
2885 [75366]: https://github.com/rust-lang/rust/pull/75366/
2886 [75204]: https://github.com/rust-lang/rust/pull/75204/
2887 [74650]: https://github.com/rust-lang/rust/pull/74650/
2888 [74419]: https://github.com/rust-lang/rust/pull/74419/
2889 [73964]: https://github.com/rust-lang/rust/pull/73964/
2890 [74021]: https://github.com/rust-lang/rust/pull/74021/
2891 [74060]: https://github.com/rust-lang/rust/pull/74060/
2892 [73893]: https://github.com/rust-lang/rust/pull/73893/
2893 [73526]: https://github.com/rust-lang/rust/pull/73526/
2894 [73583]: https://github.com/rust-lang/rust/pull/73583/
2895 [73084]: https://github.com/rust-lang/rust/pull/73084/
2896 [73197]: https://github.com/rust-lang/rust/pull/73197/
2897 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
2898 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
2899 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
2900 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
2901 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
2902 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
2903 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
2904 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
2905 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
2906 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
2907 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
2908 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
2909 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
2910 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
2911
2912
2913 Version 1.46.0 (2020-08-27)
2914 ==========================
2915
2916 Language
2917 --------
2918 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
2919 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
2920   const functions.][73862]
2921 - [The `#[track_caller]` attribute can now be added to functions to use the
2922   function's caller's location information for panic messages.][72445]
2923 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
2924   `x.0.0` over `(x.0).0`.
2925 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
2926   You currently can't use `mem::transmute` in constant functions.
2927
2928 Compiler
2929 --------
2930 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
2931 - [Enabled static "Position Independent Executables" by default
2932   for `x86_64-unknown-linux-musl`.][70740]
2933
2934 Libraries
2935 ---------
2936 - [`mem::forget` is now a `const fn`.][73887]
2937 - [`String` now implements `From<char>`.][73466]
2938 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
2939   integer types.][73032]
2940 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
2941 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
2942   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
2943 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
2944 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
2945 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
2946
2947 Stabilized APIs
2948 ---------------
2949 - [`Option::zip`]
2950 - [`vec::Drain::as_slice`]
2951
2952 Cargo
2953 -----
2954 Added a number of new environment variables that are now available when
2955 compiling your crate.
2956
2957 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
2958   the specific binary being compiled and the name of the crate.
2959 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
2960 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
2961
2962 Compatibility Notes
2963 -------------------
2964 - [The target configuration option `abi_blacklist` has been renamed
2965   to `unsupported_abis`.][74150] The old name will still continue to work.
2966 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
2967   This was previously accepted but will become a hard error in a future release.
2968 - [Rustc will fail to compile if you have a struct with
2969   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
2970   allowed on `enum`s.
2971 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
2972   ensure that spans have the correct information, and may cause breakage if you
2973   were relying on receiving spans with dummy information.
2974 - [The InnoSetup installer for Windows is no longer available.][72569] This was
2975   a legacy installer that was replaced by a MSI installer a few years ago but
2976   was still being built.
2977 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
2978 - [Rustc will no longer accept overlapping trait implementations that only
2979   differ in how the lifetime was bound.][72493]
2980 - [Rustc now correctly relates the lifetime of an existential associated
2981   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
2982   you to pass a shorter lifetime than expected.
2983 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
2984   The library will need to be installed for `rustc` to work, even though we
2985   expect it to be already available on most systems.
2986 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
2987   under QEMU.][74820]
2988 - [Pretty printing of some tokens in procedural macros changed.][75453] The
2989   exact output returned by rustc's pretty printing is an unstable
2990   implementation detail: we recommend any macro relying on it to switch to a
2991   more robust parsing system.
2992
2993 [75453]: https://github.com/rust-lang/rust/issues/75453/
2994 [74820]: https://github.com/rust-lang/rust/issues/74820/
2995 [74420]: https://github.com/rust-lang/rust/issues/74420/
2996 [74109]: https://github.com/rust-lang/rust/pull/74109/
2997 [74150]: https://github.com/rust-lang/rust/pull/74150/
2998 [73862]: https://github.com/rust-lang/rust/pull/73862/
2999 [73887]: https://github.com/rust-lang/rust/pull/73887/
3000 [73466]: https://github.com/rust-lang/rust/pull/73466/
3001 [73516]: https://github.com/rust-lang/rust/pull/73516/
3002 [73293]: https://github.com/rust-lang/rust/pull/73293/
3003 [73007]: https://github.com/rust-lang/rust/pull/73007/
3004 [73032]: https://github.com/rust-lang/rust/pull/73032/
3005 [72920]: https://github.com/rust-lang/rust/pull/72920/
3006 [72569]: https://github.com/rust-lang/rust/pull/72569/
3007 [72583]: https://github.com/rust-lang/rust/pull/72583/
3008 [72584]: https://github.com/rust-lang/rust/pull/72584/
3009 [72717]: https://github.com/rust-lang/rust/pull/72717/
3010 [72437]: https://github.com/rust-lang/rust/pull/72437/
3011 [72445]: https://github.com/rust-lang/rust/pull/72445/
3012 [72486]: https://github.com/rust-lang/rust/pull/72486/
3013 [72493]: https://github.com/rust-lang/rust/pull/72493/
3014 [72331]: https://github.com/rust-lang/rust/pull/72331/
3015 [71896]: https://github.com/rust-lang/rust/pull/71896/
3016 [71660]: https://github.com/rust-lang/rust/pull/71660/
3017 [71322]: https://github.com/rust-lang/rust/pull/71322/
3018 [70740]: https://github.com/rust-lang/rust/pull/70740/
3019 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
3020 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
3021 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
3022 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
3023 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
3024
3025
3026 Version 1.45.2 (2020-08-03)
3027 ==========================
3028
3029 * [Fix bindings in tuple struct patterns][74954]
3030 * [Fix track_caller integration with trait objects][74784]
3031
3032 [74954]: https://github.com/rust-lang/rust/issues/74954
3033 [74784]: https://github.com/rust-lang/rust/issues/74784
3034
3035
3036 Version 1.45.1 (2020-07-30)
3037 ==========================
3038
3039 * [Fix const propagation with references.][73613]
3040 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
3041 * [Avoid spurious implicit region bound.][74509]
3042 * [Install clippy on x.py install][74457]
3043
3044 [73613]: https://github.com/rust-lang/rust/pull/73613
3045 [73078]: https://github.com/rust-lang/rust/issues/73078
3046 [74509]: https://github.com/rust-lang/rust/pull/74509
3047 [74457]: https://github.com/rust-lang/rust/pull/74457
3048
3049
3050 Version 1.45.0 (2020-07-16)
3051 ==========================
3052
3053 Language
3054 --------
3055 - [Out of range float to int conversions using `as` has been defined as a saturating
3056   conversion.][71269] This was previously undefined behaviour, but you can use the
3057    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
3058    may be desirable in rare performance sensitive situations.
3059 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
3060   using `u64`.][70705]
3061 - [Function like procedural macros can now be used in expression, pattern, and  statement
3062   positions.][68717] This means you can now use a function-like procedural macro
3063   anywhere you can use a declarative (`macro_rules!`) macro.
3064
3065 Compiler
3066 --------
3067 - [You can now override individual target features through the `target-feature`
3068   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
3069   equivalent to `-C target-feature=+avx2,+fma`.
3070 - [Added the `force-unwind-tables` flag.][69984] This option allows
3071   rustc to always generate unwind tables regardless of panic strategy.
3072 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
3073   to include LLVM bitcode into generated `rlib`s (this is on by default).
3074 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
3075 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
3076 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
3077 - [Upgraded to LLVM 10.][67759]
3078
3079 \* Refer to Rust's [platform support page][platform-support-doc] for more
3080 information on Rust's tiered platform support.
3081
3082
3083 Libraries
3084 ---------
3085 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
3086   and `Ord`.][72239]
3087 - [`proc_macro::TokenStream` now implements `Default`.][72234]
3088 - [You can now use `char` with
3089   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
3090   a range of codepoints.][72413] E.g.
3091   you can now write the following;
3092   ```rust
3093   for ch in 'a'..='z' {
3094       print!("{}", ch);
3095   }
3096   println!();
3097   // Prints "abcdefghijklmnopqrstuvwxyz"
3098   ```
3099 - [`OsString` now implements `FromStr`.][71662]
3100 - [The `saturating_neg` method has been added to all signed integer primitive
3101   types, and the `saturating_abs` method has been added for all integer
3102   primitive types.][71886]
3103 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
3104   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
3105   or `Path`.][71447]
3106 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
3107 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
3108   integer types.][69813]
3109 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
3110   integer types.][72324]
3111 - [The `fetch_update` method has been added to all atomic integer types.][71843]
3112
3113 Stabilized APIs
3114 ---------------
3115 - [`Arc::as_ptr`]
3116 - [`BTreeMap::remove_entry`]
3117 - [`Rc::as_ptr`]
3118 - [`rc::Weak::as_ptr`]
3119 - [`rc::Weak::from_raw`]
3120 - [`rc::Weak::into_raw`]
3121 - [`str::strip_prefix`]
3122 - [`str::strip_suffix`]
3123 - [`sync::Weak::as_ptr`]
3124 - [`sync::Weak::from_raw`]
3125 - [`sync::Weak::into_raw`]
3126 - [`char::UNICODE_VERSION`]
3127 - [`Span::resolved_at`]
3128 - [`Span::located_at`]
3129 - [`Span::mixed_site`]
3130 - [`unix::process::CommandExt::arg0`]
3131
3132 Cargo
3133 -----
3134
3135 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
3136   time.][cargo/8066]
3137
3138 Misc
3139 ----
3140 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
3141   `~~outdated information~~` becomes "~~outdated information~~".
3142 - [Added an emoji to Rustdoc's deprecated API message.][72014]
3143
3144 Compatibility Notes
3145 -------------------
3146 - [Trying to self initialize a static value (that is creating a value using
3147   itself) is unsound and now causes a compile error.][71140]
3148 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
3149   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
3150 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
3151   previously undocumented and not intended for public use. Rustdoc still provides
3152   a non-zero exit code on errors.
3153 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
3154   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
3155   flags while cargo is adding `embed-bitcode` itself. The recommended way to
3156   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
3157   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
3158
3159 Internals Only
3160 --------------
3161 - [Make clippy a git subtree instead of a git submodule][70655]
3162 - [Unify the undo log of all snapshot types][69464]
3163
3164 [71848]: https://github.com/rust-lang/rust/issues/71848/
3165 [73420]: https://github.com/rust-lang/rust/issues/73420/
3166 [72324]: https://github.com/rust-lang/rust/pull/72324/
3167 [71843]: https://github.com/rust-lang/rust/pull/71843/
3168 [71886]: https://github.com/rust-lang/rust/pull/71886/
3169 [72234]: https://github.com/rust-lang/rust/pull/72234/
3170 [72239]: https://github.com/rust-lang/rust/pull/72239/
3171 [72397]: https://github.com/rust-lang/rust/pull/72397/
3172 [72413]: https://github.com/rust-lang/rust/pull/72413/
3173 [72014]: https://github.com/rust-lang/rust/pull/72014/
3174 [72062]: https://github.com/rust-lang/rust/pull/72062/
3175 [72094]: https://github.com/rust-lang/rust/pull/72094/
3176 [72133]: https://github.com/rust-lang/rust/pull/72133/
3177 [67759]: https://github.com/rust-lang/rust/pull/67759/
3178 [71900]: https://github.com/rust-lang/rust/pull/71900/
3179 [71928]: https://github.com/rust-lang/rust/pull/71928/
3180 [71662]: https://github.com/rust-lang/rust/pull/71662/
3181 [71716]: https://github.com/rust-lang/rust/pull/71716/
3182 [71447]: https://github.com/rust-lang/rust/pull/71447/
3183 [71269]: https://github.com/rust-lang/rust/pull/71269/
3184 [71095]: https://github.com/rust-lang/rust/pull/71095/
3185 [71140]: https://github.com/rust-lang/rust/pull/71140/
3186 [70655]: https://github.com/rust-lang/rust/pull/70655/
3187 [70705]: https://github.com/rust-lang/rust/pull/70705/
3188 [69984]: https://github.com/rust-lang/rust/pull/69984/
3189 [69813]: https://github.com/rust-lang/rust/pull/69813/
3190 [69464]: https://github.com/rust-lang/rust/pull/69464/
3191 [68717]: https://github.com/rust-lang/rust/pull/68717/
3192 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
3193 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
3194 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
3195 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
3196 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
3197 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
3198 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
3199 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
3200 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
3201 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
3202 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
3203 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
3204 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
3205 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
3206 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
3207 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
3208 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
3209
3210
3211 Version 1.44.1 (2020-06-18)
3212 ===========================
3213
3214 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
3215 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
3216 * [Fix crashes when finding backtrace on macOS.][71397]
3217 * [Clippy applies lint levels into different files.][clippy/5356]
3218
3219 [71397]: https://github.com/rust-lang/rust/issues/71397
3220 [73078]: https://github.com/rust-lang/rust/issues/73078
3221 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
3222 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
3223
3224
3225 Version 1.44.0 (2020-06-04)
3226 ==========================
3227
3228 Language
3229 --------
3230 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
3231 - [Added the `unused_braces` lint.][70081]
3232
3233 **Syntax-only changes**
3234
3235 - [Expansion-driven outline module parsing][69838]
3236 ```rust
3237 #[cfg(FALSE)]
3238 mod foo {
3239     mod bar {
3240         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
3241     }
3242 }
3243 ```
3244
3245 These are still rejected semantically, so you will likely receive an error but
3246 these changes can be seen and parsed by macros and conditional compilation.
3247
3248 Compiler
3249 --------
3250 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
3251   Additionally when in incremental mode rustc defaults to 256 codegen units.
3252 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
3253   a panic is thrown.][67502]
3254 - [Added tier 3\* support for the `aarch64-unknown-none` and
3255   `aarch64-unknown-none-softfloat` targets.][68334]
3256 - [Added tier 3 support for `arm64-apple-tvos` and
3257   `x86_64-apple-tvos` targets.][68191]
3258
3259
3260 Libraries
3261 ---------
3262 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
3263   `vec![]` to be able to be used in `const` contexts.
3264 - [`convert::Infallible` now implements `Hash`.][70281]
3265 - [`OsString` now implements `DerefMut` and `IndexMut` returning
3266   a `&mut OsStr`.][70048]
3267 - [Unicode 13 is now supported.][69929]
3268 - [`String` now implements `From<&mut str>`.][69661]
3269 - [`IoSlice` now implements `Copy`.][69403]
3270 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
3271 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
3272 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
3273   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
3274   integer types.][69373]
3275
3276 Stabilized APIs
3277 ---------------
3278 - [`PathBuf::with_capacity`]
3279 - [`PathBuf::capacity`]
3280 - [`PathBuf::clear`]
3281 - [`PathBuf::reserve`]
3282 - [`PathBuf::reserve_exact`]
3283 - [`PathBuf::shrink_to_fit`]
3284 - [`f32::to_int_unchecked`]
3285 - [`f64::to_int_unchecked`]
3286 - [`Layout::align_to`]
3287 - [`Layout::pad_to_align`]
3288 - [`Layout::array`]
3289 - [`Layout::extend`]
3290
3291 Cargo
3292 -----
3293 - [Added the `cargo tree` command which will print a tree graph of
3294   your dependencies.][cargo/8062] E.g.
3295   ```
3296     mdbook v0.3.2 (/Users/src/rust/mdbook)
3297   ├── ammonia v3.0.0
3298   │   ├── html5ever v0.24.0
3299   │   │   ├── log v0.4.8
3300   │   │   │   └── cfg-if v0.1.9
3301   │   │   ├── mac v0.1.1
3302   │   │   └── markup5ever v0.9.0
3303   │   │       ├── log v0.4.8 (*)
3304   │   │       ├── phf v0.7.24
3305   │   │       │   └── phf_shared v0.7.24
3306   │   │       │       ├── siphasher v0.2.3
3307   │   │       │       └── unicase v1.4.2
3308   │   │       │           [build-dependencies]
3309   │   │       │           └── version_check v0.1.5
3310   ...
3311   ```
3312   You can also display dependencies on multiple versions of the same crate with
3313   `cargo tree -d` (short for `cargo tree --duplicates`).
3314
3315 Misc
3316 ----
3317 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
3318   the version in the sidebar.][69494]
3319
3320 Compatibility Notes
3321 -------------------
3322 - [Rustc now correctly generates static libraries on Windows GNU targets with
3323   the `.a` extension, rather than the previous `.lib`.][70937]
3324 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
3325 - [The `file_name` property in JSON output of macro errors now points the actual
3326   source file rather than the previous format of `<NAME macros>`.][70969]
3327   **Note:** this may not point to a file that actually exists on the user's system.
3328 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
3329 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
3330   not allow zero initialization such as `NonZeroU8`.][66059] This was
3331   previously a warning.
3332 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
3333   operator has been defined as a saturating operation.][71269] This was previously
3334   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
3335   continue using the current behaviour, which may be desirable in rare performance
3336   sensitive situations.
3337
3338 Internal Only
3339 -------------
3340 These changes provide no direct user facing benefits, but represent significant
3341 improvements to the internals and overall performance of rustc and
3342 related tools.
3343
3344 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
3345 - [Replace big JS dict with JSON parsing.][71250]
3346
3347 [69373]: https://github.com/rust-lang/rust/pull/69373/
3348 [66059]: https://github.com/rust-lang/rust/pull/66059/
3349 [68191]: https://github.com/rust-lang/rust/pull/68191/
3350 [68899]: https://github.com/rust-lang/rust/pull/68899/
3351 [71147]: https://github.com/rust-lang/rust/pull/71147/
3352 [71250]: https://github.com/rust-lang/rust/pull/71250/
3353 [70937]: https://github.com/rust-lang/rust/pull/70937/
3354 [70969]: https://github.com/rust-lang/rust/pull/70969/
3355 [70632]: https://github.com/rust-lang/rust/pull/70632/
3356 [70281]: https://github.com/rust-lang/rust/pull/70281/
3357 [70345]: https://github.com/rust-lang/rust/pull/70345/
3358 [70048]: https://github.com/rust-lang/rust/pull/70048/
3359 [70081]: https://github.com/rust-lang/rust/pull/70081/
3360 [70156]: https://github.com/rust-lang/rust/pull/70156/
3361 [71269]: https://github.com/rust-lang/rust/pull/71269/
3362 [69838]: https://github.com/rust-lang/rust/pull/69838/
3363 [69929]: https://github.com/rust-lang/rust/pull/69929/
3364 [69661]: https://github.com/rust-lang/rust/pull/69661/
3365 [69778]: https://github.com/rust-lang/rust/pull/69778/
3366 [69494]: https://github.com/rust-lang/rust/pull/69494/
3367 [69403]: https://github.com/rust-lang/rust/pull/69403/
3368 [69033]: https://github.com/rust-lang/rust/pull/69033/
3369 [68692]: https://github.com/rust-lang/rust/pull/68692/
3370 [68334]: https://github.com/rust-lang/rust/pull/68334/
3371 [67502]: https://github.com/rust-lang/rust/pull/67502/
3372 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
3373 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
3374 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
3375 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
3376 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
3377 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
3378 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
3379 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
3380 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
3381 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
3382 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
3383 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
3384 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
3385
3386
3387 Version 1.43.1 (2020-05-07)
3388 ===========================
3389
3390 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
3391 * [Fixed the stabilization of AVX-512 features.][71473]
3392 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
3393
3394 [71430]: https://github.com/rust-lang/rust/pull/71430
3395 [71473]: https://github.com/rust-lang/rust/issues/71473
3396 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
3397
3398
3399 Version 1.43.0 (2020-04-23)
3400 ==========================
3401
3402 Language
3403 --------
3404 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
3405   the type inferred correctly.][68129]
3406 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
3407
3408 **Syntax only changes**
3409 - [Allow `type Foo: Ord` syntactically.][69361]
3410 - [Fuse associated and extern items up to defaultness.][69194]
3411 - [Syntactically allow `self` in all `fn` contexts.][68764]
3412 - [Merge `fn` syntax + cleanup item parsing.][68728]
3413 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
3414   For example, you may now write:
3415   ```rust
3416   macro_rules! mac_trait {
3417       ($i:item) => {
3418           trait T { $i }
3419       }
3420   }
3421   mac_trait! {
3422       fn foo() {}
3423   }
3424   ```
3425
3426 These are still rejected *semantically*, so you will likely receive an error but
3427 these changes can be seen and parsed by macros and
3428 conditional compilation.
3429
3430
3431 Compiler
3432 --------
3433 - [You can now pass multiple lint flags to rustc to override the previous
3434   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
3435   everything in the `unused` lint group except `unused-variables` which
3436   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
3437   everything in the `unused` lint group **including** `unused-variables` since
3438   the allow flag is specified before the deny flag (and therefore overridden).
3439 - [rustc will now prefer your system MinGW libraries over its bundled libraries
3440   if they are available on `windows-gnu`.][67429]
3441 - [rustc now buffers errors/warnings printed in JSON.][69227]
3442
3443 Libraries
3444 ---------
3445 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
3446   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
3447   respectively.][69538] **Note** These conversions are only available when `N`
3448   is `0..=32`.
3449 - [You can now use associated constants on floats and integers directly, rather
3450   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
3451   `f32::NAN` with no imports.
3452 - [`u8::is_ascii` is now `const`.][68984]
3453 - [`String` now implements `AsMut<str>`.][68742]
3454 - [Added the `primitive` module to `std` and `core`.][67637] This module
3455   reexports Rust's primitive types. This is mainly useful in macros
3456   where you want avoid these types being shadowed.
3457 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
3458 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
3459
3460 Stabilized APIs
3461 ---------------
3462 - [`Once::is_completed`]
3463 - [`f32::LOG10_2`]
3464 - [`f32::LOG2_10`]
3465 - [`f64::LOG10_2`]
3466 - [`f64::LOG2_10`]
3467 - [`iter::once_with`]
3468
3469 Cargo
3470 -----
3471 - [You can now set config `[profile]`s in your `.cargo/config`, or through
3472   your environment.][cargo/7823]
3473 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
3474   executable path when running integration tests or benchmarks.][cargo/7697]
3475   `<name>` is the name of your binary as-is e.g. If you wanted the executable
3476   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
3477
3478 Misc
3479 ----
3480 - [Certain checks in the `const_err` lint were deemed unrelated to const
3481   evaluation][69185], and have been moved to the `unconditional_panic` and
3482   `arithmetic_overflow` lints.
3483
3484 Compatibility Notes
3485 -------------------
3486
3487 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
3488   has been a warning since 1.36.0.
3489 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
3490   led to some instances being accepted, and now correctly emits a hard error.
3491
3492 [69340]: https://github.com/rust-lang/rust/pull/69340
3493
3494 Internal Only
3495 -------------
3496 These changes provide no direct user facing benefits, but represent significant
3497 improvements to the internals and overall performance of `rustc` and
3498 related tools.
3499
3500 - [All components are now built with `opt-level=3` instead of `2`.][67878]
3501 - [Improved how rustc generates drop code.][67332]
3502 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
3503 - [traits: preallocate 2 Vecs of known initial size][69022]
3504 - [Avoid exponential behaviour when relating types][68772]
3505 - [Skip `Drop` terminators for enum variants without drop glue][68943]
3506 - [Improve performance of coherence checks][68966]
3507 - [Deduplicate types in the generator witness][68672]
3508 - [Invert control in struct_lint_level.][68725]
3509
3510 [67332]: https://github.com/rust-lang/rust/pull/67332/
3511 [67429]: https://github.com/rust-lang/rust/pull/67429/
3512 [67637]: https://github.com/rust-lang/rust/pull/67637/
3513 [67642]: https://github.com/rust-lang/rust/pull/67642/
3514 [67878]: https://github.com/rust-lang/rust/pull/67878/
3515 [67885]: https://github.com/rust-lang/rust/pull/67885/
3516 [68129]: https://github.com/rust-lang/rust/pull/68129/
3517 [68672]: https://github.com/rust-lang/rust/pull/68672/
3518 [68725]: https://github.com/rust-lang/rust/pull/68725/
3519 [68728]: https://github.com/rust-lang/rust/pull/68728/
3520 [68738]: https://github.com/rust-lang/rust/pull/68738/
3521 [68742]: https://github.com/rust-lang/rust/pull/68742/
3522 [68764]: https://github.com/rust-lang/rust/pull/68764/
3523 [68772]: https://github.com/rust-lang/rust/pull/68772/
3524 [68943]: https://github.com/rust-lang/rust/pull/68943/
3525 [68952]: https://github.com/rust-lang/rust/pull/68952/
3526 [68966]: https://github.com/rust-lang/rust/pull/68966/
3527 [68984]: https://github.com/rust-lang/rust/pull/68984/
3528 [69022]: https://github.com/rust-lang/rust/pull/69022/
3529 [69185]: https://github.com/rust-lang/rust/pull/69185/
3530 [69194]: https://github.com/rust-lang/rust/pull/69194/
3531 [69201]: https://github.com/rust-lang/rust/pull/69201/
3532 [69227]: https://github.com/rust-lang/rust/pull/69227/
3533 [69548]: https://github.com/rust-lang/rust/pull/69548/
3534 [69256]: https://github.com/rust-lang/rust/pull/69256/
3535 [69361]: https://github.com/rust-lang/rust/pull/69361/
3536 [69366]: https://github.com/rust-lang/rust/pull/69366/
3537 [69538]: https://github.com/rust-lang/rust/pull/69538/
3538 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
3539 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
3540 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
3541 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
3542 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
3543 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
3544 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
3545 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
3546
3547
3548 Version 1.42.0 (2020-03-12)
3549 ==========================
3550
3551 Language
3552 --------
3553 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
3554   ```rust
3555   fn foo(words: &[&str]) {
3556       match words {
3557           ["Hello", "World", "!", ..] => println!("Hello World!"),
3558           ["Foo", "Bar", ..] => println!("Baz"),
3559           rest => println!("{:?}", rest),
3560       }
3561   }
3562   ```
3563 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
3564   that you can create an enum that has the exact layout and ABI of the type
3565   it contains.
3566 - [You can now use outer attribute procedural macros on inline modules.][64273]
3567 - [There are some *syntax-only* changes:][67131]
3568    - `default` is syntactically allowed before items in `trait` definitions.
3569    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
3570      leave out their bodies in favor of `;`.
3571    - Bounds on associated types in `impl`s are now syntactically allowed
3572      (e.g. `type Foo: Ord;`).
3573    - `...` (the C-variadic type) may occur syntactically directly as the type of
3574       any function parameter.
3575
3576   These are still rejected *semantically*, so you will likely receive an error
3577   but these changes can be seen and parsed by procedural macros and
3578   conditional compilation.
3579
3580 Compiler
3581 --------
3582 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
3583 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
3584 - [`Option::{expect,unwrap}` and
3585    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
3586    pointing to the location where they were called, rather than
3587    `core`'s internals. ][67887]
3588
3589 \* Refer to Rust's [platform support page][platform-support-doc] for more
3590 information on Rust's tiered platform support.
3591
3592 Libraries
3593 ---------
3594 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
3595 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
3596    to implement `Sized`.][67935]
3597 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
3598 - [`Layout::new` is now `const`.][66254]
3599 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
3600
3601
3602 Stabilized APIs
3603 ---------------
3604 - [`CondVar::wait_while`]
3605 - [`CondVar::wait_timeout_while`]
3606 - [`DebugMap::key`]
3607 - [`DebugMap::value`]
3608 - [`ManuallyDrop::take`]
3609 - [`matches!`]
3610 - [`ptr::slice_from_raw_parts_mut`]
3611 - [`ptr::slice_from_raw_parts`]
3612
3613 Cargo
3614 -----
3615 - [You no longer need to include `extern crate proc_macro;` to be able to
3616   `use proc_macro;` in the `2018` edition.][cargo/7700]
3617
3618 Compatibility Notes
3619 -------------------
3620 - [`Error::description` has been deprecated, and its use will now produce a
3621   warning.][66919] It's recommended to use `Display`/`to_string` instead.
3622
3623 [68253]: https://github.com/rust-lang/rust/pull/68253/
3624 [68348]: https://github.com/rust-lang/rust/pull/68348/
3625 [67935]: https://github.com/rust-lang/rust/pull/67935/
3626 [68339]: https://github.com/rust-lang/rust/pull/68339/
3627 [68122]: https://github.com/rust-lang/rust/pull/68122/
3628 [64273]: https://github.com/rust-lang/rust/pull/64273/
3629 [67712]: https://github.com/rust-lang/rust/pull/67712/
3630 [67887]: https://github.com/rust-lang/rust/pull/67887/
3631 [67131]: https://github.com/rust-lang/rust/pull/67131/
3632 [67233]: https://github.com/rust-lang/rust/pull/67233/
3633 [66899]: https://github.com/rust-lang/rust/pull/66899/
3634 [66919]: https://github.com/rust-lang/rust/pull/66919/
3635 [66254]: https://github.com/rust-lang/rust/pull/66254/
3636 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
3637 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
3638 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
3639 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
3640 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
3641 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
3642 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
3643 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
3644 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
3645
3646
3647 Version 1.41.1 (2020-02-27)
3648 ===========================
3649
3650 * [Always check types of static items][69145]
3651 * [Always check lifetime bounds of `Copy` impls][69145]
3652 * [Fix miscompilation in callers of `Layout::repeat`][69225]
3653
3654 [69225]: https://github.com/rust-lang/rust/issues/69225
3655 [69145]: https://github.com/rust-lang/rust/pull/69145
3656
3657
3658 Version 1.41.0 (2020-01-30)
3659 ===========================
3660
3661 Language
3662 --------
3663
3664 - [You can now pass type parameters to foreign items when implementing
3665   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
3666 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
3667   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
3668   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
3669 - [You can now use any valid identifier in a `format_args` macro.][66847]
3670   Previously identifiers starting with an underscore were not allowed.
3671 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
3672   enum variants.][66183] These are still rejected semantically, but
3673   can be seen and parsed by procedural macros and conditional compilation.
3674 - [You can now define a Rust `extern "C"` function with `Box<T>` and use `T*` as the corresponding
3675   type on the C side.][62514] Please see [the documentation][box-memory-layout] for more information,
3676   including the important caveat about preferring to avoid `Box<T>` in Rust signatures for functions defined in C.
3677
3678 [box-memory-layout]: https://doc.rust-lang.org/std/boxed/index.html#memory-layout
3679
3680 Compiler
3681 --------
3682
3683 - [Rustc will now warn if you have unused loop `'label`s.][66325]
3684 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
3685 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
3686 - [You can now pass an arguments file passing the `@path` syntax
3687   to rustc.][66172] Note that the format differs somewhat from what is
3688   found in other tooling; please see [the documentation][argfile-docs] for
3689   more information.
3690 - [You can now provide `--extern` flag without a path, indicating that it is
3691   available from the search path or specified with an `-L` flag.][64882]
3692
3693 \* Refer to Rust's [platform support page][platform-support-doc] for more
3694 information on Rust's tiered platform support.
3695
3696 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
3697
3698 Libraries
3699 ---------
3700
3701 - [The `core::panic` module is now stable.][66771] It was already stable
3702   through `std`.
3703 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
3704   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
3705 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
3706
3707 Stabilized APIs
3708 ---------------
3709
3710 - [`Result::map_or`]
3711 - [`Result::map_or_else`]
3712 - [`std::rc::Weak::weak_count`]
3713 - [`std::rc::Weak::strong_count`]
3714 - [`std::sync::Weak::weak_count`]
3715 - [`std::sync::Weak::strong_count`]
3716
3717 Cargo
3718 -----
3719
3720 - [Cargo will now document all the private items for binary crates
3721   by default.][cargo/7593]
3722 - [`cargo-install` will now reinstall the package if it detects that it is out
3723   of date.][cargo/7560]
3724 - [Cargo.lock now uses a more git friendly format that should help to reduce
3725   merge conflicts.][cargo/7579]
3726 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
3727   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
3728   optimisation level to `2` for debug builds. You can also use
3729   `[profile.<profile>.build-override]` to override build scripts and
3730   their dependencies.
3731
3732 Misc
3733 ----
3734
3735 - [You can now specify `edition` in documentation code blocks to compile the block
3736   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
3737   should be compiled the 2018 edition of Rust.
3738 - [You can now provide custom themes to rustdoc with `--theme`, and check the
3739   current theme with `--check-theme`.][54733]
3740 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
3741
3742 Compatibility Notes
3743 -------------------
3744
3745 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
3746   Apple targets.][apple-32bit-drop] This means that the source code is still
3747   available to build, but the targets are no longer being tested and release
3748   binaries for those platforms will no longer be distributed by the Rust project.
3749   Please refer to the linked blog post for more information.
3750
3751 [54733]: https://github.com/rust-lang/rust/pull/54733/
3752 [61351]: https://github.com/rust-lang/rust/pull/61351/
3753 [62514]: https://github.com/rust-lang/rust/pull/62514/
3754 [67255]: https://github.com/rust-lang/rust/pull/67255/
3755 [66661]: https://github.com/rust-lang/rust/pull/66661/
3756 [66771]: https://github.com/rust-lang/rust/pull/66771/
3757 [66847]: https://github.com/rust-lang/rust/pull/66847/
3758 [66238]: https://github.com/rust-lang/rust/pull/66238/
3759 [66277]: https://github.com/rust-lang/rust/pull/66277/
3760 [66325]: https://github.com/rust-lang/rust/pull/66325/
3761 [66172]: https://github.com/rust-lang/rust/pull/66172/
3762 [66183]: https://github.com/rust-lang/rust/pull/66183/
3763 [65879]: https://github.com/rust-lang/rust/pull/65879/
3764 [65013]: https://github.com/rust-lang/rust/pull/65013/
3765 [64882]: https://github.com/rust-lang/rust/pull/64882/
3766 [64325]: https://github.com/rust-lang/rust/pull/64325/
3767 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
3768 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
3769 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
3770 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
3771 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
3772 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
3773 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
3774 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
3775 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
3776 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
3777 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
3778
3779 Version 1.40.0 (2019-12-19)
3780 ===========================
3781
3782 Language
3783 --------
3784 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
3785   `const` contexts.][65188] e.g.
3786
3787   ```rust
3788   pub struct Point(i32, i32);
3789
3790   const ORIGIN: Point = {
3791       let constructor = Point;
3792
3793       constructor(0, 0)
3794   };
3795   ```
3796
3797 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
3798   indicate that there may be variants or fields added in the future.][64639]
3799   For example this requires adding a wild-card branch (`_ => {}`) to any match
3800   statements on a non-exhaustive `enum`. [(RFC 2008)]
3801 - [You can now use function-like procedural macros in `extern` blocks and in
3802   type positions.][63931] e.g. `type Generated = macro!();`
3803 - [Function-like and attribute procedural macros can now emit
3804   `macro_rules!` items, so you can now have your macros generate macros.][64035]
3805 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
3806   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
3807   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
3808
3809 Compiler
3810 --------
3811 - [Added tier 3 support\* for the
3812   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
3813 - [Added tier 3 support for the
3814   `aarch64-unknown-none-softfloat` target.][64589]
3815 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
3816   `mips64el-unknown-linux-muslabi64` targets.][65843]
3817
3818 \* Refer to Rust's [platform support page][platform-support-doc] for more
3819   information on Rust's tiered platform support.
3820
3821 Libraries
3822 ---------
3823 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
3824
3825 Stabilized APIs
3826 ---------------
3827 - [`BTreeMap::get_key_value`]
3828 - [`HashMap::get_key_value`]
3829 - [`Option::as_deref_mut`]
3830 - [`Option::as_deref`]
3831 - [`Option::flatten`]
3832 - [`UdpSocket::peer_addr`]
3833 - [`f32::to_be_bytes`]
3834 - [`f32::to_le_bytes`]
3835 - [`f32::to_ne_bytes`]
3836 - [`f64::to_be_bytes`]
3837 - [`f64::to_le_bytes`]
3838 - [`f64::to_ne_bytes`]
3839 - [`f32::from_be_bytes`]
3840 - [`f32::from_le_bytes`]
3841 - [`f32::from_ne_bytes`]
3842 - [`f64::from_be_bytes`]
3843 - [`f64::from_le_bytes`]
3844 - [`f64::from_ne_bytes`]
3845 - [`mem::take`]
3846 - [`slice::repeat`]
3847 - [`todo!`]
3848
3849 Cargo
3850 -----
3851 - [Cargo will now always display warnings, rather than only on
3852   fresh builds.][cargo/7450]
3853 - [Feature flags (except `--all-features`) passed to a virtual workspace will
3854   now produce an error.][cargo/7507] Previously these flags were ignored.
3855 - [You can now publish `dev-dependencies` without including
3856   a `version`.][cargo/7333]
3857
3858 Misc
3859 ----
3860 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
3861   when running documentation tests with `rustdoc`.][63803]
3862
3863 Compatibility Notes
3864 -------------------
3865 - [As previously announced, any previous NLL warnings in the 2015 edition are
3866   now hard errors.][64221]
3867 - [The `include!` macro will now warn if it failed to include the
3868   entire file.][64284] The `include!` macro unintentionally only includes the
3869   first _expression_ in a file, and this can be unintuitive. This will become
3870   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
3871 - [Using `#[inline]` on function prototypes and consts now emits a warning under
3872   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
3873   or `extern` blocks now correctly emits a hard error.
3874
3875 [65294]: https://github.com/rust-lang/rust/pull/65294/
3876 [66103]: https://github.com/rust-lang/rust/pull/66103/
3877 [65843]: https://github.com/rust-lang/rust/pull/65843/
3878 [65188]: https://github.com/rust-lang/rust/pull/65188/
3879 [65092]: https://github.com/rust-lang/rust/pull/65092/
3880 [64589]: https://github.com/rust-lang/rust/pull/64589/
3881 [64639]: https://github.com/rust-lang/rust/pull/64639/
3882 [64221]: https://github.com/rust-lang/rust/pull/64221/
3883 [64284]: https://github.com/rust-lang/rust/pull/64284/
3884 [63931]: https://github.com/rust-lang/rust/pull/63931/
3885 [64035]: https://github.com/rust-lang/rust/pull/64035/
3886 [63674]: https://github.com/rust-lang/rust/pull/63674/
3887 [63803]: https://github.com/rust-lang/rust/pull/63803/
3888 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
3889 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
3890 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
3891 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
3892 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
3893 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
3894 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
3895 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
3896 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
3897 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
3898 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
3899 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
3900 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
3901 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
3902 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
3903 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
3904 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
3905 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
3906 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
3907 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
3908 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
3909 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
3910 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
3911 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
3912 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
3913
3914
3915 Version 1.39.0 (2019-11-07)
3916 ===========================
3917
3918 Language
3919 --------
3920 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
3921   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
3922 - [You can now use certain attributes on function, closure, and function pointer
3923   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
3924   `deny`, `forbid` as well as inert helper attributes used by procedural macro
3925   attributes applied to items. e.g.
3926   ```rust
3927   fn len(
3928       #[cfg(windows)] slice: &[u16],
3929       #[cfg(not(windows))] slice: &[u8],
3930   ) -> usize {
3931       slice.len()
3932   }
3933   ```
3934 - [You can now take shared references to bind-by-move patterns in the `if` guards
3935   of `match` arms.][63118] e.g.
3936   ```rust
3937   fn main() {
3938       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
3939
3940       match array {
3941           nums
3942   //      ---- `nums` is bound by move.
3943               if nums.iter().sum::<u8>() == 10
3944   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
3945           => {
3946               drop(nums);
3947   //          ----------- Legal as `nums` was bound by move and so we have ownership.
3948           }
3949           _ => unreachable!(),
3950       }
3951   }
3952   ```
3953
3954
3955
3956 Compiler
3957 --------
3958 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
3959 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
3960 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
3961   **Note** Cargo currently doesn't use this feature. Refer to
3962   [cargo#7315][cargo/7315] to track this feature's progress.
3963 - [You can now pass `--show-output` argument to test binaries to print the
3964   output of successful tests.][62600]
3965
3966
3967 \* Refer to Rust's [platform support page][platform-support-doc] for more
3968 information on Rust's tiered platform support.
3969
3970 Libraries
3971 ---------
3972 - [`Vec::new` and `String::new` are now `const` functions.][64028]
3973 - [`LinkedList::new` is now a `const` function.][63684]
3974 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
3975 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
3976   now `const`.][63786]
3977
3978 Stabilized APIs
3979 ---------------
3980 - [`Pin::into_inner`]
3981 - [`Instant::checked_duration_since`]
3982 - [`Instant::saturating_duration_since`]
3983
3984 Cargo
3985 -----
3986 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
3987 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
3988   `--all` is now deprecated.
3989
3990 Misc
3991 ----
3992 - [You can now pass `-Clinker` to rustdoc to control the linker used
3993   for compiling doctests.][63834]
3994
3995 Compatibility Notes
3996 -------------------
3997 - [Code that was previously accepted by the old borrow checker, but rejected by
3998   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
3999   previously a warning, and will also become a hard error in the Rust 2015
4000   edition in the 1.40.0 release.
4001 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
4002   run tests.][63827] This should improve performance when running a large
4003   amount of doctests.
4004 - [The `try!` macro will now issue a deprecation warning.][62672] It is
4005   recommended to use the `?` operator instead.
4006 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
4007   returned `0.0`.
4008
4009 [62600]: https://github.com/rust-lang/rust/pull/62600/
4010 [62672]: https://github.com/rust-lang/rust/pull/62672/
4011 [63118]: https://github.com/rust-lang/rust/pull/63118/
4012 [63209]: https://github.com/rust-lang/rust/pull/63209/
4013 [63402]: https://github.com/rust-lang/rust/pull/63402/
4014 [63565]: https://github.com/rust-lang/rust/pull/63565/
4015 [63595]: https://github.com/rust-lang/rust/pull/63595/
4016 [63684]: https://github.com/rust-lang/rust/pull/63684/
4017 [63698]: https://github.com/rust-lang/rust/pull/63698/
4018 [63770]: https://github.com/rust-lang/rust/pull/63770/
4019 [63786]: https://github.com/rust-lang/rust/pull/63786/
4020 [63827]: https://github.com/rust-lang/rust/pull/63827/
4021 [63834]: https://github.com/rust-lang/rust/pull/63834/
4022 [64010]: https://github.com/rust-lang/rust/pull/64010/
4023 [64028]: https://github.com/rust-lang/rust/pull/64028/
4024 [64334]: https://github.com/rust-lang/rust/pull/64334/
4025 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
4026 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
4027 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
4028 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
4029 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
4030 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
4031
4032 Version 1.38.0 (2019-09-26)
4033 ==========================
4034
4035 Language
4036 --------
4037 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
4038 - [The `#[deprecated]` attribute can now be used on macros.][62042]
4039
4040 Compiler
4041 --------
4042 - [Added pipelined compilation support to `rustc`.][62766] This will
4043   improve compilation times in some cases. For further information please refer
4044   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
4045 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
4046   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
4047   `x86_64-uwp-windows-msvc` targets.][60260]
4048 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
4049   `armv7-unknown-linux-musleabi` targets.][63107]
4050 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
4051 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
4052 - [Upgraded to LLVM 9.][62592]
4053
4054 \* Refer to Rust's [platform support page][platform-support-doc] for more
4055 information on Rust's tiered platform support.
4056
4057 Libraries
4058 ---------
4059 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
4060 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
4061   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
4062   is available at `std::clone::Clone`). This also makes all built-in macros
4063   available in `std`/`core` root. e.g. `std::include_bytes!`.
4064 - [`str::Chars` now implements `Debug`.][63000]
4065 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
4066 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
4067 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
4068 - [Added euclidean remainder and division operations (`div_euclid`,
4069   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
4070   `overflowing`, and `wrapping` versions are available for all
4071   integer primitives.
4072 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
4073   `PartialEq`.][61491]
4074 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
4075
4076 Stabilized APIs
4077 ---------------
4078 - [`<*const T>::cast`]
4079 - [`<*mut T>::cast`]
4080 - [`Duration::as_secs_f32`]
4081 - [`Duration::as_secs_f64`]
4082 - [`Duration::div_f32`]
4083 - [`Duration::div_f64`]
4084 - [`Duration::from_secs_f32`]
4085 - [`Duration::from_secs_f64`]
4086 - [`Duration::mul_f32`]
4087 - [`Duration::mul_f64`]
4088 - [`any::type_name`]
4089
4090 Cargo
4091 -----
4092 - [Added pipelined compilation support to `cargo`.][cargo/7143]
4093 - [You can now pass the `--features` option multiple times to enable
4094   multiple features.][cargo/7084]
4095
4096 Rustdoc
4097 -------
4098
4099 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
4100
4101 Misc
4102 ----
4103 - [`rustc` will now warn about some incorrect uses of
4104   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
4105
4106 Compatibility Notes
4107 -------------------
4108 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
4109   1.38.0.
4110 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
4111   issues][62896] with certain crates such as libc.
4112
4113 [60260]: https://github.com/rust-lang/rust/pull/60260/
4114 [61457]: https://github.com/rust-lang/rust/pull/61457/
4115 [61491]: https://github.com/rust-lang/rust/pull/61491/
4116 [61884]: https://github.com/rust-lang/rust/pull/61884/
4117 [61953]: https://github.com/rust-lang/rust/pull/61953/
4118 [62042]: https://github.com/rust-lang/rust/pull/62042/
4119 [62528]: https://github.com/rust-lang/rust/pull/62528/
4120 [62583]: https://github.com/rust-lang/rust/pull/62583/
4121 [62735]: https://github.com/rust-lang/rust/pull/62735/
4122 [62766]: https://github.com/rust-lang/rust/pull/62766/
4123 [62784]: https://github.com/rust-lang/rust/pull/62784/
4124 [62592]: https://github.com/rust-lang/rust/pull/62592/
4125 [62785]: https://github.com/rust-lang/rust/issues/62785/
4126 [62814]: https://github.com/rust-lang/rust/pull/62814/
4127 [62896]: https://github.com/rust-lang/rust/issues/62896/
4128 [63000]: https://github.com/rust-lang/rust/pull/63000/
4129 [63056]: https://github.com/rust-lang/rust/pull/63056/
4130 [63107]: https://github.com/rust-lang/rust/pull/63107/
4131 [63346]: https://github.com/rust-lang/rust/pull/63346/
4132 [63421]: https://github.com/rust-lang/rust/pull/63421/
4133 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
4134 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
4135 [63048]: https://github.com/rust-lang/rust/pull/63048
4136 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
4137 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
4138 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
4139 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
4140 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
4141 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
4142 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
4143 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
4144 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
4145 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
4146 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
4147 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
4148 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
4149
4150 Version 1.37.0 (2019-08-15)
4151 ==========================
4152
4153 Language
4154 --------
4155 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
4156   [`Box`][62228], or an [array][62235] and unused.
4157 - [You can now use the `cfg` and `cfg_attr` attributes on
4158   generic parameters.][61547]
4159 - [You can now use enum variants through type alias.][61682] e.g. You can
4160   write the following:
4161   ```rust
4162   type MyOption = Option<u8>;
4163
4164   fn increment_or_zero(x: MyOption) -> u8 {
4165       match x {
4166           MyOption::Some(y) => y + 1,
4167           MyOption::None => 0,
4168       }
4169   }
4170   ```
4171 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
4172   `const _: u32 = 5;`.
4173 - [You can now use `#[repr(align(X)]` on enums.][61229]
4174 - [The  `?` Kleene macro operator is now available in the
4175   2015 edition.][60932]
4176
4177 Compiler
4178 --------
4179 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
4180   and `-C profile-use` flags.][61268] For more information on how to use profile
4181   guided optimization, please refer to the [rustc book][rustc-book-pgo].
4182 - [The `rust-lldb` wrapper script should now work again.][61827]
4183
4184 Libraries
4185 ---------
4186 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
4187
4188 Stabilized APIs
4189 ---------------
4190 - [`BufReader::buffer`]
4191 - [`BufWriter::buffer`]
4192 - [`Cell::from_mut`]
4193 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
4194 - [`DoubleEndedIterator::nth_back`]
4195 - [`Option::xor`]
4196 - [`Wrapping::reverse_bits`]
4197 - [`i128::reverse_bits`]
4198 - [`i16::reverse_bits`]
4199 - [`i32::reverse_bits`]
4200 - [`i64::reverse_bits`]
4201 - [`i8::reverse_bits`]
4202 - [`isize::reverse_bits`]
4203 - [`slice::copy_within`]
4204 - [`u128::reverse_bits`]
4205 - [`u16::reverse_bits`]
4206 - [`u32::reverse_bits`]
4207 - [`u64::reverse_bits`]
4208 - [`u8::reverse_bits`]
4209 - [`usize::reverse_bits`]
4210
4211 Cargo
4212 -----
4213 - [`Cargo.lock` files are now included by default when publishing executable crates
4214   with executables.][cargo/7026]
4215 - [You can now specify `default-run="foo"` in `[package]` to specify the
4216   default executable to use for `cargo run`.][cargo/7056]
4217
4218 Misc
4219 ----
4220
4221 Compatibility Notes
4222 -------------------
4223 - [Using `...` for inclusive range patterns will now warn by default.][61342]
4224   Please transition your code to using the `..=` syntax for inclusive
4225   ranges instead.
4226 - [Using a trait object without the `dyn` will now warn by default.][61203]
4227   Please transition your code to use `dyn Trait` for trait objects instead.
4228
4229 [62228]: https://github.com/rust-lang/rust/pull/62228/
4230 [62235]: https://github.com/rust-lang/rust/pull/62235/
4231 [61802]: https://github.com/rust-lang/rust/pull/61802/
4232 [61827]: https://github.com/rust-lang/rust/pull/61827/
4233 [61547]: https://github.com/rust-lang/rust/pull/61547/
4234 [61682]: https://github.com/rust-lang/rust/pull/61682/
4235 [61268]: https://github.com/rust-lang/rust/pull/61268/
4236 [61342]: https://github.com/rust-lang/rust/pull/61342/
4237 [61347]: https://github.com/rust-lang/rust/pull/61347/
4238 [61100]: https://github.com/rust-lang/rust/pull/61100/
4239 [61203]: https://github.com/rust-lang/rust/pull/61203/
4240 [61229]: https://github.com/rust-lang/rust/pull/61229/
4241 [60932]: https://github.com/rust-lang/rust/pull/60932/
4242 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
4243 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
4244 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
4245 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
4246 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
4247 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
4248 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
4249 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
4250 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
4251 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
4252 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
4253 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
4254 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
4255 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
4256 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
4257 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
4258 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
4259 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
4260 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
4261 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
4262 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
4263 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
4264 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
4265
4266
4267 Version 1.36.0 (2019-07-04)
4268 ==========================
4269
4270 Language
4271 --------
4272 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
4273 - [The order of traits in trait objects no longer affects the semantics of that
4274   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
4275   `dyn fmt::Debug + Send`, where this was previously not the case.
4276
4277 Libraries
4278 ---------
4279 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
4280 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
4281 - [`mem::needs_drop` is now available as a const fn.][60364]
4282 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
4283 - [`String` now implements `BorrowMut<str>`.][60404]
4284 - [`io::Cursor` now implements `Default`.][60234]
4285 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
4286 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
4287   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
4288   environment has access to heap memory allocation.
4289 - [`String` now implements `From<&String>`.][59825]
4290 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
4291   return a tuple of each argument when there is multiple arguments.
4292 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
4293   not used.][59648]
4294
4295 Stabilized APIs
4296 ---------------
4297 - [`VecDeque::rotate_left`]
4298 - [`VecDeque::rotate_right`]
4299 - [`Iterator::copied`]
4300 - [`io::IoSlice`]
4301 - [`io::IoSliceMut`]
4302 - [`Read::read_vectored`]
4303 - [`Write::write_vectored`]
4304 - [`str::as_mut_ptr`]
4305 - [`mem::MaybeUninit`]
4306 - [`pointer::align_offset`]
4307 - [`future::Future`]
4308 - [`task::Context`]
4309 - [`task::RawWaker`]
4310 - [`task::RawWakerVTable`]
4311 - [`task::Waker`]
4312 - [`task::Poll`]
4313
4314 Cargo
4315 -----
4316 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
4317 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
4318
4319 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
4320
4321 Clippy
4322 ------
4323 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
4324
4325 Misc
4326 ----
4327
4328 Compatibility Notes
4329 -------------------
4330 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
4331   longer recommended, and will be deprecated in 1.39.0.
4332
4333 [60318]: https://github.com/rust-lang/rust/pull/60318/
4334 [60364]: https://github.com/rust-lang/rust/pull/60364/
4335 [60370]: https://github.com/rust-lang/rust/pull/60370/
4336 [60404]: https://github.com/rust-lang/rust/pull/60404/
4337 [60234]: https://github.com/rust-lang/rust/pull/60234/
4338 [60244]: https://github.com/rust-lang/rust/pull/60244/
4339 [58623]: https://github.com/rust-lang/rust/pull/58623/
4340 [59648]: https://github.com/rust-lang/rust/pull/59648/
4341 [59675]: https://github.com/rust-lang/rust/pull/59675/
4342 [59825]: https://github.com/rust-lang/rust/pull/59825/
4343 [59826]: https://github.com/rust-lang/rust/pull/59826/
4344 [59445]: https://github.com/rust-lang/rust/pull/59445/
4345 [59114]: https://github.com/rust-lang/rust/pull/59114/
4346 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
4347 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
4348 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
4349 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
4350 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
4351 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
4352 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
4353 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
4354 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
4355 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
4356 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
4357 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
4358 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
4359 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
4360 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
4361 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
4362 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
4363 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
4364 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
4365 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
4366
4367
4368 Version 1.35.0 (2019-05-23)
4369 ==========================
4370
4371 Language
4372 --------
4373 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
4374   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
4375 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
4376   ```rust
4377   unsafe fn call_unsafe(func: unsafe fn()) {
4378       func()
4379   }
4380
4381   pub fn main() {
4382       unsafe { call_unsafe(|| {}); }
4383   }
4384   ```
4385
4386
4387 Compiler
4388 --------
4389 - [Added the `armv6-unknown-freebsd-gnueabihf` and
4390   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
4391 - [Added the `wasm32-unknown-wasi` target.][59464]
4392
4393
4394 Libraries
4395 ---------
4396 - [`Thread` will now show its ID in `Debug` output.][59460]
4397 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
4398 - [`alloc::System` now implements `Default`.][59451]
4399 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
4400   last field.][59076]
4401 - [`char::{ToLowercase, ToUppercase}` now
4402   implement `ExactSizeIterator`.][58778]
4403 - [All `NonZero` numeric types now implement `FromStr`.][58717]
4404 - [Removed the `Read` trait bounds
4405   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
4406 - [You can now call the `dbg!` macro without any parameters to print the file
4407   and line where it is called.][57847]
4408 - [In place ASCII case conversions are now up to 4× faster.][59283]
4409   e.g. `str::make_ascii_lowercase`
4410 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
4411   and `Send`.][58369]
4412
4413 Stabilized APIs
4414 ---------------
4415 - [`f32::copysign`]
4416 - [`f64::copysign`]
4417 - [`RefCell::replace_with`]
4418 - [`RefCell::map_split`]
4419 - [`ptr::hash`]
4420 - [`Range::contains`]
4421 - [`RangeFrom::contains`]
4422 - [`RangeTo::contains`]
4423 - [`RangeInclusive::contains`]
4424 - [`RangeToInclusive::contains`]
4425 - [`Option::copied`]
4426
4427 Cargo
4428 -----
4429 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
4430   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
4431   platform specific.
4432
4433 Misc
4434 ----
4435 - [The Rust toolchain is now available natively for musl based distros.][58575]
4436
4437 [59460]: https://github.com/rust-lang/rust/pull/59460/
4438 [59464]: https://github.com/rust-lang/rust/pull/59464/
4439 [59500]: https://github.com/rust-lang/rust/pull/59500/
4440 [59512]: https://github.com/rust-lang/rust/pull/59512/
4441 [59580]: https://github.com/rust-lang/rust/pull/59580/
4442 [59283]: https://github.com/rust-lang/rust/pull/59283/
4443 [59451]: https://github.com/rust-lang/rust/pull/59451/
4444 [59076]: https://github.com/rust-lang/rust/pull/59076/
4445 [58778]: https://github.com/rust-lang/rust/pull/58778/
4446 [58717]: https://github.com/rust-lang/rust/pull/58717/
4447 [58369]: https://github.com/rust-lang/rust/pull/58369/
4448 [58423]: https://github.com/rust-lang/rust/pull/58423/
4449 [58080]: https://github.com/rust-lang/rust/pull/58080/
4450 [57847]: https://github.com/rust-lang/rust/pull/57847/
4451 [58575]: https://github.com/rust-lang/rust/pull/58575
4452 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
4453 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
4454 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
4455 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
4456 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
4457 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
4458 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
4459 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
4460 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
4461 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
4462 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
4463 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
4464
4465 Version 1.34.2 (2019-05-14)
4466 ===========================
4467
4468 * [Destabilize the `Error::type_id` function due to a security
4469    vulnerability][60785] ([CVE-2019-12083])
4470
4471 [60785]: https://github.com/rust-lang/rust/pull/60785
4472 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
4473
4474 Version 1.34.1 (2019-04-25)
4475 ===========================
4476
4477 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
4478 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
4479 * [Fix Clippy panic when checking some macros][clippy/3805]
4480
4481 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
4482 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
4483 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
4484
4485 Version 1.34.0 (2019-04-11)
4486 ==========================
4487
4488 Language
4489 --------
4490 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
4491   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
4492   but had no effect.
4493 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
4494   `#[attr{}]` procedural macros.][57367]
4495 - [You can now write `extern crate self as foo;`][57407] to import your
4496   crate's root into the extern prelude.
4497
4498
4499 Compiler
4500 --------
4501 - [You can now target `riscv64imac-unknown-none-elf` and
4502   `riscv64gc-unknown-none-elf`.][58406]
4503 - [You can now enable linker plugin LTO optimisations with
4504   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
4505   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
4506   boundaries.
4507 - [You can now target `powerpc64-unknown-freebsd`.][57809]
4508
4509
4510 Libraries
4511 ---------
4512 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
4513   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
4514   the `Hash` trait to create an iterator.
4515 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
4516   methods.][58421] Most notably you no longer require the `Ord` trait to create
4517   an iterator.
4518 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
4519   for all numeric types.][58044]
4520 - [Indexing a `str` is now generic over all types that
4521   implement `SliceIndex<str>`.][57604]
4522 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
4523   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
4524   produce a warning if their returning type is unused.
4525 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
4526   `overflowing_pow` are now available for all numeric types.][57873] These are
4527   equivalent to methods such as `wrapping_add` for the `pow` operation.
4528
4529
4530 Stabilized APIs
4531 ---------------
4532
4533 #### std & core
4534 * [`Any::type_id`]
4535 * [`Error::type_id`]
4536 * [`atomic::AtomicI16`]
4537 * [`atomic::AtomicI32`]
4538 * [`atomic::AtomicI64`]
4539 * [`atomic::AtomicI8`]
4540 * [`atomic::AtomicU16`]
4541 * [`atomic::AtomicU32`]
4542 * [`atomic::AtomicU64`]
4543 * [`atomic::AtomicU8`]
4544 * [`convert::Infallible`]
4545 * [`convert::TryFrom`]
4546 * [`convert::TryInto`]
4547 * [`iter::from_fn`]
4548 * [`iter::successors`]
4549 * [`num::NonZeroI128`]
4550 * [`num::NonZeroI16`]
4551 * [`num::NonZeroI32`]
4552 * [`num::NonZeroI64`]
4553 * [`num::NonZeroI8`]
4554 * [`num::NonZeroIsize`]
4555 * [`slice::sort_by_cached_key`]
4556 * [`str::escape_debug`]
4557 * [`str::escape_default`]
4558 * [`str::escape_unicode`]
4559 * [`str::split_ascii_whitespace`]
4560
4561 #### std
4562 * [`Instant::checked_add`]
4563 * [`Instant::checked_sub`]
4564 * [`SystemTime::checked_add`]
4565 * [`SystemTime::checked_sub`]
4566
4567 Cargo
4568 -----
4569 - [You can now use alternative registries to crates.io.][cargo/6654]
4570
4571 Misc
4572 ----
4573 - [You can now use the `?` operator in your documentation tests without manually
4574   adding `fn main() -> Result<(), _> {}`.][56470]
4575
4576 Compatibility Notes
4577 -------------------
4578 - [`Command::before_exec` is being replaced by the unsafe method
4579   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
4580 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
4581   can now use `const` functions in `static` variables.
4582
4583 [58370]: https://github.com/rust-lang/rust/pull/58370/
4584 [58406]: https://github.com/rust-lang/rust/pull/58406/
4585 [58421]: https://github.com/rust-lang/rust/pull/58421/
4586 [58166]: https://github.com/rust-lang/rust/pull/58166/
4587 [58044]: https://github.com/rust-lang/rust/pull/58044/
4588 [58057]: https://github.com/rust-lang/rust/pull/58057/
4589 [58059]: https://github.com/rust-lang/rust/pull/58059/
4590 [57809]: https://github.com/rust-lang/rust/pull/57809/
4591 [57873]: https://github.com/rust-lang/rust/pull/57873/
4592 [57604]: https://github.com/rust-lang/rust/pull/57604/
4593 [57367]: https://github.com/rust-lang/rust/pull/57367/
4594 [57407]: https://github.com/rust-lang/rust/pull/57407/
4595 [57425]: https://github.com/rust-lang/rust/pull/57425/
4596 [57106]: https://github.com/rust-lang/rust/pull/57106/
4597 [56470]: https://github.com/rust-lang/rust/pull/56470/
4598 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
4599 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
4600 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
4601 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
4602 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
4603 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
4604 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
4605 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
4606 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
4607 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
4608 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
4609 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
4610 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
4611 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
4612 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
4613 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
4614 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
4615 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
4616 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
4617 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
4618 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
4619 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
4620 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
4621 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
4622 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
4623 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
4624 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
4625 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
4626 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
4627 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
4628 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
4629
4630
4631 Version 1.33.0 (2019-02-28)
4632 ==========================
4633
4634 Language
4635 --------
4636 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
4637   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
4638 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
4639   E.g. You can have match statement on a `u8` that covers `0..=255` and
4640   you would no longer be required to have a `_ => unreachable!()` case.
4641 - [You can now have multiple patterns in `if let` and `while let`
4642   expressions.][57532] You can do this with the same syntax as a `match`
4643   expression. E.g.
4644   ```rust
4645   enum Creature {
4646       Crab(String),
4647       Lobster(String),
4648       Person(String),
4649   }
4650
4651   fn main() {
4652       let state = Creature::Crab("Ferris");
4653
4654       if let Creature::Crab(name) | Creature::Person(name) = state {
4655           println!("This creature's name is: {}", name);
4656       }
4657   }
4658   ```
4659 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
4660   this feature will by default produce a warning as this behaviour can be
4661   unintuitive. E.g. `if let _ = 5 {}`
4662 - [You can now use `let` bindings, assignments, expression statements,
4663   and irrefutable pattern destructuring in const functions.][57175]
4664 - [You can now call unsafe const functions.][57067] E.g.
4665   ```rust
4666   const unsafe fn foo() -> i32 { 5 }
4667   const fn bar() -> i32 {
4668       unsafe { foo() }
4669   }
4670   ```
4671 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
4672   E.g. `#[cfg_attr(all(), must_use, optimize)]`
4673 - [You can now specify a specific alignment with the `#[repr(packed)]`
4674   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
4675   with an alignment of 2 bytes and a size of 6 bytes.
4676 - [You can now import an item from a module as an `_`.][56303] This allows you to
4677   import a trait's impls, and not have the name in the namespace. E.g.
4678   ```rust
4679   use std::io::Read as _;
4680
4681   // Allowed as there is only one `Read` in the module.
4682   pub trait Read {}
4683   ```
4684 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
4685
4686 Compiler
4687 --------
4688 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
4689   command line argument.][56351]
4690 - [The minimum required LLVM version has been bumped to 6.0.][56642]
4691 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
4692 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
4693   tier 2 support.][57130] Visit the [platform support][platform-support] page for
4694   information on Rust's platform support.
4695 - [Added support for the `thumbv7neon-linux-androideabi` and
4696   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
4697 - [Added support for the `x86_64-unknown-uefi` target.][56769]
4698
4699 Libraries
4700 ---------
4701 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
4702   functions for all numeric types.][57566]
4703 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
4704   are now `const` functions for all numeric types.][57105]
4705 - [The methods `is_positive` and `is_negative` are now `const` functions for
4706   all signed numeric types.][57105]
4707 - [The `get` method for all `NonZero` types is now `const`.][57167]
4708 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
4709   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
4710   numeric types.][57234]
4711 - [`Ipv4Addr::new` is now a `const` function][57234]
4712
4713 Stabilized APIs
4714 ---------------
4715 - [`unix::FileExt::read_exact_at`]
4716 - [`unix::FileExt::write_all_at`]
4717 - [`Option::transpose`]
4718 - [`Result::transpose`]
4719 - [`convert::identity`]
4720 - [`pin::Pin`]
4721 - [`marker::Unpin`]
4722 - [`marker::PhantomPinned`]
4723 - [`Vec::resize_with`]
4724 - [`VecDeque::resize_with`]
4725 - [`Duration::as_millis`]
4726 - [`Duration::as_micros`]
4727 - [`Duration::as_nanos`]
4728
4729
4730 Cargo
4731 -----
4732 - [You can now publish crates that require a feature flag to compile with
4733   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
4734 - [Cargo should now rebuild a crate if a file was modified during the initial
4735   build.][cargo/6484]
4736
4737 Compatibility Notes
4738 -------------------
4739 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
4740   are now deprecated in the standard library, and their usage will now produce a warning.
4741   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
4742   methods instead.
4743 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
4744   downcasting.
4745 - [Libtest no longer creates a new thread for each test when
4746   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
4747
4748 [56243]: https://github.com/rust-lang/rust/pull/56243
4749 [56303]: https://github.com/rust-lang/rust/pull/56303/
4750 [56351]: https://github.com/rust-lang/rust/pull/56351/
4751 [56362]: https://github.com/rust-lang/rust/pull/56362
4752 [56642]: https://github.com/rust-lang/rust/pull/56642/
4753 [56769]: https://github.com/rust-lang/rust/pull/56769/
4754 [56805]: https://github.com/rust-lang/rust/pull/56805
4755 [56947]: https://github.com/rust-lang/rust/pull/56947/
4756 [57049]: https://github.com/rust-lang/rust/pull/57049/
4757 [57067]: https://github.com/rust-lang/rust/pull/57067/
4758 [57105]: https://github.com/rust-lang/rust/pull/57105
4759 [57130]: https://github.com/rust-lang/rust/pull/57130/
4760 [57167]: https://github.com/rust-lang/rust/pull/57167/
4761 [57175]: https://github.com/rust-lang/rust/pull/57175/
4762 [57234]: https://github.com/rust-lang/rust/pull/57234/
4763 [57332]: https://github.com/rust-lang/rust/pull/57332/
4764 [57465]: https://github.com/rust-lang/rust/pull/57465/
4765 [57532]: https://github.com/rust-lang/rust/pull/57532/
4766 [57535]: https://github.com/rust-lang/rust/pull/57535/
4767 [57566]: https://github.com/rust-lang/rust/pull/57566/
4768 [57615]: https://github.com/rust-lang/rust/pull/57615/
4769 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
4770 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
4771 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
4772 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
4773 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
4774 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
4775 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
4776 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
4777 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
4778 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
4779 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
4780 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
4781 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
4782 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
4783 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
4784 [platform-support]: https://forge.rust-lang.org/platform-support.html
4785
4786 Version 1.32.0 (2019-01-17)
4787 ==========================
4788
4789 Language
4790 --------
4791 #### 2018 edition
4792 - [You can now use the `?` operator in macro definitions.][56245] The `?`
4793   operator allows you to specify zero or one repetitions similar to the `*` and
4794   `+` operators.
4795 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
4796   now always resolve to the item (`enum`, `struct`, etc.) available in the
4797   module if present, before resolving to a external crate or an item the prelude.][56759]
4798   E.g.
4799   ```rust
4800   enum Color { Red, Green, Blue }
4801
4802   use Color::*;
4803   ```
4804
4805 #### All editions
4806 - [You can now match against `PhantomData<T>` types.][55837]
4807 - [You can now match against literals in macros with the `literal`
4808   specifier.][56072] This will match against a literal of any type.
4809   E.g. `1`, `'A'`, `"Hello World"`
4810 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
4811   ```rust
4812   struct Point(i32, i32);
4813
4814   impl Point {
4815       pub fn new(x: i32, y: i32) -> Self {
4816           Self(x, y)
4817       }
4818
4819       pub fn is_origin(&self) -> bool {
4820           match self {
4821               Self(0, 0) => true,
4822               _ => false,
4823           }
4824       }
4825   }
4826   ```
4827 - [Self can also now be used in type definitions.][56366] E.g.
4828   ```rust
4829   enum List<T>
4830   where
4831       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
4832   {
4833       Nil,
4834       Cons(T, Box<Self>) // likewise here
4835   }
4836   ```
4837 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
4838   a `impl Trait` or `dyn Trait` is returned and unused in the program.
4839
4840 Compiler
4841 --------
4842 - [The default allocator has changed from jemalloc to the default allocator on
4843   your system.][55238] The compiler itself on Linux & macOS will still use
4844   jemalloc, but programs compiled with it will use the system allocator.
4845 - [Added the `aarch64-pc-windows-msvc` target.][55702]
4846
4847 Libraries
4848 ---------
4849 - [`PathBuf` now implements `FromStr`.][55148]
4850 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
4851 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
4852   easily debug expressions in your rust program. E.g.
4853   ```rust
4854   let a = 2;
4855   let b = dbg!(a * 2) + 1;
4856   //      ^-- prints: [src/main.rs:4] a * 2 = 4
4857   assert_eq!(b, 5);
4858   ```
4859
4860 The following APIs are now `const` functions and can be used in a
4861 `const` context.
4862
4863 - [`Cell::as_ptr`]
4864 - [`UnsafeCell::get`]
4865 - [`char::is_ascii`]
4866 - [`iter::empty`]
4867 - [`ManuallyDrop::new`]
4868 - [`ManuallyDrop::into_inner`]
4869 - [`RangeInclusive::start`]
4870 - [`RangeInclusive::end`]
4871 - [`NonNull::as_ptr`]
4872 - [`slice::as_ptr`]
4873 - [`str::as_ptr`]
4874 - [`Duration::as_secs`]
4875 - [`Duration::subsec_millis`]
4876 - [`Duration::subsec_micros`]
4877 - [`Duration::subsec_nanos`]
4878 - [`CStr::as_ptr`]
4879 - [`Ipv4Addr::is_unspecified`]
4880 - [`Ipv6Addr::new`]
4881 - [`Ipv6Addr::octets`]
4882
4883 Stabilized APIs
4884 ---------------
4885 - [`i8::to_be_bytes`]
4886 - [`i8::to_le_bytes`]
4887 - [`i8::to_ne_bytes`]
4888 - [`i8::from_be_bytes`]
4889 - [`i8::from_le_bytes`]
4890 - [`i8::from_ne_bytes`]
4891 - [`i16::to_be_bytes`]
4892 - [`i16::to_le_bytes`]
4893 - [`i16::to_ne_bytes`]
4894 - [`i16::from_be_bytes`]
4895 - [`i16::from_le_bytes`]
4896 - [`i16::from_ne_bytes`]
4897 - [`i32::to_be_bytes`]
4898 - [`i32::to_le_bytes`]
4899 - [`i32::to_ne_bytes`]
4900 - [`i32::from_be_bytes`]
4901 - [`i32::from_le_bytes`]
4902 - [`i32::from_ne_bytes`]
4903 - [`i64::to_be_bytes`]
4904 - [`i64::to_le_bytes`]
4905 - [`i64::to_ne_bytes`]
4906 - [`i64::from_be_bytes`]
4907 - [`i64::from_le_bytes`]
4908 - [`i64::from_ne_bytes`]
4909 - [`i128::to_be_bytes`]
4910 - [`i128::to_le_bytes`]
4911 - [`i128::to_ne_bytes`]
4912 - [`i128::from_be_bytes`]
4913 - [`i128::from_le_bytes`]
4914 - [`i128::from_ne_bytes`]
4915 - [`isize::to_be_bytes`]
4916 - [`isize::to_le_bytes`]
4917 - [`isize::to_ne_bytes`]
4918 - [`isize::from_be_bytes`]
4919 - [`isize::from_le_bytes`]
4920 - [`isize::from_ne_bytes`]
4921 - [`u8::to_be_bytes`]
4922 - [`u8::to_le_bytes`]
4923 - [`u8::to_ne_bytes`]
4924 - [`u8::from_be_bytes`]
4925 - [`u8::from_le_bytes`]
4926 - [`u8::from_ne_bytes`]
4927 - [`u16::to_be_bytes`]
4928 - [`u16::to_le_bytes`]
4929 - [`u16::to_ne_bytes`]
4930 - [`u16::from_be_bytes`]
4931 - [`u16::from_le_bytes`]
4932 - [`u16::from_ne_bytes`]
4933 - [`u32::to_be_bytes`]
4934 - [`u32::to_le_bytes`]
4935 - [`u32::to_ne_bytes`]
4936 - [`u32::from_be_bytes`]
4937 - [`u32::from_le_bytes`]
4938 - [`u32::from_ne_bytes`]
4939 - [`u64::to_be_bytes`]
4940 - [`u64::to_le_bytes`]
4941 - [`u64::to_ne_bytes`]
4942 - [`u64::from_be_bytes`]
4943 - [`u64::from_le_bytes`]
4944 - [`u64::from_ne_bytes`]
4945 - [`u128::to_be_bytes`]
4946 - [`u128::to_le_bytes`]
4947 - [`u128::to_ne_bytes`]
4948 - [`u128::from_be_bytes`]
4949 - [`u128::from_le_bytes`]
4950 - [`u128::from_ne_bytes`]
4951 - [`usize::to_be_bytes`]
4952 - [`usize::to_le_bytes`]
4953 - [`usize::to_ne_bytes`]
4954 - [`usize::from_be_bytes`]
4955 - [`usize::from_le_bytes`]
4956 - [`usize::from_ne_bytes`]
4957
4958 Cargo
4959 -----
4960 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
4961 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
4962
4963 Misc
4964 ----
4965 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
4966
4967 Compatibility Notes
4968 -------------------
4969 - [The argument types for AVX's
4970   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
4971   been changed from `*const` to `*mut` as the previous implementation
4972   was unsound.
4973
4974
4975 [55148]: https://github.com/rust-lang/rust/pull/55148/
4976 [55238]: https://github.com/rust-lang/rust/pull/55238/
4977 [55280]: https://github.com/rust-lang/rust/pull/55280/
4978 [55610]: https://github.com/rust-lang/rust/pull/55610/
4979 [55663]: https://github.com/rust-lang/rust/pull/55663/
4980 [55702]: https://github.com/rust-lang/rust/pull/55702/
4981 [55837]: https://github.com/rust-lang/rust/pull/55837/
4982 [55843]: https://github.com/rust-lang/rust/pull/55843/
4983 [56072]: https://github.com/rust-lang/rust/pull/56072/
4984 [56245]: https://github.com/rust-lang/rust/pull/56245/
4985 [56365]: https://github.com/rust-lang/rust/pull/56365/
4986 [56366]: https://github.com/rust-lang/rust/pull/56366/
4987 [56395]: https://github.com/rust-lang/rust/pull/56395/
4988 [56759]: https://github.com/rust-lang/rust/pull/56759/
4989 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
4990 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
4991 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
4992 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
4993 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
4994 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4995 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4996 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
4997 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
4998 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
4999 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
5000 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
5001 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
5002 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
5003 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
5004 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
5005 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
5006 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
5007 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
5008 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
5009 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
5010 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
5011 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
5012 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
5013 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
5014 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
5015 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
5016 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
5017 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
5018 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
5019 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
5020 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
5021 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
5022 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
5023 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
5024 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
5025 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
5026 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
5027 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
5028 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
5029 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
5030 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
5031 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
5032 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
5033 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
5034 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
5035 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
5036 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
5037 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
5038 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
5039 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
5040 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
5041 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
5042 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
5043 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
5044 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
5045 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
5046 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
5047 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
5048 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
5049 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
5050 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
5051 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
5052 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
5053 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
5054 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
5055 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
5056 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
5057 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
5058 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
5059 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
5060 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
5061 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
5062 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
5063 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
5064 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
5065 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
5066 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
5067 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
5068 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
5069 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
5070 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
5071 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
5072 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
5073 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
5074 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
5075 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
5076 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
5077 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
5078 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
5079 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
5080 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
5081 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
5082
5083
5084 Version 1.31.1 (2018-12-20)
5085 ===========================
5086
5087 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
5088 - [Fix broken go-to-definition in RLS][rls/1171]
5089 - [Fix infinite loop on hover in RLS][rls/1170]
5090
5091 [56562]: https://github.com/rust-lang/rust/pull/56562
5092 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
5093 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
5094
5095 Version 1.31.0 (2018-12-06)
5096 ==========================
5097
5098 Language
5099 --------
5100 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
5101 - [New lifetime elision rules now allow for eliding lifetimes in functions and
5102   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
5103   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
5104   in structs.
5105 - [You can now define and use `const` functions.][54835] These are currently
5106   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
5107   [language reference][const-reference] for what exactly is available.
5108 - [You can now use tool lints, which allow you to scope lints from external
5109   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
5110 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
5111   a crate, not just in exported functions.][54451]
5112 - [You can now use parentheses in pattern matches.][54497]
5113
5114 Compiler
5115 --------
5116 - [Updated musl to 1.1.20][54430]
5117
5118 Libraries
5119 ---------
5120 - [You can now convert `num::NonZero*` types to their raw equivalents using the
5121   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
5122 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
5123   into `Option<&mut T>` using the `From` trait.][53218]
5124 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
5125
5126
5127 Stabilized APIs
5128 ---------------
5129 - [`slice::align_to`]
5130 - [`slice::align_to_mut`]
5131 - [`slice::chunks_exact`]
5132 - [`slice::chunks_exact_mut`]
5133 - [`slice::rchunks`]
5134 - [`slice::rchunks_mut`]
5135 - [`slice::rchunks_exact`]
5136 - [`slice::rchunks_exact_mut`]
5137 - [`Option::replace`]
5138
5139 Cargo
5140 -----
5141 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
5142 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
5143   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
5144
5145 [52813]: https://github.com/rust-lang/rust/pull/52813/
5146 [53218]: https://github.com/rust-lang/rust/pull/53218/
5147 [54057]: https://github.com/rust-lang/rust/pull/54057/
5148 [54240]: https://github.com/rust-lang/rust/pull/54240/
5149 [54430]: https://github.com/rust-lang/rust/pull/54430/
5150 [54451]: https://github.com/rust-lang/rust/pull/54451/
5151 [54497]: https://github.com/rust-lang/rust/pull/54497/
5152 [54778]: https://github.com/rust-lang/rust/pull/54778/
5153 [54835]: https://github.com/rust-lang/rust/pull/54835/
5154 [54870]: https://github.com/rust-lang/rust/pull/54870/
5155 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
5156 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
5157 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
5158 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
5159 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
5160 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
5161 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
5162 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
5163 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
5164 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
5165 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
5166 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
5167 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
5168 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
5169
5170 Version 1.30.1 (2018-11-08)
5171 ===========================
5172
5173 - [Fixed overflow ICE in rustdoc][54199]
5174 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
5175
5176 [54199]: https://github.com/rust-lang/rust/pull/54199
5177 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
5178
5179 Version 1.30.0 (2018-10-25)
5180 ==========================
5181
5182 Language
5183 --------
5184 - [Procedural macros are now available.][52081] These kinds of macros allow for
5185   more powerful code generation. There is a [new chapter available][proc-macros]
5186   in the Rust Programming Language book that goes further in depth.
5187 - [You can now use keywords as identifiers using the raw identifiers
5188   syntax (`r#`),][53236] e.g. `let r#for = true;`
5189 - [Using anonymous parameters in traits is now deprecated with a warning and
5190   will be a hard error in the 2018 edition.][53272]
5191 - [You can now use `crate` in paths.][54404] This allows you to refer to the
5192   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
5193 - [Using a external crate no longer requires being prefixed with `::`.][54404]
5194   Previously, using a external crate in a module without a use statement
5195   required `let json = ::serde_json::from_str(foo);` but can now be written
5196   as `let json = serde_json::from_str(foo);`.
5197 - [You can now apply the `#[used]` attribute to static items to prevent the
5198   compiler from optimising them away, even if they appear to be unused,][51363]
5199   e.g. `#[used] static FOO: u32 = 1;`
5200 - [You can now import and reexport macros from other crates with the `use`
5201   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
5202   the root module of the crate. If your macro relies on calling other local
5203   macros, it is recommended to export with the
5204   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
5205   those macros.
5206 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
5207   using the `vis` specifier.][53370]
5208 - [Non-macro attributes now allow all forms of literals, not just
5209   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
5210   write `#[attr(true)]`.
5211 - [You can now specify a function to handle a panic in the Rust runtime with the
5212   `#[panic_handler]` attribute.][51366]
5213
5214 Compiler
5215 --------
5216 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
5217 - [Added the `aarch64-unknown-netbsd` target][53165]
5218 - [Upgraded to LLVM 8.][53611]
5219
5220 Libraries
5221 ---------
5222 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
5223
5224 Stabilized APIs
5225 ---------------
5226 - [`Ipv4Addr::BROADCAST`]
5227 - [`Ipv4Addr::LOCALHOST`]
5228 - [`Ipv4Addr::UNSPECIFIED`]
5229 - [`Ipv6Addr::LOCALHOST`]
5230 - [`Ipv6Addr::UNSPECIFIED`]
5231 - [`Iterator::find_map`]
5232
5233   The following methods are replacement methods for `trim_left`, `trim_right`,
5234   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
5235   in 1.33.0:
5236 - [`str::trim_end_matches`]
5237 - [`str::trim_end`]
5238 - [`str::trim_start_matches`]
5239 - [`str::trim_start`]
5240
5241 Cargo
5242 ----
5243 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
5244 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
5245   equivalent to calling `rustdoc --error-format=json`.
5246 - [Cargo will now provide a progress bar for builds.][cargo/5995]
5247
5248 Misc
5249 ----
5250 - [`rustdoc` allows you to specify what edition to treat your code as with the
5251   `--edition` option.][54057]
5252 - [`rustdoc` now has the `--color` (specify whether to output color) and
5253   `--error-format` (specify error format, e.g. `json`) options.][53003]
5254 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
5255   debug symbols.][53774]
5256 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
5257   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
5258
5259 [50911]: https://github.com/rust-lang/rust/pull/50911/
5260 [51363]: https://github.com/rust-lang/rust/pull/51363/
5261 [51366]: https://github.com/rust-lang/rust/pull/51366/
5262 [52081]: https://github.com/rust-lang/rust/pull/52081/
5263 [53003]: https://github.com/rust-lang/rust/pull/53003/
5264 [53033]: https://github.com/rust-lang/rust/pull/53033/
5265 [53044]: https://github.com/rust-lang/rust/pull/53044/
5266 [53165]: https://github.com/rust-lang/rust/pull/53165/
5267 [53611]: https://github.com/rust-lang/rust/pull/53611/
5268 [53236]: https://github.com/rust-lang/rust/pull/53236/
5269 [53272]: https://github.com/rust-lang/rust/pull/53272/
5270 [53370]: https://github.com/rust-lang/rust/pull/53370/
5271 [53459]: https://github.com/rust-lang/rust/pull/53459/
5272 [53774]: https://github.com/rust-lang/rust/pull/53774/
5273 [53822]: https://github.com/rust-lang/rust/pull/53822/
5274 [54057]: https://github.com/rust-lang/rust/pull/54057/
5275 [54404]: https://github.com/rust-lang/rust/pull/54404/
5276 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
5277 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
5278 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
5279 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
5280
5281 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
5282 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
5283 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
5284 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
5285 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
5286 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
5287 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
5288 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
5289 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
5290 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
5291
5292
5293 Version 1.29.2 (2018-10-11)
5294 ===========================
5295
5296 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
5297 - The `rls-preview` component on the windows-gnu targets has been restored.
5298
5299 [54639]: https://github.com/rust-lang/rust/pull/54639
5300
5301
5302 Version 1.29.1 (2018-09-25)
5303 ===========================
5304
5305 Security Notes
5306 --------------
5307
5308 - The standard library's `str::repeat` function contained an out of bounds write
5309   caused by an integer overflow. This has been fixed by deterministically
5310   panicking when an overflow happens.
5311
5312   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
5313   us.
5314
5315
5316 Version 1.29.0 (2018-09-13)
5317 ==========================
5318
5319 Compiler
5320 --------
5321 - [Bumped minimum LLVM version to 5.0.][51899]
5322 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
5323 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
5324 - [Upgraded to LLVM 7.][51966]
5325
5326 Libraries
5327 ---------
5328 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
5329 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
5330 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
5331 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
5332   for `&str`.][51178]
5333 - [`Cell<T>` now allows `T` to be unsized.][50494]
5334 - [`SocketAddr` is now stable on Redox.][52656]
5335
5336 Stabilized APIs
5337 ---------------
5338 - [`Arc::downcast`]
5339 - [`Iterator::flatten`]
5340 - [`Rc::downcast`]
5341
5342 Cargo
5343 -----
5344 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
5345   `--locked` to disable this behavior.
5346 - [`cargo-install` will now allow you to cross compile an install
5347   using `--target`.][cargo/5614]
5348 - [Added the `cargo-fix` subcommand to automatically move project code from
5349   2015 edition to 2018.][cargo/5723]
5350 - [`cargo doc` can now optionally document private types using the
5351   `--document-private-items` flag.][cargo/5543]
5352
5353 Misc
5354 ----
5355 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
5356   the specified level to that level.][52354] For example `--cap-lints warn`
5357   will demote `deny` and `forbid` lints to `warn`.
5358 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
5359   fails and `101` if there is a panic.][52197]
5360 - [A preview of clippy has been made available through rustup.][51122]
5361   You can install the preview with `rustup component add clippy-preview`.
5362
5363 Compatibility Notes
5364 -------------------
5365 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
5366   Use `str::get_unchecked(begin..end)` instead.
5367 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
5368   Consider using the `home_dir` function from
5369   https://crates.io/crates/dirs instead.
5370 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
5371 - [`cfg` attributes and `--cfg` command line flags are now more
5372   strictly validated.][53893]
5373
5374 [53893]: https://github.com/rust-lang/rust/pull/53893/
5375 [52861]: https://github.com/rust-lang/rust/pull/52861/
5376 [51966]: https://github.com/rust-lang/rust/pull/51966/
5377 [52656]: https://github.com/rust-lang/rust/pull/52656/
5378 [52239]: https://github.com/rust-lang/rust/pull/52239/
5379 [52330]: https://github.com/rust-lang/rust/pull/52330/
5380 [52354]: https://github.com/rust-lang/rust/pull/52354/
5381 [52402]: https://github.com/rust-lang/rust/pull/52402/
5382 [52197]: https://github.com/rust-lang/rust/pull/52197/
5383 [51807]: https://github.com/rust-lang/rust/pull/51807/
5384 [51899]: https://github.com/rust-lang/rust/pull/51899/
5385 [51912]: https://github.com/rust-lang/rust/pull/51912/
5386 [51619]: https://github.com/rust-lang/rust/pull/51619/
5387 [51656]: https://github.com/rust-lang/rust/pull/51656/
5388 [51178]: https://github.com/rust-lang/rust/pull/51178/
5389 [51122]: https://github.com/rust-lang/rust/pull/51122
5390 [50494]: https://github.com/rust-lang/rust/pull/50494/
5391 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
5392 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
5393 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
5394 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
5395 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
5396 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
5397 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
5398
5399
5400 Version 1.28.0 (2018-08-02)
5401 ===========================
5402
5403 Language
5404 --------
5405 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
5406   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
5407   the inner type across Foreign Function Interface (FFI) boundaries.
5408 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
5409   and can now be used as identifiers.][51196]
5410 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
5411   stable.][51241] This will allow users to specify a global allocator for
5412   their program.
5413 - [Unit test functions marked with the `#[test]` attribute can now return
5414   `Result<(), E: Debug>` in addition to `()`.][51298]
5415 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
5416   allows macros to easily target lifetimes.
5417
5418 Compiler
5419 --------
5420 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
5421   prioritise making smaller binary sizes. `z` is the same as `s` with the
5422   exception that it does not vectorise loops, which typically results in an even
5423   smaller binary.
5424 - [The short error format is now stable.][49546] Specified with
5425   `--error-format=short` this option will provide a more compressed output of
5426   rust error messages.
5427 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
5428 - [Reduced the number of allocations in the macro parser.][50855] This can
5429   improve compile times of macro heavy crates on average by 5%.
5430
5431 Libraries
5432 ---------
5433 - [Implemented `Default` for `&mut str`.][51306]
5434 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
5435 - [Implemented `Extend` for `()`.][50234]
5436 - [The `Debug` implementation of `time::Duration` should now be more easily
5437   human readable.][50364] Previously a `Duration` of one second would printed as
5438   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
5439 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
5440   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
5441   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
5442   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
5443   for `PathBuf`.][50170]
5444 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
5445   and `Wrapping<i128>`.][50465]
5446 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
5447   possible.][51050] This can provide up to a 40% speed increase.
5448 - [Improved error messages when using `format!`.][50610]
5449
5450 Stabilized APIs
5451 ---------------
5452 - [`Iterator::step_by`]
5453 - [`Path::ancestors`]
5454 - [`SystemTime::UNIX_EPOCH`]
5455 - [`alloc::GlobalAlloc`]
5456 - [`alloc::Layout`]
5457 - [`alloc::LayoutErr`]
5458 - [`alloc::System`]
5459 - [`alloc::alloc`]
5460 - [`alloc::alloc_zeroed`]
5461 - [`alloc::dealloc`]
5462 - [`alloc::realloc`]
5463 - [`alloc::handle_alloc_error`]
5464 - [`btree_map::Entry::or_default`]
5465 - [`fmt::Alignment`]
5466 - [`hash_map::Entry::or_default`]
5467 - [`iter::repeat_with`]
5468 - [`num::NonZeroUsize`]
5469 - [`num::NonZeroU128`]
5470 - [`num::NonZeroU16`]
5471 - [`num::NonZeroU32`]
5472 - [`num::NonZeroU64`]
5473 - [`num::NonZeroU8`]
5474 - [`ops::RangeBounds`]
5475 - [`slice::SliceIndex`]
5476 - [`slice::from_mut`]
5477 - [`slice::from_ref`]
5478 - [`{Any + Send + Sync}::downcast_mut`]
5479 - [`{Any + Send + Sync}::downcast_ref`]
5480 - [`{Any + Send + Sync}::is`]
5481
5482 Cargo
5483 -----
5484 - [Cargo will now no longer allow you to publish crates with build scripts that
5485   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
5486   considered to be immutable.
5487
5488 Misc
5489 ----
5490 - [The `suggestion_applicability` field in `rustc`'s json output is now
5491   stable.][50486] This will allow dev tools to check whether a code suggestion
5492   would apply to them.
5493
5494 Compatibility Notes
5495 -------------------
5496 - [Rust will consider trait objects with duplicated constraints to be the same
5497   type as without the duplicated constraint.][51276] For example the below code will
5498   now fail to compile.
5499   ```rust
5500   trait Trait {}
5501
5502   impl Trait + Send {
5503       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
5504   }
5505
5506   impl Trait + Send + Send {
5507       fn test(&self) { println!("two"); }
5508   }
5509   ```
5510
5511 [49546]: https://github.com/rust-lang/rust/pull/49546/
5512 [50143]: https://github.com/rust-lang/rust/pull/50143/
5513 [50170]: https://github.com/rust-lang/rust/pull/50170/
5514 [50234]: https://github.com/rust-lang/rust/pull/50234/
5515 [50265]: https://github.com/rust-lang/rust/pull/50265/
5516 [50364]: https://github.com/rust-lang/rust/pull/50364/
5517 [50385]: https://github.com/rust-lang/rust/pull/50385/
5518 [50465]: https://github.com/rust-lang/rust/pull/50465/
5519 [50486]: https://github.com/rust-lang/rust/pull/50486/
5520 [50554]: https://github.com/rust-lang/rust/pull/50554/
5521 [50610]: https://github.com/rust-lang/rust/pull/50610/
5522 [50855]: https://github.com/rust-lang/rust/pull/50855/
5523 [51050]: https://github.com/rust-lang/rust/pull/51050/
5524 [51196]: https://github.com/rust-lang/rust/pull/51196/
5525 [51241]: https://github.com/rust-lang/rust/pull/51241/
5526 [51276]: https://github.com/rust-lang/rust/pull/51276/
5527 [51298]: https://github.com/rust-lang/rust/pull/51298/
5528 [51306]: https://github.com/rust-lang/rust/pull/51306/
5529 [51562]: https://github.com/rust-lang/rust/pull/51562/
5530 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
5531 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
5532 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
5533 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
5534 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
5535 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
5536 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
5537 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
5538 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
5539 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
5540 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
5541 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
5542 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
5543 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
5544 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
5545 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
5546 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
5547 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
5548 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
5549 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
5550 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
5551 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
5552 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
5553 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
5554 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
5555 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
5556 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
5557 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
5558 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
5559 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
5560
5561 Version 1.27.2 (2018-07-20)
5562 ===========================
5563
5564 Compatibility Notes
5565 -------------------
5566
5567 - The borrow checker was fixed to avoid potential unsoundness when using
5568   match ergonomics: [#52213][52213].
5569
5570 [52213]: https://github.com/rust-lang/rust/issues/52213
5571
5572 Version 1.27.1 (2018-07-10)
5573 ===========================
5574
5575 Security Notes
5576 --------------
5577
5578 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
5579   when running, which enabled executing code as some other user on a
5580   given machine. This release fixes that vulnerability; you can read
5581   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
5582
5583   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
5584
5585 Compatibility Notes
5586 -------------------
5587
5588 - The borrow checker was fixed to avoid an additional potential unsoundness when using
5589   match ergonomics: [#51415][51415], [#49534][49534].
5590
5591 [51415]: https://github.com/rust-lang/rust/issues/51415
5592 [49534]: https://github.com/rust-lang/rust/issues/49534
5593 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
5594 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
5595
5596 Version 1.27.0 (2018-06-21)
5597 ==========================
5598
5599 Language
5600 --------
5601 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
5602   be used as an identifier.
5603 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
5604   bare `Trait` syntax, and should make it clearer when being used in tandem with
5605   `impl Trait` because it is equivalent to the following syntax:
5606   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
5607   `Box<Trait> == Box<dyn Trait>`.
5608 - [Attributes on generic parameters such as types and lifetimes are
5609   now stable.][48851] e.g.
5610   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
5611 - [The `#[must_use]` attribute can now also be used on functions as well as
5612   types.][48925] It provides a lint that by default warns users when the
5613   value returned by a function has not been used.
5614
5615 Compiler
5616 --------
5617 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
5618
5619 Libraries
5620 ---------
5621 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
5622   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
5623   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
5624   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
5625   the `cfg` attribute.
5626 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
5627   std are now available in core.][49896]
5628 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
5629   to `Self`.][49630]
5630 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
5631   that the operation isn't done in place.
5632 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
5633   the `#[must_use]` attribute][49533] to warn about unused potentially
5634   expensive allocations.
5635
5636 Stabilized APIs
5637 ---------------
5638 - [`DoubleEndedIterator::rfind`]
5639 - [`DoubleEndedIterator::rfold`]
5640 - [`DoubleEndedIterator::try_rfold`]
5641 - [`Duration::from_micros`]
5642 - [`Duration::from_nanos`]
5643 - [`Duration::subsec_micros`]
5644 - [`Duration::subsec_millis`]
5645 - [`HashMap::remove_entry`]
5646 - [`Iterator::try_fold`]
5647 - [`Iterator::try_for_each`]
5648 - [`NonNull::cast`]
5649 - [`Option::filter`]
5650 - [`String::replace_range`]
5651 - [`Take::set_limit`]
5652 - [`hint::unreachable_unchecked`]
5653 - [`os::unix::process::parent_id`]
5654 - [`ptr::swap_nonoverlapping`]
5655 - [`slice::rsplit_mut`]
5656 - [`slice::rsplit`]
5657 - [`slice::swap_with_slice`]
5658
5659 Cargo
5660 -----
5661 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
5662   `readme`, and `repository` fields.][cargo/5386]
5663 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
5664 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
5665   a different directory than `target` for placing compilation artifacts.
5666 - [Cargo will be adding automatic target inference for binaries, benchmarks,
5667   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
5668   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
5669   where cargo would infer a binary, Cargo will produce a warning. You can
5670   disable this feature ahead of time by setting any of the following to false:
5671   `autobins`, `autobenches`, `autoexamples`, `autotests`.
5672 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
5673   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
5674
5675 Misc
5676 ----
5677 - [Added “The Rustc book” into the official documentation.][49707]
5678   [“The Rustc book”] documents and teaches how to use the rustc compiler.
5679 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
5680
5681 Compatibility Notes
5682 -------------------
5683 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
5684   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
5685   compile, `"".is_empty()` will still compile.
5686 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
5687   will only print the inner type.][48553] E.g.
5688   `print!("{:?}", AtomicBool::new(true))` will print `true`,
5689   not `AtomicBool(true)`.
5690 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
5691   could enter higher numbers but they were not supported by LLVM. Up to 512MB
5692   alignment should cover all use cases.
5693 - The `.description()` method on the `std::error::Error` trait
5694   [has been soft-deprecated][50163]. It is no longer required to implement it.
5695
5696 [48553]: https://github.com/rust-lang/rust/pull/48553/
5697 [48851]: https://github.com/rust-lang/rust/pull/48851/
5698 [48925]: https://github.com/rust-lang/rust/pull/48925/
5699 [49533]: https://github.com/rust-lang/rust/pull/49533/
5700 [49623]: https://github.com/rust-lang/rust/pull/49623/
5701 [49630]: https://github.com/rust-lang/rust/pull/49630/
5702 [49664]: https://github.com/rust-lang/rust/pull/49664/
5703 [49699]: https://github.com/rust-lang/rust/pull/49699/
5704 [49707]: https://github.com/rust-lang/rust/pull/49707/
5705 [49896]: https://github.com/rust-lang/rust/pull/49896/
5706 [49968]: https://github.com/rust-lang/rust/pull/49968/
5707 [50163]: https://github.com/rust-lang/rust/pull/50163
5708 [50177]: https://github.com/rust-lang/rust/pull/50177/
5709 [50378]: https://github.com/rust-lang/rust/pull/50378/
5710 [50423]: https://github.com/rust-lang/rust/pull/50423/
5711 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
5712 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
5713 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
5714 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
5715 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
5716 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
5717 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
5718 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
5719 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
5720 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
5721 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
5722 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
5723 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
5724 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
5725 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
5726 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
5727 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
5728 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
5729 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
5730 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
5731 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
5732 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
5733 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
5734 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
5735 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
5736 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
5737 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
5738 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
5739 [“The Rustc book”]: https://doc.rust-lang.org/rustc
5740
5741
5742 Version 1.26.2 (2018-06-05)
5743 ==========================
5744
5745 Compatibility Notes
5746 -------------------
5747
5748 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
5749
5750 [51117]: https://github.com/rust-lang/rust/issues/51117
5751
5752
5753 Version 1.26.1 (2018-05-29)
5754 ==========================
5755
5756 Tools
5757 -----
5758
5759 - [RLS now works on Windows.][50646]
5760 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
5761
5762
5763 Compatibility Notes
5764 --------
5765
5766 - [`fn main() -> impl Trait` no longer works for non-Termination
5767   trait.][50656]
5768   This reverts an accidental stabilization.
5769 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
5770 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
5771
5772 [50646]: https://github.com/rust-lang/rust/issues/50646
5773 [50656]: https://github.com/rust-lang/rust/pull/50656
5774 [50812]: https://github.com/rust-lang/rust/pull/50812
5775 [50950]: https://github.com/rust-lang/rust/issues/50950
5776 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
5777
5778 Version 1.26.0 (2018-05-10)
5779 ==========================
5780
5781 Language
5782 --------
5783 - [Closures now implement `Copy` and/or `Clone` if all captured variables
5784   implement either or both traits.][49299]
5785 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
5786 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
5787   lifetime can be elided.][49458]
5788 - [`impl Trait` is now stable allowing you to have abstract types in returns
5789    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
5790   `fn open(path: impl AsRef<Path>)`.
5791 - [Pattern matching will now automatically apply dereferences.][49394]
5792 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
5793 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
5794 - [A lot of operations are now available in a const context.][46882] E.g. You
5795   can now index into constant arrays, reference and dereference into constants,
5796   and use tuple struct constructors.
5797 - [Fixed entry slice patterns are now stable.][48516] E.g.
5798   ```rust
5799   let points = [1, 2, 3, 4];
5800   match points {
5801       [1, 2, 3, 4] => println!("All points were sequential."),
5802       _ => println!("Not all points were sequential."),
5803   }
5804   ```
5805
5806
5807 Compiler
5808 --------
5809 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
5810 - [Fixed exponential projection complexity on nested types.][48296]
5811   This can provide up to a ~12% reduction in compile times for certain crates.
5812 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
5813   to remap path prefixes outputted by the compiler.
5814 - [Added `powerpc-unknown-netbsd` target.][48281]
5815
5816 Libraries
5817 ---------
5818 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
5819 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
5820   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
5821 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
5822 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
5823 - [`ascii::escape_default` is now available in libcore.][48735]
5824 - [Trailing commas are now supported in std and core macros.][48056]
5825 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
5826 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
5827
5828 Stabilized APIs
5829 ---------------
5830 - [`*const T::add`]
5831 - [`*const T::copy_to_nonoverlapping`]
5832 - [`*const T::copy_to`]
5833 - [`*const T::read_unaligned`]
5834 - [`*const T::read_volatile`]
5835 - [`*const T::read`]
5836 - [`*const T::sub`]
5837 - [`*const T::wrapping_add`]
5838 - [`*const T::wrapping_sub`]
5839 - [`*mut T::add`]
5840 - [`*mut T::copy_to_nonoverlapping`]
5841 - [`*mut T::copy_to`]
5842 - [`*mut T::read_unaligned`]
5843 - [`*mut T::read_volatile`]
5844 - [`*mut T::read`]
5845 - [`*mut T::replace`]
5846 - [`*mut T::sub`]
5847 - [`*mut T::swap`]
5848 - [`*mut T::wrapping_add`]
5849 - [`*mut T::wrapping_sub`]
5850 - [`*mut T::write_bytes`]
5851 - [`*mut T::write_unaligned`]
5852 - [`*mut T::write_volatile`]
5853 - [`*mut T::write`]
5854 - [`Box::leak`]
5855 - [`FromUtf8Error::as_bytes`]
5856 - [`LocalKey::try_with`]
5857 - [`Option::cloned`]
5858 - [`btree_map::Entry::and_modify`]
5859 - [`fs::read_to_string`]
5860 - [`fs::read`]
5861 - [`fs::write`]
5862 - [`hash_map::Entry::and_modify`]
5863 - [`iter::FusedIterator`]
5864 - [`ops::RangeInclusive`]
5865 - [`ops::RangeToInclusive`]
5866 - [`process::id`]
5867 - [`slice::rotate_left`]
5868 - [`slice::rotate_right`]
5869 - [`String::retain`]
5870
5871
5872 Cargo
5873 -----
5874 - [Cargo will now output path to custom commands when `-v` is
5875   passed with `--list`][cargo/5041]
5876 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
5877
5878 Misc
5879 ----
5880 - [The second edition of "The Rust Programming Language" book is now recommended
5881   over the first.][48404]
5882
5883 Compatibility Notes
5884 -------------------
5885
5886 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
5887   syntax is now invalid.
5888   ```
5889   use std::ops::Fn as dyn;
5890   fn g(_: Box<dyn(std::fmt::Debug)>) {}
5891   ```
5892 - [The result of dereferences are no longer promoted to `'static`.][47408]
5893   e.g.
5894   ```rust
5895   fn main() {
5896       const PAIR: &(i32, i32) = &(0, 1);
5897       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
5898   }
5899   ```
5900 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
5901 - [`".e0"` will now no longer parse as `0.0` and will instead cause
5902   an error.][48235]
5903 - [Removed hoedown from rustdoc.][48274]
5904 - [Bounds on higher-kinded lifetimes a hard error.][48326]
5905
5906 [46882]: https://github.com/rust-lang/rust/pull/46882
5907 [47379]: https://github.com/rust-lang/rust/pull/47379
5908 [47408]: https://github.com/rust-lang/rust/pull/47408
5909 [47813]: https://github.com/rust-lang/rust/pull/47813
5910 [48056]: https://github.com/rust-lang/rust/pull/48056
5911 [48125]: https://github.com/rust-lang/rust/pull/48125
5912 [48235]: https://github.com/rust-lang/rust/pull/48235
5913 [48274]: https://github.com/rust-lang/rust/pull/48274
5914 [48281]: https://github.com/rust-lang/rust/pull/48281
5915 [48296]: https://github.com/rust-lang/rust/pull/48296
5916 [48326]: https://github.com/rust-lang/rust/pull/48326
5917 [48359]: https://github.com/rust-lang/rust/pull/48359
5918 [48404]: https://github.com/rust-lang/rust/pull/48404
5919 [48481]: https://github.com/rust-lang/rust/pull/48481
5920 [48516]: https://github.com/rust-lang/rust/pull/48516
5921 [48628]: https://github.com/rust-lang/rust/pull/48628
5922 [48629]: https://github.com/rust-lang/rust/pull/48629
5923 [48657]: https://github.com/rust-lang/rust/pull/48657
5924 [48735]: https://github.com/rust-lang/rust/pull/48735
5925 [48978]: https://github.com/rust-lang/rust/pull/48978
5926 [49101]: https://github.com/rust-lang/rust/pull/49101
5927 [49109]: https://github.com/rust-lang/rust/pull/49109
5928 [49162]: https://github.com/rust-lang/rust/pull/49162
5929 [49255]: https://github.com/rust-lang/rust/pull/49255
5930 [49299]: https://github.com/rust-lang/rust/pull/49299
5931 [49305]: https://github.com/rust-lang/rust/pull/49305
5932 [49394]: https://github.com/rust-lang/rust/pull/49394
5933 [49458]: https://github.com/rust-lang/rust/pull/49458
5934 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
5935 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
5936 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
5937 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
5938 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
5939 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
5940 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
5941 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
5942 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
5943 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
5944 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
5945 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
5946 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
5947 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
5948 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
5949 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
5950 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
5951 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
5952 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
5953 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
5954 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
5955 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
5956 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
5957 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
5958 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
5959 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
5960 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
5961 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
5962 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
5963 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
5964 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
5965 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
5966 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
5967 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
5968 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
5969 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
5970 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
5971 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
5972 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
5973 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
5974 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
5975 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
5976
5977
5978 Version 1.25.0 (2018-03-29)
5979 ==========================
5980
5981 Language
5982 --------
5983 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
5984 - [You can now use nested groups of imports.][47948]
5985   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
5986 - [You can now have `|` at the start of a match arm.][47947] e.g.
5987 ```rust
5988 enum Foo { A, B, C }
5989
5990 fn main() {
5991     let x = Foo::A;
5992     match x {
5993         | Foo::A
5994         | Foo::B => println!("AB"),
5995         | Foo::C => println!("C"),
5996     }
5997 }
5998 ```
5999
6000 Compiler
6001 --------
6002 - [Upgraded to LLVM 6.][47828]
6003 - [Added `-C lto=val` option.][47521]
6004 - [Added `i586-unknown-linux-musl` target][47282]
6005
6006 Libraries
6007 ---------
6008 - [Impl Send for `process::Command` on Unix.][47760]
6009 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
6010 - [`UnsafeCell::into_inner` is now safe.][47204]
6011 - [Implement libstd for CloudABI.][47268]
6012 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
6013 - [Implement `AsRef<Path>` for Component][46985]
6014 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
6015 - [Moved `Duration` to libcore.][46666]
6016
6017 Stabilized APIs
6018 ---------------
6019 - [`Location::column`]
6020 - [`ptr::NonNull`]
6021
6022 The following functions can now be used in a constant expression.
6023 eg. `static MINUTE: Duration = Duration::from_secs(60);`
6024 - [`Duration::new`][47300]
6025 - [`Duration::from_secs`][47300]
6026 - [`Duration::from_millis`][47300]
6027
6028 Cargo
6029 -----
6030 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
6031 - [`cargo new` now defaults to creating a binary crate, instead of a
6032   library crate.][cargo/5029]
6033
6034 Misc
6035 ----
6036 - [Rust by example is now shipped with new releases][46196]
6037
6038 Compatibility Notes
6039 -------------------
6040 - [Deprecated `net::lookup_host`.][47510]
6041 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
6042 - The borrow checker was sometimes incorrectly permitting overlapping borrows
6043   around indexing operations (see [#47349][47349]). This has been fixed (which also
6044   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
6045 - [Removed deprecated unstable attribute `#[simd]`.][47251]
6046
6047 [33903]: https://github.com/rust-lang/rust/pull/33903
6048 [47947]: https://github.com/rust-lang/rust/pull/47947
6049 [47948]: https://github.com/rust-lang/rust/pull/47948
6050 [47760]: https://github.com/rust-lang/rust/pull/47760
6051 [47790]: https://github.com/rust-lang/rust/pull/47790
6052 [47828]: https://github.com/rust-lang/rust/pull/47828
6053 [47398]: https://github.com/rust-lang/rust/pull/47398
6054 [47510]: https://github.com/rust-lang/rust/pull/47510
6055 [47521]: https://github.com/rust-lang/rust/pull/47521
6056 [47204]: https://github.com/rust-lang/rust/pull/47204
6057 [47251]: https://github.com/rust-lang/rust/pull/47251
6058 [47268]: https://github.com/rust-lang/rust/pull/47268
6059 [47282]: https://github.com/rust-lang/rust/pull/47282
6060 [47300]: https://github.com/rust-lang/rust/pull/47300
6061 [47349]: https://github.com/rust-lang/rust/pull/47349
6062 [46931]: https://github.com/rust-lang/rust/pull/46931
6063 [46985]: https://github.com/rust-lang/rust/pull/46985
6064 [47006]: https://github.com/rust-lang/rust/pull/47006
6065 [46830]: https://github.com/rust-lang/rust/pull/46830
6066 [46095]: https://github.com/rust-lang/rust/pull/46095
6067 [46666]: https://github.com/rust-lang/rust/pull/46666
6068 [46196]: https://github.com/rust-lang/rust/pull/46196
6069 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
6070 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
6071 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
6072 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
6073 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
6074
6075
6076 Version 1.24.1 (2018-03-01)
6077 ==========================
6078
6079  - [Do not abort when unwinding through FFI][48251]
6080  - [Emit UTF-16 files for linker arguments on Windows][48318]
6081  - [Make the error index generator work again][48308]
6082  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
6083
6084 [48251]: https://github.com/rust-lang/rust/issues/48251
6085 [48308]: https://github.com/rust-lang/rust/issues/48308
6086 [48318]: https://github.com/rust-lang/rust/issues/48318
6087 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
6088
6089
6090 Version 1.24.0 (2018-02-15)
6091 ==========================
6092
6093 Language
6094 --------
6095 - [External `sysv64` ffi is now available.][46528]
6096   eg. `extern "sysv64" fn foo () {}`
6097
6098 Compiler
6099 --------
6100 - [rustc now uses 16 codegen units by default for release builds.][46910]
6101   For the fastest builds, utilize `codegen-units=1`.
6102 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
6103 - [Add `aarch64-unknown-openbsd` support][46760]
6104
6105 Libraries
6106 ---------
6107 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
6108   improvement in performance in the majority of cases.
6109 - [`OsStr`'s `Debug` implementation is now lossless and consistent
6110   with Windows.][46798]
6111 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
6112 - [impl `From<bool>` for `AtomicBool`][46293]
6113 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
6114 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
6115 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
6116 - [float::from_bits now just uses transmute.][46012] This provides
6117   some optimisations from LLVM.
6118 - [Copied `AsciiExt` methods onto `char`][46077]
6119 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
6120 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
6121 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
6122 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
6123
6124 Stabilized APIs
6125 ---------------
6126 - [`RefCell::replace`]
6127 - [`RefCell::swap`]
6128 - [`atomic::spin_loop_hint`]
6129
6130 The following functions can now be used in a constant expression.
6131 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
6132
6133 - [`AtomicBool::new`][46287]
6134 - [`AtomicUsize::new`][46287]
6135 - [`AtomicIsize::new`][46287]
6136 - [`AtomicPtr::new`][46287]
6137 - [`Cell::new`][46287]
6138 - [`{integer}::min_value`][46287]
6139 - [`{integer}::max_value`][46287]
6140 - [`mem::size_of`][46287]
6141 - [`mem::align_of`][46287]
6142 - [`ptr::null`][46287]
6143 - [`ptr::null_mut`][46287]
6144 - [`RefCell::new`][46287]
6145 - [`UnsafeCell::new`][46287]
6146
6147 Cargo
6148 -----
6149 - [Added a `workspace.default-members` config that
6150   overrides implied `--all` in virtual workspaces.][cargo/4743]
6151 - [Enable incremental by default on development builds.][cargo/4817] Also added
6152   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
6153   per-project or global basis respectively.
6154
6155 Misc
6156 ----
6157
6158 Compatibility Notes
6159 -------------------
6160 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
6161 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
6162   in accordance with IETF RFC 4291 §2.2.
6163 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
6164 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
6165   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
6166 - [Leading zeros in tuple struct members is now an error][47084]
6167 - [`column!()` macro is one-based instead of zero-based][46977]
6168 - [`fmt::Arguments` can no longer be shared across threads][45198]
6169 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
6170 - [Cargo sets a different working directory for the compiler][cargo/4788]
6171
6172 [44884]: https://github.com/rust-lang/rust/pull/44884
6173 [45198]: https://github.com/rust-lang/rust/pull/45198
6174 [45506]: https://github.com/rust-lang/rust/pull/45506
6175 [45990]: https://github.com/rust-lang/rust/pull/45990
6176 [46012]: https://github.com/rust-lang/rust/pull/46012
6177 [46077]: https://github.com/rust-lang/rust/pull/46077
6178 [46094]: https://github.com/rust-lang/rust/pull/46094
6179 [46284]: https://github.com/rust-lang/rust/pull/46284
6180 [46287]: https://github.com/rust-lang/rust/pull/46287
6181 [46293]: https://github.com/rust-lang/rust/pull/46293
6182 [46528]: https://github.com/rust-lang/rust/pull/46528
6183 [46671]: https://github.com/rust-lang/rust/pull/46671
6184 [46713]: https://github.com/rust-lang/rust/pull/46713
6185 [46735]: https://github.com/rust-lang/rust/pull/46735
6186 [46760]: https://github.com/rust-lang/rust/pull/46760
6187 [46798]: https://github.com/rust-lang/rust/pull/46798
6188 [46828]: https://github.com/rust-lang/rust/pull/46828
6189 [46831]: https://github.com/rust-lang/rust/pull/46831
6190 [46833]: https://github.com/rust-lang/rust/pull/46833
6191 [46910]: https://github.com/rust-lang/rust/pull/46910
6192 [46977]: https://github.com/rust-lang/rust/pull/46977
6193 [47018]: https://github.com/rust-lang/rust/pull/47018
6194 [47080]: https://github.com/rust-lang/rust/pull/47080
6195 [47084]: https://github.com/rust-lang/rust/pull/47084
6196 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
6197 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
6198 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
6199 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
6200 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
6201 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
6202
6203
6204 Version 1.23.0 (2018-01-04)
6205 ==========================
6206
6207 Language
6208 --------
6209 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
6210 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
6211   Which should fix some confusing errors in some operations.
6212
6213 Compiler
6214 --------
6215 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
6216   undefined behavior.][45920]
6217 - [rustc now suggests renaming import if names clash.][45660]
6218 - [Display errors/warnings correctly when there are zero-width or
6219   wide characters.][45711]
6220 - [rustc now avoids unnecessary copies of arguments that are
6221   simple bindings][45380] This should improve memory usage on average by 5-10%.
6222 - [Updated musl used to build musl rustc to 1.1.17][45393]
6223
6224 Libraries
6225 ---------
6226 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
6227 - [Implement Hash for raw pointers to unsized types][45483]
6228 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
6229 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
6230 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
6231 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
6232   and `<*mut T>::as_mut`][44932]
6233 - [Optimized `Thread::{park, unpark}` implementation][45524]
6234 - [Improved `SliceExt::binary_search` performance.][45333]
6235 - [impl `FromIterator<()>` for `()`][45379]
6236 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
6237   is now deprecated.
6238
6239 Stabilized APIs
6240 ---------------
6241
6242 Cargo
6243 -----
6244 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
6245   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
6246 - [Added unit test checking to `cargo check`][cargo/4592]
6247 - [Cargo now lets you install a specific version
6248   using `cargo install --version`][cargo/4637]
6249
6250 Misc
6251 ----
6252 - [Releases now ship with the Cargo book documentation.][45692]
6253 - [rustdoc now prints rendering warnings on every run.][45324]
6254
6255 Compatibility Notes
6256 -------------------
6257 - [Changes have been made to type equality to make it more correct,
6258   in rare cases this could break some code.][45853] [Tracking issue for
6259   further information][45852]
6260 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
6261 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
6262   Android 9, the minimum supported version is Android 14.
6263 - [Bumped the minimum LLVM to 3.9][45326]
6264
6265 [44042]: https://github.com/rust-lang/rust/pull/44042
6266 [44932]: https://github.com/rust-lang/rust/pull/44932
6267 [45267]: https://github.com/rust-lang/rust/pull/45267
6268 [45324]: https://github.com/rust-lang/rust/pull/45324
6269 [45326]: https://github.com/rust-lang/rust/pull/45326
6270 [45333]: https://github.com/rust-lang/rust/pull/45333
6271 [45379]: https://github.com/rust-lang/rust/pull/45379
6272 [45380]: https://github.com/rust-lang/rust/pull/45380
6273 [45393]: https://github.com/rust-lang/rust/pull/45393
6274 [45435]: https://github.com/rust-lang/rust/pull/45435
6275 [45483]: https://github.com/rust-lang/rust/pull/45483
6276 [45524]: https://github.com/rust-lang/rust/pull/45524
6277 [45571]: https://github.com/rust-lang/rust/pull/45571
6278 [45580]: https://github.com/rust-lang/rust/pull/45580
6279 [45610]: https://github.com/rust-lang/rust/pull/45610
6280 [45660]: https://github.com/rust-lang/rust/pull/45660
6281 [45692]: https://github.com/rust-lang/rust/pull/45692
6282 [45711]: https://github.com/rust-lang/rust/pull/45711
6283 [45772]: https://github.com/rust-lang/rust/pull/45772
6284 [45852]: https://github.com/rust-lang/rust/issues/45852
6285 [45853]: https://github.com/rust-lang/rust/pull/45853
6286 [45887]: https://github.com/rust-lang/rust/pull/45887
6287 [45920]: https://github.com/rust-lang/rust/pull/45920
6288 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
6289 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
6290 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
6291
6292
6293 Version 1.22.1 (2017-11-22)
6294 ==========================
6295
6296 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
6297
6298 [46183]: https://github.com/rust-lang/rust/pull/46183
6299
6300 Version 1.22.0 (2017-11-22)
6301 ==========================
6302
6303 Language
6304 --------
6305 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
6306 - [Now accepts underscores in unicode escapes][43716]
6307 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
6308 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
6309
6310 Compiler
6311 --------
6312 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
6313 - [rustc will no longer inline in codegen units when compiling for debug][45075]
6314   This should decrease compile times for debug builds.
6315 - [strict memory alignment now enabled on ARMv6][45094]
6316 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
6317
6318 Libraries
6319 ---------
6320 - [Allow atomic operations up to 32 bits
6321   on `armv5te_unknown_linux_gnueabi`][44978]
6322 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
6323 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
6324 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
6325 - [Properly detect overflow in `Instant += Duration`.][44220]
6326 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
6327 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
6328 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
6329
6330 Stabilized APIs
6331 ---------------
6332
6333 Cargo
6334 -----
6335 - [Cargo will now build multi file examples in subdirectories of the `examples`
6336   folder that have a `main.rs` file.][cargo/4496]
6337 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
6338   the old format will continue to work and can be updated with `cargo update`.
6339 - [Now supports vendoring git repositories][cargo/3992]
6340
6341 Misc
6342 ----
6343 - [`libbacktrace` is now available on Apple platforms.][44251]
6344 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
6345   This now lets you specify that a given code example will fail to compile.
6346
6347 Compatibility Notes
6348 -------------------
6349 - [The minimum Android version that rustc can build for has been bumped
6350   to `4.0` from `2.3`][45656]
6351 - [Allowing `T op= &T` for numeric types has broken some type
6352   inference cases][45480]
6353
6354
6355 [42526]: https://github.com/rust-lang/rust/pull/42526
6356 [43716]: https://github.com/rust-lang/rust/pull/43716
6357 [43949]: https://github.com/rust-lang/rust/pull/43949
6358 [44015]: https://github.com/rust-lang/rust/pull/44015
6359 [44220]: https://github.com/rust-lang/rust/pull/44220
6360 [44251]: https://github.com/rust-lang/rust/pull/44251
6361 [44287]: https://github.com/rust-lang/rust/pull/44287
6362 [44303]: https://github.com/rust-lang/rust/pull/44303
6363 [44456]: https://github.com/rust-lang/rust/pull/44456
6364 [44466]: https://github.com/rust-lang/rust/pull/44466
6365 [44895]: https://github.com/rust-lang/rust/pull/44895
6366 [44966]: https://github.com/rust-lang/rust/pull/44966
6367 [44978]: https://github.com/rust-lang/rust/pull/44978
6368 [45041]: https://github.com/rust-lang/rust/pull/45041
6369 [45064]: https://github.com/rust-lang/rust/pull/45064
6370 [45075]: https://github.com/rust-lang/rust/pull/45075
6371 [45094]: https://github.com/rust-lang/rust/pull/45094
6372 [45095]: https://github.com/rust-lang/rust/pull/45095
6373 [45480]: https://github.com/rust-lang/rust/issues/45480
6374 [45656]: https://github.com/rust-lang/rust/pull/45656
6375 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
6376 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
6377 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
6378
6379
6380
6381
6382
6383
6384 Version 1.21.0 (2017-10-12)
6385 ==========================
6386
6387 Language
6388 --------
6389 - [You can now use static references for literals.][43838]
6390   Example:
6391   ```rust
6392   fn main() {
6393       let x: &'static u32 = &0;
6394   }
6395   ```
6396 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
6397   Example:
6398   ```rust
6399   my_macro!(Vec<i32>::new); // Always worked
6400   my_macro!(Vec::<i32>::new); // Now works
6401   ```
6402
6403 Compiler
6404 --------
6405 - [Upgraded jemalloc to 4.5.0][43911]
6406 - [Enabled unwinding panics on Redox][43917]
6407 - [Now runs LLVM in parallel during translation phase.][43506]
6408   This should reduce peak memory usage.
6409
6410 Libraries
6411 ---------
6412 - [Generate builtin impls for `Clone` for all arrays and tuples that
6413   are `T: Clone`][43690]
6414 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
6415 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
6416   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
6417
6418 Stabilized APIs
6419 ---------------
6420
6421 [`std::mem::discriminant`]
6422
6423 Cargo
6424 -----
6425 - [You can now call `cargo install` with multiple package names][cargo/4216]
6426 - [Cargo commands inside a virtual workspace will now implicitly
6427   pass `--all`][cargo/4335]
6428 - [Added a `[patch]` section to `Cargo.toml` to handle
6429   prepublication dependencies][cargo/4123] [RFC 1969]
6430 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
6431   like patterns][cargo/4270]
6432 - [Added the `--all-targets` option][cargo/4400]
6433 - [Using required dependencies as a feature is now deprecated and emits
6434   a warning][cargo/4364]
6435
6436
6437 Misc
6438 ----
6439 - [Cargo docs are moving][43916]
6440   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
6441 - [The rustdoc book is now available][43863]
6442   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
6443 - [Added a preview of RLS has been made available through rustup][44204]
6444   Install with `rustup component add rls-preview`
6445 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
6446   Previously only showed `std::os::unix`.
6447
6448 Compatibility Notes
6449 -------------------
6450 - [Changes in method matching against higher-ranked types][43880] This may cause
6451   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
6452 - [rustc's JSON error output's byte position start at top of file.][42973]
6453   Was previously relative to the rustc's internal `CodeMap` struct which
6454   required the unstable library `libsyntax` to correctly use.
6455 - [`unused_results` lint no longer ignores booleans][43728]
6456
6457 [42565]: https://github.com/rust-lang/rust/pull/42565
6458 [42973]: https://github.com/rust-lang/rust/pull/42973
6459 [43348]: https://github.com/rust-lang/rust/pull/43348
6460 [43459]: https://github.com/rust-lang/rust/pull/43459
6461 [43506]: https://github.com/rust-lang/rust/pull/43506
6462 [43540]: https://github.com/rust-lang/rust/pull/43540
6463 [43690]: https://github.com/rust-lang/rust/pull/43690
6464 [43728]: https://github.com/rust-lang/rust/pull/43728
6465 [43838]: https://github.com/rust-lang/rust/pull/43838
6466 [43863]: https://github.com/rust-lang/rust/pull/43863
6467 [43880]: https://github.com/rust-lang/rust/pull/43880
6468 [43911]: https://github.com/rust-lang/rust/pull/43911
6469 [43916]: https://github.com/rust-lang/rust/pull/43916
6470 [43917]: https://github.com/rust-lang/rust/pull/43917
6471 [44204]: https://github.com/rust-lang/rust/pull/44204
6472 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
6473 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
6474 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
6475 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
6476 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
6477 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
6478 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
6479 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
6480 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
6481
6482 Version 1.20.0 (2017-08-31)
6483 ===========================
6484
6485 Language
6486 --------
6487 - [Associated constants are now stabilised.][42809]
6488 - [A lot of macro bugs are now fixed.][42913]
6489
6490 Compiler
6491 --------
6492
6493 - [Struct fields are now properly coerced to the expected field type.][42807]
6494 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
6495   `wasm32-experimental-emscripten` target.
6496 - [Changed some of the error messages to be more helpful.][42033]
6497 - [Add support for RELRO(RELocation Read-Only) for platforms that support
6498   it.][43170]
6499 - [rustc now reports the total number of errors on compilation failure][43015]
6500   previously this was only the number of errors in the pass that failed.
6501 - [Expansion in rustc has been sped up 29x.][42533]
6502 - [added `msp430-none-elf` target.][43099]
6503 - [rustc will now suggest one-argument enum variant to fix type mismatch when
6504   applicable][43178]
6505 - [Fixes backtraces on Redox][43228]
6506 - [rustc now identifies different versions of same crate when absolute paths of
6507   different types match in an error message.][42826]
6508
6509 Libraries
6510 ---------
6511
6512
6513 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
6514 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
6515   tuples.][43011]
6516 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
6517   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
6518 - [Impl `Clone` for `DefaultHasher`.][42799]
6519 - [Impl `Sync` for `SyncSender`.][42397]
6520 - [Impl `FromStr` for `char`][42271]
6521 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
6522   NaN.][42431]
6523 - [allow messages in the `unimplemented!()` macro.][42155]
6524   ie. `unimplemented!("Waiting for 1.21 to be stable")`
6525 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
6526 - [Upgrade to Unicode 10.0.0][42999]
6527 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
6528 - [Skip the main thread's manual stack guard on Linux][43072]
6529 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in *O*(1) time][43077]
6530 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
6531   previously 2^15.
6532 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
6533
6534 Stabilized APIs
6535 ---------------
6536
6537 - [`CStr::into_c_string`]
6538 - [`CString::as_c_str`]
6539 - [`CString::into_boxed_c_str`]
6540 - [`Chain::get_mut`]
6541 - [`Chain::get_ref`]
6542 - [`Chain::into_inner`]
6543 - [`Option::get_or_insert_with`]
6544 - [`Option::get_or_insert`]
6545 - [`OsStr::into_os_string`]
6546 - [`OsString::into_boxed_os_str`]
6547 - [`Take::get_mut`]
6548 - [`Take::get_ref`]
6549 - [`Utf8Error::error_len`]
6550 - [`char::EscapeDebug`]
6551 - [`char::escape_debug`]
6552 - [`compile_error!`]
6553 - [`f32::from_bits`]
6554 - [`f32::to_bits`]
6555 - [`f64::from_bits`]
6556 - [`f64::to_bits`]
6557 - [`mem::ManuallyDrop`]
6558 - [`slice::sort_unstable_by_key`]
6559 - [`slice::sort_unstable_by`]
6560 - [`slice::sort_unstable`]
6561 - [`str::from_boxed_utf8_unchecked`]
6562 - [`str::as_bytes_mut`]
6563 - [`str::as_bytes_mut`]
6564 - [`str::from_utf8_mut`]
6565 - [`str::from_utf8_unchecked_mut`]
6566 - [`str::get_mut`]
6567 - [`str::get_unchecked_mut`]
6568 - [`str::get_unchecked`]
6569 - [`str::get`]
6570 - [`str::into_boxed_bytes`]
6571
6572
6573 Cargo
6574 -----
6575 - [Cargo API token location moved from `~/.cargo/config` to
6576   `~/.cargo/credentials`.][cargo/3978]
6577 - [Cargo will now build `main.rs` binaries that are in sub-directories of
6578   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
6579   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
6580 - [You can now specify version of a binary when installed through
6581   `cargo install` using `--vers`.][cargo/4229]
6582 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
6583   failure.][cargo/4248]
6584 - [Changed the convention around which file is the crate root.][cargo/4259]
6585
6586 Compatibility Notes
6587 -------------------
6588
6589 - [Functions with `'static` in their return types will now not be as usable as
6590   if they were using lifetime parameters instead.][42417]
6591 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
6592   takes the sign of NaN into account where previously didn't.][42430]
6593
6594 [42033]: https://github.com/rust-lang/rust/pull/42033
6595 [42155]: https://github.com/rust-lang/rust/pull/42155
6596 [42271]: https://github.com/rust-lang/rust/pull/42271
6597 [42397]: https://github.com/rust-lang/rust/pull/42397
6598 [42417]: https://github.com/rust-lang/rust/pull/42417
6599 [42430]: https://github.com/rust-lang/rust/pull/42430
6600 [42431]: https://github.com/rust-lang/rust/pull/42431
6601 [42533]: https://github.com/rust-lang/rust/pull/42533
6602 [42571]: https://github.com/rust-lang/rust/pull/42571
6603 [42613]: https://github.com/rust-lang/rust/pull/42613
6604 [42799]: https://github.com/rust-lang/rust/pull/42799
6605 [42807]: https://github.com/rust-lang/rust/pull/42807
6606 [42809]: https://github.com/rust-lang/rust/pull/42809
6607 [42822]: https://github.com/rust-lang/rust/pull/42822
6608 [42826]: https://github.com/rust-lang/rust/pull/42826
6609 [42854]: https://github.com/rust-lang/rust/pull/42854
6610 [42913]: https://github.com/rust-lang/rust/pull/42913
6611 [42999]: https://github.com/rust-lang/rust/pull/42999
6612 [43011]: https://github.com/rust-lang/rust/pull/43011
6613 [43015]: https://github.com/rust-lang/rust/pull/43015
6614 [43072]: https://github.com/rust-lang/rust/pull/43072
6615 [43077]: https://github.com/rust-lang/rust/pull/43077
6616 [43097]: https://github.com/rust-lang/rust/pull/43097
6617 [43099]: https://github.com/rust-lang/rust/pull/43099
6618 [43170]: https://github.com/rust-lang/rust/pull/43170
6619 [43178]: https://github.com/rust-lang/rust/pull/43178
6620 [43185]: https://github.com/rust-lang/rust/pull/43185
6621 [43228]: https://github.com/rust-lang/rust/pull/43228
6622 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
6623 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
6624 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
6625 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
6626 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
6627 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
6628 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
6629 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
6630 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
6631 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
6632 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
6633 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
6634 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
6635 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
6636 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
6637 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
6638 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
6639 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
6640 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
6641 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
6642 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
6643 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
6644 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
6645 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
6646 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
6647 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
6648 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
6649 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
6650 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
6651 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
6652 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
6653 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
6654 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
6655 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
6656 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
6657 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
6658 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
6659 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
6660
6661
6662 Version 1.19.0 (2017-07-20)
6663 ===========================
6664
6665 Language
6666 --------
6667
6668 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
6669   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
6670 - [Macro recursion limit increased to 1024 from 64.][41676]
6671 - [Added lint for detecting unused macros.][41907]
6672 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
6673   For example: `let x = loop { break 7; };`
6674 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
6675   contain `Copy` types and cannot have a `Drop` implementation.
6676   Example: `union Foo { bar: u8, baz: usize }`
6677 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
6678   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
6679
6680 Compiler
6681 --------
6682
6683 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
6684 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
6685   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
6686   you should use `--target armv7-linux-androideabi`.
6687 - [Fixed ICE when removing a source file between compilation sessions.][41873]
6688 - [Minor optimisation of string operations.][42037]
6689 - [Compiler error message is now `aborting due to previous error(s)` instead of
6690   `aborting due to N previous errors`][42150] This was previously inaccurate and
6691   would only count certain kinds of errors.
6692 - [The compiler now supports Visual Studio 2017][42225]
6693 - [The compiler is now built against LLVM 4.0.1 by default][42948]
6694 - [Added a lot][42264] of [new error codes][42302]
6695 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
6696   libraries with C Run-time Libraries(CRT) to be statically linked.
6697 - [Fixed various ARM codegen bugs][42740]
6698
6699 Libraries
6700 ---------
6701
6702 - [`String` now implements `FromIterator<Cow<'a, str>>` and
6703   `Extend<Cow<'a, str>>`][41449]
6704 - [`Vec` now implements `From<&mut [T]>`][41530]
6705 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
6706 - [`SplitWhitespace` now implements `Clone`][41659]
6707 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
6708   1.5x faster][41764]
6709 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
6710   macros, but for printing to stderr.
6711
6712 Stabilized APIs
6713 ---------------
6714
6715 - [`OsString::shrink_to_fit`]
6716 - [`cmp::Reverse`]
6717 - [`Command::envs`]
6718 - [`thread::ThreadId`]
6719
6720 Cargo
6721 -----
6722
6723 - [Build scripts can now add environment variables to the environment
6724   the crate is being compiled in.
6725   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
6726 - [Subcommands now replace the current process rather than spawning a new
6727   child process][cargo/3970]
6728 - [Workspace members can now accept glob file patterns][cargo/3979]
6729 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
6730   the members in a given workspace.][cargo/3988]
6731 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
6732 - [Target directory path is now in the cargo metadata][cargo/4022]
6733 - [Cargo no longer checks out a local working directory for the
6734   crates.io index][cargo/4026] This should provide smaller file size for the
6735   registry, and improve cloning times, especially on Windows machines.
6736 - [Added an `--exclude` option for excluding certain packages when using the
6737   `--all` option][cargo/4031]
6738 - [Cargo will now automatically retry when receiving a 5xx error
6739   from crates.io][cargo/4032]
6740 - [The `--features` option now accepts multiple comma or space
6741   delimited values.][cargo/4084]
6742 - [Added support for custom target specific runners][cargo/3954]
6743
6744 Misc
6745 ----
6746
6747 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
6748   Windows Debugger.
6749 - [Rust will now release XZ compressed packages][rust-installer/57]
6750 - [rustup will now prefer to download rust packages with
6751   XZ compression][rustup/1100] over GZip packages.
6752 - [Added the ability to escape `#` in rust documentation][41785] By adding
6753   additional `#`'s ie. `##` is now `#`
6754
6755 Compatibility Notes
6756 -------------------
6757
6758 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
6759 - [`-Z` flags are now no longer allowed to be used on the stable
6760   compiler.][41751] This has been a warning for a year previous to this.
6761 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
6762   longer works][42844]. Users should migrate to the built-in `check`
6763   command, which has been available since 1.16.
6764 - [Ending a float literal with `._` is now a hard error.
6765   Example: `42._` .][41946]
6766 - [Any use of a private `extern crate` outside of its module is now a
6767   hard error.][36886] This was previously a warning.
6768 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
6769   relative while the `::` prefix makes a path absolute, but was ignored and the
6770   path was relative regardless.
6771 - [Floating point constants in match patterns is now a hard error][36890]
6772   This was previously a warning.
6773 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
6774   match patterns is now a hard error][36891] This was previously a warning.
6775 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
6776   a warning.
6777 - [From the pound escape, lines consisting of multiple `#`s are
6778   now visible][41785]
6779 - [It is an error to re-export private enum variants][42460]. This is
6780   known to break a number of crates that depend on an older version of
6781   mustache.
6782 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
6783   to use it to find the linker, and the build will fail where it did
6784   not previously][42607]
6785
6786 [36886]: https://github.com/rust-lang/rust/issues/36886
6787 [36888]: https://github.com/rust-lang/rust/issues/36888
6788 [36890]: https://github.com/rust-lang/rust/issues/36890
6789 [36891]: https://github.com/rust-lang/rust/issues/36891
6790 [36892]: https://github.com/rust-lang/rust/issues/36892
6791 [37406]: https://github.com/rust-lang/rust/issues/37406
6792 [39983]: https://github.com/rust-lang/rust/pull/39983
6793 [41145]: https://github.com/rust-lang/rust/pull/41145
6794 [41192]: https://github.com/rust-lang/rust/pull/41192
6795 [41258]: https://github.com/rust-lang/rust/pull/41258
6796 [41370]: https://github.com/rust-lang/rust/pull/41370
6797 [41449]: https://github.com/rust-lang/rust/pull/41449
6798 [41530]: https://github.com/rust-lang/rust/pull/41530
6799 [41624]: https://github.com/rust-lang/rust/pull/41624
6800 [41656]: https://github.com/rust-lang/rust/pull/41656
6801 [41659]: https://github.com/rust-lang/rust/pull/41659
6802 [41676]: https://github.com/rust-lang/rust/pull/41676
6803 [41751]: https://github.com/rust-lang/rust/pull/41751
6804 [41764]: https://github.com/rust-lang/rust/pull/41764
6805 [41785]: https://github.com/rust-lang/rust/pull/41785
6806 [41873]: https://github.com/rust-lang/rust/pull/41873
6807 [41907]: https://github.com/rust-lang/rust/pull/41907
6808 [41946]: https://github.com/rust-lang/rust/pull/41946
6809 [42016]: https://github.com/rust-lang/rust/pull/42016
6810 [42037]: https://github.com/rust-lang/rust/pull/42037
6811 [42068]: https://github.com/rust-lang/rust/pull/42068
6812 [42150]: https://github.com/rust-lang/rust/pull/42150
6813 [42162]: https://github.com/rust-lang/rust/pull/42162
6814 [42225]: https://github.com/rust-lang/rust/pull/42225
6815 [42264]: https://github.com/rust-lang/rust/pull/42264
6816 [42302]: https://github.com/rust-lang/rust/pull/42302
6817 [42460]: https://github.com/rust-lang/rust/issues/42460
6818 [42607]: https://github.com/rust-lang/rust/issues/42607
6819 [42740]: https://github.com/rust-lang/rust/pull/42740
6820 [42844]: https://github.com/rust-lang/rust/issues/42844
6821 [42948]: https://github.com/rust-lang/rust/pull/42948
6822 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
6823 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
6824 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
6825 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
6826 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
6827 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
6828 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
6829 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
6830 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
6831 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
6832 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
6833 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
6834 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
6835 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
6836 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
6837 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
6838 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
6839 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
6840 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
6841 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
6842 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
6843 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
6844
6845
6846 Version 1.18.0 (2017-06-08)
6847 ===========================
6848
6849 Language
6850 --------
6851
6852 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
6853   make the item visible to just that module tree. Also accepts the keyword
6854   `crate` to make something public to the whole crate but not users of the
6855   library. Example: `pub(crate) mod utils;`. [RFC 1422].
6856 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
6857   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
6858 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
6859   types like `Write + Send`, trailing `+` are now supported in trait objects,
6860   and better error reporting for trait objects starting with `?Sized`.
6861 - [0e+10 is now a valid floating point literal][40589]
6862 - [Now warns if you bind a lifetime parameter to 'static][40734]
6863 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
6864   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
6865   representation in some cases.][40377]
6866
6867 Compiler
6868 --------
6869
6870 - [rustc can now emit mir with `--emit mir`][39891]
6871 - [Improved LLVM IR for trivial functions][40367]
6872 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
6873 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
6874   opportunities found through profiling
6875 - [Improved backtrace formatting when panicking][38165]
6876
6877 Libraries
6878 ---------
6879
6880 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
6881   iterator hasn't been advanced the original `Vec` is reassembled with no actual
6882   iteration or reallocation.
6883 - [Simplified HashMap Bucket interface][40561] provides performance
6884   improvements for iterating and cloning.
6885 - [Specialize Vec::from_elem to use calloc][40409]
6886 - [Fixed Race condition in fs::create_dir_all][39799]
6887 - [No longer caching stdio on Windows][40516]
6888 - [Optimized insertion sort in slice][40807] insertion sort in some cases
6889   2.50%~ faster and in one case now 12.50% faster.
6890 - [Optimized `AtomicBool::fetch_nand`][41143]
6891
6892 Stabilized APIs
6893 ---------------
6894
6895 - [`Child::try_wait`]
6896 - [`HashMap::retain`]
6897 - [`HashSet::retain`]
6898 - [`PeekMut::pop`]
6899 - [`TcpStream::peek`]
6900 - [`UdpSocket::peek`]
6901 - [`UdpSocket::peek_from`]
6902
6903 Cargo
6904 -----
6905
6906 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
6907   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
6908 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
6909 - [Added Android build support][cargo/3885]
6910 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
6911   of a certain type, for example `cargo build --bins` will build all
6912   binaries.
6913 - [Added support for haiku][cargo/3952]
6914
6915 Misc
6916 ----
6917
6918 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
6919 - [Rust now uses the official cross compiler for NetBSD][40612]
6920 - [rustdoc now accepts `#` at the start of files][40828]
6921 - [Fixed jemalloc support for musl][41168]
6922
6923 Compatibility Notes
6924 -------------------
6925
6926 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
6927   always placed after the sign if it exists and before the digits. With the `#`
6928   flag the zeroes are placed after the prefix and before the digits.
6929 - [Due to the struct field optimisation][40377], using `transmute` on structs
6930   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
6931   always been undefined behavior, but is now more likely to break in practice.
6932 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
6933   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
6934   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
6935 - [Overlapping inherent `impl`s are now a hard error][40728]
6936 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
6937 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
6938   `out.asm` and `out.ll` instead of only one of the filetypes.
6939 - [ calling a function that returns `Self` will no longer work][41805] when
6940   the size of `Self` cannot be statically determined.
6941 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
6942   this has caused a few regressions namely:
6943
6944   - Changed the link order of local static/dynamic libraries (respecting the
6945     order on given rather than having the compiler reorder).
6946   - Changed how MinGW is linked, native code linked to dynamic libraries
6947     may require manually linking to the gcc support library (for the native
6948     code itself)
6949
6950 [38165]: https://github.com/rust-lang/rust/pull/38165
6951 [39799]: https://github.com/rust-lang/rust/pull/39799
6952 [39891]: https://github.com/rust-lang/rust/pull/39891
6953 [40043]: https://github.com/rust-lang/rust/pull/40043
6954 [40241]: https://github.com/rust-lang/rust/pull/40241
6955 [40338]: https://github.com/rust-lang/rust/pull/40338
6956 [40367]: https://github.com/rust-lang/rust/pull/40367
6957 [40377]: https://github.com/rust-lang/rust/pull/40377
6958 [40409]: https://github.com/rust-lang/rust/pull/40409
6959 [40516]: https://github.com/rust-lang/rust/pull/40516
6960 [40556]: https://github.com/rust-lang/rust/pull/40556
6961 [40561]: https://github.com/rust-lang/rust/pull/40561
6962 [40589]: https://github.com/rust-lang/rust/pull/40589
6963 [40612]: https://github.com/rust-lang/rust/pull/40612
6964 [40723]: https://github.com/rust-lang/rust/pull/40723
6965 [40728]: https://github.com/rust-lang/rust/pull/40728
6966 [40731]: https://github.com/rust-lang/rust/pull/40731
6967 [40734]: https://github.com/rust-lang/rust/pull/40734
6968 [40805]: https://github.com/rust-lang/rust/pull/40805
6969 [40807]: https://github.com/rust-lang/rust/pull/40807
6970 [40828]: https://github.com/rust-lang/rust/pull/40828
6971 [40870]: https://github.com/rust-lang/rust/pull/40870
6972 [41085]: https://github.com/rust-lang/rust/pull/41085
6973 [41143]: https://github.com/rust-lang/rust/pull/41143
6974 [41168]: https://github.com/rust-lang/rust/pull/41168
6975 [41270]: https://github.com/rust-lang/rust/issues/41270
6976 [41469]: https://github.com/rust-lang/rust/pull/41469
6977 [41805]: https://github.com/rust-lang/rust/issues/41805
6978 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
6979 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
6980 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
6981 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
6982 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
6983 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
6984 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
6985 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
6986 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
6987 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
6988 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
6989 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
6990 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
6991 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
6992
6993
6994 Version 1.17.0 (2017-04-27)
6995 ===========================
6996
6997 Language
6998 --------
6999
7000 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
7001 * [Fields of structs may be initialized without duplicating the field/variable
7002   names][39761]. [RFC 1682]
7003 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
7004 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
7005   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
7006   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
7007   `'b`. Soundness fix.
7008 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
7009 * [Static variables may contain references to other statics][40027]
7010
7011 Compiler
7012 --------
7013
7014 * [Exit quickly on only `--emit dep-info`][40336]
7015 * [Make `-C relocation-model` more correctly determine whether the linker
7016   creates a position-independent executable][40245]
7017 * [Add `-C overflow-checks` to directly control whether integer overflow
7018   panics][40037]
7019 * [The rustc type checker now checks items on demand instead of in a single
7020   in-order pass][40008]. This is mostly an internal refactoring in support of
7021   future work, including incremental type checking, but also resolves [RFC
7022   1647], allowing `Self` to appear in `impl` `where` clauses.
7023 * [Optimize vtable loads][39995]
7024 * [Turn off vectorization for Emscripten targets][39990]
7025 * [Provide suggestions for unknown macros imported with `use`][39953]
7026 * [Fix ICEs in path resolution][39939]
7027 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
7028 * [Add clearer error message using `&str + &str`][39116]
7029
7030 Stabilized APIs
7031 ---------------
7032
7033 * [`Arc::into_raw`]
7034 * [`Arc::from_raw`]
7035 * [`Arc::ptr_eq`]
7036 * [`Rc::into_raw`]
7037 * [`Rc::from_raw`]
7038 * [`Rc::ptr_eq`]
7039 * [`Ordering::then`]
7040 * [`Ordering::then_with`]
7041 * [`BTreeMap::range`]
7042 * [`BTreeMap::range_mut`]
7043 * [`collections::Bound`]
7044 * [`process::abort`]
7045 * [`ptr::read_unaligned`]
7046 * [`ptr::write_unaligned`]
7047 * [`Result::expect_err`]
7048 * [`Cell::swap`]
7049 * [`Cell::replace`]
7050 * [`Cell::into_inner`]
7051 * [`Cell::take`]
7052
7053 Libraries
7054 ---------
7055
7056 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
7057 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
7058 * [`String` implements `FromIterator<&char>`][40028]
7059 * `Box` [implements][40009] a number of new conversions:
7060   `From<Box<str>> for String`,
7061   `From<Box<[T]>> for Vec<T>`,
7062   `From<Box<CStr>> for CString`,
7063   `From<Box<OsStr>> for OsString`,
7064   `From<Box<Path>> for PathBuf`,
7065   `Into<Box<str>> for String`,
7066   `Into<Box<[T]>> for Vec<T>`,
7067   `Into<Box<CStr>> for CString`,
7068   `Into<Box<OsStr>> for OsString`,
7069   `Into<Box<Path>> for PathBuf`,
7070   `Default for Box<str>`,
7071   `Default for Box<CStr>`,
7072   `Default for Box<OsStr>`,
7073   `From<&CStr> for Box<CStr>`,
7074   `From<&OsStr> for Box<OsStr>`,
7075   `From<&Path> for Box<Path>`
7076 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
7077 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
7078 * [Slightly optimize `slice::sort`][39538]
7079 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
7080 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
7081   `Box<str>` implements `From<&str>`][39438]
7082 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
7083   `From<(I, u16)> where I: Into<IpAddr>`][39372]
7084 * [`format!` estimates the needed capacity before writing a string][39356]
7085 * [Support unprivileged symlink creation in Windows][38921]
7086 * [`PathBuf` implements `Default`][38764]
7087 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
7088 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
7089   and poor hash functions.
7090
7091 Cargo
7092 -----
7093
7094 * [Add `cargo check --all`][cargo/3731]
7095 * [Add an option to ignore SSL revocation checking][cargo/3699]
7096 * [Add `cargo run --package`][cargo/3691]
7097 * [Add `required_features`][cargo/3667]
7098 * [Assume `build.rs` is a build script][cargo/3664]
7099 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
7100
7101 Misc
7102 ----
7103
7104 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
7105   `rustbook`][39633]
7106 * [The "Unstable Book" documents nightly-only features][ubook]
7107 * [Improve the style of the sidebar in rustdoc output][40265]
7108 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
7109 * [Fix MSP430 breakage due to `i128`][40257]
7110 * [Preliminary Solaris/SPARCv9 support][39903]
7111 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
7112   run without installing the MSVC runtime.
7113 * [`rustdoc --test` includes file names in test names][39788]
7114 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
7115   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
7116 * [Initial support for `aarch64-unknown-freebsd`][39491]
7117 * [Initial support for `i686-unknown-netbsd`][39426]
7118 * [This release no longer includes the old makefile build system][39431]. Rust
7119   is built with a custom build system, written in Rust, and with Cargo.
7120 * [Add Debug implementations for libcollection structs][39002]
7121 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
7122 * [`--test-threads=0` produces an error][38945]
7123 * [`rustup` installs documentation by default][40526]
7124 * [The Rust source includes NatVis visualizations][39843]. These can be used by
7125   WinDbg and Visual Studio to improve the debugging experience.
7126
7127 Compatibility Notes
7128 -------------------
7129
7130 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
7131   workaround, either use MSVC 2015 or run vcvars.bat.
7132 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
7133   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
7134   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
7135   fix.
7136 * [`format!` and `Display::to_string` panic if an underlying formatting
7137   implementation returns an error][40117]. Previously the error was silently
7138   ignored. It is incorrect for `write_fmt` to return an error when writing
7139   to a string.
7140 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
7141   crates were marked stable and could be accessed from the stable toolchain.
7142 * [Rust git source no longer includes vendored crates][39728]. Those that need
7143   to build with vendored crates should build from release tarballs.
7144 * [Fix inert attributes from `proc_macro_derives`][39572]
7145 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
7146   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
7147   build system.
7148 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
7149   existing code generally ignores the type of dead-code unless a type-hint is
7150   provided; this can cause surprising inference interactions particularly around
7151   defaulting. The new code uniformly ignores the result type of dead-code.
7152 * [Tuple-struct constructors with private fields are no longer visible][38932]
7153 * [Lifetime parameters that do not appear in the arguments are now considered
7154   early-bound][38897], resolving a soundness bug (#[32330]). The
7155   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
7156   April of 2016.
7157 * [rustdoc: fix doctests with non-feature crate attributes][38161]
7158 * [Make transmuting from fn item types to pointer-sized types a hard
7159   error][34198]
7160
7161 [27787]: https://github.com/rust-lang/rust/issues/27787
7162 [32330]: https://github.com/rust-lang/rust/issues/32330
7163 [34198]: https://github.com/rust-lang/rust/pull/34198
7164 [38161]: https://github.com/rust-lang/rust/pull/38161
7165 [38368]: https://github.com/rust-lang/rust/pull/38368
7166 [38584]: https://github.com/rust-lang/rust/issues/38584
7167 [38661]: https://github.com/rust-lang/rust/pull/38661
7168 [38764]: https://github.com/rust-lang/rust/pull/38764
7169 [38864]: https://github.com/rust-lang/rust/issues/38864
7170 [38897]: https://github.com/rust-lang/rust/pull/38897
7171 [38921]: https://github.com/rust-lang/rust/pull/38921
7172 [38932]: https://github.com/rust-lang/rust/pull/38932
7173 [38945]: https://github.com/rust-lang/rust/pull/38945
7174 [38981]: https://github.com/rust-lang/rust/pull/38981
7175 [39002]: https://github.com/rust-lang/rust/pull/39002
7176 [39116]: https://github.com/rust-lang/rust/pull/39116
7177 [39193]: https://github.com/rust-lang/rust/pull/39193
7178 [39265]: https://github.com/rust-lang/rust/pull/39265
7179 [39356]: https://github.com/rust-lang/rust/pull/39356
7180 [39372]: https://github.com/rust-lang/rust/pull/39372
7181 [39426]: https://github.com/rust-lang/rust/pull/39426
7182 [39431]: https://github.com/rust-lang/rust/pull/39431
7183 [39438]: https://github.com/rust-lang/rust/pull/39438
7184 [39440]: https://github.com/rust-lang/rust/pull/39440
7185 [39485]: https://github.com/rust-lang/rust/pull/39485
7186 [39491]: https://github.com/rust-lang/rust/pull/39491
7187 [39518]: https://github.com/rust-lang/rust/pull/39518
7188 [39538]: https://github.com/rust-lang/rust/pull/39538
7189 [39572]: https://github.com/rust-lang/rust/pull/39572
7190 [39633]: https://github.com/rust-lang/rust/pull/39633
7191 [39642]: https://github.com/rust-lang/rust/pull/39642
7192 [39728]: https://github.com/rust-lang/rust/pull/39728
7193 [39761]: https://github.com/rust-lang/rust/pull/39761
7194 [39788]: https://github.com/rust-lang/rust/pull/39788
7195 [39793]: https://github.com/rust-lang/rust/pull/39793
7196 [39837]: https://github.com/rust-lang/rust/pull/39837
7197 [39843]: https://github.com/rust-lang/rust/pull/39843
7198 [39851]: https://github.com/rust-lang/rust/pull/39851
7199 [39903]: https://github.com/rust-lang/rust/pull/39903
7200 [39939]: https://github.com/rust-lang/rust/pull/39939
7201 [39953]: https://github.com/rust-lang/rust/pull/39953
7202 [39960]: https://github.com/rust-lang/rust/pull/39960
7203 [39990]: https://github.com/rust-lang/rust/pull/39990
7204 [39995]: https://github.com/rust-lang/rust/pull/39995
7205 [40008]: https://github.com/rust-lang/rust/pull/40008
7206 [40009]: https://github.com/rust-lang/rust/pull/40009
7207 [40027]: https://github.com/rust-lang/rust/pull/40027
7208 [40028]: https://github.com/rust-lang/rust/pull/40028
7209 [40037]: https://github.com/rust-lang/rust/pull/40037
7210 [40117]: https://github.com/rust-lang/rust/pull/40117
7211 [40166]: https://github.com/rust-lang/rust/pull/40166
7212 [40245]: https://github.com/rust-lang/rust/pull/40245
7213 [40257]: https://github.com/rust-lang/rust/pull/40257
7214 [40261]: https://github.com/rust-lang/rust/pull/40261
7215 [40265]: https://github.com/rust-lang/rust/pull/40265
7216 [40319]: https://github.com/rust-lang/rust/pull/40319
7217 [40336]: https://github.com/rust-lang/rust/pull/40336
7218 [40526]: https://github.com/rust-lang/rust/pull/40526
7219 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
7220 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
7221 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
7222 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
7223 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
7224 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
7225 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
7226 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
7227 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
7228 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
7229 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
7230 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
7231 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
7232 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
7233 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
7234 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
7235 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
7236 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
7237 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
7238 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
7239 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
7240 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
7241 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
7242 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
7243 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
7244 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
7245 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
7246 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
7247 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
7248 [ubook]: https://doc.rust-lang.org/unstable-book/
7249
7250
7251 Version 1.16.0 (2017-03-16)
7252 ===========================
7253
7254 Language
7255 --------
7256
7257 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
7258 * [Uninhabitable enums (those without any variants) no longer permit wildcard
7259   match patterns][38069]
7260 * [Clean up semantics of `self` in an import list][38313]
7261 * [`Self` may appear in `impl` headers][38920]
7262 * [`Self` may appear in struct expressions][39282]
7263
7264 Compiler
7265 --------
7266
7267 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
7268   a `.rmeta` file containing only crate metadata][38571]. This can be
7269   used by tools like the Rust Language Service to perform
7270   metadata-only builds.
7271 * [Levenshtein based typo suggestions now work in most places, while
7272   previously they worked only for fields and sometimes for local
7273   variables][38927]. Together with the overhaul of "no
7274   resolution"/"unexpected resolution" errors (#[38154]) they result in
7275   large and systematic improvement in resolution diagnostics.
7276 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
7277   `U`][38670]
7278 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
7279 * [`rustc` no longer attempts to provide "consider using an explicit
7280   lifetime" suggestions][37057]. They were inaccurate.
7281
7282 Stabilized APIs
7283 ---------------
7284
7285 * [`VecDeque::truncate`]
7286 * [`VecDeque::resize`]
7287 * [`String::insert_str`]
7288 * [`Duration::checked_add`]
7289 * [`Duration::checked_sub`]
7290 * [`Duration::checked_div`]
7291 * [`Duration::checked_mul`]
7292 * [`str::replacen`]
7293 * [`str::repeat`]
7294 * [`SocketAddr::is_ipv4`]
7295 * [`SocketAddr::is_ipv6`]
7296 * [`IpAddr::is_ipv4`]
7297 * [`IpAddr::is_ipv6`]
7298 * [`Vec::dedup_by`]
7299 * [`Vec::dedup_by_key`]
7300 * [`Result::unwrap_or_default`]
7301 * [`<*const T>::wrapping_offset`]
7302 * [`<*mut T>::wrapping_offset`]
7303 * `CommandExt::creation_flags`
7304 * [`File::set_permissions`]
7305 * [`String::split_off`]
7306
7307 Libraries
7308 ---------
7309
7310 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
7311   their argument by `Borrow` parameter][37761]
7312 * [All public types in std implement `Debug`][38006]
7313 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
7314 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
7315 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
7316   Windows][38274]
7317 * [std: Fix partial writes in `LineWriter`][38062]
7318 * [std: Clamp max read/write sizes on Unix][38622]
7319 * [Use more specific panic message for `&str` slicing errors][38066]
7320 * [`TcpListener::set_only_v6` is deprecated][38304]. This
7321   functionality cannot be achieved in std currently.
7322 * [`writeln!`, like `println!`, now accepts a form with no string
7323   or formatting arguments, to just print a newline][38469]
7324 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
7325 * [Reduce the size of static data in `std_unicode::tables`][38781]
7326 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
7327   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
7328   `Display`][38909]
7329 * [`Duration` implements `Sum`][38712]
7330 * [`String` implements `ToSocketAddrs`][39048]
7331
7332 Cargo
7333 -----
7334
7335 * [The `cargo check` command does a type check of a project without
7336   building it][cargo/3296]
7337 * [crates.io will display CI badges from Travis and AppVeyor, if
7338   specified in Cargo.toml][cargo/3546]
7339 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
7340 * [Compilation profiles accept integer values for `debug`, in addition
7341   to `true` and `false`. These are passed to `rustc` as the value to
7342   `-C debuginfo`][cargo/3534]
7343 * [Implement `cargo --version --verbose`][cargo/3604]
7344 * [All builds now output 'dep-info' build dependencies compatible with
7345   make and ninja][cargo/3557]
7346 * [Build all workspace members with `build --all`][cargo/3511]
7347 * [Document all workspace members with `doc --all`][cargo/3515]
7348 * [Path deps outside workspace are not members][cargo/3443]
7349
7350 Misc
7351 ----
7352
7353 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
7354   the path to the Rust implementation][38589]
7355 * [The `armv7-linux-androideabi` target no longer enables NEON
7356   extensions, per Google's ABI guide][38413]
7357 * [The stock standard library can be compiled for Redox OS][38401]
7358 * [Rust has initial SPARC support][38726]. Tier 3. No builds
7359   available.
7360 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
7361   builds available.
7362 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
7363
7364 Compatibility Notes
7365 -------------------
7366
7367 * [Uninhabitable enums (those without any variants) no longer permit wildcard
7368   match patterns][38069]
7369 * In this release, references to uninhabited types can not be
7370   pattern-matched. This was accidentally allowed in 1.15.
7371 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
7372 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
7373   Windows][38274]
7374 * [Clean up semantics of `self` in an import list][38313]
7375 * Reimplemented lifetime elision. This change was almost entirely compatible
7376   with existing code, but it did close a number of small bugs and loopholes,
7377   as well as being more accepting in some other [cases][41105].
7378
7379 [37057]: https://github.com/rust-lang/rust/pull/37057
7380 [37761]: https://github.com/rust-lang/rust/pull/37761
7381 [38006]: https://github.com/rust-lang/rust/pull/38006
7382 [38051]: https://github.com/rust-lang/rust/pull/38051
7383 [38062]: https://github.com/rust-lang/rust/pull/38062
7384 [38622]: https://github.com/rust-lang/rust/pull/38622
7385 [38066]: https://github.com/rust-lang/rust/pull/38066
7386 [38069]: https://github.com/rust-lang/rust/pull/38069
7387 [38131]: https://github.com/rust-lang/rust/pull/38131
7388 [38154]: https://github.com/rust-lang/rust/pull/38154
7389 [38274]: https://github.com/rust-lang/rust/pull/38274
7390 [38304]: https://github.com/rust-lang/rust/pull/38304
7391 [38313]: https://github.com/rust-lang/rust/pull/38313
7392 [38327]: https://github.com/rust-lang/rust/pull/38327
7393 [38401]: https://github.com/rust-lang/rust/pull/38401
7394 [38413]: https://github.com/rust-lang/rust/pull/38413
7395 [38469]: https://github.com/rust-lang/rust/pull/38469
7396 [38559]: https://github.com/rust-lang/rust/pull/38559
7397 [38571]: https://github.com/rust-lang/rust/pull/38571
7398 [38580]: https://github.com/rust-lang/rust/pull/38580
7399 [38589]: https://github.com/rust-lang/rust/pull/38589
7400 [38670]: https://github.com/rust-lang/rust/pull/38670
7401 [38712]: https://github.com/rust-lang/rust/pull/38712
7402 [38726]: https://github.com/rust-lang/rust/pull/38726
7403 [38781]: https://github.com/rust-lang/rust/pull/38781
7404 [38798]: https://github.com/rust-lang/rust/pull/38798
7405 [38909]: https://github.com/rust-lang/rust/pull/38909
7406 [38920]: https://github.com/rust-lang/rust/pull/38920
7407 [38927]: https://github.com/rust-lang/rust/pull/38927
7408 [39048]: https://github.com/rust-lang/rust/pull/39048
7409 [39282]: https://github.com/rust-lang/rust/pull/39282
7410 [39379]: https://github.com/rust-lang/rust/pull/39379
7411 [41105]: https://github.com/rust-lang/rust/issues/41105
7412 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
7413 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
7414 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
7415 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
7416 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
7417 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
7418 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
7419 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
7420 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
7421 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
7422 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
7423 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
7424 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
7425 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
7426 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
7427 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
7428 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
7429 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
7430 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
7431 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
7432 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
7433 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
7434 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
7435 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
7436 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
7437 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
7438 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
7439 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
7440 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
7441
7442
7443 Version 1.15.1 (2017-02-09)
7444 ===========================
7445
7446 * [Fix IntoIter::as_mut_slice's signature][39466]
7447 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
7448
7449 [39466]: https://github.com/rust-lang/rust/pull/39466
7450 [39523]: https://github.com/rust-lang/rust/pull/39523
7451
7452
7453 Version 1.15.0 (2017-02-02)
7454 ===========================
7455
7456 Language
7457 --------
7458
7459 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
7460   stable. This allows popular code-generating crates like Serde and Diesel to
7461   work ergonomically. [RFC 1681].
7462 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
7463   with curly braces][36868]. Part of [RFC 1506].
7464 * [A number of minor changes to name resolution have been activated][37127].
7465   They add up to more consistent semantics, allowing for future evolution of
7466   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
7467   details of what is different. The breaking changes here have been transitioned
7468   through the [`legacy_imports`] lint since 1.14, with no known regressions.
7469 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
7470   bounds][38279]
7471 * [`?Sized` can be used in `where` clauses][37791]
7472 * [There is now a limit on the size of monomorphized types and it can be
7473   modified with the `#![type_size_limit]` crate attribute, similarly to
7474   the `#![recursion_limit]` attribute][37789]
7475
7476 Compiler
7477 --------
7478
7479 * [On Windows, the compiler will apply dllimport attributes when linking to
7480   extern functions][37973]. Additional attributes and flags can control which
7481   library kind is linked and its name. [RFC 1717].
7482 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
7483 * [The `--test` flag works with procedural macro crates][38107]
7484 * [Fix `extern "aapcs" fn` ABI][37814]
7485 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
7486 * [The `format!` expander recognizes incorrect `printf` and shell-style
7487   formatting directives and suggests the correct format][37613].
7488 * [Only report one error for all unused imports in an import list][37456]
7489
7490 Compiler Performance
7491 --------------------
7492
7493 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
7494 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
7495 * [Don't clone in `UnificationTable::probe`][37848]
7496 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
7497 * [Use small vectors in type walker][37760]
7498 * [Macro expansion performance was improved][37701]
7499 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
7500 * [Replace FNV with a faster hash function][37229]
7501
7502 Stabilized APIs
7503 ---------------
7504
7505 * [`std::iter::Iterator::min_by`]
7506 * [`std::iter::Iterator::max_by`]
7507 * [`std::os::*::fs::FileExt`]
7508 * [`std::sync::atomic::Atomic*::get_mut`]
7509 * [`std::sync::atomic::Atomic*::into_inner`]
7510 * [`std::vec::IntoIter::as_slice`]
7511 * [`std::vec::IntoIter::as_mut_slice`]
7512 * [`std::sync::mpsc::Receiver::try_iter`]
7513 * [`std::os::unix::process::CommandExt::before_exec`]
7514 * [`std::rc::Rc::strong_count`]
7515 * [`std::rc::Rc::weak_count`]
7516 * [`std::sync::Arc::strong_count`]
7517 * [`std::sync::Arc::weak_count`]
7518 * [`std::char::encode_utf8`]
7519 * [`std::char::encode_utf16`]
7520 * [`std::cell::Ref::clone`]
7521 * [`std::io::Take::into_inner`]
7522
7523 Libraries
7524 ---------
7525
7526 * [The standard sorting algorithm has been rewritten for dramatic performance
7527   improvements][38192]. It is a hybrid merge sort, drawing influences from
7528   Timsort. Previously it was a naive merge sort.
7529 * [`Iterator::nth` no longer has a `Sized` bound][38134]
7530 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
7531   performance.
7532 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
7533   and `char_indices().last()`][37882]
7534 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
7535 * [Chinese characters display correctly in `fmt::Debug`][37855]
7536 * [Derive `Default` for `Duration`][37699]
7537 * [Support creation of anonymous pipes on WinXP/2k][37677]
7538 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
7539 * [Don't pass overlapped handles to processes][38835]
7540
7541 Cargo
7542 -----
7543
7544 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
7545   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
7546   should instead check the variable at runtime with `std::env`. That the value
7547   was set at build time was a bug, and incorrect when cross-compiling. This
7548   change is known to cause breakage.
7549 * [Add `--all` flag to `cargo test`][cargo/3221]
7550 * [Compile statically against the MSVC CRT][cargo/3363]
7551 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
7552 * [Link OpenSSL statically on OSX][cargo/3311]
7553 * [Apply new fingerprinting to build dir outputs][cargo/3310]
7554 * [Test for bad path overrides with summaries][cargo/3336]
7555 * [Require `cargo install --vers` to take a semver version][cargo/3338]
7556 * [Fix retrying crate downloads for network errors][cargo/3348]
7557 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
7558 * [Emit more info on --message-format=json][cargo/3319]
7559 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
7560 * [Don't ignore errors in workspace manifest][cargo/3409]
7561 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
7562
7563 Tooling
7564 -------
7565
7566 * [Test runners (binaries built with `--test`) now support a `--list` argument
7567   that lists the tests it contains][38185]
7568 * [Test runners now support a `--exact` argument that makes the test filter
7569   match exactly, instead of matching only a substring of the test name][38181]
7570 * [rustdoc supports a `--playground-url` flag][37763]
7571 * [rustdoc provides more details about `#[should_panic]` errors][37749]
7572
7573 Misc
7574 ----
7575
7576 * [The Rust build system is now written in Rust][37817]. The Makefiles may
7577   continue to be used in this release by passing `--disable-rustbuild` to the
7578   configure script, but they will be deleted soon. Note that the new build
7579   system uses a different on-disk layout that will likely affect any scripts
7580   building Rust.
7581 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
7582   releases.
7583 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
7584 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
7585   releases.
7586
7587 Compatibility Notes
7588 -------------------
7589
7590 * [A number of minor changes to name resolution have been activated][37127].
7591   They add up to more consistent semantics, allowing for future evolution of
7592   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
7593   details of what is different. The breaking changes here have been transitioned
7594   through the [`legacy_imports`] lint since 1.14, with no known regressions.
7595 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
7596   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
7597   should instead check the variable at runtime with `std::env`. That the value
7598   was set at build time was a bug, and incorrect when cross-compiling. This
7599   change is known to cause breakage.
7600 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
7601   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
7602   1.10 and is now an error by default. It will become a hard error in the near
7603   future.
7604 * [The semantics relating modules to file system directories are changing in
7605   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
7606   lint, which is a warning in this release, and will become a hard error in the
7607   future.
7608 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
7609 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
7610   the underlying iterator][37834]
7611
7612 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
7613 [33685]: https://github.com/rust-lang/rust/issues/33685
7614 [36868]: https://github.com/rust-lang/rust/pull/36868
7615 [37127]: https://github.com/rust-lang/rust/pull/37127
7616 [37229]: https://github.com/rust-lang/rust/pull/37229
7617 [37456]: https://github.com/rust-lang/rust/pull/37456
7618 [37527]: https://github.com/rust-lang/rust/pull/37527
7619 [37602]: https://github.com/rust-lang/rust/pull/37602
7620 [37613]: https://github.com/rust-lang/rust/pull/37613
7621 [37615]: https://github.com/rust-lang/rust/pull/37615
7622 [37636]: https://github.com/rust-lang/rust/pull/37636
7623 [37627]: https://github.com/rust-lang/rust/pull/37627
7624 [37642]: https://github.com/rust-lang/rust/pull/37642
7625 [37677]: https://github.com/rust-lang/rust/pull/37677
7626 [37699]: https://github.com/rust-lang/rust/pull/37699
7627 [37701]: https://github.com/rust-lang/rust/pull/37701
7628 [37705]: https://github.com/rust-lang/rust/pull/37705
7629 [37749]: https://github.com/rust-lang/rust/pull/37749
7630 [37760]: https://github.com/rust-lang/rust/pull/37760
7631 [37763]: https://github.com/rust-lang/rust/pull/37763
7632 [37764]: https://github.com/rust-lang/rust/pull/37764
7633 [37789]: https://github.com/rust-lang/rust/pull/37789
7634 [37791]: https://github.com/rust-lang/rust/pull/37791
7635 [37814]: https://github.com/rust-lang/rust/pull/37814
7636 [37817]: https://github.com/rust-lang/rust/pull/37817
7637 [37834]: https://github.com/rust-lang/rust/pull/37834
7638 [37848]: https://github.com/rust-lang/rust/pull/37848
7639 [37855]: https://github.com/rust-lang/rust/pull/37855
7640 [37882]: https://github.com/rust-lang/rust/pull/37882
7641 [37888]: https://github.com/rust-lang/rust/pull/37888
7642 [37973]: https://github.com/rust-lang/rust/pull/37973
7643 [37979]: https://github.com/rust-lang/rust/pull/37979
7644 [38086]: https://github.com/rust-lang/rust/pull/38086
7645 [38107]: https://github.com/rust-lang/rust/pull/38107
7646 [38117]: https://github.com/rust-lang/rust/pull/38117
7647 [38134]: https://github.com/rust-lang/rust/pull/38134
7648 [38146]: https://github.com/rust-lang/rust/pull/38146
7649 [38181]: https://github.com/rust-lang/rust/pull/38181
7650 [38182]: https://github.com/rust-lang/rust/pull/38182
7651 [38185]: https://github.com/rust-lang/rust/pull/38185
7652 [38192]: https://github.com/rust-lang/rust/pull/38192
7653 [38279]: https://github.com/rust-lang/rust/pull/38279
7654 [38835]: https://github.com/rust-lang/rust/pull/38835
7655 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
7656 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
7657 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
7658 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
7659 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
7660 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
7661 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
7662 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
7663 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
7664 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
7665 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
7666 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
7667 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
7668 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
7669 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
7670 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
7671 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
7672 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
7673 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
7674 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
7675 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
7676 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
7677 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
7678 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
7679 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
7680 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
7681 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
7682 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
7683 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
7684 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
7685 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
7686 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
7687 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
7688 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
7689 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
7690 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
7691 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
7692
7693
7694 Version 1.14.0 (2016-12-22)
7695 ===========================
7696
7697 Language
7698 --------
7699
7700 * [`..` matches multiple tuple fields in enum variants, structs
7701   and tuples][36843]. [RFC 1492].
7702 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
7703 * [`use *` and `use ::*` both glob-import from the crate root][37367]
7704 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
7705   dereferencing][36822]
7706
7707 Compiler
7708 --------
7709
7710 * [Mark enums with non-zero discriminant as non-zero][37224]
7711 * [Lower-case `static mut` names are linted like other
7712   statics and consts][37162]
7713 * [Fix ICE on some macros in const integer positions
7714    (e.g. `[u8; m!()]`)][36819]
7715 * [Improve error message and snippet for "did you mean `x`"][36798]
7716 * [Add a panic-strategy field to the target specification][36794]
7717 * [Include LLVM version in `--version --verbose`][37200]
7718
7719 Compile-time Optimizations
7720 --------------------------
7721
7722 * [Improve macro expansion performance][37569]
7723 * [Shrink `Expr_::ExprInlineAsm`][37445]
7724 * [Replace all uses of SHA-256 with BLAKE2b][37439]
7725 * [Reduce the number of bytes hashed by `IchHasher`][37427]
7726 * [Avoid more allocations when compiling html5ever][37373]
7727 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
7728 * [Avoid some allocations in the macro parser][37318]
7729 * [Use a faster deflate setting][37298]
7730 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
7731   during interning of slices][37270]
7732 * [Optimize `write_metadata`][37267]
7733 * [Don't process obligation forest cycles when stalled][37231]
7734 * [Avoid many `CrateConfig` clones][37161]
7735 * [Optimize `Substs::super_fold_with`][37108]
7736 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
7737 * [Speed up `plug_leaks`][36917]
7738
7739 Libraries
7740 ---------
7741
7742 * [`println!()`, with no arguments, prints newline][36825].
7743   Previously, an empty string was required to achieve the same.
7744 * [`Wrapping` impls standard binary and unary operators, as well as
7745    the `Sum` and `Product` iterators][37356]
7746 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
7747   Vec<T>`][37326]
7748 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
7749   `VecDeque` iterators][37315]
7750 * [Improve `SipHasher` performance on small values][37312]
7751 * [Add Iterator trait TrustedLen to enable better FromIterator /
7752   Extend][37306]
7753 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
7754 * [`ReadDir` implements `Debug`][37221]
7755 * [Implement `RefUnwindSafe` for atomic types][37178]
7756 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
7757 * [Avoid allocations in `Decoder::read_str`][37064]
7758 * [`io::Error` implements `From<io::ErrorKind>`][37037]
7759 * [Impl `Debug` for raw pointers to unsized data][36880]
7760 * [Don't reuse `HashMap` random seeds][37470]
7761 * [The internal memory layout of `HashMap` is more cache-friendly, for
7762   significant improvements in some operations][36692]
7763 * [`HashMap` uses less memory on 32-bit architectures][36595]
7764 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
7765
7766 Cargo
7767 -----
7768
7769 * [Expose rustc cfg values to build scripts][cargo/3243]
7770 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
7771 * [Fix passing --features when testing multiple packages][cargo/3280]
7772 * [Use a single profile set per workspace][cargo/3249]
7773 * [Load `replace` sections from lock files][cargo/3220]
7774 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
7775
7776 Tooling
7777 -------
7778
7779 * [rustup is the recommended Rust installation method][1.14rustup]
7780 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
7781   S390x. These are [tier 2] platforms and may have major defects. Follow the
7782   instructions on the website to install, or add the targets to an existing
7783   installation with `rustup target add`. The new target triples are:
7784   - `mips-unknown-linux-gnu`
7785   - `mipsel-unknown-linux-gnu`
7786   - `mips64-unknown-linux-gnuabi64`
7787   - `mips64el-unknown-linux-gnuabi64 `
7788   - `powerpc-unknown-linux-gnu`
7789   - `powerpc64-unknown-linux-gnu`
7790   - `powerpc64le-unknown-linux-gnu`
7791   - `s390x-unknown-linux-gnu `
7792 * This release includes target (std) builds for ARM Linux running MUSL
7793   libc. These are [tier 2] platforms and may have major defects. Add the
7794   following triples to an existing rustup installation with `rustup target add`:
7795   - `arm-unknown-linux-musleabi`
7796   - `arm-unknown-linux-musleabihf`
7797   - `armv7-unknown-linux-musleabihf`
7798 * This release includes [experimental support for WebAssembly][1.14wasm], via
7799   the `wasm32-unknown-emscripten` target. This target is known to have major
7800   defects. Please test, report, and fix.
7801 * rustup no longer installs documentation by default. Run `rustup
7802   component add rust-docs` to install.
7803 * [Fix line stepping in debugger][37310]
7804 * [Enable line number debuginfo in releases][37280]
7805
7806 Misc
7807 ----
7808
7809 * [Disable jemalloc on aarch64/powerpc/mips][37392]
7810 * [Add support for Fuchsia OS][37313]
7811 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
7812
7813 Compatibility Notes
7814 -------------------
7815
7816 * [A number of forward-compatibility lints used by the compiler
7817   to gradually introduce language changes have been converted
7818   to deny by default][36894]:
7819   - ["use of inaccessible extern crate erroneously allowed"][36886]
7820   - ["type parameter default erroneously allowed in invalid location"][36887]
7821   - ["detects super or self keywords at the beginning of global path"][36888]
7822   - ["two overlapping inherent impls define an item with the same name
7823     were erroneously allowed"][36889]
7824   - ["floating-point constants cannot be used in patterns"][36890]
7825   - ["constants of struct or enum type can only be used in a pattern if
7826      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
7827   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
7828 * [Prohibit patterns in trait methods without bodies][37378]
7829 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
7830 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
7831 * [The `$crate` macro variable is accepted in fewer locations][37213]
7832 * [Impls specifying extra region requirements beyond the trait
7833   they implement are rejected][37167]
7834 * [Enums may not be unsized][37111]. Unsized enums are intended to
7835   work but never have. For now they are forbidden.
7836 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
7837
7838 [tier 2]: https://forge.rust-lang.org/platform-support.html
7839 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
7840 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
7841 [36430]: https://github.com/rust-lang/rust/pull/36430
7842 [36595]: https://github.com/rust-lang/rust/pull/36595
7843 [36692]: https://github.com/rust-lang/rust/pull/36692
7844 [36767]: https://github.com/rust-lang/rust/pull/36767
7845 [36794]: https://github.com/rust-lang/rust/pull/36794
7846 [36798]: https://github.com/rust-lang/rust/pull/36798
7847 [36819]: https://github.com/rust-lang/rust/pull/36819
7848 [36822]: https://github.com/rust-lang/rust/pull/36822
7849 [36825]: https://github.com/rust-lang/rust/pull/36825
7850 [36843]: https://github.com/rust-lang/rust/pull/36843
7851 [36880]: https://github.com/rust-lang/rust/pull/36880
7852 [36886]: https://github.com/rust-lang/rust/issues/36886
7853 [36887]: https://github.com/rust-lang/rust/issues/36887
7854 [36888]: https://github.com/rust-lang/rust/issues/36888
7855 [36889]: https://github.com/rust-lang/rust/issues/36889
7856 [36890]: https://github.com/rust-lang/rust/issues/36890
7857 [36891]: https://github.com/rust-lang/rust/issues/36891
7858 [36892]: https://github.com/rust-lang/rust/issues/36892
7859 [36894]: https://github.com/rust-lang/rust/pull/36894
7860 [36917]: https://github.com/rust-lang/rust/pull/36917
7861 [36993]: https://github.com/rust-lang/rust/pull/36993
7862 [37037]: https://github.com/rust-lang/rust/pull/37037
7863 [37064]: https://github.com/rust-lang/rust/pull/37064
7864 [37094]: https://github.com/rust-lang/rust/pull/37094
7865 [37108]: https://github.com/rust-lang/rust/pull/37108
7866 [37111]: https://github.com/rust-lang/rust/pull/37111
7867 [37161]: https://github.com/rust-lang/rust/pull/37161
7868 [37162]: https://github.com/rust-lang/rust/pull/37162
7869 [37167]: https://github.com/rust-lang/rust/pull/37167
7870 [37178]: https://github.com/rust-lang/rust/pull/37178
7871 [37200]: https://github.com/rust-lang/rust/pull/37200
7872 [37213]: https://github.com/rust-lang/rust/pull/37213
7873 [37221]: https://github.com/rust-lang/rust/pull/37221
7874 [37224]: https://github.com/rust-lang/rust/pull/37224
7875 [37230]: https://github.com/rust-lang/rust/pull/37230
7876 [37231]: https://github.com/rust-lang/rust/pull/37231
7877 [37247]: https://github.com/rust-lang/rust/pull/37247
7878 [37267]: https://github.com/rust-lang/rust/pull/37267
7879 [37270]: https://github.com/rust-lang/rust/pull/37270
7880 [37273]: https://github.com/rust-lang/rust/pull/37273
7881 [37280]: https://github.com/rust-lang/rust/pull/37280
7882 [37298]: https://github.com/rust-lang/rust/pull/37298
7883 [37306]: https://github.com/rust-lang/rust/pull/37306
7884 [37310]: https://github.com/rust-lang/rust/pull/37310
7885 [37312]: https://github.com/rust-lang/rust/pull/37312
7886 [37313]: https://github.com/rust-lang/rust/pull/37313
7887 [37315]: https://github.com/rust-lang/rust/pull/37315
7888 [37318]: https://github.com/rust-lang/rust/pull/37318
7889 [37322]: https://github.com/rust-lang/rust/pull/37322
7890 [37326]: https://github.com/rust-lang/rust/pull/37326
7891 [37351]: https://github.com/rust-lang/rust/pull/37351
7892 [37356]: https://github.com/rust-lang/rust/pull/37356
7893 [37367]: https://github.com/rust-lang/rust/pull/37367
7894 [37373]: https://github.com/rust-lang/rust/pull/37373
7895 [37378]: https://github.com/rust-lang/rust/pull/37378
7896 [37389]: https://github.com/rust-lang/rust/pull/37389
7897 [37392]: https://github.com/rust-lang/rust/pull/37392
7898 [37427]: https://github.com/rust-lang/rust/pull/37427
7899 [37439]: https://github.com/rust-lang/rust/pull/37439
7900 [37445]: https://github.com/rust-lang/rust/pull/37445
7901 [37470]: https://github.com/rust-lang/rust/pull/37470
7902 [37569]: https://github.com/rust-lang/rust/pull/37569
7903 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
7904 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
7905 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
7906 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
7907 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
7908 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
7909 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
7910
7911
7912 Version 1.13.0 (2016-11-10)
7913 ===========================
7914
7915 Language
7916 --------
7917
7918 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
7919   errors, like the `try!` macro, described in [RFC 0243].
7920 * [Stabilize macros in type position][36014]. Described in [RFC 873].
7921 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
7922 * [Fix `#[derive]` for empty tuple structs/variants][35728]
7923 * [Fix lifetime rules for 'if' conditions][36029]
7924 * [Avoid loading and parsing unconfigured non-inline modules][36482]
7925
7926 Compiler
7927 --------
7928
7929 * [Add the `-C link-arg` argument][36574]
7930 * [Remove the old AST-based backend from rustc_trans][35764]
7931 * [Don't enable NEON by default on armv7 Linux][35814]
7932 * [Fix debug line number info for macro expansions][35238]
7933 * [Do not emit "class method" debuginfo for types that are not
7934   DICompositeType][36008]
7935 * [Warn about multiple conflicting #[repr] hints][34623]
7936 * [When sizing DST, don't double-count nested struct prefixes][36351]
7937 * [Default RUST_MIN_STACK to 16MiB for now][36505]
7938 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
7939 * [Reject macros with empty repetitions to avoid infinite loop][36721]
7940 * [Expand macros without recursing to avoid stack overflows][36214]
7941
7942 Diagnostics
7943 -----------
7944
7945 * [Replace macro backtraces with labeled local uses][35702]
7946 * [Improve error message for misplaced doc comments][33922]
7947 * [Buffer unix and lock windows to prevent message interleaving][35975]
7948 * [Update lifetime errors to specifically note temporaries][36171]
7949 * [Special case a few colors for Windows][36178]
7950 * [Suggest `use self` when such an import resolves][36289]
7951 * [Be more specific when type parameter shadows primitive type][36338]
7952 * Many minor improvements
7953
7954 Compile-time Optimizations
7955 --------------------------
7956
7957 * [Compute and cache HIR hashes at beginning][35854]
7958 * [Don't hash types in loan paths][36004]
7959 * [Cache projections in trans][35761]
7960 * [Optimize the parser's last token handling][36527]
7961 * [Only instantiate #[inline] functions in codegen units referencing
7962   them][36524]. This leads to big improvements in cases where crates export
7963   define many inline functions without using them directly.
7964 * [Lazily allocate TypedArena's first chunk][36592]
7965 * [Don't allocate during default HashSet creation][36734]
7966
7967 Stabilized APIs
7968 ---------------
7969
7970 * [`checked_abs`]
7971 * [`wrapping_abs`]
7972 * [`overflowing_abs`]
7973 * [`RefCell::try_borrow`]
7974 * [`RefCell::try_borrow_mut`]
7975
7976 Libraries
7977 ---------
7978
7979 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
7980 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
7981   covariant][35354]
7982 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
7983 * [Implement `Debug` for `std::vec::IntoIter`][35707]
7984 * [`CString`: avoid excessive growth just to 0-terminate][35871]
7985 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
7986 * [Use arc4rand on FreeBSD][35884]
7987 * [memrchr: Correct aligned offset computation][35969]
7988 * [Improve Demangling of Rust Symbols][36059]
7989 * [Use monotonic time in condition variables][35048]
7990 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
7991 * [Implement conversion traits for `char`][35755]
7992 * [Fix illegal instruction caused by overflow in channel cloning][36104]
7993 * [Zero first byte of CString on drop][36264]
7994 * [Inherit overflow checks for sum and product][36372]
7995 * [Add missing Eq implementations][36423]
7996 * [Implement `Debug` for `DirEntry`][36631]
7997 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
7998   `errno`][36754]
7999 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
8000 * [Implement more traits for `std::io::ErrorKind`][35911]
8001 * [Optimize BinaryHeap bounds checking][36072]
8002 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
8003   `extend_with_element`][36355]
8004 * [Fix overflow checking in unsigned pow()][34942]
8005
8006 Cargo
8007 -----
8008
8009 * This release includes security fixes to both curl and OpenSSL.
8010 * [Fix transitive doctests when panic=abort][cargo/3021]
8011 * [Add --all-features flag to cargo][cargo/3038]
8012 * [Reject path-based dependencies in `cargo package`][cargo/3060]
8013 * [Don't parse the home directory more than once][cargo/3078]
8014 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
8015 * [Update OpenSSL to 1.0.2j][cargo/3121]
8016 * [Add license and license_file to cargo metadata output][cargo/3110]
8017 * [Make crates-io registry URL optional in config; ignore all changes to
8018   source.crates-io][cargo/3089]
8019 * [Don't download dependencies from other platforms][cargo/3123]
8020 * [Build transitive dev-dependencies when needed][cargo/3125]
8021 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
8022 * [Avoid updating registry when adding existing deps][cargo/3144]
8023 * [Warn about path overrides that won't work][cargo/3136]
8024 * [Use workspaces during `cargo install`][cargo/3146]
8025 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
8026 * [Add --message-format flag][cargo/3000]
8027 * [Pass target environment for rustdoc][cargo/3205]
8028 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
8029 * [Update curl and curl-sys][cargo/3241]
8030 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
8031
8032 Tooling
8033 -------
8034
8035 * [rustdoc: Add the `--sysroot` argument][36586]
8036 * [rustdoc: Fix a couple of issues with the search results][35655]
8037 * [rustdoc: remove the `!` from macro URLs and titles][35234]
8038 * [gdb: Fix pretty-printing special-cased Rust types][35585]
8039 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
8040
8041 Misc
8042 ----
8043
8044 * [Remove unmaintained style guide][35124]
8045 * [Add s390x support][36369]
8046 * [Initial work at Haiku OS support][36727]
8047 * [Add mips-uclibc targets][35734]
8048 * [Crate-ify compiler-rt into compiler-builtins][35021]
8049 * [Add rustc version info (git hash + date) to dist tarball][36213]
8050 * Many documentation improvements
8051
8052 Compatibility Notes
8053 -------------------
8054
8055 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
8056 * [Deny (by default) transmuting from fn item types to pointer-sized
8057   types][34923]. Continuing the long transition to zero-sized fn items,
8058   per [RFC 401].
8059 * [Fix `#[derive]` for empty tuple structs/variants][35728].
8060   Part of [RFC 1506].
8061 * [Issue deprecation warnings for safe accesses to extern statics][36173]
8062 * [Fix lifetime rules for 'if' conditions][36029].
8063 * [Inherit overflow checks for sum and product][36372].
8064 * [Forbid user-defined macros named "macro_rules"][36730].
8065
8066 [33922]: https://github.com/rust-lang/rust/pull/33922
8067 [34623]: https://github.com/rust-lang/rust/pull/34623
8068 [34923]: https://github.com/rust-lang/rust/pull/34923
8069 [34942]: https://github.com/rust-lang/rust/pull/34942
8070 [35021]: https://github.com/rust-lang/rust/pull/35021
8071 [35048]: https://github.com/rust-lang/rust/pull/35048
8072 [35074]: https://github.com/rust-lang/rust/pull/35074
8073 [35124]: https://github.com/rust-lang/rust/pull/35124
8074 [35234]: https://github.com/rust-lang/rust/pull/35234
8075 [35238]: https://github.com/rust-lang/rust/pull/35238
8076 [35354]: https://github.com/rust-lang/rust/pull/35354
8077 [35559]: https://github.com/rust-lang/rust/pull/35559
8078 [35585]: https://github.com/rust-lang/rust/pull/35585
8079 [35627]: https://github.com/rust-lang/rust/pull/35627
8080 [35655]: https://github.com/rust-lang/rust/pull/35655
8081 [35702]: https://github.com/rust-lang/rust/pull/35702
8082 [35707]: https://github.com/rust-lang/rust/pull/35707
8083 [35728]: https://github.com/rust-lang/rust/pull/35728
8084 [35734]: https://github.com/rust-lang/rust/pull/35734
8085 [35755]: https://github.com/rust-lang/rust/pull/35755
8086 [35761]: https://github.com/rust-lang/rust/pull/35761
8087 [35764]: https://github.com/rust-lang/rust/pull/35764
8088 [35814]: https://github.com/rust-lang/rust/pull/35814
8089 [35854]: https://github.com/rust-lang/rust/pull/35854
8090 [35871]: https://github.com/rust-lang/rust/pull/35871
8091 [35884]: https://github.com/rust-lang/rust/pull/35884
8092 [35911]: https://github.com/rust-lang/rust/pull/35911
8093 [35969]: https://github.com/rust-lang/rust/pull/35969
8094 [35975]: https://github.com/rust-lang/rust/pull/35975
8095 [36004]: https://github.com/rust-lang/rust/pull/36004
8096 [36008]: https://github.com/rust-lang/rust/pull/36008
8097 [36014]: https://github.com/rust-lang/rust/pull/36014
8098 [36029]: https://github.com/rust-lang/rust/pull/36029
8099 [36059]: https://github.com/rust-lang/rust/pull/36059
8100 [36072]: https://github.com/rust-lang/rust/pull/36072
8101 [36101]: https://github.com/rust-lang/rust/pull/36101
8102 [36104]: https://github.com/rust-lang/rust/pull/36104
8103 [36171]: https://github.com/rust-lang/rust/pull/36171
8104 [36173]: https://github.com/rust-lang/rust/pull/36173
8105 [36178]: https://github.com/rust-lang/rust/pull/36178
8106 [36213]: https://github.com/rust-lang/rust/pull/36213
8107 [36214]: https://github.com/rust-lang/rust/pull/36214
8108 [36264]: https://github.com/rust-lang/rust/pull/36264
8109 [36266]: https://github.com/rust-lang/rust/pull/36266
8110 [36289]: https://github.com/rust-lang/rust/pull/36289
8111 [36338]: https://github.com/rust-lang/rust/pull/36338
8112 [36351]: https://github.com/rust-lang/rust/pull/36351
8113 [36355]: https://github.com/rust-lang/rust/pull/36355
8114 [36369]: https://github.com/rust-lang/rust/pull/36369
8115 [36372]: https://github.com/rust-lang/rust/pull/36372
8116 [36423]: https://github.com/rust-lang/rust/pull/36423
8117 [36482]: https://github.com/rust-lang/rust/pull/36482
8118 [36505]: https://github.com/rust-lang/rust/pull/36505
8119 [36524]: https://github.com/rust-lang/rust/pull/36524
8120 [36527]: https://github.com/rust-lang/rust/pull/36527
8121 [36551]: https://github.com/rust-lang/rust/pull/36551
8122 [36574]: https://github.com/rust-lang/rust/pull/36574
8123 [36586]: https://github.com/rust-lang/rust/pull/36586
8124 [36592]: https://github.com/rust-lang/rust/pull/36592
8125 [36631]: https://github.com/rust-lang/rust/pull/36631
8126 [36721]: https://github.com/rust-lang/rust/pull/36721
8127 [36727]: https://github.com/rust-lang/rust/pull/36727
8128 [36730]: https://github.com/rust-lang/rust/pull/36730
8129 [36734]: https://github.com/rust-lang/rust/pull/36734
8130 [36754]: https://github.com/rust-lang/rust/pull/36754
8131 [36995]: https://github.com/rust-lang/rust/pull/36995
8132 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
8133 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
8134 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
8135 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
8136 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
8137 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
8138 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
8139 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
8140 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
8141 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
8142 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
8143 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
8144 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
8145 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
8146 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
8147 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
8148 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
8149 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
8150 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
8151 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
8152 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
8153 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
8154 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
8155 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
8156 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
8157 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
8158 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
8159 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
8160 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
8161 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
8162 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
8163 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
8164
8165
8166 Version 1.12.1 (2016-10-20)
8167 ===========================
8168
8169 Regression Fixes
8170 ----------------
8171
8172 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
8173 * [Confusion with double negation and booleans][36856]
8174 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
8175 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
8176 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
8177 * [Corrupted memory after updated to 1.12][36936]
8178 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
8179 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
8180 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
8181
8182 [36381]: https://github.com/rust-lang/rust/issues/36381
8183 [36856]: https://github.com/rust-lang/rust/issues/36856
8184 [36875]: https://github.com/rust-lang/rust/issues/36875
8185 [36924]: https://github.com/rust-lang/rust/issues/36924
8186 [36926]: https://github.com/rust-lang/rust/issues/36926
8187 [36936]: https://github.com/rust-lang/rust/issues/36936
8188 [37026]: https://github.com/rust-lang/rust/issues/37026
8189 [37112]: https://github.com/rust-lang/rust/issues/37112
8190 [37153]: https://github.com/rust-lang/rust/issues/37153
8191
8192
8193 Version 1.12.0 (2016-09-29)
8194 ===========================
8195
8196 Highlights
8197 ----------
8198
8199 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
8200   This translation pass is far simpler than the previous AST->LLVM pass, and
8201   creates opportunities to perform new optimizations directly on the MIR. It
8202   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
8203 * [`rustc` presents a new, more readable error format, along with
8204   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
8205   Most common editors supporting Rust have been updated to work with it. It was
8206   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
8207
8208 Compiler
8209 --------
8210
8211 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
8212   This translation pass is far simpler than the previous AST->LLVM pass, and
8213   creates opportunities to perform new optimizations directly on the MIR. It
8214   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
8215 * [Print the Rust target name, not the LLVM target name, with
8216   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
8217 * [The computation of `TypeId` is correct in some cases where it was previously
8218   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
8219 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
8220 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
8221   `--print relocation-models`, and `--print code-models` print the available
8222   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
8223   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
8224 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
8225   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
8226   These targets produce statically-linked binaries. There are no binary release
8227   builds yet though.
8228
8229 Diagnostics
8230 -----------
8231
8232 * [`rustc` presents a new, more readable error format, along with
8233   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
8234   Most common editors supporting Rust have been updated to work with it. It was
8235   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
8236 * [In error descriptions, references are now described in plain English,
8237   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
8238 * [In error type descriptions, unknown numeric types are named `{integer}` or
8239   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
8240 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
8241
8242 Language
8243 --------
8244
8245 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
8246 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
8247 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
8248   useful](https://github.com/rust-lang/rust/pull/34908)
8249 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
8250   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
8251 * [Semicolons are properly required as statement delimiters inside
8252   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
8253 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
8254
8255 Stabilized APIs
8256 ---------------
8257
8258 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
8259 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
8260 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
8261 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
8262 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
8263 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
8264 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
8265 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
8266 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
8267 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
8268   Both on Unix and Windows.
8269 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
8270 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
8271 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
8272 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
8273 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
8274 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
8275 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
8276 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
8277
8278 Libraries
8279 ---------
8280
8281 * [The `format!` macro and friends now allow a single argument to be formatted
8282   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
8283 * [The lifetime bounds on `[T]::binary_search_by` and
8284   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
8285 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
8286 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
8287 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
8288 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
8289 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
8290 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
8291 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
8292 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
8293   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
8294 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
8295   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
8296 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
8297 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
8298   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
8299 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
8300 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
8301 * [`mpsc::sync_channel` `Receiver`s return any available message before
8302   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
8303 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
8304 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
8305
8306 Cargo
8307 -----
8308
8309 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
8310 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
8311 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
8312 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
8313 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
8314 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
8315 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
8316 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
8317 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
8318 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
8319 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
8320 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
8321 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
8322 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
8323 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
8324 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
8325
8326 Performance
8327 -----------
8328
8329 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
8330 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
8331
8332 Tooling
8333 -------
8334
8335 * [Test binaries now support a `--test-threads` argument to specify the number
8336   of threads used to run tests, and which acts the same as the
8337   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
8338 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
8339 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
8340 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
8341 * [Rust releases now come with source packages that can be installed by rustup
8342   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
8343   The resulting source code can be used by tools and IDES, located in the
8344   sysroot under `lib/rustlib/src`.
8345
8346 Misc
8347 ----
8348
8349 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
8350 * Many minor improvements to the documentation.
8351 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
8352
8353 Compatibility Notes
8354 -------------------
8355
8356 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
8357   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
8358 * [When formatting strings, if "precision" is specified, the "fill",
8359   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
8360 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
8361
8362
8363 Version 1.11.0 (2016-08-18)
8364 ===========================
8365
8366 Language
8367 --------
8368
8369 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
8370 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
8371 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
8372 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
8373
8374 Stabilized APIs
8375 ---------------
8376
8377 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
8378 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
8379 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
8380 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
8381 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
8382 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
8383   (in libcore - previously stabilized in libstd)
8384 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
8385   (in libcore - previously stabilized in libstd)
8386 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
8387   (in libcore - previously stabilized in libstd)
8388 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
8389   (in libcore - previously stabilized in libstd)
8390 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
8391 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
8392 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
8393 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
8394
8395 Libraries
8396 ---------
8397
8398 * [The `thread_local!` macro supports multiple definitions in a single
8399    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
8400 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
8401 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
8402   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
8403 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
8404 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
8405 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
8406 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
8407
8408 Cargo
8409 -----
8410
8411 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
8412 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
8413 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
8414 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
8415 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
8416   and `-vv` prints warnings for all crates.
8417 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
8418 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
8419   This provides room for expansion by arbitrary tools.
8420 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
8421 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
8422 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
8423 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
8424 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
8425 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
8426 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
8427
8428 Performance
8429 -----------
8430
8431 * [Caching projections speeds up type check dramatically for some
8432   workloads](https://github.com/rust-lang/rust/pull/33816)
8433 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
8434   This hasher is faster, but is believed to provide sufficient
8435   protection from collision attacks.
8436 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
8437
8438 Rustdoc
8439 -------
8440
8441 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
8442 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
8443 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
8444 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
8445 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
8446
8447 Tooling
8448 -------
8449
8450 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
8451 * [When emitting debug info, rustc emits frame pointers for closures,
8452   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
8453 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
8454 * Many more errors have been given error codes and extended
8455   explanations
8456 * API documentation continues to be improved, with many new examples
8457
8458 Misc
8459 ----
8460
8461 * [rustc no longer hangs when dependencies recursively re-export
8462   submodules](https://github.com/rust-lang/rust/pull/34542)
8463 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
8464 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
8465   rewritten](https://github.com/rust-lang/rust/pull/33895)
8466 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
8467   No targets use this yet, but it works toward AVR support.
8468
8469 Compatibility Notes
8470 -------------------
8471
8472 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
8473 * [The new follow-set rules that place restrictions on `macro_rules!`
8474   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
8475   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
8476   and has been a warning since 1.10.
8477 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
8478   This causes breakage in some corner cases.
8479
8480
8481 Version 1.10.0 (2016-07-07)
8482 ===========================
8483
8484 Language
8485 --------
8486
8487 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
8488   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
8489 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
8490 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
8491 * [`panic!` can be converted to a runtime abort with the
8492   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
8493   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
8494 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
8495   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
8496   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
8497   Note that Cargo does not yet directly support cdylibs.
8498
8499 Stabilized APIs
8500 ---------------
8501
8502 * `os::windows::fs::OpenOptionsExt::access_mode`
8503 * `os::windows::fs::OpenOptionsExt::share_mode`
8504 * `os::windows::fs::OpenOptionsExt::custom_flags`
8505 * `os::windows::fs::OpenOptionsExt::attributes`
8506 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
8507 * `os::unix::fs::OpenOptionsExt::custom_flags`
8508 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
8509 * `Default for sync::Weak`
8510 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
8511 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
8512 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
8513 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
8514 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
8515 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
8516 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
8517 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
8518 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
8519 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
8520 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
8521 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
8522 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
8523 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
8524 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
8525 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
8526 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
8527 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
8528 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
8529 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
8530 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
8531 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
8532 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
8533 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
8534 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
8535 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
8536 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
8537 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
8538 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
8539 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
8540 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
8541 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
8542 * Read/Write/RawFd impls for `UnixStream`
8543 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
8544 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
8545 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
8546 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
8547 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
8548 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
8549 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
8550 * RawFd impls for `UnixListener`
8551 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
8552 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
8553 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
8554 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
8555 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
8556 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
8557 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
8558 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
8559 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
8560 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
8561 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
8562 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
8563 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
8564 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
8565 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
8566 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
8567 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
8568 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
8569 * RawFd impls for `UnixDatagram`
8570 * `{BTree,Hash}Map::values_mut`
8571 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
8572
8573 Libraries
8574 ---------
8575
8576 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
8577   The semantics of this minor method are subtle and probably not what
8578   most people want.
8579 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
8580 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
8581   will fall back to `/dev/urandom` temporarily to avoid blocking
8582   during early boot](https://github.com/rust-lang/rust/pull/33086).
8583 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
8584 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
8585 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
8586 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
8587 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
8588 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
8589   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
8590
8591 Cargo
8592 -----
8593 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
8594   This controls the runtime behavior of the `panic!` macro
8595   and can be either "unwind" (the default), or "abort".
8596   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
8597 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
8598 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
8599 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
8600   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
8601 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
8602 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
8603 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
8604   By default they are retried twice, which can be customized with the
8605   `net.retry` value in `.cargo/config`.
8606 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
8607 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
8608 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
8609 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
8610   Makes it possible to install multiple crates in parallel.
8611 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
8612 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
8613 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
8614 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
8615 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
8616 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
8617
8618 Performance
8619 -----------
8620
8621 * [rustc memory usage was reduced by refactoring the context used for
8622   type checking](https://github.com/rust-lang/rust/pull/33425).
8623 * [Speed up creation of `HashMap`s by caching the random keys used
8624   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
8625 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
8626 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
8627 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
8628   10x faster than the previous lookup tables.
8629 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
8630
8631 Usability
8632 ---------
8633
8634 * Many incremental improvements to documentation and rustdoc.
8635 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
8636 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
8637 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
8638 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
8639 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
8640 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
8641 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
8642
8643 Misc
8644 ----
8645
8646 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
8647 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
8648 * [`std` no longer prints backtraces on platforms where the running
8649   module must be loaded with `env::current_exe`, which can't be relied
8650   on](https://github.com/rust-lang/rust/pull/33554).
8651 * This release includes std binaries for the i586-unknown-linux-gnu,
8652   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
8653   i586 target is for old x86 hardware without SSE2, and the armv7
8654   target is for Android running on modern ARM architectures.
8655 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
8656   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
8657 * [On Unix the runtime aborts by calling `libc::abort` instead of
8658   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
8659 * [Rust is now bootstrapped from the previous release of Rust,
8660   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
8661
8662 Compatibility Notes
8663 -------------------
8664
8665 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
8666 * [`target_env` for Linux ARM targets is just `gnu`, not
8667   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
8668 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
8669 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
8670 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
8671   Affects how macros are parsed.
8672 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
8673 * [Feature-gated attributes on macro-generated macro invocations are
8674   now rejected](https://github.com/rust-lang/rust/pull/32791).
8675 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
8676   This caused some minor changes to type inference.
8677
8678
8679 Version 1.9.0 (2016-05-26)
8680 ==========================
8681
8682 Language
8683 --------
8684
8685 * The `#[deprecated]` attribute when applied to an API will generate
8686   warnings when used. The warnings may be suppressed with
8687   `#[allow(deprecated)]`. [RFC 1270].
8688 * [`fn` item types are zero sized, and each `fn` names a unique
8689   type][1.9fn]. This will break code that transmutes `fn`s, so calling
8690   `transmute` on a `fn` type will generate a warning for a few cycles,
8691   then will be converted to an error.
8692 * [Field and method resolution understand visibility, so private
8693   fields and methods cannot prevent the proper use of public fields
8694   and methods][1.9fv].
8695 * [The parser considers unicode codepoints in the
8696   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
8697
8698 Stabilized APIs
8699 ---------------
8700
8701 * [`std::panic`]
8702 * [`std::panic::catch_unwind`] (renamed from `recover`)
8703 * [`std::panic::resume_unwind`] (renamed from `propagate`)
8704 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
8705 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
8706 * [`str::is_char_boundary`]
8707 * [`<*const T>::as_ref`]
8708 * [`<*mut T>::as_ref`]
8709 * [`<*mut T>::as_mut`]
8710 * [`AsciiExt::make_ascii_uppercase`]
8711 * [`AsciiExt::make_ascii_lowercase`]
8712 * [`char::decode_utf16`]
8713 * [`char::DecodeUtf16`]
8714 * [`char::DecodeUtf16Error`]
8715 * [`char::DecodeUtf16Error::unpaired_surrogate`]
8716 * [`BTreeSet::take`]
8717 * [`BTreeSet::replace`]
8718 * [`BTreeSet::get`]
8719 * [`HashSet::take`]
8720 * [`HashSet::replace`]
8721 * [`HashSet::get`]
8722 * [`OsString::with_capacity`]
8723 * [`OsString::clear`]
8724 * [`OsString::capacity`]
8725 * [`OsString::reserve`]
8726 * [`OsString::reserve_exact`]
8727 * [`OsStr::is_empty`]
8728 * [`OsStr::len`]
8729 * [`std::os::unix::thread`]
8730 * [`RawPthread`]
8731 * [`JoinHandleExt`]
8732 * [`JoinHandleExt::as_pthread_t`]
8733 * [`JoinHandleExt::into_pthread_t`]
8734 * [`HashSet::hasher`]
8735 * [`HashMap::hasher`]
8736 * [`CommandExt::exec`]
8737 * [`File::try_clone`]
8738 * [`SocketAddr::set_ip`]
8739 * [`SocketAddr::set_port`]
8740 * [`SocketAddrV4::set_ip`]
8741 * [`SocketAddrV4::set_port`]
8742 * [`SocketAddrV6::set_ip`]
8743 * [`SocketAddrV6::set_port`]
8744 * [`SocketAddrV6::set_flowinfo`]
8745 * [`SocketAddrV6::set_scope_id`]
8746 * [`slice::copy_from_slice`]
8747 * [`ptr::read_volatile`]
8748 * [`ptr::write_volatile`]
8749 * [`OpenOptions::create_new`]
8750 * [`TcpStream::set_nodelay`]
8751 * [`TcpStream::nodelay`]
8752 * [`TcpStream::set_ttl`]
8753 * [`TcpStream::ttl`]
8754 * [`TcpStream::set_only_v6`]
8755 * [`TcpStream::only_v6`]
8756 * [`TcpStream::take_error`]
8757 * [`TcpStream::set_nonblocking`]
8758 * [`TcpListener::set_ttl`]
8759 * [`TcpListener::ttl`]
8760 * [`TcpListener::set_only_v6`]
8761 * [`TcpListener::only_v6`]
8762 * [`TcpListener::take_error`]
8763 * [`TcpListener::set_nonblocking`]
8764 * [`UdpSocket::set_broadcast`]
8765 * [`UdpSocket::broadcast`]
8766 * [`UdpSocket::set_multicast_loop_v4`]
8767 * [`UdpSocket::multicast_loop_v4`]
8768 * [`UdpSocket::set_multicast_ttl_v4`]
8769 * [`UdpSocket::multicast_ttl_v4`]
8770 * [`UdpSocket::set_multicast_loop_v6`]
8771 * [`UdpSocket::multicast_loop_v6`]
8772 * [`UdpSocket::set_multicast_ttl_v6`]
8773 * [`UdpSocket::multicast_ttl_v6`]
8774 * [`UdpSocket::set_ttl`]
8775 * [`UdpSocket::ttl`]
8776 * [`UdpSocket::set_only_v6`]
8777 * [`UdpSocket::only_v6`]
8778 * [`UdpSocket::join_multicast_v4`]
8779 * [`UdpSocket::join_multicast_v6`]
8780 * [`UdpSocket::leave_multicast_v4`]
8781 * [`UdpSocket::leave_multicast_v6`]
8782 * [`UdpSocket::take_error`]
8783 * [`UdpSocket::connect`]
8784 * [`UdpSocket::send`]
8785 * [`UdpSocket::recv`]
8786 * [`UdpSocket::set_nonblocking`]
8787
8788 Libraries
8789 ---------
8790
8791 * [`std::sync::Once` is poisoned if its initialization function
8792   fails][1.9o].
8793 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
8794 * [Most types implement `fmt::Debug`][1.9db].
8795 * [The default buffer size used by `BufReader` and `BufWriter` was
8796   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
8797   used by other languages.
8798 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
8799   `Duration` additionally implements `*=` and `/=`][1.9ta].
8800 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
8801 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
8802 * [`Chain` implements `BufRead`][1.9ch].
8803 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
8804
8805 Cargo
8806 -----
8807
8808 * [Cargo can now run concurrently][1.9cc].
8809 * [Top-level overrides allow specific revisions of crates to be
8810   overridden through the entire crate graph][1.9ct].  This is intended
8811   to make upgrades easier for large projects, by allowing crates to be
8812   forked temporarily until they've been upgraded and republished.
8813 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
8814 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
8815   on the commandline][1.9cf]. `rustc` arguments can also be specified
8816   in the `build.rustflags` configuration key.
8817
8818 Performance
8819 -----------
8820
8821 * [The time complexity of comparing variables for equivalence during type
8822   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
8823   to major compilation time improvement in some scenarios.
8824 * [`ToString` is specialized for `str`, giving it the same performance
8825   as `to_owned`][1.9ts].
8826 * [Spawning processes with `Command::output` no longer creates extra
8827   threads][1.9sp].
8828 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
8829   for C-like enums][1.9cl].
8830
8831 Misc
8832 ----
8833
8834 * [Passing the `--quiet` flag to a test runner will produce
8835   much-abbreviated output][1.9q].
8836 * The Rust Project now publishes std binaries for the
8837   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
8838   `i586-pc-windows-msvc` targets.
8839
8840 Compatibility Notes
8841 -------------------
8842
8843 * [`std::sync::Once` is poisoned if its initialization function
8844   fails][1.9o].
8845 * [It is illegal to define methods with the same name in overlapping
8846   inherent `impl` blocks][1.9sn].
8847 * [`fn` item types are zero sized, and each `fn` names a unique
8848   type][1.9fn]. This will break code that transmutes `fn`s, so calling
8849   `transmute` on a `fn` type will generate a warning for a few cycles,
8850   then will be converted to an error.
8851 * [Improvements to const evaluation may trigger new errors when integer
8852   literals are out of range][1.9ce].
8853
8854
8855 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
8856 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
8857 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
8858 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
8859 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
8860 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
8861 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
8862 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
8863 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
8864 [1.9db]: https://github.com/rust-lang/rust/pull/32054
8865 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
8866 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
8867 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
8868 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
8869 [1.9o]: https://github.com/rust-lang/rust/pull/32325
8870 [1.9q]: https://github.com/rust-lang/rust/pull/31887
8871 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
8872 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
8873 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
8874 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
8875 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
8876 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
8877 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
8878 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
8879 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
8880 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
8881 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
8882 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
8883 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
8884 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
8885 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
8886 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
8887 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
8888 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
8889 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
8890 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
8891 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
8892 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
8893 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
8894 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
8895 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
8896 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
8897 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
8898 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
8899 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
8900 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
8901 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
8902 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
8903 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
8904 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
8905 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
8906 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
8907 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
8908 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
8909 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
8910 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
8911 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
8912 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
8913 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
8914 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
8915 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
8916 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
8917 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
8918 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
8919 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
8920 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
8921 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
8922 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
8923 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
8924 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
8925 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
8926 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
8927 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
8928 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
8929 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
8930 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
8931 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
8932 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
8933 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
8934 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
8935 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
8936 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
8937 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
8938 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
8939 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
8940 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
8941 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
8942 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
8943 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
8944 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
8945 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
8946 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
8947 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
8948 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
8949 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
8950 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
8951 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
8952 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
8953 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
8954 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
8955 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
8956 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
8957 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
8958 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
8959 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
8960 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
8961 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
8962 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
8963 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
8964 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
8965
8966
8967 Version 1.8.0 (2016-04-14)
8968 ==========================
8969
8970 Language
8971 --------
8972
8973 * Rust supports overloading of compound assignment statements like
8974   `+=` by implementing the [`AddAssign`], [`SubAssign`],
8975   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
8976   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
8977   traits. [RFC 953].
8978 * Empty structs can be defined with braces, as in `struct Foo { }`, in
8979   addition to the non-braced form, `struct Foo;`. [RFC 218].
8980
8981 Libraries
8982 ---------
8983
8984 * Stabilized APIs:
8985   * [`str::encode_utf16`] (renamed from `utf16_units`)
8986   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
8987   * [`Ref::map`]
8988   * [`RefMut::map`]
8989   * [`ptr::drop_in_place`]
8990   * [`time::Instant`]
8991   * [`time::SystemTime`]
8992   * [`Instant::now`]
8993   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
8994   * [`Instant::elapsed`]
8995   * [`SystemTime::now`]
8996   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
8997   * [`SystemTime::elapsed`]
8998   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
8999   * [`SystemTimeError`]
9000   * [`SystemTimeError::duration`]
9001   * Various impls for `SystemTimeError`
9002   * [`UNIX_EPOCH`]
9003   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
9004     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
9005     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
9006 * [The `write!` and `writeln!` macros correctly emit errors if any of
9007   their arguments can't be formatted][1.8w].
9008 * [Various I/O functions support large files on 32-bit Linux][1.8l].
9009 * [The Unix-specific `raw` modules, which contain a number of
9010   redefined C types are deprecated][1.8r], including `os::raw::unix`,
9011   `os::raw::macos`, and `os::raw::linux`. These modules defined types
9012   such as `ino_t` and `dev_t`. The inconsistency of these definitions
9013   across platforms was making it difficult to implement `std`
9014   correctly. Those that need these definitions should use the `libc`
9015   crate. [RFC 1415].
9016 * The Unix-specific `MetadataExt` traits, including
9017   `os::unix::fs::MetadataExt`, which expose values such as inode
9018   numbers [no longer return platform-specific types][1.8r], but
9019   instead return widened integers. [RFC 1415].
9020 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
9021 * [Atomic loads and stores are not volatile][1.8a].
9022 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
9023
9024 Performance
9025 -----------
9026
9027 * [Inlining hash functions lead to a 3% compile-time improvement in
9028   some workloads][1.8h].
9029 * When using jemalloc, its symbols are [unprefixed so that it
9030   overrides the libc malloc implementation][1.8h]. This means that for
9031   rustc, LLVM is now using jemalloc, which results in a 6%
9032   compile-time improvement on a specific workload.
9033 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
9034
9035 Misc
9036 ----
9037
9038 * [32-bit MSVC builds finally implement unwinding][1.8ms].
9039   i686-pc-windows-msvc is now considered a tier-1 platform.
9040 * [The `--print targets` flag prints a list of supported targets][1.8t].
9041 * [The `--print cfg` flag prints the `cfg`s defined for the current
9042   target][1.8cf].
9043 * [`rustc` can be built with an new Cargo-based build system, written
9044   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
9045   build system. To enable it configure with `configure --rustbuild`.
9046 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
9047   variants while also indicating the total number of missing variants
9048   if more than 3][1.8m].
9049 * [Executable stacks are disabled on Linux and BSD][1.8nx].
9050 * The Rust Project now publishes binary releases of the standard
9051   library for a number of tier-2 targets:
9052   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
9053   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
9054   `x86_64-rumprun-netbsd`. These can be installed with
9055   tools such as [multirust][1.8mr].
9056
9057 Cargo
9058 -----
9059
9060 * [`cargo init` creates a new Cargo project in the current
9061   directory][1.8ci].  It is otherwise like `cargo new`.
9062 * [Cargo has configuration keys for `-v` and
9063   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
9064   `[term]` section of `.cargo/config`.
9065 * [Configuration keys that evaluate to strings or integers can be set
9066   via environment variables][1.8ce]. For example the `build.jobs` key
9067   can be set via `CARGO_BUILD_JOBS`. Environment variables take
9068   precedence over config files.
9069 * [Target-specific dependencies support Rust `cfg` syntax for
9070   describing targets][1.8cfg] so that dependencies for multiple
9071   targets can be specified together. [RFC 1361].
9072 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
9073   `RUSTDOC` take precedence over the `build.target-dir`,
9074   `build.rustc`, and `build.rustdoc` configuration values][1.8cfv].
9075 * [The child process tree is killed on Windows when Cargo is
9076   killed][1.8ck].
9077 * [The `build.target` configuration value sets the target platform,
9078   like `--target`][1.8ct].
9079
9080 Compatibility Notes
9081 -------------------
9082
9083 * [Unstable compiler flags have been further restricted][1.8u]. Since
9084   1.0 `-Z` flags have been considered unstable, and other flags that
9085   were considered unstable additionally required passing `-Z
9086   unstable-options` to access. Unlike unstable language and library
9087   features though, these options have been accessible on the stable
9088   release channel. Going forward, *new unstable flags will not be
9089   available on the stable release channel*, and old unstable flags
9090   will warn about their usage. In the future, all unstable flags will
9091   be unavailable on the stable release channel.
9092 * [It is no longer possible to `match` on empty enum variants using
9093   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
9094 * The Unix-specific `MetadataExt` traits, including
9095   `os::unix::fs::MetadataExt`, which expose values such as inode
9096   numbers [no longer return platform-specific types][1.8r], but
9097   instead return widened integers. [RFC 1415].
9098 * [Modules sourced from the filesystem cannot appear within arbitrary
9099   blocks, but only within other modules][1.8mf].
9100 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
9101 * On Unix, [stack overflow triggers a runtime abort instead of a
9102   SIGSEGV][1.8so].
9103 * [`Command::spawn` and its equivalents return an error if any of
9104   its command-line arguments contain interior `NUL`s][1.8n].
9105 * [Tuple and unit enum variants from other crates are in the type
9106   namespace][1.8tn].
9107 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
9108   type instead of `.a` files][1.8st]. Additionally, for the MSVC
9109   toolchain, `rustc` emits import libraries named `foo.dll.lib`
9110   instead of `foo.lib`.
9111
9112
9113 [1.8a]: https://github.com/rust-lang/rust/pull/30962
9114 [1.8b]: https://github.com/rust-lang/rust/pull/31123
9115 [1.8c]: https://github.com/rust-lang/rust/pull/31530
9116 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
9117 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
9118 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
9119 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
9120 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
9121 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
9122 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
9123 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
9124 [1.8cfv]: https://github.com/rust-lang/cargo/issues/2365
9125 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
9126 [1.8h]: https://github.com/rust-lang/rust/pull/31460
9127 [1.8l]: https://github.com/rust-lang/rust/pull/31668
9128 [1.8m]: https://github.com/rust-lang/rust/pull/31020
9129 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
9130 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
9131 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
9132 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
9133 [1.8n]: https://github.com/rust-lang/rust/pull/31056
9134 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
9135 [1.8r]: https://github.com/rust-lang/rust/pull/31551
9136 [1.8so]: https://github.com/rust-lang/rust/pull/31333
9137 [1.8st]: https://github.com/rust-lang/rust/pull/29520
9138 [1.8t]: https://github.com/rust-lang/rust/pull/31358
9139 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
9140 [1.8u]: https://github.com/rust-lang/rust/pull/31793
9141 [1.8v]: https://github.com/rust-lang/rust/pull/31757
9142 [1.8w]: https://github.com/rust-lang/rust/pull/31904
9143 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
9144 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
9145 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
9146 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
9147 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
9148 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
9149 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
9150 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
9151 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
9152 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
9153 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
9154 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
9155 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
9156 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
9157 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
9158 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
9159 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
9160 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
9161 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
9162 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
9163 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
9164 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
9165 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
9166 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
9167 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
9168 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
9169 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
9170 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
9171 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
9172 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
9173
9174
9175 Version 1.7.0 (2016-03-03)
9176 ==========================
9177
9178 Libraries
9179 ---------
9180
9181 * Stabilized APIs
9182   * `Path`
9183     * [`Path::strip_prefix`] (renamed from relative_from)
9184     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
9185   * `Ipv4Addr`
9186     * [`Ipv4Addr::is_loopback`]
9187     * [`Ipv4Addr::is_private`]
9188     * [`Ipv4Addr::is_link_local`]
9189     * [`Ipv4Addr::is_multicast`]
9190     * [`Ipv4Addr::is_broadcast`]
9191     * [`Ipv4Addr::is_documentation`]
9192   * `Ipv6Addr`
9193     * [`Ipv6Addr::is_unspecified`]
9194     * [`Ipv6Addr::is_loopback`]
9195     * [`Ipv6Addr::is_multicast`]
9196   * `Vec`
9197     * [`Vec::as_slice`]
9198     * [`Vec::as_mut_slice`]
9199   * `String`
9200     * [`String::as_str`]
9201     * [`String::as_mut_str`]
9202   * Slices
9203     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
9204     be the same length
9205     * `<[T]>::`[`sort_by_key`]
9206   * checked, saturated, and overflowing operations
9207     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
9208     * [`i32::saturating_mul`]
9209     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
9210     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
9211     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
9212     * [`u32::saturating_mul`]
9213     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
9214     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
9215     * and checked, saturated, and overflowing operations for other primitive types
9216   * FFI
9217     * [`ffi::IntoStringError`]
9218     * [`CString::into_string`]
9219     * [`CString::into_bytes`]
9220     * [`CString::into_bytes_with_nul`]
9221     * `From<CString> for Vec<u8>`
9222   * `IntoStringError`
9223     * [`IntoStringError::into_cstring`]
9224     * [`IntoStringError::utf8_error`]
9225     * `Error for IntoStringError`
9226   * Hashing
9227     * [`std::hash::BuildHasher`]
9228     * [`BuildHasher::Hasher`]
9229     * [`BuildHasher::build_hasher`]
9230     * [`std::hash::BuildHasherDefault`]
9231     * [`HashMap::with_hasher`]
9232     * [`HashMap::with_capacity_and_hasher`]
9233     * [`HashSet::with_hasher`]
9234     * [`HashSet::with_capacity_and_hasher`]
9235     * [`std::collections::hash_map::RandomState`]
9236     * [`RandomState::new`]
9237 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
9238   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
9239   from bytes is faster.
9240 * [The performance of `LineWriter` (and thus `io::stdout`) was
9241   improved by using `memchr` to search for newlines][1.7m].
9242 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
9243   `f64` variants were stabilized previously.
9244 * [`BTreeMap` was rewritten to use less memory and improve the performance
9245   of insertion and iteration, the latter by as much as 5x][1.7bm].
9246 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
9247   covariant over their contained type][1.7bt].
9248 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
9249   over their contained type][1.7ll].
9250 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
9251   searching methods.
9252 * [`Any` is implemented for unsized types][1.7a].
9253 * [`Hash` is implemented for `Duration`][1.7h].
9254
9255 Misc
9256 ----
9257
9258 * [When running tests with `--test`, rustdoc will pass `--cfg`
9259   arguments to the compiler][1.7dt].
9260 * [The compiler is built with RPATH information by default][1.7rpa].
9261   This means that it will be possible to run `rustc` when installed in
9262   unusual configurations without configuring the dynamic linker search
9263   path explicitly.
9264 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
9265   any RPATH entries (emitted with `-C rpath`) *not* take precedence
9266   over `LD_LIBRARY_PATH`.
9267
9268 Cargo
9269 -----
9270
9271 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
9272   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
9273 * [The `rerun-if-changed` build script directive no longer causes the
9274   build script to incorrectly run twice in certain scenarios][1.7rr].
9275
9276 Compatibility Notes
9277 -------------------
9278
9279 * Soundness fixes to the interactions between associated types and
9280   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
9281   code that violates the new rules. This is a significant change that
9282   is known to break existing code, so it has emitted warnings for the
9283   new error cases since 1.4 to give crate authors time to adapt. The
9284   details of what is changing are subtle; read the RFC for more.
9285 * [Several bugs in the compiler's visibility calculations were
9286   fixed][1.7v]. Since this was found to break significant amounts of
9287   code, the new errors will be emitted as warnings for several release
9288   cycles, under the `private_in_public` lint.
9289 * Defaulted type parameters were accidentally accepted in positions
9290   that were not intended. In this release, [defaulted type parameters
9291   appearing outside of type definitions will generate a
9292   warning][1.7d], which will become an error in future releases.
9293 * [Parsing "." as a float results in an error instead of 0][1.7p].
9294   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
9295 * [Borrows of closure parameters may not outlive the closure][1.7bc].
9296
9297 [1.7a]: https://github.com/rust-lang/rust/pull/30928
9298 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
9299 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
9300 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
9301 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
9302 [1.7d]: https://github.com/rust-lang/rust/pull/30724
9303 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
9304 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
9305 [1.7f]: https://github.com/rust-lang/rust/pull/30672
9306 [1.7h]: https://github.com/rust-lang/rust/pull/30818
9307 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
9308 [1.7m]: https://github.com/rust-lang/rust/pull/30381
9309 [1.7p]: https://github.com/rust-lang/rust/pull/30681
9310 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
9311 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
9312 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
9313 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
9314 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
9315 [1.7v]: https://github.com/rust-lang/rust/pull/29973
9316 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
9317 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
9318 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
9319 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
9320 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
9321 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
9322 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
9323 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
9324 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
9325 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
9326 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
9327 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
9328 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
9329 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
9330 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
9331 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
9332 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
9333 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
9334 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
9335 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
9336 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
9337 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
9338 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
9339 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
9340 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
9341 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
9342 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
9343 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
9344 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
9345 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
9346 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
9347 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
9348 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
9349 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
9350 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
9351 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
9352 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
9353 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
9354 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
9355 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
9356 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
9357 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
9358 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
9359 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
9360 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
9361 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
9362 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
9363 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
9364 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
9365 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
9366 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
9367 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
9368 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
9369 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
9370 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
9371 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
9372 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
9373 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
9374 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
9375 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
9376
9377
9378 Version 1.6.0 (2016-01-21)
9379 ==========================
9380
9381 Language
9382 --------
9383
9384 * The `#![no_std]` attribute causes a crate to not be linked to the
9385   standard library, but only the [core library][1.6co], as described
9386   in [RFC 1184]. The core library defines common types and traits but
9387   has no platform dependencies whatsoever, and is the basis for Rust
9388   software in environments that cannot support a full port of the
9389   standard library, such as operating systems. Most of the core
9390   library is now stable.
9391
9392 Libraries
9393 ---------
9394
9395 * Stabilized APIs:
9396   [`Read::read_exact`],
9397   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
9398   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
9399   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
9400   [`os::unix::fs::DirBuilderExt`],
9401   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
9402   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
9403   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
9404   [`collections::hash_map::Drain`],
9405   [`collections::hash_map::HashMap::drain`],
9406   [`collections::hash_set::Drain`],
9407   [`collections::hash_set::HashSet::drain`],
9408   [`collections::binary_heap::Drain`],
9409   [`collections::binary_heap::BinaryHeap::drain`],
9410   [`Vec::extend_from_slice`] (renamed from `push_all`),
9411   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
9412   [`RwLock::into_inner`],
9413   [`Iterator::min_by_key`] (renamed from `min_by`),
9414   [`Iterator::max_by_key`] (renamed from `max_by`).
9415 * The [core library][1.6co] is stable, as are most of its APIs.
9416 * [The `assert_eq!` macro supports arguments that don't implement
9417   `Sized`][1.6ae], such as arrays. In this way it behaves more like
9418   `assert!`.
9419 * Several timer functions that take duration in milliseconds [are
9420   deprecated in favor of those that take `Duration`][1.6ms]. These
9421   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
9422   `thread::park_timeout_ms`.
9423 * The algorithm by which `Vec` reserves additional elements was
9424   [tweaked to not allocate excessive space][1.6a] while still growing
9425   exponentially.
9426 * `From` conversions are [implemented from integers to floats][1.6f]
9427   in cases where the conversion is lossless. Thus they are not
9428   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
9429   or `f64`. They are also not implemented for `isize` and `usize`
9430   because the implementations would be platform-specific. `From` is
9431   also implemented from `f32` to `f64`.
9432 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
9433 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
9434 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
9435 * [`BinaryHeap` was refactored][1.6bh] for modest performance
9436   improvements.
9437 * Sorting slices that are already sorted [is 50% faster in some
9438   cases][1.6s].
9439
9440 Cargo
9441 -----
9442
9443 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
9444 * Cargo build scripts can specify their dependencies by emitting the
9445   [`rerun-if-changed`][1.6rr] key.
9446 * crates.io will reject publication of crates with dependencies that
9447   have a wildcard version constraint. Crates with wildcard
9448   dependencies were seen to cause a variety of problems, as described
9449   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
9450   warning.
9451 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
9452   release folder.  A variety of artifacts that Cargo failed to clean
9453   are now correctly deleted.
9454
9455 Misc
9456 ----
9457
9458 * The `unreachable_code` lint [warns when a function call's argument
9459   diverges][1.6dv].
9460 * The parser indicates [failures that may be caused by
9461   confusingly-similar Unicode characters][1.6uc]
9462 * Certain macro errors [are reported at definition time][1.6m], not
9463   expansion.
9464
9465 Compatibility Notes
9466 -------------------
9467
9468 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
9469   environment variable when locating crates. This was a pre-cargo
9470   feature for integrating with the package manager that was
9471   accidentally never removed.
9472 * [A number of bugs were fixed in the privacy checker][1.6p] that
9473   could cause previously-accepted code to break.
9474 * [Modules and unit/tuple structs may not share the same name][1.6ts].
9475 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
9476   struct pattern syntax (`Foo(..)`) can no longer be used to match
9477   unit structs. This is a warning now, but will become an error in
9478   future releases. Patterns that share the same name as a const are
9479   now an error.
9480 * A bug was fixed that causes [rustc not to apply default type
9481   parameters][1.6xc] when resolving certain method implementations of
9482   traits defined in other crates.
9483
9484 [1.6a]: https://github.com/rust-lang/rust/pull/29454
9485 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
9486 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
9487 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
9488 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
9489 [1.6co]: http://doc.rust-lang.org/core/index.html
9490 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
9491 [1.6f]: https://github.com/rust-lang/rust/pull/29129
9492 [1.6m]: https://github.com/rust-lang/rust/pull/29828
9493 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
9494 [1.6p]: https://github.com/rust-lang/rust/pull/29726
9495 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
9496 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
9497 [1.6s]: https://github.com/rust-lang/rust/pull/29675
9498 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
9499 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
9500 [1.6us]: https://github.com/rust-lang/rust/pull/29383
9501 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
9502 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
9503 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
9504 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
9505 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
9506 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
9507 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
9508 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
9509 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
9510 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
9511 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
9512 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
9513 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
9514 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
9515 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
9516 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
9517 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
9518 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
9519 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
9520 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
9521 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
9522 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
9523 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
9524 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
9525 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
9526 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
9527 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
9528 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
9529 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
9530 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
9531
9532
9533 Version 1.5.0 (2015-12-10)
9534 ==========================
9535
9536 * ~700 changes, numerous bugfixes
9537
9538 Highlights
9539 ----------
9540
9541 * Stabilized APIs:
9542   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
9543   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
9544   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
9545   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
9546   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
9547   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
9548   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
9549   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
9550   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
9551   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
9552   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
9553   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
9554   [`Path::read_link`], [`Path::symlink_metadata`],
9555   [`Utf8Error::valid_up_to`], [`Vec::resize`],
9556   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
9557   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
9558   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
9559   [`slice::split_first_mut`], [`slice::split_first`],
9560   [`slice::split_last_mut`], [`slice::split_last`],
9561   [`char::from_u32_unchecked`], [`fs::canonicalize`],
9562   [`str::MatchIndices`], [`str::RMatchIndices`],
9563   [`str::match_indices`], [`str::rmatch_indices`],
9564   [`str::slice_mut_unchecked`], [`string::ParseError`].
9565 * Rust applications hosted on crates.io can be installed locally to
9566   `~/.cargo/bin` with the [`cargo install`] command. Among other
9567   things this makes it easier to augment Cargo with new subcommands:
9568   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
9569   invoked as `cargo foo`.
9570 * Crates with wildcard (`*`) dependencies will [emit warnings when
9571   published][1.5w]. In 1.6 it will no longer be possible to publish
9572   crates with wildcard dependencies.
9573
9574 Breaking Changes
9575 ----------------
9576
9577 * The rules determining when a particular lifetime must outlive
9578   a particular value (known as '[dropck]') have been [modified
9579   to not rely on parametricity][1.5p].
9580 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
9581   and `Arc`][1.5a]. Because these smart pointer types implement
9582   `Deref`, this causes breakage in cases where the interior type
9583   contains methods of the same name.
9584 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
9585   that they could drop their content. Soundness fix.
9586 * All method invocations are [properly checked][1.5wf1] for
9587   [well-formedness][1.5wf2]. Soundness fix.
9588 * Traits whose supertraits contain `Self` are [not object
9589   safe][1.5o]. Soundness fix.
9590 * Target specifications support a [`no_default_libraries`][1.5nd]
9591   setting that controls whether `-nodefaultlibs` is passed to the
9592   linker, and in turn the `is_like_windows` setting no longer affects
9593   the `-nodefaultlibs` flag.
9594 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
9595 * The `#[inline]` and `#[repr]` attributes [can only appear
9596   in valid locations][1.5at].
9597 * Native libraries linked from the local crate are [passed to
9598   the linker before native libraries from upstream crates][1.5nl].
9599 * Two rarely-used attributes, `#[no_debug]` and
9600   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
9601 * Negation of unsigned integers, which has been a warning for
9602   several releases, [is now behind a feature gate and will
9603   generate errors][1.5nu].
9604 * The parser accidentally accepted visibility modifiers on
9605   enum variants, a bug [which has been fixed][1.5ev].
9606 * [A bug was fixed that allowed `use` statements to import unstable
9607   features][1.5use].
9608
9609 Language
9610 --------
9611
9612 * When evaluating expressions at compile-time that are not
9613   compile-time constants (const-evaluating expressions in non-const
9614   contexts), incorrect code such as overlong bitshifts and arithmetic
9615   overflow will [generate a warning instead of an error][1.5ce],
9616   delaying the error until runtime. This will allow the
9617   const-evaluator to be expanded in the future backwards-compatibly.
9618 * The `improper_ctypes` lint [no longer warns about using `isize` and
9619   `usize` in FFI][1.5ict].
9620
9621 Libraries
9622 ---------
9623
9624 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
9625   invariant][1.5c].
9626 * `Default` is [implemented for mutable slices][1.5d].
9627 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
9628 * There are now `From` conversions [between floating point
9629   types][1.5f] where the conversions are lossless.
9630 * There are now `From` conversions [between integer types][1.5i] where
9631   the conversions are lossless.
9632 * [`fs::Metadata` implements `Clone`][1.5fs].
9633 * The `parse` method [accepts a leading "+" when parsing
9634   integers][1.5pi].
9635 * [`AsMut` is implemented for `Vec`][1.5am].
9636 * The `clone_from` implementations for `String` and `BinaryHeap` [have
9637   been optimized][1.5cf] and no longer rely on the default impl.
9638 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
9639   `unsafe extern "C"` function types now [implement `Clone`,
9640   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
9641   `fmt::Debug` for up to 12 arguments][1.5fp].
9642 * [Dropping `Vec`s is much faster in unoptimized builds when the
9643   element types don't implement `Drop`][1.5dv].
9644 * A bug that caused in incorrect behavior when [combining `VecDeque`
9645   with zero-sized types][1.5vdz] was resolved.
9646 * [`PartialOrd` for slices is faster][1.5po].
9647
9648 Miscellaneous
9649 -------------
9650
9651 * [Crate metadata size was reduced by 20%][1.5md].
9652 * [Improvements to code generation reduced the size of libcore by 3.3
9653   MB and rustc's memory usage by 18MB][1.5m].
9654 * [Improvements to deref translation increased performance in
9655   unoptimized builds][1.5dr].
9656 * Various errors in trait resolution [are deduplicated to only be
9657   reported once][1.5te].
9658 * Rust has preliminary [support for rumprun kernels][1.5rr].
9659 * Rust has preliminary [support for NetBSD on amd64][1.5na].
9660
9661 [1.5use]: https://github.com/rust-lang/rust/pull/28364
9662 [1.5po]: https://github.com/rust-lang/rust/pull/28436
9663 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
9664 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
9665 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
9666 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
9667 [1.5md]: https://github.com/rust-lang/rust/pull/28521
9668 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
9669 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
9670 [1.5na]: https://github.com/rust-lang/rust/pull/28543
9671 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
9672 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
9673 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
9674 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
9675 [1.5te]: https://github.com/rust-lang/rust/pull/28645
9676 [1.5at]: https://github.com/rust-lang/rust/pull/28650
9677 [1.5am]: https://github.com/rust-lang/rust/pull/28663
9678 [1.5m]: https://github.com/rust-lang/rust/pull/28778
9679 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
9680 [1.5a]: https://github.com/rust-lang/rust/pull/28811
9681 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
9682 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
9683 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
9684 [1.5i]: https://github.com/rust-lang/rust/pull/28921
9685 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
9686 [1.5f]: https://github.com/rust-lang/rust/pull/29129
9687 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
9688 [1.5s]: https://github.com/rust-lang/rust/pull/29190
9689 [1.5d]: https://github.com/rust-lang/rust/pull/29245
9690 [1.5o]: https://github.com/rust-lang/rust/pull/29259
9691 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
9692 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
9693 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
9694 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
9695 [1.5c]: https://github.com/rust-lang/rust/pull/29110
9696 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
9697 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
9698 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
9699 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
9700 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
9701 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
9702 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
9703 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
9704 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
9705 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
9706 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
9707 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
9708 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
9709 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
9710 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
9711 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
9712 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
9713 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
9714 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
9715 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
9716 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
9717 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
9718 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
9719 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
9720 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
9721 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
9722 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
9723 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
9724 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
9725 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
9726 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
9727 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
9728 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
9729 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
9730 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
9731 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
9732 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
9733 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
9734 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
9735 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
9736 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
9737 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
9738 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
9739 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
9740 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
9741 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
9742 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
9743 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
9744 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
9745 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
9746 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
9747 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
9748 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
9749 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
9750
9751 Version 1.4.0 (2015-10-29)
9752 ==========================
9753
9754 * ~1200 changes, numerous bugfixes
9755
9756 Highlights
9757 ----------
9758
9759 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
9760   GNU) are now supported and recommended for use.
9761
9762 Breaking Changes
9763 ----------------
9764
9765 * [Several changes have been made to fix type soundness and improve
9766   the behavior of associated types][sound]. See [RFC 1214]. Although
9767   we have mostly introduced these changes as warnings this release, to
9768   become errors next release, there are still some scenarios that will
9769   see immediate breakage.
9770 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
9771   line breaks in addition to `\n`][crlf].
9772 * [Loans of `'static` lifetime extend to the end of a function][stat].
9773 * [`str::parse` no longer introduces avoidable rounding error when
9774   parsing floating point numbers. Together with earlier changes to
9775   float formatting/output, "round trips" like f.to_string().parse()
9776   now preserve the value of f exactly. Additionally, leading plus
9777   signs are now accepted][fp3].
9778
9779
9780 Language
9781 --------
9782
9783 * `use` statements that import multiple items [can now rename
9784   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
9785 * [Binops work correctly on fat pointers][binfat].
9786 * `pub extern crate`, which does not behave as expected, [issues a
9787   warning][pec] until a better solution is found.
9788
9789 Libraries
9790 ---------
9791
9792 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
9793   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
9794   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
9795   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
9796   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
9797   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
9798   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
9799   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
9800   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
9801   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
9802   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
9803   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
9804   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
9805   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
9806   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
9807   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
9808   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
9809   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
9810   [`thread::sleep`].
9811 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
9812   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
9813   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
9814   `f64::from_str_radix`.
9815 * [Reverse-searching strings is faster with the 'two-way'
9816   algorithm][s].
9817 * [`std::io::copy` allows `?Sized` arguments][cc].
9818 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
9819   [override `count`, `nth` and `last` with an *O*(1)
9820   implementation][it].
9821 * [`Default` is implemented for arrays up to `[T; 32]`][d].
9822 * [`IntoRawFd` has been added to the Unix-specific prelude,
9823   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
9824   prelude][pr].
9825 * [`Extend<String>` and `FromIterator<String` are both implemented for
9826   `String`][es].
9827 * [`IntoIterator` is implemented for references to `Option` and
9828   `Result`][into2].
9829 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
9830   Copy`][ext] as part of [RFC 839]. This will cause type inference
9831   breakage in rare situations.
9832 * [`BinaryHeap` implements `Debug`][bh2].
9833 * [`Borrow` and `BorrowMut` are implemented for fixed-size
9834   arrays][bm].
9835 * [`extern fn`s with the "Rust" and "C" ABIs implement common
9836   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
9837 * [String comparison is faster][faststr].
9838 * `&mut T` where `T: std::fmt::Write` [also implements
9839   `std::fmt::Write`][mutw].
9840 * [A stable regression in `VecDeque::push_back` and other
9841   capacity-altering methods that caused panics for zero-sized types
9842   was fixed][vd].
9843 * [Function pointers implement traits for up to 12 parameters][fp2].
9844
9845 Miscellaneous
9846 -------------
9847
9848 * The compiler [no longer uses the 'morestack' feature to prevent
9849   stack overflow][mm]. Instead it uses guard pages and stack
9850   probes (though stack probes are not yet implemented on any platform
9851   but Windows).
9852 * [The compiler matches traits faster when projections are involved][p].
9853 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
9854   `usize`][ffi].
9855 * [Cargo now displays useful information about what its doing during
9856   `cargo update`][cu].
9857
9858 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
9859 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
9860 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
9861 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
9862 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
9863 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
9864 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
9865 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
9866 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
9867 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
9868 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
9869 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
9870 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
9871 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
9872 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
9873 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
9874 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
9875 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
9876 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
9877 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
9878 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
9879 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
9880 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
9881 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
9882 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
9883 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
9884 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
9885 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
9886 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
9887 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
9888 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
9889 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
9890 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
9891 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
9892 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
9893 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
9894 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
9895 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
9896 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
9897 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
9898 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
9899 [bh2]: https://github.com/rust-lang/rust/pull/28156
9900 [binfat]: https://github.com/rust-lang/rust/pull/28270
9901 [bm]: https://github.com/rust-lang/rust/pull/28197
9902 [cc]: https://github.com/rust-lang/rust/pull/27531
9903 [crlf]: https://github.com/rust-lang/rust/pull/28034
9904 [cu]: https://github.com/rust-lang/cargo/pull/1931
9905 [d]: https://github.com/rust-lang/rust/pull/27825
9906 [dep]: https://github.com/rust-lang/rust/pull/28339
9907 [es]: https://github.com/rust-lang/rust/pull/27956
9908 [ext]: https://github.com/rust-lang/rust/pull/28094
9909 [faststr]: https://github.com/rust-lang/rust/pull/28338
9910 [ffi]: https://github.com/rust-lang/rust/pull/28779
9911 [fp]: https://github.com/rust-lang/rust/pull/28268
9912 [fp2]: https://github.com/rust-lang/rust/pull/28560
9913 [fp3]: https://github.com/rust-lang/rust/pull/27307
9914 [i]: https://github.com/rust-lang/rust/pull/27451
9915 [into2]: https://github.com/rust-lang/rust/pull/28039
9916 [it]: https://github.com/rust-lang/rust/pull/27652
9917 [mm]: https://github.com/rust-lang/rust/pull/27338
9918 [mutw]: https://github.com/rust-lang/rust/pull/28368
9919 [sound]: https://github.com/rust-lang/rust/pull/27641
9920 [p]: https://github.com/rust-lang/rust/pull/27866
9921 [pec]: https://github.com/rust-lang/rust/pull/28486
9922 [pr]: https://github.com/rust-lang/rust/pull/27896
9923 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
9924 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
9925 [s]: https://github.com/rust-lang/rust/pull/27474
9926 [stab]: https://github.com/rust-lang/rust/pull/28339
9927 [stat]: https://github.com/rust-lang/rust/pull/28321
9928 [vd]: https://github.com/rust-lang/rust/pull/28494
9929
9930 Version 1.3.0 (2015-09-17)
9931 ==============================
9932
9933 * ~900 changes, numerous bugfixes
9934
9935 Highlights
9936 ----------
9937
9938 * The [new object lifetime defaults][nold] have been [turned
9939   on][nold2] after a cycle of warnings about the change. Now types
9940   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
9941   being interpreted as `&'a Box<Trait+'a>` to `&'a
9942   Box<Trait+'static>`.
9943 * [The Rustonomicon][nom] is a new book in the official documentation
9944   that dives into writing unsafe Rust.
9945 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
9946   timekeeping is employed by other std APIs, as well as out-of-tree
9947   time crates.
9948
9949 Breaking Changes
9950 ----------------
9951
9952 * The [new object lifetime defaults][nold] have been [turned
9953   on][nold2] after a cycle of warnings about the change.
9954 * There is a known [regression][lr] in how object lifetime elision is
9955   interpreted, the proper solution for which is undetermined.
9956 * The `#[prelude_import]` attribute, an internal implementation
9957   detail, was accidentally stabilized previously. [It has been put
9958   behind the `prelude_import` feature gate][pi]. This change is
9959   believed to break no existing code.
9960 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
9961   [more sane for dynamically sized types][dst3]. Code that relied on
9962   the previous behavior is thought to be broken.
9963 * The `dropck` rules, which checks that destructors can't access
9964   destroyed values, [have been updated][dropck] to match the
9965   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
9966   cause some previously-compiling code to no longer build.
9967
9968 Language
9969 --------
9970
9971 * The [new object lifetime defaults][nold] have been [turned
9972   on][nold2] after a cycle of warnings about the change.
9973 * Semicolons may [now follow types and paths in
9974   macros](https://github.com/rust-lang/rust/pull/27000).
9975 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
9976   [more sane for dynamically sized types][dst3]. Code that relied on
9977   the previous behavior is not known to exist, and suspected to be
9978   broken.
9979 * `'static` variables [may now be recursive][st].
9980 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
9981   implementations correctly.
9982 * The `dropck` rules, which checks that destructors can't access
9983   destroyed values, [have been updated][dropck] to match the
9984   [RFC][dropckrfc].
9985
9986 Libraries
9987 ---------
9988
9989 * The [`Duration`] API, [has been stabilized][ds], as well as the
9990   `std::time` module, which presently contains only `Duration`.
9991 * `Box<str>` and `Box<[T]>` both implement `Clone`.
9992 * The owned C string, [`CString`], implements [`Borrow`] and the
9993   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
9994   these allow C strings to be borrowed and cloned in generic code.
9995 * [`CStr`] implements [`Debug`].
9996 * [`AtomicPtr`] implements [`Debug`].
9997 * [`Error`] trait objects [can be downcast to their concrete types][e]
9998   in many common configurations, using the [`is`], [`downcast`],
9999   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
10000   [`Any`] trait.
10001 * Searching for substrings now [employs the two-way algorithm][search]
10002   instead of doing a naive search. This gives major speedups to a
10003   number of methods, including [`contains`][sc], [`find`][sf],
10004   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
10005   [`ends_with`][sew] are also faster.
10006 * The performance of `PartialEq` for slices is [much faster][ps].
10007 * The [`Hash`] trait offers the default method, [`hash_slice`], which
10008   is overridden and optimized by the implementations for scalars.
10009 * The [`Hasher`] trait now has a number of specialized `write_*`
10010   methods for primitive types, for efficiency.
10011 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
10012   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
10013   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
10014   of [`std::error::Error::cause`][iec] also delegates to the inner
10015   error.
10016 * [`process::Child`][pc] gained the [`id`] method, which returns a
10017   `u32` representing the platform-specific process identifier.
10018 * The [`connect`] method on slices is deprecated, replaced by the new
10019   [`join`] method (note that both of these are on the *unstable*
10020   [`SliceConcatExt`] trait, but through the magic of the prelude are
10021   available to stable code anyway).
10022 * The [`Div`] operator is implemented for [`Wrapping`] types.
10023 * [`DerefMut` is implemented for `String`][dms].
10024 * Performance of SipHash (the default hasher for `HashMap`) is
10025   [better for long data][sh].
10026 * [`AtomicPtr`] implements [`Send`].
10027 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
10028   are now [specialized to use uninitialized buffers for increased
10029   performance][rte].
10030 * Lifetime parameters of foreign functions [are now resolved
10031   properly][f].
10032
10033 Misc
10034 ----
10035
10036 * Rust can now, with some coercion, [produce programs that run on
10037   Windows XP][xp], though XP is not considered a supported platform.
10038 * Porting Rust on Windows from the GNU toolchain to MSVC continues
10039   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
10040   recommended for use in 1.3, though should be fully-functional
10041   in the [64-bit 1.4 beta][b14].
10042 * On Fedora-based systems installation will [properly configure the
10043   dynamic linker][fl].
10044 * The compiler gained many new extended error descriptions, which can
10045   be accessed with the `--explain` flag.
10046 * The `dropck` pass, which checks that destructors can't access
10047   destroyed values, [has been rewritten][27261]. This fixes some
10048   soundness holes, and as such will cause some previously-compiling
10049   code to no longer build.
10050 * `rustc` now uses [LLVM to write archive files where possible][ar].
10051   Eventually this will eliminate the compiler's dependency on the ar
10052   utility.
10053 * Rust has [preliminary support for i686 FreeBSD][26959] (it has long
10054   supported FreeBSD on x86_64).
10055 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
10056   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
10057   more strict.
10058 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
10059   will kill the process instead of leaking][nlp].
10060
10061 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
10062 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
10063 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
10064 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
10065 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
10066 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
10067 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
10068 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
10069 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
10070 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
10071 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
10072 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
10073 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
10074 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
10075 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
10076 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
10077 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
10078 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
10079 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
10080 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
10081 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
10082 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
10083 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
10084 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
10085 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
10086 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
10087 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
10088 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
10089 [ar]: https://github.com/rust-lang/rust/pull/26926
10090 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
10091 [dms]: https://github.com/rust-lang/rust/pull/26241
10092 [27261]: https://github.com/rust-lang/rust/pull/27261
10093 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
10094 [ds]: https://github.com/rust-lang/rust/pull/26818
10095 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
10096 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
10097 [dst3]: https://github.com/rust-lang/rust/pull/27351
10098 [e]: https://github.com/rust-lang/rust/pull/24793
10099 [f]: https://github.com/rust-lang/rust/pull/26588
10100 [26959]: https://github.com/rust-lang/rust/pull/26959
10101 [fl]: https://github.com/rust-lang/rust-installer/pull/41
10102 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
10103 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
10104 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
10105 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
10106 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
10107 [lic]: https://github.com/rust-lang/rust/pull/26583
10108 [lnu]: https://github.com/rust-lang/rust/pull/27026
10109 [lr]: https://github.com/rust-lang/rust/issues/27248
10110 [lum]: https://github.com/rust-lang/rust/pull/26378
10111 [lur]: https://github.com/rust-lang/rust/pull/26783
10112 [nlp]: https://github.com/rust-lang/rust/pull/27176
10113 [nold2]: https://github.com/rust-lang/rust/pull/27045
10114 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
10115 [nom]: http://doc.rust-lang.org/nightly/nomicon/
10116 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
10117 [pi]: https://github.com/rust-lang/rust/pull/26699
10118 [ps]: https://github.com/rust-lang/rust/pull/26884
10119 [rte]: https://github.com/rust-lang/rust/pull/26950
10120 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
10121 [search]: https://github.com/rust-lang/rust/pull/26327
10122 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
10123 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
10124 [sh]: https://github.com/rust-lang/rust/pull/27280
10125 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
10126 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
10127 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
10128 [st]: https://github.com/rust-lang/rust/pull/26630
10129 [win1]: https://github.com/rust-lang/rust/pull/26569
10130 [win2]: https://github.com/rust-lang/rust/pull/26741
10131 [win3]: https://github.com/rust-lang/rust/pull/26741
10132 [win4]: https://github.com/rust-lang/rust/pull/27210
10133 [xp]: https://github.com/rust-lang/rust/pull/26569
10134
10135 Version 1.2.0 (2015-08-07)
10136 ==========================
10137
10138 * ~1200 changes, numerous bugfixes
10139
10140 Highlights
10141 ----------
10142
10143 * [Dynamically-sized-type coercions][dst] allow smart pointer types
10144   like `Rc` to contain types without a fixed size, arrays and trait
10145   objects, finally enabling use of `Rc<[T]>` and completing the
10146   implementation of DST.
10147 * [Parallel codegen][parcodegen] is now working again, which can
10148   substantially speed up large builds in debug mode; It also gets
10149   another ~33% speedup when bootstrapping on a 4 core machine (using 8
10150   jobs). It's not enabled by default, but will be "in the near
10151   future". It can be activated with the `-C codegen-units=N` flag to
10152   `rustc`.
10153 * This is the first release with [experimental support for linking
10154   with the MSVC linker and lib C on Windows (instead of using the GNU
10155   variants via MinGW)][win]. It is yet recommended only for the most
10156   intrepid Rustaceans.
10157 * Benchmark compilations are showing a 30% improvement in
10158   bootstrapping over 1.1.
10159
10160 Breaking Changes
10161 ----------------
10162
10163 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
10164   unicode case mapping, which is a previously-planned change in
10165   behavior and considered a bugfix.
10166 * [`mem::align_of`] now specifies [the *minimum alignment* for
10167   T][align], which is usually the alignment programs are interested
10168   in, and the same value reported by clang's
10169   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
10170   break real code.
10171 * [The `#[packed]` attribute is no longer silently accepted by the
10172   compiler][packed]. This attribute did nothing and code that
10173   mentioned it likely did not work as intended.
10174 * Associated type defaults are [now behind the
10175   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
10176   defaults *did not work*, but could be mentioned syntactically. As
10177   such this breakage has minimal impact.
10178
10179 Language
10180 --------
10181
10182 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
10183   matching against dereferenceable values.
10184
10185 Libraries
10186 ---------
10187
10188 * The [`Extend`] trait, which grows a collection from an iterator, is
10189   implemented over iterators of references, for `String`, `Vec`,
10190   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
10191   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
10192 * The [`iter::once`] function returns an iterator that yields a single
10193   element, and [`iter::empty`] returns an iterator that yields no
10194   elements.
10195 * The [`matches`] and [`rmatches`] methods on `str` return iterators
10196   over substring matches.
10197 * [`Cell`] and [`RefCell`] both implement `Eq`.
10198 * A number of methods for wrapping arithmetic are added to the
10199   integral types, [`wrapping_div`], [`wrapping_rem`],
10200   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
10201   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
10202   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
10203   type.. It is illegal for the default arithmetic operations in Rust
10204   to overflow; the desire to wrap must be explicit.
10205 * The `{:#?}` formatting specifier [displays the alternate,
10206   pretty-printed][debugfmt] form of the `Debug` formatter. This
10207   feature was actually introduced prior to 1.0 with little
10208   fanfare.
10209 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
10210   for writing data to formatted strings, similar to [`io::Write`].
10211 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
10212   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
10213   are used by code generators to emit implementations of [`Debug`].
10214 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
10215   methods that convert case, following Unicode case mapping.
10216 * It is now easier to handle poisoned locks. The [`PoisonError`]
10217   type, returned by failing lock operations, exposes `into_inner`,
10218   `get_ref`, and `get_mut`, which all give access to the inner lock
10219   guard, and allow the poisoned lock to continue to operate. The
10220   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
10221   poisoned lock without attempting to take the lock.
10222 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
10223   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
10224   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
10225   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
10226   `ChildStderr`.
10227 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
10228   malformed input.
10229
10230 Misc
10231 ----
10232
10233 * `rustc` employs smarter heuristics for guessing at [typos].
10234 * `rustc` emits more efficient code for [no-op conversions between
10235   unsafe pointers][nop].
10236 * Fat pointers are now [passed in pairs of immediate arguments][fat],
10237   resulting in faster compile times and smaller code.
10238
10239 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
10240 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
10241 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
10242 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
10243 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
10244 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
10245 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
10246 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
10247 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
10248 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
10249 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
10250 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
10251 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
10252 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
10253 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
10254 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
10255 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
10256 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
10257 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
10258 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
10259 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
10260 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
10261 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
10262 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
10263 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
10264 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
10265 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
10266 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
10267 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
10268 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
10269 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
10270 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
10271 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
10272 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
10273 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
10274 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
10275 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
10276 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
10277 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
10278 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
10279 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
10280 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
10281 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
10282 [align]: https://github.com/rust-lang/rust/pull/25646
10283 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
10284 [typos]: https://github.com/rust-lang/rust/pull/26087
10285 [nop]: https://github.com/rust-lang/rust/pull/26336
10286 [fat]: https://github.com/rust-lang/rust/pull/26411
10287 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
10288 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
10289 [packed]: https://github.com/rust-lang/rust/pull/25541
10290 [ad]: https://github.com/rust-lang/rust/pull/27382
10291 [win]: https://github.com/rust-lang/rust/pull/25350
10292
10293 Version 1.1.0 (2015-06-25)
10294 =========================
10295
10296 * ~850 changes, numerous bugfixes
10297
10298 Highlights
10299 ----------
10300
10301 * The [`std::fs` module has been expanded][fs] to expand the set of
10302   functionality exposed:
10303   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
10304     don't incur a syscall on some platforms.
10305   * A `symlink_metadata` function has been added.
10306   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
10307     access to all underlying information.
10308 * The compiler now contains extended explanations of many errors. When an error
10309   with an explanation occurs the compiler suggests using the `--explain` flag
10310   to read the explanation. Error explanations are also [available online][err-index].
10311 * Thanks to multiple [improvements][sk] to [type checking][pre], as
10312   well as other work, the time to bootstrap the compiler decreased by
10313   32%.
10314
10315 Libraries
10316 ---------
10317
10318 * The [`str::split_whitespace`] method splits a string on unicode
10319   whitespace boundaries.
10320 * On both Windows and Unix, new extension traits provide conversion of
10321   I/O types to and from the underlying system handles. On Unix, these
10322   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
10323   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
10324   `TcpListener`, and `UpdSocket`. Further implementations for
10325   `std::process` will be stabilized later.
10326 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
10327   Windows, symlinks can be created with
10328   `std::os::windows::symlink_dir` and
10329   `std::os::windows::symlink_file`.
10330 * The `mpsc::Receiver` type can now be converted into an iterator with
10331   `into_iter` on the [`IntoIterator`] trait.
10332 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
10333   implementation of the [`From`] trait.
10334 * The `Debug` implementation for `RangeFull` [creates output that is
10335   more consistent with other implementations][rf].
10336 * [`Debug` is implemented for `File`][file].
10337 * The `Default` implementation for `Arc` [no longer requires `Sync +
10338   Send`][arc].
10339 * [The `Iterator` methods `count`, `nth`, and `last` have been
10340   overridden for slices to have *O*(1) performance instead of *O*(*n*)][si].
10341 * Incorrect handling of paths on Windows has been improved in both the
10342   compiler and the standard library.
10343 * [`AtomicPtr` gained a `Default` implementation][ap].
10344 * In accordance with Rust's policy on arithmetic overflow `abs` now
10345   [panics on overflow when debug assertions are enabled][abs].
10346 * The [`Cloned`] iterator, which was accidentally left unstable for
10347   1.0 [has been stabilized][c].
10348 * The [`Incoming`] iterator, which iterates over incoming TCP
10349   connections, and which was accidentally unnamable in 1.0, [is now
10350   properly exported][inc].
10351 * [`BinaryHeap`] no longer corrupts itself [when functions called by
10352   `sift_up` or `sift_down` panic][bh].
10353 * The [`split_off`] method of `LinkedList` [no longer corrupts
10354   the list in certain scenarios][ll].
10355
10356 Misc
10357 ----
10358
10359 * Type checking performance [has improved notably][sk] with
10360   [multiple improvements][pre].
10361 * The compiler [suggests code changes][ch] for more errors.
10362 * rustc and it's build system have experimental support for [building
10363   toolchains against MUSL][m] instead of glibc on Linux.
10364 * The compiler defines the `target_env` cfg value, which is used for
10365   distinguishing toolchains that are otherwise for the same
10366   platform. Presently this is set to `gnu` for common GNU Linux
10367   targets and for MinGW targets, and `musl` for MUSL Linux targets.
10368 * The [`cargo rustc`][crc] command invokes a build with custom flags
10369   to rustc.
10370 * [Android executables are always position independent][pie].
10371 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
10372   with `Drop`][24935].
10373
10374 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
10375 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
10376 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
10377 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
10378 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
10379 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
10380 [rf]: https://github.com/rust-lang/rust/pull/24491
10381 [err-index]: https://doc.rust-lang.org/error-index.html
10382 [sk]: https://github.com/rust-lang/rust/pull/24615
10383 [pre]: https://github.com/rust-lang/rust/pull/25323
10384 [file]: https://github.com/rust-lang/rust/pull/24598
10385 [ch]: https://github.com/rust-lang/rust/pull/24683
10386 [arc]: https://github.com/rust-lang/rust/pull/24695
10387 [si]: https://github.com/rust-lang/rust/pull/24701
10388 [ap]: https://github.com/rust-lang/rust/pull/24834
10389 [m]: https://github.com/rust-lang/rust/pull/24777
10390 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
10391 [crc]: https://github.com/rust-lang/cargo/pull/1568
10392 [pie]: https://github.com/rust-lang/rust/pull/24953
10393 [abs]: https://github.com/rust-lang/rust/pull/25441
10394 [c]: https://github.com/rust-lang/rust/pull/25496
10395 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
10396 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
10397 [inc]: https://github.com/rust-lang/rust/pull/25522
10398 [bh]: https://github.com/rust-lang/rust/pull/25856
10399 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
10400 [ll]: https://github.com/rust-lang/rust/pull/26022
10401 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
10402 [24935]: https://github.com/rust-lang/rust/pull/24935
10403
10404 Version 1.0.0 (2015-05-15)
10405 ========================
10406
10407 * ~1500 changes, numerous bugfixes
10408
10409 Highlights
10410 ----------
10411
10412 * The vast majority of the standard library is now `#[stable]`. It is
10413   no longer possible to use unstable features with a stable build of
10414   the compiler.
10415 * Many popular crates on [crates.io] now work on the stable release
10416   channel.
10417 * Arithmetic on basic integer types now [checks for overflow in debug
10418   builds][overflow].
10419
10420 Language
10421 --------
10422
10423 * Several [restrictions have been added to trait coherence][coh] in
10424   order to make it easier for upstream authors to change traits
10425   without breaking downstream code.
10426 * Digits of binary and octal literals are [lexed more eagerly][lex] to
10427   improve error messages and macro behavior. For example, `0b1234` is
10428   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
10429 * Trait bounds [are always invariant][inv], eliminating the need for
10430   the `PhantomFn` and `MarkerTrait` lang items, which have been
10431   removed.
10432 * ["-" is no longer a valid character in crate names][cr], the `extern crate
10433   "foo" as bar` syntax has been replaced with `extern crate foo as
10434   bar`, and Cargo now automatically translates "-" in *package* names
10435   to underscore for the crate name.
10436 * [Lifetime shadowing is an error][lt].
10437 * [`Send` no longer implies `'static`][send-rfc].
10438 * [UFCS now supports trait-less associated paths][moar-ufcs] like
10439   `MyType::default()`.
10440 * Primitive types [now have inherent methods][prim-inherent],
10441   obviating the need for extension traits like `SliceExt`.
10442 * Methods with `Self: Sized` in their `where` clause are [considered
10443   object-safe][self-sized], allowing many extension traits like
10444   `IteratorExt` to be merged into the traits they extended.
10445 * You can now [refer to associated types][assoc-where] whose
10446   corresponding trait bounds appear only in a `where` clause.
10447 * The final bits of [OIBIT landed][oibit-final], meaning that traits
10448   like `Send` and `Sync` are now library-defined.
10449 * A [Reflect trait][reflect] was introduced, which means that
10450   downcasting via the `Any` trait is effectively limited to concrete
10451   types. This helps retain the potentially-important "parametricity"
10452   property: generic code cannot behave differently for different type
10453   arguments except in minor ways.
10454 * The `unsafe_destructor` feature is now deprecated in favor of the
10455   [new `dropck`][rfc769]. This change is a major reduction in unsafe
10456   code.
10457
10458 Libraries
10459 ---------
10460
10461 * The `thread_local` module [has been renamed to `std::thread`][th].
10462 * The methods of `IteratorExt` [have been moved to the `Iterator`
10463   trait itself][23300].
10464 * Several traits that implement Rust's conventions for type
10465   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
10466   [centralized in the `std::convert` module][con].
10467 * The `FromError` trait [was removed in favor of `From`][fe].
10468 * The basic sleep function [has moved to
10469   `std::thread::sleep_ms`][slp].
10470 * The `splitn` function now takes an `n` parameter that represents the
10471   number of items yielded by the returned iterator [instead of the
10472   number of 'splits'][spl].
10473 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
10474 * [Derived implementations of `PartialOrd` now order enums according
10475   to their explicitly-assigned discriminants][po].
10476 * [Methods for searching strings are generic over `Pattern`s][pat],
10477   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
10478   some others.
10479 * [In method resolution, object methods are resolved before inherent
10480   methods][meth].
10481 * [`String::from_str` has been deprecated in favor of the `From` impl,
10482   `String::from`][24517].
10483 * [`io::Error` implements `Sync`][ios].
10484 * [The `words` method on `&str` has been replaced with
10485   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
10486   a word?'
10487 * The new path and IO modules are complete and `#[stable]`. This
10488   was the major library focus for this cycle.
10489 * The path API was [revised][path-normalize] to normalize `.`,
10490   adjusting the tradeoffs in favor of the most common usage.
10491 * A large number of remaining APIs in `std` were also stabilized
10492   during this cycle; about 75% of the non-deprecated API surface
10493   is now stable.
10494 * The new [string pattern API][string-pattern] landed, which makes
10495   the string slice API much more internally consistent and flexible.
10496 * A new set of [generic conversion traits][conversion] replaced
10497   many existing ad hoc traits.
10498 * Generic numeric traits were [completely removed][num-traits]. This
10499   was made possible thanks to inherent methods for primitive types,
10500   and the removal gives maximal flexibility for designing a numeric
10501   hierarchy in the future.
10502 * The `Fn` traits are now related via [inheritance][fn-inherit]
10503   and provide ergonomic [blanket implementations][fn-blanket].
10504 * The `Index` and `IndexMut` traits were changed to
10505   [take the index by value][index-value], enabling code like
10506   `hash_map["string"]` to work.
10507 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
10508   `Copy` data is known to be `Clone` as well.
10509
10510 Misc
10511 ----
10512
10513 * Many errors now have extended explanations that can be accessed with
10514   the `--explain` flag to `rustc`.
10515 * Many new examples have been added to the standard library
10516   documentation.
10517 * rustdoc has received a number of improvements focused on completion
10518   and polish.
10519 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
10520 * Much headway was made on ecosystem-wide CI, making it possible
10521   to [compare builds for breakage][ci-compare].
10522
10523
10524 [crates.io]: http://crates.io
10525 [clo]: https://github.com/rust-lang/rust/pull/24034
10526 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
10527 [con]: https://github.com/rust-lang/rust/pull/23875
10528 [cr]: https://github.com/rust-lang/rust/pull/23419
10529 [fe]: https://github.com/rust-lang/rust/pull/23879
10530 [23300]: https://github.com/rust-lang/rust/pull/23300
10531 [inv]: https://github.com/rust-lang/rust/pull/23938
10532 [ios]: https://github.com/rust-lang/rust/pull/24133
10533 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
10534 [lt]: https://github.com/rust-lang/rust/pull/24057
10535 [meth]: https://github.com/rust-lang/rust/pull/24056
10536 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
10537 [po]: https://github.com/rust-lang/rust/pull/24270
10538 [24517]: https://github.com/rust-lang/rust/pull/24517
10539 [slp]: https://github.com/rust-lang/rust/pull/23949
10540 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
10541 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
10542 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
10543 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
10544 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
10545 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
10546 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
10547 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
10548 [self-sized]: https://github.com/rust-lang/rust/pull/22301
10549 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
10550 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
10551 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
10552 [reflect]: https://github.com/rust-lang/rust/pull/23712
10553 [conversion]: https://github.com/rust-lang/rfcs/pull/529
10554 [num-traits]: https://github.com/rust-lang/rust/pull/23549
10555 [index-value]: https://github.com/rust-lang/rust/pull/23601
10556 [rfc769]: https://github.com/rust-lang/rfcs/pull/769
10557 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
10558 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
10559 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
10560 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
10561 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
10562
10563
10564 Version 1.0.0-alpha.2 (2015-02-20)
10565 =====================================
10566
10567 * ~1300 changes, numerous bugfixes
10568
10569 * Highlights
10570
10571     * The various I/O modules were [overhauled][io-rfc] to reduce
10572       unnecessary abstractions and provide better interoperation with
10573       the underlying platform. The old `io` module remains temporarily
10574       at `std::old_io`.
10575     * The standard library now [participates in feature gating][feat],
10576       so use of unstable libraries now requires a `#![feature(...)]`
10577       attribute. The impact of this change is [described on the
10578       forum][feat-forum]. [RFC][feat-rfc].
10579
10580 * Language
10581
10582     * `for` loops [now operate on the `IntoIterator` trait][into],
10583       which eliminates the need to call `.iter()`, etc. to iterate
10584       over collections. There are some new subtleties to remember
10585       though regarding what sort of iterators various types yield, in
10586       particular that `for foo in bar { }` yields values from a move
10587       iterator, destroying the original collection. [RFC][into-rfc].
10588     * Objects now have [default lifetime bounds][obj], so you don't
10589       have to write `Box<Trait+'static>` when you don't care about
10590       storing references. [RFC][obj-rfc].
10591     * In types that implement `Drop`, [lifetimes must outlive the
10592       value][drop]. This will soon make it possible to safely
10593       implement `Drop` for types where `#[unsafe_destructor]` is now
10594       required. Read the [gorgeous RFC][drop-rfc] for details.
10595     * The fully qualified <T as Trait>::X syntax lets you set the Self
10596       type for a trait method or associated type. [RFC][ufcs-rfc].
10597     * References to types that implement `Deref<U>` now [automatically
10598       coerce to references][deref] to the dereferenced type `U`,
10599       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
10600       should eliminate many unsightly uses of `&*`, as when converting
10601       from references to vectors into references to
10602       slices. [RFC][deref-rfc].
10603     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
10604       `|:|`) is obsolete and closure kind is inferred from context.
10605     * [`Self` is a keyword][Self].
10606
10607 * Libraries
10608
10609     * The `Show` and `String` formatting traits [have been
10610       renamed][fmt] to `Debug` and `Display` to more clearly reflect
10611       their related purposes. Automatically getting a string
10612       conversion to use with `format!("{:?}", something_to_debug)` is
10613       now written `#[derive(Debug)]`.
10614     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
10615       OsStr}`, provide strings in platform-specific encodings for easier
10616       interop with system APIs. [RFC][osstr-rfc].
10617     * The `boxed::into_raw` and `Box::from_raw` functions [convert
10618       between `Box<T>` and `*mut T`][boxraw], a common pattern for
10619       creating raw pointers.
10620
10621 * Tooling
10622
10623     * Certain long error messages of the form 'expected foo found bar'
10624       are now [split neatly across multiple
10625       lines][multiline]. Examples in the PR.
10626     * On Unix Rust can be [uninstalled][un] by running
10627       `/usr/local/lib/rustlib/uninstall.sh`.
10628     * The `#[rustc_on_unimplemented]` attribute, requiring the
10629       'on_unimplemented' feature, lets rustc [display custom error
10630       messages when a trait is expected to be implemented for a type
10631       but is not][onun].
10632
10633 * Misc
10634
10635     * Rust is tested against a [LALR grammar][lalr], which parses
10636       almost all the Rust files that rustc does.
10637
10638 [boxraw]: https://github.com/rust-lang/rust/pull/21318
10639 [close]: https://github.com/rust-lang/rust/pull/21843
10640 [deref]: https://github.com/rust-lang/rust/pull/21351
10641 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
10642 [drop]: https://github.com/rust-lang/rust/pull/21972
10643 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
10644 [feat]: https://github.com/rust-lang/rust/pull/21248
10645 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
10646 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
10647 [fmt]: https://github.com/rust-lang/rust/pull/21457
10648 [into]: https://github.com/rust-lang/rust/pull/20790
10649 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
10650 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
10651 [lalr]: https://github.com/rust-lang/rust/pull/21452
10652 [multiline]: https://github.com/rust-lang/rust/pull/19870
10653 [obj]: https://github.com/rust-lang/rust/pull/22230
10654 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
10655 [onun]: https://github.com/rust-lang/rust/pull/20889
10656 [osstr]: https://github.com/rust-lang/rust/pull/21488
10657 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
10658 [Self]: https://github.com/rust-lang/rust/pull/22158
10659 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
10660 [un]: https://github.com/rust-lang/rust/pull/22256
10661
10662
10663 Version 1.0.0-alpha (2015-01-09)
10664 ==================================
10665
10666   * ~2400 changes, numerous bugfixes
10667
10668   * Highlights
10669
10670     * The language itself is considered feature complete for 1.0,
10671       though there will be many usability improvements and bugfixes
10672       before the final release.
10673     * Nearly 50% of the public API surface of the standard library has
10674       been declared 'stable'. Those interfaces are unlikely to change
10675       before 1.0.
10676     * The long-running debate over integer types has been
10677       [settled][ints]: Rust will ship with types named `isize` and
10678       `usize`, rather than `int` and `uint`, for pointer-sized
10679       integers. Guidelines will be rolled out during the alpha cycle.
10680     * Most crates that are not `std` have been moved out of the Rust
10681       distribution into the Cargo ecosystem so they can evolve
10682       separately and don't need to be stabilized as quickly, including
10683       'time', 'getopts', 'num', 'regex', and 'term'.
10684     * Documentation continues to be expanded with more API coverage, more
10685       examples, and more in-depth explanations. The guides have been
10686       consolidated into [The Rust Programming Language][trpl].
10687     * "[Rust By Example][rbe]" is now maintained by the Rust team.
10688     * All official Rust binary installers now come with [Cargo], the
10689       Rust package manager.
10690
10691 * Language
10692
10693     * Closures have been [completely redesigned][unboxed] to be
10694       implemented in terms of traits, can now be used as generic type
10695       bounds and thus monomorphized and inlined, or via an opaque
10696       pointer (boxed) as in the old system. The new system is often
10697       referred to as 'unboxed' closures.
10698     * Traits now support [associated types][assoc], allowing families
10699       of related types to be defined together and used generically in
10700       powerful ways.
10701     * Enum variants are [namespaced by their type names][enum].
10702     * [`where` clauses][where] provide a more versatile and attractive
10703       syntax for specifying generic bounds, though the previous syntax
10704       remains valid.
10705     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
10706       numeric types.
10707     * Rust [no longer has a runtime][rt] of any description, and only
10708       supports OS threads, not green threads.
10709     * At long last, Rust has been overhauled for 'dynamically-sized
10710       types' ([DST]), which integrates 'fat pointers' (object types,
10711       arrays, and `str`) more deeply into the type system, making it
10712       more consistent.
10713     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
10714       `..j` that produce range types and which, when combined with the
10715       `Index` operator and multidispatch, leads to a convenient slice
10716       notation, `[i..j]`.
10717     * The new range syntax revealed an ambiguity in the fixed-length
10718       array syntax, so now fixed length arrays [are written `[T;
10719       N]`][arrays].
10720     * The `Copy` trait is no longer implemented automatically. Unsafe
10721       pointers no longer implement `Sync` and `Send` so types
10722       containing them don't automatically either. `Sync` and `Send`
10723       are now 'unsafe traits' so one can "forcibly" implement them via
10724       `unsafe impl` if a type confirms to the requirements for them
10725       even though the internals do not (e.g. structs containing unsafe
10726       pointers like `Arc`). These changes are intended to prevent some
10727       footguns and are collectively known as [opt-in built-in
10728       traits][oibit] (though `Sync` and `Send` will soon become pure
10729       library types unknown to the compiler).
10730     * Operator traits now take their operands [by value][ops], and
10731       comparison traits can use multidispatch to compare one type
10732       against multiple other types, allowing e.g. `String` to be
10733       compared with `&str`.
10734     * `if let` and `while let` are no longer feature-gated.
10735     * Rust has adopted a more [uniform syntax for escaping unicode
10736       characters][unicode].
10737     * `macro_rules!` [has been declared stable][mac]. Though it is a
10738       flawed system it is sufficiently popular that it must be usable
10739       for 1.0. Effort has gone into [future-proofing][mac-future] it
10740       in ways that will allow other macro systems to be developed in
10741       parallel, and won't otherwise impact the evolution of the
10742       language.
10743     * The prelude has been [pared back significantly][prelude] such
10744       that it is the minimum necessary to support the most pervasive
10745       code patterns, and through [generalized where clauses][where]
10746       many of the prelude extension traits have been consolidated.
10747     * Rust's rudimentary reflection [has been removed][refl], as it
10748       incurred too much code generation for little benefit.
10749     * [Struct variants][structvars] are no longer feature-gated.
10750     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
10751       known as 'higher-ranked trait bounds', this crucially allows
10752       unboxed closures to work.
10753     * Macros invocations surrounded by parens or square brackets and
10754       not terminated by a semicolon are [parsed as
10755       expressions][macros], which makes expressions like `vec![1i32,
10756       2, 3].len()` work as expected.
10757     * Trait objects now implement their traits automatically, and
10758       traits that can be coerced to objects now must be [object
10759       safe][objsafe].
10760     * Automatically deriving traits is now done with `#[derive(...)]`
10761       not `#[deriving(...)]` for [consistency with other naming
10762       conventions][derive].
10763     * Importing the containing module or enum at the same time as
10764       items or variants they contain is [now done with `self` instead
10765       of `mod`][self], as in use `foo::{self, bar}`
10766     * Glob imports are no longer feature-gated.
10767     * The `box` operator and `box` patterns have been feature-gated
10768       pending a redesign. For now unique boxes should be allocated
10769       like other containers, with `Box::new`.
10770
10771 * Libraries
10772
10773     * A [series][coll1] of [efforts][coll2] to establish
10774       [conventions][coll3] for collections types has resulted in API
10775       improvements throughout the standard library.
10776     * New [APIs for error handling][err] provide ergonomic interop
10777       between error types, and [new conventions][err-conv] describe
10778       more clearly the recommended error handling strategies in Rust.
10779     * The `fail!` macro has been renamed to [`panic!`][panic] so that
10780       it is easier to discuss failure in the context of error handling
10781       without making clarifications as to whether you are referring to
10782       the 'fail' macro or failure more generally.
10783     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
10784       syscall when available.
10785     * The 'serialize' crate has been renamed 'rustc-serialize' and
10786       moved out of the distribution to Cargo. Although it is widely
10787       used now, it is expected to be superseded in the near future.
10788     * The `Show` formatter, typically implemented with
10789       `#[derive(Show)]` is [now requested with the `{:?}`
10790       specifier][show] and is intended for use by all types, for uses
10791       such as `println!` debugging. The new `String` formatter must be
10792       implemented by hand, uses the `{}` specifier, and is intended
10793       for full-fidelity conversions of things that can logically be
10794       represented as strings.
10795
10796 * Tooling
10797
10798     * [Flexible target specification][flex] allows rustc's code
10799       generation to be configured to support otherwise-unsupported
10800       platforms.
10801     * Rust comes with rust-gdb and rust-lldb scripts that launch their
10802       respective debuggers with Rust-appropriate pretty-printing.
10803     * The Windows installation of Rust is distributed with the
10804       MinGW components currently required to link binaries on that
10805       platform.
10806
10807 * Misc
10808
10809     * Nullable enum optimizations have been extended to more types so
10810       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
10811       space than the inner types themselves.
10812     * Work has begun on supporting AArch64.
10813
10814 [Cargo]: https://crates.io
10815 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
10816 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
10817 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
10818 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
10819 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
10820 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
10821 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
10822 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
10823 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
10824 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
10825 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
10826 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
10827 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
10828 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
10829 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
10830 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
10831 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
10832 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
10833 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
10834 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
10835 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
10836 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
10837 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
10838 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
10839 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
10840 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
10841 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
10842 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
10843 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
10844 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
10845 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
10846 [trpl]: https://doc.rust-lang.org/book/index.html
10847 [rbe]: http://rustbyexample.com/
10848
10849
10850 Version 0.12.0 (2014-10-09)
10851 =============================
10852
10853   * ~1900 changes, numerous bugfixes
10854
10855   * Highlights
10856
10857     * The introductory documentation (now called The Rust Guide) has
10858       been completely rewritten, as have a number of supplementary
10859       guides.
10860     * Rust's package manager, Cargo, continues to improve and is
10861       sometimes considered to be quite awesome.
10862     * Many API's in `std` have been reviewed and updated for
10863       consistency with the in-development Rust coding
10864       guidelines. The standard library documentation tracks
10865       stabilization progress.
10866     * Minor libraries have been moved out-of-tree to the rust-lang org
10867       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
10868       be installed with Cargo.
10869     * Lifetime elision allows lifetime annotations to be left off of
10870       function declarations in many common scenarios.
10871     * Rust now works on 64-bit Windows.
10872
10873   * Language
10874     * Indexing can be overloaded with the `Index` and `IndexMut`
10875       traits.
10876     * The `if let` construct takes a branch only if the `let` pattern
10877       matches, currently behind the 'if_let' feature gate.
10878     * 'where clauses', a more flexible syntax for specifying trait
10879       bounds that is more aesthetic, have been added for traits and
10880       free functions. Where clauses will in the future make it
10881       possible to constrain associated types, which would be
10882       impossible with the existing syntax.
10883     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
10884       the 'slicing_syntax' feature gate, and can be overloaded with
10885       the `Slice` or `SliceMut` traits.
10886     * The syntax for matching of sub-slices has been changed to use a
10887       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
10888       consistency with other uses of `..` and to future-proof
10889       potential additional uses of the syntax.
10890     * The syntax for matching inclusive ranges in patterns has changed
10891       from `0..3` to `0...4` to be consistent with the exclusive range
10892       syntax for slicing.
10893     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
10894       c]`) has been put behind the 'advanced_slice_patterns' feature
10895       gate and may be removed in the future.
10896     * Components of tuples and tuple structs can be extracted using
10897       the `value.0` syntax, currently behind the `tuple_indexing`
10898       feature gate.
10899     * The `#[crate_id]` attribute is no longer supported; versioning
10900       is handled by the package manager.
10901     * Renaming crate imports are now written `extern crate foo as bar`
10902       instead of `extern crate bar = foo`.
10903     * Renaming use statements are now written `use foo as bar` instead
10904       of `use bar = foo`.
10905     * `let` and `match` bindings and argument names in macros are now
10906       hygienic.
10907     * The new, more efficient, closure types ('unboxed closures') have
10908       been added under a feature gate, 'unboxed_closures'. These will
10909       soon replace the existing closure types, once higher-ranked
10910       trait lifetimes are added to the language.
10911     * `move` has been added as a keyword, for indicating closures
10912       that capture by value.
10913     * Mutation and assignment is no longer allowed in pattern guards.
10914     * Generic structs and enums can now have trait bounds.
10915     * The `Share` trait is now called `Sync` to free up the term
10916       'shared' to refer to 'shared reference' (the default reference
10917       type.
10918     * Dynamically-sized types have been mostly implemented,
10919       unifying the behavior of fat-pointer types with the rest of the
10920       type system.
10921     * As part of dynamically-sized types, the `Sized` trait has been
10922       introduced, which qualifying types implement by default, and
10923       which type parameters expect by default. To specify that a type
10924       parameter does not need to be sized, write `<Sized? T>`. Most
10925       types are `Sized`, notable exceptions being unsized arrays
10926       (`[T]`) and trait types.
10927     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
10928     * Lifetime bounds can now be applied to type parameters and object
10929       types.
10930     * The old, reference counted GC type, `Gc<T>` which was once
10931       denoted by the `@` sigil, has finally been removed. GC will be
10932       revisited in the future.
10933
10934   * Libraries
10935     * Library documentation has been improved for a number of modules.
10936     * Bit-vectors, collections::bitv has been modernized.
10937     * The url crate is deprecated in favor of
10938       http://github.com/servo/rust-url, which can be installed with
10939       Cargo.
10940     * Most I/O stream types can be cloned and subsequently closed from
10941       a different thread.
10942     * A `std::time::Duration` type has been added for use in I/O
10943       methods that rely on timers, as well as in the 'time' crate's
10944       `Timespec` arithmetic.
10945     * The runtime I/O abstraction layer that enabled the green thread
10946       scheduler to do non-thread-blocking I/O has been removed, along
10947       with the libuv-based implementation employed by the green thread
10948       scheduler. This will greatly simplify the future I/O work.
10949     * `collections::btree` has been rewritten to have a more
10950       idiomatic and efficient design.
10951
10952   * Tooling
10953     * rustdoc output now indicates the stability levels of API's.
10954     * The `--crate-name` flag can specify the name of the crate
10955       being compiled, like `#[crate_name]`.
10956     * The `-C metadata` specifies additional metadata to hash into
10957       symbol names, and `-C extra-filename` specifies additional
10958       information to put into the output filename, for use by the
10959       package manager for versioning.
10960     * debug info generation has continued to improve and should be
10961       more reliable under both gdb and lldb.
10962     * rustc has experimental support for compiling in parallel
10963       using the `-C codegen-units` flag.
10964     * rustc no longer encodes rpath information into binaries by
10965       default.
10966
10967   * Misc
10968     * Stack usage has been optimized with LLVM lifetime annotations.
10969     * Official Rust binaries on Linux are more compatible with older
10970       kernels and distributions, built on CentOS 5.10.
10971
10972
10973 Version 0.11.0 (2014-07-02)
10974 ==========================
10975
10976   * ~1700 changes, numerous bugfixes
10977
10978   * Language
10979     * ~[T] has been removed from the language. This type is superseded by
10980       the Vec<T> type.
10981     * ~str has been removed from the language. This type is superseded by
10982       the String type.
10983     * ~T has been removed from the language. This type is superseded by the
10984       Box<T> type.
10985     * @T has been removed from the language. This type is superseded by the
10986       standard library's std::gc::Gc<T> type.
10987     * Struct fields are now all private by default.
10988     * Vector indices and shift amounts are both required to be a `uint`
10989       instead of any integral type.
10990     * Byte character, byte string, and raw byte string literals are now all
10991       supported by prefixing the normal literal with a `b`.
10992     * Multiple ABIs are no longer allowed in an ABI string
10993     * The syntax for lifetimes on closures/procedures has been tweaked
10994       slightly: `<'a>|A, B|: 'b + K -> T`
10995     * Floating point modulus has been removed from the language; however it
10996       is still provided by a library implementation.
10997     * Private enum variants are now disallowed.
10998     * The `priv` keyword has been removed from the language.
10999     * A closure can no longer be invoked through a &-pointer.
11000     * The `use foo, bar, baz;` syntax has been removed from the language.
11001     * The transmute intrinsic no longer works on type parameters.
11002     * Statics now allow blocks/items in their definition.
11003     * Trait bounds are separated from objects with + instead of : now.
11004     * Objects can no longer be read while they are mutably borrowed.
11005     * The address of a static is now marked as insignificant unless the
11006       #[inline(never)] attribute is placed it.
11007     * The #[unsafe_destructor] attribute is now behind a feature gate.
11008     * Struct literals are no longer allowed in ambiguous positions such as
11009       if, while, match, and for..in.
11010     * Declaration of lang items and intrinsics are now feature-gated by
11011       default.
11012     * Integral literals no longer default to `int`, and floating point
11013       literals no longer default to `f64`. Literals must be suffixed with an
11014       appropriate type if inference cannot determine the type of the
11015       literal.
11016     * The Box<T> type is no longer implicitly borrowed to &mut T.
11017     * Procedures are now required to not capture borrowed references.
11018
11019   * Libraries
11020     * The standard library is now a "facade" over a number of underlying
11021       libraries. This means that development on the standard library should
11022       be speedier due to smaller crates, as well as a clearer line between
11023       all dependencies.
11024     * A new library, libcore, lives under the standard library's facade
11025       which is Rust's "0-assumption" library, suitable for embedded and
11026       kernel development for example.
11027     * A regex crate has been added to the standard distribution. This crate
11028       includes statically compiled regular expressions.
11029     * The unwrap/unwrap_err methods on Result require a Show bound for
11030       better error messages.
11031     * The return types of the std::comm primitives have been centralized
11032       around the Result type.
11033     * A number of I/O primitives have gained the ability to time out their
11034       operations.
11035     * A number of I/O primitives have gained the ability to close their
11036       reading/writing halves to cancel pending operations.
11037     * Reverse iterator methods have been removed in favor of `rev()` on
11038       their forward-iteration counterparts.
11039     * A bitflags! macro has been added to enable easy interop with C and
11040       management of bit flags.
11041     * A debug_assert! macro is now provided which is disabled when
11042       `--cfg ndebug` is passed to the compiler.
11043     * A graphviz crate has been added for creating .dot files.
11044     * The std::cast module has been migrated into std::mem.
11045     * The std::local_data api has been migrated from freestanding functions
11046       to being based on methods.
11047     * The Pod trait has been renamed to Copy.
11048     * jemalloc has been added as the default allocator for types.
11049     * The API for allocating memory has been changed to use proper alignment
11050       and sized deallocation
11051     * Connecting a TcpStream or binding a TcpListener is now based on a
11052       string address and a u16 port. This allows connecting to a hostname as
11053       opposed to an IP.
11054     * The Reader trait now contains a core method, read_at_least(), which
11055       correctly handles many repeated 0-length reads.
11056     * The process-spawning API is now centered around a builder-style
11057       Command struct.
11058     * The :? printing qualifier has been moved from the standard library to
11059       an external libdebug crate.
11060     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
11061       have been renamed to Eq/Ord.
11062     * The select/plural methods have been removed from format!. The escapes
11063       for { and } have also changed from \{ and \} to {{ and }},
11064       respectively.
11065     * The TaskBuilder API has been re-worked to be a true builder, and
11066       extension traits for spawning native/green tasks have been added.
11067
11068   * Tooling
11069     * All breaking changes to the language or libraries now have their
11070       commit message annotated with `[breaking-change]` to allow for easy
11071       discovery of breaking changes.
11072     * The compiler will now try to suggest how to annotate lifetimes if a
11073       lifetime-related error occurs.
11074     * Debug info continues to be improved greatly with general bug fixes and
11075       better support for situations like link time optimization (LTO).
11076     * Usage of syntax extensions when cross-compiling has been fixed.
11077     * Functionality equivalent to GCC & Clang's -ffunction-sections,
11078       -fdata-sections and --gc-sections has been enabled by default
11079     * The compiler is now stricter about where it will load module files
11080       from when a module is declared via `mod foo;`.
11081     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
11082       Syntax extensions are now discovered via a "plugin registrar" type
11083       which will be extended in the future to other various plugins.
11084     * Lints have been restructured to allow for dynamically loadable lints.
11085     * A number of rustdoc improvements:
11086       * The HTML output has been visually redesigned.
11087       * Markdown is now powered by hoedown instead of sundown.
11088       * Searching heuristics have been greatly improved.
11089       * The search index has been reduced in size by a great amount.
11090       * Cross-crate documentation via `pub use` has been greatly improved.
11091       * Primitive types are now hyperlinked and documented.
11092     * Documentation has been moved from static.rust-lang.org/doc to
11093       doc.rust-lang.org
11094     * A new sandbox, play.rust-lang.org, is available for running and
11095       sharing rust code examples on-line.
11096     * Unused attributes are now more robustly warned about.
11097     * The dead_code lint now warns about unused struct fields.
11098     * Cross-compiling to iOS is now supported.
11099     * Cross-compiling to mipsel is now supported.
11100     * Stability attributes are now inherited by default and no longer apply
11101       to intra-crate usage, only inter-crate usage.
11102     * Error message related to non-exhaustive match expressions have been
11103       greatly improved.
11104
11105
11106 Version 0.10 (2014-04-03)
11107 =========================
11108
11109   * ~1500 changes, numerous bugfixes
11110
11111   * Language
11112     * A new RFC process is now in place for modifying the language.
11113     * Patterns with `@`-pointers have been removed from the language.
11114     * Patterns with unique vectors (`~[T]`) have been removed from the
11115       language.
11116     * Patterns with unique strings (`~str`) have been removed from the
11117       language.
11118     * `@str` has been removed from the language.
11119     * `@[T]` has been removed from the language.
11120     * `@self` has been removed from the language.
11121     * `@Trait` has been removed from the language.
11122     * Headers on `~` allocations which contain `@` boxes inside the type for
11123       reference counting have been removed.
11124     * The semantics around the lifetimes of temporary expressions have changed,
11125       see #3511 and #11585 for more information.
11126     * Cross-crate syntax extensions are now possible, but feature gated. See
11127       #11151 for more information. This includes both `macro_rules!` macros as
11128       well as syntax extensions such as `format!`.
11129     * New lint modes have been added, and older ones have been turned on to be
11130       warn-by-default.
11131       * Unnecessary parentheses
11132       * Uppercase statics
11133       * Camel Case types
11134       * Uppercase variables
11135       * Publicly visible private types
11136       * `#[deriving]` with raw pointers
11137     * Unsafe functions can no longer be coerced to closures.
11138     * Various obscure macros such as `log_syntax!` are now behind feature gates.
11139     * The `#[simd]` attribute is now behind a feature gate.
11140     * Visibility is no longer allowed on `extern crate` statements, and
11141       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
11142     * Trailing commas are now allowed in argument lists and tuple patterns.
11143     * The `do` keyword has been removed, it is now a reserved keyword.
11144     * Default type parameters have been implemented, but are feature gated.
11145     * Borrowed variables through captures in closures are now considered soundly.
11146     * `extern mod` is now `extern crate`
11147     * The `Freeze` trait has been removed.
11148     * The `Share` trait has been added for types that can be shared among
11149       threads.
11150     * Labels in macros are now hygienic.
11151     * Expression/statement macro invocations can be delimited with `{}` now.
11152     * Treatment of types allowed in `static mut` locations has been tweaked.
11153     * The `*` and `.` operators are now overloadable through the `Deref` and
11154       `DerefMut` traits.
11155     * `~Trait` and `proc` no longer have `Send` bounds by default.
11156     * Partial type hints are now supported with the `_` type marker.
11157     * An `Unsafe` type was introduced for interior mutability. It is now
11158       considered undefined to transmute from `&T` to `&mut T` without using the
11159       `Unsafe` type.
11160     * The #[linkage] attribute was implemented for extern statics/functions.
11161     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
11162     * `Pod` was renamed to `Copy`.
11163
11164   * Libraries
11165     * The `libextra` library has been removed. It has now been decomposed into
11166       component libraries with smaller and more focused nuggets of
11167       functionality. The full list of libraries can be found on the
11168       documentation index page.
11169     * std: `std::condition` has been removed. All I/O errors are now propagated
11170       through the `Result` type. In order to assist with error handling, a
11171       `try!` macro for unwrapping errors with an early return and a lint for
11172       unused results has been added. See #12039 for more information.
11173     * std: The `vec` module has been renamed to `slice`.
11174     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
11175       This will become the only growable vector in the future.
11176     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
11177       are now found at `std::io::BufferedReader` instead of
11178       `std::io::buffered::BufferedReader`.
11179     * std: `print` and `println` are no longer in the prelude, the `print!` and
11180       `println!` macros are intended to be used instead.
11181     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
11182       attempts to statically prevent cycles.
11183     * std: The standard distribution is adopting the policy of pushing failure
11184       to the user rather than failing in libraries. Many functions (such as
11185       `slice::last()`) now return `Option<T>` instead of `T` + failing.
11186     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
11187       deriving mode: `#[deriving(Show)]`.
11188     * std: `ToStr` is now implemented for all types implementing `Show`.
11189     * std: The formatting trait methods now take `&self` instead of `&T`
11190     * std: The `invert()` method on iterators has been renamed to `rev()`
11191     * std: `std::num` has seen a reduction in the genericity of its traits,
11192       consolidating functionality into a few core traits.
11193     * std: Backtraces are now printed on task failure if the environment
11194       variable `RUST_BACKTRACE` is present.
11195     * std: Naming conventions for iterators have been standardized. More details
11196       can be found on the wiki's style guide.
11197     * std: `eof()` has been removed from the `Reader` trait. Specific types may
11198       still implement the function.
11199     * std: Networking types are now cloneable to allow simultaneous reads/writes.
11200     * std: `assert_approx_eq!` has been removed
11201     * std: The `e` and `E` formatting specifiers for floats have been added to
11202       print them in exponential notation.
11203     * std: The `Times` trait has been removed
11204     * std: Indications of variance and opting out of builtin bounds is done
11205       through marker types in `std::kinds::marker` now
11206     * std: `hash` has been rewritten, `IterBytes` has been removed, and
11207       `#[deriving(Hash)]` is now possible.
11208     * std: `SharedChan` has been removed, `Sender` is now cloneable.
11209     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
11210     * std: `Chan::new` is now `channel()`.
11211     * std: A new synchronous channel type has been implemented.
11212     * std: A `select!` macro is now provided for selecting over `Receiver`s.
11213     * std: `hashmap` and `trie` have been moved to `libcollections`
11214     * std: `run` has been rolled into `io::process`
11215     * std: `assert_eq!` now uses `{}` instead of `{:?}`
11216     * std: The equality and comparison traits have seen some reorganization.
11217     * std: `rand` has moved to `librand`.
11218     * std: `to_{lower,upper}case` has been implemented for `char`.
11219     * std: Logging has been moved to `liblog`.
11220     * collections: `HashMap` has been rewritten for higher performance and less
11221       memory usage.
11222     * native: The default runtime is now `libnative`. If `libgreen` is desired,
11223       it can be booted manually. The runtime guide has more information and
11224       examples.
11225     * native: All I/O functionality except signals has been implemented.
11226     * green: Task spawning with `libgreen` has been optimized with stack caching
11227       and various trimming of code.
11228     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
11229     * sync: The `extra::sync` module has been updated to modern rust (and moved
11230       to the `sync` library), tweaking and improving various interfaces while
11231       dropping redundant functionality.
11232     * sync: A new `Barrier` type has been added to the `sync` library.
11233     * sync: An efficient mutex for native and green tasks has been implemented.
11234     * serialize: The `base64` module has seen some improvement. It treats
11235       newlines better, has non-string error values, and has seen general
11236       cleanup.
11237     * fourcc: A `fourcc!` macro was introduced
11238     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
11239       hexadecimal literal.
11240
11241   * Tooling
11242     * `rustpkg` has been deprecated and removed from the main repository. Its
11243       replacement, `cargo`, is under development.
11244     * Nightly builds of rust are now available
11245     * The memory usage of rustc has been improved many times throughout this
11246       release cycle.
11247     * The build process supports disabling rpath support for the rustc binary
11248       itself.
11249     * Code generation has improved in some cases, giving more information to the
11250       LLVM optimization passes to enable more extensive optimizations.
11251     * Debuginfo compatibility with lldb on OSX has been restored.
11252     * The master branch is now gated on an android bot, making building for
11253       android much more reliable.
11254     * Output flags have been centralized into one `--emit` flag.
11255     * Crate type flags have been centralized into one `--crate-type` flag.
11256     * Codegen flags have been consolidated behind a `-C` flag.
11257     * Linking against outdated crates now has improved error messages.
11258     * Error messages with lifetimes will often suggest how to annotate the
11259       function to fix the error.
11260     * Many more types are documented in the standard library, and new guides
11261       were written.
11262     * Many `rustdoc` improvements:
11263       * code blocks are syntax highlighted.
11264       * render standalone markdown files.
11265       * the --test flag tests all code blocks by default.
11266       * exported macros are displayed.
11267       * re-exported types have their documentation inlined at the location of the
11268         first re-export.
11269       * search works across crates that have been rendered to the same output
11270         directory.
11271
11272
11273 Version 0.9 (2014-01-09)
11274 ==========================
11275
11276    * ~1800 changes, numerous bugfixes
11277
11278    * Language
11279       * The `float` type has been removed. Use `f32` or `f64` instead.
11280       * A new facility for enabling experimental features (feature gating) has
11281         been added, using the crate-level `#[feature(foo)]` attribute.
11282       * Managed boxes (@) are now behind a feature gate
11283         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
11284         standard library's `Gc` or `Rc` types instead.
11285       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
11286       * Jumping back to the top of a loop is now done with `continue` instead of
11287         `loop`.
11288       * Strings can no longer be mutated through index assignment.
11289       * Raw strings can be created via the basic `r"foo"` syntax or with matched
11290         hash delimiters, as in `r###"foo"###`.
11291       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
11292         called once.
11293       * The `&fn` type is now written `|args| -> ret` to match the literal form.
11294       * `@fn`s have been removed.
11295       * `do` only works with procs in order to make it obvious what the cost
11296         of `do` is.
11297       * Single-element tuple-like structs can no longer be dereferenced to
11298         obtain the inner value. A more comprehensive solution for overloading
11299         the dereference operator will be provided in the future.
11300       * The `#[link(...)]` attribute has been replaced with
11301         `#[crate_id = "name#vers"]`.
11302       * Empty `impl`s must be terminated with empty braces and may not be
11303         terminated with a semicolon.
11304       * Keywords are no longer allowed as lifetime names; the `self` lifetime
11305         no longer has any special meaning.
11306       * The old `fmt!` string formatting macro has been removed.
11307       * `printf!` and `printfln!` (old-style formatting) removed in favor of
11308         `print!` and `println!`.
11309       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
11310       * The `extern mod foo (name = "bar")` syntax has been removed. Use
11311         `extern mod foo = "bar"` instead.
11312       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
11313       * Macros can have attributes.
11314       * Macros can expand to items with attributes.
11315       * Macros can expand to multiple items.
11316       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
11317       * Comments may be nested.
11318       * Values automatically coerce to trait objects they implement, without
11319         an explicit `as`.
11320       * Enum discriminants are no longer an entire word but as small as needed to
11321         contain all the variants. The `repr` attribute can be used to override
11322         the discriminant size, as in `#[repr(int)]` for integer-sized, and
11323         `#[repr(C)]` to match C enums.
11324       * Non-string literals are not allowed in attributes (they never worked).
11325       * The FFI now supports variadic functions.
11326       * Octal numeric literals, as in `0o7777`.
11327       * The `concat!` syntax extension performs compile-time string concatenation.
11328       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
11329         removed as Rust no longer uses segmented stacks.
11330       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
11331       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
11332         not `*`; ignoring remaining fields of a struct is also done with `..`,
11333         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
11334       * `rustc` supports the "win64" calling convention via `extern "win64"`.
11335       * `rustc` supports the "system" calling convention, which defaults to the
11336         preferred convention for the target platform, "stdcall" on 32-bit Windows,
11337         "C" elsewhere.
11338       * The `type_overflow` lint (default: warn) checks literals for overflow.
11339       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
11340       * The `attribute_usage` lint (default: warn) warns about unknown
11341         attributes.
11342       * The `unknown_features` lint (default: warn) warns about unknown
11343         feature gates.
11344       * The `dead_code` lint (default: warn) checks for dead code.
11345       * Rust libraries can be linked statically to one another
11346       * `#[link_args]` is behind the `link_args` feature gate.
11347       * Native libraries are now linked with `#[link(name = "foo")]`
11348       * Native libraries can be statically linked to a rust crate
11349         (`#[link(name = "foo", kind = "static")]`).
11350       * Native OS X frameworks are now officially supported
11351         (`#[link(name = "foo", kind = "framework")]`).
11352       * The `#[thread_local]` attribute creates thread-local (not task-local)
11353         variables. Currently behind the `thread_local` feature gate.
11354       * The `return` keyword may be used in closures.
11355       * Types that can be copied via a memcpy implement the `Pod` kind.
11356       * The `cfg` attribute can now be used on struct fields and enum variants.
11357
11358    * Libraries
11359       * std: The `option` and `result` API's have been overhauled to make them
11360         simpler, more consistent, and more composable.
11361       * std: The entire `std::io` module has been replaced with one that is
11362         more comprehensive and that properly interfaces with the underlying
11363         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
11364         implemented.
11365       * std: `io::util` contains a number of useful implementations of
11366         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
11367         `ZeroReader`, `TeeReader`.
11368       * std: The reference counted pointer type `extra::rc` moved into std.
11369       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
11370         just a wrapper around it).
11371       * std: The `Either` type has been removed.
11372       * std: `fmt::Default` can be implemented for any type to provide default
11373         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
11374       * std: The `rand` API continues to be tweaked.
11375       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
11376         on failure in gdb, is now named `rust_fail`.
11377       * std: The `each_key` and `each_value` methods on `HashMap` have been
11378         replaced by the `keys` and `values` iterators.
11379       * std: Functions dealing with type size and alignment have moved from the
11380         `sys` module to the `mem` module.
11381       * std: The `path` module was written and API changed.
11382       * std: `str::from_utf8` has been changed to cast instead of allocate.
11383       * std: `starts_with` and `ends_with` methods added to vectors via the
11384         `ImmutableEqVector` trait, which is in the prelude.
11385       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
11386         if the index is out of bounds.
11387       * std: Task failure no longer propagates between tasks, as the model was
11388         complex, expensive, and incompatible with thread-based tasks.
11389       * std: The `Any` type can be used for dynamic typing.
11390       * std: `~Any` can be passed to the `fail!` macro and retrieved via
11391         `task::try`.
11392       * std: Methods that produce iterators generally do not have an `_iter`
11393         suffix now.
11394       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
11395         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
11396       * std: `util::ignore` renamed to `prelude::drop`.
11397       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
11398         trait.
11399       * std: `vec::raw` has seen a lot of cleanup and API changes.
11400       * std: The standard library no longer includes any C++ code, and very
11401         minimal C, eliminating the dependency on libstdc++.
11402       * std: Runtime scheduling and I/O functionality has been factored out into
11403         extensible interfaces and is now implemented by two different crates:
11404         libnative, for native threading and I/O; and libgreen, for green threading
11405         and I/O. This paves the way for using the standard library in more limited
11406         embedded environments.
11407       * std: The `comm` module has been rewritten to be much faster, have a
11408         simpler, more consistent API, and to work for both native and green
11409         threading.
11410       * std: All libuv dependencies have been moved into the rustuv crate.
11411       * native: New implementations of runtime scheduling on top of OS threads.
11412       * native: New native implementations of TCP, UDP, file I/O, process spawning,
11413         and other I/O.
11414       * green: The green thread scheduler and message passing types are almost
11415         entirely lock-free.
11416       * extra: The `flatpipes` module had bitrotted and was removed.
11417       * extra: All crypto functions have been removed and Rust now has a policy of
11418         not reimplementing crypto in the standard library. In the future crypto
11419         will be provided by external crates with bindings to established libraries.
11420       * extra: `c_vec` has been modernized.
11421       * extra: The `sort` module has been removed. Use the `sort` method on
11422         mutable slices.
11423
11424    * Tooling
11425       * The `rust` and `rusti` commands have been removed, due to lack of
11426         maintenance.
11427       * `rustdoc` was completely rewritten.
11428       * `rustdoc` can test code examples in documentation.
11429       * `rustpkg` can test packages with the argument, 'test'.
11430       * `rustpkg` supports arbitrary dependencies, including C libraries.
11431       * `rustc`'s support for generating debug info is improved again.
11432       * `rustc` has better error reporting for unbalanced delimiters.
11433       * `rustc`'s JIT support was removed due to bitrot.
11434       * Executables and static libraries can be built with LTO (-Z lto)
11435       * `rustc` adds a `--dep-info` flag for communicating dependencies to
11436         build tools.
11437
11438
11439 Version 0.8 (2013-09-26)
11440 ============================
11441
11442    * ~2200 changes, numerous bugfixes
11443
11444    * Language
11445       * The `for` loop syntax has changed to work with the `Iterator` trait.
11446       * At long last, unwinding works on Windows.
11447       * Default methods are ready for use.
11448       * Many trait inheritance bugs fixed.
11449       * Owned and borrowed trait objects work more reliably.
11450       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
11451       * rustc can omit emission of code for the `debug!` macro if it is passed
11452         `--cfg ndebug`
11453       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
11454         for foo.rs, then foo/mod.rs, and will generate an error when both are
11455         present.
11456       * Strings no longer contain trailing nulls. The new `std::c_str` module
11457         provides new mechanisms for converting to C strings.
11458       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
11459       * The FFI has been overhauled such that foreign functions are called directly,
11460         instead of through a stack-switching wrapper.
11461       * Calling a foreign function must be done through a Rust function with the
11462         `#[fixed_stack_segment]` attribute.
11463       * The `externfn!` macro can be used to declare both a foreign function and
11464         a `#[fixed_stack_segment]` wrapper at once.
11465       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
11466       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
11467       * `priv` is disallowed everywhere except for struct fields and enum variants.
11468       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
11469       * `ref` bindings in irrefutable patterns work correctly now.
11470       * `char` is now prevented from containing invalid code points.
11471       * Casting to `bool` is no longer allowed.
11472       * `\0` is now accepted as an escape in chars and strings.
11473       * `yield` is a reserved keyword.
11474       * `typeof` is a reserved keyword.
11475       * Crates may be imported by URL with `extern mod foo = "url";`.
11476       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
11477       * Static vectors can be initialized with repeating elements,
11478         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
11479       * Static structs can be initialized with functional record update,
11480         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
11481       * `cfg!` can be used to conditionally execute code based on the crate
11482         configuration, similarly to `#[cfg(...)]`.
11483       * The `unnecessary_qualification` lint detects unneeded module
11484         prefixes (default: allow).
11485       * Arithmetic operations have been implemented on the SIMD types in
11486         `std::unstable::simd`.
11487       * Exchange allocation headers were removed, reducing memory usage.
11488       * `format!` implements a completely new, extensible, and higher-performance
11489         string formatting system. It will replace `fmt!`.
11490       * `print!` and `println!` write formatted strings (using the `format!`
11491         extension) to stdout.
11492       * `write!` and `writeln!` write formatted strings (using the `format!`
11493         extension) to the new Writers in `std::rt::io`.
11494       * The library section in which a function or static is placed may
11495         be specified with `#[link_section = "..."]`.
11496       * The `proto!` syntax extension for defining bounded message protocols
11497         was removed.
11498       * `macro_rules!` is hygienic for `let` declarations.
11499       * The `#[export_name]` attribute specifies the name of a symbol.
11500       * `unreachable!` can be used to indicate unreachable code, and fails
11501         if executed.
11502
11503    * Libraries
11504       * std: Transitioned to the new runtime, written in Rust.
11505       * std: Added an experimental I/O library, `rt::io`, based on the new
11506         runtime.
11507       * std: A new generic `range` function was added to the prelude, replacing
11508         `uint::range` and friends.
11509       * std: `range_rev` no longer exists. Since range is an iterator it can be
11510         reversed with `range(lo, hi).invert()`.
11511       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
11512         renamed to `unwrap_or`.
11513       * std: The `iterator` module was renamed to `iter`.
11514       * std: Integral types now support the `checked_add`, `checked_sub`, and
11515         `checked_mul` operations for detecting overflow.
11516       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
11517         consistency.
11518       * std: Methods are standardizing on conventions for casting methods:
11519         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
11520         and cheap casts.
11521       * std: The `CString` type in `c_str` provides new ways to convert to and
11522         from C strings.
11523       * std: `DoubleEndedIterator` can yield elements in two directions.
11524       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
11525         two splices.
11526       * std: `str::from_bytes` renamed to `str::from_utf8`.
11527       * std: `pop_opt` and `shift_opt` methods added to vectors.
11528       * std: The task-local data interface no longer uses @, and keys are
11529         no longer function pointers.
11530       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
11531       * std: Added `SharedPort` to `comm`.
11532       * std: `Eq` has a default method for `ne`; only `eq` is required
11533         in implementations.
11534       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
11535         is required in implementations.
11536       * std: `is_utf8` performance is improved, impacting many string functions.
11537       * std: `os::MemoryMap` provides cross-platform mmap.
11538       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
11539         are not 'in-bounds' are considered undefined.
11540       * std: Many freestanding functions in `vec` removed in favor of methods.
11541       * std: Many freestanding functions on scalar types removed in favor of
11542         methods.
11543       * std: Many options to task builders were removed since they don't make
11544         sense in the new scheduler design.
11545       * std: More containers implement `FromIterator` so can be created by the
11546         `collect` method.
11547       * std: More complete atomic types in `unstable::atomics`.
11548       * std: `comm::PortSet` removed.
11549       * std: Mutating methods in the `Set` and `Map` traits have been moved into
11550         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
11551         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
11552         default implementations.
11553       * std: Various `from_str` functions were removed in favor of a generic
11554         `from_str` which is available in the prelude.
11555       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
11556       * extra: `dlist`, the doubly-linked list was modernized.
11557       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
11558       * extra: Added `glob` module, replacing `std::os::glob`.
11559       * extra: `rope` was removed.
11560       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
11561       * extra: `net`, and `timer` were removed. The experimental replacements
11562         are `std::rt::io::net` and `std::rt::io::timer`.
11563       * extra: Iterators implemented for `SmallIntMap`.
11564       * extra: Iterators implemented for `Bitv` and `BitvSet`.
11565       * extra: `SmallIntSet` removed. Use `BitvSet`.
11566       * extra: Performance of JSON parsing greatly improved.
11567       * extra: `semver` updated to SemVer 2.0.0.
11568       * extra: `term` handles more terminals correctly.
11569       * extra: `dbg` module removed.
11570       * extra: `par` module removed.
11571       * extra: `future` was cleaned up, with some method renames.
11572       * extra: Most free functions in `getopts` were converted to methods.
11573
11574    * Other
11575       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
11576       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
11577         similarly to gcc's `--march` flag.
11578       * rustc's performance compiling small crates is much better.
11579       * rustpkg has received many improvements.
11580       * rustpkg supports git tags as package IDs.
11581       * rustpkg builds into target-specific directories so it can be used for
11582         cross-compiling.
11583       * The number of concurrent test tasks is controlled by the environment
11584         variable RUST_TEST_TASKS.
11585       * The test harness can now report metrics for benchmarks.
11586       * All tools have man pages.
11587       * Programs compiled with `--test` now support the `-h` and `--help` flags.
11588       * The runtime uses jemalloc for allocations.
11589       * Segmented stacks are temporarily disabled as part of the transition to
11590         the new runtime. Stack overflows are possible!
11591       * A new documentation backend, rustdoc_ng, is available for use. It is
11592         still invoked through the normal `rustdoc` command.
11593
11594
11595 Version 0.7 (2013-07-03)
11596 =======================
11597
11598    * ~2000 changes, numerous bugfixes
11599
11600    * Language
11601       * `impl`s no longer accept a visibility qualifier. Put them on methods
11602         instead.
11603       * The borrow checker has been rewritten with flow-sensitivity, fixing
11604         many bugs and inconveniences.
11605       * The `self` parameter no longer implicitly means `&'self self`,
11606         and can be explicitly marked with a lifetime.
11607       * Overloadable compound operators (`+=`, etc.) have been temporarily
11608         removed due to bugs.
11609       * The `for` loop protocol now requires `for`-iterators to return `bool`
11610         so they compose better.
11611       * The `Durable` trait is replaced with the `'static` bounds.
11612       * Trait default methods work more often.
11613       * Structs with the `#[packed]` attribute have byte alignment and
11614         no padding between fields.
11615       * Type parameters bound by `Copy` must now be copied explicitly with
11616         the `copy` keyword.
11617       * It is now illegal to move out of a dereferenced unsafe pointer.
11618       * `Option<~T>` is now represented as a nullable pointer.
11619       * `@mut` does dynamic borrow checks correctly.
11620       * The `main` function is only detected at the topmost level of the crate.
11621         The `#[main]` attribute is still valid anywhere.
11622       * Struct fields may no longer be mutable. Use inherited mutability.
11623       * The `#[no_send]` attribute makes a type that would otherwise be
11624         `Send`, not.
11625       * The `#[no_freeze]` attribute makes a type that would otherwise be
11626         `Freeze`, not.
11627       * Unbounded recursion will abort the process after reaching the limit
11628         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
11629       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
11630         are never implicitly copyable.
11631       * `#[static_assert]` makes compile-time assertions about static bools.
11632       * At long last, 'argument modes' no longer exist.
11633       * The rarely used `use mod` statement no longer exists.
11634
11635    * Syntax extensions
11636       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
11637         argument list.
11638       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
11639         `Rand`, `Zero` and `ToStr` can all be automatically derived with
11640         `#[deriving(...)]`.
11641       * The `bytes!` macro returns a vector of bytes for string, u8, char,
11642         and unsuffixed integer literals.
11643
11644    * Libraries
11645       * The `core` crate was renamed to `std`.
11646       * The `std` crate was renamed to `extra`.
11647       * More and improved documentation.
11648       * std: `iterator` module for external iterator objects.
11649       * Many old-style (internal, higher-order function) iterators replaced by
11650         implementations of `Iterator`.
11651       * std: Many old internal vector and string iterators,
11652         incl. `any`, `all`. removed.
11653       * std: The `finalize` method of `Drop` renamed to `drop`.
11654       * std: The `drop` method now takes `&mut self` instead of `&self`.
11655       * std: The prelude no longer re-exports any modules, only types and traits.
11656       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
11657         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
11658       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
11659         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
11660       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
11661         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
11662       * std: Many types implement `Clone`.
11663       * std: `path` type renamed to `Path`.
11664       * std: `mut` module and `Mut` type removed.
11665       * std: Many standalone functions removed in favor of methods and iterators
11666         in `vec`, `str`. In the future methods will also work as functions.
11667       * std: `reinterpret_cast` removed. Use `transmute`.
11668       * std: ascii string handling in `std::ascii`.
11669       * std: `Rand` is implemented for ~/@.
11670       * std: `run` module for spawning processes overhauled.
11671       * std: Various atomic types added to `unstable::atomic`.
11672       * std: Various types implement `Zero`.
11673       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
11674       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
11675       * std: Added `os::mkdir_recursive`.
11676       * std: Added `os::glob` function performs filesystems globs.
11677       * std: `FuzzyEq` renamed to `ApproxEq`.
11678       * std: `Map` now defines `pop` and `swap` methods.
11679       * std: `Cell` constructors converted to static methods.
11680       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
11681       * extra: `flate` module moved from `std` to `extra`.
11682       * extra: `fileinput` module for iterating over a series of files.
11683       * extra: `Complex` number type and `complex` module.
11684       * extra: `Rational` number type and `rational` module.
11685       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
11686       * extra: `term` uses terminfo now, is more correct.
11687       * extra: `arc` functions converted to methods.
11688       * extra: Implementation of fixed output size variations of SHA-2.
11689
11690    * Tooling
11691       * `unused_variables` lint mode for unused variables (default: warn).
11692       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
11693         (default: warn).
11694       * `unused_mut` lint mode for identifying unused `mut` qualifiers
11695         (default: warn).
11696       * `dead_assignment` lint mode for unread variables (default: warn).
11697       * `unnecessary_allocation` lint mode detects some heap allocations that are
11698         immediately borrowed so could be written without allocating (default: warn).
11699       * `missing_doc` lint mode (default: allow).
11700       * `unreachable_code` lint mode (default: warn).
11701       * The `rusti` command has been rewritten and a number of bugs addressed.
11702       * rustc outputs in color on more terminals.
11703       * rustc accepts a `--link-args` flag to pass arguments to the linker.
11704       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
11705       * Compiling with `-g` will make the binary record information about
11706         dynamic borrowcheck failures for debugging.
11707       * rustdoc has a nicer stylesheet.
11708       * Various improvements to rustdoc.
11709       * Improvements to rustpkg (see the detailed release notes).
11710
11711
11712 Version 0.6 (2013-04-03)
11713 ========================
11714
11715    * ~2100 changes, numerous bugfixes
11716
11717    * Syntax changes
11718       * The self type parameter in traits is now spelled `Self`
11719       * The `self` parameter in trait and impl methods must now be explicitly
11720         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
11721       * Static methods no longer require the `static` keyword and instead
11722         are distinguished by the lack of a `self` parameter
11723       * Replaced the `Durable` trait with the `'static` lifetime
11724       * The old closure type syntax with the trailing sigil has been
11725         removed in favor of the more consistent leading sigil
11726       * `super` is a keyword, and may be prefixed to paths
11727       * Trait bounds are separated with `+` instead of whitespace
11728       * Traits are implemented with `impl Trait for Type`
11729         instead of `impl Type: Trait`
11730       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
11731       * The `export` keyword has finally been removed
11732       * The `move` keyword has been removed (see "Semantic changes")
11733       * The interior mutability qualifier on vectors, `[mut T]`, has been
11734         removed. Use `&mut [T]`, etc.
11735       * `mut` is no longer valid in `~mut T`. Use inherited mutability
11736       * `fail` is no longer a keyword. Use `fail!()`
11737       * `assert` is no longer a keyword. Use `assert!()`
11738       * `log` is no longer a keyword. use `debug!`, etc.
11739       * 1-tuples may be represented as `(T,)`
11740       * Struct fields may no longer be `mut`. Use inherited mutability,
11741         `@mut T`, `core::mut` or `core::cell`
11742       * `extern mod { ... }` is no longer valid syntax for foreign
11743         function modules. Use extern blocks: `extern { ... }`
11744       * Newtype enums removed. Use tuple-structs.
11745       * Trait implementations no longer support visibility modifiers
11746       * Pattern matching over vectors improved and expanded
11747       * `const` renamed to `static` to correspond to lifetime name,
11748         and make room for future `static mut` unsafe mutable globals.
11749       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
11750       * `Clone` implementations can be automatically generated with
11751         `#[deriving(Clone)]`
11752       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
11753         instead of `foo as Bar`.
11754       * Fixed length vector types are now written as `[int, .. 3]`
11755         instead of `[int * 3]`.
11756       * Fixed length vector types can express the length as a constant
11757         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
11758
11759    * Semantic changes
11760       * Types with owned pointers or custom destructors move by default,
11761         eliminating the `move` keyword
11762       * All foreign functions are considered unsafe
11763       * &mut is now unaliasable
11764       * Writes to borrowed @mut pointers are prevented dynamically
11765       * () has size 0
11766       * The name of the main function can be customized using #[main]
11767       * The default type of an inferred closure is &fn instead of @fn
11768       * `use` statements may no longer be "chained" - they cannot import
11769         identifiers imported by previous `use` statements
11770       * `use` statements are crate relative, importing from the "top"
11771         of the crate by default. Paths may be prefixed with `super::`
11772         or `self::` to change the search behavior.
11773       * Method visibility is inherited from the implementation declaration
11774       * Structural records have been removed
11775       * Many more types can be used in static items, including enums
11776         'static-lifetime pointers and vectors
11777       * Pattern matching over vectors improved and expanded
11778       * Typechecking of closure types has been overhauled to
11779         improve inference and eliminate unsoundness
11780       * Macros leave scope at the end of modules, unless that module is
11781         tagged with #[macro_escape]
11782
11783    * Libraries
11784       * Added big integers to `std::bigint`
11785       * Removed `core::oldcomm` module
11786       * Added pipe-based `core::comm` module
11787       * Numeric traits have been reorganized under `core::num`
11788       * `vec::slice` finally returns a slice
11789       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
11790       * Containers reorganized around traits in `core::container`
11791       * `core::dvec` removed, `~[T]` is a drop-in replacement
11792       * `core::send_map` renamed to `core::hashmap`
11793       * `std::map` removed; replaced with `core::hashmap`
11794       * `std::treemap` reimplemented as an owned balanced tree
11795       * `std::deque` and `std::smallintmap` reimplemented as owned containers
11796       * `core::trie` added as a fast ordered map for integer keys
11797       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
11798       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
11799         overload the comparison operators, whereas `TotalOrd` is used
11800         by certain container types
11801
11802    * Other
11803       * Replaced the 'cargo' package manager with 'rustpkg'
11804       * Added all-purpose 'rust' tool
11805       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
11806       * rustc now *attempts* to offer spelling suggestions
11807       * Improved support for ARM and Android
11808       * Preliminary MIPS backend
11809       * Improved foreign function ABI implementation for x86, x86_64
11810       * Various memory usage improvements
11811       * Rust code may be embedded in foreign code under limited circumstances
11812       * Inline assembler supported by new asm!() syntax extension.
11813
11814
11815 Version 0.5 (2012-12-21)
11816 ===========================
11817
11818    * ~900 changes, numerous bugfixes
11819
11820    * Syntax changes
11821       * Removed `<-` move operator
11822       * Completed the transition from the `#fmt` extension syntax to `fmt!`
11823       * Removed old fixed length vector syntax - `[T]/N`
11824       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
11825       * Macros may now expand to items and statements
11826       * `a.b()` is always parsed as a method call, never as a field projection
11827       * `Eq` and `IterBytes` implementations can be automatically generated
11828         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
11829       * Removed the special crate language for `.rc` files
11830       * Function arguments may consist of any irrefutable pattern
11831
11832    * Semantic changes
11833       * `&` and `~` pointers may point to objects
11834       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
11835       * Enum variants may be structs
11836       * Destructors can be added to all nominal types with the Drop trait
11837       * Structs and nullary enum variants may be constants
11838       * Values that cannot be implicitly copied are now automatically moved
11839         without writing `move` explicitly
11840       * `&T` may now be coerced to `*T`
11841       * Coercions happen in `let` statements as well as function calls
11842       * `use` statements now take crate-relative paths
11843       * The module and type namespaces have been merged so that static
11844         method names can be resolved under the trait in which they are
11845         declared
11846
11847    * Improved support for language features
11848       * Trait inheritance works in many scenarios
11849       * More support for explicit self arguments in methods - `self`, `&self`
11850         `@self`, and `~self` all generally work as expected
11851       * Static methods work in more situations
11852       * Experimental: Traits may declare default methods for the implementations
11853         to use
11854
11855    * Libraries
11856       * New condition handling system in `core::condition`
11857       * Timsort added to `std::sort`
11858       * New priority queue, `std::priority_queue`
11859       * Pipes for serializable types, `std::flatpipes'
11860       * Serialization overhauled to be trait-based
11861       * Expanded `getopts` definitions
11862       * Moved futures to `std`
11863       * More functions are pure now
11864       * `core::comm` renamed to `oldcomm`. Still deprecated
11865       * `rustdoc` and `cargo` are libraries now
11866
11867    * Misc
11868       * Added a preliminary REPL, `rusti`
11869       * License changed from MIT to dual MIT/APL2
11870
11871
11872 Version 0.4 (2012-10-15)
11873 ==========================
11874
11875    * ~2000 changes, numerous bugfixes
11876
11877    * Syntax
11878       * All keywords are now strict and may not be used as identifiers anywhere
11879       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
11880         'of', 'with', 'to', 'class'.
11881       * Classes are replaced with simpler structs
11882       * Explicit method self types
11883       * `ret` became `return` and `alt` became `match`
11884       * `import` is now `use`; `use is now `extern mod`
11885       * `extern mod { ... }` is now `extern { ... }`
11886       * `use mod` is the recommended way to import modules
11887       * `pub` and `priv` replace deprecated export lists
11888       * The syntax of `match` pattern arms now uses fat arrow (=>)
11889       * `main` no longer accepts an args vector; use `os::args` instead
11890
11891    * Semantics
11892       * Trait implementations are now coherent, ala Haskell typeclasses
11893       * Trait methods may be static
11894       * Argument modes are deprecated
11895       * Borrowed pointers are much more mature and recommended for use
11896       * Strings and vectors in the static region are stored in constant memory
11897       * Typestate was removed
11898       * Resolution rewritten to be more reliable
11899       * Support for 'dual-mode' data structures (freezing and thawing)
11900
11901    * Libraries
11902       * Most binary operators can now be overloaded via the traits in
11903         `core::ops'
11904       * `std::net::url` for representing URLs
11905       * Sendable hash maps in `core::send_map`
11906       * `core::task' gained a (currently unsafe) task-local storage API
11907
11908    * Concurrency
11909       * An efficient new intertask communication primitive called the pipe,
11910         along with a number of higher-level channel types, in `core::pipes`
11911       * `std::arc`, an atomically reference counted, immutable, shared memory
11912         type
11913       * `std::sync`, various exotic synchronization tools based on arcs and pipes
11914       * Futures are now based on pipes and sendable
11915       * More robust linked task failure
11916       * Improved task builder API
11917
11918    * Other
11919       * Improved error reporting
11920       * Preliminary JIT support
11921       * Preliminary work on precise GC
11922       * Extensive architectural improvements to rustc
11923       * Begun a transition away from buggy C++-based reflection (shape) code to
11924         Rust-based (visitor) code
11925       * All hash functions and tables converted to secure, randomized SipHash
11926
11927
11928 Version 0.3  (2012-07-12)
11929 ========================
11930
11931    * ~1900 changes, numerous bugfixes
11932
11933    * New coding conveniences
11934       * Integer-literal suffix inference
11935       * Per-item control over warnings, errors
11936       * #[cfg(windows)] and #[cfg(unix)] attributes
11937       * Documentation comments
11938       * More compact closure syntax
11939       * 'do' expressions for treating higher-order functions as
11940         control structures
11941       * *-patterns (wildcard extended to all constructor fields)
11942
11943    * Semantic cleanup
11944       * Name resolution pass and exhaustiveness checker rewritten
11945       * Region pointers and borrow checking supersede alias
11946         analysis
11947       * Init-ness checking is now provided by a region-based liveness
11948         pass instead of the typestate pass; same for last-use analysis
11949       * Extensive work on region pointers
11950
11951    * Experimental new language features
11952       * Slices and fixed-size, interior-allocated vectors
11953       * #!-comments for lang versioning, shell execution
11954       * Destructors and iface implementation for classes;
11955         type-parameterized classes and class methods
11956       * 'const' type kind for types that can be used to implement
11957         shared-memory concurrency patterns
11958
11959    * Type reflection
11960
11961    * Removal of various obsolete features
11962       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
11963                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
11964
11965       * Constructs: do-while loops ('do' repurposed), fn binding,
11966                     resources (replaced by destructors)
11967
11968    * Compiler reorganization
11969       * Syntax-layer of compiler split into separate crate
11970       * Clang (from LLVM project) integrated into build
11971       * Typechecker split into sub-modules
11972
11973    * New library code
11974       * New time functions
11975       * Extension methods for many built-in types
11976       * Arc: atomic-refcount read-only / exclusive-use shared cells
11977       * Par: parallel map and search routines
11978       * Extensive work on libuv interface
11979       * Much vector code moved to libraries
11980       * Syntax extensions: #line, #col, #file, #mod, #stringify,
11981         #include, #include_str, #include_bin
11982
11983    * Tool improvements
11984       * Cargo automatically resolves dependencies
11985
11986
11987 Version 0.2  (2012-03-29)
11988 =========================
11989
11990    * >1500 changes, numerous bugfixes
11991
11992    * New docs and doc tooling
11993
11994    * New port: FreeBSD x86_64
11995
11996    * Compilation model enhancements
11997       * Generics now specialized, multiply instantiated
11998       * Functions now inlined across separate crates
11999
12000    * Scheduling, stack and threading fixes
12001       * Noticeably improved message-passing performance
12002       * Explicit schedulers
12003       * Callbacks from C
12004       * Helgrind clean
12005
12006    * Experimental new language features
12007       * Operator overloading
12008       * Region pointers
12009       * Classes
12010
12011    * Various language extensions
12012       * C-callback function types: 'crust fn ...'
12013       * Infinite-loop construct: 'loop { ... }'
12014       * Shorten 'mutable' to 'mut'
12015       * Required mutable-local qualifier: 'let mut ...'
12016       * Basic glob-exporting: 'export foo::*;'
12017       * Alt now exhaustive, 'alt check' for runtime-checked
12018       * Block-function form of 'for' loop, with 'break' and 'ret'.
12019
12020    * New library code
12021       * AST quasi-quote syntax extension
12022       * Revived libuv interface
12023       * New modules: core::{future, iter}, std::arena
12024       * Merged per-platform std::{os*, fs*} to core::{libc, os}
12025       * Extensive cleanup, regularization in libstd, libcore
12026
12027
12028 Version 0.1  (2012-01-20)
12029 ===============================
12030
12031    * Most language features work, including:
12032       * Unique pointers, unique closures, move semantics
12033       * Interface-constrained generics
12034       * Static interface dispatch
12035       * Stack growth
12036       * Multithread task scheduling
12037       * Typestate predicates
12038       * Failure unwinding, destructors
12039       * Pattern matching and destructuring assignment
12040       * Lightweight block-lambda syntax
12041       * Preliminary macro-by-example
12042
12043    * Compiler works with the following configurations:
12044       * Linux: x86 and x86_64 hosts and targets
12045       * macOS: x86 and x86_64 hosts and targets
12046       * Windows: x86 hosts and targets
12047
12048    * Cross compilation / multi-target configuration supported.
12049
12050    * Preliminary API-documentation and package-management tools included.
12051
12052 Known issues:
12053
12054    * Documentation is incomplete.
12055
12056    * Performance is below intended target.
12057
12058    * Standard library APIs are subject to extensive change, reorganization.
12059
12060    * Language-level versioning is not yet operational - future code will
12061      break unexpectedly.