RELEASES.md

   1 Version 1.39.0 (2019-11-07)
   2 ===========================
   3
   4 Language
   5 --------
   6 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
   7   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
   8 - [You can now use certain attributes on function, closure, and function pointer
   9   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
  10   `deny`, `forbid` as well as inert helper attributes used by procedural macro
  11   attributes applied to items. e.g.
  12   ```rust
  13   fn len(
  14       #[cfg(windows)] slice: &[u16],
  15       #[cfg(not(windows))] slice: &[u8],
  16   ) -> usize {
  17       slice.len()
  18   }
  19   ```
  20 - [You can now take shared references to bind-by-move patterns in the `if` guards
  21   of `match` arms.][63118] e.g.
  22   ```rust
  23   fn main() {
  24       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
  25
  26       match array {
  27           nums
  28   //      ---- `nums` is bound by move.
  29               if nums.iter().sum::<u8>() == 10
  30   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
  31           => {
  32               drop(nums);
  33   //          ----------- Legal as `nums` was bound by move and so we have ownership.
  34           }
  35           _ => unreachable!(),
  36       }
  37   }
  38   ```
  39
  40
  41
  42 Compiler
  43 --------
  44 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
  45 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
  46 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
  47   **Note** Cargo currently doesn't use this feature. Refer to
  48   [cargo#7315][cargo/7315] to track this feature's progress.
  49 - [You can now pass `--show-output` argument to test binaries to print the
  50   output of successful tests.][62600]
  51
  52
  53 \* Refer to Rust's [platform support page][forge-platform-support] for more
  54 information on Rust's tiered platform support.
  55
  56 Libraries
  57 ---------
  58 - [`Vec::new` and `String::new` are now `const` functions.][64028]
  59 - [`LinkedList::new` is now a `const` function.][63684]
  60 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
  61 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
  62   now `const`.][63786]
  63
  64 Stabilized APIs
  65 ---------------
  66 - [`Pin::into_inner`]
  67 - [`Instant::checked_duration_since`]
  68 - [`Instant::saturating_duration_since`]
  69
  70 Cargo
  71 -----
  72 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
  73 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
  74   `--all` is now deprecated.
  75
  76 Misc
  77 ----
  78 - [You can now pass `-Clinker` to rustdoc to control the linker used
  79   for compiling doctests.][63834]
  80
  81 Compatibility Notes
  82 -------------------
  83 - [Code that was previously accepted by the old borrow checker, but rejected by
  84   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
  85   previously a warning, and will also become a hard error in the Rust 2015
  86   edition in the 1.40.0 release.
  87 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
  88   run tests.][63827] This should improve performance when running a large
  89   amount of doctests.
  90 - [The `try!` macro will now issue a deprecation warning.][62672] It is
  91   recommended to use the `?` operator instead.
  92 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
  93   returned `0.0`.
  94
  95 [62600]: https://github.com/rust-lang/rust/pull/62600/
  96 [62672]: https://github.com/rust-lang/rust/pull/62672/
  97 [63118]: https://github.com/rust-lang/rust/pull/63118/
  98 [63209]: https://github.com/rust-lang/rust/pull/63209/
  99 [63402]: https://github.com/rust-lang/rust/pull/63402/
 100 [63565]: https://github.com/rust-lang/rust/pull/63565/
 101 [63595]: https://github.com/rust-lang/rust/pull/63595/
 102 [63684]: https://github.com/rust-lang/rust/pull/63684/
 103 [63698]: https://github.com/rust-lang/rust/pull/63698/
 104 [63770]: https://github.com/rust-lang/rust/pull/63770/
 105 [63786]: https://github.com/rust-lang/rust/pull/63786/
 106 [63827]: https://github.com/rust-lang/rust/pull/63827/
 107 [63834]: https://github.com/rust-lang/rust/pull/63834/
 108 [63927]: https://github.com/rust-lang/rust/pull/63927/
 109 [63933]: https://github.com/rust-lang/rust/pull/63933/
 110 [63934]: https://github.com/rust-lang/rust/pull/63934/
 111 [63938]: https://github.com/rust-lang/rust/pull/63938/
 112 [63940]: https://github.com/rust-lang/rust/pull/63940/
 113 [63941]: https://github.com/rust-lang/rust/pull/63941/
 114 [63945]: https://github.com/rust-lang/rust/pull/63945/
 115 [64010]: https://github.com/rust-lang/rust/pull/64010/
 116 [64028]: https://github.com/rust-lang/rust/pull/64028/
 117 [64334]: https://github.com/rust-lang/rust/pull/64334/
 118 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
 119 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
 120 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
 121 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
 122 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
 123 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
 124
 125 Version 1.38.0 (2019-09-26)
 126 ==========================
 127
 128 Language
 129 --------
 130 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
 131 - [The `#[deprecated]` attribute can now be used on macros.][62042]
 132
 133 Compiler
 134 --------
 135 - [Added pipelined compilation support to `rustc`.][62766] This will
 136   improve compilation times in some cases. For further information please refer
 137   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
 138 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
 139   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
 140   `x86_64-uwp-windows-msvc` targets.][60260]
 141 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
 142   `armv7-unknown-linux-musleabi` targets.][63107]
 143 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
 144 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
 145
 146 \* Refer to Rust's [platform support page][forge-platform-support] for more
 147 information on Rust's tiered platform support.
 148
 149 Libraries
 150 ---------
 151 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
 152 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
 153   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
 154   is available at `std::clone::Clone`). This also makes all built-in macros
 155   available in `std`/`core` root. e.g. `std::include_bytes!`.
 156 - [`str::Chars` now implements `Debug`.][63000]
 157 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
 158 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
 159 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
 160 - [Added euclidean remainder and division operations (`div_euclid`,
 161   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
 162   `overflowing`, and `wrapping` versions are available for all
 163   integer primitives.
 164 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
 165   `PartialEq`.][61491]
 166 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
 167
 168 Stabilized APIs
 169 ---------------
 170 - [`<*const T>::cast`]
 171 - [`<*mut T>::cast`]
 172 - [`Duration::as_secs_f32`]
 173 - [`Duration::as_secs_f64`]
 174 - [`Duration::div_f32`]
 175 - [`Duration::div_f64`]
 176 - [`Duration::from_secs_f32`]
 177 - [`Duration::from_secs_f64`]
 178 - [`Duration::mul_f32`]
 179 - [`Duration::mul_f64`]
 180 - [`any::type_name`]
 181
 182 Cargo
 183 -----
 184 - [Added pipelined compilation support to `cargo`.][cargo/7143]
 185 - [You can now pass the `--features` option multiple times to enable
 186   multiple features.][cargo/7084]
 187
 188 Misc
 189 ----
 190 - [`rustc` will now warn about some incorrect uses of
 191   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
 192
 193 Compatibility Notes
 194 -------------------
 195 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
 196   1.38.0.
 197 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
 198   issues][62896] with certain crates such as libc.
 199
 200 [60260]: https://github.com/rust-lang/rust/pull/60260/
 201 [61457]: https://github.com/rust-lang/rust/pull/61457/
 202 [61491]: https://github.com/rust-lang/rust/pull/61491/
 203 [61884]: https://github.com/rust-lang/rust/pull/61884/
 204 [61953]: https://github.com/rust-lang/rust/pull/61953/
 205 [62042]: https://github.com/rust-lang/rust/pull/62042/
 206 [62528]: https://github.com/rust-lang/rust/pull/62528/
 207 [62583]: https://github.com/rust-lang/rust/pull/62583/
 208 [62735]: https://github.com/rust-lang/rust/pull/62735/
 209 [62766]: https://github.com/rust-lang/rust/pull/62766/
 210 [62784]: https://github.com/rust-lang/rust/pull/62784/
 211 [62785]: https://github.com/rust-lang/rust/issues/62785/
 212 [62814]: https://github.com/rust-lang/rust/pull/62814/
 213 [62896]: https://github.com/rust-lang/rust/issues/62896/
 214 [63000]: https://github.com/rust-lang/rust/pull/63000/
 215 [63056]: https://github.com/rust-lang/rust/pull/63056/
 216 [63107]: https://github.com/rust-lang/rust/pull/63107/
 217 [63346]: https://github.com/rust-lang/rust/pull/63346/
 218 [63421]: https://github.com/rust-lang/rust/pull/63421/
 219 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
 220 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
 221 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
 222 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
 223 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
 224 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
 225 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
 226 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
 227 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
 228 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
 229 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
 230 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
 231 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
 232 [forge-platform-support]: https://forge.rust-lang.org/platform-support.html
 233 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
 234
 235 Version 1.37.0 (2019-08-15)
 236 ==========================
 237
 238 Language
 239 --------
 240 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
 241   [`Box`][62228], or an [array][62235] and unused.
 242 - [You can now use the `cfg` and `cfg_attr` attributes on
 243   generic parameters.][61547]
 244 - [You can now use enum variants through type alias.][61682] e.g. You can
 245   write the following:
 246   ```rust
 247   type MyOption = Option<u8>;
 248
 249   fn increment_or_zero(x: MyOption) -> u8 {
 250       match x {
 251           MyOption::Some(y) => y + 1,
 252           MyOption::None => 0,
 253       }
 254   }
 255   ```
 256 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
 257   `const _: u32 = 5;`.
 258 - [You can now use `#[repr(align(X)]` on enums.][61229]
 259 - [The  `?` Kleene macro operator is now available in the
 260   2015 edition.][60932]
 261
 262 Compiler
 263 --------
 264 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
 265   and `-C profile-use` flags.][61268] For more information on how to use profile
 266   guided optimization, please refer to the [rustc book][rustc-book-pgo].
 267 - [The `rust-lldb` wrapper script should now work again.][61827]
 268
 269 Libraries
 270 ---------
 271 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
 272
 273 Stabilized APIs
 274 ---------------
 275 - [`BufReader::buffer`]
 276 - [`BufWriter::buffer`]
 277 - [`Cell::from_mut`]
 278 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
 279 - [`DoubleEndedIterator::nth_back`]
 280 - [`Option::xor`]
 281 - [`Wrapping::reverse_bits`]
 282 - [`i128::reverse_bits`]
 283 - [`i16::reverse_bits`]
 284 - [`i32::reverse_bits`]
 285 - [`i64::reverse_bits`]
 286 - [`i8::reverse_bits`]
 287 - [`isize::reverse_bits`]
 288 - [`slice::copy_within`]
 289 - [`u128::reverse_bits`]
 290 - [`u16::reverse_bits`]
 291 - [`u32::reverse_bits`]
 292 - [`u64::reverse_bits`]
 293 - [`u8::reverse_bits`]
 294 - [`usize::reverse_bits`]
 295
 296 Cargo
 297 -----
 298 - [`Cargo.lock` files are now included by default when publishing executable crates
 299   with executables.][cargo/7026]
 300 - [You can now specify `default-run="foo"` in `[package]` to specify the
 301   default executable to use for `cargo run`.][cargo/7056]
 302
 303 Misc
 304 ----
 305
 306 Compatibility Notes
 307 -------------------
 308 - [Using `...` for inclusive range patterns will now warn by default.][61342]
 309   Please transition your code to using the `..=` syntax for inclusive
 310   ranges instead.
 311 - [Using a trait object without the `dyn` will now warn by default.][61203]
 312   Please transition your code to use `dyn Trait` for trait objects instead.
 313
 314 [62228]: https://github.com/rust-lang/rust/pull/62228/
 315 [62235]: https://github.com/rust-lang/rust/pull/62235/
 316 [61802]: https://github.com/rust-lang/rust/pull/61802/
 317 [61827]: https://github.com/rust-lang/rust/pull/61827/
 318 [61547]: https://github.com/rust-lang/rust/pull/61547/
 319 [61682]: https://github.com/rust-lang/rust/pull/61682/
 320 [61268]: https://github.com/rust-lang/rust/pull/61268/
 321 [61342]: https://github.com/rust-lang/rust/pull/61342/
 322 [61347]: https://github.com/rust-lang/rust/pull/61347/
 323 [61100]: https://github.com/rust-lang/rust/pull/61100/
 324 [61203]: https://github.com/rust-lang/rust/pull/61203/
 325 [61229]: https://github.com/rust-lang/rust/pull/61229/
 326 [60932]: https://github.com/rust-lang/rust/pull/60932/
 327 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
 328 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
 329 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
 330 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
 331 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
 332 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
 333 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
 334 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
 335 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
 336 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
 337 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
 338 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
 339 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
 340 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
 341 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
 342 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
 343 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
 344 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
 345 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
 346 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
 347 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
 348 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
 349 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
 350 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
 351
 352
 353 Version 1.36.0 (2019-07-04)
 354 ==========================
 355
 356 Language
 357 --------
 358 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
 359 - [The order of traits in trait objects no longer affects the semantics of that
 360   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
 361   `dyn fmt::Debug + Send`, where this was previously not the case.
 362
 363 Libraries
 364 ---------
 365 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
 366 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
 367 - [`mem::needs_drop` is now available as a const fn.][60364]
 368 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
 369 - [`String` now implements `BorrowMut<str>`.][60404]
 370 - [`io::Cursor` now implements `Default`.][60234]
 371 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
 372 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
 373   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
 374   environment has access to heap memory allocation.
 375 - [`String` now implements `From<&String>`.][59825]
 376 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
 377   return a tuple of each argument when there is multiple arguments.
 378 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
 379   not used.][59648]
 380
 381 Stabilized APIs
 382 ---------------
 383 - [`VecDeque::rotate_left`]
 384 - [`VecDeque::rotate_right`]
 385 - [`Iterator::copied`]
 386 - [`io::IoSlice`]
 387 - [`io::IoSliceMut`]
 388 - [`Read::read_vectored`]
 389 - [`Write::write_vectored`]
 390 - [`str::as_mut_ptr`]
 391 - [`mem::MaybeUninit`]
 392 - [`pointer::align_offset`]
 393 - [`future::Future`]
 394 - [`task::Context`]
 395 - [`task::RawWaker`]
 396 - [`task::RawWakerVTable`]
 397 - [`task::Waker`]
 398 - [`task::Poll`]
 399
 400 Cargo
 401 -----
 402 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
 403 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
 404
 405 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
 406
 407 Clippy
 408 ------
 409 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
 410
 411 Misc
 412 ----
 413
 414 Compatibility Notes
 415 -------------------
 416 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
 417   longer recommended, and will be deprecated in 1.39.0.
 418
 419 [60318]: https://github.com/rust-lang/rust/pull/60318/
 420 [60364]: https://github.com/rust-lang/rust/pull/60364/
 421 [60370]: https://github.com/rust-lang/rust/pull/60370/
 422 [60404]: https://github.com/rust-lang/rust/pull/60404/
 423 [60234]: https://github.com/rust-lang/rust/pull/60234/
 424 [60244]: https://github.com/rust-lang/rust/pull/60244/
 425 [58623]: https://github.com/rust-lang/rust/pull/58623/
 426 [59648]: https://github.com/rust-lang/rust/pull/59648/
 427 [59675]: https://github.com/rust-lang/rust/pull/59675/
 428 [59825]: https://github.com/rust-lang/rust/pull/59825/
 429 [59826]: https://github.com/rust-lang/rust/pull/59826/
 430 [59445]: https://github.com/rust-lang/rust/pull/59445/
 431 [59114]: https://github.com/rust-lang/rust/pull/59114/
 432 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
 433 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
 434 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
 435 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
 436 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
 437 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
 438 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
 439 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
 440 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
 441 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
 442 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
 443 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
 444 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
 445 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
 446 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
 447 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
 448 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
 449 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
 450 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
 451 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
 452
 453
 454 Version 1.35.0 (2019-05-23)
 455 ==========================
 456
 457 Language
 458 --------
 459 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
 460   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
 461 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
 462   ```rust
 463   unsafe fn call_unsafe(func: unsafe fn()) {
 464       func()
 465   }
 466
 467   pub fn main() {
 468       unsafe { call_unsafe(|| {}); }
 469   }
 470   ```
 471
 472
 473 Compiler
 474 --------
 475 - [Added the `armv6-unknown-freebsd-gnueabihf` and
 476   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
 477 - [Added the `wasm32-unknown-wasi` target.][59464]
 478
 479
 480 Libraries
 481 ---------
 482 - [`Thread` will now show its ID in `Debug` output.][59460]
 483 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
 484 - [`alloc::System` now implements `Default`.][59451]
 485 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
 486   last field.][59076]
 487 - [`char::{ToLowercase, ToUppercase}` now
 488   implement `ExactSizeIterator`.][58778]
 489 - [All `NonZero` numeric types now implement `FromStr`.][58717]
 490 - [Removed the `Read` trait bounds
 491   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
 492 - [You can now call the `dbg!` macro without any parameters to print the file
 493   and line where it is called.][57847]
 494 - [In place ASCII case conversions are now up to 4× faster.][59283]
 495   e.g. `str::make_ascii_lowercase`
 496 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
 497   and `Send`.][58369]
 498
 499 Stabilized APIs
 500 ---------------
 501 - [`f32::copysign`]
 502 - [`f64::copysign`]
 503 - [`RefCell::replace_with`]
 504 - [`RefCell::map_split`]
 505 - [`ptr::hash`]
 506 - [`Range::contains`]
 507 - [`RangeFrom::contains`]
 508 - [`RangeTo::contains`]
 509 - [`RangeInclusive::contains`]
 510 - [`RangeToInclusive::contains`]
 511 - [`Option::copied`]
 512
 513 Cargo
 514 -----
 515 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
 516   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
 517   platform specific.
 518
 519 Misc
 520 ----
 521 - [The Rust toolchain is now available natively for musl based distros.][58575]
 522
 523 [59460]: https://github.com/rust-lang/rust/pull/59460/
 524 [59464]: https://github.com/rust-lang/rust/pull/59464/
 525 [59500]: https://github.com/rust-lang/rust/pull/59500/
 526 [59512]: https://github.com/rust-lang/rust/pull/59512/
 527 [59580]: https://github.com/rust-lang/rust/pull/59580/
 528 [59283]: https://github.com/rust-lang/rust/pull/59283/
 529 [59451]: https://github.com/rust-lang/rust/pull/59451/
 530 [59076]: https://github.com/rust-lang/rust/pull/59076/
 531 [58778]: https://github.com/rust-lang/rust/pull/58778/
 532 [58717]: https://github.com/rust-lang/rust/pull/58717/
 533 [58369]: https://github.com/rust-lang/rust/pull/58369/
 534 [58423]: https://github.com/rust-lang/rust/pull/58423/
 535 [58080]: https://github.com/rust-lang/rust/pull/58080/
 536 [57847]: https://github.com/rust-lang/rust/pull/57847/
 537 [58575]: https://github.com/rust-lang/rust/pull/58575
 538 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
 539 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
 540 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
 541 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
 542 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
 543 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
 544 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
 545 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
 546 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
 547 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
 548 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
 549 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
 550
 551 Version 1.34.2 (2019-05-14)
 552 ===========================
 553
 554 * [Destabilize the `Error::type_id` function due to a security
 555    vulnerability][60785] ([CVE-2019-12083])
 556
 557 [60785]: https://github.com/rust-lang/rust/pull/60785
 558 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
 559
 560 Version 1.34.1 (2019-04-25)
 561 ===========================
 562
 563 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
 564 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
 565 * [Fix Clippy panic when checking some macros][clippy/3805]
 566
 567 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
 568 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
 569 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
 570
 571 Version 1.34.0 (2019-04-11)
 572 ==========================
 573
 574 Language
 575 --------
 576 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
 577   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
 578   but had no effect.
 579 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
 580   `#[attr{}]` procedural macros.][57367]
 581 - [You can now write `extern crate self as foo;`][57407] to import your
 582   crate's root into the extern prelude.
 583
 584
 585 Compiler
 586 --------
 587 - [You can now target `riscv64imac-unknown-none-elf` and
 588   `riscv64gc-unknown-none-elf`.][58406]
 589 - [You can now enable linker plugin LTO optimisations with
 590   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
 591   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
 592   boundaries.
 593 - [You can now target `powerpc64-unknown-freebsd`.][57809]
 594
 595
 596 Libraries
 597 ---------
 598 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
 599   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
 600   the `Hash` trait to create an iterator.
 601 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
 602   methods.][58421] Most notably you no longer require the `Ord` trait to create
 603   an iterator.
 604 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
 605   for all numeric types.][58044]
 606 - [Indexing a `str` is now generic over all types that
 607   implement `SliceIndex<str>`.][57604]
 608 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
 609   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
 610   produce a warning if their returning type is unused.
 611 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
 612   `overflowing_pow` are now available for all numeric types.][57873] These are
 613   equivalent to methods such as `wrapping_add` for the `pow` operation.
 614
 615
 616 Stabilized APIs
 617 ---------------
 618
 619 #### std & core
 620 * [`Any::type_id`]
 621 * [`Error::type_id`]
 622 * [`atomic::AtomicI16`]
 623 * [`atomic::AtomicI32`]
 624 * [`atomic::AtomicI64`]
 625 * [`atomic::AtomicI8`]
 626 * [`atomic::AtomicU16`]
 627 * [`atomic::AtomicU32`]
 628 * [`atomic::AtomicU64`]
 629 * [`atomic::AtomicU8`]
 630 * [`convert::Infallible`]
 631 * [`convert::TryFrom`]
 632 * [`convert::TryInto`]
 633 * [`iter::from_fn`]
 634 * [`iter::successors`]
 635 * [`num::NonZeroI128`]
 636 * [`num::NonZeroI16`]
 637 * [`num::NonZeroI32`]
 638 * [`num::NonZeroI64`]
 639 * [`num::NonZeroI8`]
 640 * [`num::NonZeroIsize`]
 641 * [`slice::sort_by_cached_key`]
 642 * [`str::escape_debug`]
 643 * [`str::escape_default`]
 644 * [`str::escape_unicode`]
 645 * [`str::split_ascii_whitespace`]
 646
 647 #### std
 648 * [`Instant::checked_add`]
 649 * [`Instant::checked_sub`]
 650 * [`SystemTime::checked_add`]
 651 * [`SystemTime::checked_sub`]
 652
 653 Cargo
 654 -----
 655 - [You can now use alternative registries to crates.io.][cargo/6654]
 656
 657 Misc
 658 ----
 659 - [You can now use the `?` operator in your documentation tests without manually
 660   adding `fn main() -> Result<(), _> {}`.][56470]
 661
 662 Compatibility Notes
 663 -------------------
 664 - [`Command::before_exec` is being replaced by the unsafe method
 665   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
 666 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
 667   can now use `const` functions in `static` variables.
 668
 669 [58370]: https://github.com/rust-lang/rust/pull/58370/
 670 [58406]: https://github.com/rust-lang/rust/pull/58406/
 671 [58421]: https://github.com/rust-lang/rust/pull/58421/
 672 [58166]: https://github.com/rust-lang/rust/pull/58166/
 673 [58044]: https://github.com/rust-lang/rust/pull/58044/
 674 [58057]: https://github.com/rust-lang/rust/pull/58057/
 675 [58059]: https://github.com/rust-lang/rust/pull/58059/
 676 [57809]: https://github.com/rust-lang/rust/pull/57809/
 677 [57873]: https://github.com/rust-lang/rust/pull/57873/
 678 [57604]: https://github.com/rust-lang/rust/pull/57604/
 679 [57367]: https://github.com/rust-lang/rust/pull/57367/
 680 [57407]: https://github.com/rust-lang/rust/pull/57407/
 681 [57425]: https://github.com/rust-lang/rust/pull/57425/
 682 [57106]: https://github.com/rust-lang/rust/pull/57106/
 683 [56470]: https://github.com/rust-lang/rust/pull/56470/
 684 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
 685 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
 686 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
 687 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
 688 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
 689 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
 690 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
 691 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
 692 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
 693 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
 694 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
 695 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
 696 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
 697 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
 698 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
 699 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
 700 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
 701 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
 702 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
 703 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
 704 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
 705 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
 706 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
 707 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
 708 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
 709 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
 710 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
 711 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
 712 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
 713 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
 714 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
 715
 716
 717 Version 1.33.0 (2019-02-28)
 718 ==========================
 719
 720 Language
 721 --------
 722 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
 723   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
 724 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
 725   E.g. You can have match statement on a `u8` that covers `0..=255` and
 726   you would no longer be required to have a `_ => unreachable!()` case.
 727 - [You can now have multiple patterns in `if let` and `while let`
 728   expressions.][57532] You can do this with the same syntax as a `match`
 729   expression. E.g.
 730   ```rust
 731   enum Creature {
 732       Crab(String),
 733       Lobster(String),
 734       Person(String),
 735   }
 736
 737   fn main() {
 738       let state = Creature::Crab("Ferris");
 739
 740       if let Creature::Crab(name) | Creature::Person(name) = state {
 741           println!("This creature's name is: {}", name);
 742       }
 743   }
 744   ```
 745 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
 746   this feature will by default produce a warning as this behaviour can be
 747   unintuitive. E.g. `if let _ = 5 {}`
 748 - [You can now use `let` bindings, assignments, expression statements,
 749   and irrefutable pattern destructuring in const functions.][57175]
 750 - [You can now call unsafe const functions.][57067] E.g.
 751   ```rust
 752   const unsafe fn foo() -> i32 { 5 }
 753   const fn bar() -> i32 {
 754       unsafe { foo() }
 755   }
 756   ```
 757 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
 758   E.g. `#[cfg_attr(all(), must_use, optimize)]`
 759 - [You can now specify a specific alignment with the `#[repr(packed)]`
 760   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
 761   with an alignment of 2 bytes and a size of 6 bytes.
 762 - [You can now import an item from a module as an `_`.][56303] This allows you to
 763   import a trait's impls, and not have the name in the namespace. E.g.
 764   ```rust
 765   use std::io::Read as _;
 766
 767   // Allowed as there is only one `Read` in the module.
 768   pub trait Read {}
 769   ```
 770 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
 771
 772 Compiler
 773 --------
 774 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
 775   command line argument.][56351]
 776 - [The minimum required LLVM version has been bumped to 6.0.][56642]
 777 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
 778 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
 779   tier 2 support.][57130] Visit the [platform support][platform-support] page for
 780   information on Rust's platform support.
 781 - [Added support for the `thumbv7neon-linux-androideabi` and
 782   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
 783 - [Added support for the `x86_64-unknown-uefi` target.][56769]
 784
 785 Libraries
 786 ---------
 787 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
 788   functions for all numeric types.][57566]
 789 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
 790   are now `const` functions for all numeric types.][57105]
 791 - [The methods `is_positive` and `is_negative` are now `const` functions for
 792   all signed numeric types.][57105]
 793 - [The `get` method for all `NonZero` types is now `const`.][57167]
 794 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
 795   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
 796   numeric types.][57234]
 797 - [`Ipv4Addr::new` is now a `const` function][57234]
 798
 799 Stabilized APIs
 800 ---------------
 801 - [`unix::FileExt::read_exact_at`]
 802 - [`unix::FileExt::write_all_at`]
 803 - [`Option::transpose`]
 804 - [`Result::transpose`]
 805 - [`convert::identity`]
 806 - [`pin::Pin`]
 807 - [`marker::Unpin`]
 808 - [`marker::PhantomPinned`]
 809 - [`Vec::resize_with`]
 810 - [`VecDeque::resize_with`]
 811 - [`Duration::as_millis`]
 812 - [`Duration::as_micros`]
 813 - [`Duration::as_nanos`]
 814
 815
 816 Cargo
 817 -----
 818 - [You can now publish crates that require a feature flag to compile with
 819   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
 820 - [Cargo should now rebuild a crate if a file was modified during the initial
 821   build.][cargo/6484]
 822
 823 Compatibility Notes
 824 -------------------
 825 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
 826   are now deprecated in the standard library, and their usage will now produce a warning.
 827   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
 828   methods instead.
 829 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
 830   downcasting.
 831 - [Libtest no longer creates a new thread for each test when
 832   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
 833
 834 [55982]: https://github.com/rust-lang/rust/pull/55982/
 835 [56243]: https://github.com/rust-lang/rust/pull/56243
 836 [56303]: https://github.com/rust-lang/rust/pull/56303/
 837 [56351]: https://github.com/rust-lang/rust/pull/56351/
 838 [56362]: https://github.com/rust-lang/rust/pull/56362
 839 [56642]: https://github.com/rust-lang/rust/pull/56642/
 840 [56769]: https://github.com/rust-lang/rust/pull/56769/
 841 [56805]: https://github.com/rust-lang/rust/pull/56805
 842 [56947]: https://github.com/rust-lang/rust/pull/56947/
 843 [57049]: https://github.com/rust-lang/rust/pull/57049/
 844 [57067]: https://github.com/rust-lang/rust/pull/57067/
 845 [57105]: https://github.com/rust-lang/rust/pull/57105
 846 [57130]: https://github.com/rust-lang/rust/pull/57130/
 847 [57167]: https://github.com/rust-lang/rust/pull/57167/
 848 [57175]: https://github.com/rust-lang/rust/pull/57175/
 849 [57234]: https://github.com/rust-lang/rust/pull/57234/
 850 [57332]: https://github.com/rust-lang/rust/pull/57332/
 851 [57465]: https://github.com/rust-lang/rust/pull/57465/
 852 [57532]: https://github.com/rust-lang/rust/pull/57532/
 853 [57535]: https://github.com/rust-lang/rust/pull/57535/
 854 [57566]: https://github.com/rust-lang/rust/pull/57566/
 855 [57615]: https://github.com/rust-lang/rust/pull/57615/
 856 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
 857 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
 858 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
 859 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
 860 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
 861 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
 862 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
 863 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
 864 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
 865 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
 866 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
 867 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
 868 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
 869 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
 870 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
 871 [platform-support]: https://forge.rust-lang.org/platform-support.html
 872
 873 Version 1.32.0 (2019-01-17)
 874 ==========================
 875
 876 Language
 877 --------
 878 #### 2018 edition
 879 - [You can now use the `?` operator in macro definitions.][56245] The `?`
 880   operator allows you to specify zero or one repetitions similar to the `*` and
 881   `+` operators.
 882 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
 883   now always resolve to the item (`enum`, `struct`, etc.) available in the
 884   module if present, before resolving to a external crate or an item the prelude.][56759]
 885   E.g.
 886   ```rust
 887   enum Color { Red, Green, Blue }
 888
 889   use Color::*;
 890   ```
 891
 892 #### All editions
 893 - [You can now match against `PhantomData<T>` types.][55837]
 894 - [You can now match against literals in macros with the `literal`
 895   specifier.][56072] This will match against a literal of any type.
 896   E.g. `1`, `'A'`, `"Hello World"`
 897 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
 898   ```rust
 899   struct Point(i32, i32);
 900
 901   impl Point {
 902       pub fn new(x: i32, y: i32) -> Self {
 903           Self(x, y)
 904       }
 905
 906       pub fn is_origin(&self) -> bool {
 907           match self {
 908               Self(0, 0) => true,
 909               _ => false,
 910           }
 911       }
 912   }
 913   ```
 914 - [Self can also now be used in type definitions.][56366] E.g.
 915   ```rust
 916   enum List<T>
 917   where
 918       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
 919   {
 920       Nil,
 921       Cons(T, Box<Self>) // likewise here
 922   }
 923   ```
 924 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
 925   a `impl Trait` or `dyn Trait` is returned and unused in the program.
 926
 927 Compiler
 928 --------
 929 - [The default allocator has changed from jemalloc to the default allocator on
 930   your system.][55238] The compiler itself on Linux & macOS will still use
 931   jemalloc, but programs compiled with it will use the system allocator.
 932 - [Added the `aarch64-pc-windows-msvc` target.][55702]
 933
 934 Libraries
 935 ---------
 936 - [`PathBuf` now implements `FromStr`.][55148]
 937 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
 938 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
 939   easily debug expressions in your rust program. E.g.
 940   ```rust
 941   let a = 2;
 942   let b = dbg!(a * 2) + 1;
 943   //      ^-- prints: [src/main.rs:4] a * 2 = 4
 944   assert_eq!(b, 5);
 945   ```
 946
 947 The following APIs are now `const` functions and can be used in a
 948 `const` context.
 949
 950 - [`Cell::as_ptr`]
 951 - [`UnsafeCell::get`]
 952 - [`char::is_ascii`]
 953 - [`iter::empty`]
 954 - [`ManuallyDrop::new`]
 955 - [`ManuallyDrop::into_inner`]
 956 - [`RangeInclusive::start`]
 957 - [`RangeInclusive::end`]
 958 - [`NonNull::as_ptr`]
 959 - [`slice::as_ptr`]
 960 - [`str::as_ptr`]
 961 - [`Duration::as_secs`]
 962 - [`Duration::subsec_millis`]
 963 - [`Duration::subsec_micros`]
 964 - [`Duration::subsec_nanos`]
 965 - [`CStr::as_ptr`]
 966 - [`Ipv4Addr::is_unspecified`]
 967 - [`Ipv6Addr::new`]
 968 - [`Ipv6Addr::octets`]
 969
 970 Stabilized APIs
 971 ---------------
 972 - [`i8::to_be_bytes`]
 973 - [`i8::to_le_bytes`]
 974 - [`i8::to_ne_bytes`]
 975 - [`i8::from_be_bytes`]
 976 - [`i8::from_le_bytes`]
 977 - [`i8::from_ne_bytes`]
 978 - [`i16::to_be_bytes`]
 979 - [`i16::to_le_bytes`]
 980 - [`i16::to_ne_bytes`]
 981 - [`i16::from_be_bytes`]
 982 - [`i16::from_le_bytes`]
 983 - [`i16::from_ne_bytes`]
 984 - [`i32::to_be_bytes`]
 985 - [`i32::to_le_bytes`]
 986 - [`i32::to_ne_bytes`]
 987 - [`i32::from_be_bytes`]
 988 - [`i32::from_le_bytes`]
 989 - [`i32::from_ne_bytes`]
 990 - [`i64::to_be_bytes`]
 991 - [`i64::to_le_bytes`]
 992 - [`i64::to_ne_bytes`]
 993 - [`i64::from_be_bytes`]
 994 - [`i64::from_le_bytes`]
 995 - [`i64::from_ne_bytes`]
 996 - [`i128::to_be_bytes`]
 997 - [`i128::to_le_bytes`]
 998 - [`i128::to_ne_bytes`]
 999 - [`i128::from_be_bytes`]
1000 - [`i128::from_le_bytes`]
1001 - [`i128::from_ne_bytes`]
1002 - [`isize::to_be_bytes`]
1003 - [`isize::to_le_bytes`]
1004 - [`isize::to_ne_bytes`]
1005 - [`isize::from_be_bytes`]
1006 - [`isize::from_le_bytes`]
1007 - [`isize::from_ne_bytes`]
1008 - [`u8::to_be_bytes`]
1009 - [`u8::to_le_bytes`]
1010 - [`u8::to_ne_bytes`]
1011 - [`u8::from_be_bytes`]
1012 - [`u8::from_le_bytes`]
1013 - [`u8::from_ne_bytes`]
1014 - [`u16::to_be_bytes`]
1015 - [`u16::to_le_bytes`]
1016 - [`u16::to_ne_bytes`]
1017 - [`u16::from_be_bytes`]
1018 - [`u16::from_le_bytes`]
1019 - [`u16::from_ne_bytes`]
1020 - [`u32::to_be_bytes`]
1021 - [`u32::to_le_bytes`]
1022 - [`u32::to_ne_bytes`]
1023 - [`u32::from_be_bytes`]
1024 - [`u32::from_le_bytes`]
1025 - [`u32::from_ne_bytes`]
1026 - [`u64::to_be_bytes`]
1027 - [`u64::to_le_bytes`]
1028 - [`u64::to_ne_bytes`]
1029 - [`u64::from_be_bytes`]
1030 - [`u64::from_le_bytes`]
1031 - [`u64::from_ne_bytes`]
1032 - [`u128::to_be_bytes`]
1033 - [`u128::to_le_bytes`]
1034 - [`u128::to_ne_bytes`]
1035 - [`u128::from_be_bytes`]
1036 - [`u128::from_le_bytes`]
1037 - [`u128::from_ne_bytes`]
1038 - [`usize::to_be_bytes`]
1039 - [`usize::to_le_bytes`]
1040 - [`usize::to_ne_bytes`]
1041 - [`usize::from_be_bytes`]
1042 - [`usize::from_le_bytes`]
1043 - [`usize::from_ne_bytes`]
1044
1045 Cargo
1046 -----
1047 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
1048 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
1049
1050 Misc
1051 ----
1052 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
1053
1054 Compatibility Notes
1055 -------------------
1056 - [The argument types for AVX's
1057   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
1058   been changed from `*const` to `*mut` as the previous implementation
1059   was unsound.
1060
1061
1062 [55148]: https://github.com/rust-lang/rust/pull/55148/
1063 [55238]: https://github.com/rust-lang/rust/pull/55238/
1064 [55280]: https://github.com/rust-lang/rust/pull/55280/
1065 [55610]: https://github.com/rust-lang/rust/pull/55610/
1066 [55663]: https://github.com/rust-lang/rust/pull/55663/
1067 [55702]: https://github.com/rust-lang/rust/pull/55702/
1068 [55837]: https://github.com/rust-lang/rust/pull/55837/
1069 [55843]: https://github.com/rust-lang/rust/pull/55843/
1070 [56072]: https://github.com/rust-lang/rust/pull/56072/
1071 [56245]: https://github.com/rust-lang/rust/pull/56245/
1072 [56365]: https://github.com/rust-lang/rust/pull/56365/
1073 [56366]: https://github.com/rust-lang/rust/pull/56366/
1074 [56395]: https://github.com/rust-lang/rust/pull/56395/
1075 [56759]: https://github.com/rust-lang/rust/pull/56759/
1076 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
1077 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
1078 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
1079 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
1080 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
1081 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1082 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1083 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
1084 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
1085 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
1086 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
1087 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
1088 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
1089 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
1090 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
1091 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
1092 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
1093 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
1094 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
1095 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
1096 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
1097 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
1098 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
1099 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
1100 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
1101 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
1102 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
1103 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
1104 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
1105 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
1106 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
1107 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
1108 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
1109 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
1110 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
1111 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
1112 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
1113 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
1114 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
1115 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
1116 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
1117 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
1118 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
1119 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
1120 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
1121 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
1122 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
1123 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
1124 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
1125 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
1126 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
1127 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
1128 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
1129 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
1130 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
1131 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
1132 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
1133 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
1134 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
1135 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
1136 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
1137 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
1138 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
1139 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
1140 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
1141 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
1142 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
1143 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
1144 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
1145 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
1146 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
1147 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
1148 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
1149 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
1150 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
1151 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
1152 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
1153 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
1154 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
1155 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
1156 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
1157 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
1158 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
1159 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
1160 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
1161 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
1162 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
1163 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
1164 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
1165 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
1166 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
1167 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
1168 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
1169
1170
1171 Version 1.31.1 (2018-12-20)
1172 ===========================
1173
1174 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
1175 - [Fix broken go-to-definition in RLS][rls/1171]
1176 - [Fix infinite loop on hover in RLS][rls/1170]
1177
1178 [56562]: https://github.com/rust-lang/rust/pull/56562
1179 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
1180 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
1181
1182 Version 1.31.0 (2018-12-06)
1183 ==========================
1184
1185 Language
1186 --------
1187 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
1188 - [New lifetime elision rules now allow for eliding lifetimes in functions and
1189   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
1190   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
1191   in structs.
1192 - [You can now define and use `const` functions.][54835] These are currently
1193   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
1194   [language reference][const-reference] for what exactly is available.
1195 - [You can now use tool lints, which allow you to scope lints from external
1196   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
1197 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
1198   a crate, not just in exported functions.][54451]
1199 - [You can now use parentheses in pattern matches.][54497]
1200
1201 Compiler
1202 --------
1203 - [Updated musl to 1.1.20][54430]
1204
1205 Libraries
1206 ---------
1207 - [You can now convert `num::NonZero*` types to their raw equivalents using the
1208   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
1209 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
1210   into `Option<&mut T>` using the `From` trait.][53218]
1211 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
1212
1213
1214 Stabilized APIs
1215 ---------------
1216 - [`slice::align_to`]
1217 - [`slice::align_to_mut`]
1218 - [`slice::chunks_exact`]
1219 - [`slice::chunks_exact_mut`]
1220 - [`slice::rchunks`]
1221 - [`slice::rchunks_mut`]
1222 - [`slice::rchunks_exact`]
1223 - [`slice::rchunks_exact_mut`]
1224 - [`Option::replace`]
1225
1226 Cargo
1227 -----
1228 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
1229 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
1230   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
1231
1232 [52813]: https://github.com/rust-lang/rust/pull/52813/
1233 [53218]: https://github.com/rust-lang/rust/pull/53218/
1234 [53555]: https://github.com/rust-lang/rust/issues/53555/
1235 [54057]: https://github.com/rust-lang/rust/pull/54057/
1236 [54240]: https://github.com/rust-lang/rust/pull/54240/
1237 [54430]: https://github.com/rust-lang/rust/pull/54430/
1238 [54451]: https://github.com/rust-lang/rust/pull/54451/
1239 [54497]: https://github.com/rust-lang/rust/pull/54497/
1240 [54778]: https://github.com/rust-lang/rust/pull/54778/
1241 [54835]: https://github.com/rust-lang/rust/pull/54835/
1242 [54870]: https://github.com/rust-lang/rust/pull/54870/
1243 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
1244 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
1245 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
1246 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
1247 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
1248 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
1249 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1250 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
1251 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1252 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
1253 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
1254 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
1255 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
1256 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
1257
1258 Version 1.30.1 (2018-11-08)
1259 ===========================
1260
1261 - [Fixed overflow ICE in rustdoc][54199]
1262 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
1263
1264 [54199]: https://github.com/rust-lang/rust/pull/54199
1265 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
1266
1267 Version 1.30.0 (2018-10-25)
1268 ==========================
1269
1270 Language
1271 --------
1272 - [Procedural macros are now available.][52081] These kinds of macros allow for
1273   more powerful code generation. There is a [new chapter available][proc-macros]
1274   in the Rust Programming Language book that goes further in depth.
1275 - [You can now use keywords as identifiers using the raw identifiers
1276   syntax (`r#`),][53236] e.g. `let r#for = true;`
1277 - [Using anonymous parameters in traits is now deprecated with a warning and
1278   will be a hard error in the 2018 edition.][53272]
1279 - [You can now use `crate` in paths.][54404] This allows you to refer to the
1280   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
1281 - [Using a external crate no longer requires being prefixed with `::`.][54404]
1282   Previously, using a external crate in a module without a use statement
1283   required `let json = ::serde_json::from_str(foo);` but can now be written
1284   as `let json = serde_json::from_str(foo);`.
1285 - [You can now apply the `#[used]` attribute to static items to prevent the
1286   compiler from optimising them away, even if they appear to be unused,][51363]
1287   e.g. `#[used] static FOO: u32 = 1;`
1288 - [You can now import and reexport macros from other crates with the `use`
1289   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
1290   the root module of the crate. If your macro relies on calling other local
1291   macros, it is recommended to export with the
1292   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
1293   those macros.
1294 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
1295   using the `vis` specifier.][53370]
1296 - [Non-macro attributes now allow all forms of literals, not just
1297   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
1298   write `#[attr(true)]`.
1299 - [You can now specify a function to handle a panic in the Rust runtime with the
1300   `#[panic_handler]` attribute.][51366]
1301
1302 Compiler
1303 --------
1304 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
1305 - [Added the `aarch64-unknown-netbsd` target][53165]
1306
1307 Libraries
1308 ---------
1309 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
1310
1311 Stabilized APIs
1312 ---------------
1313 - [`Ipv4Addr::BROADCAST`]
1314 - [`Ipv4Addr::LOCALHOST`]
1315 - [`Ipv4Addr::UNSPECIFIED`]
1316 - [`Ipv6Addr::LOCALHOST`]
1317 - [`Ipv6Addr::UNSPECIFIED`]
1318 - [`Iterator::find_map`]
1319
1320   The following methods are replacement methods for `trim_left`, `trim_right`,
1321   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
1322   in 1.33.0:
1323 - [`str::trim_end_matches`]
1324 - [`str::trim_end`]
1325 - [`str::trim_start_matches`]
1326 - [`str::trim_start`]
1327
1328 Cargo
1329 ----
1330 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
1331 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
1332   equivalent to calling `rustdoc --error-format=json`.
1333 - [Cargo will now provide a progress bar for builds.][cargo/5995]
1334
1335 Misc
1336 ----
1337 - [`rustdoc` allows you to specify what edition to treat your code as with the
1338   `--edition` option.][54057]
1339 - [`rustdoc` now has the `--color` (specify whether to output color) and
1340   `--error-format` (specify error format, e.g. `json`) options.][53003]
1341 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
1342   debug symbols.][53774]
1343 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
1344   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
1345
1346 [50911]: https://github.com/rust-lang/rust/pull/50911/
1347 [51363]: https://github.com/rust-lang/rust/pull/51363/
1348 [51366]: https://github.com/rust-lang/rust/pull/51366/
1349 [52081]: https://github.com/rust-lang/rust/pull/52081/
1350 [53003]: https://github.com/rust-lang/rust/pull/53003/
1351 [53033]: https://github.com/rust-lang/rust/pull/53033/
1352 [53044]: https://github.com/rust-lang/rust/pull/53044/
1353 [53165]: https://github.com/rust-lang/rust/pull/53165/
1354 [53213]: https://github.com/rust-lang/rust/pull/53213/
1355 [53236]: https://github.com/rust-lang/rust/pull/53236/
1356 [53272]: https://github.com/rust-lang/rust/pull/53272/
1357 [53370]: https://github.com/rust-lang/rust/pull/53370/
1358 [53459]: https://github.com/rust-lang/rust/pull/53459/
1359 [53774]: https://github.com/rust-lang/rust/pull/53774/
1360 [53822]: https://github.com/rust-lang/rust/pull/53822/
1361 [54057]: https://github.com/rust-lang/rust/pull/54057/
1362 [54146]: https://github.com/rust-lang/rust/pull/54146/
1363 [54404]: https://github.com/rust-lang/rust/pull/54404/
1364 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
1365 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
1366 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
1367 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
1368
1369 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
1370 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
1371 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
1372 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
1373 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
1374 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
1375 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
1376 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
1377 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
1378 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
1379
1380
1381 Version 1.29.2 (2018-10-11)
1382 ===========================
1383
1384 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
1385 - The `rls-preview` component on the windows-gnu targets has been restored.
1386
1387 [54639]: https://github.com/rust-lang/rust/pull/54639
1388
1389
1390 Version 1.29.1 (2018-09-25)
1391 ===========================
1392
1393 Security Notes
1394 --------------
1395
1396 - The standard library's `str::repeat` function contained an out of bounds write
1397   caused by an integer overflow. This has been fixed by deterministically
1398   panicking when an overflow happens.
1399
1400   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
1401   us.
1402
1403
1404 Version 1.29.0 (2018-09-13)
1405 ==========================
1406
1407 Compiler
1408 --------
1409 - [Bumped minimum LLVM version to 5.0.][51899]
1410 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
1411 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
1412
1413 Libraries
1414 ---------
1415 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
1416 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
1417 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
1418 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
1419   for `&str`.][51178]
1420 - [`Cell<T>` now allows `T` to be unsized.][50494]
1421 - [`SocketAddr` is now stable on Redox.][52656]
1422
1423 Stabilized APIs
1424 ---------------
1425 - [`Arc::downcast`]
1426 - [`Iterator::flatten`]
1427 - [`Rc::downcast`]
1428
1429 Cargo
1430 -----
1431 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
1432   `--locked` to disable this behavior.
1433 - [`cargo-install` will now allow you to cross compile an install
1434   using `--target`.][cargo/5614]
1435 - [Added the `cargo-fix` subcommand to automatically move project code from
1436   2015 edition to 2018.][cargo/5723]
1437 - [`cargo doc` can now optionally document private types using the
1438   `--document-private-items` flag.][cargo/5543]
1439
1440 Misc
1441 ----
1442 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
1443   the specified level to that level.][52354] For example `--cap-lints warn`
1444   will demote `deny` and `forbid` lints to `warn`.
1445 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
1446   fails and `101` if there is a panic.][52197]
1447 - [A preview of clippy has been made available through rustup.][51122]
1448   You can install the preview with `rustup component add clippy-preview`.
1449
1450 Compatibility Notes
1451 -------------------
1452 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
1453   Use `str::get_unchecked(begin..end)` instead.
1454 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
1455   Consider using the `home_dir` function from
1456   https://crates.io/crates/dirs instead.
1457 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
1458 - [`cfg` attributes and `--cfg` command line flags are now more
1459   strictly validated.][53893]
1460
1461 [53893]: https://github.com/rust-lang/rust/pull/53893/
1462 [52861]: https://github.com/rust-lang/rust/pull/52861/
1463 [52656]: https://github.com/rust-lang/rust/pull/52656/
1464 [52239]: https://github.com/rust-lang/rust/pull/52239/
1465 [52330]: https://github.com/rust-lang/rust/pull/52330/
1466 [52354]: https://github.com/rust-lang/rust/pull/52354/
1467 [52402]: https://github.com/rust-lang/rust/pull/52402/
1468 [52103]: https://github.com/rust-lang/rust/pull/52103/
1469 [52197]: https://github.com/rust-lang/rust/pull/52197/
1470 [51807]: https://github.com/rust-lang/rust/pull/51807/
1471 [51899]: https://github.com/rust-lang/rust/pull/51899/
1472 [51912]: https://github.com/rust-lang/rust/pull/51912/
1473 [51511]: https://github.com/rust-lang/rust/pull/51511/
1474 [51619]: https://github.com/rust-lang/rust/pull/51619/
1475 [51656]: https://github.com/rust-lang/rust/pull/51656/
1476 [51178]: https://github.com/rust-lang/rust/pull/51178/
1477 [51122]: https://github.com/rust-lang/rust/pull/51122
1478 [50494]: https://github.com/rust-lang/rust/pull/50494/
1479 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
1480 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
1481 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
1482 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
1483 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
1484 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
1485 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
1486
1487
1488 Version 1.28.0 (2018-08-02)
1489 ===========================
1490
1491 Language
1492 --------
1493 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
1494   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
1495   the inner type across Foreign Function Interface (FFI) boundaries.
1496 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
1497   and can now be used as identifiers.][51196]
1498 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
1499   stable.][51241] This will allow users to specify a global allocator for
1500   their program.
1501 - [Unit test functions marked with the `#[test]` attribute can now return
1502   `Result<(), E: Debug>` in addition to `()`.][51298]
1503 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
1504   allows macros to easily target lifetimes.
1505
1506 Compiler
1507 --------
1508 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
1509   prioritise making smaller binary sizes. `z` is the same as `s` with the
1510   exception that it does not vectorise loops, which typically results in an even
1511   smaller binary.
1512 - [The short error format is now stable.][49546] Specified with
1513   `--error-format=short` this option will provide a more compressed output of
1514   rust error messages.
1515 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
1516 - [Reduced the number of allocations in the macro parser.][50855] This can
1517   improve compile times of macro heavy crates on average by 5%.
1518
1519 Libraries
1520 ---------
1521 - [Implemented `Default` for `&mut str`.][51306]
1522 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
1523 - [Implemented `Extend` for `()`.][50234]
1524 - [The `Debug` implementation of `time::Duration` should now be more easily
1525   human readable.][50364] Previously a `Duration` of one second would printed as
1526   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
1527 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
1528   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
1529   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
1530   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
1531   for `PathBuf`.][50170]
1532 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
1533   and `Wrapping<i128>`.][50465]
1534 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
1535   possible.][51050] This can provide up to a 40% speed increase.
1536 - [Improved error messages when using `format!`.][50610]
1537
1538 Stabilized APIs
1539 ---------------
1540 - [`Iterator::step_by`]
1541 - [`Path::ancestors`]
1542 - [`SystemTime::UNIX_EPOCH`]
1543 - [`alloc::GlobalAlloc`]
1544 - [`alloc::Layout`]
1545 - [`alloc::LayoutErr`]
1546 - [`alloc::System`]
1547 - [`alloc::alloc`]
1548 - [`alloc::alloc_zeroed`]
1549 - [`alloc::dealloc`]
1550 - [`alloc::realloc`]
1551 - [`alloc::handle_alloc_error`]
1552 - [`btree_map::Entry::or_default`]
1553 - [`fmt::Alignment`]
1554 - [`hash_map::Entry::or_default`]
1555 - [`iter::repeat_with`]
1556 - [`num::NonZeroUsize`]
1557 - [`num::NonZeroU128`]
1558 - [`num::NonZeroU16`]
1559 - [`num::NonZeroU32`]
1560 - [`num::NonZeroU64`]
1561 - [`num::NonZeroU8`]
1562 - [`ops::RangeBounds`]
1563 - [`slice::SliceIndex`]
1564 - [`slice::from_mut`]
1565 - [`slice::from_ref`]
1566 - [`{Any + Send + Sync}::downcast_mut`]
1567 - [`{Any + Send + Sync}::downcast_ref`]
1568 - [`{Any + Send + Sync}::is`]
1569
1570 Cargo
1571 -----
1572 - [Cargo will now no longer allow you to publish crates with build scripts that
1573   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
1574   considered to be immutable.
1575
1576 Misc
1577 ----
1578 - [The `suggestion_applicability` field in `rustc`'s json output is now
1579   stable.][50486] This will allow dev tools to check whether a code suggestion
1580   would apply to them.
1581
1582 Compatibility Notes
1583 -------------------
1584 - [Rust will consider trait objects with duplicated constraints to be the same
1585   type as without the duplicated constraint.][51276] For example the below code will
1586   now fail to compile.
1587   ```rust
1588   trait Trait {}
1589
1590   impl Trait + Send {
1591       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
1592   }
1593
1594   impl Trait + Send + Send {
1595       fn test(&self) { println!("two"); }
1596   }
1597   ```
1598
1599 [49546]: https://github.com/rust-lang/rust/pull/49546/
1600 [50143]: https://github.com/rust-lang/rust/pull/50143/
1601 [50170]: https://github.com/rust-lang/rust/pull/50170/
1602 [50234]: https://github.com/rust-lang/rust/pull/50234/
1603 [50265]: https://github.com/rust-lang/rust/pull/50265/
1604 [50364]: https://github.com/rust-lang/rust/pull/50364/
1605 [50385]: https://github.com/rust-lang/rust/pull/50385/
1606 [50465]: https://github.com/rust-lang/rust/pull/50465/
1607 [50486]: https://github.com/rust-lang/rust/pull/50486/
1608 [50554]: https://github.com/rust-lang/rust/pull/50554/
1609 [50610]: https://github.com/rust-lang/rust/pull/50610/
1610 [50855]: https://github.com/rust-lang/rust/pull/50855/
1611 [51050]: https://github.com/rust-lang/rust/pull/51050/
1612 [51196]: https://github.com/rust-lang/rust/pull/51196/
1613 [51200]: https://github.com/rust-lang/rust/pull/51200/
1614 [51241]: https://github.com/rust-lang/rust/pull/51241/
1615 [51276]: https://github.com/rust-lang/rust/pull/51276/
1616 [51298]: https://github.com/rust-lang/rust/pull/51298/
1617 [51306]: https://github.com/rust-lang/rust/pull/51306/
1618 [51562]: https://github.com/rust-lang/rust/pull/51562/
1619 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
1620 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
1621 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
1622 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
1623 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
1624 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
1625 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
1626 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
1627 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
1628 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
1629 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
1630 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
1631 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
1632 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
1633 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
1634 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
1635 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
1636 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
1637 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
1638 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
1639 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
1640 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
1641 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
1642 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
1643 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
1644 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
1645 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
1646 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
1647 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
1648 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
1649
1650 Version 1.27.2 (2018-07-20)
1651 ===========================
1652
1653 Compatibility Notes
1654 -------------------
1655
1656 - The borrow checker was fixed to avoid potential unsoundness when using
1657   match ergonomics: [#52213][52213].
1658
1659 [52213]: https://github.com/rust-lang/rust/issues/52213
1660
1661 Version 1.27.1 (2018-07-10)
1662 ===========================
1663
1664 Security Notes
1665 --------------
1666
1667 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
1668   when running, which enabled executing code as some other user on a
1669   given machine. This release fixes that vulnerability; you can read
1670   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
1671
1672   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
1673
1674 Compatibility Notes
1675 -------------------
1676
1677 - The borrow checker was fixed to avoid an additional potential unsoundness when using
1678   match ergonomics: [#51415][51415], [#49534][49534].
1679
1680 [51415]: https://github.com/rust-lang/rust/issues/51415
1681 [49534]: https://github.com/rust-lang/rust/issues/49534
1682 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
1683 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
1684
1685 Version 1.27.0 (2018-06-21)
1686 ==========================
1687
1688 Language
1689 --------
1690 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
1691   be used as an identifier.
1692 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
1693   bare `Trait` syntax, and should make it clearer when being used in tandem with
1694   `impl Trait` because it is equivalent to the following syntax:
1695   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
1696   `Box<Trait> == Box<dyn Trait>`.
1697 - [Attributes on generic parameters such as types and lifetimes are
1698   now stable.][48851] e.g.
1699   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
1700 - [The `#[must_use]` attribute can now also be used on functions as well as
1701   types.][48925] It provides a lint that by default warns users when the
1702   value returned by a function has not been used.
1703
1704 Compiler
1705 --------
1706 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
1707
1708 Libraries
1709 ---------
1710 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
1711   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
1712   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
1713   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
1714   the `cfg` attribute.
1715 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
1716   std are now available in core.][49896]
1717 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
1718   to `Self`.][49630]
1719 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
1720   that the operation isn't done in place.
1721 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
1722   the `#[must_use]` attribute][49533] to warn about unused potentially
1723   expensive allocations.
1724
1725 Stabilized APIs
1726 ---------------
1727 - [`DoubleEndedIterator::rfind`]
1728 - [`DoubleEndedIterator::rfold`]
1729 - [`DoubleEndedIterator::try_rfold`]
1730 - [`Duration::from_micros`]
1731 - [`Duration::from_nanos`]
1732 - [`Duration::subsec_micros`]
1733 - [`Duration::subsec_millis`]
1734 - [`HashMap::remove_entry`]
1735 - [`Iterator::try_fold`]
1736 - [`Iterator::try_for_each`]
1737 - [`NonNull::cast`]
1738 - [`Option::filter`]
1739 - [`String::replace_range`]
1740 - [`Take::set_limit`]
1741 - [`hint::unreachable_unchecked`]
1742 - [`os::unix::process::parent_id`]
1743 - [`ptr::swap_nonoverlapping`]
1744 - [`slice::rsplit_mut`]
1745 - [`slice::rsplit`]
1746 - [`slice::swap_with_slice`]
1747
1748 Cargo
1749 -----
1750 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
1751   `readme`, and `repository` fields.][cargo/5386]
1752 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
1753 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
1754   a different directory than `target` for placing compilation artifacts.
1755 - [Cargo will be adding automatic target inference for binaries, benchmarks,
1756   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
1757   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
1758   where cargo would infer a binary, Cargo will produce a warning. You can
1759   disable this feature ahead of time by setting any of the following to false:
1760   `autobins`, `autobenches`, `autoexamples`, `autotests`.
1761 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
1762   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
1763
1764 Misc
1765 ----
1766 - [Added “The Rustc book” into the official documentation.][49707]
1767   [“The Rustc book”] documents and teaches how to use the rustc compiler.
1768 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
1769
1770 Compatibility Notes
1771 -------------------
1772 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
1773   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
1774   compile, `"".is_empty()` will still compile.
1775 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
1776   will only print the inner type.][48553] E.g.
1777   `print!("{:?}", AtomicBool::new(true))` will print `true`,
1778   not `AtomicBool(true)`.
1779 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
1780   could enter higher numbers but they were not supported by LLVM. Up to 512MB
1781   alignment should cover all use cases.
1782 - The `.description()` method on the `std::error::Error` trait
1783   [has been soft-deprecated][50163]. It is no longer required to implement it.
1784
1785 [48553]: https://github.com/rust-lang/rust/pull/48553/
1786 [48851]: https://github.com/rust-lang/rust/pull/48851/
1787 [48925]: https://github.com/rust-lang/rust/pull/48925/
1788 [49533]: https://github.com/rust-lang/rust/pull/49533/
1789 [49623]: https://github.com/rust-lang/rust/pull/49623/
1790 [49630]: https://github.com/rust-lang/rust/pull/49630/
1791 [49664]: https://github.com/rust-lang/rust/pull/49664/
1792 [49699]: https://github.com/rust-lang/rust/pull/49699/
1793 [49707]: https://github.com/rust-lang/rust/pull/49707/
1794 [49719]: https://github.com/rust-lang/rust/pull/49719/
1795 [49896]: https://github.com/rust-lang/rust/pull/49896/
1796 [49968]: https://github.com/rust-lang/rust/pull/49968/
1797 [50163]: https://github.com/rust-lang/rust/pull/50163
1798 [50177]: https://github.com/rust-lang/rust/pull/50177/
1799 [50378]: https://github.com/rust-lang/rust/pull/50378/
1800 [50398]: https://github.com/rust-lang/rust/pull/50398/
1801 [50423]: https://github.com/rust-lang/rust/pull/50423/
1802 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
1803 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
1804 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
1805 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
1806 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
1807 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
1808 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
1809 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
1810 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
1811 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
1812 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
1813 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1814 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1815 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
1816 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
1817 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
1818 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
1819 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
1820 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
1821 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
1822 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
1823 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
1824 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
1825 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
1826 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
1827 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
1828 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
1829 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
1830 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
1831 [“The Rustc book”]: https://doc.rust-lang.org/rustc
1832
1833
1834 Version 1.26.2 (2018-06-05)
1835 ==========================
1836
1837 Compatibility Notes
1838 -------------------
1839
1840 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
1841
1842 [51117]: https://github.com/rust-lang/rust/issues/51117
1843
1844
1845 Version 1.26.1 (2018-05-29)
1846 ==========================
1847
1848 Tools
1849 -----
1850
1851 - [RLS now works on Windows.][50646]
1852 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
1853
1854
1855 Compatibility Notes
1856 --------
1857
1858 - [`fn main() -> impl Trait` no longer works for non-Termination
1859   trait.][50656]
1860   This reverts an accidental stabilization.
1861 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
1862 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
1863
1864 [50646]: https://github.com/rust-lang/rust/issues/50646
1865 [50656]: https://github.com/rust-lang/rust/pull/50656
1866 [50812]: https://github.com/rust-lang/rust/pull/50812
1867 [50950]: https://github.com/rust-lang/rust/issues/50950
1868 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
1869
1870 Version 1.26.0 (2018-05-10)
1871 ==========================
1872
1873 Language
1874 --------
1875 - [Closures now implement `Copy` and/or `Clone` if all captured variables
1876   implement either or both traits.][49299]
1877 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
1878 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
1879   lifetime can be elided.][49458]
1880 - [`impl Trait` is now stable allowing you to have abstract types in returns
1881    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
1882   `fn open(path: impl AsRef<Path>)`.
1883 - [Pattern matching will now automatically apply dereferences.][49394]
1884 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
1885 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
1886 - [A lot of operations are now available in a const context.][46882] E.g. You
1887   can now index into constant arrays, reference and dereference into constants,
1888   and use tuple struct constructors.
1889 - [Fixed entry slice patterns are now stable.][48516] E.g.
1890   ```rust
1891   let points = [1, 2, 3, 4];
1892   match points {
1893       [1, 2, 3, 4] => println!("All points were sequential."),
1894       _ => println!("Not all points were sequential."),
1895   }
1896   ```
1897
1898
1899 Compiler
1900 --------
1901 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
1902 - [Fixed exponential projection complexity on nested types.][48296]
1903   This can provide up to a ~12% reduction in compile times for certain crates.
1904 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
1905   to remap path prefixes outputted by the compiler.
1906 - [Added `powerpc-unknown-netbsd` target.][48281]
1907
1908 Libraries
1909 ---------
1910 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
1911 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
1912   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
1913 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
1914 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
1915 - [`ascii::escape_default` is now available in libcore.][48735]
1916 - [Trailing commas are now supported in std and core macros.][48056]
1917 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
1918 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
1919
1920 Stabilized APIs
1921 ---------------
1922 - [`*const T::add`]
1923 - [`*const T::copy_to_nonoverlapping`]
1924 - [`*const T::copy_to`]
1925 - [`*const T::read_unaligned`]
1926 - [`*const T::read_volatile`]
1927 - [`*const T::read`]
1928 - [`*const T::sub`]
1929 - [`*const T::wrapping_add`]
1930 - [`*const T::wrapping_sub`]
1931 - [`*mut T::add`]
1932 - [`*mut T::copy_to_nonoverlapping`]
1933 - [`*mut T::copy_to`]
1934 - [`*mut T::read_unaligned`]
1935 - [`*mut T::read_volatile`]
1936 - [`*mut T::read`]
1937 - [`*mut T::replace`]
1938 - [`*mut T::sub`]
1939 - [`*mut T::swap`]
1940 - [`*mut T::wrapping_add`]
1941 - [`*mut T::wrapping_sub`]
1942 - [`*mut T::write_bytes`]
1943 - [`*mut T::write_unaligned`]
1944 - [`*mut T::write_volatile`]
1945 - [`*mut T::write`]
1946 - [`Box::leak`]
1947 - [`FromUtf8Error::as_bytes`]
1948 - [`LocalKey::try_with`]
1949 - [`Option::cloned`]
1950 - [`btree_map::Entry::and_modify`]
1951 - [`fs::read_to_string`]
1952 - [`fs::read`]
1953 - [`fs::write`]
1954 - [`hash_map::Entry::and_modify`]
1955 - [`iter::FusedIterator`]
1956 - [`ops::RangeInclusive`]
1957 - [`ops::RangeToInclusive`]
1958 - [`process::id`]
1959 - [`slice::rotate_left`]
1960 - [`slice::rotate_right`]
1961 - [`String::retain`]
1962
1963
1964 Cargo
1965 -----
1966 - [Cargo will now output path to custom commands when `-v` is
1967   passed with `--list`][cargo/5041]
1968 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
1969
1970 Misc
1971 ----
1972 - [The second edition of "The Rust Programming Language" book is now recommended
1973   over the first.][48404]
1974
1975 Compatibility Notes
1976 -------------------
1977
1978 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
1979   syntax is now invalid.
1980   ```
1981   use std::ops::Fn as dyn;
1982   fn g(_: Box<dyn(std::fmt::Debug)>) {}
1983   ```
1984 - [The result of dereferences are no longer promoted to `'static`.][47408]
1985   e.g.
1986   ```rust
1987   fn main() {
1988       const PAIR: &(i32, i32) = &(0, 1);
1989       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
1990   }
1991   ```
1992 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
1993 - [`".e0"` will now no longer parse as `0.0` and will instead cause
1994   an error.][48235]
1995 - [Removed hoedown from rustdoc.][48274]
1996 - [Bounds on higher-kinded lifetimes a hard error.][48326]
1997
1998 [46882]: https://github.com/rust-lang/rust/pull/46882
1999 [47379]: https://github.com/rust-lang/rust/pull/47379
2000 [47408]: https://github.com/rust-lang/rust/pull/47408
2001 [47813]: https://github.com/rust-lang/rust/pull/47813
2002 [48056]: https://github.com/rust-lang/rust/pull/48056
2003 [48125]: https://github.com/rust-lang/rust/pull/48125
2004 [48166]: https://github.com/rust-lang/rust/pull/48166
2005 [48235]: https://github.com/rust-lang/rust/pull/48235
2006 [48274]: https://github.com/rust-lang/rust/pull/48274
2007 [48281]: https://github.com/rust-lang/rust/pull/48281
2008 [48296]: https://github.com/rust-lang/rust/pull/48296
2009 [48326]: https://github.com/rust-lang/rust/pull/48326
2010 [48359]: https://github.com/rust-lang/rust/pull/48359
2011 [48404]: https://github.com/rust-lang/rust/pull/48404
2012 [48481]: https://github.com/rust-lang/rust/pull/48481
2013 [48516]: https://github.com/rust-lang/rust/pull/48516
2014 [48628]: https://github.com/rust-lang/rust/pull/48628
2015 [48629]: https://github.com/rust-lang/rust/pull/48629
2016 [48657]: https://github.com/rust-lang/rust/pull/48657
2017 [48735]: https://github.com/rust-lang/rust/pull/48735
2018 [48978]: https://github.com/rust-lang/rust/pull/48978
2019 [49101]: https://github.com/rust-lang/rust/pull/49101
2020 [49109]: https://github.com/rust-lang/rust/pull/49109
2021 [49121]: https://github.com/rust-lang/rust/pull/49121
2022 [49162]: https://github.com/rust-lang/rust/pull/49162
2023 [49184]: https://github.com/rust-lang/rust/pull/49184
2024 [49234]: https://github.com/rust-lang/rust/pull/49234
2025 [49255]: https://github.com/rust-lang/rust/pull/49255
2026 [49299]: https://github.com/rust-lang/rust/pull/49299
2027 [49305]: https://github.com/rust-lang/rust/pull/49305
2028 [49394]: https://github.com/rust-lang/rust/pull/49394
2029 [49458]: https://github.com/rust-lang/rust/pull/49458
2030 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
2031 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
2032 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
2033 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
2034 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
2035 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
2036 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
2037 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
2038 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
2039 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
2040 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
2041 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
2042 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
2043 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
2044 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
2045 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
2046 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
2047 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
2048 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
2049 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
2050 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
2051 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
2052 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
2053 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
2054 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
2055 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
2056 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
2057 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
2058 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
2059 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
2060 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
2061 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
2062 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
2063 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
2064 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
2065 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
2066 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2067 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
2068 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
2069 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
2070 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
2071 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
2072
2073
2074 Version 1.25.0 (2018-03-29)
2075 ==========================
2076
2077 Language
2078 --------
2079 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
2080 - [You can now use nested groups of imports.][47948]
2081   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
2082 - [You can now have `|` at the start of a match arm.][47947] e.g.
2083 ```rust
2084 enum Foo { A, B, C }
2085
2086 fn main() {
2087     let x = Foo::A;
2088     match x {
2089         | Foo::A
2090         | Foo::B => println!("AB"),
2091         | Foo::C => println!("C"),
2092     }
2093 }
2094 ```
2095
2096 Compiler
2097 --------
2098 - [Upgraded to LLVM 6.][47828]
2099 - [Added `-C lto=val` option.][47521]
2100 - [Added `i586-unknown-linux-musl` target][47282]
2101
2102 Libraries
2103 ---------
2104 - [Impl Send for `process::Command` on Unix.][47760]
2105 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
2106 - [`UnsafeCell::into_inner` is now safe.][47204]
2107 - [Implement libstd for CloudABI.][47268]
2108 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
2109 - [Implement `AsRef<Path>` for Component][46985]
2110 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
2111 - [Moved `Duration` to libcore.][46666]
2112
2113 Stabilized APIs
2114 ---------------
2115 - [`Location::column`]
2116 - [`ptr::NonNull`]
2117
2118 The following functions can now be used in a constant expression.
2119 eg. `static MINUTE: Duration = Duration::from_secs(60);`
2120 - [`Duration::new`][47300]
2121 - [`Duration::from_secs`][47300]
2122 - [`Duration::from_millis`][47300]
2123
2124 Cargo
2125 -----
2126 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
2127 - [`cargo new` now defaults to creating a binary crate, instead of a
2128   library crate.][cargo/5029]
2129
2130 Misc
2131 ----
2132 - [Rust by example is now shipped with new releases][46196]
2133
2134 Compatibility Notes
2135 -------------------
2136 - [Deprecated `net::lookup_host`.][47510]
2137 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
2138 - The borrow checker was sometimes incorrectly permitting overlapping borrows
2139   around indexing operations (see [#47349][47349]). This has been fixed (which also
2140   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
2141 - [Removed deprecated unstable attribute `#[simd]`.][47251]
2142
2143 [33903]: https://github.com/rust-lang/rust/pull/33903
2144 [47947]: https://github.com/rust-lang/rust/pull/47947
2145 [47948]: https://github.com/rust-lang/rust/pull/47948
2146 [47760]: https://github.com/rust-lang/rust/pull/47760
2147 [47790]: https://github.com/rust-lang/rust/pull/47790
2148 [47828]: https://github.com/rust-lang/rust/pull/47828
2149 [47398]: https://github.com/rust-lang/rust/pull/47398
2150 [47510]: https://github.com/rust-lang/rust/pull/47510
2151 [47521]: https://github.com/rust-lang/rust/pull/47521
2152 [47204]: https://github.com/rust-lang/rust/pull/47204
2153 [47251]: https://github.com/rust-lang/rust/pull/47251
2154 [47268]: https://github.com/rust-lang/rust/pull/47268
2155 [47282]: https://github.com/rust-lang/rust/pull/47282
2156 [47300]: https://github.com/rust-lang/rust/pull/47300
2157 [47349]: https://github.com/rust-lang/rust/pull/47349
2158 [46931]: https://github.com/rust-lang/rust/pull/46931
2159 [46985]: https://github.com/rust-lang/rust/pull/46985
2160 [47006]: https://github.com/rust-lang/rust/pull/47006
2161 [46830]: https://github.com/rust-lang/rust/pull/46830
2162 [46095]: https://github.com/rust-lang/rust/pull/46095
2163 [46666]: https://github.com/rust-lang/rust/pull/46666
2164 [46196]: https://github.com/rust-lang/rust/pull/46196
2165 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
2166 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
2167 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
2168 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
2169 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
2170
2171
2172 Version 1.24.1 (2018-03-01)
2173 ==========================
2174
2175  - [Do not abort when unwinding through FFI][48251]
2176  - [Emit UTF-16 files for linker arguments on Windows][48318]
2177  - [Make the error index generator work again][48308]
2178  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
2179
2180 [48251]: https://github.com/rust-lang/rust/issues/48251
2181 [48308]: https://github.com/rust-lang/rust/issues/48308
2182 [48318]: https://github.com/rust-lang/rust/issues/48318
2183 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
2184
2185
2186 Version 1.24.0 (2018-02-15)
2187 ==========================
2188
2189 Language
2190 --------
2191 - [External `sysv64` ffi is now available.][46528]
2192   eg. `extern "sysv64" fn foo () {}`
2193
2194 Compiler
2195 --------
2196 - [rustc now uses 16 codegen units by default for release builds.][46910]
2197   For the fastest builds, utilize `codegen-units=1`.
2198 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
2199 - [Add `aarch64-unknown-openbsd` support][46760]
2200
2201 Libraries
2202 ---------
2203 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
2204   improvement in performance in the majority of cases.
2205 - [`OsStr`'s `Debug` implementation is now lossless and consistent
2206   with Windows.][46798]
2207 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
2208 - [impl `From<bool>` for `AtomicBool`][46293]
2209 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
2210 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
2211 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
2212 - [float::from_bits now just uses transmute.][46012] This provides
2213   some optimisations from LLVM.
2214 - [Copied `AsciiExt` methods onto `char`][46077]
2215 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
2216 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
2217 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
2218 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
2219
2220 Stabilized APIs
2221 ---------------
2222 - [`RefCell::replace`]
2223 - [`RefCell::swap`]
2224 - [`atomic::spin_loop_hint`]
2225
2226 The following functions can now be used in a constant expression.
2227 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
2228
2229 - [`AtomicBool::new`][46287]
2230 - [`AtomicUsize::new`][46287]
2231 - [`AtomicIsize::new`][46287]
2232 - [`AtomicPtr::new`][46287]
2233 - [`Cell::new`][46287]
2234 - [`{integer}::min_value`][46287]
2235 - [`{integer}::max_value`][46287]
2236 - [`mem::size_of`][46287]
2237 - [`mem::align_of`][46287]
2238 - [`ptr::null`][46287]
2239 - [`ptr::null_mut`][46287]
2240 - [`RefCell::new`][46287]
2241 - [`UnsafeCell::new`][46287]
2242
2243 Cargo
2244 -----
2245 - [Added a `workspace.default-members` config that
2246   overrides implied `--all` in virtual workspaces.][cargo/4743]
2247 - [Enable incremental by default on development builds.][cargo/4817] Also added
2248   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
2249   per-project or global basis respectively.
2250
2251 Misc
2252 ----
2253
2254 Compatibility Notes
2255 -------------------
2256 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
2257 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
2258   in accordance with IETF RFC 4291 §2.2.
2259 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
2260 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
2261   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
2262 - [Leading zeros in tuple struct members is now an error][47084]
2263 - [`column!()` macro is one-based instead of zero-based][46977]
2264 - [`fmt::Arguments` can no longer be shared across threads][45198]
2265 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
2266 - [Cargo sets a different working directory for the compiler][cargo/4788]
2267
2268 [44884]: https://github.com/rust-lang/rust/pull/44884
2269 [45198]: https://github.com/rust-lang/rust/pull/45198
2270 [45506]: https://github.com/rust-lang/rust/pull/45506
2271 [45904]: https://github.com/rust-lang/rust/pull/45904
2272 [45990]: https://github.com/rust-lang/rust/pull/45990
2273 [46012]: https://github.com/rust-lang/rust/pull/46012
2274 [46077]: https://github.com/rust-lang/rust/pull/46077
2275 [46094]: https://github.com/rust-lang/rust/pull/46094
2276 [46284]: https://github.com/rust-lang/rust/pull/46284
2277 [46287]: https://github.com/rust-lang/rust/pull/46287
2278 [46293]: https://github.com/rust-lang/rust/pull/46293
2279 [46528]: https://github.com/rust-lang/rust/pull/46528
2280 [46671]: https://github.com/rust-lang/rust/pull/46671
2281 [46713]: https://github.com/rust-lang/rust/pull/46713
2282 [46735]: https://github.com/rust-lang/rust/pull/46735
2283 [46749]: https://github.com/rust-lang/rust/pull/46749
2284 [46760]: https://github.com/rust-lang/rust/pull/46760
2285 [46798]: https://github.com/rust-lang/rust/pull/46798
2286 [46828]: https://github.com/rust-lang/rust/pull/46828
2287 [46831]: https://github.com/rust-lang/rust/pull/46831
2288 [46833]: https://github.com/rust-lang/rust/pull/46833
2289 [46910]: https://github.com/rust-lang/rust/pull/46910
2290 [46977]: https://github.com/rust-lang/rust/pull/46977
2291 [47018]: https://github.com/rust-lang/rust/pull/47018
2292 [47080]: https://github.com/rust-lang/rust/pull/47080
2293 [47084]: https://github.com/rust-lang/rust/pull/47084
2294 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
2295 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
2296 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
2297 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
2298 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
2299 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
2300
2301
2302 Version 1.23.0 (2018-01-04)
2303 ==========================
2304
2305 Language
2306 --------
2307 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
2308 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
2309   Which should fix some confusing errors in some operations.
2310
2311 Compiler
2312 --------
2313 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
2314   undefined behavior.][45920]
2315 - [rustc now suggests renaming import if names clash.][45660]
2316 - [Display errors/warnings correctly when there are zero-width or
2317   wide characters.][45711]
2318 - [rustc now avoids unnecessary copies of arguments that are
2319   simple bindings][45380] This should improve memory usage on average by 5-10%.
2320 - [Updated musl used to build musl rustc to 1.1.17][45393]
2321
2322 Libraries
2323 ---------
2324 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
2325 - [Implement Hash for raw pointers to unsized types][45483]
2326 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
2327 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
2328 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
2329 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
2330   and `<*mut T>::as_mut`][44932]
2331 - [Optimized `Thread::{park, unpark}` implementation][45524]
2332 - [Improved `SliceExt::binary_search` performance.][45333]
2333 - [impl `FromIterator<()>` for `()`][45379]
2334 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
2335   is now deprecated.
2336
2337 Stabilized APIs
2338 ---------------
2339
2340 Cargo
2341 -----
2342 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
2343   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
2344 - [Added unit test checking to `cargo check`][cargo/4592]
2345 - [Cargo now lets you install a specific version
2346   using `cargo install --version`][cargo/4637]
2347
2348 Misc
2349 ----
2350 - [Releases now ship with the Cargo book documentation.][45692]
2351 - [rustdoc now prints rendering warnings on every run.][45324]
2352
2353 Compatibility Notes
2354 -------------------
2355 - [Changes have been made to type equality to make it more correct,
2356   in rare cases this could break some code.][45853] [Tracking issue for
2357   further information][45852]
2358 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
2359 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
2360   Android 9, the minimum supported version is Android 14.
2361 - [Bumped the minimum LLVM to 3.9][45326]
2362
2363 [44042]: https://github.com/rust-lang/rust/pull/44042
2364 [44932]: https://github.com/rust-lang/rust/pull/44932
2365 [45267]: https://github.com/rust-lang/rust/pull/45267
2366 [45324]: https://github.com/rust-lang/rust/pull/45324
2367 [45326]: https://github.com/rust-lang/rust/pull/45326
2368 [45333]: https://github.com/rust-lang/rust/pull/45333
2369 [45379]: https://github.com/rust-lang/rust/pull/45379
2370 [45380]: https://github.com/rust-lang/rust/pull/45380
2371 [45393]: https://github.com/rust-lang/rust/pull/45393
2372 [45435]: https://github.com/rust-lang/rust/pull/45435
2373 [45483]: https://github.com/rust-lang/rust/pull/45483
2374 [45524]: https://github.com/rust-lang/rust/pull/45524
2375 [45571]: https://github.com/rust-lang/rust/pull/45571
2376 [45580]: https://github.com/rust-lang/rust/pull/45580
2377 [45610]: https://github.com/rust-lang/rust/pull/45610
2378 [45660]: https://github.com/rust-lang/rust/pull/45660
2379 [45692]: https://github.com/rust-lang/rust/pull/45692
2380 [45711]: https://github.com/rust-lang/rust/pull/45711
2381 [45772]: https://github.com/rust-lang/rust/pull/45772
2382 [45852]: https://github.com/rust-lang/rust/issues/45852
2383 [45853]: https://github.com/rust-lang/rust/pull/45853
2384 [45887]: https://github.com/rust-lang/rust/pull/45887
2385 [45920]: https://github.com/rust-lang/rust/pull/45920
2386 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
2387 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
2388 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
2389
2390
2391 Version 1.22.1 (2017-11-22)
2392 ==========================
2393
2394 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
2395
2396 [46183]: https://github.com/rust-lang/rust/pull/46183
2397
2398 Version 1.22.0 (2017-11-22)
2399 ==========================
2400
2401 Language
2402 --------
2403 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
2404 - [Now accepts underscores in unicode escapes][43716]
2405 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
2406 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
2407
2408 Compiler
2409 --------
2410 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
2411 - [rustc will no longer inline in codegen units when compiling for debug][45075]
2412   This should decrease compile times for debug builds.
2413 - [strict memory alignment now enabled on ARMv6][45094]
2414 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
2415
2416 Libraries
2417 ---------
2418 - [Allow atomic operations up to 32 bits
2419   on `armv5te_unknown_linux_gnueabi`][44978]
2420 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
2421 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
2422 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
2423 - [Properly detect overflow in `Instant += Duration`.][44220]
2424 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
2425 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
2426 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
2427
2428 Stabilized APIs
2429 ---------------
2430
2431 Cargo
2432 -----
2433 - [Cargo will now build multi file examples in subdirectories of the `examples`
2434   folder that have a `main.rs` file.][cargo/4496]
2435 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
2436   the old format will continue to work and can be updated with `cargo update`.
2437 - [Now supports vendoring git repositories][cargo/3992]
2438
2439 Misc
2440 ----
2441 - [`libbacktrace` is now available on Apple platforms.][44251]
2442 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
2443   This now lets you specify that a given code example will fail to compile.
2444
2445 Compatibility Notes
2446 -------------------
2447 - [The minimum Android version that rustc can build for has been bumped
2448   to `4.0` from `2.3`][45656]
2449 - [Allowing `T op= &T` for numeric types has broken some type
2450   inference cases][45480]
2451
2452
2453 [42526]: https://github.com/rust-lang/rust/pull/42526
2454 [43017]: https://github.com/rust-lang/rust/pull/43017
2455 [43716]: https://github.com/rust-lang/rust/pull/43716
2456 [43949]: https://github.com/rust-lang/rust/pull/43949
2457 [44015]: https://github.com/rust-lang/rust/pull/44015
2458 [44220]: https://github.com/rust-lang/rust/pull/44220
2459 [44251]: https://github.com/rust-lang/rust/pull/44251
2460 [44287]: https://github.com/rust-lang/rust/pull/44287
2461 [44303]: https://github.com/rust-lang/rust/pull/44303
2462 [44456]: https://github.com/rust-lang/rust/pull/44456
2463 [44466]: https://github.com/rust-lang/rust/pull/44466
2464 [44895]: https://github.com/rust-lang/rust/pull/44895
2465 [44966]: https://github.com/rust-lang/rust/pull/44966
2466 [44978]: https://github.com/rust-lang/rust/pull/44978
2467 [45041]: https://github.com/rust-lang/rust/pull/45041
2468 [45064]: https://github.com/rust-lang/rust/pull/45064
2469 [45075]: https://github.com/rust-lang/rust/pull/45075
2470 [45094]: https://github.com/rust-lang/rust/pull/45094
2471 [45095]: https://github.com/rust-lang/rust/pull/45095
2472 [45480]: https://github.com/rust-lang/rust/issues/45480
2473 [45656]: https://github.com/rust-lang/rust/pull/45656
2474 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
2475 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
2476 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
2477
2478
2479
2480
2481
2482
2483 Version 1.21.0 (2017-10-12)
2484 ==========================
2485
2486 Language
2487 --------
2488 - [You can now use static references for literals.][43838]
2489   Example:
2490   ```rust
2491   fn main() {
2492       let x: &'static u32 = &0;
2493   }
2494   ```
2495 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
2496   Example:
2497   ```rust
2498   my_macro!(Vec<i32>::new); // Always worked
2499   my_macro!(Vec::<i32>::new); // Now works
2500   ```
2501
2502 Compiler
2503 --------
2504 - [Upgraded jemalloc to 4.5.0][43911]
2505 - [Enabled unwinding panics on Redox][43917]
2506 - [Now runs LLVM in parallel during translation phase.][43506]
2507   This should reduce peak memory usage.
2508
2509 Libraries
2510 ---------
2511 - [Generate builtin impls for `Clone` for all arrays and tuples that
2512   are `T: Clone`][43690]
2513 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
2514 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
2515   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
2516
2517 Stabilized APIs
2518 ---------------
2519
2520 [`std::mem::discriminant`]
2521
2522 Cargo
2523 -----
2524 - [You can now call `cargo install` with multiple package names][cargo/4216]
2525 - [Cargo commands inside a virtual workspace will now implicitly
2526   pass `--all`][cargo/4335]
2527 - [Added a `[patch]` section to `Cargo.toml` to handle
2528   prepublication dependencies][cargo/4123] [RFC 1969]
2529 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
2530   like patterns][cargo/4270]
2531 - [Added the `--all-targets` option][cargo/4400]
2532 - [Using required dependencies as a feature is now deprecated and emits
2533   a warning][cargo/4364]
2534
2535
2536 Misc
2537 ----
2538 - [Cargo docs are moving][43916]
2539   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
2540 - [The rustdoc book is now available][43863]
2541   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
2542 - [Added a preview of RLS has been made available through rustup][44204]
2543   Install with `rustup component add rls-preview`
2544 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
2545   Previously only showed `std::os::unix`.
2546
2547 Compatibility Notes
2548 -------------------
2549 - [Changes in method matching against higher-ranked types][43880] This may cause
2550   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
2551 - [rustc's JSON error output's byte position start at top of file.][42973]
2552   Was previously relative to the rustc's internal `CodeMap` struct which
2553   required the unstable library `libsyntax` to correctly use.
2554 - [`unused_results` lint no longer ignores booleans][43728]
2555
2556 [42565]: https://github.com/rust-lang/rust/pull/42565
2557 [42973]: https://github.com/rust-lang/rust/pull/42973
2558 [43348]: https://github.com/rust-lang/rust/pull/43348
2559 [43459]: https://github.com/rust-lang/rust/pull/43459
2560 [43506]: https://github.com/rust-lang/rust/pull/43506
2561 [43540]: https://github.com/rust-lang/rust/pull/43540
2562 [43690]: https://github.com/rust-lang/rust/pull/43690
2563 [43728]: https://github.com/rust-lang/rust/pull/43728
2564 [43838]: https://github.com/rust-lang/rust/pull/43838
2565 [43863]: https://github.com/rust-lang/rust/pull/43863
2566 [43880]: https://github.com/rust-lang/rust/pull/43880
2567 [43911]: https://github.com/rust-lang/rust/pull/43911
2568 [43916]: https://github.com/rust-lang/rust/pull/43916
2569 [43917]: https://github.com/rust-lang/rust/pull/43917
2570 [44204]: https://github.com/rust-lang/rust/pull/44204
2571 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
2572 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
2573 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
2574 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
2575 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
2576 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
2577 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
2578 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
2579 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
2580
2581 Version 1.20.0 (2017-08-31)
2582 ===========================
2583
2584 Language
2585 --------
2586 - [Associated constants are now stabilised.][42809]
2587 - [A lot of macro bugs are now fixed.][42913]
2588
2589 Compiler
2590 --------
2591
2592 - [Struct fields are now properly coerced to the expected field type.][42807]
2593 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
2594   `wasm32-experimental-emscripten` target.
2595 - [Changed some of the error messages to be more helpful.][42033]
2596 - [Add support for RELRO(RELocation Read-Only) for platforms that support
2597   it.][43170]
2598 - [rustc now reports the total number of errors on compilation failure][43015]
2599   previously this was only the number of errors in the pass that failed.
2600 - [Expansion in rustc has been sped up 29x.][42533]
2601 - [added `msp430-none-elf` target.][43099]
2602 - [rustc will now suggest one-argument enum variant to fix type mismatch when
2603   applicable][43178]
2604 - [Fixes backtraces on Redox][43228]
2605 - [rustc now identifies different versions of same crate when absolute paths of
2606   different types match in an error message.][42826]
2607
2608 Libraries
2609 ---------
2610
2611
2612 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
2613 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
2614   tuples.][43011]
2615 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
2616   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
2617 - [Impl `Clone` for `DefaultHasher`.][42799]
2618 - [Impl `Sync` for `SyncSender`.][42397]
2619 - [Impl `FromStr` for `char`][42271]
2620 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
2621   NaN.][42431]
2622 - [allow messages in the `unimplemented!()` macro.][42155]
2623   ie. `unimplemented!("Waiting for 1.21 to be stable")`
2624 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
2625 - [Upgrade to Unicode 10.0.0][42999]
2626 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
2627 - [Skip the main thread's manual stack guard on Linux][43072]
2628 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
2629 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
2630   previously 2^15.
2631 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
2632
2633 Stabilized APIs
2634 ---------------
2635
2636 - [`CStr::into_c_string`]
2637 - [`CString::as_c_str`]
2638 - [`CString::into_boxed_c_str`]
2639 - [`Chain::get_mut`]
2640 - [`Chain::get_ref`]
2641 - [`Chain::into_inner`]
2642 - [`Option::get_or_insert_with`]
2643 - [`Option::get_or_insert`]
2644 - [`OsStr::into_os_string`]
2645 - [`OsString::into_boxed_os_str`]
2646 - [`Take::get_mut`]
2647 - [`Take::get_ref`]
2648 - [`Utf8Error::error_len`]
2649 - [`char::EscapeDebug`]
2650 - [`char::escape_debug`]
2651 - [`compile_error!`]
2652 - [`f32::from_bits`]
2653 - [`f32::to_bits`]
2654 - [`f64::from_bits`]
2655 - [`f64::to_bits`]
2656 - [`mem::ManuallyDrop`]
2657 - [`slice::sort_unstable_by_key`]
2658 - [`slice::sort_unstable_by`]
2659 - [`slice::sort_unstable`]
2660 - [`str::from_boxed_utf8_unchecked`]
2661 - [`str::as_bytes_mut`]
2662 - [`str::as_bytes_mut`]
2663 - [`str::from_utf8_mut`]
2664 - [`str::from_utf8_unchecked_mut`]
2665 - [`str::get_mut`]
2666 - [`str::get_unchecked_mut`]
2667 - [`str::get_unchecked`]
2668 - [`str::get`]
2669 - [`str::into_boxed_bytes`]
2670
2671
2672 Cargo
2673 -----
2674 - [Cargo API token location moved from `~/.cargo/config` to
2675   `~/.cargo/credentials`.][cargo/3978]
2676 - [Cargo will now build `main.rs` binaries that are in sub-directories of
2677   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
2678   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
2679 - [You can now specify version of a binary when installed through
2680   `cargo install` using `--vers`.][cargo/4229]
2681 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
2682   failure.][cargo/4248]
2683 - [Changed the convention around which file is the crate root.][cargo/4259]
2684 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
2685   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
2686
2687 Compatibility Notes
2688 -------------------
2689
2690 - [Functions with `'static` in their return types will now not be as usable as
2691   if they were using lifetime parameters instead.][42417]
2692 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
2693   takes the sign of NaN into account where previously didn't.][42430]
2694
2695 [42033]: https://github.com/rust-lang/rust/pull/42033
2696 [42155]: https://github.com/rust-lang/rust/pull/42155
2697 [42271]: https://github.com/rust-lang/rust/pull/42271
2698 [42397]: https://github.com/rust-lang/rust/pull/42397
2699 [42417]: https://github.com/rust-lang/rust/pull/42417
2700 [42430]: https://github.com/rust-lang/rust/pull/42430
2701 [42431]: https://github.com/rust-lang/rust/pull/42431
2702 [42533]: https://github.com/rust-lang/rust/pull/42533
2703 [42571]: https://github.com/rust-lang/rust/pull/42571
2704 [42613]: https://github.com/rust-lang/rust/pull/42613
2705 [42799]: https://github.com/rust-lang/rust/pull/42799
2706 [42807]: https://github.com/rust-lang/rust/pull/42807
2707 [42809]: https://github.com/rust-lang/rust/pull/42809
2708 [42822]: https://github.com/rust-lang/rust/pull/42822
2709 [42826]: https://github.com/rust-lang/rust/pull/42826
2710 [42854]: https://github.com/rust-lang/rust/pull/42854
2711 [42913]: https://github.com/rust-lang/rust/pull/42913
2712 [42999]: https://github.com/rust-lang/rust/pull/42999
2713 [43011]: https://github.com/rust-lang/rust/pull/43011
2714 [43015]: https://github.com/rust-lang/rust/pull/43015
2715 [43072]: https://github.com/rust-lang/rust/pull/43072
2716 [43077]: https://github.com/rust-lang/rust/pull/43077
2717 [43097]: https://github.com/rust-lang/rust/pull/43097
2718 [43099]: https://github.com/rust-lang/rust/pull/43099
2719 [43170]: https://github.com/rust-lang/rust/pull/43170
2720 [43178]: https://github.com/rust-lang/rust/pull/43178
2721 [43185]: https://github.com/rust-lang/rust/pull/43185
2722 [43228]: https://github.com/rust-lang/rust/pull/43228
2723 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
2724 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
2725 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
2726 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
2727 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
2728 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
2729 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
2730 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
2731 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
2732 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
2733 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
2734 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
2735 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
2736 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
2737 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
2738 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
2739 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
2740 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
2741 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
2742 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
2743 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
2744 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
2745 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
2746 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
2747 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
2748 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
2749 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
2750 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
2751 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
2752 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
2753 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
2754 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
2755 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
2756 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
2757 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
2758 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
2759 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
2760 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
2761 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
2762
2763
2764 Version 1.19.0 (2017-07-20)
2765 ===========================
2766
2767 Language
2768 --------
2769
2770 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
2771   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
2772 - [Macro recursion limit increased to 1024 from 64.][41676]
2773 - [Added lint for detecting unused macros.][41907]
2774 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
2775   For example: `let x = loop { break 7; };`
2776 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
2777   contain `Copy` types and cannot have a `Drop` implementation.
2778   Example: `union Foo { bar: u8, baz: usize }`
2779 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
2780   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
2781
2782 Compiler
2783 --------
2784
2785 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
2786 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
2787   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
2788   you should use `--target armv7-linux-androideabi`.
2789 - [Fixed ICE when removing a source file between compilation sessions.][41873]
2790 - [Minor optimisation of string operations.][42037]
2791 - [Compiler error message is now `aborting due to previous error(s)` instead of
2792   `aborting due to N previous errors`][42150] This was previously inaccurate and
2793   would only count certain kinds of errors.
2794 - [The compiler now supports Visual Studio 2017][42225]
2795 - [The compiler is now built against LLVM 4.0.1 by default][42948]
2796 - [Added a lot][42264] of [new error codes][42302]
2797 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
2798   libraries with C Run-time Libraries(CRT) to be statically linked.
2799 - [Fixed various ARM codegen bugs][42740]
2800
2801 Libraries
2802 ---------
2803
2804 - [`String` now implements `FromIterator<Cow<'a, str>>` and
2805   `Extend<Cow<'a, str>>`][41449]
2806 - [`Vec` now implements `From<&mut [T]>`][41530]
2807 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
2808 - [`SplitWhitespace` now implements `Clone`][41659]
2809 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
2810   1.5x faster][41764]
2811 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
2812   macros, but for printing to stderr.
2813
2814 Stabilized APIs
2815 ---------------
2816
2817 - [`OsString::shrink_to_fit`]
2818 - [`cmp::Reverse`]
2819 - [`Command::envs`]
2820 - [`thread::ThreadId`]
2821
2822 Cargo
2823 -----
2824
2825 - [Build scripts can now add environment variables to the environment
2826   the crate is being compiled in.
2827   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
2828 - [Subcommands now replace the current process rather than spawning a new
2829   child process][cargo/3970]
2830 - [Workspace members can now accept glob file patterns][cargo/3979]
2831 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
2832   the members in a given workspace.][cargo/3988]
2833 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
2834 - [Target directory path is now in the cargo metadata][cargo/4022]
2835 - [Cargo no longer checks out a local working directory for the
2836   crates.io index][cargo/4026] This should provide smaller file size for the
2837   registry, and improve cloning times, especially on Windows machines.
2838 - [Added an `--exclude` option for excluding certain packages when using the
2839   `--all` option][cargo/4031]
2840 - [Cargo will now automatically retry when receiving a 5xx error
2841   from crates.io][cargo/4032]
2842 - [The `--features` option now accepts multiple comma or space
2843   delimited values.][cargo/4084]
2844 - [Added support for custom target specific runners][cargo/3954]
2845
2846 Misc
2847 ----
2848
2849 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
2850   Windows Debugger.
2851 - [Rust will now release XZ compressed packages][rust-installer/57]
2852 - [rustup will now prefer to download rust packages with
2853   XZ compression][rustup/1100] over GZip packages.
2854 - [Added the ability to escape `#` in rust documentation][41785] By adding
2855   additional `#`'s ie. `##` is now `#`
2856
2857 Compatibility Notes
2858 -------------------
2859
2860 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
2861 - [`-Z` flags are now no longer allowed to be used on the stable
2862   compiler.][41751] This has been a warning for a year previous to this.
2863 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
2864   longer works][42844]. Users should migrate to the built-in `check`
2865   command, which has been available since 1.16.
2866 - [Ending a float literal with `._` is now a hard error.
2867   Example: `42._` .][41946]
2868 - [Any use of a private `extern crate` outside of its module is now a
2869   hard error.][36886] This was previously a warning.
2870 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
2871   relative while the `::` prefix makes a path absolute, but was ignored and the
2872   path was relative regardless.
2873 - [Floating point constants in match patterns is now a hard error][36890]
2874   This was previously a warning.
2875 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
2876   match patterns is now a hard error][36891] This was previously a warning.
2877 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
2878   a warning.
2879 - [From the pound escape, lines consisting of multiple `#`s are
2880   now visible][41785]
2881 - [It is an error to re-export private enum variants][42460]. This is
2882   known to break a number of crates that depend on an older version of
2883   mustache.
2884 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
2885   to use it to find the linker, and the build will fail where it did
2886   not previously][42607]
2887
2888 [36886]: https://github.com/rust-lang/rust/issues/36886
2889 [36888]: https://github.com/rust-lang/rust/issues/36888
2890 [36890]: https://github.com/rust-lang/rust/issues/36890
2891 [36891]: https://github.com/rust-lang/rust/issues/36891
2892 [36892]: https://github.com/rust-lang/rust/issues/36892
2893 [37406]: https://github.com/rust-lang/rust/issues/37406
2894 [39983]: https://github.com/rust-lang/rust/pull/39983
2895 [41145]: https://github.com/rust-lang/rust/pull/41145
2896 [41192]: https://github.com/rust-lang/rust/pull/41192
2897 [41258]: https://github.com/rust-lang/rust/pull/41258
2898 [41370]: https://github.com/rust-lang/rust/pull/41370
2899 [41449]: https://github.com/rust-lang/rust/pull/41449
2900 [41530]: https://github.com/rust-lang/rust/pull/41530
2901 [41624]: https://github.com/rust-lang/rust/pull/41624
2902 [41656]: https://github.com/rust-lang/rust/pull/41656
2903 [41659]: https://github.com/rust-lang/rust/pull/41659
2904 [41676]: https://github.com/rust-lang/rust/pull/41676
2905 [41751]: https://github.com/rust-lang/rust/pull/41751
2906 [41764]: https://github.com/rust-lang/rust/pull/41764
2907 [41785]: https://github.com/rust-lang/rust/pull/41785
2908 [41873]: https://github.com/rust-lang/rust/pull/41873
2909 [41907]: https://github.com/rust-lang/rust/pull/41907
2910 [41946]: https://github.com/rust-lang/rust/pull/41946
2911 [42016]: https://github.com/rust-lang/rust/pull/42016
2912 [42037]: https://github.com/rust-lang/rust/pull/42037
2913 [42068]: https://github.com/rust-lang/rust/pull/42068
2914 [42150]: https://github.com/rust-lang/rust/pull/42150
2915 [42162]: https://github.com/rust-lang/rust/pull/42162
2916 [42225]: https://github.com/rust-lang/rust/pull/42225
2917 [42264]: https://github.com/rust-lang/rust/pull/42264
2918 [42302]: https://github.com/rust-lang/rust/pull/42302
2919 [42460]: https://github.com/rust-lang/rust/issues/42460
2920 [42607]: https://github.com/rust-lang/rust/issues/42607
2921 [42740]: https://github.com/rust-lang/rust/pull/42740
2922 [42844]: https://github.com/rust-lang/rust/issues/42844
2923 [42948]: https://github.com/rust-lang/rust/pull/42948
2924 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
2925 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
2926 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
2927 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
2928 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
2929 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
2930 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
2931 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
2932 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
2933 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
2934 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
2935 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
2936 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
2937 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
2938 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
2939 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
2940 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
2941 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
2942 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
2943 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
2944 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
2945 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
2946
2947
2948 Version 1.18.0 (2017-06-08)
2949 ===========================
2950
2951 Language
2952 --------
2953
2954 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
2955   make the item visible to just that module tree. Also accepts the keyword
2956   `crate` to make something public to the whole crate but not users of the
2957   library. Example: `pub(crate) mod utils;`. [RFC 1422].
2958 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
2959   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
2960 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
2961   types like `Write + Send`, trailing `+` are now supported in trait objects,
2962   and better error reporting for trait objects starting with `?Sized`.
2963 - [0e+10 is now a valid floating point literal][40589]
2964 - [Now warns if you bind a lifetime parameter to 'static][40734]
2965 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
2966   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
2967   representation in some cases.][40377]
2968
2969 Compiler
2970 --------
2971
2972 - [rustc can now emit mir with `--emit mir`][39891]
2973 - [Improved LLVM IR for trivial functions][40367]
2974 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
2975 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
2976   opportunities found through profiling
2977 - [Improved backtrace formatting when panicking][38165]
2978
2979 Libraries
2980 ---------
2981
2982 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
2983   iterator hasn't been advanced the original `Vec` is reassembled with no actual
2984   iteration or reallocation.
2985 - [Simplified HashMap Bucket interface][40561] provides performance
2986   improvements for iterating and cloning.
2987 - [Specialize Vec::from_elem to use calloc][40409]
2988 - [Fixed Race condition in fs::create_dir_all][39799]
2989 - [No longer caching stdio on Windows][40516]
2990 - [Optimized insertion sort in slice][40807] insertion sort in some cases
2991   2.50%~ faster and in one case now 12.50% faster.
2992 - [Optimized `AtomicBool::fetch_nand`][41143]
2993
2994 Stabilized APIs
2995 ---------------
2996
2997 - [`Child::try_wait`]
2998 - [`HashMap::retain`]
2999 - [`HashSet::retain`]
3000 - [`PeekMut::pop`]
3001 - [`TcpStream::peek`]
3002 - [`UdpSocket::peek`]
3003 - [`UdpSocket::peek_from`]
3004
3005 Cargo
3006 -----
3007
3008 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
3009   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
3010 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
3011 - [Added Android build support][cargo/3885]
3012 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
3013   of a certain type, for example `cargo build --bins` will build all
3014   binaries.
3015 - [Added support for haiku][cargo/3952]
3016
3017 Misc
3018 ----
3019
3020 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
3021 - [Added rust-windbg script for better debugging on Windows][39983]
3022 - [Rust now uses the official cross compiler for NetBSD][40612]
3023 - [rustdoc now accepts `#` at the start of files][40828]
3024 - [Fixed jemalloc support for musl][41168]
3025
3026 Compatibility Notes
3027 -------------------
3028
3029 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
3030   always placed after the sign if it exists and before the digits. With the `#`
3031   flag the zeroes are placed after the prefix and before the digits.
3032 - [Due to the struct field optimisation][40377], using `transmute` on structs
3033   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
3034   always been undefined behavior, but is now more likely to break in practice.
3035 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
3036   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
3037   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
3038 - [Overlapping inherent `impl`s are now a hard error][40728]
3039 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
3040 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
3041   `out.asm` and `out.ll` instead of only one of the filetypes.
3042 - [ calling a function that returns `Self` will no longer work][41805] when
3043   the size of `Self` cannot be statically determined.
3044 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
3045   this has caused a few regressions namely:
3046
3047   - Changed the link order of local static/dynamic libraries (respecting the
3048     order on given rather than having the compiler reorder).
3049   - Changed how MinGW is linked, native code linked to dynamic libraries
3050     may require manually linking to the gcc support library (for the native
3051     code itself)
3052
3053 [38165]: https://github.com/rust-lang/rust/pull/38165
3054 [39799]: https://github.com/rust-lang/rust/pull/39799
3055 [39891]: https://github.com/rust-lang/rust/pull/39891
3056 [39983]: https://github.com/rust-lang/rust/pull/39983
3057 [40043]: https://github.com/rust-lang/rust/pull/40043
3058 [40241]: https://github.com/rust-lang/rust/pull/40241
3059 [40338]: https://github.com/rust-lang/rust/pull/40338
3060 [40367]: https://github.com/rust-lang/rust/pull/40367
3061 [40377]: https://github.com/rust-lang/rust/pull/40377
3062 [40409]: https://github.com/rust-lang/rust/pull/40409
3063 [40516]: https://github.com/rust-lang/rust/pull/40516
3064 [40556]: https://github.com/rust-lang/rust/pull/40556
3065 [40561]: https://github.com/rust-lang/rust/pull/40561
3066 [40589]: https://github.com/rust-lang/rust/pull/40589
3067 [40612]: https://github.com/rust-lang/rust/pull/40612
3068 [40723]: https://github.com/rust-lang/rust/pull/40723
3069 [40728]: https://github.com/rust-lang/rust/pull/40728
3070 [40731]: https://github.com/rust-lang/rust/pull/40731
3071 [40734]: https://github.com/rust-lang/rust/pull/40734
3072 [40805]: https://github.com/rust-lang/rust/pull/40805
3073 [40807]: https://github.com/rust-lang/rust/pull/40807
3074 [40828]: https://github.com/rust-lang/rust/pull/40828
3075 [40870]: https://github.com/rust-lang/rust/pull/40870
3076 [41085]: https://github.com/rust-lang/rust/pull/41085
3077 [41143]: https://github.com/rust-lang/rust/pull/41143
3078 [41168]: https://github.com/rust-lang/rust/pull/41168
3079 [41270]: https://github.com/rust-lang/rust/issues/41270
3080 [41469]: https://github.com/rust-lang/rust/pull/41469
3081 [41805]: https://github.com/rust-lang/rust/issues/41805
3082 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
3083 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
3084 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
3085 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
3086 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
3087 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
3088 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
3089 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
3090 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
3091 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
3092 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
3093 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
3094 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
3095 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
3096
3097
3098 Version 1.17.0 (2017-04-27)
3099 ===========================
3100
3101 Language
3102 --------
3103
3104 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
3105 * [Fields of structs may be initialized without duplicating the field/variable
3106   names][39761]. [RFC 1682]
3107 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
3108 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3109   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
3110   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
3111   `'b`. Soundness fix.
3112 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
3113 * [Static variables may contain references to other statics][40027]
3114
3115 Compiler
3116 --------
3117
3118 * [Exit quickly on only `--emit dep-info`][40336]
3119 * [Make `-C relocation-model` more correctly determine whether the linker
3120   creates a position-independent executable][40245]
3121 * [Add `-C overflow-checks` to directly control whether integer overflow
3122   panics][40037]
3123 * [The rustc type checker now checks items on demand instead of in a single
3124   in-order pass][40008]. This is mostly an internal refactoring in support of
3125   future work, including incremental type checking, but also resolves [RFC
3126   1647], allowing `Self` to appear in `impl` `where` clauses.
3127 * [Optimize vtable loads][39995]
3128 * [Turn off vectorization for Emscripten targets][39990]
3129 * [Provide suggestions for unknown macros imported with `use`][39953]
3130 * [Fix ICEs in path resolution][39939]
3131 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
3132 * [Add clearer error message using `&str + &str`][39116]
3133
3134 Stabilized APIs
3135 ---------------
3136
3137 * [`Arc::into_raw`]
3138 * [`Arc::from_raw`]
3139 * [`Arc::ptr_eq`]
3140 * [`Rc::into_raw`]
3141 * [`Rc::from_raw`]
3142 * [`Rc::ptr_eq`]
3143 * [`Ordering::then`]
3144 * [`Ordering::then_with`]
3145 * [`BTreeMap::range`]
3146 * [`BTreeMap::range_mut`]
3147 * [`collections::Bound`]
3148 * [`process::abort`]
3149 * [`ptr::read_unaligned`]
3150 * [`ptr::write_unaligned`]
3151 * [`Result::expect_err`]
3152 * [`Cell::swap`]
3153 * [`Cell::replace`]
3154 * [`Cell::into_inner`]
3155 * [`Cell::take`]
3156
3157 Libraries
3158 ---------
3159
3160 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
3161 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
3162 * [`String` implements `FromIterator<&char>`][40028]
3163 * `Box` [implements][40009] a number of new conversions:
3164   `From<Box<str>> for String`,
3165   `From<Box<[T]>> for Vec<T>`,
3166   `From<Box<CStr>> for CString`,
3167   `From<Box<OsStr>> for OsString`,
3168   `From<Box<Path>> for PathBuf`,
3169   `Into<Box<str>> for String`,
3170   `Into<Box<[T]>> for Vec<T>`,
3171   `Into<Box<CStr>> for CString`,
3172   `Into<Box<OsStr>> for OsString`,
3173   `Into<Box<Path>> for PathBuf`,
3174   `Default for Box<str>`,
3175   `Default for Box<CStr>`,
3176   `Default for Box<OsStr>`,
3177   `From<&CStr> for Box<CStr>`,
3178   `From<&OsStr> for Box<OsStr>`,
3179   `From<&Path> for Box<Path>`
3180 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
3181 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
3182 * [Slightly optimize `slice::sort`][39538]
3183 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
3184 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
3185   `Box<str>` implements `From<&str>`][39438]
3186 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
3187   `From<(I, u16)> where I: Into<IpAddr>`][39372]
3188 * [`format!` estimates the needed capacity before writing a string][39356]
3189 * [Support unprivileged symlink creation in Windows][38921]
3190 * [`PathBuf` implements `Default`][38764]
3191 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
3192 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
3193   and poor hash functions.
3194
3195 Cargo
3196 -----
3197
3198 * [Add `cargo check --all`][cargo/3731]
3199 * [Add an option to ignore SSL revocation checking][cargo/3699]
3200 * [Add `cargo run --package`][cargo/3691]
3201 * [Add `required_features`][cargo/3667]
3202 * [Assume `build.rs` is a build script][cargo/3664]
3203 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
3204
3205 Misc
3206 ----
3207
3208 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
3209   `rustbook`][39633]
3210 * [The "Unstable Book" documents nightly-only features][ubook]
3211 * [Improve the style of the sidebar in rustdoc output][40265]
3212 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
3213 * [Fix MSP430 breakage due to `i128`][40257]
3214 * [Preliminary Solaris/SPARCv9 support][39903]
3215 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
3216   run without installing the MSVC runtime.
3217 * [`rustdoc --test` includes file names in test names][39788]
3218 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
3219   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
3220 * [Initial support for `aarch64-unknown-freebsd`][39491]
3221 * [Initial support for `i686-unknown-netbsd`][39426]
3222 * [This release no longer includes the old makefile build system][39431]. Rust
3223   is built with a custom build system, written in Rust, and with Cargo.
3224 * [Add Debug implementations for libcollection structs][39002]
3225 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
3226 * [`--test-threads=0` produces an error][38945]
3227 * [`rustup` installs documentation by default][40526]
3228 * [The Rust source includes NatVis visualizations][39843]. These can be used by
3229   WinDbg and Visual Studio to improve the debugging experience.
3230
3231 Compatibility Notes
3232 -------------------
3233
3234 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
3235   workaround, either use MSVC 2015 or run vcvars.bat.
3236 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3237   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
3238   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
3239   fix.
3240 * [`format!` and `Display::to_string` panic if an underlying formatting
3241   implementation returns an error][40117]. Previously the error was silently
3242   ignored. It is incorrect for `write_fmt` to return an error when writing
3243   to a string.
3244 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
3245   crates were marked stable and could be accessed from the stable toolchain.
3246 * [Rust git source no longer includes vendored crates][39728]. Those that need
3247   to build with vendored crates should build from release tarballs.
3248 * [Fix inert attributes from `proc_macro_derives`][39572]
3249 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
3250   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
3251   build system.
3252 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
3253   existing code generally ignores the type of dead-code unless a type-hint is
3254   provided; this can cause surprising inference interactions particularly around
3255   defaulting. The new code uniformly ignores the result type of dead-code.
3256 * [Tuple-struct constructors with private fields are no longer visible][38932]
3257 * [Lifetime parameters that do not appear in the arguments are now considered
3258   early-bound][38897], resolving a soundness bug (#[32330]). The
3259   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
3260   April of 2016.
3261 * [rustdoc: fix doctests with non-feature crate attributes][38161]
3262 * [Make transmuting from fn item types to pointer-sized types a hard
3263   error][34198]
3264
3265 [27787]: https://github.com/rust-lang/rust/issues/27787
3266 [32330]: https://github.com/rust-lang/rust/issues/32330
3267 [34198]: https://github.com/rust-lang/rust/pull/34198
3268 [38161]: https://github.com/rust-lang/rust/pull/38161
3269 [38368]: https://github.com/rust-lang/rust/pull/38368
3270 [38584]: https://github.com/rust-lang/rust/issues/38584
3271 [38661]: https://github.com/rust-lang/rust/pull/38661
3272 [38764]: https://github.com/rust-lang/rust/pull/38764
3273 [38864]: https://github.com/rust-lang/rust/issues/38864
3274 [38897]: https://github.com/rust-lang/rust/pull/38897
3275 [38921]: https://github.com/rust-lang/rust/pull/38921
3276 [38932]: https://github.com/rust-lang/rust/pull/38932
3277 [38945]: https://github.com/rust-lang/rust/pull/38945
3278 [38981]: https://github.com/rust-lang/rust/pull/38981
3279 [39002]: https://github.com/rust-lang/rust/pull/39002
3280 [39116]: https://github.com/rust-lang/rust/pull/39116
3281 [39193]: https://github.com/rust-lang/rust/pull/39193
3282 [39265]: https://github.com/rust-lang/rust/pull/39265
3283 [39356]: https://github.com/rust-lang/rust/pull/39356
3284 [39372]: https://github.com/rust-lang/rust/pull/39372
3285 [39426]: https://github.com/rust-lang/rust/pull/39426
3286 [39431]: https://github.com/rust-lang/rust/pull/39431
3287 [39438]: https://github.com/rust-lang/rust/pull/39438
3288 [39440]: https://github.com/rust-lang/rust/pull/39440
3289 [39485]: https://github.com/rust-lang/rust/pull/39485
3290 [39491]: https://github.com/rust-lang/rust/pull/39491
3291 [39518]: https://github.com/rust-lang/rust/pull/39518
3292 [39538]: https://github.com/rust-lang/rust/pull/39538
3293 [39572]: https://github.com/rust-lang/rust/pull/39572
3294 [39633]: https://github.com/rust-lang/rust/pull/39633
3295 [39642]: https://github.com/rust-lang/rust/pull/39642
3296 [39728]: https://github.com/rust-lang/rust/pull/39728
3297 [39761]: https://github.com/rust-lang/rust/pull/39761
3298 [39788]: https://github.com/rust-lang/rust/pull/39788
3299 [39793]: https://github.com/rust-lang/rust/pull/39793
3300 [39837]: https://github.com/rust-lang/rust/pull/39837
3301 [39843]: https://github.com/rust-lang/rust/pull/39843
3302 [39851]: https://github.com/rust-lang/rust/pull/39851
3303 [39903]: https://github.com/rust-lang/rust/pull/39903
3304 [39939]: https://github.com/rust-lang/rust/pull/39939
3305 [39953]: https://github.com/rust-lang/rust/pull/39953
3306 [39960]: https://github.com/rust-lang/rust/pull/39960
3307 [39990]: https://github.com/rust-lang/rust/pull/39990
3308 [39995]: https://github.com/rust-lang/rust/pull/39995
3309 [40008]: https://github.com/rust-lang/rust/pull/40008
3310 [40009]: https://github.com/rust-lang/rust/pull/40009
3311 [40027]: https://github.com/rust-lang/rust/pull/40027
3312 [40028]: https://github.com/rust-lang/rust/pull/40028
3313 [40037]: https://github.com/rust-lang/rust/pull/40037
3314 [40117]: https://github.com/rust-lang/rust/pull/40117
3315 [40166]: https://github.com/rust-lang/rust/pull/40166
3316 [40245]: https://github.com/rust-lang/rust/pull/40245
3317 [40257]: https://github.com/rust-lang/rust/pull/40257
3318 [40261]: https://github.com/rust-lang/rust/pull/40261
3319 [40265]: https://github.com/rust-lang/rust/pull/40265
3320 [40319]: https://github.com/rust-lang/rust/pull/40319
3321 [40336]: https://github.com/rust-lang/rust/pull/40336
3322 [40526]: https://github.com/rust-lang/rust/pull/40526
3323 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
3324 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
3325 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
3326 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
3327 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
3328 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
3329 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
3330 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
3331 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
3332 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
3333 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
3334 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
3335 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
3336 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
3337 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
3338 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
3339 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
3340 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
3341 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
3342 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
3343 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
3344 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
3345 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
3346 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
3347 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
3348 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
3349 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
3350 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
3351 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
3352 [mdbook]: https://crates.io/crates/mdbook
3353 [ubook]: https://doc.rust-lang.org/unstable-book/
3354
3355
3356 Version 1.16.0 (2017-03-16)
3357 ===========================
3358
3359 Language
3360 --------
3361
3362 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3363 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3364   match patterns][38069]
3365 * [Clean up semantics of `self` in an import list][38313]
3366 * [`Self` may appear in `impl` headers][38920]
3367 * [`Self` may appear in struct expressions][39282]
3368
3369 Compiler
3370 --------
3371
3372 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
3373   a `.rmeta` file containing only crate metadata][38571]. This can be
3374   used by tools like the Rust Language Service to perform
3375   metadata-only builds.
3376 * [Levenshtein based typo suggestions now work in most places, while
3377   previously they worked only for fields and sometimes for local
3378   variables][38927]. Together with the overhaul of "no
3379   resolution"/"unexpected resolution" errors (#[38154]) they result in
3380   large and systematic improvement in resolution diagnostics.
3381 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
3382   `U`][38670]
3383 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
3384 * [`rustc` no longer attempts to provide "consider using an explicit
3385   lifetime" suggestions][37057]. They were inaccurate.
3386
3387 Stabilized APIs
3388 ---------------
3389
3390 * [`VecDeque::truncate`]
3391 * [`VecDeque::resize`]
3392 * [`String::insert_str`]
3393 * [`Duration::checked_add`]
3394 * [`Duration::checked_sub`]
3395 * [`Duration::checked_div`]
3396 * [`Duration::checked_mul`]
3397 * [`str::replacen`]
3398 * [`str::repeat`]
3399 * [`SocketAddr::is_ipv4`]
3400 * [`SocketAddr::is_ipv6`]
3401 * [`IpAddr::is_ipv4`]
3402 * [`IpAddr::is_ipv6`]
3403 * [`Vec::dedup_by`]
3404 * [`Vec::dedup_by_key`]
3405 * [`Result::unwrap_or_default`]
3406 * [`<*const T>::wrapping_offset`]
3407 * [`<*mut T>::wrapping_offset`]
3408 * `CommandExt::creation_flags`
3409 * [`File::set_permissions`]
3410 * [`String::split_off`]
3411
3412 Libraries
3413 ---------
3414
3415 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
3416   their argument by `Borrow` parameter][37761]
3417 * [All public types in std implement `Debug`][38006]
3418 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
3419 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
3420 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3421   Windows][38274]
3422 * [std: Fix partial writes in `LineWriter`][38062]
3423 * [std: Clamp max read/write sizes on Unix][38062]
3424 * [Use more specific panic message for `&str` slicing errors][38066]
3425 * [`TcpListener::set_only_v6` is deprecated][38304]. This
3426   functionality cannot be achieved in std currently.
3427 * [`writeln!`, like `println!`, now accepts a form with no string
3428   or formatting arguments, to just print a newline][38469]
3429 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
3430 * [Reduce the size of static data in `std_unicode::tables`][38781]
3431 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
3432   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
3433   `Display`][38909]
3434 * [`Duration` implements `Sum`][38712]
3435 * [`String` implements `ToSocketAddrs`][39048]
3436
3437 Cargo
3438 -----
3439
3440 * [The `cargo check` command does a type check of a project without
3441   building it][cargo/3296]
3442 * [crates.io will display CI badges from Travis and AppVeyor, if
3443   specified in Cargo.toml][cargo/3546]
3444 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
3445 * [Compilation profiles accept integer values for `debug`, in addition
3446   to `true` and `false`. These are passed to `rustc` as the value to
3447   `-C debuginfo`][cargo/3534]
3448 * [Implement `cargo --version --verbose`][cargo/3604]
3449 * [All builds now output 'dep-info' build dependencies compatible with
3450   make and ninja][cargo/3557]
3451 * [Build all workspace members with `build --all`][cargo/3511]
3452 * [Document all workspace members with `doc --all`][cargo/3515]
3453 * [Path deps outside workspace are not members][cargo/3443]
3454
3455 Misc
3456 ----
3457
3458 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
3459   the path to the Rust implementation][38589]
3460 * [The `armv7-linux-androideabi` target no longer enables NEON
3461   extensions, per Google's ABI guide][38413]
3462 * [The stock standard library can be compiled for Redox OS][38401]
3463 * [Rust has initial SPARC support][38726]. Tier 3. No builds
3464   available.
3465 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
3466   builds available.
3467 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
3468
3469 Compatibility Notes
3470 -------------------
3471
3472 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3473   match patterns][38069]
3474 * In this release, references to uninhabited types can not be
3475   pattern-matched. This was accidentally allowed in 1.15.
3476 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3477 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3478   Windows][38274]
3479 * [Clean up semantics of `self` in an import list][38313]
3480 * Reimplemented lifetime elision. This change was almost entirely compatible
3481   with existing code, but it did close a number of small bugs and loopholes,
3482   as well as being more accepting in some other [cases][41105].
3483
3484 [37057]: https://github.com/rust-lang/rust/pull/37057
3485 [37761]: https://github.com/rust-lang/rust/pull/37761
3486 [38006]: https://github.com/rust-lang/rust/pull/38006
3487 [38051]: https://github.com/rust-lang/rust/pull/38051
3488 [38062]: https://github.com/rust-lang/rust/pull/38062
3489 [38062]: https://github.com/rust-lang/rust/pull/38622
3490 [38066]: https://github.com/rust-lang/rust/pull/38066
3491 [38069]: https://github.com/rust-lang/rust/pull/38069
3492 [38131]: https://github.com/rust-lang/rust/pull/38131
3493 [38154]: https://github.com/rust-lang/rust/pull/38154
3494 [38274]: https://github.com/rust-lang/rust/pull/38274
3495 [38304]: https://github.com/rust-lang/rust/pull/38304
3496 [38313]: https://github.com/rust-lang/rust/pull/38313
3497 [38314]: https://github.com/rust-lang/rust/pull/38314
3498 [38327]: https://github.com/rust-lang/rust/pull/38327
3499 [38401]: https://github.com/rust-lang/rust/pull/38401
3500 [38413]: https://github.com/rust-lang/rust/pull/38413
3501 [38469]: https://github.com/rust-lang/rust/pull/38469
3502 [38559]: https://github.com/rust-lang/rust/pull/38559
3503 [38571]: https://github.com/rust-lang/rust/pull/38571
3504 [38580]: https://github.com/rust-lang/rust/pull/38580
3505 [38589]: https://github.com/rust-lang/rust/pull/38589
3506 [38670]: https://github.com/rust-lang/rust/pull/38670
3507 [38712]: https://github.com/rust-lang/rust/pull/38712
3508 [38726]: https://github.com/rust-lang/rust/pull/38726
3509 [38781]: https://github.com/rust-lang/rust/pull/38781
3510 [38798]: https://github.com/rust-lang/rust/pull/38798
3511 [38909]: https://github.com/rust-lang/rust/pull/38909
3512 [38920]: https://github.com/rust-lang/rust/pull/38920
3513 [38927]: https://github.com/rust-lang/rust/pull/38927
3514 [39048]: https://github.com/rust-lang/rust/pull/39048
3515 [39282]: https://github.com/rust-lang/rust/pull/39282
3516 [39379]: https://github.com/rust-lang/rust/pull/39379
3517 [41105]: https://github.com/rust-lang/rust/issues/41105
3518 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
3519 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
3520 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
3521 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
3522 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
3523 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
3524 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
3525 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
3526 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
3527 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
3528 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
3529 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
3530 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
3531 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
3532 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
3533 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
3534 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
3535 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
3536 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
3537 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
3538 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
3539 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
3540 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
3541 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
3542 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
3543 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
3544 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
3545 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
3546 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
3547 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
3548
3549
3550 Version 1.15.1 (2017-02-09)
3551 ===========================
3552
3553 * [Fix IntoIter::as_mut_slice's signature][39466]
3554 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
3555
3556 [39466]: https://github.com/rust-lang/rust/pull/39466
3557 [39523]: https://github.com/rust-lang/rust/pull/39523
3558
3559
3560 Version 1.15.0 (2017-02-02)
3561 ===========================
3562
3563 Language
3564 --------
3565
3566 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
3567   stable. This allows popular code-generating crates like Serde and Diesel to
3568   work ergonomically. [RFC 1681].
3569 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
3570   with curly braces][36868]. Part of [RFC 1506].
3571 * [A number of minor changes to name resolution have been activated][37127].
3572   They add up to more consistent semantics, allowing for future evolution of
3573   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
3574   details of what is different. The breaking changes here have been transitioned
3575   through the [`legacy_imports`] lint since 1.14, with no known regressions.
3576 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
3577   bounds][38279]
3578 * [`?Sized` can be used in `where` clauses][37791]
3579 * [There is now a limit on the size of monomorphized types and it can be
3580   modified with the `#![type_size_limit]` crate attribute, similarly to
3581   the `#![recursion_limit]` attribute][37789]
3582
3583 Compiler
3584 --------
3585
3586 * [On Windows, the compiler will apply dllimport attributes when linking to
3587   extern functions][37973]. Additional attributes and flags can control which
3588   library kind is linked and its name. [RFC 1717].
3589 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
3590 * [The `--test` flag works with procedural macro crates][38107]
3591 * [Fix `extern "aapcs" fn` ABI][37814]
3592 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
3593 * [The `format!` expander recognizes incorrect `printf` and shell-style
3594   formatting directives and suggests the correct format][37613].
3595 * [Only report one error for all unused imports in an import list][37456]
3596
3597 Compiler Performance
3598 --------------------
3599
3600 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
3601 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
3602 * [Don't clone in `UnificationTable::probe`][37848]
3603 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
3604 * [Use small vectors in type walker][37760]
3605 * [Macro expansion performance was improved][37701]
3606 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
3607 * [Replace FNV with a faster hash function][37229]
3608
3609 Stabilized APIs
3610 ---------------
3611
3612 * [`std::iter::Iterator::min_by`]
3613 * [`std::iter::Iterator::max_by`]
3614 * [`std::os::*::fs::FileExt`]
3615 * [`std::sync::atomic::Atomic*::get_mut`]
3616 * [`std::sync::atomic::Atomic*::into_inner`]
3617 * [`std::vec::IntoIter::as_slice`]
3618 * [`std::vec::IntoIter::as_mut_slice`]
3619 * [`std::sync::mpsc::Receiver::try_iter`]
3620 * [`std::os::unix::process::CommandExt::before_exec`]
3621 * [`std::rc::Rc::strong_count`]
3622 * [`std::rc::Rc::weak_count`]
3623 * [`std::sync::Arc::strong_count`]
3624 * [`std::sync::Arc::weak_count`]
3625 * [`std::char::encode_utf8`]
3626 * [`std::char::encode_utf16`]
3627 * [`std::cell::Ref::clone`]
3628 * [`std::io::Take::into_inner`]
3629
3630 Libraries
3631 ---------
3632
3633 * [The standard sorting algorithm has been rewritten for dramatic performance
3634   improvements][38192]. It is a hybrid merge sort, drawing influences from
3635   Timsort. Previously it was a naive merge sort.
3636 * [`Iterator::nth` no longer has a `Sized` bound][38134]
3637 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
3638   performance.
3639 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
3640   and `char_indices().last()`][37882]
3641 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
3642 * [Chinese characters display correctly in `fmt::Debug`][37855]
3643 * [Derive `Default` for `Duration`][37699]
3644 * [Support creation of anonymous pipes on WinXP/2k][37677]
3645 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
3646 * [Don't pass overlapped handles to processes][38835]
3647
3648 Cargo
3649 -----
3650
3651 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
3652   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
3653   should instead check the variable at runtime with `std::env`. That the value
3654   was set at build time was a bug, and incorrect when cross-compiling. This
3655   change is known to cause breakage.
3656 * [Add `--all` flag to `cargo test`][cargo/3221]
3657 * [Compile statically against the MSVC CRT][cargo/3363]
3658 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
3659 * [Link OpenSSL statically on OSX][cargo/3311]
3660 * [Apply new fingerprinting to build dir outputs][cargo/3310]
3661 * [Test for bad path overrides with summaries][cargo/3336]
3662 * [Require `cargo install --vers` to take a semver version][cargo/3338]
3663 * [Fix retrying crate downloads for network errors][cargo/3348]
3664 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
3665 * [Emit more info on --message-format=json][cargo/3319]
3666 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
3667 * [Don't ignore errors in workspace manifest][cargo/3409]
3668 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
3669
3670 Tooling
3671 -------
3672
3673 * [Test runners (binaries built with `--test`) now support a `--list` argument
3674   that lists the tests it contains][38185]
3675 * [Test runners now support a `--exact` argument that makes the test filter
3676   match exactly, instead of matching only a substring of the test name][38181]
3677 * [rustdoc supports a `--playground-url` flag][37763]
3678 * [rustdoc provides more details about `#[should_panic]` errors][37749]
3679
3680 Misc
3681 ----
3682
3683 * [The Rust build system is now written in Rust][37817]. The Makefiles may
3684   continue to be used in this release by passing `--disable-rustbuild` to the
3685   configure script, but they will be deleted soon. Note that the new build
3686   system uses a different on-disk layout that will likely affect any scripts
3687   building Rust.
3688 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
3689   releases.
3690 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
3691 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
3692   releases.
3693
3694 Compatibility Notes
3695 -------------------
3696
3697 * [A number of minor changes to name resolution have been activated][37127].
3698   They add up to more consistent semantics, allowing for future evolution of
3699   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
3700   details of what is different. The breaking changes here have been transitioned
3701   through the [`legacy_imports`] lint since 1.14, with no known regressions.
3702 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
3703   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
3704   should instead check the variable at runtime with `std::env`. That the value
3705   was set at build time was a bug, and incorrect when cross-compiling. This
3706   change is known to cause breakage.
3707 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
3708   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
3709   1.10 and is now an error by default. It will become a hard error in the near
3710   future.
3711 * [The semantics relating modules to file system directories are changing in
3712   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
3713   lint, which is a warning in this release, and will become a hard error in the
3714   future.
3715 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
3716 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
3717   the underlying iterator][37834]
3718
3719 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
3720 [33685]: https://github.com/rust-lang/rust/issues/33685
3721 [36868]: https://github.com/rust-lang/rust/pull/36868
3722 [37127]: https://github.com/rust-lang/rust/pull/37127
3723 [37229]: https://github.com/rust-lang/rust/pull/37229
3724 [37456]: https://github.com/rust-lang/rust/pull/37456
3725 [37527]: https://github.com/rust-lang/rust/pull/37527
3726 [37602]: https://github.com/rust-lang/rust/pull/37602
3727 [37613]: https://github.com/rust-lang/rust/pull/37613
3728 [37615]: https://github.com/rust-lang/rust/pull/37615
3729 [37636]: https://github.com/rust-lang/rust/pull/37636
3730 [37627]: https://github.com/rust-lang/rust/pull/37627
3731 [37642]: https://github.com/rust-lang/rust/pull/37642
3732 [37677]: https://github.com/rust-lang/rust/pull/37677
3733 [37699]: https://github.com/rust-lang/rust/pull/37699
3734 [37701]: https://github.com/rust-lang/rust/pull/37701
3735 [37705]: https://github.com/rust-lang/rust/pull/37705
3736 [37749]: https://github.com/rust-lang/rust/pull/37749
3737 [37760]: https://github.com/rust-lang/rust/pull/37760
3738 [37763]: https://github.com/rust-lang/rust/pull/37763
3739 [37764]: https://github.com/rust-lang/rust/pull/37764
3740 [37789]: https://github.com/rust-lang/rust/pull/37789
3741 [37791]: https://github.com/rust-lang/rust/pull/37791
3742 [37814]: https://github.com/rust-lang/rust/pull/37814
3743 [37817]: https://github.com/rust-lang/rust/pull/37817
3744 [37834]: https://github.com/rust-lang/rust/pull/37834
3745 [37848]: https://github.com/rust-lang/rust/pull/37848
3746 [37855]: https://github.com/rust-lang/rust/pull/37855
3747 [37882]: https://github.com/rust-lang/rust/pull/37882
3748 [37888]: https://github.com/rust-lang/rust/pull/37888
3749 [37973]: https://github.com/rust-lang/rust/pull/37973
3750 [37979]: https://github.com/rust-lang/rust/pull/37979
3751 [38086]: https://github.com/rust-lang/rust/pull/38086
3752 [38107]: https://github.com/rust-lang/rust/pull/38107
3753 [38117]: https://github.com/rust-lang/rust/pull/38117
3754 [38134]: https://github.com/rust-lang/rust/pull/38134
3755 [38146]: https://github.com/rust-lang/rust/pull/38146
3756 [38181]: https://github.com/rust-lang/rust/pull/38181
3757 [38182]: https://github.com/rust-lang/rust/pull/38182
3758 [38185]: https://github.com/rust-lang/rust/pull/38185
3759 [38192]: https://github.com/rust-lang/rust/pull/38192
3760 [38279]: https://github.com/rust-lang/rust/pull/38279
3761 [38835]: https://github.com/rust-lang/rust/pull/38835
3762 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
3763 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3764 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
3765 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
3766 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
3767 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
3768 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
3769 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
3770 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
3771 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
3772 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
3773 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
3774 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
3775 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
3776 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
3777 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
3778 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
3779 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
3780 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
3781 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
3782 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
3783 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
3784 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
3785 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
3786 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
3787 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
3788 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
3789 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
3790 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
3791 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
3792 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
3793 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
3794 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
3795 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
3796 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
3797 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
3798 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
3799 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
3800
3801
3802 Version 1.14.0 (2016-12-22)
3803 ===========================
3804
3805 Language
3806 --------
3807
3808 * [`..` matches multiple tuple fields in enum variants, structs
3809   and tuples][36843]. [RFC 1492].
3810 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
3811 * [`use *` and `use ::*` both glob-import from the crate root][37367]
3812 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
3813   dereferencing][36822]
3814
3815 Compiler
3816 --------
3817
3818 * [Mark enums with non-zero discriminant as non-zero][37224]
3819 * [Lower-case `static mut` names are linted like other
3820   statics and consts][37162]
3821 * [Fix ICE on some macros in const integer positions
3822    (e.g. `[u8; m!()]`)][36819]
3823 * [Improve error message and snippet for "did you mean `x`"][36798]
3824 * [Add a panic-strategy field to the target specification][36794]
3825 * [Include LLVM version in `--version --verbose`][37200]
3826
3827 Compile-time Optimizations
3828 --------------------------
3829
3830 * [Improve macro expansion performance][37569]
3831 * [Shrink `Expr_::ExprInlineAsm`][37445]
3832 * [Replace all uses of SHA-256 with BLAKE2b][37439]
3833 * [Reduce the number of bytes hashed by `IchHasher`][37427]
3834 * [Avoid more allocations when compiling html5ever][37373]
3835 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
3836 * [Avoid some allocations in the macro parser][37318]
3837 * [Use a faster deflate setting][37298]
3838 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
3839   during interning of slices][37270]
3840 * [Optimize `write_metadata`][37267]
3841 * [Don't process obligation forest cycles when stalled][37231]
3842 * [Avoid many `CrateConfig` clones][37161]
3843 * [Optimize `Substs::super_fold_with`][37108]
3844 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
3845 * [Speed up `plug_leaks`][36917]
3846
3847 Libraries
3848 ---------
3849
3850 * [`println!()`, with no arguments, prints newline][36825].
3851   Previously, an empty string was required to achieve the same.
3852 * [`Wrapping` impls standard binary and unary operators, as well as
3853    the `Sum` and `Product` iterators][37356]
3854 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
3855   Vec<T>`][37326]
3856 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
3857   `VecDeque` iterators][37315]
3858 * [Improve `SipHasher` performance on small values][37312]
3859 * [Add Iterator trait TrustedLen to enable better FromIterator /
3860   Extend][37306]
3861 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
3862 * [`ReadDir` implements `Debug`][37221]
3863 * [Implement `RefUnwindSafe` for atomic types][37178]
3864 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
3865 * [Avoid allocations in `Decoder::read_str`][37064]
3866 * [`io::Error` implements `From<io::ErrorKind>`][37037]
3867 * [Impl `Debug` for raw pointers to unsized data][36880]
3868 * [Don't reuse `HashMap` random seeds][37470]
3869 * [The internal memory layout of `HashMap` is more cache-friendly, for
3870   significant improvements in some operations][36692]
3871 * [`HashMap` uses less memory on 32-bit architectures][36595]
3872 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
3873
3874 Cargo
3875 -----
3876
3877 * [Expose rustc cfg values to build scripts][cargo/3243]
3878 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
3879 * [Fix passing --features when testing multiple packages][cargo/3280]
3880 * [Use a single profile set per workspace][cargo/3249]
3881 * [Load `replace` sections from lock files][cargo/3220]
3882 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
3883
3884 Tooling
3885 -------
3886
3887 * [rustup is the recommended Rust installation method][1.14rustup]
3888 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
3889   S390x. These are [tier 2] platforms and may have major defects. Follow the
3890   instructions on the website to install, or add the targets to an existing
3891   installation with `rustup target add`. The new target triples are:
3892   - `mips-unknown-linux-gnu`
3893   - `mipsel-unknown-linux-gnu`
3894   - `mips64-unknown-linux-gnuabi64`
3895   - `mips64el-unknown-linux-gnuabi64 `
3896   - `powerpc-unknown-linux-gnu`
3897   - `powerpc64-unknown-linux-gnu`
3898   - `powerpc64le-unknown-linux-gnu`
3899   - `s390x-unknown-linux-gnu `
3900 * This release includes target (std) builds for ARM Linux running MUSL
3901   libc. These are [tier 2] platforms and may have major defects. Add the
3902   following triples to an existing rustup installation with `rustup target add`:
3903   - `arm-unknown-linux-musleabi`
3904   - `arm-unknown-linux-musleabihf`
3905   - `armv7-unknown-linux-musleabihf`
3906 * This release includes [experimental support for WebAssembly][1.14wasm], via
3907   the `wasm32-unknown-emscripten` target. This target is known to have major
3908   defects. Please test, report, and fix.
3909 * rustup no longer installs documentation by default. Run `rustup
3910   component add rust-docs` to install.
3911 * [Fix line stepping in debugger][37310]
3912 * [Enable line number debuginfo in releases][37280]
3913
3914 Misc
3915 ----
3916
3917 * [Disable jemalloc on aarch64/powerpc/mips][37392]
3918 * [Add support for Fuchsia OS][37313]
3919 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
3920
3921 Compatibility Notes
3922 -------------------
3923
3924 * [A number of forward-compatibility lints used by the compiler
3925   to gradually introduce language changes have been converted
3926   to deny by default][36894]:
3927   - ["use of inaccessible extern crate erroneously allowed"][36886]
3928   - ["type parameter default erroneously allowed in invalid location"][36887]
3929   - ["detects super or self keywords at the beginning of global path"][36888]
3930   - ["two overlapping inherent impls define an item with the same name
3931     were erroneously allowed"][36889]
3932   - ["floating-point constants cannot be used in patterns"][36890]
3933   - ["constants of struct or enum type can only be used in a pattern if
3934      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
3935   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
3936 * [Prohibit patterns in trait methods without bodies][37378]
3937 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
3938 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
3939 * [The `$crate` macro variable is accepted in fewer locations][37213]
3940 * [Impls specifying extra region requirements beyond the trait
3941   they implement are rejected][37167]
3942 * [Enums may not be unsized][37111]. Unsized enums are intended to
3943   work but never have. For now they are forbidden.
3944 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
3945
3946 [tier 2]: https://forge.rust-lang.org/platform-support.html
3947 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
3948 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
3949 [36430]: https://github.com/rust-lang/rust/pull/36430
3950 [36595]: https://github.com/rust-lang/rust/pull/36595
3951 [36595]: https://github.com/rust-lang/rust/pull/36595
3952 [36692]: https://github.com/rust-lang/rust/pull/36692
3953 [36767]: https://github.com/rust-lang/rust/pull/36767
3954 [36794]: https://github.com/rust-lang/rust/pull/36794
3955 [36798]: https://github.com/rust-lang/rust/pull/36798
3956 [36819]: https://github.com/rust-lang/rust/pull/36819
3957 [36822]: https://github.com/rust-lang/rust/pull/36822
3958 [36825]: https://github.com/rust-lang/rust/pull/36825
3959 [36843]: https://github.com/rust-lang/rust/pull/36843
3960 [36880]: https://github.com/rust-lang/rust/pull/36880
3961 [36886]: https://github.com/rust-lang/rust/issues/36886
3962 [36887]: https://github.com/rust-lang/rust/issues/36887
3963 [36888]: https://github.com/rust-lang/rust/issues/36888
3964 [36889]: https://github.com/rust-lang/rust/issues/36889
3965 [36890]: https://github.com/rust-lang/rust/issues/36890
3966 [36891]: https://github.com/rust-lang/rust/issues/36891
3967 [36892]: https://github.com/rust-lang/rust/issues/36892
3968 [36894]: https://github.com/rust-lang/rust/pull/36894
3969 [36917]: https://github.com/rust-lang/rust/pull/36917
3970 [36993]: https://github.com/rust-lang/rust/pull/36993
3971 [37037]: https://github.com/rust-lang/rust/pull/37037
3972 [37064]: https://github.com/rust-lang/rust/pull/37064
3973 [37094]: https://github.com/rust-lang/rust/pull/37094
3974 [37108]: https://github.com/rust-lang/rust/pull/37108
3975 [37111]: https://github.com/rust-lang/rust/pull/37111
3976 [37161]: https://github.com/rust-lang/rust/pull/37161
3977 [37162]: https://github.com/rust-lang/rust/pull/37162
3978 [37167]: https://github.com/rust-lang/rust/pull/37167
3979 [37178]: https://github.com/rust-lang/rust/pull/37178
3980 [37200]: https://github.com/rust-lang/rust/pull/37200
3981 [37213]: https://github.com/rust-lang/rust/pull/37213
3982 [37221]: https://github.com/rust-lang/rust/pull/37221
3983 [37224]: https://github.com/rust-lang/rust/pull/37224
3984 [37230]: https://github.com/rust-lang/rust/pull/37230
3985 [37231]: https://github.com/rust-lang/rust/pull/37231
3986 [37247]: https://github.com/rust-lang/rust/pull/37247
3987 [37267]: https://github.com/rust-lang/rust/pull/37267
3988 [37270]: https://github.com/rust-lang/rust/pull/37270
3989 [37273]: https://github.com/rust-lang/rust/pull/37273
3990 [37280]: https://github.com/rust-lang/rust/pull/37280
3991 [37298]: https://github.com/rust-lang/rust/pull/37298
3992 [37306]: https://github.com/rust-lang/rust/pull/37306
3993 [37310]: https://github.com/rust-lang/rust/pull/37310
3994 [37312]: https://github.com/rust-lang/rust/pull/37312
3995 [37313]: https://github.com/rust-lang/rust/pull/37313
3996 [37315]: https://github.com/rust-lang/rust/pull/37315
3997 [37318]: https://github.com/rust-lang/rust/pull/37318
3998 [37322]: https://github.com/rust-lang/rust/pull/37322
3999 [37326]: https://github.com/rust-lang/rust/pull/37326
4000 [37351]: https://github.com/rust-lang/rust/pull/37351
4001 [37356]: https://github.com/rust-lang/rust/pull/37356
4002 [37367]: https://github.com/rust-lang/rust/pull/37367
4003 [37373]: https://github.com/rust-lang/rust/pull/37373
4004 [37378]: https://github.com/rust-lang/rust/pull/37378
4005 [37389]: https://github.com/rust-lang/rust/pull/37389
4006 [37392]: https://github.com/rust-lang/rust/pull/37392
4007 [37427]: https://github.com/rust-lang/rust/pull/37427
4008 [37439]: https://github.com/rust-lang/rust/pull/37439
4009 [37445]: https://github.com/rust-lang/rust/pull/37445
4010 [37470]: https://github.com/rust-lang/rust/pull/37470
4011 [37569]: https://github.com/rust-lang/rust/pull/37569
4012 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4013 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
4014 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
4015 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
4016 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
4017 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
4018 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
4019
4020
4021 Version 1.13.0 (2016-11-10)
4022 ===========================
4023
4024 Language
4025 --------
4026
4027 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
4028   errors, like the `try!` macro, described in [RFC 0243].
4029 * [Stabilize macros in type position][36014]. Described in [RFC 873].
4030 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
4031 * [Fix `#[derive]` for empty tuple structs/variants][35728]
4032 * [Fix lifetime rules for 'if' conditions][36029]
4033 * [Avoid loading and parsing unconfigured non-inline modules][36482]
4034
4035 Compiler
4036 --------
4037
4038 * [Add the `-C link-arg` argument][36574]
4039 * [Remove the old AST-based backend from rustc_trans][35764]
4040 * [Don't enable NEON by default on armv7 Linux][35814]
4041 * [Fix debug line number info for macro expansions][35238]
4042 * [Do not emit "class method" debuginfo for types that are not
4043   DICompositeType][36008]
4044 * [Warn about multiple conflicting #[repr] hints][34623]
4045 * [When sizing DST, don't double-count nested struct prefixes][36351]
4046 * [Default RUST_MIN_STACK to 16MiB for now][36505]
4047 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
4048 * [Reject macros with empty repetitions to avoid infinite loop][36721]
4049 * [Expand macros without recursing to avoid stack overflows][36214]
4050
4051 Diagnostics
4052 -----------
4053
4054 * [Replace macro backtraces with labeled local uses][35702]
4055 * [Improve error message for misplaced doc comments][33922]
4056 * [Buffer unix and lock windows to prevent message interleaving][35975]
4057 * [Update lifetime errors to specifically note temporaries][36171]
4058 * [Special case a few colors for Windows][36178]
4059 * [Suggest `use self` when such an import resolves][36289]
4060 * [Be more specific when type parameter shadows primitive type][36338]
4061 * Many minor improvements
4062
4063 Compile-time Optimizations
4064 --------------------------
4065
4066 * [Compute and cache HIR hashes at beginning][35854]
4067 * [Don't hash types in loan paths][36004]
4068 * [Cache projections in trans][35761]
4069 * [Optimize the parser's last token handling][36527]
4070 * [Only instantiate #[inline] functions in codegen units referencing
4071   them][36524]. This leads to big improvements in cases where crates export
4072   define many inline functions without using them directly.
4073 * [Lazily allocate TypedArena's first chunk][36592]
4074 * [Don't allocate during default HashSet creation][36734]
4075
4076 Stabilized APIs
4077 ---------------
4078
4079 * [`checked_abs`]
4080 * [`wrapping_abs`]
4081 * [`overflowing_abs`]
4082 * [`RefCell::try_borrow`]
4083 * [`RefCell::try_borrow_mut`]
4084
4085 Libraries
4086 ---------
4087
4088 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
4089 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
4090   covariant][35354]
4091 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
4092 * [Implement `Debug` for `std::vec::IntoIter`][35707]
4093 * [`CString`: avoid excessive growth just to 0-terminate][35871]
4094 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
4095 * [Use arc4rand on FreeBSD][35884]
4096 * [memrchr: Correct aligned offset computation][35969]
4097 * [Improve Demangling of Rust Symbols][36059]
4098 * [Use monotonic time in condition variables][35048]
4099 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
4100 * [Implement conversion traits for `char`][35755]
4101 * [Fix illegal instruction caused by overflow in channel cloning][36104]
4102 * [Zero first byte of CString on drop][36264]
4103 * [Inherit overflow checks for sum and product][36372]
4104 * [Add missing Eq implementations][36423]
4105 * [Implement `Debug` for `DirEntry`][36631]
4106 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
4107   `errno`][36754]
4108 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4109 * [Implement more traits for `std::io::ErrorKind`][35911]
4110 * [Optimize BinaryHeap bounds checking][36072]
4111 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
4112   `extend_with_element`][36355]
4113 * [Fix overflow checking in unsigned pow()][34942]
4114
4115 Cargo
4116 -----
4117
4118 * This release includes security fixes to both curl and OpenSSL.
4119 * [Fix transitive doctests when panic=abort][cargo/3021]
4120 * [Add --all-features flag to cargo][cargo/3038]
4121 * [Reject path-based dependencies in `cargo package`][cargo/3060]
4122 * [Don't parse the home directory more than once][cargo/3078]
4123 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
4124 * [Update OpenSSL to 1.0.2j][cargo/3121]
4125 * [Add license and license_file to cargo metadata output][cargo/3110]
4126 * [Make crates-io registry URL optional in config; ignore all changes to
4127   source.crates-io][cargo/3089]
4128 * [Don't download dependencies from other platforms][cargo/3123]
4129 * [Build transitive dev-dependencies when needed][cargo/3125]
4130 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
4131 * [Avoid updating registry when adding existing deps][cargo/3144]
4132 * [Warn about path overrides that won't work][cargo/3136]
4133 * [Use workspaces during `cargo install`][cargo/3146]
4134 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
4135 * [Add --message-format flag][cargo/3000]
4136 * [Pass target environment for rustdoc][cargo/3205]
4137 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
4138 * [Update curl and curl-sys][cargo/3241]
4139 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
4140
4141 Tooling
4142 -------
4143
4144 * [rustdoc: Add the `--sysroot` argument][36586]
4145 * [rustdoc: Fix a couple of issues with the search results][35655]
4146 * [rustdoc: remove the `!` from macro URLs and titles][35234]
4147 * [gdb: Fix pretty-printing special-cased Rust types][35585]
4148 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
4149
4150 Misc
4151 ----
4152
4153 * [Remove unmaintained style guide][35124]
4154 * [Add s390x support][36369]
4155 * [Initial work at Haiku OS support][36727]
4156 * [Add mips-uclibc targets][35734]
4157 * [Crate-ify compiler-rt into compiler-builtins][35021]
4158 * [Add rustc version info (git hash + date) to dist tarball][36213]
4159 * Many documentation improvements
4160
4161 Compatibility Notes
4162 -------------------
4163
4164 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4165 * [Deny (by default) transmuting from fn item types to pointer-sized
4166   types][34923]. Continuing the long transition to zero-sized fn items,
4167   per [RFC 401].
4168 * [Fix `#[derive]` for empty tuple structs/variants][35728].
4169   Part of [RFC 1506].
4170 * [Issue deprecation warnings for safe accesses to extern statics][36173]
4171 * [Fix lifetime rules for 'if' conditions][36029].
4172 * [Inherit overflow checks for sum and product][36372].
4173 * [Forbid user-defined macros named "macro_rules"][36730].
4174
4175 [33922]: https://github.com/rust-lang/rust/pull/33922
4176 [34623]: https://github.com/rust-lang/rust/pull/34623
4177 [34923]: https://github.com/rust-lang/rust/pull/34923
4178 [34942]: https://github.com/rust-lang/rust/pull/34942
4179 [34982]: https://github.com/rust-lang/rust/pull/34982
4180 [35021]: https://github.com/rust-lang/rust/pull/35021
4181 [35048]: https://github.com/rust-lang/rust/pull/35048
4182 [35074]: https://github.com/rust-lang/rust/pull/35074
4183 [35124]: https://github.com/rust-lang/rust/pull/35124
4184 [35234]: https://github.com/rust-lang/rust/pull/35234
4185 [35238]: https://github.com/rust-lang/rust/pull/35238
4186 [35354]: https://github.com/rust-lang/rust/pull/35354
4187 [35559]: https://github.com/rust-lang/rust/pull/35559
4188 [35585]: https://github.com/rust-lang/rust/pull/35585
4189 [35627]: https://github.com/rust-lang/rust/pull/35627
4190 [35655]: https://github.com/rust-lang/rust/pull/35655
4191 [35702]: https://github.com/rust-lang/rust/pull/35702
4192 [35707]: https://github.com/rust-lang/rust/pull/35707
4193 [35728]: https://github.com/rust-lang/rust/pull/35728
4194 [35734]: https://github.com/rust-lang/rust/pull/35734
4195 [35755]: https://github.com/rust-lang/rust/pull/35755
4196 [35761]: https://github.com/rust-lang/rust/pull/35761
4197 [35764]: https://github.com/rust-lang/rust/pull/35764
4198 [35814]: https://github.com/rust-lang/rust/pull/35814
4199 [35854]: https://github.com/rust-lang/rust/pull/35854
4200 [35871]: https://github.com/rust-lang/rust/pull/35871
4201 [35884]: https://github.com/rust-lang/rust/pull/35884
4202 [35911]: https://github.com/rust-lang/rust/pull/35911
4203 [35969]: https://github.com/rust-lang/rust/pull/35969
4204 [35975]: https://github.com/rust-lang/rust/pull/35975
4205 [36004]: https://github.com/rust-lang/rust/pull/36004
4206 [36008]: https://github.com/rust-lang/rust/pull/36008
4207 [36014]: https://github.com/rust-lang/rust/pull/36014
4208 [36029]: https://github.com/rust-lang/rust/pull/36029
4209 [36059]: https://github.com/rust-lang/rust/pull/36059
4210 [36072]: https://github.com/rust-lang/rust/pull/36072
4211 [36101]: https://github.com/rust-lang/rust/pull/36101
4212 [36104]: https://github.com/rust-lang/rust/pull/36104
4213 [36171]: https://github.com/rust-lang/rust/pull/36171
4214 [36173]: https://github.com/rust-lang/rust/pull/36173
4215 [36178]: https://github.com/rust-lang/rust/pull/36178
4216 [36213]: https://github.com/rust-lang/rust/pull/36213
4217 [36214]: https://github.com/rust-lang/rust/pull/36214
4218 [36264]: https://github.com/rust-lang/rust/pull/36264
4219 [36266]: https://github.com/rust-lang/rust/pull/36266
4220 [36289]: https://github.com/rust-lang/rust/pull/36289
4221 [36338]: https://github.com/rust-lang/rust/pull/36338
4222 [36351]: https://github.com/rust-lang/rust/pull/36351
4223 [36355]: https://github.com/rust-lang/rust/pull/36355
4224 [36369]: https://github.com/rust-lang/rust/pull/36369
4225 [36372]: https://github.com/rust-lang/rust/pull/36372
4226 [36423]: https://github.com/rust-lang/rust/pull/36423
4227 [36482]: https://github.com/rust-lang/rust/pull/36482
4228 [36505]: https://github.com/rust-lang/rust/pull/36505
4229 [36524]: https://github.com/rust-lang/rust/pull/36524
4230 [36527]: https://github.com/rust-lang/rust/pull/36527
4231 [36551]: https://github.com/rust-lang/rust/pull/36551
4232 [36574]: https://github.com/rust-lang/rust/pull/36574
4233 [36586]: https://github.com/rust-lang/rust/pull/36586
4234 [36592]: https://github.com/rust-lang/rust/pull/36592
4235 [36631]: https://github.com/rust-lang/rust/pull/36631
4236 [36639]: https://github.com/rust-lang/rust/pull/36639
4237 [36721]: https://github.com/rust-lang/rust/pull/36721
4238 [36727]: https://github.com/rust-lang/rust/pull/36727
4239 [36730]: https://github.com/rust-lang/rust/pull/36730
4240 [36734]: https://github.com/rust-lang/rust/pull/36734
4241 [36754]: https://github.com/rust-lang/rust/pull/36754
4242 [36995]: https://github.com/rust-lang/rust/pull/36995
4243 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
4244 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
4245 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4246 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
4247 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
4248 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
4249 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
4250 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
4251 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
4252 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
4253 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
4254 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
4255 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
4256 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
4257 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
4258 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
4259 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
4260 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
4261 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
4262 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
4263 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
4264 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
4265 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
4266 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
4267 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
4268 [rustup]: https://www.rustup.rs
4269 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
4270 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
4271 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
4272 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
4273 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
4274 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
4275 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
4276
4277
4278 Version 1.12.1 (2016-10-20)
4279 ===========================
4280
4281 Regression Fixes
4282 ----------------
4283
4284 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
4285 * [Confusion with double negation and booleans][36856]
4286 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
4287 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
4288 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
4289 * [Corrupted memory after updated to 1.12][36936]
4290 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
4291 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
4292 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
4293
4294 [36381]: https://github.com/rust-lang/rust/issues/36381
4295 [36856]: https://github.com/rust-lang/rust/issues/36856
4296 [36875]: https://github.com/rust-lang/rust/issues/36875
4297 [36924]: https://github.com/rust-lang/rust/issues/36924
4298 [36926]: https://github.com/rust-lang/rust/issues/36926
4299 [36936]: https://github.com/rust-lang/rust/issues/36936
4300 [37026]: https://github.com/rust-lang/rust/issues/37026
4301 [37112]: https://github.com/rust-lang/rust/issues/37112
4302 [37153]: https://github.com/rust-lang/rust/issues/37153
4303
4304
4305 Version 1.12.0 (2016-09-29)
4306 ===========================
4307
4308 Highlights
4309 ----------
4310
4311 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4312   This translation pass is far simpler than the previous AST->LLVM pass, and
4313   creates opportunities to perform new optimizations directly on the MIR. It
4314   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4315 * [`rustc` presents a new, more readable error format, along with
4316   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
4317   Most common editors supporting Rust have been updated to work with it. It was
4318   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
4319
4320 Compiler
4321 --------
4322
4323 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4324   This translation pass is far simpler than the previous AST->LLVM pass, and
4325   creates opportunities to perform new optimizations directly on the MIR. It
4326   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4327 * [Print the Rust target name, not the LLVM target name, with
4328   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
4329 * [The computation of `TypeId` is correct in some cases where it was previously
4330   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
4331 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
4332 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
4333   `--print relocation-models`, and `--print code-models` print the available
4334   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
4335   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
4336 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
4337   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
4338   These targets produce statically-linked binaries. There are no binary release
4339   builds yet though.
4340
4341 Diagnostics
4342 -----------
4343
4344 * [`rustc` presents a new, more readable error format, along with
4345   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
4346   Most common editors supporting Rust have been updated to work with it. It was
4347   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
4348 * [In error descriptions, references are now described in plain English,
4349   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
4350 * [In error type descriptions, unknown numeric types are named `{integer}` or
4351   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
4352 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
4353
4354 Language
4355 --------
4356
4357 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
4358 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
4359 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
4360   useful](https://github.com/rust-lang/rust/pull/34908)
4361 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
4362   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
4363 * [Semicolons are properly required as statement delimiters inside
4364   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
4365 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
4366
4367 Stabilized APIs
4368 ---------------
4369
4370 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
4371 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
4372 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
4373 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
4374 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
4375 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
4376 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
4377 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
4378 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
4379 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
4380   Both on Unix and Windows.
4381 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
4382 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
4383 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
4384 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
4385 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
4386 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
4387 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
4388 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
4389
4390 Libraries
4391 ---------
4392
4393 * [The `format!` macro and friends now allow a single argument to be formatted
4394   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
4395 * [The lifetime bounds on `[T]::binary_search_by` and
4396   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
4397 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
4398 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
4399 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
4400 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
4401 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
4402 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
4403 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
4404 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
4405   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
4406 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
4407   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
4408 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
4409 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
4410   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
4411 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
4412 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
4413 * [`mpsc::sync_channel` `Receiver`s return any available message before
4414   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
4415 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
4416 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
4417
4418 Cargo
4419 -----
4420
4421 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
4422 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
4423 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
4424 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
4425 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
4426 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
4427 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
4428 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
4429 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
4430 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
4431 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
4432 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
4433 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
4434 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
4435 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
4436 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
4437
4438 Performance
4439 -----------
4440
4441 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
4442 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
4443
4444 Tooling
4445 -------
4446
4447 * [Test binaries now support a `--test-threads` argument to specify the number
4448   of threads used to run tests, and which acts the same as the
4449   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
4450 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
4451 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
4452 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
4453 * [Rust releases now come with source packages that can be installed by rustup
4454   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
4455   The resulting source code can be used by tools and IDES, located in the
4456   sysroot under `lib/rustlib/src`.
4457
4458 Misc
4459 ----
4460
4461 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
4462 * Many minor improvements to the documentation.
4463 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
4464
4465 Compatibility Notes
4466 -------------------
4467
4468 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
4469   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
4470 * [When formatting strings, if "precision" is specified, the "fill",
4471   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
4472 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
4473
4474
4475 Version 1.11.0 (2016-08-18)
4476 ===========================
4477
4478 Language
4479 --------
4480
4481 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
4482 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
4483 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
4484 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
4485 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
4486
4487 Stabilized APIs
4488 ---------------
4489
4490 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
4491 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
4492 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
4493 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
4494 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
4495 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
4496   (in libcore - previously stabilized in libstd)
4497 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
4498   (in libcore - previously stabilized in libstd)
4499 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
4500   (in libcore - previously stabilized in libstd)
4501 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
4502   (in libcore - previously stabilized in libstd)
4503 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
4504 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
4505 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
4506 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
4507
4508 Libraries
4509 ---------
4510
4511 * [The `thread_local!` macro supports multiple definitions in a single
4512    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
4513 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
4514 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
4515   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
4516 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
4517 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
4518 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
4519 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
4520
4521 Cargo
4522 -----
4523
4524 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
4525 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
4526 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
4527 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
4528 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
4529   and `-vv` prints warnings for all crates.
4530 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
4531 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
4532   This provides room for expansion by arbitrary tools.
4533 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
4534 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
4535 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
4536 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
4537 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
4538 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
4539 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
4540
4541 Performance
4542 -----------
4543
4544 * [Caching projections speeds up type check dramatically for some
4545   workloads](https://github.com/rust-lang/rust/pull/33816)
4546 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
4547   This hasher is faster, but is believed to provide sufficient
4548   protection from collision attacks.
4549 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
4550
4551 Rustdoc
4552 -------
4553
4554 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
4555 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
4556 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
4557 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
4558 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
4559
4560 Tooling
4561 -------
4562
4563 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
4564 * [When emitting debug info, rustc emits frame pointers for closures,
4565   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
4566 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
4567 * Many more errors have been given error codes and extended
4568   explanations
4569 * API documentation continues to be improved, with many new examples
4570
4571 Misc
4572 ----
4573
4574 * [rustc no longer hangs when dependencies recursively re-export
4575   submodules](https://github.com/rust-lang/rust/pull/34542)
4576 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
4577 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
4578   rewritten](https://github.com/rust-lang/rust/pull/33895)
4579 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
4580   No targets use this yet, but it works toward AVR support.
4581
4582 Compatibility Notes
4583 -------------------
4584
4585 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
4586 * [The new follow-set rules that place restrictions on `macro_rules!`
4587   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
4588   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
4589   and has been a warning since 1.10.
4590 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
4591   This causes breakage in some corner cases.
4592
4593
4594 Version 1.10.0 (2016-07-07)
4595 ===========================
4596
4597 Language
4598 --------
4599
4600 * [Allow `concat_idents!` in type positions as well as in expression
4601   positions](https://github.com/rust-lang/rust/pull/33735).
4602 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
4603   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
4604 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
4605 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
4606 * [`panic!` can be converted to a runtime abort with the
4607   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
4608   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
4609 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
4610   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
4611   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
4612   Note that Cargo does not yet directly support cdylibs.
4613
4614 Stabilized APIs
4615 ---------------
4616
4617 * `os::windows::fs::OpenOptionsExt::access_mode`
4618 * `os::windows::fs::OpenOptionsExt::share_mode`
4619 * `os::windows::fs::OpenOptionsExt::custom_flags`
4620 * `os::windows::fs::OpenOptionsExt::attributes`
4621 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
4622 * `os::unix::fs::OpenOptionsExt::custom_flags`
4623 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
4624 * `Default for sync::Weak`
4625 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
4626 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
4627 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
4628 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
4629 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
4630 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
4631 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
4632 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
4633 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
4634 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
4635 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
4636 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
4637 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
4638 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
4639 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
4640 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
4641 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
4642 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
4643 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
4644 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
4645 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
4646 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
4647 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
4648 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
4649 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
4650 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
4651 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
4652 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
4653 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
4654 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
4655 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
4656 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
4657 * Read/Write/RawFd impls for `UnixStream`
4658 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
4659 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
4660 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
4661 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
4662 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
4663 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
4664 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
4665 * RawFd impls for `UnixListener`
4666 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
4667 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
4668 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
4669 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
4670 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
4671 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
4672 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
4673 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
4674 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
4675 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
4676 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
4677 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
4678 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
4679 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
4680 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
4681 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
4682 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
4683 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
4684 * RawFd impls for `UnixDatagram`
4685 * `{BTree,Hash}Map::values_mut`
4686 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
4687
4688 Libraries
4689 ---------
4690
4691 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
4692   The semantics of this minor method are subtle and probably not what
4693   most people want.
4694 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
4695 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
4696   will fall back to `/dev/urandom` temporarily to avoid blocking
4697   during early boot](https://github.com/rust-lang/rust/pull/33086).
4698 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
4699 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
4700 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
4701 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
4702 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
4703 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
4704   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
4705
4706 Cargo
4707 -----
4708 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
4709   This controls the runtime behavior of the `panic!` macro
4710   and can be either "unwind" (the default), or "abort".
4711   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
4712 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
4713 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
4714 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
4715   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
4716 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
4717 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
4718 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
4719   By default they are retried twice, which can be customized with the
4720   `net.retry` value in `.cargo/config`.
4721 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
4722 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
4723 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
4724 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
4725   Makes it possible to install multiple crates in parallel.
4726 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
4727 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
4728 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
4729 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
4730 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
4731 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
4732
4733 Performance
4734 -----------
4735
4736 * [rustc memory usage was reduced by refactoring the context used for
4737   type checking](https://github.com/rust-lang/rust/pull/33425).
4738 * [Speed up creation of `HashMap`s by caching the random keys used
4739   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
4740 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
4741 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
4742 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
4743   10x faster than the previous lookup tables.
4744 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
4745
4746 Usability
4747 ---------
4748
4749 * Many incremental improvements to documentation and rustdoc.
4750 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
4751 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
4752 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
4753 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
4754 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
4755 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
4756 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
4757
4758 Misc
4759 ----
4760
4761 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
4762 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
4763 * [`std` no longer prints backtraces on platforms where the running
4764   module must be loaded with `env::current_exe`, which can't be relied
4765   on](https://github.com/rust-lang/rust/pull/33554).
4766 * This release includes std binaries for the i586-unknown-linux-gnu,
4767   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
4768   i586 target is for old x86 hardware without SSE2, and the armv7
4769   target is for Android running on modern ARM architectures.
4770 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
4771   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
4772 * [On Unix the runtime aborts by calling `libc::abort` instead of
4773   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
4774 * [Rust is now bootstrapped from the previous release of Rust,
4775   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
4776
4777 Compatibility Notes
4778 -------------------
4779
4780 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
4781 * [`target_env` for Linux ARM targets is just `gnu`, not
4782   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
4783 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
4784 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
4785 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
4786   Affects how macros are parsed.
4787 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
4788 * [Feature-gated attributes on macro-generated macro invocations are
4789   now rejected](https://github.com/rust-lang/rust/pull/32791).
4790 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
4791   This caused some minor changes to type inference.
4792
4793
4794 Version 1.9.0 (2016-05-26)
4795 ==========================
4796
4797 Language
4798 --------
4799
4800 * The `#[deprecated]` attribute when applied to an API will generate
4801   warnings when used. The warnings may be suppressed with
4802   `#[allow(deprecated)]`. [RFC 1270].
4803 * [`fn` item types are zero sized, and each `fn` names a unique
4804   type][1.9fn]. This will break code that transmutes `fn`s, so calling
4805   `transmute` on a `fn` type will generate a warning for a few cycles,
4806   then will be converted to an error.
4807 * [Field and method resolution understand visibility, so private
4808   fields and methods cannot prevent the proper use of public fields
4809   and methods][1.9fv].
4810 * [The parser considers unicode codepoints in the
4811   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
4812
4813 Stabilized APIs
4814 ---------------
4815
4816 * [`std::panic`]
4817 * [`std::panic::catch_unwind`][] (renamed from `recover`)
4818 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
4819 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
4820 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
4821 * [`str::is_char_boundary`]
4822 * [`<*const T>::as_ref`]
4823 * [`<*mut T>::as_ref`]
4824 * [`<*mut T>::as_mut`]
4825 * [`AsciiExt::make_ascii_uppercase`]
4826 * [`AsciiExt::make_ascii_lowercase`]
4827 * [`char::decode_utf16`]
4828 * [`char::DecodeUtf16`]
4829 * [`char::DecodeUtf16Error`]
4830 * [`char::DecodeUtf16Error::unpaired_surrogate`]
4831 * [`BTreeSet::take`]
4832 * [`BTreeSet::replace`]
4833 * [`BTreeSet::get`]
4834 * [`HashSet::take`]
4835 * [`HashSet::replace`]
4836 * [`HashSet::get`]
4837 * [`OsString::with_capacity`]
4838 * [`OsString::clear`]
4839 * [`OsString::capacity`]
4840 * [`OsString::reserve`]
4841 * [`OsString::reserve_exact`]
4842 * [`OsStr::is_empty`]
4843 * [`OsStr::len`]
4844 * [`std::os::unix::thread`]
4845 * [`RawPthread`]
4846 * [`JoinHandleExt`]
4847 * [`JoinHandleExt::as_pthread_t`]
4848 * [`JoinHandleExt::into_pthread_t`]
4849 * [`HashSet::hasher`]
4850 * [`HashMap::hasher`]
4851 * [`CommandExt::exec`]
4852 * [`File::try_clone`]
4853 * [`SocketAddr::set_ip`]
4854 * [`SocketAddr::set_port`]
4855 * [`SocketAddrV4::set_ip`]
4856 * [`SocketAddrV4::set_port`]
4857 * [`SocketAddrV6::set_ip`]
4858 * [`SocketAddrV6::set_port`]
4859 * [`SocketAddrV6::set_flowinfo`]
4860 * [`SocketAddrV6::set_scope_id`]
4861 * [`slice::copy_from_slice`]
4862 * [`ptr::read_volatile`]
4863 * [`ptr::write_volatile`]
4864 * [`OpenOptions::create_new`]
4865 * [`TcpStream::set_nodelay`]
4866 * [`TcpStream::nodelay`]
4867 * [`TcpStream::set_ttl`]
4868 * [`TcpStream::ttl`]
4869 * [`TcpStream::set_only_v6`]
4870 * [`TcpStream::only_v6`]
4871 * [`TcpStream::take_error`]
4872 * [`TcpStream::set_nonblocking`]
4873 * [`TcpListener::set_ttl`]
4874 * [`TcpListener::ttl`]
4875 * [`TcpListener::set_only_v6`]
4876 * [`TcpListener::only_v6`]
4877 * [`TcpListener::take_error`]
4878 * [`TcpListener::set_nonblocking`]
4879 * [`UdpSocket::set_broadcast`]
4880 * [`UdpSocket::broadcast`]
4881 * [`UdpSocket::set_multicast_loop_v4`]
4882 * [`UdpSocket::multicast_loop_v4`]
4883 * [`UdpSocket::set_multicast_ttl_v4`]
4884 * [`UdpSocket::multicast_ttl_v4`]
4885 * [`UdpSocket::set_multicast_loop_v6`]
4886 * [`UdpSocket::multicast_loop_v6`]
4887 * [`UdpSocket::set_multicast_ttl_v6`]
4888 * [`UdpSocket::multicast_ttl_v6`]
4889 * [`UdpSocket::set_ttl`]
4890 * [`UdpSocket::ttl`]
4891 * [`UdpSocket::set_only_v6`]
4892 * [`UdpSocket::only_v6`]
4893 * [`UdpSocket::join_multicast_v4`]
4894 * [`UdpSocket::join_multicast_v6`]
4895 * [`UdpSocket::leave_multicast_v4`]
4896 * [`UdpSocket::leave_multicast_v6`]
4897 * [`UdpSocket::take_error`]
4898 * [`UdpSocket::connect`]
4899 * [`UdpSocket::send`]
4900 * [`UdpSocket::recv`]
4901 * [`UdpSocket::set_nonblocking`]
4902
4903 Libraries
4904 ---------
4905
4906 * [`std::sync::Once` is poisoned if its initialization function
4907   fails][1.9o].
4908 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
4909 * [Most types implement `fmt::Debug`][1.9db].
4910 * [The default buffer size used by `BufReader` and `BufWriter` was
4911   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
4912   used by other languages.
4913 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
4914   `Duration` additionally implements `*=` and `/=`][1.9ta].
4915 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
4916 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
4917 * [`Chain` implements `BufRead`][1.9ch].
4918 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
4919
4920 Cargo
4921 -----
4922
4923 * [Cargo can now run concurrently][1.9cc].
4924 * [Top-level overrides allow specific revisions of crates to be
4925   overridden through the entire crate graph][1.9ct].  This is intended
4926   to make upgrades easier for large projects, by allowing crates to be
4927   forked temporarily until they've been upgraded and republished.
4928 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
4929 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
4930   on the commandline][1.9cf]. `rustc` arguments can also be specified
4931   in the `build.rustflags` configuration key.
4932
4933 Performance
4934 -----------
4935
4936 * [The time complexity of comparing variables for equivalence during type
4937   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
4938   to major compilation time improvement in some scenarios.
4939 * [`ToString` is specialized for `str`, giving it the same performance
4940   as `to_owned`][1.9ts].
4941 * [Spawning processes with `Command::output` no longer creates extra
4942   threads][1.9sp].
4943 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
4944   for C-like enums][1.9cl].
4945
4946 Misc
4947 ----
4948
4949 * [Passing the `--quiet` flag to a test runner will produce
4950   much-abbreviated output][1.9q].
4951 * The Rust Project now publishes std binaries for the
4952   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
4953   `i586-pc-windows-msvc` targets.
4954
4955 Compatibility Notes
4956 -------------------
4957
4958 * [`std::sync::Once` is poisoned if its initialization function
4959   fails][1.9o].
4960 * [It is illegal to define methods with the same name in overlapping
4961   inherent `impl` blocks][1.9sn].
4962 * [`fn` item types are zero sized, and each `fn` names a unique
4963   type][1.9fn]. This will break code that transmutes `fn`s, so calling
4964   `transmute` on a `fn` type will generate a warning for a few cycles,
4965   then will be converted to an error.
4966 * [Improvements to const evaluation may trigger new errors when integer
4967   literals are out of range][1.9ce].
4968
4969
4970 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
4971 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
4972 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
4973 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
4974 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
4975 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
4976 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
4977 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
4978 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
4979 [1.9db]: https://github.com/rust-lang/rust/pull/32054
4980 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
4981 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
4982 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
4983 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
4984 [1.9o]: https://github.com/rust-lang/rust/pull/32325
4985 [1.9q]: https://github.com/rust-lang/rust/pull/31887
4986 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
4987 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
4988 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
4989 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
4990 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
4991 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
4992 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
4993 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
4994 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
4995 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
4996 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
4997 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
4998 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
4999 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
5000 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
5001 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
5002 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
5003 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
5004 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
5005 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
5006 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
5007 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
5008 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
5009 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
5010 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
5011 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
5012 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
5013 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
5014 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
5015 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
5016 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
5017 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
5018 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
5019 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
5020 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
5021 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
5022 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
5023 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
5024 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
5025 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
5026 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
5027 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
5028 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
5029 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
5030 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5031 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5032 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5033 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5034 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5035 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5036 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
5037 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5038 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
5039 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5040 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5041 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5042 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5043 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5044 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
5045 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
5046 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
5047 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
5048 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
5049 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
5050 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
5051 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
5052 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
5053 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
5054 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
5055 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
5056 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
5057 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
5058 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
5059 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
5060 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
5061 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
5062 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
5063 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
5064 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
5065 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
5066 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
5067 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
5068 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
5069 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
5070 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
5071 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
5072 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
5073 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
5074 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
5075 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
5076 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
5077 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
5078 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
5079 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
5080
5081
5082 Version 1.8.0 (2016-04-14)
5083 ==========================
5084
5085 Language
5086 --------
5087
5088 * Rust supports overloading of compound assignment statements like
5089   `+=` by implementing the [`AddAssign`], [`SubAssign`],
5090   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
5091   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
5092   traits. [RFC 953].
5093 * Empty structs can be defined with braces, as in `struct Foo { }`, in
5094   addition to the non-braced form, `struct Foo;`. [RFC 218].
5095
5096 Libraries
5097 ---------
5098
5099 * Stabilized APIs:
5100   * [`str::encode_utf16`][] (renamed from `utf16_units`)
5101   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
5102   * [`Ref::map`]
5103   * [`RefMut::map`]
5104   * [`ptr::drop_in_place`]
5105   * [`time::Instant`]
5106   * [`time::SystemTime`]
5107   * [`Instant::now`]
5108   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
5109   * [`Instant::elapsed`]
5110   * [`SystemTime::now`]
5111   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
5112   * [`SystemTime::elapsed`]
5113   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
5114   * [`SystemTimeError`]
5115   * [`SystemTimeError::duration`]
5116   * Various impls for `SystemTimeError`
5117   * [`UNIX_EPOCH`]
5118   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
5119     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
5120     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
5121 * [The `write!` and `writeln!` macros correctly emit errors if any of
5122   their arguments can't be formatted][1.8w].
5123 * [Various I/O functions support large files on 32-bit Linux][1.8l].
5124 * [The Unix-specific `raw` modules, which contain a number of
5125   redefined C types are deprecated][1.8r], including `os::raw::unix`,
5126   `os::raw::macos`, and `os::raw::linux`. These modules defined types
5127   such as `ino_t` and `dev_t`. The inconsistency of these definitions
5128   across platforms was making it difficult to implement `std`
5129   correctly. Those that need these definitions should use the `libc`
5130   crate. [RFC 1415].
5131 * The Unix-specific `MetadataExt` traits, including
5132   `os::unix::fs::MetadataExt`, which expose values such as inode
5133   numbers [no longer return platform-specific types][1.8r], but
5134   instead return widened integers. [RFC 1415].
5135 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
5136 * [Atomic loads and stores are not volatile][1.8a].
5137 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
5138
5139 Performance
5140 -----------
5141
5142 * [Inlining hash functions lead to a 3% compile-time improvement in
5143   some workloads][1.8h].
5144 * When using jemalloc, its symbols are [unprefixed so that it
5145   overrides the libc malloc implementation][1.8h]. This means that for
5146   rustc, LLVM is now using jemalloc, which results in a 6%
5147   compile-time improvement on a specific workload.
5148 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
5149
5150 Misc
5151 ----
5152
5153 * [32-bit MSVC builds finally implement unwinding][1.8ms].
5154   i686-pc-windows-msvc is now considered a tier-1 platform.
5155 * [The `--print targets` flag prints a list of supported targets][1.8t].
5156 * [The `--print cfg` flag prints the `cfg`s defined for the current
5157   target][1.8cf].
5158 * [`rustc` can be built with an new Cargo-based build system, written
5159   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
5160   build system. To enable it configure with `configure --rustbuild`.
5161 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
5162   variants while also indicating the total number of missing variants
5163   if more than 3][1.8m].
5164 * [Executable stacks are disabled on Linux and BSD][1.8nx].
5165 * The Rust Project now publishes binary releases of the standard
5166   library for a number of tier-2 targets:
5167   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
5168   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
5169   `x86_64-rumprun-netbsd`. These can be installed with
5170   tools such as [multirust][1.8mr].
5171
5172 Cargo
5173 -----
5174
5175 * [`cargo init` creates a new Cargo project in the current
5176   directory][1.8ci].  It is otherwise like `cargo new`.
5177 * [Cargo has configuration keys for `-v` and
5178   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
5179   `[term]` section of `.cargo/config`.
5180 * [Configuration keys that evaluate to strings or integers can be set
5181   via environment variables][1.8ce]. For example the `build.jobs` key
5182   can be set via `CARGO_BUILD_JOBS`. Environment variables take
5183   precedence over config files.
5184 * [Target-specific dependencies support Rust `cfg` syntax for
5185   describing targets][1.8cfg] so that dependencies for multiple
5186   targets can be specified together. [RFC 1361].
5187 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
5188   `RUSTDOC` take precedence over the `build.target-dir`,
5189   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
5190 * [The child process tree is killed on Windows when Cargo is
5191   killed][1.8ck].
5192 * [The `build.target` configuration value sets the target platform,
5193   like `--target`][1.8ct].
5194
5195 Compatibility Notes
5196 -------------------
5197
5198 * [Unstable compiler flags have been further restricted][1.8u]. Since
5199   1.0 `-Z` flags have been considered unstable, and other flags that
5200   were considered unstable additionally required passing `-Z
5201   unstable-options` to access. Unlike unstable language and library
5202   features though, these options have been accessible on the stable
5203   release channel. Going forward, *new unstable flags will not be
5204   available on the stable release channel*, and old unstable flags
5205   will warn about their usage. In the future, all unstable flags will
5206   be unavailable on the stable release channel.
5207 * [It is no longer possible to `match` on empty enum variants using
5208   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
5209 * The Unix-specific `MetadataExt` traits, including
5210   `os::unix::fs::MetadataExt`, which expose values such as inode
5211   numbers [no longer return platform-specific types][1.8r], but
5212   instead return widened integers. [RFC 1415].
5213 * [Modules sourced from the filesystem cannot appear within arbitrary
5214   blocks, but only within other modules][1.8mf].
5215 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
5216 * On Unix, [stack overflow triggers a runtime abort instead of a
5217   SIGSEGV][1.8so].
5218 * [`Command::spawn` and its equivalents return an error if any of
5219   its command-line arguments contain interior `NUL`s][1.8n].
5220 * [Tuple and unit enum variants from other crates are in the type
5221   namespace][1.8tn].
5222 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
5223   type instead of `.a` files][1.8st]. Additionally, for the MSVC
5224   toolchain, `rustc` emits import libraries named `foo.dll.lib`
5225   instead of `foo.lib`.
5226
5227
5228 [1.8a]: https://github.com/rust-lang/rust/pull/30962
5229 [1.8b]: https://github.com/rust-lang/rust/pull/31123
5230 [1.8c]: https://github.com/rust-lang/rust/pull/31530
5231 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
5232 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
5233 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
5234 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
5235 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
5236 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
5237 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
5238 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
5239 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
5240 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
5241 [1.8h]: https://github.com/rust-lang/rust/pull/31460
5242 [1.8l]: https://github.com/rust-lang/rust/pull/31668
5243 [1.8m]: https://github.com/rust-lang/rust/pull/31020
5244 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
5245 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
5246 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
5247 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
5248 [1.8n]: https://github.com/rust-lang/rust/pull/31056
5249 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
5250 [1.8r]: https://github.com/rust-lang/rust/pull/31551
5251 [1.8so]: https://github.com/rust-lang/rust/pull/31333
5252 [1.8st]: https://github.com/rust-lang/rust/pull/29520
5253 [1.8t]: https://github.com/rust-lang/rust/pull/31358
5254 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
5255 [1.8u]: https://github.com/rust-lang/rust/pull/31793
5256 [1.8v]: https://github.com/rust-lang/rust/pull/31757
5257 [1.8w]: https://github.com/rust-lang/rust/pull/31904
5258 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
5259 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
5260 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
5261 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
5262 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
5263 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
5264 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
5265 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
5266 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
5267 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
5268 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
5269 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
5270 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
5271 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
5272 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
5273 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
5274 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
5275 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
5276 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
5277 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
5278 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
5279 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
5280 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
5281 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
5282 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
5283 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
5284 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
5285 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
5286 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
5287 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
5288
5289
5290 Version 1.7.0 (2016-03-03)
5291 ==========================
5292
5293 Libraries
5294 ---------
5295
5296 * Stabilized APIs
5297   * `Path`
5298     * [`Path::strip_prefix`][] (renamed from relative_from)
5299     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
5300   * `Ipv4Addr`
5301     * [`Ipv4Addr::is_loopback`]
5302     * [`Ipv4Addr::is_private`]
5303     * [`Ipv4Addr::is_link_local`]
5304     * [`Ipv4Addr::is_multicast`]
5305     * [`Ipv4Addr::is_broadcast`]
5306     * [`Ipv4Addr::is_documentation`]
5307   * `Ipv6Addr`
5308     * [`Ipv6Addr::is_unspecified`]
5309     * [`Ipv6Addr::is_loopback`]
5310     * [`Ipv6Addr::is_multicast`]
5311   * `Vec`
5312     * [`Vec::as_slice`]
5313     * [`Vec::as_mut_slice`]
5314   * `String`
5315     * [`String::as_str`]
5316     * [`String::as_mut_str`]
5317   * Slices
5318     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
5319     be the same length
5320     * `<[T]>::`[`sort_by_key`]
5321   * checked, saturated, and overflowing operations
5322     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
5323     * [`i32::saturating_mul`]
5324     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
5325     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
5326     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
5327     * [`u32::saturating_mul`]
5328     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
5329     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
5330     * and checked, saturated, and overflowing operations for other primitive types
5331   * FFI
5332     * [`ffi::IntoStringError`]
5333     * [`CString::into_string`]
5334     * [`CString::into_bytes`]
5335     * [`CString::into_bytes_with_nul`]
5336     * `From<CString> for Vec<u8>`
5337   * `IntoStringError`
5338     * [`IntoStringError::into_cstring`]
5339     * [`IntoStringError::utf8_error`]
5340     * `Error for IntoStringError`
5341   * Hashing
5342     * [`std::hash::BuildHasher`]
5343     * [`BuildHasher::Hasher`]
5344     * [`BuildHasher::build_hasher`]
5345     * [`std::hash::BuildHasherDefault`]
5346     * [`HashMap::with_hasher`]
5347     * [`HashMap::with_capacity_and_hasher`]
5348     * [`HashSet::with_hasher`]
5349     * [`HashSet::with_capacity_and_hasher`]
5350     * [`std::collections::hash_map::RandomState`]
5351     * [`RandomState::new`]
5352 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
5353   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
5354   from bytes is faster.
5355 * [The performance of `LineWriter` (and thus `io::stdout`) was
5356   improved by using `memchr` to search for newlines][1.7m].
5357 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
5358   `f64` variants were stabilized previously.
5359 * [`BTreeMap` was rewritten to use less memory and improve the performance
5360   of insertion and iteration, the latter by as much as 5x][1.7bm].
5361 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
5362   covariant over their contained type][1.7bt].
5363 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
5364   over their contained type][1.7ll].
5365 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
5366   searching methods.
5367 * [`Any` is implemented for unsized types][1.7a].
5368 * [`Hash` is implemented for `Duration`][1.7h].
5369
5370 Misc
5371 ----
5372
5373 * [When running tests with `--test`, rustdoc will pass `--cfg`
5374   arguments to the compiler][1.7dt].
5375 * [The compiler is built with RPATH information by default][1.7rpa].
5376   This means that it will be possible to run `rustc` when installed in
5377   unusual configurations without configuring the dynamic linker search
5378   path explicitly.
5379 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
5380   any RPATH entries (emitted with `-C rpath`) *not* take precedence
5381   over `LD_LIBRARY_PATH`.
5382
5383 Cargo
5384 -----
5385
5386 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
5387   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
5388 * [The `rerun-if-changed` build script directive no longer causes the
5389   build script to incorrectly run twice in certain scenarios][1.7rr].
5390
5391 Compatibility Notes
5392 -------------------
5393
5394 * Soundness fixes to the interactions between associated types and
5395   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
5396   code that violates the new rules. This is a significant change that
5397   is known to break existing code, so it has emitted warnings for the
5398   new error cases since 1.4 to give crate authors time to adapt. The
5399   details of what is changing are subtle; read the RFC for more.
5400 * [Several bugs in the compiler's visibility calculations were
5401   fixed][1.7v]. Since this was found to break significant amounts of
5402   code, the new errors will be emitted as warnings for several release
5403   cycles, under the `private_in_public` lint.
5404 * Defaulted type parameters were accidentally accepted in positions
5405   that were not intended. In this release, [defaulted type parameters
5406   appearing outside of type definitions will generate a
5407   warning][1.7d], which will become an error in future releases.
5408 * [Parsing "." as a float results in an error instead of 0][1.7p].
5409   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
5410 * [Borrows of closure parameters may not outlive the closure][1.7bc].
5411
5412 [1.7a]: https://github.com/rust-lang/rust/pull/30928
5413 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
5414 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
5415 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
5416 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
5417 [1.7d]: https://github.com/rust-lang/rust/pull/30724
5418 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
5419 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
5420 [1.7f]: https://github.com/rust-lang/rust/pull/30672
5421 [1.7h]: https://github.com/rust-lang/rust/pull/30818
5422 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
5423 [1.7m]: https://github.com/rust-lang/rust/pull/30381
5424 [1.7p]: https://github.com/rust-lang/rust/pull/30681
5425 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
5426 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
5427 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
5428 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
5429 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
5430 [1.7v]: https://github.com/rust-lang/rust/pull/29973
5431 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5432 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5433 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
5434 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
5435 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
5436 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
5437 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
5438 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
5439 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
5440 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
5441 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
5442 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
5443 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
5444 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
5445 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
5446 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
5447 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
5448 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
5449 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
5450 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
5451 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
5452 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
5453 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
5454 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
5455 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
5456 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
5457 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
5458 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
5459 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
5460 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
5461 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
5462 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
5463 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
5464 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
5465 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
5466 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
5467 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
5468 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
5469 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
5470 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
5471 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
5472 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
5473 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
5474 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
5475 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
5476 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
5477 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
5478 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5479 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
5480 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5481 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
5482 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
5483 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
5484 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
5485 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
5486 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
5487 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
5488 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
5489 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
5490 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
5491
5492
5493 Version 1.6.0 (2016-01-21)
5494 ==========================
5495
5496 Language
5497 --------
5498
5499 * The `#![no_std]` attribute causes a crate to not be linked to the
5500   standard library, but only the [core library][1.6co], as described
5501   in [RFC 1184]. The core library defines common types and traits but
5502   has no platform dependencies whatsoever, and is the basis for Rust
5503   software in environments that cannot support a full port of the
5504   standard library, such as operating systems. Most of the core
5505   library is now stable.
5506
5507 Libraries
5508 ---------
5509
5510 * Stabilized APIs:
5511   [`Read::read_exact`],
5512   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
5513   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
5514   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
5515   [`os::unix::fs::DirBuilderExt`],
5516   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
5517   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
5518   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
5519   [`collections::hash_map::Drain`],
5520   [`collections::hash_map::HashMap::drain`],
5521   [`collections::hash_set::Drain`],
5522   [`collections::hash_set::HashSet::drain`],
5523   [`collections::binary_heap::Drain`],
5524   [`collections::binary_heap::BinaryHeap::drain`],
5525   [`Vec::extend_from_slice`][] (renamed from `push_all`),
5526   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
5527   [`RwLock::into_inner`],
5528   [`Iterator::min_by_key`][] (renamed from `min_by`),
5529   [`Iterator::max_by_key`][] (renamed from `max_by`).
5530 * The [core library][1.6co] is stable, as are most of its APIs.
5531 * [The `assert_eq!` macro supports arguments that don't implement
5532   `Sized`][1.6ae], such as arrays. In this way it behaves more like
5533   `assert!`.
5534 * Several timer functions that take duration in milliseconds [are
5535   deprecated in favor of those that take `Duration`][1.6ms]. These
5536   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
5537   `thread::park_timeout_ms`.
5538 * The algorithm by which `Vec` reserves additional elements was
5539   [tweaked to not allocate excessive space][1.6a] while still growing
5540   exponentially.
5541 * `From` conversions are [implemented from integers to floats][1.6f]
5542   in cases where the conversion is lossless. Thus they are not
5543   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
5544   or `f64`. They are also not implemented for `isize` and `usize`
5545   because the implementations would be platform-specific. `From` is
5546   also implemented from `f32` to `f64`.
5547 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
5548 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
5549 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
5550 * [`BinaryHeap` was refactored][1.6bh] for modest performance
5551   improvements.
5552 * Sorting slices that are already sorted [is 50% faster in some
5553   cases][1.6s].
5554
5555 Cargo
5556 -----
5557
5558 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
5559 * Cargo build scripts can specify their dependencies by emitting the
5560   [`rerun-if-changed`][1.6rr] key.
5561 * crates.io will reject publication of crates with dependencies that
5562   have a wildcard version constraint. Crates with wildcard
5563   dependencies were seen to cause a variety of problems, as described
5564   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
5565   warning.
5566 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
5567   release folder.  A variety of artifacts that Cargo failed to clean
5568   are now correctly deleted.
5569
5570 Misc
5571 ----
5572
5573 * The `unreachable_code` lint [warns when a function call's argument
5574   diverges][1.6dv].
5575 * The parser indicates [failures that may be caused by
5576   confusingly-similar Unicode characters][1.6uc]
5577 * Certain macro errors [are reported at definition time][1.6m], not
5578   expansion.
5579
5580 Compatibility Notes
5581 -------------------
5582
5583 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
5584   environment variable when locating crates. This was a pre-cargo
5585   feature for integrating with the package manager that was
5586   accidentally never removed.
5587 * [A number of bugs were fixed in the privacy checker][1.6p] that
5588   could cause previously-accepted code to break.
5589 * [Modules and unit/tuple structs may not share the same name][1.6ts].
5590 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
5591   struct pattern syntax (`Foo(..)`) can no longer be used to match
5592   unit structs. This is a warning now, but will become an error in
5593   future releases. Patterns that share the same name as a const are
5594   now an error.
5595 * A bug was fixed that causes [rustc not to apply default type
5596   parameters][1.6xc] when resolving certain method implementations of
5597   traits defined in other crates.
5598
5599 [1.6a]: https://github.com/rust-lang/rust/pull/29454
5600 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
5601 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
5602 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
5603 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
5604 [1.6co]: http://doc.rust-lang.org/core/index.html
5605 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
5606 [1.6f]: https://github.com/rust-lang/rust/pull/29129
5607 [1.6m]: https://github.com/rust-lang/rust/pull/29828
5608 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
5609 [1.6p]: https://github.com/rust-lang/rust/pull/29726
5610 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
5611 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
5612 [1.6s]: https://github.com/rust-lang/rust/pull/29675
5613 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
5614 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
5615 [1.6us]: https://github.com/rust-lang/rust/pull/29383
5616 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
5617 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
5618 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
5619 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
5620 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
5621 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
5622 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
5623 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
5624 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
5625 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
5626 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
5627 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
5628 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
5629 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
5630 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
5631 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
5632 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
5633 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
5634 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
5635 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
5636 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
5637 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
5638 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
5639 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
5640 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
5641 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
5642 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
5643 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
5644 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
5645 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
5646
5647
5648 Version 1.5.0 (2015-12-10)
5649 ==========================
5650
5651 * ~700 changes, numerous bugfixes
5652
5653 Highlights
5654 ----------
5655
5656 * Stabilized APIs:
5657   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
5658   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
5659   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
5660   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
5661   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
5662   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
5663   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
5664   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
5665   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
5666   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
5667   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
5668   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
5669   [`Path::read_link`], [`Path::symlink_metadata`],
5670   [`Utf8Error::valid_up_to`], [`Vec::resize`],
5671   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
5672   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
5673   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
5674   [`slice::split_first_mut`], [`slice::split_first`],
5675   [`slice::split_last_mut`], [`slice::split_last`],
5676   [`char::from_u32_unchecked`], [`fs::canonicalize`],
5677   [`str::MatchIndices`], [`str::RMatchIndices`],
5678   [`str::match_indices`], [`str::rmatch_indices`],
5679   [`str::slice_mut_unchecked`], [`string::ParseError`].
5680 * Rust applications hosted on crates.io can be installed locally to
5681   `~/.cargo/bin` with the [`cargo install`] command. Among other
5682   things this makes it easier to augment Cargo with new subcommands:
5683   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
5684   invoked as `cargo foo`.
5685 * Crates with wildcard (`*`) dependencies will [emit warnings when
5686   published][1.5w]. In 1.6 it will no longer be possible to publish
5687   crates with wildcard dependencies.
5688
5689 Breaking Changes
5690 ----------------
5691
5692 * The rules determining when a particular lifetime must outlive
5693   a particular value (known as '[dropck]') have been [modified
5694   to not rely on parametricity][1.5p].
5695 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
5696   and `Arc`][1.5a]. Because these smart pointer types implement
5697   `Deref`, this causes breakage in cases where the interior type
5698   contains methods of the same name.
5699 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
5700   that they could drop their content. Soundness fix.
5701 * All method invocations are [properly checked][1.5wf1] for
5702   [well-formedness][1.5wf2]. Soundness fix.
5703 * Traits whose supertraits contain `Self` are [not object
5704   safe][1.5o]. Soundness fix.
5705 * Target specifications support a [`no_default_libraries`][1.5nd]
5706   setting that controls whether `-nodefaultlibs` is passed to the
5707   linker, and in turn the `is_like_windows` setting no longer affects
5708   the `-nodefaultlibs` flag.
5709 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
5710 * The `#[inline]` and `#[repr]` attributes [can only appear
5711   in valid locations][1.5at].
5712 * Native libraries linked from the local crate are [passed to
5713   the linker before native libraries from upstream crates][1.5nl].
5714 * Two rarely-used attributes, `#[no_debug]` and
5715   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
5716 * Negation of unsigned integers, which has been a warning for
5717   several releases, [is now behind a feature gate and will
5718   generate errors][1.5nu].
5719 * The parser accidentally accepted visibility modifiers on
5720   enum variants, a bug [which has been fixed][1.5ev].
5721 * [A bug was fixed that allowed `use` statements to import unstable
5722   features][1.5use].
5723
5724 Language
5725 --------
5726
5727 * When evaluating expressions at compile-time that are not
5728   compile-time constants (const-evaluating expressions in non-const
5729   contexts), incorrect code such as overlong bitshifts and arithmetic
5730   overflow will [generate a warning instead of an error][1.5ce],
5731   delaying the error until runtime. This will allow the
5732   const-evaluator to be expanded in the future backwards-compatibly.
5733 * The `improper_ctypes` lint [no longer warns about using `isize` and
5734   `usize` in FFI][1.5ict].
5735
5736 Libraries
5737 ---------
5738
5739 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
5740   invariant][1.5c].
5741 * `Default` is [implemented for mutable slices][1.5d].
5742 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
5743 * There are now `From` conversions [between floating point
5744   types][1.5f] where the conversions are lossless.
5745 * There are now `From` conversions [between integer types][1.5i] where
5746   the conversions are lossless.
5747 * [`fs::Metadata` implements `Clone`][1.5fs].
5748 * The `parse` method [accepts a leading "+" when parsing
5749   integers][1.5pi].
5750 * [`AsMut` is implemented for `Vec`][1.5am].
5751 * The `clone_from` implementations for `String` and `BinaryHeap` [have
5752   been optimized][1.5cf] and no longer rely on the default impl.
5753 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
5754   `unsafe extern "C"` function types now [implement `Clone`,
5755   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
5756   `fmt::Debug` for up to 12 arguments][1.5fp].
5757 * [Dropping `Vec`s is much faster in unoptimized builds when the
5758   element types don't implement `Drop`][1.5dv].
5759 * A bug that caused in incorrect behavior when [combining `VecDeque`
5760   with zero-sized types][1.5vdz] was resolved.
5761 * [`PartialOrd` for slices is faster][1.5po].
5762
5763 Miscellaneous
5764 -------------
5765
5766 * [Crate metadata size was reduced by 20%][1.5md].
5767 * [Improvements to code generation reduced the size of libcore by 3.3
5768   MB and rustc's memory usage by 18MB][1.5m].
5769 * [Improvements to deref translation increased performance in
5770   unoptimized builds][1.5dr].
5771 * Various errors in trait resolution [are deduplicated to only be
5772   reported once][1.5te].
5773 * Rust has preliminary [support for rumprun kernels][1.5rr].
5774 * Rust has preliminary [support for NetBSD on amd64][1.5na].
5775
5776 [1.5use]: https://github.com/rust-lang/rust/pull/28364
5777 [1.5po]: https://github.com/rust-lang/rust/pull/28436
5778 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
5779 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
5780 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
5781 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
5782 [1.5md]: https://github.com/rust-lang/rust/pull/28521
5783 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
5784 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
5785 [1.5na]: https://github.com/rust-lang/rust/pull/28543
5786 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
5787 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
5788 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
5789 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
5790 [1.5te]: https://github.com/rust-lang/rust/pull/28645
5791 [1.5at]: https://github.com/rust-lang/rust/pull/28650
5792 [1.5am]: https://github.com/rust-lang/rust/pull/28663
5793 [1.5m]: https://github.com/rust-lang/rust/pull/28778
5794 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
5795 [1.5a]: https://github.com/rust-lang/rust/pull/28811
5796 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
5797 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
5798 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
5799 [1.5i]: https://github.com/rust-lang/rust/pull/28921
5800 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
5801 [1.5f]: https://github.com/rust-lang/rust/pull/29129
5802 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
5803 [1.5s]: https://github.com/rust-lang/rust/pull/29190
5804 [1.5d]: https://github.com/rust-lang/rust/pull/29245
5805 [1.5o]: https://github.com/rust-lang/rust/pull/29259
5806 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
5807 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5808 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
5809 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
5810 [1.5c]: https://github.com/rust-lang/rust/pull/29110
5811 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
5812 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
5813 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
5814 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
5815 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
5816 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
5817 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
5818 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
5819 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
5820 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
5821 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
5822 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
5823 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
5824 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
5825 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
5826 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
5827 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
5828 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
5829 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
5830 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
5831 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
5832 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
5833 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
5834 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
5835 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
5836 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
5837 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
5838 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
5839 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
5840 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
5841 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
5842 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
5843 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
5844 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
5845 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
5846 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
5847 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
5848 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
5849 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
5850 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
5851 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
5852 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
5853 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
5854 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
5855 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
5856 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
5857 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
5858 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
5859 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
5860 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
5861 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
5862 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
5863 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
5864 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
5865
5866 Version 1.4.0 (2015-10-29)
5867 ==========================
5868
5869 * ~1200 changes, numerous bugfixes
5870
5871 Highlights
5872 ----------
5873
5874 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
5875   GNU) are now supported and recommended for use.
5876
5877 Breaking Changes
5878 ----------------
5879
5880 * [Several changes have been made to fix type soundness and improve
5881   the behavior of associated types][sound]. See [RFC 1214]. Although
5882   we have mostly introduced these changes as warnings this release, to
5883   become errors next release, there are still some scenarios that will
5884   see immediate breakage.
5885 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
5886   line breaks in addition to `\n`][crlf].
5887 * [Loans of `'static` lifetime extend to the end of a function][stat].
5888 * [`str::parse` no longer introduces avoidable rounding error when
5889   parsing floating point numbers. Together with earlier changes to
5890   float formatting/output, "round trips" like f.to_string().parse()
5891   now preserve the value of f exactly. Additionally, leading plus
5892   signs are now accepted][fp3].
5893
5894
5895 Language
5896 --------
5897
5898 * `use` statements that import multiple items [can now rename
5899   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
5900 * [Binops work correctly on fat pointers][binfat].
5901 * `pub extern crate`, which does not behave as expected, [issues a
5902   warning][pec] until a better solution is found.
5903
5904 Libraries
5905 ---------
5906
5907 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
5908   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
5909   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
5910   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
5911   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
5912   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
5913   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
5914   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
5915   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
5916   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
5917   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
5918   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
5919   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
5920   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
5921   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
5922   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
5923   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
5924   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
5925   [`thread::sleep`].
5926 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
5927   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
5928   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
5929   `f64::from_str_radix`.
5930 * [Reverse-searching strings is faster with the 'two-way'
5931   algorithm][s].
5932 * [`std::io::copy` allows `?Sized` arguments][cc].
5933 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
5934   [override `count`, `nth` and `last` with an O(1)
5935   implementation][it].
5936 * [`Default` is implemented for arrays up to `[T; 32]`][d].
5937 * [`IntoRawFd` has been added to the Unix-specific prelude,
5938   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
5939   prelude][pr].
5940 * [`Extend<String>` and `FromIterator<String` are both implemented for
5941   `String`][es].
5942 * [`IntoIterator` is implemented for references to `Option` and
5943   `Result`][into2].
5944 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
5945   Copy`][ext] as part of [RFC 839]. This will cause type inference
5946   breakage in rare situations.
5947 * [`BinaryHeap` implements `Debug`][bh2].
5948 * [`Borrow` and `BorrowMut` are implemented for fixed-size
5949   arrays][bm].
5950 * [`extern fn`s with the "Rust" and "C" ABIs implement common
5951   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
5952 * [String comparison is faster][faststr].
5953 * `&mut T` where `T: std::fmt::Write` [also implements
5954   `std::fmt::Write`][mutw].
5955 * [A stable regression in `VecDeque::push_back` and other
5956   capacity-altering methods that caused panics for zero-sized types
5957   was fixed][vd].
5958 * [Function pointers implement traits for up to 12 parameters][fp2].
5959
5960 Miscellaneous
5961 -------------
5962
5963 * The compiler [no longer uses the 'morestack' feature to prevent
5964   stack overflow][mm]. Instead it uses guard pages and stack
5965   probes (though stack probes are not yet implemented on any platform
5966   but Windows).
5967 * [The compiler matches traits faster when projections are involved][p].
5968 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
5969   `usize`][ffi].
5970 * [Cargo now displays useful information about what its doing during
5971   `cargo update`][cu].
5972
5973 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
5974 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
5975 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
5976 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
5977 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
5978 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
5979 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
5980 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
5981 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
5982 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
5983 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
5984 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
5985 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
5986 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
5987 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
5988 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
5989 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
5990 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
5991 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
5992 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
5993 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
5994 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
5995 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
5996 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
5997 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
5998 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
5999 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
6000 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
6001 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
6002 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
6003 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
6004 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
6005 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
6006 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
6007 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
6008 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
6009 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
6010 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
6011 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
6012 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
6013 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
6014 [bh2]: https://github.com/rust-lang/rust/pull/28156
6015 [binfat]: https://github.com/rust-lang/rust/pull/28270
6016 [bm]: https://github.com/rust-lang/rust/pull/28197
6017 [cc]: https://github.com/rust-lang/rust/pull/27531
6018 [crlf]: https://github.com/rust-lang/rust/pull/28034
6019 [cu]: https://github.com/rust-lang/cargo/pull/1931
6020 [d]: https://github.com/rust-lang/rust/pull/27825
6021 [dep]: https://github.com/rust-lang/rust/pull/28339
6022 [es]: https://github.com/rust-lang/rust/pull/27956
6023 [ext]: https://github.com/rust-lang/rust/pull/28094
6024 [faststr]: https://github.com/rust-lang/rust/pull/28338
6025 [ffi]: https://github.com/rust-lang/rust/pull/28779
6026 [fp]: https://github.com/rust-lang/rust/pull/28268
6027 [fp2]: https://github.com/rust-lang/rust/pull/28560
6028 [fp3]: https://github.com/rust-lang/rust/pull/27307
6029 [i]: https://github.com/rust-lang/rust/pull/27451
6030 [into2]: https://github.com/rust-lang/rust/pull/28039
6031 [it]: https://github.com/rust-lang/rust/pull/27652
6032 [mm]: https://github.com/rust-lang/rust/pull/27338
6033 [mutw]: https://github.com/rust-lang/rust/pull/28368
6034 [sound]: https://github.com/rust-lang/rust/pull/27641
6035 [p]: https://github.com/rust-lang/rust/pull/27866
6036 [pec]: https://github.com/rust-lang/rust/pull/28486
6037 [pr]: https://github.com/rust-lang/rust/pull/27896
6038 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6039 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6040 [s]: https://github.com/rust-lang/rust/pull/27474
6041 [stab]: https://github.com/rust-lang/rust/pull/28339
6042 [stat]: https://github.com/rust-lang/rust/pull/28321
6043 [vd]: https://github.com/rust-lang/rust/pull/28494
6044
6045 Version 1.3.0 (2015-09-17)
6046 ==============================
6047
6048 * ~900 changes, numerous bugfixes
6049
6050 Highlights
6051 ----------
6052
6053 * The [new object lifetime defaults][nold] have been [turned
6054   on][nold2] after a cycle of warnings about the change. Now types
6055   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
6056   being interpreted as `&'a Box<Trait+'a>` to `&'a
6057   Box<Trait+'static>`.
6058 * [The Rustonomicon][nom] is a new book in the official documentation
6059   that dives into writing unsafe Rust.
6060 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
6061   timekeeping is employed by other std APIs, as well as out-of-tree
6062   time crates.
6063
6064 Breaking Changes
6065 ----------------
6066
6067 * The [new object lifetime defaults][nold] have been [turned
6068   on][nold2] after a cycle of warnings about the change.
6069 * There is a known [regression][lr] in how object lifetime elision is
6070   interpreted, the proper solution for which is undetermined.
6071 * The `#[prelude_import]` attribute, an internal implementation
6072   detail, was accidentally stabilized previously. [It has been put
6073   behind the `prelude_import` feature gate][pi]. This change is
6074   believed to break no existing code.
6075 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6076   [more sane for dynamically sized types][dst3]. Code that relied on
6077   the previous behavior is thought to be broken.
6078 * The `dropck` rules, which checks that destructors can't access
6079   destroyed values, [have been updated][dropck] to match the
6080   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
6081   cause some previously-compiling code to no longer build.
6082
6083 Language
6084 --------
6085
6086 * The [new object lifetime defaults][nold] have been [turned
6087   on][nold2] after a cycle of warnings about the change.
6088 * Semicolons may [now follow types and paths in
6089   macros](https://github.com/rust-lang/rust/pull/27000).
6090 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6091   [more sane for dynamically sized types][dst3]. Code that relied on
6092   the previous behavior is not known to exist, and suspected to be
6093   broken.
6094 * `'static` variables [may now be recursive][st].
6095 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
6096   implementations correctly.
6097 * The `dropck` rules, which checks that destructors can't access
6098   destroyed values, [have been updated][dropck] to match the
6099   [RFC][dropckrfc].
6100
6101 Libraries
6102 ---------
6103
6104 * The [`Duration`] API, [has been stabilized][ds], as well as the
6105   `std::time` module, which presently contains only `Duration`.
6106 * `Box<str>` and `Box<[T]>` both implement `Clone`.
6107 * The owned C string, [`CString`], implements [`Borrow`] and the
6108   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
6109   these allow C strings to be borrowed and cloned in generic code.
6110 * [`CStr`] implements [`Debug`].
6111 * [`AtomicPtr`] implements [`Debug`].
6112 * [`Error`] trait objects [can be downcast to their concrete types][e]
6113   in many common configurations, using the [`is`], [`downcast`],
6114   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
6115   [`Any`] trait.
6116 * Searching for substrings now [employs the two-way algorithm][search]
6117   instead of doing a naive search. This gives major speedups to a
6118   number of methods, including [`contains`][sc], [`find`][sf],
6119   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
6120   [`ends_with`][sew] are also faster.
6121 * The performance of `PartialEq` for slices is [much faster][ps].
6122 * The [`Hash`] trait offers the default method, [`hash_slice`], which
6123   is overridden and optimized by the implementations for scalars.
6124 * The [`Hasher`] trait now has a number of specialized `write_*`
6125   methods for primitive types, for efficiency.
6126 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
6127   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
6128   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
6129   of [`std::error::Error::cause`][iec] also delegates to the inner
6130   error.
6131 * [`process::Child`][pc] gained the [`id`] method, which returns a
6132   `u32` representing the platform-specific process identifier.
6133 * The [`connect`] method on slices is deprecated, replaced by the new
6134   [`join`] method (note that both of these are on the *unstable*
6135   [`SliceConcatExt`] trait, but through the magic of the prelude are
6136   available to stable code anyway).
6137 * The [`Div`] operator is implemented for [`Wrapping`] types.
6138 * [`DerefMut` is implemented for `String`][dms].
6139 * Performance of SipHash (the default hasher for `HashMap`) is
6140   [better for long data][sh].
6141 * [`AtomicPtr`] implements [`Send`].
6142 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
6143   are now [specialized to use uninitialized buffers for increased
6144   performance][rte].
6145 * Lifetime parameters of foreign functions [are now resolved
6146   properly][f].
6147
6148 Misc
6149 ----
6150
6151 * Rust can now, with some coercion, [produce programs that run on
6152   Windows XP][xp], though XP is not considered a supported platform.
6153 * Porting Rust on Windows from the GNU toolchain to MSVC continues
6154   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
6155   recommended for use in 1.3, though should be fully-functional
6156   in the [64-bit 1.4 beta][b14].
6157 * On Fedora-based systems installation will [properly configure the
6158   dynamic linker][fl].
6159 * The compiler gained many new extended error descriptions, which can
6160   be accessed with the `--explain` flag.
6161 * The `dropck` pass, which checks that destructors can't access
6162   destroyed values, [has been rewritten][dropck]. This fixes some
6163   soundness holes, and as such will cause some previously-compiling
6164   code to no longer build.
6165 * `rustc` now uses [LLVM to write archive files where possible][ar].
6166   Eventually this will eliminate the compiler's dependency on the ar
6167   utility.
6168 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
6169   supported FreeBSD on x86_64).
6170 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
6171   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
6172   more strict.
6173 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
6174   will kill the process instead of leaking][nlp].
6175
6176 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
6177 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
6178 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
6179 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
6180 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
6181 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6182 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6183 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
6184 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
6185 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
6186 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
6187 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
6188 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
6189 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6190 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
6191 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
6192 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
6193 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
6194 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6195 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
6196 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
6197 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
6198 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
6199 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6200 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
6201 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
6202 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
6203 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
6204 [ar]: https://github.com/rust-lang/rust/pull/26926
6205 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
6206 [dms]: https://github.com/rust-lang/rust/pull/26241
6207 [dropck]: https://github.com/rust-lang/rust/pull/27261
6208 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6209 [ds]: https://github.com/rust-lang/rust/pull/26818
6210 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
6211 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
6212 [dst3]: https://github.com/rust-lang/rust/pull/27351
6213 [e]: https://github.com/rust-lang/rust/pull/24793
6214 [f]: https://github.com/rust-lang/rust/pull/26588
6215 [fb]: https://github.com/rust-lang/rust/pull/26959
6216 [fl]: https://github.com/rust-lang/rust-installer/pull/41
6217 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6218 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
6219 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
6220 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
6221 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
6222 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
6223 [lic]: https://github.com/rust-lang/rust/pull/26583
6224 [lnu]: https://github.com/rust-lang/rust/pull/27026
6225 [lr]: https://github.com/rust-lang/rust/issues/27248
6226 [lum]: https://github.com/rust-lang/rust/pull/26378
6227 [lur]: https://github.com/rust-lang/rust/pull/26783
6228 [nlp]: https://github.com/rust-lang/rust/pull/27176
6229 [nold2]: https://github.com/rust-lang/rust/pull/27045
6230 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
6231 [nom]: http://doc.rust-lang.org/nightly/nomicon/
6232 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
6233 [pi]: https://github.com/rust-lang/rust/pull/26699
6234 [ps]: https://github.com/rust-lang/rust/pull/26884
6235 [rte]: https://github.com/rust-lang/rust/pull/26950
6236 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
6237 [search]: https://github.com/rust-lang/rust/pull/26327
6238 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
6239 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
6240 [sh]: https://github.com/rust-lang/rust/pull/27280
6241 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
6242 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
6243 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
6244 [st]: https://github.com/rust-lang/rust/pull/26630
6245 [win1]: https://github.com/rust-lang/rust/pull/26569
6246 [win2]: https://github.com/rust-lang/rust/pull/26741
6247 [win3]: https://github.com/rust-lang/rust/pull/26741
6248 [win4]: https://github.com/rust-lang/rust/pull/27210
6249 [xp]: https://github.com/rust-lang/rust/pull/26569
6250
6251 Version 1.2.0 (2015-08-07)
6252 ==========================
6253
6254 * ~1200 changes, numerous bugfixes
6255
6256 Highlights
6257 ----------
6258
6259 * [Dynamically-sized-type coercions][dst] allow smart pointer types
6260   like `Rc` to contain types without a fixed size, arrays and trait
6261   objects, finally enabling use of `Rc<[T]>` and completing the
6262   implementation of DST.
6263 * [Parallel codegen][parcodegen] is now working again, which can
6264   substantially speed up large builds in debug mode; It also gets
6265   another ~33% speedup when bootstrapping on a 4 core machine (using 8
6266   jobs). It's not enabled by default, but will be "in the near
6267   future". It can be activated with the `-C codegen-units=N` flag to
6268   `rustc`.
6269 * This is the first release with [experimental support for linking
6270   with the MSVC linker and lib C on Windows (instead of using the GNU
6271   variants via MinGW)][win]. It is yet recommended only for the most
6272   intrepid Rustaceans.
6273 * Benchmark compilations are showing a 30% improvement in
6274   bootstrapping over 1.1.
6275
6276 Breaking Changes
6277 ----------------
6278
6279 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
6280   unicode case mapping, which is a previously-planned change in
6281   behavior and considered a bugfix.
6282 * [`mem::align_of`] now specifies [the *minimum alignment* for
6283   T][align], which is usually the alignment programs are interested
6284   in, and the same value reported by clang's
6285   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
6286   break real code.
6287 * [The `#[packed]` attribute is no longer silently accepted by the
6288   compiler][packed]. This attribute did nothing and code that
6289   mentioned it likely did not work as intended.
6290 * Associated type defaults are [now behind the
6291   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
6292   defaults *did not work*, but could be mentioned syntactically. As
6293   such this breakage has minimal impact.
6294
6295 Language
6296 --------
6297
6298 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
6299   matching against dereferenceable values.
6300
6301 Libraries
6302 ---------
6303
6304 * The [`Extend`] trait, which grows a collection from an iterator, is
6305   implemented over iterators of references, for `String`, `Vec`,
6306   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
6307   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
6308 * The [`iter::once`] function returns an iterator that yields a single
6309   element, and [`iter::empty`] returns an iterator that yields no
6310   elements.
6311 * The [`matches`] and [`rmatches`] methods on `str` return iterators
6312   over substring matches.
6313 * [`Cell`] and [`RefCell`] both implement `Eq`.
6314 * A number of methods for wrapping arithmetic are added to the
6315   integral types, [`wrapping_div`], [`wrapping_rem`],
6316   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
6317   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
6318   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
6319   type.. It is illegal for the default arithmetic operations in Rust
6320   to overflow; the desire to wrap must be explicit.
6321 * The `{:#?}` formatting specifier [displays the alternate,
6322   pretty-printed][debugfmt] form of the `Debug` formatter. This
6323   feature was actually introduced prior to 1.0 with little
6324   fanfare.
6325 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
6326   for writing data to formatted strings, similar to [`io::Write`].
6327 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
6328   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
6329   are used by code generators to emit implementations of [`Debug`].
6330 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
6331   methods that convert case, following Unicode case mapping.
6332 * It is now easier to handle poisoned locks. The [`PoisonError`]
6333   type, returned by failing lock operations, exposes `into_inner`,
6334   `get_ref`, and `get_mut`, which all give access to the inner lock
6335   guard, and allow the poisoned lock to continue to operate. The
6336   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
6337   poisoned lock without attempting to take the lock.
6338 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
6339   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
6340   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
6341   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
6342   `ChildStderr`.
6343 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
6344   malformed input.
6345
6346 Misc
6347 ----
6348
6349 * `rustc` employs smarter heuristics for guessing at [typos].
6350 * `rustc` emits more efficient code for [no-op conversions between
6351   unsafe pointers][nop].
6352 * Fat pointers are now [passed in pairs of immediate arguments][fat],
6353   resulting in faster compile times and smaller code.
6354
6355 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
6356 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6357 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
6358 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
6359 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
6360 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
6361 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
6362 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
6363 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
6364 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
6365 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
6366 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
6367 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
6368 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
6369 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
6370 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
6371 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6372 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
6373 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
6374 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
6375 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
6376 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
6377 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
6378 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
6379 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
6380 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6381 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
6382 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
6383 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
6384 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
6385 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
6386 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
6387 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
6388 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
6389 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
6390 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
6391 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
6392 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
6393 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
6394 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
6395 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
6396 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6397 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
6398 [align]: https://github.com/rust-lang/rust/pull/25646
6399 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
6400 [typos]: https://github.com/rust-lang/rust/pull/26087
6401 [nop]: https://github.com/rust-lang/rust/pull/26336
6402 [fat]: https://github.com/rust-lang/rust/pull/26411
6403 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
6404 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
6405 [packed]: https://github.com/rust-lang/rust/pull/25541
6406 [ad]: https://github.com/rust-lang/rust/pull/27382
6407 [win]: https://github.com/rust-lang/rust/pull/25350
6408
6409 Version 1.1.0 (2015-06-25)
6410 =========================
6411
6412 * ~850 changes, numerous bugfixes
6413
6414 Highlights
6415 ----------
6416
6417 * The [`std::fs` module has been expanded][fs] to expand the set of
6418   functionality exposed:
6419   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
6420     don't incur a syscall on some platforms.
6421   * A `symlink_metadata` function has been added.
6422   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
6423     access to all underlying information.
6424 * The compiler now contains extended explanations of many errors. When an error
6425   with an explanation occurs the compiler suggests using the `--explain` flag
6426   to read the explanation. Error explanations are also [available online][err-index].
6427 * Thanks to multiple [improvements][sk] to [type checking][pre], as
6428   well as other work, the time to bootstrap the compiler decreased by
6429   32%.
6430
6431 Libraries
6432 ---------
6433
6434 * The [`str::split_whitespace`] method splits a string on unicode
6435   whitespace boundaries.
6436 * On both Windows and Unix, new extension traits provide conversion of
6437   I/O types to and from the underlying system handles. On Unix, these
6438   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
6439   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
6440   `TcpListener`, and `UpdSocket`. Further implementations for
6441   `std::process` will be stabilized later.
6442 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
6443   Windows, symlinks can be created with
6444   `std::os::windows::symlink_dir` and
6445   `std::os::windows::symlink_file`.
6446 * The `mpsc::Receiver` type can now be converted into an iterator with
6447   `into_iter` on the [`IntoIterator`] trait.
6448 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
6449   implementation of the [`From`] trait.
6450 * The `Debug` implementation for `RangeFull` [creates output that is
6451   more consistent with other implementations][rf].
6452 * [`Debug` is implemented for `File`][file].
6453 * The `Default` implementation for `Arc` [no longer requires `Sync +
6454   Send`][arc].
6455 * [The `Iterator` methods `count`, `nth`, and `last` have been
6456   overridden for slices to have O(1) performance instead of O(n)][si].
6457 * Incorrect handling of paths on Windows has been improved in both the
6458   compiler and the standard library.
6459 * [`AtomicPtr` gained a `Default` implementation][ap].
6460 * In accordance with Rust's policy on arithmetic overflow `abs` now
6461   [panics on overflow when debug assertions are enabled][abs].
6462 * The [`Cloned`] iterator, which was accidentally left unstable for
6463   1.0 [has been stabilized][c].
6464 * The [`Incoming`] iterator, which iterates over incoming TCP
6465   connections, and which was accidentally unnamable in 1.0, [is now
6466   properly exported][inc].
6467 * [`BinaryHeap`] no longer corrupts itself [when functions called by
6468   `sift_up` or `sift_down` panic][bh].
6469 * The [`split_off`] method of `LinkedList` [no longer corrupts
6470   the list in certain scenarios][ll].
6471
6472 Misc
6473 ----
6474
6475 * Type checking performance [has improved notably][sk] with
6476   [multiple improvements][pre].
6477 * The compiler [suggests code changes][ch] for more errors.
6478 * rustc and it's build system have experimental support for [building
6479   toolchains against MUSL][m] instead of glibc on Linux.
6480 * The compiler defines the `target_env` cfg value, which is used for
6481   distinguishing toolchains that are otherwise for the same
6482   platform. Presently this is set to `gnu` for common GNU Linux
6483   targets and for MinGW targets, and `musl` for MUSL Linux targets.
6484 * The [`cargo rustc`][crc] command invokes a build with custom flags
6485   to rustc.
6486 * [Android executables are always position independent][pie].
6487 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
6488   with `Drop`][drop].
6489
6490 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
6491 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
6492 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
6493 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
6494 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
6495 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
6496 [rf]: https://github.com/rust-lang/rust/pull/24491
6497 [err-index]: https://doc.rust-lang.org/error-index.html
6498 [sk]: https://github.com/rust-lang/rust/pull/24615
6499 [pre]: https://github.com/rust-lang/rust/pull/25323
6500 [file]: https://github.com/rust-lang/rust/pull/24598
6501 [ch]: https://github.com/rust-lang/rust/pull/24683
6502 [arc]: https://github.com/rust-lang/rust/pull/24695
6503 [si]: https://github.com/rust-lang/rust/pull/24701
6504 [ap]: https://github.com/rust-lang/rust/pull/24834
6505 [m]: https://github.com/rust-lang/rust/pull/24777
6506 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
6507 [crc]: https://github.com/rust-lang/cargo/pull/1568
6508 [pie]: https://github.com/rust-lang/rust/pull/24953
6509 [abs]: https://github.com/rust-lang/rust/pull/25441
6510 [c]: https://github.com/rust-lang/rust/pull/25496
6511 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
6512 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
6513 [inc]: https://github.com/rust-lang/rust/pull/25522
6514 [bh]: https://github.com/rust-lang/rust/pull/25856
6515 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
6516 [ll]: https://github.com/rust-lang/rust/pull/26022
6517 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
6518 [drop]: https://github.com/rust-lang/rust/pull/24935
6519
6520 Version 1.0.0 (2015-05-15)
6521 ========================
6522
6523 * ~1500 changes, numerous bugfixes
6524
6525 Highlights
6526 ----------
6527
6528 * The vast majority of the standard library is now `#[stable]`. It is
6529   no longer possible to use unstable features with a stable build of
6530   the compiler.
6531 * Many popular crates on [crates.io] now work on the stable release
6532   channel.
6533 * Arithmetic on basic integer types now [checks for overflow in debug
6534   builds][overflow].
6535
6536 Language
6537 --------
6538
6539 * Several [restrictions have been added to trait coherence][coh] in
6540   order to make it easier for upstream authors to change traits
6541   without breaking downstream code.
6542 * Digits of binary and octal literals are [lexed more eagerly][lex] to
6543   improve error messages and macro behavior. For example, `0b1234` is
6544   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
6545 * Trait bounds [are always invariant][inv], eliminating the need for
6546   the `PhantomFn` and `MarkerTrait` lang items, which have been
6547   removed.
6548 * ["-" is no longer a valid character in crate names][cr], the `extern crate
6549   "foo" as bar` syntax has been replaced with `extern crate foo as
6550   bar`, and Cargo now automatically translates "-" in *package* names
6551   to underscore for the crate name.
6552 * [Lifetime shadowing is an error][lt].
6553 * [`Send` no longer implies `'static`][send-rfc].
6554 * [UFCS now supports trait-less associated paths][moar-ufcs] like
6555   `MyType::default()`.
6556 * Primitive types [now have inherent methods][prim-inherent],
6557   obviating the need for extension traits like `SliceExt`.
6558 * Methods with `Self: Sized` in their `where` clause are [considered
6559   object-safe][self-sized], allowing many extension traits like
6560   `IteratorExt` to be merged into the traits they extended.
6561 * You can now [refer to associated types][assoc-where] whose
6562   corresponding trait bounds appear only in a `where` clause.
6563 * The final bits of [OIBIT landed][oibit-final], meaning that traits
6564   like `Send` and `Sync` are now library-defined.
6565 * A [Reflect trait][reflect] was introduced, which means that
6566   downcasting via the `Any` trait is effectively limited to concrete
6567   types. This helps retain the potentially-important "parametricity"
6568   property: generic code cannot behave differently for different type
6569   arguments except in minor ways.
6570 * The `unsafe_destructor` feature is now deprecated in favor of the
6571   [new `dropck`][dropck]. This change is a major reduction in unsafe
6572   code.
6573
6574 Libraries
6575 ---------
6576
6577 * The `thread_local` module [has been renamed to `std::thread`][th].
6578 * The methods of `IteratorExt` [have been moved to the `Iterator`
6579   trait itself][ie].
6580 * Several traits that implement Rust's conventions for type
6581   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
6582   [centralized in the `std::convert` module][con].
6583 * The `FromError` trait [was removed in favor of `From`][fe].
6584 * The basic sleep function [has moved to
6585   `std::thread::sleep_ms`][slp].
6586 * The `splitn` function now takes an `n` parameter that represents the
6587   number of items yielded by the returned iterator [instead of the
6588   number of 'splits'][spl].
6589 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
6590 * [Derived implementations of `PartialOrd` now order enums according
6591   to their explicitly-assigned discriminants][po].
6592 * [Methods for searching strings are generic over `Pattern`s][pat],
6593   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
6594   some others.
6595 * [In method resolution, object methods are resolved before inherent
6596   methods][meth].
6597 * [`String::from_str` has been deprecated in favor of the `From` impl,
6598   `String::from`][sf].
6599 * [`io::Error` implements `Sync`][ios].
6600 * [The `words` method on `&str` has been replaced with
6601   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
6602   a word?'
6603 * The new path and IO modules are complete and `#[stable]`. This
6604   was the major library focus for this cycle.
6605 * The path API was [revised][path-normalize] to normalize `.`,
6606   adjusting the tradeoffs in favor of the most common usage.
6607 * A large number of remaining APIs in `std` were also stabilized
6608   during this cycle; about 75% of the non-deprecated API surface
6609   is now stable.
6610 * The new [string pattern API][string-pattern] landed, which makes
6611   the string slice API much more internally consistent and flexible.
6612 * A new set of [generic conversion traits][conversion] replaced
6613   many existing ad hoc traits.
6614 * Generic numeric traits were [completely removed][num-traits]. This
6615   was made possible thanks to inherent methods for primitive types,
6616   and the removal gives maximal flexibility for designing a numeric
6617   hierarchy in the future.
6618 * The `Fn` traits are now related via [inheritance][fn-inherit]
6619   and provide ergonomic [blanket implementations][fn-blanket].
6620 * The `Index` and `IndexMut` traits were changed to
6621   [take the index by value][index-value], enabling code like
6622   `hash_map["string"]` to work.
6623 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
6624   `Copy` data is known to be `Clone` as well.
6625
6626 Misc
6627 ----
6628
6629 * Many errors now have extended explanations that can be accessed with
6630   the `--explain` flag to `rustc`.
6631 * Many new examples have been added to the standard library
6632   documentation.
6633 * rustdoc has received a number of improvements focused on completion
6634   and polish.
6635 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
6636 * Much headway was made on ecosystem-wide CI, making it possible
6637   to [compare builds for breakage][ci-compare].
6638
6639
6640 [crates.io]: http://crates.io
6641 [clo]: https://github.com/rust-lang/rust/pull/24034
6642 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
6643 [con]: https://github.com/rust-lang/rust/pull/23875
6644 [cr]: https://github.com/rust-lang/rust/pull/23419
6645 [fe]: https://github.com/rust-lang/rust/pull/23879
6646 [ie]: https://github.com/rust-lang/rust/pull/23300
6647 [inv]: https://github.com/rust-lang/rust/pull/23938
6648 [ios]: https://github.com/rust-lang/rust/pull/24133
6649 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
6650 [lt]: https://github.com/rust-lang/rust/pull/24057
6651 [meth]: https://github.com/rust-lang/rust/pull/24056
6652 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
6653 [po]: https://github.com/rust-lang/rust/pull/24270
6654 [sf]: https://github.com/rust-lang/rust/pull/24517
6655 [slp]: https://github.com/rust-lang/rust/pull/23949
6656 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
6657 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
6658 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
6659 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
6660 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
6661 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
6662 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
6663 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
6664 [self-sized]: https://github.com/rust-lang/rust/pull/22301
6665 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
6666 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
6667 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
6668 [reflect]: https://github.com/rust-lang/rust/pull/23712
6669 [conversion]: https://github.com/rust-lang/rfcs/pull/529
6670 [num-traits]: https://github.com/rust-lang/rust/pull/23549
6671 [index-value]: https://github.com/rust-lang/rust/pull/23601
6672 [dropck]: https://github.com/rust-lang/rfcs/pull/769
6673 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
6674 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
6675 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
6676 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
6677 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
6678
6679
6680 Version 1.0.0-alpha.2 (2015-02-20)
6681 =====================================
6682
6683 * ~1300 changes, numerous bugfixes
6684
6685 * Highlights
6686
6687     * The various I/O modules were [overhauled][io-rfc] to reduce
6688       unnecessary abstractions and provide better interoperation with
6689       the underlying platform. The old `io` module remains temporarily
6690       at `std::old_io`.
6691     * The standard library now [participates in feature gating][feat],
6692       so use of unstable libraries now requires a `#![feature(...)]`
6693       attribute. The impact of this change is [described on the
6694       forum][feat-forum]. [RFC][feat-rfc].
6695
6696 * Language
6697
6698     * `for` loops [now operate on the `IntoIterator` trait][into],
6699       which eliminates the need to call `.iter()`, etc. to iterate
6700       over collections. There are some new subtleties to remember
6701       though regarding what sort of iterators various types yield, in
6702       particular that `for foo in bar { }` yields values from a move
6703       iterator, destroying the original collection. [RFC][into-rfc].
6704     * Objects now have [default lifetime bounds][obj], so you don't
6705       have to write `Box<Trait+'static>` when you don't care about
6706       storing references. [RFC][obj-rfc].
6707     * In types that implement `Drop`, [lifetimes must outlive the
6708       value][drop]. This will soon make it possible to safely
6709       implement `Drop` for types where `#[unsafe_destructor]` is now
6710       required. Read the [gorgeous RFC][drop-rfc] for details.
6711     * The fully qualified <T as Trait>::X syntax lets you set the Self
6712       type for a trait method or associated type. [RFC][ufcs-rfc].
6713     * References to types that implement `Deref<U>` now [automatically
6714       coerce to references][deref] to the dereferenced type `U`,
6715       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
6716       should eliminate many unsightly uses of `&*`, as when converting
6717       from references to vectors into references to
6718       slices. [RFC][deref-rfc].
6719     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
6720       `|:|`) is obsolete and closure kind is inferred from context.
6721     * [`Self` is a keyword][Self].
6722
6723 * Libraries
6724
6725     * The `Show` and `String` formatting traits [have been
6726       renamed][fmt] to `Debug` and `Display` to more clearly reflect
6727       their related purposes. Automatically getting a string
6728       conversion to use with `format!("{:?}", something_to_debug)` is
6729       now written `#[derive(Debug)]`.
6730     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
6731       OsStr}`, provide strings in platform-specific encodings for easier
6732       interop with system APIs. [RFC][osstr-rfc].
6733     * The `boxed::into_raw` and `Box::from_raw` functions [convert
6734       between `Box<T>` and `*mut T`][boxraw], a common pattern for
6735       creating raw pointers.
6736
6737 * Tooling
6738
6739     * Certain long error messages of the form 'expected foo found bar'
6740       are now [split neatly across multiple
6741       lines][multiline]. Examples in the PR.
6742     * On Unix Rust can be [uninstalled][un] by running
6743       `/usr/local/lib/rustlib/uninstall.sh`.
6744     * The `#[rustc_on_unimplemented]` attribute, requiring the
6745       'on_unimplemented' feature, lets rustc [display custom error
6746       messages when a trait is expected to be implemented for a type
6747       but is not][onun].
6748
6749 * Misc
6750
6751     * Rust is tested against a [LALR grammar][lalr], which parses
6752       almost all the Rust files that rustc does.
6753
6754 [boxraw]: https://github.com/rust-lang/rust/pull/21318
6755 [close]: https://github.com/rust-lang/rust/pull/21843
6756 [deref]: https://github.com/rust-lang/rust/pull/21351
6757 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
6758 [drop]: https://github.com/rust-lang/rust/pull/21972
6759 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6760 [feat]: https://github.com/rust-lang/rust/pull/21248
6761 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
6762 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
6763 [fmt]: https://github.com/rust-lang/rust/pull/21457
6764 [into]: https://github.com/rust-lang/rust/pull/20790
6765 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
6766 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
6767 [lalr]: https://github.com/rust-lang/rust/pull/21452
6768 [multiline]: https://github.com/rust-lang/rust/pull/19870
6769 [obj]: https://github.com/rust-lang/rust/pull/22230
6770 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
6771 [onun]: https://github.com/rust-lang/rust/pull/20889
6772 [osstr]: https://github.com/rust-lang/rust/pull/21488
6773 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
6774 [Self]: https://github.com/rust-lang/rust/pull/22158
6775 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
6776 [un]: https://github.com/rust-lang/rust/pull/22256
6777
6778
6779 Version 1.0.0-alpha (2015-01-09)
6780 ==================================
6781
6782   * ~2400 changes, numerous bugfixes
6783
6784   * Highlights
6785
6786     * The language itself is considered feature complete for 1.0,
6787       though there will be many usability improvements and bugfixes
6788       before the final release.
6789     * Nearly 50% of the public API surface of the standard library has
6790       been declared 'stable'. Those interfaces are unlikely to change
6791       before 1.0.
6792     * The long-running debate over integer types has been
6793       [settled][ints]: Rust will ship with types named `isize` and
6794       `usize`, rather than `int` and `uint`, for pointer-sized
6795       integers. Guidelines will be rolled out during the alpha cycle.
6796     * Most crates that are not `std` have been moved out of the Rust
6797       distribution into the Cargo ecosystem so they can evolve
6798       separately and don't need to be stabilized as quickly, including
6799       'time', 'getopts', 'num', 'regex', and 'term'.
6800     * Documentation continues to be expanded with more API coverage, more
6801       examples, and more in-depth explanations. The guides have been
6802       consolidated into [The Rust Programming Language][trpl].
6803     * "[Rust By Example][rbe]" is now maintained by the Rust team.
6804     * All official Rust binary installers now come with [Cargo], the
6805       Rust package manager.
6806
6807 * Language
6808
6809     * Closures have been [completely redesigned][unboxed] to be
6810       implemented in terms of traits, can now be used as generic type
6811       bounds and thus monomorphized and inlined, or via an opaque
6812       pointer (boxed) as in the old system. The new system is often
6813       referred to as 'unboxed' closures.
6814     * Traits now support [associated types][assoc], allowing families
6815       of related types to be defined together and used generically in
6816       powerful ways.
6817     * Enum variants are [namespaced by their type names][enum].
6818     * [`where` clauses][where] provide a more versatile and attractive
6819       syntax for specifying generic bounds, though the previous syntax
6820       remains valid.
6821     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
6822       numeric types.
6823     * Rust [no longer has a runtime][rt] of any description, and only
6824       supports OS threads, not green threads.
6825     * At long last, Rust has been overhauled for 'dynamically-sized
6826       types' ([DST]), which integrates 'fat pointers' (object types,
6827       arrays, and `str`) more deeply into the type system, making it
6828       more consistent.
6829     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
6830       `..j` that produce range types and which, when combined with the
6831       `Index` operator and multidispatch, leads to a convenient slice
6832       notation, `[i..j]`.
6833     * The new range syntax revealed an ambiguity in the fixed-length
6834       array syntax, so now fixed length arrays [are written `[T;
6835       N]`][arrays].
6836     * The `Copy` trait is no longer implemented automatically. Unsafe
6837       pointers no longer implement `Sync` and `Send` so types
6838       containing them don't automatically either. `Sync` and `Send`
6839       are now 'unsafe traits' so one can "forcibly" implement them via
6840       `unsafe impl` if a type confirms to the requirements for them
6841       even though the internals do not (e.g. structs containing unsafe
6842       pointers like `Arc`). These changes are intended to prevent some
6843       footguns and are collectively known as [opt-in built-in
6844       traits][oibit] (though `Sync` and `Send` will soon become pure
6845       library types unknown to the compiler).
6846     * Operator traits now take their operands [by value][ops], and
6847       comparison traits can use multidispatch to compare one type
6848       against multiple other types, allowing e.g. `String` to be
6849       compared with `&str`.
6850     * `if let` and `while let` are no longer feature-gated.
6851     * Rust has adopted a more [uniform syntax for escaping unicode
6852       characters][unicode].
6853     * `macro_rules!` [has been declared stable][mac]. Though it is a
6854       flawed system it is sufficiently popular that it must be usable
6855       for 1.0. Effort has gone into [future-proofing][mac-future] it
6856       in ways that will allow other macro systems to be developed in
6857       parallel, and won't otherwise impact the evolution of the
6858       language.
6859     * The prelude has been [pared back significantly][prelude] such
6860       that it is the minimum necessary to support the most pervasive
6861       code patterns, and through [generalized where clauses][where]
6862       many of the prelude extension traits have been consolidated.
6863     * Rust's rudimentary reflection [has been removed][refl], as it
6864       incurred too much code generation for little benefit.
6865     * [Struct variants][structvars] are no longer feature-gated.
6866     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
6867       known as 'higher-ranked trait bounds', this crucially allows
6868       unboxed closures to work.
6869     * Macros invocations surrounded by parens or square brackets and
6870       not terminated by a semicolon are [parsed as
6871       expressions][macros], which makes expressions like `vec![1i32,
6872       2, 3].len()` work as expected.
6873     * Trait objects now implement their traits automatically, and
6874       traits that can be coerced to objects now must be [object
6875       safe][objsafe].
6876     * Automatically deriving traits is now done with `#[derive(...)]`
6877       not `#[deriving(...)]` for [consistency with other naming
6878       conventions][derive].
6879     * Importing the containing module or enum at the same time as
6880       items or variants they contain is [now done with `self` instead
6881       of `mod`][self], as in use `foo::{self, bar}`
6882     * Glob imports are no longer feature-gated.
6883     * The `box` operator and `box` patterns have been feature-gated
6884       pending a redesign. For now unique boxes should be allocated
6885       like other containers, with `Box::new`.
6886
6887 * Libraries
6888
6889     * A [series][coll1] of [efforts][coll2] to establish
6890       [conventions][coll3] for collections types has resulted in API
6891       improvements throughout the standard library.
6892     * New [APIs for error handling][err] provide ergonomic interop
6893       between error types, and [new conventions][err-conv] describe
6894       more clearly the recommended error handling strategies in Rust.
6895     * The `fail!` macro has been renamed to [`panic!`][panic] so that
6896       it is easier to discuss failure in the context of error handling
6897       without making clarifications as to whether you are referring to
6898       the 'fail' macro or failure more generally.
6899     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
6900       syscall when available.
6901     * The 'serialize' crate has been renamed 'rustc-serialize' and
6902       moved out of the distribution to Cargo. Although it is widely
6903       used now, it is expected to be superseded in the near future.
6904     * The `Show` formatter, typically implemented with
6905       `#[derive(Show)]` is [now requested with the `{:?}`
6906       specifier][show] and is intended for use by all types, for uses
6907       such as `println!` debugging. The new `String` formatter must be
6908       implemented by hand, uses the `{}` specifier, and is intended
6909       for full-fidelity conversions of things that can logically be
6910       represented as strings.
6911
6912 * Tooling
6913
6914     * [Flexible target specification][flex] allows rustc's code
6915       generation to be configured to support otherwise-unsupported
6916       platforms.
6917     * Rust comes with rust-gdb and rust-lldb scripts that launch their
6918       respective debuggers with Rust-appropriate pretty-printing.
6919     * The Windows installation of Rust is distributed with the
6920       MinGW components currently required to link binaries on that
6921       platform.
6922
6923 * Misc
6924
6925     * Nullable enum optimizations have been extended to more types so
6926       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
6927       space than the inner types themselves.
6928     * Work has begun on supporting AArch64.
6929
6930 [Cargo]: https://crates.io
6931 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
6932 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
6933 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
6934 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
6935 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
6936 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
6937 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
6938 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
6939 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
6940 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
6941 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
6942 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
6943 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
6944 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
6945 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
6946 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
6947 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
6948 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
6949 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
6950 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
6951 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
6952 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
6953 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
6954 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
6955 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
6956 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
6957 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
6958 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
6959 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
6960 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
6961 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
6962 [trpl]: https://doc.rust-lang.org/book/index.html
6963 [rbe]: http://rustbyexample.com/
6964
6965
6966 Version 0.12.0 (2014-10-09)
6967 =============================
6968
6969   * ~1900 changes, numerous bugfixes
6970
6971   * Highlights
6972
6973     * The introductory documentation (now called The Rust Guide) has
6974       been completely rewritten, as have a number of supplementary
6975       guides.
6976     * Rust's package manager, Cargo, continues to improve and is
6977       sometimes considered to be quite awesome.
6978     * Many API's in `std` have been reviewed and updated for
6979       consistency with the in-development Rust coding
6980       guidelines. The standard library documentation tracks
6981       stabilization progress.
6982     * Minor libraries have been moved out-of-tree to the rust-lang org
6983       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
6984       be installed with Cargo.
6985     * Lifetime elision allows lifetime annotations to be left off of
6986       function declarations in many common scenarios.
6987     * Rust now works on 64-bit Windows.
6988
6989   * Language
6990     * Indexing can be overloaded with the `Index` and `IndexMut`
6991       traits.
6992     * The `if let` construct takes a branch only if the `let` pattern
6993       matches, currently behind the 'if_let' feature gate.
6994     * 'where clauses', a more flexible syntax for specifying trait
6995       bounds that is more aesthetic, have been added for traits and
6996       free functions. Where clauses will in the future make it
6997       possible to constrain associated types, which would be
6998       impossible with the existing syntax.
6999     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
7000       the 'slicing_syntax' feature gate, and can be overloaded with
7001       the `Slice` or `SliceMut` traits.
7002     * The syntax for matching of sub-slices has been changed to use a
7003       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
7004       consistency with other uses of `..` and to future-proof
7005       potential additional uses of the syntax.
7006     * The syntax for matching inclusive ranges in patterns has changed
7007       from `0..3` to `0...4` to be consistent with the exclusive range
7008       syntax for slicing.
7009     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
7010       c]`) has been put behind the 'advanced_slice_patterns' feature
7011       gate and may be removed in the future.
7012     * Components of tuples and tuple structs can be extracted using
7013       the `value.0` syntax, currently behind the `tuple_indexing`
7014       feature gate.
7015     * The `#[crate_id]` attribute is no longer supported; versioning
7016       is handled by the package manager.
7017     * Renaming crate imports are now written `extern crate foo as bar`
7018       instead of `extern crate bar = foo`.
7019     * Renaming use statements are now written `use foo as bar` instead
7020       of `use bar = foo`.
7021     * `let` and `match` bindings and argument names in macros are now
7022       hygienic.
7023     * The new, more efficient, closure types ('unboxed closures') have
7024       been added under a feature gate, 'unboxed_closures'. These will
7025       soon replace the existing closure types, once higher-ranked
7026       trait lifetimes are added to the language.
7027     * `move` has been added as a keyword, for indicating closures
7028       that capture by value.
7029     * Mutation and assignment is no longer allowed in pattern guards.
7030     * Generic structs and enums can now have trait bounds.
7031     * The `Share` trait is now called `Sync` to free up the term
7032       'shared' to refer to 'shared reference' (the default reference
7033       type.
7034     * Dynamically-sized types have been mostly implemented,
7035       unifying the behavior of fat-pointer types with the rest of the
7036       type system.
7037     * As part of dynamically-sized types, the `Sized` trait has been
7038       introduced, which qualifying types implement by default, and
7039       which type parameters expect by default. To specify that a type
7040       parameter does not need to be sized, write `<Sized? T>`. Most
7041       types are `Sized`, notable exceptions being unsized arrays
7042       (`[T]`) and trait types.
7043     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
7044     * Lifetime bounds can now be applied to type parameters and object
7045       types.
7046     * The old, reference counted GC type, `Gc<T>` which was once
7047       denoted by the `@` sigil, has finally been removed. GC will be
7048       revisited in the future.
7049
7050   * Libraries
7051     * Library documentation has been improved for a number of modules.
7052     * Bit-vectors, collections::bitv has been modernized.
7053     * The url crate is deprecated in favor of
7054       http://github.com/servo/rust-url, which can be installed with
7055       Cargo.
7056     * Most I/O stream types can be cloned and subsequently closed from
7057       a different thread.
7058     * A `std::time::Duration` type has been added for use in I/O
7059       methods that rely on timers, as well as in the 'time' crate's
7060       `Timespec` arithmetic.
7061     * The runtime I/O abstraction layer that enabled the green thread
7062       scheduler to do non-thread-blocking I/O has been removed, along
7063       with the libuv-based implementation employed by the green thread
7064       scheduler. This will greatly simplify the future I/O work.
7065     * `collections::btree` has been rewritten to have a more
7066       idiomatic and efficient design.
7067
7068   * Tooling
7069     * rustdoc output now indicates the stability levels of API's.
7070     * The `--crate-name` flag can specify the name of the crate
7071       being compiled, like `#[crate_name]`.
7072     * The `-C metadata` specifies additional metadata to hash into
7073       symbol names, and `-C extra-filename` specifies additional
7074       information to put into the output filename, for use by the
7075       package manager for versioning.
7076     * debug info generation has continued to improve and should be
7077       more reliable under both gdb and lldb.
7078     * rustc has experimental support for compiling in parallel
7079       using the `-C codegen-units` flag.
7080     * rustc no longer encodes rpath information into binaries by
7081       default.
7082
7083   * Misc
7084     * Stack usage has been optimized with LLVM lifetime annotations.
7085     * Official Rust binaries on Linux are more compatible with older
7086       kernels and distributions, built on CentOS 5.10.
7087
7088
7089 Version 0.11.0 (2014-07-02)
7090 ==========================
7091
7092   * ~1700 changes, numerous bugfixes
7093
7094   * Language
7095     * ~[T] has been removed from the language. This type is superseded by
7096       the Vec<T> type.
7097     * ~str has been removed from the language. This type is superseded by
7098       the String type.
7099     * ~T has been removed from the language. This type is superseded by the
7100       Box<T> type.
7101     * @T has been removed from the language. This type is superseded by the
7102       standard library's std::gc::Gc<T> type.
7103     * Struct fields are now all private by default.
7104     * Vector indices and shift amounts are both required to be a `uint`
7105       instead of any integral type.
7106     * Byte character, byte string, and raw byte string literals are now all
7107       supported by prefixing the normal literal with a `b`.
7108     * Multiple ABIs are no longer allowed in an ABI string
7109     * The syntax for lifetimes on closures/procedures has been tweaked
7110       slightly: `<'a>|A, B|: 'b + K -> T`
7111     * Floating point modulus has been removed from the language; however it
7112       is still provided by a library implementation.
7113     * Private enum variants are now disallowed.
7114     * The `priv` keyword has been removed from the language.
7115     * A closure can no longer be invoked through a &-pointer.
7116     * The `use foo, bar, baz;` syntax has been removed from the language.
7117     * The transmute intrinsic no longer works on type parameters.
7118     * Statics now allow blocks/items in their definition.
7119     * Trait bounds are separated from objects with + instead of : now.
7120     * Objects can no longer be read while they are mutably borrowed.
7121     * The address of a static is now marked as insignificant unless the
7122       #[inline(never)] attribute is placed it.
7123     * The #[unsafe_destructor] attribute is now behind a feature gate.
7124     * Struct literals are no longer allowed in ambiguous positions such as
7125       if, while, match, and for..in.
7126     * Declaration of lang items and intrinsics are now feature-gated by
7127       default.
7128     * Integral literals no longer default to `int`, and floating point
7129       literals no longer default to `f64`. Literals must be suffixed with an
7130       appropriate type if inference cannot determine the type of the
7131       literal.
7132     * The Box<T> type is no longer implicitly borrowed to &mut T.
7133     * Procedures are now required to not capture borrowed references.
7134
7135   * Libraries
7136     * The standard library is now a "facade" over a number of underlying
7137       libraries. This means that development on the standard library should
7138       be speedier due to smaller crates, as well as a clearer line between
7139       all dependencies.
7140     * A new library, libcore, lives under the standard library's facade
7141       which is Rust's "0-assumption" library, suitable for embedded and
7142       kernel development for example.
7143     * A regex crate has been added to the standard distribution. This crate
7144       includes statically compiled regular expressions.
7145     * The unwrap/unwrap_err methods on Result require a Show bound for
7146       better error messages.
7147     * The return types of the std::comm primitives have been centralized
7148       around the Result type.
7149     * A number of I/O primitives have gained the ability to time out their
7150       operations.
7151     * A number of I/O primitives have gained the ability to close their
7152       reading/writing halves to cancel pending operations.
7153     * Reverse iterator methods have been removed in favor of `rev()` on
7154       their forward-iteration counterparts.
7155     * A bitflags! macro has been added to enable easy interop with C and
7156       management of bit flags.
7157     * A debug_assert! macro is now provided which is disabled when
7158       `--cfg ndebug` is passed to the compiler.
7159     * A graphviz crate has been added for creating .dot files.
7160     * The std::cast module has been migrated into std::mem.
7161     * The std::local_data api has been migrated from freestanding functions
7162       to being based on methods.
7163     * The Pod trait has been renamed to Copy.
7164     * jemalloc has been added as the default allocator for types.
7165     * The API for allocating memory has been changed to use proper alignment
7166       and sized deallocation
7167     * Connecting a TcpStream or binding a TcpListener is now based on a
7168       string address and a u16 port. This allows connecting to a hostname as
7169       opposed to an IP.
7170     * The Reader trait now contains a core method, read_at_least(), which
7171       correctly handles many repeated 0-length reads.
7172     * The process-spawning API is now centered around a builder-style
7173       Command struct.
7174     * The :? printing qualifier has been moved from the standard library to
7175       an external libdebug crate.
7176     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
7177       have been renamed to Eq/Ord.
7178     * The select/plural methods have been removed from format!. The escapes
7179       for { and } have also changed from \{ and \} to {{ and }},
7180       respectively.
7181     * The TaskBuilder API has been re-worked to be a true builder, and
7182       extension traits for spawning native/green tasks have been added.
7183
7184   * Tooling
7185     * All breaking changes to the language or libraries now have their
7186       commit message annotated with `[breaking-change]` to allow for easy
7187       discovery of breaking changes.
7188     * The compiler will now try to suggest how to annotate lifetimes if a
7189       lifetime-related error occurs.
7190     * Debug info continues to be improved greatly with general bug fixes and
7191       better support for situations like link time optimization (LTO).
7192     * Usage of syntax extensions when cross-compiling has been fixed.
7193     * Functionality equivalent to GCC & Clang's -ffunction-sections,
7194       -fdata-sections and --gc-sections has been enabled by default
7195     * The compiler is now stricter about where it will load module files
7196       from when a module is declared via `mod foo;`.
7197     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
7198       Syntax extensions are now discovered via a "plugin registrar" type
7199       which will be extended in the future to other various plugins.
7200     * Lints have been restructured to allow for dynamically loadable lints.
7201     * A number of rustdoc improvements:
7202       * The HTML output has been visually redesigned.
7203       * Markdown is now powered by hoedown instead of sundown.
7204       * Searching heuristics have been greatly improved.
7205       * The search index has been reduced in size by a great amount.
7206       * Cross-crate documentation via `pub use` has been greatly improved.
7207       * Primitive types are now hyperlinked and documented.
7208     * Documentation has been moved from static.rust-lang.org/doc to
7209       doc.rust-lang.org
7210     * A new sandbox, play.rust-lang.org, is available for running and
7211       sharing rust code examples on-line.
7212     * Unused attributes are now more robustly warned about.
7213     * The dead_code lint now warns about unused struct fields.
7214     * Cross-compiling to iOS is now supported.
7215     * Cross-compiling to mipsel is now supported.
7216     * Stability attributes are now inherited by default and no longer apply
7217       to intra-crate usage, only inter-crate usage.
7218     * Error message related to non-exhaustive match expressions have been
7219       greatly improved.
7220
7221
7222 Version 0.10 (2014-04-03)
7223 =========================
7224
7225   * ~1500 changes, numerous bugfixes
7226
7227   * Language
7228     * A new RFC process is now in place for modifying the language.
7229     * Patterns with `@`-pointers have been removed from the language.
7230     * Patterns with unique vectors (`~[T]`) have been removed from the
7231       language.
7232     * Patterns with unique strings (`~str`) have been removed from the
7233       language.
7234     * `@str` has been removed from the language.
7235     * `@[T]` has been removed from the language.
7236     * `@self` has been removed from the language.
7237     * `@Trait` has been removed from the language.
7238     * Headers on `~` allocations which contain `@` boxes inside the type for
7239       reference counting have been removed.
7240     * The semantics around the lifetimes of temporary expressions have changed,
7241       see #3511 and #11585 for more information.
7242     * Cross-crate syntax extensions are now possible, but feature gated. See
7243       #11151 for more information. This includes both `macro_rules!` macros as
7244       well as syntax extensions such as `format!`.
7245     * New lint modes have been added, and older ones have been turned on to be
7246       warn-by-default.
7247       * Unnecessary parentheses
7248       * Uppercase statics
7249       * Camel Case types
7250       * Uppercase variables
7251       * Publicly visible private types
7252       * `#[deriving]` with raw pointers
7253     * Unsafe functions can no longer be coerced to closures.
7254     * Various obscure macros such as `log_syntax!` are now behind feature gates.
7255     * The `#[simd]` attribute is now behind a feature gate.
7256     * Visibility is no longer allowed on `extern crate` statements, and
7257       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
7258     * Trailing commas are now allowed in argument lists and tuple patterns.
7259     * The `do` keyword has been removed, it is now a reserved keyword.
7260     * Default type parameters have been implemented, but are feature gated.
7261     * Borrowed variables through captures in closures are now considered soundly.
7262     * `extern mod` is now `extern crate`
7263     * The `Freeze` trait has been removed.
7264     * The `Share` trait has been added for types that can be shared among
7265       threads.
7266     * Labels in macros are now hygienic.
7267     * Expression/statement macro invocations can be delimited with `{}` now.
7268     * Treatment of types allowed in `static mut` locations has been tweaked.
7269     * The `*` and `.` operators are now overloadable through the `Deref` and
7270       `DerefMut` traits.
7271     * `~Trait` and `proc` no longer have `Send` bounds by default.
7272     * Partial type hints are now supported with the `_` type marker.
7273     * An `Unsafe` type was introduced for interior mutability. It is now
7274       considered undefined to transmute from `&T` to `&mut T` without using the
7275       `Unsafe` type.
7276     * The #[linkage] attribute was implemented for extern statics/functions.
7277     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
7278     * `Pod` was renamed to `Copy`.
7279
7280   * Libraries
7281     * The `libextra` library has been removed. It has now been decomposed into
7282       component libraries with smaller and more focused nuggets of
7283       functionality. The full list of libraries can be found on the
7284       documentation index page.
7285     * std: `std::condition` has been removed. All I/O errors are now propagated
7286       through the `Result` type. In order to assist with error handling, a
7287       `try!` macro for unwrapping errors with an early return and a lint for
7288       unused results has been added. See #12039 for more information.
7289     * std: The `vec` module has been renamed to `slice`.
7290     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
7291       This will become the only growable vector in the future.
7292     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
7293       are now found at `std::io::BufferedReader` instead of
7294       `std::io::buffered::BufferedReader`.
7295     * std: `print` and `println` are no longer in the prelude, the `print!` and
7296       `println!` macros are intended to be used instead.
7297     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
7298       attempts to statically prevent cycles.
7299     * std: The standard distribution is adopting the policy of pushing failure
7300       to the user rather than failing in libraries. Many functions (such as
7301       `slice::last()`) now return `Option<T>` instead of `T` + failing.
7302     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
7303       deriving mode: `#[deriving(Show)]`.
7304     * std: `ToStr` is now implemented for all types implementing `Show`.
7305     * std: The formatting trait methods now take `&self` instead of `&T`
7306     * std: The `invert()` method on iterators has been renamed to `rev()`
7307     * std: `std::num` has seen a reduction in the genericity of its traits,
7308       consolidating functionality into a few core traits.
7309     * std: Backtraces are now printed on task failure if the environment
7310       variable `RUST_BACKTRACE` is present.
7311     * std: Naming conventions for iterators have been standardized. More details
7312       can be found on the wiki's style guide.
7313     * std: `eof()` has been removed from the `Reader` trait. Specific types may
7314       still implement the function.
7315     * std: Networking types are now cloneable to allow simultaneous reads/writes.
7316     * std: `assert_approx_eq!` has been removed
7317     * std: The `e` and `E` formatting specifiers for floats have been added to
7318       print them in exponential notation.
7319     * std: The `Times` trait has been removed
7320     * std: Indications of variance and opting out of builtin bounds is done
7321       through marker types in `std::kinds::marker` now
7322     * std: `hash` has been rewritten, `IterBytes` has been removed, and
7323       `#[deriving(Hash)]` is now possible.
7324     * std: `SharedChan` has been removed, `Sender` is now cloneable.
7325     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
7326     * std: `Chan::new` is now `channel()`.
7327     * std: A new synchronous channel type has been implemented.
7328     * std: A `select!` macro is now provided for selecting over `Receiver`s.
7329     * std: `hashmap` and `trie` have been moved to `libcollections`
7330     * std: `run` has been rolled into `io::process`
7331     * std: `assert_eq!` now uses `{}` instead of `{:?}`
7332     * std: The equality and comparison traits have seen some reorganization.
7333     * std: `rand` has moved to `librand`.
7334     * std: `to_{lower,upper}case` has been implemented for `char`.
7335     * std: Logging has been moved to `liblog`.
7336     * collections: `HashMap` has been rewritten for higher performance and less
7337       memory usage.
7338     * native: The default runtime is now `libnative`. If `libgreen` is desired,
7339       it can be booted manually. The runtime guide has more information and
7340       examples.
7341     * native: All I/O functionality except signals has been implemented.
7342     * green: Task spawning with `libgreen` has been optimized with stack caching
7343       and various trimming of code.
7344     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
7345     * sync: The `extra::sync` module has been updated to modern rust (and moved
7346       to the `sync` library), tweaking and improving various interfaces while
7347       dropping redundant functionality.
7348     * sync: A new `Barrier` type has been added to the `sync` library.
7349     * sync: An efficient mutex for native and green tasks has been implemented.
7350     * serialize: The `base64` module has seen some improvement. It treats
7351       newlines better, has non-string error values, and has seen general
7352       cleanup.
7353     * fourcc: A `fourcc!` macro was introduced
7354     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
7355       hexadecimal literal.
7356
7357   * Tooling
7358     * `rustpkg` has been deprecated and removed from the main repository. Its
7359       replacement, `cargo`, is under development.
7360     * Nightly builds of rust are now available
7361     * The memory usage of rustc has been improved many times throughout this
7362       release cycle.
7363     * The build process supports disabling rpath support for the rustc binary
7364       itself.
7365     * Code generation has improved in some cases, giving more information to the
7366       LLVM optimization passes to enable more extensive optimizations.
7367     * Debuginfo compatibility with lldb on OSX has been restored.
7368     * The master branch is now gated on an android bot, making building for
7369       android much more reliable.
7370     * Output flags have been centralized into one `--emit` flag.
7371     * Crate type flags have been centralized into one `--crate-type` flag.
7372     * Codegen flags have been consolidated behind a `-C` flag.
7373     * Linking against outdated crates now has improved error messages.
7374     * Error messages with lifetimes will often suggest how to annotate the
7375       function to fix the error.
7376     * Many more types are documented in the standard library, and new guides
7377       were written.
7378     * Many `rustdoc` improvements:
7379       * code blocks are syntax highlighted.
7380       * render standalone markdown files.
7381       * the --test flag tests all code blocks by default.
7382       * exported macros are displayed.
7383       * re-exported types have their documentation inlined at the location of the
7384         first re-export.
7385       * search works across crates that have been rendered to the same output
7386         directory.
7387
7388
7389 Version 0.9 (2014-01-09)
7390 ==========================
7391
7392    * ~1800 changes, numerous bugfixes
7393
7394    * Language
7395       * The `float` type has been removed. Use `f32` or `f64` instead.
7396       * A new facility for enabling experimental features (feature gating) has
7397         been added, using the crate-level `#[feature(foo)]` attribute.
7398       * Managed boxes (@) are now behind a feature gate
7399         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
7400         standard library's `Gc` or `Rc` types instead.
7401       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
7402       * Jumping back to the top of a loop is now done with `continue` instead of
7403         `loop`.
7404       * Strings can no longer be mutated through index assignment.
7405       * Raw strings can be created via the basic `r"foo"` syntax or with matched
7406         hash delimiters, as in `r###"foo"###`.
7407       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
7408         called once.
7409       * The `&fn` type is now written `|args| -> ret` to match the literal form.
7410       * `@fn`s have been removed.
7411       * `do` only works with procs in order to make it obvious what the cost
7412         of `do` is.
7413       * Single-element tuple-like structs can no longer be dereferenced to
7414         obtain the inner value. A more comprehensive solution for overloading
7415         the dereference operator will be provided in the future.
7416       * The `#[link(...)]` attribute has been replaced with
7417         `#[crate_id = "name#vers"]`.
7418       * Empty `impl`s must be terminated with empty braces and may not be
7419         terminated with a semicolon.
7420       * Keywords are no longer allowed as lifetime names; the `self` lifetime
7421         no longer has any special meaning.
7422       * The old `fmt!` string formatting macro has been removed.
7423       * `printf!` and `printfln!` (old-style formatting) removed in favor of
7424         `print!` and `println!`.
7425       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
7426       * The `extern mod foo (name = "bar")` syntax has been removed. Use
7427         `extern mod foo = "bar"` instead.
7428       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
7429       * Macros can have attributes.
7430       * Macros can expand to items with attributes.
7431       * Macros can expand to multiple items.
7432       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
7433       * Comments may be nested.
7434       * Values automatically coerce to trait objects they implement, without
7435         an explicit `as`.
7436       * Enum discriminants are no longer an entire word but as small as needed to
7437         contain all the variants. The `repr` attribute can be used to override
7438         the discriminant size, as in `#[repr(int)]` for integer-sized, and
7439         `#[repr(C)]` to match C enums.
7440       * Non-string literals are not allowed in attributes (they never worked).
7441       * The FFI now supports variadic functions.
7442       * Octal numeric literals, as in `0o7777`.
7443       * The `concat!` syntax extension performs compile-time string concatenation.
7444       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
7445         removed as Rust no longer uses segmented stacks.
7446       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
7447       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
7448         not `*`; ignoring remaining fields of a struct is also done with `..`,
7449         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
7450       * `rustc` supports the "win64" calling convention via `extern "win64"`.
7451       * `rustc` supports the "system" calling convention, which defaults to the
7452         preferred convention for the target platform, "stdcall" on 32-bit Windows,
7453         "C" elsewhere.
7454       * The `type_overflow` lint (default: warn) checks literals for overflow.
7455       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
7456       * The `attribute_usage` lint (default: warn) warns about unknown
7457         attributes.
7458       * The `unknown_features` lint (default: warn) warns about unknown
7459         feature gates.
7460       * The `dead_code` lint (default: warn) checks for dead code.
7461       * Rust libraries can be linked statically to one another
7462       * `#[link_args]` is behind the `link_args` feature gate.
7463       * Native libraries are now linked with `#[link(name = "foo")]`
7464       * Native libraries can be statically linked to a rust crate
7465         (`#[link(name = "foo", kind = "static")]`).
7466       * Native OS X frameworks are now officially supported
7467         (`#[link(name = "foo", kind = "framework")]`).
7468       * The `#[thread_local]` attribute creates thread-local (not task-local)
7469         variables. Currently behind the `thread_local` feature gate.
7470       * The `return` keyword may be used in closures.
7471       * Types that can be copied via a memcpy implement the `Pod` kind.
7472       * The `cfg` attribute can now be used on struct fields and enum variants.
7473
7474    * Libraries
7475       * std: The `option` and `result` API's have been overhauled to make them
7476         simpler, more consistent, and more composable.
7477       * std: The entire `std::io` module has been replaced with one that is
7478         more comprehensive and that properly interfaces with the underlying
7479         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
7480         implemented.
7481       * std: `io::util` contains a number of useful implementations of
7482         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
7483         `ZeroReader`, `TeeReader`.
7484       * std: The reference counted pointer type `extra::rc` moved into std.
7485       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
7486         just a wrapper around it).
7487       * std: The `Either` type has been removed.
7488       * std: `fmt::Default` can be implemented for any type to provide default
7489         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
7490       * std: The `rand` API continues to be tweaked.
7491       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
7492         on failure in gdb, is now named `rust_fail`.
7493       * std: The `each_key` and `each_value` methods on `HashMap` have been
7494         replaced by the `keys` and `values` iterators.
7495       * std: Functions dealing with type size and alignment have moved from the
7496         `sys` module to the `mem` module.
7497       * std: The `path` module was written and API changed.
7498       * std: `str::from_utf8` has been changed to cast instead of allocate.
7499       * std: `starts_with` and `ends_with` methods added to vectors via the
7500         `ImmutableEqVector` trait, which is in the prelude.
7501       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
7502         if the index is out of bounds.
7503       * std: Task failure no longer propagates between tasks, as the model was
7504         complex, expensive, and incompatible with thread-based tasks.
7505       * std: The `Any` type can be used for dynamic typing.
7506       * std: `~Any` can be passed to the `fail!` macro and retrieved via
7507         `task::try`.
7508       * std: Methods that produce iterators generally do not have an `_iter`
7509         suffix now.
7510       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
7511         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
7512       * std: `util::ignore` renamed to `prelude::drop`.
7513       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
7514         trait.
7515       * std: `vec::raw` has seen a lot of cleanup and API changes.
7516       * std: The standard library no longer includes any C++ code, and very
7517         minimal C, eliminating the dependency on libstdc++.
7518       * std: Runtime scheduling and I/O functionality has been factored out into
7519         extensible interfaces and is now implemented by two different crates:
7520         libnative, for native threading and I/O; and libgreen, for green threading
7521         and I/O. This paves the way for using the standard library in more limited
7522         embedded environments.
7523       * std: The `comm` module has been rewritten to be much faster, have a
7524         simpler, more consistent API, and to work for both native and green
7525         threading.
7526       * std: All libuv dependencies have been moved into the rustuv crate.
7527       * native: New implementations of runtime scheduling on top of OS threads.
7528       * native: New native implementations of TCP, UDP, file I/O, process spawning,
7529         and other I/O.
7530       * green: The green thread scheduler and message passing types are almost
7531         entirely lock-free.
7532       * extra: The `flatpipes` module had bitrotted and was removed.
7533       * extra: All crypto functions have been removed and Rust now has a policy of
7534         not reimplementing crypto in the standard library. In the future crypto
7535         will be provided by external crates with bindings to established libraries.
7536       * extra: `c_vec` has been modernized.
7537       * extra: The `sort` module has been removed. Use the `sort` method on
7538         mutable slices.
7539
7540    * Tooling
7541       * The `rust` and `rusti` commands have been removed, due to lack of
7542         maintenance.
7543       * `rustdoc` was completely rewritten.
7544       * `rustdoc` can test code examples in documentation.
7545       * `rustpkg` can test packages with the argument, 'test'.
7546       * `rustpkg` supports arbitrary dependencies, including C libraries.
7547       * `rustc`'s support for generating debug info is improved again.
7548       * `rustc` has better error reporting for unbalanced delimiters.
7549       * `rustc`'s JIT support was removed due to bitrot.
7550       * Executables and static libraries can be built with LTO (-Z lto)
7551       * `rustc` adds a `--dep-info` flag for communicating dependencies to
7552         build tools.
7553
7554
7555 Version 0.8 (2013-09-26)
7556 ============================
7557
7558    * ~2200 changes, numerous bugfixes
7559
7560    * Language
7561       * The `for` loop syntax has changed to work with the `Iterator` trait.
7562       * At long last, unwinding works on Windows.
7563       * Default methods are ready for use.
7564       * Many trait inheritance bugs fixed.
7565       * Owned and borrowed trait objects work more reliably.
7566       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
7567       * rustc can omit emission of code for the `debug!` macro if it is passed
7568         `--cfg ndebug`
7569       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
7570         for foo.rs, then foo/mod.rs, and will generate an error when both are
7571         present.
7572       * Strings no longer contain trailing nulls. The new `std::c_str` module
7573         provides new mechanisms for converting to C strings.
7574       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
7575       * The FFI has been overhauled such that foreign functions are called directly,
7576         instead of through a stack-switching wrapper.
7577       * Calling a foreign function must be done through a Rust function with the
7578         `#[fixed_stack_segment]` attribute.
7579       * The `externfn!` macro can be used to declare both a foreign function and
7580         a `#[fixed_stack_segment]` wrapper at once.
7581       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
7582       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
7583       * `priv` is disallowed everywhere except for struct fields and enum variants.
7584       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
7585       * `ref` bindings in irrefutable patterns work correctly now.
7586       * `char` is now prevented from containing invalid code points.
7587       * Casting to `bool` is no longer allowed.
7588       * `\0` is now accepted as an escape in chars and strings.
7589       * `yield` is a reserved keyword.
7590       * `typeof` is a reserved keyword.
7591       * Crates may be imported by URL with `extern mod foo = "url";`.
7592       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
7593       * Static vectors can be initialized with repeating elements,
7594         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
7595       * Static structs can be initialized with functional record update,
7596         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
7597       * `cfg!` can be used to conditionally execute code based on the crate
7598         configuration, similarly to `#[cfg(...)]`.
7599       * The `unnecessary_qualification` lint detects unneeded module
7600         prefixes (default: allow).
7601       * Arithmetic operations have been implemented on the SIMD types in
7602         `std::unstable::simd`.
7603       * Exchange allocation headers were removed, reducing memory usage.
7604       * `format!` implements a completely new, extensible, and higher-performance
7605         string formatting system. It will replace `fmt!`.
7606       * `print!` and `println!` write formatted strings (using the `format!`
7607         extension) to stdout.
7608       * `write!` and `writeln!` write formatted strings (using the `format!`
7609         extension) to the new Writers in `std::rt::io`.
7610       * The library section in which a function or static is placed may
7611         be specified with `#[link_section = "..."]`.
7612       * The `proto!` syntax extension for defining bounded message protocols
7613         was removed.
7614       * `macro_rules!` is hygienic for `let` declarations.
7615       * The `#[export_name]` attribute specifies the name of a symbol.
7616       * `unreachable!` can be used to indicate unreachable code, and fails
7617         if executed.
7618
7619    * Libraries
7620       * std: Transitioned to the new runtime, written in Rust.
7621       * std: Added an experimental I/O library, `rt::io`, based on the new
7622         runtime.
7623       * std: A new generic `range` function was added to the prelude, replacing
7624         `uint::range` and friends.
7625       * std: `range_rev` no longer exists. Since range is an iterator it can be
7626         reversed with `range(lo, hi).invert()`.
7627       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
7628         renamed to `unwrap_or`.
7629       * std: The `iterator` module was renamed to `iter`.
7630       * std: Integral types now support the `checked_add`, `checked_sub`, and
7631         `checked_mul` operations for detecting overflow.
7632       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
7633         consistency.
7634       * std: Methods are standardizing on conventions for casting methods:
7635         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
7636         and cheap casts.
7637       * std: The `CString` type in `c_str` provides new ways to convert to and
7638         from C strings.
7639       * std: `DoubleEndedIterator` can yield elements in two directions.
7640       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
7641         two splices.
7642       * std: `str::from_bytes` renamed to `str::from_utf8`.
7643       * std: `pop_opt` and `shift_opt` methods added to vectors.
7644       * std: The task-local data interface no longer uses @, and keys are
7645         no longer function pointers.
7646       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
7647       * std: Added `SharedPort` to `comm`.
7648       * std: `Eq` has a default method for `ne`; only `eq` is required
7649         in implementations.
7650       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
7651         is required in implementations.
7652       * std: `is_utf8` performance is improved, impacting many string functions.
7653       * std: `os::MemoryMap` provides cross-platform mmap.
7654       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
7655         are not 'in-bounds' are considered undefined.
7656       * std: Many freestanding functions in `vec` removed in favor of methods.
7657       * std: Many freestanding functions on scalar types removed in favor of
7658         methods.
7659       * std: Many options to task builders were removed since they don't make
7660         sense in the new scheduler design.
7661       * std: More containers implement `FromIterator` so can be created by the
7662         `collect` method.
7663       * std: More complete atomic types in `unstable::atomics`.
7664       * std: `comm::PortSet` removed.
7665       * std: Mutating methods in the `Set` and `Map` traits have been moved into
7666         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
7667         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
7668         default implementations.
7669       * std: Various `from_str` functions were removed in favor of a generic
7670         `from_str` which is available in the prelude.
7671       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
7672       * extra: `dlist`, the doubly-linked list was modernized.
7673       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
7674       * extra: Added `glob` module, replacing `std::os::glob`.
7675       * extra: `rope` was removed.
7676       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
7677       * extra: `net`, and `timer` were removed. The experimental replacements
7678         are `std::rt::io::net` and `std::rt::io::timer`.
7679       * extra: Iterators implemented for `SmallIntMap`.
7680       * extra: Iterators implemented for `Bitv` and `BitvSet`.
7681       * extra: `SmallIntSet` removed. Use `BitvSet`.
7682       * extra: Performance of JSON parsing greatly improved.
7683       * extra: `semver` updated to SemVer 2.0.0.
7684       * extra: `term` handles more terminals correctly.
7685       * extra: `dbg` module removed.
7686       * extra: `par` module removed.
7687       * extra: `future` was cleaned up, with some method renames.
7688       * extra: Most free functions in `getopts` were converted to methods.
7689
7690    * Other
7691       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
7692       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
7693         similarly to gcc's `--march` flag.
7694       * rustc's performance compiling small crates is much better.
7695       * rustpkg has received many improvements.
7696       * rustpkg supports git tags as package IDs.
7697       * rustpkg builds into target-specific directories so it can be used for
7698         cross-compiling.
7699       * The number of concurrent test tasks is controlled by the environment
7700         variable RUST_TEST_TASKS.
7701       * The test harness can now report metrics for benchmarks.
7702       * All tools have man pages.
7703       * Programs compiled with `--test` now support the `-h` and `--help` flags.
7704       * The runtime uses jemalloc for allocations.
7705       * Segmented stacks are temporarily disabled as part of the transition to
7706         the new runtime. Stack overflows are possible!
7707       * A new documentation backend, rustdoc_ng, is available for use. It is
7708         still invoked through the normal `rustdoc` command.
7709
7710
7711 Version 0.7 (2013-07-03)
7712 =======================
7713
7714    * ~2000 changes, numerous bugfixes
7715
7716    * Language
7717       * `impl`s no longer accept a visibility qualifier. Put them on methods
7718         instead.
7719       * The borrow checker has been rewritten with flow-sensitivity, fixing
7720         many bugs and inconveniences.
7721       * The `self` parameter no longer implicitly means `&'self self`,
7722         and can be explicitly marked with a lifetime.
7723       * Overloadable compound operators (`+=`, etc.) have been temporarily
7724         removed due to bugs.
7725       * The `for` loop protocol now requires `for`-iterators to return `bool`
7726         so they compose better.
7727       * The `Durable` trait is replaced with the `'static` bounds.
7728       * Trait default methods work more often.
7729       * Structs with the `#[packed]` attribute have byte alignment and
7730         no padding between fields.
7731       * Type parameters bound by `Copy` must now be copied explicitly with
7732         the `copy` keyword.
7733       * It is now illegal to move out of a dereferenced unsafe pointer.
7734       * `Option<~T>` is now represented as a nullable pointer.
7735       * `@mut` does dynamic borrow checks correctly.
7736       * The `main` function is only detected at the topmost level of the crate.
7737         The `#[main]` attribute is still valid anywhere.
7738       * Struct fields may no longer be mutable. Use inherited mutability.
7739       * The `#[no_send]` attribute makes a type that would otherwise be
7740         `Send`, not.
7741       * The `#[no_freeze]` attribute makes a type that would otherwise be
7742         `Freeze`, not.
7743       * Unbounded recursion will abort the process after reaching the limit
7744         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
7745       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
7746         are never implicitly copyable.
7747       * `#[static_assert]` makes compile-time assertions about static bools.
7748       * At long last, 'argument modes' no longer exist.
7749       * The rarely used `use mod` statement no longer exists.
7750
7751    * Syntax extensions
7752       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
7753         argument list.
7754       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
7755         `Rand`, `Zero` and `ToStr` can all be automatically derived with
7756         `#[deriving(...)]`.
7757       * The `bytes!` macro returns a vector of bytes for string, u8, char,
7758         and unsuffixed integer literals.
7759
7760    * Libraries
7761       * The `core` crate was renamed to `std`.
7762       * The `std` crate was renamed to `extra`.
7763       * More and improved documentation.
7764       * std: `iterator` module for external iterator objects.
7765       * Many old-style (internal, higher-order function) iterators replaced by
7766         implementations of `Iterator`.
7767       * std: Many old internal vector and string iterators,
7768         incl. `any`, `all`. removed.
7769       * std: The `finalize` method of `Drop` renamed to `drop`.
7770       * std: The `drop` method now takes `&mut self` instead of `&self`.
7771       * std: The prelude no longer re-exports any modules, only types and traits.
7772       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
7773         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
7774       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
7775         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
7776       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
7777         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
7778       * std: Many types implement `Clone`.
7779       * std: `path` type renamed to `Path`.
7780       * std: `mut` module and `Mut` type removed.
7781       * std: Many standalone functions removed in favor of methods and iterators
7782         in `vec`, `str`. In the future methods will also work as functions.
7783       * std: `reinterpret_cast` removed. Use `transmute`.
7784       * std: ascii string handling in `std::ascii`.
7785       * std: `Rand` is implemented for ~/@.
7786       * std: `run` module for spawning processes overhauled.
7787       * std: Various atomic types added to `unstable::atomic`.
7788       * std: Various types implement `Zero`.
7789       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
7790       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
7791       * std: Added `os::mkdir_recursive`.
7792       * std: Added `os::glob` function performs filesystems globs.
7793       * std: `FuzzyEq` renamed to `ApproxEq`.
7794       * std: `Map` now defines `pop` and `swap` methods.
7795       * std: `Cell` constructors converted to static methods.
7796       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
7797       * extra: `flate` module moved from `std` to `extra`.
7798       * extra: `fileinput` module for iterating over a series of files.
7799       * extra: `Complex` number type and `complex` module.
7800       * extra: `Rational` number type and `rational` module.
7801       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
7802       * extra: `term` uses terminfo now, is more correct.
7803       * extra: `arc` functions converted to methods.
7804       * extra: Implementation of fixed output size variations of SHA-2.
7805
7806    * Tooling
7807       * `unused_variable`  lint mode for unused variables (default: warn).
7808       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
7809         (default: warn).
7810       * `unused_mut` lint mode for identifying unused `mut` qualifiers
7811         (default: warn).
7812       * `dead_assignment` lint mode for unread variables (default: warn).
7813       * `unnecessary_allocation` lint mode detects some heap allocations that are
7814         immediately borrowed so could be written without allocating (default: warn).
7815       * `missing_doc` lint mode (default: allow).
7816       * `unreachable_code` lint mode (default: warn).
7817       * The `rusti` command has been rewritten and a number of bugs addressed.
7818       * rustc outputs in color on more terminals.
7819       * rustc accepts a `--link-args` flag to pass arguments to the linker.
7820       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
7821       * Compiling with `-g` will make the binary record information about
7822         dynamic borrowcheck failures for debugging.
7823       * rustdoc has a nicer stylesheet.
7824       * Various improvements to rustdoc.
7825       * Improvements to rustpkg (see the detailed release notes).
7826
7827
7828 Version 0.6 (2013-04-03)
7829 ========================
7830
7831    * ~2100 changes, numerous bugfixes
7832
7833    * Syntax changes
7834       * The self type parameter in traits is now spelled `Self`
7835       * The `self` parameter in trait and impl methods must now be explicitly
7836         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
7837       * Static methods no longer require the `static` keyword and instead
7838         are distinguished by the lack of a `self` parameter
7839       * Replaced the `Durable` trait with the `'static` lifetime
7840       * The old closure type syntax with the trailing sigil has been
7841         removed in favor of the more consistent leading sigil
7842       * `super` is a keyword, and may be prefixed to paths
7843       * Trait bounds are separated with `+` instead of whitespace
7844       * Traits are implemented with `impl Trait for Type`
7845         instead of `impl Type: Trait`
7846       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
7847       * The `export` keyword has finally been removed
7848       * The `move` keyword has been removed (see "Semantic changes")
7849       * The interior mutability qualifier on vectors, `[mut T]`, has been
7850         removed. Use `&mut [T]`, etc.
7851       * `mut` is no longer valid in `~mut T`. Use inherited mutability
7852       * `fail` is no longer a keyword. Use `fail!()`
7853       * `assert` is no longer a keyword. Use `assert!()`
7854       * `log` is no longer a keyword. use `debug!`, etc.
7855       * 1-tuples may be represented as `(T,)`
7856       * Struct fields may no longer be `mut`. Use inherited mutability,
7857         `@mut T`, `core::mut` or `core::cell`
7858       * `extern mod { ... }` is no longer valid syntax for foreign
7859         function modules. Use extern blocks: `extern { ... }`
7860       * Newtype enums removed. Use tuple-structs.
7861       * Trait implementations no longer support visibility modifiers
7862       * Pattern matching over vectors improved and expanded
7863       * `const` renamed to `static` to correspond to lifetime name,
7864         and make room for future `static mut` unsafe mutable globals.
7865       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
7866       * `Clone` implementations can be automatically generated with
7867         `#[deriving(Clone)]`
7868       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
7869         instead of `foo as Bar`.
7870       * Fixed length vector types are now written as `[int, .. 3]`
7871         instead of `[int * 3]`.
7872       * Fixed length vector types can express the length as a constant
7873         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
7874
7875    * Semantic changes
7876       * Types with owned pointers or custom destructors move by default,
7877         eliminating the `move` keyword
7878       * All foreign functions are considered unsafe
7879       * &mut is now unaliasable
7880       * Writes to borrowed @mut pointers are prevented dynamically
7881       * () has size 0
7882       * The name of the main function can be customized using #[main]
7883       * The default type of an inferred closure is &fn instead of @fn
7884       * `use` statements may no longer be "chained" - they cannot import
7885         identifiers imported by previous `use` statements
7886       * `use` statements are crate relative, importing from the "top"
7887         of the crate by default. Paths may be prefixed with `super::`
7888         or `self::` to change the search behavior.
7889       * Method visibility is inherited from the implementation declaration
7890       * Structural records have been removed
7891       * Many more types can be used in static items, including enums
7892         'static-lifetime pointers and vectors
7893       * Pattern matching over vectors improved and expanded
7894       * Typechecking of closure types has been overhauled to
7895         improve inference and eliminate unsoundness
7896       * Macros leave scope at the end of modules, unless that module is
7897         tagged with #[macro_escape]
7898
7899    * Libraries
7900       * Added big integers to `std::bigint`
7901       * Removed `core::oldcomm` module
7902       * Added pipe-based `core::comm` module
7903       * Numeric traits have been reorganized under `core::num`
7904       * `vec::slice` finally returns a slice
7905       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
7906       * Containers reorganized around traits in `core::container`
7907       * `core::dvec` removed, `~[T]` is a drop-in replacement
7908       * `core::send_map` renamed to `core::hashmap`
7909       * `std::map` removed; replaced with `core::hashmap`
7910       * `std::treemap` reimplemented as an owned balanced tree
7911       * `std::deque` and `std::smallintmap` reimplemented as owned containers
7912       * `core::trie` added as a fast ordered map for integer keys
7913       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
7914       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
7915         overload the comparison operators, whereas `TotalOrd` is used
7916         by certain container types
7917
7918    * Other
7919       * Replaced the 'cargo' package manager with 'rustpkg'
7920       * Added all-purpose 'rust' tool
7921       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
7922       * rustc now *attempts* to offer spelling suggestions
7923       * Improved support for ARM and Android
7924       * Preliminary MIPS backend
7925       * Improved foreign function ABI implementation for x86, x86_64
7926       * Various memory usage improvements
7927       * Rust code may be embedded in foreign code under limited circumstances
7928       * Inline assembler supported by new asm!() syntax extension.
7929
7930
7931 Version 0.5 (2012-12-21)
7932 ===========================
7933
7934    * ~900 changes, numerous bugfixes
7935
7936    * Syntax changes
7937       * Removed `<-` move operator
7938       * Completed the transition from the `#fmt` extension syntax to `fmt!`
7939       * Removed old fixed length vector syntax - `[T]/N`
7940       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
7941       * Macros may now expand to items and statements
7942       * `a.b()` is always parsed as a method call, never as a field projection
7943       * `Eq` and `IterBytes` implementations can be automatically generated
7944         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
7945       * Removed the special crate language for `.rc` files
7946       * Function arguments may consist of any irrefutable pattern
7947
7948    * Semantic changes
7949       * `&` and `~` pointers may point to objects
7950       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
7951       * Enum variants may be structs
7952       * Destructors can be added to all nominal types with the Drop trait
7953       * Structs and nullary enum variants may be constants
7954       * Values that cannot be implicitly copied are now automatically moved
7955         without writing `move` explicitly
7956       * `&T` may now be coerced to `*T`
7957       * Coercions happen in `let` statements as well as function calls
7958       * `use` statements now take crate-relative paths
7959       * The module and type namespaces have been merged so that static
7960         method names can be resolved under the trait in which they are
7961         declared
7962
7963    * Improved support for language features
7964       * Trait inheritance works in many scenarios
7965       * More support for explicit self arguments in methods - `self`, `&self`
7966         `@self`, and `~self` all generally work as expected
7967       * Static methods work in more situations
7968       * Experimental: Traits may declare default methods for the implementations
7969         to use
7970
7971    * Libraries
7972       * New condition handling system in `core::condition`
7973       * Timsort added to `std::sort`
7974       * New priority queue, `std::priority_queue`
7975       * Pipes for serializable types, `std::flatpipes'
7976       * Serialization overhauled to be trait-based
7977       * Expanded `getopts` definitions
7978       * Moved futures to `std`
7979       * More functions are pure now
7980       * `core::comm` renamed to `oldcomm`. Still deprecated
7981       * `rustdoc` and `cargo` are libraries now
7982
7983    * Misc
7984       * Added a preliminary REPL, `rusti`
7985       * License changed from MIT to dual MIT/APL2
7986
7987
7988 Version 0.4 (2012-10-15)
7989 ==========================
7990
7991    * ~2000 changes, numerous bugfixes
7992
7993    * Syntax
7994       * All keywords are now strict and may not be used as identifiers anywhere
7995       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
7996         'of', 'with', 'to', 'class'.
7997       * Classes are replaced with simpler structs
7998       * Explicit method self types
7999       * `ret` became `return` and `alt` became `match`
8000       * `import` is now `use`; `use is now `extern mod`
8001       * `extern mod { ... }` is now `extern { ... }`
8002       * `use mod` is the recommended way to import modules
8003       * `pub` and `priv` replace deprecated export lists
8004       * The syntax of `match` pattern arms now uses fat arrow (=>)
8005       * `main` no longer accepts an args vector; use `os::args` instead
8006
8007    * Semantics
8008       * Trait implementations are now coherent, ala Haskell typeclasses
8009       * Trait methods may be static
8010       * Argument modes are deprecated
8011       * Borrowed pointers are much more mature and recommended for use
8012       * Strings and vectors in the static region are stored in constant memory
8013       * Typestate was removed
8014       * Resolution rewritten to be more reliable
8015       * Support for 'dual-mode' data structures (freezing and thawing)
8016
8017    * Libraries
8018       * Most binary operators can now be overloaded via the traits in
8019         `core::ops'
8020       * `std::net::url` for representing URLs
8021       * Sendable hash maps in `core::send_map`
8022       * `core::task' gained a (currently unsafe) task-local storage API
8023
8024    * Concurrency
8025       * An efficient new intertask communication primitive called the pipe,
8026         along with a number of higher-level channel types, in `core::pipes`
8027       * `std::arc`, an atomically reference counted, immutable, shared memory
8028         type
8029       * `std::sync`, various exotic synchronization tools based on arcs and pipes
8030       * Futures are now based on pipes and sendable
8031       * More robust linked task failure
8032       * Improved task builder API
8033
8034    * Other
8035       * Improved error reporting
8036       * Preliminary JIT support
8037       * Preliminary work on precise GC
8038       * Extensive architectural improvements to rustc
8039       * Begun a transition away from buggy C++-based reflection (shape) code to
8040         Rust-based (visitor) code
8041       * All hash functions and tables converted to secure, randomized SipHash
8042
8043
8044 Version 0.3  (2012-07-12)
8045 ========================
8046
8047    * ~1900 changes, numerous bugfixes
8048
8049    * New coding conveniences
8050       * Integer-literal suffix inference
8051       * Per-item control over warnings, errors
8052       * #[cfg(windows)] and #[cfg(unix)] attributes
8053       * Documentation comments
8054       * More compact closure syntax
8055       * 'do' expressions for treating higher-order functions as
8056         control structures
8057       * *-patterns (wildcard extended to all constructor fields)
8058
8059    * Semantic cleanup
8060       * Name resolution pass and exhaustiveness checker rewritten
8061       * Region pointers and borrow checking supersede alias
8062         analysis
8063       * Init-ness checking is now provided by a region-based liveness
8064         pass instead of the typestate pass; same for last-use analysis
8065       * Extensive work on region pointers
8066
8067    * Experimental new language features
8068       * Slices and fixed-size, interior-allocated vectors
8069       * #!-comments for lang versioning, shell execution
8070       * Destructors and iface implementation for classes;
8071         type-parameterized classes and class methods
8072       * 'const' type kind for types that can be used to implement
8073         shared-memory concurrency patterns
8074
8075    * Type reflection
8076
8077    * Removal of various obsolete features
8078       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
8079                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
8080
8081       * Constructs: do-while loops ('do' repurposed), fn binding,
8082                     resources (replaced by destructors)
8083
8084    * Compiler reorganization
8085       * Syntax-layer of compiler split into separate crate
8086       * Clang (from LLVM project) integrated into build
8087       * Typechecker split into sub-modules
8088
8089    * New library code
8090       * New time functions
8091       * Extension methods for many built-in types
8092       * Arc: atomic-refcount read-only / exclusive-use shared cells
8093       * Par: parallel map and search routines
8094       * Extensive work on libuv interface
8095       * Much vector code moved to libraries
8096       * Syntax extensions: #line, #col, #file, #mod, #stringify,
8097         #include, #include_str, #include_bin
8098
8099    * Tool improvements
8100       * Cargo automatically resolves dependencies
8101
8102
8103 Version 0.2  (2012-03-29)
8104 =========================
8105
8106    * >1500 changes, numerous bugfixes
8107
8108    * New docs and doc tooling
8109
8110    * New port: FreeBSD x86_64
8111
8112    * Compilation model enhancements
8113       * Generics now specialized, multiply instantiated
8114       * Functions now inlined across separate crates
8115
8116    * Scheduling, stack and threading fixes
8117       * Noticeably improved message-passing performance
8118       * Explicit schedulers
8119       * Callbacks from C
8120       * Helgrind clean
8121
8122    * Experimental new language features
8123       * Operator overloading
8124       * Region pointers
8125       * Classes
8126
8127    * Various language extensions
8128       * C-callback function types: 'crust fn ...'
8129       * Infinite-loop construct: 'loop { ... }'
8130       * Shorten 'mutable' to 'mut'
8131       * Required mutable-local qualifier: 'let mut ...'
8132       * Basic glob-exporting: 'export foo::*;'
8133       * Alt now exhaustive, 'alt check' for runtime-checked
8134       * Block-function form of 'for' loop, with 'break' and 'ret'.
8135
8136    * New library code
8137       * AST quasi-quote syntax extension
8138       * Revived libuv interface
8139       * New modules: core::{future, iter}, std::arena
8140       * Merged per-platform std::{os*, fs*} to core::{libc, os}
8141       * Extensive cleanup, regularization in libstd, libcore
8142
8143
8144 Version 0.1  (2012-01-20)
8145 ===============================
8146
8147    * Most language features work, including:
8148       * Unique pointers, unique closures, move semantics
8149       * Interface-constrained generics
8150       * Static interface dispatch
8151       * Stack growth
8152       * Multithread task scheduling
8153       * Typestate predicates
8154       * Failure unwinding, destructors
8155       * Pattern matching and destructuring assignment
8156       * Lightweight block-lambda syntax
8157       * Preliminary macro-by-example
8158
8159    * Compiler works with the following configurations:
8160       * Linux: x86 and x86_64 hosts and targets
8161       * macOS: x86 and x86_64 hosts and targets
8162       * Windows: x86 hosts and targets
8163
8164    * Cross compilation / multi-target configuration supported.
8165
8166    * Preliminary API-documentation and package-management tools included.
8167
8168 Known issues:
8169
8170    * Documentation is incomplete.
8171
8172    * Performance is below intended target.
8173
8174    * Standard library APIs are subject to extensive change, reorganization.
8175
8176    * Language-level versioning is not yet operational - future code will
8177      break unexpectedly.