RELEASES.md

   1 Version 1.43.0 (2020-04-23)
   2 ==========================
   3
   4 Language
   5 --------
   6 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
   7   the correctly inferred type.][68129]
   8
   9 **Syntax only changes**
  10 - [Allow `type Foo: Ord` syntactically.][69361]
  11 - [Unify item parsing & filter illegal item kinds.][69366]
  12 - [Fuse associated and extern items up to defaultness.][69194]
  13 - [Permit attributes on `if` expressions.][69201]
  14 - [Syntactically allow `self` in all `fn` contexts.][68764]
  15 - [Merge `fn` syntax + cleanup item parsing.][68728]
  16
  17 These are still rejected *semantically*, so you will likely receive an error but
  18 these changes can be seen and parsed by procedural macros and
  19 conditional compilation.
  20
  21
  22 Compiler
  23 --------
  24 - [You can now pass multiple lint flags to rustc to override the previous
  25   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
  26   everything in the `unused` lint group unused except `unused-variables` which
  27   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
  28   everything in the `unused` lint group **including** `unused-variables` since
  29   the allow flag is specified before the deny flag (and therefore overridden).
  30 - [rustc will now prefer your system MinGW libraries over its bundled libraries
  31   if they are available on `windows-gnu`.][67429]
  32 - [rustc now buffers errors/warnings printed in JSON.][69227]
  33
  34 Libraries
  35 ---------
  36 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
  37   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
  38   respectively.][69538] These conversions succeed when `N` is `0..=32`.
  39 - [All `to_be_bytes`, `to_le_bytes`, `to_ne_bytes`, `from_be_bytes`,
  40   `from_le_bytes`, and `from_ne_bytes` methods for integers are
  41   now `const`.][69373]
  42 - [You can now use associated constants on floats and integers directly, rather
  43   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
  44   `f32::NAN` with no imports.
  45 - [`u8::is_ascii` is now `const`.][68984]
  46 - [`String` now implements `AsMut<str>`.][68742]
  47 - [Added the `primitive` module to `std` and `core`.][67637] This module
  48   reexports Rust's primitive types. This is mainly useful for use in macros
  49   where you want avoid these types being shadowed.
  50 - [The some of the trait bounds on `HashMap` and `HashSet`.][67642]
  51 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
  52
  53 Stabilized APIs
  54 ---------------
  55 - [`Once::is_completed`]
  56 - [`f32::LOG10_2`]
  57 - [`f32::LOG2_10`]
  58 - [`f64::LOG10_2`]
  59 - [`f64::LOG2_10`]
  60 - [`iter::once_with`]
  61
  62 Misc
  63 ----
  64 - [Certain checks in the `const_err` lint were deemed unrelated to const
  65   evaluation][69185], and have been moved to the `unconditional_panic` and
  66   `arithmetic_overflow` lints.
  67
  68 Internal Only
  69 -------------
  70 These changes provide no direct user facing benefits, but represent significant
  71 improvements to the internals and overall performance of `rustc` and
  72 related tools.
  73
  74 - [All components are now built with `opt-level=3` instead of `2`.][67878]
  75 - [Improved how rustc generates drop code.][67332]
  76 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
  77 - [traits: preallocate 2 Vecs of known initial size][69022]
  78 - [Avoid exponential behaviour when relating types][68772]
  79 - [Skip `Drop` terminators for enum variants without drop glue][68943]
  80 - [Improve performance of coherence checks][68966]
  81 - [Deduplicate types in the generator witness][68672]
  82 - [Invert control in struct_lint_level.][68725]
  83
  84 [67332]: https://github.com/rust-lang/rust/pull/67332/
  85 [67429]: https://github.com/rust-lang/rust/pull/67429/
  86 [67637]: https://github.com/rust-lang/rust/pull/67637/
  87 [67642]: https://github.com/rust-lang/rust/pull/67642/
  88 [67878]: https://github.com/rust-lang/rust/pull/67878/
  89 [67885]: https://github.com/rust-lang/rust/pull/67885/
  90 [68129]: https://github.com/rust-lang/rust/pull/68129/
  91 [68672]: https://github.com/rust-lang/rust/pull/68672/
  92 [68725]: https://github.com/rust-lang/rust/pull/68725/
  93 [68728]: https://github.com/rust-lang/rust/pull/68728/
  94 [68738]: https://github.com/rust-lang/rust/pull/68738/
  95 [68742]: https://github.com/rust-lang/rust/pull/68742/
  96 [68764]: https://github.com/rust-lang/rust/pull/68764/
  97 [68772]: https://github.com/rust-lang/rust/pull/68772/
  98 [68943]: https://github.com/rust-lang/rust/pull/68943/
  99 [68952]: https://github.com/rust-lang/rust/pull/68952/
 100 [68966]: https://github.com/rust-lang/rust/pull/68966/
 101 [68984]: https://github.com/rust-lang/rust/pull/68984/
 102 [69022]: https://github.com/rust-lang/rust/pull/69022/
 103 [69185]: https://github.com/rust-lang/rust/pull/69185/
 104 [69194]: https://github.com/rust-lang/rust/pull/69194/
 105 [69201]: https://github.com/rust-lang/rust/pull/69201/
 106 [69227]: https://github.com/rust-lang/rust/pull/69227/
 107 [69256]: https://github.com/rust-lang/rust/pull/69256/
 108 [69361]: https://github.com/rust-lang/rust/pull/69361/
 109 [69366]: https://github.com/rust-lang/rust/pull/69366/
 110 [69373]: https://github.com/rust-lang/rust/pull/69373/
 111 [69538]: https://github.com/rust-lang/rust/pull/69538/
 112 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
 113 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
 114 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
 115 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
 116 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
 117 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
 118
 119
 120 Version 1.42.0 (2020-03-12)
 121 ==========================
 122
 123 Language
 124 --------
 125 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
 126   ```rust
 127   fn foo(words: &[&str]) {
 128       match words {
 129           ["Hello", "World", "!", ..] => println!("Hello World!"),
 130           ["Foo", "Bar", ..] => println!("Baz"),
 131           rest => println!("{:?}", rest),
 132       }
 133   }
 134   ```
 135 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
 136   that you can create an enum that has the exact layout and ABI of the type
 137   it contains.
 138 - [There are some *syntax-only* changes:][67131]
 139    - `default` is syntactically allowed before items in `trait` definitions.
 140    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
 141      leave out their bodies in favor of `;`.
 142    - Bounds on associated types in `impl`s are now syntactically allowed
 143      (e.g. `type Foo: Ord;`).
 144    - `...` (the C-variadic type) may occur syntactically directly as the type of
 145       any function parameter.
 146
 147   These are still rejected *semantically*, so you will likely receive an error
 148   but these changes can be seen and parsed by procedural macros and
 149   conditional compilation.
 150
 151 Compiler
 152 --------
 153 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
 154 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
 155 - [`Option::{expect,unwrap}` and
 156    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
 157    pointing to the location where they were called, rather than
 158    `core`'s internals. ][67887]
 159
 160 \* Refer to Rust's [platform support page][forge-platform-support] for more
 161 information on Rust's tiered platform support.
 162
 163 Libraries
 164 ---------
 165 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
 166 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
 167    to implement `Sized`.][67935]
 168 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
 169 - [`Layout::new` is now `const`.][66254]
 170 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
 171
 172
 173 Stabilized APIs
 174 ---------------
 175 - [`CondVar::wait_while`]
 176 - [`CondVar::wait_timeout_while`]
 177 - [`DebugMap::key`]
 178 - [`DebugMap::value`]
 179 - [`ManuallyDrop::take`]
 180 - [`matches!`]
 181 - [`ptr::slice_from_raw_parts_mut`]
 182 - [`ptr::slice_from_raw_parts`]
 183
 184 Cargo
 185 -----
 186 - [You no longer need to include `extern crate proc_macro;` to be able to
 187   `use proc_macro;` in the `2018` edition.][cargo/7700]
 188
 189 Compatibility Notes
 190 -------------------
 191 - [`Error::description` has been deprecated, and its use will now produce a
 192   warning.][66919] It's recommended to use `Display`/`to_string` instead.
 193
 194 [68253]: https://github.com/rust-lang/rust/pull/68253/
 195 [68348]: https://github.com/rust-lang/rust/pull/68348/
 196 [67935]: https://github.com/rust-lang/rust/pull/67935/
 197 [68339]: https://github.com/rust-lang/rust/pull/68339/
 198 [68122]: https://github.com/rust-lang/rust/pull/68122/
 199 [67712]: https://github.com/rust-lang/rust/pull/67712/
 200 [67887]: https://github.com/rust-lang/rust/pull/67887/
 201 [67131]: https://github.com/rust-lang/rust/pull/67131/
 202 [67233]: https://github.com/rust-lang/rust/pull/67233/
 203 [66899]: https://github.com/rust-lang/rust/pull/66899/
 204 [66919]: https://github.com/rust-lang/rust/pull/66919/
 205 [66254]: https://github.com/rust-lang/rust/pull/66254/
 206 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
 207 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
 208 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
 209 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
 210 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
 211 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
 212 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
 213 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
 214 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
 215
 216
 217 Version 1.41.1 (2020-02-27)
 218 ===========================
 219
 220 * [Always check types of static items][69145]
 221 * [Always check lifetime bounds of `Copy` impls][69145]
 222 * [Fix miscompilation in callers of `Layout::repeat`][69225]
 223
 224 [69225]: https://github.com/rust-lang/rust/issues/69225
 225 [69145]: https://github.com/rust-lang/rust/pull/69145
 226
 227
 228 Version 1.41.0 (2020-01-30)
 229 ===========================
 230
 231 Language
 232 --------
 233
 234 - [You can now pass type parameters to foreign items when implementing
 235   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
 236 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
 237   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
 238   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
 239 - [You can now use any valid identifier in a `format_args` macro.][66847]
 240   Previously identifiers starting with an underscore were not allowed.
 241 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
 242   enum variants.][66183] These are still rejected semantically, but
 243   can be seen and parsed by procedural macros and conditional compilation.
 244
 245 Compiler
 246 --------
 247
 248 - [Rustc will now warn if you have unused loop `'label`s.][66325]
 249 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
 250 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
 251 - [You can now pass an arguments file passing the `@path` syntax
 252   to rustc.][66172] Note that the format differs somewhat from what is
 253   found in other tooling; please see [the documentation][argfile-docs] for
 254   more information.
 255 - [You can now provide `--extern` flag without a path, indicating that it is
 256   available from the search path or specified with an `-L` flag.][64882]
 257
 258 \* Refer to Rust's [platform support page][forge-platform-support] for more
 259 information on Rust's tiered platform support.
 260
 261 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
 262
 263 Libraries
 264 ---------
 265
 266 - [The `core::panic` module is now stable.][66771] It was already stable
 267   through `std`.
 268 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
 269   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
 270 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
 271
 272 Stabilized APIs
 273 ---------------
 274
 275 - [`Result::map_or`]
 276 - [`Result::map_or_else`]
 277 - [`std::rc::Weak::weak_count`]
 278 - [`std::rc::Weak::strong_count`]
 279 - [`std::sync::Weak::weak_count`]
 280 - [`std::sync::Weak::strong_count`]
 281
 282 Cargo
 283 -----
 284
 285 - [Cargo will now document all the private items for binary crates
 286   by default.][cargo/7593]
 287 - [`cargo-install` will now reinstall the package if it detects that it is out
 288   of date.][cargo/7560]
 289 - [Cargo.lock now uses a more git friendly format that should help to reduce
 290   merge conflicts.][cargo/7579]
 291 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
 292   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
 293   optimisation level to `2` for debug builds. You can also use
 294   `[profile.<profile>.build-override]` to override build scripts and
 295   their dependencies.
 296
 297 Misc
 298 ----
 299
 300 - [You can now specify `edition` in documentation code blocks to compile the block
 301   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
 302   should be compiled the 2018 edition of Rust.
 303 - [You can now provide custom themes to rustdoc with `--theme`, and check the
 304   current theme with `--check-theme`.][54733]
 305 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
 306
 307 Compatibility Notes
 308 -------------------
 309
 310 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
 311   Apple targets.][apple-32bit-drop] This means that the source code is still
 312   available to build, but the targets are no longer being tested and release
 313   binaries for those platforms will no longer be distributed by the Rust project.
 314   Please refer to the linked blog post for more information.
 315
 316 [54733]: https://github.com/rust-lang/rust/pull/54733/
 317 [61351]: https://github.com/rust-lang/rust/pull/61351/
 318 [67255]: https://github.com/rust-lang/rust/pull/67255/
 319 [66661]: https://github.com/rust-lang/rust/pull/66661/
 320 [66771]: https://github.com/rust-lang/rust/pull/66771/
 321 [66847]: https://github.com/rust-lang/rust/pull/66847/
 322 [66238]: https://github.com/rust-lang/rust/pull/66238/
 323 [66277]: https://github.com/rust-lang/rust/pull/66277/
 324 [66325]: https://github.com/rust-lang/rust/pull/66325/
 325 [66172]: https://github.com/rust-lang/rust/pull/66172/
 326 [66183]: https://github.com/rust-lang/rust/pull/66183/
 327 [65879]: https://github.com/rust-lang/rust/pull/65879/
 328 [65013]: https://github.com/rust-lang/rust/pull/65013/
 329 [64882]: https://github.com/rust-lang/rust/pull/64882/
 330 [64325]: https://github.com/rust-lang/rust/pull/64325/
 331 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
 332 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
 333 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
 334 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
 335 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
 336 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
 337 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
 338 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
 339 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
 340 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
 341 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
 342
 343 Version 1.40.0 (2019-12-19)
 344 ===========================
 345
 346 Language
 347 --------
 348 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
 349   `const` contexts.][65188] e.g.
 350
 351   ```rust
 352   pub struct Point(i32, i32);
 353
 354   const ORIGIN: Point = {
 355       let constructor = Point;
 356
 357       constructor(0, 0)
 358   };
 359   ```
 360
 361 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
 362   indicate that there may be variants or fields added in the future.][64639]
 363   For example this requires adding a wild-card branch (`_ => {}`) to any match
 364   statements on a non-exhaustive `enum`. [(RFC 2008)]
 365 - [You can now use function-like procedural macros in `extern` blocks and in
 366   type positions.][63931] e.g. `type Generated = macro!();`
 367 - [Function-like and attribute procedural macros can now emit
 368   `macro_rules!` items, so you can now have your macros generate macros.][64035]
 369 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
 370   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
 371   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
 372
 373 Compiler
 374 --------
 375 - [Added tier 3 support\* for the
 376   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
 377 - [Added tier 3 support for the
 378   `aarch64-unknown-none-softfloat` target.][64589]
 379 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
 380   `mips64el-unknown-linux-muslabi64` targets.][65843]
 381
 382 \* Refer to Rust's [platform support page][forge-platform-support] for more
 383   information on Rust's tiered platform support.
 384
 385 Libraries
 386 ---------
 387 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
 388
 389 Stabilized APIs
 390 ---------------
 391 - [`BTreeMap::get_key_value`]
 392 - [`HashMap::get_key_value`]
 393 - [`Option::as_deref_mut`]
 394 - [`Option::as_deref`]
 395 - [`Option::flatten`]
 396 - [`UdpSocket::peer_addr`]
 397 - [`f32::to_be_bytes`]
 398 - [`f32::to_le_bytes`]
 399 - [`f32::to_ne_bytes`]
 400 - [`f64::to_be_bytes`]
 401 - [`f64::to_le_bytes`]
 402 - [`f64::to_ne_bytes`]
 403 - [`f32::from_be_bytes`]
 404 - [`f32::from_le_bytes`]
 405 - [`f32::from_ne_bytes`]
 406 - [`f64::from_be_bytes`]
 407 - [`f64::from_le_bytes`]
 408 - [`f64::from_ne_bytes`]
 409 - [`mem::take`]
 410 - [`slice::repeat`]
 411 - [`todo!`]
 412
 413 Cargo
 414 -----
 415 - [Cargo will now always display warnings, rather than only on
 416   fresh builds.][cargo/7450]
 417 - [Feature flags (except `--all-features`) passed to a virtual workspace will
 418   now produce an error.][cargo/7507] Previously these flags were ignored.
 419 - [You can now publish `dev-dependencies` without including
 420   a `version`.][cargo/7333]
 421
 422 Misc
 423 ----
 424 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
 425   when running documentation tests with `rustdoc`.][63803]
 426
 427 Compatibility Notes
 428 -------------------
 429 - [As previously announced, any previous NLL warnings in the 2015 edition are
 430   now hard errors.][64221]
 431 - [The `include!` macro will now warn if it failed to include the
 432   entire file.][64284] The `include!` macro unintentionally only includes the
 433   first _expression_ in a file, and this can be unintuitive. This will become
 434   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
 435 - [Using `#[inline]` on function prototypes and consts now emits a warning under
 436   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
 437   or `extern` blocks now correctly emits a hard error.
 438
 439 [65294]: https://github.com/rust-lang/rust/pull/65294/
 440 [66103]: https://github.com/rust-lang/rust/pull/66103/
 441 [65843]: https://github.com/rust-lang/rust/pull/65843/
 442 [65188]: https://github.com/rust-lang/rust/pull/65188/
 443 [65092]: https://github.com/rust-lang/rust/pull/65092/
 444 [64589]: https://github.com/rust-lang/rust/pull/64589/
 445 [64639]: https://github.com/rust-lang/rust/pull/64639/
 446 [64221]: https://github.com/rust-lang/rust/pull/64221/
 447 [64284]: https://github.com/rust-lang/rust/pull/64284/
 448 [63931]: https://github.com/rust-lang/rust/pull/63931/
 449 [64035]: https://github.com/rust-lang/rust/pull/64035/
 450 [63674]: https://github.com/rust-lang/rust/pull/63674/
 451 [63803]: https://github.com/rust-lang/rust/pull/63803/
 452 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
 453 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
 454 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
 455 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
 456 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
 457 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
 458 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
 459 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
 460 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
 461 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
 462 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
 463 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
 464 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
 465 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
 466 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
 467 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
 468 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
 469 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
 470 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
 471 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
 472 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
 473 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
 474 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
 475 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
 476 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
 477 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
 478
 479
 480 Version 1.39.0 (2019-11-07)
 481 ===========================
 482
 483 Language
 484 --------
 485 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
 486   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
 487 - [You can now use certain attributes on function, closure, and function pointer
 488   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
 489   `deny`, `forbid` as well as inert helper attributes used by procedural macro
 490   attributes applied to items. e.g.
 491   ```rust
 492   fn len(
 493       #[cfg(windows)] slice: &[u16],
 494       #[cfg(not(windows))] slice: &[u8],
 495   ) -> usize {
 496       slice.len()
 497   }
 498   ```
 499 - [You can now take shared references to bind-by-move patterns in the `if` guards
 500   of `match` arms.][63118] e.g.
 501   ```rust
 502   fn main() {
 503       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
 504
 505       match array {
 506           nums
 507   //      ---- `nums` is bound by move.
 508               if nums.iter().sum::<u8>() == 10
 509   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
 510           => {
 511               drop(nums);
 512   //          ----------- Legal as `nums` was bound by move and so we have ownership.
 513           }
 514           _ => unreachable!(),
 515       }
 516   }
 517   ```
 518
 519
 520
 521 Compiler
 522 --------
 523 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
 524 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
 525 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
 526   **Note** Cargo currently doesn't use this feature. Refer to
 527   [cargo#7315][cargo/7315] to track this feature's progress.
 528 - [You can now pass `--show-output` argument to test binaries to print the
 529   output of successful tests.][62600]
 530
 531
 532 \* Refer to Rust's [platform support page][forge-platform-support] for more
 533 information on Rust's tiered platform support.
 534
 535 Libraries
 536 ---------
 537 - [`Vec::new` and `String::new` are now `const` functions.][64028]
 538 - [`LinkedList::new` is now a `const` function.][63684]
 539 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
 540 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
 541   now `const`.][63786]
 542
 543 Stabilized APIs
 544 ---------------
 545 - [`Pin::into_inner`]
 546 - [`Instant::checked_duration_since`]
 547 - [`Instant::saturating_duration_since`]
 548
 549 Cargo
 550 -----
 551 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
 552 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
 553   `--all` is now deprecated.
 554
 555 Misc
 556 ----
 557 - [You can now pass `-Clinker` to rustdoc to control the linker used
 558   for compiling doctests.][63834]
 559
 560 Compatibility Notes
 561 -------------------
 562 - [Code that was previously accepted by the old borrow checker, but rejected by
 563   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
 564   previously a warning, and will also become a hard error in the Rust 2015
 565   edition in the 1.40.0 release.
 566 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
 567   run tests.][63827] This should improve performance when running a large
 568   amount of doctests.
 569 - [The `try!` macro will now issue a deprecation warning.][62672] It is
 570   recommended to use the `?` operator instead.
 571 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
 572   returned `0.0`.
 573
 574 [62600]: https://github.com/rust-lang/rust/pull/62600/
 575 [62672]: https://github.com/rust-lang/rust/pull/62672/
 576 [63118]: https://github.com/rust-lang/rust/pull/63118/
 577 [63209]: https://github.com/rust-lang/rust/pull/63209/
 578 [63402]: https://github.com/rust-lang/rust/pull/63402/
 579 [63565]: https://github.com/rust-lang/rust/pull/63565/
 580 [63595]: https://github.com/rust-lang/rust/pull/63595/
 581 [63684]: https://github.com/rust-lang/rust/pull/63684/
 582 [63698]: https://github.com/rust-lang/rust/pull/63698/
 583 [63770]: https://github.com/rust-lang/rust/pull/63770/
 584 [63786]: https://github.com/rust-lang/rust/pull/63786/
 585 [63827]: https://github.com/rust-lang/rust/pull/63827/
 586 [63834]: https://github.com/rust-lang/rust/pull/63834/
 587 [63927]: https://github.com/rust-lang/rust/pull/63927/
 588 [63933]: https://github.com/rust-lang/rust/pull/63933/
 589 [63934]: https://github.com/rust-lang/rust/pull/63934/
 590 [63938]: https://github.com/rust-lang/rust/pull/63938/
 591 [63940]: https://github.com/rust-lang/rust/pull/63940/
 592 [63941]: https://github.com/rust-lang/rust/pull/63941/
 593 [63945]: https://github.com/rust-lang/rust/pull/63945/
 594 [64010]: https://github.com/rust-lang/rust/pull/64010/
 595 [64028]: https://github.com/rust-lang/rust/pull/64028/
 596 [64334]: https://github.com/rust-lang/rust/pull/64334/
 597 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
 598 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
 599 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
 600 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
 601 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
 602 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
 603
 604 Version 1.38.0 (2019-09-26)
 605 ==========================
 606
 607 Language
 608 --------
 609 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
 610 - [The `#[deprecated]` attribute can now be used on macros.][62042]
 611
 612 Compiler
 613 --------
 614 - [Added pipelined compilation support to `rustc`.][62766] This will
 615   improve compilation times in some cases. For further information please refer
 616   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
 617 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
 618   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
 619   `x86_64-uwp-windows-msvc` targets.][60260]
 620 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
 621   `armv7-unknown-linux-musleabi` targets.][63107]
 622 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
 623 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
 624
 625 \* Refer to Rust's [platform support page][forge-platform-support] for more
 626 information on Rust's tiered platform support.
 627
 628 Libraries
 629 ---------
 630 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
 631 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
 632   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
 633   is available at `std::clone::Clone`). This also makes all built-in macros
 634   available in `std`/`core` root. e.g. `std::include_bytes!`.
 635 - [`str::Chars` now implements `Debug`.][63000]
 636 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
 637 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
 638 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
 639 - [Added euclidean remainder and division operations (`div_euclid`,
 640   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
 641   `overflowing`, and `wrapping` versions are available for all
 642   integer primitives.
 643 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
 644   `PartialEq`.][61491]
 645 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
 646
 647 Stabilized APIs
 648 ---------------
 649 - [`<*const T>::cast`]
 650 - [`<*mut T>::cast`]
 651 - [`Duration::as_secs_f32`]
 652 - [`Duration::as_secs_f64`]
 653 - [`Duration::div_f32`]
 654 - [`Duration::div_f64`]
 655 - [`Duration::from_secs_f32`]
 656 - [`Duration::from_secs_f64`]
 657 - [`Duration::mul_f32`]
 658 - [`Duration::mul_f64`]
 659 - [`any::type_name`]
 660
 661 Cargo
 662 -----
 663 - [Added pipelined compilation support to `cargo`.][cargo/7143]
 664 - [You can now pass the `--features` option multiple times to enable
 665   multiple features.][cargo/7084]
 666
 667 Misc
 668 ----
 669 - [`rustc` will now warn about some incorrect uses of
 670   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
 671
 672 Compatibility Notes
 673 -------------------
 674 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
 675   1.38.0.
 676 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
 677   issues][62896] with certain crates such as libc.
 678
 679 [60260]: https://github.com/rust-lang/rust/pull/60260/
 680 [61457]: https://github.com/rust-lang/rust/pull/61457/
 681 [61491]: https://github.com/rust-lang/rust/pull/61491/
 682 [61884]: https://github.com/rust-lang/rust/pull/61884/
 683 [61953]: https://github.com/rust-lang/rust/pull/61953/
 684 [62042]: https://github.com/rust-lang/rust/pull/62042/
 685 [62528]: https://github.com/rust-lang/rust/pull/62528/
 686 [62583]: https://github.com/rust-lang/rust/pull/62583/
 687 [62735]: https://github.com/rust-lang/rust/pull/62735/
 688 [62766]: https://github.com/rust-lang/rust/pull/62766/
 689 [62784]: https://github.com/rust-lang/rust/pull/62784/
 690 [62785]: https://github.com/rust-lang/rust/issues/62785/
 691 [62814]: https://github.com/rust-lang/rust/pull/62814/
 692 [62896]: https://github.com/rust-lang/rust/issues/62896/
 693 [63000]: https://github.com/rust-lang/rust/pull/63000/
 694 [63056]: https://github.com/rust-lang/rust/pull/63056/
 695 [63107]: https://github.com/rust-lang/rust/pull/63107/
 696 [63346]: https://github.com/rust-lang/rust/pull/63346/
 697 [63421]: https://github.com/rust-lang/rust/pull/63421/
 698 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
 699 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
 700 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
 701 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
 702 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
 703 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
 704 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
 705 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
 706 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
 707 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
 708 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
 709 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
 710 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
 711 [forge-platform-support]: https://forge.rust-lang.org/platform-support.html
 712 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
 713
 714 Version 1.37.0 (2019-08-15)
 715 ==========================
 716
 717 Language
 718 --------
 719 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
 720   [`Box`][62228], or an [array][62235] and unused.
 721 - [You can now use the `cfg` and `cfg_attr` attributes on
 722   generic parameters.][61547]
 723 - [You can now use enum variants through type alias.][61682] e.g. You can
 724   write the following:
 725   ```rust
 726   type MyOption = Option<u8>;
 727
 728   fn increment_or_zero(x: MyOption) -> u8 {
 729       match x {
 730           MyOption::Some(y) => y + 1,
 731           MyOption::None => 0,
 732       }
 733   }
 734   ```
 735 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
 736   `const _: u32 = 5;`.
 737 - [You can now use `#[repr(align(X)]` on enums.][61229]
 738 - [The  `?` Kleene macro operator is now available in the
 739   2015 edition.][60932]
 740
 741 Compiler
 742 --------
 743 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
 744   and `-C profile-use` flags.][61268] For more information on how to use profile
 745   guided optimization, please refer to the [rustc book][rustc-book-pgo].
 746 - [The `rust-lldb` wrapper script should now work again.][61827]
 747
 748 Libraries
 749 ---------
 750 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
 751
 752 Stabilized APIs
 753 ---------------
 754 - [`BufReader::buffer`]
 755 - [`BufWriter::buffer`]
 756 - [`Cell::from_mut`]
 757 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
 758 - [`DoubleEndedIterator::nth_back`]
 759 - [`Option::xor`]
 760 - [`Wrapping::reverse_bits`]
 761 - [`i128::reverse_bits`]
 762 - [`i16::reverse_bits`]
 763 - [`i32::reverse_bits`]
 764 - [`i64::reverse_bits`]
 765 - [`i8::reverse_bits`]
 766 - [`isize::reverse_bits`]
 767 - [`slice::copy_within`]
 768 - [`u128::reverse_bits`]
 769 - [`u16::reverse_bits`]
 770 - [`u32::reverse_bits`]
 771 - [`u64::reverse_bits`]
 772 - [`u8::reverse_bits`]
 773 - [`usize::reverse_bits`]
 774
 775 Cargo
 776 -----
 777 - [`Cargo.lock` files are now included by default when publishing executable crates
 778   with executables.][cargo/7026]
 779 - [You can now specify `default-run="foo"` in `[package]` to specify the
 780   default executable to use for `cargo run`.][cargo/7056]
 781
 782 Misc
 783 ----
 784
 785 Compatibility Notes
 786 -------------------
 787 - [Using `...` for inclusive range patterns will now warn by default.][61342]
 788   Please transition your code to using the `..=` syntax for inclusive
 789   ranges instead.
 790 - [Using a trait object without the `dyn` will now warn by default.][61203]
 791   Please transition your code to use `dyn Trait` for trait objects instead.
 792
 793 [62228]: https://github.com/rust-lang/rust/pull/62228/
 794 [62235]: https://github.com/rust-lang/rust/pull/62235/
 795 [61802]: https://github.com/rust-lang/rust/pull/61802/
 796 [61827]: https://github.com/rust-lang/rust/pull/61827/
 797 [61547]: https://github.com/rust-lang/rust/pull/61547/
 798 [61682]: https://github.com/rust-lang/rust/pull/61682/
 799 [61268]: https://github.com/rust-lang/rust/pull/61268/
 800 [61342]: https://github.com/rust-lang/rust/pull/61342/
 801 [61347]: https://github.com/rust-lang/rust/pull/61347/
 802 [61100]: https://github.com/rust-lang/rust/pull/61100/
 803 [61203]: https://github.com/rust-lang/rust/pull/61203/
 804 [61229]: https://github.com/rust-lang/rust/pull/61229/
 805 [60932]: https://github.com/rust-lang/rust/pull/60932/
 806 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
 807 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
 808 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
 809 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
 810 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
 811 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
 812 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
 813 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
 814 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
 815 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
 816 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
 817 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
 818 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
 819 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
 820 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
 821 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
 822 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
 823 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
 824 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
 825 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
 826 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
 827 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
 828 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
 829 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
 830
 831
 832 Version 1.36.0 (2019-07-04)
 833 ==========================
 834
 835 Language
 836 --------
 837 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
 838 - [The order of traits in trait objects no longer affects the semantics of that
 839   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
 840   `dyn fmt::Debug + Send`, where this was previously not the case.
 841
 842 Libraries
 843 ---------
 844 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
 845 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
 846 - [`mem::needs_drop` is now available as a const fn.][60364]
 847 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
 848 - [`String` now implements `BorrowMut<str>`.][60404]
 849 - [`io::Cursor` now implements `Default`.][60234]
 850 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
 851 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
 852   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
 853   environment has access to heap memory allocation.
 854 - [`String` now implements `From<&String>`.][59825]
 855 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
 856   return a tuple of each argument when there is multiple arguments.
 857 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
 858   not used.][59648]
 859
 860 Stabilized APIs
 861 ---------------
 862 - [`VecDeque::rotate_left`]
 863 - [`VecDeque::rotate_right`]
 864 - [`Iterator::copied`]
 865 - [`io::IoSlice`]
 866 - [`io::IoSliceMut`]
 867 - [`Read::read_vectored`]
 868 - [`Write::write_vectored`]
 869 - [`str::as_mut_ptr`]
 870 - [`mem::MaybeUninit`]
 871 - [`pointer::align_offset`]
 872 - [`future::Future`]
 873 - [`task::Context`]
 874 - [`task::RawWaker`]
 875 - [`task::RawWakerVTable`]
 876 - [`task::Waker`]
 877 - [`task::Poll`]
 878
 879 Cargo
 880 -----
 881 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
 882 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
 883
 884 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
 885
 886 Clippy
 887 ------
 888 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
 889
 890 Misc
 891 ----
 892
 893 Compatibility Notes
 894 -------------------
 895 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
 896   longer recommended, and will be deprecated in 1.39.0.
 897
 898 [60318]: https://github.com/rust-lang/rust/pull/60318/
 899 [60364]: https://github.com/rust-lang/rust/pull/60364/
 900 [60370]: https://github.com/rust-lang/rust/pull/60370/
 901 [60404]: https://github.com/rust-lang/rust/pull/60404/
 902 [60234]: https://github.com/rust-lang/rust/pull/60234/
 903 [60244]: https://github.com/rust-lang/rust/pull/60244/
 904 [58623]: https://github.com/rust-lang/rust/pull/58623/
 905 [59648]: https://github.com/rust-lang/rust/pull/59648/
 906 [59675]: https://github.com/rust-lang/rust/pull/59675/
 907 [59825]: https://github.com/rust-lang/rust/pull/59825/
 908 [59826]: https://github.com/rust-lang/rust/pull/59826/
 909 [59445]: https://github.com/rust-lang/rust/pull/59445/
 910 [59114]: https://github.com/rust-lang/rust/pull/59114/
 911 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
 912 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
 913 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
 914 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
 915 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
 916 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
 917 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
 918 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
 919 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
 920 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
 921 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
 922 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
 923 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
 924 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
 925 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
 926 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
 927 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
 928 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
 929 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
 930 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
 931
 932
 933 Version 1.35.0 (2019-05-23)
 934 ==========================
 935
 936 Language
 937 --------
 938 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
 939   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
 940 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
 941   ```rust
 942   unsafe fn call_unsafe(func: unsafe fn()) {
 943       func()
 944   }
 945
 946   pub fn main() {
 947       unsafe { call_unsafe(|| {}); }
 948   }
 949   ```
 950
 951
 952 Compiler
 953 --------
 954 - [Added the `armv6-unknown-freebsd-gnueabihf` and
 955   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
 956 - [Added the `wasm32-unknown-wasi` target.][59464]
 957
 958
 959 Libraries
 960 ---------
 961 - [`Thread` will now show its ID in `Debug` output.][59460]
 962 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
 963 - [`alloc::System` now implements `Default`.][59451]
 964 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
 965   last field.][59076]
 966 - [`char::{ToLowercase, ToUppercase}` now
 967   implement `ExactSizeIterator`.][58778]
 968 - [All `NonZero` numeric types now implement `FromStr`.][58717]
 969 - [Removed the `Read` trait bounds
 970   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
 971 - [You can now call the `dbg!` macro without any parameters to print the file
 972   and line where it is called.][57847]
 973 - [In place ASCII case conversions are now up to 4× faster.][59283]
 974   e.g. `str::make_ascii_lowercase`
 975 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
 976   and `Send`.][58369]
 977
 978 Stabilized APIs
 979 ---------------
 980 - [`f32::copysign`]
 981 - [`f64::copysign`]
 982 - [`RefCell::replace_with`]
 983 - [`RefCell::map_split`]
 984 - [`ptr::hash`]
 985 - [`Range::contains`]
 986 - [`RangeFrom::contains`]
 987 - [`RangeTo::contains`]
 988 - [`RangeInclusive::contains`]
 989 - [`RangeToInclusive::contains`]
 990 - [`Option::copied`]
 991
 992 Cargo
 993 -----
 994 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
 995   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
 996   platform specific.
 997
 998 Misc
 999 ----
1000 - [The Rust toolchain is now available natively for musl based distros.][58575]
1001
1002 [59460]: https://github.com/rust-lang/rust/pull/59460/
1003 [59464]: https://github.com/rust-lang/rust/pull/59464/
1004 [59500]: https://github.com/rust-lang/rust/pull/59500/
1005 [59512]: https://github.com/rust-lang/rust/pull/59512/
1006 [59580]: https://github.com/rust-lang/rust/pull/59580/
1007 [59283]: https://github.com/rust-lang/rust/pull/59283/
1008 [59451]: https://github.com/rust-lang/rust/pull/59451/
1009 [59076]: https://github.com/rust-lang/rust/pull/59076/
1010 [58778]: https://github.com/rust-lang/rust/pull/58778/
1011 [58717]: https://github.com/rust-lang/rust/pull/58717/
1012 [58369]: https://github.com/rust-lang/rust/pull/58369/
1013 [58423]: https://github.com/rust-lang/rust/pull/58423/
1014 [58080]: https://github.com/rust-lang/rust/pull/58080/
1015 [57847]: https://github.com/rust-lang/rust/pull/57847/
1016 [58575]: https://github.com/rust-lang/rust/pull/58575
1017 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
1018 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
1019 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
1020 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
1021 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
1022 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
1023 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
1024 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
1025 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
1026 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
1027 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
1028 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
1029
1030 Version 1.34.2 (2019-05-14)
1031 ===========================
1032
1033 * [Destabilize the `Error::type_id` function due to a security
1034    vulnerability][60785] ([CVE-2019-12083])
1035
1036 [60785]: https://github.com/rust-lang/rust/pull/60785
1037 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
1038
1039 Version 1.34.1 (2019-04-25)
1040 ===========================
1041
1042 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
1043 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
1044 * [Fix Clippy panic when checking some macros][clippy/3805]
1045
1046 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
1047 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
1048 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
1049
1050 Version 1.34.0 (2019-04-11)
1051 ==========================
1052
1053 Language
1054 --------
1055 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
1056   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
1057   but had no effect.
1058 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
1059   `#[attr{}]` procedural macros.][57367]
1060 - [You can now write `extern crate self as foo;`][57407] to import your
1061   crate's root into the extern prelude.
1062
1063
1064 Compiler
1065 --------
1066 - [You can now target `riscv64imac-unknown-none-elf` and
1067   `riscv64gc-unknown-none-elf`.][58406]
1068 - [You can now enable linker plugin LTO optimisations with
1069   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
1070   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
1071   boundaries.
1072 - [You can now target `powerpc64-unknown-freebsd`.][57809]
1073
1074
1075 Libraries
1076 ---------
1077 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
1078   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
1079   the `Hash` trait to create an iterator.
1080 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
1081   methods.][58421] Most notably you no longer require the `Ord` trait to create
1082   an iterator.
1083 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
1084   for all numeric types.][58044]
1085 - [Indexing a `str` is now generic over all types that
1086   implement `SliceIndex<str>`.][57604]
1087 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
1088   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
1089   produce a warning if their returning type is unused.
1090 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
1091   `overflowing_pow` are now available for all numeric types.][57873] These are
1092   equivalent to methods such as `wrapping_add` for the `pow` operation.
1093
1094
1095 Stabilized APIs
1096 ---------------
1097
1098 #### std & core
1099 * [`Any::type_id`]
1100 * [`Error::type_id`]
1101 * [`atomic::AtomicI16`]
1102 * [`atomic::AtomicI32`]
1103 * [`atomic::AtomicI64`]
1104 * [`atomic::AtomicI8`]
1105 * [`atomic::AtomicU16`]
1106 * [`atomic::AtomicU32`]
1107 * [`atomic::AtomicU64`]
1108 * [`atomic::AtomicU8`]
1109 * [`convert::Infallible`]
1110 * [`convert::TryFrom`]
1111 * [`convert::TryInto`]
1112 * [`iter::from_fn`]
1113 * [`iter::successors`]
1114 * [`num::NonZeroI128`]
1115 * [`num::NonZeroI16`]
1116 * [`num::NonZeroI32`]
1117 * [`num::NonZeroI64`]
1118 * [`num::NonZeroI8`]
1119 * [`num::NonZeroIsize`]
1120 * [`slice::sort_by_cached_key`]
1121 * [`str::escape_debug`]
1122 * [`str::escape_default`]
1123 * [`str::escape_unicode`]
1124 * [`str::split_ascii_whitespace`]
1125
1126 #### std
1127 * [`Instant::checked_add`]
1128 * [`Instant::checked_sub`]
1129 * [`SystemTime::checked_add`]
1130 * [`SystemTime::checked_sub`]
1131
1132 Cargo
1133 -----
1134 - [You can now use alternative registries to crates.io.][cargo/6654]
1135
1136 Misc
1137 ----
1138 - [You can now use the `?` operator in your documentation tests without manually
1139   adding `fn main() -> Result<(), _> {}`.][56470]
1140
1141 Compatibility Notes
1142 -------------------
1143 - [`Command::before_exec` is being replaced by the unsafe method
1144   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
1145 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
1146   can now use `const` functions in `static` variables.
1147
1148 [58370]: https://github.com/rust-lang/rust/pull/58370/
1149 [58406]: https://github.com/rust-lang/rust/pull/58406/
1150 [58421]: https://github.com/rust-lang/rust/pull/58421/
1151 [58166]: https://github.com/rust-lang/rust/pull/58166/
1152 [58044]: https://github.com/rust-lang/rust/pull/58044/
1153 [58057]: https://github.com/rust-lang/rust/pull/58057/
1154 [58059]: https://github.com/rust-lang/rust/pull/58059/
1155 [57809]: https://github.com/rust-lang/rust/pull/57809/
1156 [57873]: https://github.com/rust-lang/rust/pull/57873/
1157 [57604]: https://github.com/rust-lang/rust/pull/57604/
1158 [57367]: https://github.com/rust-lang/rust/pull/57367/
1159 [57407]: https://github.com/rust-lang/rust/pull/57407/
1160 [57425]: https://github.com/rust-lang/rust/pull/57425/
1161 [57106]: https://github.com/rust-lang/rust/pull/57106/
1162 [56470]: https://github.com/rust-lang/rust/pull/56470/
1163 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
1164 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
1165 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
1166 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
1167 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
1168 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
1169 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
1170 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
1171 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
1172 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
1173 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
1174 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
1175 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
1176 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
1177 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
1178 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
1179 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
1180 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
1181 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
1182 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
1183 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
1184 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
1185 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
1186 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
1187 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
1188 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
1189 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
1190 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
1191 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
1192 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
1193 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
1194
1195
1196 Version 1.33.0 (2019-02-28)
1197 ==========================
1198
1199 Language
1200 --------
1201 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
1202   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
1203 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
1204   E.g. You can have match statement on a `u8` that covers `0..=255` and
1205   you would no longer be required to have a `_ => unreachable!()` case.
1206 - [You can now have multiple patterns in `if let` and `while let`
1207   expressions.][57532] You can do this with the same syntax as a `match`
1208   expression. E.g.
1209   ```rust
1210   enum Creature {
1211       Crab(String),
1212       Lobster(String),
1213       Person(String),
1214   }
1215
1216   fn main() {
1217       let state = Creature::Crab("Ferris");
1218
1219       if let Creature::Crab(name) | Creature::Person(name) = state {
1220           println!("This creature's name is: {}", name);
1221       }
1222   }
1223   ```
1224 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
1225   this feature will by default produce a warning as this behaviour can be
1226   unintuitive. E.g. `if let _ = 5 {}`
1227 - [You can now use `let` bindings, assignments, expression statements,
1228   and irrefutable pattern destructuring in const functions.][57175]
1229 - [You can now call unsafe const functions.][57067] E.g.
1230   ```rust
1231   const unsafe fn foo() -> i32 { 5 }
1232   const fn bar() -> i32 {
1233       unsafe { foo() }
1234   }
1235   ```
1236 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
1237   E.g. `#[cfg_attr(all(), must_use, optimize)]`
1238 - [You can now specify a specific alignment with the `#[repr(packed)]`
1239   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
1240   with an alignment of 2 bytes and a size of 6 bytes.
1241 - [You can now import an item from a module as an `_`.][56303] This allows you to
1242   import a trait's impls, and not have the name in the namespace. E.g.
1243   ```rust
1244   use std::io::Read as _;
1245
1246   // Allowed as there is only one `Read` in the module.
1247   pub trait Read {}
1248   ```
1249 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
1250
1251 Compiler
1252 --------
1253 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
1254   command line argument.][56351]
1255 - [The minimum required LLVM version has been bumped to 6.0.][56642]
1256 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
1257 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
1258   tier 2 support.][57130] Visit the [platform support][platform-support] page for
1259   information on Rust's platform support.
1260 - [Added support for the `thumbv7neon-linux-androideabi` and
1261   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
1262 - [Added support for the `x86_64-unknown-uefi` target.][56769]
1263
1264 Libraries
1265 ---------
1266 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
1267   functions for all numeric types.][57566]
1268 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
1269   are now `const` functions for all numeric types.][57105]
1270 - [The methods `is_positive` and `is_negative` are now `const` functions for
1271   all signed numeric types.][57105]
1272 - [The `get` method for all `NonZero` types is now `const`.][57167]
1273 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
1274   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
1275   numeric types.][57234]
1276 - [`Ipv4Addr::new` is now a `const` function][57234]
1277
1278 Stabilized APIs
1279 ---------------
1280 - [`unix::FileExt::read_exact_at`]
1281 - [`unix::FileExt::write_all_at`]
1282 - [`Option::transpose`]
1283 - [`Result::transpose`]
1284 - [`convert::identity`]
1285 - [`pin::Pin`]
1286 - [`marker::Unpin`]
1287 - [`marker::PhantomPinned`]
1288 - [`Vec::resize_with`]
1289 - [`VecDeque::resize_with`]
1290 - [`Duration::as_millis`]
1291 - [`Duration::as_micros`]
1292 - [`Duration::as_nanos`]
1293
1294
1295 Cargo
1296 -----
1297 - [You can now publish crates that require a feature flag to compile with
1298   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
1299 - [Cargo should now rebuild a crate if a file was modified during the initial
1300   build.][cargo/6484]
1301
1302 Compatibility Notes
1303 -------------------
1304 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
1305   are now deprecated in the standard library, and their usage will now produce a warning.
1306   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
1307   methods instead.
1308 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
1309   downcasting.
1310 - [Libtest no longer creates a new thread for each test when
1311   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
1312
1313 [55982]: https://github.com/rust-lang/rust/pull/55982/
1314 [56243]: https://github.com/rust-lang/rust/pull/56243
1315 [56303]: https://github.com/rust-lang/rust/pull/56303/
1316 [56351]: https://github.com/rust-lang/rust/pull/56351/
1317 [56362]: https://github.com/rust-lang/rust/pull/56362
1318 [56642]: https://github.com/rust-lang/rust/pull/56642/
1319 [56769]: https://github.com/rust-lang/rust/pull/56769/
1320 [56805]: https://github.com/rust-lang/rust/pull/56805
1321 [56947]: https://github.com/rust-lang/rust/pull/56947/
1322 [57049]: https://github.com/rust-lang/rust/pull/57049/
1323 [57067]: https://github.com/rust-lang/rust/pull/57067/
1324 [57105]: https://github.com/rust-lang/rust/pull/57105
1325 [57130]: https://github.com/rust-lang/rust/pull/57130/
1326 [57167]: https://github.com/rust-lang/rust/pull/57167/
1327 [57175]: https://github.com/rust-lang/rust/pull/57175/
1328 [57234]: https://github.com/rust-lang/rust/pull/57234/
1329 [57332]: https://github.com/rust-lang/rust/pull/57332/
1330 [57465]: https://github.com/rust-lang/rust/pull/57465/
1331 [57532]: https://github.com/rust-lang/rust/pull/57532/
1332 [57535]: https://github.com/rust-lang/rust/pull/57535/
1333 [57566]: https://github.com/rust-lang/rust/pull/57566/
1334 [57615]: https://github.com/rust-lang/rust/pull/57615/
1335 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
1336 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
1337 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
1338 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
1339 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
1340 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
1341 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
1342 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
1343 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
1344 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
1345 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
1346 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
1347 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
1348 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
1349 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
1350 [platform-support]: https://forge.rust-lang.org/platform-support.html
1351
1352 Version 1.32.0 (2019-01-17)
1353 ==========================
1354
1355 Language
1356 --------
1357 #### 2018 edition
1358 - [You can now use the `?` operator in macro definitions.][56245] The `?`
1359   operator allows you to specify zero or one repetitions similar to the `*` and
1360   `+` operators.
1361 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
1362   now always resolve to the item (`enum`, `struct`, etc.) available in the
1363   module if present, before resolving to a external crate or an item the prelude.][56759]
1364   E.g.
1365   ```rust
1366   enum Color { Red, Green, Blue }
1367
1368   use Color::*;
1369   ```
1370
1371 #### All editions
1372 - [You can now match against `PhantomData<T>` types.][55837]
1373 - [You can now match against literals in macros with the `literal`
1374   specifier.][56072] This will match against a literal of any type.
1375   E.g. `1`, `'A'`, `"Hello World"`
1376 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
1377   ```rust
1378   struct Point(i32, i32);
1379
1380   impl Point {
1381       pub fn new(x: i32, y: i32) -> Self {
1382           Self(x, y)
1383       }
1384
1385       pub fn is_origin(&self) -> bool {
1386           match self {
1387               Self(0, 0) => true,
1388               _ => false,
1389           }
1390       }
1391   }
1392   ```
1393 - [Self can also now be used in type definitions.][56366] E.g.
1394   ```rust
1395   enum List<T>
1396   where
1397       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
1398   {
1399       Nil,
1400       Cons(T, Box<Self>) // likewise here
1401   }
1402   ```
1403 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
1404   a `impl Trait` or `dyn Trait` is returned and unused in the program.
1405
1406 Compiler
1407 --------
1408 - [The default allocator has changed from jemalloc to the default allocator on
1409   your system.][55238] The compiler itself on Linux & macOS will still use
1410   jemalloc, but programs compiled with it will use the system allocator.
1411 - [Added the `aarch64-pc-windows-msvc` target.][55702]
1412
1413 Libraries
1414 ---------
1415 - [`PathBuf` now implements `FromStr`.][55148]
1416 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
1417 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
1418   easily debug expressions in your rust program. E.g.
1419   ```rust
1420   let a = 2;
1421   let b = dbg!(a * 2) + 1;
1422   //      ^-- prints: [src/main.rs:4] a * 2 = 4
1423   assert_eq!(b, 5);
1424   ```
1425
1426 The following APIs are now `const` functions and can be used in a
1427 `const` context.
1428
1429 - [`Cell::as_ptr`]
1430 - [`UnsafeCell::get`]
1431 - [`char::is_ascii`]
1432 - [`iter::empty`]
1433 - [`ManuallyDrop::new`]
1434 - [`ManuallyDrop::into_inner`]
1435 - [`RangeInclusive::start`]
1436 - [`RangeInclusive::end`]
1437 - [`NonNull::as_ptr`]
1438 - [`slice::as_ptr`]
1439 - [`str::as_ptr`]
1440 - [`Duration::as_secs`]
1441 - [`Duration::subsec_millis`]
1442 - [`Duration::subsec_micros`]
1443 - [`Duration::subsec_nanos`]
1444 - [`CStr::as_ptr`]
1445 - [`Ipv4Addr::is_unspecified`]
1446 - [`Ipv6Addr::new`]
1447 - [`Ipv6Addr::octets`]
1448
1449 Stabilized APIs
1450 ---------------
1451 - [`i8::to_be_bytes`]
1452 - [`i8::to_le_bytes`]
1453 - [`i8::to_ne_bytes`]
1454 - [`i8::from_be_bytes`]
1455 - [`i8::from_le_bytes`]
1456 - [`i8::from_ne_bytes`]
1457 - [`i16::to_be_bytes`]
1458 - [`i16::to_le_bytes`]
1459 - [`i16::to_ne_bytes`]
1460 - [`i16::from_be_bytes`]
1461 - [`i16::from_le_bytes`]
1462 - [`i16::from_ne_bytes`]
1463 - [`i32::to_be_bytes`]
1464 - [`i32::to_le_bytes`]
1465 - [`i32::to_ne_bytes`]
1466 - [`i32::from_be_bytes`]
1467 - [`i32::from_le_bytes`]
1468 - [`i32::from_ne_bytes`]
1469 - [`i64::to_be_bytes`]
1470 - [`i64::to_le_bytes`]
1471 - [`i64::to_ne_bytes`]
1472 - [`i64::from_be_bytes`]
1473 - [`i64::from_le_bytes`]
1474 - [`i64::from_ne_bytes`]
1475 - [`i128::to_be_bytes`]
1476 - [`i128::to_le_bytes`]
1477 - [`i128::to_ne_bytes`]
1478 - [`i128::from_be_bytes`]
1479 - [`i128::from_le_bytes`]
1480 - [`i128::from_ne_bytes`]
1481 - [`isize::to_be_bytes`]
1482 - [`isize::to_le_bytes`]
1483 - [`isize::to_ne_bytes`]
1484 - [`isize::from_be_bytes`]
1485 - [`isize::from_le_bytes`]
1486 - [`isize::from_ne_bytes`]
1487 - [`u8::to_be_bytes`]
1488 - [`u8::to_le_bytes`]
1489 - [`u8::to_ne_bytes`]
1490 - [`u8::from_be_bytes`]
1491 - [`u8::from_le_bytes`]
1492 - [`u8::from_ne_bytes`]
1493 - [`u16::to_be_bytes`]
1494 - [`u16::to_le_bytes`]
1495 - [`u16::to_ne_bytes`]
1496 - [`u16::from_be_bytes`]
1497 - [`u16::from_le_bytes`]
1498 - [`u16::from_ne_bytes`]
1499 - [`u32::to_be_bytes`]
1500 - [`u32::to_le_bytes`]
1501 - [`u32::to_ne_bytes`]
1502 - [`u32::from_be_bytes`]
1503 - [`u32::from_le_bytes`]
1504 - [`u32::from_ne_bytes`]
1505 - [`u64::to_be_bytes`]
1506 - [`u64::to_le_bytes`]
1507 - [`u64::to_ne_bytes`]
1508 - [`u64::from_be_bytes`]
1509 - [`u64::from_le_bytes`]
1510 - [`u64::from_ne_bytes`]
1511 - [`u128::to_be_bytes`]
1512 - [`u128::to_le_bytes`]
1513 - [`u128::to_ne_bytes`]
1514 - [`u128::from_be_bytes`]
1515 - [`u128::from_le_bytes`]
1516 - [`u128::from_ne_bytes`]
1517 - [`usize::to_be_bytes`]
1518 - [`usize::to_le_bytes`]
1519 - [`usize::to_ne_bytes`]
1520 - [`usize::from_be_bytes`]
1521 - [`usize::from_le_bytes`]
1522 - [`usize::from_ne_bytes`]
1523
1524 Cargo
1525 -----
1526 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
1527 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
1528
1529 Misc
1530 ----
1531 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
1532
1533 Compatibility Notes
1534 -------------------
1535 - [The argument types for AVX's
1536   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
1537   been changed from `*const` to `*mut` as the previous implementation
1538   was unsound.
1539
1540
1541 [55148]: https://github.com/rust-lang/rust/pull/55148/
1542 [55238]: https://github.com/rust-lang/rust/pull/55238/
1543 [55280]: https://github.com/rust-lang/rust/pull/55280/
1544 [55610]: https://github.com/rust-lang/rust/pull/55610/
1545 [55663]: https://github.com/rust-lang/rust/pull/55663/
1546 [55702]: https://github.com/rust-lang/rust/pull/55702/
1547 [55837]: https://github.com/rust-lang/rust/pull/55837/
1548 [55843]: https://github.com/rust-lang/rust/pull/55843/
1549 [56072]: https://github.com/rust-lang/rust/pull/56072/
1550 [56245]: https://github.com/rust-lang/rust/pull/56245/
1551 [56365]: https://github.com/rust-lang/rust/pull/56365/
1552 [56366]: https://github.com/rust-lang/rust/pull/56366/
1553 [56395]: https://github.com/rust-lang/rust/pull/56395/
1554 [56759]: https://github.com/rust-lang/rust/pull/56759/
1555 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
1556 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
1557 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
1558 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
1559 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
1560 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1561 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1562 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
1563 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
1564 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
1565 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
1566 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
1567 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
1568 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
1569 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
1570 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
1571 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
1572 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
1573 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
1574 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
1575 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
1576 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
1577 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
1578 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
1579 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
1580 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
1581 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
1582 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
1583 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
1584 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
1585 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
1586 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
1587 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
1588 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
1589 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
1590 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
1591 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
1592 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
1593 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
1594 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
1595 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
1596 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
1597 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
1598 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
1599 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
1600 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
1601 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
1602 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
1603 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
1604 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
1605 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
1606 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
1607 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
1608 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
1609 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
1610 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
1611 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
1612 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
1613 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
1614 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
1615 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
1616 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
1617 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
1618 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
1619 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
1620 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
1621 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
1622 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
1623 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
1624 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
1625 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
1626 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
1627 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
1628 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
1629 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
1630 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
1631 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
1632 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
1633 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
1634 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
1635 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
1636 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
1637 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
1638 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
1639 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
1640 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
1641 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
1642 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
1643 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
1644 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
1645 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
1646 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
1647 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
1648
1649
1650 Version 1.31.1 (2018-12-20)
1651 ===========================
1652
1653 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
1654 - [Fix broken go-to-definition in RLS][rls/1171]
1655 - [Fix infinite loop on hover in RLS][rls/1170]
1656
1657 [56562]: https://github.com/rust-lang/rust/pull/56562
1658 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
1659 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
1660
1661 Version 1.31.0 (2018-12-06)
1662 ==========================
1663
1664 Language
1665 --------
1666 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
1667 - [New lifetime elision rules now allow for eliding lifetimes in functions and
1668   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
1669   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
1670   in structs.
1671 - [You can now define and use `const` functions.][54835] These are currently
1672   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
1673   [language reference][const-reference] for what exactly is available.
1674 - [You can now use tool lints, which allow you to scope lints from external
1675   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
1676 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
1677   a crate, not just in exported functions.][54451]
1678 - [You can now use parentheses in pattern matches.][54497]
1679
1680 Compiler
1681 --------
1682 - [Updated musl to 1.1.20][54430]
1683
1684 Libraries
1685 ---------
1686 - [You can now convert `num::NonZero*` types to their raw equivalents using the
1687   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
1688 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
1689   into `Option<&mut T>` using the `From` trait.][53218]
1690 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
1691
1692
1693 Stabilized APIs
1694 ---------------
1695 - [`slice::align_to`]
1696 - [`slice::align_to_mut`]
1697 - [`slice::chunks_exact`]
1698 - [`slice::chunks_exact_mut`]
1699 - [`slice::rchunks`]
1700 - [`slice::rchunks_mut`]
1701 - [`slice::rchunks_exact`]
1702 - [`slice::rchunks_exact_mut`]
1703 - [`Option::replace`]
1704
1705 Cargo
1706 -----
1707 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
1708 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
1709   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
1710
1711 [52813]: https://github.com/rust-lang/rust/pull/52813/
1712 [53218]: https://github.com/rust-lang/rust/pull/53218/
1713 [53555]: https://github.com/rust-lang/rust/issues/53555/
1714 [54057]: https://github.com/rust-lang/rust/pull/54057/
1715 [54240]: https://github.com/rust-lang/rust/pull/54240/
1716 [54430]: https://github.com/rust-lang/rust/pull/54430/
1717 [54451]: https://github.com/rust-lang/rust/pull/54451/
1718 [54497]: https://github.com/rust-lang/rust/pull/54497/
1719 [54778]: https://github.com/rust-lang/rust/pull/54778/
1720 [54835]: https://github.com/rust-lang/rust/pull/54835/
1721 [54870]: https://github.com/rust-lang/rust/pull/54870/
1722 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
1723 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
1724 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
1725 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
1726 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
1727 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
1728 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1729 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
1730 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1731 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
1732 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
1733 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
1734 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
1735 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
1736
1737 Version 1.30.1 (2018-11-08)
1738 ===========================
1739
1740 - [Fixed overflow ICE in rustdoc][54199]
1741 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
1742
1743 [54199]: https://github.com/rust-lang/rust/pull/54199
1744 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
1745
1746 Version 1.30.0 (2018-10-25)
1747 ==========================
1748
1749 Language
1750 --------
1751 - [Procedural macros are now available.][52081] These kinds of macros allow for
1752   more powerful code generation. There is a [new chapter available][proc-macros]
1753   in the Rust Programming Language book that goes further in depth.
1754 - [You can now use keywords as identifiers using the raw identifiers
1755   syntax (`r#`),][53236] e.g. `let r#for = true;`
1756 - [Using anonymous parameters in traits is now deprecated with a warning and
1757   will be a hard error in the 2018 edition.][53272]
1758 - [You can now use `crate` in paths.][54404] This allows you to refer to the
1759   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
1760 - [Using a external crate no longer requires being prefixed with `::`.][54404]
1761   Previously, using a external crate in a module without a use statement
1762   required `let json = ::serde_json::from_str(foo);` but can now be written
1763   as `let json = serde_json::from_str(foo);`.
1764 - [You can now apply the `#[used]` attribute to static items to prevent the
1765   compiler from optimising them away, even if they appear to be unused,][51363]
1766   e.g. `#[used] static FOO: u32 = 1;`
1767 - [You can now import and reexport macros from other crates with the `use`
1768   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
1769   the root module of the crate. If your macro relies on calling other local
1770   macros, it is recommended to export with the
1771   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
1772   those macros.
1773 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
1774   using the `vis` specifier.][53370]
1775 - [Non-macro attributes now allow all forms of literals, not just
1776   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
1777   write `#[attr(true)]`.
1778 - [You can now specify a function to handle a panic in the Rust runtime with the
1779   `#[panic_handler]` attribute.][51366]
1780
1781 Compiler
1782 --------
1783 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
1784 - [Added the `aarch64-unknown-netbsd` target][53165]
1785
1786 Libraries
1787 ---------
1788 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
1789
1790 Stabilized APIs
1791 ---------------
1792 - [`Ipv4Addr::BROADCAST`]
1793 - [`Ipv4Addr::LOCALHOST`]
1794 - [`Ipv4Addr::UNSPECIFIED`]
1795 - [`Ipv6Addr::LOCALHOST`]
1796 - [`Ipv6Addr::UNSPECIFIED`]
1797 - [`Iterator::find_map`]
1798
1799   The following methods are replacement methods for `trim_left`, `trim_right`,
1800   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
1801   in 1.33.0:
1802 - [`str::trim_end_matches`]
1803 - [`str::trim_end`]
1804 - [`str::trim_start_matches`]
1805 - [`str::trim_start`]
1806
1807 Cargo
1808 ----
1809 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
1810 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
1811   equivalent to calling `rustdoc --error-format=json`.
1812 - [Cargo will now provide a progress bar for builds.][cargo/5995]
1813
1814 Misc
1815 ----
1816 - [`rustdoc` allows you to specify what edition to treat your code as with the
1817   `--edition` option.][54057]
1818 - [`rustdoc` now has the `--color` (specify whether to output color) and
1819   `--error-format` (specify error format, e.g. `json`) options.][53003]
1820 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
1821   debug symbols.][53774]
1822 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
1823   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
1824
1825 [50911]: https://github.com/rust-lang/rust/pull/50911/
1826 [51363]: https://github.com/rust-lang/rust/pull/51363/
1827 [51366]: https://github.com/rust-lang/rust/pull/51366/
1828 [52081]: https://github.com/rust-lang/rust/pull/52081/
1829 [53003]: https://github.com/rust-lang/rust/pull/53003/
1830 [53033]: https://github.com/rust-lang/rust/pull/53033/
1831 [53044]: https://github.com/rust-lang/rust/pull/53044/
1832 [53165]: https://github.com/rust-lang/rust/pull/53165/
1833 [53213]: https://github.com/rust-lang/rust/pull/53213/
1834 [53236]: https://github.com/rust-lang/rust/pull/53236/
1835 [53272]: https://github.com/rust-lang/rust/pull/53272/
1836 [53370]: https://github.com/rust-lang/rust/pull/53370/
1837 [53459]: https://github.com/rust-lang/rust/pull/53459/
1838 [53774]: https://github.com/rust-lang/rust/pull/53774/
1839 [53822]: https://github.com/rust-lang/rust/pull/53822/
1840 [54057]: https://github.com/rust-lang/rust/pull/54057/
1841 [54146]: https://github.com/rust-lang/rust/pull/54146/
1842 [54404]: https://github.com/rust-lang/rust/pull/54404/
1843 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
1844 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
1845 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
1846 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
1847
1848 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
1849 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
1850 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
1851 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
1852 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
1853 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
1854 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
1855 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
1856 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
1857 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
1858
1859
1860 Version 1.29.2 (2018-10-11)
1861 ===========================
1862
1863 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
1864 - The `rls-preview` component on the windows-gnu targets has been restored.
1865
1866 [54639]: https://github.com/rust-lang/rust/pull/54639
1867
1868
1869 Version 1.29.1 (2018-09-25)
1870 ===========================
1871
1872 Security Notes
1873 --------------
1874
1875 - The standard library's `str::repeat` function contained an out of bounds write
1876   caused by an integer overflow. This has been fixed by deterministically
1877   panicking when an overflow happens.
1878
1879   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
1880   us.
1881
1882
1883 Version 1.29.0 (2018-09-13)
1884 ==========================
1885
1886 Compiler
1887 --------
1888 - [Bumped minimum LLVM version to 5.0.][51899]
1889 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
1890 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
1891
1892 Libraries
1893 ---------
1894 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
1895 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
1896 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
1897 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
1898   for `&str`.][51178]
1899 - [`Cell<T>` now allows `T` to be unsized.][50494]
1900 - [`SocketAddr` is now stable on Redox.][52656]
1901
1902 Stabilized APIs
1903 ---------------
1904 - [`Arc::downcast`]
1905 - [`Iterator::flatten`]
1906 - [`Rc::downcast`]
1907
1908 Cargo
1909 -----
1910 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
1911   `--locked` to disable this behavior.
1912 - [`cargo-install` will now allow you to cross compile an install
1913   using `--target`.][cargo/5614]
1914 - [Added the `cargo-fix` subcommand to automatically move project code from
1915   2015 edition to 2018.][cargo/5723]
1916 - [`cargo doc` can now optionally document private types using the
1917   `--document-private-items` flag.][cargo/5543]
1918
1919 Misc
1920 ----
1921 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
1922   the specified level to that level.][52354] For example `--cap-lints warn`
1923   will demote `deny` and `forbid` lints to `warn`.
1924 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
1925   fails and `101` if there is a panic.][52197]
1926 - [A preview of clippy has been made available through rustup.][51122]
1927   You can install the preview with `rustup component add clippy-preview`.
1928
1929 Compatibility Notes
1930 -------------------
1931 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
1932   Use `str::get_unchecked(begin..end)` instead.
1933 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
1934   Consider using the `home_dir` function from
1935   https://crates.io/crates/dirs instead.
1936 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
1937 - [`cfg` attributes and `--cfg` command line flags are now more
1938   strictly validated.][53893]
1939
1940 [53893]: https://github.com/rust-lang/rust/pull/53893/
1941 [52861]: https://github.com/rust-lang/rust/pull/52861/
1942 [52656]: https://github.com/rust-lang/rust/pull/52656/
1943 [52239]: https://github.com/rust-lang/rust/pull/52239/
1944 [52330]: https://github.com/rust-lang/rust/pull/52330/
1945 [52354]: https://github.com/rust-lang/rust/pull/52354/
1946 [52402]: https://github.com/rust-lang/rust/pull/52402/
1947 [52103]: https://github.com/rust-lang/rust/pull/52103/
1948 [52197]: https://github.com/rust-lang/rust/pull/52197/
1949 [51807]: https://github.com/rust-lang/rust/pull/51807/
1950 [51899]: https://github.com/rust-lang/rust/pull/51899/
1951 [51912]: https://github.com/rust-lang/rust/pull/51912/
1952 [51511]: https://github.com/rust-lang/rust/pull/51511/
1953 [51619]: https://github.com/rust-lang/rust/pull/51619/
1954 [51656]: https://github.com/rust-lang/rust/pull/51656/
1955 [51178]: https://github.com/rust-lang/rust/pull/51178/
1956 [51122]: https://github.com/rust-lang/rust/pull/51122
1957 [50494]: https://github.com/rust-lang/rust/pull/50494/
1958 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
1959 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
1960 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
1961 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
1962 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
1963 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
1964 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
1965
1966
1967 Version 1.28.0 (2018-08-02)
1968 ===========================
1969
1970 Language
1971 --------
1972 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
1973   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
1974   the inner type across Foreign Function Interface (FFI) boundaries.
1975 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
1976   and can now be used as identifiers.][51196]
1977 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
1978   stable.][51241] This will allow users to specify a global allocator for
1979   their program.
1980 - [Unit test functions marked with the `#[test]` attribute can now return
1981   `Result<(), E: Debug>` in addition to `()`.][51298]
1982 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
1983   allows macros to easily target lifetimes.
1984
1985 Compiler
1986 --------
1987 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
1988   prioritise making smaller binary sizes. `z` is the same as `s` with the
1989   exception that it does not vectorise loops, which typically results in an even
1990   smaller binary.
1991 - [The short error format is now stable.][49546] Specified with
1992   `--error-format=short` this option will provide a more compressed output of
1993   rust error messages.
1994 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
1995 - [Reduced the number of allocations in the macro parser.][50855] This can
1996   improve compile times of macro heavy crates on average by 5%.
1997
1998 Libraries
1999 ---------
2000 - [Implemented `Default` for `&mut str`.][51306]
2001 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
2002 - [Implemented `Extend` for `()`.][50234]
2003 - [The `Debug` implementation of `time::Duration` should now be more easily
2004   human readable.][50364] Previously a `Duration` of one second would printed as
2005   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
2006 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
2007   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
2008   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
2009   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
2010   for `PathBuf`.][50170]
2011 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
2012   and `Wrapping<i128>`.][50465]
2013 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
2014   possible.][51050] This can provide up to a 40% speed increase.
2015 - [Improved error messages when using `format!`.][50610]
2016
2017 Stabilized APIs
2018 ---------------
2019 - [`Iterator::step_by`]
2020 - [`Path::ancestors`]
2021 - [`SystemTime::UNIX_EPOCH`]
2022 - [`alloc::GlobalAlloc`]
2023 - [`alloc::Layout`]
2024 - [`alloc::LayoutErr`]
2025 - [`alloc::System`]
2026 - [`alloc::alloc`]
2027 - [`alloc::alloc_zeroed`]
2028 - [`alloc::dealloc`]
2029 - [`alloc::realloc`]
2030 - [`alloc::handle_alloc_error`]
2031 - [`btree_map::Entry::or_default`]
2032 - [`fmt::Alignment`]
2033 - [`hash_map::Entry::or_default`]
2034 - [`iter::repeat_with`]
2035 - [`num::NonZeroUsize`]
2036 - [`num::NonZeroU128`]
2037 - [`num::NonZeroU16`]
2038 - [`num::NonZeroU32`]
2039 - [`num::NonZeroU64`]
2040 - [`num::NonZeroU8`]
2041 - [`ops::RangeBounds`]
2042 - [`slice::SliceIndex`]
2043 - [`slice::from_mut`]
2044 - [`slice::from_ref`]
2045 - [`{Any + Send + Sync}::downcast_mut`]
2046 - [`{Any + Send + Sync}::downcast_ref`]
2047 - [`{Any + Send + Sync}::is`]
2048
2049 Cargo
2050 -----
2051 - [Cargo will now no longer allow you to publish crates with build scripts that
2052   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
2053   considered to be immutable.
2054
2055 Misc
2056 ----
2057 - [The `suggestion_applicability` field in `rustc`'s json output is now
2058   stable.][50486] This will allow dev tools to check whether a code suggestion
2059   would apply to them.
2060
2061 Compatibility Notes
2062 -------------------
2063 - [Rust will consider trait objects with duplicated constraints to be the same
2064   type as without the duplicated constraint.][51276] For example the below code will
2065   now fail to compile.
2066   ```rust
2067   trait Trait {}
2068
2069   impl Trait + Send {
2070       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
2071   }
2072
2073   impl Trait + Send + Send {
2074       fn test(&self) { println!("two"); }
2075   }
2076   ```
2077
2078 [49546]: https://github.com/rust-lang/rust/pull/49546/
2079 [50143]: https://github.com/rust-lang/rust/pull/50143/
2080 [50170]: https://github.com/rust-lang/rust/pull/50170/
2081 [50234]: https://github.com/rust-lang/rust/pull/50234/
2082 [50265]: https://github.com/rust-lang/rust/pull/50265/
2083 [50364]: https://github.com/rust-lang/rust/pull/50364/
2084 [50385]: https://github.com/rust-lang/rust/pull/50385/
2085 [50465]: https://github.com/rust-lang/rust/pull/50465/
2086 [50486]: https://github.com/rust-lang/rust/pull/50486/
2087 [50554]: https://github.com/rust-lang/rust/pull/50554/
2088 [50610]: https://github.com/rust-lang/rust/pull/50610/
2089 [50855]: https://github.com/rust-lang/rust/pull/50855/
2090 [51050]: https://github.com/rust-lang/rust/pull/51050/
2091 [51196]: https://github.com/rust-lang/rust/pull/51196/
2092 [51200]: https://github.com/rust-lang/rust/pull/51200/
2093 [51241]: https://github.com/rust-lang/rust/pull/51241/
2094 [51276]: https://github.com/rust-lang/rust/pull/51276/
2095 [51298]: https://github.com/rust-lang/rust/pull/51298/
2096 [51306]: https://github.com/rust-lang/rust/pull/51306/
2097 [51562]: https://github.com/rust-lang/rust/pull/51562/
2098 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
2099 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
2100 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
2101 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
2102 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
2103 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
2104 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
2105 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
2106 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
2107 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
2108 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
2109 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
2110 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
2111 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
2112 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
2113 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
2114 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
2115 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
2116 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
2117 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
2118 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
2119 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
2120 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
2121 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
2122 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
2123 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
2124 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
2125 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
2126 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
2127 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
2128
2129 Version 1.27.2 (2018-07-20)
2130 ===========================
2131
2132 Compatibility Notes
2133 -------------------
2134
2135 - The borrow checker was fixed to avoid potential unsoundness when using
2136   match ergonomics: [#52213][52213].
2137
2138 [52213]: https://github.com/rust-lang/rust/issues/52213
2139
2140 Version 1.27.1 (2018-07-10)
2141 ===========================
2142
2143 Security Notes
2144 --------------
2145
2146 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
2147   when running, which enabled executing code as some other user on a
2148   given machine. This release fixes that vulnerability; you can read
2149   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
2150
2151   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
2152
2153 Compatibility Notes
2154 -------------------
2155
2156 - The borrow checker was fixed to avoid an additional potential unsoundness when using
2157   match ergonomics: [#51415][51415], [#49534][49534].
2158
2159 [51415]: https://github.com/rust-lang/rust/issues/51415
2160 [49534]: https://github.com/rust-lang/rust/issues/49534
2161 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
2162 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
2163
2164 Version 1.27.0 (2018-06-21)
2165 ==========================
2166
2167 Language
2168 --------
2169 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
2170   be used as an identifier.
2171 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
2172   bare `Trait` syntax, and should make it clearer when being used in tandem with
2173   `impl Trait` because it is equivalent to the following syntax:
2174   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
2175   `Box<Trait> == Box<dyn Trait>`.
2176 - [Attributes on generic parameters such as types and lifetimes are
2177   now stable.][48851] e.g.
2178   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
2179 - [The `#[must_use]` attribute can now also be used on functions as well as
2180   types.][48925] It provides a lint that by default warns users when the
2181   value returned by a function has not been used.
2182
2183 Compiler
2184 --------
2185 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
2186
2187 Libraries
2188 ---------
2189 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
2190   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
2191   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
2192   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
2193   the `cfg` attribute.
2194 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
2195   std are now available in core.][49896]
2196 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
2197   to `Self`.][49630]
2198 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
2199   that the operation isn't done in place.
2200 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
2201   the `#[must_use]` attribute][49533] to warn about unused potentially
2202   expensive allocations.
2203
2204 Stabilized APIs
2205 ---------------
2206 - [`DoubleEndedIterator::rfind`]
2207 - [`DoubleEndedIterator::rfold`]
2208 - [`DoubleEndedIterator::try_rfold`]
2209 - [`Duration::from_micros`]
2210 - [`Duration::from_nanos`]
2211 - [`Duration::subsec_micros`]
2212 - [`Duration::subsec_millis`]
2213 - [`HashMap::remove_entry`]
2214 - [`Iterator::try_fold`]
2215 - [`Iterator::try_for_each`]
2216 - [`NonNull::cast`]
2217 - [`Option::filter`]
2218 - [`String::replace_range`]
2219 - [`Take::set_limit`]
2220 - [`hint::unreachable_unchecked`]
2221 - [`os::unix::process::parent_id`]
2222 - [`ptr::swap_nonoverlapping`]
2223 - [`slice::rsplit_mut`]
2224 - [`slice::rsplit`]
2225 - [`slice::swap_with_slice`]
2226
2227 Cargo
2228 -----
2229 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
2230   `readme`, and `repository` fields.][cargo/5386]
2231 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
2232 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
2233   a different directory than `target` for placing compilation artifacts.
2234 - [Cargo will be adding automatic target inference for binaries, benchmarks,
2235   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
2236   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
2237   where cargo would infer a binary, Cargo will produce a warning. You can
2238   disable this feature ahead of time by setting any of the following to false:
2239   `autobins`, `autobenches`, `autoexamples`, `autotests`.
2240 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
2241   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
2242
2243 Misc
2244 ----
2245 - [Added “The Rustc book” into the official documentation.][49707]
2246   [“The Rustc book”] documents and teaches how to use the rustc compiler.
2247 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
2248
2249 Compatibility Notes
2250 -------------------
2251 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
2252   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
2253   compile, `"".is_empty()` will still compile.
2254 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
2255   will only print the inner type.][48553] E.g.
2256   `print!("{:?}", AtomicBool::new(true))` will print `true`,
2257   not `AtomicBool(true)`.
2258 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
2259   could enter higher numbers but they were not supported by LLVM. Up to 512MB
2260   alignment should cover all use cases.
2261 - The `.description()` method on the `std::error::Error` trait
2262   [has been soft-deprecated][50163]. It is no longer required to implement it.
2263
2264 [48553]: https://github.com/rust-lang/rust/pull/48553/
2265 [48851]: https://github.com/rust-lang/rust/pull/48851/
2266 [48925]: https://github.com/rust-lang/rust/pull/48925/
2267 [49533]: https://github.com/rust-lang/rust/pull/49533/
2268 [49623]: https://github.com/rust-lang/rust/pull/49623/
2269 [49630]: https://github.com/rust-lang/rust/pull/49630/
2270 [49664]: https://github.com/rust-lang/rust/pull/49664/
2271 [49699]: https://github.com/rust-lang/rust/pull/49699/
2272 [49707]: https://github.com/rust-lang/rust/pull/49707/
2273 [49719]: https://github.com/rust-lang/rust/pull/49719/
2274 [49896]: https://github.com/rust-lang/rust/pull/49896/
2275 [49968]: https://github.com/rust-lang/rust/pull/49968/
2276 [50163]: https://github.com/rust-lang/rust/pull/50163
2277 [50177]: https://github.com/rust-lang/rust/pull/50177/
2278 [50378]: https://github.com/rust-lang/rust/pull/50378/
2279 [50398]: https://github.com/rust-lang/rust/pull/50398/
2280 [50423]: https://github.com/rust-lang/rust/pull/50423/
2281 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
2282 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
2283 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
2284 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
2285 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
2286 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
2287 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
2288 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
2289 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
2290 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
2291 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
2292 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2293 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2294 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
2295 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
2296 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
2297 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
2298 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
2299 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
2300 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
2301 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
2302 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
2303 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2304 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
2305 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
2306 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
2307 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
2308 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
2309 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
2310 [“The Rustc book”]: https://doc.rust-lang.org/rustc
2311
2312
2313 Version 1.26.2 (2018-06-05)
2314 ==========================
2315
2316 Compatibility Notes
2317 -------------------
2318
2319 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
2320
2321 [51117]: https://github.com/rust-lang/rust/issues/51117
2322
2323
2324 Version 1.26.1 (2018-05-29)
2325 ==========================
2326
2327 Tools
2328 -----
2329
2330 - [RLS now works on Windows.][50646]
2331 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
2332
2333
2334 Compatibility Notes
2335 --------
2336
2337 - [`fn main() -> impl Trait` no longer works for non-Termination
2338   trait.][50656]
2339   This reverts an accidental stabilization.
2340 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
2341 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
2342
2343 [50646]: https://github.com/rust-lang/rust/issues/50646
2344 [50656]: https://github.com/rust-lang/rust/pull/50656
2345 [50812]: https://github.com/rust-lang/rust/pull/50812
2346 [50950]: https://github.com/rust-lang/rust/issues/50950
2347 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
2348
2349 Version 1.26.0 (2018-05-10)
2350 ==========================
2351
2352 Language
2353 --------
2354 - [Closures now implement `Copy` and/or `Clone` if all captured variables
2355   implement either or both traits.][49299]
2356 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
2357 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
2358   lifetime can be elided.][49458]
2359 - [`impl Trait` is now stable allowing you to have abstract types in returns
2360    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
2361   `fn open(path: impl AsRef<Path>)`.
2362 - [Pattern matching will now automatically apply dereferences.][49394]
2363 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
2364 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
2365 - [A lot of operations are now available in a const context.][46882] E.g. You
2366   can now index into constant arrays, reference and dereference into constants,
2367   and use tuple struct constructors.
2368 - [Fixed entry slice patterns are now stable.][48516] E.g.
2369   ```rust
2370   let points = [1, 2, 3, 4];
2371   match points {
2372       [1, 2, 3, 4] => println!("All points were sequential."),
2373       _ => println!("Not all points were sequential."),
2374   }
2375   ```
2376
2377
2378 Compiler
2379 --------
2380 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
2381 - [Fixed exponential projection complexity on nested types.][48296]
2382   This can provide up to a ~12% reduction in compile times for certain crates.
2383 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
2384   to remap path prefixes outputted by the compiler.
2385 - [Added `powerpc-unknown-netbsd` target.][48281]
2386
2387 Libraries
2388 ---------
2389 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
2390 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
2391   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
2392 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
2393 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
2394 - [`ascii::escape_default` is now available in libcore.][48735]
2395 - [Trailing commas are now supported in std and core macros.][48056]
2396 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
2397 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
2398
2399 Stabilized APIs
2400 ---------------
2401 - [`*const T::add`]
2402 - [`*const T::copy_to_nonoverlapping`]
2403 - [`*const T::copy_to`]
2404 - [`*const T::read_unaligned`]
2405 - [`*const T::read_volatile`]
2406 - [`*const T::read`]
2407 - [`*const T::sub`]
2408 - [`*const T::wrapping_add`]
2409 - [`*const T::wrapping_sub`]
2410 - [`*mut T::add`]
2411 - [`*mut T::copy_to_nonoverlapping`]
2412 - [`*mut T::copy_to`]
2413 - [`*mut T::read_unaligned`]
2414 - [`*mut T::read_volatile`]
2415 - [`*mut T::read`]
2416 - [`*mut T::replace`]
2417 - [`*mut T::sub`]
2418 - [`*mut T::swap`]
2419 - [`*mut T::wrapping_add`]
2420 - [`*mut T::wrapping_sub`]
2421 - [`*mut T::write_bytes`]
2422 - [`*mut T::write_unaligned`]
2423 - [`*mut T::write_volatile`]
2424 - [`*mut T::write`]
2425 - [`Box::leak`]
2426 - [`FromUtf8Error::as_bytes`]
2427 - [`LocalKey::try_with`]
2428 - [`Option::cloned`]
2429 - [`btree_map::Entry::and_modify`]
2430 - [`fs::read_to_string`]
2431 - [`fs::read`]
2432 - [`fs::write`]
2433 - [`hash_map::Entry::and_modify`]
2434 - [`iter::FusedIterator`]
2435 - [`ops::RangeInclusive`]
2436 - [`ops::RangeToInclusive`]
2437 - [`process::id`]
2438 - [`slice::rotate_left`]
2439 - [`slice::rotate_right`]
2440 - [`String::retain`]
2441
2442
2443 Cargo
2444 -----
2445 - [Cargo will now output path to custom commands when `-v` is
2446   passed with `--list`][cargo/5041]
2447 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
2448
2449 Misc
2450 ----
2451 - [The second edition of "The Rust Programming Language" book is now recommended
2452   over the first.][48404]
2453
2454 Compatibility Notes
2455 -------------------
2456
2457 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
2458   syntax is now invalid.
2459   ```
2460   use std::ops::Fn as dyn;
2461   fn g(_: Box<dyn(std::fmt::Debug)>) {}
2462   ```
2463 - [The result of dereferences are no longer promoted to `'static`.][47408]
2464   e.g.
2465   ```rust
2466   fn main() {
2467       const PAIR: &(i32, i32) = &(0, 1);
2468       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
2469   }
2470   ```
2471 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
2472 - [`".e0"` will now no longer parse as `0.0` and will instead cause
2473   an error.][48235]
2474 - [Removed hoedown from rustdoc.][48274]
2475 - [Bounds on higher-kinded lifetimes a hard error.][48326]
2476
2477 [46882]: https://github.com/rust-lang/rust/pull/46882
2478 [47379]: https://github.com/rust-lang/rust/pull/47379
2479 [47408]: https://github.com/rust-lang/rust/pull/47408
2480 [47813]: https://github.com/rust-lang/rust/pull/47813
2481 [48056]: https://github.com/rust-lang/rust/pull/48056
2482 [48125]: https://github.com/rust-lang/rust/pull/48125
2483 [48166]: https://github.com/rust-lang/rust/pull/48166
2484 [48235]: https://github.com/rust-lang/rust/pull/48235
2485 [48274]: https://github.com/rust-lang/rust/pull/48274
2486 [48281]: https://github.com/rust-lang/rust/pull/48281
2487 [48296]: https://github.com/rust-lang/rust/pull/48296
2488 [48326]: https://github.com/rust-lang/rust/pull/48326
2489 [48359]: https://github.com/rust-lang/rust/pull/48359
2490 [48404]: https://github.com/rust-lang/rust/pull/48404
2491 [48481]: https://github.com/rust-lang/rust/pull/48481
2492 [48516]: https://github.com/rust-lang/rust/pull/48516
2493 [48628]: https://github.com/rust-lang/rust/pull/48628
2494 [48629]: https://github.com/rust-lang/rust/pull/48629
2495 [48657]: https://github.com/rust-lang/rust/pull/48657
2496 [48735]: https://github.com/rust-lang/rust/pull/48735
2497 [48978]: https://github.com/rust-lang/rust/pull/48978
2498 [49101]: https://github.com/rust-lang/rust/pull/49101
2499 [49109]: https://github.com/rust-lang/rust/pull/49109
2500 [49121]: https://github.com/rust-lang/rust/pull/49121
2501 [49162]: https://github.com/rust-lang/rust/pull/49162
2502 [49184]: https://github.com/rust-lang/rust/pull/49184
2503 [49234]: https://github.com/rust-lang/rust/pull/49234
2504 [49255]: https://github.com/rust-lang/rust/pull/49255
2505 [49299]: https://github.com/rust-lang/rust/pull/49299
2506 [49305]: https://github.com/rust-lang/rust/pull/49305
2507 [49394]: https://github.com/rust-lang/rust/pull/49394
2508 [49458]: https://github.com/rust-lang/rust/pull/49458
2509 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
2510 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
2511 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
2512 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
2513 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
2514 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
2515 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
2516 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
2517 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
2518 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
2519 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
2520 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
2521 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
2522 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
2523 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
2524 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
2525 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
2526 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
2527 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
2528 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
2529 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
2530 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
2531 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
2532 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
2533 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
2534 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
2535 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
2536 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
2537 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
2538 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
2539 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
2540 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
2541 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
2542 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
2543 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
2544 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
2545 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2546 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
2547 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
2548 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
2549 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
2550 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
2551
2552
2553 Version 1.25.0 (2018-03-29)
2554 ==========================
2555
2556 Language
2557 --------
2558 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
2559 - [You can now use nested groups of imports.][47948]
2560   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
2561 - [You can now have `|` at the start of a match arm.][47947] e.g.
2562 ```rust
2563 enum Foo { A, B, C }
2564
2565 fn main() {
2566     let x = Foo::A;
2567     match x {
2568         | Foo::A
2569         | Foo::B => println!("AB"),
2570         | Foo::C => println!("C"),
2571     }
2572 }
2573 ```
2574
2575 Compiler
2576 --------
2577 - [Upgraded to LLVM 6.][47828]
2578 - [Added `-C lto=val` option.][47521]
2579 - [Added `i586-unknown-linux-musl` target][47282]
2580
2581 Libraries
2582 ---------
2583 - [Impl Send for `process::Command` on Unix.][47760]
2584 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
2585 - [`UnsafeCell::into_inner` is now safe.][47204]
2586 - [Implement libstd for CloudABI.][47268]
2587 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
2588 - [Implement `AsRef<Path>` for Component][46985]
2589 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
2590 - [Moved `Duration` to libcore.][46666]
2591
2592 Stabilized APIs
2593 ---------------
2594 - [`Location::column`]
2595 - [`ptr::NonNull`]
2596
2597 The following functions can now be used in a constant expression.
2598 eg. `static MINUTE: Duration = Duration::from_secs(60);`
2599 - [`Duration::new`][47300]
2600 - [`Duration::from_secs`][47300]
2601 - [`Duration::from_millis`][47300]
2602
2603 Cargo
2604 -----
2605 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
2606 - [`cargo new` now defaults to creating a binary crate, instead of a
2607   library crate.][cargo/5029]
2608
2609 Misc
2610 ----
2611 - [Rust by example is now shipped with new releases][46196]
2612
2613 Compatibility Notes
2614 -------------------
2615 - [Deprecated `net::lookup_host`.][47510]
2616 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
2617 - The borrow checker was sometimes incorrectly permitting overlapping borrows
2618   around indexing operations (see [#47349][47349]). This has been fixed (which also
2619   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
2620 - [Removed deprecated unstable attribute `#[simd]`.][47251]
2621
2622 [33903]: https://github.com/rust-lang/rust/pull/33903
2623 [47947]: https://github.com/rust-lang/rust/pull/47947
2624 [47948]: https://github.com/rust-lang/rust/pull/47948
2625 [47760]: https://github.com/rust-lang/rust/pull/47760
2626 [47790]: https://github.com/rust-lang/rust/pull/47790
2627 [47828]: https://github.com/rust-lang/rust/pull/47828
2628 [47398]: https://github.com/rust-lang/rust/pull/47398
2629 [47510]: https://github.com/rust-lang/rust/pull/47510
2630 [47521]: https://github.com/rust-lang/rust/pull/47521
2631 [47204]: https://github.com/rust-lang/rust/pull/47204
2632 [47251]: https://github.com/rust-lang/rust/pull/47251
2633 [47268]: https://github.com/rust-lang/rust/pull/47268
2634 [47282]: https://github.com/rust-lang/rust/pull/47282
2635 [47300]: https://github.com/rust-lang/rust/pull/47300
2636 [47349]: https://github.com/rust-lang/rust/pull/47349
2637 [46931]: https://github.com/rust-lang/rust/pull/46931
2638 [46985]: https://github.com/rust-lang/rust/pull/46985
2639 [47006]: https://github.com/rust-lang/rust/pull/47006
2640 [46830]: https://github.com/rust-lang/rust/pull/46830
2641 [46095]: https://github.com/rust-lang/rust/pull/46095
2642 [46666]: https://github.com/rust-lang/rust/pull/46666
2643 [46196]: https://github.com/rust-lang/rust/pull/46196
2644 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
2645 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
2646 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
2647 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
2648 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
2649
2650
2651 Version 1.24.1 (2018-03-01)
2652 ==========================
2653
2654  - [Do not abort when unwinding through FFI][48251]
2655  - [Emit UTF-16 files for linker arguments on Windows][48318]
2656  - [Make the error index generator work again][48308]
2657  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
2658
2659 [48251]: https://github.com/rust-lang/rust/issues/48251
2660 [48308]: https://github.com/rust-lang/rust/issues/48308
2661 [48318]: https://github.com/rust-lang/rust/issues/48318
2662 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
2663
2664
2665 Version 1.24.0 (2018-02-15)
2666 ==========================
2667
2668 Language
2669 --------
2670 - [External `sysv64` ffi is now available.][46528]
2671   eg. `extern "sysv64" fn foo () {}`
2672
2673 Compiler
2674 --------
2675 - [rustc now uses 16 codegen units by default for release builds.][46910]
2676   For the fastest builds, utilize `codegen-units=1`.
2677 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
2678 - [Add `aarch64-unknown-openbsd` support][46760]
2679
2680 Libraries
2681 ---------
2682 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
2683   improvement in performance in the majority of cases.
2684 - [`OsStr`'s `Debug` implementation is now lossless and consistent
2685   with Windows.][46798]
2686 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
2687 - [impl `From<bool>` for `AtomicBool`][46293]
2688 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
2689 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
2690 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
2691 - [float::from_bits now just uses transmute.][46012] This provides
2692   some optimisations from LLVM.
2693 - [Copied `AsciiExt` methods onto `char`][46077]
2694 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
2695 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
2696 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
2697 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
2698
2699 Stabilized APIs
2700 ---------------
2701 - [`RefCell::replace`]
2702 - [`RefCell::swap`]
2703 - [`atomic::spin_loop_hint`]
2704
2705 The following functions can now be used in a constant expression.
2706 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
2707
2708 - [`AtomicBool::new`][46287]
2709 - [`AtomicUsize::new`][46287]
2710 - [`AtomicIsize::new`][46287]
2711 - [`AtomicPtr::new`][46287]
2712 - [`Cell::new`][46287]
2713 - [`{integer}::min_value`][46287]
2714 - [`{integer}::max_value`][46287]
2715 - [`mem::size_of`][46287]
2716 - [`mem::align_of`][46287]
2717 - [`ptr::null`][46287]
2718 - [`ptr::null_mut`][46287]
2719 - [`RefCell::new`][46287]
2720 - [`UnsafeCell::new`][46287]
2721
2722 Cargo
2723 -----
2724 - [Added a `workspace.default-members` config that
2725   overrides implied `--all` in virtual workspaces.][cargo/4743]
2726 - [Enable incremental by default on development builds.][cargo/4817] Also added
2727   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
2728   per-project or global basis respectively.
2729
2730 Misc
2731 ----
2732
2733 Compatibility Notes
2734 -------------------
2735 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
2736 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
2737   in accordance with IETF RFC 4291 §2.2.
2738 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
2739 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
2740   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
2741 - [Leading zeros in tuple struct members is now an error][47084]
2742 - [`column!()` macro is one-based instead of zero-based][46977]
2743 - [`fmt::Arguments` can no longer be shared across threads][45198]
2744 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
2745 - [Cargo sets a different working directory for the compiler][cargo/4788]
2746
2747 [44884]: https://github.com/rust-lang/rust/pull/44884
2748 [45198]: https://github.com/rust-lang/rust/pull/45198
2749 [45506]: https://github.com/rust-lang/rust/pull/45506
2750 [45904]: https://github.com/rust-lang/rust/pull/45904
2751 [45990]: https://github.com/rust-lang/rust/pull/45990
2752 [46012]: https://github.com/rust-lang/rust/pull/46012
2753 [46077]: https://github.com/rust-lang/rust/pull/46077
2754 [46094]: https://github.com/rust-lang/rust/pull/46094
2755 [46284]: https://github.com/rust-lang/rust/pull/46284
2756 [46287]: https://github.com/rust-lang/rust/pull/46287
2757 [46293]: https://github.com/rust-lang/rust/pull/46293
2758 [46528]: https://github.com/rust-lang/rust/pull/46528
2759 [46671]: https://github.com/rust-lang/rust/pull/46671
2760 [46713]: https://github.com/rust-lang/rust/pull/46713
2761 [46735]: https://github.com/rust-lang/rust/pull/46735
2762 [46749]: https://github.com/rust-lang/rust/pull/46749
2763 [46760]: https://github.com/rust-lang/rust/pull/46760
2764 [46798]: https://github.com/rust-lang/rust/pull/46798
2765 [46828]: https://github.com/rust-lang/rust/pull/46828
2766 [46831]: https://github.com/rust-lang/rust/pull/46831
2767 [46833]: https://github.com/rust-lang/rust/pull/46833
2768 [46910]: https://github.com/rust-lang/rust/pull/46910
2769 [46977]: https://github.com/rust-lang/rust/pull/46977
2770 [47018]: https://github.com/rust-lang/rust/pull/47018
2771 [47080]: https://github.com/rust-lang/rust/pull/47080
2772 [47084]: https://github.com/rust-lang/rust/pull/47084
2773 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
2774 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
2775 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
2776 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
2777 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
2778 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
2779
2780
2781 Version 1.23.0 (2018-01-04)
2782 ==========================
2783
2784 Language
2785 --------
2786 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
2787 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
2788   Which should fix some confusing errors in some operations.
2789
2790 Compiler
2791 --------
2792 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
2793   undefined behavior.][45920]
2794 - [rustc now suggests renaming import if names clash.][45660]
2795 - [Display errors/warnings correctly when there are zero-width or
2796   wide characters.][45711]
2797 - [rustc now avoids unnecessary copies of arguments that are
2798   simple bindings][45380] This should improve memory usage on average by 5-10%.
2799 - [Updated musl used to build musl rustc to 1.1.17][45393]
2800
2801 Libraries
2802 ---------
2803 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
2804 - [Implement Hash for raw pointers to unsized types][45483]
2805 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
2806 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
2807 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
2808 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
2809   and `<*mut T>::as_mut`][44932]
2810 - [Optimized `Thread::{park, unpark}` implementation][45524]
2811 - [Improved `SliceExt::binary_search` performance.][45333]
2812 - [impl `FromIterator<()>` for `()`][45379]
2813 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
2814   is now deprecated.
2815
2816 Stabilized APIs
2817 ---------------
2818
2819 Cargo
2820 -----
2821 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
2822   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
2823 - [Added unit test checking to `cargo check`][cargo/4592]
2824 - [Cargo now lets you install a specific version
2825   using `cargo install --version`][cargo/4637]
2826
2827 Misc
2828 ----
2829 - [Releases now ship with the Cargo book documentation.][45692]
2830 - [rustdoc now prints rendering warnings on every run.][45324]
2831
2832 Compatibility Notes
2833 -------------------
2834 - [Changes have been made to type equality to make it more correct,
2835   in rare cases this could break some code.][45853] [Tracking issue for
2836   further information][45852]
2837 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
2838 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
2839   Android 9, the minimum supported version is Android 14.
2840 - [Bumped the minimum LLVM to 3.9][45326]
2841
2842 [44042]: https://github.com/rust-lang/rust/pull/44042
2843 [44932]: https://github.com/rust-lang/rust/pull/44932
2844 [45267]: https://github.com/rust-lang/rust/pull/45267
2845 [45324]: https://github.com/rust-lang/rust/pull/45324
2846 [45326]: https://github.com/rust-lang/rust/pull/45326
2847 [45333]: https://github.com/rust-lang/rust/pull/45333
2848 [45379]: https://github.com/rust-lang/rust/pull/45379
2849 [45380]: https://github.com/rust-lang/rust/pull/45380
2850 [45393]: https://github.com/rust-lang/rust/pull/45393
2851 [45435]: https://github.com/rust-lang/rust/pull/45435
2852 [45483]: https://github.com/rust-lang/rust/pull/45483
2853 [45524]: https://github.com/rust-lang/rust/pull/45524
2854 [45571]: https://github.com/rust-lang/rust/pull/45571
2855 [45580]: https://github.com/rust-lang/rust/pull/45580
2856 [45610]: https://github.com/rust-lang/rust/pull/45610
2857 [45660]: https://github.com/rust-lang/rust/pull/45660
2858 [45692]: https://github.com/rust-lang/rust/pull/45692
2859 [45711]: https://github.com/rust-lang/rust/pull/45711
2860 [45772]: https://github.com/rust-lang/rust/pull/45772
2861 [45852]: https://github.com/rust-lang/rust/issues/45852
2862 [45853]: https://github.com/rust-lang/rust/pull/45853
2863 [45887]: https://github.com/rust-lang/rust/pull/45887
2864 [45920]: https://github.com/rust-lang/rust/pull/45920
2865 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
2866 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
2867 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
2868
2869
2870 Version 1.22.1 (2017-11-22)
2871 ==========================
2872
2873 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
2874
2875 [46183]: https://github.com/rust-lang/rust/pull/46183
2876
2877 Version 1.22.0 (2017-11-22)
2878 ==========================
2879
2880 Language
2881 --------
2882 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
2883 - [Now accepts underscores in unicode escapes][43716]
2884 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
2885 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
2886
2887 Compiler
2888 --------
2889 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
2890 - [rustc will no longer inline in codegen units when compiling for debug][45075]
2891   This should decrease compile times for debug builds.
2892 - [strict memory alignment now enabled on ARMv6][45094]
2893 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
2894
2895 Libraries
2896 ---------
2897 - [Allow atomic operations up to 32 bits
2898   on `armv5te_unknown_linux_gnueabi`][44978]
2899 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
2900 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
2901 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
2902 - [Properly detect overflow in `Instant += Duration`.][44220]
2903 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
2904 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
2905 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
2906
2907 Stabilized APIs
2908 ---------------
2909
2910 Cargo
2911 -----
2912 - [Cargo will now build multi file examples in subdirectories of the `examples`
2913   folder that have a `main.rs` file.][cargo/4496]
2914 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
2915   the old format will continue to work and can be updated with `cargo update`.
2916 - [Now supports vendoring git repositories][cargo/3992]
2917
2918 Misc
2919 ----
2920 - [`libbacktrace` is now available on Apple platforms.][44251]
2921 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
2922   This now lets you specify that a given code example will fail to compile.
2923
2924 Compatibility Notes
2925 -------------------
2926 - [The minimum Android version that rustc can build for has been bumped
2927   to `4.0` from `2.3`][45656]
2928 - [Allowing `T op= &T` for numeric types has broken some type
2929   inference cases][45480]
2930
2931
2932 [42526]: https://github.com/rust-lang/rust/pull/42526
2933 [43017]: https://github.com/rust-lang/rust/pull/43017
2934 [43716]: https://github.com/rust-lang/rust/pull/43716
2935 [43949]: https://github.com/rust-lang/rust/pull/43949
2936 [44015]: https://github.com/rust-lang/rust/pull/44015
2937 [44220]: https://github.com/rust-lang/rust/pull/44220
2938 [44251]: https://github.com/rust-lang/rust/pull/44251
2939 [44287]: https://github.com/rust-lang/rust/pull/44287
2940 [44303]: https://github.com/rust-lang/rust/pull/44303
2941 [44456]: https://github.com/rust-lang/rust/pull/44456
2942 [44466]: https://github.com/rust-lang/rust/pull/44466
2943 [44895]: https://github.com/rust-lang/rust/pull/44895
2944 [44966]: https://github.com/rust-lang/rust/pull/44966
2945 [44978]: https://github.com/rust-lang/rust/pull/44978
2946 [45041]: https://github.com/rust-lang/rust/pull/45041
2947 [45064]: https://github.com/rust-lang/rust/pull/45064
2948 [45075]: https://github.com/rust-lang/rust/pull/45075
2949 [45094]: https://github.com/rust-lang/rust/pull/45094
2950 [45095]: https://github.com/rust-lang/rust/pull/45095
2951 [45480]: https://github.com/rust-lang/rust/issues/45480
2952 [45656]: https://github.com/rust-lang/rust/pull/45656
2953 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
2954 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
2955 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
2956
2957
2958
2959
2960
2961
2962 Version 1.21.0 (2017-10-12)
2963 ==========================
2964
2965 Language
2966 --------
2967 - [You can now use static references for literals.][43838]
2968   Example:
2969   ```rust
2970   fn main() {
2971       let x: &'static u32 = &0;
2972   }
2973   ```
2974 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
2975   Example:
2976   ```rust
2977   my_macro!(Vec<i32>::new); // Always worked
2978   my_macro!(Vec::<i32>::new); // Now works
2979   ```
2980
2981 Compiler
2982 --------
2983 - [Upgraded jemalloc to 4.5.0][43911]
2984 - [Enabled unwinding panics on Redox][43917]
2985 - [Now runs LLVM in parallel during translation phase.][43506]
2986   This should reduce peak memory usage.
2987
2988 Libraries
2989 ---------
2990 - [Generate builtin impls for `Clone` for all arrays and tuples that
2991   are `T: Clone`][43690]
2992 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
2993 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
2994   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
2995
2996 Stabilized APIs
2997 ---------------
2998
2999 [`std::mem::discriminant`]
3000
3001 Cargo
3002 -----
3003 - [You can now call `cargo install` with multiple package names][cargo/4216]
3004 - [Cargo commands inside a virtual workspace will now implicitly
3005   pass `--all`][cargo/4335]
3006 - [Added a `[patch]` section to `Cargo.toml` to handle
3007   prepublication dependencies][cargo/4123] [RFC 1969]
3008 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
3009   like patterns][cargo/4270]
3010 - [Added the `--all-targets` option][cargo/4400]
3011 - [Using required dependencies as a feature is now deprecated and emits
3012   a warning][cargo/4364]
3013
3014
3015 Misc
3016 ----
3017 - [Cargo docs are moving][43916]
3018   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
3019 - [The rustdoc book is now available][43863]
3020   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
3021 - [Added a preview of RLS has been made available through rustup][44204]
3022   Install with `rustup component add rls-preview`
3023 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
3024   Previously only showed `std::os::unix`.
3025
3026 Compatibility Notes
3027 -------------------
3028 - [Changes in method matching against higher-ranked types][43880] This may cause
3029   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
3030 - [rustc's JSON error output's byte position start at top of file.][42973]
3031   Was previously relative to the rustc's internal `CodeMap` struct which
3032   required the unstable library `libsyntax` to correctly use.
3033 - [`unused_results` lint no longer ignores booleans][43728]
3034
3035 [42565]: https://github.com/rust-lang/rust/pull/42565
3036 [42973]: https://github.com/rust-lang/rust/pull/42973
3037 [43348]: https://github.com/rust-lang/rust/pull/43348
3038 [43459]: https://github.com/rust-lang/rust/pull/43459
3039 [43506]: https://github.com/rust-lang/rust/pull/43506
3040 [43540]: https://github.com/rust-lang/rust/pull/43540
3041 [43690]: https://github.com/rust-lang/rust/pull/43690
3042 [43728]: https://github.com/rust-lang/rust/pull/43728
3043 [43838]: https://github.com/rust-lang/rust/pull/43838
3044 [43863]: https://github.com/rust-lang/rust/pull/43863
3045 [43880]: https://github.com/rust-lang/rust/pull/43880
3046 [43911]: https://github.com/rust-lang/rust/pull/43911
3047 [43916]: https://github.com/rust-lang/rust/pull/43916
3048 [43917]: https://github.com/rust-lang/rust/pull/43917
3049 [44204]: https://github.com/rust-lang/rust/pull/44204
3050 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
3051 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
3052 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3053 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
3054 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
3055 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
3056 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
3057 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
3058 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
3059
3060 Version 1.20.0 (2017-08-31)
3061 ===========================
3062
3063 Language
3064 --------
3065 - [Associated constants are now stabilised.][42809]
3066 - [A lot of macro bugs are now fixed.][42913]
3067
3068 Compiler
3069 --------
3070
3071 - [Struct fields are now properly coerced to the expected field type.][42807]
3072 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
3073   `wasm32-experimental-emscripten` target.
3074 - [Changed some of the error messages to be more helpful.][42033]
3075 - [Add support for RELRO(RELocation Read-Only) for platforms that support
3076   it.][43170]
3077 - [rustc now reports the total number of errors on compilation failure][43015]
3078   previously this was only the number of errors in the pass that failed.
3079 - [Expansion in rustc has been sped up 29x.][42533]
3080 - [added `msp430-none-elf` target.][43099]
3081 - [rustc will now suggest one-argument enum variant to fix type mismatch when
3082   applicable][43178]
3083 - [Fixes backtraces on Redox][43228]
3084 - [rustc now identifies different versions of same crate when absolute paths of
3085   different types match in an error message.][42826]
3086
3087 Libraries
3088 ---------
3089
3090
3091 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
3092 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
3093   tuples.][43011]
3094 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
3095   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
3096 - [Impl `Clone` for `DefaultHasher`.][42799]
3097 - [Impl `Sync` for `SyncSender`.][42397]
3098 - [Impl `FromStr` for `char`][42271]
3099 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
3100   NaN.][42431]
3101 - [allow messages in the `unimplemented!()` macro.][42155]
3102   ie. `unimplemented!("Waiting for 1.21 to be stable")`
3103 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
3104 - [Upgrade to Unicode 10.0.0][42999]
3105 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
3106 - [Skip the main thread's manual stack guard on Linux][43072]
3107 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
3108 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
3109   previously 2^15.
3110 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
3111
3112 Stabilized APIs
3113 ---------------
3114
3115 - [`CStr::into_c_string`]
3116 - [`CString::as_c_str`]
3117 - [`CString::into_boxed_c_str`]
3118 - [`Chain::get_mut`]
3119 - [`Chain::get_ref`]
3120 - [`Chain::into_inner`]
3121 - [`Option::get_or_insert_with`]
3122 - [`Option::get_or_insert`]
3123 - [`OsStr::into_os_string`]
3124 - [`OsString::into_boxed_os_str`]
3125 - [`Take::get_mut`]
3126 - [`Take::get_ref`]
3127 - [`Utf8Error::error_len`]
3128 - [`char::EscapeDebug`]
3129 - [`char::escape_debug`]
3130 - [`compile_error!`]
3131 - [`f32::from_bits`]
3132 - [`f32::to_bits`]
3133 - [`f64::from_bits`]
3134 - [`f64::to_bits`]
3135 - [`mem::ManuallyDrop`]
3136 - [`slice::sort_unstable_by_key`]
3137 - [`slice::sort_unstable_by`]
3138 - [`slice::sort_unstable`]
3139 - [`str::from_boxed_utf8_unchecked`]
3140 - [`str::as_bytes_mut`]
3141 - [`str::as_bytes_mut`]
3142 - [`str::from_utf8_mut`]
3143 - [`str::from_utf8_unchecked_mut`]
3144 - [`str::get_mut`]
3145 - [`str::get_unchecked_mut`]
3146 - [`str::get_unchecked`]
3147 - [`str::get`]
3148 - [`str::into_boxed_bytes`]
3149
3150
3151 Cargo
3152 -----
3153 - [Cargo API token location moved from `~/.cargo/config` to
3154   `~/.cargo/credentials`.][cargo/3978]
3155 - [Cargo will now build `main.rs` binaries that are in sub-directories of
3156   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
3157   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
3158 - [You can now specify version of a binary when installed through
3159   `cargo install` using `--vers`.][cargo/4229]
3160 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
3161   failure.][cargo/4248]
3162 - [Changed the convention around which file is the crate root.][cargo/4259]
3163 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
3164   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
3165
3166 Compatibility Notes
3167 -------------------
3168
3169 - [Functions with `'static` in their return types will now not be as usable as
3170   if they were using lifetime parameters instead.][42417]
3171 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
3172   takes the sign of NaN into account where previously didn't.][42430]
3173
3174 [42033]: https://github.com/rust-lang/rust/pull/42033
3175 [42155]: https://github.com/rust-lang/rust/pull/42155
3176 [42271]: https://github.com/rust-lang/rust/pull/42271
3177 [42397]: https://github.com/rust-lang/rust/pull/42397
3178 [42417]: https://github.com/rust-lang/rust/pull/42417
3179 [42430]: https://github.com/rust-lang/rust/pull/42430
3180 [42431]: https://github.com/rust-lang/rust/pull/42431
3181 [42533]: https://github.com/rust-lang/rust/pull/42533
3182 [42571]: https://github.com/rust-lang/rust/pull/42571
3183 [42613]: https://github.com/rust-lang/rust/pull/42613
3184 [42799]: https://github.com/rust-lang/rust/pull/42799
3185 [42807]: https://github.com/rust-lang/rust/pull/42807
3186 [42809]: https://github.com/rust-lang/rust/pull/42809
3187 [42822]: https://github.com/rust-lang/rust/pull/42822
3188 [42826]: https://github.com/rust-lang/rust/pull/42826
3189 [42854]: https://github.com/rust-lang/rust/pull/42854
3190 [42913]: https://github.com/rust-lang/rust/pull/42913
3191 [42999]: https://github.com/rust-lang/rust/pull/42999
3192 [43011]: https://github.com/rust-lang/rust/pull/43011
3193 [43015]: https://github.com/rust-lang/rust/pull/43015
3194 [43072]: https://github.com/rust-lang/rust/pull/43072
3195 [43077]: https://github.com/rust-lang/rust/pull/43077
3196 [43097]: https://github.com/rust-lang/rust/pull/43097
3197 [43099]: https://github.com/rust-lang/rust/pull/43099
3198 [43170]: https://github.com/rust-lang/rust/pull/43170
3199 [43178]: https://github.com/rust-lang/rust/pull/43178
3200 [43185]: https://github.com/rust-lang/rust/pull/43185
3201 [43228]: https://github.com/rust-lang/rust/pull/43228
3202 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
3203 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
3204 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
3205 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
3206 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
3207 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3208 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
3209 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
3210 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
3211 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
3212 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
3213 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
3214 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
3215 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
3216 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
3217 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
3218 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
3219 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
3220 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
3221 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
3222 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
3223 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
3224 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
3225 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
3226 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
3227 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
3228 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
3229 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
3230 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
3231 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
3232 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
3233 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
3234 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
3235 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
3236 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
3237 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
3238 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
3239 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
3240 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
3241
3242
3243 Version 1.19.0 (2017-07-20)
3244 ===========================
3245
3246 Language
3247 --------
3248
3249 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
3250   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
3251 - [Macro recursion limit increased to 1024 from 64.][41676]
3252 - [Added lint for detecting unused macros.][41907]
3253 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
3254   For example: `let x = loop { break 7; };`
3255 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
3256   contain `Copy` types and cannot have a `Drop` implementation.
3257   Example: `union Foo { bar: u8, baz: usize }`
3258 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
3259   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
3260
3261 Compiler
3262 --------
3263
3264 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
3265 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
3266   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
3267   you should use `--target armv7-linux-androideabi`.
3268 - [Fixed ICE when removing a source file between compilation sessions.][41873]
3269 - [Minor optimisation of string operations.][42037]
3270 - [Compiler error message is now `aborting due to previous error(s)` instead of
3271   `aborting due to N previous errors`][42150] This was previously inaccurate and
3272   would only count certain kinds of errors.
3273 - [The compiler now supports Visual Studio 2017][42225]
3274 - [The compiler is now built against LLVM 4.0.1 by default][42948]
3275 - [Added a lot][42264] of [new error codes][42302]
3276 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
3277   libraries with C Run-time Libraries(CRT) to be statically linked.
3278 - [Fixed various ARM codegen bugs][42740]
3279
3280 Libraries
3281 ---------
3282
3283 - [`String` now implements `FromIterator<Cow<'a, str>>` and
3284   `Extend<Cow<'a, str>>`][41449]
3285 - [`Vec` now implements `From<&mut [T]>`][41530]
3286 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
3287 - [`SplitWhitespace` now implements `Clone`][41659]
3288 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
3289   1.5x faster][41764]
3290 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
3291   macros, but for printing to stderr.
3292
3293 Stabilized APIs
3294 ---------------
3295
3296 - [`OsString::shrink_to_fit`]
3297 - [`cmp::Reverse`]
3298 - [`Command::envs`]
3299 - [`thread::ThreadId`]
3300
3301 Cargo
3302 -----
3303
3304 - [Build scripts can now add environment variables to the environment
3305   the crate is being compiled in.
3306   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
3307 - [Subcommands now replace the current process rather than spawning a new
3308   child process][cargo/3970]
3309 - [Workspace members can now accept glob file patterns][cargo/3979]
3310 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
3311   the members in a given workspace.][cargo/3988]
3312 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
3313 - [Target directory path is now in the cargo metadata][cargo/4022]
3314 - [Cargo no longer checks out a local working directory for the
3315   crates.io index][cargo/4026] This should provide smaller file size for the
3316   registry, and improve cloning times, especially on Windows machines.
3317 - [Added an `--exclude` option for excluding certain packages when using the
3318   `--all` option][cargo/4031]
3319 - [Cargo will now automatically retry when receiving a 5xx error
3320   from crates.io][cargo/4032]
3321 - [The `--features` option now accepts multiple comma or space
3322   delimited values.][cargo/4084]
3323 - [Added support for custom target specific runners][cargo/3954]
3324
3325 Misc
3326 ----
3327
3328 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
3329   Windows Debugger.
3330 - [Rust will now release XZ compressed packages][rust-installer/57]
3331 - [rustup will now prefer to download rust packages with
3332   XZ compression][rustup/1100] over GZip packages.
3333 - [Added the ability to escape `#` in rust documentation][41785] By adding
3334   additional `#`'s ie. `##` is now `#`
3335
3336 Compatibility Notes
3337 -------------------
3338
3339 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
3340 - [`-Z` flags are now no longer allowed to be used on the stable
3341   compiler.][41751] This has been a warning for a year previous to this.
3342 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
3343   longer works][42844]. Users should migrate to the built-in `check`
3344   command, which has been available since 1.16.
3345 - [Ending a float literal with `._` is now a hard error.
3346   Example: `42._` .][41946]
3347 - [Any use of a private `extern crate` outside of its module is now a
3348   hard error.][36886] This was previously a warning.
3349 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
3350   relative while the `::` prefix makes a path absolute, but was ignored and the
3351   path was relative regardless.
3352 - [Floating point constants in match patterns is now a hard error][36890]
3353   This was previously a warning.
3354 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
3355   match patterns is now a hard error][36891] This was previously a warning.
3356 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
3357   a warning.
3358 - [From the pound escape, lines consisting of multiple `#`s are
3359   now visible][41785]
3360 - [It is an error to re-export private enum variants][42460]. This is
3361   known to break a number of crates that depend on an older version of
3362   mustache.
3363 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
3364   to use it to find the linker, and the build will fail where it did
3365   not previously][42607]
3366
3367 [36886]: https://github.com/rust-lang/rust/issues/36886
3368 [36888]: https://github.com/rust-lang/rust/issues/36888
3369 [36890]: https://github.com/rust-lang/rust/issues/36890
3370 [36891]: https://github.com/rust-lang/rust/issues/36891
3371 [36892]: https://github.com/rust-lang/rust/issues/36892
3372 [37406]: https://github.com/rust-lang/rust/issues/37406
3373 [39983]: https://github.com/rust-lang/rust/pull/39983
3374 [41145]: https://github.com/rust-lang/rust/pull/41145
3375 [41192]: https://github.com/rust-lang/rust/pull/41192
3376 [41258]: https://github.com/rust-lang/rust/pull/41258
3377 [41370]: https://github.com/rust-lang/rust/pull/41370
3378 [41449]: https://github.com/rust-lang/rust/pull/41449
3379 [41530]: https://github.com/rust-lang/rust/pull/41530
3380 [41624]: https://github.com/rust-lang/rust/pull/41624
3381 [41656]: https://github.com/rust-lang/rust/pull/41656
3382 [41659]: https://github.com/rust-lang/rust/pull/41659
3383 [41676]: https://github.com/rust-lang/rust/pull/41676
3384 [41751]: https://github.com/rust-lang/rust/pull/41751
3385 [41764]: https://github.com/rust-lang/rust/pull/41764
3386 [41785]: https://github.com/rust-lang/rust/pull/41785
3387 [41873]: https://github.com/rust-lang/rust/pull/41873
3388 [41907]: https://github.com/rust-lang/rust/pull/41907
3389 [41946]: https://github.com/rust-lang/rust/pull/41946
3390 [42016]: https://github.com/rust-lang/rust/pull/42016
3391 [42037]: https://github.com/rust-lang/rust/pull/42037
3392 [42068]: https://github.com/rust-lang/rust/pull/42068
3393 [42150]: https://github.com/rust-lang/rust/pull/42150
3394 [42162]: https://github.com/rust-lang/rust/pull/42162
3395 [42225]: https://github.com/rust-lang/rust/pull/42225
3396 [42264]: https://github.com/rust-lang/rust/pull/42264
3397 [42302]: https://github.com/rust-lang/rust/pull/42302
3398 [42460]: https://github.com/rust-lang/rust/issues/42460
3399 [42607]: https://github.com/rust-lang/rust/issues/42607
3400 [42740]: https://github.com/rust-lang/rust/pull/42740
3401 [42844]: https://github.com/rust-lang/rust/issues/42844
3402 [42948]: https://github.com/rust-lang/rust/pull/42948
3403 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
3404 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
3405 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
3406 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
3407 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
3408 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
3409 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
3410 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
3411 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
3412 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
3413 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
3414 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
3415 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
3416 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
3417 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
3418 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
3419 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
3420 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
3421 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
3422 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
3423 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
3424 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
3425
3426
3427 Version 1.18.0 (2017-06-08)
3428 ===========================
3429
3430 Language
3431 --------
3432
3433 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
3434   make the item visible to just that module tree. Also accepts the keyword
3435   `crate` to make something public to the whole crate but not users of the
3436   library. Example: `pub(crate) mod utils;`. [RFC 1422].
3437 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
3438   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
3439 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
3440   types like `Write + Send`, trailing `+` are now supported in trait objects,
3441   and better error reporting for trait objects starting with `?Sized`.
3442 - [0e+10 is now a valid floating point literal][40589]
3443 - [Now warns if you bind a lifetime parameter to 'static][40734]
3444 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
3445   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
3446   representation in some cases.][40377]
3447
3448 Compiler
3449 --------
3450
3451 - [rustc can now emit mir with `--emit mir`][39891]
3452 - [Improved LLVM IR for trivial functions][40367]
3453 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
3454 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
3455   opportunities found through profiling
3456 - [Improved backtrace formatting when panicking][38165]
3457
3458 Libraries
3459 ---------
3460
3461 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
3462   iterator hasn't been advanced the original `Vec` is reassembled with no actual
3463   iteration or reallocation.
3464 - [Simplified HashMap Bucket interface][40561] provides performance
3465   improvements for iterating and cloning.
3466 - [Specialize Vec::from_elem to use calloc][40409]
3467 - [Fixed Race condition in fs::create_dir_all][39799]
3468 - [No longer caching stdio on Windows][40516]
3469 - [Optimized insertion sort in slice][40807] insertion sort in some cases
3470   2.50%~ faster and in one case now 12.50% faster.
3471 - [Optimized `AtomicBool::fetch_nand`][41143]
3472
3473 Stabilized APIs
3474 ---------------
3475
3476 - [`Child::try_wait`]
3477 - [`HashMap::retain`]
3478 - [`HashSet::retain`]
3479 - [`PeekMut::pop`]
3480 - [`TcpStream::peek`]
3481 - [`UdpSocket::peek`]
3482 - [`UdpSocket::peek_from`]
3483
3484 Cargo
3485 -----
3486
3487 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
3488   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
3489 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
3490 - [Added Android build support][cargo/3885]
3491 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
3492   of a certain type, for example `cargo build --bins` will build all
3493   binaries.
3494 - [Added support for haiku][cargo/3952]
3495
3496 Misc
3497 ----
3498
3499 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
3500 - [Added rust-windbg script for better debugging on Windows][39983]
3501 - [Rust now uses the official cross compiler for NetBSD][40612]
3502 - [rustdoc now accepts `#` at the start of files][40828]
3503 - [Fixed jemalloc support for musl][41168]
3504
3505 Compatibility Notes
3506 -------------------
3507
3508 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
3509   always placed after the sign if it exists and before the digits. With the `#`
3510   flag the zeroes are placed after the prefix and before the digits.
3511 - [Due to the struct field optimisation][40377], using `transmute` on structs
3512   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
3513   always been undefined behavior, but is now more likely to break in practice.
3514 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
3515   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
3516   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
3517 - [Overlapping inherent `impl`s are now a hard error][40728]
3518 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
3519 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
3520   `out.asm` and `out.ll` instead of only one of the filetypes.
3521 - [ calling a function that returns `Self` will no longer work][41805] when
3522   the size of `Self` cannot be statically determined.
3523 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
3524   this has caused a few regressions namely:
3525
3526   - Changed the link order of local static/dynamic libraries (respecting the
3527     order on given rather than having the compiler reorder).
3528   - Changed how MinGW is linked, native code linked to dynamic libraries
3529     may require manually linking to the gcc support library (for the native
3530     code itself)
3531
3532 [38165]: https://github.com/rust-lang/rust/pull/38165
3533 [39799]: https://github.com/rust-lang/rust/pull/39799
3534 [39891]: https://github.com/rust-lang/rust/pull/39891
3535 [39983]: https://github.com/rust-lang/rust/pull/39983
3536 [40043]: https://github.com/rust-lang/rust/pull/40043
3537 [40241]: https://github.com/rust-lang/rust/pull/40241
3538 [40338]: https://github.com/rust-lang/rust/pull/40338
3539 [40367]: https://github.com/rust-lang/rust/pull/40367
3540 [40377]: https://github.com/rust-lang/rust/pull/40377
3541 [40409]: https://github.com/rust-lang/rust/pull/40409
3542 [40516]: https://github.com/rust-lang/rust/pull/40516
3543 [40556]: https://github.com/rust-lang/rust/pull/40556
3544 [40561]: https://github.com/rust-lang/rust/pull/40561
3545 [40589]: https://github.com/rust-lang/rust/pull/40589
3546 [40612]: https://github.com/rust-lang/rust/pull/40612
3547 [40723]: https://github.com/rust-lang/rust/pull/40723
3548 [40728]: https://github.com/rust-lang/rust/pull/40728
3549 [40731]: https://github.com/rust-lang/rust/pull/40731
3550 [40734]: https://github.com/rust-lang/rust/pull/40734
3551 [40805]: https://github.com/rust-lang/rust/pull/40805
3552 [40807]: https://github.com/rust-lang/rust/pull/40807
3553 [40828]: https://github.com/rust-lang/rust/pull/40828
3554 [40870]: https://github.com/rust-lang/rust/pull/40870
3555 [41085]: https://github.com/rust-lang/rust/pull/41085
3556 [41143]: https://github.com/rust-lang/rust/pull/41143
3557 [41168]: https://github.com/rust-lang/rust/pull/41168
3558 [41270]: https://github.com/rust-lang/rust/issues/41270
3559 [41469]: https://github.com/rust-lang/rust/pull/41469
3560 [41805]: https://github.com/rust-lang/rust/issues/41805
3561 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
3562 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
3563 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
3564 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
3565 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
3566 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
3567 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
3568 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
3569 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
3570 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
3571 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
3572 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
3573 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
3574 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
3575
3576
3577 Version 1.17.0 (2017-04-27)
3578 ===========================
3579
3580 Language
3581 --------
3582
3583 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
3584 * [Fields of structs may be initialized without duplicating the field/variable
3585   names][39761]. [RFC 1682]
3586 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
3587 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3588   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
3589   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
3590   `'b`. Soundness fix.
3591 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
3592 * [Static variables may contain references to other statics][40027]
3593
3594 Compiler
3595 --------
3596
3597 * [Exit quickly on only `--emit dep-info`][40336]
3598 * [Make `-C relocation-model` more correctly determine whether the linker
3599   creates a position-independent executable][40245]
3600 * [Add `-C overflow-checks` to directly control whether integer overflow
3601   panics][40037]
3602 * [The rustc type checker now checks items on demand instead of in a single
3603   in-order pass][40008]. This is mostly an internal refactoring in support of
3604   future work, including incremental type checking, but also resolves [RFC
3605   1647], allowing `Self` to appear in `impl` `where` clauses.
3606 * [Optimize vtable loads][39995]
3607 * [Turn off vectorization for Emscripten targets][39990]
3608 * [Provide suggestions for unknown macros imported with `use`][39953]
3609 * [Fix ICEs in path resolution][39939]
3610 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
3611 * [Add clearer error message using `&str + &str`][39116]
3612
3613 Stabilized APIs
3614 ---------------
3615
3616 * [`Arc::into_raw`]
3617 * [`Arc::from_raw`]
3618 * [`Arc::ptr_eq`]
3619 * [`Rc::into_raw`]
3620 * [`Rc::from_raw`]
3621 * [`Rc::ptr_eq`]
3622 * [`Ordering::then`]
3623 * [`Ordering::then_with`]
3624 * [`BTreeMap::range`]
3625 * [`BTreeMap::range_mut`]
3626 * [`collections::Bound`]
3627 * [`process::abort`]
3628 * [`ptr::read_unaligned`]
3629 * [`ptr::write_unaligned`]
3630 * [`Result::expect_err`]
3631 * [`Cell::swap`]
3632 * [`Cell::replace`]
3633 * [`Cell::into_inner`]
3634 * [`Cell::take`]
3635
3636 Libraries
3637 ---------
3638
3639 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
3640 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
3641 * [`String` implements `FromIterator<&char>`][40028]
3642 * `Box` [implements][40009] a number of new conversions:
3643   `From<Box<str>> for String`,
3644   `From<Box<[T]>> for Vec<T>`,
3645   `From<Box<CStr>> for CString`,
3646   `From<Box<OsStr>> for OsString`,
3647   `From<Box<Path>> for PathBuf`,
3648   `Into<Box<str>> for String`,
3649   `Into<Box<[T]>> for Vec<T>`,
3650   `Into<Box<CStr>> for CString`,
3651   `Into<Box<OsStr>> for OsString`,
3652   `Into<Box<Path>> for PathBuf`,
3653   `Default for Box<str>`,
3654   `Default for Box<CStr>`,
3655   `Default for Box<OsStr>`,
3656   `From<&CStr> for Box<CStr>`,
3657   `From<&OsStr> for Box<OsStr>`,
3658   `From<&Path> for Box<Path>`
3659 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
3660 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
3661 * [Slightly optimize `slice::sort`][39538]
3662 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
3663 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
3664   `Box<str>` implements `From<&str>`][39438]
3665 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
3666   `From<(I, u16)> where I: Into<IpAddr>`][39372]
3667 * [`format!` estimates the needed capacity before writing a string][39356]
3668 * [Support unprivileged symlink creation in Windows][38921]
3669 * [`PathBuf` implements `Default`][38764]
3670 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
3671 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
3672   and poor hash functions.
3673
3674 Cargo
3675 -----
3676
3677 * [Add `cargo check --all`][cargo/3731]
3678 * [Add an option to ignore SSL revocation checking][cargo/3699]
3679 * [Add `cargo run --package`][cargo/3691]
3680 * [Add `required_features`][cargo/3667]
3681 * [Assume `build.rs` is a build script][cargo/3664]
3682 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
3683
3684 Misc
3685 ----
3686
3687 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
3688   `rustbook`][39633]
3689 * [The "Unstable Book" documents nightly-only features][ubook]
3690 * [Improve the style of the sidebar in rustdoc output][40265]
3691 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
3692 * [Fix MSP430 breakage due to `i128`][40257]
3693 * [Preliminary Solaris/SPARCv9 support][39903]
3694 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
3695   run without installing the MSVC runtime.
3696 * [`rustdoc --test` includes file names in test names][39788]
3697 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
3698   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
3699 * [Initial support for `aarch64-unknown-freebsd`][39491]
3700 * [Initial support for `i686-unknown-netbsd`][39426]
3701 * [This release no longer includes the old makefile build system][39431]. Rust
3702   is built with a custom build system, written in Rust, and with Cargo.
3703 * [Add Debug implementations for libcollection structs][39002]
3704 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
3705 * [`--test-threads=0` produces an error][38945]
3706 * [`rustup` installs documentation by default][40526]
3707 * [The Rust source includes NatVis visualizations][39843]. These can be used by
3708   WinDbg and Visual Studio to improve the debugging experience.
3709
3710 Compatibility Notes
3711 -------------------
3712
3713 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
3714   workaround, either use MSVC 2015 or run vcvars.bat.
3715 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3716   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
3717   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
3718   fix.
3719 * [`format!` and `Display::to_string` panic if an underlying formatting
3720   implementation returns an error][40117]. Previously the error was silently
3721   ignored. It is incorrect for `write_fmt` to return an error when writing
3722   to a string.
3723 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
3724   crates were marked stable and could be accessed from the stable toolchain.
3725 * [Rust git source no longer includes vendored crates][39728]. Those that need
3726   to build with vendored crates should build from release tarballs.
3727 * [Fix inert attributes from `proc_macro_derives`][39572]
3728 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
3729   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
3730   build system.
3731 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
3732   existing code generally ignores the type of dead-code unless a type-hint is
3733   provided; this can cause surprising inference interactions particularly around
3734   defaulting. The new code uniformly ignores the result type of dead-code.
3735 * [Tuple-struct constructors with private fields are no longer visible][38932]
3736 * [Lifetime parameters that do not appear in the arguments are now considered
3737   early-bound][38897], resolving a soundness bug (#[32330]). The
3738   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
3739   April of 2016.
3740 * [rustdoc: fix doctests with non-feature crate attributes][38161]
3741 * [Make transmuting from fn item types to pointer-sized types a hard
3742   error][34198]
3743
3744 [27787]: https://github.com/rust-lang/rust/issues/27787
3745 [32330]: https://github.com/rust-lang/rust/issues/32330
3746 [34198]: https://github.com/rust-lang/rust/pull/34198
3747 [38161]: https://github.com/rust-lang/rust/pull/38161
3748 [38368]: https://github.com/rust-lang/rust/pull/38368
3749 [38584]: https://github.com/rust-lang/rust/issues/38584
3750 [38661]: https://github.com/rust-lang/rust/pull/38661
3751 [38764]: https://github.com/rust-lang/rust/pull/38764
3752 [38864]: https://github.com/rust-lang/rust/issues/38864
3753 [38897]: https://github.com/rust-lang/rust/pull/38897
3754 [38921]: https://github.com/rust-lang/rust/pull/38921
3755 [38932]: https://github.com/rust-lang/rust/pull/38932
3756 [38945]: https://github.com/rust-lang/rust/pull/38945
3757 [38981]: https://github.com/rust-lang/rust/pull/38981
3758 [39002]: https://github.com/rust-lang/rust/pull/39002
3759 [39116]: https://github.com/rust-lang/rust/pull/39116
3760 [39193]: https://github.com/rust-lang/rust/pull/39193
3761 [39265]: https://github.com/rust-lang/rust/pull/39265
3762 [39356]: https://github.com/rust-lang/rust/pull/39356
3763 [39372]: https://github.com/rust-lang/rust/pull/39372
3764 [39426]: https://github.com/rust-lang/rust/pull/39426
3765 [39431]: https://github.com/rust-lang/rust/pull/39431
3766 [39438]: https://github.com/rust-lang/rust/pull/39438
3767 [39440]: https://github.com/rust-lang/rust/pull/39440
3768 [39485]: https://github.com/rust-lang/rust/pull/39485
3769 [39491]: https://github.com/rust-lang/rust/pull/39491
3770 [39518]: https://github.com/rust-lang/rust/pull/39518
3771 [39538]: https://github.com/rust-lang/rust/pull/39538
3772 [39572]: https://github.com/rust-lang/rust/pull/39572
3773 [39633]: https://github.com/rust-lang/rust/pull/39633
3774 [39642]: https://github.com/rust-lang/rust/pull/39642
3775 [39728]: https://github.com/rust-lang/rust/pull/39728
3776 [39761]: https://github.com/rust-lang/rust/pull/39761
3777 [39788]: https://github.com/rust-lang/rust/pull/39788
3778 [39793]: https://github.com/rust-lang/rust/pull/39793
3779 [39837]: https://github.com/rust-lang/rust/pull/39837
3780 [39843]: https://github.com/rust-lang/rust/pull/39843
3781 [39851]: https://github.com/rust-lang/rust/pull/39851
3782 [39903]: https://github.com/rust-lang/rust/pull/39903
3783 [39939]: https://github.com/rust-lang/rust/pull/39939
3784 [39953]: https://github.com/rust-lang/rust/pull/39953
3785 [39960]: https://github.com/rust-lang/rust/pull/39960
3786 [39990]: https://github.com/rust-lang/rust/pull/39990
3787 [39995]: https://github.com/rust-lang/rust/pull/39995
3788 [40008]: https://github.com/rust-lang/rust/pull/40008
3789 [40009]: https://github.com/rust-lang/rust/pull/40009
3790 [40027]: https://github.com/rust-lang/rust/pull/40027
3791 [40028]: https://github.com/rust-lang/rust/pull/40028
3792 [40037]: https://github.com/rust-lang/rust/pull/40037
3793 [40117]: https://github.com/rust-lang/rust/pull/40117
3794 [40166]: https://github.com/rust-lang/rust/pull/40166
3795 [40245]: https://github.com/rust-lang/rust/pull/40245
3796 [40257]: https://github.com/rust-lang/rust/pull/40257
3797 [40261]: https://github.com/rust-lang/rust/pull/40261
3798 [40265]: https://github.com/rust-lang/rust/pull/40265
3799 [40319]: https://github.com/rust-lang/rust/pull/40319
3800 [40336]: https://github.com/rust-lang/rust/pull/40336
3801 [40526]: https://github.com/rust-lang/rust/pull/40526
3802 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
3803 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
3804 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
3805 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
3806 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
3807 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
3808 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
3809 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
3810 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
3811 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
3812 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
3813 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
3814 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
3815 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
3816 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
3817 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
3818 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
3819 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
3820 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
3821 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
3822 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
3823 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
3824 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
3825 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
3826 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
3827 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
3828 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
3829 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
3830 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
3831 [mdbook]: https://crates.io/crates/mdbook
3832 [ubook]: https://doc.rust-lang.org/unstable-book/
3833
3834
3835 Version 1.16.0 (2017-03-16)
3836 ===========================
3837
3838 Language
3839 --------
3840
3841 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3842 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3843   match patterns][38069]
3844 * [Clean up semantics of `self` in an import list][38313]
3845 * [`Self` may appear in `impl` headers][38920]
3846 * [`Self` may appear in struct expressions][39282]
3847
3848 Compiler
3849 --------
3850
3851 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
3852   a `.rmeta` file containing only crate metadata][38571]. This can be
3853   used by tools like the Rust Language Service to perform
3854   metadata-only builds.
3855 * [Levenshtein based typo suggestions now work in most places, while
3856   previously they worked only for fields and sometimes for local
3857   variables][38927]. Together with the overhaul of "no
3858   resolution"/"unexpected resolution" errors (#[38154]) they result in
3859   large and systematic improvement in resolution diagnostics.
3860 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
3861   `U`][38670]
3862 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
3863 * [`rustc` no longer attempts to provide "consider using an explicit
3864   lifetime" suggestions][37057]. They were inaccurate.
3865
3866 Stabilized APIs
3867 ---------------
3868
3869 * [`VecDeque::truncate`]
3870 * [`VecDeque::resize`]
3871 * [`String::insert_str`]
3872 * [`Duration::checked_add`]
3873 * [`Duration::checked_sub`]
3874 * [`Duration::checked_div`]
3875 * [`Duration::checked_mul`]
3876 * [`str::replacen`]
3877 * [`str::repeat`]
3878 * [`SocketAddr::is_ipv4`]
3879 * [`SocketAddr::is_ipv6`]
3880 * [`IpAddr::is_ipv4`]
3881 * [`IpAddr::is_ipv6`]
3882 * [`Vec::dedup_by`]
3883 * [`Vec::dedup_by_key`]
3884 * [`Result::unwrap_or_default`]
3885 * [`<*const T>::wrapping_offset`]
3886 * [`<*mut T>::wrapping_offset`]
3887 * `CommandExt::creation_flags`
3888 * [`File::set_permissions`]
3889 * [`String::split_off`]
3890
3891 Libraries
3892 ---------
3893
3894 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
3895   their argument by `Borrow` parameter][37761]
3896 * [All public types in std implement `Debug`][38006]
3897 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
3898 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
3899 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3900   Windows][38274]
3901 * [std: Fix partial writes in `LineWriter`][38062]
3902 * [std: Clamp max read/write sizes on Unix][38062]
3903 * [Use more specific panic message for `&str` slicing errors][38066]
3904 * [`TcpListener::set_only_v6` is deprecated][38304]. This
3905   functionality cannot be achieved in std currently.
3906 * [`writeln!`, like `println!`, now accepts a form with no string
3907   or formatting arguments, to just print a newline][38469]
3908 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
3909 * [Reduce the size of static data in `std_unicode::tables`][38781]
3910 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
3911   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
3912   `Display`][38909]
3913 * [`Duration` implements `Sum`][38712]
3914 * [`String` implements `ToSocketAddrs`][39048]
3915
3916 Cargo
3917 -----
3918
3919 * [The `cargo check` command does a type check of a project without
3920   building it][cargo/3296]
3921 * [crates.io will display CI badges from Travis and AppVeyor, if
3922   specified in Cargo.toml][cargo/3546]
3923 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
3924 * [Compilation profiles accept integer values for `debug`, in addition
3925   to `true` and `false`. These are passed to `rustc` as the value to
3926   `-C debuginfo`][cargo/3534]
3927 * [Implement `cargo --version --verbose`][cargo/3604]
3928 * [All builds now output 'dep-info' build dependencies compatible with
3929   make and ninja][cargo/3557]
3930 * [Build all workspace members with `build --all`][cargo/3511]
3931 * [Document all workspace members with `doc --all`][cargo/3515]
3932 * [Path deps outside workspace are not members][cargo/3443]
3933
3934 Misc
3935 ----
3936
3937 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
3938   the path to the Rust implementation][38589]
3939 * [The `armv7-linux-androideabi` target no longer enables NEON
3940   extensions, per Google's ABI guide][38413]
3941 * [The stock standard library can be compiled for Redox OS][38401]
3942 * [Rust has initial SPARC support][38726]. Tier 3. No builds
3943   available.
3944 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
3945   builds available.
3946 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
3947
3948 Compatibility Notes
3949 -------------------
3950
3951 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3952   match patterns][38069]
3953 * In this release, references to uninhabited types can not be
3954   pattern-matched. This was accidentally allowed in 1.15.
3955 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3956 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3957   Windows][38274]
3958 * [Clean up semantics of `self` in an import list][38313]
3959 * Reimplemented lifetime elision. This change was almost entirely compatible
3960   with existing code, but it did close a number of small bugs and loopholes,
3961   as well as being more accepting in some other [cases][41105].
3962
3963 [37057]: https://github.com/rust-lang/rust/pull/37057
3964 [37761]: https://github.com/rust-lang/rust/pull/37761
3965 [38006]: https://github.com/rust-lang/rust/pull/38006
3966 [38051]: https://github.com/rust-lang/rust/pull/38051
3967 [38062]: https://github.com/rust-lang/rust/pull/38062
3968 [38062]: https://github.com/rust-lang/rust/pull/38622
3969 [38066]: https://github.com/rust-lang/rust/pull/38066
3970 [38069]: https://github.com/rust-lang/rust/pull/38069
3971 [38131]: https://github.com/rust-lang/rust/pull/38131
3972 [38154]: https://github.com/rust-lang/rust/pull/38154
3973 [38274]: https://github.com/rust-lang/rust/pull/38274
3974 [38304]: https://github.com/rust-lang/rust/pull/38304
3975 [38313]: https://github.com/rust-lang/rust/pull/38313
3976 [38314]: https://github.com/rust-lang/rust/pull/38314
3977 [38327]: https://github.com/rust-lang/rust/pull/38327
3978 [38401]: https://github.com/rust-lang/rust/pull/38401
3979 [38413]: https://github.com/rust-lang/rust/pull/38413
3980 [38469]: https://github.com/rust-lang/rust/pull/38469
3981 [38559]: https://github.com/rust-lang/rust/pull/38559
3982 [38571]: https://github.com/rust-lang/rust/pull/38571
3983 [38580]: https://github.com/rust-lang/rust/pull/38580
3984 [38589]: https://github.com/rust-lang/rust/pull/38589
3985 [38670]: https://github.com/rust-lang/rust/pull/38670
3986 [38712]: https://github.com/rust-lang/rust/pull/38712
3987 [38726]: https://github.com/rust-lang/rust/pull/38726
3988 [38781]: https://github.com/rust-lang/rust/pull/38781
3989 [38798]: https://github.com/rust-lang/rust/pull/38798
3990 [38909]: https://github.com/rust-lang/rust/pull/38909
3991 [38920]: https://github.com/rust-lang/rust/pull/38920
3992 [38927]: https://github.com/rust-lang/rust/pull/38927
3993 [39048]: https://github.com/rust-lang/rust/pull/39048
3994 [39282]: https://github.com/rust-lang/rust/pull/39282
3995 [39379]: https://github.com/rust-lang/rust/pull/39379
3996 [41105]: https://github.com/rust-lang/rust/issues/41105
3997 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
3998 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
3999 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
4000 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
4001 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
4002 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
4003 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
4004 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
4005 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
4006 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
4007 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
4008 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
4009 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
4010 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
4011 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
4012 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
4013 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
4014 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
4015 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
4016 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
4017 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
4018 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
4019 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
4020 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
4021 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
4022 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
4023 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
4024 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
4025 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
4026 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4027
4028
4029 Version 1.15.1 (2017-02-09)
4030 ===========================
4031
4032 * [Fix IntoIter::as_mut_slice's signature][39466]
4033 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
4034
4035 [39466]: https://github.com/rust-lang/rust/pull/39466
4036 [39523]: https://github.com/rust-lang/rust/pull/39523
4037
4038
4039 Version 1.15.0 (2017-02-02)
4040 ===========================
4041
4042 Language
4043 --------
4044
4045 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
4046   stable. This allows popular code-generating crates like Serde and Diesel to
4047   work ergonomically. [RFC 1681].
4048 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
4049   with curly braces][36868]. Part of [RFC 1506].
4050 * [A number of minor changes to name resolution have been activated][37127].
4051   They add up to more consistent semantics, allowing for future evolution of
4052   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4053   details of what is different. The breaking changes here have been transitioned
4054   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4055 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
4056   bounds][38279]
4057 * [`?Sized` can be used in `where` clauses][37791]
4058 * [There is now a limit on the size of monomorphized types and it can be
4059   modified with the `#![type_size_limit]` crate attribute, similarly to
4060   the `#![recursion_limit]` attribute][37789]
4061
4062 Compiler
4063 --------
4064
4065 * [On Windows, the compiler will apply dllimport attributes when linking to
4066   extern functions][37973]. Additional attributes and flags can control which
4067   library kind is linked and its name. [RFC 1717].
4068 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4069 * [The `--test` flag works with procedural macro crates][38107]
4070 * [Fix `extern "aapcs" fn` ABI][37814]
4071 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
4072 * [The `format!` expander recognizes incorrect `printf` and shell-style
4073   formatting directives and suggests the correct format][37613].
4074 * [Only report one error for all unused imports in an import list][37456]
4075
4076 Compiler Performance
4077 --------------------
4078
4079 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
4080 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
4081 * [Don't clone in `UnificationTable::probe`][37848]
4082 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
4083 * [Use small vectors in type walker][37760]
4084 * [Macro expansion performance was improved][37701]
4085 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
4086 * [Replace FNV with a faster hash function][37229]
4087
4088 Stabilized APIs
4089 ---------------
4090
4091 * [`std::iter::Iterator::min_by`]
4092 * [`std::iter::Iterator::max_by`]
4093 * [`std::os::*::fs::FileExt`]
4094 * [`std::sync::atomic::Atomic*::get_mut`]
4095 * [`std::sync::atomic::Atomic*::into_inner`]
4096 * [`std::vec::IntoIter::as_slice`]
4097 * [`std::vec::IntoIter::as_mut_slice`]
4098 * [`std::sync::mpsc::Receiver::try_iter`]
4099 * [`std::os::unix::process::CommandExt::before_exec`]
4100 * [`std::rc::Rc::strong_count`]
4101 * [`std::rc::Rc::weak_count`]
4102 * [`std::sync::Arc::strong_count`]
4103 * [`std::sync::Arc::weak_count`]
4104 * [`std::char::encode_utf8`]
4105 * [`std::char::encode_utf16`]
4106 * [`std::cell::Ref::clone`]
4107 * [`std::io::Take::into_inner`]
4108
4109 Libraries
4110 ---------
4111
4112 * [The standard sorting algorithm has been rewritten for dramatic performance
4113   improvements][38192]. It is a hybrid merge sort, drawing influences from
4114   Timsort. Previously it was a naive merge sort.
4115 * [`Iterator::nth` no longer has a `Sized` bound][38134]
4116 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
4117   performance.
4118 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
4119   and `char_indices().last()`][37882]
4120 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
4121 * [Chinese characters display correctly in `fmt::Debug`][37855]
4122 * [Derive `Default` for `Duration`][37699]
4123 * [Support creation of anonymous pipes on WinXP/2k][37677]
4124 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
4125 * [Don't pass overlapped handles to processes][38835]
4126
4127 Cargo
4128 -----
4129
4130 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4131   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4132   should instead check the variable at runtime with `std::env`. That the value
4133   was set at build time was a bug, and incorrect when cross-compiling. This
4134   change is known to cause breakage.
4135 * [Add `--all` flag to `cargo test`][cargo/3221]
4136 * [Compile statically against the MSVC CRT][cargo/3363]
4137 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
4138 * [Link OpenSSL statically on OSX][cargo/3311]
4139 * [Apply new fingerprinting to build dir outputs][cargo/3310]
4140 * [Test for bad path overrides with summaries][cargo/3336]
4141 * [Require `cargo install --vers` to take a semver version][cargo/3338]
4142 * [Fix retrying crate downloads for network errors][cargo/3348]
4143 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
4144 * [Emit more info on --message-format=json][cargo/3319]
4145 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
4146 * [Don't ignore errors in workspace manifest][cargo/3409]
4147 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
4148
4149 Tooling
4150 -------
4151
4152 * [Test runners (binaries built with `--test`) now support a `--list` argument
4153   that lists the tests it contains][38185]
4154 * [Test runners now support a `--exact` argument that makes the test filter
4155   match exactly, instead of matching only a substring of the test name][38181]
4156 * [rustdoc supports a `--playground-url` flag][37763]
4157 * [rustdoc provides more details about `#[should_panic]` errors][37749]
4158
4159 Misc
4160 ----
4161
4162 * [The Rust build system is now written in Rust][37817]. The Makefiles may
4163   continue to be used in this release by passing `--disable-rustbuild` to the
4164   configure script, but they will be deleted soon. Note that the new build
4165   system uses a different on-disk layout that will likely affect any scripts
4166   building Rust.
4167 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
4168   releases.
4169 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
4170 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
4171   releases.
4172
4173 Compatibility Notes
4174 -------------------
4175
4176 * [A number of minor changes to name resolution have been activated][37127].
4177   They add up to more consistent semantics, allowing for future evolution of
4178   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4179   details of what is different. The breaking changes here have been transitioned
4180   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4181 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4182   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4183   should instead check the variable at runtime with `std::env`. That the value
4184   was set at build time was a bug, and incorrect when cross-compiling. This
4185   change is known to cause breakage.
4186 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
4187   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
4188   1.10 and is now an error by default. It will become a hard error in the near
4189   future.
4190 * [The semantics relating modules to file system directories are changing in
4191   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
4192   lint, which is a warning in this release, and will become a hard error in the
4193   future.
4194 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4195 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
4196   the underlying iterator][37834]
4197
4198 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
4199 [33685]: https://github.com/rust-lang/rust/issues/33685
4200 [36868]: https://github.com/rust-lang/rust/pull/36868
4201 [37127]: https://github.com/rust-lang/rust/pull/37127
4202 [37229]: https://github.com/rust-lang/rust/pull/37229
4203 [37456]: https://github.com/rust-lang/rust/pull/37456
4204 [37527]: https://github.com/rust-lang/rust/pull/37527
4205 [37602]: https://github.com/rust-lang/rust/pull/37602
4206 [37613]: https://github.com/rust-lang/rust/pull/37613
4207 [37615]: https://github.com/rust-lang/rust/pull/37615
4208 [37636]: https://github.com/rust-lang/rust/pull/37636
4209 [37627]: https://github.com/rust-lang/rust/pull/37627
4210 [37642]: https://github.com/rust-lang/rust/pull/37642
4211 [37677]: https://github.com/rust-lang/rust/pull/37677
4212 [37699]: https://github.com/rust-lang/rust/pull/37699
4213 [37701]: https://github.com/rust-lang/rust/pull/37701
4214 [37705]: https://github.com/rust-lang/rust/pull/37705
4215 [37749]: https://github.com/rust-lang/rust/pull/37749
4216 [37760]: https://github.com/rust-lang/rust/pull/37760
4217 [37763]: https://github.com/rust-lang/rust/pull/37763
4218 [37764]: https://github.com/rust-lang/rust/pull/37764
4219 [37789]: https://github.com/rust-lang/rust/pull/37789
4220 [37791]: https://github.com/rust-lang/rust/pull/37791
4221 [37814]: https://github.com/rust-lang/rust/pull/37814
4222 [37817]: https://github.com/rust-lang/rust/pull/37817
4223 [37834]: https://github.com/rust-lang/rust/pull/37834
4224 [37848]: https://github.com/rust-lang/rust/pull/37848
4225 [37855]: https://github.com/rust-lang/rust/pull/37855
4226 [37882]: https://github.com/rust-lang/rust/pull/37882
4227 [37888]: https://github.com/rust-lang/rust/pull/37888
4228 [37973]: https://github.com/rust-lang/rust/pull/37973
4229 [37979]: https://github.com/rust-lang/rust/pull/37979
4230 [38086]: https://github.com/rust-lang/rust/pull/38086
4231 [38107]: https://github.com/rust-lang/rust/pull/38107
4232 [38117]: https://github.com/rust-lang/rust/pull/38117
4233 [38134]: https://github.com/rust-lang/rust/pull/38134
4234 [38146]: https://github.com/rust-lang/rust/pull/38146
4235 [38181]: https://github.com/rust-lang/rust/pull/38181
4236 [38182]: https://github.com/rust-lang/rust/pull/38182
4237 [38185]: https://github.com/rust-lang/rust/pull/38185
4238 [38192]: https://github.com/rust-lang/rust/pull/38192
4239 [38279]: https://github.com/rust-lang/rust/pull/38279
4240 [38835]: https://github.com/rust-lang/rust/pull/38835
4241 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4242 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4243 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
4244 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
4245 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
4246 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
4247 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
4248 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
4249 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
4250 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
4251 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
4252 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
4253 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
4254 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
4255 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
4256 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
4257 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
4258 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
4259 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
4260 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
4261 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
4262 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
4263 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
4264 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
4265 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
4266 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
4267 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
4268 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
4269 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
4270 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
4271 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
4272 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
4273 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
4274 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
4275 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
4276 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
4277 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
4278 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
4279
4280
4281 Version 1.14.0 (2016-12-22)
4282 ===========================
4283
4284 Language
4285 --------
4286
4287 * [`..` matches multiple tuple fields in enum variants, structs
4288   and tuples][36843]. [RFC 1492].
4289 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
4290 * [`use *` and `use ::*` both glob-import from the crate root][37367]
4291 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
4292   dereferencing][36822]
4293
4294 Compiler
4295 --------
4296
4297 * [Mark enums with non-zero discriminant as non-zero][37224]
4298 * [Lower-case `static mut` names are linted like other
4299   statics and consts][37162]
4300 * [Fix ICE on some macros in const integer positions
4301    (e.g. `[u8; m!()]`)][36819]
4302 * [Improve error message and snippet for "did you mean `x`"][36798]
4303 * [Add a panic-strategy field to the target specification][36794]
4304 * [Include LLVM version in `--version --verbose`][37200]
4305
4306 Compile-time Optimizations
4307 --------------------------
4308
4309 * [Improve macro expansion performance][37569]
4310 * [Shrink `Expr_::ExprInlineAsm`][37445]
4311 * [Replace all uses of SHA-256 with BLAKE2b][37439]
4312 * [Reduce the number of bytes hashed by `IchHasher`][37427]
4313 * [Avoid more allocations when compiling html5ever][37373]
4314 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
4315 * [Avoid some allocations in the macro parser][37318]
4316 * [Use a faster deflate setting][37298]
4317 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
4318   during interning of slices][37270]
4319 * [Optimize `write_metadata`][37267]
4320 * [Don't process obligation forest cycles when stalled][37231]
4321 * [Avoid many `CrateConfig` clones][37161]
4322 * [Optimize `Substs::super_fold_with`][37108]
4323 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
4324 * [Speed up `plug_leaks`][36917]
4325
4326 Libraries
4327 ---------
4328
4329 * [`println!()`, with no arguments, prints newline][36825].
4330   Previously, an empty string was required to achieve the same.
4331 * [`Wrapping` impls standard binary and unary operators, as well as
4332    the `Sum` and `Product` iterators][37356]
4333 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
4334   Vec<T>`][37326]
4335 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
4336   `VecDeque` iterators][37315]
4337 * [Improve `SipHasher` performance on small values][37312]
4338 * [Add Iterator trait TrustedLen to enable better FromIterator /
4339   Extend][37306]
4340 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
4341 * [`ReadDir` implements `Debug`][37221]
4342 * [Implement `RefUnwindSafe` for atomic types][37178]
4343 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
4344 * [Avoid allocations in `Decoder::read_str`][37064]
4345 * [`io::Error` implements `From<io::ErrorKind>`][37037]
4346 * [Impl `Debug` for raw pointers to unsized data][36880]
4347 * [Don't reuse `HashMap` random seeds][37470]
4348 * [The internal memory layout of `HashMap` is more cache-friendly, for
4349   significant improvements in some operations][36692]
4350 * [`HashMap` uses less memory on 32-bit architectures][36595]
4351 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
4352
4353 Cargo
4354 -----
4355
4356 * [Expose rustc cfg values to build scripts][cargo/3243]
4357 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
4358 * [Fix passing --features when testing multiple packages][cargo/3280]
4359 * [Use a single profile set per workspace][cargo/3249]
4360 * [Load `replace` sections from lock files][cargo/3220]
4361 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
4362
4363 Tooling
4364 -------
4365
4366 * [rustup is the recommended Rust installation method][1.14rustup]
4367 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
4368   S390x. These are [tier 2] platforms and may have major defects. Follow the
4369   instructions on the website to install, or add the targets to an existing
4370   installation with `rustup target add`. The new target triples are:
4371   - `mips-unknown-linux-gnu`
4372   - `mipsel-unknown-linux-gnu`
4373   - `mips64-unknown-linux-gnuabi64`
4374   - `mips64el-unknown-linux-gnuabi64 `
4375   - `powerpc-unknown-linux-gnu`
4376   - `powerpc64-unknown-linux-gnu`
4377   - `powerpc64le-unknown-linux-gnu`
4378   - `s390x-unknown-linux-gnu `
4379 * This release includes target (std) builds for ARM Linux running MUSL
4380   libc. These are [tier 2] platforms and may have major defects. Add the
4381   following triples to an existing rustup installation with `rustup target add`:
4382   - `arm-unknown-linux-musleabi`
4383   - `arm-unknown-linux-musleabihf`
4384   - `armv7-unknown-linux-musleabihf`
4385 * This release includes [experimental support for WebAssembly][1.14wasm], via
4386   the `wasm32-unknown-emscripten` target. This target is known to have major
4387   defects. Please test, report, and fix.
4388 * rustup no longer installs documentation by default. Run `rustup
4389   component add rust-docs` to install.
4390 * [Fix line stepping in debugger][37310]
4391 * [Enable line number debuginfo in releases][37280]
4392
4393 Misc
4394 ----
4395
4396 * [Disable jemalloc on aarch64/powerpc/mips][37392]
4397 * [Add support for Fuchsia OS][37313]
4398 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
4399
4400 Compatibility Notes
4401 -------------------
4402
4403 * [A number of forward-compatibility lints used by the compiler
4404   to gradually introduce language changes have been converted
4405   to deny by default][36894]:
4406   - ["use of inaccessible extern crate erroneously allowed"][36886]
4407   - ["type parameter default erroneously allowed in invalid location"][36887]
4408   - ["detects super or self keywords at the beginning of global path"][36888]
4409   - ["two overlapping inherent impls define an item with the same name
4410     were erroneously allowed"][36889]
4411   - ["floating-point constants cannot be used in patterns"][36890]
4412   - ["constants of struct or enum type can only be used in a pattern if
4413      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
4414   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
4415 * [Prohibit patterns in trait methods without bodies][37378]
4416 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
4417 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
4418 * [The `$crate` macro variable is accepted in fewer locations][37213]
4419 * [Impls specifying extra region requirements beyond the trait
4420   they implement are rejected][37167]
4421 * [Enums may not be unsized][37111]. Unsized enums are intended to
4422   work but never have. For now they are forbidden.
4423 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
4424
4425 [tier 2]: https://forge.rust-lang.org/platform-support.html
4426 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
4427 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
4428 [36430]: https://github.com/rust-lang/rust/pull/36430
4429 [36595]: https://github.com/rust-lang/rust/pull/36595
4430 [36595]: https://github.com/rust-lang/rust/pull/36595
4431 [36692]: https://github.com/rust-lang/rust/pull/36692
4432 [36767]: https://github.com/rust-lang/rust/pull/36767
4433 [36794]: https://github.com/rust-lang/rust/pull/36794
4434 [36798]: https://github.com/rust-lang/rust/pull/36798
4435 [36819]: https://github.com/rust-lang/rust/pull/36819
4436 [36822]: https://github.com/rust-lang/rust/pull/36822
4437 [36825]: https://github.com/rust-lang/rust/pull/36825
4438 [36843]: https://github.com/rust-lang/rust/pull/36843
4439 [36880]: https://github.com/rust-lang/rust/pull/36880
4440 [36886]: https://github.com/rust-lang/rust/issues/36886
4441 [36887]: https://github.com/rust-lang/rust/issues/36887
4442 [36888]: https://github.com/rust-lang/rust/issues/36888
4443 [36889]: https://github.com/rust-lang/rust/issues/36889
4444 [36890]: https://github.com/rust-lang/rust/issues/36890
4445 [36891]: https://github.com/rust-lang/rust/issues/36891
4446 [36892]: https://github.com/rust-lang/rust/issues/36892
4447 [36894]: https://github.com/rust-lang/rust/pull/36894
4448 [36917]: https://github.com/rust-lang/rust/pull/36917
4449 [36993]: https://github.com/rust-lang/rust/pull/36993
4450 [37037]: https://github.com/rust-lang/rust/pull/37037
4451 [37064]: https://github.com/rust-lang/rust/pull/37064
4452 [37094]: https://github.com/rust-lang/rust/pull/37094
4453 [37108]: https://github.com/rust-lang/rust/pull/37108
4454 [37111]: https://github.com/rust-lang/rust/pull/37111
4455 [37161]: https://github.com/rust-lang/rust/pull/37161
4456 [37162]: https://github.com/rust-lang/rust/pull/37162
4457 [37167]: https://github.com/rust-lang/rust/pull/37167
4458 [37178]: https://github.com/rust-lang/rust/pull/37178
4459 [37200]: https://github.com/rust-lang/rust/pull/37200
4460 [37213]: https://github.com/rust-lang/rust/pull/37213
4461 [37221]: https://github.com/rust-lang/rust/pull/37221
4462 [37224]: https://github.com/rust-lang/rust/pull/37224
4463 [37230]: https://github.com/rust-lang/rust/pull/37230
4464 [37231]: https://github.com/rust-lang/rust/pull/37231
4465 [37247]: https://github.com/rust-lang/rust/pull/37247
4466 [37267]: https://github.com/rust-lang/rust/pull/37267
4467 [37270]: https://github.com/rust-lang/rust/pull/37270
4468 [37273]: https://github.com/rust-lang/rust/pull/37273
4469 [37280]: https://github.com/rust-lang/rust/pull/37280
4470 [37298]: https://github.com/rust-lang/rust/pull/37298
4471 [37306]: https://github.com/rust-lang/rust/pull/37306
4472 [37310]: https://github.com/rust-lang/rust/pull/37310
4473 [37312]: https://github.com/rust-lang/rust/pull/37312
4474 [37313]: https://github.com/rust-lang/rust/pull/37313
4475 [37315]: https://github.com/rust-lang/rust/pull/37315
4476 [37318]: https://github.com/rust-lang/rust/pull/37318
4477 [37322]: https://github.com/rust-lang/rust/pull/37322
4478 [37326]: https://github.com/rust-lang/rust/pull/37326
4479 [37351]: https://github.com/rust-lang/rust/pull/37351
4480 [37356]: https://github.com/rust-lang/rust/pull/37356
4481 [37367]: https://github.com/rust-lang/rust/pull/37367
4482 [37373]: https://github.com/rust-lang/rust/pull/37373
4483 [37378]: https://github.com/rust-lang/rust/pull/37378
4484 [37389]: https://github.com/rust-lang/rust/pull/37389
4485 [37392]: https://github.com/rust-lang/rust/pull/37392
4486 [37427]: https://github.com/rust-lang/rust/pull/37427
4487 [37439]: https://github.com/rust-lang/rust/pull/37439
4488 [37445]: https://github.com/rust-lang/rust/pull/37445
4489 [37470]: https://github.com/rust-lang/rust/pull/37470
4490 [37569]: https://github.com/rust-lang/rust/pull/37569
4491 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4492 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
4493 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
4494 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
4495 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
4496 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
4497 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
4498
4499
4500 Version 1.13.0 (2016-11-10)
4501 ===========================
4502
4503 Language
4504 --------
4505
4506 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
4507   errors, like the `try!` macro, described in [RFC 0243].
4508 * [Stabilize macros in type position][36014]. Described in [RFC 873].
4509 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
4510 * [Fix `#[derive]` for empty tuple structs/variants][35728]
4511 * [Fix lifetime rules for 'if' conditions][36029]
4512 * [Avoid loading and parsing unconfigured non-inline modules][36482]
4513
4514 Compiler
4515 --------
4516
4517 * [Add the `-C link-arg` argument][36574]
4518 * [Remove the old AST-based backend from rustc_trans][35764]
4519 * [Don't enable NEON by default on armv7 Linux][35814]
4520 * [Fix debug line number info for macro expansions][35238]
4521 * [Do not emit "class method" debuginfo for types that are not
4522   DICompositeType][36008]
4523 * [Warn about multiple conflicting #[repr] hints][34623]
4524 * [When sizing DST, don't double-count nested struct prefixes][36351]
4525 * [Default RUST_MIN_STACK to 16MiB for now][36505]
4526 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
4527 * [Reject macros with empty repetitions to avoid infinite loop][36721]
4528 * [Expand macros without recursing to avoid stack overflows][36214]
4529
4530 Diagnostics
4531 -----------
4532
4533 * [Replace macro backtraces with labeled local uses][35702]
4534 * [Improve error message for misplaced doc comments][33922]
4535 * [Buffer unix and lock windows to prevent message interleaving][35975]
4536 * [Update lifetime errors to specifically note temporaries][36171]
4537 * [Special case a few colors for Windows][36178]
4538 * [Suggest `use self` when such an import resolves][36289]
4539 * [Be more specific when type parameter shadows primitive type][36338]
4540 * Many minor improvements
4541
4542 Compile-time Optimizations
4543 --------------------------
4544
4545 * [Compute and cache HIR hashes at beginning][35854]
4546 * [Don't hash types in loan paths][36004]
4547 * [Cache projections in trans][35761]
4548 * [Optimize the parser's last token handling][36527]
4549 * [Only instantiate #[inline] functions in codegen units referencing
4550   them][36524]. This leads to big improvements in cases where crates export
4551   define many inline functions without using them directly.
4552 * [Lazily allocate TypedArena's first chunk][36592]
4553 * [Don't allocate during default HashSet creation][36734]
4554
4555 Stabilized APIs
4556 ---------------
4557
4558 * [`checked_abs`]
4559 * [`wrapping_abs`]
4560 * [`overflowing_abs`]
4561 * [`RefCell::try_borrow`]
4562 * [`RefCell::try_borrow_mut`]
4563
4564 Libraries
4565 ---------
4566
4567 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
4568 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
4569   covariant][35354]
4570 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
4571 * [Implement `Debug` for `std::vec::IntoIter`][35707]
4572 * [`CString`: avoid excessive growth just to 0-terminate][35871]
4573 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
4574 * [Use arc4rand on FreeBSD][35884]
4575 * [memrchr: Correct aligned offset computation][35969]
4576 * [Improve Demangling of Rust Symbols][36059]
4577 * [Use monotonic time in condition variables][35048]
4578 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
4579 * [Implement conversion traits for `char`][35755]
4580 * [Fix illegal instruction caused by overflow in channel cloning][36104]
4581 * [Zero first byte of CString on drop][36264]
4582 * [Inherit overflow checks for sum and product][36372]
4583 * [Add missing Eq implementations][36423]
4584 * [Implement `Debug` for `DirEntry`][36631]
4585 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
4586   `errno`][36754]
4587 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4588 * [Implement more traits for `std::io::ErrorKind`][35911]
4589 * [Optimize BinaryHeap bounds checking][36072]
4590 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
4591   `extend_with_element`][36355]
4592 * [Fix overflow checking in unsigned pow()][34942]
4593
4594 Cargo
4595 -----
4596
4597 * This release includes security fixes to both curl and OpenSSL.
4598 * [Fix transitive doctests when panic=abort][cargo/3021]
4599 * [Add --all-features flag to cargo][cargo/3038]
4600 * [Reject path-based dependencies in `cargo package`][cargo/3060]
4601 * [Don't parse the home directory more than once][cargo/3078]
4602 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
4603 * [Update OpenSSL to 1.0.2j][cargo/3121]
4604 * [Add license and license_file to cargo metadata output][cargo/3110]
4605 * [Make crates-io registry URL optional in config; ignore all changes to
4606   source.crates-io][cargo/3089]
4607 * [Don't download dependencies from other platforms][cargo/3123]
4608 * [Build transitive dev-dependencies when needed][cargo/3125]
4609 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
4610 * [Avoid updating registry when adding existing deps][cargo/3144]
4611 * [Warn about path overrides that won't work][cargo/3136]
4612 * [Use workspaces during `cargo install`][cargo/3146]
4613 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
4614 * [Add --message-format flag][cargo/3000]
4615 * [Pass target environment for rustdoc][cargo/3205]
4616 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
4617 * [Update curl and curl-sys][cargo/3241]
4618 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
4619
4620 Tooling
4621 -------
4622
4623 * [rustdoc: Add the `--sysroot` argument][36586]
4624 * [rustdoc: Fix a couple of issues with the search results][35655]
4625 * [rustdoc: remove the `!` from macro URLs and titles][35234]
4626 * [gdb: Fix pretty-printing special-cased Rust types][35585]
4627 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
4628
4629 Misc
4630 ----
4631
4632 * [Remove unmaintained style guide][35124]
4633 * [Add s390x support][36369]
4634 * [Initial work at Haiku OS support][36727]
4635 * [Add mips-uclibc targets][35734]
4636 * [Crate-ify compiler-rt into compiler-builtins][35021]
4637 * [Add rustc version info (git hash + date) to dist tarball][36213]
4638 * Many documentation improvements
4639
4640 Compatibility Notes
4641 -------------------
4642
4643 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4644 * [Deny (by default) transmuting from fn item types to pointer-sized
4645   types][34923]. Continuing the long transition to zero-sized fn items,
4646   per [RFC 401].
4647 * [Fix `#[derive]` for empty tuple structs/variants][35728].
4648   Part of [RFC 1506].
4649 * [Issue deprecation warnings for safe accesses to extern statics][36173]
4650 * [Fix lifetime rules for 'if' conditions][36029].
4651 * [Inherit overflow checks for sum and product][36372].
4652 * [Forbid user-defined macros named "macro_rules"][36730].
4653
4654 [33922]: https://github.com/rust-lang/rust/pull/33922
4655 [34623]: https://github.com/rust-lang/rust/pull/34623
4656 [34923]: https://github.com/rust-lang/rust/pull/34923
4657 [34942]: https://github.com/rust-lang/rust/pull/34942
4658 [34982]: https://github.com/rust-lang/rust/pull/34982
4659 [35021]: https://github.com/rust-lang/rust/pull/35021
4660 [35048]: https://github.com/rust-lang/rust/pull/35048
4661 [35074]: https://github.com/rust-lang/rust/pull/35074
4662 [35124]: https://github.com/rust-lang/rust/pull/35124
4663 [35234]: https://github.com/rust-lang/rust/pull/35234
4664 [35238]: https://github.com/rust-lang/rust/pull/35238
4665 [35354]: https://github.com/rust-lang/rust/pull/35354
4666 [35559]: https://github.com/rust-lang/rust/pull/35559
4667 [35585]: https://github.com/rust-lang/rust/pull/35585
4668 [35627]: https://github.com/rust-lang/rust/pull/35627
4669 [35655]: https://github.com/rust-lang/rust/pull/35655
4670 [35702]: https://github.com/rust-lang/rust/pull/35702
4671 [35707]: https://github.com/rust-lang/rust/pull/35707
4672 [35728]: https://github.com/rust-lang/rust/pull/35728
4673 [35734]: https://github.com/rust-lang/rust/pull/35734
4674 [35755]: https://github.com/rust-lang/rust/pull/35755
4675 [35761]: https://github.com/rust-lang/rust/pull/35761
4676 [35764]: https://github.com/rust-lang/rust/pull/35764
4677 [35814]: https://github.com/rust-lang/rust/pull/35814
4678 [35854]: https://github.com/rust-lang/rust/pull/35854
4679 [35871]: https://github.com/rust-lang/rust/pull/35871
4680 [35884]: https://github.com/rust-lang/rust/pull/35884
4681 [35911]: https://github.com/rust-lang/rust/pull/35911
4682 [35969]: https://github.com/rust-lang/rust/pull/35969
4683 [35975]: https://github.com/rust-lang/rust/pull/35975
4684 [36004]: https://github.com/rust-lang/rust/pull/36004
4685 [36008]: https://github.com/rust-lang/rust/pull/36008
4686 [36014]: https://github.com/rust-lang/rust/pull/36014
4687 [36029]: https://github.com/rust-lang/rust/pull/36029
4688 [36059]: https://github.com/rust-lang/rust/pull/36059
4689 [36072]: https://github.com/rust-lang/rust/pull/36072
4690 [36101]: https://github.com/rust-lang/rust/pull/36101
4691 [36104]: https://github.com/rust-lang/rust/pull/36104
4692 [36171]: https://github.com/rust-lang/rust/pull/36171
4693 [36173]: https://github.com/rust-lang/rust/pull/36173
4694 [36178]: https://github.com/rust-lang/rust/pull/36178
4695 [36213]: https://github.com/rust-lang/rust/pull/36213
4696 [36214]: https://github.com/rust-lang/rust/pull/36214
4697 [36264]: https://github.com/rust-lang/rust/pull/36264
4698 [36266]: https://github.com/rust-lang/rust/pull/36266
4699 [36289]: https://github.com/rust-lang/rust/pull/36289
4700 [36338]: https://github.com/rust-lang/rust/pull/36338
4701 [36351]: https://github.com/rust-lang/rust/pull/36351
4702 [36355]: https://github.com/rust-lang/rust/pull/36355
4703 [36369]: https://github.com/rust-lang/rust/pull/36369
4704 [36372]: https://github.com/rust-lang/rust/pull/36372
4705 [36423]: https://github.com/rust-lang/rust/pull/36423
4706 [36482]: https://github.com/rust-lang/rust/pull/36482
4707 [36505]: https://github.com/rust-lang/rust/pull/36505
4708 [36524]: https://github.com/rust-lang/rust/pull/36524
4709 [36527]: https://github.com/rust-lang/rust/pull/36527
4710 [36551]: https://github.com/rust-lang/rust/pull/36551
4711 [36574]: https://github.com/rust-lang/rust/pull/36574
4712 [36586]: https://github.com/rust-lang/rust/pull/36586
4713 [36592]: https://github.com/rust-lang/rust/pull/36592
4714 [36631]: https://github.com/rust-lang/rust/pull/36631
4715 [36639]: https://github.com/rust-lang/rust/pull/36639
4716 [36721]: https://github.com/rust-lang/rust/pull/36721
4717 [36727]: https://github.com/rust-lang/rust/pull/36727
4718 [36730]: https://github.com/rust-lang/rust/pull/36730
4719 [36734]: https://github.com/rust-lang/rust/pull/36734
4720 [36754]: https://github.com/rust-lang/rust/pull/36754
4721 [36995]: https://github.com/rust-lang/rust/pull/36995
4722 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
4723 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
4724 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4725 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
4726 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
4727 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
4728 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
4729 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
4730 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
4731 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
4732 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
4733 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
4734 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
4735 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
4736 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
4737 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
4738 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
4739 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
4740 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
4741 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
4742 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
4743 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
4744 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
4745 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
4746 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
4747 [rustup]: https://www.rustup.rs
4748 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
4749 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
4750 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
4751 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
4752 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
4753 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
4754 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
4755
4756
4757 Version 1.12.1 (2016-10-20)
4758 ===========================
4759
4760 Regression Fixes
4761 ----------------
4762
4763 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
4764 * [Confusion with double negation and booleans][36856]
4765 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
4766 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
4767 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
4768 * [Corrupted memory after updated to 1.12][36936]
4769 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
4770 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
4771 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
4772
4773 [36381]: https://github.com/rust-lang/rust/issues/36381
4774 [36856]: https://github.com/rust-lang/rust/issues/36856
4775 [36875]: https://github.com/rust-lang/rust/issues/36875
4776 [36924]: https://github.com/rust-lang/rust/issues/36924
4777 [36926]: https://github.com/rust-lang/rust/issues/36926
4778 [36936]: https://github.com/rust-lang/rust/issues/36936
4779 [37026]: https://github.com/rust-lang/rust/issues/37026
4780 [37112]: https://github.com/rust-lang/rust/issues/37112
4781 [37153]: https://github.com/rust-lang/rust/issues/37153
4782
4783
4784 Version 1.12.0 (2016-09-29)
4785 ===========================
4786
4787 Highlights
4788 ----------
4789
4790 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4791   This translation pass is far simpler than the previous AST->LLVM pass, and
4792   creates opportunities to perform new optimizations directly on the MIR. It
4793   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4794 * [`rustc` presents a new, more readable error format, along with
4795   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
4796   Most common editors supporting Rust have been updated to work with it. It was
4797   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
4798
4799 Compiler
4800 --------
4801
4802 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4803   This translation pass is far simpler than the previous AST->LLVM pass, and
4804   creates opportunities to perform new optimizations directly on the MIR. It
4805   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4806 * [Print the Rust target name, not the LLVM target name, with
4807   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
4808 * [The computation of `TypeId` is correct in some cases where it was previously
4809   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
4810 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
4811 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
4812   `--print relocation-models`, and `--print code-models` print the available
4813   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
4814   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
4815 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
4816   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
4817   These targets produce statically-linked binaries. There are no binary release
4818   builds yet though.
4819
4820 Diagnostics
4821 -----------
4822
4823 * [`rustc` presents a new, more readable error format, along with
4824   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
4825   Most common editors supporting Rust have been updated to work with it. It was
4826   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
4827 * [In error descriptions, references are now described in plain English,
4828   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
4829 * [In error type descriptions, unknown numeric types are named `{integer}` or
4830   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
4831 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
4832
4833 Language
4834 --------
4835
4836 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
4837 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
4838 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
4839   useful](https://github.com/rust-lang/rust/pull/34908)
4840 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
4841   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
4842 * [Semicolons are properly required as statement delimiters inside
4843   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
4844 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
4845
4846 Stabilized APIs
4847 ---------------
4848
4849 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
4850 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
4851 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
4852 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
4853 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
4854 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
4855 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
4856 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
4857 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
4858 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
4859   Both on Unix and Windows.
4860 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
4861 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
4862 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
4863 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
4864 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
4865 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
4866 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
4867 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
4868
4869 Libraries
4870 ---------
4871
4872 * [The `format!` macro and friends now allow a single argument to be formatted
4873   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
4874 * [The lifetime bounds on `[T]::binary_search_by` and
4875   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
4876 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
4877 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
4878 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
4879 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
4880 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
4881 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
4882 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
4883 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
4884   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
4885 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
4886   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
4887 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
4888 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
4889   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
4890 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
4891 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
4892 * [`mpsc::sync_channel` `Receiver`s return any available message before
4893   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
4894 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
4895 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
4896
4897 Cargo
4898 -----
4899
4900 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
4901 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
4902 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
4903 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
4904 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
4905 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
4906 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
4907 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
4908 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
4909 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
4910 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
4911 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
4912 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
4913 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
4914 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
4915 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
4916
4917 Performance
4918 -----------
4919
4920 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
4921 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
4922
4923 Tooling
4924 -------
4925
4926 * [Test binaries now support a `--test-threads` argument to specify the number
4927   of threads used to run tests, and which acts the same as the
4928   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
4929 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
4930 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
4931 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
4932 * [Rust releases now come with source packages that can be installed by rustup
4933   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
4934   The resulting source code can be used by tools and IDES, located in the
4935   sysroot under `lib/rustlib/src`.
4936
4937 Misc
4938 ----
4939
4940 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
4941 * Many minor improvements to the documentation.
4942 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
4943
4944 Compatibility Notes
4945 -------------------
4946
4947 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
4948   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
4949 * [When formatting strings, if "precision" is specified, the "fill",
4950   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
4951 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
4952
4953
4954 Version 1.11.0 (2016-08-18)
4955 ===========================
4956
4957 Language
4958 --------
4959
4960 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
4961 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
4962 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
4963 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
4964
4965 Stabilized APIs
4966 ---------------
4967
4968 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
4969 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
4970 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
4971 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
4972 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
4973 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
4974   (in libcore - previously stabilized in libstd)
4975 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
4976   (in libcore - previously stabilized in libstd)
4977 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
4978   (in libcore - previously stabilized in libstd)
4979 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
4980   (in libcore - previously stabilized in libstd)
4981 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
4982 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
4983 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
4984 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
4985
4986 Libraries
4987 ---------
4988
4989 * [The `thread_local!` macro supports multiple definitions in a single
4990    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
4991 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
4992 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
4993   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
4994 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
4995 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
4996 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
4997 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
4998
4999 Cargo
5000 -----
5001
5002 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
5003 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
5004 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
5005 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
5006 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
5007   and `-vv` prints warnings for all crates.
5008 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
5009 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
5010   This provides room for expansion by arbitrary tools.
5011 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
5012 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
5013 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
5014 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
5015 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
5016 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
5017 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
5018
5019 Performance
5020 -----------
5021
5022 * [Caching projections speeds up type check dramatically for some
5023   workloads](https://github.com/rust-lang/rust/pull/33816)
5024 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
5025   This hasher is faster, but is believed to provide sufficient
5026   protection from collision attacks.
5027 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
5028
5029 Rustdoc
5030 -------
5031
5032 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
5033 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
5034 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
5035 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
5036 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
5037
5038 Tooling
5039 -------
5040
5041 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
5042 * [When emitting debug info, rustc emits frame pointers for closures,
5043   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
5044 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5045 * Many more errors have been given error codes and extended
5046   explanations
5047 * API documentation continues to be improved, with many new examples
5048
5049 Misc
5050 ----
5051
5052 * [rustc no longer hangs when dependencies recursively re-export
5053   submodules](https://github.com/rust-lang/rust/pull/34542)
5054 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
5055 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
5056   rewritten](https://github.com/rust-lang/rust/pull/33895)
5057 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
5058   No targets use this yet, but it works toward AVR support.
5059
5060 Compatibility Notes
5061 -------------------
5062
5063 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
5064 * [The new follow-set rules that place restrictions on `macro_rules!`
5065   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
5066   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
5067   and has been a warning since 1.10.
5068 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
5069   This causes breakage in some corner cases.
5070
5071
5072 Version 1.10.0 (2016-07-07)
5073 ===========================
5074
5075 Language
5076 --------
5077
5078 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
5079   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
5080 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
5081 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
5082 * [`panic!` can be converted to a runtime abort with the
5083   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
5084   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5085 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
5086   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
5087   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
5088   Note that Cargo does not yet directly support cdylibs.
5089
5090 Stabilized APIs
5091 ---------------
5092
5093 * `os::windows::fs::OpenOptionsExt::access_mode`
5094 * `os::windows::fs::OpenOptionsExt::share_mode`
5095 * `os::windows::fs::OpenOptionsExt::custom_flags`
5096 * `os::windows::fs::OpenOptionsExt::attributes`
5097 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
5098 * `os::unix::fs::OpenOptionsExt::custom_flags`
5099 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
5100 * `Default for sync::Weak`
5101 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
5102 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
5103 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
5104 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
5105 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
5106 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
5107 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
5108 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
5109 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
5110 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
5111 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
5112 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
5113 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
5114 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
5115 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
5116 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
5117 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
5118 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
5119 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
5120 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
5121 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
5122 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
5123 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
5124 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
5125 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
5126 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5127 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5128 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5129 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5130 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
5131 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
5132 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
5133 * Read/Write/RawFd impls for `UnixStream`
5134 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
5135 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
5136 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
5137 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
5138 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
5139 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
5140 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
5141 * RawFd impls for `UnixListener`
5142 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
5143 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
5144 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
5145 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
5146 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
5147 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
5148 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
5149 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
5150 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
5151 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
5152 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
5153 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
5154 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
5155 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
5156 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
5157 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
5158 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
5159 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
5160 * RawFd impls for `UnixDatagram`
5161 * `{BTree,Hash}Map::values_mut`
5162 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
5163
5164 Libraries
5165 ---------
5166
5167 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
5168   The semantics of this minor method are subtle and probably not what
5169   most people want.
5170 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
5171 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
5172   will fall back to `/dev/urandom` temporarily to avoid blocking
5173   during early boot](https://github.com/rust-lang/rust/pull/33086).
5174 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
5175 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
5176 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
5177 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
5178 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
5179 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
5180   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
5181
5182 Cargo
5183 -----
5184 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
5185   This controls the runtime behavior of the `panic!` macro
5186   and can be either "unwind" (the default), or "abort".
5187   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5188 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
5189 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
5190 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
5191   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
5192 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
5193 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
5194 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
5195   By default they are retried twice, which can be customized with the
5196   `net.retry` value in `.cargo/config`.
5197 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
5198 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
5199 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
5200 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
5201   Makes it possible to install multiple crates in parallel.
5202 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
5203 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
5204 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
5205 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
5206 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
5207 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
5208
5209 Performance
5210 -----------
5211
5212 * [rustc memory usage was reduced by refactoring the context used for
5213   type checking](https://github.com/rust-lang/rust/pull/33425).
5214 * [Speed up creation of `HashMap`s by caching the random keys used
5215   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
5216 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
5217 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
5218 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
5219   10x faster than the previous lookup tables.
5220 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
5221
5222 Usability
5223 ---------
5224
5225 * Many incremental improvements to documentation and rustdoc.
5226 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
5227 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
5228 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
5229 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
5230 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
5231 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
5232 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
5233
5234 Misc
5235 ----
5236
5237 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
5238 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
5239 * [`std` no longer prints backtraces on platforms where the running
5240   module must be loaded with `env::current_exe`, which can't be relied
5241   on](https://github.com/rust-lang/rust/pull/33554).
5242 * This release includes std binaries for the i586-unknown-linux-gnu,
5243   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
5244   i586 target is for old x86 hardware without SSE2, and the armv7
5245   target is for Android running on modern ARM architectures.
5246 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
5247   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
5248 * [On Unix the runtime aborts by calling `libc::abort` instead of
5249   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
5250 * [Rust is now bootstrapped from the previous release of Rust,
5251   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
5252
5253 Compatibility Notes
5254 -------------------
5255
5256 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
5257 * [`target_env` for Linux ARM targets is just `gnu`, not
5258   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
5259 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
5260 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
5261 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
5262   Affects how macros are parsed.
5263 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
5264 * [Feature-gated attributes on macro-generated macro invocations are
5265   now rejected](https://github.com/rust-lang/rust/pull/32791).
5266 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
5267   This caused some minor changes to type inference.
5268
5269
5270 Version 1.9.0 (2016-05-26)
5271 ==========================
5272
5273 Language
5274 --------
5275
5276 * The `#[deprecated]` attribute when applied to an API will generate
5277   warnings when used. The warnings may be suppressed with
5278   `#[allow(deprecated)]`. [RFC 1270].
5279 * [`fn` item types are zero sized, and each `fn` names a unique
5280   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5281   `transmute` on a `fn` type will generate a warning for a few cycles,
5282   then will be converted to an error.
5283 * [Field and method resolution understand visibility, so private
5284   fields and methods cannot prevent the proper use of public fields
5285   and methods][1.9fv].
5286 * [The parser considers unicode codepoints in the
5287   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
5288
5289 Stabilized APIs
5290 ---------------
5291
5292 * [`std::panic`]
5293 * [`std::panic::catch_unwind`] (renamed from `recover`)
5294 * [`std::panic::resume_unwind`] (renamed from `propagate`)
5295 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
5296 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
5297 * [`str::is_char_boundary`]
5298 * [`<*const T>::as_ref`]
5299 * [`<*mut T>::as_ref`]
5300 * [`<*mut T>::as_mut`]
5301 * [`AsciiExt::make_ascii_uppercase`]
5302 * [`AsciiExt::make_ascii_lowercase`]
5303 * [`char::decode_utf16`]
5304 * [`char::DecodeUtf16`]
5305 * [`char::DecodeUtf16Error`]
5306 * [`char::DecodeUtf16Error::unpaired_surrogate`]
5307 * [`BTreeSet::take`]
5308 * [`BTreeSet::replace`]
5309 * [`BTreeSet::get`]
5310 * [`HashSet::take`]
5311 * [`HashSet::replace`]
5312 * [`HashSet::get`]
5313 * [`OsString::with_capacity`]
5314 * [`OsString::clear`]
5315 * [`OsString::capacity`]
5316 * [`OsString::reserve`]
5317 * [`OsString::reserve_exact`]
5318 * [`OsStr::is_empty`]
5319 * [`OsStr::len`]
5320 * [`std::os::unix::thread`]
5321 * [`RawPthread`]
5322 * [`JoinHandleExt`]
5323 * [`JoinHandleExt::as_pthread_t`]
5324 * [`JoinHandleExt::into_pthread_t`]
5325 * [`HashSet::hasher`]
5326 * [`HashMap::hasher`]
5327 * [`CommandExt::exec`]
5328 * [`File::try_clone`]
5329 * [`SocketAddr::set_ip`]
5330 * [`SocketAddr::set_port`]
5331 * [`SocketAddrV4::set_ip`]
5332 * [`SocketAddrV4::set_port`]
5333 * [`SocketAddrV6::set_ip`]
5334 * [`SocketAddrV6::set_port`]
5335 * [`SocketAddrV6::set_flowinfo`]
5336 * [`SocketAddrV6::set_scope_id`]
5337 * [`slice::copy_from_slice`]
5338 * [`ptr::read_volatile`]
5339 * [`ptr::write_volatile`]
5340 * [`OpenOptions::create_new`]
5341 * [`TcpStream::set_nodelay`]
5342 * [`TcpStream::nodelay`]
5343 * [`TcpStream::set_ttl`]
5344 * [`TcpStream::ttl`]
5345 * [`TcpStream::set_only_v6`]
5346 * [`TcpStream::only_v6`]
5347 * [`TcpStream::take_error`]
5348 * [`TcpStream::set_nonblocking`]
5349 * [`TcpListener::set_ttl`]
5350 * [`TcpListener::ttl`]
5351 * [`TcpListener::set_only_v6`]
5352 * [`TcpListener::only_v6`]
5353 * [`TcpListener::take_error`]
5354 * [`TcpListener::set_nonblocking`]
5355 * [`UdpSocket::set_broadcast`]
5356 * [`UdpSocket::broadcast`]
5357 * [`UdpSocket::set_multicast_loop_v4`]
5358 * [`UdpSocket::multicast_loop_v4`]
5359 * [`UdpSocket::set_multicast_ttl_v4`]
5360 * [`UdpSocket::multicast_ttl_v4`]
5361 * [`UdpSocket::set_multicast_loop_v6`]
5362 * [`UdpSocket::multicast_loop_v6`]
5363 * [`UdpSocket::set_multicast_ttl_v6`]
5364 * [`UdpSocket::multicast_ttl_v6`]
5365 * [`UdpSocket::set_ttl`]
5366 * [`UdpSocket::ttl`]
5367 * [`UdpSocket::set_only_v6`]
5368 * [`UdpSocket::only_v6`]
5369 * [`UdpSocket::join_multicast_v4`]
5370 * [`UdpSocket::join_multicast_v6`]
5371 * [`UdpSocket::leave_multicast_v4`]
5372 * [`UdpSocket::leave_multicast_v6`]
5373 * [`UdpSocket::take_error`]
5374 * [`UdpSocket::connect`]
5375 * [`UdpSocket::send`]
5376 * [`UdpSocket::recv`]
5377 * [`UdpSocket::set_nonblocking`]
5378
5379 Libraries
5380 ---------
5381
5382 * [`std::sync::Once` is poisoned if its initialization function
5383   fails][1.9o].
5384 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
5385 * [Most types implement `fmt::Debug`][1.9db].
5386 * [The default buffer size used by `BufReader` and `BufWriter` was
5387   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
5388   used by other languages.
5389 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
5390   `Duration` additionally implements `*=` and `/=`][1.9ta].
5391 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
5392 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
5393 * [`Chain` implements `BufRead`][1.9ch].
5394 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
5395
5396 Cargo
5397 -----
5398
5399 * [Cargo can now run concurrently][1.9cc].
5400 * [Top-level overrides allow specific revisions of crates to be
5401   overridden through the entire crate graph][1.9ct].  This is intended
5402   to make upgrades easier for large projects, by allowing crates to be
5403   forked temporarily until they've been upgraded and republished.
5404 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
5405 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
5406   on the commandline][1.9cf]. `rustc` arguments can also be specified
5407   in the `build.rustflags` configuration key.
5408
5409 Performance
5410 -----------
5411
5412 * [The time complexity of comparing variables for equivalence during type
5413   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
5414   to major compilation time improvement in some scenarios.
5415 * [`ToString` is specialized for `str`, giving it the same performance
5416   as `to_owned`][1.9ts].
5417 * [Spawning processes with `Command::output` no longer creates extra
5418   threads][1.9sp].
5419 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
5420   for C-like enums][1.9cl].
5421
5422 Misc
5423 ----
5424
5425 * [Passing the `--quiet` flag to a test runner will produce
5426   much-abbreviated output][1.9q].
5427 * The Rust Project now publishes std binaries for the
5428   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
5429   `i586-pc-windows-msvc` targets.
5430
5431 Compatibility Notes
5432 -------------------
5433
5434 * [`std::sync::Once` is poisoned if its initialization function
5435   fails][1.9o].
5436 * [It is illegal to define methods with the same name in overlapping
5437   inherent `impl` blocks][1.9sn].
5438 * [`fn` item types are zero sized, and each `fn` names a unique
5439   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5440   `transmute` on a `fn` type will generate a warning for a few cycles,
5441   then will be converted to an error.
5442 * [Improvements to const evaluation may trigger new errors when integer
5443   literals are out of range][1.9ce].
5444
5445
5446 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
5447 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
5448 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
5449 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
5450 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
5451 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
5452 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
5453 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
5454 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
5455 [1.9db]: https://github.com/rust-lang/rust/pull/32054
5456 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
5457 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
5458 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
5459 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
5460 [1.9o]: https://github.com/rust-lang/rust/pull/32325
5461 [1.9q]: https://github.com/rust-lang/rust/pull/31887
5462 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
5463 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
5464 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
5465 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
5466 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
5467 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
5468 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
5469 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
5470 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5471 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
5472 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5473 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
5474 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
5475 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
5476 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
5477 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
5478 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
5479 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
5480 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
5481 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
5482 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
5483 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
5484 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
5485 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
5486 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
5487 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
5488 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
5489 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
5490 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
5491 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
5492 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
5493 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
5494 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
5495 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
5496 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
5497 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
5498 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
5499 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
5500 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
5501 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
5502 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
5503 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
5504 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
5505 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
5506 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5507 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5508 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5509 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5510 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5511 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5512 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
5513 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5514 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
5515 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5516 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5517 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5518 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5519 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5520 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
5521 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
5522 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
5523 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
5524 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
5525 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
5526 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
5527 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
5528 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
5529 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
5530 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
5531 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
5532 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
5533 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
5534 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
5535 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
5536 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
5537 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
5538 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
5539 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
5540 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
5541 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
5542 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
5543 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
5544 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
5545 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
5546 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
5547 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
5548 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
5549 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
5550 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
5551 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
5552 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
5553 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
5554 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
5555 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
5556
5557
5558 Version 1.8.0 (2016-04-14)
5559 ==========================
5560
5561 Language
5562 --------
5563
5564 * Rust supports overloading of compound assignment statements like
5565   `+=` by implementing the [`AddAssign`], [`SubAssign`],
5566   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
5567   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
5568   traits. [RFC 953].
5569 * Empty structs can be defined with braces, as in `struct Foo { }`, in
5570   addition to the non-braced form, `struct Foo;`. [RFC 218].
5571
5572 Libraries
5573 ---------
5574
5575 * Stabilized APIs:
5576   * [`str::encode_utf16`] (renamed from `utf16_units`)
5577   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
5578   * [`Ref::map`]
5579   * [`RefMut::map`]
5580   * [`ptr::drop_in_place`]
5581   * [`time::Instant`]
5582   * [`time::SystemTime`]
5583   * [`Instant::now`]
5584   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
5585   * [`Instant::elapsed`]
5586   * [`SystemTime::now`]
5587   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
5588   * [`SystemTime::elapsed`]
5589   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
5590   * [`SystemTimeError`]
5591   * [`SystemTimeError::duration`]
5592   * Various impls for `SystemTimeError`
5593   * [`UNIX_EPOCH`]
5594   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
5595     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
5596     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
5597 * [The `write!` and `writeln!` macros correctly emit errors if any of
5598   their arguments can't be formatted][1.8w].
5599 * [Various I/O functions support large files on 32-bit Linux][1.8l].
5600 * [The Unix-specific `raw` modules, which contain a number of
5601   redefined C types are deprecated][1.8r], including `os::raw::unix`,
5602   `os::raw::macos`, and `os::raw::linux`. These modules defined types
5603   such as `ino_t` and `dev_t`. The inconsistency of these definitions
5604   across platforms was making it difficult to implement `std`
5605   correctly. Those that need these definitions should use the `libc`
5606   crate. [RFC 1415].
5607 * The Unix-specific `MetadataExt` traits, including
5608   `os::unix::fs::MetadataExt`, which expose values such as inode
5609   numbers [no longer return platform-specific types][1.8r], but
5610   instead return widened integers. [RFC 1415].
5611 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
5612 * [Atomic loads and stores are not volatile][1.8a].
5613 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
5614
5615 Performance
5616 -----------
5617
5618 * [Inlining hash functions lead to a 3% compile-time improvement in
5619   some workloads][1.8h].
5620 * When using jemalloc, its symbols are [unprefixed so that it
5621   overrides the libc malloc implementation][1.8h]. This means that for
5622   rustc, LLVM is now using jemalloc, which results in a 6%
5623   compile-time improvement on a specific workload.
5624 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
5625
5626 Misc
5627 ----
5628
5629 * [32-bit MSVC builds finally implement unwinding][1.8ms].
5630   i686-pc-windows-msvc is now considered a tier-1 platform.
5631 * [The `--print targets` flag prints a list of supported targets][1.8t].
5632 * [The `--print cfg` flag prints the `cfg`s defined for the current
5633   target][1.8cf].
5634 * [`rustc` can be built with an new Cargo-based build system, written
5635   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
5636   build system. To enable it configure with `configure --rustbuild`.
5637 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
5638   variants while also indicating the total number of missing variants
5639   if more than 3][1.8m].
5640 * [Executable stacks are disabled on Linux and BSD][1.8nx].
5641 * The Rust Project now publishes binary releases of the standard
5642   library for a number of tier-2 targets:
5643   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
5644   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
5645   `x86_64-rumprun-netbsd`. These can be installed with
5646   tools such as [multirust][1.8mr].
5647
5648 Cargo
5649 -----
5650
5651 * [`cargo init` creates a new Cargo project in the current
5652   directory][1.8ci].  It is otherwise like `cargo new`.
5653 * [Cargo has configuration keys for `-v` and
5654   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
5655   `[term]` section of `.cargo/config`.
5656 * [Configuration keys that evaluate to strings or integers can be set
5657   via environment variables][1.8ce]. For example the `build.jobs` key
5658   can be set via `CARGO_BUILD_JOBS`. Environment variables take
5659   precedence over config files.
5660 * [Target-specific dependencies support Rust `cfg` syntax for
5661   describing targets][1.8cfg] so that dependencies for multiple
5662   targets can be specified together. [RFC 1361].
5663 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
5664   `RUSTDOC` take precedence over the `build.target-dir`,
5665   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
5666 * [The child process tree is killed on Windows when Cargo is
5667   killed][1.8ck].
5668 * [The `build.target` configuration value sets the target platform,
5669   like `--target`][1.8ct].
5670
5671 Compatibility Notes
5672 -------------------
5673
5674 * [Unstable compiler flags have been further restricted][1.8u]. Since
5675   1.0 `-Z` flags have been considered unstable, and other flags that
5676   were considered unstable additionally required passing `-Z
5677   unstable-options` to access. Unlike unstable language and library
5678   features though, these options have been accessible on the stable
5679   release channel. Going forward, *new unstable flags will not be
5680   available on the stable release channel*, and old unstable flags
5681   will warn about their usage. In the future, all unstable flags will
5682   be unavailable on the stable release channel.
5683 * [It is no longer possible to `match` on empty enum variants using
5684   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
5685 * The Unix-specific `MetadataExt` traits, including
5686   `os::unix::fs::MetadataExt`, which expose values such as inode
5687   numbers [no longer return platform-specific types][1.8r], but
5688   instead return widened integers. [RFC 1415].
5689 * [Modules sourced from the filesystem cannot appear within arbitrary
5690   blocks, but only within other modules][1.8mf].
5691 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
5692 * On Unix, [stack overflow triggers a runtime abort instead of a
5693   SIGSEGV][1.8so].
5694 * [`Command::spawn` and its equivalents return an error if any of
5695   its command-line arguments contain interior `NUL`s][1.8n].
5696 * [Tuple and unit enum variants from other crates are in the type
5697   namespace][1.8tn].
5698 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
5699   type instead of `.a` files][1.8st]. Additionally, for the MSVC
5700   toolchain, `rustc` emits import libraries named `foo.dll.lib`
5701   instead of `foo.lib`.
5702
5703
5704 [1.8a]: https://github.com/rust-lang/rust/pull/30962
5705 [1.8b]: https://github.com/rust-lang/rust/pull/31123
5706 [1.8c]: https://github.com/rust-lang/rust/pull/31530
5707 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
5708 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
5709 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
5710 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
5711 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
5712 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
5713 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
5714 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
5715 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
5716 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
5717 [1.8h]: https://github.com/rust-lang/rust/pull/31460
5718 [1.8l]: https://github.com/rust-lang/rust/pull/31668
5719 [1.8m]: https://github.com/rust-lang/rust/pull/31020
5720 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
5721 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
5722 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
5723 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
5724 [1.8n]: https://github.com/rust-lang/rust/pull/31056
5725 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
5726 [1.8r]: https://github.com/rust-lang/rust/pull/31551
5727 [1.8so]: https://github.com/rust-lang/rust/pull/31333
5728 [1.8st]: https://github.com/rust-lang/rust/pull/29520
5729 [1.8t]: https://github.com/rust-lang/rust/pull/31358
5730 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
5731 [1.8u]: https://github.com/rust-lang/rust/pull/31793
5732 [1.8v]: https://github.com/rust-lang/rust/pull/31757
5733 [1.8w]: https://github.com/rust-lang/rust/pull/31904
5734 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
5735 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
5736 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
5737 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
5738 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
5739 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
5740 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
5741 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
5742 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
5743 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
5744 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
5745 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
5746 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
5747 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
5748 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
5749 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
5750 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
5751 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
5752 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
5753 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
5754 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
5755 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
5756 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
5757 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
5758 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
5759 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
5760 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
5761 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
5762 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
5763 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
5764
5765
5766 Version 1.7.0 (2016-03-03)
5767 ==========================
5768
5769 Libraries
5770 ---------
5771
5772 * Stabilized APIs
5773   * `Path`
5774     * [`Path::strip_prefix`] (renamed from relative_from)
5775     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
5776   * `Ipv4Addr`
5777     * [`Ipv4Addr::is_loopback`]
5778     * [`Ipv4Addr::is_private`]
5779     * [`Ipv4Addr::is_link_local`]
5780     * [`Ipv4Addr::is_multicast`]
5781     * [`Ipv4Addr::is_broadcast`]
5782     * [`Ipv4Addr::is_documentation`]
5783   * `Ipv6Addr`
5784     * [`Ipv6Addr::is_unspecified`]
5785     * [`Ipv6Addr::is_loopback`]
5786     * [`Ipv6Addr::is_multicast`]
5787   * `Vec`
5788     * [`Vec::as_slice`]
5789     * [`Vec::as_mut_slice`]
5790   * `String`
5791     * [`String::as_str`]
5792     * [`String::as_mut_str`]
5793   * Slices
5794     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
5795     be the same length
5796     * `<[T]>::`[`sort_by_key`]
5797   * checked, saturated, and overflowing operations
5798     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
5799     * [`i32::saturating_mul`]
5800     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
5801     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
5802     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
5803     * [`u32::saturating_mul`]
5804     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
5805     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
5806     * and checked, saturated, and overflowing operations for other primitive types
5807   * FFI
5808     * [`ffi::IntoStringError`]
5809     * [`CString::into_string`]
5810     * [`CString::into_bytes`]
5811     * [`CString::into_bytes_with_nul`]
5812     * `From<CString> for Vec<u8>`
5813   * `IntoStringError`
5814     * [`IntoStringError::into_cstring`]
5815     * [`IntoStringError::utf8_error`]
5816     * `Error for IntoStringError`
5817   * Hashing
5818     * [`std::hash::BuildHasher`]
5819     * [`BuildHasher::Hasher`]
5820     * [`BuildHasher::build_hasher`]
5821     * [`std::hash::BuildHasherDefault`]
5822     * [`HashMap::with_hasher`]
5823     * [`HashMap::with_capacity_and_hasher`]
5824     * [`HashSet::with_hasher`]
5825     * [`HashSet::with_capacity_and_hasher`]
5826     * [`std::collections::hash_map::RandomState`]
5827     * [`RandomState::new`]
5828 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
5829   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
5830   from bytes is faster.
5831 * [The performance of `LineWriter` (and thus `io::stdout`) was
5832   improved by using `memchr` to search for newlines][1.7m].
5833 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
5834   `f64` variants were stabilized previously.
5835 * [`BTreeMap` was rewritten to use less memory and improve the performance
5836   of insertion and iteration, the latter by as much as 5x][1.7bm].
5837 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
5838   covariant over their contained type][1.7bt].
5839 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
5840   over their contained type][1.7ll].
5841 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
5842   searching methods.
5843 * [`Any` is implemented for unsized types][1.7a].
5844 * [`Hash` is implemented for `Duration`][1.7h].
5845
5846 Misc
5847 ----
5848
5849 * [When running tests with `--test`, rustdoc will pass `--cfg`
5850   arguments to the compiler][1.7dt].
5851 * [The compiler is built with RPATH information by default][1.7rpa].
5852   This means that it will be possible to run `rustc` when installed in
5853   unusual configurations without configuring the dynamic linker search
5854   path explicitly.
5855 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
5856   any RPATH entries (emitted with `-C rpath`) *not* take precedence
5857   over `LD_LIBRARY_PATH`.
5858
5859 Cargo
5860 -----
5861
5862 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
5863   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
5864 * [The `rerun-if-changed` build script directive no longer causes the
5865   build script to incorrectly run twice in certain scenarios][1.7rr].
5866
5867 Compatibility Notes
5868 -------------------
5869
5870 * Soundness fixes to the interactions between associated types and
5871   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
5872   code that violates the new rules. This is a significant change that
5873   is known to break existing code, so it has emitted warnings for the
5874   new error cases since 1.4 to give crate authors time to adapt. The
5875   details of what is changing are subtle; read the RFC for more.
5876 * [Several bugs in the compiler's visibility calculations were
5877   fixed][1.7v]. Since this was found to break significant amounts of
5878   code, the new errors will be emitted as warnings for several release
5879   cycles, under the `private_in_public` lint.
5880 * Defaulted type parameters were accidentally accepted in positions
5881   that were not intended. In this release, [defaulted type parameters
5882   appearing outside of type definitions will generate a
5883   warning][1.7d], which will become an error in future releases.
5884 * [Parsing "." as a float results in an error instead of 0][1.7p].
5885   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
5886 * [Borrows of closure parameters may not outlive the closure][1.7bc].
5887
5888 [1.7a]: https://github.com/rust-lang/rust/pull/30928
5889 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
5890 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
5891 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
5892 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
5893 [1.7d]: https://github.com/rust-lang/rust/pull/30724
5894 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
5895 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
5896 [1.7f]: https://github.com/rust-lang/rust/pull/30672
5897 [1.7h]: https://github.com/rust-lang/rust/pull/30818
5898 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
5899 [1.7m]: https://github.com/rust-lang/rust/pull/30381
5900 [1.7p]: https://github.com/rust-lang/rust/pull/30681
5901 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
5902 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
5903 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
5904 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
5905 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
5906 [1.7v]: https://github.com/rust-lang/rust/pull/29973
5907 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5908 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5909 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
5910 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
5911 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
5912 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
5913 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
5914 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
5915 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
5916 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
5917 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
5918 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
5919 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
5920 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
5921 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
5922 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
5923 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
5924 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
5925 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
5926 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
5927 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
5928 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
5929 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
5930 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
5931 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
5932 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
5933 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
5934 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
5935 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
5936 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
5937 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
5938 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
5939 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
5940 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
5941 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
5942 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
5943 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
5944 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
5945 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
5946 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
5947 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
5948 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
5949 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
5950 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
5951 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
5952 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
5953 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
5954 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5955 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
5956 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5957 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
5958 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
5959 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
5960 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
5961 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
5962 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
5963 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
5964 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
5965 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
5966 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
5967
5968
5969 Version 1.6.0 (2016-01-21)
5970 ==========================
5971
5972 Language
5973 --------
5974
5975 * The `#![no_std]` attribute causes a crate to not be linked to the
5976   standard library, but only the [core library][1.6co], as described
5977   in [RFC 1184]. The core library defines common types and traits but
5978   has no platform dependencies whatsoever, and is the basis for Rust
5979   software in environments that cannot support a full port of the
5980   standard library, such as operating systems. Most of the core
5981   library is now stable.
5982
5983 Libraries
5984 ---------
5985
5986 * Stabilized APIs:
5987   [`Read::read_exact`],
5988   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
5989   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
5990   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
5991   [`os::unix::fs::DirBuilderExt`],
5992   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
5993   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
5994   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
5995   [`collections::hash_map::Drain`],
5996   [`collections::hash_map::HashMap::drain`],
5997   [`collections::hash_set::Drain`],
5998   [`collections::hash_set::HashSet::drain`],
5999   [`collections::binary_heap::Drain`],
6000   [`collections::binary_heap::BinaryHeap::drain`],
6001   [`Vec::extend_from_slice`] (renamed from `push_all`),
6002   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
6003   [`RwLock::into_inner`],
6004   [`Iterator::min_by_key`] (renamed from `min_by`),
6005   [`Iterator::max_by_key`] (renamed from `max_by`).
6006 * The [core library][1.6co] is stable, as are most of its APIs.
6007 * [The `assert_eq!` macro supports arguments that don't implement
6008   `Sized`][1.6ae], such as arrays. In this way it behaves more like
6009   `assert!`.
6010 * Several timer functions that take duration in milliseconds [are
6011   deprecated in favor of those that take `Duration`][1.6ms]. These
6012   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
6013   `thread::park_timeout_ms`.
6014 * The algorithm by which `Vec` reserves additional elements was
6015   [tweaked to not allocate excessive space][1.6a] while still growing
6016   exponentially.
6017 * `From` conversions are [implemented from integers to floats][1.6f]
6018   in cases where the conversion is lossless. Thus they are not
6019   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
6020   or `f64`. They are also not implemented for `isize` and `usize`
6021   because the implementations would be platform-specific. `From` is
6022   also implemented from `f32` to `f64`.
6023 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
6024 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
6025 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
6026 * [`BinaryHeap` was refactored][1.6bh] for modest performance
6027   improvements.
6028 * Sorting slices that are already sorted [is 50% faster in some
6029   cases][1.6s].
6030
6031 Cargo
6032 -----
6033
6034 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
6035 * Cargo build scripts can specify their dependencies by emitting the
6036   [`rerun-if-changed`][1.6rr] key.
6037 * crates.io will reject publication of crates with dependencies that
6038   have a wildcard version constraint. Crates with wildcard
6039   dependencies were seen to cause a variety of problems, as described
6040   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
6041   warning.
6042 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
6043   release folder.  A variety of artifacts that Cargo failed to clean
6044   are now correctly deleted.
6045
6046 Misc
6047 ----
6048
6049 * The `unreachable_code` lint [warns when a function call's argument
6050   diverges][1.6dv].
6051 * The parser indicates [failures that may be caused by
6052   confusingly-similar Unicode characters][1.6uc]
6053 * Certain macro errors [are reported at definition time][1.6m], not
6054   expansion.
6055
6056 Compatibility Notes
6057 -------------------
6058
6059 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
6060   environment variable when locating crates. This was a pre-cargo
6061   feature for integrating with the package manager that was
6062   accidentally never removed.
6063 * [A number of bugs were fixed in the privacy checker][1.6p] that
6064   could cause previously-accepted code to break.
6065 * [Modules and unit/tuple structs may not share the same name][1.6ts].
6066 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
6067   struct pattern syntax (`Foo(..)`) can no longer be used to match
6068   unit structs. This is a warning now, but will become an error in
6069   future releases. Patterns that share the same name as a const are
6070   now an error.
6071 * A bug was fixed that causes [rustc not to apply default type
6072   parameters][1.6xc] when resolving certain method implementations of
6073   traits defined in other crates.
6074
6075 [1.6a]: https://github.com/rust-lang/rust/pull/29454
6076 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
6077 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
6078 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
6079 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
6080 [1.6co]: http://doc.rust-lang.org/core/index.html
6081 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
6082 [1.6f]: https://github.com/rust-lang/rust/pull/29129
6083 [1.6m]: https://github.com/rust-lang/rust/pull/29828
6084 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
6085 [1.6p]: https://github.com/rust-lang/rust/pull/29726
6086 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
6087 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
6088 [1.6s]: https://github.com/rust-lang/rust/pull/29675
6089 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
6090 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
6091 [1.6us]: https://github.com/rust-lang/rust/pull/29383
6092 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
6093 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
6094 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6095 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
6096 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
6097 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
6098 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
6099 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
6100 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
6101 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
6102 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
6103 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
6104 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
6105 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
6106 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
6107 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
6108 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
6109 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
6110 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
6111 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
6112 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
6113 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
6114 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
6115 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
6116 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
6117 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
6118 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
6119 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
6120 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
6121 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
6122
6123
6124 Version 1.5.0 (2015-12-10)
6125 ==========================
6126
6127 * ~700 changes, numerous bugfixes
6128
6129 Highlights
6130 ----------
6131
6132 * Stabilized APIs:
6133   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
6134   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
6135   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
6136   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
6137   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
6138   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
6139   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
6140   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
6141   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
6142   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
6143   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
6144   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
6145   [`Path::read_link`], [`Path::symlink_metadata`],
6146   [`Utf8Error::valid_up_to`], [`Vec::resize`],
6147   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
6148   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
6149   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
6150   [`slice::split_first_mut`], [`slice::split_first`],
6151   [`slice::split_last_mut`], [`slice::split_last`],
6152   [`char::from_u32_unchecked`], [`fs::canonicalize`],
6153   [`str::MatchIndices`], [`str::RMatchIndices`],
6154   [`str::match_indices`], [`str::rmatch_indices`],
6155   [`str::slice_mut_unchecked`], [`string::ParseError`].
6156 * Rust applications hosted on crates.io can be installed locally to
6157   `~/.cargo/bin` with the [`cargo install`] command. Among other
6158   things this makes it easier to augment Cargo with new subcommands:
6159   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
6160   invoked as `cargo foo`.
6161 * Crates with wildcard (`*`) dependencies will [emit warnings when
6162   published][1.5w]. In 1.6 it will no longer be possible to publish
6163   crates with wildcard dependencies.
6164
6165 Breaking Changes
6166 ----------------
6167
6168 * The rules determining when a particular lifetime must outlive
6169   a particular value (known as '[dropck]') have been [modified
6170   to not rely on parametricity][1.5p].
6171 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
6172   and `Arc`][1.5a]. Because these smart pointer types implement
6173   `Deref`, this causes breakage in cases where the interior type
6174   contains methods of the same name.
6175 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
6176   that they could drop their content. Soundness fix.
6177 * All method invocations are [properly checked][1.5wf1] for
6178   [well-formedness][1.5wf2]. Soundness fix.
6179 * Traits whose supertraits contain `Self` are [not object
6180   safe][1.5o]. Soundness fix.
6181 * Target specifications support a [`no_default_libraries`][1.5nd]
6182   setting that controls whether `-nodefaultlibs` is passed to the
6183   linker, and in turn the `is_like_windows` setting no longer affects
6184   the `-nodefaultlibs` flag.
6185 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
6186 * The `#[inline]` and `#[repr]` attributes [can only appear
6187   in valid locations][1.5at].
6188 * Native libraries linked from the local crate are [passed to
6189   the linker before native libraries from upstream crates][1.5nl].
6190 * Two rarely-used attributes, `#[no_debug]` and
6191   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
6192 * Negation of unsigned integers, which has been a warning for
6193   several releases, [is now behind a feature gate and will
6194   generate errors][1.5nu].
6195 * The parser accidentally accepted visibility modifiers on
6196   enum variants, a bug [which has been fixed][1.5ev].
6197 * [A bug was fixed that allowed `use` statements to import unstable
6198   features][1.5use].
6199
6200 Language
6201 --------
6202
6203 * When evaluating expressions at compile-time that are not
6204   compile-time constants (const-evaluating expressions in non-const
6205   contexts), incorrect code such as overlong bitshifts and arithmetic
6206   overflow will [generate a warning instead of an error][1.5ce],
6207   delaying the error until runtime. This will allow the
6208   const-evaluator to be expanded in the future backwards-compatibly.
6209 * The `improper_ctypes` lint [no longer warns about using `isize` and
6210   `usize` in FFI][1.5ict].
6211
6212 Libraries
6213 ---------
6214
6215 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
6216   invariant][1.5c].
6217 * `Default` is [implemented for mutable slices][1.5d].
6218 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
6219 * There are now `From` conversions [between floating point
6220   types][1.5f] where the conversions are lossless.
6221 * There are now `From` conversions [between integer types][1.5i] where
6222   the conversions are lossless.
6223 * [`fs::Metadata` implements `Clone`][1.5fs].
6224 * The `parse` method [accepts a leading "+" when parsing
6225   integers][1.5pi].
6226 * [`AsMut` is implemented for `Vec`][1.5am].
6227 * The `clone_from` implementations for `String` and `BinaryHeap` [have
6228   been optimized][1.5cf] and no longer rely on the default impl.
6229 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
6230   `unsafe extern "C"` function types now [implement `Clone`,
6231   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
6232   `fmt::Debug` for up to 12 arguments][1.5fp].
6233 * [Dropping `Vec`s is much faster in unoptimized builds when the
6234   element types don't implement `Drop`][1.5dv].
6235 * A bug that caused in incorrect behavior when [combining `VecDeque`
6236   with zero-sized types][1.5vdz] was resolved.
6237 * [`PartialOrd` for slices is faster][1.5po].
6238
6239 Miscellaneous
6240 -------------
6241
6242 * [Crate metadata size was reduced by 20%][1.5md].
6243 * [Improvements to code generation reduced the size of libcore by 3.3
6244   MB and rustc's memory usage by 18MB][1.5m].
6245 * [Improvements to deref translation increased performance in
6246   unoptimized builds][1.5dr].
6247 * Various errors in trait resolution [are deduplicated to only be
6248   reported once][1.5te].
6249 * Rust has preliminary [support for rumprun kernels][1.5rr].
6250 * Rust has preliminary [support for NetBSD on amd64][1.5na].
6251
6252 [1.5use]: https://github.com/rust-lang/rust/pull/28364
6253 [1.5po]: https://github.com/rust-lang/rust/pull/28436
6254 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
6255 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
6256 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
6257 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
6258 [1.5md]: https://github.com/rust-lang/rust/pull/28521
6259 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
6260 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
6261 [1.5na]: https://github.com/rust-lang/rust/pull/28543
6262 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
6263 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
6264 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
6265 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
6266 [1.5te]: https://github.com/rust-lang/rust/pull/28645
6267 [1.5at]: https://github.com/rust-lang/rust/pull/28650
6268 [1.5am]: https://github.com/rust-lang/rust/pull/28663
6269 [1.5m]: https://github.com/rust-lang/rust/pull/28778
6270 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
6271 [1.5a]: https://github.com/rust-lang/rust/pull/28811
6272 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
6273 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
6274 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
6275 [1.5i]: https://github.com/rust-lang/rust/pull/28921
6276 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
6277 [1.5f]: https://github.com/rust-lang/rust/pull/29129
6278 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
6279 [1.5s]: https://github.com/rust-lang/rust/pull/29190
6280 [1.5d]: https://github.com/rust-lang/rust/pull/29245
6281 [1.5o]: https://github.com/rust-lang/rust/pull/29259
6282 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
6283 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6284 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
6285 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
6286 [1.5c]: https://github.com/rust-lang/rust/pull/29110
6287 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6288 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
6289 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
6290 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
6291 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
6292 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
6293 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
6294 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
6295 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
6296 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
6297 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
6298 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
6299 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
6300 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
6301 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
6302 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
6303 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
6304 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
6305 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
6306 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
6307 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
6308 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
6309 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
6310 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
6311 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
6312 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
6313 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
6314 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
6315 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
6316 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
6317 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
6318 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
6319 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
6320 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
6321 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
6322 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
6323 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
6324 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
6325 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
6326 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
6327 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
6328 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
6329 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
6330 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
6331 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
6332 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
6333 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
6334 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
6335 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
6336 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
6337 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
6338 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
6339 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
6340 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
6341
6342 Version 1.4.0 (2015-10-29)
6343 ==========================
6344
6345 * ~1200 changes, numerous bugfixes
6346
6347 Highlights
6348 ----------
6349
6350 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
6351   GNU) are now supported and recommended for use.
6352
6353 Breaking Changes
6354 ----------------
6355
6356 * [Several changes have been made to fix type soundness and improve
6357   the behavior of associated types][sound]. See [RFC 1214]. Although
6358   we have mostly introduced these changes as warnings this release, to
6359   become errors next release, there are still some scenarios that will
6360   see immediate breakage.
6361 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
6362   line breaks in addition to `\n`][crlf].
6363 * [Loans of `'static` lifetime extend to the end of a function][stat].
6364 * [`str::parse` no longer introduces avoidable rounding error when
6365   parsing floating point numbers. Together with earlier changes to
6366   float formatting/output, "round trips" like f.to_string().parse()
6367   now preserve the value of f exactly. Additionally, leading plus
6368   signs are now accepted][fp3].
6369
6370
6371 Language
6372 --------
6373
6374 * `use` statements that import multiple items [can now rename
6375   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
6376 * [Binops work correctly on fat pointers][binfat].
6377 * `pub extern crate`, which does not behave as expected, [issues a
6378   warning][pec] until a better solution is found.
6379
6380 Libraries
6381 ---------
6382
6383 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
6384   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
6385   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
6386   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
6387   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
6388   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
6389   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
6390   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
6391   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
6392   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
6393   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
6394   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
6395   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
6396   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
6397   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
6398   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
6399   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
6400   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
6401   [`thread::sleep`].
6402 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
6403   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
6404   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
6405   `f64::from_str_radix`.
6406 * [Reverse-searching strings is faster with the 'two-way'
6407   algorithm][s].
6408 * [`std::io::copy` allows `?Sized` arguments][cc].
6409 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
6410   [override `count`, `nth` and `last` with an O(1)
6411   implementation][it].
6412 * [`Default` is implemented for arrays up to `[T; 32]`][d].
6413 * [`IntoRawFd` has been added to the Unix-specific prelude,
6414   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
6415   prelude][pr].
6416 * [`Extend<String>` and `FromIterator<String` are both implemented for
6417   `String`][es].
6418 * [`IntoIterator` is implemented for references to `Option` and
6419   `Result`][into2].
6420 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
6421   Copy`][ext] as part of [RFC 839]. This will cause type inference
6422   breakage in rare situations.
6423 * [`BinaryHeap` implements `Debug`][bh2].
6424 * [`Borrow` and `BorrowMut` are implemented for fixed-size
6425   arrays][bm].
6426 * [`extern fn`s with the "Rust" and "C" ABIs implement common
6427   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
6428 * [String comparison is faster][faststr].
6429 * `&mut T` where `T: std::fmt::Write` [also implements
6430   `std::fmt::Write`][mutw].
6431 * [A stable regression in `VecDeque::push_back` and other
6432   capacity-altering methods that caused panics for zero-sized types
6433   was fixed][vd].
6434 * [Function pointers implement traits for up to 12 parameters][fp2].
6435
6436 Miscellaneous
6437 -------------
6438
6439 * The compiler [no longer uses the 'morestack' feature to prevent
6440   stack overflow][mm]. Instead it uses guard pages and stack
6441   probes (though stack probes are not yet implemented on any platform
6442   but Windows).
6443 * [The compiler matches traits faster when projections are involved][p].
6444 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
6445   `usize`][ffi].
6446 * [Cargo now displays useful information about what its doing during
6447   `cargo update`][cu].
6448
6449 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
6450 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
6451 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
6452 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
6453 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
6454 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
6455 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
6456 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
6457 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
6458 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
6459 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
6460 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
6461 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
6462 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
6463 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
6464 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
6465 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
6466 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
6467 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6468 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6469 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6470 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6471 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6472 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6473 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6474 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6475 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
6476 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
6477 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
6478 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
6479 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
6480 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
6481 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
6482 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
6483 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
6484 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
6485 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
6486 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
6487 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
6488 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
6489 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
6490 [bh2]: https://github.com/rust-lang/rust/pull/28156
6491 [binfat]: https://github.com/rust-lang/rust/pull/28270
6492 [bm]: https://github.com/rust-lang/rust/pull/28197
6493 [cc]: https://github.com/rust-lang/rust/pull/27531
6494 [crlf]: https://github.com/rust-lang/rust/pull/28034
6495 [cu]: https://github.com/rust-lang/cargo/pull/1931
6496 [d]: https://github.com/rust-lang/rust/pull/27825
6497 [dep]: https://github.com/rust-lang/rust/pull/28339
6498 [es]: https://github.com/rust-lang/rust/pull/27956
6499 [ext]: https://github.com/rust-lang/rust/pull/28094
6500 [faststr]: https://github.com/rust-lang/rust/pull/28338
6501 [ffi]: https://github.com/rust-lang/rust/pull/28779
6502 [fp]: https://github.com/rust-lang/rust/pull/28268
6503 [fp2]: https://github.com/rust-lang/rust/pull/28560
6504 [fp3]: https://github.com/rust-lang/rust/pull/27307
6505 [i]: https://github.com/rust-lang/rust/pull/27451
6506 [into2]: https://github.com/rust-lang/rust/pull/28039
6507 [it]: https://github.com/rust-lang/rust/pull/27652
6508 [mm]: https://github.com/rust-lang/rust/pull/27338
6509 [mutw]: https://github.com/rust-lang/rust/pull/28368
6510 [sound]: https://github.com/rust-lang/rust/pull/27641
6511 [p]: https://github.com/rust-lang/rust/pull/27866
6512 [pec]: https://github.com/rust-lang/rust/pull/28486
6513 [pr]: https://github.com/rust-lang/rust/pull/27896
6514 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6515 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6516 [s]: https://github.com/rust-lang/rust/pull/27474
6517 [stab]: https://github.com/rust-lang/rust/pull/28339
6518 [stat]: https://github.com/rust-lang/rust/pull/28321
6519 [vd]: https://github.com/rust-lang/rust/pull/28494
6520
6521 Version 1.3.0 (2015-09-17)
6522 ==============================
6523
6524 * ~900 changes, numerous bugfixes
6525
6526 Highlights
6527 ----------
6528
6529 * The [new object lifetime defaults][nold] have been [turned
6530   on][nold2] after a cycle of warnings about the change. Now types
6531   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
6532   being interpreted as `&'a Box<Trait+'a>` to `&'a
6533   Box<Trait+'static>`.
6534 * [The Rustonomicon][nom] is a new book in the official documentation
6535   that dives into writing unsafe Rust.
6536 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
6537   timekeeping is employed by other std APIs, as well as out-of-tree
6538   time crates.
6539
6540 Breaking Changes
6541 ----------------
6542
6543 * The [new object lifetime defaults][nold] have been [turned
6544   on][nold2] after a cycle of warnings about the change.
6545 * There is a known [regression][lr] in how object lifetime elision is
6546   interpreted, the proper solution for which is undetermined.
6547 * The `#[prelude_import]` attribute, an internal implementation
6548   detail, was accidentally stabilized previously. [It has been put
6549   behind the `prelude_import` feature gate][pi]. This change is
6550   believed to break no existing code.
6551 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6552   [more sane for dynamically sized types][dst3]. Code that relied on
6553   the previous behavior is thought to be broken.
6554 * The `dropck` rules, which checks that destructors can't access
6555   destroyed values, [have been updated][dropck] to match the
6556   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
6557   cause some previously-compiling code to no longer build.
6558
6559 Language
6560 --------
6561
6562 * The [new object lifetime defaults][nold] have been [turned
6563   on][nold2] after a cycle of warnings about the change.
6564 * Semicolons may [now follow types and paths in
6565   macros](https://github.com/rust-lang/rust/pull/27000).
6566 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6567   [more sane for dynamically sized types][dst3]. Code that relied on
6568   the previous behavior is not known to exist, and suspected to be
6569   broken.
6570 * `'static` variables [may now be recursive][st].
6571 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
6572   implementations correctly.
6573 * The `dropck` rules, which checks that destructors can't access
6574   destroyed values, [have been updated][dropck] to match the
6575   [RFC][dropckrfc].
6576
6577 Libraries
6578 ---------
6579
6580 * The [`Duration`] API, [has been stabilized][ds], as well as the
6581   `std::time` module, which presently contains only `Duration`.
6582 * `Box<str>` and `Box<[T]>` both implement `Clone`.
6583 * The owned C string, [`CString`], implements [`Borrow`] and the
6584   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
6585   these allow C strings to be borrowed and cloned in generic code.
6586 * [`CStr`] implements [`Debug`].
6587 * [`AtomicPtr`] implements [`Debug`].
6588 * [`Error`] trait objects [can be downcast to their concrete types][e]
6589   in many common configurations, using the [`is`], [`downcast`],
6590   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
6591   [`Any`] trait.
6592 * Searching for substrings now [employs the two-way algorithm][search]
6593   instead of doing a naive search. This gives major speedups to a
6594   number of methods, including [`contains`][sc], [`find`][sf],
6595   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
6596   [`ends_with`][sew] are also faster.
6597 * The performance of `PartialEq` for slices is [much faster][ps].
6598 * The [`Hash`] trait offers the default method, [`hash_slice`], which
6599   is overridden and optimized by the implementations for scalars.
6600 * The [`Hasher`] trait now has a number of specialized `write_*`
6601   methods for primitive types, for efficiency.
6602 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
6603   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
6604   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
6605   of [`std::error::Error::cause`][iec] also delegates to the inner
6606   error.
6607 * [`process::Child`][pc] gained the [`id`] method, which returns a
6608   `u32` representing the platform-specific process identifier.
6609 * The [`connect`] method on slices is deprecated, replaced by the new
6610   [`join`] method (note that both of these are on the *unstable*
6611   [`SliceConcatExt`] trait, but through the magic of the prelude are
6612   available to stable code anyway).
6613 * The [`Div`] operator is implemented for [`Wrapping`] types.
6614 * [`DerefMut` is implemented for `String`][dms].
6615 * Performance of SipHash (the default hasher for `HashMap`) is
6616   [better for long data][sh].
6617 * [`AtomicPtr`] implements [`Send`].
6618 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
6619   are now [specialized to use uninitialized buffers for increased
6620   performance][rte].
6621 * Lifetime parameters of foreign functions [are now resolved
6622   properly][f].
6623
6624 Misc
6625 ----
6626
6627 * Rust can now, with some coercion, [produce programs that run on
6628   Windows XP][xp], though XP is not considered a supported platform.
6629 * Porting Rust on Windows from the GNU toolchain to MSVC continues
6630   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
6631   recommended for use in 1.3, though should be fully-functional
6632   in the [64-bit 1.4 beta][b14].
6633 * On Fedora-based systems installation will [properly configure the
6634   dynamic linker][fl].
6635 * The compiler gained many new extended error descriptions, which can
6636   be accessed with the `--explain` flag.
6637 * The `dropck` pass, which checks that destructors can't access
6638   destroyed values, [has been rewritten][dropck]. This fixes some
6639   soundness holes, and as such will cause some previously-compiling
6640   code to no longer build.
6641 * `rustc` now uses [LLVM to write archive files where possible][ar].
6642   Eventually this will eliminate the compiler's dependency on the ar
6643   utility.
6644 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
6645   supported FreeBSD on x86_64).
6646 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
6647   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
6648   more strict.
6649 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
6650   will kill the process instead of leaking][nlp].
6651
6652 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
6653 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
6654 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
6655 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
6656 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
6657 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6658 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6659 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
6660 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
6661 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
6662 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
6663 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
6664 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
6665 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6666 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
6667 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
6668 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
6669 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
6670 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6671 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
6672 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
6673 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
6674 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
6675 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6676 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
6677 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
6678 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
6679 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
6680 [ar]: https://github.com/rust-lang/rust/pull/26926
6681 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
6682 [dms]: https://github.com/rust-lang/rust/pull/26241
6683 [dropck]: https://github.com/rust-lang/rust/pull/27261
6684 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6685 [ds]: https://github.com/rust-lang/rust/pull/26818
6686 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
6687 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
6688 [dst3]: https://github.com/rust-lang/rust/pull/27351
6689 [e]: https://github.com/rust-lang/rust/pull/24793
6690 [f]: https://github.com/rust-lang/rust/pull/26588
6691 [fb]: https://github.com/rust-lang/rust/pull/26959
6692 [fl]: https://github.com/rust-lang/rust-installer/pull/41
6693 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6694 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
6695 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
6696 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
6697 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
6698 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
6699 [lic]: https://github.com/rust-lang/rust/pull/26583
6700 [lnu]: https://github.com/rust-lang/rust/pull/27026
6701 [lr]: https://github.com/rust-lang/rust/issues/27248
6702 [lum]: https://github.com/rust-lang/rust/pull/26378
6703 [lur]: https://github.com/rust-lang/rust/pull/26783
6704 [nlp]: https://github.com/rust-lang/rust/pull/27176
6705 [nold2]: https://github.com/rust-lang/rust/pull/27045
6706 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
6707 [nom]: http://doc.rust-lang.org/nightly/nomicon/
6708 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
6709 [pi]: https://github.com/rust-lang/rust/pull/26699
6710 [ps]: https://github.com/rust-lang/rust/pull/26884
6711 [rte]: https://github.com/rust-lang/rust/pull/26950
6712 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
6713 [search]: https://github.com/rust-lang/rust/pull/26327
6714 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
6715 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
6716 [sh]: https://github.com/rust-lang/rust/pull/27280
6717 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
6718 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
6719 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
6720 [st]: https://github.com/rust-lang/rust/pull/26630
6721 [win1]: https://github.com/rust-lang/rust/pull/26569
6722 [win2]: https://github.com/rust-lang/rust/pull/26741
6723 [win3]: https://github.com/rust-lang/rust/pull/26741
6724 [win4]: https://github.com/rust-lang/rust/pull/27210
6725 [xp]: https://github.com/rust-lang/rust/pull/26569
6726
6727 Version 1.2.0 (2015-08-07)
6728 ==========================
6729
6730 * ~1200 changes, numerous bugfixes
6731
6732 Highlights
6733 ----------
6734
6735 * [Dynamically-sized-type coercions][dst] allow smart pointer types
6736   like `Rc` to contain types without a fixed size, arrays and trait
6737   objects, finally enabling use of `Rc<[T]>` and completing the
6738   implementation of DST.
6739 * [Parallel codegen][parcodegen] is now working again, which can
6740   substantially speed up large builds in debug mode; It also gets
6741   another ~33% speedup when bootstrapping on a 4 core machine (using 8
6742   jobs). It's not enabled by default, but will be "in the near
6743   future". It can be activated with the `-C codegen-units=N` flag to
6744   `rustc`.
6745 * This is the first release with [experimental support for linking
6746   with the MSVC linker and lib C on Windows (instead of using the GNU
6747   variants via MinGW)][win]. It is yet recommended only for the most
6748   intrepid Rustaceans.
6749 * Benchmark compilations are showing a 30% improvement in
6750   bootstrapping over 1.1.
6751
6752 Breaking Changes
6753 ----------------
6754
6755 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
6756   unicode case mapping, which is a previously-planned change in
6757   behavior and considered a bugfix.
6758 * [`mem::align_of`] now specifies [the *minimum alignment* for
6759   T][align], which is usually the alignment programs are interested
6760   in, and the same value reported by clang's
6761   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
6762   break real code.
6763 * [The `#[packed]` attribute is no longer silently accepted by the
6764   compiler][packed]. This attribute did nothing and code that
6765   mentioned it likely did not work as intended.
6766 * Associated type defaults are [now behind the
6767   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
6768   defaults *did not work*, but could be mentioned syntactically. As
6769   such this breakage has minimal impact.
6770
6771 Language
6772 --------
6773
6774 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
6775   matching against dereferenceable values.
6776
6777 Libraries
6778 ---------
6779
6780 * The [`Extend`] trait, which grows a collection from an iterator, is
6781   implemented over iterators of references, for `String`, `Vec`,
6782   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
6783   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
6784 * The [`iter::once`] function returns an iterator that yields a single
6785   element, and [`iter::empty`] returns an iterator that yields no
6786   elements.
6787 * The [`matches`] and [`rmatches`] methods on `str` return iterators
6788   over substring matches.
6789 * [`Cell`] and [`RefCell`] both implement `Eq`.
6790 * A number of methods for wrapping arithmetic are added to the
6791   integral types, [`wrapping_div`], [`wrapping_rem`],
6792   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
6793   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
6794   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
6795   type.. It is illegal for the default arithmetic operations in Rust
6796   to overflow; the desire to wrap must be explicit.
6797 * The `{:#?}` formatting specifier [displays the alternate,
6798   pretty-printed][debugfmt] form of the `Debug` formatter. This
6799   feature was actually introduced prior to 1.0 with little
6800   fanfare.
6801 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
6802   for writing data to formatted strings, similar to [`io::Write`].
6803 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
6804   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
6805   are used by code generators to emit implementations of [`Debug`].
6806 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
6807   methods that convert case, following Unicode case mapping.
6808 * It is now easier to handle poisoned locks. The [`PoisonError`]
6809   type, returned by failing lock operations, exposes `into_inner`,
6810   `get_ref`, and `get_mut`, which all give access to the inner lock
6811   guard, and allow the poisoned lock to continue to operate. The
6812   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
6813   poisoned lock without attempting to take the lock.
6814 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
6815   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
6816   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
6817   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
6818   `ChildStderr`.
6819 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
6820   malformed input.
6821
6822 Misc
6823 ----
6824
6825 * `rustc` employs smarter heuristics for guessing at [typos].
6826 * `rustc` emits more efficient code for [no-op conversions between
6827   unsafe pointers][nop].
6828 * Fat pointers are now [passed in pairs of immediate arguments][fat],
6829   resulting in faster compile times and smaller code.
6830
6831 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
6832 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6833 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
6834 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
6835 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
6836 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
6837 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
6838 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
6839 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
6840 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
6841 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
6842 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
6843 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
6844 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
6845 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
6846 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
6847 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6848 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
6849 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
6850 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
6851 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
6852 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
6853 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
6854 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
6855 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
6856 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6857 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
6858 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
6859 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
6860 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
6861 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
6862 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
6863 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
6864 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
6865 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
6866 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
6867 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
6868 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
6869 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
6870 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
6871 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
6872 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6873 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
6874 [align]: https://github.com/rust-lang/rust/pull/25646
6875 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
6876 [typos]: https://github.com/rust-lang/rust/pull/26087
6877 [nop]: https://github.com/rust-lang/rust/pull/26336
6878 [fat]: https://github.com/rust-lang/rust/pull/26411
6879 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
6880 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
6881 [packed]: https://github.com/rust-lang/rust/pull/25541
6882 [ad]: https://github.com/rust-lang/rust/pull/27382
6883 [win]: https://github.com/rust-lang/rust/pull/25350
6884
6885 Version 1.1.0 (2015-06-25)
6886 =========================
6887
6888 * ~850 changes, numerous bugfixes
6889
6890 Highlights
6891 ----------
6892
6893 * The [`std::fs` module has been expanded][fs] to expand the set of
6894   functionality exposed:
6895   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
6896     don't incur a syscall on some platforms.
6897   * A `symlink_metadata` function has been added.
6898   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
6899     access to all underlying information.
6900 * The compiler now contains extended explanations of many errors. When an error
6901   with an explanation occurs the compiler suggests using the `--explain` flag
6902   to read the explanation. Error explanations are also [available online][err-index].
6903 * Thanks to multiple [improvements][sk] to [type checking][pre], as
6904   well as other work, the time to bootstrap the compiler decreased by
6905   32%.
6906
6907 Libraries
6908 ---------
6909
6910 * The [`str::split_whitespace`] method splits a string on unicode
6911   whitespace boundaries.
6912 * On both Windows and Unix, new extension traits provide conversion of
6913   I/O types to and from the underlying system handles. On Unix, these
6914   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
6915   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
6916   `TcpListener`, and `UpdSocket`. Further implementations for
6917   `std::process` will be stabilized later.
6918 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
6919   Windows, symlinks can be created with
6920   `std::os::windows::symlink_dir` and
6921   `std::os::windows::symlink_file`.
6922 * The `mpsc::Receiver` type can now be converted into an iterator with
6923   `into_iter` on the [`IntoIterator`] trait.
6924 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
6925   implementation of the [`From`] trait.
6926 * The `Debug` implementation for `RangeFull` [creates output that is
6927   more consistent with other implementations][rf].
6928 * [`Debug` is implemented for `File`][file].
6929 * The `Default` implementation for `Arc` [no longer requires `Sync +
6930   Send`][arc].
6931 * [The `Iterator` methods `count`, `nth`, and `last` have been
6932   overridden for slices to have O(1) performance instead of O(n)][si].
6933 * Incorrect handling of paths on Windows has been improved in both the
6934   compiler and the standard library.
6935 * [`AtomicPtr` gained a `Default` implementation][ap].
6936 * In accordance with Rust's policy on arithmetic overflow `abs` now
6937   [panics on overflow when debug assertions are enabled][abs].
6938 * The [`Cloned`] iterator, which was accidentally left unstable for
6939   1.0 [has been stabilized][c].
6940 * The [`Incoming`] iterator, which iterates over incoming TCP
6941   connections, and which was accidentally unnamable in 1.0, [is now
6942   properly exported][inc].
6943 * [`BinaryHeap`] no longer corrupts itself [when functions called by
6944   `sift_up` or `sift_down` panic][bh].
6945 * The [`split_off`] method of `LinkedList` [no longer corrupts
6946   the list in certain scenarios][ll].
6947
6948 Misc
6949 ----
6950
6951 * Type checking performance [has improved notably][sk] with
6952   [multiple improvements][pre].
6953 * The compiler [suggests code changes][ch] for more errors.
6954 * rustc and it's build system have experimental support for [building
6955   toolchains against MUSL][m] instead of glibc on Linux.
6956 * The compiler defines the `target_env` cfg value, which is used for
6957   distinguishing toolchains that are otherwise for the same
6958   platform. Presently this is set to `gnu` for common GNU Linux
6959   targets and for MinGW targets, and `musl` for MUSL Linux targets.
6960 * The [`cargo rustc`][crc] command invokes a build with custom flags
6961   to rustc.
6962 * [Android executables are always position independent][pie].
6963 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
6964   with `Drop`][drop].
6965
6966 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
6967 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
6968 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
6969 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
6970 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
6971 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
6972 [rf]: https://github.com/rust-lang/rust/pull/24491
6973 [err-index]: https://doc.rust-lang.org/error-index.html
6974 [sk]: https://github.com/rust-lang/rust/pull/24615
6975 [pre]: https://github.com/rust-lang/rust/pull/25323
6976 [file]: https://github.com/rust-lang/rust/pull/24598
6977 [ch]: https://github.com/rust-lang/rust/pull/24683
6978 [arc]: https://github.com/rust-lang/rust/pull/24695
6979 [si]: https://github.com/rust-lang/rust/pull/24701
6980 [ap]: https://github.com/rust-lang/rust/pull/24834
6981 [m]: https://github.com/rust-lang/rust/pull/24777
6982 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
6983 [crc]: https://github.com/rust-lang/cargo/pull/1568
6984 [pie]: https://github.com/rust-lang/rust/pull/24953
6985 [abs]: https://github.com/rust-lang/rust/pull/25441
6986 [c]: https://github.com/rust-lang/rust/pull/25496
6987 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
6988 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
6989 [inc]: https://github.com/rust-lang/rust/pull/25522
6990 [bh]: https://github.com/rust-lang/rust/pull/25856
6991 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
6992 [ll]: https://github.com/rust-lang/rust/pull/26022
6993 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
6994 [drop]: https://github.com/rust-lang/rust/pull/24935
6995
6996 Version 1.0.0 (2015-05-15)
6997 ========================
6998
6999 * ~1500 changes, numerous bugfixes
7000
7001 Highlights
7002 ----------
7003
7004 * The vast majority of the standard library is now `#[stable]`. It is
7005   no longer possible to use unstable features with a stable build of
7006   the compiler.
7007 * Many popular crates on [crates.io] now work on the stable release
7008   channel.
7009 * Arithmetic on basic integer types now [checks for overflow in debug
7010   builds][overflow].
7011
7012 Language
7013 --------
7014
7015 * Several [restrictions have been added to trait coherence][coh] in
7016   order to make it easier for upstream authors to change traits
7017   without breaking downstream code.
7018 * Digits of binary and octal literals are [lexed more eagerly][lex] to
7019   improve error messages and macro behavior. For example, `0b1234` is
7020   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
7021 * Trait bounds [are always invariant][inv], eliminating the need for
7022   the `PhantomFn` and `MarkerTrait` lang items, which have been
7023   removed.
7024 * ["-" is no longer a valid character in crate names][cr], the `extern crate
7025   "foo" as bar` syntax has been replaced with `extern crate foo as
7026   bar`, and Cargo now automatically translates "-" in *package* names
7027   to underscore for the crate name.
7028 * [Lifetime shadowing is an error][lt].
7029 * [`Send` no longer implies `'static`][send-rfc].
7030 * [UFCS now supports trait-less associated paths][moar-ufcs] like
7031   `MyType::default()`.
7032 * Primitive types [now have inherent methods][prim-inherent],
7033   obviating the need for extension traits like `SliceExt`.
7034 * Methods with `Self: Sized` in their `where` clause are [considered
7035   object-safe][self-sized], allowing many extension traits like
7036   `IteratorExt` to be merged into the traits they extended.
7037 * You can now [refer to associated types][assoc-where] whose
7038   corresponding trait bounds appear only in a `where` clause.
7039 * The final bits of [OIBIT landed][oibit-final], meaning that traits
7040   like `Send` and `Sync` are now library-defined.
7041 * A [Reflect trait][reflect] was introduced, which means that
7042   downcasting via the `Any` trait is effectively limited to concrete
7043   types. This helps retain the potentially-important "parametricity"
7044   property: generic code cannot behave differently for different type
7045   arguments except in minor ways.
7046 * The `unsafe_destructor` feature is now deprecated in favor of the
7047   [new `dropck`][dropck]. This change is a major reduction in unsafe
7048   code.
7049
7050 Libraries
7051 ---------
7052
7053 * The `thread_local` module [has been renamed to `std::thread`][th].
7054 * The methods of `IteratorExt` [have been moved to the `Iterator`
7055   trait itself][ie].
7056 * Several traits that implement Rust's conventions for type
7057   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
7058   [centralized in the `std::convert` module][con].
7059 * The `FromError` trait [was removed in favor of `From`][fe].
7060 * The basic sleep function [has moved to
7061   `std::thread::sleep_ms`][slp].
7062 * The `splitn` function now takes an `n` parameter that represents the
7063   number of items yielded by the returned iterator [instead of the
7064   number of 'splits'][spl].
7065 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
7066 * [Derived implementations of `PartialOrd` now order enums according
7067   to their explicitly-assigned discriminants][po].
7068 * [Methods for searching strings are generic over `Pattern`s][pat],
7069   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
7070   some others.
7071 * [In method resolution, object methods are resolved before inherent
7072   methods][meth].
7073 * [`String::from_str` has been deprecated in favor of the `From` impl,
7074   `String::from`][sf].
7075 * [`io::Error` implements `Sync`][ios].
7076 * [The `words` method on `&str` has been replaced with
7077   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
7078   a word?'
7079 * The new path and IO modules are complete and `#[stable]`. This
7080   was the major library focus for this cycle.
7081 * The path API was [revised][path-normalize] to normalize `.`,
7082   adjusting the tradeoffs in favor of the most common usage.
7083 * A large number of remaining APIs in `std` were also stabilized
7084   during this cycle; about 75% of the non-deprecated API surface
7085   is now stable.
7086 * The new [string pattern API][string-pattern] landed, which makes
7087   the string slice API much more internally consistent and flexible.
7088 * A new set of [generic conversion traits][conversion] replaced
7089   many existing ad hoc traits.
7090 * Generic numeric traits were [completely removed][num-traits]. This
7091   was made possible thanks to inherent methods for primitive types,
7092   and the removal gives maximal flexibility for designing a numeric
7093   hierarchy in the future.
7094 * The `Fn` traits are now related via [inheritance][fn-inherit]
7095   and provide ergonomic [blanket implementations][fn-blanket].
7096 * The `Index` and `IndexMut` traits were changed to
7097   [take the index by value][index-value], enabling code like
7098   `hash_map["string"]` to work.
7099 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
7100   `Copy` data is known to be `Clone` as well.
7101
7102 Misc
7103 ----
7104
7105 * Many errors now have extended explanations that can be accessed with
7106   the `--explain` flag to `rustc`.
7107 * Many new examples have been added to the standard library
7108   documentation.
7109 * rustdoc has received a number of improvements focused on completion
7110   and polish.
7111 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
7112 * Much headway was made on ecosystem-wide CI, making it possible
7113   to [compare builds for breakage][ci-compare].
7114
7115
7116 [crates.io]: http://crates.io
7117 [clo]: https://github.com/rust-lang/rust/pull/24034
7118 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
7119 [con]: https://github.com/rust-lang/rust/pull/23875
7120 [cr]: https://github.com/rust-lang/rust/pull/23419
7121 [fe]: https://github.com/rust-lang/rust/pull/23879
7122 [ie]: https://github.com/rust-lang/rust/pull/23300
7123 [inv]: https://github.com/rust-lang/rust/pull/23938
7124 [ios]: https://github.com/rust-lang/rust/pull/24133
7125 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
7126 [lt]: https://github.com/rust-lang/rust/pull/24057
7127 [meth]: https://github.com/rust-lang/rust/pull/24056
7128 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
7129 [po]: https://github.com/rust-lang/rust/pull/24270
7130 [sf]: https://github.com/rust-lang/rust/pull/24517
7131 [slp]: https://github.com/rust-lang/rust/pull/23949
7132 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
7133 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
7134 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
7135 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
7136 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
7137 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
7138 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
7139 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
7140 [self-sized]: https://github.com/rust-lang/rust/pull/22301
7141 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
7142 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
7143 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
7144 [reflect]: https://github.com/rust-lang/rust/pull/23712
7145 [conversion]: https://github.com/rust-lang/rfcs/pull/529
7146 [num-traits]: https://github.com/rust-lang/rust/pull/23549
7147 [index-value]: https://github.com/rust-lang/rust/pull/23601
7148 [dropck]: https://github.com/rust-lang/rfcs/pull/769
7149 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
7150 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
7151 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
7152 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
7153 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
7154
7155
7156 Version 1.0.0-alpha.2 (2015-02-20)
7157 =====================================
7158
7159 * ~1300 changes, numerous bugfixes
7160
7161 * Highlights
7162
7163     * The various I/O modules were [overhauled][io-rfc] to reduce
7164       unnecessary abstractions and provide better interoperation with
7165       the underlying platform. The old `io` module remains temporarily
7166       at `std::old_io`.
7167     * The standard library now [participates in feature gating][feat],
7168       so use of unstable libraries now requires a `#![feature(...)]`
7169       attribute. The impact of this change is [described on the
7170       forum][feat-forum]. [RFC][feat-rfc].
7171
7172 * Language
7173
7174     * `for` loops [now operate on the `IntoIterator` trait][into],
7175       which eliminates the need to call `.iter()`, etc. to iterate
7176       over collections. There are some new subtleties to remember
7177       though regarding what sort of iterators various types yield, in
7178       particular that `for foo in bar { }` yields values from a move
7179       iterator, destroying the original collection. [RFC][into-rfc].
7180     * Objects now have [default lifetime bounds][obj], so you don't
7181       have to write `Box<Trait+'static>` when you don't care about
7182       storing references. [RFC][obj-rfc].
7183     * In types that implement `Drop`, [lifetimes must outlive the
7184       value][drop]. This will soon make it possible to safely
7185       implement `Drop` for types where `#[unsafe_destructor]` is now
7186       required. Read the [gorgeous RFC][drop-rfc] for details.
7187     * The fully qualified <T as Trait>::X syntax lets you set the Self
7188       type for a trait method or associated type. [RFC][ufcs-rfc].
7189     * References to types that implement `Deref<U>` now [automatically
7190       coerce to references][deref] to the dereferenced type `U`,
7191       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
7192       should eliminate many unsightly uses of `&*`, as when converting
7193       from references to vectors into references to
7194       slices. [RFC][deref-rfc].
7195     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
7196       `|:|`) is obsolete and closure kind is inferred from context.
7197     * [`Self` is a keyword][Self].
7198
7199 * Libraries
7200
7201     * The `Show` and `String` formatting traits [have been
7202       renamed][fmt] to `Debug` and `Display` to more clearly reflect
7203       their related purposes. Automatically getting a string
7204       conversion to use with `format!("{:?}", something_to_debug)` is
7205       now written `#[derive(Debug)]`.
7206     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
7207       OsStr}`, provide strings in platform-specific encodings for easier
7208       interop with system APIs. [RFC][osstr-rfc].
7209     * The `boxed::into_raw` and `Box::from_raw` functions [convert
7210       between `Box<T>` and `*mut T`][boxraw], a common pattern for
7211       creating raw pointers.
7212
7213 * Tooling
7214
7215     * Certain long error messages of the form 'expected foo found bar'
7216       are now [split neatly across multiple
7217       lines][multiline]. Examples in the PR.
7218     * On Unix Rust can be [uninstalled][un] by running
7219       `/usr/local/lib/rustlib/uninstall.sh`.
7220     * The `#[rustc_on_unimplemented]` attribute, requiring the
7221       'on_unimplemented' feature, lets rustc [display custom error
7222       messages when a trait is expected to be implemented for a type
7223       but is not][onun].
7224
7225 * Misc
7226
7227     * Rust is tested against a [LALR grammar][lalr], which parses
7228       almost all the Rust files that rustc does.
7229
7230 [boxraw]: https://github.com/rust-lang/rust/pull/21318
7231 [close]: https://github.com/rust-lang/rust/pull/21843
7232 [deref]: https://github.com/rust-lang/rust/pull/21351
7233 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
7234 [drop]: https://github.com/rust-lang/rust/pull/21972
7235 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7236 [feat]: https://github.com/rust-lang/rust/pull/21248
7237 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
7238 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
7239 [fmt]: https://github.com/rust-lang/rust/pull/21457
7240 [into]: https://github.com/rust-lang/rust/pull/20790
7241 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
7242 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7243 [lalr]: https://github.com/rust-lang/rust/pull/21452
7244 [multiline]: https://github.com/rust-lang/rust/pull/19870
7245 [obj]: https://github.com/rust-lang/rust/pull/22230
7246 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
7247 [onun]: https://github.com/rust-lang/rust/pull/20889
7248 [osstr]: https://github.com/rust-lang/rust/pull/21488
7249 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7250 [Self]: https://github.com/rust-lang/rust/pull/22158
7251 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
7252 [un]: https://github.com/rust-lang/rust/pull/22256
7253
7254
7255 Version 1.0.0-alpha (2015-01-09)
7256 ==================================
7257
7258   * ~2400 changes, numerous bugfixes
7259
7260   * Highlights
7261
7262     * The language itself is considered feature complete for 1.0,
7263       though there will be many usability improvements and bugfixes
7264       before the final release.
7265     * Nearly 50% of the public API surface of the standard library has
7266       been declared 'stable'. Those interfaces are unlikely to change
7267       before 1.0.
7268     * The long-running debate over integer types has been
7269       [settled][ints]: Rust will ship with types named `isize` and
7270       `usize`, rather than `int` and `uint`, for pointer-sized
7271       integers. Guidelines will be rolled out during the alpha cycle.
7272     * Most crates that are not `std` have been moved out of the Rust
7273       distribution into the Cargo ecosystem so they can evolve
7274       separately and don't need to be stabilized as quickly, including
7275       'time', 'getopts', 'num', 'regex', and 'term'.
7276     * Documentation continues to be expanded with more API coverage, more
7277       examples, and more in-depth explanations. The guides have been
7278       consolidated into [The Rust Programming Language][trpl].
7279     * "[Rust By Example][rbe]" is now maintained by the Rust team.
7280     * All official Rust binary installers now come with [Cargo], the
7281       Rust package manager.
7282
7283 * Language
7284
7285     * Closures have been [completely redesigned][unboxed] to be
7286       implemented in terms of traits, can now be used as generic type
7287       bounds and thus monomorphized and inlined, or via an opaque
7288       pointer (boxed) as in the old system. The new system is often
7289       referred to as 'unboxed' closures.
7290     * Traits now support [associated types][assoc], allowing families
7291       of related types to be defined together and used generically in
7292       powerful ways.
7293     * Enum variants are [namespaced by their type names][enum].
7294     * [`where` clauses][where] provide a more versatile and attractive
7295       syntax for specifying generic bounds, though the previous syntax
7296       remains valid.
7297     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
7298       numeric types.
7299     * Rust [no longer has a runtime][rt] of any description, and only
7300       supports OS threads, not green threads.
7301     * At long last, Rust has been overhauled for 'dynamically-sized
7302       types' ([DST]), which integrates 'fat pointers' (object types,
7303       arrays, and `str`) more deeply into the type system, making it
7304       more consistent.
7305     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
7306       `..j` that produce range types and which, when combined with the
7307       `Index` operator and multidispatch, leads to a convenient slice
7308       notation, `[i..j]`.
7309     * The new range syntax revealed an ambiguity in the fixed-length
7310       array syntax, so now fixed length arrays [are written `[T;
7311       N]`][arrays].
7312     * The `Copy` trait is no longer implemented automatically. Unsafe
7313       pointers no longer implement `Sync` and `Send` so types
7314       containing them don't automatically either. `Sync` and `Send`
7315       are now 'unsafe traits' so one can "forcibly" implement them via
7316       `unsafe impl` if a type confirms to the requirements for them
7317       even though the internals do not (e.g. structs containing unsafe
7318       pointers like `Arc`). These changes are intended to prevent some
7319       footguns and are collectively known as [opt-in built-in
7320       traits][oibit] (though `Sync` and `Send` will soon become pure
7321       library types unknown to the compiler).
7322     * Operator traits now take their operands [by value][ops], and
7323       comparison traits can use multidispatch to compare one type
7324       against multiple other types, allowing e.g. `String` to be
7325       compared with `&str`.
7326     * `if let` and `while let` are no longer feature-gated.
7327     * Rust has adopted a more [uniform syntax for escaping unicode
7328       characters][unicode].
7329     * `macro_rules!` [has been declared stable][mac]. Though it is a
7330       flawed system it is sufficiently popular that it must be usable
7331       for 1.0. Effort has gone into [future-proofing][mac-future] it
7332       in ways that will allow other macro systems to be developed in
7333       parallel, and won't otherwise impact the evolution of the
7334       language.
7335     * The prelude has been [pared back significantly][prelude] such
7336       that it is the minimum necessary to support the most pervasive
7337       code patterns, and through [generalized where clauses][where]
7338       many of the prelude extension traits have been consolidated.
7339     * Rust's rudimentary reflection [has been removed][refl], as it
7340       incurred too much code generation for little benefit.
7341     * [Struct variants][structvars] are no longer feature-gated.
7342     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
7343       known as 'higher-ranked trait bounds', this crucially allows
7344       unboxed closures to work.
7345     * Macros invocations surrounded by parens or square brackets and
7346       not terminated by a semicolon are [parsed as
7347       expressions][macros], which makes expressions like `vec![1i32,
7348       2, 3].len()` work as expected.
7349     * Trait objects now implement their traits automatically, and
7350       traits that can be coerced to objects now must be [object
7351       safe][objsafe].
7352     * Automatically deriving traits is now done with `#[derive(...)]`
7353       not `#[deriving(...)]` for [consistency with other naming
7354       conventions][derive].
7355     * Importing the containing module or enum at the same time as
7356       items or variants they contain is [now done with `self` instead
7357       of `mod`][self], as in use `foo::{self, bar}`
7358     * Glob imports are no longer feature-gated.
7359     * The `box` operator and `box` patterns have been feature-gated
7360       pending a redesign. For now unique boxes should be allocated
7361       like other containers, with `Box::new`.
7362
7363 * Libraries
7364
7365     * A [series][coll1] of [efforts][coll2] to establish
7366       [conventions][coll3] for collections types has resulted in API
7367       improvements throughout the standard library.
7368     * New [APIs for error handling][err] provide ergonomic interop
7369       between error types, and [new conventions][err-conv] describe
7370       more clearly the recommended error handling strategies in Rust.
7371     * The `fail!` macro has been renamed to [`panic!`][panic] so that
7372       it is easier to discuss failure in the context of error handling
7373       without making clarifications as to whether you are referring to
7374       the 'fail' macro or failure more generally.
7375     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
7376       syscall when available.
7377     * The 'serialize' crate has been renamed 'rustc-serialize' and
7378       moved out of the distribution to Cargo. Although it is widely
7379       used now, it is expected to be superseded in the near future.
7380     * The `Show` formatter, typically implemented with
7381       `#[derive(Show)]` is [now requested with the `{:?}`
7382       specifier][show] and is intended for use by all types, for uses
7383       such as `println!` debugging. The new `String` formatter must be
7384       implemented by hand, uses the `{}` specifier, and is intended
7385       for full-fidelity conversions of things that can logically be
7386       represented as strings.
7387
7388 * Tooling
7389
7390     * [Flexible target specification][flex] allows rustc's code
7391       generation to be configured to support otherwise-unsupported
7392       platforms.
7393     * Rust comes with rust-gdb and rust-lldb scripts that launch their
7394       respective debuggers with Rust-appropriate pretty-printing.
7395     * The Windows installation of Rust is distributed with the
7396       MinGW components currently required to link binaries on that
7397       platform.
7398
7399 * Misc
7400
7401     * Nullable enum optimizations have been extended to more types so
7402       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
7403       space than the inner types themselves.
7404     * Work has begun on supporting AArch64.
7405
7406 [Cargo]: https://crates.io
7407 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
7408 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
7409 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
7410 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
7411 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
7412 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
7413 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
7414 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
7415 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
7416 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
7417 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
7418 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
7419 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
7420 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
7421 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
7422 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
7423 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
7424 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
7425 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
7426 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
7427 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
7428 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
7429 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
7430 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
7431 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
7432 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
7433 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
7434 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
7435 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
7436 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
7437 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
7438 [trpl]: https://doc.rust-lang.org/book/index.html
7439 [rbe]: http://rustbyexample.com/
7440
7441
7442 Version 0.12.0 (2014-10-09)
7443 =============================
7444
7445   * ~1900 changes, numerous bugfixes
7446
7447   * Highlights
7448
7449     * The introductory documentation (now called The Rust Guide) has
7450       been completely rewritten, as have a number of supplementary
7451       guides.
7452     * Rust's package manager, Cargo, continues to improve and is
7453       sometimes considered to be quite awesome.
7454     * Many API's in `std` have been reviewed and updated for
7455       consistency with the in-development Rust coding
7456       guidelines. The standard library documentation tracks
7457       stabilization progress.
7458     * Minor libraries have been moved out-of-tree to the rust-lang org
7459       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
7460       be installed with Cargo.
7461     * Lifetime elision allows lifetime annotations to be left off of
7462       function declarations in many common scenarios.
7463     * Rust now works on 64-bit Windows.
7464
7465   * Language
7466     * Indexing can be overloaded with the `Index` and `IndexMut`
7467       traits.
7468     * The `if let` construct takes a branch only if the `let` pattern
7469       matches, currently behind the 'if_let' feature gate.
7470     * 'where clauses', a more flexible syntax for specifying trait
7471       bounds that is more aesthetic, have been added for traits and
7472       free functions. Where clauses will in the future make it
7473       possible to constrain associated types, which would be
7474       impossible with the existing syntax.
7475     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
7476       the 'slicing_syntax' feature gate, and can be overloaded with
7477       the `Slice` or `SliceMut` traits.
7478     * The syntax for matching of sub-slices has been changed to use a
7479       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
7480       consistency with other uses of `..` and to future-proof
7481       potential additional uses of the syntax.
7482     * The syntax for matching inclusive ranges in patterns has changed
7483       from `0..3` to `0...4` to be consistent with the exclusive range
7484       syntax for slicing.
7485     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
7486       c]`) has been put behind the 'advanced_slice_patterns' feature
7487       gate and may be removed in the future.
7488     * Components of tuples and tuple structs can be extracted using
7489       the `value.0` syntax, currently behind the `tuple_indexing`
7490       feature gate.
7491     * The `#[crate_id]` attribute is no longer supported; versioning
7492       is handled by the package manager.
7493     * Renaming crate imports are now written `extern crate foo as bar`
7494       instead of `extern crate bar = foo`.
7495     * Renaming use statements are now written `use foo as bar` instead
7496       of `use bar = foo`.
7497     * `let` and `match` bindings and argument names in macros are now
7498       hygienic.
7499     * The new, more efficient, closure types ('unboxed closures') have
7500       been added under a feature gate, 'unboxed_closures'. These will
7501       soon replace the existing closure types, once higher-ranked
7502       trait lifetimes are added to the language.
7503     * `move` has been added as a keyword, for indicating closures
7504       that capture by value.
7505     * Mutation and assignment is no longer allowed in pattern guards.
7506     * Generic structs and enums can now have trait bounds.
7507     * The `Share` trait is now called `Sync` to free up the term
7508       'shared' to refer to 'shared reference' (the default reference
7509       type.
7510     * Dynamically-sized types have been mostly implemented,
7511       unifying the behavior of fat-pointer types with the rest of the
7512       type system.
7513     * As part of dynamically-sized types, the `Sized` trait has been
7514       introduced, which qualifying types implement by default, and
7515       which type parameters expect by default. To specify that a type
7516       parameter does not need to be sized, write `<Sized? T>`. Most
7517       types are `Sized`, notable exceptions being unsized arrays
7518       (`[T]`) and trait types.
7519     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
7520     * Lifetime bounds can now be applied to type parameters and object
7521       types.
7522     * The old, reference counted GC type, `Gc<T>` which was once
7523       denoted by the `@` sigil, has finally been removed. GC will be
7524       revisited in the future.
7525
7526   * Libraries
7527     * Library documentation has been improved for a number of modules.
7528     * Bit-vectors, collections::bitv has been modernized.
7529     * The url crate is deprecated in favor of
7530       http://github.com/servo/rust-url, which can be installed with
7531       Cargo.
7532     * Most I/O stream types can be cloned and subsequently closed from
7533       a different thread.
7534     * A `std::time::Duration` type has been added for use in I/O
7535       methods that rely on timers, as well as in the 'time' crate's
7536       `Timespec` arithmetic.
7537     * The runtime I/O abstraction layer that enabled the green thread
7538       scheduler to do non-thread-blocking I/O has been removed, along
7539       with the libuv-based implementation employed by the green thread
7540       scheduler. This will greatly simplify the future I/O work.
7541     * `collections::btree` has been rewritten to have a more
7542       idiomatic and efficient design.
7543
7544   * Tooling
7545     * rustdoc output now indicates the stability levels of API's.
7546     * The `--crate-name` flag can specify the name of the crate
7547       being compiled, like `#[crate_name]`.
7548     * The `-C metadata` specifies additional metadata to hash into
7549       symbol names, and `-C extra-filename` specifies additional
7550       information to put into the output filename, for use by the
7551       package manager for versioning.
7552     * debug info generation has continued to improve and should be
7553       more reliable under both gdb and lldb.
7554     * rustc has experimental support for compiling in parallel
7555       using the `-C codegen-units` flag.
7556     * rustc no longer encodes rpath information into binaries by
7557       default.
7558
7559   * Misc
7560     * Stack usage has been optimized with LLVM lifetime annotations.
7561     * Official Rust binaries on Linux are more compatible with older
7562       kernels and distributions, built on CentOS 5.10.
7563
7564
7565 Version 0.11.0 (2014-07-02)
7566 ==========================
7567
7568   * ~1700 changes, numerous bugfixes
7569
7570   * Language
7571     * ~[T] has been removed from the language. This type is superseded by
7572       the Vec<T> type.
7573     * ~str has been removed from the language. This type is superseded by
7574       the String type.
7575     * ~T has been removed from the language. This type is superseded by the
7576       Box<T> type.
7577     * @T has been removed from the language. This type is superseded by the
7578       standard library's std::gc::Gc<T> type.
7579     * Struct fields are now all private by default.
7580     * Vector indices and shift amounts are both required to be a `uint`
7581       instead of any integral type.
7582     * Byte character, byte string, and raw byte string literals are now all
7583       supported by prefixing the normal literal with a `b`.
7584     * Multiple ABIs are no longer allowed in an ABI string
7585     * The syntax for lifetimes on closures/procedures has been tweaked
7586       slightly: `<'a>|A, B|: 'b + K -> T`
7587     * Floating point modulus has been removed from the language; however it
7588       is still provided by a library implementation.
7589     * Private enum variants are now disallowed.
7590     * The `priv` keyword has been removed from the language.
7591     * A closure can no longer be invoked through a &-pointer.
7592     * The `use foo, bar, baz;` syntax has been removed from the language.
7593     * The transmute intrinsic no longer works on type parameters.
7594     * Statics now allow blocks/items in their definition.
7595     * Trait bounds are separated from objects with + instead of : now.
7596     * Objects can no longer be read while they are mutably borrowed.
7597     * The address of a static is now marked as insignificant unless the
7598       #[inline(never)] attribute is placed it.
7599     * The #[unsafe_destructor] attribute is now behind a feature gate.
7600     * Struct literals are no longer allowed in ambiguous positions such as
7601       if, while, match, and for..in.
7602     * Declaration of lang items and intrinsics are now feature-gated by
7603       default.
7604     * Integral literals no longer default to `int`, and floating point
7605       literals no longer default to `f64`. Literals must be suffixed with an
7606       appropriate type if inference cannot determine the type of the
7607       literal.
7608     * The Box<T> type is no longer implicitly borrowed to &mut T.
7609     * Procedures are now required to not capture borrowed references.
7610
7611   * Libraries
7612     * The standard library is now a "facade" over a number of underlying
7613       libraries. This means that development on the standard library should
7614       be speedier due to smaller crates, as well as a clearer line between
7615       all dependencies.
7616     * A new library, libcore, lives under the standard library's facade
7617       which is Rust's "0-assumption" library, suitable for embedded and
7618       kernel development for example.
7619     * A regex crate has been added to the standard distribution. This crate
7620       includes statically compiled regular expressions.
7621     * The unwrap/unwrap_err methods on Result require a Show bound for
7622       better error messages.
7623     * The return types of the std::comm primitives have been centralized
7624       around the Result type.
7625     * A number of I/O primitives have gained the ability to time out their
7626       operations.
7627     * A number of I/O primitives have gained the ability to close their
7628       reading/writing halves to cancel pending operations.
7629     * Reverse iterator methods have been removed in favor of `rev()` on
7630       their forward-iteration counterparts.
7631     * A bitflags! macro has been added to enable easy interop with C and
7632       management of bit flags.
7633     * A debug_assert! macro is now provided which is disabled when
7634       `--cfg ndebug` is passed to the compiler.
7635     * A graphviz crate has been added for creating .dot files.
7636     * The std::cast module has been migrated into std::mem.
7637     * The std::local_data api has been migrated from freestanding functions
7638       to being based on methods.
7639     * The Pod trait has been renamed to Copy.
7640     * jemalloc has been added as the default allocator for types.
7641     * The API for allocating memory has been changed to use proper alignment
7642       and sized deallocation
7643     * Connecting a TcpStream or binding a TcpListener is now based on a
7644       string address and a u16 port. This allows connecting to a hostname as
7645       opposed to an IP.
7646     * The Reader trait now contains a core method, read_at_least(), which
7647       correctly handles many repeated 0-length reads.
7648     * The process-spawning API is now centered around a builder-style
7649       Command struct.
7650     * The :? printing qualifier has been moved from the standard library to
7651       an external libdebug crate.
7652     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
7653       have been renamed to Eq/Ord.
7654     * The select/plural methods have been removed from format!. The escapes
7655       for { and } have also changed from \{ and \} to {{ and }},
7656       respectively.
7657     * The TaskBuilder API has been re-worked to be a true builder, and
7658       extension traits for spawning native/green tasks have been added.
7659
7660   * Tooling
7661     * All breaking changes to the language or libraries now have their
7662       commit message annotated with `[breaking-change]` to allow for easy
7663       discovery of breaking changes.
7664     * The compiler will now try to suggest how to annotate lifetimes if a
7665       lifetime-related error occurs.
7666     * Debug info continues to be improved greatly with general bug fixes and
7667       better support for situations like link time optimization (LTO).
7668     * Usage of syntax extensions when cross-compiling has been fixed.
7669     * Functionality equivalent to GCC & Clang's -ffunction-sections,
7670       -fdata-sections and --gc-sections has been enabled by default
7671     * The compiler is now stricter about where it will load module files
7672       from when a module is declared via `mod foo;`.
7673     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
7674       Syntax extensions are now discovered via a "plugin registrar" type
7675       which will be extended in the future to other various plugins.
7676     * Lints have been restructured to allow for dynamically loadable lints.
7677     * A number of rustdoc improvements:
7678       * The HTML output has been visually redesigned.
7679       * Markdown is now powered by hoedown instead of sundown.
7680       * Searching heuristics have been greatly improved.
7681       * The search index has been reduced in size by a great amount.
7682       * Cross-crate documentation via `pub use` has been greatly improved.
7683       * Primitive types are now hyperlinked and documented.
7684     * Documentation has been moved from static.rust-lang.org/doc to
7685       doc.rust-lang.org
7686     * A new sandbox, play.rust-lang.org, is available for running and
7687       sharing rust code examples on-line.
7688     * Unused attributes are now more robustly warned about.
7689     * The dead_code lint now warns about unused struct fields.
7690     * Cross-compiling to iOS is now supported.
7691     * Cross-compiling to mipsel is now supported.
7692     * Stability attributes are now inherited by default and no longer apply
7693       to intra-crate usage, only inter-crate usage.
7694     * Error message related to non-exhaustive match expressions have been
7695       greatly improved.
7696
7697
7698 Version 0.10 (2014-04-03)
7699 =========================
7700
7701   * ~1500 changes, numerous bugfixes
7702
7703   * Language
7704     * A new RFC process is now in place for modifying the language.
7705     * Patterns with `@`-pointers have been removed from the language.
7706     * Patterns with unique vectors (`~[T]`) have been removed from the
7707       language.
7708     * Patterns with unique strings (`~str`) have been removed from the
7709       language.
7710     * `@str` has been removed from the language.
7711     * `@[T]` has been removed from the language.
7712     * `@self` has been removed from the language.
7713     * `@Trait` has been removed from the language.
7714     * Headers on `~` allocations which contain `@` boxes inside the type for
7715       reference counting have been removed.
7716     * The semantics around the lifetimes of temporary expressions have changed,
7717       see #3511 and #11585 for more information.
7718     * Cross-crate syntax extensions are now possible, but feature gated. See
7719       #11151 for more information. This includes both `macro_rules!` macros as
7720       well as syntax extensions such as `format!`.
7721     * New lint modes have been added, and older ones have been turned on to be
7722       warn-by-default.
7723       * Unnecessary parentheses
7724       * Uppercase statics
7725       * Camel Case types
7726       * Uppercase variables
7727       * Publicly visible private types
7728       * `#[deriving]` with raw pointers
7729     * Unsafe functions can no longer be coerced to closures.
7730     * Various obscure macros such as `log_syntax!` are now behind feature gates.
7731     * The `#[simd]` attribute is now behind a feature gate.
7732     * Visibility is no longer allowed on `extern crate` statements, and
7733       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
7734     * Trailing commas are now allowed in argument lists and tuple patterns.
7735     * The `do` keyword has been removed, it is now a reserved keyword.
7736     * Default type parameters have been implemented, but are feature gated.
7737     * Borrowed variables through captures in closures are now considered soundly.
7738     * `extern mod` is now `extern crate`
7739     * The `Freeze` trait has been removed.
7740     * The `Share` trait has been added for types that can be shared among
7741       threads.
7742     * Labels in macros are now hygienic.
7743     * Expression/statement macro invocations can be delimited with `{}` now.
7744     * Treatment of types allowed in `static mut` locations has been tweaked.
7745     * The `*` and `.` operators are now overloadable through the `Deref` and
7746       `DerefMut` traits.
7747     * `~Trait` and `proc` no longer have `Send` bounds by default.
7748     * Partial type hints are now supported with the `_` type marker.
7749     * An `Unsafe` type was introduced for interior mutability. It is now
7750       considered undefined to transmute from `&T` to `&mut T` without using the
7751       `Unsafe` type.
7752     * The #[linkage] attribute was implemented for extern statics/functions.
7753     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
7754     * `Pod` was renamed to `Copy`.
7755
7756   * Libraries
7757     * The `libextra` library has been removed. It has now been decomposed into
7758       component libraries with smaller and more focused nuggets of
7759       functionality. The full list of libraries can be found on the
7760       documentation index page.
7761     * std: `std::condition` has been removed. All I/O errors are now propagated
7762       through the `Result` type. In order to assist with error handling, a
7763       `try!` macro for unwrapping errors with an early return and a lint for
7764       unused results has been added. See #12039 for more information.
7765     * std: The `vec` module has been renamed to `slice`.
7766     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
7767       This will become the only growable vector in the future.
7768     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
7769       are now found at `std::io::BufferedReader` instead of
7770       `std::io::buffered::BufferedReader`.
7771     * std: `print` and `println` are no longer in the prelude, the `print!` and
7772       `println!` macros are intended to be used instead.
7773     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
7774       attempts to statically prevent cycles.
7775     * std: The standard distribution is adopting the policy of pushing failure
7776       to the user rather than failing in libraries. Many functions (such as
7777       `slice::last()`) now return `Option<T>` instead of `T` + failing.
7778     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
7779       deriving mode: `#[deriving(Show)]`.
7780     * std: `ToStr` is now implemented for all types implementing `Show`.
7781     * std: The formatting trait methods now take `&self` instead of `&T`
7782     * std: The `invert()` method on iterators has been renamed to `rev()`
7783     * std: `std::num` has seen a reduction in the genericity of its traits,
7784       consolidating functionality into a few core traits.
7785     * std: Backtraces are now printed on task failure if the environment
7786       variable `RUST_BACKTRACE` is present.
7787     * std: Naming conventions for iterators have been standardized. More details
7788       can be found on the wiki's style guide.
7789     * std: `eof()` has been removed from the `Reader` trait. Specific types may
7790       still implement the function.
7791     * std: Networking types are now cloneable to allow simultaneous reads/writes.
7792     * std: `assert_approx_eq!` has been removed
7793     * std: The `e` and `E` formatting specifiers for floats have been added to
7794       print them in exponential notation.
7795     * std: The `Times` trait has been removed
7796     * std: Indications of variance and opting out of builtin bounds is done
7797       through marker types in `std::kinds::marker` now
7798     * std: `hash` has been rewritten, `IterBytes` has been removed, and
7799       `#[deriving(Hash)]` is now possible.
7800     * std: `SharedChan` has been removed, `Sender` is now cloneable.
7801     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
7802     * std: `Chan::new` is now `channel()`.
7803     * std: A new synchronous channel type has been implemented.
7804     * std: A `select!` macro is now provided for selecting over `Receiver`s.
7805     * std: `hashmap` and `trie` have been moved to `libcollections`
7806     * std: `run` has been rolled into `io::process`
7807     * std: `assert_eq!` now uses `{}` instead of `{:?}`
7808     * std: The equality and comparison traits have seen some reorganization.
7809     * std: `rand` has moved to `librand`.
7810     * std: `to_{lower,upper}case` has been implemented for `char`.
7811     * std: Logging has been moved to `liblog`.
7812     * collections: `HashMap` has been rewritten for higher performance and less
7813       memory usage.
7814     * native: The default runtime is now `libnative`. If `libgreen` is desired,
7815       it can be booted manually. The runtime guide has more information and
7816       examples.
7817     * native: All I/O functionality except signals has been implemented.
7818     * green: Task spawning with `libgreen` has been optimized with stack caching
7819       and various trimming of code.
7820     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
7821     * sync: The `extra::sync` module has been updated to modern rust (and moved
7822       to the `sync` library), tweaking and improving various interfaces while
7823       dropping redundant functionality.
7824     * sync: A new `Barrier` type has been added to the `sync` library.
7825     * sync: An efficient mutex for native and green tasks has been implemented.
7826     * serialize: The `base64` module has seen some improvement. It treats
7827       newlines better, has non-string error values, and has seen general
7828       cleanup.
7829     * fourcc: A `fourcc!` macro was introduced
7830     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
7831       hexadecimal literal.
7832
7833   * Tooling
7834     * `rustpkg` has been deprecated and removed from the main repository. Its
7835       replacement, `cargo`, is under development.
7836     * Nightly builds of rust are now available
7837     * The memory usage of rustc has been improved many times throughout this
7838       release cycle.
7839     * The build process supports disabling rpath support for the rustc binary
7840       itself.
7841     * Code generation has improved in some cases, giving more information to the
7842       LLVM optimization passes to enable more extensive optimizations.
7843     * Debuginfo compatibility with lldb on OSX has been restored.
7844     * The master branch is now gated on an android bot, making building for
7845       android much more reliable.
7846     * Output flags have been centralized into one `--emit` flag.
7847     * Crate type flags have been centralized into one `--crate-type` flag.
7848     * Codegen flags have been consolidated behind a `-C` flag.
7849     * Linking against outdated crates now has improved error messages.
7850     * Error messages with lifetimes will often suggest how to annotate the
7851       function to fix the error.
7852     * Many more types are documented in the standard library, and new guides
7853       were written.
7854     * Many `rustdoc` improvements:
7855       * code blocks are syntax highlighted.
7856       * render standalone markdown files.
7857       * the --test flag tests all code blocks by default.
7858       * exported macros are displayed.
7859       * re-exported types have their documentation inlined at the location of the
7860         first re-export.
7861       * search works across crates that have been rendered to the same output
7862         directory.
7863
7864
7865 Version 0.9 (2014-01-09)
7866 ==========================
7867
7868    * ~1800 changes, numerous bugfixes
7869
7870    * Language
7871       * The `float` type has been removed. Use `f32` or `f64` instead.
7872       * A new facility for enabling experimental features (feature gating) has
7873         been added, using the crate-level `#[feature(foo)]` attribute.
7874       * Managed boxes (@) are now behind a feature gate
7875         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
7876         standard library's `Gc` or `Rc` types instead.
7877       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
7878       * Jumping back to the top of a loop is now done with `continue` instead of
7879         `loop`.
7880       * Strings can no longer be mutated through index assignment.
7881       * Raw strings can be created via the basic `r"foo"` syntax or with matched
7882         hash delimiters, as in `r###"foo"###`.
7883       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
7884         called once.
7885       * The `&fn` type is now written `|args| -> ret` to match the literal form.
7886       * `@fn`s have been removed.
7887       * `do` only works with procs in order to make it obvious what the cost
7888         of `do` is.
7889       * Single-element tuple-like structs can no longer be dereferenced to
7890         obtain the inner value. A more comprehensive solution for overloading
7891         the dereference operator will be provided in the future.
7892       * The `#[link(...)]` attribute has been replaced with
7893         `#[crate_id = "name#vers"]`.
7894       * Empty `impl`s must be terminated with empty braces and may not be
7895         terminated with a semicolon.
7896       * Keywords are no longer allowed as lifetime names; the `self` lifetime
7897         no longer has any special meaning.
7898       * The old `fmt!` string formatting macro has been removed.
7899       * `printf!` and `printfln!` (old-style formatting) removed in favor of
7900         `print!` and `println!`.
7901       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
7902       * The `extern mod foo (name = "bar")` syntax has been removed. Use
7903         `extern mod foo = "bar"` instead.
7904       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
7905       * Macros can have attributes.
7906       * Macros can expand to items with attributes.
7907       * Macros can expand to multiple items.
7908       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
7909       * Comments may be nested.
7910       * Values automatically coerce to trait objects they implement, without
7911         an explicit `as`.
7912       * Enum discriminants are no longer an entire word but as small as needed to
7913         contain all the variants. The `repr` attribute can be used to override
7914         the discriminant size, as in `#[repr(int)]` for integer-sized, and
7915         `#[repr(C)]` to match C enums.
7916       * Non-string literals are not allowed in attributes (they never worked).
7917       * The FFI now supports variadic functions.
7918       * Octal numeric literals, as in `0o7777`.
7919       * The `concat!` syntax extension performs compile-time string concatenation.
7920       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
7921         removed as Rust no longer uses segmented stacks.
7922       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
7923       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
7924         not `*`; ignoring remaining fields of a struct is also done with `..`,
7925         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
7926       * `rustc` supports the "win64" calling convention via `extern "win64"`.
7927       * `rustc` supports the "system" calling convention, which defaults to the
7928         preferred convention for the target platform, "stdcall" on 32-bit Windows,
7929         "C" elsewhere.
7930       * The `type_overflow` lint (default: warn) checks literals for overflow.
7931       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
7932       * The `attribute_usage` lint (default: warn) warns about unknown
7933         attributes.
7934       * The `unknown_features` lint (default: warn) warns about unknown
7935         feature gates.
7936       * The `dead_code` lint (default: warn) checks for dead code.
7937       * Rust libraries can be linked statically to one another
7938       * `#[link_args]` is behind the `link_args` feature gate.
7939       * Native libraries are now linked with `#[link(name = "foo")]`
7940       * Native libraries can be statically linked to a rust crate
7941         (`#[link(name = "foo", kind = "static")]`).
7942       * Native OS X frameworks are now officially supported
7943         (`#[link(name = "foo", kind = "framework")]`).
7944       * The `#[thread_local]` attribute creates thread-local (not task-local)
7945         variables. Currently behind the `thread_local` feature gate.
7946       * The `return` keyword may be used in closures.
7947       * Types that can be copied via a memcpy implement the `Pod` kind.
7948       * The `cfg` attribute can now be used on struct fields and enum variants.
7949
7950    * Libraries
7951       * std: The `option` and `result` API's have been overhauled to make them
7952         simpler, more consistent, and more composable.
7953       * std: The entire `std::io` module has been replaced with one that is
7954         more comprehensive and that properly interfaces with the underlying
7955         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
7956         implemented.
7957       * std: `io::util` contains a number of useful implementations of
7958         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
7959         `ZeroReader`, `TeeReader`.
7960       * std: The reference counted pointer type `extra::rc` moved into std.
7961       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
7962         just a wrapper around it).
7963       * std: The `Either` type has been removed.
7964       * std: `fmt::Default` can be implemented for any type to provide default
7965         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
7966       * std: The `rand` API continues to be tweaked.
7967       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
7968         on failure in gdb, is now named `rust_fail`.
7969       * std: The `each_key` and `each_value` methods on `HashMap` have been
7970         replaced by the `keys` and `values` iterators.
7971       * std: Functions dealing with type size and alignment have moved from the
7972         `sys` module to the `mem` module.
7973       * std: The `path` module was written and API changed.
7974       * std: `str::from_utf8` has been changed to cast instead of allocate.
7975       * std: `starts_with` and `ends_with` methods added to vectors via the
7976         `ImmutableEqVector` trait, which is in the prelude.
7977       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
7978         if the index is out of bounds.
7979       * std: Task failure no longer propagates between tasks, as the model was
7980         complex, expensive, and incompatible with thread-based tasks.
7981       * std: The `Any` type can be used for dynamic typing.
7982       * std: `~Any` can be passed to the `fail!` macro and retrieved via
7983         `task::try`.
7984       * std: Methods that produce iterators generally do not have an `_iter`
7985         suffix now.
7986       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
7987         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
7988       * std: `util::ignore` renamed to `prelude::drop`.
7989       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
7990         trait.
7991       * std: `vec::raw` has seen a lot of cleanup and API changes.
7992       * std: The standard library no longer includes any C++ code, and very
7993         minimal C, eliminating the dependency on libstdc++.
7994       * std: Runtime scheduling and I/O functionality has been factored out into
7995         extensible interfaces and is now implemented by two different crates:
7996         libnative, for native threading and I/O; and libgreen, for green threading
7997         and I/O. This paves the way for using the standard library in more limited
7998         embedded environments.
7999       * std: The `comm` module has been rewritten to be much faster, have a
8000         simpler, more consistent API, and to work for both native and green
8001         threading.
8002       * std: All libuv dependencies have been moved into the rustuv crate.
8003       * native: New implementations of runtime scheduling on top of OS threads.
8004       * native: New native implementations of TCP, UDP, file I/O, process spawning,
8005         and other I/O.
8006       * green: The green thread scheduler and message passing types are almost
8007         entirely lock-free.
8008       * extra: The `flatpipes` module had bitrotted and was removed.
8009       * extra: All crypto functions have been removed and Rust now has a policy of
8010         not reimplementing crypto in the standard library. In the future crypto
8011         will be provided by external crates with bindings to established libraries.
8012       * extra: `c_vec` has been modernized.
8013       * extra: The `sort` module has been removed. Use the `sort` method on
8014         mutable slices.
8015
8016    * Tooling
8017       * The `rust` and `rusti` commands have been removed, due to lack of
8018         maintenance.
8019       * `rustdoc` was completely rewritten.
8020       * `rustdoc` can test code examples in documentation.
8021       * `rustpkg` can test packages with the argument, 'test'.
8022       * `rustpkg` supports arbitrary dependencies, including C libraries.
8023       * `rustc`'s support for generating debug info is improved again.
8024       * `rustc` has better error reporting for unbalanced delimiters.
8025       * `rustc`'s JIT support was removed due to bitrot.
8026       * Executables and static libraries can be built with LTO (-Z lto)
8027       * `rustc` adds a `--dep-info` flag for communicating dependencies to
8028         build tools.
8029
8030
8031 Version 0.8 (2013-09-26)
8032 ============================
8033
8034    * ~2200 changes, numerous bugfixes
8035
8036    * Language
8037       * The `for` loop syntax has changed to work with the `Iterator` trait.
8038       * At long last, unwinding works on Windows.
8039       * Default methods are ready for use.
8040       * Many trait inheritance bugs fixed.
8041       * Owned and borrowed trait objects work more reliably.
8042       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
8043       * rustc can omit emission of code for the `debug!` macro if it is passed
8044         `--cfg ndebug`
8045       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
8046         for foo.rs, then foo/mod.rs, and will generate an error when both are
8047         present.
8048       * Strings no longer contain trailing nulls. The new `std::c_str` module
8049         provides new mechanisms for converting to C strings.
8050       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
8051       * The FFI has been overhauled such that foreign functions are called directly,
8052         instead of through a stack-switching wrapper.
8053       * Calling a foreign function must be done through a Rust function with the
8054         `#[fixed_stack_segment]` attribute.
8055       * The `externfn!` macro can be used to declare both a foreign function and
8056         a `#[fixed_stack_segment]` wrapper at once.
8057       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
8058       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
8059       * `priv` is disallowed everywhere except for struct fields and enum variants.
8060       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
8061       * `ref` bindings in irrefutable patterns work correctly now.
8062       * `char` is now prevented from containing invalid code points.
8063       * Casting to `bool` is no longer allowed.
8064       * `\0` is now accepted as an escape in chars and strings.
8065       * `yield` is a reserved keyword.
8066       * `typeof` is a reserved keyword.
8067       * Crates may be imported by URL with `extern mod foo = "url";`.
8068       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
8069       * Static vectors can be initialized with repeating elements,
8070         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
8071       * Static structs can be initialized with functional record update,
8072         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
8073       * `cfg!` can be used to conditionally execute code based on the crate
8074         configuration, similarly to `#[cfg(...)]`.
8075       * The `unnecessary_qualification` lint detects unneeded module
8076         prefixes (default: allow).
8077       * Arithmetic operations have been implemented on the SIMD types in
8078         `std::unstable::simd`.
8079       * Exchange allocation headers were removed, reducing memory usage.
8080       * `format!` implements a completely new, extensible, and higher-performance
8081         string formatting system. It will replace `fmt!`.
8082       * `print!` and `println!` write formatted strings (using the `format!`
8083         extension) to stdout.
8084       * `write!` and `writeln!` write formatted strings (using the `format!`
8085         extension) to the new Writers in `std::rt::io`.
8086       * The library section in which a function or static is placed may
8087         be specified with `#[link_section = "..."]`.
8088       * The `proto!` syntax extension for defining bounded message protocols
8089         was removed.
8090       * `macro_rules!` is hygienic for `let` declarations.
8091       * The `#[export_name]` attribute specifies the name of a symbol.
8092       * `unreachable!` can be used to indicate unreachable code, and fails
8093         if executed.
8094
8095    * Libraries
8096       * std: Transitioned to the new runtime, written in Rust.
8097       * std: Added an experimental I/O library, `rt::io`, based on the new
8098         runtime.
8099       * std: A new generic `range` function was added to the prelude, replacing
8100         `uint::range` and friends.
8101       * std: `range_rev` no longer exists. Since range is an iterator it can be
8102         reversed with `range(lo, hi).invert()`.
8103       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
8104         renamed to `unwrap_or`.
8105       * std: The `iterator` module was renamed to `iter`.
8106       * std: Integral types now support the `checked_add`, `checked_sub`, and
8107         `checked_mul` operations for detecting overflow.
8108       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
8109         consistency.
8110       * std: Methods are standardizing on conventions for casting methods:
8111         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
8112         and cheap casts.
8113       * std: The `CString` type in `c_str` provides new ways to convert to and
8114         from C strings.
8115       * std: `DoubleEndedIterator` can yield elements in two directions.
8116       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
8117         two splices.
8118       * std: `str::from_bytes` renamed to `str::from_utf8`.
8119       * std: `pop_opt` and `shift_opt` methods added to vectors.
8120       * std: The task-local data interface no longer uses @, and keys are
8121         no longer function pointers.
8122       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
8123       * std: Added `SharedPort` to `comm`.
8124       * std: `Eq` has a default method for `ne`; only `eq` is required
8125         in implementations.
8126       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
8127         is required in implementations.
8128       * std: `is_utf8` performance is improved, impacting many string functions.
8129       * std: `os::MemoryMap` provides cross-platform mmap.
8130       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
8131         are not 'in-bounds' are considered undefined.
8132       * std: Many freestanding functions in `vec` removed in favor of methods.
8133       * std: Many freestanding functions on scalar types removed in favor of
8134         methods.
8135       * std: Many options to task builders were removed since they don't make
8136         sense in the new scheduler design.
8137       * std: More containers implement `FromIterator` so can be created by the
8138         `collect` method.
8139       * std: More complete atomic types in `unstable::atomics`.
8140       * std: `comm::PortSet` removed.
8141       * std: Mutating methods in the `Set` and `Map` traits have been moved into
8142         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
8143         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
8144         default implementations.
8145       * std: Various `from_str` functions were removed in favor of a generic
8146         `from_str` which is available in the prelude.
8147       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
8148       * extra: `dlist`, the doubly-linked list was modernized.
8149       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
8150       * extra: Added `glob` module, replacing `std::os::glob`.
8151       * extra: `rope` was removed.
8152       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
8153       * extra: `net`, and `timer` were removed. The experimental replacements
8154         are `std::rt::io::net` and `std::rt::io::timer`.
8155       * extra: Iterators implemented for `SmallIntMap`.
8156       * extra: Iterators implemented for `Bitv` and `BitvSet`.
8157       * extra: `SmallIntSet` removed. Use `BitvSet`.
8158       * extra: Performance of JSON parsing greatly improved.
8159       * extra: `semver` updated to SemVer 2.0.0.
8160       * extra: `term` handles more terminals correctly.
8161       * extra: `dbg` module removed.
8162       * extra: `par` module removed.
8163       * extra: `future` was cleaned up, with some method renames.
8164       * extra: Most free functions in `getopts` were converted to methods.
8165
8166    * Other
8167       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
8168       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
8169         similarly to gcc's `--march` flag.
8170       * rustc's performance compiling small crates is much better.
8171       * rustpkg has received many improvements.
8172       * rustpkg supports git tags as package IDs.
8173       * rustpkg builds into target-specific directories so it can be used for
8174         cross-compiling.
8175       * The number of concurrent test tasks is controlled by the environment
8176         variable RUST_TEST_TASKS.
8177       * The test harness can now report metrics for benchmarks.
8178       * All tools have man pages.
8179       * Programs compiled with `--test` now support the `-h` and `--help` flags.
8180       * The runtime uses jemalloc for allocations.
8181       * Segmented stacks are temporarily disabled as part of the transition to
8182         the new runtime. Stack overflows are possible!
8183       * A new documentation backend, rustdoc_ng, is available for use. It is
8184         still invoked through the normal `rustdoc` command.
8185
8186
8187 Version 0.7 (2013-07-03)
8188 =======================
8189
8190    * ~2000 changes, numerous bugfixes
8191
8192    * Language
8193       * `impl`s no longer accept a visibility qualifier. Put them on methods
8194         instead.
8195       * The borrow checker has been rewritten with flow-sensitivity, fixing
8196         many bugs and inconveniences.
8197       * The `self` parameter no longer implicitly means `&'self self`,
8198         and can be explicitly marked with a lifetime.
8199       * Overloadable compound operators (`+=`, etc.) have been temporarily
8200         removed due to bugs.
8201       * The `for` loop protocol now requires `for`-iterators to return `bool`
8202         so they compose better.
8203       * The `Durable` trait is replaced with the `'static` bounds.
8204       * Trait default methods work more often.
8205       * Structs with the `#[packed]` attribute have byte alignment and
8206         no padding between fields.
8207       * Type parameters bound by `Copy` must now be copied explicitly with
8208         the `copy` keyword.
8209       * It is now illegal to move out of a dereferenced unsafe pointer.
8210       * `Option<~T>` is now represented as a nullable pointer.
8211       * `@mut` does dynamic borrow checks correctly.
8212       * The `main` function is only detected at the topmost level of the crate.
8213         The `#[main]` attribute is still valid anywhere.
8214       * Struct fields may no longer be mutable. Use inherited mutability.
8215       * The `#[no_send]` attribute makes a type that would otherwise be
8216         `Send`, not.
8217       * The `#[no_freeze]` attribute makes a type that would otherwise be
8218         `Freeze`, not.
8219       * Unbounded recursion will abort the process after reaching the limit
8220         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
8221       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
8222         are never implicitly copyable.
8223       * `#[static_assert]` makes compile-time assertions about static bools.
8224       * At long last, 'argument modes' no longer exist.
8225       * The rarely used `use mod` statement no longer exists.
8226
8227    * Syntax extensions
8228       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
8229         argument list.
8230       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
8231         `Rand`, `Zero` and `ToStr` can all be automatically derived with
8232         `#[deriving(...)]`.
8233       * The `bytes!` macro returns a vector of bytes for string, u8, char,
8234         and unsuffixed integer literals.
8235
8236    * Libraries
8237       * The `core` crate was renamed to `std`.
8238       * The `std` crate was renamed to `extra`.
8239       * More and improved documentation.
8240       * std: `iterator` module for external iterator objects.
8241       * Many old-style (internal, higher-order function) iterators replaced by
8242         implementations of `Iterator`.
8243       * std: Many old internal vector and string iterators,
8244         incl. `any`, `all`. removed.
8245       * std: The `finalize` method of `Drop` renamed to `drop`.
8246       * std: The `drop` method now takes `&mut self` instead of `&self`.
8247       * std: The prelude no longer re-exports any modules, only types and traits.
8248       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
8249         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
8250       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
8251         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
8252       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
8253         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
8254       * std: Many types implement `Clone`.
8255       * std: `path` type renamed to `Path`.
8256       * std: `mut` module and `Mut` type removed.
8257       * std: Many standalone functions removed in favor of methods and iterators
8258         in `vec`, `str`. In the future methods will also work as functions.
8259       * std: `reinterpret_cast` removed. Use `transmute`.
8260       * std: ascii string handling in `std::ascii`.
8261       * std: `Rand` is implemented for ~/@.
8262       * std: `run` module for spawning processes overhauled.
8263       * std: Various atomic types added to `unstable::atomic`.
8264       * std: Various types implement `Zero`.
8265       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
8266       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
8267       * std: Added `os::mkdir_recursive`.
8268       * std: Added `os::glob` function performs filesystems globs.
8269       * std: `FuzzyEq` renamed to `ApproxEq`.
8270       * std: `Map` now defines `pop` and `swap` methods.
8271       * std: `Cell` constructors converted to static methods.
8272       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
8273       * extra: `flate` module moved from `std` to `extra`.
8274       * extra: `fileinput` module for iterating over a series of files.
8275       * extra: `Complex` number type and `complex` module.
8276       * extra: `Rational` number type and `rational` module.
8277       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
8278       * extra: `term` uses terminfo now, is more correct.
8279       * extra: `arc` functions converted to methods.
8280       * extra: Implementation of fixed output size variations of SHA-2.
8281
8282    * Tooling
8283       * `unused_variables` lint mode for unused variables (default: warn).
8284       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
8285         (default: warn).
8286       * `unused_mut` lint mode for identifying unused `mut` qualifiers
8287         (default: warn).
8288       * `dead_assignment` lint mode for unread variables (default: warn).
8289       * `unnecessary_allocation` lint mode detects some heap allocations that are
8290         immediately borrowed so could be written without allocating (default: warn).
8291       * `missing_doc` lint mode (default: allow).
8292       * `unreachable_code` lint mode (default: warn).
8293       * The `rusti` command has been rewritten and a number of bugs addressed.
8294       * rustc outputs in color on more terminals.
8295       * rustc accepts a `--link-args` flag to pass arguments to the linker.
8296       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
8297       * Compiling with `-g` will make the binary record information about
8298         dynamic borrowcheck failures for debugging.
8299       * rustdoc has a nicer stylesheet.
8300       * Various improvements to rustdoc.
8301       * Improvements to rustpkg (see the detailed release notes).
8302
8303
8304 Version 0.6 (2013-04-03)
8305 ========================
8306
8307    * ~2100 changes, numerous bugfixes
8308
8309    * Syntax changes
8310       * The self type parameter in traits is now spelled `Self`
8311       * The `self` parameter in trait and impl methods must now be explicitly
8312         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
8313       * Static methods no longer require the `static` keyword and instead
8314         are distinguished by the lack of a `self` parameter
8315       * Replaced the `Durable` trait with the `'static` lifetime
8316       * The old closure type syntax with the trailing sigil has been
8317         removed in favor of the more consistent leading sigil
8318       * `super` is a keyword, and may be prefixed to paths
8319       * Trait bounds are separated with `+` instead of whitespace
8320       * Traits are implemented with `impl Trait for Type`
8321         instead of `impl Type: Trait`
8322       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
8323       * The `export` keyword has finally been removed
8324       * The `move` keyword has been removed (see "Semantic changes")
8325       * The interior mutability qualifier on vectors, `[mut T]`, has been
8326         removed. Use `&mut [T]`, etc.
8327       * `mut` is no longer valid in `~mut T`. Use inherited mutability
8328       * `fail` is no longer a keyword. Use `fail!()`
8329       * `assert` is no longer a keyword. Use `assert!()`
8330       * `log` is no longer a keyword. use `debug!`, etc.
8331       * 1-tuples may be represented as `(T,)`
8332       * Struct fields may no longer be `mut`. Use inherited mutability,
8333         `@mut T`, `core::mut` or `core::cell`
8334       * `extern mod { ... }` is no longer valid syntax for foreign
8335         function modules. Use extern blocks: `extern { ... }`
8336       * Newtype enums removed. Use tuple-structs.
8337       * Trait implementations no longer support visibility modifiers
8338       * Pattern matching over vectors improved and expanded
8339       * `const` renamed to `static` to correspond to lifetime name,
8340         and make room for future `static mut` unsafe mutable globals.
8341       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
8342       * `Clone` implementations can be automatically generated with
8343         `#[deriving(Clone)]`
8344       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
8345         instead of `foo as Bar`.
8346       * Fixed length vector types are now written as `[int, .. 3]`
8347         instead of `[int * 3]`.
8348       * Fixed length vector types can express the length as a constant
8349         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
8350
8351    * Semantic changes
8352       * Types with owned pointers or custom destructors move by default,
8353         eliminating the `move` keyword
8354       * All foreign functions are considered unsafe
8355       * &mut is now unaliasable
8356       * Writes to borrowed @mut pointers are prevented dynamically
8357       * () has size 0
8358       * The name of the main function can be customized using #[main]
8359       * The default type of an inferred closure is &fn instead of @fn
8360       * `use` statements may no longer be "chained" - they cannot import
8361         identifiers imported by previous `use` statements
8362       * `use` statements are crate relative, importing from the "top"
8363         of the crate by default. Paths may be prefixed with `super::`
8364         or `self::` to change the search behavior.
8365       * Method visibility is inherited from the implementation declaration
8366       * Structural records have been removed
8367       * Many more types can be used in static items, including enums
8368         'static-lifetime pointers and vectors
8369       * Pattern matching over vectors improved and expanded
8370       * Typechecking of closure types has been overhauled to
8371         improve inference and eliminate unsoundness
8372       * Macros leave scope at the end of modules, unless that module is
8373         tagged with #[macro_escape]
8374
8375    * Libraries
8376       * Added big integers to `std::bigint`
8377       * Removed `core::oldcomm` module
8378       * Added pipe-based `core::comm` module
8379       * Numeric traits have been reorganized under `core::num`
8380       * `vec::slice` finally returns a slice
8381       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
8382       * Containers reorganized around traits in `core::container`
8383       * `core::dvec` removed, `~[T]` is a drop-in replacement
8384       * `core::send_map` renamed to `core::hashmap`
8385       * `std::map` removed; replaced with `core::hashmap`
8386       * `std::treemap` reimplemented as an owned balanced tree
8387       * `std::deque` and `std::smallintmap` reimplemented as owned containers
8388       * `core::trie` added as a fast ordered map for integer keys
8389       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
8390       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
8391         overload the comparison operators, whereas `TotalOrd` is used
8392         by certain container types
8393
8394    * Other
8395       * Replaced the 'cargo' package manager with 'rustpkg'
8396       * Added all-purpose 'rust' tool
8397       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
8398       * rustc now *attempts* to offer spelling suggestions
8399       * Improved support for ARM and Android
8400       * Preliminary MIPS backend
8401       * Improved foreign function ABI implementation for x86, x86_64
8402       * Various memory usage improvements
8403       * Rust code may be embedded in foreign code under limited circumstances
8404       * Inline assembler supported by new asm!() syntax extension.
8405
8406
8407 Version 0.5 (2012-12-21)
8408 ===========================
8409
8410    * ~900 changes, numerous bugfixes
8411
8412    * Syntax changes
8413       * Removed `<-` move operator
8414       * Completed the transition from the `#fmt` extension syntax to `fmt!`
8415       * Removed old fixed length vector syntax - `[T]/N`
8416       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
8417       * Macros may now expand to items and statements
8418       * `a.b()` is always parsed as a method call, never as a field projection
8419       * `Eq` and `IterBytes` implementations can be automatically generated
8420         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
8421       * Removed the special crate language for `.rc` files
8422       * Function arguments may consist of any irrefutable pattern
8423
8424    * Semantic changes
8425       * `&` and `~` pointers may point to objects
8426       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
8427       * Enum variants may be structs
8428       * Destructors can be added to all nominal types with the Drop trait
8429       * Structs and nullary enum variants may be constants
8430       * Values that cannot be implicitly copied are now automatically moved
8431         without writing `move` explicitly
8432       * `&T` may now be coerced to `*T`
8433       * Coercions happen in `let` statements as well as function calls
8434       * `use` statements now take crate-relative paths
8435       * The module and type namespaces have been merged so that static
8436         method names can be resolved under the trait in which they are
8437         declared
8438
8439    * Improved support for language features
8440       * Trait inheritance works in many scenarios
8441       * More support for explicit self arguments in methods - `self`, `&self`
8442         `@self`, and `~self` all generally work as expected
8443       * Static methods work in more situations
8444       * Experimental: Traits may declare default methods for the implementations
8445         to use
8446
8447    * Libraries
8448       * New condition handling system in `core::condition`
8449       * Timsort added to `std::sort`
8450       * New priority queue, `std::priority_queue`
8451       * Pipes for serializable types, `std::flatpipes'
8452       * Serialization overhauled to be trait-based
8453       * Expanded `getopts` definitions
8454       * Moved futures to `std`
8455       * More functions are pure now
8456       * `core::comm` renamed to `oldcomm`. Still deprecated
8457       * `rustdoc` and `cargo` are libraries now
8458
8459    * Misc
8460       * Added a preliminary REPL, `rusti`
8461       * License changed from MIT to dual MIT/APL2
8462
8463
8464 Version 0.4 (2012-10-15)
8465 ==========================
8466
8467    * ~2000 changes, numerous bugfixes
8468
8469    * Syntax
8470       * All keywords are now strict and may not be used as identifiers anywhere
8471       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
8472         'of', 'with', 'to', 'class'.
8473       * Classes are replaced with simpler structs
8474       * Explicit method self types
8475       * `ret` became `return` and `alt` became `match`
8476       * `import` is now `use`; `use is now `extern mod`
8477       * `extern mod { ... }` is now `extern { ... }`
8478       * `use mod` is the recommended way to import modules
8479       * `pub` and `priv` replace deprecated export lists
8480       * The syntax of `match` pattern arms now uses fat arrow (=>)
8481       * `main` no longer accepts an args vector; use `os::args` instead
8482
8483    * Semantics
8484       * Trait implementations are now coherent, ala Haskell typeclasses
8485       * Trait methods may be static
8486       * Argument modes are deprecated
8487       * Borrowed pointers are much more mature and recommended for use
8488       * Strings and vectors in the static region are stored in constant memory
8489       * Typestate was removed
8490       * Resolution rewritten to be more reliable
8491       * Support for 'dual-mode' data structures (freezing and thawing)
8492
8493    * Libraries
8494       * Most binary operators can now be overloaded via the traits in
8495         `core::ops'
8496       * `std::net::url` for representing URLs
8497       * Sendable hash maps in `core::send_map`
8498       * `core::task' gained a (currently unsafe) task-local storage API
8499
8500    * Concurrency
8501       * An efficient new intertask communication primitive called the pipe,
8502         along with a number of higher-level channel types, in `core::pipes`
8503       * `std::arc`, an atomically reference counted, immutable, shared memory
8504         type
8505       * `std::sync`, various exotic synchronization tools based on arcs and pipes
8506       * Futures are now based on pipes and sendable
8507       * More robust linked task failure
8508       * Improved task builder API
8509
8510    * Other
8511       * Improved error reporting
8512       * Preliminary JIT support
8513       * Preliminary work on precise GC
8514       * Extensive architectural improvements to rustc
8515       * Begun a transition away from buggy C++-based reflection (shape) code to
8516         Rust-based (visitor) code
8517       * All hash functions and tables converted to secure, randomized SipHash
8518
8519
8520 Version 0.3  (2012-07-12)
8521 ========================
8522
8523    * ~1900 changes, numerous bugfixes
8524
8525    * New coding conveniences
8526       * Integer-literal suffix inference
8527       * Per-item control over warnings, errors
8528       * #[cfg(windows)] and #[cfg(unix)] attributes
8529       * Documentation comments
8530       * More compact closure syntax
8531       * 'do' expressions for treating higher-order functions as
8532         control structures
8533       * *-patterns (wildcard extended to all constructor fields)
8534
8535    * Semantic cleanup
8536       * Name resolution pass and exhaustiveness checker rewritten
8537       * Region pointers and borrow checking supersede alias
8538         analysis
8539       * Init-ness checking is now provided by a region-based liveness
8540         pass instead of the typestate pass; same for last-use analysis
8541       * Extensive work on region pointers
8542
8543    * Experimental new language features
8544       * Slices and fixed-size, interior-allocated vectors
8545       * #!-comments for lang versioning, shell execution
8546       * Destructors and iface implementation for classes;
8547         type-parameterized classes and class methods
8548       * 'const' type kind for types that can be used to implement
8549         shared-memory concurrency patterns
8550
8551    * Type reflection
8552
8553    * Removal of various obsolete features
8554       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
8555                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
8556
8557       * Constructs: do-while loops ('do' repurposed), fn binding,
8558                     resources (replaced by destructors)
8559
8560    * Compiler reorganization
8561       * Syntax-layer of compiler split into separate crate
8562       * Clang (from LLVM project) integrated into build
8563       * Typechecker split into sub-modules
8564
8565    * New library code
8566       * New time functions
8567       * Extension methods for many built-in types
8568       * Arc: atomic-refcount read-only / exclusive-use shared cells
8569       * Par: parallel map and search routines
8570       * Extensive work on libuv interface
8571       * Much vector code moved to libraries
8572       * Syntax extensions: #line, #col, #file, #mod, #stringify,
8573         #include, #include_str, #include_bin
8574
8575    * Tool improvements
8576       * Cargo automatically resolves dependencies
8577
8578
8579 Version 0.2  (2012-03-29)
8580 =========================
8581
8582    * >1500 changes, numerous bugfixes
8583
8584    * New docs and doc tooling
8585
8586    * New port: FreeBSD x86_64
8587
8588    * Compilation model enhancements
8589       * Generics now specialized, multiply instantiated
8590       * Functions now inlined across separate crates
8591
8592    * Scheduling, stack and threading fixes
8593       * Noticeably improved message-passing performance
8594       * Explicit schedulers
8595       * Callbacks from C
8596       * Helgrind clean
8597
8598    * Experimental new language features
8599       * Operator overloading
8600       * Region pointers
8601       * Classes
8602
8603    * Various language extensions
8604       * C-callback function types: 'crust fn ...'
8605       * Infinite-loop construct: 'loop { ... }'
8606       * Shorten 'mutable' to 'mut'
8607       * Required mutable-local qualifier: 'let mut ...'
8608       * Basic glob-exporting: 'export foo::*;'
8609       * Alt now exhaustive, 'alt check' for runtime-checked
8610       * Block-function form of 'for' loop, with 'break' and 'ret'.
8611
8612    * New library code
8613       * AST quasi-quote syntax extension
8614       * Revived libuv interface
8615       * New modules: core::{future, iter}, std::arena
8616       * Merged per-platform std::{os*, fs*} to core::{libc, os}
8617       * Extensive cleanup, regularization in libstd, libcore
8618
8619
8620 Version 0.1  (2012-01-20)
8621 ===============================
8622
8623    * Most language features work, including:
8624       * Unique pointers, unique closures, move semantics
8625       * Interface-constrained generics
8626       * Static interface dispatch
8627       * Stack growth
8628       * Multithread task scheduling
8629       * Typestate predicates
8630       * Failure unwinding, destructors
8631       * Pattern matching and destructuring assignment
8632       * Lightweight block-lambda syntax
8633       * Preliminary macro-by-example
8634
8635    * Compiler works with the following configurations:
8636       * Linux: x86 and x86_64 hosts and targets
8637       * macOS: x86 and x86_64 hosts and targets
8638       * Windows: x86 hosts and targets
8639
8640    * Cross compilation / multi-target configuration supported.
8641
8642    * Preliminary API-documentation and package-management tools included.
8643
8644 Known issues:
8645
8646    * Documentation is incomplete.
8647
8648    * Performance is below intended target.
8649
8650    * Standard library APIs are subject to extensive change, reorganization.
8651
8652    * Language-level versioning is not yet operational - future code will
8653      break unexpectedly.