RELEASES.md

   1 Version 1.41.0 (2020-01-30)
   2 ===========================
   3
   4 Language
   5 --------
   6
   7 - [You can now pass type parameters to foreign items when implementing
   8   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
   9 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
  10   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
  11   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
  12 - [You can now use any valid identifier in a `format_args` macro.][66847]
  13   Previously identifiers starting with an underscore were not allowed.
  14 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
  15   enum variants.][66183] These are still rejected semantically, but
  16   can be seen and parsed by procedural macros and conditional compilation.
  17
  18 Compiler
  19 --------
  20
  21 - [Rustc will now warn if you have unused loop `'label`s.][66325]
  22 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
  23 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
  24 - [You can now pass an arguments file passing the `@path` syntax
  25   to rustc.][66172] Note that the format differs somewhat from what is
  26   found in other tooling; please see [the documentation][argfile-docs] for
  27   more information.
  28 - [You can now provide `--extern` flag without a path, indicating that it is
  29   available from the search path or specified with an `-L` flag.][64882]
  30
  31 \* Refer to Rust's [platform support page][forge-platform-support] for more
  32 information on Rust's tiered platform support.
  33
  34 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
  35
  36 Libraries
  37 ---------
  38
  39 - [The `core::panic` module is now stable.][66771] It was already stable
  40   through `std`.
  41 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
  42   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
  43 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
  44
  45 Stabilized APIs
  46 ---------------
  47
  48 - [`Result::map_or`]
  49 - [`Result::map_or_else`]
  50 - [`std::rc::Weak::weak_count`]
  51 - [`std::rc::Weak::strong_count`]
  52 - [`std::sync::Weak::weak_count`]
  53 - [`std::sync::Weak::strong_count`]
  54
  55 Cargo
  56 -----
  57
  58 - [Cargo will now document all the private items for binary crates
  59   by default.][cargo/7593]
  60 - [`cargo-install` will now reinstall the package if it detects that it is out
  61   of date.][cargo/7560]
  62 - [Cargo.lock now uses a more git friendly format that should help to reduce
  63   merge conflicts.][cargo/7579]
  64 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
  65   `[profile.dev.overrides.image] opt-level = 2` sets the `image` crate's
  66   optimisation level to `2` for debug builds. You can also use
  67   `[profile.<profile>.build_overrides]` to override build scripts and
  68   their dependencies.
  69
  70 Misc
  71 ----
  72
  73 - [You can now specify `edition` in documentation code blocks to compile the block
  74   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
  75   should be compiled the 2018 edition of Rust.
  76 - [You can now provide custom themes to rustdoc with `--theme`, and check the
  77   current theme with `--check-theme`.][54733]
  78 - [You can use `#[doc(cfg(item))]` to document that a item is only available with
  79   certain features.][61351]
  80
  81 Compatibility Notes
  82 -------------------
  83
  84 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
  85   Apple targets.][apple-32bit-drop] This means that the source code is still
  86   available to build, but the targets are no longer being tested and release
  87   binaries for those platforms will no longer be distributed by the Rust project.
  88   Please refer to the linked blog post for more information.
  89
  90 [54733]: https://github.com/rust-lang/rust/pull/54733/
  91 [61351]: https://github.com/rust-lang/rust/pull/61351/
  92 [67255]: https://github.com/rust-lang/rust/pull/67255/
  93 [66661]: https://github.com/rust-lang/rust/pull/66661/
  94 [66771]: https://github.com/rust-lang/rust/pull/66771/
  95 [66847]: https://github.com/rust-lang/rust/pull/66847/
  96 [66238]: https://github.com/rust-lang/rust/pull/66238/
  97 [66277]: https://github.com/rust-lang/rust/pull/66277/
  98 [66325]: https://github.com/rust-lang/rust/pull/66325/
  99 [66172]: https://github.com/rust-lang/rust/pull/66172/
 100 [66183]: https://github.com/rust-lang/rust/pull/66183/
 101 [65879]: https://github.com/rust-lang/rust/pull/65879/
 102 [65013]: https://github.com/rust-lang/rust/pull/65013/
 103 [64882]: https://github.com/rust-lang/rust/pull/64882/
 104 [64325]: https://github.com/rust-lang/rust/pull/64325/
 105 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
 106 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
 107 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
 108 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
 109 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
 110 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
 111 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
 112 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
 113 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
 114 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
 115 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
 116
 117 Version 1.40.0 (2019-12-19)
 118 ===========================
 119
 120 Language
 121 --------
 122 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
 123   `const` contexts.][65188] e.g.
 124
 125   ```rust
 126   pub struct Point(i32, i32);
 127
 128   const ORIGIN: Point = {
 129       let constructor = Point;
 130
 131       constructor(0, 0)
 132   };
 133   ```
 134
 135 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
 136   indicate that there may be variants or fields added in the future.][64639]
 137   For example this requires adding a wild-card branch (`_ => {}`) to any match
 138   statements on a non-exhaustive `enum`. [(RFC 2008)]
 139 - [You can now use function-like procedural macros in `extern` blocks and in
 140   type positions.][63931] e.g. `type Generated = macro!();`
 141 - [Function-like and attribute procedural macros can now emit
 142   `macro_rules!` items, so you can now have your macros generate macros.][64035]
 143 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
 144   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
 145   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
 146
 147 Compiler
 148 --------
 149 - [Added tier 3 support\* for the
 150   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
 151 - [Added tier 3 support for the
 152   `aarch64-unknown-none-softfloat` target.][64589]
 153 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
 154   `mips64el-unknown-linux-muslabi64` targets.][65843]
 155
 156 \* Refer to Rust's [platform support page][forge-platform-support] for more
 157   information on Rust's tiered platform support.
 158
 159 Libraries
 160 ---------
 161 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
 162
 163 Stabilized APIs
 164 ---------------
 165 - [`BTreeMap::get_key_value`]
 166 - [`HashMap::get_key_value`]
 167 - [`Option::as_deref_mut`]
 168 - [`Option::as_deref`]
 169 - [`Option::flatten`]
 170 - [`UdpSocket::peer_addr`]
 171 - [`f32::to_be_bytes`]
 172 - [`f32::to_le_bytes`]
 173 - [`f32::to_ne_bytes`]
 174 - [`f64::to_be_bytes`]
 175 - [`f64::to_le_bytes`]
 176 - [`f64::to_ne_bytes`]
 177 - [`f32::from_be_bytes`]
 178 - [`f32::from_le_bytes`]
 179 - [`f32::from_ne_bytes`]
 180 - [`f64::from_be_bytes`]
 181 - [`f64::from_le_bytes`]
 182 - [`f64::from_ne_bytes`]
 183 - [`mem::take`]
 184 - [`slice::repeat`]
 185 - [`todo!`]
 186
 187 Cargo
 188 -----
 189 - [Cargo will now always display warnings, rather than only on
 190   fresh builds.][cargo/7450]
 191 - [Feature flags (except `--all-features`) passed to a virtual workspace will
 192   now produce an error.][cargo/7507] Previously these flags were ignored.
 193 - [You can now publish `dev-dependencies` without including
 194   a `version`.][cargo/7333]
 195
 196 Misc
 197 ----
 198 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
 199   when running documentation tests with `rustdoc`.][63803]
 200
 201 Compatibility Notes
 202 -------------------
 203 - [As previously announced, any previous NLL warnings in the 2015 edition are
 204   now hard errors.][64221]
 205 - [The `include!` macro will now warn if it failed to include the
 206   entire file.][64284] The `include!` macro unintentionally only includes the
 207   first _expression_ in a file, and this can be unintuitive. This will become
 208   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
 209 - [Using `#[inline]` on function prototypes and consts now emits a warning under
 210   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
 211   or `extern` blocks now correctly emits a hard error.
 212
 213 [65294]: https://github.com/rust-lang/rust/pull/65294/
 214 [66103]: https://github.com/rust-lang/rust/pull/66103/
 215 [65843]: https://github.com/rust-lang/rust/pull/65843/
 216 [65188]: https://github.com/rust-lang/rust/pull/65188/
 217 [65092]: https://github.com/rust-lang/rust/pull/65092/
 218 [64589]: https://github.com/rust-lang/rust/pull/64589/
 219 [64639]: https://github.com/rust-lang/rust/pull/64639/
 220 [64221]: https://github.com/rust-lang/rust/pull/64221/
 221 [64284]: https://github.com/rust-lang/rust/pull/64284/
 222 [63931]: https://github.com/rust-lang/rust/pull/63931/
 223 [64035]: https://github.com/rust-lang/rust/pull/64035/
 224 [63674]: https://github.com/rust-lang/rust/pull/63674/
 225 [63803]: https://github.com/rust-lang/rust/pull/63803/
 226 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
 227 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
 228 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
 229 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
 230 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
 231 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
 232 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
 233 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
 234 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
 235 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
 236 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
 237 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
 238 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
 239 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
 240 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
 241 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
 242 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
 243 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
 244 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
 245 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
 246 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
 247 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
 248 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
 249 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
 250 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
 251 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
 252
 253
 254 Version 1.39.0 (2019-11-07)
 255 ===========================
 256
 257 Language
 258 --------
 259 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
 260   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
 261 - [You can now use certain attributes on function, closure, and function pointer
 262   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
 263   `deny`, `forbid` as well as inert helper attributes used by procedural macro
 264   attributes applied to items. e.g.
 265   ```rust
 266   fn len(
 267       #[cfg(windows)] slice: &[u16],
 268       #[cfg(not(windows))] slice: &[u8],
 269   ) -> usize {
 270       slice.len()
 271   }
 272   ```
 273 - [You can now take shared references to bind-by-move patterns in the `if` guards
 274   of `match` arms.][63118] e.g.
 275   ```rust
 276   fn main() {
 277       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
 278
 279       match array {
 280           nums
 281   //      ---- `nums` is bound by move.
 282               if nums.iter().sum::<u8>() == 10
 283   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
 284           => {
 285               drop(nums);
 286   //          ----------- Legal as `nums` was bound by move and so we have ownership.
 287           }
 288           _ => unreachable!(),
 289       }
 290   }
 291   ```
 292
 293
 294
 295 Compiler
 296 --------
 297 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
 298 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
 299 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
 300   **Note** Cargo currently doesn't use this feature. Refer to
 301   [cargo#7315][cargo/7315] to track this feature's progress.
 302 - [You can now pass `--show-output` argument to test binaries to print the
 303   output of successful tests.][62600]
 304
 305
 306 \* Refer to Rust's [platform support page][forge-platform-support] for more
 307 information on Rust's tiered platform support.
 308
 309 Libraries
 310 ---------
 311 - [`Vec::new` and `String::new` are now `const` functions.][64028]
 312 - [`LinkedList::new` is now a `const` function.][63684]
 313 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
 314 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
 315   now `const`.][63786]
 316
 317 Stabilized APIs
 318 ---------------
 319 - [`Pin::into_inner`]
 320 - [`Instant::checked_duration_since`]
 321 - [`Instant::saturating_duration_since`]
 322
 323 Cargo
 324 -----
 325 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
 326 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
 327   `--all` is now deprecated.
 328
 329 Misc
 330 ----
 331 - [You can now pass `-Clinker` to rustdoc to control the linker used
 332   for compiling doctests.][63834]
 333
 334 Compatibility Notes
 335 -------------------
 336 - [Code that was previously accepted by the old borrow checker, but rejected by
 337   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
 338   previously a warning, and will also become a hard error in the Rust 2015
 339   edition in the 1.40.0 release.
 340 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
 341   run tests.][63827] This should improve performance when running a large
 342   amount of doctests.
 343 - [The `try!` macro will now issue a deprecation warning.][62672] It is
 344   recommended to use the `?` operator instead.
 345 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
 346   returned `0.0`.
 347
 348 [62600]: https://github.com/rust-lang/rust/pull/62600/
 349 [62672]: https://github.com/rust-lang/rust/pull/62672/
 350 [63118]: https://github.com/rust-lang/rust/pull/63118/
 351 [63209]: https://github.com/rust-lang/rust/pull/63209/
 352 [63402]: https://github.com/rust-lang/rust/pull/63402/
 353 [63565]: https://github.com/rust-lang/rust/pull/63565/
 354 [63595]: https://github.com/rust-lang/rust/pull/63595/
 355 [63684]: https://github.com/rust-lang/rust/pull/63684/
 356 [63698]: https://github.com/rust-lang/rust/pull/63698/
 357 [63770]: https://github.com/rust-lang/rust/pull/63770/
 358 [63786]: https://github.com/rust-lang/rust/pull/63786/
 359 [63827]: https://github.com/rust-lang/rust/pull/63827/
 360 [63834]: https://github.com/rust-lang/rust/pull/63834/
 361 [63927]: https://github.com/rust-lang/rust/pull/63927/
 362 [63933]: https://github.com/rust-lang/rust/pull/63933/
 363 [63934]: https://github.com/rust-lang/rust/pull/63934/
 364 [63938]: https://github.com/rust-lang/rust/pull/63938/
 365 [63940]: https://github.com/rust-lang/rust/pull/63940/
 366 [63941]: https://github.com/rust-lang/rust/pull/63941/
 367 [63945]: https://github.com/rust-lang/rust/pull/63945/
 368 [64010]: https://github.com/rust-lang/rust/pull/64010/
 369 [64028]: https://github.com/rust-lang/rust/pull/64028/
 370 [64334]: https://github.com/rust-lang/rust/pull/64334/
 371 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
 372 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
 373 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
 374 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
 375 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
 376 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
 377
 378 Version 1.38.0 (2019-09-26)
 379 ==========================
 380
 381 Language
 382 --------
 383 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
 384 - [The `#[deprecated]` attribute can now be used on macros.][62042]
 385
 386 Compiler
 387 --------
 388 - [Added pipelined compilation support to `rustc`.][62766] This will
 389   improve compilation times in some cases. For further information please refer
 390   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
 391 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
 392   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
 393   `x86_64-uwp-windows-msvc` targets.][60260]
 394 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
 395   `armv7-unknown-linux-musleabi` targets.][63107]
 396 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
 397 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
 398
 399 \* Refer to Rust's [platform support page][forge-platform-support] for more
 400 information on Rust's tiered platform support.
 401
 402 Libraries
 403 ---------
 404 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
 405 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
 406   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
 407   is available at `std::clone::Clone`). This also makes all built-in macros
 408   available in `std`/`core` root. e.g. `std::include_bytes!`.
 409 - [`str::Chars` now implements `Debug`.][63000]
 410 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
 411 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
 412 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
 413 - [Added euclidean remainder and division operations (`div_euclid`,
 414   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
 415   `overflowing`, and `wrapping` versions are available for all
 416   integer primitives.
 417 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
 418   `PartialEq`.][61491]
 419 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
 420
 421 Stabilized APIs
 422 ---------------
 423 - [`<*const T>::cast`]
 424 - [`<*mut T>::cast`]
 425 - [`Duration::as_secs_f32`]
 426 - [`Duration::as_secs_f64`]
 427 - [`Duration::div_f32`]
 428 - [`Duration::div_f64`]
 429 - [`Duration::from_secs_f32`]
 430 - [`Duration::from_secs_f64`]
 431 - [`Duration::mul_f32`]
 432 - [`Duration::mul_f64`]
 433 - [`any::type_name`]
 434
 435 Cargo
 436 -----
 437 - [Added pipelined compilation support to `cargo`.][cargo/7143]
 438 - [You can now pass the `--features` option multiple times to enable
 439   multiple features.][cargo/7084]
 440
 441 Misc
 442 ----
 443 - [`rustc` will now warn about some incorrect uses of
 444   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
 445
 446 Compatibility Notes
 447 -------------------
 448 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
 449   1.38.0.
 450 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
 451   issues][62896] with certain crates such as libc.
 452
 453 [60260]: https://github.com/rust-lang/rust/pull/60260/
 454 [61457]: https://github.com/rust-lang/rust/pull/61457/
 455 [61491]: https://github.com/rust-lang/rust/pull/61491/
 456 [61884]: https://github.com/rust-lang/rust/pull/61884/
 457 [61953]: https://github.com/rust-lang/rust/pull/61953/
 458 [62042]: https://github.com/rust-lang/rust/pull/62042/
 459 [62528]: https://github.com/rust-lang/rust/pull/62528/
 460 [62583]: https://github.com/rust-lang/rust/pull/62583/
 461 [62735]: https://github.com/rust-lang/rust/pull/62735/
 462 [62766]: https://github.com/rust-lang/rust/pull/62766/
 463 [62784]: https://github.com/rust-lang/rust/pull/62784/
 464 [62785]: https://github.com/rust-lang/rust/issues/62785/
 465 [62814]: https://github.com/rust-lang/rust/pull/62814/
 466 [62896]: https://github.com/rust-lang/rust/issues/62896/
 467 [63000]: https://github.com/rust-lang/rust/pull/63000/
 468 [63056]: https://github.com/rust-lang/rust/pull/63056/
 469 [63107]: https://github.com/rust-lang/rust/pull/63107/
 470 [63346]: https://github.com/rust-lang/rust/pull/63346/
 471 [63421]: https://github.com/rust-lang/rust/pull/63421/
 472 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
 473 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
 474 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
 475 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
 476 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
 477 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
 478 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
 479 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
 480 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
 481 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
 482 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
 483 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
 484 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
 485 [forge-platform-support]: https://forge.rust-lang.org/platform-support.html
 486 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
 487
 488 Version 1.37.0 (2019-08-15)
 489 ==========================
 490
 491 Language
 492 --------
 493 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
 494   [`Box`][62228], or an [array][62235] and unused.
 495 - [You can now use the `cfg` and `cfg_attr` attributes on
 496   generic parameters.][61547]
 497 - [You can now use enum variants through type alias.][61682] e.g. You can
 498   write the following:
 499   ```rust
 500   type MyOption = Option<u8>;
 501
 502   fn increment_or_zero(x: MyOption) -> u8 {
 503       match x {
 504           MyOption::Some(y) => y + 1,
 505           MyOption::None => 0,
 506       }
 507   }
 508   ```
 509 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
 510   `const _: u32 = 5;`.
 511 - [You can now use `#[repr(align(X)]` on enums.][61229]
 512 - [The  `?` Kleene macro operator is now available in the
 513   2015 edition.][60932]
 514
 515 Compiler
 516 --------
 517 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
 518   and `-C profile-use` flags.][61268] For more information on how to use profile
 519   guided optimization, please refer to the [rustc book][rustc-book-pgo].
 520 - [The `rust-lldb` wrapper script should now work again.][61827]
 521
 522 Libraries
 523 ---------
 524 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
 525
 526 Stabilized APIs
 527 ---------------
 528 - [`BufReader::buffer`]
 529 - [`BufWriter::buffer`]
 530 - [`Cell::from_mut`]
 531 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
 532 - [`DoubleEndedIterator::nth_back`]
 533 - [`Option::xor`]
 534 - [`Wrapping::reverse_bits`]
 535 - [`i128::reverse_bits`]
 536 - [`i16::reverse_bits`]
 537 - [`i32::reverse_bits`]
 538 - [`i64::reverse_bits`]
 539 - [`i8::reverse_bits`]
 540 - [`isize::reverse_bits`]
 541 - [`slice::copy_within`]
 542 - [`u128::reverse_bits`]
 543 - [`u16::reverse_bits`]
 544 - [`u32::reverse_bits`]
 545 - [`u64::reverse_bits`]
 546 - [`u8::reverse_bits`]
 547 - [`usize::reverse_bits`]
 548
 549 Cargo
 550 -----
 551 - [`Cargo.lock` files are now included by default when publishing executable crates
 552   with executables.][cargo/7026]
 553 - [You can now specify `default-run="foo"` in `[package]` to specify the
 554   default executable to use for `cargo run`.][cargo/7056]
 555
 556 Misc
 557 ----
 558
 559 Compatibility Notes
 560 -------------------
 561 - [Using `...` for inclusive range patterns will now warn by default.][61342]
 562   Please transition your code to using the `..=` syntax for inclusive
 563   ranges instead.
 564 - [Using a trait object without the `dyn` will now warn by default.][61203]
 565   Please transition your code to use `dyn Trait` for trait objects instead.
 566
 567 [62228]: https://github.com/rust-lang/rust/pull/62228/
 568 [62235]: https://github.com/rust-lang/rust/pull/62235/
 569 [61802]: https://github.com/rust-lang/rust/pull/61802/
 570 [61827]: https://github.com/rust-lang/rust/pull/61827/
 571 [61547]: https://github.com/rust-lang/rust/pull/61547/
 572 [61682]: https://github.com/rust-lang/rust/pull/61682/
 573 [61268]: https://github.com/rust-lang/rust/pull/61268/
 574 [61342]: https://github.com/rust-lang/rust/pull/61342/
 575 [61347]: https://github.com/rust-lang/rust/pull/61347/
 576 [61100]: https://github.com/rust-lang/rust/pull/61100/
 577 [61203]: https://github.com/rust-lang/rust/pull/61203/
 578 [61229]: https://github.com/rust-lang/rust/pull/61229/
 579 [60932]: https://github.com/rust-lang/rust/pull/60932/
 580 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
 581 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
 582 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
 583 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
 584 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
 585 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
 586 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
 587 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
 588 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
 589 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
 590 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
 591 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
 592 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
 593 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
 594 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
 595 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
 596 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
 597 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
 598 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
 599 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
 600 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
 601 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
 602 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
 603 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
 604
 605
 606 Version 1.36.0 (2019-07-04)
 607 ==========================
 608
 609 Language
 610 --------
 611 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
 612 - [The order of traits in trait objects no longer affects the semantics of that
 613   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
 614   `dyn fmt::Debug + Send`, where this was previously not the case.
 615
 616 Libraries
 617 ---------
 618 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
 619 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
 620 - [`mem::needs_drop` is now available as a const fn.][60364]
 621 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
 622 - [`String` now implements `BorrowMut<str>`.][60404]
 623 - [`io::Cursor` now implements `Default`.][60234]
 624 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
 625 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
 626   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
 627   environment has access to heap memory allocation.
 628 - [`String` now implements `From<&String>`.][59825]
 629 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
 630   return a tuple of each argument when there is multiple arguments.
 631 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
 632   not used.][59648]
 633
 634 Stabilized APIs
 635 ---------------
 636 - [`VecDeque::rotate_left`]
 637 - [`VecDeque::rotate_right`]
 638 - [`Iterator::copied`]
 639 - [`io::IoSlice`]
 640 - [`io::IoSliceMut`]
 641 - [`Read::read_vectored`]
 642 - [`Write::write_vectored`]
 643 - [`str::as_mut_ptr`]
 644 - [`mem::MaybeUninit`]
 645 - [`pointer::align_offset`]
 646 - [`future::Future`]
 647 - [`task::Context`]
 648 - [`task::RawWaker`]
 649 - [`task::RawWakerVTable`]
 650 - [`task::Waker`]
 651 - [`task::Poll`]
 652
 653 Cargo
 654 -----
 655 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
 656 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
 657
 658 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
 659
 660 Clippy
 661 ------
 662 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
 663
 664 Misc
 665 ----
 666
 667 Compatibility Notes
 668 -------------------
 669 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
 670   longer recommended, and will be deprecated in 1.39.0.
 671
 672 [60318]: https://github.com/rust-lang/rust/pull/60318/
 673 [60364]: https://github.com/rust-lang/rust/pull/60364/
 674 [60370]: https://github.com/rust-lang/rust/pull/60370/
 675 [60404]: https://github.com/rust-lang/rust/pull/60404/
 676 [60234]: https://github.com/rust-lang/rust/pull/60234/
 677 [60244]: https://github.com/rust-lang/rust/pull/60244/
 678 [58623]: https://github.com/rust-lang/rust/pull/58623/
 679 [59648]: https://github.com/rust-lang/rust/pull/59648/
 680 [59675]: https://github.com/rust-lang/rust/pull/59675/
 681 [59825]: https://github.com/rust-lang/rust/pull/59825/
 682 [59826]: https://github.com/rust-lang/rust/pull/59826/
 683 [59445]: https://github.com/rust-lang/rust/pull/59445/
 684 [59114]: https://github.com/rust-lang/rust/pull/59114/
 685 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
 686 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
 687 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
 688 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
 689 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
 690 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
 691 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
 692 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
 693 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
 694 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
 695 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
 696 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
 697 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
 698 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
 699 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
 700 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
 701 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
 702 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
 703 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
 704 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
 705
 706
 707 Version 1.35.0 (2019-05-23)
 708 ==========================
 709
 710 Language
 711 --------
 712 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
 713   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
 714 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
 715   ```rust
 716   unsafe fn call_unsafe(func: unsafe fn()) {
 717       func()
 718   }
 719
 720   pub fn main() {
 721       unsafe { call_unsafe(|| {}); }
 722   }
 723   ```
 724
 725
 726 Compiler
 727 --------
 728 - [Added the `armv6-unknown-freebsd-gnueabihf` and
 729   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
 730 - [Added the `wasm32-unknown-wasi` target.][59464]
 731
 732
 733 Libraries
 734 ---------
 735 - [`Thread` will now show its ID in `Debug` output.][59460]
 736 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
 737 - [`alloc::System` now implements `Default`.][59451]
 738 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
 739   last field.][59076]
 740 - [`char::{ToLowercase, ToUppercase}` now
 741   implement `ExactSizeIterator`.][58778]
 742 - [All `NonZero` numeric types now implement `FromStr`.][58717]
 743 - [Removed the `Read` trait bounds
 744   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
 745 - [You can now call the `dbg!` macro without any parameters to print the file
 746   and line where it is called.][57847]
 747 - [In place ASCII case conversions are now up to 4× faster.][59283]
 748   e.g. `str::make_ascii_lowercase`
 749 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
 750   and `Send`.][58369]
 751
 752 Stabilized APIs
 753 ---------------
 754 - [`f32::copysign`]
 755 - [`f64::copysign`]
 756 - [`RefCell::replace_with`]
 757 - [`RefCell::map_split`]
 758 - [`ptr::hash`]
 759 - [`Range::contains`]
 760 - [`RangeFrom::contains`]
 761 - [`RangeTo::contains`]
 762 - [`RangeInclusive::contains`]
 763 - [`RangeToInclusive::contains`]
 764 - [`Option::copied`]
 765
 766 Cargo
 767 -----
 768 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
 769   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
 770   platform specific.
 771
 772 Misc
 773 ----
 774 - [The Rust toolchain is now available natively for musl based distros.][58575]
 775
 776 [59460]: https://github.com/rust-lang/rust/pull/59460/
 777 [59464]: https://github.com/rust-lang/rust/pull/59464/
 778 [59500]: https://github.com/rust-lang/rust/pull/59500/
 779 [59512]: https://github.com/rust-lang/rust/pull/59512/
 780 [59580]: https://github.com/rust-lang/rust/pull/59580/
 781 [59283]: https://github.com/rust-lang/rust/pull/59283/
 782 [59451]: https://github.com/rust-lang/rust/pull/59451/
 783 [59076]: https://github.com/rust-lang/rust/pull/59076/
 784 [58778]: https://github.com/rust-lang/rust/pull/58778/
 785 [58717]: https://github.com/rust-lang/rust/pull/58717/
 786 [58369]: https://github.com/rust-lang/rust/pull/58369/
 787 [58423]: https://github.com/rust-lang/rust/pull/58423/
 788 [58080]: https://github.com/rust-lang/rust/pull/58080/
 789 [57847]: https://github.com/rust-lang/rust/pull/57847/
 790 [58575]: https://github.com/rust-lang/rust/pull/58575
 791 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
 792 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
 793 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
 794 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
 795 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
 796 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
 797 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
 798 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
 799 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
 800 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
 801 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
 802 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
 803
 804 Version 1.34.2 (2019-05-14)
 805 ===========================
 806
 807 * [Destabilize the `Error::type_id` function due to a security
 808    vulnerability][60785] ([CVE-2019-12083])
 809
 810 [60785]: https://github.com/rust-lang/rust/pull/60785
 811 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
 812
 813 Version 1.34.1 (2019-04-25)
 814 ===========================
 815
 816 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
 817 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
 818 * [Fix Clippy panic when checking some macros][clippy/3805]
 819
 820 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
 821 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
 822 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
 823
 824 Version 1.34.0 (2019-04-11)
 825 ==========================
 826
 827 Language
 828 --------
 829 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
 830   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
 831   but had no effect.
 832 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
 833   `#[attr{}]` procedural macros.][57367]
 834 - [You can now write `extern crate self as foo;`][57407] to import your
 835   crate's root into the extern prelude.
 836
 837
 838 Compiler
 839 --------
 840 - [You can now target `riscv64imac-unknown-none-elf` and
 841   `riscv64gc-unknown-none-elf`.][58406]
 842 - [You can now enable linker plugin LTO optimisations with
 843   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
 844   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
 845   boundaries.
 846 - [You can now target `powerpc64-unknown-freebsd`.][57809]
 847
 848
 849 Libraries
 850 ---------
 851 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
 852   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
 853   the `Hash` trait to create an iterator.
 854 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
 855   methods.][58421] Most notably you no longer require the `Ord` trait to create
 856   an iterator.
 857 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
 858   for all numeric types.][58044]
 859 - [Indexing a `str` is now generic over all types that
 860   implement `SliceIndex<str>`.][57604]
 861 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
 862   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
 863   produce a warning if their returning type is unused.
 864 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
 865   `overflowing_pow` are now available for all numeric types.][57873] These are
 866   equivalent to methods such as `wrapping_add` for the `pow` operation.
 867
 868
 869 Stabilized APIs
 870 ---------------
 871
 872 #### std & core
 873 * [`Any::type_id`]
 874 * [`Error::type_id`]
 875 * [`atomic::AtomicI16`]
 876 * [`atomic::AtomicI32`]
 877 * [`atomic::AtomicI64`]
 878 * [`atomic::AtomicI8`]
 879 * [`atomic::AtomicU16`]
 880 * [`atomic::AtomicU32`]
 881 * [`atomic::AtomicU64`]
 882 * [`atomic::AtomicU8`]
 883 * [`convert::Infallible`]
 884 * [`convert::TryFrom`]
 885 * [`convert::TryInto`]
 886 * [`iter::from_fn`]
 887 * [`iter::successors`]
 888 * [`num::NonZeroI128`]
 889 * [`num::NonZeroI16`]
 890 * [`num::NonZeroI32`]
 891 * [`num::NonZeroI64`]
 892 * [`num::NonZeroI8`]
 893 * [`num::NonZeroIsize`]
 894 * [`slice::sort_by_cached_key`]
 895 * [`str::escape_debug`]
 896 * [`str::escape_default`]
 897 * [`str::escape_unicode`]
 898 * [`str::split_ascii_whitespace`]
 899
 900 #### std
 901 * [`Instant::checked_add`]
 902 * [`Instant::checked_sub`]
 903 * [`SystemTime::checked_add`]
 904 * [`SystemTime::checked_sub`]
 905
 906 Cargo
 907 -----
 908 - [You can now use alternative registries to crates.io.][cargo/6654]
 909
 910 Misc
 911 ----
 912 - [You can now use the `?` operator in your documentation tests without manually
 913   adding `fn main() -> Result<(), _> {}`.][56470]
 914
 915 Compatibility Notes
 916 -------------------
 917 - [`Command::before_exec` is being replaced by the unsafe method
 918   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
 919 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
 920   can now use `const` functions in `static` variables.
 921
 922 [58370]: https://github.com/rust-lang/rust/pull/58370/
 923 [58406]: https://github.com/rust-lang/rust/pull/58406/
 924 [58421]: https://github.com/rust-lang/rust/pull/58421/
 925 [58166]: https://github.com/rust-lang/rust/pull/58166/
 926 [58044]: https://github.com/rust-lang/rust/pull/58044/
 927 [58057]: https://github.com/rust-lang/rust/pull/58057/
 928 [58059]: https://github.com/rust-lang/rust/pull/58059/
 929 [57809]: https://github.com/rust-lang/rust/pull/57809/
 930 [57873]: https://github.com/rust-lang/rust/pull/57873/
 931 [57604]: https://github.com/rust-lang/rust/pull/57604/
 932 [57367]: https://github.com/rust-lang/rust/pull/57367/
 933 [57407]: https://github.com/rust-lang/rust/pull/57407/
 934 [57425]: https://github.com/rust-lang/rust/pull/57425/
 935 [57106]: https://github.com/rust-lang/rust/pull/57106/
 936 [56470]: https://github.com/rust-lang/rust/pull/56470/
 937 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
 938 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
 939 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
 940 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
 941 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
 942 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
 943 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
 944 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
 945 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
 946 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
 947 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
 948 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
 949 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
 950 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
 951 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
 952 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
 953 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
 954 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
 955 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
 956 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
 957 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
 958 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
 959 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
 960 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
 961 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
 962 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
 963 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
 964 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
 965 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
 966 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
 967 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
 968
 969
 970 Version 1.33.0 (2019-02-28)
 971 ==========================
 972
 973 Language
 974 --------
 975 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
 976   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
 977 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
 978   E.g. You can have match statement on a `u8` that covers `0..=255` and
 979   you would no longer be required to have a `_ => unreachable!()` case.
 980 - [You can now have multiple patterns in `if let` and `while let`
 981   expressions.][57532] You can do this with the same syntax as a `match`
 982   expression. E.g.
 983   ```rust
 984   enum Creature {
 985       Crab(String),
 986       Lobster(String),
 987       Person(String),
 988   }
 989
 990   fn main() {
 991       let state = Creature::Crab("Ferris");
 992
 993       if let Creature::Crab(name) | Creature::Person(name) = state {
 994           println!("This creature's name is: {}", name);
 995       }
 996   }
 997   ```
 998 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
 999   this feature will by default produce a warning as this behaviour can be
1000   unintuitive. E.g. `if let _ = 5 {}`
1001 - [You can now use `let` bindings, assignments, expression statements,
1002   and irrefutable pattern destructuring in const functions.][57175]
1003 - [You can now call unsafe const functions.][57067] E.g.
1004   ```rust
1005   const unsafe fn foo() -> i32 { 5 }
1006   const fn bar() -> i32 {
1007       unsafe { foo() }
1008   }
1009   ```
1010 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
1011   E.g. `#[cfg_attr(all(), must_use, optimize)]`
1012 - [You can now specify a specific alignment with the `#[repr(packed)]`
1013   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
1014   with an alignment of 2 bytes and a size of 6 bytes.
1015 - [You can now import an item from a module as an `_`.][56303] This allows you to
1016   import a trait's impls, and not have the name in the namespace. E.g.
1017   ```rust
1018   use std::io::Read as _;
1019
1020   // Allowed as there is only one `Read` in the module.
1021   pub trait Read {}
1022   ```
1023 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
1024
1025 Compiler
1026 --------
1027 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
1028   command line argument.][56351]
1029 - [The minimum required LLVM version has been bumped to 6.0.][56642]
1030 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
1031 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
1032   tier 2 support.][57130] Visit the [platform support][platform-support] page for
1033   information on Rust's platform support.
1034 - [Added support for the `thumbv7neon-linux-androideabi` and
1035   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
1036 - [Added support for the `x86_64-unknown-uefi` target.][56769]
1037
1038 Libraries
1039 ---------
1040 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
1041   functions for all numeric types.][57566]
1042 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
1043   are now `const` functions for all numeric types.][57105]
1044 - [The methods `is_positive` and `is_negative` are now `const` functions for
1045   all signed numeric types.][57105]
1046 - [The `get` method for all `NonZero` types is now `const`.][57167]
1047 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
1048   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
1049   numeric types.][57234]
1050 - [`Ipv4Addr::new` is now a `const` function][57234]
1051
1052 Stabilized APIs
1053 ---------------
1054 - [`unix::FileExt::read_exact_at`]
1055 - [`unix::FileExt::write_all_at`]
1056 - [`Option::transpose`]
1057 - [`Result::transpose`]
1058 - [`convert::identity`]
1059 - [`pin::Pin`]
1060 - [`marker::Unpin`]
1061 - [`marker::PhantomPinned`]
1062 - [`Vec::resize_with`]
1063 - [`VecDeque::resize_with`]
1064 - [`Duration::as_millis`]
1065 - [`Duration::as_micros`]
1066 - [`Duration::as_nanos`]
1067
1068
1069 Cargo
1070 -----
1071 - [You can now publish crates that require a feature flag to compile with
1072   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
1073 - [Cargo should now rebuild a crate if a file was modified during the initial
1074   build.][cargo/6484]
1075
1076 Compatibility Notes
1077 -------------------
1078 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
1079   are now deprecated in the standard library, and their usage will now produce a warning.
1080   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
1081   methods instead.
1082 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
1083   downcasting.
1084 - [Libtest no longer creates a new thread for each test when
1085   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
1086
1087 [55982]: https://github.com/rust-lang/rust/pull/55982/
1088 [56243]: https://github.com/rust-lang/rust/pull/56243
1089 [56303]: https://github.com/rust-lang/rust/pull/56303/
1090 [56351]: https://github.com/rust-lang/rust/pull/56351/
1091 [56362]: https://github.com/rust-lang/rust/pull/56362
1092 [56642]: https://github.com/rust-lang/rust/pull/56642/
1093 [56769]: https://github.com/rust-lang/rust/pull/56769/
1094 [56805]: https://github.com/rust-lang/rust/pull/56805
1095 [56947]: https://github.com/rust-lang/rust/pull/56947/
1096 [57049]: https://github.com/rust-lang/rust/pull/57049/
1097 [57067]: https://github.com/rust-lang/rust/pull/57067/
1098 [57105]: https://github.com/rust-lang/rust/pull/57105
1099 [57130]: https://github.com/rust-lang/rust/pull/57130/
1100 [57167]: https://github.com/rust-lang/rust/pull/57167/
1101 [57175]: https://github.com/rust-lang/rust/pull/57175/
1102 [57234]: https://github.com/rust-lang/rust/pull/57234/
1103 [57332]: https://github.com/rust-lang/rust/pull/57332/
1104 [57465]: https://github.com/rust-lang/rust/pull/57465/
1105 [57532]: https://github.com/rust-lang/rust/pull/57532/
1106 [57535]: https://github.com/rust-lang/rust/pull/57535/
1107 [57566]: https://github.com/rust-lang/rust/pull/57566/
1108 [57615]: https://github.com/rust-lang/rust/pull/57615/
1109 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
1110 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
1111 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
1112 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
1113 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
1114 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
1115 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
1116 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
1117 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
1118 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
1119 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
1120 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
1121 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
1122 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
1123 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
1124 [platform-support]: https://forge.rust-lang.org/platform-support.html
1125
1126 Version 1.32.0 (2019-01-17)
1127 ==========================
1128
1129 Language
1130 --------
1131 #### 2018 edition
1132 - [You can now use the `?` operator in macro definitions.][56245] The `?`
1133   operator allows you to specify zero or one repetitions similar to the `*` and
1134   `+` operators.
1135 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
1136   now always resolve to the item (`enum`, `struct`, etc.) available in the
1137   module if present, before resolving to a external crate or an item the prelude.][56759]
1138   E.g.
1139   ```rust
1140   enum Color { Red, Green, Blue }
1141
1142   use Color::*;
1143   ```
1144
1145 #### All editions
1146 - [You can now match against `PhantomData<T>` types.][55837]
1147 - [You can now match against literals in macros with the `literal`
1148   specifier.][56072] This will match against a literal of any type.
1149   E.g. `1`, `'A'`, `"Hello World"`
1150 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
1151   ```rust
1152   struct Point(i32, i32);
1153
1154   impl Point {
1155       pub fn new(x: i32, y: i32) -> Self {
1156           Self(x, y)
1157       }
1158
1159       pub fn is_origin(&self) -> bool {
1160           match self {
1161               Self(0, 0) => true,
1162               _ => false,
1163           }
1164       }
1165   }
1166   ```
1167 - [Self can also now be used in type definitions.][56366] E.g.
1168   ```rust
1169   enum List<T>
1170   where
1171       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
1172   {
1173       Nil,
1174       Cons(T, Box<Self>) // likewise here
1175   }
1176   ```
1177 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
1178   a `impl Trait` or `dyn Trait` is returned and unused in the program.
1179
1180 Compiler
1181 --------
1182 - [The default allocator has changed from jemalloc to the default allocator on
1183   your system.][55238] The compiler itself on Linux & macOS will still use
1184   jemalloc, but programs compiled with it will use the system allocator.
1185 - [Added the `aarch64-pc-windows-msvc` target.][55702]
1186
1187 Libraries
1188 ---------
1189 - [`PathBuf` now implements `FromStr`.][55148]
1190 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
1191 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
1192   easily debug expressions in your rust program. E.g.
1193   ```rust
1194   let a = 2;
1195   let b = dbg!(a * 2) + 1;
1196   //      ^-- prints: [src/main.rs:4] a * 2 = 4
1197   assert_eq!(b, 5);
1198   ```
1199
1200 The following APIs are now `const` functions and can be used in a
1201 `const` context.
1202
1203 - [`Cell::as_ptr`]
1204 - [`UnsafeCell::get`]
1205 - [`char::is_ascii`]
1206 - [`iter::empty`]
1207 - [`ManuallyDrop::new`]
1208 - [`ManuallyDrop::into_inner`]
1209 - [`RangeInclusive::start`]
1210 - [`RangeInclusive::end`]
1211 - [`NonNull::as_ptr`]
1212 - [`slice::as_ptr`]
1213 - [`str::as_ptr`]
1214 - [`Duration::as_secs`]
1215 - [`Duration::subsec_millis`]
1216 - [`Duration::subsec_micros`]
1217 - [`Duration::subsec_nanos`]
1218 - [`CStr::as_ptr`]
1219 - [`Ipv4Addr::is_unspecified`]
1220 - [`Ipv6Addr::new`]
1221 - [`Ipv6Addr::octets`]
1222
1223 Stabilized APIs
1224 ---------------
1225 - [`i8::to_be_bytes`]
1226 - [`i8::to_le_bytes`]
1227 - [`i8::to_ne_bytes`]
1228 - [`i8::from_be_bytes`]
1229 - [`i8::from_le_bytes`]
1230 - [`i8::from_ne_bytes`]
1231 - [`i16::to_be_bytes`]
1232 - [`i16::to_le_bytes`]
1233 - [`i16::to_ne_bytes`]
1234 - [`i16::from_be_bytes`]
1235 - [`i16::from_le_bytes`]
1236 - [`i16::from_ne_bytes`]
1237 - [`i32::to_be_bytes`]
1238 - [`i32::to_le_bytes`]
1239 - [`i32::to_ne_bytes`]
1240 - [`i32::from_be_bytes`]
1241 - [`i32::from_le_bytes`]
1242 - [`i32::from_ne_bytes`]
1243 - [`i64::to_be_bytes`]
1244 - [`i64::to_le_bytes`]
1245 - [`i64::to_ne_bytes`]
1246 - [`i64::from_be_bytes`]
1247 - [`i64::from_le_bytes`]
1248 - [`i64::from_ne_bytes`]
1249 - [`i128::to_be_bytes`]
1250 - [`i128::to_le_bytes`]
1251 - [`i128::to_ne_bytes`]
1252 - [`i128::from_be_bytes`]
1253 - [`i128::from_le_bytes`]
1254 - [`i128::from_ne_bytes`]
1255 - [`isize::to_be_bytes`]
1256 - [`isize::to_le_bytes`]
1257 - [`isize::to_ne_bytes`]
1258 - [`isize::from_be_bytes`]
1259 - [`isize::from_le_bytes`]
1260 - [`isize::from_ne_bytes`]
1261 - [`u8::to_be_bytes`]
1262 - [`u8::to_le_bytes`]
1263 - [`u8::to_ne_bytes`]
1264 - [`u8::from_be_bytes`]
1265 - [`u8::from_le_bytes`]
1266 - [`u8::from_ne_bytes`]
1267 - [`u16::to_be_bytes`]
1268 - [`u16::to_le_bytes`]
1269 - [`u16::to_ne_bytes`]
1270 - [`u16::from_be_bytes`]
1271 - [`u16::from_le_bytes`]
1272 - [`u16::from_ne_bytes`]
1273 - [`u32::to_be_bytes`]
1274 - [`u32::to_le_bytes`]
1275 - [`u32::to_ne_bytes`]
1276 - [`u32::from_be_bytes`]
1277 - [`u32::from_le_bytes`]
1278 - [`u32::from_ne_bytes`]
1279 - [`u64::to_be_bytes`]
1280 - [`u64::to_le_bytes`]
1281 - [`u64::to_ne_bytes`]
1282 - [`u64::from_be_bytes`]
1283 - [`u64::from_le_bytes`]
1284 - [`u64::from_ne_bytes`]
1285 - [`u128::to_be_bytes`]
1286 - [`u128::to_le_bytes`]
1287 - [`u128::to_ne_bytes`]
1288 - [`u128::from_be_bytes`]
1289 - [`u128::from_le_bytes`]
1290 - [`u128::from_ne_bytes`]
1291 - [`usize::to_be_bytes`]
1292 - [`usize::to_le_bytes`]
1293 - [`usize::to_ne_bytes`]
1294 - [`usize::from_be_bytes`]
1295 - [`usize::from_le_bytes`]
1296 - [`usize::from_ne_bytes`]
1297
1298 Cargo
1299 -----
1300 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
1301 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
1302
1303 Misc
1304 ----
1305 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
1306
1307 Compatibility Notes
1308 -------------------
1309 - [The argument types for AVX's
1310   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
1311   been changed from `*const` to `*mut` as the previous implementation
1312   was unsound.
1313
1314
1315 [55148]: https://github.com/rust-lang/rust/pull/55148/
1316 [55238]: https://github.com/rust-lang/rust/pull/55238/
1317 [55280]: https://github.com/rust-lang/rust/pull/55280/
1318 [55610]: https://github.com/rust-lang/rust/pull/55610/
1319 [55663]: https://github.com/rust-lang/rust/pull/55663/
1320 [55702]: https://github.com/rust-lang/rust/pull/55702/
1321 [55837]: https://github.com/rust-lang/rust/pull/55837/
1322 [55843]: https://github.com/rust-lang/rust/pull/55843/
1323 [56072]: https://github.com/rust-lang/rust/pull/56072/
1324 [56245]: https://github.com/rust-lang/rust/pull/56245/
1325 [56365]: https://github.com/rust-lang/rust/pull/56365/
1326 [56366]: https://github.com/rust-lang/rust/pull/56366/
1327 [56395]: https://github.com/rust-lang/rust/pull/56395/
1328 [56759]: https://github.com/rust-lang/rust/pull/56759/
1329 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
1330 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
1331 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
1332 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
1333 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
1334 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1335 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1336 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
1337 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
1338 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
1339 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
1340 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
1341 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
1342 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
1343 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
1344 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
1345 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
1346 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
1347 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
1348 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
1349 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
1350 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
1351 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
1352 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
1353 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
1354 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
1355 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
1356 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
1357 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
1358 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
1359 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
1360 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
1361 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
1362 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
1363 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
1364 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
1365 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
1366 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
1367 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
1368 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
1369 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
1370 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
1371 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
1372 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
1373 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
1374 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
1375 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
1376 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
1377 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
1378 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
1379 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
1380 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
1381 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
1382 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
1383 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
1384 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
1385 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
1386 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
1387 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
1388 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
1389 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
1390 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
1391 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
1392 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
1393 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
1394 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
1395 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
1396 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
1397 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
1398 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
1399 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
1400 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
1401 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
1402 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
1403 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
1404 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
1405 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
1406 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
1407 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
1408 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
1409 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
1410 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
1411 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
1412 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
1413 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
1414 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
1415 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
1416 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
1417 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
1418 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
1419 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
1420 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
1421 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
1422
1423
1424 Version 1.31.1 (2018-12-20)
1425 ===========================
1426
1427 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
1428 - [Fix broken go-to-definition in RLS][rls/1171]
1429 - [Fix infinite loop on hover in RLS][rls/1170]
1430
1431 [56562]: https://github.com/rust-lang/rust/pull/56562
1432 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
1433 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
1434
1435 Version 1.31.0 (2018-12-06)
1436 ==========================
1437
1438 Language
1439 --------
1440 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
1441 - [New lifetime elision rules now allow for eliding lifetimes in functions and
1442   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
1443   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
1444   in structs.
1445 - [You can now define and use `const` functions.][54835] These are currently
1446   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
1447   [language reference][const-reference] for what exactly is available.
1448 - [You can now use tool lints, which allow you to scope lints from external
1449   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
1450 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
1451   a crate, not just in exported functions.][54451]
1452 - [You can now use parentheses in pattern matches.][54497]
1453
1454 Compiler
1455 --------
1456 - [Updated musl to 1.1.20][54430]
1457
1458 Libraries
1459 ---------
1460 - [You can now convert `num::NonZero*` types to their raw equivalents using the
1461   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
1462 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
1463   into `Option<&mut T>` using the `From` trait.][53218]
1464 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
1465
1466
1467 Stabilized APIs
1468 ---------------
1469 - [`slice::align_to`]
1470 - [`slice::align_to_mut`]
1471 - [`slice::chunks_exact`]
1472 - [`slice::chunks_exact_mut`]
1473 - [`slice::rchunks`]
1474 - [`slice::rchunks_mut`]
1475 - [`slice::rchunks_exact`]
1476 - [`slice::rchunks_exact_mut`]
1477 - [`Option::replace`]
1478
1479 Cargo
1480 -----
1481 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
1482 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
1483   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
1484
1485 [52813]: https://github.com/rust-lang/rust/pull/52813/
1486 [53218]: https://github.com/rust-lang/rust/pull/53218/
1487 [53555]: https://github.com/rust-lang/rust/issues/53555/
1488 [54057]: https://github.com/rust-lang/rust/pull/54057/
1489 [54240]: https://github.com/rust-lang/rust/pull/54240/
1490 [54430]: https://github.com/rust-lang/rust/pull/54430/
1491 [54451]: https://github.com/rust-lang/rust/pull/54451/
1492 [54497]: https://github.com/rust-lang/rust/pull/54497/
1493 [54778]: https://github.com/rust-lang/rust/pull/54778/
1494 [54835]: https://github.com/rust-lang/rust/pull/54835/
1495 [54870]: https://github.com/rust-lang/rust/pull/54870/
1496 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
1497 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
1498 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
1499 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
1500 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
1501 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
1502 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1503 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
1504 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1505 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
1506 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
1507 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
1508 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
1509 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
1510
1511 Version 1.30.1 (2018-11-08)
1512 ===========================
1513
1514 - [Fixed overflow ICE in rustdoc][54199]
1515 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
1516
1517 [54199]: https://github.com/rust-lang/rust/pull/54199
1518 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
1519
1520 Version 1.30.0 (2018-10-25)
1521 ==========================
1522
1523 Language
1524 --------
1525 - [Procedural macros are now available.][52081] These kinds of macros allow for
1526   more powerful code generation. There is a [new chapter available][proc-macros]
1527   in the Rust Programming Language book that goes further in depth.
1528 - [You can now use keywords as identifiers using the raw identifiers
1529   syntax (`r#`),][53236] e.g. `let r#for = true;`
1530 - [Using anonymous parameters in traits is now deprecated with a warning and
1531   will be a hard error in the 2018 edition.][53272]
1532 - [You can now use `crate` in paths.][54404] This allows you to refer to the
1533   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
1534 - [Using a external crate no longer requires being prefixed with `::`.][54404]
1535   Previously, using a external crate in a module without a use statement
1536   required `let json = ::serde_json::from_str(foo);` but can now be written
1537   as `let json = serde_json::from_str(foo);`.
1538 - [You can now apply the `#[used]` attribute to static items to prevent the
1539   compiler from optimising them away, even if they appear to be unused,][51363]
1540   e.g. `#[used] static FOO: u32 = 1;`
1541 - [You can now import and reexport macros from other crates with the `use`
1542   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
1543   the root module of the crate. If your macro relies on calling other local
1544   macros, it is recommended to export with the
1545   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
1546   those macros.
1547 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
1548   using the `vis` specifier.][53370]
1549 - [Non-macro attributes now allow all forms of literals, not just
1550   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
1551   write `#[attr(true)]`.
1552 - [You can now specify a function to handle a panic in the Rust runtime with the
1553   `#[panic_handler]` attribute.][51366]
1554
1555 Compiler
1556 --------
1557 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
1558 - [Added the `aarch64-unknown-netbsd` target][53165]
1559
1560 Libraries
1561 ---------
1562 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
1563
1564 Stabilized APIs
1565 ---------------
1566 - [`Ipv4Addr::BROADCAST`]
1567 - [`Ipv4Addr::LOCALHOST`]
1568 - [`Ipv4Addr::UNSPECIFIED`]
1569 - [`Ipv6Addr::LOCALHOST`]
1570 - [`Ipv6Addr::UNSPECIFIED`]
1571 - [`Iterator::find_map`]
1572
1573   The following methods are replacement methods for `trim_left`, `trim_right`,
1574   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
1575   in 1.33.0:
1576 - [`str::trim_end_matches`]
1577 - [`str::trim_end`]
1578 - [`str::trim_start_matches`]
1579 - [`str::trim_start`]
1580
1581 Cargo
1582 ----
1583 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
1584 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
1585   equivalent to calling `rustdoc --error-format=json`.
1586 - [Cargo will now provide a progress bar for builds.][cargo/5995]
1587
1588 Misc
1589 ----
1590 - [`rustdoc` allows you to specify what edition to treat your code as with the
1591   `--edition` option.][54057]
1592 - [`rustdoc` now has the `--color` (specify whether to output color) and
1593   `--error-format` (specify error format, e.g. `json`) options.][53003]
1594 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
1595   debug symbols.][53774]
1596 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
1597   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
1598
1599 [50911]: https://github.com/rust-lang/rust/pull/50911/
1600 [51363]: https://github.com/rust-lang/rust/pull/51363/
1601 [51366]: https://github.com/rust-lang/rust/pull/51366/
1602 [52081]: https://github.com/rust-lang/rust/pull/52081/
1603 [53003]: https://github.com/rust-lang/rust/pull/53003/
1604 [53033]: https://github.com/rust-lang/rust/pull/53033/
1605 [53044]: https://github.com/rust-lang/rust/pull/53044/
1606 [53165]: https://github.com/rust-lang/rust/pull/53165/
1607 [53213]: https://github.com/rust-lang/rust/pull/53213/
1608 [53236]: https://github.com/rust-lang/rust/pull/53236/
1609 [53272]: https://github.com/rust-lang/rust/pull/53272/
1610 [53370]: https://github.com/rust-lang/rust/pull/53370/
1611 [53459]: https://github.com/rust-lang/rust/pull/53459/
1612 [53774]: https://github.com/rust-lang/rust/pull/53774/
1613 [53822]: https://github.com/rust-lang/rust/pull/53822/
1614 [54057]: https://github.com/rust-lang/rust/pull/54057/
1615 [54146]: https://github.com/rust-lang/rust/pull/54146/
1616 [54404]: https://github.com/rust-lang/rust/pull/54404/
1617 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
1618 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
1619 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
1620 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
1621
1622 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
1623 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
1624 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
1625 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
1626 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
1627 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
1628 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
1629 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
1630 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
1631 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
1632
1633
1634 Version 1.29.2 (2018-10-11)
1635 ===========================
1636
1637 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
1638 - The `rls-preview` component on the windows-gnu targets has been restored.
1639
1640 [54639]: https://github.com/rust-lang/rust/pull/54639
1641
1642
1643 Version 1.29.1 (2018-09-25)
1644 ===========================
1645
1646 Security Notes
1647 --------------
1648
1649 - The standard library's `str::repeat` function contained an out of bounds write
1650   caused by an integer overflow. This has been fixed by deterministically
1651   panicking when an overflow happens.
1652
1653   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
1654   us.
1655
1656
1657 Version 1.29.0 (2018-09-13)
1658 ==========================
1659
1660 Compiler
1661 --------
1662 - [Bumped minimum LLVM version to 5.0.][51899]
1663 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
1664 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
1665
1666 Libraries
1667 ---------
1668 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
1669 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
1670 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
1671 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
1672   for `&str`.][51178]
1673 - [`Cell<T>` now allows `T` to be unsized.][50494]
1674 - [`SocketAddr` is now stable on Redox.][52656]
1675
1676 Stabilized APIs
1677 ---------------
1678 - [`Arc::downcast`]
1679 - [`Iterator::flatten`]
1680 - [`Rc::downcast`]
1681
1682 Cargo
1683 -----
1684 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
1685   `--locked` to disable this behavior.
1686 - [`cargo-install` will now allow you to cross compile an install
1687   using `--target`.][cargo/5614]
1688 - [Added the `cargo-fix` subcommand to automatically move project code from
1689   2015 edition to 2018.][cargo/5723]
1690 - [`cargo doc` can now optionally document private types using the
1691   `--document-private-items` flag.][cargo/5543]
1692
1693 Misc
1694 ----
1695 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
1696   the specified level to that level.][52354] For example `--cap-lints warn`
1697   will demote `deny` and `forbid` lints to `warn`.
1698 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
1699   fails and `101` if there is a panic.][52197]
1700 - [A preview of clippy has been made available through rustup.][51122]
1701   You can install the preview with `rustup component add clippy-preview`.
1702
1703 Compatibility Notes
1704 -------------------
1705 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
1706   Use `str::get_unchecked(begin..end)` instead.
1707 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
1708   Consider using the `home_dir` function from
1709   https://crates.io/crates/dirs instead.
1710 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
1711 - [`cfg` attributes and `--cfg` command line flags are now more
1712   strictly validated.][53893]
1713
1714 [53893]: https://github.com/rust-lang/rust/pull/53893/
1715 [52861]: https://github.com/rust-lang/rust/pull/52861/
1716 [52656]: https://github.com/rust-lang/rust/pull/52656/
1717 [52239]: https://github.com/rust-lang/rust/pull/52239/
1718 [52330]: https://github.com/rust-lang/rust/pull/52330/
1719 [52354]: https://github.com/rust-lang/rust/pull/52354/
1720 [52402]: https://github.com/rust-lang/rust/pull/52402/
1721 [52103]: https://github.com/rust-lang/rust/pull/52103/
1722 [52197]: https://github.com/rust-lang/rust/pull/52197/
1723 [51807]: https://github.com/rust-lang/rust/pull/51807/
1724 [51899]: https://github.com/rust-lang/rust/pull/51899/
1725 [51912]: https://github.com/rust-lang/rust/pull/51912/
1726 [51511]: https://github.com/rust-lang/rust/pull/51511/
1727 [51619]: https://github.com/rust-lang/rust/pull/51619/
1728 [51656]: https://github.com/rust-lang/rust/pull/51656/
1729 [51178]: https://github.com/rust-lang/rust/pull/51178/
1730 [51122]: https://github.com/rust-lang/rust/pull/51122
1731 [50494]: https://github.com/rust-lang/rust/pull/50494/
1732 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
1733 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
1734 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
1735 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
1736 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
1737 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
1738 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
1739
1740
1741 Version 1.28.0 (2018-08-02)
1742 ===========================
1743
1744 Language
1745 --------
1746 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
1747   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
1748   the inner type across Foreign Function Interface (FFI) boundaries.
1749 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
1750   and can now be used as identifiers.][51196]
1751 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
1752   stable.][51241] This will allow users to specify a global allocator for
1753   their program.
1754 - [Unit test functions marked with the `#[test]` attribute can now return
1755   `Result<(), E: Debug>` in addition to `()`.][51298]
1756 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
1757   allows macros to easily target lifetimes.
1758
1759 Compiler
1760 --------
1761 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
1762   prioritise making smaller binary sizes. `z` is the same as `s` with the
1763   exception that it does not vectorise loops, which typically results in an even
1764   smaller binary.
1765 - [The short error format is now stable.][49546] Specified with
1766   `--error-format=short` this option will provide a more compressed output of
1767   rust error messages.
1768 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
1769 - [Reduced the number of allocations in the macro parser.][50855] This can
1770   improve compile times of macro heavy crates on average by 5%.
1771
1772 Libraries
1773 ---------
1774 - [Implemented `Default` for `&mut str`.][51306]
1775 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
1776 - [Implemented `Extend` for `()`.][50234]
1777 - [The `Debug` implementation of `time::Duration` should now be more easily
1778   human readable.][50364] Previously a `Duration` of one second would printed as
1779   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
1780 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
1781   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
1782   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
1783   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
1784   for `PathBuf`.][50170]
1785 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
1786   and `Wrapping<i128>`.][50465]
1787 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
1788   possible.][51050] This can provide up to a 40% speed increase.
1789 - [Improved error messages when using `format!`.][50610]
1790
1791 Stabilized APIs
1792 ---------------
1793 - [`Iterator::step_by`]
1794 - [`Path::ancestors`]
1795 - [`SystemTime::UNIX_EPOCH`]
1796 - [`alloc::GlobalAlloc`]
1797 - [`alloc::Layout`]
1798 - [`alloc::LayoutErr`]
1799 - [`alloc::System`]
1800 - [`alloc::alloc`]
1801 - [`alloc::alloc_zeroed`]
1802 - [`alloc::dealloc`]
1803 - [`alloc::realloc`]
1804 - [`alloc::handle_alloc_error`]
1805 - [`btree_map::Entry::or_default`]
1806 - [`fmt::Alignment`]
1807 - [`hash_map::Entry::or_default`]
1808 - [`iter::repeat_with`]
1809 - [`num::NonZeroUsize`]
1810 - [`num::NonZeroU128`]
1811 - [`num::NonZeroU16`]
1812 - [`num::NonZeroU32`]
1813 - [`num::NonZeroU64`]
1814 - [`num::NonZeroU8`]
1815 - [`ops::RangeBounds`]
1816 - [`slice::SliceIndex`]
1817 - [`slice::from_mut`]
1818 - [`slice::from_ref`]
1819 - [`{Any + Send + Sync}::downcast_mut`]
1820 - [`{Any + Send + Sync}::downcast_ref`]
1821 - [`{Any + Send + Sync}::is`]
1822
1823 Cargo
1824 -----
1825 - [Cargo will now no longer allow you to publish crates with build scripts that
1826   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
1827   considered to be immutable.
1828
1829 Misc
1830 ----
1831 - [The `suggestion_applicability` field in `rustc`'s json output is now
1832   stable.][50486] This will allow dev tools to check whether a code suggestion
1833   would apply to them.
1834
1835 Compatibility Notes
1836 -------------------
1837 - [Rust will consider trait objects with duplicated constraints to be the same
1838   type as without the duplicated constraint.][51276] For example the below code will
1839   now fail to compile.
1840   ```rust
1841   trait Trait {}
1842
1843   impl Trait + Send {
1844       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
1845   }
1846
1847   impl Trait + Send + Send {
1848       fn test(&self) { println!("two"); }
1849   }
1850   ```
1851
1852 [49546]: https://github.com/rust-lang/rust/pull/49546/
1853 [50143]: https://github.com/rust-lang/rust/pull/50143/
1854 [50170]: https://github.com/rust-lang/rust/pull/50170/
1855 [50234]: https://github.com/rust-lang/rust/pull/50234/
1856 [50265]: https://github.com/rust-lang/rust/pull/50265/
1857 [50364]: https://github.com/rust-lang/rust/pull/50364/
1858 [50385]: https://github.com/rust-lang/rust/pull/50385/
1859 [50465]: https://github.com/rust-lang/rust/pull/50465/
1860 [50486]: https://github.com/rust-lang/rust/pull/50486/
1861 [50554]: https://github.com/rust-lang/rust/pull/50554/
1862 [50610]: https://github.com/rust-lang/rust/pull/50610/
1863 [50855]: https://github.com/rust-lang/rust/pull/50855/
1864 [51050]: https://github.com/rust-lang/rust/pull/51050/
1865 [51196]: https://github.com/rust-lang/rust/pull/51196/
1866 [51200]: https://github.com/rust-lang/rust/pull/51200/
1867 [51241]: https://github.com/rust-lang/rust/pull/51241/
1868 [51276]: https://github.com/rust-lang/rust/pull/51276/
1869 [51298]: https://github.com/rust-lang/rust/pull/51298/
1870 [51306]: https://github.com/rust-lang/rust/pull/51306/
1871 [51562]: https://github.com/rust-lang/rust/pull/51562/
1872 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
1873 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
1874 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
1875 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
1876 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
1877 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
1878 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
1879 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
1880 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
1881 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
1882 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
1883 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
1884 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
1885 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
1886 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
1887 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
1888 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
1889 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
1890 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
1891 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
1892 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
1893 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
1894 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
1895 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
1896 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
1897 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
1898 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
1899 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
1900 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
1901 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
1902
1903 Version 1.27.2 (2018-07-20)
1904 ===========================
1905
1906 Compatibility Notes
1907 -------------------
1908
1909 - The borrow checker was fixed to avoid potential unsoundness when using
1910   match ergonomics: [#52213][52213].
1911
1912 [52213]: https://github.com/rust-lang/rust/issues/52213
1913
1914 Version 1.27.1 (2018-07-10)
1915 ===========================
1916
1917 Security Notes
1918 --------------
1919
1920 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
1921   when running, which enabled executing code as some other user on a
1922   given machine. This release fixes that vulnerability; you can read
1923   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
1924
1925   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
1926
1927 Compatibility Notes
1928 -------------------
1929
1930 - The borrow checker was fixed to avoid an additional potential unsoundness when using
1931   match ergonomics: [#51415][51415], [#49534][49534].
1932
1933 [51415]: https://github.com/rust-lang/rust/issues/51415
1934 [49534]: https://github.com/rust-lang/rust/issues/49534
1935 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
1936 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
1937
1938 Version 1.27.0 (2018-06-21)
1939 ==========================
1940
1941 Language
1942 --------
1943 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
1944   be used as an identifier.
1945 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
1946   bare `Trait` syntax, and should make it clearer when being used in tandem with
1947   `impl Trait` because it is equivalent to the following syntax:
1948   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
1949   `Box<Trait> == Box<dyn Trait>`.
1950 - [Attributes on generic parameters such as types and lifetimes are
1951   now stable.][48851] e.g.
1952   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
1953 - [The `#[must_use]` attribute can now also be used on functions as well as
1954   types.][48925] It provides a lint that by default warns users when the
1955   value returned by a function has not been used.
1956
1957 Compiler
1958 --------
1959 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
1960
1961 Libraries
1962 ---------
1963 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
1964   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
1965   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
1966   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
1967   the `cfg` attribute.
1968 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
1969   std are now available in core.][49896]
1970 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
1971   to `Self`.][49630]
1972 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
1973   that the operation isn't done in place.
1974 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
1975   the `#[must_use]` attribute][49533] to warn about unused potentially
1976   expensive allocations.
1977
1978 Stabilized APIs
1979 ---------------
1980 - [`DoubleEndedIterator::rfind`]
1981 - [`DoubleEndedIterator::rfold`]
1982 - [`DoubleEndedIterator::try_rfold`]
1983 - [`Duration::from_micros`]
1984 - [`Duration::from_nanos`]
1985 - [`Duration::subsec_micros`]
1986 - [`Duration::subsec_millis`]
1987 - [`HashMap::remove_entry`]
1988 - [`Iterator::try_fold`]
1989 - [`Iterator::try_for_each`]
1990 - [`NonNull::cast`]
1991 - [`Option::filter`]
1992 - [`String::replace_range`]
1993 - [`Take::set_limit`]
1994 - [`hint::unreachable_unchecked`]
1995 - [`os::unix::process::parent_id`]
1996 - [`ptr::swap_nonoverlapping`]
1997 - [`slice::rsplit_mut`]
1998 - [`slice::rsplit`]
1999 - [`slice::swap_with_slice`]
2000
2001 Cargo
2002 -----
2003 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
2004   `readme`, and `repository` fields.][cargo/5386]
2005 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
2006 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
2007   a different directory than `target` for placing compilation artifacts.
2008 - [Cargo will be adding automatic target inference for binaries, benchmarks,
2009   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
2010   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
2011   where cargo would infer a binary, Cargo will produce a warning. You can
2012   disable this feature ahead of time by setting any of the following to false:
2013   `autobins`, `autobenches`, `autoexamples`, `autotests`.
2014 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
2015   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
2016
2017 Misc
2018 ----
2019 - [Added “The Rustc book” into the official documentation.][49707]
2020   [“The Rustc book”] documents and teaches how to use the rustc compiler.
2021 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
2022
2023 Compatibility Notes
2024 -------------------
2025 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
2026   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
2027   compile, `"".is_empty()` will still compile.
2028 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
2029   will only print the inner type.][48553] E.g.
2030   `print!("{:?}", AtomicBool::new(true))` will print `true`,
2031   not `AtomicBool(true)`.
2032 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
2033   could enter higher numbers but they were not supported by LLVM. Up to 512MB
2034   alignment should cover all use cases.
2035 - The `.description()` method on the `std::error::Error` trait
2036   [has been soft-deprecated][50163]. It is no longer required to implement it.
2037
2038 [48553]: https://github.com/rust-lang/rust/pull/48553/
2039 [48851]: https://github.com/rust-lang/rust/pull/48851/
2040 [48925]: https://github.com/rust-lang/rust/pull/48925/
2041 [49533]: https://github.com/rust-lang/rust/pull/49533/
2042 [49623]: https://github.com/rust-lang/rust/pull/49623/
2043 [49630]: https://github.com/rust-lang/rust/pull/49630/
2044 [49664]: https://github.com/rust-lang/rust/pull/49664/
2045 [49699]: https://github.com/rust-lang/rust/pull/49699/
2046 [49707]: https://github.com/rust-lang/rust/pull/49707/
2047 [49719]: https://github.com/rust-lang/rust/pull/49719/
2048 [49896]: https://github.com/rust-lang/rust/pull/49896/
2049 [49968]: https://github.com/rust-lang/rust/pull/49968/
2050 [50163]: https://github.com/rust-lang/rust/pull/50163
2051 [50177]: https://github.com/rust-lang/rust/pull/50177/
2052 [50378]: https://github.com/rust-lang/rust/pull/50378/
2053 [50398]: https://github.com/rust-lang/rust/pull/50398/
2054 [50423]: https://github.com/rust-lang/rust/pull/50423/
2055 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
2056 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
2057 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
2058 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
2059 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
2060 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
2061 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
2062 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
2063 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
2064 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
2065 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
2066 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2067 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2068 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
2069 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
2070 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
2071 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
2072 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
2073 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
2074 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
2075 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
2076 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
2077 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2078 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
2079 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
2080 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
2081 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
2082 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
2083 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
2084 [“The Rustc book”]: https://doc.rust-lang.org/rustc
2085
2086
2087 Version 1.26.2 (2018-06-05)
2088 ==========================
2089
2090 Compatibility Notes
2091 -------------------
2092
2093 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
2094
2095 [51117]: https://github.com/rust-lang/rust/issues/51117
2096
2097
2098 Version 1.26.1 (2018-05-29)
2099 ==========================
2100
2101 Tools
2102 -----
2103
2104 - [RLS now works on Windows.][50646]
2105 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
2106
2107
2108 Compatibility Notes
2109 --------
2110
2111 - [`fn main() -> impl Trait` no longer works for non-Termination
2112   trait.][50656]
2113   This reverts an accidental stabilization.
2114 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
2115 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
2116
2117 [50646]: https://github.com/rust-lang/rust/issues/50646
2118 [50656]: https://github.com/rust-lang/rust/pull/50656
2119 [50812]: https://github.com/rust-lang/rust/pull/50812
2120 [50950]: https://github.com/rust-lang/rust/issues/50950
2121 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
2122
2123 Version 1.26.0 (2018-05-10)
2124 ==========================
2125
2126 Language
2127 --------
2128 - [Closures now implement `Copy` and/or `Clone` if all captured variables
2129   implement either or both traits.][49299]
2130 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
2131 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
2132   lifetime can be elided.][49458]
2133 - [`impl Trait` is now stable allowing you to have abstract types in returns
2134    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
2135   `fn open(path: impl AsRef<Path>)`.
2136 - [Pattern matching will now automatically apply dereferences.][49394]
2137 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
2138 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
2139 - [A lot of operations are now available in a const context.][46882] E.g. You
2140   can now index into constant arrays, reference and dereference into constants,
2141   and use tuple struct constructors.
2142 - [Fixed entry slice patterns are now stable.][48516] E.g.
2143   ```rust
2144   let points = [1, 2, 3, 4];
2145   match points {
2146       [1, 2, 3, 4] => println!("All points were sequential."),
2147       _ => println!("Not all points were sequential."),
2148   }
2149   ```
2150
2151
2152 Compiler
2153 --------
2154 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
2155 - [Fixed exponential projection complexity on nested types.][48296]
2156   This can provide up to a ~12% reduction in compile times for certain crates.
2157 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
2158   to remap path prefixes outputted by the compiler.
2159 - [Added `powerpc-unknown-netbsd` target.][48281]
2160
2161 Libraries
2162 ---------
2163 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
2164 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
2165   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
2166 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
2167 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
2168 - [`ascii::escape_default` is now available in libcore.][48735]
2169 - [Trailing commas are now supported in std and core macros.][48056]
2170 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
2171 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
2172
2173 Stabilized APIs
2174 ---------------
2175 - [`*const T::add`]
2176 - [`*const T::copy_to_nonoverlapping`]
2177 - [`*const T::copy_to`]
2178 - [`*const T::read_unaligned`]
2179 - [`*const T::read_volatile`]
2180 - [`*const T::read`]
2181 - [`*const T::sub`]
2182 - [`*const T::wrapping_add`]
2183 - [`*const T::wrapping_sub`]
2184 - [`*mut T::add`]
2185 - [`*mut T::copy_to_nonoverlapping`]
2186 - [`*mut T::copy_to`]
2187 - [`*mut T::read_unaligned`]
2188 - [`*mut T::read_volatile`]
2189 - [`*mut T::read`]
2190 - [`*mut T::replace`]
2191 - [`*mut T::sub`]
2192 - [`*mut T::swap`]
2193 - [`*mut T::wrapping_add`]
2194 - [`*mut T::wrapping_sub`]
2195 - [`*mut T::write_bytes`]
2196 - [`*mut T::write_unaligned`]
2197 - [`*mut T::write_volatile`]
2198 - [`*mut T::write`]
2199 - [`Box::leak`]
2200 - [`FromUtf8Error::as_bytes`]
2201 - [`LocalKey::try_with`]
2202 - [`Option::cloned`]
2203 - [`btree_map::Entry::and_modify`]
2204 - [`fs::read_to_string`]
2205 - [`fs::read`]
2206 - [`fs::write`]
2207 - [`hash_map::Entry::and_modify`]
2208 - [`iter::FusedIterator`]
2209 - [`ops::RangeInclusive`]
2210 - [`ops::RangeToInclusive`]
2211 - [`process::id`]
2212 - [`slice::rotate_left`]
2213 - [`slice::rotate_right`]
2214 - [`String::retain`]
2215
2216
2217 Cargo
2218 -----
2219 - [Cargo will now output path to custom commands when `-v` is
2220   passed with `--list`][cargo/5041]
2221 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
2222
2223 Misc
2224 ----
2225 - [The second edition of "The Rust Programming Language" book is now recommended
2226   over the first.][48404]
2227
2228 Compatibility Notes
2229 -------------------
2230
2231 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
2232   syntax is now invalid.
2233   ```
2234   use std::ops::Fn as dyn;
2235   fn g(_: Box<dyn(std::fmt::Debug)>) {}
2236   ```
2237 - [The result of dereferences are no longer promoted to `'static`.][47408]
2238   e.g.
2239   ```rust
2240   fn main() {
2241       const PAIR: &(i32, i32) = &(0, 1);
2242       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
2243   }
2244   ```
2245 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
2246 - [`".e0"` will now no longer parse as `0.0` and will instead cause
2247   an error.][48235]
2248 - [Removed hoedown from rustdoc.][48274]
2249 - [Bounds on higher-kinded lifetimes a hard error.][48326]
2250
2251 [46882]: https://github.com/rust-lang/rust/pull/46882
2252 [47379]: https://github.com/rust-lang/rust/pull/47379
2253 [47408]: https://github.com/rust-lang/rust/pull/47408
2254 [47813]: https://github.com/rust-lang/rust/pull/47813
2255 [48056]: https://github.com/rust-lang/rust/pull/48056
2256 [48125]: https://github.com/rust-lang/rust/pull/48125
2257 [48166]: https://github.com/rust-lang/rust/pull/48166
2258 [48235]: https://github.com/rust-lang/rust/pull/48235
2259 [48274]: https://github.com/rust-lang/rust/pull/48274
2260 [48281]: https://github.com/rust-lang/rust/pull/48281
2261 [48296]: https://github.com/rust-lang/rust/pull/48296
2262 [48326]: https://github.com/rust-lang/rust/pull/48326
2263 [48359]: https://github.com/rust-lang/rust/pull/48359
2264 [48404]: https://github.com/rust-lang/rust/pull/48404
2265 [48481]: https://github.com/rust-lang/rust/pull/48481
2266 [48516]: https://github.com/rust-lang/rust/pull/48516
2267 [48628]: https://github.com/rust-lang/rust/pull/48628
2268 [48629]: https://github.com/rust-lang/rust/pull/48629
2269 [48657]: https://github.com/rust-lang/rust/pull/48657
2270 [48735]: https://github.com/rust-lang/rust/pull/48735
2271 [48978]: https://github.com/rust-lang/rust/pull/48978
2272 [49101]: https://github.com/rust-lang/rust/pull/49101
2273 [49109]: https://github.com/rust-lang/rust/pull/49109
2274 [49121]: https://github.com/rust-lang/rust/pull/49121
2275 [49162]: https://github.com/rust-lang/rust/pull/49162
2276 [49184]: https://github.com/rust-lang/rust/pull/49184
2277 [49234]: https://github.com/rust-lang/rust/pull/49234
2278 [49255]: https://github.com/rust-lang/rust/pull/49255
2279 [49299]: https://github.com/rust-lang/rust/pull/49299
2280 [49305]: https://github.com/rust-lang/rust/pull/49305
2281 [49394]: https://github.com/rust-lang/rust/pull/49394
2282 [49458]: https://github.com/rust-lang/rust/pull/49458
2283 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
2284 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
2285 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
2286 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
2287 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
2288 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
2289 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
2290 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
2291 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
2292 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
2293 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
2294 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
2295 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
2296 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
2297 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
2298 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
2299 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
2300 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
2301 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
2302 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
2303 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
2304 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
2305 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
2306 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
2307 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
2308 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
2309 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
2310 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
2311 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
2312 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
2313 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
2314 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
2315 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
2316 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
2317 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
2318 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
2319 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2320 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
2321 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
2322 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
2323 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
2324 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
2325
2326
2327 Version 1.25.0 (2018-03-29)
2328 ==========================
2329
2330 Language
2331 --------
2332 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
2333 - [You can now use nested groups of imports.][47948]
2334   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
2335 - [You can now have `|` at the start of a match arm.][47947] e.g.
2336 ```rust
2337 enum Foo { A, B, C }
2338
2339 fn main() {
2340     let x = Foo::A;
2341     match x {
2342         | Foo::A
2343         | Foo::B => println!("AB"),
2344         | Foo::C => println!("C"),
2345     }
2346 }
2347 ```
2348
2349 Compiler
2350 --------
2351 - [Upgraded to LLVM 6.][47828]
2352 - [Added `-C lto=val` option.][47521]
2353 - [Added `i586-unknown-linux-musl` target][47282]
2354
2355 Libraries
2356 ---------
2357 - [Impl Send for `process::Command` on Unix.][47760]
2358 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
2359 - [`UnsafeCell::into_inner` is now safe.][47204]
2360 - [Implement libstd for CloudABI.][47268]
2361 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
2362 - [Implement `AsRef<Path>` for Component][46985]
2363 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
2364 - [Moved `Duration` to libcore.][46666]
2365
2366 Stabilized APIs
2367 ---------------
2368 - [`Location::column`]
2369 - [`ptr::NonNull`]
2370
2371 The following functions can now be used in a constant expression.
2372 eg. `static MINUTE: Duration = Duration::from_secs(60);`
2373 - [`Duration::new`][47300]
2374 - [`Duration::from_secs`][47300]
2375 - [`Duration::from_millis`][47300]
2376
2377 Cargo
2378 -----
2379 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
2380 - [`cargo new` now defaults to creating a binary crate, instead of a
2381   library crate.][cargo/5029]
2382
2383 Misc
2384 ----
2385 - [Rust by example is now shipped with new releases][46196]
2386
2387 Compatibility Notes
2388 -------------------
2389 - [Deprecated `net::lookup_host`.][47510]
2390 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
2391 - The borrow checker was sometimes incorrectly permitting overlapping borrows
2392   around indexing operations (see [#47349][47349]). This has been fixed (which also
2393   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
2394 - [Removed deprecated unstable attribute `#[simd]`.][47251]
2395
2396 [33903]: https://github.com/rust-lang/rust/pull/33903
2397 [47947]: https://github.com/rust-lang/rust/pull/47947
2398 [47948]: https://github.com/rust-lang/rust/pull/47948
2399 [47760]: https://github.com/rust-lang/rust/pull/47760
2400 [47790]: https://github.com/rust-lang/rust/pull/47790
2401 [47828]: https://github.com/rust-lang/rust/pull/47828
2402 [47398]: https://github.com/rust-lang/rust/pull/47398
2403 [47510]: https://github.com/rust-lang/rust/pull/47510
2404 [47521]: https://github.com/rust-lang/rust/pull/47521
2405 [47204]: https://github.com/rust-lang/rust/pull/47204
2406 [47251]: https://github.com/rust-lang/rust/pull/47251
2407 [47268]: https://github.com/rust-lang/rust/pull/47268
2408 [47282]: https://github.com/rust-lang/rust/pull/47282
2409 [47300]: https://github.com/rust-lang/rust/pull/47300
2410 [47349]: https://github.com/rust-lang/rust/pull/47349
2411 [46931]: https://github.com/rust-lang/rust/pull/46931
2412 [46985]: https://github.com/rust-lang/rust/pull/46985
2413 [47006]: https://github.com/rust-lang/rust/pull/47006
2414 [46830]: https://github.com/rust-lang/rust/pull/46830
2415 [46095]: https://github.com/rust-lang/rust/pull/46095
2416 [46666]: https://github.com/rust-lang/rust/pull/46666
2417 [46196]: https://github.com/rust-lang/rust/pull/46196
2418 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
2419 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
2420 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
2421 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
2422 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
2423
2424
2425 Version 1.24.1 (2018-03-01)
2426 ==========================
2427
2428  - [Do not abort when unwinding through FFI][48251]
2429  - [Emit UTF-16 files for linker arguments on Windows][48318]
2430  - [Make the error index generator work again][48308]
2431  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
2432
2433 [48251]: https://github.com/rust-lang/rust/issues/48251
2434 [48308]: https://github.com/rust-lang/rust/issues/48308
2435 [48318]: https://github.com/rust-lang/rust/issues/48318
2436 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
2437
2438
2439 Version 1.24.0 (2018-02-15)
2440 ==========================
2441
2442 Language
2443 --------
2444 - [External `sysv64` ffi is now available.][46528]
2445   eg. `extern "sysv64" fn foo () {}`
2446
2447 Compiler
2448 --------
2449 - [rustc now uses 16 codegen units by default for release builds.][46910]
2450   For the fastest builds, utilize `codegen-units=1`.
2451 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
2452 - [Add `aarch64-unknown-openbsd` support][46760]
2453
2454 Libraries
2455 ---------
2456 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
2457   improvement in performance in the majority of cases.
2458 - [`OsStr`'s `Debug` implementation is now lossless and consistent
2459   with Windows.][46798]
2460 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
2461 - [impl `From<bool>` for `AtomicBool`][46293]
2462 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
2463 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
2464 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
2465 - [float::from_bits now just uses transmute.][46012] This provides
2466   some optimisations from LLVM.
2467 - [Copied `AsciiExt` methods onto `char`][46077]
2468 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
2469 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
2470 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
2471 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
2472
2473 Stabilized APIs
2474 ---------------
2475 - [`RefCell::replace`]
2476 - [`RefCell::swap`]
2477 - [`atomic::spin_loop_hint`]
2478
2479 The following functions can now be used in a constant expression.
2480 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
2481
2482 - [`AtomicBool::new`][46287]
2483 - [`AtomicUsize::new`][46287]
2484 - [`AtomicIsize::new`][46287]
2485 - [`AtomicPtr::new`][46287]
2486 - [`Cell::new`][46287]
2487 - [`{integer}::min_value`][46287]
2488 - [`{integer}::max_value`][46287]
2489 - [`mem::size_of`][46287]
2490 - [`mem::align_of`][46287]
2491 - [`ptr::null`][46287]
2492 - [`ptr::null_mut`][46287]
2493 - [`RefCell::new`][46287]
2494 - [`UnsafeCell::new`][46287]
2495
2496 Cargo
2497 -----
2498 - [Added a `workspace.default-members` config that
2499   overrides implied `--all` in virtual workspaces.][cargo/4743]
2500 - [Enable incremental by default on development builds.][cargo/4817] Also added
2501   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
2502   per-project or global basis respectively.
2503
2504 Misc
2505 ----
2506
2507 Compatibility Notes
2508 -------------------
2509 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
2510 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
2511   in accordance with IETF RFC 4291 §2.2.
2512 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
2513 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
2514   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
2515 - [Leading zeros in tuple struct members is now an error][47084]
2516 - [`column!()` macro is one-based instead of zero-based][46977]
2517 - [`fmt::Arguments` can no longer be shared across threads][45198]
2518 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
2519 - [Cargo sets a different working directory for the compiler][cargo/4788]
2520
2521 [44884]: https://github.com/rust-lang/rust/pull/44884
2522 [45198]: https://github.com/rust-lang/rust/pull/45198
2523 [45506]: https://github.com/rust-lang/rust/pull/45506
2524 [45904]: https://github.com/rust-lang/rust/pull/45904
2525 [45990]: https://github.com/rust-lang/rust/pull/45990
2526 [46012]: https://github.com/rust-lang/rust/pull/46012
2527 [46077]: https://github.com/rust-lang/rust/pull/46077
2528 [46094]: https://github.com/rust-lang/rust/pull/46094
2529 [46284]: https://github.com/rust-lang/rust/pull/46284
2530 [46287]: https://github.com/rust-lang/rust/pull/46287
2531 [46293]: https://github.com/rust-lang/rust/pull/46293
2532 [46528]: https://github.com/rust-lang/rust/pull/46528
2533 [46671]: https://github.com/rust-lang/rust/pull/46671
2534 [46713]: https://github.com/rust-lang/rust/pull/46713
2535 [46735]: https://github.com/rust-lang/rust/pull/46735
2536 [46749]: https://github.com/rust-lang/rust/pull/46749
2537 [46760]: https://github.com/rust-lang/rust/pull/46760
2538 [46798]: https://github.com/rust-lang/rust/pull/46798
2539 [46828]: https://github.com/rust-lang/rust/pull/46828
2540 [46831]: https://github.com/rust-lang/rust/pull/46831
2541 [46833]: https://github.com/rust-lang/rust/pull/46833
2542 [46910]: https://github.com/rust-lang/rust/pull/46910
2543 [46977]: https://github.com/rust-lang/rust/pull/46977
2544 [47018]: https://github.com/rust-lang/rust/pull/47018
2545 [47080]: https://github.com/rust-lang/rust/pull/47080
2546 [47084]: https://github.com/rust-lang/rust/pull/47084
2547 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
2548 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
2549 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
2550 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
2551 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
2552 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
2553
2554
2555 Version 1.23.0 (2018-01-04)
2556 ==========================
2557
2558 Language
2559 --------
2560 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
2561 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
2562   Which should fix some confusing errors in some operations.
2563
2564 Compiler
2565 --------
2566 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
2567   undefined behavior.][45920]
2568 - [rustc now suggests renaming import if names clash.][45660]
2569 - [Display errors/warnings correctly when there are zero-width or
2570   wide characters.][45711]
2571 - [rustc now avoids unnecessary copies of arguments that are
2572   simple bindings][45380] This should improve memory usage on average by 5-10%.
2573 - [Updated musl used to build musl rustc to 1.1.17][45393]
2574
2575 Libraries
2576 ---------
2577 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
2578 - [Implement Hash for raw pointers to unsized types][45483]
2579 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
2580 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
2581 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
2582 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
2583   and `<*mut T>::as_mut`][44932]
2584 - [Optimized `Thread::{park, unpark}` implementation][45524]
2585 - [Improved `SliceExt::binary_search` performance.][45333]
2586 - [impl `FromIterator<()>` for `()`][45379]
2587 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
2588   is now deprecated.
2589
2590 Stabilized APIs
2591 ---------------
2592
2593 Cargo
2594 -----
2595 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
2596   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
2597 - [Added unit test checking to `cargo check`][cargo/4592]
2598 - [Cargo now lets you install a specific version
2599   using `cargo install --version`][cargo/4637]
2600
2601 Misc
2602 ----
2603 - [Releases now ship with the Cargo book documentation.][45692]
2604 - [rustdoc now prints rendering warnings on every run.][45324]
2605
2606 Compatibility Notes
2607 -------------------
2608 - [Changes have been made to type equality to make it more correct,
2609   in rare cases this could break some code.][45853] [Tracking issue for
2610   further information][45852]
2611 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
2612 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
2613   Android 9, the minimum supported version is Android 14.
2614 - [Bumped the minimum LLVM to 3.9][45326]
2615
2616 [44042]: https://github.com/rust-lang/rust/pull/44042
2617 [44932]: https://github.com/rust-lang/rust/pull/44932
2618 [45267]: https://github.com/rust-lang/rust/pull/45267
2619 [45324]: https://github.com/rust-lang/rust/pull/45324
2620 [45326]: https://github.com/rust-lang/rust/pull/45326
2621 [45333]: https://github.com/rust-lang/rust/pull/45333
2622 [45379]: https://github.com/rust-lang/rust/pull/45379
2623 [45380]: https://github.com/rust-lang/rust/pull/45380
2624 [45393]: https://github.com/rust-lang/rust/pull/45393
2625 [45435]: https://github.com/rust-lang/rust/pull/45435
2626 [45483]: https://github.com/rust-lang/rust/pull/45483
2627 [45524]: https://github.com/rust-lang/rust/pull/45524
2628 [45571]: https://github.com/rust-lang/rust/pull/45571
2629 [45580]: https://github.com/rust-lang/rust/pull/45580
2630 [45610]: https://github.com/rust-lang/rust/pull/45610
2631 [45660]: https://github.com/rust-lang/rust/pull/45660
2632 [45692]: https://github.com/rust-lang/rust/pull/45692
2633 [45711]: https://github.com/rust-lang/rust/pull/45711
2634 [45772]: https://github.com/rust-lang/rust/pull/45772
2635 [45852]: https://github.com/rust-lang/rust/issues/45852
2636 [45853]: https://github.com/rust-lang/rust/pull/45853
2637 [45887]: https://github.com/rust-lang/rust/pull/45887
2638 [45920]: https://github.com/rust-lang/rust/pull/45920
2639 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
2640 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
2641 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
2642
2643
2644 Version 1.22.1 (2017-11-22)
2645 ==========================
2646
2647 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
2648
2649 [46183]: https://github.com/rust-lang/rust/pull/46183
2650
2651 Version 1.22.0 (2017-11-22)
2652 ==========================
2653
2654 Language
2655 --------
2656 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
2657 - [Now accepts underscores in unicode escapes][43716]
2658 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
2659 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
2660
2661 Compiler
2662 --------
2663 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
2664 - [rustc will no longer inline in codegen units when compiling for debug][45075]
2665   This should decrease compile times for debug builds.
2666 - [strict memory alignment now enabled on ARMv6][45094]
2667 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
2668
2669 Libraries
2670 ---------
2671 - [Allow atomic operations up to 32 bits
2672   on `armv5te_unknown_linux_gnueabi`][44978]
2673 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
2674 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
2675 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
2676 - [Properly detect overflow in `Instant += Duration`.][44220]
2677 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
2678 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
2679 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
2680
2681 Stabilized APIs
2682 ---------------
2683
2684 Cargo
2685 -----
2686 - [Cargo will now build multi file examples in subdirectories of the `examples`
2687   folder that have a `main.rs` file.][cargo/4496]
2688 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
2689   the old format will continue to work and can be updated with `cargo update`.
2690 - [Now supports vendoring git repositories][cargo/3992]
2691
2692 Misc
2693 ----
2694 - [`libbacktrace` is now available on Apple platforms.][44251]
2695 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
2696   This now lets you specify that a given code example will fail to compile.
2697
2698 Compatibility Notes
2699 -------------------
2700 - [The minimum Android version that rustc can build for has been bumped
2701   to `4.0` from `2.3`][45656]
2702 - [Allowing `T op= &T` for numeric types has broken some type
2703   inference cases][45480]
2704
2705
2706 [42526]: https://github.com/rust-lang/rust/pull/42526
2707 [43017]: https://github.com/rust-lang/rust/pull/43017
2708 [43716]: https://github.com/rust-lang/rust/pull/43716
2709 [43949]: https://github.com/rust-lang/rust/pull/43949
2710 [44015]: https://github.com/rust-lang/rust/pull/44015
2711 [44220]: https://github.com/rust-lang/rust/pull/44220
2712 [44251]: https://github.com/rust-lang/rust/pull/44251
2713 [44287]: https://github.com/rust-lang/rust/pull/44287
2714 [44303]: https://github.com/rust-lang/rust/pull/44303
2715 [44456]: https://github.com/rust-lang/rust/pull/44456
2716 [44466]: https://github.com/rust-lang/rust/pull/44466
2717 [44895]: https://github.com/rust-lang/rust/pull/44895
2718 [44966]: https://github.com/rust-lang/rust/pull/44966
2719 [44978]: https://github.com/rust-lang/rust/pull/44978
2720 [45041]: https://github.com/rust-lang/rust/pull/45041
2721 [45064]: https://github.com/rust-lang/rust/pull/45064
2722 [45075]: https://github.com/rust-lang/rust/pull/45075
2723 [45094]: https://github.com/rust-lang/rust/pull/45094
2724 [45095]: https://github.com/rust-lang/rust/pull/45095
2725 [45480]: https://github.com/rust-lang/rust/issues/45480
2726 [45656]: https://github.com/rust-lang/rust/pull/45656
2727 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
2728 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
2729 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
2730
2731
2732
2733
2734
2735
2736 Version 1.21.0 (2017-10-12)
2737 ==========================
2738
2739 Language
2740 --------
2741 - [You can now use static references for literals.][43838]
2742   Example:
2743   ```rust
2744   fn main() {
2745       let x: &'static u32 = &0;
2746   }
2747   ```
2748 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
2749   Example:
2750   ```rust
2751   my_macro!(Vec<i32>::new); // Always worked
2752   my_macro!(Vec::<i32>::new); // Now works
2753   ```
2754
2755 Compiler
2756 --------
2757 - [Upgraded jemalloc to 4.5.0][43911]
2758 - [Enabled unwinding panics on Redox][43917]
2759 - [Now runs LLVM in parallel during translation phase.][43506]
2760   This should reduce peak memory usage.
2761
2762 Libraries
2763 ---------
2764 - [Generate builtin impls for `Clone` for all arrays and tuples that
2765   are `T: Clone`][43690]
2766 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
2767 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
2768   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
2769
2770 Stabilized APIs
2771 ---------------
2772
2773 [`std::mem::discriminant`]
2774
2775 Cargo
2776 -----
2777 - [You can now call `cargo install` with multiple package names][cargo/4216]
2778 - [Cargo commands inside a virtual workspace will now implicitly
2779   pass `--all`][cargo/4335]
2780 - [Added a `[patch]` section to `Cargo.toml` to handle
2781   prepublication dependencies][cargo/4123] [RFC 1969]
2782 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
2783   like patterns][cargo/4270]
2784 - [Added the `--all-targets` option][cargo/4400]
2785 - [Using required dependencies as a feature is now deprecated and emits
2786   a warning][cargo/4364]
2787
2788
2789 Misc
2790 ----
2791 - [Cargo docs are moving][43916]
2792   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
2793 - [The rustdoc book is now available][43863]
2794   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
2795 - [Added a preview of RLS has been made available through rustup][44204]
2796   Install with `rustup component add rls-preview`
2797 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
2798   Previously only showed `std::os::unix`.
2799
2800 Compatibility Notes
2801 -------------------
2802 - [Changes in method matching against higher-ranked types][43880] This may cause
2803   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
2804 - [rustc's JSON error output's byte position start at top of file.][42973]
2805   Was previously relative to the rustc's internal `CodeMap` struct which
2806   required the unstable library `libsyntax` to correctly use.
2807 - [`unused_results` lint no longer ignores booleans][43728]
2808
2809 [42565]: https://github.com/rust-lang/rust/pull/42565
2810 [42973]: https://github.com/rust-lang/rust/pull/42973
2811 [43348]: https://github.com/rust-lang/rust/pull/43348
2812 [43459]: https://github.com/rust-lang/rust/pull/43459
2813 [43506]: https://github.com/rust-lang/rust/pull/43506
2814 [43540]: https://github.com/rust-lang/rust/pull/43540
2815 [43690]: https://github.com/rust-lang/rust/pull/43690
2816 [43728]: https://github.com/rust-lang/rust/pull/43728
2817 [43838]: https://github.com/rust-lang/rust/pull/43838
2818 [43863]: https://github.com/rust-lang/rust/pull/43863
2819 [43880]: https://github.com/rust-lang/rust/pull/43880
2820 [43911]: https://github.com/rust-lang/rust/pull/43911
2821 [43916]: https://github.com/rust-lang/rust/pull/43916
2822 [43917]: https://github.com/rust-lang/rust/pull/43917
2823 [44204]: https://github.com/rust-lang/rust/pull/44204
2824 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
2825 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
2826 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
2827 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
2828 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
2829 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
2830 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
2831 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
2832 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
2833
2834 Version 1.20.0 (2017-08-31)
2835 ===========================
2836
2837 Language
2838 --------
2839 - [Associated constants are now stabilised.][42809]
2840 - [A lot of macro bugs are now fixed.][42913]
2841
2842 Compiler
2843 --------
2844
2845 - [Struct fields are now properly coerced to the expected field type.][42807]
2846 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
2847   `wasm32-experimental-emscripten` target.
2848 - [Changed some of the error messages to be more helpful.][42033]
2849 - [Add support for RELRO(RELocation Read-Only) for platforms that support
2850   it.][43170]
2851 - [rustc now reports the total number of errors on compilation failure][43015]
2852   previously this was only the number of errors in the pass that failed.
2853 - [Expansion in rustc has been sped up 29x.][42533]
2854 - [added `msp430-none-elf` target.][43099]
2855 - [rustc will now suggest one-argument enum variant to fix type mismatch when
2856   applicable][43178]
2857 - [Fixes backtraces on Redox][43228]
2858 - [rustc now identifies different versions of same crate when absolute paths of
2859   different types match in an error message.][42826]
2860
2861 Libraries
2862 ---------
2863
2864
2865 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
2866 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
2867   tuples.][43011]
2868 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
2869   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
2870 - [Impl `Clone` for `DefaultHasher`.][42799]
2871 - [Impl `Sync` for `SyncSender`.][42397]
2872 - [Impl `FromStr` for `char`][42271]
2873 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
2874   NaN.][42431]
2875 - [allow messages in the `unimplemented!()` macro.][42155]
2876   ie. `unimplemented!("Waiting for 1.21 to be stable")`
2877 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
2878 - [Upgrade to Unicode 10.0.0][42999]
2879 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
2880 - [Skip the main thread's manual stack guard on Linux][43072]
2881 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
2882 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
2883   previously 2^15.
2884 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
2885
2886 Stabilized APIs
2887 ---------------
2888
2889 - [`CStr::into_c_string`]
2890 - [`CString::as_c_str`]
2891 - [`CString::into_boxed_c_str`]
2892 - [`Chain::get_mut`]
2893 - [`Chain::get_ref`]
2894 - [`Chain::into_inner`]
2895 - [`Option::get_or_insert_with`]
2896 - [`Option::get_or_insert`]
2897 - [`OsStr::into_os_string`]
2898 - [`OsString::into_boxed_os_str`]
2899 - [`Take::get_mut`]
2900 - [`Take::get_ref`]
2901 - [`Utf8Error::error_len`]
2902 - [`char::EscapeDebug`]
2903 - [`char::escape_debug`]
2904 - [`compile_error!`]
2905 - [`f32::from_bits`]
2906 - [`f32::to_bits`]
2907 - [`f64::from_bits`]
2908 - [`f64::to_bits`]
2909 - [`mem::ManuallyDrop`]
2910 - [`slice::sort_unstable_by_key`]
2911 - [`slice::sort_unstable_by`]
2912 - [`slice::sort_unstable`]
2913 - [`str::from_boxed_utf8_unchecked`]
2914 - [`str::as_bytes_mut`]
2915 - [`str::as_bytes_mut`]
2916 - [`str::from_utf8_mut`]
2917 - [`str::from_utf8_unchecked_mut`]
2918 - [`str::get_mut`]
2919 - [`str::get_unchecked_mut`]
2920 - [`str::get_unchecked`]
2921 - [`str::get`]
2922 - [`str::into_boxed_bytes`]
2923
2924
2925 Cargo
2926 -----
2927 - [Cargo API token location moved from `~/.cargo/config` to
2928   `~/.cargo/credentials`.][cargo/3978]
2929 - [Cargo will now build `main.rs` binaries that are in sub-directories of
2930   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
2931   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
2932 - [You can now specify version of a binary when installed through
2933   `cargo install` using `--vers`.][cargo/4229]
2934 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
2935   failure.][cargo/4248]
2936 - [Changed the convention around which file is the crate root.][cargo/4259]
2937 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
2938   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
2939
2940 Compatibility Notes
2941 -------------------
2942
2943 - [Functions with `'static` in their return types will now not be as usable as
2944   if they were using lifetime parameters instead.][42417]
2945 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
2946   takes the sign of NaN into account where previously didn't.][42430]
2947
2948 [42033]: https://github.com/rust-lang/rust/pull/42033
2949 [42155]: https://github.com/rust-lang/rust/pull/42155
2950 [42271]: https://github.com/rust-lang/rust/pull/42271
2951 [42397]: https://github.com/rust-lang/rust/pull/42397
2952 [42417]: https://github.com/rust-lang/rust/pull/42417
2953 [42430]: https://github.com/rust-lang/rust/pull/42430
2954 [42431]: https://github.com/rust-lang/rust/pull/42431
2955 [42533]: https://github.com/rust-lang/rust/pull/42533
2956 [42571]: https://github.com/rust-lang/rust/pull/42571
2957 [42613]: https://github.com/rust-lang/rust/pull/42613
2958 [42799]: https://github.com/rust-lang/rust/pull/42799
2959 [42807]: https://github.com/rust-lang/rust/pull/42807
2960 [42809]: https://github.com/rust-lang/rust/pull/42809
2961 [42822]: https://github.com/rust-lang/rust/pull/42822
2962 [42826]: https://github.com/rust-lang/rust/pull/42826
2963 [42854]: https://github.com/rust-lang/rust/pull/42854
2964 [42913]: https://github.com/rust-lang/rust/pull/42913
2965 [42999]: https://github.com/rust-lang/rust/pull/42999
2966 [43011]: https://github.com/rust-lang/rust/pull/43011
2967 [43015]: https://github.com/rust-lang/rust/pull/43015
2968 [43072]: https://github.com/rust-lang/rust/pull/43072
2969 [43077]: https://github.com/rust-lang/rust/pull/43077
2970 [43097]: https://github.com/rust-lang/rust/pull/43097
2971 [43099]: https://github.com/rust-lang/rust/pull/43099
2972 [43170]: https://github.com/rust-lang/rust/pull/43170
2973 [43178]: https://github.com/rust-lang/rust/pull/43178
2974 [43185]: https://github.com/rust-lang/rust/pull/43185
2975 [43228]: https://github.com/rust-lang/rust/pull/43228
2976 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
2977 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
2978 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
2979 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
2980 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
2981 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
2982 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
2983 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
2984 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
2985 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
2986 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
2987 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
2988 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
2989 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
2990 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
2991 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
2992 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
2993 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
2994 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
2995 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
2996 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
2997 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
2998 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
2999 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
3000 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
3001 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
3002 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
3003 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
3004 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
3005 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
3006 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
3007 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
3008 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
3009 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
3010 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
3011 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
3012 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
3013 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
3014 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
3015
3016
3017 Version 1.19.0 (2017-07-20)
3018 ===========================
3019
3020 Language
3021 --------
3022
3023 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
3024   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
3025 - [Macro recursion limit increased to 1024 from 64.][41676]
3026 - [Added lint for detecting unused macros.][41907]
3027 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
3028   For example: `let x = loop { break 7; };`
3029 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
3030   contain `Copy` types and cannot have a `Drop` implementation.
3031   Example: `union Foo { bar: u8, baz: usize }`
3032 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
3033   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
3034
3035 Compiler
3036 --------
3037
3038 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
3039 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
3040   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
3041   you should use `--target armv7-linux-androideabi`.
3042 - [Fixed ICE when removing a source file between compilation sessions.][41873]
3043 - [Minor optimisation of string operations.][42037]
3044 - [Compiler error message is now `aborting due to previous error(s)` instead of
3045   `aborting due to N previous errors`][42150] This was previously inaccurate and
3046   would only count certain kinds of errors.
3047 - [The compiler now supports Visual Studio 2017][42225]
3048 - [The compiler is now built against LLVM 4.0.1 by default][42948]
3049 - [Added a lot][42264] of [new error codes][42302]
3050 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
3051   libraries with C Run-time Libraries(CRT) to be statically linked.
3052 - [Fixed various ARM codegen bugs][42740]
3053
3054 Libraries
3055 ---------
3056
3057 - [`String` now implements `FromIterator<Cow<'a, str>>` and
3058   `Extend<Cow<'a, str>>`][41449]
3059 - [`Vec` now implements `From<&mut [T]>`][41530]
3060 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
3061 - [`SplitWhitespace` now implements `Clone`][41659]
3062 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
3063   1.5x faster][41764]
3064 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
3065   macros, but for printing to stderr.
3066
3067 Stabilized APIs
3068 ---------------
3069
3070 - [`OsString::shrink_to_fit`]
3071 - [`cmp::Reverse`]
3072 - [`Command::envs`]
3073 - [`thread::ThreadId`]
3074
3075 Cargo
3076 -----
3077
3078 - [Build scripts can now add environment variables to the environment
3079   the crate is being compiled in.
3080   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
3081 - [Subcommands now replace the current process rather than spawning a new
3082   child process][cargo/3970]
3083 - [Workspace members can now accept glob file patterns][cargo/3979]
3084 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
3085   the members in a given workspace.][cargo/3988]
3086 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
3087 - [Target directory path is now in the cargo metadata][cargo/4022]
3088 - [Cargo no longer checks out a local working directory for the
3089   crates.io index][cargo/4026] This should provide smaller file size for the
3090   registry, and improve cloning times, especially on Windows machines.
3091 - [Added an `--exclude` option for excluding certain packages when using the
3092   `--all` option][cargo/4031]
3093 - [Cargo will now automatically retry when receiving a 5xx error
3094   from crates.io][cargo/4032]
3095 - [The `--features` option now accepts multiple comma or space
3096   delimited values.][cargo/4084]
3097 - [Added support for custom target specific runners][cargo/3954]
3098
3099 Misc
3100 ----
3101
3102 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
3103   Windows Debugger.
3104 - [Rust will now release XZ compressed packages][rust-installer/57]
3105 - [rustup will now prefer to download rust packages with
3106   XZ compression][rustup/1100] over GZip packages.
3107 - [Added the ability to escape `#` in rust documentation][41785] By adding
3108   additional `#`'s ie. `##` is now `#`
3109
3110 Compatibility Notes
3111 -------------------
3112
3113 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
3114 - [`-Z` flags are now no longer allowed to be used on the stable
3115   compiler.][41751] This has been a warning for a year previous to this.
3116 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
3117   longer works][42844]. Users should migrate to the built-in `check`
3118   command, which has been available since 1.16.
3119 - [Ending a float literal with `._` is now a hard error.
3120   Example: `42._` .][41946]
3121 - [Any use of a private `extern crate` outside of its module is now a
3122   hard error.][36886] This was previously a warning.
3123 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
3124   relative while the `::` prefix makes a path absolute, but was ignored and the
3125   path was relative regardless.
3126 - [Floating point constants in match patterns is now a hard error][36890]
3127   This was previously a warning.
3128 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
3129   match patterns is now a hard error][36891] This was previously a warning.
3130 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
3131   a warning.
3132 - [From the pound escape, lines consisting of multiple `#`s are
3133   now visible][41785]
3134 - [It is an error to re-export private enum variants][42460]. This is
3135   known to break a number of crates that depend on an older version of
3136   mustache.
3137 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
3138   to use it to find the linker, and the build will fail where it did
3139   not previously][42607]
3140
3141 [36886]: https://github.com/rust-lang/rust/issues/36886
3142 [36888]: https://github.com/rust-lang/rust/issues/36888
3143 [36890]: https://github.com/rust-lang/rust/issues/36890
3144 [36891]: https://github.com/rust-lang/rust/issues/36891
3145 [36892]: https://github.com/rust-lang/rust/issues/36892
3146 [37406]: https://github.com/rust-lang/rust/issues/37406
3147 [39983]: https://github.com/rust-lang/rust/pull/39983
3148 [41145]: https://github.com/rust-lang/rust/pull/41145
3149 [41192]: https://github.com/rust-lang/rust/pull/41192
3150 [41258]: https://github.com/rust-lang/rust/pull/41258
3151 [41370]: https://github.com/rust-lang/rust/pull/41370
3152 [41449]: https://github.com/rust-lang/rust/pull/41449
3153 [41530]: https://github.com/rust-lang/rust/pull/41530
3154 [41624]: https://github.com/rust-lang/rust/pull/41624
3155 [41656]: https://github.com/rust-lang/rust/pull/41656
3156 [41659]: https://github.com/rust-lang/rust/pull/41659
3157 [41676]: https://github.com/rust-lang/rust/pull/41676
3158 [41751]: https://github.com/rust-lang/rust/pull/41751
3159 [41764]: https://github.com/rust-lang/rust/pull/41764
3160 [41785]: https://github.com/rust-lang/rust/pull/41785
3161 [41873]: https://github.com/rust-lang/rust/pull/41873
3162 [41907]: https://github.com/rust-lang/rust/pull/41907
3163 [41946]: https://github.com/rust-lang/rust/pull/41946
3164 [42016]: https://github.com/rust-lang/rust/pull/42016
3165 [42037]: https://github.com/rust-lang/rust/pull/42037
3166 [42068]: https://github.com/rust-lang/rust/pull/42068
3167 [42150]: https://github.com/rust-lang/rust/pull/42150
3168 [42162]: https://github.com/rust-lang/rust/pull/42162
3169 [42225]: https://github.com/rust-lang/rust/pull/42225
3170 [42264]: https://github.com/rust-lang/rust/pull/42264
3171 [42302]: https://github.com/rust-lang/rust/pull/42302
3172 [42460]: https://github.com/rust-lang/rust/issues/42460
3173 [42607]: https://github.com/rust-lang/rust/issues/42607
3174 [42740]: https://github.com/rust-lang/rust/pull/42740
3175 [42844]: https://github.com/rust-lang/rust/issues/42844
3176 [42948]: https://github.com/rust-lang/rust/pull/42948
3177 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
3178 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
3179 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
3180 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
3181 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
3182 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
3183 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
3184 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
3185 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
3186 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
3187 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
3188 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
3189 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
3190 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
3191 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
3192 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
3193 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
3194 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
3195 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
3196 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
3197 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
3198 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
3199
3200
3201 Version 1.18.0 (2017-06-08)
3202 ===========================
3203
3204 Language
3205 --------
3206
3207 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
3208   make the item visible to just that module tree. Also accepts the keyword
3209   `crate` to make something public to the whole crate but not users of the
3210   library. Example: `pub(crate) mod utils;`. [RFC 1422].
3211 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
3212   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
3213 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
3214   types like `Write + Send`, trailing `+` are now supported in trait objects,
3215   and better error reporting for trait objects starting with `?Sized`.
3216 - [0e+10 is now a valid floating point literal][40589]
3217 - [Now warns if you bind a lifetime parameter to 'static][40734]
3218 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
3219   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
3220   representation in some cases.][40377]
3221
3222 Compiler
3223 --------
3224
3225 - [rustc can now emit mir with `--emit mir`][39891]
3226 - [Improved LLVM IR for trivial functions][40367]
3227 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
3228 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
3229   opportunities found through profiling
3230 - [Improved backtrace formatting when panicking][38165]
3231
3232 Libraries
3233 ---------
3234
3235 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
3236   iterator hasn't been advanced the original `Vec` is reassembled with no actual
3237   iteration or reallocation.
3238 - [Simplified HashMap Bucket interface][40561] provides performance
3239   improvements for iterating and cloning.
3240 - [Specialize Vec::from_elem to use calloc][40409]
3241 - [Fixed Race condition in fs::create_dir_all][39799]
3242 - [No longer caching stdio on Windows][40516]
3243 - [Optimized insertion sort in slice][40807] insertion sort in some cases
3244   2.50%~ faster and in one case now 12.50% faster.
3245 - [Optimized `AtomicBool::fetch_nand`][41143]
3246
3247 Stabilized APIs
3248 ---------------
3249
3250 - [`Child::try_wait`]
3251 - [`HashMap::retain`]
3252 - [`HashSet::retain`]
3253 - [`PeekMut::pop`]
3254 - [`TcpStream::peek`]
3255 - [`UdpSocket::peek`]
3256 - [`UdpSocket::peek_from`]
3257
3258 Cargo
3259 -----
3260
3261 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
3262   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
3263 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
3264 - [Added Android build support][cargo/3885]
3265 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
3266   of a certain type, for example `cargo build --bins` will build all
3267   binaries.
3268 - [Added support for haiku][cargo/3952]
3269
3270 Misc
3271 ----
3272
3273 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
3274 - [Added rust-windbg script for better debugging on Windows][39983]
3275 - [Rust now uses the official cross compiler for NetBSD][40612]
3276 - [rustdoc now accepts `#` at the start of files][40828]
3277 - [Fixed jemalloc support for musl][41168]
3278
3279 Compatibility Notes
3280 -------------------
3281
3282 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
3283   always placed after the sign if it exists and before the digits. With the `#`
3284   flag the zeroes are placed after the prefix and before the digits.
3285 - [Due to the struct field optimisation][40377], using `transmute` on structs
3286   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
3287   always been undefined behavior, but is now more likely to break in practice.
3288 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
3289   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
3290   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
3291 - [Overlapping inherent `impl`s are now a hard error][40728]
3292 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
3293 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
3294   `out.asm` and `out.ll` instead of only one of the filetypes.
3295 - [ calling a function that returns `Self` will no longer work][41805] when
3296   the size of `Self` cannot be statically determined.
3297 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
3298   this has caused a few regressions namely:
3299
3300   - Changed the link order of local static/dynamic libraries (respecting the
3301     order on given rather than having the compiler reorder).
3302   - Changed how MinGW is linked, native code linked to dynamic libraries
3303     may require manually linking to the gcc support library (for the native
3304     code itself)
3305
3306 [38165]: https://github.com/rust-lang/rust/pull/38165
3307 [39799]: https://github.com/rust-lang/rust/pull/39799
3308 [39891]: https://github.com/rust-lang/rust/pull/39891
3309 [39983]: https://github.com/rust-lang/rust/pull/39983
3310 [40043]: https://github.com/rust-lang/rust/pull/40043
3311 [40241]: https://github.com/rust-lang/rust/pull/40241
3312 [40338]: https://github.com/rust-lang/rust/pull/40338
3313 [40367]: https://github.com/rust-lang/rust/pull/40367
3314 [40377]: https://github.com/rust-lang/rust/pull/40377
3315 [40409]: https://github.com/rust-lang/rust/pull/40409
3316 [40516]: https://github.com/rust-lang/rust/pull/40516
3317 [40556]: https://github.com/rust-lang/rust/pull/40556
3318 [40561]: https://github.com/rust-lang/rust/pull/40561
3319 [40589]: https://github.com/rust-lang/rust/pull/40589
3320 [40612]: https://github.com/rust-lang/rust/pull/40612
3321 [40723]: https://github.com/rust-lang/rust/pull/40723
3322 [40728]: https://github.com/rust-lang/rust/pull/40728
3323 [40731]: https://github.com/rust-lang/rust/pull/40731
3324 [40734]: https://github.com/rust-lang/rust/pull/40734
3325 [40805]: https://github.com/rust-lang/rust/pull/40805
3326 [40807]: https://github.com/rust-lang/rust/pull/40807
3327 [40828]: https://github.com/rust-lang/rust/pull/40828
3328 [40870]: https://github.com/rust-lang/rust/pull/40870
3329 [41085]: https://github.com/rust-lang/rust/pull/41085
3330 [41143]: https://github.com/rust-lang/rust/pull/41143
3331 [41168]: https://github.com/rust-lang/rust/pull/41168
3332 [41270]: https://github.com/rust-lang/rust/issues/41270
3333 [41469]: https://github.com/rust-lang/rust/pull/41469
3334 [41805]: https://github.com/rust-lang/rust/issues/41805
3335 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
3336 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
3337 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
3338 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
3339 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
3340 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
3341 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
3342 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
3343 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
3344 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
3345 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
3346 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
3347 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
3348 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
3349
3350
3351 Version 1.17.0 (2017-04-27)
3352 ===========================
3353
3354 Language
3355 --------
3356
3357 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
3358 * [Fields of structs may be initialized without duplicating the field/variable
3359   names][39761]. [RFC 1682]
3360 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
3361 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3362   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
3363   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
3364   `'b`. Soundness fix.
3365 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
3366 * [Static variables may contain references to other statics][40027]
3367
3368 Compiler
3369 --------
3370
3371 * [Exit quickly on only `--emit dep-info`][40336]
3372 * [Make `-C relocation-model` more correctly determine whether the linker
3373   creates a position-independent executable][40245]
3374 * [Add `-C overflow-checks` to directly control whether integer overflow
3375   panics][40037]
3376 * [The rustc type checker now checks items on demand instead of in a single
3377   in-order pass][40008]. This is mostly an internal refactoring in support of
3378   future work, including incremental type checking, but also resolves [RFC
3379   1647], allowing `Self` to appear in `impl` `where` clauses.
3380 * [Optimize vtable loads][39995]
3381 * [Turn off vectorization for Emscripten targets][39990]
3382 * [Provide suggestions for unknown macros imported with `use`][39953]
3383 * [Fix ICEs in path resolution][39939]
3384 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
3385 * [Add clearer error message using `&str + &str`][39116]
3386
3387 Stabilized APIs
3388 ---------------
3389
3390 * [`Arc::into_raw`]
3391 * [`Arc::from_raw`]
3392 * [`Arc::ptr_eq`]
3393 * [`Rc::into_raw`]
3394 * [`Rc::from_raw`]
3395 * [`Rc::ptr_eq`]
3396 * [`Ordering::then`]
3397 * [`Ordering::then_with`]
3398 * [`BTreeMap::range`]
3399 * [`BTreeMap::range_mut`]
3400 * [`collections::Bound`]
3401 * [`process::abort`]
3402 * [`ptr::read_unaligned`]
3403 * [`ptr::write_unaligned`]
3404 * [`Result::expect_err`]
3405 * [`Cell::swap`]
3406 * [`Cell::replace`]
3407 * [`Cell::into_inner`]
3408 * [`Cell::take`]
3409
3410 Libraries
3411 ---------
3412
3413 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
3414 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
3415 * [`String` implements `FromIterator<&char>`][40028]
3416 * `Box` [implements][40009] a number of new conversions:
3417   `From<Box<str>> for String`,
3418   `From<Box<[T]>> for Vec<T>`,
3419   `From<Box<CStr>> for CString`,
3420   `From<Box<OsStr>> for OsString`,
3421   `From<Box<Path>> for PathBuf`,
3422   `Into<Box<str>> for String`,
3423   `Into<Box<[T]>> for Vec<T>`,
3424   `Into<Box<CStr>> for CString`,
3425   `Into<Box<OsStr>> for OsString`,
3426   `Into<Box<Path>> for PathBuf`,
3427   `Default for Box<str>`,
3428   `Default for Box<CStr>`,
3429   `Default for Box<OsStr>`,
3430   `From<&CStr> for Box<CStr>`,
3431   `From<&OsStr> for Box<OsStr>`,
3432   `From<&Path> for Box<Path>`
3433 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
3434 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
3435 * [Slightly optimize `slice::sort`][39538]
3436 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
3437 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
3438   `Box<str>` implements `From<&str>`][39438]
3439 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
3440   `From<(I, u16)> where I: Into<IpAddr>`][39372]
3441 * [`format!` estimates the needed capacity before writing a string][39356]
3442 * [Support unprivileged symlink creation in Windows][38921]
3443 * [`PathBuf` implements `Default`][38764]
3444 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
3445 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
3446   and poor hash functions.
3447
3448 Cargo
3449 -----
3450
3451 * [Add `cargo check --all`][cargo/3731]
3452 * [Add an option to ignore SSL revocation checking][cargo/3699]
3453 * [Add `cargo run --package`][cargo/3691]
3454 * [Add `required_features`][cargo/3667]
3455 * [Assume `build.rs` is a build script][cargo/3664]
3456 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
3457
3458 Misc
3459 ----
3460
3461 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
3462   `rustbook`][39633]
3463 * [The "Unstable Book" documents nightly-only features][ubook]
3464 * [Improve the style of the sidebar in rustdoc output][40265]
3465 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
3466 * [Fix MSP430 breakage due to `i128`][40257]
3467 * [Preliminary Solaris/SPARCv9 support][39903]
3468 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
3469   run without installing the MSVC runtime.
3470 * [`rustdoc --test` includes file names in test names][39788]
3471 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
3472   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
3473 * [Initial support for `aarch64-unknown-freebsd`][39491]
3474 * [Initial support for `i686-unknown-netbsd`][39426]
3475 * [This release no longer includes the old makefile build system][39431]. Rust
3476   is built with a custom build system, written in Rust, and with Cargo.
3477 * [Add Debug implementations for libcollection structs][39002]
3478 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
3479 * [`--test-threads=0` produces an error][38945]
3480 * [`rustup` installs documentation by default][40526]
3481 * [The Rust source includes NatVis visualizations][39843]. These can be used by
3482   WinDbg and Visual Studio to improve the debugging experience.
3483
3484 Compatibility Notes
3485 -------------------
3486
3487 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
3488   workaround, either use MSVC 2015 or run vcvars.bat.
3489 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3490   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
3491   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
3492   fix.
3493 * [`format!` and `Display::to_string` panic if an underlying formatting
3494   implementation returns an error][40117]. Previously the error was silently
3495   ignored. It is incorrect for `write_fmt` to return an error when writing
3496   to a string.
3497 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
3498   crates were marked stable and could be accessed from the stable toolchain.
3499 * [Rust git source no longer includes vendored crates][39728]. Those that need
3500   to build with vendored crates should build from release tarballs.
3501 * [Fix inert attributes from `proc_macro_derives`][39572]
3502 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
3503   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
3504   build system.
3505 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
3506   existing code generally ignores the type of dead-code unless a type-hint is
3507   provided; this can cause surprising inference interactions particularly around
3508   defaulting. The new code uniformly ignores the result type of dead-code.
3509 * [Tuple-struct constructors with private fields are no longer visible][38932]
3510 * [Lifetime parameters that do not appear in the arguments are now considered
3511   early-bound][38897], resolving a soundness bug (#[32330]). The
3512   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
3513   April of 2016.
3514 * [rustdoc: fix doctests with non-feature crate attributes][38161]
3515 * [Make transmuting from fn item types to pointer-sized types a hard
3516   error][34198]
3517
3518 [27787]: https://github.com/rust-lang/rust/issues/27787
3519 [32330]: https://github.com/rust-lang/rust/issues/32330
3520 [34198]: https://github.com/rust-lang/rust/pull/34198
3521 [38161]: https://github.com/rust-lang/rust/pull/38161
3522 [38368]: https://github.com/rust-lang/rust/pull/38368
3523 [38584]: https://github.com/rust-lang/rust/issues/38584
3524 [38661]: https://github.com/rust-lang/rust/pull/38661
3525 [38764]: https://github.com/rust-lang/rust/pull/38764
3526 [38864]: https://github.com/rust-lang/rust/issues/38864
3527 [38897]: https://github.com/rust-lang/rust/pull/38897
3528 [38921]: https://github.com/rust-lang/rust/pull/38921
3529 [38932]: https://github.com/rust-lang/rust/pull/38932
3530 [38945]: https://github.com/rust-lang/rust/pull/38945
3531 [38981]: https://github.com/rust-lang/rust/pull/38981
3532 [39002]: https://github.com/rust-lang/rust/pull/39002
3533 [39116]: https://github.com/rust-lang/rust/pull/39116
3534 [39193]: https://github.com/rust-lang/rust/pull/39193
3535 [39265]: https://github.com/rust-lang/rust/pull/39265
3536 [39356]: https://github.com/rust-lang/rust/pull/39356
3537 [39372]: https://github.com/rust-lang/rust/pull/39372
3538 [39426]: https://github.com/rust-lang/rust/pull/39426
3539 [39431]: https://github.com/rust-lang/rust/pull/39431
3540 [39438]: https://github.com/rust-lang/rust/pull/39438
3541 [39440]: https://github.com/rust-lang/rust/pull/39440
3542 [39485]: https://github.com/rust-lang/rust/pull/39485
3543 [39491]: https://github.com/rust-lang/rust/pull/39491
3544 [39518]: https://github.com/rust-lang/rust/pull/39518
3545 [39538]: https://github.com/rust-lang/rust/pull/39538
3546 [39572]: https://github.com/rust-lang/rust/pull/39572
3547 [39633]: https://github.com/rust-lang/rust/pull/39633
3548 [39642]: https://github.com/rust-lang/rust/pull/39642
3549 [39728]: https://github.com/rust-lang/rust/pull/39728
3550 [39761]: https://github.com/rust-lang/rust/pull/39761
3551 [39788]: https://github.com/rust-lang/rust/pull/39788
3552 [39793]: https://github.com/rust-lang/rust/pull/39793
3553 [39837]: https://github.com/rust-lang/rust/pull/39837
3554 [39843]: https://github.com/rust-lang/rust/pull/39843
3555 [39851]: https://github.com/rust-lang/rust/pull/39851
3556 [39903]: https://github.com/rust-lang/rust/pull/39903
3557 [39939]: https://github.com/rust-lang/rust/pull/39939
3558 [39953]: https://github.com/rust-lang/rust/pull/39953
3559 [39960]: https://github.com/rust-lang/rust/pull/39960
3560 [39990]: https://github.com/rust-lang/rust/pull/39990
3561 [39995]: https://github.com/rust-lang/rust/pull/39995
3562 [40008]: https://github.com/rust-lang/rust/pull/40008
3563 [40009]: https://github.com/rust-lang/rust/pull/40009
3564 [40027]: https://github.com/rust-lang/rust/pull/40027
3565 [40028]: https://github.com/rust-lang/rust/pull/40028
3566 [40037]: https://github.com/rust-lang/rust/pull/40037
3567 [40117]: https://github.com/rust-lang/rust/pull/40117
3568 [40166]: https://github.com/rust-lang/rust/pull/40166
3569 [40245]: https://github.com/rust-lang/rust/pull/40245
3570 [40257]: https://github.com/rust-lang/rust/pull/40257
3571 [40261]: https://github.com/rust-lang/rust/pull/40261
3572 [40265]: https://github.com/rust-lang/rust/pull/40265
3573 [40319]: https://github.com/rust-lang/rust/pull/40319
3574 [40336]: https://github.com/rust-lang/rust/pull/40336
3575 [40526]: https://github.com/rust-lang/rust/pull/40526
3576 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
3577 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
3578 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
3579 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
3580 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
3581 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
3582 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
3583 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
3584 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
3585 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
3586 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
3587 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
3588 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
3589 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
3590 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
3591 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
3592 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
3593 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
3594 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
3595 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
3596 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
3597 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
3598 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
3599 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
3600 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
3601 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
3602 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
3603 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
3604 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
3605 [mdbook]: https://crates.io/crates/mdbook
3606 [ubook]: https://doc.rust-lang.org/unstable-book/
3607
3608
3609 Version 1.16.0 (2017-03-16)
3610 ===========================
3611
3612 Language
3613 --------
3614
3615 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3616 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3617   match patterns][38069]
3618 * [Clean up semantics of `self` in an import list][38313]
3619 * [`Self` may appear in `impl` headers][38920]
3620 * [`Self` may appear in struct expressions][39282]
3621
3622 Compiler
3623 --------
3624
3625 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
3626   a `.rmeta` file containing only crate metadata][38571]. This can be
3627   used by tools like the Rust Language Service to perform
3628   metadata-only builds.
3629 * [Levenshtein based typo suggestions now work in most places, while
3630   previously they worked only for fields and sometimes for local
3631   variables][38927]. Together with the overhaul of "no
3632   resolution"/"unexpected resolution" errors (#[38154]) they result in
3633   large and systematic improvement in resolution diagnostics.
3634 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
3635   `U`][38670]
3636 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
3637 * [`rustc` no longer attempts to provide "consider using an explicit
3638   lifetime" suggestions][37057]. They were inaccurate.
3639
3640 Stabilized APIs
3641 ---------------
3642
3643 * [`VecDeque::truncate`]
3644 * [`VecDeque::resize`]
3645 * [`String::insert_str`]
3646 * [`Duration::checked_add`]
3647 * [`Duration::checked_sub`]
3648 * [`Duration::checked_div`]
3649 * [`Duration::checked_mul`]
3650 * [`str::replacen`]
3651 * [`str::repeat`]
3652 * [`SocketAddr::is_ipv4`]
3653 * [`SocketAddr::is_ipv6`]
3654 * [`IpAddr::is_ipv4`]
3655 * [`IpAddr::is_ipv6`]
3656 * [`Vec::dedup_by`]
3657 * [`Vec::dedup_by_key`]
3658 * [`Result::unwrap_or_default`]
3659 * [`<*const T>::wrapping_offset`]
3660 * [`<*mut T>::wrapping_offset`]
3661 * `CommandExt::creation_flags`
3662 * [`File::set_permissions`]
3663 * [`String::split_off`]
3664
3665 Libraries
3666 ---------
3667
3668 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
3669   their argument by `Borrow` parameter][37761]
3670 * [All public types in std implement `Debug`][38006]
3671 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
3672 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
3673 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3674   Windows][38274]
3675 * [std: Fix partial writes in `LineWriter`][38062]
3676 * [std: Clamp max read/write sizes on Unix][38062]
3677 * [Use more specific panic message for `&str` slicing errors][38066]
3678 * [`TcpListener::set_only_v6` is deprecated][38304]. This
3679   functionality cannot be achieved in std currently.
3680 * [`writeln!`, like `println!`, now accepts a form with no string
3681   or formatting arguments, to just print a newline][38469]
3682 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
3683 * [Reduce the size of static data in `std_unicode::tables`][38781]
3684 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
3685   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
3686   `Display`][38909]
3687 * [`Duration` implements `Sum`][38712]
3688 * [`String` implements `ToSocketAddrs`][39048]
3689
3690 Cargo
3691 -----
3692
3693 * [The `cargo check` command does a type check of a project without
3694   building it][cargo/3296]
3695 * [crates.io will display CI badges from Travis and AppVeyor, if
3696   specified in Cargo.toml][cargo/3546]
3697 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
3698 * [Compilation profiles accept integer values for `debug`, in addition
3699   to `true` and `false`. These are passed to `rustc` as the value to
3700   `-C debuginfo`][cargo/3534]
3701 * [Implement `cargo --version --verbose`][cargo/3604]
3702 * [All builds now output 'dep-info' build dependencies compatible with
3703   make and ninja][cargo/3557]
3704 * [Build all workspace members with `build --all`][cargo/3511]
3705 * [Document all workspace members with `doc --all`][cargo/3515]
3706 * [Path deps outside workspace are not members][cargo/3443]
3707
3708 Misc
3709 ----
3710
3711 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
3712   the path to the Rust implementation][38589]
3713 * [The `armv7-linux-androideabi` target no longer enables NEON
3714   extensions, per Google's ABI guide][38413]
3715 * [The stock standard library can be compiled for Redox OS][38401]
3716 * [Rust has initial SPARC support][38726]. Tier 3. No builds
3717   available.
3718 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
3719   builds available.
3720 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
3721
3722 Compatibility Notes
3723 -------------------
3724
3725 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3726   match patterns][38069]
3727 * In this release, references to uninhabited types can not be
3728   pattern-matched. This was accidentally allowed in 1.15.
3729 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3730 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3731   Windows][38274]
3732 * [Clean up semantics of `self` in an import list][38313]
3733 * Reimplemented lifetime elision. This change was almost entirely compatible
3734   with existing code, but it did close a number of small bugs and loopholes,
3735   as well as being more accepting in some other [cases][41105].
3736
3737 [37057]: https://github.com/rust-lang/rust/pull/37057
3738 [37761]: https://github.com/rust-lang/rust/pull/37761
3739 [38006]: https://github.com/rust-lang/rust/pull/38006
3740 [38051]: https://github.com/rust-lang/rust/pull/38051
3741 [38062]: https://github.com/rust-lang/rust/pull/38062
3742 [38062]: https://github.com/rust-lang/rust/pull/38622
3743 [38066]: https://github.com/rust-lang/rust/pull/38066
3744 [38069]: https://github.com/rust-lang/rust/pull/38069
3745 [38131]: https://github.com/rust-lang/rust/pull/38131
3746 [38154]: https://github.com/rust-lang/rust/pull/38154
3747 [38274]: https://github.com/rust-lang/rust/pull/38274
3748 [38304]: https://github.com/rust-lang/rust/pull/38304
3749 [38313]: https://github.com/rust-lang/rust/pull/38313
3750 [38314]: https://github.com/rust-lang/rust/pull/38314
3751 [38327]: https://github.com/rust-lang/rust/pull/38327
3752 [38401]: https://github.com/rust-lang/rust/pull/38401
3753 [38413]: https://github.com/rust-lang/rust/pull/38413
3754 [38469]: https://github.com/rust-lang/rust/pull/38469
3755 [38559]: https://github.com/rust-lang/rust/pull/38559
3756 [38571]: https://github.com/rust-lang/rust/pull/38571
3757 [38580]: https://github.com/rust-lang/rust/pull/38580
3758 [38589]: https://github.com/rust-lang/rust/pull/38589
3759 [38670]: https://github.com/rust-lang/rust/pull/38670
3760 [38712]: https://github.com/rust-lang/rust/pull/38712
3761 [38726]: https://github.com/rust-lang/rust/pull/38726
3762 [38781]: https://github.com/rust-lang/rust/pull/38781
3763 [38798]: https://github.com/rust-lang/rust/pull/38798
3764 [38909]: https://github.com/rust-lang/rust/pull/38909
3765 [38920]: https://github.com/rust-lang/rust/pull/38920
3766 [38927]: https://github.com/rust-lang/rust/pull/38927
3767 [39048]: https://github.com/rust-lang/rust/pull/39048
3768 [39282]: https://github.com/rust-lang/rust/pull/39282
3769 [39379]: https://github.com/rust-lang/rust/pull/39379
3770 [41105]: https://github.com/rust-lang/rust/issues/41105
3771 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
3772 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
3773 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
3774 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
3775 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
3776 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
3777 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
3778 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
3779 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
3780 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
3781 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
3782 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
3783 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
3784 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
3785 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
3786 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
3787 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
3788 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
3789 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
3790 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
3791 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
3792 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
3793 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
3794 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
3795 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
3796 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
3797 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
3798 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
3799 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
3800 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
3801
3802
3803 Version 1.15.1 (2017-02-09)
3804 ===========================
3805
3806 * [Fix IntoIter::as_mut_slice's signature][39466]
3807 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
3808
3809 [39466]: https://github.com/rust-lang/rust/pull/39466
3810 [39523]: https://github.com/rust-lang/rust/pull/39523
3811
3812
3813 Version 1.15.0 (2017-02-02)
3814 ===========================
3815
3816 Language
3817 --------
3818
3819 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
3820   stable. This allows popular code-generating crates like Serde and Diesel to
3821   work ergonomically. [RFC 1681].
3822 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
3823   with curly braces][36868]. Part of [RFC 1506].
3824 * [A number of minor changes to name resolution have been activated][37127].
3825   They add up to more consistent semantics, allowing for future evolution of
3826   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
3827   details of what is different. The breaking changes here have been transitioned
3828   through the [`legacy_imports`] lint since 1.14, with no known regressions.
3829 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
3830   bounds][38279]
3831 * [`?Sized` can be used in `where` clauses][37791]
3832 * [There is now a limit on the size of monomorphized types and it can be
3833   modified with the `#![type_size_limit]` crate attribute, similarly to
3834   the `#![recursion_limit]` attribute][37789]
3835
3836 Compiler
3837 --------
3838
3839 * [On Windows, the compiler will apply dllimport attributes when linking to
3840   extern functions][37973]. Additional attributes and flags can control which
3841   library kind is linked and its name. [RFC 1717].
3842 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
3843 * [The `--test` flag works with procedural macro crates][38107]
3844 * [Fix `extern "aapcs" fn` ABI][37814]
3845 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
3846 * [The `format!` expander recognizes incorrect `printf` and shell-style
3847   formatting directives and suggests the correct format][37613].
3848 * [Only report one error for all unused imports in an import list][37456]
3849
3850 Compiler Performance
3851 --------------------
3852
3853 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
3854 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
3855 * [Don't clone in `UnificationTable::probe`][37848]
3856 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
3857 * [Use small vectors in type walker][37760]
3858 * [Macro expansion performance was improved][37701]
3859 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
3860 * [Replace FNV with a faster hash function][37229]
3861
3862 Stabilized APIs
3863 ---------------
3864
3865 * [`std::iter::Iterator::min_by`]
3866 * [`std::iter::Iterator::max_by`]
3867 * [`std::os::*::fs::FileExt`]
3868 * [`std::sync::atomic::Atomic*::get_mut`]
3869 * [`std::sync::atomic::Atomic*::into_inner`]
3870 * [`std::vec::IntoIter::as_slice`]
3871 * [`std::vec::IntoIter::as_mut_slice`]
3872 * [`std::sync::mpsc::Receiver::try_iter`]
3873 * [`std::os::unix::process::CommandExt::before_exec`]
3874 * [`std::rc::Rc::strong_count`]
3875 * [`std::rc::Rc::weak_count`]
3876 * [`std::sync::Arc::strong_count`]
3877 * [`std::sync::Arc::weak_count`]
3878 * [`std::char::encode_utf8`]
3879 * [`std::char::encode_utf16`]
3880 * [`std::cell::Ref::clone`]
3881 * [`std::io::Take::into_inner`]
3882
3883 Libraries
3884 ---------
3885
3886 * [The standard sorting algorithm has been rewritten for dramatic performance
3887   improvements][38192]. It is a hybrid merge sort, drawing influences from
3888   Timsort. Previously it was a naive merge sort.
3889 * [`Iterator::nth` no longer has a `Sized` bound][38134]
3890 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
3891   performance.
3892 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
3893   and `char_indices().last()`][37882]
3894 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
3895 * [Chinese characters display correctly in `fmt::Debug`][37855]
3896 * [Derive `Default` for `Duration`][37699]
3897 * [Support creation of anonymous pipes on WinXP/2k][37677]
3898 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
3899 * [Don't pass overlapped handles to processes][38835]
3900
3901 Cargo
3902 -----
3903
3904 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
3905   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
3906   should instead check the variable at runtime with `std::env`. That the value
3907   was set at build time was a bug, and incorrect when cross-compiling. This
3908   change is known to cause breakage.
3909 * [Add `--all` flag to `cargo test`][cargo/3221]
3910 * [Compile statically against the MSVC CRT][cargo/3363]
3911 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
3912 * [Link OpenSSL statically on OSX][cargo/3311]
3913 * [Apply new fingerprinting to build dir outputs][cargo/3310]
3914 * [Test for bad path overrides with summaries][cargo/3336]
3915 * [Require `cargo install --vers` to take a semver version][cargo/3338]
3916 * [Fix retrying crate downloads for network errors][cargo/3348]
3917 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
3918 * [Emit more info on --message-format=json][cargo/3319]
3919 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
3920 * [Don't ignore errors in workspace manifest][cargo/3409]
3921 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
3922
3923 Tooling
3924 -------
3925
3926 * [Test runners (binaries built with `--test`) now support a `--list` argument
3927   that lists the tests it contains][38185]
3928 * [Test runners now support a `--exact` argument that makes the test filter
3929   match exactly, instead of matching only a substring of the test name][38181]
3930 * [rustdoc supports a `--playground-url` flag][37763]
3931 * [rustdoc provides more details about `#[should_panic]` errors][37749]
3932
3933 Misc
3934 ----
3935
3936 * [The Rust build system is now written in Rust][37817]. The Makefiles may
3937   continue to be used in this release by passing `--disable-rustbuild` to the
3938   configure script, but they will be deleted soon. Note that the new build
3939   system uses a different on-disk layout that will likely affect any scripts
3940   building Rust.
3941 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
3942   releases.
3943 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
3944 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
3945   releases.
3946
3947 Compatibility Notes
3948 -------------------
3949
3950 * [A number of minor changes to name resolution have been activated][37127].
3951   They add up to more consistent semantics, allowing for future evolution of
3952   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
3953   details of what is different. The breaking changes here have been transitioned
3954   through the [`legacy_imports`] lint since 1.14, with no known regressions.
3955 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
3956   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
3957   should instead check the variable at runtime with `std::env`. That the value
3958   was set at build time was a bug, and incorrect when cross-compiling. This
3959   change is known to cause breakage.
3960 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
3961   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
3962   1.10 and is now an error by default. It will become a hard error in the near
3963   future.
3964 * [The semantics relating modules to file system directories are changing in
3965   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
3966   lint, which is a warning in this release, and will become a hard error in the
3967   future.
3968 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
3969 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
3970   the underlying iterator][37834]
3971
3972 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
3973 [33685]: https://github.com/rust-lang/rust/issues/33685
3974 [36868]: https://github.com/rust-lang/rust/pull/36868
3975 [37127]: https://github.com/rust-lang/rust/pull/37127
3976 [37229]: https://github.com/rust-lang/rust/pull/37229
3977 [37456]: https://github.com/rust-lang/rust/pull/37456
3978 [37527]: https://github.com/rust-lang/rust/pull/37527
3979 [37602]: https://github.com/rust-lang/rust/pull/37602
3980 [37613]: https://github.com/rust-lang/rust/pull/37613
3981 [37615]: https://github.com/rust-lang/rust/pull/37615
3982 [37636]: https://github.com/rust-lang/rust/pull/37636
3983 [37627]: https://github.com/rust-lang/rust/pull/37627
3984 [37642]: https://github.com/rust-lang/rust/pull/37642
3985 [37677]: https://github.com/rust-lang/rust/pull/37677
3986 [37699]: https://github.com/rust-lang/rust/pull/37699
3987 [37701]: https://github.com/rust-lang/rust/pull/37701
3988 [37705]: https://github.com/rust-lang/rust/pull/37705
3989 [37749]: https://github.com/rust-lang/rust/pull/37749
3990 [37760]: https://github.com/rust-lang/rust/pull/37760
3991 [37763]: https://github.com/rust-lang/rust/pull/37763
3992 [37764]: https://github.com/rust-lang/rust/pull/37764
3993 [37789]: https://github.com/rust-lang/rust/pull/37789
3994 [37791]: https://github.com/rust-lang/rust/pull/37791
3995 [37814]: https://github.com/rust-lang/rust/pull/37814
3996 [37817]: https://github.com/rust-lang/rust/pull/37817
3997 [37834]: https://github.com/rust-lang/rust/pull/37834
3998 [37848]: https://github.com/rust-lang/rust/pull/37848
3999 [37855]: https://github.com/rust-lang/rust/pull/37855
4000 [37882]: https://github.com/rust-lang/rust/pull/37882
4001 [37888]: https://github.com/rust-lang/rust/pull/37888
4002 [37973]: https://github.com/rust-lang/rust/pull/37973
4003 [37979]: https://github.com/rust-lang/rust/pull/37979
4004 [38086]: https://github.com/rust-lang/rust/pull/38086
4005 [38107]: https://github.com/rust-lang/rust/pull/38107
4006 [38117]: https://github.com/rust-lang/rust/pull/38117
4007 [38134]: https://github.com/rust-lang/rust/pull/38134
4008 [38146]: https://github.com/rust-lang/rust/pull/38146
4009 [38181]: https://github.com/rust-lang/rust/pull/38181
4010 [38182]: https://github.com/rust-lang/rust/pull/38182
4011 [38185]: https://github.com/rust-lang/rust/pull/38185
4012 [38192]: https://github.com/rust-lang/rust/pull/38192
4013 [38279]: https://github.com/rust-lang/rust/pull/38279
4014 [38835]: https://github.com/rust-lang/rust/pull/38835
4015 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4016 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4017 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
4018 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
4019 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
4020 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
4021 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
4022 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
4023 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
4024 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
4025 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
4026 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
4027 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
4028 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
4029 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
4030 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
4031 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
4032 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
4033 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
4034 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
4035 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
4036 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
4037 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
4038 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
4039 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
4040 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
4041 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
4042 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
4043 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
4044 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
4045 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
4046 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
4047 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
4048 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
4049 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
4050 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
4051 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
4052 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
4053
4054
4055 Version 1.14.0 (2016-12-22)
4056 ===========================
4057
4058 Language
4059 --------
4060
4061 * [`..` matches multiple tuple fields in enum variants, structs
4062   and tuples][36843]. [RFC 1492].
4063 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
4064 * [`use *` and `use ::*` both glob-import from the crate root][37367]
4065 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
4066   dereferencing][36822]
4067
4068 Compiler
4069 --------
4070
4071 * [Mark enums with non-zero discriminant as non-zero][37224]
4072 * [Lower-case `static mut` names are linted like other
4073   statics and consts][37162]
4074 * [Fix ICE on some macros in const integer positions
4075    (e.g. `[u8; m!()]`)][36819]
4076 * [Improve error message and snippet for "did you mean `x`"][36798]
4077 * [Add a panic-strategy field to the target specification][36794]
4078 * [Include LLVM version in `--version --verbose`][37200]
4079
4080 Compile-time Optimizations
4081 --------------------------
4082
4083 * [Improve macro expansion performance][37569]
4084 * [Shrink `Expr_::ExprInlineAsm`][37445]
4085 * [Replace all uses of SHA-256 with BLAKE2b][37439]
4086 * [Reduce the number of bytes hashed by `IchHasher`][37427]
4087 * [Avoid more allocations when compiling html5ever][37373]
4088 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
4089 * [Avoid some allocations in the macro parser][37318]
4090 * [Use a faster deflate setting][37298]
4091 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
4092   during interning of slices][37270]
4093 * [Optimize `write_metadata`][37267]
4094 * [Don't process obligation forest cycles when stalled][37231]
4095 * [Avoid many `CrateConfig` clones][37161]
4096 * [Optimize `Substs::super_fold_with`][37108]
4097 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
4098 * [Speed up `plug_leaks`][36917]
4099
4100 Libraries
4101 ---------
4102
4103 * [`println!()`, with no arguments, prints newline][36825].
4104   Previously, an empty string was required to achieve the same.
4105 * [`Wrapping` impls standard binary and unary operators, as well as
4106    the `Sum` and `Product` iterators][37356]
4107 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
4108   Vec<T>`][37326]
4109 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
4110   `VecDeque` iterators][37315]
4111 * [Improve `SipHasher` performance on small values][37312]
4112 * [Add Iterator trait TrustedLen to enable better FromIterator /
4113   Extend][37306]
4114 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
4115 * [`ReadDir` implements `Debug`][37221]
4116 * [Implement `RefUnwindSafe` for atomic types][37178]
4117 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
4118 * [Avoid allocations in `Decoder::read_str`][37064]
4119 * [`io::Error` implements `From<io::ErrorKind>`][37037]
4120 * [Impl `Debug` for raw pointers to unsized data][36880]
4121 * [Don't reuse `HashMap` random seeds][37470]
4122 * [The internal memory layout of `HashMap` is more cache-friendly, for
4123   significant improvements in some operations][36692]
4124 * [`HashMap` uses less memory on 32-bit architectures][36595]
4125 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
4126
4127 Cargo
4128 -----
4129
4130 * [Expose rustc cfg values to build scripts][cargo/3243]
4131 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
4132 * [Fix passing --features when testing multiple packages][cargo/3280]
4133 * [Use a single profile set per workspace][cargo/3249]
4134 * [Load `replace` sections from lock files][cargo/3220]
4135 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
4136
4137 Tooling
4138 -------
4139
4140 * [rustup is the recommended Rust installation method][1.14rustup]
4141 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
4142   S390x. These are [tier 2] platforms and may have major defects. Follow the
4143   instructions on the website to install, or add the targets to an existing
4144   installation with `rustup target add`. The new target triples are:
4145   - `mips-unknown-linux-gnu`
4146   - `mipsel-unknown-linux-gnu`
4147   - `mips64-unknown-linux-gnuabi64`
4148   - `mips64el-unknown-linux-gnuabi64 `
4149   - `powerpc-unknown-linux-gnu`
4150   - `powerpc64-unknown-linux-gnu`
4151   - `powerpc64le-unknown-linux-gnu`
4152   - `s390x-unknown-linux-gnu `
4153 * This release includes target (std) builds for ARM Linux running MUSL
4154   libc. These are [tier 2] platforms and may have major defects. Add the
4155   following triples to an existing rustup installation with `rustup target add`:
4156   - `arm-unknown-linux-musleabi`
4157   - `arm-unknown-linux-musleabihf`
4158   - `armv7-unknown-linux-musleabihf`
4159 * This release includes [experimental support for WebAssembly][1.14wasm], via
4160   the `wasm32-unknown-emscripten` target. This target is known to have major
4161   defects. Please test, report, and fix.
4162 * rustup no longer installs documentation by default. Run `rustup
4163   component add rust-docs` to install.
4164 * [Fix line stepping in debugger][37310]
4165 * [Enable line number debuginfo in releases][37280]
4166
4167 Misc
4168 ----
4169
4170 * [Disable jemalloc on aarch64/powerpc/mips][37392]
4171 * [Add support for Fuchsia OS][37313]
4172 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
4173
4174 Compatibility Notes
4175 -------------------
4176
4177 * [A number of forward-compatibility lints used by the compiler
4178   to gradually introduce language changes have been converted
4179   to deny by default][36894]:
4180   - ["use of inaccessible extern crate erroneously allowed"][36886]
4181   - ["type parameter default erroneously allowed in invalid location"][36887]
4182   - ["detects super or self keywords at the beginning of global path"][36888]
4183   - ["two overlapping inherent impls define an item with the same name
4184     were erroneously allowed"][36889]
4185   - ["floating-point constants cannot be used in patterns"][36890]
4186   - ["constants of struct or enum type can only be used in a pattern if
4187      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
4188   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
4189 * [Prohibit patterns in trait methods without bodies][37378]
4190 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
4191 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
4192 * [The `$crate` macro variable is accepted in fewer locations][37213]
4193 * [Impls specifying extra region requirements beyond the trait
4194   they implement are rejected][37167]
4195 * [Enums may not be unsized][37111]. Unsized enums are intended to
4196   work but never have. For now they are forbidden.
4197 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
4198
4199 [tier 2]: https://forge.rust-lang.org/platform-support.html
4200 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
4201 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
4202 [36430]: https://github.com/rust-lang/rust/pull/36430
4203 [36595]: https://github.com/rust-lang/rust/pull/36595
4204 [36595]: https://github.com/rust-lang/rust/pull/36595
4205 [36692]: https://github.com/rust-lang/rust/pull/36692
4206 [36767]: https://github.com/rust-lang/rust/pull/36767
4207 [36794]: https://github.com/rust-lang/rust/pull/36794
4208 [36798]: https://github.com/rust-lang/rust/pull/36798
4209 [36819]: https://github.com/rust-lang/rust/pull/36819
4210 [36822]: https://github.com/rust-lang/rust/pull/36822
4211 [36825]: https://github.com/rust-lang/rust/pull/36825
4212 [36843]: https://github.com/rust-lang/rust/pull/36843
4213 [36880]: https://github.com/rust-lang/rust/pull/36880
4214 [36886]: https://github.com/rust-lang/rust/issues/36886
4215 [36887]: https://github.com/rust-lang/rust/issues/36887
4216 [36888]: https://github.com/rust-lang/rust/issues/36888
4217 [36889]: https://github.com/rust-lang/rust/issues/36889
4218 [36890]: https://github.com/rust-lang/rust/issues/36890
4219 [36891]: https://github.com/rust-lang/rust/issues/36891
4220 [36892]: https://github.com/rust-lang/rust/issues/36892
4221 [36894]: https://github.com/rust-lang/rust/pull/36894
4222 [36917]: https://github.com/rust-lang/rust/pull/36917
4223 [36993]: https://github.com/rust-lang/rust/pull/36993
4224 [37037]: https://github.com/rust-lang/rust/pull/37037
4225 [37064]: https://github.com/rust-lang/rust/pull/37064
4226 [37094]: https://github.com/rust-lang/rust/pull/37094
4227 [37108]: https://github.com/rust-lang/rust/pull/37108
4228 [37111]: https://github.com/rust-lang/rust/pull/37111
4229 [37161]: https://github.com/rust-lang/rust/pull/37161
4230 [37162]: https://github.com/rust-lang/rust/pull/37162
4231 [37167]: https://github.com/rust-lang/rust/pull/37167
4232 [37178]: https://github.com/rust-lang/rust/pull/37178
4233 [37200]: https://github.com/rust-lang/rust/pull/37200
4234 [37213]: https://github.com/rust-lang/rust/pull/37213
4235 [37221]: https://github.com/rust-lang/rust/pull/37221
4236 [37224]: https://github.com/rust-lang/rust/pull/37224
4237 [37230]: https://github.com/rust-lang/rust/pull/37230
4238 [37231]: https://github.com/rust-lang/rust/pull/37231
4239 [37247]: https://github.com/rust-lang/rust/pull/37247
4240 [37267]: https://github.com/rust-lang/rust/pull/37267
4241 [37270]: https://github.com/rust-lang/rust/pull/37270
4242 [37273]: https://github.com/rust-lang/rust/pull/37273
4243 [37280]: https://github.com/rust-lang/rust/pull/37280
4244 [37298]: https://github.com/rust-lang/rust/pull/37298
4245 [37306]: https://github.com/rust-lang/rust/pull/37306
4246 [37310]: https://github.com/rust-lang/rust/pull/37310
4247 [37312]: https://github.com/rust-lang/rust/pull/37312
4248 [37313]: https://github.com/rust-lang/rust/pull/37313
4249 [37315]: https://github.com/rust-lang/rust/pull/37315
4250 [37318]: https://github.com/rust-lang/rust/pull/37318
4251 [37322]: https://github.com/rust-lang/rust/pull/37322
4252 [37326]: https://github.com/rust-lang/rust/pull/37326
4253 [37351]: https://github.com/rust-lang/rust/pull/37351
4254 [37356]: https://github.com/rust-lang/rust/pull/37356
4255 [37367]: https://github.com/rust-lang/rust/pull/37367
4256 [37373]: https://github.com/rust-lang/rust/pull/37373
4257 [37378]: https://github.com/rust-lang/rust/pull/37378
4258 [37389]: https://github.com/rust-lang/rust/pull/37389
4259 [37392]: https://github.com/rust-lang/rust/pull/37392
4260 [37427]: https://github.com/rust-lang/rust/pull/37427
4261 [37439]: https://github.com/rust-lang/rust/pull/37439
4262 [37445]: https://github.com/rust-lang/rust/pull/37445
4263 [37470]: https://github.com/rust-lang/rust/pull/37470
4264 [37569]: https://github.com/rust-lang/rust/pull/37569
4265 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4266 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
4267 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
4268 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
4269 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
4270 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
4271 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
4272
4273
4274 Version 1.13.0 (2016-11-10)
4275 ===========================
4276
4277 Language
4278 --------
4279
4280 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
4281   errors, like the `try!` macro, described in [RFC 0243].
4282 * [Stabilize macros in type position][36014]. Described in [RFC 873].
4283 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
4284 * [Fix `#[derive]` for empty tuple structs/variants][35728]
4285 * [Fix lifetime rules for 'if' conditions][36029]
4286 * [Avoid loading and parsing unconfigured non-inline modules][36482]
4287
4288 Compiler
4289 --------
4290
4291 * [Add the `-C link-arg` argument][36574]
4292 * [Remove the old AST-based backend from rustc_trans][35764]
4293 * [Don't enable NEON by default on armv7 Linux][35814]
4294 * [Fix debug line number info for macro expansions][35238]
4295 * [Do not emit "class method" debuginfo for types that are not
4296   DICompositeType][36008]
4297 * [Warn about multiple conflicting #[repr] hints][34623]
4298 * [When sizing DST, don't double-count nested struct prefixes][36351]
4299 * [Default RUST_MIN_STACK to 16MiB for now][36505]
4300 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
4301 * [Reject macros with empty repetitions to avoid infinite loop][36721]
4302 * [Expand macros without recursing to avoid stack overflows][36214]
4303
4304 Diagnostics
4305 -----------
4306
4307 * [Replace macro backtraces with labeled local uses][35702]
4308 * [Improve error message for misplaced doc comments][33922]
4309 * [Buffer unix and lock windows to prevent message interleaving][35975]
4310 * [Update lifetime errors to specifically note temporaries][36171]
4311 * [Special case a few colors for Windows][36178]
4312 * [Suggest `use self` when such an import resolves][36289]
4313 * [Be more specific when type parameter shadows primitive type][36338]
4314 * Many minor improvements
4315
4316 Compile-time Optimizations
4317 --------------------------
4318
4319 * [Compute and cache HIR hashes at beginning][35854]
4320 * [Don't hash types in loan paths][36004]
4321 * [Cache projections in trans][35761]
4322 * [Optimize the parser's last token handling][36527]
4323 * [Only instantiate #[inline] functions in codegen units referencing
4324   them][36524]. This leads to big improvements in cases where crates export
4325   define many inline functions without using them directly.
4326 * [Lazily allocate TypedArena's first chunk][36592]
4327 * [Don't allocate during default HashSet creation][36734]
4328
4329 Stabilized APIs
4330 ---------------
4331
4332 * [`checked_abs`]
4333 * [`wrapping_abs`]
4334 * [`overflowing_abs`]
4335 * [`RefCell::try_borrow`]
4336 * [`RefCell::try_borrow_mut`]
4337
4338 Libraries
4339 ---------
4340
4341 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
4342 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
4343   covariant][35354]
4344 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
4345 * [Implement `Debug` for `std::vec::IntoIter`][35707]
4346 * [`CString`: avoid excessive growth just to 0-terminate][35871]
4347 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
4348 * [Use arc4rand on FreeBSD][35884]
4349 * [memrchr: Correct aligned offset computation][35969]
4350 * [Improve Demangling of Rust Symbols][36059]
4351 * [Use monotonic time in condition variables][35048]
4352 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
4353 * [Implement conversion traits for `char`][35755]
4354 * [Fix illegal instruction caused by overflow in channel cloning][36104]
4355 * [Zero first byte of CString on drop][36264]
4356 * [Inherit overflow checks for sum and product][36372]
4357 * [Add missing Eq implementations][36423]
4358 * [Implement `Debug` for `DirEntry`][36631]
4359 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
4360   `errno`][36754]
4361 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4362 * [Implement more traits for `std::io::ErrorKind`][35911]
4363 * [Optimize BinaryHeap bounds checking][36072]
4364 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
4365   `extend_with_element`][36355]
4366 * [Fix overflow checking in unsigned pow()][34942]
4367
4368 Cargo
4369 -----
4370
4371 * This release includes security fixes to both curl and OpenSSL.
4372 * [Fix transitive doctests when panic=abort][cargo/3021]
4373 * [Add --all-features flag to cargo][cargo/3038]
4374 * [Reject path-based dependencies in `cargo package`][cargo/3060]
4375 * [Don't parse the home directory more than once][cargo/3078]
4376 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
4377 * [Update OpenSSL to 1.0.2j][cargo/3121]
4378 * [Add license and license_file to cargo metadata output][cargo/3110]
4379 * [Make crates-io registry URL optional in config; ignore all changes to
4380   source.crates-io][cargo/3089]
4381 * [Don't download dependencies from other platforms][cargo/3123]
4382 * [Build transitive dev-dependencies when needed][cargo/3125]
4383 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
4384 * [Avoid updating registry when adding existing deps][cargo/3144]
4385 * [Warn about path overrides that won't work][cargo/3136]
4386 * [Use workspaces during `cargo install`][cargo/3146]
4387 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
4388 * [Add --message-format flag][cargo/3000]
4389 * [Pass target environment for rustdoc][cargo/3205]
4390 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
4391 * [Update curl and curl-sys][cargo/3241]
4392 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
4393
4394 Tooling
4395 -------
4396
4397 * [rustdoc: Add the `--sysroot` argument][36586]
4398 * [rustdoc: Fix a couple of issues with the search results][35655]
4399 * [rustdoc: remove the `!` from macro URLs and titles][35234]
4400 * [gdb: Fix pretty-printing special-cased Rust types][35585]
4401 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
4402
4403 Misc
4404 ----
4405
4406 * [Remove unmaintained style guide][35124]
4407 * [Add s390x support][36369]
4408 * [Initial work at Haiku OS support][36727]
4409 * [Add mips-uclibc targets][35734]
4410 * [Crate-ify compiler-rt into compiler-builtins][35021]
4411 * [Add rustc version info (git hash + date) to dist tarball][36213]
4412 * Many documentation improvements
4413
4414 Compatibility Notes
4415 -------------------
4416
4417 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4418 * [Deny (by default) transmuting from fn item types to pointer-sized
4419   types][34923]. Continuing the long transition to zero-sized fn items,
4420   per [RFC 401].
4421 * [Fix `#[derive]` for empty tuple structs/variants][35728].
4422   Part of [RFC 1506].
4423 * [Issue deprecation warnings for safe accesses to extern statics][36173]
4424 * [Fix lifetime rules for 'if' conditions][36029].
4425 * [Inherit overflow checks for sum and product][36372].
4426 * [Forbid user-defined macros named "macro_rules"][36730].
4427
4428 [33922]: https://github.com/rust-lang/rust/pull/33922
4429 [34623]: https://github.com/rust-lang/rust/pull/34623
4430 [34923]: https://github.com/rust-lang/rust/pull/34923
4431 [34942]: https://github.com/rust-lang/rust/pull/34942
4432 [34982]: https://github.com/rust-lang/rust/pull/34982
4433 [35021]: https://github.com/rust-lang/rust/pull/35021
4434 [35048]: https://github.com/rust-lang/rust/pull/35048
4435 [35074]: https://github.com/rust-lang/rust/pull/35074
4436 [35124]: https://github.com/rust-lang/rust/pull/35124
4437 [35234]: https://github.com/rust-lang/rust/pull/35234
4438 [35238]: https://github.com/rust-lang/rust/pull/35238
4439 [35354]: https://github.com/rust-lang/rust/pull/35354
4440 [35559]: https://github.com/rust-lang/rust/pull/35559
4441 [35585]: https://github.com/rust-lang/rust/pull/35585
4442 [35627]: https://github.com/rust-lang/rust/pull/35627
4443 [35655]: https://github.com/rust-lang/rust/pull/35655
4444 [35702]: https://github.com/rust-lang/rust/pull/35702
4445 [35707]: https://github.com/rust-lang/rust/pull/35707
4446 [35728]: https://github.com/rust-lang/rust/pull/35728
4447 [35734]: https://github.com/rust-lang/rust/pull/35734
4448 [35755]: https://github.com/rust-lang/rust/pull/35755
4449 [35761]: https://github.com/rust-lang/rust/pull/35761
4450 [35764]: https://github.com/rust-lang/rust/pull/35764
4451 [35814]: https://github.com/rust-lang/rust/pull/35814
4452 [35854]: https://github.com/rust-lang/rust/pull/35854
4453 [35871]: https://github.com/rust-lang/rust/pull/35871
4454 [35884]: https://github.com/rust-lang/rust/pull/35884
4455 [35911]: https://github.com/rust-lang/rust/pull/35911
4456 [35969]: https://github.com/rust-lang/rust/pull/35969
4457 [35975]: https://github.com/rust-lang/rust/pull/35975
4458 [36004]: https://github.com/rust-lang/rust/pull/36004
4459 [36008]: https://github.com/rust-lang/rust/pull/36008
4460 [36014]: https://github.com/rust-lang/rust/pull/36014
4461 [36029]: https://github.com/rust-lang/rust/pull/36029
4462 [36059]: https://github.com/rust-lang/rust/pull/36059
4463 [36072]: https://github.com/rust-lang/rust/pull/36072
4464 [36101]: https://github.com/rust-lang/rust/pull/36101
4465 [36104]: https://github.com/rust-lang/rust/pull/36104
4466 [36171]: https://github.com/rust-lang/rust/pull/36171
4467 [36173]: https://github.com/rust-lang/rust/pull/36173
4468 [36178]: https://github.com/rust-lang/rust/pull/36178
4469 [36213]: https://github.com/rust-lang/rust/pull/36213
4470 [36214]: https://github.com/rust-lang/rust/pull/36214
4471 [36264]: https://github.com/rust-lang/rust/pull/36264
4472 [36266]: https://github.com/rust-lang/rust/pull/36266
4473 [36289]: https://github.com/rust-lang/rust/pull/36289
4474 [36338]: https://github.com/rust-lang/rust/pull/36338
4475 [36351]: https://github.com/rust-lang/rust/pull/36351
4476 [36355]: https://github.com/rust-lang/rust/pull/36355
4477 [36369]: https://github.com/rust-lang/rust/pull/36369
4478 [36372]: https://github.com/rust-lang/rust/pull/36372
4479 [36423]: https://github.com/rust-lang/rust/pull/36423
4480 [36482]: https://github.com/rust-lang/rust/pull/36482
4481 [36505]: https://github.com/rust-lang/rust/pull/36505
4482 [36524]: https://github.com/rust-lang/rust/pull/36524
4483 [36527]: https://github.com/rust-lang/rust/pull/36527
4484 [36551]: https://github.com/rust-lang/rust/pull/36551
4485 [36574]: https://github.com/rust-lang/rust/pull/36574
4486 [36586]: https://github.com/rust-lang/rust/pull/36586
4487 [36592]: https://github.com/rust-lang/rust/pull/36592
4488 [36631]: https://github.com/rust-lang/rust/pull/36631
4489 [36639]: https://github.com/rust-lang/rust/pull/36639
4490 [36721]: https://github.com/rust-lang/rust/pull/36721
4491 [36727]: https://github.com/rust-lang/rust/pull/36727
4492 [36730]: https://github.com/rust-lang/rust/pull/36730
4493 [36734]: https://github.com/rust-lang/rust/pull/36734
4494 [36754]: https://github.com/rust-lang/rust/pull/36754
4495 [36995]: https://github.com/rust-lang/rust/pull/36995
4496 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
4497 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
4498 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4499 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
4500 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
4501 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
4502 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
4503 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
4504 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
4505 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
4506 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
4507 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
4508 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
4509 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
4510 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
4511 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
4512 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
4513 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
4514 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
4515 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
4516 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
4517 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
4518 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
4519 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
4520 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
4521 [rustup]: https://www.rustup.rs
4522 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
4523 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
4524 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
4525 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
4526 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
4527 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
4528 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
4529
4530
4531 Version 1.12.1 (2016-10-20)
4532 ===========================
4533
4534 Regression Fixes
4535 ----------------
4536
4537 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
4538 * [Confusion with double negation and booleans][36856]
4539 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
4540 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
4541 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
4542 * [Corrupted memory after updated to 1.12][36936]
4543 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
4544 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
4545 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
4546
4547 [36381]: https://github.com/rust-lang/rust/issues/36381
4548 [36856]: https://github.com/rust-lang/rust/issues/36856
4549 [36875]: https://github.com/rust-lang/rust/issues/36875
4550 [36924]: https://github.com/rust-lang/rust/issues/36924
4551 [36926]: https://github.com/rust-lang/rust/issues/36926
4552 [36936]: https://github.com/rust-lang/rust/issues/36936
4553 [37026]: https://github.com/rust-lang/rust/issues/37026
4554 [37112]: https://github.com/rust-lang/rust/issues/37112
4555 [37153]: https://github.com/rust-lang/rust/issues/37153
4556
4557
4558 Version 1.12.0 (2016-09-29)
4559 ===========================
4560
4561 Highlights
4562 ----------
4563
4564 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4565   This translation pass is far simpler than the previous AST->LLVM pass, and
4566   creates opportunities to perform new optimizations directly on the MIR. It
4567   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4568 * [`rustc` presents a new, more readable error format, along with
4569   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
4570   Most common editors supporting Rust have been updated to work with it. It was
4571   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
4572
4573 Compiler
4574 --------
4575
4576 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4577   This translation pass is far simpler than the previous AST->LLVM pass, and
4578   creates opportunities to perform new optimizations directly on the MIR. It
4579   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4580 * [Print the Rust target name, not the LLVM target name, with
4581   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
4582 * [The computation of `TypeId` is correct in some cases where it was previously
4583   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
4584 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
4585 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
4586   `--print relocation-models`, and `--print code-models` print the available
4587   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
4588   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
4589 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
4590   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
4591   These targets produce statically-linked binaries. There are no binary release
4592   builds yet though.
4593
4594 Diagnostics
4595 -----------
4596
4597 * [`rustc` presents a new, more readable error format, along with
4598   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
4599   Most common editors supporting Rust have been updated to work with it. It was
4600   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
4601 * [In error descriptions, references are now described in plain English,
4602   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
4603 * [In error type descriptions, unknown numeric types are named `{integer}` or
4604   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
4605 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
4606
4607 Language
4608 --------
4609
4610 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
4611 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
4612 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
4613   useful](https://github.com/rust-lang/rust/pull/34908)
4614 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
4615   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
4616 * [Semicolons are properly required as statement delimiters inside
4617   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
4618 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
4619
4620 Stabilized APIs
4621 ---------------
4622
4623 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
4624 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
4625 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
4626 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
4627 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
4628 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
4629 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
4630 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
4631 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
4632 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
4633   Both on Unix and Windows.
4634 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
4635 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
4636 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
4637 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
4638 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
4639 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
4640 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
4641 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
4642
4643 Libraries
4644 ---------
4645
4646 * [The `format!` macro and friends now allow a single argument to be formatted
4647   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
4648 * [The lifetime bounds on `[T]::binary_search_by` and
4649   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
4650 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
4651 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
4652 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
4653 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
4654 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
4655 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
4656 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
4657 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
4658   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
4659 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
4660   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
4661 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
4662 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
4663   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
4664 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
4665 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
4666 * [`mpsc::sync_channel` `Receiver`s return any available message before
4667   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
4668 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
4669 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
4670
4671 Cargo
4672 -----
4673
4674 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
4675 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
4676 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
4677 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
4678 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
4679 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
4680 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
4681 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
4682 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
4683 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
4684 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
4685 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
4686 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
4687 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
4688 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
4689 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
4690
4691 Performance
4692 -----------
4693
4694 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
4695 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
4696
4697 Tooling
4698 -------
4699
4700 * [Test binaries now support a `--test-threads` argument to specify the number
4701   of threads used to run tests, and which acts the same as the
4702   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
4703 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
4704 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
4705 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
4706 * [Rust releases now come with source packages that can be installed by rustup
4707   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
4708   The resulting source code can be used by tools and IDES, located in the
4709   sysroot under `lib/rustlib/src`.
4710
4711 Misc
4712 ----
4713
4714 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
4715 * Many minor improvements to the documentation.
4716 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
4717
4718 Compatibility Notes
4719 -------------------
4720
4721 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
4722   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
4723 * [When formatting strings, if "precision" is specified, the "fill",
4724   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
4725 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
4726
4727
4728 Version 1.11.0 (2016-08-18)
4729 ===========================
4730
4731 Language
4732 --------
4733
4734 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
4735 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
4736 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
4737 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
4738 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
4739
4740 Stabilized APIs
4741 ---------------
4742
4743 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
4744 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
4745 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
4746 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
4747 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
4748 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
4749   (in libcore - previously stabilized in libstd)
4750 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
4751   (in libcore - previously stabilized in libstd)
4752 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
4753   (in libcore - previously stabilized in libstd)
4754 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
4755   (in libcore - previously stabilized in libstd)
4756 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
4757 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
4758 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
4759 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
4760
4761 Libraries
4762 ---------
4763
4764 * [The `thread_local!` macro supports multiple definitions in a single
4765    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
4766 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
4767 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
4768   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
4769 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
4770 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
4771 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
4772 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
4773
4774 Cargo
4775 -----
4776
4777 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
4778 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
4779 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
4780 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
4781 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
4782   and `-vv` prints warnings for all crates.
4783 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
4784 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
4785   This provides room for expansion by arbitrary tools.
4786 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
4787 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
4788 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
4789 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
4790 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
4791 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
4792 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
4793
4794 Performance
4795 -----------
4796
4797 * [Caching projections speeds up type check dramatically for some
4798   workloads](https://github.com/rust-lang/rust/pull/33816)
4799 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
4800   This hasher is faster, but is believed to provide sufficient
4801   protection from collision attacks.
4802 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
4803
4804 Rustdoc
4805 -------
4806
4807 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
4808 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
4809 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
4810 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
4811 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
4812
4813 Tooling
4814 -------
4815
4816 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
4817 * [When emitting debug info, rustc emits frame pointers for closures,
4818   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
4819 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
4820 * Many more errors have been given error codes and extended
4821   explanations
4822 * API documentation continues to be improved, with many new examples
4823
4824 Misc
4825 ----
4826
4827 * [rustc no longer hangs when dependencies recursively re-export
4828   submodules](https://github.com/rust-lang/rust/pull/34542)
4829 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
4830 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
4831   rewritten](https://github.com/rust-lang/rust/pull/33895)
4832 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
4833   No targets use this yet, but it works toward AVR support.
4834
4835 Compatibility Notes
4836 -------------------
4837
4838 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
4839 * [The new follow-set rules that place restrictions on `macro_rules!`
4840   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
4841   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
4842   and has been a warning since 1.10.
4843 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
4844   This causes breakage in some corner cases.
4845
4846
4847 Version 1.10.0 (2016-07-07)
4848 ===========================
4849
4850 Language
4851 --------
4852
4853 * [Allow `concat_idents!` in type positions as well as in expression
4854   positions](https://github.com/rust-lang/rust/pull/33735).
4855 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
4856   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
4857 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
4858 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
4859 * [`panic!` can be converted to a runtime abort with the
4860   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
4861   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
4862 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
4863   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
4864   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
4865   Note that Cargo does not yet directly support cdylibs.
4866
4867 Stabilized APIs
4868 ---------------
4869
4870 * `os::windows::fs::OpenOptionsExt::access_mode`
4871 * `os::windows::fs::OpenOptionsExt::share_mode`
4872 * `os::windows::fs::OpenOptionsExt::custom_flags`
4873 * `os::windows::fs::OpenOptionsExt::attributes`
4874 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
4875 * `os::unix::fs::OpenOptionsExt::custom_flags`
4876 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
4877 * `Default for sync::Weak`
4878 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
4879 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
4880 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
4881 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
4882 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
4883 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
4884 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
4885 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
4886 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
4887 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
4888 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
4889 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
4890 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
4891 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
4892 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
4893 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
4894 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
4895 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
4896 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
4897 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
4898 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
4899 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
4900 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
4901 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
4902 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
4903 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
4904 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
4905 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
4906 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
4907 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
4908 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
4909 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
4910 * Read/Write/RawFd impls for `UnixStream`
4911 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
4912 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
4913 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
4914 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
4915 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
4916 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
4917 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
4918 * RawFd impls for `UnixListener`
4919 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
4920 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
4921 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
4922 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
4923 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
4924 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
4925 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
4926 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
4927 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
4928 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
4929 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
4930 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
4931 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
4932 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
4933 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
4934 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
4935 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
4936 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
4937 * RawFd impls for `UnixDatagram`
4938 * `{BTree,Hash}Map::values_mut`
4939 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
4940
4941 Libraries
4942 ---------
4943
4944 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
4945   The semantics of this minor method are subtle and probably not what
4946   most people want.
4947 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
4948 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
4949   will fall back to `/dev/urandom` temporarily to avoid blocking
4950   during early boot](https://github.com/rust-lang/rust/pull/33086).
4951 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
4952 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
4953 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
4954 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
4955 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
4956 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
4957   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
4958
4959 Cargo
4960 -----
4961 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
4962   This controls the runtime behavior of the `panic!` macro
4963   and can be either "unwind" (the default), or "abort".
4964   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
4965 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
4966 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
4967 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
4968   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
4969 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
4970 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
4971 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
4972   By default they are retried twice, which can be customized with the
4973   `net.retry` value in `.cargo/config`.
4974 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
4975 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
4976 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
4977 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
4978   Makes it possible to install multiple crates in parallel.
4979 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
4980 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
4981 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
4982 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
4983 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
4984 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
4985
4986 Performance
4987 -----------
4988
4989 * [rustc memory usage was reduced by refactoring the context used for
4990   type checking](https://github.com/rust-lang/rust/pull/33425).
4991 * [Speed up creation of `HashMap`s by caching the random keys used
4992   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
4993 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
4994 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
4995 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
4996   10x faster than the previous lookup tables.
4997 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
4998
4999 Usability
5000 ---------
5001
5002 * Many incremental improvements to documentation and rustdoc.
5003 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
5004 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
5005 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
5006 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
5007 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
5008 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
5009 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
5010
5011 Misc
5012 ----
5013
5014 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
5015 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
5016 * [`std` no longer prints backtraces on platforms where the running
5017   module must be loaded with `env::current_exe`, which can't be relied
5018   on](https://github.com/rust-lang/rust/pull/33554).
5019 * This release includes std binaries for the i586-unknown-linux-gnu,
5020   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
5021   i586 target is for old x86 hardware without SSE2, and the armv7
5022   target is for Android running on modern ARM architectures.
5023 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
5024   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
5025 * [On Unix the runtime aborts by calling `libc::abort` instead of
5026   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
5027 * [Rust is now bootstrapped from the previous release of Rust,
5028   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
5029
5030 Compatibility Notes
5031 -------------------
5032
5033 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
5034 * [`target_env` for Linux ARM targets is just `gnu`, not
5035   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
5036 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
5037 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
5038 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
5039   Affects how macros are parsed.
5040 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
5041 * [Feature-gated attributes on macro-generated macro invocations are
5042   now rejected](https://github.com/rust-lang/rust/pull/32791).
5043 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
5044   This caused some minor changes to type inference.
5045
5046
5047 Version 1.9.0 (2016-05-26)
5048 ==========================
5049
5050 Language
5051 --------
5052
5053 * The `#[deprecated]` attribute when applied to an API will generate
5054   warnings when used. The warnings may be suppressed with
5055   `#[allow(deprecated)]`. [RFC 1270].
5056 * [`fn` item types are zero sized, and each `fn` names a unique
5057   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5058   `transmute` on a `fn` type will generate a warning for a few cycles,
5059   then will be converted to an error.
5060 * [Field and method resolution understand visibility, so private
5061   fields and methods cannot prevent the proper use of public fields
5062   and methods][1.9fv].
5063 * [The parser considers unicode codepoints in the
5064   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
5065
5066 Stabilized APIs
5067 ---------------
5068
5069 * [`std::panic`]
5070 * [`std::panic::catch_unwind`] (renamed from `recover`)
5071 * [`std::panic::resume_unwind`] (renamed from `propagate`)
5072 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
5073 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
5074 * [`str::is_char_boundary`]
5075 * [`<*const T>::as_ref`]
5076 * [`<*mut T>::as_ref`]
5077 * [`<*mut T>::as_mut`]
5078 * [`AsciiExt::make_ascii_uppercase`]
5079 * [`AsciiExt::make_ascii_lowercase`]
5080 * [`char::decode_utf16`]
5081 * [`char::DecodeUtf16`]
5082 * [`char::DecodeUtf16Error`]
5083 * [`char::DecodeUtf16Error::unpaired_surrogate`]
5084 * [`BTreeSet::take`]
5085 * [`BTreeSet::replace`]
5086 * [`BTreeSet::get`]
5087 * [`HashSet::take`]
5088 * [`HashSet::replace`]
5089 * [`HashSet::get`]
5090 * [`OsString::with_capacity`]
5091 * [`OsString::clear`]
5092 * [`OsString::capacity`]
5093 * [`OsString::reserve`]
5094 * [`OsString::reserve_exact`]
5095 * [`OsStr::is_empty`]
5096 * [`OsStr::len`]
5097 * [`std::os::unix::thread`]
5098 * [`RawPthread`]
5099 * [`JoinHandleExt`]
5100 * [`JoinHandleExt::as_pthread_t`]
5101 * [`JoinHandleExt::into_pthread_t`]
5102 * [`HashSet::hasher`]
5103 * [`HashMap::hasher`]
5104 * [`CommandExt::exec`]
5105 * [`File::try_clone`]
5106 * [`SocketAddr::set_ip`]
5107 * [`SocketAddr::set_port`]
5108 * [`SocketAddrV4::set_ip`]
5109 * [`SocketAddrV4::set_port`]
5110 * [`SocketAddrV6::set_ip`]
5111 * [`SocketAddrV6::set_port`]
5112 * [`SocketAddrV6::set_flowinfo`]
5113 * [`SocketAddrV6::set_scope_id`]
5114 * [`slice::copy_from_slice`]
5115 * [`ptr::read_volatile`]
5116 * [`ptr::write_volatile`]
5117 * [`OpenOptions::create_new`]
5118 * [`TcpStream::set_nodelay`]
5119 * [`TcpStream::nodelay`]
5120 * [`TcpStream::set_ttl`]
5121 * [`TcpStream::ttl`]
5122 * [`TcpStream::set_only_v6`]
5123 * [`TcpStream::only_v6`]
5124 * [`TcpStream::take_error`]
5125 * [`TcpStream::set_nonblocking`]
5126 * [`TcpListener::set_ttl`]
5127 * [`TcpListener::ttl`]
5128 * [`TcpListener::set_only_v6`]
5129 * [`TcpListener::only_v6`]
5130 * [`TcpListener::take_error`]
5131 * [`TcpListener::set_nonblocking`]
5132 * [`UdpSocket::set_broadcast`]
5133 * [`UdpSocket::broadcast`]
5134 * [`UdpSocket::set_multicast_loop_v4`]
5135 * [`UdpSocket::multicast_loop_v4`]
5136 * [`UdpSocket::set_multicast_ttl_v4`]
5137 * [`UdpSocket::multicast_ttl_v4`]
5138 * [`UdpSocket::set_multicast_loop_v6`]
5139 * [`UdpSocket::multicast_loop_v6`]
5140 * [`UdpSocket::set_multicast_ttl_v6`]
5141 * [`UdpSocket::multicast_ttl_v6`]
5142 * [`UdpSocket::set_ttl`]
5143 * [`UdpSocket::ttl`]
5144 * [`UdpSocket::set_only_v6`]
5145 * [`UdpSocket::only_v6`]
5146 * [`UdpSocket::join_multicast_v4`]
5147 * [`UdpSocket::join_multicast_v6`]
5148 * [`UdpSocket::leave_multicast_v4`]
5149 * [`UdpSocket::leave_multicast_v6`]
5150 * [`UdpSocket::take_error`]
5151 * [`UdpSocket::connect`]
5152 * [`UdpSocket::send`]
5153 * [`UdpSocket::recv`]
5154 * [`UdpSocket::set_nonblocking`]
5155
5156 Libraries
5157 ---------
5158
5159 * [`std::sync::Once` is poisoned if its initialization function
5160   fails][1.9o].
5161 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
5162 * [Most types implement `fmt::Debug`][1.9db].
5163 * [The default buffer size used by `BufReader` and `BufWriter` was
5164   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
5165   used by other languages.
5166 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
5167   `Duration` additionally implements `*=` and `/=`][1.9ta].
5168 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
5169 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
5170 * [`Chain` implements `BufRead`][1.9ch].
5171 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
5172
5173 Cargo
5174 -----
5175
5176 * [Cargo can now run concurrently][1.9cc].
5177 * [Top-level overrides allow specific revisions of crates to be
5178   overridden through the entire crate graph][1.9ct].  This is intended
5179   to make upgrades easier for large projects, by allowing crates to be
5180   forked temporarily until they've been upgraded and republished.
5181 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
5182 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
5183   on the commandline][1.9cf]. `rustc` arguments can also be specified
5184   in the `build.rustflags` configuration key.
5185
5186 Performance
5187 -----------
5188
5189 * [The time complexity of comparing variables for equivalence during type
5190   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
5191   to major compilation time improvement in some scenarios.
5192 * [`ToString` is specialized for `str`, giving it the same performance
5193   as `to_owned`][1.9ts].
5194 * [Spawning processes with `Command::output` no longer creates extra
5195   threads][1.9sp].
5196 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
5197   for C-like enums][1.9cl].
5198
5199 Misc
5200 ----
5201
5202 * [Passing the `--quiet` flag to a test runner will produce
5203   much-abbreviated output][1.9q].
5204 * The Rust Project now publishes std binaries for the
5205   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
5206   `i586-pc-windows-msvc` targets.
5207
5208 Compatibility Notes
5209 -------------------
5210
5211 * [`std::sync::Once` is poisoned if its initialization function
5212   fails][1.9o].
5213 * [It is illegal to define methods with the same name in overlapping
5214   inherent `impl` blocks][1.9sn].
5215 * [`fn` item types are zero sized, and each `fn` names a unique
5216   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5217   `transmute` on a `fn` type will generate a warning for a few cycles,
5218   then will be converted to an error.
5219 * [Improvements to const evaluation may trigger new errors when integer
5220   literals are out of range][1.9ce].
5221
5222
5223 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
5224 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
5225 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
5226 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
5227 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
5228 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
5229 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
5230 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
5231 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
5232 [1.9db]: https://github.com/rust-lang/rust/pull/32054
5233 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
5234 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
5235 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
5236 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
5237 [1.9o]: https://github.com/rust-lang/rust/pull/32325
5238 [1.9q]: https://github.com/rust-lang/rust/pull/31887
5239 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
5240 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
5241 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
5242 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
5243 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
5244 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
5245 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
5246 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
5247 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5248 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
5249 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5250 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
5251 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
5252 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
5253 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
5254 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
5255 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
5256 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
5257 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
5258 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
5259 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
5260 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
5261 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
5262 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
5263 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
5264 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
5265 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
5266 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
5267 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
5268 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
5269 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
5270 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
5271 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
5272 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
5273 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
5274 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
5275 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
5276 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
5277 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
5278 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
5279 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
5280 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
5281 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
5282 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
5283 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5284 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5285 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5286 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5287 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5288 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5289 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
5290 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5291 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
5292 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5293 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5294 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5295 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5296 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5297 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
5298 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
5299 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
5300 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
5301 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
5302 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
5303 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
5304 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
5305 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
5306 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
5307 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
5308 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
5309 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
5310 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
5311 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
5312 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
5313 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
5314 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
5315 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
5316 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
5317 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
5318 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
5319 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
5320 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
5321 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
5322 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
5323 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
5324 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
5325 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
5326 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
5327 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
5328 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
5329 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
5330 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
5331 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
5332 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
5333
5334
5335 Version 1.8.0 (2016-04-14)
5336 ==========================
5337
5338 Language
5339 --------
5340
5341 * Rust supports overloading of compound assignment statements like
5342   `+=` by implementing the [`AddAssign`], [`SubAssign`],
5343   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
5344   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
5345   traits. [RFC 953].
5346 * Empty structs can be defined with braces, as in `struct Foo { }`, in
5347   addition to the non-braced form, `struct Foo;`. [RFC 218].
5348
5349 Libraries
5350 ---------
5351
5352 * Stabilized APIs:
5353   * [`str::encode_utf16`] (renamed from `utf16_units`)
5354   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
5355   * [`Ref::map`]
5356   * [`RefMut::map`]
5357   * [`ptr::drop_in_place`]
5358   * [`time::Instant`]
5359   * [`time::SystemTime`]
5360   * [`Instant::now`]
5361   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
5362   * [`Instant::elapsed`]
5363   * [`SystemTime::now`]
5364   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
5365   * [`SystemTime::elapsed`]
5366   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
5367   * [`SystemTimeError`]
5368   * [`SystemTimeError::duration`]
5369   * Various impls for `SystemTimeError`
5370   * [`UNIX_EPOCH`]
5371   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
5372     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
5373     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
5374 * [The `write!` and `writeln!` macros correctly emit errors if any of
5375   their arguments can't be formatted][1.8w].
5376 * [Various I/O functions support large files on 32-bit Linux][1.8l].
5377 * [The Unix-specific `raw` modules, which contain a number of
5378   redefined C types are deprecated][1.8r], including `os::raw::unix`,
5379   `os::raw::macos`, and `os::raw::linux`. These modules defined types
5380   such as `ino_t` and `dev_t`. The inconsistency of these definitions
5381   across platforms was making it difficult to implement `std`
5382   correctly. Those that need these definitions should use the `libc`
5383   crate. [RFC 1415].
5384 * The Unix-specific `MetadataExt` traits, including
5385   `os::unix::fs::MetadataExt`, which expose values such as inode
5386   numbers [no longer return platform-specific types][1.8r], but
5387   instead return widened integers. [RFC 1415].
5388 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
5389 * [Atomic loads and stores are not volatile][1.8a].
5390 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
5391
5392 Performance
5393 -----------
5394
5395 * [Inlining hash functions lead to a 3% compile-time improvement in
5396   some workloads][1.8h].
5397 * When using jemalloc, its symbols are [unprefixed so that it
5398   overrides the libc malloc implementation][1.8h]. This means that for
5399   rustc, LLVM is now using jemalloc, which results in a 6%
5400   compile-time improvement on a specific workload.
5401 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
5402
5403 Misc
5404 ----
5405
5406 * [32-bit MSVC builds finally implement unwinding][1.8ms].
5407   i686-pc-windows-msvc is now considered a tier-1 platform.
5408 * [The `--print targets` flag prints a list of supported targets][1.8t].
5409 * [The `--print cfg` flag prints the `cfg`s defined for the current
5410   target][1.8cf].
5411 * [`rustc` can be built with an new Cargo-based build system, written
5412   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
5413   build system. To enable it configure with `configure --rustbuild`.
5414 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
5415   variants while also indicating the total number of missing variants
5416   if more than 3][1.8m].
5417 * [Executable stacks are disabled on Linux and BSD][1.8nx].
5418 * The Rust Project now publishes binary releases of the standard
5419   library for a number of tier-2 targets:
5420   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
5421   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
5422   `x86_64-rumprun-netbsd`. These can be installed with
5423   tools such as [multirust][1.8mr].
5424
5425 Cargo
5426 -----
5427
5428 * [`cargo init` creates a new Cargo project in the current
5429   directory][1.8ci].  It is otherwise like `cargo new`.
5430 * [Cargo has configuration keys for `-v` and
5431   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
5432   `[term]` section of `.cargo/config`.
5433 * [Configuration keys that evaluate to strings or integers can be set
5434   via environment variables][1.8ce]. For example the `build.jobs` key
5435   can be set via `CARGO_BUILD_JOBS`. Environment variables take
5436   precedence over config files.
5437 * [Target-specific dependencies support Rust `cfg` syntax for
5438   describing targets][1.8cfg] so that dependencies for multiple
5439   targets can be specified together. [RFC 1361].
5440 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
5441   `RUSTDOC` take precedence over the `build.target-dir`,
5442   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
5443 * [The child process tree is killed on Windows when Cargo is
5444   killed][1.8ck].
5445 * [The `build.target` configuration value sets the target platform,
5446   like `--target`][1.8ct].
5447
5448 Compatibility Notes
5449 -------------------
5450
5451 * [Unstable compiler flags have been further restricted][1.8u]. Since
5452   1.0 `-Z` flags have been considered unstable, and other flags that
5453   were considered unstable additionally required passing `-Z
5454   unstable-options` to access. Unlike unstable language and library
5455   features though, these options have been accessible on the stable
5456   release channel. Going forward, *new unstable flags will not be
5457   available on the stable release channel*, and old unstable flags
5458   will warn about their usage. In the future, all unstable flags will
5459   be unavailable on the stable release channel.
5460 * [It is no longer possible to `match` on empty enum variants using
5461   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
5462 * The Unix-specific `MetadataExt` traits, including
5463   `os::unix::fs::MetadataExt`, which expose values such as inode
5464   numbers [no longer return platform-specific types][1.8r], but
5465   instead return widened integers. [RFC 1415].
5466 * [Modules sourced from the filesystem cannot appear within arbitrary
5467   blocks, but only within other modules][1.8mf].
5468 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
5469 * On Unix, [stack overflow triggers a runtime abort instead of a
5470   SIGSEGV][1.8so].
5471 * [`Command::spawn` and its equivalents return an error if any of
5472   its command-line arguments contain interior `NUL`s][1.8n].
5473 * [Tuple and unit enum variants from other crates are in the type
5474   namespace][1.8tn].
5475 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
5476   type instead of `.a` files][1.8st]. Additionally, for the MSVC
5477   toolchain, `rustc` emits import libraries named `foo.dll.lib`
5478   instead of `foo.lib`.
5479
5480
5481 [1.8a]: https://github.com/rust-lang/rust/pull/30962
5482 [1.8b]: https://github.com/rust-lang/rust/pull/31123
5483 [1.8c]: https://github.com/rust-lang/rust/pull/31530
5484 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
5485 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
5486 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
5487 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
5488 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
5489 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
5490 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
5491 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
5492 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
5493 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
5494 [1.8h]: https://github.com/rust-lang/rust/pull/31460
5495 [1.8l]: https://github.com/rust-lang/rust/pull/31668
5496 [1.8m]: https://github.com/rust-lang/rust/pull/31020
5497 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
5498 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
5499 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
5500 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
5501 [1.8n]: https://github.com/rust-lang/rust/pull/31056
5502 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
5503 [1.8r]: https://github.com/rust-lang/rust/pull/31551
5504 [1.8so]: https://github.com/rust-lang/rust/pull/31333
5505 [1.8st]: https://github.com/rust-lang/rust/pull/29520
5506 [1.8t]: https://github.com/rust-lang/rust/pull/31358
5507 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
5508 [1.8u]: https://github.com/rust-lang/rust/pull/31793
5509 [1.8v]: https://github.com/rust-lang/rust/pull/31757
5510 [1.8w]: https://github.com/rust-lang/rust/pull/31904
5511 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
5512 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
5513 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
5514 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
5515 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
5516 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
5517 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
5518 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
5519 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
5520 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
5521 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
5522 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
5523 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
5524 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
5525 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
5526 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
5527 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
5528 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
5529 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
5530 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
5531 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
5532 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
5533 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
5534 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
5535 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
5536 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
5537 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
5538 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
5539 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
5540 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
5541
5542
5543 Version 1.7.0 (2016-03-03)
5544 ==========================
5545
5546 Libraries
5547 ---------
5548
5549 * Stabilized APIs
5550   * `Path`
5551     * [`Path::strip_prefix`] (renamed from relative_from)
5552     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
5553   * `Ipv4Addr`
5554     * [`Ipv4Addr::is_loopback`]
5555     * [`Ipv4Addr::is_private`]
5556     * [`Ipv4Addr::is_link_local`]
5557     * [`Ipv4Addr::is_multicast`]
5558     * [`Ipv4Addr::is_broadcast`]
5559     * [`Ipv4Addr::is_documentation`]
5560   * `Ipv6Addr`
5561     * [`Ipv6Addr::is_unspecified`]
5562     * [`Ipv6Addr::is_loopback`]
5563     * [`Ipv6Addr::is_multicast`]
5564   * `Vec`
5565     * [`Vec::as_slice`]
5566     * [`Vec::as_mut_slice`]
5567   * `String`
5568     * [`String::as_str`]
5569     * [`String::as_mut_str`]
5570   * Slices
5571     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
5572     be the same length
5573     * `<[T]>::`[`sort_by_key`]
5574   * checked, saturated, and overflowing operations
5575     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
5576     * [`i32::saturating_mul`]
5577     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
5578     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
5579     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
5580     * [`u32::saturating_mul`]
5581     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
5582     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
5583     * and checked, saturated, and overflowing operations for other primitive types
5584   * FFI
5585     * [`ffi::IntoStringError`]
5586     * [`CString::into_string`]
5587     * [`CString::into_bytes`]
5588     * [`CString::into_bytes_with_nul`]
5589     * `From<CString> for Vec<u8>`
5590   * `IntoStringError`
5591     * [`IntoStringError::into_cstring`]
5592     * [`IntoStringError::utf8_error`]
5593     * `Error for IntoStringError`
5594   * Hashing
5595     * [`std::hash::BuildHasher`]
5596     * [`BuildHasher::Hasher`]
5597     * [`BuildHasher::build_hasher`]
5598     * [`std::hash::BuildHasherDefault`]
5599     * [`HashMap::with_hasher`]
5600     * [`HashMap::with_capacity_and_hasher`]
5601     * [`HashSet::with_hasher`]
5602     * [`HashSet::with_capacity_and_hasher`]
5603     * [`std::collections::hash_map::RandomState`]
5604     * [`RandomState::new`]
5605 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
5606   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
5607   from bytes is faster.
5608 * [The performance of `LineWriter` (and thus `io::stdout`) was
5609   improved by using `memchr` to search for newlines][1.7m].
5610 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
5611   `f64` variants were stabilized previously.
5612 * [`BTreeMap` was rewritten to use less memory and improve the performance
5613   of insertion and iteration, the latter by as much as 5x][1.7bm].
5614 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
5615   covariant over their contained type][1.7bt].
5616 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
5617   over their contained type][1.7ll].
5618 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
5619   searching methods.
5620 * [`Any` is implemented for unsized types][1.7a].
5621 * [`Hash` is implemented for `Duration`][1.7h].
5622
5623 Misc
5624 ----
5625
5626 * [When running tests with `--test`, rustdoc will pass `--cfg`
5627   arguments to the compiler][1.7dt].
5628 * [The compiler is built with RPATH information by default][1.7rpa].
5629   This means that it will be possible to run `rustc` when installed in
5630   unusual configurations without configuring the dynamic linker search
5631   path explicitly.
5632 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
5633   any RPATH entries (emitted with `-C rpath`) *not* take precedence
5634   over `LD_LIBRARY_PATH`.
5635
5636 Cargo
5637 -----
5638
5639 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
5640   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
5641 * [The `rerun-if-changed` build script directive no longer causes the
5642   build script to incorrectly run twice in certain scenarios][1.7rr].
5643
5644 Compatibility Notes
5645 -------------------
5646
5647 * Soundness fixes to the interactions between associated types and
5648   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
5649   code that violates the new rules. This is a significant change that
5650   is known to break existing code, so it has emitted warnings for the
5651   new error cases since 1.4 to give crate authors time to adapt. The
5652   details of what is changing are subtle; read the RFC for more.
5653 * [Several bugs in the compiler's visibility calculations were
5654   fixed][1.7v]. Since this was found to break significant amounts of
5655   code, the new errors will be emitted as warnings for several release
5656   cycles, under the `private_in_public` lint.
5657 * Defaulted type parameters were accidentally accepted in positions
5658   that were not intended. In this release, [defaulted type parameters
5659   appearing outside of type definitions will generate a
5660   warning][1.7d], which will become an error in future releases.
5661 * [Parsing "." as a float results in an error instead of 0][1.7p].
5662   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
5663 * [Borrows of closure parameters may not outlive the closure][1.7bc].
5664
5665 [1.7a]: https://github.com/rust-lang/rust/pull/30928
5666 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
5667 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
5668 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
5669 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
5670 [1.7d]: https://github.com/rust-lang/rust/pull/30724
5671 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
5672 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
5673 [1.7f]: https://github.com/rust-lang/rust/pull/30672
5674 [1.7h]: https://github.com/rust-lang/rust/pull/30818
5675 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
5676 [1.7m]: https://github.com/rust-lang/rust/pull/30381
5677 [1.7p]: https://github.com/rust-lang/rust/pull/30681
5678 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
5679 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
5680 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
5681 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
5682 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
5683 [1.7v]: https://github.com/rust-lang/rust/pull/29973
5684 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5685 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5686 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
5687 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
5688 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
5689 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
5690 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
5691 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
5692 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
5693 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
5694 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
5695 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
5696 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
5697 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
5698 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
5699 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
5700 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
5701 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
5702 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
5703 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
5704 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
5705 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
5706 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
5707 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
5708 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
5709 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
5710 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
5711 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
5712 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
5713 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
5714 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
5715 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
5716 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
5717 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
5718 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
5719 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
5720 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
5721 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
5722 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
5723 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
5724 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
5725 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
5726 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
5727 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
5728 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
5729 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
5730 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
5731 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5732 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
5733 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5734 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
5735 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
5736 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
5737 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
5738 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
5739 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
5740 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
5741 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
5742 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
5743 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
5744
5745
5746 Version 1.6.0 (2016-01-21)
5747 ==========================
5748
5749 Language
5750 --------
5751
5752 * The `#![no_std]` attribute causes a crate to not be linked to the
5753   standard library, but only the [core library][1.6co], as described
5754   in [RFC 1184]. The core library defines common types and traits but
5755   has no platform dependencies whatsoever, and is the basis for Rust
5756   software in environments that cannot support a full port of the
5757   standard library, such as operating systems. Most of the core
5758   library is now stable.
5759
5760 Libraries
5761 ---------
5762
5763 * Stabilized APIs:
5764   [`Read::read_exact`],
5765   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
5766   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
5767   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
5768   [`os::unix::fs::DirBuilderExt`],
5769   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
5770   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
5771   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
5772   [`collections::hash_map::Drain`],
5773   [`collections::hash_map::HashMap::drain`],
5774   [`collections::hash_set::Drain`],
5775   [`collections::hash_set::HashSet::drain`],
5776   [`collections::binary_heap::Drain`],
5777   [`collections::binary_heap::BinaryHeap::drain`],
5778   [`Vec::extend_from_slice`] (renamed from `push_all`),
5779   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
5780   [`RwLock::into_inner`],
5781   [`Iterator::min_by_key`] (renamed from `min_by`),
5782   [`Iterator::max_by_key`] (renamed from `max_by`).
5783 * The [core library][1.6co] is stable, as are most of its APIs.
5784 * [The `assert_eq!` macro supports arguments that don't implement
5785   `Sized`][1.6ae], such as arrays. In this way it behaves more like
5786   `assert!`.
5787 * Several timer functions that take duration in milliseconds [are
5788   deprecated in favor of those that take `Duration`][1.6ms]. These
5789   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
5790   `thread::park_timeout_ms`.
5791 * The algorithm by which `Vec` reserves additional elements was
5792   [tweaked to not allocate excessive space][1.6a] while still growing
5793   exponentially.
5794 * `From` conversions are [implemented from integers to floats][1.6f]
5795   in cases where the conversion is lossless. Thus they are not
5796   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
5797   or `f64`. They are also not implemented for `isize` and `usize`
5798   because the implementations would be platform-specific. `From` is
5799   also implemented from `f32` to `f64`.
5800 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
5801 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
5802 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
5803 * [`BinaryHeap` was refactored][1.6bh] for modest performance
5804   improvements.
5805 * Sorting slices that are already sorted [is 50% faster in some
5806   cases][1.6s].
5807
5808 Cargo
5809 -----
5810
5811 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
5812 * Cargo build scripts can specify their dependencies by emitting the
5813   [`rerun-if-changed`][1.6rr] key.
5814 * crates.io will reject publication of crates with dependencies that
5815   have a wildcard version constraint. Crates with wildcard
5816   dependencies were seen to cause a variety of problems, as described
5817   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
5818   warning.
5819 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
5820   release folder.  A variety of artifacts that Cargo failed to clean
5821   are now correctly deleted.
5822
5823 Misc
5824 ----
5825
5826 * The `unreachable_code` lint [warns when a function call's argument
5827   diverges][1.6dv].
5828 * The parser indicates [failures that may be caused by
5829   confusingly-similar Unicode characters][1.6uc]
5830 * Certain macro errors [are reported at definition time][1.6m], not
5831   expansion.
5832
5833 Compatibility Notes
5834 -------------------
5835
5836 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
5837   environment variable when locating crates. This was a pre-cargo
5838   feature for integrating with the package manager that was
5839   accidentally never removed.
5840 * [A number of bugs were fixed in the privacy checker][1.6p] that
5841   could cause previously-accepted code to break.
5842 * [Modules and unit/tuple structs may not share the same name][1.6ts].
5843 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
5844   struct pattern syntax (`Foo(..)`) can no longer be used to match
5845   unit structs. This is a warning now, but will become an error in
5846   future releases. Patterns that share the same name as a const are
5847   now an error.
5848 * A bug was fixed that causes [rustc not to apply default type
5849   parameters][1.6xc] when resolving certain method implementations of
5850   traits defined in other crates.
5851
5852 [1.6a]: https://github.com/rust-lang/rust/pull/29454
5853 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
5854 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
5855 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
5856 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
5857 [1.6co]: http://doc.rust-lang.org/core/index.html
5858 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
5859 [1.6f]: https://github.com/rust-lang/rust/pull/29129
5860 [1.6m]: https://github.com/rust-lang/rust/pull/29828
5861 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
5862 [1.6p]: https://github.com/rust-lang/rust/pull/29726
5863 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
5864 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
5865 [1.6s]: https://github.com/rust-lang/rust/pull/29675
5866 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
5867 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
5868 [1.6us]: https://github.com/rust-lang/rust/pull/29383
5869 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
5870 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
5871 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
5872 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
5873 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
5874 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
5875 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
5876 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
5877 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
5878 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
5879 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
5880 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
5881 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
5882 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
5883 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
5884 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
5885 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
5886 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
5887 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
5888 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
5889 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
5890 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
5891 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
5892 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
5893 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
5894 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
5895 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
5896 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
5897 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
5898 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
5899
5900
5901 Version 1.5.0 (2015-12-10)
5902 ==========================
5903
5904 * ~700 changes, numerous bugfixes
5905
5906 Highlights
5907 ----------
5908
5909 * Stabilized APIs:
5910   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
5911   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
5912   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
5913   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
5914   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
5915   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
5916   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
5917   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
5918   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
5919   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
5920   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
5921   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
5922   [`Path::read_link`], [`Path::symlink_metadata`],
5923   [`Utf8Error::valid_up_to`], [`Vec::resize`],
5924   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
5925   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
5926   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
5927   [`slice::split_first_mut`], [`slice::split_first`],
5928   [`slice::split_last_mut`], [`slice::split_last`],
5929   [`char::from_u32_unchecked`], [`fs::canonicalize`],
5930   [`str::MatchIndices`], [`str::RMatchIndices`],
5931   [`str::match_indices`], [`str::rmatch_indices`],
5932   [`str::slice_mut_unchecked`], [`string::ParseError`].
5933 * Rust applications hosted on crates.io can be installed locally to
5934   `~/.cargo/bin` with the [`cargo install`] command. Among other
5935   things this makes it easier to augment Cargo with new subcommands:
5936   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
5937   invoked as `cargo foo`.
5938 * Crates with wildcard (`*`) dependencies will [emit warnings when
5939   published][1.5w]. In 1.6 it will no longer be possible to publish
5940   crates with wildcard dependencies.
5941
5942 Breaking Changes
5943 ----------------
5944
5945 * The rules determining when a particular lifetime must outlive
5946   a particular value (known as '[dropck]') have been [modified
5947   to not rely on parametricity][1.5p].
5948 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
5949   and `Arc`][1.5a]. Because these smart pointer types implement
5950   `Deref`, this causes breakage in cases where the interior type
5951   contains methods of the same name.
5952 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
5953   that they could drop their content. Soundness fix.
5954 * All method invocations are [properly checked][1.5wf1] for
5955   [well-formedness][1.5wf2]. Soundness fix.
5956 * Traits whose supertraits contain `Self` are [not object
5957   safe][1.5o]. Soundness fix.
5958 * Target specifications support a [`no_default_libraries`][1.5nd]
5959   setting that controls whether `-nodefaultlibs` is passed to the
5960   linker, and in turn the `is_like_windows` setting no longer affects
5961   the `-nodefaultlibs` flag.
5962 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
5963 * The `#[inline]` and `#[repr]` attributes [can only appear
5964   in valid locations][1.5at].
5965 * Native libraries linked from the local crate are [passed to
5966   the linker before native libraries from upstream crates][1.5nl].
5967 * Two rarely-used attributes, `#[no_debug]` and
5968   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
5969 * Negation of unsigned integers, which has been a warning for
5970   several releases, [is now behind a feature gate and will
5971   generate errors][1.5nu].
5972 * The parser accidentally accepted visibility modifiers on
5973   enum variants, a bug [which has been fixed][1.5ev].
5974 * [A bug was fixed that allowed `use` statements to import unstable
5975   features][1.5use].
5976
5977 Language
5978 --------
5979
5980 * When evaluating expressions at compile-time that are not
5981   compile-time constants (const-evaluating expressions in non-const
5982   contexts), incorrect code such as overlong bitshifts and arithmetic
5983   overflow will [generate a warning instead of an error][1.5ce],
5984   delaying the error until runtime. This will allow the
5985   const-evaluator to be expanded in the future backwards-compatibly.
5986 * The `improper_ctypes` lint [no longer warns about using `isize` and
5987   `usize` in FFI][1.5ict].
5988
5989 Libraries
5990 ---------
5991
5992 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
5993   invariant][1.5c].
5994 * `Default` is [implemented for mutable slices][1.5d].
5995 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
5996 * There are now `From` conversions [between floating point
5997   types][1.5f] where the conversions are lossless.
5998 * There are now `From` conversions [between integer types][1.5i] where
5999   the conversions are lossless.
6000 * [`fs::Metadata` implements `Clone`][1.5fs].
6001 * The `parse` method [accepts a leading "+" when parsing
6002   integers][1.5pi].
6003 * [`AsMut` is implemented for `Vec`][1.5am].
6004 * The `clone_from` implementations for `String` and `BinaryHeap` [have
6005   been optimized][1.5cf] and no longer rely on the default impl.
6006 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
6007   `unsafe extern "C"` function types now [implement `Clone`,
6008   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
6009   `fmt::Debug` for up to 12 arguments][1.5fp].
6010 * [Dropping `Vec`s is much faster in unoptimized builds when the
6011   element types don't implement `Drop`][1.5dv].
6012 * A bug that caused in incorrect behavior when [combining `VecDeque`
6013   with zero-sized types][1.5vdz] was resolved.
6014 * [`PartialOrd` for slices is faster][1.5po].
6015
6016 Miscellaneous
6017 -------------
6018
6019 * [Crate metadata size was reduced by 20%][1.5md].
6020 * [Improvements to code generation reduced the size of libcore by 3.3
6021   MB and rustc's memory usage by 18MB][1.5m].
6022 * [Improvements to deref translation increased performance in
6023   unoptimized builds][1.5dr].
6024 * Various errors in trait resolution [are deduplicated to only be
6025   reported once][1.5te].
6026 * Rust has preliminary [support for rumprun kernels][1.5rr].
6027 * Rust has preliminary [support for NetBSD on amd64][1.5na].
6028
6029 [1.5use]: https://github.com/rust-lang/rust/pull/28364
6030 [1.5po]: https://github.com/rust-lang/rust/pull/28436
6031 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
6032 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
6033 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
6034 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
6035 [1.5md]: https://github.com/rust-lang/rust/pull/28521
6036 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
6037 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
6038 [1.5na]: https://github.com/rust-lang/rust/pull/28543
6039 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
6040 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
6041 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
6042 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
6043 [1.5te]: https://github.com/rust-lang/rust/pull/28645
6044 [1.5at]: https://github.com/rust-lang/rust/pull/28650
6045 [1.5am]: https://github.com/rust-lang/rust/pull/28663
6046 [1.5m]: https://github.com/rust-lang/rust/pull/28778
6047 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
6048 [1.5a]: https://github.com/rust-lang/rust/pull/28811
6049 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
6050 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
6051 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
6052 [1.5i]: https://github.com/rust-lang/rust/pull/28921
6053 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
6054 [1.5f]: https://github.com/rust-lang/rust/pull/29129
6055 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
6056 [1.5s]: https://github.com/rust-lang/rust/pull/29190
6057 [1.5d]: https://github.com/rust-lang/rust/pull/29245
6058 [1.5o]: https://github.com/rust-lang/rust/pull/29259
6059 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
6060 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6061 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
6062 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
6063 [1.5c]: https://github.com/rust-lang/rust/pull/29110
6064 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6065 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
6066 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
6067 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
6068 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
6069 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
6070 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
6071 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
6072 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
6073 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
6074 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
6075 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
6076 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
6077 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
6078 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
6079 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
6080 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
6081 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
6082 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
6083 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
6084 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
6085 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
6086 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
6087 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
6088 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
6089 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
6090 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
6091 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
6092 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
6093 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
6094 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
6095 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
6096 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
6097 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
6098 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
6099 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
6100 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
6101 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
6102 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
6103 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
6104 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
6105 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
6106 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
6107 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
6108 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
6109 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
6110 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
6111 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
6112 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
6113 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
6114 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
6115 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
6116 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
6117 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
6118
6119 Version 1.4.0 (2015-10-29)
6120 ==========================
6121
6122 * ~1200 changes, numerous bugfixes
6123
6124 Highlights
6125 ----------
6126
6127 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
6128   GNU) are now supported and recommended for use.
6129
6130 Breaking Changes
6131 ----------------
6132
6133 * [Several changes have been made to fix type soundness and improve
6134   the behavior of associated types][sound]. See [RFC 1214]. Although
6135   we have mostly introduced these changes as warnings this release, to
6136   become errors next release, there are still some scenarios that will
6137   see immediate breakage.
6138 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
6139   line breaks in addition to `\n`][crlf].
6140 * [Loans of `'static` lifetime extend to the end of a function][stat].
6141 * [`str::parse` no longer introduces avoidable rounding error when
6142   parsing floating point numbers. Together with earlier changes to
6143   float formatting/output, "round trips" like f.to_string().parse()
6144   now preserve the value of f exactly. Additionally, leading plus
6145   signs are now accepted][fp3].
6146
6147
6148 Language
6149 --------
6150
6151 * `use` statements that import multiple items [can now rename
6152   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
6153 * [Binops work correctly on fat pointers][binfat].
6154 * `pub extern crate`, which does not behave as expected, [issues a
6155   warning][pec] until a better solution is found.
6156
6157 Libraries
6158 ---------
6159
6160 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
6161   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
6162   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
6163   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
6164   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
6165   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
6166   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
6167   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
6168   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
6169   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
6170   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
6171   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
6172   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
6173   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
6174   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
6175   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
6176   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
6177   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
6178   [`thread::sleep`].
6179 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
6180   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
6181   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
6182   `f64::from_str_radix`.
6183 * [Reverse-searching strings is faster with the 'two-way'
6184   algorithm][s].
6185 * [`std::io::copy` allows `?Sized` arguments][cc].
6186 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
6187   [override `count`, `nth` and `last` with an O(1)
6188   implementation][it].
6189 * [`Default` is implemented for arrays up to `[T; 32]`][d].
6190 * [`IntoRawFd` has been added to the Unix-specific prelude,
6191   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
6192   prelude][pr].
6193 * [`Extend<String>` and `FromIterator<String` are both implemented for
6194   `String`][es].
6195 * [`IntoIterator` is implemented for references to `Option` and
6196   `Result`][into2].
6197 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
6198   Copy`][ext] as part of [RFC 839]. This will cause type inference
6199   breakage in rare situations.
6200 * [`BinaryHeap` implements `Debug`][bh2].
6201 * [`Borrow` and `BorrowMut` are implemented for fixed-size
6202   arrays][bm].
6203 * [`extern fn`s with the "Rust" and "C" ABIs implement common
6204   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
6205 * [String comparison is faster][faststr].
6206 * `&mut T` where `T: std::fmt::Write` [also implements
6207   `std::fmt::Write`][mutw].
6208 * [A stable regression in `VecDeque::push_back` and other
6209   capacity-altering methods that caused panics for zero-sized types
6210   was fixed][vd].
6211 * [Function pointers implement traits for up to 12 parameters][fp2].
6212
6213 Miscellaneous
6214 -------------
6215
6216 * The compiler [no longer uses the 'morestack' feature to prevent
6217   stack overflow][mm]. Instead it uses guard pages and stack
6218   probes (though stack probes are not yet implemented on any platform
6219   but Windows).
6220 * [The compiler matches traits faster when projections are involved][p].
6221 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
6222   `usize`][ffi].
6223 * [Cargo now displays useful information about what its doing during
6224   `cargo update`][cu].
6225
6226 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
6227 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
6228 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
6229 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
6230 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
6231 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
6232 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
6233 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
6234 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
6235 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
6236 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
6237 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
6238 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
6239 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
6240 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
6241 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
6242 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
6243 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
6244 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6245 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6246 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6247 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6248 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6249 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6250 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6251 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6252 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
6253 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
6254 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
6255 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
6256 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
6257 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
6258 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
6259 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
6260 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
6261 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
6262 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
6263 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
6264 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
6265 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
6266 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
6267 [bh2]: https://github.com/rust-lang/rust/pull/28156
6268 [binfat]: https://github.com/rust-lang/rust/pull/28270
6269 [bm]: https://github.com/rust-lang/rust/pull/28197
6270 [cc]: https://github.com/rust-lang/rust/pull/27531
6271 [crlf]: https://github.com/rust-lang/rust/pull/28034
6272 [cu]: https://github.com/rust-lang/cargo/pull/1931
6273 [d]: https://github.com/rust-lang/rust/pull/27825
6274 [dep]: https://github.com/rust-lang/rust/pull/28339
6275 [es]: https://github.com/rust-lang/rust/pull/27956
6276 [ext]: https://github.com/rust-lang/rust/pull/28094
6277 [faststr]: https://github.com/rust-lang/rust/pull/28338
6278 [ffi]: https://github.com/rust-lang/rust/pull/28779
6279 [fp]: https://github.com/rust-lang/rust/pull/28268
6280 [fp2]: https://github.com/rust-lang/rust/pull/28560
6281 [fp3]: https://github.com/rust-lang/rust/pull/27307
6282 [i]: https://github.com/rust-lang/rust/pull/27451
6283 [into2]: https://github.com/rust-lang/rust/pull/28039
6284 [it]: https://github.com/rust-lang/rust/pull/27652
6285 [mm]: https://github.com/rust-lang/rust/pull/27338
6286 [mutw]: https://github.com/rust-lang/rust/pull/28368
6287 [sound]: https://github.com/rust-lang/rust/pull/27641
6288 [p]: https://github.com/rust-lang/rust/pull/27866
6289 [pec]: https://github.com/rust-lang/rust/pull/28486
6290 [pr]: https://github.com/rust-lang/rust/pull/27896
6291 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6292 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6293 [s]: https://github.com/rust-lang/rust/pull/27474
6294 [stab]: https://github.com/rust-lang/rust/pull/28339
6295 [stat]: https://github.com/rust-lang/rust/pull/28321
6296 [vd]: https://github.com/rust-lang/rust/pull/28494
6297
6298 Version 1.3.0 (2015-09-17)
6299 ==============================
6300
6301 * ~900 changes, numerous bugfixes
6302
6303 Highlights
6304 ----------
6305
6306 * The [new object lifetime defaults][nold] have been [turned
6307   on][nold2] after a cycle of warnings about the change. Now types
6308   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
6309   being interpreted as `&'a Box<Trait+'a>` to `&'a
6310   Box<Trait+'static>`.
6311 * [The Rustonomicon][nom] is a new book in the official documentation
6312   that dives into writing unsafe Rust.
6313 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
6314   timekeeping is employed by other std APIs, as well as out-of-tree
6315   time crates.
6316
6317 Breaking Changes
6318 ----------------
6319
6320 * The [new object lifetime defaults][nold] have been [turned
6321   on][nold2] after a cycle of warnings about the change.
6322 * There is a known [regression][lr] in how object lifetime elision is
6323   interpreted, the proper solution for which is undetermined.
6324 * The `#[prelude_import]` attribute, an internal implementation
6325   detail, was accidentally stabilized previously. [It has been put
6326   behind the `prelude_import` feature gate][pi]. This change is
6327   believed to break no existing code.
6328 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6329   [more sane for dynamically sized types][dst3]. Code that relied on
6330   the previous behavior is thought to be broken.
6331 * The `dropck` rules, which checks that destructors can't access
6332   destroyed values, [have been updated][dropck] to match the
6333   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
6334   cause some previously-compiling code to no longer build.
6335
6336 Language
6337 --------
6338
6339 * The [new object lifetime defaults][nold] have been [turned
6340   on][nold2] after a cycle of warnings about the change.
6341 * Semicolons may [now follow types and paths in
6342   macros](https://github.com/rust-lang/rust/pull/27000).
6343 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6344   [more sane for dynamically sized types][dst3]. Code that relied on
6345   the previous behavior is not known to exist, and suspected to be
6346   broken.
6347 * `'static` variables [may now be recursive][st].
6348 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
6349   implementations correctly.
6350 * The `dropck` rules, which checks that destructors can't access
6351   destroyed values, [have been updated][dropck] to match the
6352   [RFC][dropckrfc].
6353
6354 Libraries
6355 ---------
6356
6357 * The [`Duration`] API, [has been stabilized][ds], as well as the
6358   `std::time` module, which presently contains only `Duration`.
6359 * `Box<str>` and `Box<[T]>` both implement `Clone`.
6360 * The owned C string, [`CString`], implements [`Borrow`] and the
6361   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
6362   these allow C strings to be borrowed and cloned in generic code.
6363 * [`CStr`] implements [`Debug`].
6364 * [`AtomicPtr`] implements [`Debug`].
6365 * [`Error`] trait objects [can be downcast to their concrete types][e]
6366   in many common configurations, using the [`is`], [`downcast`],
6367   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
6368   [`Any`] trait.
6369 * Searching for substrings now [employs the two-way algorithm][search]
6370   instead of doing a naive search. This gives major speedups to a
6371   number of methods, including [`contains`][sc], [`find`][sf],
6372   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
6373   [`ends_with`][sew] are also faster.
6374 * The performance of `PartialEq` for slices is [much faster][ps].
6375 * The [`Hash`] trait offers the default method, [`hash_slice`], which
6376   is overridden and optimized by the implementations for scalars.
6377 * The [`Hasher`] trait now has a number of specialized `write_*`
6378   methods for primitive types, for efficiency.
6379 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
6380   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
6381   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
6382   of [`std::error::Error::cause`][iec] also delegates to the inner
6383   error.
6384 * [`process::Child`][pc] gained the [`id`] method, which returns a
6385   `u32` representing the platform-specific process identifier.
6386 * The [`connect`] method on slices is deprecated, replaced by the new
6387   [`join`] method (note that both of these are on the *unstable*
6388   [`SliceConcatExt`] trait, but through the magic of the prelude are
6389   available to stable code anyway).
6390 * The [`Div`] operator is implemented for [`Wrapping`] types.
6391 * [`DerefMut` is implemented for `String`][dms].
6392 * Performance of SipHash (the default hasher for `HashMap`) is
6393   [better for long data][sh].
6394 * [`AtomicPtr`] implements [`Send`].
6395 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
6396   are now [specialized to use uninitialized buffers for increased
6397   performance][rte].
6398 * Lifetime parameters of foreign functions [are now resolved
6399   properly][f].
6400
6401 Misc
6402 ----
6403
6404 * Rust can now, with some coercion, [produce programs that run on
6405   Windows XP][xp], though XP is not considered a supported platform.
6406 * Porting Rust on Windows from the GNU toolchain to MSVC continues
6407   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
6408   recommended for use in 1.3, though should be fully-functional
6409   in the [64-bit 1.4 beta][b14].
6410 * On Fedora-based systems installation will [properly configure the
6411   dynamic linker][fl].
6412 * The compiler gained many new extended error descriptions, which can
6413   be accessed with the `--explain` flag.
6414 * The `dropck` pass, which checks that destructors can't access
6415   destroyed values, [has been rewritten][dropck]. This fixes some
6416   soundness holes, and as such will cause some previously-compiling
6417   code to no longer build.
6418 * `rustc` now uses [LLVM to write archive files where possible][ar].
6419   Eventually this will eliminate the compiler's dependency on the ar
6420   utility.
6421 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
6422   supported FreeBSD on x86_64).
6423 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
6424   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
6425   more strict.
6426 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
6427   will kill the process instead of leaking][nlp].
6428
6429 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
6430 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
6431 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
6432 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
6433 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
6434 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6435 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6436 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
6437 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
6438 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
6439 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
6440 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
6441 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
6442 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6443 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
6444 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
6445 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
6446 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
6447 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6448 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
6449 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
6450 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
6451 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
6452 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6453 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
6454 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
6455 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
6456 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
6457 [ar]: https://github.com/rust-lang/rust/pull/26926
6458 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
6459 [dms]: https://github.com/rust-lang/rust/pull/26241
6460 [dropck]: https://github.com/rust-lang/rust/pull/27261
6461 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6462 [ds]: https://github.com/rust-lang/rust/pull/26818
6463 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
6464 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
6465 [dst3]: https://github.com/rust-lang/rust/pull/27351
6466 [e]: https://github.com/rust-lang/rust/pull/24793
6467 [f]: https://github.com/rust-lang/rust/pull/26588
6468 [fb]: https://github.com/rust-lang/rust/pull/26959
6469 [fl]: https://github.com/rust-lang/rust-installer/pull/41
6470 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6471 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
6472 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
6473 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
6474 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
6475 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
6476 [lic]: https://github.com/rust-lang/rust/pull/26583
6477 [lnu]: https://github.com/rust-lang/rust/pull/27026
6478 [lr]: https://github.com/rust-lang/rust/issues/27248
6479 [lum]: https://github.com/rust-lang/rust/pull/26378
6480 [lur]: https://github.com/rust-lang/rust/pull/26783
6481 [nlp]: https://github.com/rust-lang/rust/pull/27176
6482 [nold2]: https://github.com/rust-lang/rust/pull/27045
6483 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
6484 [nom]: http://doc.rust-lang.org/nightly/nomicon/
6485 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
6486 [pi]: https://github.com/rust-lang/rust/pull/26699
6487 [ps]: https://github.com/rust-lang/rust/pull/26884
6488 [rte]: https://github.com/rust-lang/rust/pull/26950
6489 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
6490 [search]: https://github.com/rust-lang/rust/pull/26327
6491 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
6492 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
6493 [sh]: https://github.com/rust-lang/rust/pull/27280
6494 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
6495 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
6496 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
6497 [st]: https://github.com/rust-lang/rust/pull/26630
6498 [win1]: https://github.com/rust-lang/rust/pull/26569
6499 [win2]: https://github.com/rust-lang/rust/pull/26741
6500 [win3]: https://github.com/rust-lang/rust/pull/26741
6501 [win4]: https://github.com/rust-lang/rust/pull/27210
6502 [xp]: https://github.com/rust-lang/rust/pull/26569
6503
6504 Version 1.2.0 (2015-08-07)
6505 ==========================
6506
6507 * ~1200 changes, numerous bugfixes
6508
6509 Highlights
6510 ----------
6511
6512 * [Dynamically-sized-type coercions][dst] allow smart pointer types
6513   like `Rc` to contain types without a fixed size, arrays and trait
6514   objects, finally enabling use of `Rc<[T]>` and completing the
6515   implementation of DST.
6516 * [Parallel codegen][parcodegen] is now working again, which can
6517   substantially speed up large builds in debug mode; It also gets
6518   another ~33% speedup when bootstrapping on a 4 core machine (using 8
6519   jobs). It's not enabled by default, but will be "in the near
6520   future". It can be activated with the `-C codegen-units=N` flag to
6521   `rustc`.
6522 * This is the first release with [experimental support for linking
6523   with the MSVC linker and lib C on Windows (instead of using the GNU
6524   variants via MinGW)][win]. It is yet recommended only for the most
6525   intrepid Rustaceans.
6526 * Benchmark compilations are showing a 30% improvement in
6527   bootstrapping over 1.1.
6528
6529 Breaking Changes
6530 ----------------
6531
6532 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
6533   unicode case mapping, which is a previously-planned change in
6534   behavior and considered a bugfix.
6535 * [`mem::align_of`] now specifies [the *minimum alignment* for
6536   T][align], which is usually the alignment programs are interested
6537   in, and the same value reported by clang's
6538   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
6539   break real code.
6540 * [The `#[packed]` attribute is no longer silently accepted by the
6541   compiler][packed]. This attribute did nothing and code that
6542   mentioned it likely did not work as intended.
6543 * Associated type defaults are [now behind the
6544   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
6545   defaults *did not work*, but could be mentioned syntactically. As
6546   such this breakage has minimal impact.
6547
6548 Language
6549 --------
6550
6551 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
6552   matching against dereferenceable values.
6553
6554 Libraries
6555 ---------
6556
6557 * The [`Extend`] trait, which grows a collection from an iterator, is
6558   implemented over iterators of references, for `String`, `Vec`,
6559   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
6560   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
6561 * The [`iter::once`] function returns an iterator that yields a single
6562   element, and [`iter::empty`] returns an iterator that yields no
6563   elements.
6564 * The [`matches`] and [`rmatches`] methods on `str` return iterators
6565   over substring matches.
6566 * [`Cell`] and [`RefCell`] both implement `Eq`.
6567 * A number of methods for wrapping arithmetic are added to the
6568   integral types, [`wrapping_div`], [`wrapping_rem`],
6569   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
6570   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
6571   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
6572   type.. It is illegal for the default arithmetic operations in Rust
6573   to overflow; the desire to wrap must be explicit.
6574 * The `{:#?}` formatting specifier [displays the alternate,
6575   pretty-printed][debugfmt] form of the `Debug` formatter. This
6576   feature was actually introduced prior to 1.0 with little
6577   fanfare.
6578 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
6579   for writing data to formatted strings, similar to [`io::Write`].
6580 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
6581   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
6582   are used by code generators to emit implementations of [`Debug`].
6583 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
6584   methods that convert case, following Unicode case mapping.
6585 * It is now easier to handle poisoned locks. The [`PoisonError`]
6586   type, returned by failing lock operations, exposes `into_inner`,
6587   `get_ref`, and `get_mut`, which all give access to the inner lock
6588   guard, and allow the poisoned lock to continue to operate. The
6589   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
6590   poisoned lock without attempting to take the lock.
6591 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
6592   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
6593   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
6594   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
6595   `ChildStderr`.
6596 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
6597   malformed input.
6598
6599 Misc
6600 ----
6601
6602 * `rustc` employs smarter heuristics for guessing at [typos].
6603 * `rustc` emits more efficient code for [no-op conversions between
6604   unsafe pointers][nop].
6605 * Fat pointers are now [passed in pairs of immediate arguments][fat],
6606   resulting in faster compile times and smaller code.
6607
6608 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
6609 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6610 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
6611 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
6612 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
6613 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
6614 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
6615 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
6616 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
6617 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
6618 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
6619 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
6620 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
6621 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
6622 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
6623 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
6624 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6625 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
6626 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
6627 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
6628 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
6629 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
6630 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
6631 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
6632 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
6633 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6634 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
6635 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
6636 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
6637 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
6638 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
6639 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
6640 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
6641 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
6642 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
6643 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
6644 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
6645 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
6646 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
6647 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
6648 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
6649 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6650 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
6651 [align]: https://github.com/rust-lang/rust/pull/25646
6652 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
6653 [typos]: https://github.com/rust-lang/rust/pull/26087
6654 [nop]: https://github.com/rust-lang/rust/pull/26336
6655 [fat]: https://github.com/rust-lang/rust/pull/26411
6656 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
6657 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
6658 [packed]: https://github.com/rust-lang/rust/pull/25541
6659 [ad]: https://github.com/rust-lang/rust/pull/27382
6660 [win]: https://github.com/rust-lang/rust/pull/25350
6661
6662 Version 1.1.0 (2015-06-25)
6663 =========================
6664
6665 * ~850 changes, numerous bugfixes
6666
6667 Highlights
6668 ----------
6669
6670 * The [`std::fs` module has been expanded][fs] to expand the set of
6671   functionality exposed:
6672   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
6673     don't incur a syscall on some platforms.
6674   * A `symlink_metadata` function has been added.
6675   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
6676     access to all underlying information.
6677 * The compiler now contains extended explanations of many errors. When an error
6678   with an explanation occurs the compiler suggests using the `--explain` flag
6679   to read the explanation. Error explanations are also [available online][err-index].
6680 * Thanks to multiple [improvements][sk] to [type checking][pre], as
6681   well as other work, the time to bootstrap the compiler decreased by
6682   32%.
6683
6684 Libraries
6685 ---------
6686
6687 * The [`str::split_whitespace`] method splits a string on unicode
6688   whitespace boundaries.
6689 * On both Windows and Unix, new extension traits provide conversion of
6690   I/O types to and from the underlying system handles. On Unix, these
6691   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
6692   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
6693   `TcpListener`, and `UpdSocket`. Further implementations for
6694   `std::process` will be stabilized later.
6695 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
6696   Windows, symlinks can be created with
6697   `std::os::windows::symlink_dir` and
6698   `std::os::windows::symlink_file`.
6699 * The `mpsc::Receiver` type can now be converted into an iterator with
6700   `into_iter` on the [`IntoIterator`] trait.
6701 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
6702   implementation of the [`From`] trait.
6703 * The `Debug` implementation for `RangeFull` [creates output that is
6704   more consistent with other implementations][rf].
6705 * [`Debug` is implemented for `File`][file].
6706 * The `Default` implementation for `Arc` [no longer requires `Sync +
6707   Send`][arc].
6708 * [The `Iterator` methods `count`, `nth`, and `last` have been
6709   overridden for slices to have O(1) performance instead of O(n)][si].
6710 * Incorrect handling of paths on Windows has been improved in both the
6711   compiler and the standard library.
6712 * [`AtomicPtr` gained a `Default` implementation][ap].
6713 * In accordance with Rust's policy on arithmetic overflow `abs` now
6714   [panics on overflow when debug assertions are enabled][abs].
6715 * The [`Cloned`] iterator, which was accidentally left unstable for
6716   1.0 [has been stabilized][c].
6717 * The [`Incoming`] iterator, which iterates over incoming TCP
6718   connections, and which was accidentally unnamable in 1.0, [is now
6719   properly exported][inc].
6720 * [`BinaryHeap`] no longer corrupts itself [when functions called by
6721   `sift_up` or `sift_down` panic][bh].
6722 * The [`split_off`] method of `LinkedList` [no longer corrupts
6723   the list in certain scenarios][ll].
6724
6725 Misc
6726 ----
6727
6728 * Type checking performance [has improved notably][sk] with
6729   [multiple improvements][pre].
6730 * The compiler [suggests code changes][ch] for more errors.
6731 * rustc and it's build system have experimental support for [building
6732   toolchains against MUSL][m] instead of glibc on Linux.
6733 * The compiler defines the `target_env` cfg value, which is used for
6734   distinguishing toolchains that are otherwise for the same
6735   platform. Presently this is set to `gnu` for common GNU Linux
6736   targets and for MinGW targets, and `musl` for MUSL Linux targets.
6737 * The [`cargo rustc`][crc] command invokes a build with custom flags
6738   to rustc.
6739 * [Android executables are always position independent][pie].
6740 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
6741   with `Drop`][drop].
6742
6743 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
6744 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
6745 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
6746 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
6747 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
6748 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
6749 [rf]: https://github.com/rust-lang/rust/pull/24491
6750 [err-index]: https://doc.rust-lang.org/error-index.html
6751 [sk]: https://github.com/rust-lang/rust/pull/24615
6752 [pre]: https://github.com/rust-lang/rust/pull/25323
6753 [file]: https://github.com/rust-lang/rust/pull/24598
6754 [ch]: https://github.com/rust-lang/rust/pull/24683
6755 [arc]: https://github.com/rust-lang/rust/pull/24695
6756 [si]: https://github.com/rust-lang/rust/pull/24701
6757 [ap]: https://github.com/rust-lang/rust/pull/24834
6758 [m]: https://github.com/rust-lang/rust/pull/24777
6759 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
6760 [crc]: https://github.com/rust-lang/cargo/pull/1568
6761 [pie]: https://github.com/rust-lang/rust/pull/24953
6762 [abs]: https://github.com/rust-lang/rust/pull/25441
6763 [c]: https://github.com/rust-lang/rust/pull/25496
6764 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
6765 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
6766 [inc]: https://github.com/rust-lang/rust/pull/25522
6767 [bh]: https://github.com/rust-lang/rust/pull/25856
6768 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
6769 [ll]: https://github.com/rust-lang/rust/pull/26022
6770 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
6771 [drop]: https://github.com/rust-lang/rust/pull/24935
6772
6773 Version 1.0.0 (2015-05-15)
6774 ========================
6775
6776 * ~1500 changes, numerous bugfixes
6777
6778 Highlights
6779 ----------
6780
6781 * The vast majority of the standard library is now `#[stable]`. It is
6782   no longer possible to use unstable features with a stable build of
6783   the compiler.
6784 * Many popular crates on [crates.io] now work on the stable release
6785   channel.
6786 * Arithmetic on basic integer types now [checks for overflow in debug
6787   builds][overflow].
6788
6789 Language
6790 --------
6791
6792 * Several [restrictions have been added to trait coherence][coh] in
6793   order to make it easier for upstream authors to change traits
6794   without breaking downstream code.
6795 * Digits of binary and octal literals are [lexed more eagerly][lex] to
6796   improve error messages and macro behavior. For example, `0b1234` is
6797   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
6798 * Trait bounds [are always invariant][inv], eliminating the need for
6799   the `PhantomFn` and `MarkerTrait` lang items, which have been
6800   removed.
6801 * ["-" is no longer a valid character in crate names][cr], the `extern crate
6802   "foo" as bar` syntax has been replaced with `extern crate foo as
6803   bar`, and Cargo now automatically translates "-" in *package* names
6804   to underscore for the crate name.
6805 * [Lifetime shadowing is an error][lt].
6806 * [`Send` no longer implies `'static`][send-rfc].
6807 * [UFCS now supports trait-less associated paths][moar-ufcs] like
6808   `MyType::default()`.
6809 * Primitive types [now have inherent methods][prim-inherent],
6810   obviating the need for extension traits like `SliceExt`.
6811 * Methods with `Self: Sized` in their `where` clause are [considered
6812   object-safe][self-sized], allowing many extension traits like
6813   `IteratorExt` to be merged into the traits they extended.
6814 * You can now [refer to associated types][assoc-where] whose
6815   corresponding trait bounds appear only in a `where` clause.
6816 * The final bits of [OIBIT landed][oibit-final], meaning that traits
6817   like `Send` and `Sync` are now library-defined.
6818 * A [Reflect trait][reflect] was introduced, which means that
6819   downcasting via the `Any` trait is effectively limited to concrete
6820   types. This helps retain the potentially-important "parametricity"
6821   property: generic code cannot behave differently for different type
6822   arguments except in minor ways.
6823 * The `unsafe_destructor` feature is now deprecated in favor of the
6824   [new `dropck`][dropck]. This change is a major reduction in unsafe
6825   code.
6826
6827 Libraries
6828 ---------
6829
6830 * The `thread_local` module [has been renamed to `std::thread`][th].
6831 * The methods of `IteratorExt` [have been moved to the `Iterator`
6832   trait itself][ie].
6833 * Several traits that implement Rust's conventions for type
6834   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
6835   [centralized in the `std::convert` module][con].
6836 * The `FromError` trait [was removed in favor of `From`][fe].
6837 * The basic sleep function [has moved to
6838   `std::thread::sleep_ms`][slp].
6839 * The `splitn` function now takes an `n` parameter that represents the
6840   number of items yielded by the returned iterator [instead of the
6841   number of 'splits'][spl].
6842 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
6843 * [Derived implementations of `PartialOrd` now order enums according
6844   to their explicitly-assigned discriminants][po].
6845 * [Methods for searching strings are generic over `Pattern`s][pat],
6846   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
6847   some others.
6848 * [In method resolution, object methods are resolved before inherent
6849   methods][meth].
6850 * [`String::from_str` has been deprecated in favor of the `From` impl,
6851   `String::from`][sf].
6852 * [`io::Error` implements `Sync`][ios].
6853 * [The `words` method on `&str` has been replaced with
6854   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
6855   a word?'
6856 * The new path and IO modules are complete and `#[stable]`. This
6857   was the major library focus for this cycle.
6858 * The path API was [revised][path-normalize] to normalize `.`,
6859   adjusting the tradeoffs in favor of the most common usage.
6860 * A large number of remaining APIs in `std` were also stabilized
6861   during this cycle; about 75% of the non-deprecated API surface
6862   is now stable.
6863 * The new [string pattern API][string-pattern] landed, which makes
6864   the string slice API much more internally consistent and flexible.
6865 * A new set of [generic conversion traits][conversion] replaced
6866   many existing ad hoc traits.
6867 * Generic numeric traits were [completely removed][num-traits]. This
6868   was made possible thanks to inherent methods for primitive types,
6869   and the removal gives maximal flexibility for designing a numeric
6870   hierarchy in the future.
6871 * The `Fn` traits are now related via [inheritance][fn-inherit]
6872   and provide ergonomic [blanket implementations][fn-blanket].
6873 * The `Index` and `IndexMut` traits were changed to
6874   [take the index by value][index-value], enabling code like
6875   `hash_map["string"]` to work.
6876 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
6877   `Copy` data is known to be `Clone` as well.
6878
6879 Misc
6880 ----
6881
6882 * Many errors now have extended explanations that can be accessed with
6883   the `--explain` flag to `rustc`.
6884 * Many new examples have been added to the standard library
6885   documentation.
6886 * rustdoc has received a number of improvements focused on completion
6887   and polish.
6888 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
6889 * Much headway was made on ecosystem-wide CI, making it possible
6890   to [compare builds for breakage][ci-compare].
6891
6892
6893 [crates.io]: http://crates.io
6894 [clo]: https://github.com/rust-lang/rust/pull/24034
6895 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
6896 [con]: https://github.com/rust-lang/rust/pull/23875
6897 [cr]: https://github.com/rust-lang/rust/pull/23419
6898 [fe]: https://github.com/rust-lang/rust/pull/23879
6899 [ie]: https://github.com/rust-lang/rust/pull/23300
6900 [inv]: https://github.com/rust-lang/rust/pull/23938
6901 [ios]: https://github.com/rust-lang/rust/pull/24133
6902 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
6903 [lt]: https://github.com/rust-lang/rust/pull/24057
6904 [meth]: https://github.com/rust-lang/rust/pull/24056
6905 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
6906 [po]: https://github.com/rust-lang/rust/pull/24270
6907 [sf]: https://github.com/rust-lang/rust/pull/24517
6908 [slp]: https://github.com/rust-lang/rust/pull/23949
6909 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
6910 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
6911 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
6912 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
6913 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
6914 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
6915 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
6916 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
6917 [self-sized]: https://github.com/rust-lang/rust/pull/22301
6918 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
6919 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
6920 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
6921 [reflect]: https://github.com/rust-lang/rust/pull/23712
6922 [conversion]: https://github.com/rust-lang/rfcs/pull/529
6923 [num-traits]: https://github.com/rust-lang/rust/pull/23549
6924 [index-value]: https://github.com/rust-lang/rust/pull/23601
6925 [dropck]: https://github.com/rust-lang/rfcs/pull/769
6926 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
6927 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
6928 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
6929 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
6930 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
6931
6932
6933 Version 1.0.0-alpha.2 (2015-02-20)
6934 =====================================
6935
6936 * ~1300 changes, numerous bugfixes
6937
6938 * Highlights
6939
6940     * The various I/O modules were [overhauled][io-rfc] to reduce
6941       unnecessary abstractions and provide better interoperation with
6942       the underlying platform. The old `io` module remains temporarily
6943       at `std::old_io`.
6944     * The standard library now [participates in feature gating][feat],
6945       so use of unstable libraries now requires a `#![feature(...)]`
6946       attribute. The impact of this change is [described on the
6947       forum][feat-forum]. [RFC][feat-rfc].
6948
6949 * Language
6950
6951     * `for` loops [now operate on the `IntoIterator` trait][into],
6952       which eliminates the need to call `.iter()`, etc. to iterate
6953       over collections. There are some new subtleties to remember
6954       though regarding what sort of iterators various types yield, in
6955       particular that `for foo in bar { }` yields values from a move
6956       iterator, destroying the original collection. [RFC][into-rfc].
6957     * Objects now have [default lifetime bounds][obj], so you don't
6958       have to write `Box<Trait+'static>` when you don't care about
6959       storing references. [RFC][obj-rfc].
6960     * In types that implement `Drop`, [lifetimes must outlive the
6961       value][drop]. This will soon make it possible to safely
6962       implement `Drop` for types where `#[unsafe_destructor]` is now
6963       required. Read the [gorgeous RFC][drop-rfc] for details.
6964     * The fully qualified <T as Trait>::X syntax lets you set the Self
6965       type for a trait method or associated type. [RFC][ufcs-rfc].
6966     * References to types that implement `Deref<U>` now [automatically
6967       coerce to references][deref] to the dereferenced type `U`,
6968       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
6969       should eliminate many unsightly uses of `&*`, as when converting
6970       from references to vectors into references to
6971       slices. [RFC][deref-rfc].
6972     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
6973       `|:|`) is obsolete and closure kind is inferred from context.
6974     * [`Self` is a keyword][Self].
6975
6976 * Libraries
6977
6978     * The `Show` and `String` formatting traits [have been
6979       renamed][fmt] to `Debug` and `Display` to more clearly reflect
6980       their related purposes. Automatically getting a string
6981       conversion to use with `format!("{:?}", something_to_debug)` is
6982       now written `#[derive(Debug)]`.
6983     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
6984       OsStr}`, provide strings in platform-specific encodings for easier
6985       interop with system APIs. [RFC][osstr-rfc].
6986     * The `boxed::into_raw` and `Box::from_raw` functions [convert
6987       between `Box<T>` and `*mut T`][boxraw], a common pattern for
6988       creating raw pointers.
6989
6990 * Tooling
6991
6992     * Certain long error messages of the form 'expected foo found bar'
6993       are now [split neatly across multiple
6994       lines][multiline]. Examples in the PR.
6995     * On Unix Rust can be [uninstalled][un] by running
6996       `/usr/local/lib/rustlib/uninstall.sh`.
6997     * The `#[rustc_on_unimplemented]` attribute, requiring the
6998       'on_unimplemented' feature, lets rustc [display custom error
6999       messages when a trait is expected to be implemented for a type
7000       but is not][onun].
7001
7002 * Misc
7003
7004     * Rust is tested against a [LALR grammar][lalr], which parses
7005       almost all the Rust files that rustc does.
7006
7007 [boxraw]: https://github.com/rust-lang/rust/pull/21318
7008 [close]: https://github.com/rust-lang/rust/pull/21843
7009 [deref]: https://github.com/rust-lang/rust/pull/21351
7010 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
7011 [drop]: https://github.com/rust-lang/rust/pull/21972
7012 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7013 [feat]: https://github.com/rust-lang/rust/pull/21248
7014 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
7015 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
7016 [fmt]: https://github.com/rust-lang/rust/pull/21457
7017 [into]: https://github.com/rust-lang/rust/pull/20790
7018 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
7019 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7020 [lalr]: https://github.com/rust-lang/rust/pull/21452
7021 [multiline]: https://github.com/rust-lang/rust/pull/19870
7022 [obj]: https://github.com/rust-lang/rust/pull/22230
7023 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
7024 [onun]: https://github.com/rust-lang/rust/pull/20889
7025 [osstr]: https://github.com/rust-lang/rust/pull/21488
7026 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7027 [Self]: https://github.com/rust-lang/rust/pull/22158
7028 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
7029 [un]: https://github.com/rust-lang/rust/pull/22256
7030
7031
7032 Version 1.0.0-alpha (2015-01-09)
7033 ==================================
7034
7035   * ~2400 changes, numerous bugfixes
7036
7037   * Highlights
7038
7039     * The language itself is considered feature complete for 1.0,
7040       though there will be many usability improvements and bugfixes
7041       before the final release.
7042     * Nearly 50% of the public API surface of the standard library has
7043       been declared 'stable'. Those interfaces are unlikely to change
7044       before 1.0.
7045     * The long-running debate over integer types has been
7046       [settled][ints]: Rust will ship with types named `isize` and
7047       `usize`, rather than `int` and `uint`, for pointer-sized
7048       integers. Guidelines will be rolled out during the alpha cycle.
7049     * Most crates that are not `std` have been moved out of the Rust
7050       distribution into the Cargo ecosystem so they can evolve
7051       separately and don't need to be stabilized as quickly, including
7052       'time', 'getopts', 'num', 'regex', and 'term'.
7053     * Documentation continues to be expanded with more API coverage, more
7054       examples, and more in-depth explanations. The guides have been
7055       consolidated into [The Rust Programming Language][trpl].
7056     * "[Rust By Example][rbe]" is now maintained by the Rust team.
7057     * All official Rust binary installers now come with [Cargo], the
7058       Rust package manager.
7059
7060 * Language
7061
7062     * Closures have been [completely redesigned][unboxed] to be
7063       implemented in terms of traits, can now be used as generic type
7064       bounds and thus monomorphized and inlined, or via an opaque
7065       pointer (boxed) as in the old system. The new system is often
7066       referred to as 'unboxed' closures.
7067     * Traits now support [associated types][assoc], allowing families
7068       of related types to be defined together and used generically in
7069       powerful ways.
7070     * Enum variants are [namespaced by their type names][enum].
7071     * [`where` clauses][where] provide a more versatile and attractive
7072       syntax for specifying generic bounds, though the previous syntax
7073       remains valid.
7074     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
7075       numeric types.
7076     * Rust [no longer has a runtime][rt] of any description, and only
7077       supports OS threads, not green threads.
7078     * At long last, Rust has been overhauled for 'dynamically-sized
7079       types' ([DST]), which integrates 'fat pointers' (object types,
7080       arrays, and `str`) more deeply into the type system, making it
7081       more consistent.
7082     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
7083       `..j` that produce range types and which, when combined with the
7084       `Index` operator and multidispatch, leads to a convenient slice
7085       notation, `[i..j]`.
7086     * The new range syntax revealed an ambiguity in the fixed-length
7087       array syntax, so now fixed length arrays [are written `[T;
7088       N]`][arrays].
7089     * The `Copy` trait is no longer implemented automatically. Unsafe
7090       pointers no longer implement `Sync` and `Send` so types
7091       containing them don't automatically either. `Sync` and `Send`
7092       are now 'unsafe traits' so one can "forcibly" implement them via
7093       `unsafe impl` if a type confirms to the requirements for them
7094       even though the internals do not (e.g. structs containing unsafe
7095       pointers like `Arc`). These changes are intended to prevent some
7096       footguns and are collectively known as [opt-in built-in
7097       traits][oibit] (though `Sync` and `Send` will soon become pure
7098       library types unknown to the compiler).
7099     * Operator traits now take their operands [by value][ops], and
7100       comparison traits can use multidispatch to compare one type
7101       against multiple other types, allowing e.g. `String` to be
7102       compared with `&str`.
7103     * `if let` and `while let` are no longer feature-gated.
7104     * Rust has adopted a more [uniform syntax for escaping unicode
7105       characters][unicode].
7106     * `macro_rules!` [has been declared stable][mac]. Though it is a
7107       flawed system it is sufficiently popular that it must be usable
7108       for 1.0. Effort has gone into [future-proofing][mac-future] it
7109       in ways that will allow other macro systems to be developed in
7110       parallel, and won't otherwise impact the evolution of the
7111       language.
7112     * The prelude has been [pared back significantly][prelude] such
7113       that it is the minimum necessary to support the most pervasive
7114       code patterns, and through [generalized where clauses][where]
7115       many of the prelude extension traits have been consolidated.
7116     * Rust's rudimentary reflection [has been removed][refl], as it
7117       incurred too much code generation for little benefit.
7118     * [Struct variants][structvars] are no longer feature-gated.
7119     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
7120       known as 'higher-ranked trait bounds', this crucially allows
7121       unboxed closures to work.
7122     * Macros invocations surrounded by parens or square brackets and
7123       not terminated by a semicolon are [parsed as
7124       expressions][macros], which makes expressions like `vec![1i32,
7125       2, 3].len()` work as expected.
7126     * Trait objects now implement their traits automatically, and
7127       traits that can be coerced to objects now must be [object
7128       safe][objsafe].
7129     * Automatically deriving traits is now done with `#[derive(...)]`
7130       not `#[deriving(...)]` for [consistency with other naming
7131       conventions][derive].
7132     * Importing the containing module or enum at the same time as
7133       items or variants they contain is [now done with `self` instead
7134       of `mod`][self], as in use `foo::{self, bar}`
7135     * Glob imports are no longer feature-gated.
7136     * The `box` operator and `box` patterns have been feature-gated
7137       pending a redesign. For now unique boxes should be allocated
7138       like other containers, with `Box::new`.
7139
7140 * Libraries
7141
7142     * A [series][coll1] of [efforts][coll2] to establish
7143       [conventions][coll3] for collections types has resulted in API
7144       improvements throughout the standard library.
7145     * New [APIs for error handling][err] provide ergonomic interop
7146       between error types, and [new conventions][err-conv] describe
7147       more clearly the recommended error handling strategies in Rust.
7148     * The `fail!` macro has been renamed to [`panic!`][panic] so that
7149       it is easier to discuss failure in the context of error handling
7150       without making clarifications as to whether you are referring to
7151       the 'fail' macro or failure more generally.
7152     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
7153       syscall when available.
7154     * The 'serialize' crate has been renamed 'rustc-serialize' and
7155       moved out of the distribution to Cargo. Although it is widely
7156       used now, it is expected to be superseded in the near future.
7157     * The `Show` formatter, typically implemented with
7158       `#[derive(Show)]` is [now requested with the `{:?}`
7159       specifier][show] and is intended for use by all types, for uses
7160       such as `println!` debugging. The new `String` formatter must be
7161       implemented by hand, uses the `{}` specifier, and is intended
7162       for full-fidelity conversions of things that can logically be
7163       represented as strings.
7164
7165 * Tooling
7166
7167     * [Flexible target specification][flex] allows rustc's code
7168       generation to be configured to support otherwise-unsupported
7169       platforms.
7170     * Rust comes with rust-gdb and rust-lldb scripts that launch their
7171       respective debuggers with Rust-appropriate pretty-printing.
7172     * The Windows installation of Rust is distributed with the
7173       MinGW components currently required to link binaries on that
7174       platform.
7175
7176 * Misc
7177
7178     * Nullable enum optimizations have been extended to more types so
7179       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
7180       space than the inner types themselves.
7181     * Work has begun on supporting AArch64.
7182
7183 [Cargo]: https://crates.io
7184 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
7185 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
7186 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
7187 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
7188 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
7189 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
7190 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
7191 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
7192 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
7193 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
7194 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
7195 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
7196 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
7197 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
7198 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
7199 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
7200 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
7201 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
7202 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
7203 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
7204 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
7205 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
7206 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
7207 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
7208 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
7209 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
7210 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
7211 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
7212 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
7213 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
7214 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
7215 [trpl]: https://doc.rust-lang.org/book/index.html
7216 [rbe]: http://rustbyexample.com/
7217
7218
7219 Version 0.12.0 (2014-10-09)
7220 =============================
7221
7222   * ~1900 changes, numerous bugfixes
7223
7224   * Highlights
7225
7226     * The introductory documentation (now called The Rust Guide) has
7227       been completely rewritten, as have a number of supplementary
7228       guides.
7229     * Rust's package manager, Cargo, continues to improve and is
7230       sometimes considered to be quite awesome.
7231     * Many API's in `std` have been reviewed and updated for
7232       consistency with the in-development Rust coding
7233       guidelines. The standard library documentation tracks
7234       stabilization progress.
7235     * Minor libraries have been moved out-of-tree to the rust-lang org
7236       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
7237       be installed with Cargo.
7238     * Lifetime elision allows lifetime annotations to be left off of
7239       function declarations in many common scenarios.
7240     * Rust now works on 64-bit Windows.
7241
7242   * Language
7243     * Indexing can be overloaded with the `Index` and `IndexMut`
7244       traits.
7245     * The `if let` construct takes a branch only if the `let` pattern
7246       matches, currently behind the 'if_let' feature gate.
7247     * 'where clauses', a more flexible syntax for specifying trait
7248       bounds that is more aesthetic, have been added for traits and
7249       free functions. Where clauses will in the future make it
7250       possible to constrain associated types, which would be
7251       impossible with the existing syntax.
7252     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
7253       the 'slicing_syntax' feature gate, and can be overloaded with
7254       the `Slice` or `SliceMut` traits.
7255     * The syntax for matching of sub-slices has been changed to use a
7256       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
7257       consistency with other uses of `..` and to future-proof
7258       potential additional uses of the syntax.
7259     * The syntax for matching inclusive ranges in patterns has changed
7260       from `0..3` to `0...4` to be consistent with the exclusive range
7261       syntax for slicing.
7262     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
7263       c]`) has been put behind the 'advanced_slice_patterns' feature
7264       gate and may be removed in the future.
7265     * Components of tuples and tuple structs can be extracted using
7266       the `value.0` syntax, currently behind the `tuple_indexing`
7267       feature gate.
7268     * The `#[crate_id]` attribute is no longer supported; versioning
7269       is handled by the package manager.
7270     * Renaming crate imports are now written `extern crate foo as bar`
7271       instead of `extern crate bar = foo`.
7272     * Renaming use statements are now written `use foo as bar` instead
7273       of `use bar = foo`.
7274     * `let` and `match` bindings and argument names in macros are now
7275       hygienic.
7276     * The new, more efficient, closure types ('unboxed closures') have
7277       been added under a feature gate, 'unboxed_closures'. These will
7278       soon replace the existing closure types, once higher-ranked
7279       trait lifetimes are added to the language.
7280     * `move` has been added as a keyword, for indicating closures
7281       that capture by value.
7282     * Mutation and assignment is no longer allowed in pattern guards.
7283     * Generic structs and enums can now have trait bounds.
7284     * The `Share` trait is now called `Sync` to free up the term
7285       'shared' to refer to 'shared reference' (the default reference
7286       type.
7287     * Dynamically-sized types have been mostly implemented,
7288       unifying the behavior of fat-pointer types with the rest of the
7289       type system.
7290     * As part of dynamically-sized types, the `Sized` trait has been
7291       introduced, which qualifying types implement by default, and
7292       which type parameters expect by default. To specify that a type
7293       parameter does not need to be sized, write `<Sized? T>`. Most
7294       types are `Sized`, notable exceptions being unsized arrays
7295       (`[T]`) and trait types.
7296     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
7297     * Lifetime bounds can now be applied to type parameters and object
7298       types.
7299     * The old, reference counted GC type, `Gc<T>` which was once
7300       denoted by the `@` sigil, has finally been removed. GC will be
7301       revisited in the future.
7302
7303   * Libraries
7304     * Library documentation has been improved for a number of modules.
7305     * Bit-vectors, collections::bitv has been modernized.
7306     * The url crate is deprecated in favor of
7307       http://github.com/servo/rust-url, which can be installed with
7308       Cargo.
7309     * Most I/O stream types can be cloned and subsequently closed from
7310       a different thread.
7311     * A `std::time::Duration` type has been added for use in I/O
7312       methods that rely on timers, as well as in the 'time' crate's
7313       `Timespec` arithmetic.
7314     * The runtime I/O abstraction layer that enabled the green thread
7315       scheduler to do non-thread-blocking I/O has been removed, along
7316       with the libuv-based implementation employed by the green thread
7317       scheduler. This will greatly simplify the future I/O work.
7318     * `collections::btree` has been rewritten to have a more
7319       idiomatic and efficient design.
7320
7321   * Tooling
7322     * rustdoc output now indicates the stability levels of API's.
7323     * The `--crate-name` flag can specify the name of the crate
7324       being compiled, like `#[crate_name]`.
7325     * The `-C metadata` specifies additional metadata to hash into
7326       symbol names, and `-C extra-filename` specifies additional
7327       information to put into the output filename, for use by the
7328       package manager for versioning.
7329     * debug info generation has continued to improve and should be
7330       more reliable under both gdb and lldb.
7331     * rustc has experimental support for compiling in parallel
7332       using the `-C codegen-units` flag.
7333     * rustc no longer encodes rpath information into binaries by
7334       default.
7335
7336   * Misc
7337     * Stack usage has been optimized with LLVM lifetime annotations.
7338     * Official Rust binaries on Linux are more compatible with older
7339       kernels and distributions, built on CentOS 5.10.
7340
7341
7342 Version 0.11.0 (2014-07-02)
7343 ==========================
7344
7345   * ~1700 changes, numerous bugfixes
7346
7347   * Language
7348     * ~[T] has been removed from the language. This type is superseded by
7349       the Vec<T> type.
7350     * ~str has been removed from the language. This type is superseded by
7351       the String type.
7352     * ~T has been removed from the language. This type is superseded by the
7353       Box<T> type.
7354     * @T has been removed from the language. This type is superseded by the
7355       standard library's std::gc::Gc<T> type.
7356     * Struct fields are now all private by default.
7357     * Vector indices and shift amounts are both required to be a `uint`
7358       instead of any integral type.
7359     * Byte character, byte string, and raw byte string literals are now all
7360       supported by prefixing the normal literal with a `b`.
7361     * Multiple ABIs are no longer allowed in an ABI string
7362     * The syntax for lifetimes on closures/procedures has been tweaked
7363       slightly: `<'a>|A, B|: 'b + K -> T`
7364     * Floating point modulus has been removed from the language; however it
7365       is still provided by a library implementation.
7366     * Private enum variants are now disallowed.
7367     * The `priv` keyword has been removed from the language.
7368     * A closure can no longer be invoked through a &-pointer.
7369     * The `use foo, bar, baz;` syntax has been removed from the language.
7370     * The transmute intrinsic no longer works on type parameters.
7371     * Statics now allow blocks/items in their definition.
7372     * Trait bounds are separated from objects with + instead of : now.
7373     * Objects can no longer be read while they are mutably borrowed.
7374     * The address of a static is now marked as insignificant unless the
7375       #[inline(never)] attribute is placed it.
7376     * The #[unsafe_destructor] attribute is now behind a feature gate.
7377     * Struct literals are no longer allowed in ambiguous positions such as
7378       if, while, match, and for..in.
7379     * Declaration of lang items and intrinsics are now feature-gated by
7380       default.
7381     * Integral literals no longer default to `int`, and floating point
7382       literals no longer default to `f64`. Literals must be suffixed with an
7383       appropriate type if inference cannot determine the type of the
7384       literal.
7385     * The Box<T> type is no longer implicitly borrowed to &mut T.
7386     * Procedures are now required to not capture borrowed references.
7387
7388   * Libraries
7389     * The standard library is now a "facade" over a number of underlying
7390       libraries. This means that development on the standard library should
7391       be speedier due to smaller crates, as well as a clearer line between
7392       all dependencies.
7393     * A new library, libcore, lives under the standard library's facade
7394       which is Rust's "0-assumption" library, suitable for embedded and
7395       kernel development for example.
7396     * A regex crate has been added to the standard distribution. This crate
7397       includes statically compiled regular expressions.
7398     * The unwrap/unwrap_err methods on Result require a Show bound for
7399       better error messages.
7400     * The return types of the std::comm primitives have been centralized
7401       around the Result type.
7402     * A number of I/O primitives have gained the ability to time out their
7403       operations.
7404     * A number of I/O primitives have gained the ability to close their
7405       reading/writing halves to cancel pending operations.
7406     * Reverse iterator methods have been removed in favor of `rev()` on
7407       their forward-iteration counterparts.
7408     * A bitflags! macro has been added to enable easy interop with C and
7409       management of bit flags.
7410     * A debug_assert! macro is now provided which is disabled when
7411       `--cfg ndebug` is passed to the compiler.
7412     * A graphviz crate has been added for creating .dot files.
7413     * The std::cast module has been migrated into std::mem.
7414     * The std::local_data api has been migrated from freestanding functions
7415       to being based on methods.
7416     * The Pod trait has been renamed to Copy.
7417     * jemalloc has been added as the default allocator for types.
7418     * The API for allocating memory has been changed to use proper alignment
7419       and sized deallocation
7420     * Connecting a TcpStream or binding a TcpListener is now based on a
7421       string address and a u16 port. This allows connecting to a hostname as
7422       opposed to an IP.
7423     * The Reader trait now contains a core method, read_at_least(), which
7424       correctly handles many repeated 0-length reads.
7425     * The process-spawning API is now centered around a builder-style
7426       Command struct.
7427     * The :? printing qualifier has been moved from the standard library to
7428       an external libdebug crate.
7429     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
7430       have been renamed to Eq/Ord.
7431     * The select/plural methods have been removed from format!. The escapes
7432       for { and } have also changed from \{ and \} to {{ and }},
7433       respectively.
7434     * The TaskBuilder API has been re-worked to be a true builder, and
7435       extension traits for spawning native/green tasks have been added.
7436
7437   * Tooling
7438     * All breaking changes to the language or libraries now have their
7439       commit message annotated with `[breaking-change]` to allow for easy
7440       discovery of breaking changes.
7441     * The compiler will now try to suggest how to annotate lifetimes if a
7442       lifetime-related error occurs.
7443     * Debug info continues to be improved greatly with general bug fixes and
7444       better support for situations like link time optimization (LTO).
7445     * Usage of syntax extensions when cross-compiling has been fixed.
7446     * Functionality equivalent to GCC & Clang's -ffunction-sections,
7447       -fdata-sections and --gc-sections has been enabled by default
7448     * The compiler is now stricter about where it will load module files
7449       from when a module is declared via `mod foo;`.
7450     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
7451       Syntax extensions are now discovered via a "plugin registrar" type
7452       which will be extended in the future to other various plugins.
7453     * Lints have been restructured to allow for dynamically loadable lints.
7454     * A number of rustdoc improvements:
7455       * The HTML output has been visually redesigned.
7456       * Markdown is now powered by hoedown instead of sundown.
7457       * Searching heuristics have been greatly improved.
7458       * The search index has been reduced in size by a great amount.
7459       * Cross-crate documentation via `pub use` has been greatly improved.
7460       * Primitive types are now hyperlinked and documented.
7461     * Documentation has been moved from static.rust-lang.org/doc to
7462       doc.rust-lang.org
7463     * A new sandbox, play.rust-lang.org, is available for running and
7464       sharing rust code examples on-line.
7465     * Unused attributes are now more robustly warned about.
7466     * The dead_code lint now warns about unused struct fields.
7467     * Cross-compiling to iOS is now supported.
7468     * Cross-compiling to mipsel is now supported.
7469     * Stability attributes are now inherited by default and no longer apply
7470       to intra-crate usage, only inter-crate usage.
7471     * Error message related to non-exhaustive match expressions have been
7472       greatly improved.
7473
7474
7475 Version 0.10 (2014-04-03)
7476 =========================
7477
7478   * ~1500 changes, numerous bugfixes
7479
7480   * Language
7481     * A new RFC process is now in place for modifying the language.
7482     * Patterns with `@`-pointers have been removed from the language.
7483     * Patterns with unique vectors (`~[T]`) have been removed from the
7484       language.
7485     * Patterns with unique strings (`~str`) have been removed from the
7486       language.
7487     * `@str` has been removed from the language.
7488     * `@[T]` has been removed from the language.
7489     * `@self` has been removed from the language.
7490     * `@Trait` has been removed from the language.
7491     * Headers on `~` allocations which contain `@` boxes inside the type for
7492       reference counting have been removed.
7493     * The semantics around the lifetimes of temporary expressions have changed,
7494       see #3511 and #11585 for more information.
7495     * Cross-crate syntax extensions are now possible, but feature gated. See
7496       #11151 for more information. This includes both `macro_rules!` macros as
7497       well as syntax extensions such as `format!`.
7498     * New lint modes have been added, and older ones have been turned on to be
7499       warn-by-default.
7500       * Unnecessary parentheses
7501       * Uppercase statics
7502       * Camel Case types
7503       * Uppercase variables
7504       * Publicly visible private types
7505       * `#[deriving]` with raw pointers
7506     * Unsafe functions can no longer be coerced to closures.
7507     * Various obscure macros such as `log_syntax!` are now behind feature gates.
7508     * The `#[simd]` attribute is now behind a feature gate.
7509     * Visibility is no longer allowed on `extern crate` statements, and
7510       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
7511     * Trailing commas are now allowed in argument lists and tuple patterns.
7512     * The `do` keyword has been removed, it is now a reserved keyword.
7513     * Default type parameters have been implemented, but are feature gated.
7514     * Borrowed variables through captures in closures are now considered soundly.
7515     * `extern mod` is now `extern crate`
7516     * The `Freeze` trait has been removed.
7517     * The `Share` trait has been added for types that can be shared among
7518       threads.
7519     * Labels in macros are now hygienic.
7520     * Expression/statement macro invocations can be delimited with `{}` now.
7521     * Treatment of types allowed in `static mut` locations has been tweaked.
7522     * The `*` and `.` operators are now overloadable through the `Deref` and
7523       `DerefMut` traits.
7524     * `~Trait` and `proc` no longer have `Send` bounds by default.
7525     * Partial type hints are now supported with the `_` type marker.
7526     * An `Unsafe` type was introduced for interior mutability. It is now
7527       considered undefined to transmute from `&T` to `&mut T` without using the
7528       `Unsafe` type.
7529     * The #[linkage] attribute was implemented for extern statics/functions.
7530     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
7531     * `Pod` was renamed to `Copy`.
7532
7533   * Libraries
7534     * The `libextra` library has been removed. It has now been decomposed into
7535       component libraries with smaller and more focused nuggets of
7536       functionality. The full list of libraries can be found on the
7537       documentation index page.
7538     * std: `std::condition` has been removed. All I/O errors are now propagated
7539       through the `Result` type. In order to assist with error handling, a
7540       `try!` macro for unwrapping errors with an early return and a lint for
7541       unused results has been added. See #12039 for more information.
7542     * std: The `vec` module has been renamed to `slice`.
7543     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
7544       This will become the only growable vector in the future.
7545     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
7546       are now found at `std::io::BufferedReader` instead of
7547       `std::io::buffered::BufferedReader`.
7548     * std: `print` and `println` are no longer in the prelude, the `print!` and
7549       `println!` macros are intended to be used instead.
7550     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
7551       attempts to statically prevent cycles.
7552     * std: The standard distribution is adopting the policy of pushing failure
7553       to the user rather than failing in libraries. Many functions (such as
7554       `slice::last()`) now return `Option<T>` instead of `T` + failing.
7555     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
7556       deriving mode: `#[deriving(Show)]`.
7557     * std: `ToStr` is now implemented for all types implementing `Show`.
7558     * std: The formatting trait methods now take `&self` instead of `&T`
7559     * std: The `invert()` method on iterators has been renamed to `rev()`
7560     * std: `std::num` has seen a reduction in the genericity of its traits,
7561       consolidating functionality into a few core traits.
7562     * std: Backtraces are now printed on task failure if the environment
7563       variable `RUST_BACKTRACE` is present.
7564     * std: Naming conventions for iterators have been standardized. More details
7565       can be found on the wiki's style guide.
7566     * std: `eof()` has been removed from the `Reader` trait. Specific types may
7567       still implement the function.
7568     * std: Networking types are now cloneable to allow simultaneous reads/writes.
7569     * std: `assert_approx_eq!` has been removed
7570     * std: The `e` and `E` formatting specifiers for floats have been added to
7571       print them in exponential notation.
7572     * std: The `Times` trait has been removed
7573     * std: Indications of variance and opting out of builtin bounds is done
7574       through marker types in `std::kinds::marker` now
7575     * std: `hash` has been rewritten, `IterBytes` has been removed, and
7576       `#[deriving(Hash)]` is now possible.
7577     * std: `SharedChan` has been removed, `Sender` is now cloneable.
7578     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
7579     * std: `Chan::new` is now `channel()`.
7580     * std: A new synchronous channel type has been implemented.
7581     * std: A `select!` macro is now provided for selecting over `Receiver`s.
7582     * std: `hashmap` and `trie` have been moved to `libcollections`
7583     * std: `run` has been rolled into `io::process`
7584     * std: `assert_eq!` now uses `{}` instead of `{:?}`
7585     * std: The equality and comparison traits have seen some reorganization.
7586     * std: `rand` has moved to `librand`.
7587     * std: `to_{lower,upper}case` has been implemented for `char`.
7588     * std: Logging has been moved to `liblog`.
7589     * collections: `HashMap` has been rewritten for higher performance and less
7590       memory usage.
7591     * native: The default runtime is now `libnative`. If `libgreen` is desired,
7592       it can be booted manually. The runtime guide has more information and
7593       examples.
7594     * native: All I/O functionality except signals has been implemented.
7595     * green: Task spawning with `libgreen` has been optimized with stack caching
7596       and various trimming of code.
7597     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
7598     * sync: The `extra::sync` module has been updated to modern rust (and moved
7599       to the `sync` library), tweaking and improving various interfaces while
7600       dropping redundant functionality.
7601     * sync: A new `Barrier` type has been added to the `sync` library.
7602     * sync: An efficient mutex for native and green tasks has been implemented.
7603     * serialize: The `base64` module has seen some improvement. It treats
7604       newlines better, has non-string error values, and has seen general
7605       cleanup.
7606     * fourcc: A `fourcc!` macro was introduced
7607     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
7608       hexadecimal literal.
7609
7610   * Tooling
7611     * `rustpkg` has been deprecated and removed from the main repository. Its
7612       replacement, `cargo`, is under development.
7613     * Nightly builds of rust are now available
7614     * The memory usage of rustc has been improved many times throughout this
7615       release cycle.
7616     * The build process supports disabling rpath support for the rustc binary
7617       itself.
7618     * Code generation has improved in some cases, giving more information to the
7619       LLVM optimization passes to enable more extensive optimizations.
7620     * Debuginfo compatibility with lldb on OSX has been restored.
7621     * The master branch is now gated on an android bot, making building for
7622       android much more reliable.
7623     * Output flags have been centralized into one `--emit` flag.
7624     * Crate type flags have been centralized into one `--crate-type` flag.
7625     * Codegen flags have been consolidated behind a `-C` flag.
7626     * Linking against outdated crates now has improved error messages.
7627     * Error messages with lifetimes will often suggest how to annotate the
7628       function to fix the error.
7629     * Many more types are documented in the standard library, and new guides
7630       were written.
7631     * Many `rustdoc` improvements:
7632       * code blocks are syntax highlighted.
7633       * render standalone markdown files.
7634       * the --test flag tests all code blocks by default.
7635       * exported macros are displayed.
7636       * re-exported types have their documentation inlined at the location of the
7637         first re-export.
7638       * search works across crates that have been rendered to the same output
7639         directory.
7640
7641
7642 Version 0.9 (2014-01-09)
7643 ==========================
7644
7645    * ~1800 changes, numerous bugfixes
7646
7647    * Language
7648       * The `float` type has been removed. Use `f32` or `f64` instead.
7649       * A new facility for enabling experimental features (feature gating) has
7650         been added, using the crate-level `#[feature(foo)]` attribute.
7651       * Managed boxes (@) are now behind a feature gate
7652         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
7653         standard library's `Gc` or `Rc` types instead.
7654       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
7655       * Jumping back to the top of a loop is now done with `continue` instead of
7656         `loop`.
7657       * Strings can no longer be mutated through index assignment.
7658       * Raw strings can be created via the basic `r"foo"` syntax or with matched
7659         hash delimiters, as in `r###"foo"###`.
7660       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
7661         called once.
7662       * The `&fn` type is now written `|args| -> ret` to match the literal form.
7663       * `@fn`s have been removed.
7664       * `do` only works with procs in order to make it obvious what the cost
7665         of `do` is.
7666       * Single-element tuple-like structs can no longer be dereferenced to
7667         obtain the inner value. A more comprehensive solution for overloading
7668         the dereference operator will be provided in the future.
7669       * The `#[link(...)]` attribute has been replaced with
7670         `#[crate_id = "name#vers"]`.
7671       * Empty `impl`s must be terminated with empty braces and may not be
7672         terminated with a semicolon.
7673       * Keywords are no longer allowed as lifetime names; the `self` lifetime
7674         no longer has any special meaning.
7675       * The old `fmt!` string formatting macro has been removed.
7676       * `printf!` and `printfln!` (old-style formatting) removed in favor of
7677         `print!` and `println!`.
7678       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
7679       * The `extern mod foo (name = "bar")` syntax has been removed. Use
7680         `extern mod foo = "bar"` instead.
7681       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
7682       * Macros can have attributes.
7683       * Macros can expand to items with attributes.
7684       * Macros can expand to multiple items.
7685       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
7686       * Comments may be nested.
7687       * Values automatically coerce to trait objects they implement, without
7688         an explicit `as`.
7689       * Enum discriminants are no longer an entire word but as small as needed to
7690         contain all the variants. The `repr` attribute can be used to override
7691         the discriminant size, as in `#[repr(int)]` for integer-sized, and
7692         `#[repr(C)]` to match C enums.
7693       * Non-string literals are not allowed in attributes (they never worked).
7694       * The FFI now supports variadic functions.
7695       * Octal numeric literals, as in `0o7777`.
7696       * The `concat!` syntax extension performs compile-time string concatenation.
7697       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
7698         removed as Rust no longer uses segmented stacks.
7699       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
7700       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
7701         not `*`; ignoring remaining fields of a struct is also done with `..`,
7702         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
7703       * `rustc` supports the "win64" calling convention via `extern "win64"`.
7704       * `rustc` supports the "system" calling convention, which defaults to the
7705         preferred convention for the target platform, "stdcall" on 32-bit Windows,
7706         "C" elsewhere.
7707       * The `type_overflow` lint (default: warn) checks literals for overflow.
7708       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
7709       * The `attribute_usage` lint (default: warn) warns about unknown
7710         attributes.
7711       * The `unknown_features` lint (default: warn) warns about unknown
7712         feature gates.
7713       * The `dead_code` lint (default: warn) checks for dead code.
7714       * Rust libraries can be linked statically to one another
7715       * `#[link_args]` is behind the `link_args` feature gate.
7716       * Native libraries are now linked with `#[link(name = "foo")]`
7717       * Native libraries can be statically linked to a rust crate
7718         (`#[link(name = "foo", kind = "static")]`).
7719       * Native OS X frameworks are now officially supported
7720         (`#[link(name = "foo", kind = "framework")]`).
7721       * The `#[thread_local]` attribute creates thread-local (not task-local)
7722         variables. Currently behind the `thread_local` feature gate.
7723       * The `return` keyword may be used in closures.
7724       * Types that can be copied via a memcpy implement the `Pod` kind.
7725       * The `cfg` attribute can now be used on struct fields and enum variants.
7726
7727    * Libraries
7728       * std: The `option` and `result` API's have been overhauled to make them
7729         simpler, more consistent, and more composable.
7730       * std: The entire `std::io` module has been replaced with one that is
7731         more comprehensive and that properly interfaces with the underlying
7732         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
7733         implemented.
7734       * std: `io::util` contains a number of useful implementations of
7735         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
7736         `ZeroReader`, `TeeReader`.
7737       * std: The reference counted pointer type `extra::rc` moved into std.
7738       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
7739         just a wrapper around it).
7740       * std: The `Either` type has been removed.
7741       * std: `fmt::Default` can be implemented for any type to provide default
7742         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
7743       * std: The `rand` API continues to be tweaked.
7744       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
7745         on failure in gdb, is now named `rust_fail`.
7746       * std: The `each_key` and `each_value` methods on `HashMap` have been
7747         replaced by the `keys` and `values` iterators.
7748       * std: Functions dealing with type size and alignment have moved from the
7749         `sys` module to the `mem` module.
7750       * std: The `path` module was written and API changed.
7751       * std: `str::from_utf8` has been changed to cast instead of allocate.
7752       * std: `starts_with` and `ends_with` methods added to vectors via the
7753         `ImmutableEqVector` trait, which is in the prelude.
7754       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
7755         if the index is out of bounds.
7756       * std: Task failure no longer propagates between tasks, as the model was
7757         complex, expensive, and incompatible with thread-based tasks.
7758       * std: The `Any` type can be used for dynamic typing.
7759       * std: `~Any` can be passed to the `fail!` macro and retrieved via
7760         `task::try`.
7761       * std: Methods that produce iterators generally do not have an `_iter`
7762         suffix now.
7763       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
7764         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
7765       * std: `util::ignore` renamed to `prelude::drop`.
7766       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
7767         trait.
7768       * std: `vec::raw` has seen a lot of cleanup and API changes.
7769       * std: The standard library no longer includes any C++ code, and very
7770         minimal C, eliminating the dependency on libstdc++.
7771       * std: Runtime scheduling and I/O functionality has been factored out into
7772         extensible interfaces and is now implemented by two different crates:
7773         libnative, for native threading and I/O; and libgreen, for green threading
7774         and I/O. This paves the way for using the standard library in more limited
7775         embedded environments.
7776       * std: The `comm` module has been rewritten to be much faster, have a
7777         simpler, more consistent API, and to work for both native and green
7778         threading.
7779       * std: All libuv dependencies have been moved into the rustuv crate.
7780       * native: New implementations of runtime scheduling on top of OS threads.
7781       * native: New native implementations of TCP, UDP, file I/O, process spawning,
7782         and other I/O.
7783       * green: The green thread scheduler and message passing types are almost
7784         entirely lock-free.
7785       * extra: The `flatpipes` module had bitrotted and was removed.
7786       * extra: All crypto functions have been removed and Rust now has a policy of
7787         not reimplementing crypto in the standard library. In the future crypto
7788         will be provided by external crates with bindings to established libraries.
7789       * extra: `c_vec` has been modernized.
7790       * extra: The `sort` module has been removed. Use the `sort` method on
7791         mutable slices.
7792
7793    * Tooling
7794       * The `rust` and `rusti` commands have been removed, due to lack of
7795         maintenance.
7796       * `rustdoc` was completely rewritten.
7797       * `rustdoc` can test code examples in documentation.
7798       * `rustpkg` can test packages with the argument, 'test'.
7799       * `rustpkg` supports arbitrary dependencies, including C libraries.
7800       * `rustc`'s support for generating debug info is improved again.
7801       * `rustc` has better error reporting for unbalanced delimiters.
7802       * `rustc`'s JIT support was removed due to bitrot.
7803       * Executables and static libraries can be built with LTO (-Z lto)
7804       * `rustc` adds a `--dep-info` flag for communicating dependencies to
7805         build tools.
7806
7807
7808 Version 0.8 (2013-09-26)
7809 ============================
7810
7811    * ~2200 changes, numerous bugfixes
7812
7813    * Language
7814       * The `for` loop syntax has changed to work with the `Iterator` trait.
7815       * At long last, unwinding works on Windows.
7816       * Default methods are ready for use.
7817       * Many trait inheritance bugs fixed.
7818       * Owned and borrowed trait objects work more reliably.
7819       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
7820       * rustc can omit emission of code for the `debug!` macro if it is passed
7821         `--cfg ndebug`
7822       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
7823         for foo.rs, then foo/mod.rs, and will generate an error when both are
7824         present.
7825       * Strings no longer contain trailing nulls. The new `std::c_str` module
7826         provides new mechanisms for converting to C strings.
7827       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
7828       * The FFI has been overhauled such that foreign functions are called directly,
7829         instead of through a stack-switching wrapper.
7830       * Calling a foreign function must be done through a Rust function with the
7831         `#[fixed_stack_segment]` attribute.
7832       * The `externfn!` macro can be used to declare both a foreign function and
7833         a `#[fixed_stack_segment]` wrapper at once.
7834       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
7835       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
7836       * `priv` is disallowed everywhere except for struct fields and enum variants.
7837       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
7838       * `ref` bindings in irrefutable patterns work correctly now.
7839       * `char` is now prevented from containing invalid code points.
7840       * Casting to `bool` is no longer allowed.
7841       * `\0` is now accepted as an escape in chars and strings.
7842       * `yield` is a reserved keyword.
7843       * `typeof` is a reserved keyword.
7844       * Crates may be imported by URL with `extern mod foo = "url";`.
7845       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
7846       * Static vectors can be initialized with repeating elements,
7847         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
7848       * Static structs can be initialized with functional record update,
7849         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
7850       * `cfg!` can be used to conditionally execute code based on the crate
7851         configuration, similarly to `#[cfg(...)]`.
7852       * The `unnecessary_qualification` lint detects unneeded module
7853         prefixes (default: allow).
7854       * Arithmetic operations have been implemented on the SIMD types in
7855         `std::unstable::simd`.
7856       * Exchange allocation headers were removed, reducing memory usage.
7857       * `format!` implements a completely new, extensible, and higher-performance
7858         string formatting system. It will replace `fmt!`.
7859       * `print!` and `println!` write formatted strings (using the `format!`
7860         extension) to stdout.
7861       * `write!` and `writeln!` write formatted strings (using the `format!`
7862         extension) to the new Writers in `std::rt::io`.
7863       * The library section in which a function or static is placed may
7864         be specified with `#[link_section = "..."]`.
7865       * The `proto!` syntax extension for defining bounded message protocols
7866         was removed.
7867       * `macro_rules!` is hygienic for `let` declarations.
7868       * The `#[export_name]` attribute specifies the name of a symbol.
7869       * `unreachable!` can be used to indicate unreachable code, and fails
7870         if executed.
7871
7872    * Libraries
7873       * std: Transitioned to the new runtime, written in Rust.
7874       * std: Added an experimental I/O library, `rt::io`, based on the new
7875         runtime.
7876       * std: A new generic `range` function was added to the prelude, replacing
7877         `uint::range` and friends.
7878       * std: `range_rev` no longer exists. Since range is an iterator it can be
7879         reversed with `range(lo, hi).invert()`.
7880       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
7881         renamed to `unwrap_or`.
7882       * std: The `iterator` module was renamed to `iter`.
7883       * std: Integral types now support the `checked_add`, `checked_sub`, and
7884         `checked_mul` operations for detecting overflow.
7885       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
7886         consistency.
7887       * std: Methods are standardizing on conventions for casting methods:
7888         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
7889         and cheap casts.
7890       * std: The `CString` type in `c_str` provides new ways to convert to and
7891         from C strings.
7892       * std: `DoubleEndedIterator` can yield elements in two directions.
7893       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
7894         two splices.
7895       * std: `str::from_bytes` renamed to `str::from_utf8`.
7896       * std: `pop_opt` and `shift_opt` methods added to vectors.
7897       * std: The task-local data interface no longer uses @, and keys are
7898         no longer function pointers.
7899       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
7900       * std: Added `SharedPort` to `comm`.
7901       * std: `Eq` has a default method for `ne`; only `eq` is required
7902         in implementations.
7903       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
7904         is required in implementations.
7905       * std: `is_utf8` performance is improved, impacting many string functions.
7906       * std: `os::MemoryMap` provides cross-platform mmap.
7907       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
7908         are not 'in-bounds' are considered undefined.
7909       * std: Many freestanding functions in `vec` removed in favor of methods.
7910       * std: Many freestanding functions on scalar types removed in favor of
7911         methods.
7912       * std: Many options to task builders were removed since they don't make
7913         sense in the new scheduler design.
7914       * std: More containers implement `FromIterator` so can be created by the
7915         `collect` method.
7916       * std: More complete atomic types in `unstable::atomics`.
7917       * std: `comm::PortSet` removed.
7918       * std: Mutating methods in the `Set` and `Map` traits have been moved into
7919         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
7920         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
7921         default implementations.
7922       * std: Various `from_str` functions were removed in favor of a generic
7923         `from_str` which is available in the prelude.
7924       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
7925       * extra: `dlist`, the doubly-linked list was modernized.
7926       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
7927       * extra: Added `glob` module, replacing `std::os::glob`.
7928       * extra: `rope` was removed.
7929       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
7930       * extra: `net`, and `timer` were removed. The experimental replacements
7931         are `std::rt::io::net` and `std::rt::io::timer`.
7932       * extra: Iterators implemented for `SmallIntMap`.
7933       * extra: Iterators implemented for `Bitv` and `BitvSet`.
7934       * extra: `SmallIntSet` removed. Use `BitvSet`.
7935       * extra: Performance of JSON parsing greatly improved.
7936       * extra: `semver` updated to SemVer 2.0.0.
7937       * extra: `term` handles more terminals correctly.
7938       * extra: `dbg` module removed.
7939       * extra: `par` module removed.
7940       * extra: `future` was cleaned up, with some method renames.
7941       * extra: Most free functions in `getopts` were converted to methods.
7942
7943    * Other
7944       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
7945       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
7946         similarly to gcc's `--march` flag.
7947       * rustc's performance compiling small crates is much better.
7948       * rustpkg has received many improvements.
7949       * rustpkg supports git tags as package IDs.
7950       * rustpkg builds into target-specific directories so it can be used for
7951         cross-compiling.
7952       * The number of concurrent test tasks is controlled by the environment
7953         variable RUST_TEST_TASKS.
7954       * The test harness can now report metrics for benchmarks.
7955       * All tools have man pages.
7956       * Programs compiled with `--test` now support the `-h` and `--help` flags.
7957       * The runtime uses jemalloc for allocations.
7958       * Segmented stacks are temporarily disabled as part of the transition to
7959         the new runtime. Stack overflows are possible!
7960       * A new documentation backend, rustdoc_ng, is available for use. It is
7961         still invoked through the normal `rustdoc` command.
7962
7963
7964 Version 0.7 (2013-07-03)
7965 =======================
7966
7967    * ~2000 changes, numerous bugfixes
7968
7969    * Language
7970       * `impl`s no longer accept a visibility qualifier. Put them on methods
7971         instead.
7972       * The borrow checker has been rewritten with flow-sensitivity, fixing
7973         many bugs and inconveniences.
7974       * The `self` parameter no longer implicitly means `&'self self`,
7975         and can be explicitly marked with a lifetime.
7976       * Overloadable compound operators (`+=`, etc.) have been temporarily
7977         removed due to bugs.
7978       * The `for` loop protocol now requires `for`-iterators to return `bool`
7979         so they compose better.
7980       * The `Durable` trait is replaced with the `'static` bounds.
7981       * Trait default methods work more often.
7982       * Structs with the `#[packed]` attribute have byte alignment and
7983         no padding between fields.
7984       * Type parameters bound by `Copy` must now be copied explicitly with
7985         the `copy` keyword.
7986       * It is now illegal to move out of a dereferenced unsafe pointer.
7987       * `Option<~T>` is now represented as a nullable pointer.
7988       * `@mut` does dynamic borrow checks correctly.
7989       * The `main` function is only detected at the topmost level of the crate.
7990         The `#[main]` attribute is still valid anywhere.
7991       * Struct fields may no longer be mutable. Use inherited mutability.
7992       * The `#[no_send]` attribute makes a type that would otherwise be
7993         `Send`, not.
7994       * The `#[no_freeze]` attribute makes a type that would otherwise be
7995         `Freeze`, not.
7996       * Unbounded recursion will abort the process after reaching the limit
7997         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
7998       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
7999         are never implicitly copyable.
8000       * `#[static_assert]` makes compile-time assertions about static bools.
8001       * At long last, 'argument modes' no longer exist.
8002       * The rarely used `use mod` statement no longer exists.
8003
8004    * Syntax extensions
8005       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
8006         argument list.
8007       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
8008         `Rand`, `Zero` and `ToStr` can all be automatically derived with
8009         `#[deriving(...)]`.
8010       * The `bytes!` macro returns a vector of bytes for string, u8, char,
8011         and unsuffixed integer literals.
8012
8013    * Libraries
8014       * The `core` crate was renamed to `std`.
8015       * The `std` crate was renamed to `extra`.
8016       * More and improved documentation.
8017       * std: `iterator` module for external iterator objects.
8018       * Many old-style (internal, higher-order function) iterators replaced by
8019         implementations of `Iterator`.
8020       * std: Many old internal vector and string iterators,
8021         incl. `any`, `all`. removed.
8022       * std: The `finalize` method of `Drop` renamed to `drop`.
8023       * std: The `drop` method now takes `&mut self` instead of `&self`.
8024       * std: The prelude no longer re-exports any modules, only types and traits.
8025       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
8026         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
8027       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
8028         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
8029       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
8030         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
8031       * std: Many types implement `Clone`.
8032       * std: `path` type renamed to `Path`.
8033       * std: `mut` module and `Mut` type removed.
8034       * std: Many standalone functions removed in favor of methods and iterators
8035         in `vec`, `str`. In the future methods will also work as functions.
8036       * std: `reinterpret_cast` removed. Use `transmute`.
8037       * std: ascii string handling in `std::ascii`.
8038       * std: `Rand` is implemented for ~/@.
8039       * std: `run` module for spawning processes overhauled.
8040       * std: Various atomic types added to `unstable::atomic`.
8041       * std: Various types implement `Zero`.
8042       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
8043       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
8044       * std: Added `os::mkdir_recursive`.
8045       * std: Added `os::glob` function performs filesystems globs.
8046       * std: `FuzzyEq` renamed to `ApproxEq`.
8047       * std: `Map` now defines `pop` and `swap` methods.
8048       * std: `Cell` constructors converted to static methods.
8049       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
8050       * extra: `flate` module moved from `std` to `extra`.
8051       * extra: `fileinput` module for iterating over a series of files.
8052       * extra: `Complex` number type and `complex` module.
8053       * extra: `Rational` number type and `rational` module.
8054       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
8055       * extra: `term` uses terminfo now, is more correct.
8056       * extra: `arc` functions converted to methods.
8057       * extra: Implementation of fixed output size variations of SHA-2.
8058
8059    * Tooling
8060       * `unused_variables` lint mode for unused variables (default: warn).
8061       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
8062         (default: warn).
8063       * `unused_mut` lint mode for identifying unused `mut` qualifiers
8064         (default: warn).
8065       * `dead_assignment` lint mode for unread variables (default: warn).
8066       * `unnecessary_allocation` lint mode detects some heap allocations that are
8067         immediately borrowed so could be written without allocating (default: warn).
8068       * `missing_doc` lint mode (default: allow).
8069       * `unreachable_code` lint mode (default: warn).
8070       * The `rusti` command has been rewritten and a number of bugs addressed.
8071       * rustc outputs in color on more terminals.
8072       * rustc accepts a `--link-args` flag to pass arguments to the linker.
8073       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
8074       * Compiling with `-g` will make the binary record information about
8075         dynamic borrowcheck failures for debugging.
8076       * rustdoc has a nicer stylesheet.
8077       * Various improvements to rustdoc.
8078       * Improvements to rustpkg (see the detailed release notes).
8079
8080
8081 Version 0.6 (2013-04-03)
8082 ========================
8083
8084    * ~2100 changes, numerous bugfixes
8085
8086    * Syntax changes
8087       * The self type parameter in traits is now spelled `Self`
8088       * The `self` parameter in trait and impl methods must now be explicitly
8089         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
8090       * Static methods no longer require the `static` keyword and instead
8091         are distinguished by the lack of a `self` parameter
8092       * Replaced the `Durable` trait with the `'static` lifetime
8093       * The old closure type syntax with the trailing sigil has been
8094         removed in favor of the more consistent leading sigil
8095       * `super` is a keyword, and may be prefixed to paths
8096       * Trait bounds are separated with `+` instead of whitespace
8097       * Traits are implemented with `impl Trait for Type`
8098         instead of `impl Type: Trait`
8099       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
8100       * The `export` keyword has finally been removed
8101       * The `move` keyword has been removed (see "Semantic changes")
8102       * The interior mutability qualifier on vectors, `[mut T]`, has been
8103         removed. Use `&mut [T]`, etc.
8104       * `mut` is no longer valid in `~mut T`. Use inherited mutability
8105       * `fail` is no longer a keyword. Use `fail!()`
8106       * `assert` is no longer a keyword. Use `assert!()`
8107       * `log` is no longer a keyword. use `debug!`, etc.
8108       * 1-tuples may be represented as `(T,)`
8109       * Struct fields may no longer be `mut`. Use inherited mutability,
8110         `@mut T`, `core::mut` or `core::cell`
8111       * `extern mod { ... }` is no longer valid syntax for foreign
8112         function modules. Use extern blocks: `extern { ... }`
8113       * Newtype enums removed. Use tuple-structs.
8114       * Trait implementations no longer support visibility modifiers
8115       * Pattern matching over vectors improved and expanded
8116       * `const` renamed to `static` to correspond to lifetime name,
8117         and make room for future `static mut` unsafe mutable globals.
8118       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
8119       * `Clone` implementations can be automatically generated with
8120         `#[deriving(Clone)]`
8121       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
8122         instead of `foo as Bar`.
8123       * Fixed length vector types are now written as `[int, .. 3]`
8124         instead of `[int * 3]`.
8125       * Fixed length vector types can express the length as a constant
8126         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
8127
8128    * Semantic changes
8129       * Types with owned pointers or custom destructors move by default,
8130         eliminating the `move` keyword
8131       * All foreign functions are considered unsafe
8132       * &mut is now unaliasable
8133       * Writes to borrowed @mut pointers are prevented dynamically
8134       * () has size 0
8135       * The name of the main function can be customized using #[main]
8136       * The default type of an inferred closure is &fn instead of @fn
8137       * `use` statements may no longer be "chained" - they cannot import
8138         identifiers imported by previous `use` statements
8139       * `use` statements are crate relative, importing from the "top"
8140         of the crate by default. Paths may be prefixed with `super::`
8141         or `self::` to change the search behavior.
8142       * Method visibility is inherited from the implementation declaration
8143       * Structural records have been removed
8144       * Many more types can be used in static items, including enums
8145         'static-lifetime pointers and vectors
8146       * Pattern matching over vectors improved and expanded
8147       * Typechecking of closure types has been overhauled to
8148         improve inference and eliminate unsoundness
8149       * Macros leave scope at the end of modules, unless that module is
8150         tagged with #[macro_escape]
8151
8152    * Libraries
8153       * Added big integers to `std::bigint`
8154       * Removed `core::oldcomm` module
8155       * Added pipe-based `core::comm` module
8156       * Numeric traits have been reorganized under `core::num`
8157       * `vec::slice` finally returns a slice
8158       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
8159       * Containers reorganized around traits in `core::container`
8160       * `core::dvec` removed, `~[T]` is a drop-in replacement
8161       * `core::send_map` renamed to `core::hashmap`
8162       * `std::map` removed; replaced with `core::hashmap`
8163       * `std::treemap` reimplemented as an owned balanced tree
8164       * `std::deque` and `std::smallintmap` reimplemented as owned containers
8165       * `core::trie` added as a fast ordered map for integer keys
8166       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
8167       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
8168         overload the comparison operators, whereas `TotalOrd` is used
8169         by certain container types
8170
8171    * Other
8172       * Replaced the 'cargo' package manager with 'rustpkg'
8173       * Added all-purpose 'rust' tool
8174       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
8175       * rustc now *attempts* to offer spelling suggestions
8176       * Improved support for ARM and Android
8177       * Preliminary MIPS backend
8178       * Improved foreign function ABI implementation for x86, x86_64
8179       * Various memory usage improvements
8180       * Rust code may be embedded in foreign code under limited circumstances
8181       * Inline assembler supported by new asm!() syntax extension.
8182
8183
8184 Version 0.5 (2012-12-21)
8185 ===========================
8186
8187    * ~900 changes, numerous bugfixes
8188
8189    * Syntax changes
8190       * Removed `<-` move operator
8191       * Completed the transition from the `#fmt` extension syntax to `fmt!`
8192       * Removed old fixed length vector syntax - `[T]/N`
8193       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
8194       * Macros may now expand to items and statements
8195       * `a.b()` is always parsed as a method call, never as a field projection
8196       * `Eq` and `IterBytes` implementations can be automatically generated
8197         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
8198       * Removed the special crate language for `.rc` files
8199       * Function arguments may consist of any irrefutable pattern
8200
8201    * Semantic changes
8202       * `&` and `~` pointers may point to objects
8203       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
8204       * Enum variants may be structs
8205       * Destructors can be added to all nominal types with the Drop trait
8206       * Structs and nullary enum variants may be constants
8207       * Values that cannot be implicitly copied are now automatically moved
8208         without writing `move` explicitly
8209       * `&T` may now be coerced to `*T`
8210       * Coercions happen in `let` statements as well as function calls
8211       * `use` statements now take crate-relative paths
8212       * The module and type namespaces have been merged so that static
8213         method names can be resolved under the trait in which they are
8214         declared
8215
8216    * Improved support for language features
8217       * Trait inheritance works in many scenarios
8218       * More support for explicit self arguments in methods - `self`, `&self`
8219         `@self`, and `~self` all generally work as expected
8220       * Static methods work in more situations
8221       * Experimental: Traits may declare default methods for the implementations
8222         to use
8223
8224    * Libraries
8225       * New condition handling system in `core::condition`
8226       * Timsort added to `std::sort`
8227       * New priority queue, `std::priority_queue`
8228       * Pipes for serializable types, `std::flatpipes'
8229       * Serialization overhauled to be trait-based
8230       * Expanded `getopts` definitions
8231       * Moved futures to `std`
8232       * More functions are pure now
8233       * `core::comm` renamed to `oldcomm`. Still deprecated
8234       * `rustdoc` and `cargo` are libraries now
8235
8236    * Misc
8237       * Added a preliminary REPL, `rusti`
8238       * License changed from MIT to dual MIT/APL2
8239
8240
8241 Version 0.4 (2012-10-15)
8242 ==========================
8243
8244    * ~2000 changes, numerous bugfixes
8245
8246    * Syntax
8247       * All keywords are now strict and may not be used as identifiers anywhere
8248       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
8249         'of', 'with', 'to', 'class'.
8250       * Classes are replaced with simpler structs
8251       * Explicit method self types
8252       * `ret` became `return` and `alt` became `match`
8253       * `import` is now `use`; `use is now `extern mod`
8254       * `extern mod { ... }` is now `extern { ... }`
8255       * `use mod` is the recommended way to import modules
8256       * `pub` and `priv` replace deprecated export lists
8257       * The syntax of `match` pattern arms now uses fat arrow (=>)
8258       * `main` no longer accepts an args vector; use `os::args` instead
8259
8260    * Semantics
8261       * Trait implementations are now coherent, ala Haskell typeclasses
8262       * Trait methods may be static
8263       * Argument modes are deprecated
8264       * Borrowed pointers are much more mature and recommended for use
8265       * Strings and vectors in the static region are stored in constant memory
8266       * Typestate was removed
8267       * Resolution rewritten to be more reliable
8268       * Support for 'dual-mode' data structures (freezing and thawing)
8269
8270    * Libraries
8271       * Most binary operators can now be overloaded via the traits in
8272         `core::ops'
8273       * `std::net::url` for representing URLs
8274       * Sendable hash maps in `core::send_map`
8275       * `core::task' gained a (currently unsafe) task-local storage API
8276
8277    * Concurrency
8278       * An efficient new intertask communication primitive called the pipe,
8279         along with a number of higher-level channel types, in `core::pipes`
8280       * `std::arc`, an atomically reference counted, immutable, shared memory
8281         type
8282       * `std::sync`, various exotic synchronization tools based on arcs and pipes
8283       * Futures are now based on pipes and sendable
8284       * More robust linked task failure
8285       * Improved task builder API
8286
8287    * Other
8288       * Improved error reporting
8289       * Preliminary JIT support
8290       * Preliminary work on precise GC
8291       * Extensive architectural improvements to rustc
8292       * Begun a transition away from buggy C++-based reflection (shape) code to
8293         Rust-based (visitor) code
8294       * All hash functions and tables converted to secure, randomized SipHash
8295
8296
8297 Version 0.3  (2012-07-12)
8298 ========================
8299
8300    * ~1900 changes, numerous bugfixes
8301
8302    * New coding conveniences
8303       * Integer-literal suffix inference
8304       * Per-item control over warnings, errors
8305       * #[cfg(windows)] and #[cfg(unix)] attributes
8306       * Documentation comments
8307       * More compact closure syntax
8308       * 'do' expressions for treating higher-order functions as
8309         control structures
8310       * *-patterns (wildcard extended to all constructor fields)
8311
8312    * Semantic cleanup
8313       * Name resolution pass and exhaustiveness checker rewritten
8314       * Region pointers and borrow checking supersede alias
8315         analysis
8316       * Init-ness checking is now provided by a region-based liveness
8317         pass instead of the typestate pass; same for last-use analysis
8318       * Extensive work on region pointers
8319
8320    * Experimental new language features
8321       * Slices and fixed-size, interior-allocated vectors
8322       * #!-comments for lang versioning, shell execution
8323       * Destructors and iface implementation for classes;
8324         type-parameterized classes and class methods
8325       * 'const' type kind for types that can be used to implement
8326         shared-memory concurrency patterns
8327
8328    * Type reflection
8329
8330    * Removal of various obsolete features
8331       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
8332                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
8333
8334       * Constructs: do-while loops ('do' repurposed), fn binding,
8335                     resources (replaced by destructors)
8336
8337    * Compiler reorganization
8338       * Syntax-layer of compiler split into separate crate
8339       * Clang (from LLVM project) integrated into build
8340       * Typechecker split into sub-modules
8341
8342    * New library code
8343       * New time functions
8344       * Extension methods for many built-in types
8345       * Arc: atomic-refcount read-only / exclusive-use shared cells
8346       * Par: parallel map and search routines
8347       * Extensive work on libuv interface
8348       * Much vector code moved to libraries
8349       * Syntax extensions: #line, #col, #file, #mod, #stringify,
8350         #include, #include_str, #include_bin
8351
8352    * Tool improvements
8353       * Cargo automatically resolves dependencies
8354
8355
8356 Version 0.2  (2012-03-29)
8357 =========================
8358
8359    * >1500 changes, numerous bugfixes
8360
8361    * New docs and doc tooling
8362
8363    * New port: FreeBSD x86_64
8364
8365    * Compilation model enhancements
8366       * Generics now specialized, multiply instantiated
8367       * Functions now inlined across separate crates
8368
8369    * Scheduling, stack and threading fixes
8370       * Noticeably improved message-passing performance
8371       * Explicit schedulers
8372       * Callbacks from C
8373       * Helgrind clean
8374
8375    * Experimental new language features
8376       * Operator overloading
8377       * Region pointers
8378       * Classes
8379
8380    * Various language extensions
8381       * C-callback function types: 'crust fn ...'
8382       * Infinite-loop construct: 'loop { ... }'
8383       * Shorten 'mutable' to 'mut'
8384       * Required mutable-local qualifier: 'let mut ...'
8385       * Basic glob-exporting: 'export foo::*;'
8386       * Alt now exhaustive, 'alt check' for runtime-checked
8387       * Block-function form of 'for' loop, with 'break' and 'ret'.
8388
8389    * New library code
8390       * AST quasi-quote syntax extension
8391       * Revived libuv interface
8392       * New modules: core::{future, iter}, std::arena
8393       * Merged per-platform std::{os*, fs*} to core::{libc, os}
8394       * Extensive cleanup, regularization in libstd, libcore
8395
8396
8397 Version 0.1  (2012-01-20)
8398 ===============================
8399
8400    * Most language features work, including:
8401       * Unique pointers, unique closures, move semantics
8402       * Interface-constrained generics
8403       * Static interface dispatch
8404       * Stack growth
8405       * Multithread task scheduling
8406       * Typestate predicates
8407       * Failure unwinding, destructors
8408       * Pattern matching and destructuring assignment
8409       * Lightweight block-lambda syntax
8410       * Preliminary macro-by-example
8411
8412    * Compiler works with the following configurations:
8413       * Linux: x86 and x86_64 hosts and targets
8414       * macOS: x86 and x86_64 hosts and targets
8415       * Windows: x86 hosts and targets
8416
8417    * Cross compilation / multi-target configuration supported.
8418
8419    * Preliminary API-documentation and package-management tools included.
8420
8421 Known issues:
8422
8423    * Documentation is incomplete.
8424
8425    * Performance is below intended target.
8426
8427    * Standard library APIs are subject to extensive change, reorganization.
8428
8429    * Language-level versioning is not yet operational - future code will
8430      break unexpectedly.