RELEASES.md

   1 Version 1.43.1 (2020-05-07)
   2 ===========================
   3
   4 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
   5 * [Fixed the stabilization of AVX-512 features.][71473]
   6 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
   7
   8 [71430]: https://github.com/rust-lang/rust/pull/71430
   9 [71473]: https://github.com/rust-lang/rust/issues/71473
  10 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
  11
  12
  13 Version 1.43.0 (2020-04-23)
  14 ==========================
  15
  16 Language
  17 --------
  18 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
  19   the type inferred correctly.][68129]
  20 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
  21
  22 **Syntax only changes**
  23 - [Allow `type Foo: Ord` syntactically.][69361]
  24 - [Fuse associated and extern items up to defaultness.][69194]
  25 - [Syntactically allow `self` in all `fn` contexts.][68764]
  26 - [Merge `fn` syntax + cleanup item parsing.][68728]
  27 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
  28   For example, you may now write:
  29   ```rust
  30   macro_rules! mac_trait {
  31       ($i:item) => {
  32           trait T { $i }
  33       }
  34   }
  35   mac_trait! {
  36       fn foo() {}
  37   }
  38   ```
  39
  40 These are still rejected *semantically*, so you will likely receive an error but
  41 these changes can be seen and parsed by macros and
  42 conditional compilation.
  43
  44
  45 Compiler
  46 --------
  47 - [You can now pass multiple lint flags to rustc to override the previous
  48   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
  49   everything in the `unused` lint group except `unused-variables` which
  50   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
  51   everything in the `unused` lint group **including** `unused-variables` since
  52   the allow flag is specified before the deny flag (and therefore overridden).
  53 - [rustc will now prefer your system MinGW libraries over its bundled libraries
  54   if they are available on `windows-gnu`.][67429]
  55 - [rustc now buffers errors/warnings printed in JSON.][69227]
  56
  57 Libraries
  58 ---------
  59 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
  60   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
  61   respectively.][69538] **Note** These conversions are only available when `N`
  62   is `0..=32`.
  63 - [You can now use associated constants on floats and integers directly, rather
  64   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
  65   `f32::NAN` with no imports.
  66 - [`u8::is_ascii` is now `const`.][68984]
  67 - [`String` now implements `AsMut<str>`.][68742]
  68 - [Added the `primitive` module to `std` and `core`.][67637] This module
  69   reexports Rust's primitive types. This is mainly useful in macros
  70   where you want avoid these types being shadowed.
  71 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
  72 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
  73
  74 Stabilized APIs
  75 ---------------
  76 - [`Once::is_completed`]
  77 - [`f32::LOG10_2`]
  78 - [`f32::LOG2_10`]
  79 - [`f64::LOG10_2`]
  80 - [`f64::LOG2_10`]
  81 - [`iter::once_with`]
  82
  83 Cargo
  84 -----
  85 - [You can now set config `[profile]`s in your `.cargo/config`, or through
  86   your environment.][cargo/7823]
  87 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
  88   executable path when running integration tests or benchmarks.][cargo/7697]
  89   `<name>` is the name of your binary as-is e.g. If you wanted the executable
  90   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
  91
  92 Misc
  93 ----
  94 - [Certain checks in the `const_err` lint were deemed unrelated to const
  95   evaluation][69185], and have been moved to the `unconditional_panic` and
  96   `arithmetic_overflow` lints.
  97
  98 Compatibility Notes
  99 -------------------
 100
 101 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
 102   has been a warning since 1.36.0.
 103 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
 104   led to some instances being accepted, and now correctly emits a hard error.
 105
 106 [69340]: https://github.com/rust-lang/rust/pull/69340
 107
 108 Internal Only
 109 -------------
 110 These changes provide no direct user facing benefits, but represent significant
 111 improvements to the internals and overall performance of `rustc` and
 112 related tools.
 113
 114 - [All components are now built with `opt-level=3` instead of `2`.][67878]
 115 - [Improved how rustc generates drop code.][67332]
 116 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
 117 - [traits: preallocate 2 Vecs of known initial size][69022]
 118 - [Avoid exponential behaviour when relating types][68772]
 119 - [Skip `Drop` terminators for enum variants without drop glue][68943]
 120 - [Improve performance of coherence checks][68966]
 121 - [Deduplicate types in the generator witness][68672]
 122 - [Invert control in struct_lint_level.][68725]
 123
 124 [67332]: https://github.com/rust-lang/rust/pull/67332/
 125 [67429]: https://github.com/rust-lang/rust/pull/67429/
 126 [67637]: https://github.com/rust-lang/rust/pull/67637/
 127 [67642]: https://github.com/rust-lang/rust/pull/67642/
 128 [67878]: https://github.com/rust-lang/rust/pull/67878/
 129 [67885]: https://github.com/rust-lang/rust/pull/67885/
 130 [68129]: https://github.com/rust-lang/rust/pull/68129/
 131 [68672]: https://github.com/rust-lang/rust/pull/68672/
 132 [68725]: https://github.com/rust-lang/rust/pull/68725/
 133 [68728]: https://github.com/rust-lang/rust/pull/68728/
 134 [68738]: https://github.com/rust-lang/rust/pull/68738/
 135 [68742]: https://github.com/rust-lang/rust/pull/68742/
 136 [68764]: https://github.com/rust-lang/rust/pull/68764/
 137 [68772]: https://github.com/rust-lang/rust/pull/68772/
 138 [68943]: https://github.com/rust-lang/rust/pull/68943/
 139 [68952]: https://github.com/rust-lang/rust/pull/68952/
 140 [68966]: https://github.com/rust-lang/rust/pull/68966/
 141 [68984]: https://github.com/rust-lang/rust/pull/68984/
 142 [69022]: https://github.com/rust-lang/rust/pull/69022/
 143 [69185]: https://github.com/rust-lang/rust/pull/69185/
 144 [69194]: https://github.com/rust-lang/rust/pull/69194/
 145 [69201]: https://github.com/rust-lang/rust/pull/69201/
 146 [69227]: https://github.com/rust-lang/rust/pull/69227/
 147 [69548]: https://github.com/rust-lang/rust/pull/69548/
 148 [69256]: https://github.com/rust-lang/rust/pull/69256/
 149 [69361]: https://github.com/rust-lang/rust/pull/69361/
 150 [69366]: https://github.com/rust-lang/rust/pull/69366/
 151 [69538]: https://github.com/rust-lang/rust/pull/69538/
 152 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
 153 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
 154 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
 155 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
 156 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
 157 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
 158 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
 159 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
 160
 161
 162 Version 1.42.0 (2020-03-12)
 163 ==========================
 164
 165 Language
 166 --------
 167 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
 168   ```rust
 169   fn foo(words: &[&str]) {
 170       match words {
 171           ["Hello", "World", "!", ..] => println!("Hello World!"),
 172           ["Foo", "Bar", ..] => println!("Baz"),
 173           rest => println!("{:?}", rest),
 174       }
 175   }
 176   ```
 177 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
 178   that you can create an enum that has the exact layout and ABI of the type
 179   it contains.
 180 - [There are some *syntax-only* changes:][67131]
 181    - `default` is syntactically allowed before items in `trait` definitions.
 182    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
 183      leave out their bodies in favor of `;`.
 184    - Bounds on associated types in `impl`s are now syntactically allowed
 185      (e.g. `type Foo: Ord;`).
 186    - `...` (the C-variadic type) may occur syntactically directly as the type of
 187       any function parameter.
 188
 189   These are still rejected *semantically*, so you will likely receive an error
 190   but these changes can be seen and parsed by procedural macros and
 191   conditional compilation.
 192
 193 Compiler
 194 --------
 195 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
 196 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
 197 - [`Option::{expect,unwrap}` and
 198    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
 199    pointing to the location where they were called, rather than
 200    `core`'s internals. ][67887]
 201
 202 \* Refer to Rust's [platform support page][forge-platform-support] for more
 203 information on Rust's tiered platform support.
 204
 205 Libraries
 206 ---------
 207 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
 208 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
 209    to implement `Sized`.][67935]
 210 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
 211 - [`Layout::new` is now `const`.][66254]
 212 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
 213
 214
 215 Stabilized APIs
 216 ---------------
 217 - [`CondVar::wait_while`]
 218 - [`CondVar::wait_timeout_while`]
 219 - [`DebugMap::key`]
 220 - [`DebugMap::value`]
 221 - [`ManuallyDrop::take`]
 222 - [`matches!`]
 223 - [`ptr::slice_from_raw_parts_mut`]
 224 - [`ptr::slice_from_raw_parts`]
 225
 226 Cargo
 227 -----
 228 - [You no longer need to include `extern crate proc_macro;` to be able to
 229   `use proc_macro;` in the `2018` edition.][cargo/7700]
 230
 231 Compatibility Notes
 232 -------------------
 233 - [`Error::description` has been deprecated, and its use will now produce a
 234   warning.][66919] It's recommended to use `Display`/`to_string` instead.
 235
 236 [68253]: https://github.com/rust-lang/rust/pull/68253/
 237 [68348]: https://github.com/rust-lang/rust/pull/68348/
 238 [67935]: https://github.com/rust-lang/rust/pull/67935/
 239 [68339]: https://github.com/rust-lang/rust/pull/68339/
 240 [68122]: https://github.com/rust-lang/rust/pull/68122/
 241 [67712]: https://github.com/rust-lang/rust/pull/67712/
 242 [67887]: https://github.com/rust-lang/rust/pull/67887/
 243 [67131]: https://github.com/rust-lang/rust/pull/67131/
 244 [67233]: https://github.com/rust-lang/rust/pull/67233/
 245 [66899]: https://github.com/rust-lang/rust/pull/66899/
 246 [66919]: https://github.com/rust-lang/rust/pull/66919/
 247 [66254]: https://github.com/rust-lang/rust/pull/66254/
 248 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
 249 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
 250 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
 251 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
 252 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
 253 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
 254 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
 255 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
 256 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
 257
 258
 259 Version 1.41.1 (2020-02-27)
 260 ===========================
 261
 262 * [Always check types of static items][69145]
 263 * [Always check lifetime bounds of `Copy` impls][69145]
 264 * [Fix miscompilation in callers of `Layout::repeat`][69225]
 265
 266 [69225]: https://github.com/rust-lang/rust/issues/69225
 267 [69145]: https://github.com/rust-lang/rust/pull/69145
 268
 269
 270 Version 1.41.0 (2020-01-30)
 271 ===========================
 272
 273 Language
 274 --------
 275
 276 - [You can now pass type parameters to foreign items when implementing
 277   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
 278 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
 279   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
 280   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
 281 - [You can now use any valid identifier in a `format_args` macro.][66847]
 282   Previously identifiers starting with an underscore were not allowed.
 283 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
 284   enum variants.][66183] These are still rejected semantically, but
 285   can be seen and parsed by procedural macros and conditional compilation.
 286
 287 Compiler
 288 --------
 289
 290 - [Rustc will now warn if you have unused loop `'label`s.][66325]
 291 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
 292 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
 293 - [You can now pass an arguments file passing the `@path` syntax
 294   to rustc.][66172] Note that the format differs somewhat from what is
 295   found in other tooling; please see [the documentation][argfile-docs] for
 296   more information.
 297 - [You can now provide `--extern` flag without a path, indicating that it is
 298   available from the search path or specified with an `-L` flag.][64882]
 299
 300 \* Refer to Rust's [platform support page][forge-platform-support] for more
 301 information on Rust's tiered platform support.
 302
 303 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
 304
 305 Libraries
 306 ---------
 307
 308 - [The `core::panic` module is now stable.][66771] It was already stable
 309   through `std`.
 310 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
 311   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
 312 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
 313
 314 Stabilized APIs
 315 ---------------
 316
 317 - [`Result::map_or`]
 318 - [`Result::map_or_else`]
 319 - [`std::rc::Weak::weak_count`]
 320 - [`std::rc::Weak::strong_count`]
 321 - [`std::sync::Weak::weak_count`]
 322 - [`std::sync::Weak::strong_count`]
 323
 324 Cargo
 325 -----
 326
 327 - [Cargo will now document all the private items for binary crates
 328   by default.][cargo/7593]
 329 - [`cargo-install` will now reinstall the package if it detects that it is out
 330   of date.][cargo/7560]
 331 - [Cargo.lock now uses a more git friendly format that should help to reduce
 332   merge conflicts.][cargo/7579]
 333 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
 334   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
 335   optimisation level to `2` for debug builds. You can also use
 336   `[profile.<profile>.build-override]` to override build scripts and
 337   their dependencies.
 338
 339 Misc
 340 ----
 341
 342 - [You can now specify `edition` in documentation code blocks to compile the block
 343   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
 344   should be compiled the 2018 edition of Rust.
 345 - [You can now provide custom themes to rustdoc with `--theme`, and check the
 346   current theme with `--check-theme`.][54733]
 347 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
 348
 349 Compatibility Notes
 350 -------------------
 351
 352 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
 353   Apple targets.][apple-32bit-drop] This means that the source code is still
 354   available to build, but the targets are no longer being tested and release
 355   binaries for those platforms will no longer be distributed by the Rust project.
 356   Please refer to the linked blog post for more information.
 357
 358 [54733]: https://github.com/rust-lang/rust/pull/54733/
 359 [61351]: https://github.com/rust-lang/rust/pull/61351/
 360 [67255]: https://github.com/rust-lang/rust/pull/67255/
 361 [66661]: https://github.com/rust-lang/rust/pull/66661/
 362 [66771]: https://github.com/rust-lang/rust/pull/66771/
 363 [66847]: https://github.com/rust-lang/rust/pull/66847/
 364 [66238]: https://github.com/rust-lang/rust/pull/66238/
 365 [66277]: https://github.com/rust-lang/rust/pull/66277/
 366 [66325]: https://github.com/rust-lang/rust/pull/66325/
 367 [66172]: https://github.com/rust-lang/rust/pull/66172/
 368 [66183]: https://github.com/rust-lang/rust/pull/66183/
 369 [65879]: https://github.com/rust-lang/rust/pull/65879/
 370 [65013]: https://github.com/rust-lang/rust/pull/65013/
 371 [64882]: https://github.com/rust-lang/rust/pull/64882/
 372 [64325]: https://github.com/rust-lang/rust/pull/64325/
 373 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
 374 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
 375 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
 376 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
 377 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
 378 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
 379 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
 380 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
 381 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
 382 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
 383 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
 384
 385 Version 1.40.0 (2019-12-19)
 386 ===========================
 387
 388 Language
 389 --------
 390 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
 391   `const` contexts.][65188] e.g.
 392
 393   ```rust
 394   pub struct Point(i32, i32);
 395
 396   const ORIGIN: Point = {
 397       let constructor = Point;
 398
 399       constructor(0, 0)
 400   };
 401   ```
 402
 403 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
 404   indicate that there may be variants or fields added in the future.][64639]
 405   For example this requires adding a wild-card branch (`_ => {}`) to any match
 406   statements on a non-exhaustive `enum`. [(RFC 2008)]
 407 - [You can now use function-like procedural macros in `extern` blocks and in
 408   type positions.][63931] e.g. `type Generated = macro!();`
 409 - [Function-like and attribute procedural macros can now emit
 410   `macro_rules!` items, so you can now have your macros generate macros.][64035]
 411 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
 412   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
 413   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
 414
 415 Compiler
 416 --------
 417 - [Added tier 3 support\* for the
 418   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
 419 - [Added tier 3 support for the
 420   `aarch64-unknown-none-softfloat` target.][64589]
 421 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
 422   `mips64el-unknown-linux-muslabi64` targets.][65843]
 423
 424 \* Refer to Rust's [platform support page][forge-platform-support] for more
 425   information on Rust's tiered platform support.
 426
 427 Libraries
 428 ---------
 429 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
 430
 431 Stabilized APIs
 432 ---------------
 433 - [`BTreeMap::get_key_value`]
 434 - [`HashMap::get_key_value`]
 435 - [`Option::as_deref_mut`]
 436 - [`Option::as_deref`]
 437 - [`Option::flatten`]
 438 - [`UdpSocket::peer_addr`]
 439 - [`f32::to_be_bytes`]
 440 - [`f32::to_le_bytes`]
 441 - [`f32::to_ne_bytes`]
 442 - [`f64::to_be_bytes`]
 443 - [`f64::to_le_bytes`]
 444 - [`f64::to_ne_bytes`]
 445 - [`f32::from_be_bytes`]
 446 - [`f32::from_le_bytes`]
 447 - [`f32::from_ne_bytes`]
 448 - [`f64::from_be_bytes`]
 449 - [`f64::from_le_bytes`]
 450 - [`f64::from_ne_bytes`]
 451 - [`mem::take`]
 452 - [`slice::repeat`]
 453 - [`todo!`]
 454
 455 Cargo
 456 -----
 457 - [Cargo will now always display warnings, rather than only on
 458   fresh builds.][cargo/7450]
 459 - [Feature flags (except `--all-features`) passed to a virtual workspace will
 460   now produce an error.][cargo/7507] Previously these flags were ignored.
 461 - [You can now publish `dev-dependencies` without including
 462   a `version`.][cargo/7333]
 463
 464 Misc
 465 ----
 466 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
 467   when running documentation tests with `rustdoc`.][63803]
 468
 469 Compatibility Notes
 470 -------------------
 471 - [As previously announced, any previous NLL warnings in the 2015 edition are
 472   now hard errors.][64221]
 473 - [The `include!` macro will now warn if it failed to include the
 474   entire file.][64284] The `include!` macro unintentionally only includes the
 475   first _expression_ in a file, and this can be unintuitive. This will become
 476   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
 477 - [Using `#[inline]` on function prototypes and consts now emits a warning under
 478   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
 479   or `extern` blocks now correctly emits a hard error.
 480
 481 [65294]: https://github.com/rust-lang/rust/pull/65294/
 482 [66103]: https://github.com/rust-lang/rust/pull/66103/
 483 [65843]: https://github.com/rust-lang/rust/pull/65843/
 484 [65188]: https://github.com/rust-lang/rust/pull/65188/
 485 [65092]: https://github.com/rust-lang/rust/pull/65092/
 486 [64589]: https://github.com/rust-lang/rust/pull/64589/
 487 [64639]: https://github.com/rust-lang/rust/pull/64639/
 488 [64221]: https://github.com/rust-lang/rust/pull/64221/
 489 [64284]: https://github.com/rust-lang/rust/pull/64284/
 490 [63931]: https://github.com/rust-lang/rust/pull/63931/
 491 [64035]: https://github.com/rust-lang/rust/pull/64035/
 492 [63674]: https://github.com/rust-lang/rust/pull/63674/
 493 [63803]: https://github.com/rust-lang/rust/pull/63803/
 494 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
 495 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
 496 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
 497 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
 498 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
 499 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
 500 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
 501 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
 502 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
 503 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
 504 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
 505 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
 506 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
 507 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
 508 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
 509 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
 510 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
 511 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
 512 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
 513 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
 514 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
 515 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
 516 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
 517 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
 518 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
 519 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
 520
 521
 522 Version 1.39.0 (2019-11-07)
 523 ===========================
 524
 525 Language
 526 --------
 527 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
 528   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
 529 - [You can now use certain attributes on function, closure, and function pointer
 530   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
 531   `deny`, `forbid` as well as inert helper attributes used by procedural macro
 532   attributes applied to items. e.g.
 533   ```rust
 534   fn len(
 535       #[cfg(windows)] slice: &[u16],
 536       #[cfg(not(windows))] slice: &[u8],
 537   ) -> usize {
 538       slice.len()
 539   }
 540   ```
 541 - [You can now take shared references to bind-by-move patterns in the `if` guards
 542   of `match` arms.][63118] e.g.
 543   ```rust
 544   fn main() {
 545       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
 546
 547       match array {
 548           nums
 549   //      ---- `nums` is bound by move.
 550               if nums.iter().sum::<u8>() == 10
 551   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
 552           => {
 553               drop(nums);
 554   //          ----------- Legal as `nums` was bound by move and so we have ownership.
 555           }
 556           _ => unreachable!(),
 557       }
 558   }
 559   ```
 560
 561
 562
 563 Compiler
 564 --------
 565 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
 566 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
 567 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
 568   **Note** Cargo currently doesn't use this feature. Refer to
 569   [cargo#7315][cargo/7315] to track this feature's progress.
 570 - [You can now pass `--show-output` argument to test binaries to print the
 571   output of successful tests.][62600]
 572
 573
 574 \* Refer to Rust's [platform support page][forge-platform-support] for more
 575 information on Rust's tiered platform support.
 576
 577 Libraries
 578 ---------
 579 - [`Vec::new` and `String::new` are now `const` functions.][64028]
 580 - [`LinkedList::new` is now a `const` function.][63684]
 581 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
 582 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
 583   now `const`.][63786]
 584
 585 Stabilized APIs
 586 ---------------
 587 - [`Pin::into_inner`]
 588 - [`Instant::checked_duration_since`]
 589 - [`Instant::saturating_duration_since`]
 590
 591 Cargo
 592 -----
 593 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
 594 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
 595   `--all` is now deprecated.
 596
 597 Misc
 598 ----
 599 - [You can now pass `-Clinker` to rustdoc to control the linker used
 600   for compiling doctests.][63834]
 601
 602 Compatibility Notes
 603 -------------------
 604 - [Code that was previously accepted by the old borrow checker, but rejected by
 605   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
 606   previously a warning, and will also become a hard error in the Rust 2015
 607   edition in the 1.40.0 release.
 608 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
 609   run tests.][63827] This should improve performance when running a large
 610   amount of doctests.
 611 - [The `try!` macro will now issue a deprecation warning.][62672] It is
 612   recommended to use the `?` operator instead.
 613 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
 614   returned `0.0`.
 615
 616 [62600]: https://github.com/rust-lang/rust/pull/62600/
 617 [62672]: https://github.com/rust-lang/rust/pull/62672/
 618 [63118]: https://github.com/rust-lang/rust/pull/63118/
 619 [63209]: https://github.com/rust-lang/rust/pull/63209/
 620 [63402]: https://github.com/rust-lang/rust/pull/63402/
 621 [63565]: https://github.com/rust-lang/rust/pull/63565/
 622 [63595]: https://github.com/rust-lang/rust/pull/63595/
 623 [63684]: https://github.com/rust-lang/rust/pull/63684/
 624 [63698]: https://github.com/rust-lang/rust/pull/63698/
 625 [63770]: https://github.com/rust-lang/rust/pull/63770/
 626 [63786]: https://github.com/rust-lang/rust/pull/63786/
 627 [63827]: https://github.com/rust-lang/rust/pull/63827/
 628 [63834]: https://github.com/rust-lang/rust/pull/63834/
 629 [63927]: https://github.com/rust-lang/rust/pull/63927/
 630 [63933]: https://github.com/rust-lang/rust/pull/63933/
 631 [63934]: https://github.com/rust-lang/rust/pull/63934/
 632 [63938]: https://github.com/rust-lang/rust/pull/63938/
 633 [63940]: https://github.com/rust-lang/rust/pull/63940/
 634 [63941]: https://github.com/rust-lang/rust/pull/63941/
 635 [63945]: https://github.com/rust-lang/rust/pull/63945/
 636 [64010]: https://github.com/rust-lang/rust/pull/64010/
 637 [64028]: https://github.com/rust-lang/rust/pull/64028/
 638 [64334]: https://github.com/rust-lang/rust/pull/64334/
 639 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
 640 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
 641 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
 642 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
 643 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
 644 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
 645
 646 Version 1.38.0 (2019-09-26)
 647 ==========================
 648
 649 Language
 650 --------
 651 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
 652 - [The `#[deprecated]` attribute can now be used on macros.][62042]
 653
 654 Compiler
 655 --------
 656 - [Added pipelined compilation support to `rustc`.][62766] This will
 657   improve compilation times in some cases. For further information please refer
 658   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
 659 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
 660   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
 661   `x86_64-uwp-windows-msvc` targets.][60260]
 662 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
 663   `armv7-unknown-linux-musleabi` targets.][63107]
 664 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
 665 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
 666
 667 \* Refer to Rust's [platform support page][forge-platform-support] for more
 668 information on Rust's tiered platform support.
 669
 670 Libraries
 671 ---------
 672 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
 673 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
 674   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
 675   is available at `std::clone::Clone`). This also makes all built-in macros
 676   available in `std`/`core` root. e.g. `std::include_bytes!`.
 677 - [`str::Chars` now implements `Debug`.][63000]
 678 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
 679 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
 680 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
 681 - [Added euclidean remainder and division operations (`div_euclid`,
 682   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
 683   `overflowing`, and `wrapping` versions are available for all
 684   integer primitives.
 685 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
 686   `PartialEq`.][61491]
 687 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
 688
 689 Stabilized APIs
 690 ---------------
 691 - [`<*const T>::cast`]
 692 - [`<*mut T>::cast`]
 693 - [`Duration::as_secs_f32`]
 694 - [`Duration::as_secs_f64`]
 695 - [`Duration::div_f32`]
 696 - [`Duration::div_f64`]
 697 - [`Duration::from_secs_f32`]
 698 - [`Duration::from_secs_f64`]
 699 - [`Duration::mul_f32`]
 700 - [`Duration::mul_f64`]
 701 - [`any::type_name`]
 702
 703 Cargo
 704 -----
 705 - [Added pipelined compilation support to `cargo`.][cargo/7143]
 706 - [You can now pass the `--features` option multiple times to enable
 707   multiple features.][cargo/7084]
 708
 709 Misc
 710 ----
 711 - [`rustc` will now warn about some incorrect uses of
 712   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
 713
 714 Compatibility Notes
 715 -------------------
 716 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
 717   1.38.0.
 718 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
 719   issues][62896] with certain crates such as libc.
 720
 721 [60260]: https://github.com/rust-lang/rust/pull/60260/
 722 [61457]: https://github.com/rust-lang/rust/pull/61457/
 723 [61491]: https://github.com/rust-lang/rust/pull/61491/
 724 [61884]: https://github.com/rust-lang/rust/pull/61884/
 725 [61953]: https://github.com/rust-lang/rust/pull/61953/
 726 [62042]: https://github.com/rust-lang/rust/pull/62042/
 727 [62528]: https://github.com/rust-lang/rust/pull/62528/
 728 [62583]: https://github.com/rust-lang/rust/pull/62583/
 729 [62735]: https://github.com/rust-lang/rust/pull/62735/
 730 [62766]: https://github.com/rust-lang/rust/pull/62766/
 731 [62784]: https://github.com/rust-lang/rust/pull/62784/
 732 [62785]: https://github.com/rust-lang/rust/issues/62785/
 733 [62814]: https://github.com/rust-lang/rust/pull/62814/
 734 [62896]: https://github.com/rust-lang/rust/issues/62896/
 735 [63000]: https://github.com/rust-lang/rust/pull/63000/
 736 [63056]: https://github.com/rust-lang/rust/pull/63056/
 737 [63107]: https://github.com/rust-lang/rust/pull/63107/
 738 [63346]: https://github.com/rust-lang/rust/pull/63346/
 739 [63421]: https://github.com/rust-lang/rust/pull/63421/
 740 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
 741 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
 742 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
 743 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
 744 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
 745 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
 746 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
 747 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
 748 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
 749 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
 750 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
 751 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
 752 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
 753 [forge-platform-support]: https://forge.rust-lang.org/platform-support.html
 754 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
 755
 756 Version 1.37.0 (2019-08-15)
 757 ==========================
 758
 759 Language
 760 --------
 761 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
 762   [`Box`][62228], or an [array][62235] and unused.
 763 - [You can now use the `cfg` and `cfg_attr` attributes on
 764   generic parameters.][61547]
 765 - [You can now use enum variants through type alias.][61682] e.g. You can
 766   write the following:
 767   ```rust
 768   type MyOption = Option<u8>;
 769
 770   fn increment_or_zero(x: MyOption) -> u8 {
 771       match x {
 772           MyOption::Some(y) => y + 1,
 773           MyOption::None => 0,
 774       }
 775   }
 776   ```
 777 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
 778   `const _: u32 = 5;`.
 779 - [You can now use `#[repr(align(X)]` on enums.][61229]
 780 - [The  `?` Kleene macro operator is now available in the
 781   2015 edition.][60932]
 782
 783 Compiler
 784 --------
 785 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
 786   and `-C profile-use` flags.][61268] For more information on how to use profile
 787   guided optimization, please refer to the [rustc book][rustc-book-pgo].
 788 - [The `rust-lldb` wrapper script should now work again.][61827]
 789
 790 Libraries
 791 ---------
 792 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
 793
 794 Stabilized APIs
 795 ---------------
 796 - [`BufReader::buffer`]
 797 - [`BufWriter::buffer`]
 798 - [`Cell::from_mut`]
 799 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
 800 - [`DoubleEndedIterator::nth_back`]
 801 - [`Option::xor`]
 802 - [`Wrapping::reverse_bits`]
 803 - [`i128::reverse_bits`]
 804 - [`i16::reverse_bits`]
 805 - [`i32::reverse_bits`]
 806 - [`i64::reverse_bits`]
 807 - [`i8::reverse_bits`]
 808 - [`isize::reverse_bits`]
 809 - [`slice::copy_within`]
 810 - [`u128::reverse_bits`]
 811 - [`u16::reverse_bits`]
 812 - [`u32::reverse_bits`]
 813 - [`u64::reverse_bits`]
 814 - [`u8::reverse_bits`]
 815 - [`usize::reverse_bits`]
 816
 817 Cargo
 818 -----
 819 - [`Cargo.lock` files are now included by default when publishing executable crates
 820   with executables.][cargo/7026]
 821 - [You can now specify `default-run="foo"` in `[package]` to specify the
 822   default executable to use for `cargo run`.][cargo/7056]
 823
 824 Misc
 825 ----
 826
 827 Compatibility Notes
 828 -------------------
 829 - [Using `...` for inclusive range patterns will now warn by default.][61342]
 830   Please transition your code to using the `..=` syntax for inclusive
 831   ranges instead.
 832 - [Using a trait object without the `dyn` will now warn by default.][61203]
 833   Please transition your code to use `dyn Trait` for trait objects instead.
 834
 835 [62228]: https://github.com/rust-lang/rust/pull/62228/
 836 [62235]: https://github.com/rust-lang/rust/pull/62235/
 837 [61802]: https://github.com/rust-lang/rust/pull/61802/
 838 [61827]: https://github.com/rust-lang/rust/pull/61827/
 839 [61547]: https://github.com/rust-lang/rust/pull/61547/
 840 [61682]: https://github.com/rust-lang/rust/pull/61682/
 841 [61268]: https://github.com/rust-lang/rust/pull/61268/
 842 [61342]: https://github.com/rust-lang/rust/pull/61342/
 843 [61347]: https://github.com/rust-lang/rust/pull/61347/
 844 [61100]: https://github.com/rust-lang/rust/pull/61100/
 845 [61203]: https://github.com/rust-lang/rust/pull/61203/
 846 [61229]: https://github.com/rust-lang/rust/pull/61229/
 847 [60932]: https://github.com/rust-lang/rust/pull/60932/
 848 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
 849 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
 850 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
 851 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
 852 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
 853 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
 854 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
 855 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
 856 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
 857 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
 858 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
 859 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
 860 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
 861 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
 862 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
 863 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
 864 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
 865 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
 866 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
 867 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
 868 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
 869 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
 870 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
 871 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
 872
 873
 874 Version 1.36.0 (2019-07-04)
 875 ==========================
 876
 877 Language
 878 --------
 879 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
 880 - [The order of traits in trait objects no longer affects the semantics of that
 881   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
 882   `dyn fmt::Debug + Send`, where this was previously not the case.
 883
 884 Libraries
 885 ---------
 886 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
 887 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
 888 - [`mem::needs_drop` is now available as a const fn.][60364]
 889 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
 890 - [`String` now implements `BorrowMut<str>`.][60404]
 891 - [`io::Cursor` now implements `Default`.][60234]
 892 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
 893 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
 894   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
 895   environment has access to heap memory allocation.
 896 - [`String` now implements `From<&String>`.][59825]
 897 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
 898   return a tuple of each argument when there is multiple arguments.
 899 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
 900   not used.][59648]
 901
 902 Stabilized APIs
 903 ---------------
 904 - [`VecDeque::rotate_left`]
 905 - [`VecDeque::rotate_right`]
 906 - [`Iterator::copied`]
 907 - [`io::IoSlice`]
 908 - [`io::IoSliceMut`]
 909 - [`Read::read_vectored`]
 910 - [`Write::write_vectored`]
 911 - [`str::as_mut_ptr`]
 912 - [`mem::MaybeUninit`]
 913 - [`pointer::align_offset`]
 914 - [`future::Future`]
 915 - [`task::Context`]
 916 - [`task::RawWaker`]
 917 - [`task::RawWakerVTable`]
 918 - [`task::Waker`]
 919 - [`task::Poll`]
 920
 921 Cargo
 922 -----
 923 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
 924 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
 925
 926 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
 927
 928 Clippy
 929 ------
 930 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
 931
 932 Misc
 933 ----
 934
 935 Compatibility Notes
 936 -------------------
 937 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
 938   longer recommended, and will be deprecated in 1.39.0.
 939
 940 [60318]: https://github.com/rust-lang/rust/pull/60318/
 941 [60364]: https://github.com/rust-lang/rust/pull/60364/
 942 [60370]: https://github.com/rust-lang/rust/pull/60370/
 943 [60404]: https://github.com/rust-lang/rust/pull/60404/
 944 [60234]: https://github.com/rust-lang/rust/pull/60234/
 945 [60244]: https://github.com/rust-lang/rust/pull/60244/
 946 [58623]: https://github.com/rust-lang/rust/pull/58623/
 947 [59648]: https://github.com/rust-lang/rust/pull/59648/
 948 [59675]: https://github.com/rust-lang/rust/pull/59675/
 949 [59825]: https://github.com/rust-lang/rust/pull/59825/
 950 [59826]: https://github.com/rust-lang/rust/pull/59826/
 951 [59445]: https://github.com/rust-lang/rust/pull/59445/
 952 [59114]: https://github.com/rust-lang/rust/pull/59114/
 953 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
 954 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
 955 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
 956 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
 957 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
 958 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
 959 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
 960 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
 961 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
 962 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
 963 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
 964 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
 965 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
 966 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
 967 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
 968 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
 969 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
 970 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
 971 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
 972 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
 973
 974
 975 Version 1.35.0 (2019-05-23)
 976 ==========================
 977
 978 Language
 979 --------
 980 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
 981   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
 982 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
 983   ```rust
 984   unsafe fn call_unsafe(func: unsafe fn()) {
 985       func()
 986   }
 987
 988   pub fn main() {
 989       unsafe { call_unsafe(|| {}); }
 990   }
 991   ```
 992
 993
 994 Compiler
 995 --------
 996 - [Added the `armv6-unknown-freebsd-gnueabihf` and
 997   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
 998 - [Added the `wasm32-unknown-wasi` target.][59464]
 999
1000
1001 Libraries
1002 ---------
1003 - [`Thread` will now show its ID in `Debug` output.][59460]
1004 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
1005 - [`alloc::System` now implements `Default`.][59451]
1006 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
1007   last field.][59076]
1008 - [`char::{ToLowercase, ToUppercase}` now
1009   implement `ExactSizeIterator`.][58778]
1010 - [All `NonZero` numeric types now implement `FromStr`.][58717]
1011 - [Removed the `Read` trait bounds
1012   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
1013 - [You can now call the `dbg!` macro without any parameters to print the file
1014   and line where it is called.][57847]
1015 - [In place ASCII case conversions are now up to 4× faster.][59283]
1016   e.g. `str::make_ascii_lowercase`
1017 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
1018   and `Send`.][58369]
1019
1020 Stabilized APIs
1021 ---------------
1022 - [`f32::copysign`]
1023 - [`f64::copysign`]
1024 - [`RefCell::replace_with`]
1025 - [`RefCell::map_split`]
1026 - [`ptr::hash`]
1027 - [`Range::contains`]
1028 - [`RangeFrom::contains`]
1029 - [`RangeTo::contains`]
1030 - [`RangeInclusive::contains`]
1031 - [`RangeToInclusive::contains`]
1032 - [`Option::copied`]
1033
1034 Cargo
1035 -----
1036 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
1037   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
1038   platform specific.
1039
1040 Misc
1041 ----
1042 - [The Rust toolchain is now available natively for musl based distros.][58575]
1043
1044 [59460]: https://github.com/rust-lang/rust/pull/59460/
1045 [59464]: https://github.com/rust-lang/rust/pull/59464/
1046 [59500]: https://github.com/rust-lang/rust/pull/59500/
1047 [59512]: https://github.com/rust-lang/rust/pull/59512/
1048 [59580]: https://github.com/rust-lang/rust/pull/59580/
1049 [59283]: https://github.com/rust-lang/rust/pull/59283/
1050 [59451]: https://github.com/rust-lang/rust/pull/59451/
1051 [59076]: https://github.com/rust-lang/rust/pull/59076/
1052 [58778]: https://github.com/rust-lang/rust/pull/58778/
1053 [58717]: https://github.com/rust-lang/rust/pull/58717/
1054 [58369]: https://github.com/rust-lang/rust/pull/58369/
1055 [58423]: https://github.com/rust-lang/rust/pull/58423/
1056 [58080]: https://github.com/rust-lang/rust/pull/58080/
1057 [57847]: https://github.com/rust-lang/rust/pull/57847/
1058 [58575]: https://github.com/rust-lang/rust/pull/58575
1059 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
1060 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
1061 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
1062 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
1063 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
1064 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
1065 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
1066 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
1067 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
1068 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
1069 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
1070 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
1071
1072 Version 1.34.2 (2019-05-14)
1073 ===========================
1074
1075 * [Destabilize the `Error::type_id` function due to a security
1076    vulnerability][60785] ([CVE-2019-12083])
1077
1078 [60785]: https://github.com/rust-lang/rust/pull/60785
1079 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
1080
1081 Version 1.34.1 (2019-04-25)
1082 ===========================
1083
1084 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
1085 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
1086 * [Fix Clippy panic when checking some macros][clippy/3805]
1087
1088 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
1089 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
1090 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
1091
1092 Version 1.34.0 (2019-04-11)
1093 ==========================
1094
1095 Language
1096 --------
1097 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
1098   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
1099   but had no effect.
1100 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
1101   `#[attr{}]` procedural macros.][57367]
1102 - [You can now write `extern crate self as foo;`][57407] to import your
1103   crate's root into the extern prelude.
1104
1105
1106 Compiler
1107 --------
1108 - [You can now target `riscv64imac-unknown-none-elf` and
1109   `riscv64gc-unknown-none-elf`.][58406]
1110 - [You can now enable linker plugin LTO optimisations with
1111   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
1112   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
1113   boundaries.
1114 - [You can now target `powerpc64-unknown-freebsd`.][57809]
1115
1116
1117 Libraries
1118 ---------
1119 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
1120   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
1121   the `Hash` trait to create an iterator.
1122 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
1123   methods.][58421] Most notably you no longer require the `Ord` trait to create
1124   an iterator.
1125 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
1126   for all numeric types.][58044]
1127 - [Indexing a `str` is now generic over all types that
1128   implement `SliceIndex<str>`.][57604]
1129 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
1130   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
1131   produce a warning if their returning type is unused.
1132 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
1133   `overflowing_pow` are now available for all numeric types.][57873] These are
1134   equivalent to methods such as `wrapping_add` for the `pow` operation.
1135
1136
1137 Stabilized APIs
1138 ---------------
1139
1140 #### std & core
1141 * [`Any::type_id`]
1142 * [`Error::type_id`]
1143 * [`atomic::AtomicI16`]
1144 * [`atomic::AtomicI32`]
1145 * [`atomic::AtomicI64`]
1146 * [`atomic::AtomicI8`]
1147 * [`atomic::AtomicU16`]
1148 * [`atomic::AtomicU32`]
1149 * [`atomic::AtomicU64`]
1150 * [`atomic::AtomicU8`]
1151 * [`convert::Infallible`]
1152 * [`convert::TryFrom`]
1153 * [`convert::TryInto`]
1154 * [`iter::from_fn`]
1155 * [`iter::successors`]
1156 * [`num::NonZeroI128`]
1157 * [`num::NonZeroI16`]
1158 * [`num::NonZeroI32`]
1159 * [`num::NonZeroI64`]
1160 * [`num::NonZeroI8`]
1161 * [`num::NonZeroIsize`]
1162 * [`slice::sort_by_cached_key`]
1163 * [`str::escape_debug`]
1164 * [`str::escape_default`]
1165 * [`str::escape_unicode`]
1166 * [`str::split_ascii_whitespace`]
1167
1168 #### std
1169 * [`Instant::checked_add`]
1170 * [`Instant::checked_sub`]
1171 * [`SystemTime::checked_add`]
1172 * [`SystemTime::checked_sub`]
1173
1174 Cargo
1175 -----
1176 - [You can now use alternative registries to crates.io.][cargo/6654]
1177
1178 Misc
1179 ----
1180 - [You can now use the `?` operator in your documentation tests without manually
1181   adding `fn main() -> Result<(), _> {}`.][56470]
1182
1183 Compatibility Notes
1184 -------------------
1185 - [`Command::before_exec` is being replaced by the unsafe method
1186   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
1187 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
1188   can now use `const` functions in `static` variables.
1189
1190 [58370]: https://github.com/rust-lang/rust/pull/58370/
1191 [58406]: https://github.com/rust-lang/rust/pull/58406/
1192 [58421]: https://github.com/rust-lang/rust/pull/58421/
1193 [58166]: https://github.com/rust-lang/rust/pull/58166/
1194 [58044]: https://github.com/rust-lang/rust/pull/58044/
1195 [58057]: https://github.com/rust-lang/rust/pull/58057/
1196 [58059]: https://github.com/rust-lang/rust/pull/58059/
1197 [57809]: https://github.com/rust-lang/rust/pull/57809/
1198 [57873]: https://github.com/rust-lang/rust/pull/57873/
1199 [57604]: https://github.com/rust-lang/rust/pull/57604/
1200 [57367]: https://github.com/rust-lang/rust/pull/57367/
1201 [57407]: https://github.com/rust-lang/rust/pull/57407/
1202 [57425]: https://github.com/rust-lang/rust/pull/57425/
1203 [57106]: https://github.com/rust-lang/rust/pull/57106/
1204 [56470]: https://github.com/rust-lang/rust/pull/56470/
1205 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
1206 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
1207 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
1208 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
1209 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
1210 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
1211 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
1212 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
1213 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
1214 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
1215 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
1216 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
1217 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
1218 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
1219 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
1220 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
1221 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
1222 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
1223 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
1224 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
1225 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
1226 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
1227 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
1228 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
1229 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
1230 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
1231 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
1232 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
1233 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
1234 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
1235 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
1236
1237
1238 Version 1.33.0 (2019-02-28)
1239 ==========================
1240
1241 Language
1242 --------
1243 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
1244   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
1245 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
1246   E.g. You can have match statement on a `u8` that covers `0..=255` and
1247   you would no longer be required to have a `_ => unreachable!()` case.
1248 - [You can now have multiple patterns in `if let` and `while let`
1249   expressions.][57532] You can do this with the same syntax as a `match`
1250   expression. E.g.
1251   ```rust
1252   enum Creature {
1253       Crab(String),
1254       Lobster(String),
1255       Person(String),
1256   }
1257
1258   fn main() {
1259       let state = Creature::Crab("Ferris");
1260
1261       if let Creature::Crab(name) | Creature::Person(name) = state {
1262           println!("This creature's name is: {}", name);
1263       }
1264   }
1265   ```
1266 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
1267   this feature will by default produce a warning as this behaviour can be
1268   unintuitive. E.g. `if let _ = 5 {}`
1269 - [You can now use `let` bindings, assignments, expression statements,
1270   and irrefutable pattern destructuring in const functions.][57175]
1271 - [You can now call unsafe const functions.][57067] E.g.
1272   ```rust
1273   const unsafe fn foo() -> i32 { 5 }
1274   const fn bar() -> i32 {
1275       unsafe { foo() }
1276   }
1277   ```
1278 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
1279   E.g. `#[cfg_attr(all(), must_use, optimize)]`
1280 - [You can now specify a specific alignment with the `#[repr(packed)]`
1281   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
1282   with an alignment of 2 bytes and a size of 6 bytes.
1283 - [You can now import an item from a module as an `_`.][56303] This allows you to
1284   import a trait's impls, and not have the name in the namespace. E.g.
1285   ```rust
1286   use std::io::Read as _;
1287
1288   // Allowed as there is only one `Read` in the module.
1289   pub trait Read {}
1290   ```
1291 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
1292
1293 Compiler
1294 --------
1295 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
1296   command line argument.][56351]
1297 - [The minimum required LLVM version has been bumped to 6.0.][56642]
1298 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
1299 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
1300   tier 2 support.][57130] Visit the [platform support][platform-support] page for
1301   information on Rust's platform support.
1302 - [Added support for the `thumbv7neon-linux-androideabi` and
1303   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
1304 - [Added support for the `x86_64-unknown-uefi` target.][56769]
1305
1306 Libraries
1307 ---------
1308 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
1309   functions for all numeric types.][57566]
1310 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
1311   are now `const` functions for all numeric types.][57105]
1312 - [The methods `is_positive` and `is_negative` are now `const` functions for
1313   all signed numeric types.][57105]
1314 - [The `get` method for all `NonZero` types is now `const`.][57167]
1315 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
1316   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
1317   numeric types.][57234]
1318 - [`Ipv4Addr::new` is now a `const` function][57234]
1319
1320 Stabilized APIs
1321 ---------------
1322 - [`unix::FileExt::read_exact_at`]
1323 - [`unix::FileExt::write_all_at`]
1324 - [`Option::transpose`]
1325 - [`Result::transpose`]
1326 - [`convert::identity`]
1327 - [`pin::Pin`]
1328 - [`marker::Unpin`]
1329 - [`marker::PhantomPinned`]
1330 - [`Vec::resize_with`]
1331 - [`VecDeque::resize_with`]
1332 - [`Duration::as_millis`]
1333 - [`Duration::as_micros`]
1334 - [`Duration::as_nanos`]
1335
1336
1337 Cargo
1338 -----
1339 - [You can now publish crates that require a feature flag to compile with
1340   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
1341 - [Cargo should now rebuild a crate if a file was modified during the initial
1342   build.][cargo/6484]
1343
1344 Compatibility Notes
1345 -------------------
1346 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
1347   are now deprecated in the standard library, and their usage will now produce a warning.
1348   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
1349   methods instead.
1350 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
1351   downcasting.
1352 - [Libtest no longer creates a new thread for each test when
1353   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
1354
1355 [55982]: https://github.com/rust-lang/rust/pull/55982/
1356 [56243]: https://github.com/rust-lang/rust/pull/56243
1357 [56303]: https://github.com/rust-lang/rust/pull/56303/
1358 [56351]: https://github.com/rust-lang/rust/pull/56351/
1359 [56362]: https://github.com/rust-lang/rust/pull/56362
1360 [56642]: https://github.com/rust-lang/rust/pull/56642/
1361 [56769]: https://github.com/rust-lang/rust/pull/56769/
1362 [56805]: https://github.com/rust-lang/rust/pull/56805
1363 [56947]: https://github.com/rust-lang/rust/pull/56947/
1364 [57049]: https://github.com/rust-lang/rust/pull/57049/
1365 [57067]: https://github.com/rust-lang/rust/pull/57067/
1366 [57105]: https://github.com/rust-lang/rust/pull/57105
1367 [57130]: https://github.com/rust-lang/rust/pull/57130/
1368 [57167]: https://github.com/rust-lang/rust/pull/57167/
1369 [57175]: https://github.com/rust-lang/rust/pull/57175/
1370 [57234]: https://github.com/rust-lang/rust/pull/57234/
1371 [57332]: https://github.com/rust-lang/rust/pull/57332/
1372 [57465]: https://github.com/rust-lang/rust/pull/57465/
1373 [57532]: https://github.com/rust-lang/rust/pull/57532/
1374 [57535]: https://github.com/rust-lang/rust/pull/57535/
1375 [57566]: https://github.com/rust-lang/rust/pull/57566/
1376 [57615]: https://github.com/rust-lang/rust/pull/57615/
1377 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
1378 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
1379 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
1380 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
1381 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
1382 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
1383 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
1384 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
1385 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
1386 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
1387 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
1388 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
1389 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
1390 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
1391 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
1392 [platform-support]: https://forge.rust-lang.org/platform-support.html
1393
1394 Version 1.32.0 (2019-01-17)
1395 ==========================
1396
1397 Language
1398 --------
1399 #### 2018 edition
1400 - [You can now use the `?` operator in macro definitions.][56245] The `?`
1401   operator allows you to specify zero or one repetitions similar to the `*` and
1402   `+` operators.
1403 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
1404   now always resolve to the item (`enum`, `struct`, etc.) available in the
1405   module if present, before resolving to a external crate or an item the prelude.][56759]
1406   E.g.
1407   ```rust
1408   enum Color { Red, Green, Blue }
1409
1410   use Color::*;
1411   ```
1412
1413 #### All editions
1414 - [You can now match against `PhantomData<T>` types.][55837]
1415 - [You can now match against literals in macros with the `literal`
1416   specifier.][56072] This will match against a literal of any type.
1417   E.g. `1`, `'A'`, `"Hello World"`
1418 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
1419   ```rust
1420   struct Point(i32, i32);
1421
1422   impl Point {
1423       pub fn new(x: i32, y: i32) -> Self {
1424           Self(x, y)
1425       }
1426
1427       pub fn is_origin(&self) -> bool {
1428           match self {
1429               Self(0, 0) => true,
1430               _ => false,
1431           }
1432       }
1433   }
1434   ```
1435 - [Self can also now be used in type definitions.][56366] E.g.
1436   ```rust
1437   enum List<T>
1438   where
1439       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
1440   {
1441       Nil,
1442       Cons(T, Box<Self>) // likewise here
1443   }
1444   ```
1445 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
1446   a `impl Trait` or `dyn Trait` is returned and unused in the program.
1447
1448 Compiler
1449 --------
1450 - [The default allocator has changed from jemalloc to the default allocator on
1451   your system.][55238] The compiler itself on Linux & macOS will still use
1452   jemalloc, but programs compiled with it will use the system allocator.
1453 - [Added the `aarch64-pc-windows-msvc` target.][55702]
1454
1455 Libraries
1456 ---------
1457 - [`PathBuf` now implements `FromStr`.][55148]
1458 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
1459 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
1460   easily debug expressions in your rust program. E.g.
1461   ```rust
1462   let a = 2;
1463   let b = dbg!(a * 2) + 1;
1464   //      ^-- prints: [src/main.rs:4] a * 2 = 4
1465   assert_eq!(b, 5);
1466   ```
1467
1468 The following APIs are now `const` functions and can be used in a
1469 `const` context.
1470
1471 - [`Cell::as_ptr`]
1472 - [`UnsafeCell::get`]
1473 - [`char::is_ascii`]
1474 - [`iter::empty`]
1475 - [`ManuallyDrop::new`]
1476 - [`ManuallyDrop::into_inner`]
1477 - [`RangeInclusive::start`]
1478 - [`RangeInclusive::end`]
1479 - [`NonNull::as_ptr`]
1480 - [`slice::as_ptr`]
1481 - [`str::as_ptr`]
1482 - [`Duration::as_secs`]
1483 - [`Duration::subsec_millis`]
1484 - [`Duration::subsec_micros`]
1485 - [`Duration::subsec_nanos`]
1486 - [`CStr::as_ptr`]
1487 - [`Ipv4Addr::is_unspecified`]
1488 - [`Ipv6Addr::new`]
1489 - [`Ipv6Addr::octets`]
1490
1491 Stabilized APIs
1492 ---------------
1493 - [`i8::to_be_bytes`]
1494 - [`i8::to_le_bytes`]
1495 - [`i8::to_ne_bytes`]
1496 - [`i8::from_be_bytes`]
1497 - [`i8::from_le_bytes`]
1498 - [`i8::from_ne_bytes`]
1499 - [`i16::to_be_bytes`]
1500 - [`i16::to_le_bytes`]
1501 - [`i16::to_ne_bytes`]
1502 - [`i16::from_be_bytes`]
1503 - [`i16::from_le_bytes`]
1504 - [`i16::from_ne_bytes`]
1505 - [`i32::to_be_bytes`]
1506 - [`i32::to_le_bytes`]
1507 - [`i32::to_ne_bytes`]
1508 - [`i32::from_be_bytes`]
1509 - [`i32::from_le_bytes`]
1510 - [`i32::from_ne_bytes`]
1511 - [`i64::to_be_bytes`]
1512 - [`i64::to_le_bytes`]
1513 - [`i64::to_ne_bytes`]
1514 - [`i64::from_be_bytes`]
1515 - [`i64::from_le_bytes`]
1516 - [`i64::from_ne_bytes`]
1517 - [`i128::to_be_bytes`]
1518 - [`i128::to_le_bytes`]
1519 - [`i128::to_ne_bytes`]
1520 - [`i128::from_be_bytes`]
1521 - [`i128::from_le_bytes`]
1522 - [`i128::from_ne_bytes`]
1523 - [`isize::to_be_bytes`]
1524 - [`isize::to_le_bytes`]
1525 - [`isize::to_ne_bytes`]
1526 - [`isize::from_be_bytes`]
1527 - [`isize::from_le_bytes`]
1528 - [`isize::from_ne_bytes`]
1529 - [`u8::to_be_bytes`]
1530 - [`u8::to_le_bytes`]
1531 - [`u8::to_ne_bytes`]
1532 - [`u8::from_be_bytes`]
1533 - [`u8::from_le_bytes`]
1534 - [`u8::from_ne_bytes`]
1535 - [`u16::to_be_bytes`]
1536 - [`u16::to_le_bytes`]
1537 - [`u16::to_ne_bytes`]
1538 - [`u16::from_be_bytes`]
1539 - [`u16::from_le_bytes`]
1540 - [`u16::from_ne_bytes`]
1541 - [`u32::to_be_bytes`]
1542 - [`u32::to_le_bytes`]
1543 - [`u32::to_ne_bytes`]
1544 - [`u32::from_be_bytes`]
1545 - [`u32::from_le_bytes`]
1546 - [`u32::from_ne_bytes`]
1547 - [`u64::to_be_bytes`]
1548 - [`u64::to_le_bytes`]
1549 - [`u64::to_ne_bytes`]
1550 - [`u64::from_be_bytes`]
1551 - [`u64::from_le_bytes`]
1552 - [`u64::from_ne_bytes`]
1553 - [`u128::to_be_bytes`]
1554 - [`u128::to_le_bytes`]
1555 - [`u128::to_ne_bytes`]
1556 - [`u128::from_be_bytes`]
1557 - [`u128::from_le_bytes`]
1558 - [`u128::from_ne_bytes`]
1559 - [`usize::to_be_bytes`]
1560 - [`usize::to_le_bytes`]
1561 - [`usize::to_ne_bytes`]
1562 - [`usize::from_be_bytes`]
1563 - [`usize::from_le_bytes`]
1564 - [`usize::from_ne_bytes`]
1565
1566 Cargo
1567 -----
1568 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
1569 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
1570
1571 Misc
1572 ----
1573 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
1574
1575 Compatibility Notes
1576 -------------------
1577 - [The argument types for AVX's
1578   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
1579   been changed from `*const` to `*mut` as the previous implementation
1580   was unsound.
1581
1582
1583 [55148]: https://github.com/rust-lang/rust/pull/55148/
1584 [55238]: https://github.com/rust-lang/rust/pull/55238/
1585 [55280]: https://github.com/rust-lang/rust/pull/55280/
1586 [55610]: https://github.com/rust-lang/rust/pull/55610/
1587 [55663]: https://github.com/rust-lang/rust/pull/55663/
1588 [55702]: https://github.com/rust-lang/rust/pull/55702/
1589 [55837]: https://github.com/rust-lang/rust/pull/55837/
1590 [55843]: https://github.com/rust-lang/rust/pull/55843/
1591 [56072]: https://github.com/rust-lang/rust/pull/56072/
1592 [56245]: https://github.com/rust-lang/rust/pull/56245/
1593 [56365]: https://github.com/rust-lang/rust/pull/56365/
1594 [56366]: https://github.com/rust-lang/rust/pull/56366/
1595 [56395]: https://github.com/rust-lang/rust/pull/56395/
1596 [56759]: https://github.com/rust-lang/rust/pull/56759/
1597 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
1598 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
1599 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
1600 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
1601 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
1602 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1603 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1604 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
1605 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
1606 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
1607 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
1608 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
1609 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
1610 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
1611 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
1612 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
1613 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
1614 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
1615 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
1616 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
1617 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
1618 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
1619 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
1620 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
1621 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
1622 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
1623 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
1624 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
1625 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
1626 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
1627 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
1628 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
1629 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
1630 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
1631 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
1632 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
1633 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
1634 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
1635 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
1636 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
1637 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
1638 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
1639 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
1640 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
1641 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
1642 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
1643 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
1644 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
1645 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
1646 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
1647 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
1648 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
1649 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
1650 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
1651 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
1652 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
1653 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
1654 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
1655 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
1656 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
1657 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
1658 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
1659 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
1660 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
1661 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
1662 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
1663 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
1664 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
1665 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
1666 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
1667 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
1668 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
1669 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
1670 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
1671 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
1672 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
1673 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
1674 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
1675 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
1676 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
1677 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
1678 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
1679 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
1680 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
1681 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
1682 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
1683 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
1684 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
1685 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
1686 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
1687 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
1688 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
1689 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
1690
1691
1692 Version 1.31.1 (2018-12-20)
1693 ===========================
1694
1695 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
1696 - [Fix broken go-to-definition in RLS][rls/1171]
1697 - [Fix infinite loop on hover in RLS][rls/1170]
1698
1699 [56562]: https://github.com/rust-lang/rust/pull/56562
1700 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
1701 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
1702
1703 Version 1.31.0 (2018-12-06)
1704 ==========================
1705
1706 Language
1707 --------
1708 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
1709 - [New lifetime elision rules now allow for eliding lifetimes in functions and
1710   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
1711   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
1712   in structs.
1713 - [You can now define and use `const` functions.][54835] These are currently
1714   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
1715   [language reference][const-reference] for what exactly is available.
1716 - [You can now use tool lints, which allow you to scope lints from external
1717   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
1718 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
1719   a crate, not just in exported functions.][54451]
1720 - [You can now use parentheses in pattern matches.][54497]
1721
1722 Compiler
1723 --------
1724 - [Updated musl to 1.1.20][54430]
1725
1726 Libraries
1727 ---------
1728 - [You can now convert `num::NonZero*` types to their raw equivalents using the
1729   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
1730 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
1731   into `Option<&mut T>` using the `From` trait.][53218]
1732 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
1733
1734
1735 Stabilized APIs
1736 ---------------
1737 - [`slice::align_to`]
1738 - [`slice::align_to_mut`]
1739 - [`slice::chunks_exact`]
1740 - [`slice::chunks_exact_mut`]
1741 - [`slice::rchunks`]
1742 - [`slice::rchunks_mut`]
1743 - [`slice::rchunks_exact`]
1744 - [`slice::rchunks_exact_mut`]
1745 - [`Option::replace`]
1746
1747 Cargo
1748 -----
1749 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
1750 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
1751   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
1752
1753 [52813]: https://github.com/rust-lang/rust/pull/52813/
1754 [53218]: https://github.com/rust-lang/rust/pull/53218/
1755 [53555]: https://github.com/rust-lang/rust/issues/53555/
1756 [54057]: https://github.com/rust-lang/rust/pull/54057/
1757 [54240]: https://github.com/rust-lang/rust/pull/54240/
1758 [54430]: https://github.com/rust-lang/rust/pull/54430/
1759 [54451]: https://github.com/rust-lang/rust/pull/54451/
1760 [54497]: https://github.com/rust-lang/rust/pull/54497/
1761 [54778]: https://github.com/rust-lang/rust/pull/54778/
1762 [54835]: https://github.com/rust-lang/rust/pull/54835/
1763 [54870]: https://github.com/rust-lang/rust/pull/54870/
1764 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
1765 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
1766 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
1767 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
1768 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
1769 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
1770 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1771 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
1772 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1773 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
1774 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
1775 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
1776 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
1777 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
1778
1779 Version 1.30.1 (2018-11-08)
1780 ===========================
1781
1782 - [Fixed overflow ICE in rustdoc][54199]
1783 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
1784
1785 [54199]: https://github.com/rust-lang/rust/pull/54199
1786 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
1787
1788 Version 1.30.0 (2018-10-25)
1789 ==========================
1790
1791 Language
1792 --------
1793 - [Procedural macros are now available.][52081] These kinds of macros allow for
1794   more powerful code generation. There is a [new chapter available][proc-macros]
1795   in the Rust Programming Language book that goes further in depth.
1796 - [You can now use keywords as identifiers using the raw identifiers
1797   syntax (`r#`),][53236] e.g. `let r#for = true;`
1798 - [Using anonymous parameters in traits is now deprecated with a warning and
1799   will be a hard error in the 2018 edition.][53272]
1800 - [You can now use `crate` in paths.][54404] This allows you to refer to the
1801   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
1802 - [Using a external crate no longer requires being prefixed with `::`.][54404]
1803   Previously, using a external crate in a module without a use statement
1804   required `let json = ::serde_json::from_str(foo);` but can now be written
1805   as `let json = serde_json::from_str(foo);`.
1806 - [You can now apply the `#[used]` attribute to static items to prevent the
1807   compiler from optimising them away, even if they appear to be unused,][51363]
1808   e.g. `#[used] static FOO: u32 = 1;`
1809 - [You can now import and reexport macros from other crates with the `use`
1810   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
1811   the root module of the crate. If your macro relies on calling other local
1812   macros, it is recommended to export with the
1813   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
1814   those macros.
1815 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
1816   using the `vis` specifier.][53370]
1817 - [Non-macro attributes now allow all forms of literals, not just
1818   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
1819   write `#[attr(true)]`.
1820 - [You can now specify a function to handle a panic in the Rust runtime with the
1821   `#[panic_handler]` attribute.][51366]
1822
1823 Compiler
1824 --------
1825 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
1826 - [Added the `aarch64-unknown-netbsd` target][53165]
1827
1828 Libraries
1829 ---------
1830 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
1831
1832 Stabilized APIs
1833 ---------------
1834 - [`Ipv4Addr::BROADCAST`]
1835 - [`Ipv4Addr::LOCALHOST`]
1836 - [`Ipv4Addr::UNSPECIFIED`]
1837 - [`Ipv6Addr::LOCALHOST`]
1838 - [`Ipv6Addr::UNSPECIFIED`]
1839 - [`Iterator::find_map`]
1840
1841   The following methods are replacement methods for `trim_left`, `trim_right`,
1842   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
1843   in 1.33.0:
1844 - [`str::trim_end_matches`]
1845 - [`str::trim_end`]
1846 - [`str::trim_start_matches`]
1847 - [`str::trim_start`]
1848
1849 Cargo
1850 ----
1851 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
1852 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
1853   equivalent to calling `rustdoc --error-format=json`.
1854 - [Cargo will now provide a progress bar for builds.][cargo/5995]
1855
1856 Misc
1857 ----
1858 - [`rustdoc` allows you to specify what edition to treat your code as with the
1859   `--edition` option.][54057]
1860 - [`rustdoc` now has the `--color` (specify whether to output color) and
1861   `--error-format` (specify error format, e.g. `json`) options.][53003]
1862 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
1863   debug symbols.][53774]
1864 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
1865   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
1866
1867 [50911]: https://github.com/rust-lang/rust/pull/50911/
1868 [51363]: https://github.com/rust-lang/rust/pull/51363/
1869 [51366]: https://github.com/rust-lang/rust/pull/51366/
1870 [52081]: https://github.com/rust-lang/rust/pull/52081/
1871 [53003]: https://github.com/rust-lang/rust/pull/53003/
1872 [53033]: https://github.com/rust-lang/rust/pull/53033/
1873 [53044]: https://github.com/rust-lang/rust/pull/53044/
1874 [53165]: https://github.com/rust-lang/rust/pull/53165/
1875 [53213]: https://github.com/rust-lang/rust/pull/53213/
1876 [53236]: https://github.com/rust-lang/rust/pull/53236/
1877 [53272]: https://github.com/rust-lang/rust/pull/53272/
1878 [53370]: https://github.com/rust-lang/rust/pull/53370/
1879 [53459]: https://github.com/rust-lang/rust/pull/53459/
1880 [53774]: https://github.com/rust-lang/rust/pull/53774/
1881 [53822]: https://github.com/rust-lang/rust/pull/53822/
1882 [54057]: https://github.com/rust-lang/rust/pull/54057/
1883 [54146]: https://github.com/rust-lang/rust/pull/54146/
1884 [54404]: https://github.com/rust-lang/rust/pull/54404/
1885 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
1886 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
1887 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
1888 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
1889
1890 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
1891 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
1892 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
1893 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
1894 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
1895 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
1896 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
1897 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
1898 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
1899 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
1900
1901
1902 Version 1.29.2 (2018-10-11)
1903 ===========================
1904
1905 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
1906 - The `rls-preview` component on the windows-gnu targets has been restored.
1907
1908 [54639]: https://github.com/rust-lang/rust/pull/54639
1909
1910
1911 Version 1.29.1 (2018-09-25)
1912 ===========================
1913
1914 Security Notes
1915 --------------
1916
1917 - The standard library's `str::repeat` function contained an out of bounds write
1918   caused by an integer overflow. This has been fixed by deterministically
1919   panicking when an overflow happens.
1920
1921   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
1922   us.
1923
1924
1925 Version 1.29.0 (2018-09-13)
1926 ==========================
1927
1928 Compiler
1929 --------
1930 - [Bumped minimum LLVM version to 5.0.][51899]
1931 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
1932 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
1933
1934 Libraries
1935 ---------
1936 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
1937 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
1938 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
1939 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
1940   for `&str`.][51178]
1941 - [`Cell<T>` now allows `T` to be unsized.][50494]
1942 - [`SocketAddr` is now stable on Redox.][52656]
1943
1944 Stabilized APIs
1945 ---------------
1946 - [`Arc::downcast`]
1947 - [`Iterator::flatten`]
1948 - [`Rc::downcast`]
1949
1950 Cargo
1951 -----
1952 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
1953   `--locked` to disable this behavior.
1954 - [`cargo-install` will now allow you to cross compile an install
1955   using `--target`.][cargo/5614]
1956 - [Added the `cargo-fix` subcommand to automatically move project code from
1957   2015 edition to 2018.][cargo/5723]
1958 - [`cargo doc` can now optionally document private types using the
1959   `--document-private-items` flag.][cargo/5543]
1960
1961 Misc
1962 ----
1963 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
1964   the specified level to that level.][52354] For example `--cap-lints warn`
1965   will demote `deny` and `forbid` lints to `warn`.
1966 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
1967   fails and `101` if there is a panic.][52197]
1968 - [A preview of clippy has been made available through rustup.][51122]
1969   You can install the preview with `rustup component add clippy-preview`.
1970
1971 Compatibility Notes
1972 -------------------
1973 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
1974   Use `str::get_unchecked(begin..end)` instead.
1975 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
1976   Consider using the `home_dir` function from
1977   https://crates.io/crates/dirs instead.
1978 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
1979 - [`cfg` attributes and `--cfg` command line flags are now more
1980   strictly validated.][53893]
1981
1982 [53893]: https://github.com/rust-lang/rust/pull/53893/
1983 [52861]: https://github.com/rust-lang/rust/pull/52861/
1984 [52656]: https://github.com/rust-lang/rust/pull/52656/
1985 [52239]: https://github.com/rust-lang/rust/pull/52239/
1986 [52330]: https://github.com/rust-lang/rust/pull/52330/
1987 [52354]: https://github.com/rust-lang/rust/pull/52354/
1988 [52402]: https://github.com/rust-lang/rust/pull/52402/
1989 [52103]: https://github.com/rust-lang/rust/pull/52103/
1990 [52197]: https://github.com/rust-lang/rust/pull/52197/
1991 [51807]: https://github.com/rust-lang/rust/pull/51807/
1992 [51899]: https://github.com/rust-lang/rust/pull/51899/
1993 [51912]: https://github.com/rust-lang/rust/pull/51912/
1994 [51511]: https://github.com/rust-lang/rust/pull/51511/
1995 [51619]: https://github.com/rust-lang/rust/pull/51619/
1996 [51656]: https://github.com/rust-lang/rust/pull/51656/
1997 [51178]: https://github.com/rust-lang/rust/pull/51178/
1998 [51122]: https://github.com/rust-lang/rust/pull/51122
1999 [50494]: https://github.com/rust-lang/rust/pull/50494/
2000 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
2001 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
2002 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
2003 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
2004 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
2005 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
2006 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
2007
2008
2009 Version 1.28.0 (2018-08-02)
2010 ===========================
2011
2012 Language
2013 --------
2014 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
2015   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
2016   the inner type across Foreign Function Interface (FFI) boundaries.
2017 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
2018   and can now be used as identifiers.][51196]
2019 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
2020   stable.][51241] This will allow users to specify a global allocator for
2021   their program.
2022 - [Unit test functions marked with the `#[test]` attribute can now return
2023   `Result<(), E: Debug>` in addition to `()`.][51298]
2024 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
2025   allows macros to easily target lifetimes.
2026
2027 Compiler
2028 --------
2029 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
2030   prioritise making smaller binary sizes. `z` is the same as `s` with the
2031   exception that it does not vectorise loops, which typically results in an even
2032   smaller binary.
2033 - [The short error format is now stable.][49546] Specified with
2034   `--error-format=short` this option will provide a more compressed output of
2035   rust error messages.
2036 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
2037 - [Reduced the number of allocations in the macro parser.][50855] This can
2038   improve compile times of macro heavy crates on average by 5%.
2039
2040 Libraries
2041 ---------
2042 - [Implemented `Default` for `&mut str`.][51306]
2043 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
2044 - [Implemented `Extend` for `()`.][50234]
2045 - [The `Debug` implementation of `time::Duration` should now be more easily
2046   human readable.][50364] Previously a `Duration` of one second would printed as
2047   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
2048 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
2049   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
2050   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
2051   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
2052   for `PathBuf`.][50170]
2053 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
2054   and `Wrapping<i128>`.][50465]
2055 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
2056   possible.][51050] This can provide up to a 40% speed increase.
2057 - [Improved error messages when using `format!`.][50610]
2058
2059 Stabilized APIs
2060 ---------------
2061 - [`Iterator::step_by`]
2062 - [`Path::ancestors`]
2063 - [`SystemTime::UNIX_EPOCH`]
2064 - [`alloc::GlobalAlloc`]
2065 - [`alloc::Layout`]
2066 - [`alloc::LayoutErr`]
2067 - [`alloc::System`]
2068 - [`alloc::alloc`]
2069 - [`alloc::alloc_zeroed`]
2070 - [`alloc::dealloc`]
2071 - [`alloc::realloc`]
2072 - [`alloc::handle_alloc_error`]
2073 - [`btree_map::Entry::or_default`]
2074 - [`fmt::Alignment`]
2075 - [`hash_map::Entry::or_default`]
2076 - [`iter::repeat_with`]
2077 - [`num::NonZeroUsize`]
2078 - [`num::NonZeroU128`]
2079 - [`num::NonZeroU16`]
2080 - [`num::NonZeroU32`]
2081 - [`num::NonZeroU64`]
2082 - [`num::NonZeroU8`]
2083 - [`ops::RangeBounds`]
2084 - [`slice::SliceIndex`]
2085 - [`slice::from_mut`]
2086 - [`slice::from_ref`]
2087 - [`{Any + Send + Sync}::downcast_mut`]
2088 - [`{Any + Send + Sync}::downcast_ref`]
2089 - [`{Any + Send + Sync}::is`]
2090
2091 Cargo
2092 -----
2093 - [Cargo will now no longer allow you to publish crates with build scripts that
2094   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
2095   considered to be immutable.
2096
2097 Misc
2098 ----
2099 - [The `suggestion_applicability` field in `rustc`'s json output is now
2100   stable.][50486] This will allow dev tools to check whether a code suggestion
2101   would apply to them.
2102
2103 Compatibility Notes
2104 -------------------
2105 - [Rust will consider trait objects with duplicated constraints to be the same
2106   type as without the duplicated constraint.][51276] For example the below code will
2107   now fail to compile.
2108   ```rust
2109   trait Trait {}
2110
2111   impl Trait + Send {
2112       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
2113   }
2114
2115   impl Trait + Send + Send {
2116       fn test(&self) { println!("two"); }
2117   }
2118   ```
2119
2120 [49546]: https://github.com/rust-lang/rust/pull/49546/
2121 [50143]: https://github.com/rust-lang/rust/pull/50143/
2122 [50170]: https://github.com/rust-lang/rust/pull/50170/
2123 [50234]: https://github.com/rust-lang/rust/pull/50234/
2124 [50265]: https://github.com/rust-lang/rust/pull/50265/
2125 [50364]: https://github.com/rust-lang/rust/pull/50364/
2126 [50385]: https://github.com/rust-lang/rust/pull/50385/
2127 [50465]: https://github.com/rust-lang/rust/pull/50465/
2128 [50486]: https://github.com/rust-lang/rust/pull/50486/
2129 [50554]: https://github.com/rust-lang/rust/pull/50554/
2130 [50610]: https://github.com/rust-lang/rust/pull/50610/
2131 [50855]: https://github.com/rust-lang/rust/pull/50855/
2132 [51050]: https://github.com/rust-lang/rust/pull/51050/
2133 [51196]: https://github.com/rust-lang/rust/pull/51196/
2134 [51200]: https://github.com/rust-lang/rust/pull/51200/
2135 [51241]: https://github.com/rust-lang/rust/pull/51241/
2136 [51276]: https://github.com/rust-lang/rust/pull/51276/
2137 [51298]: https://github.com/rust-lang/rust/pull/51298/
2138 [51306]: https://github.com/rust-lang/rust/pull/51306/
2139 [51562]: https://github.com/rust-lang/rust/pull/51562/
2140 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
2141 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
2142 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
2143 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
2144 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
2145 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
2146 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
2147 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
2148 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
2149 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
2150 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
2151 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
2152 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
2153 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
2154 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
2155 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
2156 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
2157 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
2158 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
2159 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
2160 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
2161 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
2162 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
2163 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
2164 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
2165 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
2166 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
2167 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
2168 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
2169 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
2170
2171 Version 1.27.2 (2018-07-20)
2172 ===========================
2173
2174 Compatibility Notes
2175 -------------------
2176
2177 - The borrow checker was fixed to avoid potential unsoundness when using
2178   match ergonomics: [#52213][52213].
2179
2180 [52213]: https://github.com/rust-lang/rust/issues/52213
2181
2182 Version 1.27.1 (2018-07-10)
2183 ===========================
2184
2185 Security Notes
2186 --------------
2187
2188 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
2189   when running, which enabled executing code as some other user on a
2190   given machine. This release fixes that vulnerability; you can read
2191   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
2192
2193   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
2194
2195 Compatibility Notes
2196 -------------------
2197
2198 - The borrow checker was fixed to avoid an additional potential unsoundness when using
2199   match ergonomics: [#51415][51415], [#49534][49534].
2200
2201 [51415]: https://github.com/rust-lang/rust/issues/51415
2202 [49534]: https://github.com/rust-lang/rust/issues/49534
2203 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
2204 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
2205
2206 Version 1.27.0 (2018-06-21)
2207 ==========================
2208
2209 Language
2210 --------
2211 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
2212   be used as an identifier.
2213 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
2214   bare `Trait` syntax, and should make it clearer when being used in tandem with
2215   `impl Trait` because it is equivalent to the following syntax:
2216   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
2217   `Box<Trait> == Box<dyn Trait>`.
2218 - [Attributes on generic parameters such as types and lifetimes are
2219   now stable.][48851] e.g.
2220   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
2221 - [The `#[must_use]` attribute can now also be used on functions as well as
2222   types.][48925] It provides a lint that by default warns users when the
2223   value returned by a function has not been used.
2224
2225 Compiler
2226 --------
2227 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
2228
2229 Libraries
2230 ---------
2231 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
2232   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
2233   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
2234   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
2235   the `cfg` attribute.
2236 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
2237   std are now available in core.][49896]
2238 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
2239   to `Self`.][49630]
2240 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
2241   that the operation isn't done in place.
2242 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
2243   the `#[must_use]` attribute][49533] to warn about unused potentially
2244   expensive allocations.
2245
2246 Stabilized APIs
2247 ---------------
2248 - [`DoubleEndedIterator::rfind`]
2249 - [`DoubleEndedIterator::rfold`]
2250 - [`DoubleEndedIterator::try_rfold`]
2251 - [`Duration::from_micros`]
2252 - [`Duration::from_nanos`]
2253 - [`Duration::subsec_micros`]
2254 - [`Duration::subsec_millis`]
2255 - [`HashMap::remove_entry`]
2256 - [`Iterator::try_fold`]
2257 - [`Iterator::try_for_each`]
2258 - [`NonNull::cast`]
2259 - [`Option::filter`]
2260 - [`String::replace_range`]
2261 - [`Take::set_limit`]
2262 - [`hint::unreachable_unchecked`]
2263 - [`os::unix::process::parent_id`]
2264 - [`ptr::swap_nonoverlapping`]
2265 - [`slice::rsplit_mut`]
2266 - [`slice::rsplit`]
2267 - [`slice::swap_with_slice`]
2268
2269 Cargo
2270 -----
2271 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
2272   `readme`, and `repository` fields.][cargo/5386]
2273 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
2274 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
2275   a different directory than `target` for placing compilation artifacts.
2276 - [Cargo will be adding automatic target inference for binaries, benchmarks,
2277   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
2278   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
2279   where cargo would infer a binary, Cargo will produce a warning. You can
2280   disable this feature ahead of time by setting any of the following to false:
2281   `autobins`, `autobenches`, `autoexamples`, `autotests`.
2282 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
2283   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
2284
2285 Misc
2286 ----
2287 - [Added “The Rustc book” into the official documentation.][49707]
2288   [“The Rustc book”] documents and teaches how to use the rustc compiler.
2289 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
2290
2291 Compatibility Notes
2292 -------------------
2293 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
2294   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
2295   compile, `"".is_empty()` will still compile.
2296 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
2297   will only print the inner type.][48553] E.g.
2298   `print!("{:?}", AtomicBool::new(true))` will print `true`,
2299   not `AtomicBool(true)`.
2300 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
2301   could enter higher numbers but they were not supported by LLVM. Up to 512MB
2302   alignment should cover all use cases.
2303 - The `.description()` method on the `std::error::Error` trait
2304   [has been soft-deprecated][50163]. It is no longer required to implement it.
2305
2306 [48553]: https://github.com/rust-lang/rust/pull/48553/
2307 [48851]: https://github.com/rust-lang/rust/pull/48851/
2308 [48925]: https://github.com/rust-lang/rust/pull/48925/
2309 [49533]: https://github.com/rust-lang/rust/pull/49533/
2310 [49623]: https://github.com/rust-lang/rust/pull/49623/
2311 [49630]: https://github.com/rust-lang/rust/pull/49630/
2312 [49664]: https://github.com/rust-lang/rust/pull/49664/
2313 [49699]: https://github.com/rust-lang/rust/pull/49699/
2314 [49707]: https://github.com/rust-lang/rust/pull/49707/
2315 [49719]: https://github.com/rust-lang/rust/pull/49719/
2316 [49896]: https://github.com/rust-lang/rust/pull/49896/
2317 [49968]: https://github.com/rust-lang/rust/pull/49968/
2318 [50163]: https://github.com/rust-lang/rust/pull/50163
2319 [50177]: https://github.com/rust-lang/rust/pull/50177/
2320 [50378]: https://github.com/rust-lang/rust/pull/50378/
2321 [50398]: https://github.com/rust-lang/rust/pull/50398/
2322 [50423]: https://github.com/rust-lang/rust/pull/50423/
2323 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
2324 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
2325 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
2326 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
2327 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
2328 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
2329 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
2330 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
2331 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
2332 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
2333 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
2334 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2335 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2336 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
2337 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
2338 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
2339 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
2340 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
2341 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
2342 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
2343 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
2344 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
2345 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2346 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
2347 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
2348 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
2349 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
2350 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
2351 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
2352 [“The Rustc book”]: https://doc.rust-lang.org/rustc
2353
2354
2355 Version 1.26.2 (2018-06-05)
2356 ==========================
2357
2358 Compatibility Notes
2359 -------------------
2360
2361 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
2362
2363 [51117]: https://github.com/rust-lang/rust/issues/51117
2364
2365
2366 Version 1.26.1 (2018-05-29)
2367 ==========================
2368
2369 Tools
2370 -----
2371
2372 - [RLS now works on Windows.][50646]
2373 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
2374
2375
2376 Compatibility Notes
2377 --------
2378
2379 - [`fn main() -> impl Trait` no longer works for non-Termination
2380   trait.][50656]
2381   This reverts an accidental stabilization.
2382 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
2383 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
2384
2385 [50646]: https://github.com/rust-lang/rust/issues/50646
2386 [50656]: https://github.com/rust-lang/rust/pull/50656
2387 [50812]: https://github.com/rust-lang/rust/pull/50812
2388 [50950]: https://github.com/rust-lang/rust/issues/50950
2389 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
2390
2391 Version 1.26.0 (2018-05-10)
2392 ==========================
2393
2394 Language
2395 --------
2396 - [Closures now implement `Copy` and/or `Clone` if all captured variables
2397   implement either or both traits.][49299]
2398 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
2399 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
2400   lifetime can be elided.][49458]
2401 - [`impl Trait` is now stable allowing you to have abstract types in returns
2402    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
2403   `fn open(path: impl AsRef<Path>)`.
2404 - [Pattern matching will now automatically apply dereferences.][49394]
2405 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
2406 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
2407 - [A lot of operations are now available in a const context.][46882] E.g. You
2408   can now index into constant arrays, reference and dereference into constants,
2409   and use tuple struct constructors.
2410 - [Fixed entry slice patterns are now stable.][48516] E.g.
2411   ```rust
2412   let points = [1, 2, 3, 4];
2413   match points {
2414       [1, 2, 3, 4] => println!("All points were sequential."),
2415       _ => println!("Not all points were sequential."),
2416   }
2417   ```
2418
2419
2420 Compiler
2421 --------
2422 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
2423 - [Fixed exponential projection complexity on nested types.][48296]
2424   This can provide up to a ~12% reduction in compile times for certain crates.
2425 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
2426   to remap path prefixes outputted by the compiler.
2427 - [Added `powerpc-unknown-netbsd` target.][48281]
2428
2429 Libraries
2430 ---------
2431 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
2432 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
2433   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
2434 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
2435 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
2436 - [`ascii::escape_default` is now available in libcore.][48735]
2437 - [Trailing commas are now supported in std and core macros.][48056]
2438 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
2439 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
2440
2441 Stabilized APIs
2442 ---------------
2443 - [`*const T::add`]
2444 - [`*const T::copy_to_nonoverlapping`]
2445 - [`*const T::copy_to`]
2446 - [`*const T::read_unaligned`]
2447 - [`*const T::read_volatile`]
2448 - [`*const T::read`]
2449 - [`*const T::sub`]
2450 - [`*const T::wrapping_add`]
2451 - [`*const T::wrapping_sub`]
2452 - [`*mut T::add`]
2453 - [`*mut T::copy_to_nonoverlapping`]
2454 - [`*mut T::copy_to`]
2455 - [`*mut T::read_unaligned`]
2456 - [`*mut T::read_volatile`]
2457 - [`*mut T::read`]
2458 - [`*mut T::replace`]
2459 - [`*mut T::sub`]
2460 - [`*mut T::swap`]
2461 - [`*mut T::wrapping_add`]
2462 - [`*mut T::wrapping_sub`]
2463 - [`*mut T::write_bytes`]
2464 - [`*mut T::write_unaligned`]
2465 - [`*mut T::write_volatile`]
2466 - [`*mut T::write`]
2467 - [`Box::leak`]
2468 - [`FromUtf8Error::as_bytes`]
2469 - [`LocalKey::try_with`]
2470 - [`Option::cloned`]
2471 - [`btree_map::Entry::and_modify`]
2472 - [`fs::read_to_string`]
2473 - [`fs::read`]
2474 - [`fs::write`]
2475 - [`hash_map::Entry::and_modify`]
2476 - [`iter::FusedIterator`]
2477 - [`ops::RangeInclusive`]
2478 - [`ops::RangeToInclusive`]
2479 - [`process::id`]
2480 - [`slice::rotate_left`]
2481 - [`slice::rotate_right`]
2482 - [`String::retain`]
2483
2484
2485 Cargo
2486 -----
2487 - [Cargo will now output path to custom commands when `-v` is
2488   passed with `--list`][cargo/5041]
2489 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
2490
2491 Misc
2492 ----
2493 - [The second edition of "The Rust Programming Language" book is now recommended
2494   over the first.][48404]
2495
2496 Compatibility Notes
2497 -------------------
2498
2499 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
2500   syntax is now invalid.
2501   ```
2502   use std::ops::Fn as dyn;
2503   fn g(_: Box<dyn(std::fmt::Debug)>) {}
2504   ```
2505 - [The result of dereferences are no longer promoted to `'static`.][47408]
2506   e.g.
2507   ```rust
2508   fn main() {
2509       const PAIR: &(i32, i32) = &(0, 1);
2510       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
2511   }
2512   ```
2513 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
2514 - [`".e0"` will now no longer parse as `0.0` and will instead cause
2515   an error.][48235]
2516 - [Removed hoedown from rustdoc.][48274]
2517 - [Bounds on higher-kinded lifetimes a hard error.][48326]
2518
2519 [46882]: https://github.com/rust-lang/rust/pull/46882
2520 [47379]: https://github.com/rust-lang/rust/pull/47379
2521 [47408]: https://github.com/rust-lang/rust/pull/47408
2522 [47813]: https://github.com/rust-lang/rust/pull/47813
2523 [48056]: https://github.com/rust-lang/rust/pull/48056
2524 [48125]: https://github.com/rust-lang/rust/pull/48125
2525 [48166]: https://github.com/rust-lang/rust/pull/48166
2526 [48235]: https://github.com/rust-lang/rust/pull/48235
2527 [48274]: https://github.com/rust-lang/rust/pull/48274
2528 [48281]: https://github.com/rust-lang/rust/pull/48281
2529 [48296]: https://github.com/rust-lang/rust/pull/48296
2530 [48326]: https://github.com/rust-lang/rust/pull/48326
2531 [48359]: https://github.com/rust-lang/rust/pull/48359
2532 [48404]: https://github.com/rust-lang/rust/pull/48404
2533 [48481]: https://github.com/rust-lang/rust/pull/48481
2534 [48516]: https://github.com/rust-lang/rust/pull/48516
2535 [48628]: https://github.com/rust-lang/rust/pull/48628
2536 [48629]: https://github.com/rust-lang/rust/pull/48629
2537 [48657]: https://github.com/rust-lang/rust/pull/48657
2538 [48735]: https://github.com/rust-lang/rust/pull/48735
2539 [48978]: https://github.com/rust-lang/rust/pull/48978
2540 [49101]: https://github.com/rust-lang/rust/pull/49101
2541 [49109]: https://github.com/rust-lang/rust/pull/49109
2542 [49121]: https://github.com/rust-lang/rust/pull/49121
2543 [49162]: https://github.com/rust-lang/rust/pull/49162
2544 [49184]: https://github.com/rust-lang/rust/pull/49184
2545 [49234]: https://github.com/rust-lang/rust/pull/49234
2546 [49255]: https://github.com/rust-lang/rust/pull/49255
2547 [49299]: https://github.com/rust-lang/rust/pull/49299
2548 [49305]: https://github.com/rust-lang/rust/pull/49305
2549 [49394]: https://github.com/rust-lang/rust/pull/49394
2550 [49458]: https://github.com/rust-lang/rust/pull/49458
2551 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
2552 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
2553 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
2554 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
2555 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
2556 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
2557 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
2558 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
2559 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
2560 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
2561 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
2562 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
2563 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
2564 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
2565 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
2566 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
2567 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
2568 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
2569 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
2570 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
2571 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
2572 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
2573 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
2574 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
2575 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
2576 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
2577 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
2578 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
2579 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
2580 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
2581 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
2582 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
2583 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
2584 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
2585 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
2586 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
2587 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2588 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
2589 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
2590 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
2591 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
2592 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
2593
2594
2595 Version 1.25.0 (2018-03-29)
2596 ==========================
2597
2598 Language
2599 --------
2600 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
2601 - [You can now use nested groups of imports.][47948]
2602   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
2603 - [You can now have `|` at the start of a match arm.][47947] e.g.
2604 ```rust
2605 enum Foo { A, B, C }
2606
2607 fn main() {
2608     let x = Foo::A;
2609     match x {
2610         | Foo::A
2611         | Foo::B => println!("AB"),
2612         | Foo::C => println!("C"),
2613     }
2614 }
2615 ```
2616
2617 Compiler
2618 --------
2619 - [Upgraded to LLVM 6.][47828]
2620 - [Added `-C lto=val` option.][47521]
2621 - [Added `i586-unknown-linux-musl` target][47282]
2622
2623 Libraries
2624 ---------
2625 - [Impl Send for `process::Command` on Unix.][47760]
2626 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
2627 - [`UnsafeCell::into_inner` is now safe.][47204]
2628 - [Implement libstd for CloudABI.][47268]
2629 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
2630 - [Implement `AsRef<Path>` for Component][46985]
2631 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
2632 - [Moved `Duration` to libcore.][46666]
2633
2634 Stabilized APIs
2635 ---------------
2636 - [`Location::column`]
2637 - [`ptr::NonNull`]
2638
2639 The following functions can now be used in a constant expression.
2640 eg. `static MINUTE: Duration = Duration::from_secs(60);`
2641 - [`Duration::new`][47300]
2642 - [`Duration::from_secs`][47300]
2643 - [`Duration::from_millis`][47300]
2644
2645 Cargo
2646 -----
2647 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
2648 - [`cargo new` now defaults to creating a binary crate, instead of a
2649   library crate.][cargo/5029]
2650
2651 Misc
2652 ----
2653 - [Rust by example is now shipped with new releases][46196]
2654
2655 Compatibility Notes
2656 -------------------
2657 - [Deprecated `net::lookup_host`.][47510]
2658 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
2659 - The borrow checker was sometimes incorrectly permitting overlapping borrows
2660   around indexing operations (see [#47349][47349]). This has been fixed (which also
2661   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
2662 - [Removed deprecated unstable attribute `#[simd]`.][47251]
2663
2664 [33903]: https://github.com/rust-lang/rust/pull/33903
2665 [47947]: https://github.com/rust-lang/rust/pull/47947
2666 [47948]: https://github.com/rust-lang/rust/pull/47948
2667 [47760]: https://github.com/rust-lang/rust/pull/47760
2668 [47790]: https://github.com/rust-lang/rust/pull/47790
2669 [47828]: https://github.com/rust-lang/rust/pull/47828
2670 [47398]: https://github.com/rust-lang/rust/pull/47398
2671 [47510]: https://github.com/rust-lang/rust/pull/47510
2672 [47521]: https://github.com/rust-lang/rust/pull/47521
2673 [47204]: https://github.com/rust-lang/rust/pull/47204
2674 [47251]: https://github.com/rust-lang/rust/pull/47251
2675 [47268]: https://github.com/rust-lang/rust/pull/47268
2676 [47282]: https://github.com/rust-lang/rust/pull/47282
2677 [47300]: https://github.com/rust-lang/rust/pull/47300
2678 [47349]: https://github.com/rust-lang/rust/pull/47349
2679 [46931]: https://github.com/rust-lang/rust/pull/46931
2680 [46985]: https://github.com/rust-lang/rust/pull/46985
2681 [47006]: https://github.com/rust-lang/rust/pull/47006
2682 [46830]: https://github.com/rust-lang/rust/pull/46830
2683 [46095]: https://github.com/rust-lang/rust/pull/46095
2684 [46666]: https://github.com/rust-lang/rust/pull/46666
2685 [46196]: https://github.com/rust-lang/rust/pull/46196
2686 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
2687 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
2688 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
2689 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
2690 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
2691
2692
2693 Version 1.24.1 (2018-03-01)
2694 ==========================
2695
2696  - [Do not abort when unwinding through FFI][48251]
2697  - [Emit UTF-16 files for linker arguments on Windows][48318]
2698  - [Make the error index generator work again][48308]
2699  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
2700
2701 [48251]: https://github.com/rust-lang/rust/issues/48251
2702 [48308]: https://github.com/rust-lang/rust/issues/48308
2703 [48318]: https://github.com/rust-lang/rust/issues/48318
2704 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
2705
2706
2707 Version 1.24.0 (2018-02-15)
2708 ==========================
2709
2710 Language
2711 --------
2712 - [External `sysv64` ffi is now available.][46528]
2713   eg. `extern "sysv64" fn foo () {}`
2714
2715 Compiler
2716 --------
2717 - [rustc now uses 16 codegen units by default for release builds.][46910]
2718   For the fastest builds, utilize `codegen-units=1`.
2719 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
2720 - [Add `aarch64-unknown-openbsd` support][46760]
2721
2722 Libraries
2723 ---------
2724 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
2725   improvement in performance in the majority of cases.
2726 - [`OsStr`'s `Debug` implementation is now lossless and consistent
2727   with Windows.][46798]
2728 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
2729 - [impl `From<bool>` for `AtomicBool`][46293]
2730 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
2731 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
2732 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
2733 - [float::from_bits now just uses transmute.][46012] This provides
2734   some optimisations from LLVM.
2735 - [Copied `AsciiExt` methods onto `char`][46077]
2736 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
2737 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
2738 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
2739 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
2740
2741 Stabilized APIs
2742 ---------------
2743 - [`RefCell::replace`]
2744 - [`RefCell::swap`]
2745 - [`atomic::spin_loop_hint`]
2746
2747 The following functions can now be used in a constant expression.
2748 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
2749
2750 - [`AtomicBool::new`][46287]
2751 - [`AtomicUsize::new`][46287]
2752 - [`AtomicIsize::new`][46287]
2753 - [`AtomicPtr::new`][46287]
2754 - [`Cell::new`][46287]
2755 - [`{integer}::min_value`][46287]
2756 - [`{integer}::max_value`][46287]
2757 - [`mem::size_of`][46287]
2758 - [`mem::align_of`][46287]
2759 - [`ptr::null`][46287]
2760 - [`ptr::null_mut`][46287]
2761 - [`RefCell::new`][46287]
2762 - [`UnsafeCell::new`][46287]
2763
2764 Cargo
2765 -----
2766 - [Added a `workspace.default-members` config that
2767   overrides implied `--all` in virtual workspaces.][cargo/4743]
2768 - [Enable incremental by default on development builds.][cargo/4817] Also added
2769   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
2770   per-project or global basis respectively.
2771
2772 Misc
2773 ----
2774
2775 Compatibility Notes
2776 -------------------
2777 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
2778 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
2779   in accordance with IETF RFC 4291 §2.2.
2780 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
2781 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
2782   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
2783 - [Leading zeros in tuple struct members is now an error][47084]
2784 - [`column!()` macro is one-based instead of zero-based][46977]
2785 - [`fmt::Arguments` can no longer be shared across threads][45198]
2786 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
2787 - [Cargo sets a different working directory for the compiler][cargo/4788]
2788
2789 [44884]: https://github.com/rust-lang/rust/pull/44884
2790 [45198]: https://github.com/rust-lang/rust/pull/45198
2791 [45506]: https://github.com/rust-lang/rust/pull/45506
2792 [45904]: https://github.com/rust-lang/rust/pull/45904
2793 [45990]: https://github.com/rust-lang/rust/pull/45990
2794 [46012]: https://github.com/rust-lang/rust/pull/46012
2795 [46077]: https://github.com/rust-lang/rust/pull/46077
2796 [46094]: https://github.com/rust-lang/rust/pull/46094
2797 [46284]: https://github.com/rust-lang/rust/pull/46284
2798 [46287]: https://github.com/rust-lang/rust/pull/46287
2799 [46293]: https://github.com/rust-lang/rust/pull/46293
2800 [46528]: https://github.com/rust-lang/rust/pull/46528
2801 [46671]: https://github.com/rust-lang/rust/pull/46671
2802 [46713]: https://github.com/rust-lang/rust/pull/46713
2803 [46735]: https://github.com/rust-lang/rust/pull/46735
2804 [46749]: https://github.com/rust-lang/rust/pull/46749
2805 [46760]: https://github.com/rust-lang/rust/pull/46760
2806 [46798]: https://github.com/rust-lang/rust/pull/46798
2807 [46828]: https://github.com/rust-lang/rust/pull/46828
2808 [46831]: https://github.com/rust-lang/rust/pull/46831
2809 [46833]: https://github.com/rust-lang/rust/pull/46833
2810 [46910]: https://github.com/rust-lang/rust/pull/46910
2811 [46977]: https://github.com/rust-lang/rust/pull/46977
2812 [47018]: https://github.com/rust-lang/rust/pull/47018
2813 [47080]: https://github.com/rust-lang/rust/pull/47080
2814 [47084]: https://github.com/rust-lang/rust/pull/47084
2815 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
2816 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
2817 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
2818 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
2819 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
2820 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
2821
2822
2823 Version 1.23.0 (2018-01-04)
2824 ==========================
2825
2826 Language
2827 --------
2828 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
2829 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
2830   Which should fix some confusing errors in some operations.
2831
2832 Compiler
2833 --------
2834 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
2835   undefined behavior.][45920]
2836 - [rustc now suggests renaming import if names clash.][45660]
2837 - [Display errors/warnings correctly when there are zero-width or
2838   wide characters.][45711]
2839 - [rustc now avoids unnecessary copies of arguments that are
2840   simple bindings][45380] This should improve memory usage on average by 5-10%.
2841 - [Updated musl used to build musl rustc to 1.1.17][45393]
2842
2843 Libraries
2844 ---------
2845 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
2846 - [Implement Hash for raw pointers to unsized types][45483]
2847 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
2848 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
2849 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
2850 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
2851   and `<*mut T>::as_mut`][44932]
2852 - [Optimized `Thread::{park, unpark}` implementation][45524]
2853 - [Improved `SliceExt::binary_search` performance.][45333]
2854 - [impl `FromIterator<()>` for `()`][45379]
2855 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
2856   is now deprecated.
2857
2858 Stabilized APIs
2859 ---------------
2860
2861 Cargo
2862 -----
2863 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
2864   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
2865 - [Added unit test checking to `cargo check`][cargo/4592]
2866 - [Cargo now lets you install a specific version
2867   using `cargo install --version`][cargo/4637]
2868
2869 Misc
2870 ----
2871 - [Releases now ship with the Cargo book documentation.][45692]
2872 - [rustdoc now prints rendering warnings on every run.][45324]
2873
2874 Compatibility Notes
2875 -------------------
2876 - [Changes have been made to type equality to make it more correct,
2877   in rare cases this could break some code.][45853] [Tracking issue for
2878   further information][45852]
2879 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
2880 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
2881   Android 9, the minimum supported version is Android 14.
2882 - [Bumped the minimum LLVM to 3.9][45326]
2883
2884 [44042]: https://github.com/rust-lang/rust/pull/44042
2885 [44932]: https://github.com/rust-lang/rust/pull/44932
2886 [45267]: https://github.com/rust-lang/rust/pull/45267
2887 [45324]: https://github.com/rust-lang/rust/pull/45324
2888 [45326]: https://github.com/rust-lang/rust/pull/45326
2889 [45333]: https://github.com/rust-lang/rust/pull/45333
2890 [45379]: https://github.com/rust-lang/rust/pull/45379
2891 [45380]: https://github.com/rust-lang/rust/pull/45380
2892 [45393]: https://github.com/rust-lang/rust/pull/45393
2893 [45435]: https://github.com/rust-lang/rust/pull/45435
2894 [45483]: https://github.com/rust-lang/rust/pull/45483
2895 [45524]: https://github.com/rust-lang/rust/pull/45524
2896 [45571]: https://github.com/rust-lang/rust/pull/45571
2897 [45580]: https://github.com/rust-lang/rust/pull/45580
2898 [45610]: https://github.com/rust-lang/rust/pull/45610
2899 [45660]: https://github.com/rust-lang/rust/pull/45660
2900 [45692]: https://github.com/rust-lang/rust/pull/45692
2901 [45711]: https://github.com/rust-lang/rust/pull/45711
2902 [45772]: https://github.com/rust-lang/rust/pull/45772
2903 [45852]: https://github.com/rust-lang/rust/issues/45852
2904 [45853]: https://github.com/rust-lang/rust/pull/45853
2905 [45887]: https://github.com/rust-lang/rust/pull/45887
2906 [45920]: https://github.com/rust-lang/rust/pull/45920
2907 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
2908 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
2909 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
2910
2911
2912 Version 1.22.1 (2017-11-22)
2913 ==========================
2914
2915 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
2916
2917 [46183]: https://github.com/rust-lang/rust/pull/46183
2918
2919 Version 1.22.0 (2017-11-22)
2920 ==========================
2921
2922 Language
2923 --------
2924 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
2925 - [Now accepts underscores in unicode escapes][43716]
2926 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
2927 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
2928
2929 Compiler
2930 --------
2931 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
2932 - [rustc will no longer inline in codegen units when compiling for debug][45075]
2933   This should decrease compile times for debug builds.
2934 - [strict memory alignment now enabled on ARMv6][45094]
2935 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
2936
2937 Libraries
2938 ---------
2939 - [Allow atomic operations up to 32 bits
2940   on `armv5te_unknown_linux_gnueabi`][44978]
2941 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
2942 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
2943 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
2944 - [Properly detect overflow in `Instant += Duration`.][44220]
2945 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
2946 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
2947 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
2948
2949 Stabilized APIs
2950 ---------------
2951
2952 Cargo
2953 -----
2954 - [Cargo will now build multi file examples in subdirectories of the `examples`
2955   folder that have a `main.rs` file.][cargo/4496]
2956 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
2957   the old format will continue to work and can be updated with `cargo update`.
2958 - [Now supports vendoring git repositories][cargo/3992]
2959
2960 Misc
2961 ----
2962 - [`libbacktrace` is now available on Apple platforms.][44251]
2963 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
2964   This now lets you specify that a given code example will fail to compile.
2965
2966 Compatibility Notes
2967 -------------------
2968 - [The minimum Android version that rustc can build for has been bumped
2969   to `4.0` from `2.3`][45656]
2970 - [Allowing `T op= &T` for numeric types has broken some type
2971   inference cases][45480]
2972
2973
2974 [42526]: https://github.com/rust-lang/rust/pull/42526
2975 [43017]: https://github.com/rust-lang/rust/pull/43017
2976 [43716]: https://github.com/rust-lang/rust/pull/43716
2977 [43949]: https://github.com/rust-lang/rust/pull/43949
2978 [44015]: https://github.com/rust-lang/rust/pull/44015
2979 [44220]: https://github.com/rust-lang/rust/pull/44220
2980 [44251]: https://github.com/rust-lang/rust/pull/44251
2981 [44287]: https://github.com/rust-lang/rust/pull/44287
2982 [44303]: https://github.com/rust-lang/rust/pull/44303
2983 [44456]: https://github.com/rust-lang/rust/pull/44456
2984 [44466]: https://github.com/rust-lang/rust/pull/44466
2985 [44895]: https://github.com/rust-lang/rust/pull/44895
2986 [44966]: https://github.com/rust-lang/rust/pull/44966
2987 [44978]: https://github.com/rust-lang/rust/pull/44978
2988 [45041]: https://github.com/rust-lang/rust/pull/45041
2989 [45064]: https://github.com/rust-lang/rust/pull/45064
2990 [45075]: https://github.com/rust-lang/rust/pull/45075
2991 [45094]: https://github.com/rust-lang/rust/pull/45094
2992 [45095]: https://github.com/rust-lang/rust/pull/45095
2993 [45480]: https://github.com/rust-lang/rust/issues/45480
2994 [45656]: https://github.com/rust-lang/rust/pull/45656
2995 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
2996 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
2997 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
2998
2999
3000
3001
3002
3003
3004 Version 1.21.0 (2017-10-12)
3005 ==========================
3006
3007 Language
3008 --------
3009 - [You can now use static references for literals.][43838]
3010   Example:
3011   ```rust
3012   fn main() {
3013       let x: &'static u32 = &0;
3014   }
3015   ```
3016 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
3017   Example:
3018   ```rust
3019   my_macro!(Vec<i32>::new); // Always worked
3020   my_macro!(Vec::<i32>::new); // Now works
3021   ```
3022
3023 Compiler
3024 --------
3025 - [Upgraded jemalloc to 4.5.0][43911]
3026 - [Enabled unwinding panics on Redox][43917]
3027 - [Now runs LLVM in parallel during translation phase.][43506]
3028   This should reduce peak memory usage.
3029
3030 Libraries
3031 ---------
3032 - [Generate builtin impls for `Clone` for all arrays and tuples that
3033   are `T: Clone`][43690]
3034 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
3035 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
3036   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
3037
3038 Stabilized APIs
3039 ---------------
3040
3041 [`std::mem::discriminant`]
3042
3043 Cargo
3044 -----
3045 - [You can now call `cargo install` with multiple package names][cargo/4216]
3046 - [Cargo commands inside a virtual workspace will now implicitly
3047   pass `--all`][cargo/4335]
3048 - [Added a `[patch]` section to `Cargo.toml` to handle
3049   prepublication dependencies][cargo/4123] [RFC 1969]
3050 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
3051   like patterns][cargo/4270]
3052 - [Added the `--all-targets` option][cargo/4400]
3053 - [Using required dependencies as a feature is now deprecated and emits
3054   a warning][cargo/4364]
3055
3056
3057 Misc
3058 ----
3059 - [Cargo docs are moving][43916]
3060   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
3061 - [The rustdoc book is now available][43863]
3062   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
3063 - [Added a preview of RLS has been made available through rustup][44204]
3064   Install with `rustup component add rls-preview`
3065 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
3066   Previously only showed `std::os::unix`.
3067
3068 Compatibility Notes
3069 -------------------
3070 - [Changes in method matching against higher-ranked types][43880] This may cause
3071   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
3072 - [rustc's JSON error output's byte position start at top of file.][42973]
3073   Was previously relative to the rustc's internal `CodeMap` struct which
3074   required the unstable library `libsyntax` to correctly use.
3075 - [`unused_results` lint no longer ignores booleans][43728]
3076
3077 [42565]: https://github.com/rust-lang/rust/pull/42565
3078 [42973]: https://github.com/rust-lang/rust/pull/42973
3079 [43348]: https://github.com/rust-lang/rust/pull/43348
3080 [43459]: https://github.com/rust-lang/rust/pull/43459
3081 [43506]: https://github.com/rust-lang/rust/pull/43506
3082 [43540]: https://github.com/rust-lang/rust/pull/43540
3083 [43690]: https://github.com/rust-lang/rust/pull/43690
3084 [43728]: https://github.com/rust-lang/rust/pull/43728
3085 [43838]: https://github.com/rust-lang/rust/pull/43838
3086 [43863]: https://github.com/rust-lang/rust/pull/43863
3087 [43880]: https://github.com/rust-lang/rust/pull/43880
3088 [43911]: https://github.com/rust-lang/rust/pull/43911
3089 [43916]: https://github.com/rust-lang/rust/pull/43916
3090 [43917]: https://github.com/rust-lang/rust/pull/43917
3091 [44204]: https://github.com/rust-lang/rust/pull/44204
3092 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
3093 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
3094 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3095 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
3096 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
3097 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
3098 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
3099 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
3100 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
3101
3102 Version 1.20.0 (2017-08-31)
3103 ===========================
3104
3105 Language
3106 --------
3107 - [Associated constants are now stabilised.][42809]
3108 - [A lot of macro bugs are now fixed.][42913]
3109
3110 Compiler
3111 --------
3112
3113 - [Struct fields are now properly coerced to the expected field type.][42807]
3114 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
3115   `wasm32-experimental-emscripten` target.
3116 - [Changed some of the error messages to be more helpful.][42033]
3117 - [Add support for RELRO(RELocation Read-Only) for platforms that support
3118   it.][43170]
3119 - [rustc now reports the total number of errors on compilation failure][43015]
3120   previously this was only the number of errors in the pass that failed.
3121 - [Expansion in rustc has been sped up 29x.][42533]
3122 - [added `msp430-none-elf` target.][43099]
3123 - [rustc will now suggest one-argument enum variant to fix type mismatch when
3124   applicable][43178]
3125 - [Fixes backtraces on Redox][43228]
3126 - [rustc now identifies different versions of same crate when absolute paths of
3127   different types match in an error message.][42826]
3128
3129 Libraries
3130 ---------
3131
3132
3133 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
3134 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
3135   tuples.][43011]
3136 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
3137   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
3138 - [Impl `Clone` for `DefaultHasher`.][42799]
3139 - [Impl `Sync` for `SyncSender`.][42397]
3140 - [Impl `FromStr` for `char`][42271]
3141 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
3142   NaN.][42431]
3143 - [allow messages in the `unimplemented!()` macro.][42155]
3144   ie. `unimplemented!("Waiting for 1.21 to be stable")`
3145 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
3146 - [Upgrade to Unicode 10.0.0][42999]
3147 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
3148 - [Skip the main thread's manual stack guard on Linux][43072]
3149 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
3150 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
3151   previously 2^15.
3152 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
3153
3154 Stabilized APIs
3155 ---------------
3156
3157 - [`CStr::into_c_string`]
3158 - [`CString::as_c_str`]
3159 - [`CString::into_boxed_c_str`]
3160 - [`Chain::get_mut`]
3161 - [`Chain::get_ref`]
3162 - [`Chain::into_inner`]
3163 - [`Option::get_or_insert_with`]
3164 - [`Option::get_or_insert`]
3165 - [`OsStr::into_os_string`]
3166 - [`OsString::into_boxed_os_str`]
3167 - [`Take::get_mut`]
3168 - [`Take::get_ref`]
3169 - [`Utf8Error::error_len`]
3170 - [`char::EscapeDebug`]
3171 - [`char::escape_debug`]
3172 - [`compile_error!`]
3173 - [`f32::from_bits`]
3174 - [`f32::to_bits`]
3175 - [`f64::from_bits`]
3176 - [`f64::to_bits`]
3177 - [`mem::ManuallyDrop`]
3178 - [`slice::sort_unstable_by_key`]
3179 - [`slice::sort_unstable_by`]
3180 - [`slice::sort_unstable`]
3181 - [`str::from_boxed_utf8_unchecked`]
3182 - [`str::as_bytes_mut`]
3183 - [`str::as_bytes_mut`]
3184 - [`str::from_utf8_mut`]
3185 - [`str::from_utf8_unchecked_mut`]
3186 - [`str::get_mut`]
3187 - [`str::get_unchecked_mut`]
3188 - [`str::get_unchecked`]
3189 - [`str::get`]
3190 - [`str::into_boxed_bytes`]
3191
3192
3193 Cargo
3194 -----
3195 - [Cargo API token location moved from `~/.cargo/config` to
3196   `~/.cargo/credentials`.][cargo/3978]
3197 - [Cargo will now build `main.rs` binaries that are in sub-directories of
3198   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
3199   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
3200 - [You can now specify version of a binary when installed through
3201   `cargo install` using `--vers`.][cargo/4229]
3202 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
3203   failure.][cargo/4248]
3204 - [Changed the convention around which file is the crate root.][cargo/4259]
3205 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
3206   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
3207
3208 Compatibility Notes
3209 -------------------
3210
3211 - [Functions with `'static` in their return types will now not be as usable as
3212   if they were using lifetime parameters instead.][42417]
3213 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
3214   takes the sign of NaN into account where previously didn't.][42430]
3215
3216 [42033]: https://github.com/rust-lang/rust/pull/42033
3217 [42155]: https://github.com/rust-lang/rust/pull/42155
3218 [42271]: https://github.com/rust-lang/rust/pull/42271
3219 [42397]: https://github.com/rust-lang/rust/pull/42397
3220 [42417]: https://github.com/rust-lang/rust/pull/42417
3221 [42430]: https://github.com/rust-lang/rust/pull/42430
3222 [42431]: https://github.com/rust-lang/rust/pull/42431
3223 [42533]: https://github.com/rust-lang/rust/pull/42533
3224 [42571]: https://github.com/rust-lang/rust/pull/42571
3225 [42613]: https://github.com/rust-lang/rust/pull/42613
3226 [42799]: https://github.com/rust-lang/rust/pull/42799
3227 [42807]: https://github.com/rust-lang/rust/pull/42807
3228 [42809]: https://github.com/rust-lang/rust/pull/42809
3229 [42822]: https://github.com/rust-lang/rust/pull/42822
3230 [42826]: https://github.com/rust-lang/rust/pull/42826
3231 [42854]: https://github.com/rust-lang/rust/pull/42854
3232 [42913]: https://github.com/rust-lang/rust/pull/42913
3233 [42999]: https://github.com/rust-lang/rust/pull/42999
3234 [43011]: https://github.com/rust-lang/rust/pull/43011
3235 [43015]: https://github.com/rust-lang/rust/pull/43015
3236 [43072]: https://github.com/rust-lang/rust/pull/43072
3237 [43077]: https://github.com/rust-lang/rust/pull/43077
3238 [43097]: https://github.com/rust-lang/rust/pull/43097
3239 [43099]: https://github.com/rust-lang/rust/pull/43099
3240 [43170]: https://github.com/rust-lang/rust/pull/43170
3241 [43178]: https://github.com/rust-lang/rust/pull/43178
3242 [43185]: https://github.com/rust-lang/rust/pull/43185
3243 [43228]: https://github.com/rust-lang/rust/pull/43228
3244 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
3245 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
3246 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
3247 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
3248 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
3249 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3250 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
3251 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
3252 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
3253 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
3254 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
3255 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
3256 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
3257 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
3258 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
3259 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
3260 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
3261 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
3262 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
3263 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
3264 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
3265 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
3266 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
3267 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
3268 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
3269 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
3270 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
3271 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
3272 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
3273 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
3274 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
3275 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
3276 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
3277 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
3278 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
3279 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
3280 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
3281 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
3282 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
3283
3284
3285 Version 1.19.0 (2017-07-20)
3286 ===========================
3287
3288 Language
3289 --------
3290
3291 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
3292   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
3293 - [Macro recursion limit increased to 1024 from 64.][41676]
3294 - [Added lint for detecting unused macros.][41907]
3295 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
3296   For example: `let x = loop { break 7; };`
3297 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
3298   contain `Copy` types and cannot have a `Drop` implementation.
3299   Example: `union Foo { bar: u8, baz: usize }`
3300 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
3301   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
3302
3303 Compiler
3304 --------
3305
3306 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
3307 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
3308   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
3309   you should use `--target armv7-linux-androideabi`.
3310 - [Fixed ICE when removing a source file between compilation sessions.][41873]
3311 - [Minor optimisation of string operations.][42037]
3312 - [Compiler error message is now `aborting due to previous error(s)` instead of
3313   `aborting due to N previous errors`][42150] This was previously inaccurate and
3314   would only count certain kinds of errors.
3315 - [The compiler now supports Visual Studio 2017][42225]
3316 - [The compiler is now built against LLVM 4.0.1 by default][42948]
3317 - [Added a lot][42264] of [new error codes][42302]
3318 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
3319   libraries with C Run-time Libraries(CRT) to be statically linked.
3320 - [Fixed various ARM codegen bugs][42740]
3321
3322 Libraries
3323 ---------
3324
3325 - [`String` now implements `FromIterator<Cow<'a, str>>` and
3326   `Extend<Cow<'a, str>>`][41449]
3327 - [`Vec` now implements `From<&mut [T]>`][41530]
3328 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
3329 - [`SplitWhitespace` now implements `Clone`][41659]
3330 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
3331   1.5x faster][41764]
3332 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
3333   macros, but for printing to stderr.
3334
3335 Stabilized APIs
3336 ---------------
3337
3338 - [`OsString::shrink_to_fit`]
3339 - [`cmp::Reverse`]
3340 - [`Command::envs`]
3341 - [`thread::ThreadId`]
3342
3343 Cargo
3344 -----
3345
3346 - [Build scripts can now add environment variables to the environment
3347   the crate is being compiled in.
3348   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
3349 - [Subcommands now replace the current process rather than spawning a new
3350   child process][cargo/3970]
3351 - [Workspace members can now accept glob file patterns][cargo/3979]
3352 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
3353   the members in a given workspace.][cargo/3988]
3354 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
3355 - [Target directory path is now in the cargo metadata][cargo/4022]
3356 - [Cargo no longer checks out a local working directory for the
3357   crates.io index][cargo/4026] This should provide smaller file size for the
3358   registry, and improve cloning times, especially on Windows machines.
3359 - [Added an `--exclude` option for excluding certain packages when using the
3360   `--all` option][cargo/4031]
3361 - [Cargo will now automatically retry when receiving a 5xx error
3362   from crates.io][cargo/4032]
3363 - [The `--features` option now accepts multiple comma or space
3364   delimited values.][cargo/4084]
3365 - [Added support for custom target specific runners][cargo/3954]
3366
3367 Misc
3368 ----
3369
3370 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
3371   Windows Debugger.
3372 - [Rust will now release XZ compressed packages][rust-installer/57]
3373 - [rustup will now prefer to download rust packages with
3374   XZ compression][rustup/1100] over GZip packages.
3375 - [Added the ability to escape `#` in rust documentation][41785] By adding
3376   additional `#`'s ie. `##` is now `#`
3377
3378 Compatibility Notes
3379 -------------------
3380
3381 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
3382 - [`-Z` flags are now no longer allowed to be used on the stable
3383   compiler.][41751] This has been a warning for a year previous to this.
3384 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
3385   longer works][42844]. Users should migrate to the built-in `check`
3386   command, which has been available since 1.16.
3387 - [Ending a float literal with `._` is now a hard error.
3388   Example: `42._` .][41946]
3389 - [Any use of a private `extern crate` outside of its module is now a
3390   hard error.][36886] This was previously a warning.
3391 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
3392   relative while the `::` prefix makes a path absolute, but was ignored and the
3393   path was relative regardless.
3394 - [Floating point constants in match patterns is now a hard error][36890]
3395   This was previously a warning.
3396 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
3397   match patterns is now a hard error][36891] This was previously a warning.
3398 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
3399   a warning.
3400 - [From the pound escape, lines consisting of multiple `#`s are
3401   now visible][41785]
3402 - [It is an error to re-export private enum variants][42460]. This is
3403   known to break a number of crates that depend on an older version of
3404   mustache.
3405 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
3406   to use it to find the linker, and the build will fail where it did
3407   not previously][42607]
3408
3409 [36886]: https://github.com/rust-lang/rust/issues/36886
3410 [36888]: https://github.com/rust-lang/rust/issues/36888
3411 [36890]: https://github.com/rust-lang/rust/issues/36890
3412 [36891]: https://github.com/rust-lang/rust/issues/36891
3413 [36892]: https://github.com/rust-lang/rust/issues/36892
3414 [37406]: https://github.com/rust-lang/rust/issues/37406
3415 [39983]: https://github.com/rust-lang/rust/pull/39983
3416 [41145]: https://github.com/rust-lang/rust/pull/41145
3417 [41192]: https://github.com/rust-lang/rust/pull/41192
3418 [41258]: https://github.com/rust-lang/rust/pull/41258
3419 [41370]: https://github.com/rust-lang/rust/pull/41370
3420 [41449]: https://github.com/rust-lang/rust/pull/41449
3421 [41530]: https://github.com/rust-lang/rust/pull/41530
3422 [41624]: https://github.com/rust-lang/rust/pull/41624
3423 [41656]: https://github.com/rust-lang/rust/pull/41656
3424 [41659]: https://github.com/rust-lang/rust/pull/41659
3425 [41676]: https://github.com/rust-lang/rust/pull/41676
3426 [41751]: https://github.com/rust-lang/rust/pull/41751
3427 [41764]: https://github.com/rust-lang/rust/pull/41764
3428 [41785]: https://github.com/rust-lang/rust/pull/41785
3429 [41873]: https://github.com/rust-lang/rust/pull/41873
3430 [41907]: https://github.com/rust-lang/rust/pull/41907
3431 [41946]: https://github.com/rust-lang/rust/pull/41946
3432 [42016]: https://github.com/rust-lang/rust/pull/42016
3433 [42037]: https://github.com/rust-lang/rust/pull/42037
3434 [42068]: https://github.com/rust-lang/rust/pull/42068
3435 [42150]: https://github.com/rust-lang/rust/pull/42150
3436 [42162]: https://github.com/rust-lang/rust/pull/42162
3437 [42225]: https://github.com/rust-lang/rust/pull/42225
3438 [42264]: https://github.com/rust-lang/rust/pull/42264
3439 [42302]: https://github.com/rust-lang/rust/pull/42302
3440 [42460]: https://github.com/rust-lang/rust/issues/42460
3441 [42607]: https://github.com/rust-lang/rust/issues/42607
3442 [42740]: https://github.com/rust-lang/rust/pull/42740
3443 [42844]: https://github.com/rust-lang/rust/issues/42844
3444 [42948]: https://github.com/rust-lang/rust/pull/42948
3445 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
3446 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
3447 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
3448 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
3449 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
3450 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
3451 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
3452 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
3453 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
3454 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
3455 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
3456 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
3457 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
3458 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
3459 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
3460 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
3461 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
3462 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
3463 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
3464 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
3465 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
3466 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
3467
3468
3469 Version 1.18.0 (2017-06-08)
3470 ===========================
3471
3472 Language
3473 --------
3474
3475 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
3476   make the item visible to just that module tree. Also accepts the keyword
3477   `crate` to make something public to the whole crate but not users of the
3478   library. Example: `pub(crate) mod utils;`. [RFC 1422].
3479 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
3480   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
3481 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
3482   types like `Write + Send`, trailing `+` are now supported in trait objects,
3483   and better error reporting for trait objects starting with `?Sized`.
3484 - [0e+10 is now a valid floating point literal][40589]
3485 - [Now warns if you bind a lifetime parameter to 'static][40734]
3486 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
3487   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
3488   representation in some cases.][40377]
3489
3490 Compiler
3491 --------
3492
3493 - [rustc can now emit mir with `--emit mir`][39891]
3494 - [Improved LLVM IR for trivial functions][40367]
3495 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
3496 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
3497   opportunities found through profiling
3498 - [Improved backtrace formatting when panicking][38165]
3499
3500 Libraries
3501 ---------
3502
3503 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
3504   iterator hasn't been advanced the original `Vec` is reassembled with no actual
3505   iteration or reallocation.
3506 - [Simplified HashMap Bucket interface][40561] provides performance
3507   improvements for iterating and cloning.
3508 - [Specialize Vec::from_elem to use calloc][40409]
3509 - [Fixed Race condition in fs::create_dir_all][39799]
3510 - [No longer caching stdio on Windows][40516]
3511 - [Optimized insertion sort in slice][40807] insertion sort in some cases
3512   2.50%~ faster and in one case now 12.50% faster.
3513 - [Optimized `AtomicBool::fetch_nand`][41143]
3514
3515 Stabilized APIs
3516 ---------------
3517
3518 - [`Child::try_wait`]
3519 - [`HashMap::retain`]
3520 - [`HashSet::retain`]
3521 - [`PeekMut::pop`]
3522 - [`TcpStream::peek`]
3523 - [`UdpSocket::peek`]
3524 - [`UdpSocket::peek_from`]
3525
3526 Cargo
3527 -----
3528
3529 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
3530   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
3531 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
3532 - [Added Android build support][cargo/3885]
3533 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
3534   of a certain type, for example `cargo build --bins` will build all
3535   binaries.
3536 - [Added support for haiku][cargo/3952]
3537
3538 Misc
3539 ----
3540
3541 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
3542 - [Added rust-windbg script for better debugging on Windows][39983]
3543 - [Rust now uses the official cross compiler for NetBSD][40612]
3544 - [rustdoc now accepts `#` at the start of files][40828]
3545 - [Fixed jemalloc support for musl][41168]
3546
3547 Compatibility Notes
3548 -------------------
3549
3550 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
3551   always placed after the sign if it exists and before the digits. With the `#`
3552   flag the zeroes are placed after the prefix and before the digits.
3553 - [Due to the struct field optimisation][40377], using `transmute` on structs
3554   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
3555   always been undefined behavior, but is now more likely to break in practice.
3556 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
3557   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
3558   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
3559 - [Overlapping inherent `impl`s are now a hard error][40728]
3560 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
3561 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
3562   `out.asm` and `out.ll` instead of only one of the filetypes.
3563 - [ calling a function that returns `Self` will no longer work][41805] when
3564   the size of `Self` cannot be statically determined.
3565 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
3566   this has caused a few regressions namely:
3567
3568   - Changed the link order of local static/dynamic libraries (respecting the
3569     order on given rather than having the compiler reorder).
3570   - Changed how MinGW is linked, native code linked to dynamic libraries
3571     may require manually linking to the gcc support library (for the native
3572     code itself)
3573
3574 [38165]: https://github.com/rust-lang/rust/pull/38165
3575 [39799]: https://github.com/rust-lang/rust/pull/39799
3576 [39891]: https://github.com/rust-lang/rust/pull/39891
3577 [39983]: https://github.com/rust-lang/rust/pull/39983
3578 [40043]: https://github.com/rust-lang/rust/pull/40043
3579 [40241]: https://github.com/rust-lang/rust/pull/40241
3580 [40338]: https://github.com/rust-lang/rust/pull/40338
3581 [40367]: https://github.com/rust-lang/rust/pull/40367
3582 [40377]: https://github.com/rust-lang/rust/pull/40377
3583 [40409]: https://github.com/rust-lang/rust/pull/40409
3584 [40516]: https://github.com/rust-lang/rust/pull/40516
3585 [40556]: https://github.com/rust-lang/rust/pull/40556
3586 [40561]: https://github.com/rust-lang/rust/pull/40561
3587 [40589]: https://github.com/rust-lang/rust/pull/40589
3588 [40612]: https://github.com/rust-lang/rust/pull/40612
3589 [40723]: https://github.com/rust-lang/rust/pull/40723
3590 [40728]: https://github.com/rust-lang/rust/pull/40728
3591 [40731]: https://github.com/rust-lang/rust/pull/40731
3592 [40734]: https://github.com/rust-lang/rust/pull/40734
3593 [40805]: https://github.com/rust-lang/rust/pull/40805
3594 [40807]: https://github.com/rust-lang/rust/pull/40807
3595 [40828]: https://github.com/rust-lang/rust/pull/40828
3596 [40870]: https://github.com/rust-lang/rust/pull/40870
3597 [41085]: https://github.com/rust-lang/rust/pull/41085
3598 [41143]: https://github.com/rust-lang/rust/pull/41143
3599 [41168]: https://github.com/rust-lang/rust/pull/41168
3600 [41270]: https://github.com/rust-lang/rust/issues/41270
3601 [41469]: https://github.com/rust-lang/rust/pull/41469
3602 [41805]: https://github.com/rust-lang/rust/issues/41805
3603 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
3604 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
3605 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
3606 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
3607 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
3608 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
3609 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
3610 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
3611 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
3612 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
3613 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
3614 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
3615 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
3616 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
3617
3618
3619 Version 1.17.0 (2017-04-27)
3620 ===========================
3621
3622 Language
3623 --------
3624
3625 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
3626 * [Fields of structs may be initialized without duplicating the field/variable
3627   names][39761]. [RFC 1682]
3628 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
3629 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3630   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
3631   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
3632   `'b`. Soundness fix.
3633 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
3634 * [Static variables may contain references to other statics][40027]
3635
3636 Compiler
3637 --------
3638
3639 * [Exit quickly on only `--emit dep-info`][40336]
3640 * [Make `-C relocation-model` more correctly determine whether the linker
3641   creates a position-independent executable][40245]
3642 * [Add `-C overflow-checks` to directly control whether integer overflow
3643   panics][40037]
3644 * [The rustc type checker now checks items on demand instead of in a single
3645   in-order pass][40008]. This is mostly an internal refactoring in support of
3646   future work, including incremental type checking, but also resolves [RFC
3647   1647], allowing `Self` to appear in `impl` `where` clauses.
3648 * [Optimize vtable loads][39995]
3649 * [Turn off vectorization for Emscripten targets][39990]
3650 * [Provide suggestions for unknown macros imported with `use`][39953]
3651 * [Fix ICEs in path resolution][39939]
3652 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
3653 * [Add clearer error message using `&str + &str`][39116]
3654
3655 Stabilized APIs
3656 ---------------
3657
3658 * [`Arc::into_raw`]
3659 * [`Arc::from_raw`]
3660 * [`Arc::ptr_eq`]
3661 * [`Rc::into_raw`]
3662 * [`Rc::from_raw`]
3663 * [`Rc::ptr_eq`]
3664 * [`Ordering::then`]
3665 * [`Ordering::then_with`]
3666 * [`BTreeMap::range`]
3667 * [`BTreeMap::range_mut`]
3668 * [`collections::Bound`]
3669 * [`process::abort`]
3670 * [`ptr::read_unaligned`]
3671 * [`ptr::write_unaligned`]
3672 * [`Result::expect_err`]
3673 * [`Cell::swap`]
3674 * [`Cell::replace`]
3675 * [`Cell::into_inner`]
3676 * [`Cell::take`]
3677
3678 Libraries
3679 ---------
3680
3681 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
3682 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
3683 * [`String` implements `FromIterator<&char>`][40028]
3684 * `Box` [implements][40009] a number of new conversions:
3685   `From<Box<str>> for String`,
3686   `From<Box<[T]>> for Vec<T>`,
3687   `From<Box<CStr>> for CString`,
3688   `From<Box<OsStr>> for OsString`,
3689   `From<Box<Path>> for PathBuf`,
3690   `Into<Box<str>> for String`,
3691   `Into<Box<[T]>> for Vec<T>`,
3692   `Into<Box<CStr>> for CString`,
3693   `Into<Box<OsStr>> for OsString`,
3694   `Into<Box<Path>> for PathBuf`,
3695   `Default for Box<str>`,
3696   `Default for Box<CStr>`,
3697   `Default for Box<OsStr>`,
3698   `From<&CStr> for Box<CStr>`,
3699   `From<&OsStr> for Box<OsStr>`,
3700   `From<&Path> for Box<Path>`
3701 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
3702 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
3703 * [Slightly optimize `slice::sort`][39538]
3704 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
3705 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
3706   `Box<str>` implements `From<&str>`][39438]
3707 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
3708   `From<(I, u16)> where I: Into<IpAddr>`][39372]
3709 * [`format!` estimates the needed capacity before writing a string][39356]
3710 * [Support unprivileged symlink creation in Windows][38921]
3711 * [`PathBuf` implements `Default`][38764]
3712 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
3713 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
3714   and poor hash functions.
3715
3716 Cargo
3717 -----
3718
3719 * [Add `cargo check --all`][cargo/3731]
3720 * [Add an option to ignore SSL revocation checking][cargo/3699]
3721 * [Add `cargo run --package`][cargo/3691]
3722 * [Add `required_features`][cargo/3667]
3723 * [Assume `build.rs` is a build script][cargo/3664]
3724 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
3725
3726 Misc
3727 ----
3728
3729 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
3730   `rustbook`][39633]
3731 * [The "Unstable Book" documents nightly-only features][ubook]
3732 * [Improve the style of the sidebar in rustdoc output][40265]
3733 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
3734 * [Fix MSP430 breakage due to `i128`][40257]
3735 * [Preliminary Solaris/SPARCv9 support][39903]
3736 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
3737   run without installing the MSVC runtime.
3738 * [`rustdoc --test` includes file names in test names][39788]
3739 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
3740   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
3741 * [Initial support for `aarch64-unknown-freebsd`][39491]
3742 * [Initial support for `i686-unknown-netbsd`][39426]
3743 * [This release no longer includes the old makefile build system][39431]. Rust
3744   is built with a custom build system, written in Rust, and with Cargo.
3745 * [Add Debug implementations for libcollection structs][39002]
3746 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
3747 * [`--test-threads=0` produces an error][38945]
3748 * [`rustup` installs documentation by default][40526]
3749 * [The Rust source includes NatVis visualizations][39843]. These can be used by
3750   WinDbg and Visual Studio to improve the debugging experience.
3751
3752 Compatibility Notes
3753 -------------------
3754
3755 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
3756   workaround, either use MSVC 2015 or run vcvars.bat.
3757 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3758   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
3759   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
3760   fix.
3761 * [`format!` and `Display::to_string` panic if an underlying formatting
3762   implementation returns an error][40117]. Previously the error was silently
3763   ignored. It is incorrect for `write_fmt` to return an error when writing
3764   to a string.
3765 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
3766   crates were marked stable and could be accessed from the stable toolchain.
3767 * [Rust git source no longer includes vendored crates][39728]. Those that need
3768   to build with vendored crates should build from release tarballs.
3769 * [Fix inert attributes from `proc_macro_derives`][39572]
3770 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
3771   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
3772   build system.
3773 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
3774   existing code generally ignores the type of dead-code unless a type-hint is
3775   provided; this can cause surprising inference interactions particularly around
3776   defaulting. The new code uniformly ignores the result type of dead-code.
3777 * [Tuple-struct constructors with private fields are no longer visible][38932]
3778 * [Lifetime parameters that do not appear in the arguments are now considered
3779   early-bound][38897], resolving a soundness bug (#[32330]). The
3780   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
3781   April of 2016.
3782 * [rustdoc: fix doctests with non-feature crate attributes][38161]
3783 * [Make transmuting from fn item types to pointer-sized types a hard
3784   error][34198]
3785
3786 [27787]: https://github.com/rust-lang/rust/issues/27787
3787 [32330]: https://github.com/rust-lang/rust/issues/32330
3788 [34198]: https://github.com/rust-lang/rust/pull/34198
3789 [38161]: https://github.com/rust-lang/rust/pull/38161
3790 [38368]: https://github.com/rust-lang/rust/pull/38368
3791 [38584]: https://github.com/rust-lang/rust/issues/38584
3792 [38661]: https://github.com/rust-lang/rust/pull/38661
3793 [38764]: https://github.com/rust-lang/rust/pull/38764
3794 [38864]: https://github.com/rust-lang/rust/issues/38864
3795 [38897]: https://github.com/rust-lang/rust/pull/38897
3796 [38921]: https://github.com/rust-lang/rust/pull/38921
3797 [38932]: https://github.com/rust-lang/rust/pull/38932
3798 [38945]: https://github.com/rust-lang/rust/pull/38945
3799 [38981]: https://github.com/rust-lang/rust/pull/38981
3800 [39002]: https://github.com/rust-lang/rust/pull/39002
3801 [39116]: https://github.com/rust-lang/rust/pull/39116
3802 [39193]: https://github.com/rust-lang/rust/pull/39193
3803 [39265]: https://github.com/rust-lang/rust/pull/39265
3804 [39356]: https://github.com/rust-lang/rust/pull/39356
3805 [39372]: https://github.com/rust-lang/rust/pull/39372
3806 [39426]: https://github.com/rust-lang/rust/pull/39426
3807 [39431]: https://github.com/rust-lang/rust/pull/39431
3808 [39438]: https://github.com/rust-lang/rust/pull/39438
3809 [39440]: https://github.com/rust-lang/rust/pull/39440
3810 [39485]: https://github.com/rust-lang/rust/pull/39485
3811 [39491]: https://github.com/rust-lang/rust/pull/39491
3812 [39518]: https://github.com/rust-lang/rust/pull/39518
3813 [39538]: https://github.com/rust-lang/rust/pull/39538
3814 [39572]: https://github.com/rust-lang/rust/pull/39572
3815 [39633]: https://github.com/rust-lang/rust/pull/39633
3816 [39642]: https://github.com/rust-lang/rust/pull/39642
3817 [39728]: https://github.com/rust-lang/rust/pull/39728
3818 [39761]: https://github.com/rust-lang/rust/pull/39761
3819 [39788]: https://github.com/rust-lang/rust/pull/39788
3820 [39793]: https://github.com/rust-lang/rust/pull/39793
3821 [39837]: https://github.com/rust-lang/rust/pull/39837
3822 [39843]: https://github.com/rust-lang/rust/pull/39843
3823 [39851]: https://github.com/rust-lang/rust/pull/39851
3824 [39903]: https://github.com/rust-lang/rust/pull/39903
3825 [39939]: https://github.com/rust-lang/rust/pull/39939
3826 [39953]: https://github.com/rust-lang/rust/pull/39953
3827 [39960]: https://github.com/rust-lang/rust/pull/39960
3828 [39990]: https://github.com/rust-lang/rust/pull/39990
3829 [39995]: https://github.com/rust-lang/rust/pull/39995
3830 [40008]: https://github.com/rust-lang/rust/pull/40008
3831 [40009]: https://github.com/rust-lang/rust/pull/40009
3832 [40027]: https://github.com/rust-lang/rust/pull/40027
3833 [40028]: https://github.com/rust-lang/rust/pull/40028
3834 [40037]: https://github.com/rust-lang/rust/pull/40037
3835 [40117]: https://github.com/rust-lang/rust/pull/40117
3836 [40166]: https://github.com/rust-lang/rust/pull/40166
3837 [40245]: https://github.com/rust-lang/rust/pull/40245
3838 [40257]: https://github.com/rust-lang/rust/pull/40257
3839 [40261]: https://github.com/rust-lang/rust/pull/40261
3840 [40265]: https://github.com/rust-lang/rust/pull/40265
3841 [40319]: https://github.com/rust-lang/rust/pull/40319
3842 [40336]: https://github.com/rust-lang/rust/pull/40336
3843 [40526]: https://github.com/rust-lang/rust/pull/40526
3844 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
3845 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
3846 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
3847 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
3848 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
3849 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
3850 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
3851 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
3852 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
3853 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
3854 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
3855 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
3856 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
3857 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
3858 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
3859 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
3860 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
3861 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
3862 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
3863 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
3864 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
3865 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
3866 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
3867 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
3868 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
3869 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
3870 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
3871 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
3872 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
3873 [mdbook]: https://crates.io/crates/mdbook
3874 [ubook]: https://doc.rust-lang.org/unstable-book/
3875
3876
3877 Version 1.16.0 (2017-03-16)
3878 ===========================
3879
3880 Language
3881 --------
3882
3883 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3884 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3885   match patterns][38069]
3886 * [Clean up semantics of `self` in an import list][38313]
3887 * [`Self` may appear in `impl` headers][38920]
3888 * [`Self` may appear in struct expressions][39282]
3889
3890 Compiler
3891 --------
3892
3893 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
3894   a `.rmeta` file containing only crate metadata][38571]. This can be
3895   used by tools like the Rust Language Service to perform
3896   metadata-only builds.
3897 * [Levenshtein based typo suggestions now work in most places, while
3898   previously they worked only for fields and sometimes for local
3899   variables][38927]. Together with the overhaul of "no
3900   resolution"/"unexpected resolution" errors (#[38154]) they result in
3901   large and systematic improvement in resolution diagnostics.
3902 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
3903   `U`][38670]
3904 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
3905 * [`rustc` no longer attempts to provide "consider using an explicit
3906   lifetime" suggestions][37057]. They were inaccurate.
3907
3908 Stabilized APIs
3909 ---------------
3910
3911 * [`VecDeque::truncate`]
3912 * [`VecDeque::resize`]
3913 * [`String::insert_str`]
3914 * [`Duration::checked_add`]
3915 * [`Duration::checked_sub`]
3916 * [`Duration::checked_div`]
3917 * [`Duration::checked_mul`]
3918 * [`str::replacen`]
3919 * [`str::repeat`]
3920 * [`SocketAddr::is_ipv4`]
3921 * [`SocketAddr::is_ipv6`]
3922 * [`IpAddr::is_ipv4`]
3923 * [`IpAddr::is_ipv6`]
3924 * [`Vec::dedup_by`]
3925 * [`Vec::dedup_by_key`]
3926 * [`Result::unwrap_or_default`]
3927 * [`<*const T>::wrapping_offset`]
3928 * [`<*mut T>::wrapping_offset`]
3929 * `CommandExt::creation_flags`
3930 * [`File::set_permissions`]
3931 * [`String::split_off`]
3932
3933 Libraries
3934 ---------
3935
3936 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
3937   their argument by `Borrow` parameter][37761]
3938 * [All public types in std implement `Debug`][38006]
3939 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
3940 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
3941 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3942   Windows][38274]
3943 * [std: Fix partial writes in `LineWriter`][38062]
3944 * [std: Clamp max read/write sizes on Unix][38062]
3945 * [Use more specific panic message for `&str` slicing errors][38066]
3946 * [`TcpListener::set_only_v6` is deprecated][38304]. This
3947   functionality cannot be achieved in std currently.
3948 * [`writeln!`, like `println!`, now accepts a form with no string
3949   or formatting arguments, to just print a newline][38469]
3950 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
3951 * [Reduce the size of static data in `std_unicode::tables`][38781]
3952 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
3953   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
3954   `Display`][38909]
3955 * [`Duration` implements `Sum`][38712]
3956 * [`String` implements `ToSocketAddrs`][39048]
3957
3958 Cargo
3959 -----
3960
3961 * [The `cargo check` command does a type check of a project without
3962   building it][cargo/3296]
3963 * [crates.io will display CI badges from Travis and AppVeyor, if
3964   specified in Cargo.toml][cargo/3546]
3965 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
3966 * [Compilation profiles accept integer values for `debug`, in addition
3967   to `true` and `false`. These are passed to `rustc` as the value to
3968   `-C debuginfo`][cargo/3534]
3969 * [Implement `cargo --version --verbose`][cargo/3604]
3970 * [All builds now output 'dep-info' build dependencies compatible with
3971   make and ninja][cargo/3557]
3972 * [Build all workspace members with `build --all`][cargo/3511]
3973 * [Document all workspace members with `doc --all`][cargo/3515]
3974 * [Path deps outside workspace are not members][cargo/3443]
3975
3976 Misc
3977 ----
3978
3979 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
3980   the path to the Rust implementation][38589]
3981 * [The `armv7-linux-androideabi` target no longer enables NEON
3982   extensions, per Google's ABI guide][38413]
3983 * [The stock standard library can be compiled for Redox OS][38401]
3984 * [Rust has initial SPARC support][38726]. Tier 3. No builds
3985   available.
3986 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
3987   builds available.
3988 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
3989
3990 Compatibility Notes
3991 -------------------
3992
3993 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3994   match patterns][38069]
3995 * In this release, references to uninhabited types can not be
3996   pattern-matched. This was accidentally allowed in 1.15.
3997 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3998 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3999   Windows][38274]
4000 * [Clean up semantics of `self` in an import list][38313]
4001 * Reimplemented lifetime elision. This change was almost entirely compatible
4002   with existing code, but it did close a number of small bugs and loopholes,
4003   as well as being more accepting in some other [cases][41105].
4004
4005 [37057]: https://github.com/rust-lang/rust/pull/37057
4006 [37761]: https://github.com/rust-lang/rust/pull/37761
4007 [38006]: https://github.com/rust-lang/rust/pull/38006
4008 [38051]: https://github.com/rust-lang/rust/pull/38051
4009 [38062]: https://github.com/rust-lang/rust/pull/38062
4010 [38062]: https://github.com/rust-lang/rust/pull/38622
4011 [38066]: https://github.com/rust-lang/rust/pull/38066
4012 [38069]: https://github.com/rust-lang/rust/pull/38069
4013 [38131]: https://github.com/rust-lang/rust/pull/38131
4014 [38154]: https://github.com/rust-lang/rust/pull/38154
4015 [38274]: https://github.com/rust-lang/rust/pull/38274
4016 [38304]: https://github.com/rust-lang/rust/pull/38304
4017 [38313]: https://github.com/rust-lang/rust/pull/38313
4018 [38314]: https://github.com/rust-lang/rust/pull/38314
4019 [38327]: https://github.com/rust-lang/rust/pull/38327
4020 [38401]: https://github.com/rust-lang/rust/pull/38401
4021 [38413]: https://github.com/rust-lang/rust/pull/38413
4022 [38469]: https://github.com/rust-lang/rust/pull/38469
4023 [38559]: https://github.com/rust-lang/rust/pull/38559
4024 [38571]: https://github.com/rust-lang/rust/pull/38571
4025 [38580]: https://github.com/rust-lang/rust/pull/38580
4026 [38589]: https://github.com/rust-lang/rust/pull/38589
4027 [38670]: https://github.com/rust-lang/rust/pull/38670
4028 [38712]: https://github.com/rust-lang/rust/pull/38712
4029 [38726]: https://github.com/rust-lang/rust/pull/38726
4030 [38781]: https://github.com/rust-lang/rust/pull/38781
4031 [38798]: https://github.com/rust-lang/rust/pull/38798
4032 [38909]: https://github.com/rust-lang/rust/pull/38909
4033 [38920]: https://github.com/rust-lang/rust/pull/38920
4034 [38927]: https://github.com/rust-lang/rust/pull/38927
4035 [39048]: https://github.com/rust-lang/rust/pull/39048
4036 [39282]: https://github.com/rust-lang/rust/pull/39282
4037 [39379]: https://github.com/rust-lang/rust/pull/39379
4038 [41105]: https://github.com/rust-lang/rust/issues/41105
4039 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4040 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4041 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
4042 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
4043 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
4044 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
4045 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
4046 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
4047 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
4048 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
4049 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
4050 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
4051 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
4052 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
4053 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
4054 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
4055 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
4056 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
4057 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
4058 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
4059 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
4060 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
4061 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
4062 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
4063 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
4064 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
4065 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
4066 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
4067 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
4068 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4069
4070
4071 Version 1.15.1 (2017-02-09)
4072 ===========================
4073
4074 * [Fix IntoIter::as_mut_slice's signature][39466]
4075 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
4076
4077 [39466]: https://github.com/rust-lang/rust/pull/39466
4078 [39523]: https://github.com/rust-lang/rust/pull/39523
4079
4080
4081 Version 1.15.0 (2017-02-02)
4082 ===========================
4083
4084 Language
4085 --------
4086
4087 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
4088   stable. This allows popular code-generating crates like Serde and Diesel to
4089   work ergonomically. [RFC 1681].
4090 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
4091   with curly braces][36868]. Part of [RFC 1506].
4092 * [A number of minor changes to name resolution have been activated][37127].
4093   They add up to more consistent semantics, allowing for future evolution of
4094   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4095   details of what is different. The breaking changes here have been transitioned
4096   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4097 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
4098   bounds][38279]
4099 * [`?Sized` can be used in `where` clauses][37791]
4100 * [There is now a limit on the size of monomorphized types and it can be
4101   modified with the `#![type_size_limit]` crate attribute, similarly to
4102   the `#![recursion_limit]` attribute][37789]
4103
4104 Compiler
4105 --------
4106
4107 * [On Windows, the compiler will apply dllimport attributes when linking to
4108   extern functions][37973]. Additional attributes and flags can control which
4109   library kind is linked and its name. [RFC 1717].
4110 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4111 * [The `--test` flag works with procedural macro crates][38107]
4112 * [Fix `extern "aapcs" fn` ABI][37814]
4113 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
4114 * [The `format!` expander recognizes incorrect `printf` and shell-style
4115   formatting directives and suggests the correct format][37613].
4116 * [Only report one error for all unused imports in an import list][37456]
4117
4118 Compiler Performance
4119 --------------------
4120
4121 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
4122 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
4123 * [Don't clone in `UnificationTable::probe`][37848]
4124 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
4125 * [Use small vectors in type walker][37760]
4126 * [Macro expansion performance was improved][37701]
4127 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
4128 * [Replace FNV with a faster hash function][37229]
4129
4130 Stabilized APIs
4131 ---------------
4132
4133 * [`std::iter::Iterator::min_by`]
4134 * [`std::iter::Iterator::max_by`]
4135 * [`std::os::*::fs::FileExt`]
4136 * [`std::sync::atomic::Atomic*::get_mut`]
4137 * [`std::sync::atomic::Atomic*::into_inner`]
4138 * [`std::vec::IntoIter::as_slice`]
4139 * [`std::vec::IntoIter::as_mut_slice`]
4140 * [`std::sync::mpsc::Receiver::try_iter`]
4141 * [`std::os::unix::process::CommandExt::before_exec`]
4142 * [`std::rc::Rc::strong_count`]
4143 * [`std::rc::Rc::weak_count`]
4144 * [`std::sync::Arc::strong_count`]
4145 * [`std::sync::Arc::weak_count`]
4146 * [`std::char::encode_utf8`]
4147 * [`std::char::encode_utf16`]
4148 * [`std::cell::Ref::clone`]
4149 * [`std::io::Take::into_inner`]
4150
4151 Libraries
4152 ---------
4153
4154 * [The standard sorting algorithm has been rewritten for dramatic performance
4155   improvements][38192]. It is a hybrid merge sort, drawing influences from
4156   Timsort. Previously it was a naive merge sort.
4157 * [`Iterator::nth` no longer has a `Sized` bound][38134]
4158 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
4159   performance.
4160 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
4161   and `char_indices().last()`][37882]
4162 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
4163 * [Chinese characters display correctly in `fmt::Debug`][37855]
4164 * [Derive `Default` for `Duration`][37699]
4165 * [Support creation of anonymous pipes on WinXP/2k][37677]
4166 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
4167 * [Don't pass overlapped handles to processes][38835]
4168
4169 Cargo
4170 -----
4171
4172 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4173   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4174   should instead check the variable at runtime with `std::env`. That the value
4175   was set at build time was a bug, and incorrect when cross-compiling. This
4176   change is known to cause breakage.
4177 * [Add `--all` flag to `cargo test`][cargo/3221]
4178 * [Compile statically against the MSVC CRT][cargo/3363]
4179 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
4180 * [Link OpenSSL statically on OSX][cargo/3311]
4181 * [Apply new fingerprinting to build dir outputs][cargo/3310]
4182 * [Test for bad path overrides with summaries][cargo/3336]
4183 * [Require `cargo install --vers` to take a semver version][cargo/3338]
4184 * [Fix retrying crate downloads for network errors][cargo/3348]
4185 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
4186 * [Emit more info on --message-format=json][cargo/3319]
4187 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
4188 * [Don't ignore errors in workspace manifest][cargo/3409]
4189 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
4190
4191 Tooling
4192 -------
4193
4194 * [Test runners (binaries built with `--test`) now support a `--list` argument
4195   that lists the tests it contains][38185]
4196 * [Test runners now support a `--exact` argument that makes the test filter
4197   match exactly, instead of matching only a substring of the test name][38181]
4198 * [rustdoc supports a `--playground-url` flag][37763]
4199 * [rustdoc provides more details about `#[should_panic]` errors][37749]
4200
4201 Misc
4202 ----
4203
4204 * [The Rust build system is now written in Rust][37817]. The Makefiles may
4205   continue to be used in this release by passing `--disable-rustbuild` to the
4206   configure script, but they will be deleted soon. Note that the new build
4207   system uses a different on-disk layout that will likely affect any scripts
4208   building Rust.
4209 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
4210   releases.
4211 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
4212 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
4213   releases.
4214
4215 Compatibility Notes
4216 -------------------
4217
4218 * [A number of minor changes to name resolution have been activated][37127].
4219   They add up to more consistent semantics, allowing for future evolution of
4220   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4221   details of what is different. The breaking changes here have been transitioned
4222   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4223 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4224   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4225   should instead check the variable at runtime with `std::env`. That the value
4226   was set at build time was a bug, and incorrect when cross-compiling. This
4227   change is known to cause breakage.
4228 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
4229   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
4230   1.10 and is now an error by default. It will become a hard error in the near
4231   future.
4232 * [The semantics relating modules to file system directories are changing in
4233   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
4234   lint, which is a warning in this release, and will become a hard error in the
4235   future.
4236 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4237 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
4238   the underlying iterator][37834]
4239
4240 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
4241 [33685]: https://github.com/rust-lang/rust/issues/33685
4242 [36868]: https://github.com/rust-lang/rust/pull/36868
4243 [37127]: https://github.com/rust-lang/rust/pull/37127
4244 [37229]: https://github.com/rust-lang/rust/pull/37229
4245 [37456]: https://github.com/rust-lang/rust/pull/37456
4246 [37527]: https://github.com/rust-lang/rust/pull/37527
4247 [37602]: https://github.com/rust-lang/rust/pull/37602
4248 [37613]: https://github.com/rust-lang/rust/pull/37613
4249 [37615]: https://github.com/rust-lang/rust/pull/37615
4250 [37636]: https://github.com/rust-lang/rust/pull/37636
4251 [37627]: https://github.com/rust-lang/rust/pull/37627
4252 [37642]: https://github.com/rust-lang/rust/pull/37642
4253 [37677]: https://github.com/rust-lang/rust/pull/37677
4254 [37699]: https://github.com/rust-lang/rust/pull/37699
4255 [37701]: https://github.com/rust-lang/rust/pull/37701
4256 [37705]: https://github.com/rust-lang/rust/pull/37705
4257 [37749]: https://github.com/rust-lang/rust/pull/37749
4258 [37760]: https://github.com/rust-lang/rust/pull/37760
4259 [37763]: https://github.com/rust-lang/rust/pull/37763
4260 [37764]: https://github.com/rust-lang/rust/pull/37764
4261 [37789]: https://github.com/rust-lang/rust/pull/37789
4262 [37791]: https://github.com/rust-lang/rust/pull/37791
4263 [37814]: https://github.com/rust-lang/rust/pull/37814
4264 [37817]: https://github.com/rust-lang/rust/pull/37817
4265 [37834]: https://github.com/rust-lang/rust/pull/37834
4266 [37848]: https://github.com/rust-lang/rust/pull/37848
4267 [37855]: https://github.com/rust-lang/rust/pull/37855
4268 [37882]: https://github.com/rust-lang/rust/pull/37882
4269 [37888]: https://github.com/rust-lang/rust/pull/37888
4270 [37973]: https://github.com/rust-lang/rust/pull/37973
4271 [37979]: https://github.com/rust-lang/rust/pull/37979
4272 [38086]: https://github.com/rust-lang/rust/pull/38086
4273 [38107]: https://github.com/rust-lang/rust/pull/38107
4274 [38117]: https://github.com/rust-lang/rust/pull/38117
4275 [38134]: https://github.com/rust-lang/rust/pull/38134
4276 [38146]: https://github.com/rust-lang/rust/pull/38146
4277 [38181]: https://github.com/rust-lang/rust/pull/38181
4278 [38182]: https://github.com/rust-lang/rust/pull/38182
4279 [38185]: https://github.com/rust-lang/rust/pull/38185
4280 [38192]: https://github.com/rust-lang/rust/pull/38192
4281 [38279]: https://github.com/rust-lang/rust/pull/38279
4282 [38835]: https://github.com/rust-lang/rust/pull/38835
4283 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4284 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4285 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
4286 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
4287 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
4288 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
4289 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
4290 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
4291 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
4292 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
4293 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
4294 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
4295 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
4296 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
4297 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
4298 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
4299 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
4300 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
4301 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
4302 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
4303 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
4304 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
4305 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
4306 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
4307 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
4308 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
4309 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
4310 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
4311 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
4312 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
4313 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
4314 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
4315 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
4316 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
4317 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
4318 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
4319 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
4320 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
4321
4322
4323 Version 1.14.0 (2016-12-22)
4324 ===========================
4325
4326 Language
4327 --------
4328
4329 * [`..` matches multiple tuple fields in enum variants, structs
4330   and tuples][36843]. [RFC 1492].
4331 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
4332 * [`use *` and `use ::*` both glob-import from the crate root][37367]
4333 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
4334   dereferencing][36822]
4335
4336 Compiler
4337 --------
4338
4339 * [Mark enums with non-zero discriminant as non-zero][37224]
4340 * [Lower-case `static mut` names are linted like other
4341   statics and consts][37162]
4342 * [Fix ICE on some macros in const integer positions
4343    (e.g. `[u8; m!()]`)][36819]
4344 * [Improve error message and snippet for "did you mean `x`"][36798]
4345 * [Add a panic-strategy field to the target specification][36794]
4346 * [Include LLVM version in `--version --verbose`][37200]
4347
4348 Compile-time Optimizations
4349 --------------------------
4350
4351 * [Improve macro expansion performance][37569]
4352 * [Shrink `Expr_::ExprInlineAsm`][37445]
4353 * [Replace all uses of SHA-256 with BLAKE2b][37439]
4354 * [Reduce the number of bytes hashed by `IchHasher`][37427]
4355 * [Avoid more allocations when compiling html5ever][37373]
4356 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
4357 * [Avoid some allocations in the macro parser][37318]
4358 * [Use a faster deflate setting][37298]
4359 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
4360   during interning of slices][37270]
4361 * [Optimize `write_metadata`][37267]
4362 * [Don't process obligation forest cycles when stalled][37231]
4363 * [Avoid many `CrateConfig` clones][37161]
4364 * [Optimize `Substs::super_fold_with`][37108]
4365 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
4366 * [Speed up `plug_leaks`][36917]
4367
4368 Libraries
4369 ---------
4370
4371 * [`println!()`, with no arguments, prints newline][36825].
4372   Previously, an empty string was required to achieve the same.
4373 * [`Wrapping` impls standard binary and unary operators, as well as
4374    the `Sum` and `Product` iterators][37356]
4375 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
4376   Vec<T>`][37326]
4377 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
4378   `VecDeque` iterators][37315]
4379 * [Improve `SipHasher` performance on small values][37312]
4380 * [Add Iterator trait TrustedLen to enable better FromIterator /
4381   Extend][37306]
4382 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
4383 * [`ReadDir` implements `Debug`][37221]
4384 * [Implement `RefUnwindSafe` for atomic types][37178]
4385 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
4386 * [Avoid allocations in `Decoder::read_str`][37064]
4387 * [`io::Error` implements `From<io::ErrorKind>`][37037]
4388 * [Impl `Debug` for raw pointers to unsized data][36880]
4389 * [Don't reuse `HashMap` random seeds][37470]
4390 * [The internal memory layout of `HashMap` is more cache-friendly, for
4391   significant improvements in some operations][36692]
4392 * [`HashMap` uses less memory on 32-bit architectures][36595]
4393 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
4394
4395 Cargo
4396 -----
4397
4398 * [Expose rustc cfg values to build scripts][cargo/3243]
4399 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
4400 * [Fix passing --features when testing multiple packages][cargo/3280]
4401 * [Use a single profile set per workspace][cargo/3249]
4402 * [Load `replace` sections from lock files][cargo/3220]
4403 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
4404
4405 Tooling
4406 -------
4407
4408 * [rustup is the recommended Rust installation method][1.14rustup]
4409 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
4410   S390x. These are [tier 2] platforms and may have major defects. Follow the
4411   instructions on the website to install, or add the targets to an existing
4412   installation with `rustup target add`. The new target triples are:
4413   - `mips-unknown-linux-gnu`
4414   - `mipsel-unknown-linux-gnu`
4415   - `mips64-unknown-linux-gnuabi64`
4416   - `mips64el-unknown-linux-gnuabi64 `
4417   - `powerpc-unknown-linux-gnu`
4418   - `powerpc64-unknown-linux-gnu`
4419   - `powerpc64le-unknown-linux-gnu`
4420   - `s390x-unknown-linux-gnu `
4421 * This release includes target (std) builds for ARM Linux running MUSL
4422   libc. These are [tier 2] platforms and may have major defects. Add the
4423   following triples to an existing rustup installation with `rustup target add`:
4424   - `arm-unknown-linux-musleabi`
4425   - `arm-unknown-linux-musleabihf`
4426   - `armv7-unknown-linux-musleabihf`
4427 * This release includes [experimental support for WebAssembly][1.14wasm], via
4428   the `wasm32-unknown-emscripten` target. This target is known to have major
4429   defects. Please test, report, and fix.
4430 * rustup no longer installs documentation by default. Run `rustup
4431   component add rust-docs` to install.
4432 * [Fix line stepping in debugger][37310]
4433 * [Enable line number debuginfo in releases][37280]
4434
4435 Misc
4436 ----
4437
4438 * [Disable jemalloc on aarch64/powerpc/mips][37392]
4439 * [Add support for Fuchsia OS][37313]
4440 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
4441
4442 Compatibility Notes
4443 -------------------
4444
4445 * [A number of forward-compatibility lints used by the compiler
4446   to gradually introduce language changes have been converted
4447   to deny by default][36894]:
4448   - ["use of inaccessible extern crate erroneously allowed"][36886]
4449   - ["type parameter default erroneously allowed in invalid location"][36887]
4450   - ["detects super or self keywords at the beginning of global path"][36888]
4451   - ["two overlapping inherent impls define an item with the same name
4452     were erroneously allowed"][36889]
4453   - ["floating-point constants cannot be used in patterns"][36890]
4454   - ["constants of struct or enum type can only be used in a pattern if
4455      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
4456   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
4457 * [Prohibit patterns in trait methods without bodies][37378]
4458 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
4459 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
4460 * [The `$crate` macro variable is accepted in fewer locations][37213]
4461 * [Impls specifying extra region requirements beyond the trait
4462   they implement are rejected][37167]
4463 * [Enums may not be unsized][37111]. Unsized enums are intended to
4464   work but never have. For now they are forbidden.
4465 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
4466
4467 [tier 2]: https://forge.rust-lang.org/platform-support.html
4468 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
4469 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
4470 [36430]: https://github.com/rust-lang/rust/pull/36430
4471 [36595]: https://github.com/rust-lang/rust/pull/36595
4472 [36595]: https://github.com/rust-lang/rust/pull/36595
4473 [36692]: https://github.com/rust-lang/rust/pull/36692
4474 [36767]: https://github.com/rust-lang/rust/pull/36767
4475 [36794]: https://github.com/rust-lang/rust/pull/36794
4476 [36798]: https://github.com/rust-lang/rust/pull/36798
4477 [36819]: https://github.com/rust-lang/rust/pull/36819
4478 [36822]: https://github.com/rust-lang/rust/pull/36822
4479 [36825]: https://github.com/rust-lang/rust/pull/36825
4480 [36843]: https://github.com/rust-lang/rust/pull/36843
4481 [36880]: https://github.com/rust-lang/rust/pull/36880
4482 [36886]: https://github.com/rust-lang/rust/issues/36886
4483 [36887]: https://github.com/rust-lang/rust/issues/36887
4484 [36888]: https://github.com/rust-lang/rust/issues/36888
4485 [36889]: https://github.com/rust-lang/rust/issues/36889
4486 [36890]: https://github.com/rust-lang/rust/issues/36890
4487 [36891]: https://github.com/rust-lang/rust/issues/36891
4488 [36892]: https://github.com/rust-lang/rust/issues/36892
4489 [36894]: https://github.com/rust-lang/rust/pull/36894
4490 [36917]: https://github.com/rust-lang/rust/pull/36917
4491 [36993]: https://github.com/rust-lang/rust/pull/36993
4492 [37037]: https://github.com/rust-lang/rust/pull/37037
4493 [37064]: https://github.com/rust-lang/rust/pull/37064
4494 [37094]: https://github.com/rust-lang/rust/pull/37094
4495 [37108]: https://github.com/rust-lang/rust/pull/37108
4496 [37111]: https://github.com/rust-lang/rust/pull/37111
4497 [37161]: https://github.com/rust-lang/rust/pull/37161
4498 [37162]: https://github.com/rust-lang/rust/pull/37162
4499 [37167]: https://github.com/rust-lang/rust/pull/37167
4500 [37178]: https://github.com/rust-lang/rust/pull/37178
4501 [37200]: https://github.com/rust-lang/rust/pull/37200
4502 [37213]: https://github.com/rust-lang/rust/pull/37213
4503 [37221]: https://github.com/rust-lang/rust/pull/37221
4504 [37224]: https://github.com/rust-lang/rust/pull/37224
4505 [37230]: https://github.com/rust-lang/rust/pull/37230
4506 [37231]: https://github.com/rust-lang/rust/pull/37231
4507 [37247]: https://github.com/rust-lang/rust/pull/37247
4508 [37267]: https://github.com/rust-lang/rust/pull/37267
4509 [37270]: https://github.com/rust-lang/rust/pull/37270
4510 [37273]: https://github.com/rust-lang/rust/pull/37273
4511 [37280]: https://github.com/rust-lang/rust/pull/37280
4512 [37298]: https://github.com/rust-lang/rust/pull/37298
4513 [37306]: https://github.com/rust-lang/rust/pull/37306
4514 [37310]: https://github.com/rust-lang/rust/pull/37310
4515 [37312]: https://github.com/rust-lang/rust/pull/37312
4516 [37313]: https://github.com/rust-lang/rust/pull/37313
4517 [37315]: https://github.com/rust-lang/rust/pull/37315
4518 [37318]: https://github.com/rust-lang/rust/pull/37318
4519 [37322]: https://github.com/rust-lang/rust/pull/37322
4520 [37326]: https://github.com/rust-lang/rust/pull/37326
4521 [37351]: https://github.com/rust-lang/rust/pull/37351
4522 [37356]: https://github.com/rust-lang/rust/pull/37356
4523 [37367]: https://github.com/rust-lang/rust/pull/37367
4524 [37373]: https://github.com/rust-lang/rust/pull/37373
4525 [37378]: https://github.com/rust-lang/rust/pull/37378
4526 [37389]: https://github.com/rust-lang/rust/pull/37389
4527 [37392]: https://github.com/rust-lang/rust/pull/37392
4528 [37427]: https://github.com/rust-lang/rust/pull/37427
4529 [37439]: https://github.com/rust-lang/rust/pull/37439
4530 [37445]: https://github.com/rust-lang/rust/pull/37445
4531 [37470]: https://github.com/rust-lang/rust/pull/37470
4532 [37569]: https://github.com/rust-lang/rust/pull/37569
4533 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4534 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
4535 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
4536 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
4537 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
4538 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
4539 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
4540
4541
4542 Version 1.13.0 (2016-11-10)
4543 ===========================
4544
4545 Language
4546 --------
4547
4548 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
4549   errors, like the `try!` macro, described in [RFC 0243].
4550 * [Stabilize macros in type position][36014]. Described in [RFC 873].
4551 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
4552 * [Fix `#[derive]` for empty tuple structs/variants][35728]
4553 * [Fix lifetime rules for 'if' conditions][36029]
4554 * [Avoid loading and parsing unconfigured non-inline modules][36482]
4555
4556 Compiler
4557 --------
4558
4559 * [Add the `-C link-arg` argument][36574]
4560 * [Remove the old AST-based backend from rustc_trans][35764]
4561 * [Don't enable NEON by default on armv7 Linux][35814]
4562 * [Fix debug line number info for macro expansions][35238]
4563 * [Do not emit "class method" debuginfo for types that are not
4564   DICompositeType][36008]
4565 * [Warn about multiple conflicting #[repr] hints][34623]
4566 * [When sizing DST, don't double-count nested struct prefixes][36351]
4567 * [Default RUST_MIN_STACK to 16MiB for now][36505]
4568 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
4569 * [Reject macros with empty repetitions to avoid infinite loop][36721]
4570 * [Expand macros without recursing to avoid stack overflows][36214]
4571
4572 Diagnostics
4573 -----------
4574
4575 * [Replace macro backtraces with labeled local uses][35702]
4576 * [Improve error message for misplaced doc comments][33922]
4577 * [Buffer unix and lock windows to prevent message interleaving][35975]
4578 * [Update lifetime errors to specifically note temporaries][36171]
4579 * [Special case a few colors for Windows][36178]
4580 * [Suggest `use self` when such an import resolves][36289]
4581 * [Be more specific when type parameter shadows primitive type][36338]
4582 * Many minor improvements
4583
4584 Compile-time Optimizations
4585 --------------------------
4586
4587 * [Compute and cache HIR hashes at beginning][35854]
4588 * [Don't hash types in loan paths][36004]
4589 * [Cache projections in trans][35761]
4590 * [Optimize the parser's last token handling][36527]
4591 * [Only instantiate #[inline] functions in codegen units referencing
4592   them][36524]. This leads to big improvements in cases where crates export
4593   define many inline functions without using them directly.
4594 * [Lazily allocate TypedArena's first chunk][36592]
4595 * [Don't allocate during default HashSet creation][36734]
4596
4597 Stabilized APIs
4598 ---------------
4599
4600 * [`checked_abs`]
4601 * [`wrapping_abs`]
4602 * [`overflowing_abs`]
4603 * [`RefCell::try_borrow`]
4604 * [`RefCell::try_borrow_mut`]
4605
4606 Libraries
4607 ---------
4608
4609 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
4610 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
4611   covariant][35354]
4612 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
4613 * [Implement `Debug` for `std::vec::IntoIter`][35707]
4614 * [`CString`: avoid excessive growth just to 0-terminate][35871]
4615 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
4616 * [Use arc4rand on FreeBSD][35884]
4617 * [memrchr: Correct aligned offset computation][35969]
4618 * [Improve Demangling of Rust Symbols][36059]
4619 * [Use monotonic time in condition variables][35048]
4620 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
4621 * [Implement conversion traits for `char`][35755]
4622 * [Fix illegal instruction caused by overflow in channel cloning][36104]
4623 * [Zero first byte of CString on drop][36264]
4624 * [Inherit overflow checks for sum and product][36372]
4625 * [Add missing Eq implementations][36423]
4626 * [Implement `Debug` for `DirEntry`][36631]
4627 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
4628   `errno`][36754]
4629 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4630 * [Implement more traits for `std::io::ErrorKind`][35911]
4631 * [Optimize BinaryHeap bounds checking][36072]
4632 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
4633   `extend_with_element`][36355]
4634 * [Fix overflow checking in unsigned pow()][34942]
4635
4636 Cargo
4637 -----
4638
4639 * This release includes security fixes to both curl and OpenSSL.
4640 * [Fix transitive doctests when panic=abort][cargo/3021]
4641 * [Add --all-features flag to cargo][cargo/3038]
4642 * [Reject path-based dependencies in `cargo package`][cargo/3060]
4643 * [Don't parse the home directory more than once][cargo/3078]
4644 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
4645 * [Update OpenSSL to 1.0.2j][cargo/3121]
4646 * [Add license and license_file to cargo metadata output][cargo/3110]
4647 * [Make crates-io registry URL optional in config; ignore all changes to
4648   source.crates-io][cargo/3089]
4649 * [Don't download dependencies from other platforms][cargo/3123]
4650 * [Build transitive dev-dependencies when needed][cargo/3125]
4651 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
4652 * [Avoid updating registry when adding existing deps][cargo/3144]
4653 * [Warn about path overrides that won't work][cargo/3136]
4654 * [Use workspaces during `cargo install`][cargo/3146]
4655 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
4656 * [Add --message-format flag][cargo/3000]
4657 * [Pass target environment for rustdoc][cargo/3205]
4658 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
4659 * [Update curl and curl-sys][cargo/3241]
4660 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
4661
4662 Tooling
4663 -------
4664
4665 * [rustdoc: Add the `--sysroot` argument][36586]
4666 * [rustdoc: Fix a couple of issues with the search results][35655]
4667 * [rustdoc: remove the `!` from macro URLs and titles][35234]
4668 * [gdb: Fix pretty-printing special-cased Rust types][35585]
4669 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
4670
4671 Misc
4672 ----
4673
4674 * [Remove unmaintained style guide][35124]
4675 * [Add s390x support][36369]
4676 * [Initial work at Haiku OS support][36727]
4677 * [Add mips-uclibc targets][35734]
4678 * [Crate-ify compiler-rt into compiler-builtins][35021]
4679 * [Add rustc version info (git hash + date) to dist tarball][36213]
4680 * Many documentation improvements
4681
4682 Compatibility Notes
4683 -------------------
4684
4685 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4686 * [Deny (by default) transmuting from fn item types to pointer-sized
4687   types][34923]. Continuing the long transition to zero-sized fn items,
4688   per [RFC 401].
4689 * [Fix `#[derive]` for empty tuple structs/variants][35728].
4690   Part of [RFC 1506].
4691 * [Issue deprecation warnings for safe accesses to extern statics][36173]
4692 * [Fix lifetime rules for 'if' conditions][36029].
4693 * [Inherit overflow checks for sum and product][36372].
4694 * [Forbid user-defined macros named "macro_rules"][36730].
4695
4696 [33922]: https://github.com/rust-lang/rust/pull/33922
4697 [34623]: https://github.com/rust-lang/rust/pull/34623
4698 [34923]: https://github.com/rust-lang/rust/pull/34923
4699 [34942]: https://github.com/rust-lang/rust/pull/34942
4700 [34982]: https://github.com/rust-lang/rust/pull/34982
4701 [35021]: https://github.com/rust-lang/rust/pull/35021
4702 [35048]: https://github.com/rust-lang/rust/pull/35048
4703 [35074]: https://github.com/rust-lang/rust/pull/35074
4704 [35124]: https://github.com/rust-lang/rust/pull/35124
4705 [35234]: https://github.com/rust-lang/rust/pull/35234
4706 [35238]: https://github.com/rust-lang/rust/pull/35238
4707 [35354]: https://github.com/rust-lang/rust/pull/35354
4708 [35559]: https://github.com/rust-lang/rust/pull/35559
4709 [35585]: https://github.com/rust-lang/rust/pull/35585
4710 [35627]: https://github.com/rust-lang/rust/pull/35627
4711 [35655]: https://github.com/rust-lang/rust/pull/35655
4712 [35702]: https://github.com/rust-lang/rust/pull/35702
4713 [35707]: https://github.com/rust-lang/rust/pull/35707
4714 [35728]: https://github.com/rust-lang/rust/pull/35728
4715 [35734]: https://github.com/rust-lang/rust/pull/35734
4716 [35755]: https://github.com/rust-lang/rust/pull/35755
4717 [35761]: https://github.com/rust-lang/rust/pull/35761
4718 [35764]: https://github.com/rust-lang/rust/pull/35764
4719 [35814]: https://github.com/rust-lang/rust/pull/35814
4720 [35854]: https://github.com/rust-lang/rust/pull/35854
4721 [35871]: https://github.com/rust-lang/rust/pull/35871
4722 [35884]: https://github.com/rust-lang/rust/pull/35884
4723 [35911]: https://github.com/rust-lang/rust/pull/35911
4724 [35969]: https://github.com/rust-lang/rust/pull/35969
4725 [35975]: https://github.com/rust-lang/rust/pull/35975
4726 [36004]: https://github.com/rust-lang/rust/pull/36004
4727 [36008]: https://github.com/rust-lang/rust/pull/36008
4728 [36014]: https://github.com/rust-lang/rust/pull/36014
4729 [36029]: https://github.com/rust-lang/rust/pull/36029
4730 [36059]: https://github.com/rust-lang/rust/pull/36059
4731 [36072]: https://github.com/rust-lang/rust/pull/36072
4732 [36101]: https://github.com/rust-lang/rust/pull/36101
4733 [36104]: https://github.com/rust-lang/rust/pull/36104
4734 [36171]: https://github.com/rust-lang/rust/pull/36171
4735 [36173]: https://github.com/rust-lang/rust/pull/36173
4736 [36178]: https://github.com/rust-lang/rust/pull/36178
4737 [36213]: https://github.com/rust-lang/rust/pull/36213
4738 [36214]: https://github.com/rust-lang/rust/pull/36214
4739 [36264]: https://github.com/rust-lang/rust/pull/36264
4740 [36266]: https://github.com/rust-lang/rust/pull/36266
4741 [36289]: https://github.com/rust-lang/rust/pull/36289
4742 [36338]: https://github.com/rust-lang/rust/pull/36338
4743 [36351]: https://github.com/rust-lang/rust/pull/36351
4744 [36355]: https://github.com/rust-lang/rust/pull/36355
4745 [36369]: https://github.com/rust-lang/rust/pull/36369
4746 [36372]: https://github.com/rust-lang/rust/pull/36372
4747 [36423]: https://github.com/rust-lang/rust/pull/36423
4748 [36482]: https://github.com/rust-lang/rust/pull/36482
4749 [36505]: https://github.com/rust-lang/rust/pull/36505
4750 [36524]: https://github.com/rust-lang/rust/pull/36524
4751 [36527]: https://github.com/rust-lang/rust/pull/36527
4752 [36551]: https://github.com/rust-lang/rust/pull/36551
4753 [36574]: https://github.com/rust-lang/rust/pull/36574
4754 [36586]: https://github.com/rust-lang/rust/pull/36586
4755 [36592]: https://github.com/rust-lang/rust/pull/36592
4756 [36631]: https://github.com/rust-lang/rust/pull/36631
4757 [36639]: https://github.com/rust-lang/rust/pull/36639
4758 [36721]: https://github.com/rust-lang/rust/pull/36721
4759 [36727]: https://github.com/rust-lang/rust/pull/36727
4760 [36730]: https://github.com/rust-lang/rust/pull/36730
4761 [36734]: https://github.com/rust-lang/rust/pull/36734
4762 [36754]: https://github.com/rust-lang/rust/pull/36754
4763 [36995]: https://github.com/rust-lang/rust/pull/36995
4764 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
4765 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
4766 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4767 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
4768 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
4769 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
4770 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
4771 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
4772 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
4773 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
4774 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
4775 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
4776 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
4777 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
4778 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
4779 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
4780 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
4781 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
4782 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
4783 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
4784 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
4785 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
4786 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
4787 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
4788 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
4789 [rustup]: https://www.rustup.rs
4790 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
4791 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
4792 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
4793 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
4794 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
4795 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
4796 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
4797
4798
4799 Version 1.12.1 (2016-10-20)
4800 ===========================
4801
4802 Regression Fixes
4803 ----------------
4804
4805 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
4806 * [Confusion with double negation and booleans][36856]
4807 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
4808 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
4809 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
4810 * [Corrupted memory after updated to 1.12][36936]
4811 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
4812 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
4813 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
4814
4815 [36381]: https://github.com/rust-lang/rust/issues/36381
4816 [36856]: https://github.com/rust-lang/rust/issues/36856
4817 [36875]: https://github.com/rust-lang/rust/issues/36875
4818 [36924]: https://github.com/rust-lang/rust/issues/36924
4819 [36926]: https://github.com/rust-lang/rust/issues/36926
4820 [36936]: https://github.com/rust-lang/rust/issues/36936
4821 [37026]: https://github.com/rust-lang/rust/issues/37026
4822 [37112]: https://github.com/rust-lang/rust/issues/37112
4823 [37153]: https://github.com/rust-lang/rust/issues/37153
4824
4825
4826 Version 1.12.0 (2016-09-29)
4827 ===========================
4828
4829 Highlights
4830 ----------
4831
4832 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4833   This translation pass is far simpler than the previous AST->LLVM pass, and
4834   creates opportunities to perform new optimizations directly on the MIR. It
4835   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4836 * [`rustc` presents a new, more readable error format, along with
4837   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
4838   Most common editors supporting Rust have been updated to work with it. It was
4839   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
4840
4841 Compiler
4842 --------
4843
4844 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4845   This translation pass is far simpler than the previous AST->LLVM pass, and
4846   creates opportunities to perform new optimizations directly on the MIR. It
4847   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4848 * [Print the Rust target name, not the LLVM target name, with
4849   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
4850 * [The computation of `TypeId` is correct in some cases where it was previously
4851   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
4852 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
4853 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
4854   `--print relocation-models`, and `--print code-models` print the available
4855   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
4856   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
4857 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
4858   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
4859   These targets produce statically-linked binaries. There are no binary release
4860   builds yet though.
4861
4862 Diagnostics
4863 -----------
4864
4865 * [`rustc` presents a new, more readable error format, along with
4866   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
4867   Most common editors supporting Rust have been updated to work with it. It was
4868   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
4869 * [In error descriptions, references are now described in plain English,
4870   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
4871 * [In error type descriptions, unknown numeric types are named `{integer}` or
4872   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
4873 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
4874
4875 Language
4876 --------
4877
4878 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
4879 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
4880 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
4881   useful](https://github.com/rust-lang/rust/pull/34908)
4882 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
4883   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
4884 * [Semicolons are properly required as statement delimiters inside
4885   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
4886 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
4887
4888 Stabilized APIs
4889 ---------------
4890
4891 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
4892 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
4893 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
4894 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
4895 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
4896 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
4897 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
4898 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
4899 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
4900 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
4901   Both on Unix and Windows.
4902 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
4903 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
4904 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
4905 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
4906 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
4907 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
4908 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
4909 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
4910
4911 Libraries
4912 ---------
4913
4914 * [The `format!` macro and friends now allow a single argument to be formatted
4915   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
4916 * [The lifetime bounds on `[T]::binary_search_by` and
4917   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
4918 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
4919 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
4920 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
4921 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
4922 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
4923 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
4924 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
4925 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
4926   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
4927 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
4928   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
4929 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
4930 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
4931   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
4932 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
4933 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
4934 * [`mpsc::sync_channel` `Receiver`s return any available message before
4935   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
4936 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
4937 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
4938
4939 Cargo
4940 -----
4941
4942 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
4943 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
4944 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
4945 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
4946 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
4947 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
4948 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
4949 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
4950 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
4951 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
4952 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
4953 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
4954 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
4955 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
4956 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
4957 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
4958
4959 Performance
4960 -----------
4961
4962 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
4963 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
4964
4965 Tooling
4966 -------
4967
4968 * [Test binaries now support a `--test-threads` argument to specify the number
4969   of threads used to run tests, and which acts the same as the
4970   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
4971 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
4972 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
4973 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
4974 * [Rust releases now come with source packages that can be installed by rustup
4975   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
4976   The resulting source code can be used by tools and IDES, located in the
4977   sysroot under `lib/rustlib/src`.
4978
4979 Misc
4980 ----
4981
4982 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
4983 * Many minor improvements to the documentation.
4984 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
4985
4986 Compatibility Notes
4987 -------------------
4988
4989 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
4990   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
4991 * [When formatting strings, if "precision" is specified, the "fill",
4992   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
4993 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
4994
4995
4996 Version 1.11.0 (2016-08-18)
4997 ===========================
4998
4999 Language
5000 --------
5001
5002 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
5003 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
5004 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
5005 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
5006
5007 Stabilized APIs
5008 ---------------
5009
5010 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
5011 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
5012 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
5013 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
5014 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
5015 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
5016   (in libcore - previously stabilized in libstd)
5017 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
5018   (in libcore - previously stabilized in libstd)
5019 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
5020   (in libcore - previously stabilized in libstd)
5021 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
5022   (in libcore - previously stabilized in libstd)
5023 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5024 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5025 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
5026 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
5027
5028 Libraries
5029 ---------
5030
5031 * [The `thread_local!` macro supports multiple definitions in a single
5032    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
5033 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
5034 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
5035   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
5036 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
5037 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
5038 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
5039 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
5040
5041 Cargo
5042 -----
5043
5044 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
5045 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
5046 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
5047 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
5048 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
5049   and `-vv` prints warnings for all crates.
5050 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
5051 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
5052   This provides room for expansion by arbitrary tools.
5053 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
5054 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
5055 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
5056 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
5057 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
5058 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
5059 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
5060
5061 Performance
5062 -----------
5063
5064 * [Caching projections speeds up type check dramatically for some
5065   workloads](https://github.com/rust-lang/rust/pull/33816)
5066 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
5067   This hasher is faster, but is believed to provide sufficient
5068   protection from collision attacks.
5069 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
5070
5071 Rustdoc
5072 -------
5073
5074 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
5075 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
5076 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
5077 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
5078 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
5079
5080 Tooling
5081 -------
5082
5083 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
5084 * [When emitting debug info, rustc emits frame pointers for closures,
5085   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
5086 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5087 * Many more errors have been given error codes and extended
5088   explanations
5089 * API documentation continues to be improved, with many new examples
5090
5091 Misc
5092 ----
5093
5094 * [rustc no longer hangs when dependencies recursively re-export
5095   submodules](https://github.com/rust-lang/rust/pull/34542)
5096 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
5097 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
5098   rewritten](https://github.com/rust-lang/rust/pull/33895)
5099 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
5100   No targets use this yet, but it works toward AVR support.
5101
5102 Compatibility Notes
5103 -------------------
5104
5105 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
5106 * [The new follow-set rules that place restrictions on `macro_rules!`
5107   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
5108   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
5109   and has been a warning since 1.10.
5110 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
5111   This causes breakage in some corner cases.
5112
5113
5114 Version 1.10.0 (2016-07-07)
5115 ===========================
5116
5117 Language
5118 --------
5119
5120 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
5121   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
5122 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
5123 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
5124 * [`panic!` can be converted to a runtime abort with the
5125   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
5126   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5127 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
5128   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
5129   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
5130   Note that Cargo does not yet directly support cdylibs.
5131
5132 Stabilized APIs
5133 ---------------
5134
5135 * `os::windows::fs::OpenOptionsExt::access_mode`
5136 * `os::windows::fs::OpenOptionsExt::share_mode`
5137 * `os::windows::fs::OpenOptionsExt::custom_flags`
5138 * `os::windows::fs::OpenOptionsExt::attributes`
5139 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
5140 * `os::unix::fs::OpenOptionsExt::custom_flags`
5141 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
5142 * `Default for sync::Weak`
5143 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
5144 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
5145 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
5146 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
5147 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
5148 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
5149 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
5150 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
5151 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
5152 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
5153 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
5154 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
5155 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
5156 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
5157 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
5158 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
5159 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
5160 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
5161 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
5162 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
5163 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
5164 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
5165 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
5166 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
5167 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
5168 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5169 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5170 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5171 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5172 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
5173 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
5174 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
5175 * Read/Write/RawFd impls for `UnixStream`
5176 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
5177 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
5178 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
5179 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
5180 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
5181 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
5182 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
5183 * RawFd impls for `UnixListener`
5184 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
5185 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
5186 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
5187 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
5188 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
5189 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
5190 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
5191 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
5192 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
5193 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
5194 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
5195 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
5196 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
5197 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
5198 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
5199 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
5200 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
5201 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
5202 * RawFd impls for `UnixDatagram`
5203 * `{BTree,Hash}Map::values_mut`
5204 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
5205
5206 Libraries
5207 ---------
5208
5209 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
5210   The semantics of this minor method are subtle and probably not what
5211   most people want.
5212 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
5213 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
5214   will fall back to `/dev/urandom` temporarily to avoid blocking
5215   during early boot](https://github.com/rust-lang/rust/pull/33086).
5216 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
5217 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
5218 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
5219 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
5220 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
5221 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
5222   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
5223
5224 Cargo
5225 -----
5226 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
5227   This controls the runtime behavior of the `panic!` macro
5228   and can be either "unwind" (the default), or "abort".
5229   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5230 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
5231 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
5232 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
5233   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
5234 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
5235 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
5236 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
5237   By default they are retried twice, which can be customized with the
5238   `net.retry` value in `.cargo/config`.
5239 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
5240 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
5241 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
5242 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
5243   Makes it possible to install multiple crates in parallel.
5244 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
5245 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
5246 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
5247 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
5248 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
5249 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
5250
5251 Performance
5252 -----------
5253
5254 * [rustc memory usage was reduced by refactoring the context used for
5255   type checking](https://github.com/rust-lang/rust/pull/33425).
5256 * [Speed up creation of `HashMap`s by caching the random keys used
5257   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
5258 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
5259 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
5260 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
5261   10x faster than the previous lookup tables.
5262 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
5263
5264 Usability
5265 ---------
5266
5267 * Many incremental improvements to documentation and rustdoc.
5268 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
5269 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
5270 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
5271 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
5272 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
5273 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
5274 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
5275
5276 Misc
5277 ----
5278
5279 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
5280 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
5281 * [`std` no longer prints backtraces on platforms where the running
5282   module must be loaded with `env::current_exe`, which can't be relied
5283   on](https://github.com/rust-lang/rust/pull/33554).
5284 * This release includes std binaries for the i586-unknown-linux-gnu,
5285   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
5286   i586 target is for old x86 hardware without SSE2, and the armv7
5287   target is for Android running on modern ARM architectures.
5288 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
5289   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
5290 * [On Unix the runtime aborts by calling `libc::abort` instead of
5291   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
5292 * [Rust is now bootstrapped from the previous release of Rust,
5293   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
5294
5295 Compatibility Notes
5296 -------------------
5297
5298 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
5299 * [`target_env` for Linux ARM targets is just `gnu`, not
5300   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
5301 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
5302 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
5303 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
5304   Affects how macros are parsed.
5305 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
5306 * [Feature-gated attributes on macro-generated macro invocations are
5307   now rejected](https://github.com/rust-lang/rust/pull/32791).
5308 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
5309   This caused some minor changes to type inference.
5310
5311
5312 Version 1.9.0 (2016-05-26)
5313 ==========================
5314
5315 Language
5316 --------
5317
5318 * The `#[deprecated]` attribute when applied to an API will generate
5319   warnings when used. The warnings may be suppressed with
5320   `#[allow(deprecated)]`. [RFC 1270].
5321 * [`fn` item types are zero sized, and each `fn` names a unique
5322   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5323   `transmute` on a `fn` type will generate a warning for a few cycles,
5324   then will be converted to an error.
5325 * [Field and method resolution understand visibility, so private
5326   fields and methods cannot prevent the proper use of public fields
5327   and methods][1.9fv].
5328 * [The parser considers unicode codepoints in the
5329   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
5330
5331 Stabilized APIs
5332 ---------------
5333
5334 * [`std::panic`]
5335 * [`std::panic::catch_unwind`] (renamed from `recover`)
5336 * [`std::panic::resume_unwind`] (renamed from `propagate`)
5337 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
5338 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
5339 * [`str::is_char_boundary`]
5340 * [`<*const T>::as_ref`]
5341 * [`<*mut T>::as_ref`]
5342 * [`<*mut T>::as_mut`]
5343 * [`AsciiExt::make_ascii_uppercase`]
5344 * [`AsciiExt::make_ascii_lowercase`]
5345 * [`char::decode_utf16`]
5346 * [`char::DecodeUtf16`]
5347 * [`char::DecodeUtf16Error`]
5348 * [`char::DecodeUtf16Error::unpaired_surrogate`]
5349 * [`BTreeSet::take`]
5350 * [`BTreeSet::replace`]
5351 * [`BTreeSet::get`]
5352 * [`HashSet::take`]
5353 * [`HashSet::replace`]
5354 * [`HashSet::get`]
5355 * [`OsString::with_capacity`]
5356 * [`OsString::clear`]
5357 * [`OsString::capacity`]
5358 * [`OsString::reserve`]
5359 * [`OsString::reserve_exact`]
5360 * [`OsStr::is_empty`]
5361 * [`OsStr::len`]
5362 * [`std::os::unix::thread`]
5363 * [`RawPthread`]
5364 * [`JoinHandleExt`]
5365 * [`JoinHandleExt::as_pthread_t`]
5366 * [`JoinHandleExt::into_pthread_t`]
5367 * [`HashSet::hasher`]
5368 * [`HashMap::hasher`]
5369 * [`CommandExt::exec`]
5370 * [`File::try_clone`]
5371 * [`SocketAddr::set_ip`]
5372 * [`SocketAddr::set_port`]
5373 * [`SocketAddrV4::set_ip`]
5374 * [`SocketAddrV4::set_port`]
5375 * [`SocketAddrV6::set_ip`]
5376 * [`SocketAddrV6::set_port`]
5377 * [`SocketAddrV6::set_flowinfo`]
5378 * [`SocketAddrV6::set_scope_id`]
5379 * [`slice::copy_from_slice`]
5380 * [`ptr::read_volatile`]
5381 * [`ptr::write_volatile`]
5382 * [`OpenOptions::create_new`]
5383 * [`TcpStream::set_nodelay`]
5384 * [`TcpStream::nodelay`]
5385 * [`TcpStream::set_ttl`]
5386 * [`TcpStream::ttl`]
5387 * [`TcpStream::set_only_v6`]
5388 * [`TcpStream::only_v6`]
5389 * [`TcpStream::take_error`]
5390 * [`TcpStream::set_nonblocking`]
5391 * [`TcpListener::set_ttl`]
5392 * [`TcpListener::ttl`]
5393 * [`TcpListener::set_only_v6`]
5394 * [`TcpListener::only_v6`]
5395 * [`TcpListener::take_error`]
5396 * [`TcpListener::set_nonblocking`]
5397 * [`UdpSocket::set_broadcast`]
5398 * [`UdpSocket::broadcast`]
5399 * [`UdpSocket::set_multicast_loop_v4`]
5400 * [`UdpSocket::multicast_loop_v4`]
5401 * [`UdpSocket::set_multicast_ttl_v4`]
5402 * [`UdpSocket::multicast_ttl_v4`]
5403 * [`UdpSocket::set_multicast_loop_v6`]
5404 * [`UdpSocket::multicast_loop_v6`]
5405 * [`UdpSocket::set_multicast_ttl_v6`]
5406 * [`UdpSocket::multicast_ttl_v6`]
5407 * [`UdpSocket::set_ttl`]
5408 * [`UdpSocket::ttl`]
5409 * [`UdpSocket::set_only_v6`]
5410 * [`UdpSocket::only_v6`]
5411 * [`UdpSocket::join_multicast_v4`]
5412 * [`UdpSocket::join_multicast_v6`]
5413 * [`UdpSocket::leave_multicast_v4`]
5414 * [`UdpSocket::leave_multicast_v6`]
5415 * [`UdpSocket::take_error`]
5416 * [`UdpSocket::connect`]
5417 * [`UdpSocket::send`]
5418 * [`UdpSocket::recv`]
5419 * [`UdpSocket::set_nonblocking`]
5420
5421 Libraries
5422 ---------
5423
5424 * [`std::sync::Once` is poisoned if its initialization function
5425   fails][1.9o].
5426 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
5427 * [Most types implement `fmt::Debug`][1.9db].
5428 * [The default buffer size used by `BufReader` and `BufWriter` was
5429   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
5430   used by other languages.
5431 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
5432   `Duration` additionally implements `*=` and `/=`][1.9ta].
5433 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
5434 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
5435 * [`Chain` implements `BufRead`][1.9ch].
5436 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
5437
5438 Cargo
5439 -----
5440
5441 * [Cargo can now run concurrently][1.9cc].
5442 * [Top-level overrides allow specific revisions of crates to be
5443   overridden through the entire crate graph][1.9ct].  This is intended
5444   to make upgrades easier for large projects, by allowing crates to be
5445   forked temporarily until they've been upgraded and republished.
5446 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
5447 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
5448   on the commandline][1.9cf]. `rustc` arguments can also be specified
5449   in the `build.rustflags` configuration key.
5450
5451 Performance
5452 -----------
5453
5454 * [The time complexity of comparing variables for equivalence during type
5455   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
5456   to major compilation time improvement in some scenarios.
5457 * [`ToString` is specialized for `str`, giving it the same performance
5458   as `to_owned`][1.9ts].
5459 * [Spawning processes with `Command::output` no longer creates extra
5460   threads][1.9sp].
5461 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
5462   for C-like enums][1.9cl].
5463
5464 Misc
5465 ----
5466
5467 * [Passing the `--quiet` flag to a test runner will produce
5468   much-abbreviated output][1.9q].
5469 * The Rust Project now publishes std binaries for the
5470   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
5471   `i586-pc-windows-msvc` targets.
5472
5473 Compatibility Notes
5474 -------------------
5475
5476 * [`std::sync::Once` is poisoned if its initialization function
5477   fails][1.9o].
5478 * [It is illegal to define methods with the same name in overlapping
5479   inherent `impl` blocks][1.9sn].
5480 * [`fn` item types are zero sized, and each `fn` names a unique
5481   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5482   `transmute` on a `fn` type will generate a warning for a few cycles,
5483   then will be converted to an error.
5484 * [Improvements to const evaluation may trigger new errors when integer
5485   literals are out of range][1.9ce].
5486
5487
5488 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
5489 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
5490 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
5491 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
5492 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
5493 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
5494 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
5495 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
5496 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
5497 [1.9db]: https://github.com/rust-lang/rust/pull/32054
5498 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
5499 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
5500 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
5501 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
5502 [1.9o]: https://github.com/rust-lang/rust/pull/32325
5503 [1.9q]: https://github.com/rust-lang/rust/pull/31887
5504 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
5505 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
5506 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
5507 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
5508 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
5509 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
5510 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
5511 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
5512 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5513 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
5514 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5515 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
5516 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
5517 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
5518 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
5519 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
5520 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
5521 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
5522 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
5523 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
5524 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
5525 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
5526 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
5527 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
5528 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
5529 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
5530 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
5531 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
5532 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
5533 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
5534 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
5535 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
5536 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
5537 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
5538 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
5539 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
5540 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
5541 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
5542 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
5543 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
5544 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
5545 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
5546 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
5547 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
5548 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5549 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5550 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5551 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5552 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5553 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5554 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
5555 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5556 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
5557 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5558 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5559 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5560 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5561 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5562 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
5563 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
5564 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
5565 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
5566 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
5567 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
5568 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
5569 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
5570 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
5571 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
5572 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
5573 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
5574 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
5575 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
5576 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
5577 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
5578 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
5579 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
5580 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
5581 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
5582 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
5583 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
5584 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
5585 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
5586 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
5587 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
5588 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
5589 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
5590 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
5591 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
5592 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
5593 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
5594 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
5595 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
5596 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
5597 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
5598
5599
5600 Version 1.8.0 (2016-04-14)
5601 ==========================
5602
5603 Language
5604 --------
5605
5606 * Rust supports overloading of compound assignment statements like
5607   `+=` by implementing the [`AddAssign`], [`SubAssign`],
5608   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
5609   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
5610   traits. [RFC 953].
5611 * Empty structs can be defined with braces, as in `struct Foo { }`, in
5612   addition to the non-braced form, `struct Foo;`. [RFC 218].
5613
5614 Libraries
5615 ---------
5616
5617 * Stabilized APIs:
5618   * [`str::encode_utf16`] (renamed from `utf16_units`)
5619   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
5620   * [`Ref::map`]
5621   * [`RefMut::map`]
5622   * [`ptr::drop_in_place`]
5623   * [`time::Instant`]
5624   * [`time::SystemTime`]
5625   * [`Instant::now`]
5626   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
5627   * [`Instant::elapsed`]
5628   * [`SystemTime::now`]
5629   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
5630   * [`SystemTime::elapsed`]
5631   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
5632   * [`SystemTimeError`]
5633   * [`SystemTimeError::duration`]
5634   * Various impls for `SystemTimeError`
5635   * [`UNIX_EPOCH`]
5636   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
5637     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
5638     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
5639 * [The `write!` and `writeln!` macros correctly emit errors if any of
5640   their arguments can't be formatted][1.8w].
5641 * [Various I/O functions support large files on 32-bit Linux][1.8l].
5642 * [The Unix-specific `raw` modules, which contain a number of
5643   redefined C types are deprecated][1.8r], including `os::raw::unix`,
5644   `os::raw::macos`, and `os::raw::linux`. These modules defined types
5645   such as `ino_t` and `dev_t`. The inconsistency of these definitions
5646   across platforms was making it difficult to implement `std`
5647   correctly. Those that need these definitions should use the `libc`
5648   crate. [RFC 1415].
5649 * The Unix-specific `MetadataExt` traits, including
5650   `os::unix::fs::MetadataExt`, which expose values such as inode
5651   numbers [no longer return platform-specific types][1.8r], but
5652   instead return widened integers. [RFC 1415].
5653 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
5654 * [Atomic loads and stores are not volatile][1.8a].
5655 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
5656
5657 Performance
5658 -----------
5659
5660 * [Inlining hash functions lead to a 3% compile-time improvement in
5661   some workloads][1.8h].
5662 * When using jemalloc, its symbols are [unprefixed so that it
5663   overrides the libc malloc implementation][1.8h]. This means that for
5664   rustc, LLVM is now using jemalloc, which results in a 6%
5665   compile-time improvement on a specific workload.
5666 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
5667
5668 Misc
5669 ----
5670
5671 * [32-bit MSVC builds finally implement unwinding][1.8ms].
5672   i686-pc-windows-msvc is now considered a tier-1 platform.
5673 * [The `--print targets` flag prints a list of supported targets][1.8t].
5674 * [The `--print cfg` flag prints the `cfg`s defined for the current
5675   target][1.8cf].
5676 * [`rustc` can be built with an new Cargo-based build system, written
5677   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
5678   build system. To enable it configure with `configure --rustbuild`.
5679 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
5680   variants while also indicating the total number of missing variants
5681   if more than 3][1.8m].
5682 * [Executable stacks are disabled on Linux and BSD][1.8nx].
5683 * The Rust Project now publishes binary releases of the standard
5684   library for a number of tier-2 targets:
5685   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
5686   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
5687   `x86_64-rumprun-netbsd`. These can be installed with
5688   tools such as [multirust][1.8mr].
5689
5690 Cargo
5691 -----
5692
5693 * [`cargo init` creates a new Cargo project in the current
5694   directory][1.8ci].  It is otherwise like `cargo new`.
5695 * [Cargo has configuration keys for `-v` and
5696   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
5697   `[term]` section of `.cargo/config`.
5698 * [Configuration keys that evaluate to strings or integers can be set
5699   via environment variables][1.8ce]. For example the `build.jobs` key
5700   can be set via `CARGO_BUILD_JOBS`. Environment variables take
5701   precedence over config files.
5702 * [Target-specific dependencies support Rust `cfg` syntax for
5703   describing targets][1.8cfg] so that dependencies for multiple
5704   targets can be specified together. [RFC 1361].
5705 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
5706   `RUSTDOC` take precedence over the `build.target-dir`,
5707   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
5708 * [The child process tree is killed on Windows when Cargo is
5709   killed][1.8ck].
5710 * [The `build.target` configuration value sets the target platform,
5711   like `--target`][1.8ct].
5712
5713 Compatibility Notes
5714 -------------------
5715
5716 * [Unstable compiler flags have been further restricted][1.8u]. Since
5717   1.0 `-Z` flags have been considered unstable, and other flags that
5718   were considered unstable additionally required passing `-Z
5719   unstable-options` to access. Unlike unstable language and library
5720   features though, these options have been accessible on the stable
5721   release channel. Going forward, *new unstable flags will not be
5722   available on the stable release channel*, and old unstable flags
5723   will warn about their usage. In the future, all unstable flags will
5724   be unavailable on the stable release channel.
5725 * [It is no longer possible to `match` on empty enum variants using
5726   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
5727 * The Unix-specific `MetadataExt` traits, including
5728   `os::unix::fs::MetadataExt`, which expose values such as inode
5729   numbers [no longer return platform-specific types][1.8r], but
5730   instead return widened integers. [RFC 1415].
5731 * [Modules sourced from the filesystem cannot appear within arbitrary
5732   blocks, but only within other modules][1.8mf].
5733 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
5734 * On Unix, [stack overflow triggers a runtime abort instead of a
5735   SIGSEGV][1.8so].
5736 * [`Command::spawn` and its equivalents return an error if any of
5737   its command-line arguments contain interior `NUL`s][1.8n].
5738 * [Tuple and unit enum variants from other crates are in the type
5739   namespace][1.8tn].
5740 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
5741   type instead of `.a` files][1.8st]. Additionally, for the MSVC
5742   toolchain, `rustc` emits import libraries named `foo.dll.lib`
5743   instead of `foo.lib`.
5744
5745
5746 [1.8a]: https://github.com/rust-lang/rust/pull/30962
5747 [1.8b]: https://github.com/rust-lang/rust/pull/31123
5748 [1.8c]: https://github.com/rust-lang/rust/pull/31530
5749 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
5750 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
5751 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
5752 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
5753 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
5754 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
5755 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
5756 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
5757 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
5758 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
5759 [1.8h]: https://github.com/rust-lang/rust/pull/31460
5760 [1.8l]: https://github.com/rust-lang/rust/pull/31668
5761 [1.8m]: https://github.com/rust-lang/rust/pull/31020
5762 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
5763 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
5764 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
5765 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
5766 [1.8n]: https://github.com/rust-lang/rust/pull/31056
5767 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
5768 [1.8r]: https://github.com/rust-lang/rust/pull/31551
5769 [1.8so]: https://github.com/rust-lang/rust/pull/31333
5770 [1.8st]: https://github.com/rust-lang/rust/pull/29520
5771 [1.8t]: https://github.com/rust-lang/rust/pull/31358
5772 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
5773 [1.8u]: https://github.com/rust-lang/rust/pull/31793
5774 [1.8v]: https://github.com/rust-lang/rust/pull/31757
5775 [1.8w]: https://github.com/rust-lang/rust/pull/31904
5776 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
5777 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
5778 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
5779 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
5780 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
5781 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
5782 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
5783 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
5784 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
5785 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
5786 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
5787 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
5788 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
5789 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
5790 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
5791 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
5792 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
5793 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
5794 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
5795 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
5796 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
5797 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
5798 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
5799 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
5800 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
5801 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
5802 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
5803 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
5804 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
5805 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
5806
5807
5808 Version 1.7.0 (2016-03-03)
5809 ==========================
5810
5811 Libraries
5812 ---------
5813
5814 * Stabilized APIs
5815   * `Path`
5816     * [`Path::strip_prefix`] (renamed from relative_from)
5817     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
5818   * `Ipv4Addr`
5819     * [`Ipv4Addr::is_loopback`]
5820     * [`Ipv4Addr::is_private`]
5821     * [`Ipv4Addr::is_link_local`]
5822     * [`Ipv4Addr::is_multicast`]
5823     * [`Ipv4Addr::is_broadcast`]
5824     * [`Ipv4Addr::is_documentation`]
5825   * `Ipv6Addr`
5826     * [`Ipv6Addr::is_unspecified`]
5827     * [`Ipv6Addr::is_loopback`]
5828     * [`Ipv6Addr::is_multicast`]
5829   * `Vec`
5830     * [`Vec::as_slice`]
5831     * [`Vec::as_mut_slice`]
5832   * `String`
5833     * [`String::as_str`]
5834     * [`String::as_mut_str`]
5835   * Slices
5836     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
5837     be the same length
5838     * `<[T]>::`[`sort_by_key`]
5839   * checked, saturated, and overflowing operations
5840     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
5841     * [`i32::saturating_mul`]
5842     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
5843     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
5844     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
5845     * [`u32::saturating_mul`]
5846     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
5847     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
5848     * and checked, saturated, and overflowing operations for other primitive types
5849   * FFI
5850     * [`ffi::IntoStringError`]
5851     * [`CString::into_string`]
5852     * [`CString::into_bytes`]
5853     * [`CString::into_bytes_with_nul`]
5854     * `From<CString> for Vec<u8>`
5855   * `IntoStringError`
5856     * [`IntoStringError::into_cstring`]
5857     * [`IntoStringError::utf8_error`]
5858     * `Error for IntoStringError`
5859   * Hashing
5860     * [`std::hash::BuildHasher`]
5861     * [`BuildHasher::Hasher`]
5862     * [`BuildHasher::build_hasher`]
5863     * [`std::hash::BuildHasherDefault`]
5864     * [`HashMap::with_hasher`]
5865     * [`HashMap::with_capacity_and_hasher`]
5866     * [`HashSet::with_hasher`]
5867     * [`HashSet::with_capacity_and_hasher`]
5868     * [`std::collections::hash_map::RandomState`]
5869     * [`RandomState::new`]
5870 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
5871   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
5872   from bytes is faster.
5873 * [The performance of `LineWriter` (and thus `io::stdout`) was
5874   improved by using `memchr` to search for newlines][1.7m].
5875 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
5876   `f64` variants were stabilized previously.
5877 * [`BTreeMap` was rewritten to use less memory and improve the performance
5878   of insertion and iteration, the latter by as much as 5x][1.7bm].
5879 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
5880   covariant over their contained type][1.7bt].
5881 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
5882   over their contained type][1.7ll].
5883 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
5884   searching methods.
5885 * [`Any` is implemented for unsized types][1.7a].
5886 * [`Hash` is implemented for `Duration`][1.7h].
5887
5888 Misc
5889 ----
5890
5891 * [When running tests with `--test`, rustdoc will pass `--cfg`
5892   arguments to the compiler][1.7dt].
5893 * [The compiler is built with RPATH information by default][1.7rpa].
5894   This means that it will be possible to run `rustc` when installed in
5895   unusual configurations without configuring the dynamic linker search
5896   path explicitly.
5897 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
5898   any RPATH entries (emitted with `-C rpath`) *not* take precedence
5899   over `LD_LIBRARY_PATH`.
5900
5901 Cargo
5902 -----
5903
5904 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
5905   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
5906 * [The `rerun-if-changed` build script directive no longer causes the
5907   build script to incorrectly run twice in certain scenarios][1.7rr].
5908
5909 Compatibility Notes
5910 -------------------
5911
5912 * Soundness fixes to the interactions between associated types and
5913   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
5914   code that violates the new rules. This is a significant change that
5915   is known to break existing code, so it has emitted warnings for the
5916   new error cases since 1.4 to give crate authors time to adapt. The
5917   details of what is changing are subtle; read the RFC for more.
5918 * [Several bugs in the compiler's visibility calculations were
5919   fixed][1.7v]. Since this was found to break significant amounts of
5920   code, the new errors will be emitted as warnings for several release
5921   cycles, under the `private_in_public` lint.
5922 * Defaulted type parameters were accidentally accepted in positions
5923   that were not intended. In this release, [defaulted type parameters
5924   appearing outside of type definitions will generate a
5925   warning][1.7d], which will become an error in future releases.
5926 * [Parsing "." as a float results in an error instead of 0][1.7p].
5927   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
5928 * [Borrows of closure parameters may not outlive the closure][1.7bc].
5929
5930 [1.7a]: https://github.com/rust-lang/rust/pull/30928
5931 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
5932 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
5933 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
5934 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
5935 [1.7d]: https://github.com/rust-lang/rust/pull/30724
5936 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
5937 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
5938 [1.7f]: https://github.com/rust-lang/rust/pull/30672
5939 [1.7h]: https://github.com/rust-lang/rust/pull/30818
5940 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
5941 [1.7m]: https://github.com/rust-lang/rust/pull/30381
5942 [1.7p]: https://github.com/rust-lang/rust/pull/30681
5943 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
5944 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
5945 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
5946 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
5947 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
5948 [1.7v]: https://github.com/rust-lang/rust/pull/29973
5949 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5950 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5951 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
5952 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
5953 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
5954 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
5955 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
5956 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
5957 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
5958 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
5959 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
5960 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
5961 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
5962 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
5963 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
5964 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
5965 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
5966 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
5967 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
5968 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
5969 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
5970 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
5971 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
5972 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
5973 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
5974 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
5975 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
5976 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
5977 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
5978 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
5979 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
5980 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
5981 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
5982 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
5983 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
5984 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
5985 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
5986 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
5987 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
5988 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
5989 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
5990 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
5991 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
5992 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
5993 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
5994 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
5995 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
5996 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5997 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
5998 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5999 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
6000 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
6001 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
6002 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
6003 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
6004 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
6005 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
6006 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
6007 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
6008 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
6009
6010
6011 Version 1.6.0 (2016-01-21)
6012 ==========================
6013
6014 Language
6015 --------
6016
6017 * The `#![no_std]` attribute causes a crate to not be linked to the
6018   standard library, but only the [core library][1.6co], as described
6019   in [RFC 1184]. The core library defines common types and traits but
6020   has no platform dependencies whatsoever, and is the basis for Rust
6021   software in environments that cannot support a full port of the
6022   standard library, such as operating systems. Most of the core
6023   library is now stable.
6024
6025 Libraries
6026 ---------
6027
6028 * Stabilized APIs:
6029   [`Read::read_exact`],
6030   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
6031   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
6032   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
6033   [`os::unix::fs::DirBuilderExt`],
6034   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
6035   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
6036   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
6037   [`collections::hash_map::Drain`],
6038   [`collections::hash_map::HashMap::drain`],
6039   [`collections::hash_set::Drain`],
6040   [`collections::hash_set::HashSet::drain`],
6041   [`collections::binary_heap::Drain`],
6042   [`collections::binary_heap::BinaryHeap::drain`],
6043   [`Vec::extend_from_slice`] (renamed from `push_all`),
6044   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
6045   [`RwLock::into_inner`],
6046   [`Iterator::min_by_key`] (renamed from `min_by`),
6047   [`Iterator::max_by_key`] (renamed from `max_by`).
6048 * The [core library][1.6co] is stable, as are most of its APIs.
6049 * [The `assert_eq!` macro supports arguments that don't implement
6050   `Sized`][1.6ae], such as arrays. In this way it behaves more like
6051   `assert!`.
6052 * Several timer functions that take duration in milliseconds [are
6053   deprecated in favor of those that take `Duration`][1.6ms]. These
6054   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
6055   `thread::park_timeout_ms`.
6056 * The algorithm by which `Vec` reserves additional elements was
6057   [tweaked to not allocate excessive space][1.6a] while still growing
6058   exponentially.
6059 * `From` conversions are [implemented from integers to floats][1.6f]
6060   in cases where the conversion is lossless. Thus they are not
6061   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
6062   or `f64`. They are also not implemented for `isize` and `usize`
6063   because the implementations would be platform-specific. `From` is
6064   also implemented from `f32` to `f64`.
6065 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
6066 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
6067 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
6068 * [`BinaryHeap` was refactored][1.6bh] for modest performance
6069   improvements.
6070 * Sorting slices that are already sorted [is 50% faster in some
6071   cases][1.6s].
6072
6073 Cargo
6074 -----
6075
6076 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
6077 * Cargo build scripts can specify their dependencies by emitting the
6078   [`rerun-if-changed`][1.6rr] key.
6079 * crates.io will reject publication of crates with dependencies that
6080   have a wildcard version constraint. Crates with wildcard
6081   dependencies were seen to cause a variety of problems, as described
6082   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
6083   warning.
6084 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
6085   release folder.  A variety of artifacts that Cargo failed to clean
6086   are now correctly deleted.
6087
6088 Misc
6089 ----
6090
6091 * The `unreachable_code` lint [warns when a function call's argument
6092   diverges][1.6dv].
6093 * The parser indicates [failures that may be caused by
6094   confusingly-similar Unicode characters][1.6uc]
6095 * Certain macro errors [are reported at definition time][1.6m], not
6096   expansion.
6097
6098 Compatibility Notes
6099 -------------------
6100
6101 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
6102   environment variable when locating crates. This was a pre-cargo
6103   feature for integrating with the package manager that was
6104   accidentally never removed.
6105 * [A number of bugs were fixed in the privacy checker][1.6p] that
6106   could cause previously-accepted code to break.
6107 * [Modules and unit/tuple structs may not share the same name][1.6ts].
6108 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
6109   struct pattern syntax (`Foo(..)`) can no longer be used to match
6110   unit structs. This is a warning now, but will become an error in
6111   future releases. Patterns that share the same name as a const are
6112   now an error.
6113 * A bug was fixed that causes [rustc not to apply default type
6114   parameters][1.6xc] when resolving certain method implementations of
6115   traits defined in other crates.
6116
6117 [1.6a]: https://github.com/rust-lang/rust/pull/29454
6118 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
6119 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
6120 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
6121 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
6122 [1.6co]: http://doc.rust-lang.org/core/index.html
6123 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
6124 [1.6f]: https://github.com/rust-lang/rust/pull/29129
6125 [1.6m]: https://github.com/rust-lang/rust/pull/29828
6126 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
6127 [1.6p]: https://github.com/rust-lang/rust/pull/29726
6128 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
6129 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
6130 [1.6s]: https://github.com/rust-lang/rust/pull/29675
6131 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
6132 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
6133 [1.6us]: https://github.com/rust-lang/rust/pull/29383
6134 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
6135 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
6136 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6137 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
6138 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
6139 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
6140 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
6141 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
6142 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
6143 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
6144 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
6145 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
6146 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
6147 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
6148 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
6149 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
6150 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
6151 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
6152 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
6153 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
6154 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
6155 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
6156 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
6157 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
6158 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
6159 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
6160 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
6161 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
6162 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
6163 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
6164
6165
6166 Version 1.5.0 (2015-12-10)
6167 ==========================
6168
6169 * ~700 changes, numerous bugfixes
6170
6171 Highlights
6172 ----------
6173
6174 * Stabilized APIs:
6175   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
6176   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
6177   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
6178   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
6179   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
6180   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
6181   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
6182   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
6183   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
6184   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
6185   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
6186   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
6187   [`Path::read_link`], [`Path::symlink_metadata`],
6188   [`Utf8Error::valid_up_to`], [`Vec::resize`],
6189   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
6190   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
6191   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
6192   [`slice::split_first_mut`], [`slice::split_first`],
6193   [`slice::split_last_mut`], [`slice::split_last`],
6194   [`char::from_u32_unchecked`], [`fs::canonicalize`],
6195   [`str::MatchIndices`], [`str::RMatchIndices`],
6196   [`str::match_indices`], [`str::rmatch_indices`],
6197   [`str::slice_mut_unchecked`], [`string::ParseError`].
6198 * Rust applications hosted on crates.io can be installed locally to
6199   `~/.cargo/bin` with the [`cargo install`] command. Among other
6200   things this makes it easier to augment Cargo with new subcommands:
6201   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
6202   invoked as `cargo foo`.
6203 * Crates with wildcard (`*`) dependencies will [emit warnings when
6204   published][1.5w]. In 1.6 it will no longer be possible to publish
6205   crates with wildcard dependencies.
6206
6207 Breaking Changes
6208 ----------------
6209
6210 * The rules determining when a particular lifetime must outlive
6211   a particular value (known as '[dropck]') have been [modified
6212   to not rely on parametricity][1.5p].
6213 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
6214   and `Arc`][1.5a]. Because these smart pointer types implement
6215   `Deref`, this causes breakage in cases where the interior type
6216   contains methods of the same name.
6217 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
6218   that they could drop their content. Soundness fix.
6219 * All method invocations are [properly checked][1.5wf1] for
6220   [well-formedness][1.5wf2]. Soundness fix.
6221 * Traits whose supertraits contain `Self` are [not object
6222   safe][1.5o]. Soundness fix.
6223 * Target specifications support a [`no_default_libraries`][1.5nd]
6224   setting that controls whether `-nodefaultlibs` is passed to the
6225   linker, and in turn the `is_like_windows` setting no longer affects
6226   the `-nodefaultlibs` flag.
6227 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
6228 * The `#[inline]` and `#[repr]` attributes [can only appear
6229   in valid locations][1.5at].
6230 * Native libraries linked from the local crate are [passed to
6231   the linker before native libraries from upstream crates][1.5nl].
6232 * Two rarely-used attributes, `#[no_debug]` and
6233   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
6234 * Negation of unsigned integers, which has been a warning for
6235   several releases, [is now behind a feature gate and will
6236   generate errors][1.5nu].
6237 * The parser accidentally accepted visibility modifiers on
6238   enum variants, a bug [which has been fixed][1.5ev].
6239 * [A bug was fixed that allowed `use` statements to import unstable
6240   features][1.5use].
6241
6242 Language
6243 --------
6244
6245 * When evaluating expressions at compile-time that are not
6246   compile-time constants (const-evaluating expressions in non-const
6247   contexts), incorrect code such as overlong bitshifts and arithmetic
6248   overflow will [generate a warning instead of an error][1.5ce],
6249   delaying the error until runtime. This will allow the
6250   const-evaluator to be expanded in the future backwards-compatibly.
6251 * The `improper_ctypes` lint [no longer warns about using `isize` and
6252   `usize` in FFI][1.5ict].
6253
6254 Libraries
6255 ---------
6256
6257 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
6258   invariant][1.5c].
6259 * `Default` is [implemented for mutable slices][1.5d].
6260 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
6261 * There are now `From` conversions [between floating point
6262   types][1.5f] where the conversions are lossless.
6263 * There are now `From` conversions [between integer types][1.5i] where
6264   the conversions are lossless.
6265 * [`fs::Metadata` implements `Clone`][1.5fs].
6266 * The `parse` method [accepts a leading "+" when parsing
6267   integers][1.5pi].
6268 * [`AsMut` is implemented for `Vec`][1.5am].
6269 * The `clone_from` implementations for `String` and `BinaryHeap` [have
6270   been optimized][1.5cf] and no longer rely on the default impl.
6271 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
6272   `unsafe extern "C"` function types now [implement `Clone`,
6273   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
6274   `fmt::Debug` for up to 12 arguments][1.5fp].
6275 * [Dropping `Vec`s is much faster in unoptimized builds when the
6276   element types don't implement `Drop`][1.5dv].
6277 * A bug that caused in incorrect behavior when [combining `VecDeque`
6278   with zero-sized types][1.5vdz] was resolved.
6279 * [`PartialOrd` for slices is faster][1.5po].
6280
6281 Miscellaneous
6282 -------------
6283
6284 * [Crate metadata size was reduced by 20%][1.5md].
6285 * [Improvements to code generation reduced the size of libcore by 3.3
6286   MB and rustc's memory usage by 18MB][1.5m].
6287 * [Improvements to deref translation increased performance in
6288   unoptimized builds][1.5dr].
6289 * Various errors in trait resolution [are deduplicated to only be
6290   reported once][1.5te].
6291 * Rust has preliminary [support for rumprun kernels][1.5rr].
6292 * Rust has preliminary [support for NetBSD on amd64][1.5na].
6293
6294 [1.5use]: https://github.com/rust-lang/rust/pull/28364
6295 [1.5po]: https://github.com/rust-lang/rust/pull/28436
6296 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
6297 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
6298 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
6299 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
6300 [1.5md]: https://github.com/rust-lang/rust/pull/28521
6301 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
6302 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
6303 [1.5na]: https://github.com/rust-lang/rust/pull/28543
6304 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
6305 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
6306 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
6307 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
6308 [1.5te]: https://github.com/rust-lang/rust/pull/28645
6309 [1.5at]: https://github.com/rust-lang/rust/pull/28650
6310 [1.5am]: https://github.com/rust-lang/rust/pull/28663
6311 [1.5m]: https://github.com/rust-lang/rust/pull/28778
6312 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
6313 [1.5a]: https://github.com/rust-lang/rust/pull/28811
6314 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
6315 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
6316 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
6317 [1.5i]: https://github.com/rust-lang/rust/pull/28921
6318 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
6319 [1.5f]: https://github.com/rust-lang/rust/pull/29129
6320 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
6321 [1.5s]: https://github.com/rust-lang/rust/pull/29190
6322 [1.5d]: https://github.com/rust-lang/rust/pull/29245
6323 [1.5o]: https://github.com/rust-lang/rust/pull/29259
6324 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
6325 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6326 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
6327 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
6328 [1.5c]: https://github.com/rust-lang/rust/pull/29110
6329 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6330 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
6331 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
6332 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
6333 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
6334 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
6335 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
6336 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
6337 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
6338 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
6339 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
6340 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
6341 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
6342 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
6343 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
6344 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
6345 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
6346 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
6347 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
6348 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
6349 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
6350 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
6351 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
6352 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
6353 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
6354 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
6355 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
6356 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
6357 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
6358 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
6359 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
6360 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
6361 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
6362 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
6363 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
6364 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
6365 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
6366 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
6367 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
6368 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
6369 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
6370 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
6371 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
6372 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
6373 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
6374 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
6375 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
6376 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
6377 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
6378 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
6379 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
6380 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
6381 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
6382 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
6383
6384 Version 1.4.0 (2015-10-29)
6385 ==========================
6386
6387 * ~1200 changes, numerous bugfixes
6388
6389 Highlights
6390 ----------
6391
6392 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
6393   GNU) are now supported and recommended for use.
6394
6395 Breaking Changes
6396 ----------------
6397
6398 * [Several changes have been made to fix type soundness and improve
6399   the behavior of associated types][sound]. See [RFC 1214]. Although
6400   we have mostly introduced these changes as warnings this release, to
6401   become errors next release, there are still some scenarios that will
6402   see immediate breakage.
6403 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
6404   line breaks in addition to `\n`][crlf].
6405 * [Loans of `'static` lifetime extend to the end of a function][stat].
6406 * [`str::parse` no longer introduces avoidable rounding error when
6407   parsing floating point numbers. Together with earlier changes to
6408   float formatting/output, "round trips" like f.to_string().parse()
6409   now preserve the value of f exactly. Additionally, leading plus
6410   signs are now accepted][fp3].
6411
6412
6413 Language
6414 --------
6415
6416 * `use` statements that import multiple items [can now rename
6417   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
6418 * [Binops work correctly on fat pointers][binfat].
6419 * `pub extern crate`, which does not behave as expected, [issues a
6420   warning][pec] until a better solution is found.
6421
6422 Libraries
6423 ---------
6424
6425 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
6426   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
6427   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
6428   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
6429   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
6430   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
6431   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
6432   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
6433   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
6434   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
6435   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
6436   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
6437   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
6438   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
6439   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
6440   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
6441   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
6442   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
6443   [`thread::sleep`].
6444 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
6445   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
6446   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
6447   `f64::from_str_radix`.
6448 * [Reverse-searching strings is faster with the 'two-way'
6449   algorithm][s].
6450 * [`std::io::copy` allows `?Sized` arguments][cc].
6451 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
6452   [override `count`, `nth` and `last` with an O(1)
6453   implementation][it].
6454 * [`Default` is implemented for arrays up to `[T; 32]`][d].
6455 * [`IntoRawFd` has been added to the Unix-specific prelude,
6456   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
6457   prelude][pr].
6458 * [`Extend<String>` and `FromIterator<String` are both implemented for
6459   `String`][es].
6460 * [`IntoIterator` is implemented for references to `Option` and
6461   `Result`][into2].
6462 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
6463   Copy`][ext] as part of [RFC 839]. This will cause type inference
6464   breakage in rare situations.
6465 * [`BinaryHeap` implements `Debug`][bh2].
6466 * [`Borrow` and `BorrowMut` are implemented for fixed-size
6467   arrays][bm].
6468 * [`extern fn`s with the "Rust" and "C" ABIs implement common
6469   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
6470 * [String comparison is faster][faststr].
6471 * `&mut T` where `T: std::fmt::Write` [also implements
6472   `std::fmt::Write`][mutw].
6473 * [A stable regression in `VecDeque::push_back` and other
6474   capacity-altering methods that caused panics for zero-sized types
6475   was fixed][vd].
6476 * [Function pointers implement traits for up to 12 parameters][fp2].
6477
6478 Miscellaneous
6479 -------------
6480
6481 * The compiler [no longer uses the 'morestack' feature to prevent
6482   stack overflow][mm]. Instead it uses guard pages and stack
6483   probes (though stack probes are not yet implemented on any platform
6484   but Windows).
6485 * [The compiler matches traits faster when projections are involved][p].
6486 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
6487   `usize`][ffi].
6488 * [Cargo now displays useful information about what its doing during
6489   `cargo update`][cu].
6490
6491 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
6492 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
6493 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
6494 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
6495 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
6496 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
6497 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
6498 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
6499 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
6500 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
6501 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
6502 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
6503 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
6504 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
6505 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
6506 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
6507 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
6508 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
6509 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6510 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6511 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6512 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6513 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6514 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6515 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6516 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6517 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
6518 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
6519 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
6520 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
6521 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
6522 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
6523 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
6524 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
6525 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
6526 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
6527 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
6528 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
6529 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
6530 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
6531 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
6532 [bh2]: https://github.com/rust-lang/rust/pull/28156
6533 [binfat]: https://github.com/rust-lang/rust/pull/28270
6534 [bm]: https://github.com/rust-lang/rust/pull/28197
6535 [cc]: https://github.com/rust-lang/rust/pull/27531
6536 [crlf]: https://github.com/rust-lang/rust/pull/28034
6537 [cu]: https://github.com/rust-lang/cargo/pull/1931
6538 [d]: https://github.com/rust-lang/rust/pull/27825
6539 [dep]: https://github.com/rust-lang/rust/pull/28339
6540 [es]: https://github.com/rust-lang/rust/pull/27956
6541 [ext]: https://github.com/rust-lang/rust/pull/28094
6542 [faststr]: https://github.com/rust-lang/rust/pull/28338
6543 [ffi]: https://github.com/rust-lang/rust/pull/28779
6544 [fp]: https://github.com/rust-lang/rust/pull/28268
6545 [fp2]: https://github.com/rust-lang/rust/pull/28560
6546 [fp3]: https://github.com/rust-lang/rust/pull/27307
6547 [i]: https://github.com/rust-lang/rust/pull/27451
6548 [into2]: https://github.com/rust-lang/rust/pull/28039
6549 [it]: https://github.com/rust-lang/rust/pull/27652
6550 [mm]: https://github.com/rust-lang/rust/pull/27338
6551 [mutw]: https://github.com/rust-lang/rust/pull/28368
6552 [sound]: https://github.com/rust-lang/rust/pull/27641
6553 [p]: https://github.com/rust-lang/rust/pull/27866
6554 [pec]: https://github.com/rust-lang/rust/pull/28486
6555 [pr]: https://github.com/rust-lang/rust/pull/27896
6556 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6557 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6558 [s]: https://github.com/rust-lang/rust/pull/27474
6559 [stab]: https://github.com/rust-lang/rust/pull/28339
6560 [stat]: https://github.com/rust-lang/rust/pull/28321
6561 [vd]: https://github.com/rust-lang/rust/pull/28494
6562
6563 Version 1.3.0 (2015-09-17)
6564 ==============================
6565
6566 * ~900 changes, numerous bugfixes
6567
6568 Highlights
6569 ----------
6570
6571 * The [new object lifetime defaults][nold] have been [turned
6572   on][nold2] after a cycle of warnings about the change. Now types
6573   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
6574   being interpreted as `&'a Box<Trait+'a>` to `&'a
6575   Box<Trait+'static>`.
6576 * [The Rustonomicon][nom] is a new book in the official documentation
6577   that dives into writing unsafe Rust.
6578 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
6579   timekeeping is employed by other std APIs, as well as out-of-tree
6580   time crates.
6581
6582 Breaking Changes
6583 ----------------
6584
6585 * The [new object lifetime defaults][nold] have been [turned
6586   on][nold2] after a cycle of warnings about the change.
6587 * There is a known [regression][lr] in how object lifetime elision is
6588   interpreted, the proper solution for which is undetermined.
6589 * The `#[prelude_import]` attribute, an internal implementation
6590   detail, was accidentally stabilized previously. [It has been put
6591   behind the `prelude_import` feature gate][pi]. This change is
6592   believed to break no existing code.
6593 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6594   [more sane for dynamically sized types][dst3]. Code that relied on
6595   the previous behavior is thought to be broken.
6596 * The `dropck` rules, which checks that destructors can't access
6597   destroyed values, [have been updated][dropck] to match the
6598   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
6599   cause some previously-compiling code to no longer build.
6600
6601 Language
6602 --------
6603
6604 * The [new object lifetime defaults][nold] have been [turned
6605   on][nold2] after a cycle of warnings about the change.
6606 * Semicolons may [now follow types and paths in
6607   macros](https://github.com/rust-lang/rust/pull/27000).
6608 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6609   [more sane for dynamically sized types][dst3]. Code that relied on
6610   the previous behavior is not known to exist, and suspected to be
6611   broken.
6612 * `'static` variables [may now be recursive][st].
6613 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
6614   implementations correctly.
6615 * The `dropck` rules, which checks that destructors can't access
6616   destroyed values, [have been updated][dropck] to match the
6617   [RFC][dropckrfc].
6618
6619 Libraries
6620 ---------
6621
6622 * The [`Duration`] API, [has been stabilized][ds], as well as the
6623   `std::time` module, which presently contains only `Duration`.
6624 * `Box<str>` and `Box<[T]>` both implement `Clone`.
6625 * The owned C string, [`CString`], implements [`Borrow`] and the
6626   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
6627   these allow C strings to be borrowed and cloned in generic code.
6628 * [`CStr`] implements [`Debug`].
6629 * [`AtomicPtr`] implements [`Debug`].
6630 * [`Error`] trait objects [can be downcast to their concrete types][e]
6631   in many common configurations, using the [`is`], [`downcast`],
6632   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
6633   [`Any`] trait.
6634 * Searching for substrings now [employs the two-way algorithm][search]
6635   instead of doing a naive search. This gives major speedups to a
6636   number of methods, including [`contains`][sc], [`find`][sf],
6637   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
6638   [`ends_with`][sew] are also faster.
6639 * The performance of `PartialEq` for slices is [much faster][ps].
6640 * The [`Hash`] trait offers the default method, [`hash_slice`], which
6641   is overridden and optimized by the implementations for scalars.
6642 * The [`Hasher`] trait now has a number of specialized `write_*`
6643   methods for primitive types, for efficiency.
6644 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
6645   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
6646   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
6647   of [`std::error::Error::cause`][iec] also delegates to the inner
6648   error.
6649 * [`process::Child`][pc] gained the [`id`] method, which returns a
6650   `u32` representing the platform-specific process identifier.
6651 * The [`connect`] method on slices is deprecated, replaced by the new
6652   [`join`] method (note that both of these are on the *unstable*
6653   [`SliceConcatExt`] trait, but through the magic of the prelude are
6654   available to stable code anyway).
6655 * The [`Div`] operator is implemented for [`Wrapping`] types.
6656 * [`DerefMut` is implemented for `String`][dms].
6657 * Performance of SipHash (the default hasher for `HashMap`) is
6658   [better for long data][sh].
6659 * [`AtomicPtr`] implements [`Send`].
6660 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
6661   are now [specialized to use uninitialized buffers for increased
6662   performance][rte].
6663 * Lifetime parameters of foreign functions [are now resolved
6664   properly][f].
6665
6666 Misc
6667 ----
6668
6669 * Rust can now, with some coercion, [produce programs that run on
6670   Windows XP][xp], though XP is not considered a supported platform.
6671 * Porting Rust on Windows from the GNU toolchain to MSVC continues
6672   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
6673   recommended for use in 1.3, though should be fully-functional
6674   in the [64-bit 1.4 beta][b14].
6675 * On Fedora-based systems installation will [properly configure the
6676   dynamic linker][fl].
6677 * The compiler gained many new extended error descriptions, which can
6678   be accessed with the `--explain` flag.
6679 * The `dropck` pass, which checks that destructors can't access
6680   destroyed values, [has been rewritten][dropck]. This fixes some
6681   soundness holes, and as such will cause some previously-compiling
6682   code to no longer build.
6683 * `rustc` now uses [LLVM to write archive files where possible][ar].
6684   Eventually this will eliminate the compiler's dependency on the ar
6685   utility.
6686 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
6687   supported FreeBSD on x86_64).
6688 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
6689   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
6690   more strict.
6691 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
6692   will kill the process instead of leaking][nlp].
6693
6694 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
6695 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
6696 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
6697 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
6698 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
6699 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6700 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6701 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
6702 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
6703 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
6704 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
6705 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
6706 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
6707 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6708 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
6709 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
6710 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
6711 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
6712 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6713 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
6714 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
6715 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
6716 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
6717 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6718 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
6719 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
6720 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
6721 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
6722 [ar]: https://github.com/rust-lang/rust/pull/26926
6723 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
6724 [dms]: https://github.com/rust-lang/rust/pull/26241
6725 [dropck]: https://github.com/rust-lang/rust/pull/27261
6726 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6727 [ds]: https://github.com/rust-lang/rust/pull/26818
6728 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
6729 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
6730 [dst3]: https://github.com/rust-lang/rust/pull/27351
6731 [e]: https://github.com/rust-lang/rust/pull/24793
6732 [f]: https://github.com/rust-lang/rust/pull/26588
6733 [fb]: https://github.com/rust-lang/rust/pull/26959
6734 [fl]: https://github.com/rust-lang/rust-installer/pull/41
6735 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6736 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
6737 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
6738 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
6739 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
6740 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
6741 [lic]: https://github.com/rust-lang/rust/pull/26583
6742 [lnu]: https://github.com/rust-lang/rust/pull/27026
6743 [lr]: https://github.com/rust-lang/rust/issues/27248
6744 [lum]: https://github.com/rust-lang/rust/pull/26378
6745 [lur]: https://github.com/rust-lang/rust/pull/26783
6746 [nlp]: https://github.com/rust-lang/rust/pull/27176
6747 [nold2]: https://github.com/rust-lang/rust/pull/27045
6748 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
6749 [nom]: http://doc.rust-lang.org/nightly/nomicon/
6750 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
6751 [pi]: https://github.com/rust-lang/rust/pull/26699
6752 [ps]: https://github.com/rust-lang/rust/pull/26884
6753 [rte]: https://github.com/rust-lang/rust/pull/26950
6754 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
6755 [search]: https://github.com/rust-lang/rust/pull/26327
6756 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
6757 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
6758 [sh]: https://github.com/rust-lang/rust/pull/27280
6759 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
6760 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
6761 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
6762 [st]: https://github.com/rust-lang/rust/pull/26630
6763 [win1]: https://github.com/rust-lang/rust/pull/26569
6764 [win2]: https://github.com/rust-lang/rust/pull/26741
6765 [win3]: https://github.com/rust-lang/rust/pull/26741
6766 [win4]: https://github.com/rust-lang/rust/pull/27210
6767 [xp]: https://github.com/rust-lang/rust/pull/26569
6768
6769 Version 1.2.0 (2015-08-07)
6770 ==========================
6771
6772 * ~1200 changes, numerous bugfixes
6773
6774 Highlights
6775 ----------
6776
6777 * [Dynamically-sized-type coercions][dst] allow smart pointer types
6778   like `Rc` to contain types without a fixed size, arrays and trait
6779   objects, finally enabling use of `Rc<[T]>` and completing the
6780   implementation of DST.
6781 * [Parallel codegen][parcodegen] is now working again, which can
6782   substantially speed up large builds in debug mode; It also gets
6783   another ~33% speedup when bootstrapping on a 4 core machine (using 8
6784   jobs). It's not enabled by default, but will be "in the near
6785   future". It can be activated with the `-C codegen-units=N` flag to
6786   `rustc`.
6787 * This is the first release with [experimental support for linking
6788   with the MSVC linker and lib C on Windows (instead of using the GNU
6789   variants via MinGW)][win]. It is yet recommended only for the most
6790   intrepid Rustaceans.
6791 * Benchmark compilations are showing a 30% improvement in
6792   bootstrapping over 1.1.
6793
6794 Breaking Changes
6795 ----------------
6796
6797 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
6798   unicode case mapping, which is a previously-planned change in
6799   behavior and considered a bugfix.
6800 * [`mem::align_of`] now specifies [the *minimum alignment* for
6801   T][align], which is usually the alignment programs are interested
6802   in, and the same value reported by clang's
6803   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
6804   break real code.
6805 * [The `#[packed]` attribute is no longer silently accepted by the
6806   compiler][packed]. This attribute did nothing and code that
6807   mentioned it likely did not work as intended.
6808 * Associated type defaults are [now behind the
6809   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
6810   defaults *did not work*, but could be mentioned syntactically. As
6811   such this breakage has minimal impact.
6812
6813 Language
6814 --------
6815
6816 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
6817   matching against dereferenceable values.
6818
6819 Libraries
6820 ---------
6821
6822 * The [`Extend`] trait, which grows a collection from an iterator, is
6823   implemented over iterators of references, for `String`, `Vec`,
6824   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
6825   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
6826 * The [`iter::once`] function returns an iterator that yields a single
6827   element, and [`iter::empty`] returns an iterator that yields no
6828   elements.
6829 * The [`matches`] and [`rmatches`] methods on `str` return iterators
6830   over substring matches.
6831 * [`Cell`] and [`RefCell`] both implement `Eq`.
6832 * A number of methods for wrapping arithmetic are added to the
6833   integral types, [`wrapping_div`], [`wrapping_rem`],
6834   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
6835   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
6836   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
6837   type.. It is illegal for the default arithmetic operations in Rust
6838   to overflow; the desire to wrap must be explicit.
6839 * The `{:#?}` formatting specifier [displays the alternate,
6840   pretty-printed][debugfmt] form of the `Debug` formatter. This
6841   feature was actually introduced prior to 1.0 with little
6842   fanfare.
6843 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
6844   for writing data to formatted strings, similar to [`io::Write`].
6845 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
6846   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
6847   are used by code generators to emit implementations of [`Debug`].
6848 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
6849   methods that convert case, following Unicode case mapping.
6850 * It is now easier to handle poisoned locks. The [`PoisonError`]
6851   type, returned by failing lock operations, exposes `into_inner`,
6852   `get_ref`, and `get_mut`, which all give access to the inner lock
6853   guard, and allow the poisoned lock to continue to operate. The
6854   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
6855   poisoned lock without attempting to take the lock.
6856 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
6857   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
6858   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
6859   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
6860   `ChildStderr`.
6861 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
6862   malformed input.
6863
6864 Misc
6865 ----
6866
6867 * `rustc` employs smarter heuristics for guessing at [typos].
6868 * `rustc` emits more efficient code for [no-op conversions between
6869   unsafe pointers][nop].
6870 * Fat pointers are now [passed in pairs of immediate arguments][fat],
6871   resulting in faster compile times and smaller code.
6872
6873 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
6874 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6875 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
6876 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
6877 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
6878 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
6879 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
6880 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
6881 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
6882 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
6883 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
6884 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
6885 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
6886 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
6887 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
6888 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
6889 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6890 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
6891 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
6892 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
6893 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
6894 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
6895 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
6896 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
6897 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
6898 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6899 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
6900 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
6901 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
6902 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
6903 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
6904 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
6905 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
6906 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
6907 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
6908 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
6909 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
6910 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
6911 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
6912 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
6913 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
6914 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6915 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
6916 [align]: https://github.com/rust-lang/rust/pull/25646
6917 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
6918 [typos]: https://github.com/rust-lang/rust/pull/26087
6919 [nop]: https://github.com/rust-lang/rust/pull/26336
6920 [fat]: https://github.com/rust-lang/rust/pull/26411
6921 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
6922 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
6923 [packed]: https://github.com/rust-lang/rust/pull/25541
6924 [ad]: https://github.com/rust-lang/rust/pull/27382
6925 [win]: https://github.com/rust-lang/rust/pull/25350
6926
6927 Version 1.1.0 (2015-06-25)
6928 =========================
6929
6930 * ~850 changes, numerous bugfixes
6931
6932 Highlights
6933 ----------
6934
6935 * The [`std::fs` module has been expanded][fs] to expand the set of
6936   functionality exposed:
6937   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
6938     don't incur a syscall on some platforms.
6939   * A `symlink_metadata` function has been added.
6940   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
6941     access to all underlying information.
6942 * The compiler now contains extended explanations of many errors. When an error
6943   with an explanation occurs the compiler suggests using the `--explain` flag
6944   to read the explanation. Error explanations are also [available online][err-index].
6945 * Thanks to multiple [improvements][sk] to [type checking][pre], as
6946   well as other work, the time to bootstrap the compiler decreased by
6947   32%.
6948
6949 Libraries
6950 ---------
6951
6952 * The [`str::split_whitespace`] method splits a string on unicode
6953   whitespace boundaries.
6954 * On both Windows and Unix, new extension traits provide conversion of
6955   I/O types to and from the underlying system handles. On Unix, these
6956   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
6957   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
6958   `TcpListener`, and `UpdSocket`. Further implementations for
6959   `std::process` will be stabilized later.
6960 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
6961   Windows, symlinks can be created with
6962   `std::os::windows::symlink_dir` and
6963   `std::os::windows::symlink_file`.
6964 * The `mpsc::Receiver` type can now be converted into an iterator with
6965   `into_iter` on the [`IntoIterator`] trait.
6966 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
6967   implementation of the [`From`] trait.
6968 * The `Debug` implementation for `RangeFull` [creates output that is
6969   more consistent with other implementations][rf].
6970 * [`Debug` is implemented for `File`][file].
6971 * The `Default` implementation for `Arc` [no longer requires `Sync +
6972   Send`][arc].
6973 * [The `Iterator` methods `count`, `nth`, and `last` have been
6974   overridden for slices to have O(1) performance instead of O(n)][si].
6975 * Incorrect handling of paths on Windows has been improved in both the
6976   compiler and the standard library.
6977 * [`AtomicPtr` gained a `Default` implementation][ap].
6978 * In accordance with Rust's policy on arithmetic overflow `abs` now
6979   [panics on overflow when debug assertions are enabled][abs].
6980 * The [`Cloned`] iterator, which was accidentally left unstable for
6981   1.0 [has been stabilized][c].
6982 * The [`Incoming`] iterator, which iterates over incoming TCP
6983   connections, and which was accidentally unnamable in 1.0, [is now
6984   properly exported][inc].
6985 * [`BinaryHeap`] no longer corrupts itself [when functions called by
6986   `sift_up` or `sift_down` panic][bh].
6987 * The [`split_off`] method of `LinkedList` [no longer corrupts
6988   the list in certain scenarios][ll].
6989
6990 Misc
6991 ----
6992
6993 * Type checking performance [has improved notably][sk] with
6994   [multiple improvements][pre].
6995 * The compiler [suggests code changes][ch] for more errors.
6996 * rustc and it's build system have experimental support for [building
6997   toolchains against MUSL][m] instead of glibc on Linux.
6998 * The compiler defines the `target_env` cfg value, which is used for
6999   distinguishing toolchains that are otherwise for the same
7000   platform. Presently this is set to `gnu` for common GNU Linux
7001   targets and for MinGW targets, and `musl` for MUSL Linux targets.
7002 * The [`cargo rustc`][crc] command invokes a build with custom flags
7003   to rustc.
7004 * [Android executables are always position independent][pie].
7005 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
7006   with `Drop`][drop].
7007
7008 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
7009 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7010 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7011 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
7012 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
7013 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
7014 [rf]: https://github.com/rust-lang/rust/pull/24491
7015 [err-index]: https://doc.rust-lang.org/error-index.html
7016 [sk]: https://github.com/rust-lang/rust/pull/24615
7017 [pre]: https://github.com/rust-lang/rust/pull/25323
7018 [file]: https://github.com/rust-lang/rust/pull/24598
7019 [ch]: https://github.com/rust-lang/rust/pull/24683
7020 [arc]: https://github.com/rust-lang/rust/pull/24695
7021 [si]: https://github.com/rust-lang/rust/pull/24701
7022 [ap]: https://github.com/rust-lang/rust/pull/24834
7023 [m]: https://github.com/rust-lang/rust/pull/24777
7024 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
7025 [crc]: https://github.com/rust-lang/cargo/pull/1568
7026 [pie]: https://github.com/rust-lang/rust/pull/24953
7027 [abs]: https://github.com/rust-lang/rust/pull/25441
7028 [c]: https://github.com/rust-lang/rust/pull/25496
7029 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
7030 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
7031 [inc]: https://github.com/rust-lang/rust/pull/25522
7032 [bh]: https://github.com/rust-lang/rust/pull/25856
7033 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
7034 [ll]: https://github.com/rust-lang/rust/pull/26022
7035 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
7036 [drop]: https://github.com/rust-lang/rust/pull/24935
7037
7038 Version 1.0.0 (2015-05-15)
7039 ========================
7040
7041 * ~1500 changes, numerous bugfixes
7042
7043 Highlights
7044 ----------
7045
7046 * The vast majority of the standard library is now `#[stable]`. It is
7047   no longer possible to use unstable features with a stable build of
7048   the compiler.
7049 * Many popular crates on [crates.io] now work on the stable release
7050   channel.
7051 * Arithmetic on basic integer types now [checks for overflow in debug
7052   builds][overflow].
7053
7054 Language
7055 --------
7056
7057 * Several [restrictions have been added to trait coherence][coh] in
7058   order to make it easier for upstream authors to change traits
7059   without breaking downstream code.
7060 * Digits of binary and octal literals are [lexed more eagerly][lex] to
7061   improve error messages and macro behavior. For example, `0b1234` is
7062   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
7063 * Trait bounds [are always invariant][inv], eliminating the need for
7064   the `PhantomFn` and `MarkerTrait` lang items, which have been
7065   removed.
7066 * ["-" is no longer a valid character in crate names][cr], the `extern crate
7067   "foo" as bar` syntax has been replaced with `extern crate foo as
7068   bar`, and Cargo now automatically translates "-" in *package* names
7069   to underscore for the crate name.
7070 * [Lifetime shadowing is an error][lt].
7071 * [`Send` no longer implies `'static`][send-rfc].
7072 * [UFCS now supports trait-less associated paths][moar-ufcs] like
7073   `MyType::default()`.
7074 * Primitive types [now have inherent methods][prim-inherent],
7075   obviating the need for extension traits like `SliceExt`.
7076 * Methods with `Self: Sized` in their `where` clause are [considered
7077   object-safe][self-sized], allowing many extension traits like
7078   `IteratorExt` to be merged into the traits they extended.
7079 * You can now [refer to associated types][assoc-where] whose
7080   corresponding trait bounds appear only in a `where` clause.
7081 * The final bits of [OIBIT landed][oibit-final], meaning that traits
7082   like `Send` and `Sync` are now library-defined.
7083 * A [Reflect trait][reflect] was introduced, which means that
7084   downcasting via the `Any` trait is effectively limited to concrete
7085   types. This helps retain the potentially-important "parametricity"
7086   property: generic code cannot behave differently for different type
7087   arguments except in minor ways.
7088 * The `unsafe_destructor` feature is now deprecated in favor of the
7089   [new `dropck`][dropck]. This change is a major reduction in unsafe
7090   code.
7091
7092 Libraries
7093 ---------
7094
7095 * The `thread_local` module [has been renamed to `std::thread`][th].
7096 * The methods of `IteratorExt` [have been moved to the `Iterator`
7097   trait itself][ie].
7098 * Several traits that implement Rust's conventions for type
7099   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
7100   [centralized in the `std::convert` module][con].
7101 * The `FromError` trait [was removed in favor of `From`][fe].
7102 * The basic sleep function [has moved to
7103   `std::thread::sleep_ms`][slp].
7104 * The `splitn` function now takes an `n` parameter that represents the
7105   number of items yielded by the returned iterator [instead of the
7106   number of 'splits'][spl].
7107 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
7108 * [Derived implementations of `PartialOrd` now order enums according
7109   to their explicitly-assigned discriminants][po].
7110 * [Methods for searching strings are generic over `Pattern`s][pat],
7111   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
7112   some others.
7113 * [In method resolution, object methods are resolved before inherent
7114   methods][meth].
7115 * [`String::from_str` has been deprecated in favor of the `From` impl,
7116   `String::from`][sf].
7117 * [`io::Error` implements `Sync`][ios].
7118 * [The `words` method on `&str` has been replaced with
7119   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
7120   a word?'
7121 * The new path and IO modules are complete and `#[stable]`. This
7122   was the major library focus for this cycle.
7123 * The path API was [revised][path-normalize] to normalize `.`,
7124   adjusting the tradeoffs in favor of the most common usage.
7125 * A large number of remaining APIs in `std` were also stabilized
7126   during this cycle; about 75% of the non-deprecated API surface
7127   is now stable.
7128 * The new [string pattern API][string-pattern] landed, which makes
7129   the string slice API much more internally consistent and flexible.
7130 * A new set of [generic conversion traits][conversion] replaced
7131   many existing ad hoc traits.
7132 * Generic numeric traits were [completely removed][num-traits]. This
7133   was made possible thanks to inherent methods for primitive types,
7134   and the removal gives maximal flexibility for designing a numeric
7135   hierarchy in the future.
7136 * The `Fn` traits are now related via [inheritance][fn-inherit]
7137   and provide ergonomic [blanket implementations][fn-blanket].
7138 * The `Index` and `IndexMut` traits were changed to
7139   [take the index by value][index-value], enabling code like
7140   `hash_map["string"]` to work.
7141 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
7142   `Copy` data is known to be `Clone` as well.
7143
7144 Misc
7145 ----
7146
7147 * Many errors now have extended explanations that can be accessed with
7148   the `--explain` flag to `rustc`.
7149 * Many new examples have been added to the standard library
7150   documentation.
7151 * rustdoc has received a number of improvements focused on completion
7152   and polish.
7153 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
7154 * Much headway was made on ecosystem-wide CI, making it possible
7155   to [compare builds for breakage][ci-compare].
7156
7157
7158 [crates.io]: http://crates.io
7159 [clo]: https://github.com/rust-lang/rust/pull/24034
7160 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
7161 [con]: https://github.com/rust-lang/rust/pull/23875
7162 [cr]: https://github.com/rust-lang/rust/pull/23419
7163 [fe]: https://github.com/rust-lang/rust/pull/23879
7164 [ie]: https://github.com/rust-lang/rust/pull/23300
7165 [inv]: https://github.com/rust-lang/rust/pull/23938
7166 [ios]: https://github.com/rust-lang/rust/pull/24133
7167 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
7168 [lt]: https://github.com/rust-lang/rust/pull/24057
7169 [meth]: https://github.com/rust-lang/rust/pull/24056
7170 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
7171 [po]: https://github.com/rust-lang/rust/pull/24270
7172 [sf]: https://github.com/rust-lang/rust/pull/24517
7173 [slp]: https://github.com/rust-lang/rust/pull/23949
7174 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
7175 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
7176 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
7177 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
7178 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
7179 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
7180 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
7181 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
7182 [self-sized]: https://github.com/rust-lang/rust/pull/22301
7183 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
7184 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
7185 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
7186 [reflect]: https://github.com/rust-lang/rust/pull/23712
7187 [conversion]: https://github.com/rust-lang/rfcs/pull/529
7188 [num-traits]: https://github.com/rust-lang/rust/pull/23549
7189 [index-value]: https://github.com/rust-lang/rust/pull/23601
7190 [dropck]: https://github.com/rust-lang/rfcs/pull/769
7191 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
7192 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
7193 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
7194 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
7195 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
7196
7197
7198 Version 1.0.0-alpha.2 (2015-02-20)
7199 =====================================
7200
7201 * ~1300 changes, numerous bugfixes
7202
7203 * Highlights
7204
7205     * The various I/O modules were [overhauled][io-rfc] to reduce
7206       unnecessary abstractions and provide better interoperation with
7207       the underlying platform. The old `io` module remains temporarily
7208       at `std::old_io`.
7209     * The standard library now [participates in feature gating][feat],
7210       so use of unstable libraries now requires a `#![feature(...)]`
7211       attribute. The impact of this change is [described on the
7212       forum][feat-forum]. [RFC][feat-rfc].
7213
7214 * Language
7215
7216     * `for` loops [now operate on the `IntoIterator` trait][into],
7217       which eliminates the need to call `.iter()`, etc. to iterate
7218       over collections. There are some new subtleties to remember
7219       though regarding what sort of iterators various types yield, in
7220       particular that `for foo in bar { }` yields values from a move
7221       iterator, destroying the original collection. [RFC][into-rfc].
7222     * Objects now have [default lifetime bounds][obj], so you don't
7223       have to write `Box<Trait+'static>` when you don't care about
7224       storing references. [RFC][obj-rfc].
7225     * In types that implement `Drop`, [lifetimes must outlive the
7226       value][drop]. This will soon make it possible to safely
7227       implement `Drop` for types where `#[unsafe_destructor]` is now
7228       required. Read the [gorgeous RFC][drop-rfc] for details.
7229     * The fully qualified <T as Trait>::X syntax lets you set the Self
7230       type for a trait method or associated type. [RFC][ufcs-rfc].
7231     * References to types that implement `Deref<U>` now [automatically
7232       coerce to references][deref] to the dereferenced type `U`,
7233       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
7234       should eliminate many unsightly uses of `&*`, as when converting
7235       from references to vectors into references to
7236       slices. [RFC][deref-rfc].
7237     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
7238       `|:|`) is obsolete and closure kind is inferred from context.
7239     * [`Self` is a keyword][Self].
7240
7241 * Libraries
7242
7243     * The `Show` and `String` formatting traits [have been
7244       renamed][fmt] to `Debug` and `Display` to more clearly reflect
7245       their related purposes. Automatically getting a string
7246       conversion to use with `format!("{:?}", something_to_debug)` is
7247       now written `#[derive(Debug)]`.
7248     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
7249       OsStr}`, provide strings in platform-specific encodings for easier
7250       interop with system APIs. [RFC][osstr-rfc].
7251     * The `boxed::into_raw` and `Box::from_raw` functions [convert
7252       between `Box<T>` and `*mut T`][boxraw], a common pattern for
7253       creating raw pointers.
7254
7255 * Tooling
7256
7257     * Certain long error messages of the form 'expected foo found bar'
7258       are now [split neatly across multiple
7259       lines][multiline]. Examples in the PR.
7260     * On Unix Rust can be [uninstalled][un] by running
7261       `/usr/local/lib/rustlib/uninstall.sh`.
7262     * The `#[rustc_on_unimplemented]` attribute, requiring the
7263       'on_unimplemented' feature, lets rustc [display custom error
7264       messages when a trait is expected to be implemented for a type
7265       but is not][onun].
7266
7267 * Misc
7268
7269     * Rust is tested against a [LALR grammar][lalr], which parses
7270       almost all the Rust files that rustc does.
7271
7272 [boxraw]: https://github.com/rust-lang/rust/pull/21318
7273 [close]: https://github.com/rust-lang/rust/pull/21843
7274 [deref]: https://github.com/rust-lang/rust/pull/21351
7275 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
7276 [drop]: https://github.com/rust-lang/rust/pull/21972
7277 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7278 [feat]: https://github.com/rust-lang/rust/pull/21248
7279 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
7280 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
7281 [fmt]: https://github.com/rust-lang/rust/pull/21457
7282 [into]: https://github.com/rust-lang/rust/pull/20790
7283 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
7284 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7285 [lalr]: https://github.com/rust-lang/rust/pull/21452
7286 [multiline]: https://github.com/rust-lang/rust/pull/19870
7287 [obj]: https://github.com/rust-lang/rust/pull/22230
7288 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
7289 [onun]: https://github.com/rust-lang/rust/pull/20889
7290 [osstr]: https://github.com/rust-lang/rust/pull/21488
7291 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7292 [Self]: https://github.com/rust-lang/rust/pull/22158
7293 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
7294 [un]: https://github.com/rust-lang/rust/pull/22256
7295
7296
7297 Version 1.0.0-alpha (2015-01-09)
7298 ==================================
7299
7300   * ~2400 changes, numerous bugfixes
7301
7302   * Highlights
7303
7304     * The language itself is considered feature complete for 1.0,
7305       though there will be many usability improvements and bugfixes
7306       before the final release.
7307     * Nearly 50% of the public API surface of the standard library has
7308       been declared 'stable'. Those interfaces are unlikely to change
7309       before 1.0.
7310     * The long-running debate over integer types has been
7311       [settled][ints]: Rust will ship with types named `isize` and
7312       `usize`, rather than `int` and `uint`, for pointer-sized
7313       integers. Guidelines will be rolled out during the alpha cycle.
7314     * Most crates that are not `std` have been moved out of the Rust
7315       distribution into the Cargo ecosystem so they can evolve
7316       separately and don't need to be stabilized as quickly, including
7317       'time', 'getopts', 'num', 'regex', and 'term'.
7318     * Documentation continues to be expanded with more API coverage, more
7319       examples, and more in-depth explanations. The guides have been
7320       consolidated into [The Rust Programming Language][trpl].
7321     * "[Rust By Example][rbe]" is now maintained by the Rust team.
7322     * All official Rust binary installers now come with [Cargo], the
7323       Rust package manager.
7324
7325 * Language
7326
7327     * Closures have been [completely redesigned][unboxed] to be
7328       implemented in terms of traits, can now be used as generic type
7329       bounds and thus monomorphized and inlined, or via an opaque
7330       pointer (boxed) as in the old system. The new system is often
7331       referred to as 'unboxed' closures.
7332     * Traits now support [associated types][assoc], allowing families
7333       of related types to be defined together and used generically in
7334       powerful ways.
7335     * Enum variants are [namespaced by their type names][enum].
7336     * [`where` clauses][where] provide a more versatile and attractive
7337       syntax for specifying generic bounds, though the previous syntax
7338       remains valid.
7339     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
7340       numeric types.
7341     * Rust [no longer has a runtime][rt] of any description, and only
7342       supports OS threads, not green threads.
7343     * At long last, Rust has been overhauled for 'dynamically-sized
7344       types' ([DST]), which integrates 'fat pointers' (object types,
7345       arrays, and `str`) more deeply into the type system, making it
7346       more consistent.
7347     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
7348       `..j` that produce range types and which, when combined with the
7349       `Index` operator and multidispatch, leads to a convenient slice
7350       notation, `[i..j]`.
7351     * The new range syntax revealed an ambiguity in the fixed-length
7352       array syntax, so now fixed length arrays [are written `[T;
7353       N]`][arrays].
7354     * The `Copy` trait is no longer implemented automatically. Unsafe
7355       pointers no longer implement `Sync` and `Send` so types
7356       containing them don't automatically either. `Sync` and `Send`
7357       are now 'unsafe traits' so one can "forcibly" implement them via
7358       `unsafe impl` if a type confirms to the requirements for them
7359       even though the internals do not (e.g. structs containing unsafe
7360       pointers like `Arc`). These changes are intended to prevent some
7361       footguns and are collectively known as [opt-in built-in
7362       traits][oibit] (though `Sync` and `Send` will soon become pure
7363       library types unknown to the compiler).
7364     * Operator traits now take their operands [by value][ops], and
7365       comparison traits can use multidispatch to compare one type
7366       against multiple other types, allowing e.g. `String` to be
7367       compared with `&str`.
7368     * `if let` and `while let` are no longer feature-gated.
7369     * Rust has adopted a more [uniform syntax for escaping unicode
7370       characters][unicode].
7371     * `macro_rules!` [has been declared stable][mac]. Though it is a
7372       flawed system it is sufficiently popular that it must be usable
7373       for 1.0. Effort has gone into [future-proofing][mac-future] it
7374       in ways that will allow other macro systems to be developed in
7375       parallel, and won't otherwise impact the evolution of the
7376       language.
7377     * The prelude has been [pared back significantly][prelude] such
7378       that it is the minimum necessary to support the most pervasive
7379       code patterns, and through [generalized where clauses][where]
7380       many of the prelude extension traits have been consolidated.
7381     * Rust's rudimentary reflection [has been removed][refl], as it
7382       incurred too much code generation for little benefit.
7383     * [Struct variants][structvars] are no longer feature-gated.
7384     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
7385       known as 'higher-ranked trait bounds', this crucially allows
7386       unboxed closures to work.
7387     * Macros invocations surrounded by parens or square brackets and
7388       not terminated by a semicolon are [parsed as
7389       expressions][macros], which makes expressions like `vec![1i32,
7390       2, 3].len()` work as expected.
7391     * Trait objects now implement their traits automatically, and
7392       traits that can be coerced to objects now must be [object
7393       safe][objsafe].
7394     * Automatically deriving traits is now done with `#[derive(...)]`
7395       not `#[deriving(...)]` for [consistency with other naming
7396       conventions][derive].
7397     * Importing the containing module or enum at the same time as
7398       items or variants they contain is [now done with `self` instead
7399       of `mod`][self], as in use `foo::{self, bar}`
7400     * Glob imports are no longer feature-gated.
7401     * The `box` operator and `box` patterns have been feature-gated
7402       pending a redesign. For now unique boxes should be allocated
7403       like other containers, with `Box::new`.
7404
7405 * Libraries
7406
7407     * A [series][coll1] of [efforts][coll2] to establish
7408       [conventions][coll3] for collections types has resulted in API
7409       improvements throughout the standard library.
7410     * New [APIs for error handling][err] provide ergonomic interop
7411       between error types, and [new conventions][err-conv] describe
7412       more clearly the recommended error handling strategies in Rust.
7413     * The `fail!` macro has been renamed to [`panic!`][panic] so that
7414       it is easier to discuss failure in the context of error handling
7415       without making clarifications as to whether you are referring to
7416       the 'fail' macro or failure more generally.
7417     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
7418       syscall when available.
7419     * The 'serialize' crate has been renamed 'rustc-serialize' and
7420       moved out of the distribution to Cargo. Although it is widely
7421       used now, it is expected to be superseded in the near future.
7422     * The `Show` formatter, typically implemented with
7423       `#[derive(Show)]` is [now requested with the `{:?}`
7424       specifier][show] and is intended for use by all types, for uses
7425       such as `println!` debugging. The new `String` formatter must be
7426       implemented by hand, uses the `{}` specifier, and is intended
7427       for full-fidelity conversions of things that can logically be
7428       represented as strings.
7429
7430 * Tooling
7431
7432     * [Flexible target specification][flex] allows rustc's code
7433       generation to be configured to support otherwise-unsupported
7434       platforms.
7435     * Rust comes with rust-gdb and rust-lldb scripts that launch their
7436       respective debuggers with Rust-appropriate pretty-printing.
7437     * The Windows installation of Rust is distributed with the
7438       MinGW components currently required to link binaries on that
7439       platform.
7440
7441 * Misc
7442
7443     * Nullable enum optimizations have been extended to more types so
7444       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
7445       space than the inner types themselves.
7446     * Work has begun on supporting AArch64.
7447
7448 [Cargo]: https://crates.io
7449 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
7450 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
7451 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
7452 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
7453 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
7454 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
7455 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
7456 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
7457 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
7458 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
7459 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
7460 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
7461 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
7462 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
7463 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
7464 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
7465 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
7466 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
7467 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
7468 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
7469 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
7470 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
7471 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
7472 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
7473 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
7474 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
7475 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
7476 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
7477 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
7478 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
7479 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
7480 [trpl]: https://doc.rust-lang.org/book/index.html
7481 [rbe]: http://rustbyexample.com/
7482
7483
7484 Version 0.12.0 (2014-10-09)
7485 =============================
7486
7487   * ~1900 changes, numerous bugfixes
7488
7489   * Highlights
7490
7491     * The introductory documentation (now called The Rust Guide) has
7492       been completely rewritten, as have a number of supplementary
7493       guides.
7494     * Rust's package manager, Cargo, continues to improve and is
7495       sometimes considered to be quite awesome.
7496     * Many API's in `std` have been reviewed and updated for
7497       consistency with the in-development Rust coding
7498       guidelines. The standard library documentation tracks
7499       stabilization progress.
7500     * Minor libraries have been moved out-of-tree to the rust-lang org
7501       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
7502       be installed with Cargo.
7503     * Lifetime elision allows lifetime annotations to be left off of
7504       function declarations in many common scenarios.
7505     * Rust now works on 64-bit Windows.
7506
7507   * Language
7508     * Indexing can be overloaded with the `Index` and `IndexMut`
7509       traits.
7510     * The `if let` construct takes a branch only if the `let` pattern
7511       matches, currently behind the 'if_let' feature gate.
7512     * 'where clauses', a more flexible syntax for specifying trait
7513       bounds that is more aesthetic, have been added for traits and
7514       free functions. Where clauses will in the future make it
7515       possible to constrain associated types, which would be
7516       impossible with the existing syntax.
7517     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
7518       the 'slicing_syntax' feature gate, and can be overloaded with
7519       the `Slice` or `SliceMut` traits.
7520     * The syntax for matching of sub-slices has been changed to use a
7521       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
7522       consistency with other uses of `..` and to future-proof
7523       potential additional uses of the syntax.
7524     * The syntax for matching inclusive ranges in patterns has changed
7525       from `0..3` to `0...4` to be consistent with the exclusive range
7526       syntax for slicing.
7527     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
7528       c]`) has been put behind the 'advanced_slice_patterns' feature
7529       gate and may be removed in the future.
7530     * Components of tuples and tuple structs can be extracted using
7531       the `value.0` syntax, currently behind the `tuple_indexing`
7532       feature gate.
7533     * The `#[crate_id]` attribute is no longer supported; versioning
7534       is handled by the package manager.
7535     * Renaming crate imports are now written `extern crate foo as bar`
7536       instead of `extern crate bar = foo`.
7537     * Renaming use statements are now written `use foo as bar` instead
7538       of `use bar = foo`.
7539     * `let` and `match` bindings and argument names in macros are now
7540       hygienic.
7541     * The new, more efficient, closure types ('unboxed closures') have
7542       been added under a feature gate, 'unboxed_closures'. These will
7543       soon replace the existing closure types, once higher-ranked
7544       trait lifetimes are added to the language.
7545     * `move` has been added as a keyword, for indicating closures
7546       that capture by value.
7547     * Mutation and assignment is no longer allowed in pattern guards.
7548     * Generic structs and enums can now have trait bounds.
7549     * The `Share` trait is now called `Sync` to free up the term
7550       'shared' to refer to 'shared reference' (the default reference
7551       type.
7552     * Dynamically-sized types have been mostly implemented,
7553       unifying the behavior of fat-pointer types with the rest of the
7554       type system.
7555     * As part of dynamically-sized types, the `Sized` trait has been
7556       introduced, which qualifying types implement by default, and
7557       which type parameters expect by default. To specify that a type
7558       parameter does not need to be sized, write `<Sized? T>`. Most
7559       types are `Sized`, notable exceptions being unsized arrays
7560       (`[T]`) and trait types.
7561     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
7562     * Lifetime bounds can now be applied to type parameters and object
7563       types.
7564     * The old, reference counted GC type, `Gc<T>` which was once
7565       denoted by the `@` sigil, has finally been removed. GC will be
7566       revisited in the future.
7567
7568   * Libraries
7569     * Library documentation has been improved for a number of modules.
7570     * Bit-vectors, collections::bitv has been modernized.
7571     * The url crate is deprecated in favor of
7572       http://github.com/servo/rust-url, which can be installed with
7573       Cargo.
7574     * Most I/O stream types can be cloned and subsequently closed from
7575       a different thread.
7576     * A `std::time::Duration` type has been added for use in I/O
7577       methods that rely on timers, as well as in the 'time' crate's
7578       `Timespec` arithmetic.
7579     * The runtime I/O abstraction layer that enabled the green thread
7580       scheduler to do non-thread-blocking I/O has been removed, along
7581       with the libuv-based implementation employed by the green thread
7582       scheduler. This will greatly simplify the future I/O work.
7583     * `collections::btree` has been rewritten to have a more
7584       idiomatic and efficient design.
7585
7586   * Tooling
7587     * rustdoc output now indicates the stability levels of API's.
7588     * The `--crate-name` flag can specify the name of the crate
7589       being compiled, like `#[crate_name]`.
7590     * The `-C metadata` specifies additional metadata to hash into
7591       symbol names, and `-C extra-filename` specifies additional
7592       information to put into the output filename, for use by the
7593       package manager for versioning.
7594     * debug info generation has continued to improve and should be
7595       more reliable under both gdb and lldb.
7596     * rustc has experimental support for compiling in parallel
7597       using the `-C codegen-units` flag.
7598     * rustc no longer encodes rpath information into binaries by
7599       default.
7600
7601   * Misc
7602     * Stack usage has been optimized with LLVM lifetime annotations.
7603     * Official Rust binaries on Linux are more compatible with older
7604       kernels and distributions, built on CentOS 5.10.
7605
7606
7607 Version 0.11.0 (2014-07-02)
7608 ==========================
7609
7610   * ~1700 changes, numerous bugfixes
7611
7612   * Language
7613     * ~[T] has been removed from the language. This type is superseded by
7614       the Vec<T> type.
7615     * ~str has been removed from the language. This type is superseded by
7616       the String type.
7617     * ~T has been removed from the language. This type is superseded by the
7618       Box<T> type.
7619     * @T has been removed from the language. This type is superseded by the
7620       standard library's std::gc::Gc<T> type.
7621     * Struct fields are now all private by default.
7622     * Vector indices and shift amounts are both required to be a `uint`
7623       instead of any integral type.
7624     * Byte character, byte string, and raw byte string literals are now all
7625       supported by prefixing the normal literal with a `b`.
7626     * Multiple ABIs are no longer allowed in an ABI string
7627     * The syntax for lifetimes on closures/procedures has been tweaked
7628       slightly: `<'a>|A, B|: 'b + K -> T`
7629     * Floating point modulus has been removed from the language; however it
7630       is still provided by a library implementation.
7631     * Private enum variants are now disallowed.
7632     * The `priv` keyword has been removed from the language.
7633     * A closure can no longer be invoked through a &-pointer.
7634     * The `use foo, bar, baz;` syntax has been removed from the language.
7635     * The transmute intrinsic no longer works on type parameters.
7636     * Statics now allow blocks/items in their definition.
7637     * Trait bounds are separated from objects with + instead of : now.
7638     * Objects can no longer be read while they are mutably borrowed.
7639     * The address of a static is now marked as insignificant unless the
7640       #[inline(never)] attribute is placed it.
7641     * The #[unsafe_destructor] attribute is now behind a feature gate.
7642     * Struct literals are no longer allowed in ambiguous positions such as
7643       if, while, match, and for..in.
7644     * Declaration of lang items and intrinsics are now feature-gated by
7645       default.
7646     * Integral literals no longer default to `int`, and floating point
7647       literals no longer default to `f64`. Literals must be suffixed with an
7648       appropriate type if inference cannot determine the type of the
7649       literal.
7650     * The Box<T> type is no longer implicitly borrowed to &mut T.
7651     * Procedures are now required to not capture borrowed references.
7652
7653   * Libraries
7654     * The standard library is now a "facade" over a number of underlying
7655       libraries. This means that development on the standard library should
7656       be speedier due to smaller crates, as well as a clearer line between
7657       all dependencies.
7658     * A new library, libcore, lives under the standard library's facade
7659       which is Rust's "0-assumption" library, suitable for embedded and
7660       kernel development for example.
7661     * A regex crate has been added to the standard distribution. This crate
7662       includes statically compiled regular expressions.
7663     * The unwrap/unwrap_err methods on Result require a Show bound for
7664       better error messages.
7665     * The return types of the std::comm primitives have been centralized
7666       around the Result type.
7667     * A number of I/O primitives have gained the ability to time out their
7668       operations.
7669     * A number of I/O primitives have gained the ability to close their
7670       reading/writing halves to cancel pending operations.
7671     * Reverse iterator methods have been removed in favor of `rev()` on
7672       their forward-iteration counterparts.
7673     * A bitflags! macro has been added to enable easy interop with C and
7674       management of bit flags.
7675     * A debug_assert! macro is now provided which is disabled when
7676       `--cfg ndebug` is passed to the compiler.
7677     * A graphviz crate has been added for creating .dot files.
7678     * The std::cast module has been migrated into std::mem.
7679     * The std::local_data api has been migrated from freestanding functions
7680       to being based on methods.
7681     * The Pod trait has been renamed to Copy.
7682     * jemalloc has been added as the default allocator for types.
7683     * The API for allocating memory has been changed to use proper alignment
7684       and sized deallocation
7685     * Connecting a TcpStream or binding a TcpListener is now based on a
7686       string address and a u16 port. This allows connecting to a hostname as
7687       opposed to an IP.
7688     * The Reader trait now contains a core method, read_at_least(), which
7689       correctly handles many repeated 0-length reads.
7690     * The process-spawning API is now centered around a builder-style
7691       Command struct.
7692     * The :? printing qualifier has been moved from the standard library to
7693       an external libdebug crate.
7694     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
7695       have been renamed to Eq/Ord.
7696     * The select/plural methods have been removed from format!. The escapes
7697       for { and } have also changed from \{ and \} to {{ and }},
7698       respectively.
7699     * The TaskBuilder API has been re-worked to be a true builder, and
7700       extension traits for spawning native/green tasks have been added.
7701
7702   * Tooling
7703     * All breaking changes to the language or libraries now have their
7704       commit message annotated with `[breaking-change]` to allow for easy
7705       discovery of breaking changes.
7706     * The compiler will now try to suggest how to annotate lifetimes if a
7707       lifetime-related error occurs.
7708     * Debug info continues to be improved greatly with general bug fixes and
7709       better support for situations like link time optimization (LTO).
7710     * Usage of syntax extensions when cross-compiling has been fixed.
7711     * Functionality equivalent to GCC & Clang's -ffunction-sections,
7712       -fdata-sections and --gc-sections has been enabled by default
7713     * The compiler is now stricter about where it will load module files
7714       from when a module is declared via `mod foo;`.
7715     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
7716       Syntax extensions are now discovered via a "plugin registrar" type
7717       which will be extended in the future to other various plugins.
7718     * Lints have been restructured to allow for dynamically loadable lints.
7719     * A number of rustdoc improvements:
7720       * The HTML output has been visually redesigned.
7721       * Markdown is now powered by hoedown instead of sundown.
7722       * Searching heuristics have been greatly improved.
7723       * The search index has been reduced in size by a great amount.
7724       * Cross-crate documentation via `pub use` has been greatly improved.
7725       * Primitive types are now hyperlinked and documented.
7726     * Documentation has been moved from static.rust-lang.org/doc to
7727       doc.rust-lang.org
7728     * A new sandbox, play.rust-lang.org, is available for running and
7729       sharing rust code examples on-line.
7730     * Unused attributes are now more robustly warned about.
7731     * The dead_code lint now warns about unused struct fields.
7732     * Cross-compiling to iOS is now supported.
7733     * Cross-compiling to mipsel is now supported.
7734     * Stability attributes are now inherited by default and no longer apply
7735       to intra-crate usage, only inter-crate usage.
7736     * Error message related to non-exhaustive match expressions have been
7737       greatly improved.
7738
7739
7740 Version 0.10 (2014-04-03)
7741 =========================
7742
7743   * ~1500 changes, numerous bugfixes
7744
7745   * Language
7746     * A new RFC process is now in place for modifying the language.
7747     * Patterns with `@`-pointers have been removed from the language.
7748     * Patterns with unique vectors (`~[T]`) have been removed from the
7749       language.
7750     * Patterns with unique strings (`~str`) have been removed from the
7751       language.
7752     * `@str` has been removed from the language.
7753     * `@[T]` has been removed from the language.
7754     * `@self` has been removed from the language.
7755     * `@Trait` has been removed from the language.
7756     * Headers on `~` allocations which contain `@` boxes inside the type for
7757       reference counting have been removed.
7758     * The semantics around the lifetimes of temporary expressions have changed,
7759       see #3511 and #11585 for more information.
7760     * Cross-crate syntax extensions are now possible, but feature gated. See
7761       #11151 for more information. This includes both `macro_rules!` macros as
7762       well as syntax extensions such as `format!`.
7763     * New lint modes have been added, and older ones have been turned on to be
7764       warn-by-default.
7765       * Unnecessary parentheses
7766       * Uppercase statics
7767       * Camel Case types
7768       * Uppercase variables
7769       * Publicly visible private types
7770       * `#[deriving]` with raw pointers
7771     * Unsafe functions can no longer be coerced to closures.
7772     * Various obscure macros such as `log_syntax!` are now behind feature gates.
7773     * The `#[simd]` attribute is now behind a feature gate.
7774     * Visibility is no longer allowed on `extern crate` statements, and
7775       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
7776     * Trailing commas are now allowed in argument lists and tuple patterns.
7777     * The `do` keyword has been removed, it is now a reserved keyword.
7778     * Default type parameters have been implemented, but are feature gated.
7779     * Borrowed variables through captures in closures are now considered soundly.
7780     * `extern mod` is now `extern crate`
7781     * The `Freeze` trait has been removed.
7782     * The `Share` trait has been added for types that can be shared among
7783       threads.
7784     * Labels in macros are now hygienic.
7785     * Expression/statement macro invocations can be delimited with `{}` now.
7786     * Treatment of types allowed in `static mut` locations has been tweaked.
7787     * The `*` and `.` operators are now overloadable through the `Deref` and
7788       `DerefMut` traits.
7789     * `~Trait` and `proc` no longer have `Send` bounds by default.
7790     * Partial type hints are now supported with the `_` type marker.
7791     * An `Unsafe` type was introduced for interior mutability. It is now
7792       considered undefined to transmute from `&T` to `&mut T` without using the
7793       `Unsafe` type.
7794     * The #[linkage] attribute was implemented for extern statics/functions.
7795     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
7796     * `Pod` was renamed to `Copy`.
7797
7798   * Libraries
7799     * The `libextra` library has been removed. It has now been decomposed into
7800       component libraries with smaller and more focused nuggets of
7801       functionality. The full list of libraries can be found on the
7802       documentation index page.
7803     * std: `std::condition` has been removed. All I/O errors are now propagated
7804       through the `Result` type. In order to assist with error handling, a
7805       `try!` macro for unwrapping errors with an early return and a lint for
7806       unused results has been added. See #12039 for more information.
7807     * std: The `vec` module has been renamed to `slice`.
7808     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
7809       This will become the only growable vector in the future.
7810     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
7811       are now found at `std::io::BufferedReader` instead of
7812       `std::io::buffered::BufferedReader`.
7813     * std: `print` and `println` are no longer in the prelude, the `print!` and
7814       `println!` macros are intended to be used instead.
7815     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
7816       attempts to statically prevent cycles.
7817     * std: The standard distribution is adopting the policy of pushing failure
7818       to the user rather than failing in libraries. Many functions (such as
7819       `slice::last()`) now return `Option<T>` instead of `T` + failing.
7820     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
7821       deriving mode: `#[deriving(Show)]`.
7822     * std: `ToStr` is now implemented for all types implementing `Show`.
7823     * std: The formatting trait methods now take `&self` instead of `&T`
7824     * std: The `invert()` method on iterators has been renamed to `rev()`
7825     * std: `std::num` has seen a reduction in the genericity of its traits,
7826       consolidating functionality into a few core traits.
7827     * std: Backtraces are now printed on task failure if the environment
7828       variable `RUST_BACKTRACE` is present.
7829     * std: Naming conventions for iterators have been standardized. More details
7830       can be found on the wiki's style guide.
7831     * std: `eof()` has been removed from the `Reader` trait. Specific types may
7832       still implement the function.
7833     * std: Networking types are now cloneable to allow simultaneous reads/writes.
7834     * std: `assert_approx_eq!` has been removed
7835     * std: The `e` and `E` formatting specifiers for floats have been added to
7836       print them in exponential notation.
7837     * std: The `Times` trait has been removed
7838     * std: Indications of variance and opting out of builtin bounds is done
7839       through marker types in `std::kinds::marker` now
7840     * std: `hash` has been rewritten, `IterBytes` has been removed, and
7841       `#[deriving(Hash)]` is now possible.
7842     * std: `SharedChan` has been removed, `Sender` is now cloneable.
7843     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
7844     * std: `Chan::new` is now `channel()`.
7845     * std: A new synchronous channel type has been implemented.
7846     * std: A `select!` macro is now provided for selecting over `Receiver`s.
7847     * std: `hashmap` and `trie` have been moved to `libcollections`
7848     * std: `run` has been rolled into `io::process`
7849     * std: `assert_eq!` now uses `{}` instead of `{:?}`
7850     * std: The equality and comparison traits have seen some reorganization.
7851     * std: `rand` has moved to `librand`.
7852     * std: `to_{lower,upper}case` has been implemented for `char`.
7853     * std: Logging has been moved to `liblog`.
7854     * collections: `HashMap` has been rewritten for higher performance and less
7855       memory usage.
7856     * native: The default runtime is now `libnative`. If `libgreen` is desired,
7857       it can be booted manually. The runtime guide has more information and
7858       examples.
7859     * native: All I/O functionality except signals has been implemented.
7860     * green: Task spawning with `libgreen` has been optimized with stack caching
7861       and various trimming of code.
7862     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
7863     * sync: The `extra::sync` module has been updated to modern rust (and moved
7864       to the `sync` library), tweaking and improving various interfaces while
7865       dropping redundant functionality.
7866     * sync: A new `Barrier` type has been added to the `sync` library.
7867     * sync: An efficient mutex for native and green tasks has been implemented.
7868     * serialize: The `base64` module has seen some improvement. It treats
7869       newlines better, has non-string error values, and has seen general
7870       cleanup.
7871     * fourcc: A `fourcc!` macro was introduced
7872     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
7873       hexadecimal literal.
7874
7875   * Tooling
7876     * `rustpkg` has been deprecated and removed from the main repository. Its
7877       replacement, `cargo`, is under development.
7878     * Nightly builds of rust are now available
7879     * The memory usage of rustc has been improved many times throughout this
7880       release cycle.
7881     * The build process supports disabling rpath support for the rustc binary
7882       itself.
7883     * Code generation has improved in some cases, giving more information to the
7884       LLVM optimization passes to enable more extensive optimizations.
7885     * Debuginfo compatibility with lldb on OSX has been restored.
7886     * The master branch is now gated on an android bot, making building for
7887       android much more reliable.
7888     * Output flags have been centralized into one `--emit` flag.
7889     * Crate type flags have been centralized into one `--crate-type` flag.
7890     * Codegen flags have been consolidated behind a `-C` flag.
7891     * Linking against outdated crates now has improved error messages.
7892     * Error messages with lifetimes will often suggest how to annotate the
7893       function to fix the error.
7894     * Many more types are documented in the standard library, and new guides
7895       were written.
7896     * Many `rustdoc` improvements:
7897       * code blocks are syntax highlighted.
7898       * render standalone markdown files.
7899       * the --test flag tests all code blocks by default.
7900       * exported macros are displayed.
7901       * re-exported types have their documentation inlined at the location of the
7902         first re-export.
7903       * search works across crates that have been rendered to the same output
7904         directory.
7905
7906
7907 Version 0.9 (2014-01-09)
7908 ==========================
7909
7910    * ~1800 changes, numerous bugfixes
7911
7912    * Language
7913       * The `float` type has been removed. Use `f32` or `f64` instead.
7914       * A new facility for enabling experimental features (feature gating) has
7915         been added, using the crate-level `#[feature(foo)]` attribute.
7916       * Managed boxes (@) are now behind a feature gate
7917         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
7918         standard library's `Gc` or `Rc` types instead.
7919       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
7920       * Jumping back to the top of a loop is now done with `continue` instead of
7921         `loop`.
7922       * Strings can no longer be mutated through index assignment.
7923       * Raw strings can be created via the basic `r"foo"` syntax or with matched
7924         hash delimiters, as in `r###"foo"###`.
7925       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
7926         called once.
7927       * The `&fn` type is now written `|args| -> ret` to match the literal form.
7928       * `@fn`s have been removed.
7929       * `do` only works with procs in order to make it obvious what the cost
7930         of `do` is.
7931       * Single-element tuple-like structs can no longer be dereferenced to
7932         obtain the inner value. A more comprehensive solution for overloading
7933         the dereference operator will be provided in the future.
7934       * The `#[link(...)]` attribute has been replaced with
7935         `#[crate_id = "name#vers"]`.
7936       * Empty `impl`s must be terminated with empty braces and may not be
7937         terminated with a semicolon.
7938       * Keywords are no longer allowed as lifetime names; the `self` lifetime
7939         no longer has any special meaning.
7940       * The old `fmt!` string formatting macro has been removed.
7941       * `printf!` and `printfln!` (old-style formatting) removed in favor of
7942         `print!` and `println!`.
7943       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
7944       * The `extern mod foo (name = "bar")` syntax has been removed. Use
7945         `extern mod foo = "bar"` instead.
7946       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
7947       * Macros can have attributes.
7948       * Macros can expand to items with attributes.
7949       * Macros can expand to multiple items.
7950       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
7951       * Comments may be nested.
7952       * Values automatically coerce to trait objects they implement, without
7953         an explicit `as`.
7954       * Enum discriminants are no longer an entire word but as small as needed to
7955         contain all the variants. The `repr` attribute can be used to override
7956         the discriminant size, as in `#[repr(int)]` for integer-sized, and
7957         `#[repr(C)]` to match C enums.
7958       * Non-string literals are not allowed in attributes (they never worked).
7959       * The FFI now supports variadic functions.
7960       * Octal numeric literals, as in `0o7777`.
7961       * The `concat!` syntax extension performs compile-time string concatenation.
7962       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
7963         removed as Rust no longer uses segmented stacks.
7964       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
7965       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
7966         not `*`; ignoring remaining fields of a struct is also done with `..`,
7967         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
7968       * `rustc` supports the "win64" calling convention via `extern "win64"`.
7969       * `rustc` supports the "system" calling convention, which defaults to the
7970         preferred convention for the target platform, "stdcall" on 32-bit Windows,
7971         "C" elsewhere.
7972       * The `type_overflow` lint (default: warn) checks literals for overflow.
7973       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
7974       * The `attribute_usage` lint (default: warn) warns about unknown
7975         attributes.
7976       * The `unknown_features` lint (default: warn) warns about unknown
7977         feature gates.
7978       * The `dead_code` lint (default: warn) checks for dead code.
7979       * Rust libraries can be linked statically to one another
7980       * `#[link_args]` is behind the `link_args` feature gate.
7981       * Native libraries are now linked with `#[link(name = "foo")]`
7982       * Native libraries can be statically linked to a rust crate
7983         (`#[link(name = "foo", kind = "static")]`).
7984       * Native OS X frameworks are now officially supported
7985         (`#[link(name = "foo", kind = "framework")]`).
7986       * The `#[thread_local]` attribute creates thread-local (not task-local)
7987         variables. Currently behind the `thread_local` feature gate.
7988       * The `return` keyword may be used in closures.
7989       * Types that can be copied via a memcpy implement the `Pod` kind.
7990       * The `cfg` attribute can now be used on struct fields and enum variants.
7991
7992    * Libraries
7993       * std: The `option` and `result` API's have been overhauled to make them
7994         simpler, more consistent, and more composable.
7995       * std: The entire `std::io` module has been replaced with one that is
7996         more comprehensive and that properly interfaces with the underlying
7997         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
7998         implemented.
7999       * std: `io::util` contains a number of useful implementations of
8000         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
8001         `ZeroReader`, `TeeReader`.
8002       * std: The reference counted pointer type `extra::rc` moved into std.
8003       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
8004         just a wrapper around it).
8005       * std: The `Either` type has been removed.
8006       * std: `fmt::Default` can be implemented for any type to provide default
8007         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
8008       * std: The `rand` API continues to be tweaked.
8009       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
8010         on failure in gdb, is now named `rust_fail`.
8011       * std: The `each_key` and `each_value` methods on `HashMap` have been
8012         replaced by the `keys` and `values` iterators.
8013       * std: Functions dealing with type size and alignment have moved from the
8014         `sys` module to the `mem` module.
8015       * std: The `path` module was written and API changed.
8016       * std: `str::from_utf8` has been changed to cast instead of allocate.
8017       * std: `starts_with` and `ends_with` methods added to vectors via the
8018         `ImmutableEqVector` trait, which is in the prelude.
8019       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
8020         if the index is out of bounds.
8021       * std: Task failure no longer propagates between tasks, as the model was
8022         complex, expensive, and incompatible with thread-based tasks.
8023       * std: The `Any` type can be used for dynamic typing.
8024       * std: `~Any` can be passed to the `fail!` macro and retrieved via
8025         `task::try`.
8026       * std: Methods that produce iterators generally do not have an `_iter`
8027         suffix now.
8028       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
8029         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
8030       * std: `util::ignore` renamed to `prelude::drop`.
8031       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
8032         trait.
8033       * std: `vec::raw` has seen a lot of cleanup and API changes.
8034       * std: The standard library no longer includes any C++ code, and very
8035         minimal C, eliminating the dependency on libstdc++.
8036       * std: Runtime scheduling and I/O functionality has been factored out into
8037         extensible interfaces and is now implemented by two different crates:
8038         libnative, for native threading and I/O; and libgreen, for green threading
8039         and I/O. This paves the way for using the standard library in more limited
8040         embedded environments.
8041       * std: The `comm` module has been rewritten to be much faster, have a
8042         simpler, more consistent API, and to work for both native and green
8043         threading.
8044       * std: All libuv dependencies have been moved into the rustuv crate.
8045       * native: New implementations of runtime scheduling on top of OS threads.
8046       * native: New native implementations of TCP, UDP, file I/O, process spawning,
8047         and other I/O.
8048       * green: The green thread scheduler and message passing types are almost
8049         entirely lock-free.
8050       * extra: The `flatpipes` module had bitrotted and was removed.
8051       * extra: All crypto functions have been removed and Rust now has a policy of
8052         not reimplementing crypto in the standard library. In the future crypto
8053         will be provided by external crates with bindings to established libraries.
8054       * extra: `c_vec` has been modernized.
8055       * extra: The `sort` module has been removed. Use the `sort` method on
8056         mutable slices.
8057
8058    * Tooling
8059       * The `rust` and `rusti` commands have been removed, due to lack of
8060         maintenance.
8061       * `rustdoc` was completely rewritten.
8062       * `rustdoc` can test code examples in documentation.
8063       * `rustpkg` can test packages with the argument, 'test'.
8064       * `rustpkg` supports arbitrary dependencies, including C libraries.
8065       * `rustc`'s support for generating debug info is improved again.
8066       * `rustc` has better error reporting for unbalanced delimiters.
8067       * `rustc`'s JIT support was removed due to bitrot.
8068       * Executables and static libraries can be built with LTO (-Z lto)
8069       * `rustc` adds a `--dep-info` flag for communicating dependencies to
8070         build tools.
8071
8072
8073 Version 0.8 (2013-09-26)
8074 ============================
8075
8076    * ~2200 changes, numerous bugfixes
8077
8078    * Language
8079       * The `for` loop syntax has changed to work with the `Iterator` trait.
8080       * At long last, unwinding works on Windows.
8081       * Default methods are ready for use.
8082       * Many trait inheritance bugs fixed.
8083       * Owned and borrowed trait objects work more reliably.
8084       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
8085       * rustc can omit emission of code for the `debug!` macro if it is passed
8086         `--cfg ndebug`
8087       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
8088         for foo.rs, then foo/mod.rs, and will generate an error when both are
8089         present.
8090       * Strings no longer contain trailing nulls. The new `std::c_str` module
8091         provides new mechanisms for converting to C strings.
8092       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
8093       * The FFI has been overhauled such that foreign functions are called directly,
8094         instead of through a stack-switching wrapper.
8095       * Calling a foreign function must be done through a Rust function with the
8096         `#[fixed_stack_segment]` attribute.
8097       * The `externfn!` macro can be used to declare both a foreign function and
8098         a `#[fixed_stack_segment]` wrapper at once.
8099       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
8100       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
8101       * `priv` is disallowed everywhere except for struct fields and enum variants.
8102       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
8103       * `ref` bindings in irrefutable patterns work correctly now.
8104       * `char` is now prevented from containing invalid code points.
8105       * Casting to `bool` is no longer allowed.
8106       * `\0` is now accepted as an escape in chars and strings.
8107       * `yield` is a reserved keyword.
8108       * `typeof` is a reserved keyword.
8109       * Crates may be imported by URL with `extern mod foo = "url";`.
8110       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
8111       * Static vectors can be initialized with repeating elements,
8112         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
8113       * Static structs can be initialized with functional record update,
8114         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
8115       * `cfg!` can be used to conditionally execute code based on the crate
8116         configuration, similarly to `#[cfg(...)]`.
8117       * The `unnecessary_qualification` lint detects unneeded module
8118         prefixes (default: allow).
8119       * Arithmetic operations have been implemented on the SIMD types in
8120         `std::unstable::simd`.
8121       * Exchange allocation headers were removed, reducing memory usage.
8122       * `format!` implements a completely new, extensible, and higher-performance
8123         string formatting system. It will replace `fmt!`.
8124       * `print!` and `println!` write formatted strings (using the `format!`
8125         extension) to stdout.
8126       * `write!` and `writeln!` write formatted strings (using the `format!`
8127         extension) to the new Writers in `std::rt::io`.
8128       * The library section in which a function or static is placed may
8129         be specified with `#[link_section = "..."]`.
8130       * The `proto!` syntax extension for defining bounded message protocols
8131         was removed.
8132       * `macro_rules!` is hygienic for `let` declarations.
8133       * The `#[export_name]` attribute specifies the name of a symbol.
8134       * `unreachable!` can be used to indicate unreachable code, and fails
8135         if executed.
8136
8137    * Libraries
8138       * std: Transitioned to the new runtime, written in Rust.
8139       * std: Added an experimental I/O library, `rt::io`, based on the new
8140         runtime.
8141       * std: A new generic `range` function was added to the prelude, replacing
8142         `uint::range` and friends.
8143       * std: `range_rev` no longer exists. Since range is an iterator it can be
8144         reversed with `range(lo, hi).invert()`.
8145       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
8146         renamed to `unwrap_or`.
8147       * std: The `iterator` module was renamed to `iter`.
8148       * std: Integral types now support the `checked_add`, `checked_sub`, and
8149         `checked_mul` operations for detecting overflow.
8150       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
8151         consistency.
8152       * std: Methods are standardizing on conventions for casting methods:
8153         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
8154         and cheap casts.
8155       * std: The `CString` type in `c_str` provides new ways to convert to and
8156         from C strings.
8157       * std: `DoubleEndedIterator` can yield elements in two directions.
8158       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
8159         two splices.
8160       * std: `str::from_bytes` renamed to `str::from_utf8`.
8161       * std: `pop_opt` and `shift_opt` methods added to vectors.
8162       * std: The task-local data interface no longer uses @, and keys are
8163         no longer function pointers.
8164       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
8165       * std: Added `SharedPort` to `comm`.
8166       * std: `Eq` has a default method for `ne`; only `eq` is required
8167         in implementations.
8168       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
8169         is required in implementations.
8170       * std: `is_utf8` performance is improved, impacting many string functions.
8171       * std: `os::MemoryMap` provides cross-platform mmap.
8172       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
8173         are not 'in-bounds' are considered undefined.
8174       * std: Many freestanding functions in `vec` removed in favor of methods.
8175       * std: Many freestanding functions on scalar types removed in favor of
8176         methods.
8177       * std: Many options to task builders were removed since they don't make
8178         sense in the new scheduler design.
8179       * std: More containers implement `FromIterator` so can be created by the
8180         `collect` method.
8181       * std: More complete atomic types in `unstable::atomics`.
8182       * std: `comm::PortSet` removed.
8183       * std: Mutating methods in the `Set` and `Map` traits have been moved into
8184         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
8185         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
8186         default implementations.
8187       * std: Various `from_str` functions were removed in favor of a generic
8188         `from_str` which is available in the prelude.
8189       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
8190       * extra: `dlist`, the doubly-linked list was modernized.
8191       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
8192       * extra: Added `glob` module, replacing `std::os::glob`.
8193       * extra: `rope` was removed.
8194       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
8195       * extra: `net`, and `timer` were removed. The experimental replacements
8196         are `std::rt::io::net` and `std::rt::io::timer`.
8197       * extra: Iterators implemented for `SmallIntMap`.
8198       * extra: Iterators implemented for `Bitv` and `BitvSet`.
8199       * extra: `SmallIntSet` removed. Use `BitvSet`.
8200       * extra: Performance of JSON parsing greatly improved.
8201       * extra: `semver` updated to SemVer 2.0.0.
8202       * extra: `term` handles more terminals correctly.
8203       * extra: `dbg` module removed.
8204       * extra: `par` module removed.
8205       * extra: `future` was cleaned up, with some method renames.
8206       * extra: Most free functions in `getopts` were converted to methods.
8207
8208    * Other
8209       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
8210       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
8211         similarly to gcc's `--march` flag.
8212       * rustc's performance compiling small crates is much better.
8213       * rustpkg has received many improvements.
8214       * rustpkg supports git tags as package IDs.
8215       * rustpkg builds into target-specific directories so it can be used for
8216         cross-compiling.
8217       * The number of concurrent test tasks is controlled by the environment
8218         variable RUST_TEST_TASKS.
8219       * The test harness can now report metrics for benchmarks.
8220       * All tools have man pages.
8221       * Programs compiled with `--test` now support the `-h` and `--help` flags.
8222       * The runtime uses jemalloc for allocations.
8223       * Segmented stacks are temporarily disabled as part of the transition to
8224         the new runtime. Stack overflows are possible!
8225       * A new documentation backend, rustdoc_ng, is available for use. It is
8226         still invoked through the normal `rustdoc` command.
8227
8228
8229 Version 0.7 (2013-07-03)
8230 =======================
8231
8232    * ~2000 changes, numerous bugfixes
8233
8234    * Language
8235       * `impl`s no longer accept a visibility qualifier. Put them on methods
8236         instead.
8237       * The borrow checker has been rewritten with flow-sensitivity, fixing
8238         many bugs and inconveniences.
8239       * The `self` parameter no longer implicitly means `&'self self`,
8240         and can be explicitly marked with a lifetime.
8241       * Overloadable compound operators (`+=`, etc.) have been temporarily
8242         removed due to bugs.
8243       * The `for` loop protocol now requires `for`-iterators to return `bool`
8244         so they compose better.
8245       * The `Durable` trait is replaced with the `'static` bounds.
8246       * Trait default methods work more often.
8247       * Structs with the `#[packed]` attribute have byte alignment and
8248         no padding between fields.
8249       * Type parameters bound by `Copy` must now be copied explicitly with
8250         the `copy` keyword.
8251       * It is now illegal to move out of a dereferenced unsafe pointer.
8252       * `Option<~T>` is now represented as a nullable pointer.
8253       * `@mut` does dynamic borrow checks correctly.
8254       * The `main` function is only detected at the topmost level of the crate.
8255         The `#[main]` attribute is still valid anywhere.
8256       * Struct fields may no longer be mutable. Use inherited mutability.
8257       * The `#[no_send]` attribute makes a type that would otherwise be
8258         `Send`, not.
8259       * The `#[no_freeze]` attribute makes a type that would otherwise be
8260         `Freeze`, not.
8261       * Unbounded recursion will abort the process after reaching the limit
8262         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
8263       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
8264         are never implicitly copyable.
8265       * `#[static_assert]` makes compile-time assertions about static bools.
8266       * At long last, 'argument modes' no longer exist.
8267       * The rarely used `use mod` statement no longer exists.
8268
8269    * Syntax extensions
8270       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
8271         argument list.
8272       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
8273         `Rand`, `Zero` and `ToStr` can all be automatically derived with
8274         `#[deriving(...)]`.
8275       * The `bytes!` macro returns a vector of bytes for string, u8, char,
8276         and unsuffixed integer literals.
8277
8278    * Libraries
8279       * The `core` crate was renamed to `std`.
8280       * The `std` crate was renamed to `extra`.
8281       * More and improved documentation.
8282       * std: `iterator` module for external iterator objects.
8283       * Many old-style (internal, higher-order function) iterators replaced by
8284         implementations of `Iterator`.
8285       * std: Many old internal vector and string iterators,
8286         incl. `any`, `all`. removed.
8287       * std: The `finalize` method of `Drop` renamed to `drop`.
8288       * std: The `drop` method now takes `&mut self` instead of `&self`.
8289       * std: The prelude no longer re-exports any modules, only types and traits.
8290       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
8291         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
8292       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
8293         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
8294       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
8295         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
8296       * std: Many types implement `Clone`.
8297       * std: `path` type renamed to `Path`.
8298       * std: `mut` module and `Mut` type removed.
8299       * std: Many standalone functions removed in favor of methods and iterators
8300         in `vec`, `str`. In the future methods will also work as functions.
8301       * std: `reinterpret_cast` removed. Use `transmute`.
8302       * std: ascii string handling in `std::ascii`.
8303       * std: `Rand` is implemented for ~/@.
8304       * std: `run` module for spawning processes overhauled.
8305       * std: Various atomic types added to `unstable::atomic`.
8306       * std: Various types implement `Zero`.
8307       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
8308       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
8309       * std: Added `os::mkdir_recursive`.
8310       * std: Added `os::glob` function performs filesystems globs.
8311       * std: `FuzzyEq` renamed to `ApproxEq`.
8312       * std: `Map` now defines `pop` and `swap` methods.
8313       * std: `Cell` constructors converted to static methods.
8314       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
8315       * extra: `flate` module moved from `std` to `extra`.
8316       * extra: `fileinput` module for iterating over a series of files.
8317       * extra: `Complex` number type and `complex` module.
8318       * extra: `Rational` number type and `rational` module.
8319       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
8320       * extra: `term` uses terminfo now, is more correct.
8321       * extra: `arc` functions converted to methods.
8322       * extra: Implementation of fixed output size variations of SHA-2.
8323
8324    * Tooling
8325       * `unused_variables` lint mode for unused variables (default: warn).
8326       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
8327         (default: warn).
8328       * `unused_mut` lint mode for identifying unused `mut` qualifiers
8329         (default: warn).
8330       * `dead_assignment` lint mode for unread variables (default: warn).
8331       * `unnecessary_allocation` lint mode detects some heap allocations that are
8332         immediately borrowed so could be written without allocating (default: warn).
8333       * `missing_doc` lint mode (default: allow).
8334       * `unreachable_code` lint mode (default: warn).
8335       * The `rusti` command has been rewritten and a number of bugs addressed.
8336       * rustc outputs in color on more terminals.
8337       * rustc accepts a `--link-args` flag to pass arguments to the linker.
8338       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
8339       * Compiling with `-g` will make the binary record information about
8340         dynamic borrowcheck failures for debugging.
8341       * rustdoc has a nicer stylesheet.
8342       * Various improvements to rustdoc.
8343       * Improvements to rustpkg (see the detailed release notes).
8344
8345
8346 Version 0.6 (2013-04-03)
8347 ========================
8348
8349    * ~2100 changes, numerous bugfixes
8350
8351    * Syntax changes
8352       * The self type parameter in traits is now spelled `Self`
8353       * The `self` parameter in trait and impl methods must now be explicitly
8354         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
8355       * Static methods no longer require the `static` keyword and instead
8356         are distinguished by the lack of a `self` parameter
8357       * Replaced the `Durable` trait with the `'static` lifetime
8358       * The old closure type syntax with the trailing sigil has been
8359         removed in favor of the more consistent leading sigil
8360       * `super` is a keyword, and may be prefixed to paths
8361       * Trait bounds are separated with `+` instead of whitespace
8362       * Traits are implemented with `impl Trait for Type`
8363         instead of `impl Type: Trait`
8364       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
8365       * The `export` keyword has finally been removed
8366       * The `move` keyword has been removed (see "Semantic changes")
8367       * The interior mutability qualifier on vectors, `[mut T]`, has been
8368         removed. Use `&mut [T]`, etc.
8369       * `mut` is no longer valid in `~mut T`. Use inherited mutability
8370       * `fail` is no longer a keyword. Use `fail!()`
8371       * `assert` is no longer a keyword. Use `assert!()`
8372       * `log` is no longer a keyword. use `debug!`, etc.
8373       * 1-tuples may be represented as `(T,)`
8374       * Struct fields may no longer be `mut`. Use inherited mutability,
8375         `@mut T`, `core::mut` or `core::cell`
8376       * `extern mod { ... }` is no longer valid syntax for foreign
8377         function modules. Use extern blocks: `extern { ... }`
8378       * Newtype enums removed. Use tuple-structs.
8379       * Trait implementations no longer support visibility modifiers
8380       * Pattern matching over vectors improved and expanded
8381       * `const` renamed to `static` to correspond to lifetime name,
8382         and make room for future `static mut` unsafe mutable globals.
8383       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
8384       * `Clone` implementations can be automatically generated with
8385         `#[deriving(Clone)]`
8386       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
8387         instead of `foo as Bar`.
8388       * Fixed length vector types are now written as `[int, .. 3]`
8389         instead of `[int * 3]`.
8390       * Fixed length vector types can express the length as a constant
8391         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
8392
8393    * Semantic changes
8394       * Types with owned pointers or custom destructors move by default,
8395         eliminating the `move` keyword
8396       * All foreign functions are considered unsafe
8397       * &mut is now unaliasable
8398       * Writes to borrowed @mut pointers are prevented dynamically
8399       * () has size 0
8400       * The name of the main function can be customized using #[main]
8401       * The default type of an inferred closure is &fn instead of @fn
8402       * `use` statements may no longer be "chained" - they cannot import
8403         identifiers imported by previous `use` statements
8404       * `use` statements are crate relative, importing from the "top"
8405         of the crate by default. Paths may be prefixed with `super::`
8406         or `self::` to change the search behavior.
8407       * Method visibility is inherited from the implementation declaration
8408       * Structural records have been removed
8409       * Many more types can be used in static items, including enums
8410         'static-lifetime pointers and vectors
8411       * Pattern matching over vectors improved and expanded
8412       * Typechecking of closure types has been overhauled to
8413         improve inference and eliminate unsoundness
8414       * Macros leave scope at the end of modules, unless that module is
8415         tagged with #[macro_escape]
8416
8417    * Libraries
8418       * Added big integers to `std::bigint`
8419       * Removed `core::oldcomm` module
8420       * Added pipe-based `core::comm` module
8421       * Numeric traits have been reorganized under `core::num`
8422       * `vec::slice` finally returns a slice
8423       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
8424       * Containers reorganized around traits in `core::container`
8425       * `core::dvec` removed, `~[T]` is a drop-in replacement
8426       * `core::send_map` renamed to `core::hashmap`
8427       * `std::map` removed; replaced with `core::hashmap`
8428       * `std::treemap` reimplemented as an owned balanced tree
8429       * `std::deque` and `std::smallintmap` reimplemented as owned containers
8430       * `core::trie` added as a fast ordered map for integer keys
8431       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
8432       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
8433         overload the comparison operators, whereas `TotalOrd` is used
8434         by certain container types
8435
8436    * Other
8437       * Replaced the 'cargo' package manager with 'rustpkg'
8438       * Added all-purpose 'rust' tool
8439       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
8440       * rustc now *attempts* to offer spelling suggestions
8441       * Improved support for ARM and Android
8442       * Preliminary MIPS backend
8443       * Improved foreign function ABI implementation for x86, x86_64
8444       * Various memory usage improvements
8445       * Rust code may be embedded in foreign code under limited circumstances
8446       * Inline assembler supported by new asm!() syntax extension.
8447
8448
8449 Version 0.5 (2012-12-21)
8450 ===========================
8451
8452    * ~900 changes, numerous bugfixes
8453
8454    * Syntax changes
8455       * Removed `<-` move operator
8456       * Completed the transition from the `#fmt` extension syntax to `fmt!`
8457       * Removed old fixed length vector syntax - `[T]/N`
8458       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
8459       * Macros may now expand to items and statements
8460       * `a.b()` is always parsed as a method call, never as a field projection
8461       * `Eq` and `IterBytes` implementations can be automatically generated
8462         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
8463       * Removed the special crate language for `.rc` files
8464       * Function arguments may consist of any irrefutable pattern
8465
8466    * Semantic changes
8467       * `&` and `~` pointers may point to objects
8468       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
8469       * Enum variants may be structs
8470       * Destructors can be added to all nominal types with the Drop trait
8471       * Structs and nullary enum variants may be constants
8472       * Values that cannot be implicitly copied are now automatically moved
8473         without writing `move` explicitly
8474       * `&T` may now be coerced to `*T`
8475       * Coercions happen in `let` statements as well as function calls
8476       * `use` statements now take crate-relative paths
8477       * The module and type namespaces have been merged so that static
8478         method names can be resolved under the trait in which they are
8479         declared
8480
8481    * Improved support for language features
8482       * Trait inheritance works in many scenarios
8483       * More support for explicit self arguments in methods - `self`, `&self`
8484         `@self`, and `~self` all generally work as expected
8485       * Static methods work in more situations
8486       * Experimental: Traits may declare default methods for the implementations
8487         to use
8488
8489    * Libraries
8490       * New condition handling system in `core::condition`
8491       * Timsort added to `std::sort`
8492       * New priority queue, `std::priority_queue`
8493       * Pipes for serializable types, `std::flatpipes'
8494       * Serialization overhauled to be trait-based
8495       * Expanded `getopts` definitions
8496       * Moved futures to `std`
8497       * More functions are pure now
8498       * `core::comm` renamed to `oldcomm`. Still deprecated
8499       * `rustdoc` and `cargo` are libraries now
8500
8501    * Misc
8502       * Added a preliminary REPL, `rusti`
8503       * License changed from MIT to dual MIT/APL2
8504
8505
8506 Version 0.4 (2012-10-15)
8507 ==========================
8508
8509    * ~2000 changes, numerous bugfixes
8510
8511    * Syntax
8512       * All keywords are now strict and may not be used as identifiers anywhere
8513       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
8514         'of', 'with', 'to', 'class'.
8515       * Classes are replaced with simpler structs
8516       * Explicit method self types
8517       * `ret` became `return` and `alt` became `match`
8518       * `import` is now `use`; `use is now `extern mod`
8519       * `extern mod { ... }` is now `extern { ... }`
8520       * `use mod` is the recommended way to import modules
8521       * `pub` and `priv` replace deprecated export lists
8522       * The syntax of `match` pattern arms now uses fat arrow (=>)
8523       * `main` no longer accepts an args vector; use `os::args` instead
8524
8525    * Semantics
8526       * Trait implementations are now coherent, ala Haskell typeclasses
8527       * Trait methods may be static
8528       * Argument modes are deprecated
8529       * Borrowed pointers are much more mature and recommended for use
8530       * Strings and vectors in the static region are stored in constant memory
8531       * Typestate was removed
8532       * Resolution rewritten to be more reliable
8533       * Support for 'dual-mode' data structures (freezing and thawing)
8534
8535    * Libraries
8536       * Most binary operators can now be overloaded via the traits in
8537         `core::ops'
8538       * `std::net::url` for representing URLs
8539       * Sendable hash maps in `core::send_map`
8540       * `core::task' gained a (currently unsafe) task-local storage API
8541
8542    * Concurrency
8543       * An efficient new intertask communication primitive called the pipe,
8544         along with a number of higher-level channel types, in `core::pipes`
8545       * `std::arc`, an atomically reference counted, immutable, shared memory
8546         type
8547       * `std::sync`, various exotic synchronization tools based on arcs and pipes
8548       * Futures are now based on pipes and sendable
8549       * More robust linked task failure
8550       * Improved task builder API
8551
8552    * Other
8553       * Improved error reporting
8554       * Preliminary JIT support
8555       * Preliminary work on precise GC
8556       * Extensive architectural improvements to rustc
8557       * Begun a transition away from buggy C++-based reflection (shape) code to
8558         Rust-based (visitor) code
8559       * All hash functions and tables converted to secure, randomized SipHash
8560
8561
8562 Version 0.3  (2012-07-12)
8563 ========================
8564
8565    * ~1900 changes, numerous bugfixes
8566
8567    * New coding conveniences
8568       * Integer-literal suffix inference
8569       * Per-item control over warnings, errors
8570       * #[cfg(windows)] and #[cfg(unix)] attributes
8571       * Documentation comments
8572       * More compact closure syntax
8573       * 'do' expressions for treating higher-order functions as
8574         control structures
8575       * *-patterns (wildcard extended to all constructor fields)
8576
8577    * Semantic cleanup
8578       * Name resolution pass and exhaustiveness checker rewritten
8579       * Region pointers and borrow checking supersede alias
8580         analysis
8581       * Init-ness checking is now provided by a region-based liveness
8582         pass instead of the typestate pass; same for last-use analysis
8583       * Extensive work on region pointers
8584
8585    * Experimental new language features
8586       * Slices and fixed-size, interior-allocated vectors
8587       * #!-comments for lang versioning, shell execution
8588       * Destructors and iface implementation for classes;
8589         type-parameterized classes and class methods
8590       * 'const' type kind for types that can be used to implement
8591         shared-memory concurrency patterns
8592
8593    * Type reflection
8594
8595    * Removal of various obsolete features
8596       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
8597                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
8598
8599       * Constructs: do-while loops ('do' repurposed), fn binding,
8600                     resources (replaced by destructors)
8601
8602    * Compiler reorganization
8603       * Syntax-layer of compiler split into separate crate
8604       * Clang (from LLVM project) integrated into build
8605       * Typechecker split into sub-modules
8606
8607    * New library code
8608       * New time functions
8609       * Extension methods for many built-in types
8610       * Arc: atomic-refcount read-only / exclusive-use shared cells
8611       * Par: parallel map and search routines
8612       * Extensive work on libuv interface
8613       * Much vector code moved to libraries
8614       * Syntax extensions: #line, #col, #file, #mod, #stringify,
8615         #include, #include_str, #include_bin
8616
8617    * Tool improvements
8618       * Cargo automatically resolves dependencies
8619
8620
8621 Version 0.2  (2012-03-29)
8622 =========================
8623
8624    * >1500 changes, numerous bugfixes
8625
8626    * New docs and doc tooling
8627
8628    * New port: FreeBSD x86_64
8629
8630    * Compilation model enhancements
8631       * Generics now specialized, multiply instantiated
8632       * Functions now inlined across separate crates
8633
8634    * Scheduling, stack and threading fixes
8635       * Noticeably improved message-passing performance
8636       * Explicit schedulers
8637       * Callbacks from C
8638       * Helgrind clean
8639
8640    * Experimental new language features
8641       * Operator overloading
8642       * Region pointers
8643       * Classes
8644
8645    * Various language extensions
8646       * C-callback function types: 'crust fn ...'
8647       * Infinite-loop construct: 'loop { ... }'
8648       * Shorten 'mutable' to 'mut'
8649       * Required mutable-local qualifier: 'let mut ...'
8650       * Basic glob-exporting: 'export foo::*;'
8651       * Alt now exhaustive, 'alt check' for runtime-checked
8652       * Block-function form of 'for' loop, with 'break' and 'ret'.
8653
8654    * New library code
8655       * AST quasi-quote syntax extension
8656       * Revived libuv interface
8657       * New modules: core::{future, iter}, std::arena
8658       * Merged per-platform std::{os*, fs*} to core::{libc, os}
8659       * Extensive cleanup, regularization in libstd, libcore
8660
8661
8662 Version 0.1  (2012-01-20)
8663 ===============================
8664
8665    * Most language features work, including:
8666       * Unique pointers, unique closures, move semantics
8667       * Interface-constrained generics
8668       * Static interface dispatch
8669       * Stack growth
8670       * Multithread task scheduling
8671       * Typestate predicates
8672       * Failure unwinding, destructors
8673       * Pattern matching and destructuring assignment
8674       * Lightweight block-lambda syntax
8675       * Preliminary macro-by-example
8676
8677    * Compiler works with the following configurations:
8678       * Linux: x86 and x86_64 hosts and targets
8679       * macOS: x86 and x86_64 hosts and targets
8680       * Windows: x86 hosts and targets
8681
8682    * Cross compilation / multi-target configuration supported.
8683
8684    * Preliminary API-documentation and package-management tools included.
8685
8686 Known issues:
8687
8688    * Documentation is incomplete.
8689
8690    * Performance is below intended target.
8691
8692    * Standard library APIs are subject to extensive change, reorganization.
8693
8694    * Language-level versioning is not yet operational - future code will
8695      break unexpectedly.