RELEASES.md

   1 Version 1.49.0 (2020-12-31)
   2 ============================
   3
   4 Language
   5 -----------------------
   6
   7 - [Unions can now implement `Drop`, and you can now have a field in a union
   8   with `ManuallyDrop<T>`.][77547]
   9 - [You can now cast uninhabited enums to integers.][76199]
  10 - [You can now bind by reference and by move in patterns.][76119] This
  11   allows you to selectively borrow individual components of a type. E.g.
  12   ```rust
  13   #[derive(Debug)]
  14   struct Person {
  15       name: String,
  16       age: u8,
  17   }
  18
  19   let person = Person {
  20       name: String::from("Alice"),
  21       age: 20,
  22   };
  23
  24   // `name` is moved out of person, but `age` is referenced.
  25   let Person { name, ref age } = person;
  26   println!("{} {}", name, age);
  27   ```
  28
  29 Compiler
  30 -----------------------
  31
  32 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
  33 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
  34 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
  35 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
  36 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
  37 - [Output from threads spawned in tests is now captured.][78227]
  38 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
  39
  40 \* Refer to Rust's [platform support page][forge-platform-support] for more
  41 information on Rust's tiered platform support.
  42
  43 Libraries
  44 -----------------------
  45
  46 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
  47 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
  48
  49 Stabilized APIs
  50 ---------------
  51
  52 - [`slice::select_nth_unstable`]
  53 - [`slice::select_nth_unstable_by`]
  54 - [`slice::select_nth_unstable_by_key`]
  55
  56 The following previously stable methods are now `const`.
  57
  58 - [`Poll::is_ready`]
  59 - [`Poll::is_pending`]
  60
  61 Cargo
  62 -----------------------
  63 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
  64 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
  65 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
  66   variable will be set if the crate being built is one the user selected to build, either
  67   with `-p` or through defaults.
  68 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
  69
  70
  71 Compatibility Notes
  72 -------------------
  73
  74 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
  75 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
  76 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
  77   Previously such invalid or unused attributes could be ignored.
  78 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
  79   read [this post about the changes][rustdoc-ws-post] for more details.
  80 - [Trait bounds are no longer inferred for associated types.][79904]
  81
  82 Internal Only
  83 -------------
  84 These changes provide no direct user facing benefits, but represent significant
  85 improvements to the internals and overall performance of rustc and
  86 related tools.
  87
  88 - [rustc's internal crates are now compiled using the `initial-exec` Thread
  89   Local Storage model.][78201]
  90 - [Calculate visibilities once in resolve.][78077]
  91 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
  92 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
  93
  94
  95 [75991]: https://github.com/rust-lang/rust/pull/75991
  96 [78951]: https://github.com/rust-lang/rust/pull/78951
  97 [78848]: https://github.com/rust-lang/rust/pull/78848
  98 [78746]: https://github.com/rust-lang/rust/pull/78746
  99 [78376]: https://github.com/rust-lang/rust/pull/78376
 100 [78228]: https://github.com/rust-lang/rust/pull/78228
 101 [78227]: https://github.com/rust-lang/rust/pull/78227
 102 [78201]: https://github.com/rust-lang/rust/pull/78201
 103 [78109]: https://github.com/rust-lang/rust/pull/78109
 104 [78077]: https://github.com/rust-lang/rust/pull/78077
 105 [77997]: https://github.com/rust-lang/rust/pull/77997
 106 [77703]: https://github.com/rust-lang/rust/pull/77703
 107 [77547]: https://github.com/rust-lang/rust/pull/77547
 108 [77015]: https://github.com/rust-lang/rust/pull/77015
 109 [76199]: https://github.com/rust-lang/rust/pull/76199
 110 [76119]: https://github.com/rust-lang/rust/pull/76119
 111 [75914]: https://github.com/rust-lang/rust/pull/75914
 112 [79004]: https://github.com/rust-lang/rust/pull/79004
 113 [78676]: https://github.com/rust-lang/rust/pull/78676
 114 [79904]: https://github.com/rust-lang/rust/issues/79904
 115 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
 116 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
 117 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
 118 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
 119 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
 120 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
 121 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
 122 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
 123 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
 124 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
 125 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
 126
 127 Version 1.48.0 (2020-11-19)
 128 ==========================
 129
 130 Language
 131 --------
 132
 133 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
 134   is still rejected *semantically*, but can now be parsed by procedural macros.
 135
 136 Compiler
 137 --------
 138 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
 139   `rustc` whether to link its own C runtime and libraries or to rely on a external
 140   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
 141 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
 142   Note: If you're using cargo you must explicitly pass the `--target` flag.
 143 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
 144
 145 \* Refer to Rust's [platform support page][forge-platform-support] for more
 146 information on Rust's tiered platform support.
 147
 148 Libraries
 149 ---------
 150 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
 151   and `&Stderr`.][76275]
 152 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
 153 - [The `matches!` macro now supports having a trailing comma.][74880]
 154 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
 155 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
 156
 157 Stabilized APIs
 158 ---------------
 159 - [`slice::as_ptr_range`]
 160 - [`slice::as_mut_ptr_range`]
 161 - [`VecDeque::make_contiguous`]
 162 - [`future::pending`]
 163 - [`future::ready`]
 164
 165 The following previously stable methods are now `const fn`'s:
 166
 167 - [`Option::is_some`]
 168 - [`Option::is_none`]
 169 - [`Option::as_ref`]
 170 - [`Result::is_ok`]
 171 - [`Result::is_err`]
 172 - [`Result::as_ref`]
 173 - [`Ordering::reverse`]
 174 - [`Ordering::then`]
 175
 176 Cargo
 177 -----
 178
 179 Rustdoc
 180 -------
 181 - [You can now link to items in `rustdoc` using the intra-doc link
 182   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
 183   a link to `std::future`'s documentation. See ["Linking to items by
 184   name"][intradoc-links] for more information.
 185 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
 186   when searching through `rustdoc`'s UI.][75740]
 187
 188 Compatibility Notes
 189 -------------------
 190 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
 191   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
 192   promoted to `'static` lifetime any more inside `const fn`s.
 193 - [Associated type bindings on trait objects are now verified to meet the bounds
 194   declared on the trait when checking that they implement the trait.][27675]
 195 - [When trait bounds on associated types or opaque types are ambiguous, the
 196   compiler no longer makes an arbitrary choice on which bound to use.][54121]
 197 - [Fixed recursive nonterminals not being expanded in macros during
 198   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
 199   correctly handling recursive nonterminal tokens.
 200 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
 201 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
 202   in places where they have no effect.][73461]
 203 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
 204   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
 205 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
 206   disallow zero-initialization.][71274]
 207 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
 208 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
 209   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
 210   see the [`catch_unwind`] documentation for further information.
 211
 212
 213
 214 Internal Only
 215 -------------
 216 These changes provide no direct user facing benefits, but represent significant
 217 improvements to the internals and overall performance of rustc and
 218 related tools.
 219
 220 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
 221   You can continue building with `make` by setting `ninja=false` in
 222   your `config.toml`.
 223 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
 224 - [Made `ensure_sufficient_stack()` non-generic][76680]
 225
 226 [78143]: https://github.com/rust-lang/rust/issues/78143
 227 [76680]: https://github.com/rust-lang/rust/pull/76680/
 228 [76030]: https://github.com/rust-lang/rust/pull/76030/
 229 [70212]: https://github.com/rust-lang/rust/pull/70212/
 230 [27675]: https://github.com/rust-lang/rust/issues/27675/
 231 [54121]: https://github.com/rust-lang/rust/issues/54121/
 232 [71274]: https://github.com/rust-lang/rust/pull/71274/
 233 [77386]: https://github.com/rust-lang/rust/pull/77386/
 234 [77153]: https://github.com/rust-lang/rust/pull/77153/
 235 [77055]: https://github.com/rust-lang/rust/pull/77055/
 236 [76275]: https://github.com/rust-lang/rust/pull/76275/
 237 [76310]: https://github.com/rust-lang/rust/pull/76310/
 238 [76420]: https://github.com/rust-lang/rust/pull/76420/
 239 [76158]: https://github.com/rust-lang/rust/pull/76158/
 240 [75857]: https://github.com/rust-lang/rust/pull/75857/
 241 [75585]: https://github.com/rust-lang/rust/pull/75585/
 242 [75740]: https://github.com/rust-lang/rust/pull/75740/
 243 [75502]: https://github.com/rust-lang/rust/pull/75502/
 244 [74880]: https://github.com/rust-lang/rust/pull/74880/
 245 [74922]: https://github.com/rust-lang/rust/pull/74922/
 246 [74430]: https://github.com/rust-lang/rust/pull/74430/
 247 [74194]: https://github.com/rust-lang/rust/pull/74194/
 248 [73461]: https://github.com/rust-lang/rust/pull/73461/
 249 [73166]: https://github.com/rust-lang/rust/pull/73166/
 250 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
 251 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
 252 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
 253 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
 254 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
 255 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
 256 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
 257 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
 258 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
 259 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
 260 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
 261 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
 262 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
 263 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
 264 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
 265
 266
 267 Version 1.47.0 (2020-10-08)
 268 ==========================
 269
 270 Language
 271 --------
 272 - [Closures will now warn when not used.][74869]
 273
 274 Compiler
 275 --------
 276 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
 277   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
 278   platforms.
 279 - [Upgraded to LLVM 11.][73526]
 280 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
 281 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
 282 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
 283
 284 \* Refer to Rust's [platform support page][forge-platform-support] for more
 285 information on Rust's tiered platform support.
 286
 287 Libraries
 288 ---------
 289 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
 290 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
 291   those of length less than 33.][74060]
 292 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
 293 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
 294   `PartialEq`, and `PartialOrd`.][73583]
 295
 296 Stabilized APIs
 297 ---------------
 298 - [`Ident::new_raw`]
 299 - [`Range::is_empty`]
 300 - [`RangeInclusive::is_empty`]
 301 - [`Result::as_deref`]
 302 - [`Result::as_deref_mut`]
 303 - [`Vec::leak`]
 304 - [`pointer::offset_from`]
 305 - [`f32::TAU`]
 306 - [`f64::TAU`]
 307
 308 The following previously stable APIs have now been made const.
 309
 310 - [The `new` method for all `NonZero` integers.][73858]
 311 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
 312   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
 313   methods for all integers.][73858]
 314 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
 315   signed integers.][73858]
 316 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
 317   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
 318   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
 319   `is_ascii_control` methods for `char` and `u8`.][73858]
 320
 321 Cargo
 322 -----
 323 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
 324   You can override this by setting the following in your `Cargo.toml`.
 325   ```toml
 326   [profile.release.build-override]
 327   opt-level = 3
 328   ```
 329 - [`cargo-help` will now display man pages for commands rather just the
 330   `--help` text.][cargo/8456]
 331 - [`cargo-metadata` now emits a `test` field indicating if a target has
 332   tests enabled.][cargo/8478]
 333 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
 334 - [`cargo-publish` will now use an alternative registry by default if it's the
 335   only registry specified in `package.publish`.][cargo/8571]
 336
 337 Misc
 338 ----
 339 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
 340   type based search.][75366]
 341 - [Added the Ayu theme to rustdoc.][71237]
 342
 343 Compatibility Notes
 344 -------------------
 345 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
 346 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
 347 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
 348   help to preserve more span information.][73084] These changes may cause
 349   compiliation errors if your macro was unhygenic or didn't correctly handle
 350   `Delimiter::None`.
 351 - [Moved support for the CloudABI target to tier 3.][75568]
 352 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
 353 - [Added the `rustc-docs` component.][75560] This allows you to install
 354   and read the documentation for the compiler internal APIs. (Currently only
 355   available for `x86_64-unknown-linux-gnu`.)
 356
 357 Internal Only
 358 --------
 359
 360 - [Improved default settings for bootstrapping in `x.py`.][73964] You can read details about this change in the ["Changes to `x.py` defaults"](https://blog.rust-lang.org/inside-rust/2020/08/30/changes-to-x-py-defaults.html) post on the Inside Rust blog.
 361
 362 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
 363 [75048]: https://github.com/rust-lang/rust/pull/75048/
 364 [74163]: https://github.com/rust-lang/rust/pull/74163/
 365 [71237]: https://github.com/rust-lang/rust/pull/71237/
 366 [74869]: https://github.com/rust-lang/rust/pull/74869/
 367 [73858]: https://github.com/rust-lang/rust/pull/73858/
 368 [75716]: https://github.com/rust-lang/rust/pull/75716/
 369 [75908]: https://github.com/rust-lang/rust/pull/75908/
 370 [75516]: https://github.com/rust-lang/rust/pull/75516/
 371 [75560]: https://github.com/rust-lang/rust/pull/75560/
 372 [75568]: https://github.com/rust-lang/rust/pull/75568/
 373 [75366]: https://github.com/rust-lang/rust/pull/75366/
 374 [75204]: https://github.com/rust-lang/rust/pull/75204/
 375 [74650]: https://github.com/rust-lang/rust/pull/74650/
 376 [74419]: https://github.com/rust-lang/rust/pull/74419/
 377 [73964]: https://github.com/rust-lang/rust/pull/73964/
 378 [74021]: https://github.com/rust-lang/rust/pull/74021/
 379 [74060]: https://github.com/rust-lang/rust/pull/74060/
 380 [73893]: https://github.com/rust-lang/rust/pull/73893/
 381 [73526]: https://github.com/rust-lang/rust/pull/73526/
 382 [73583]: https://github.com/rust-lang/rust/pull/73583/
 383 [73084]: https://github.com/rust-lang/rust/pull/73084/
 384 [73197]: https://github.com/rust-lang/rust/pull/73197/
 385 [72488]: https://github.com/rust-lang/rust/pull/72488/
 386 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
 387 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
 388 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
 389 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
 390 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
 391 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
 392 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
 393 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
 394 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
 395 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
 396 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
 397 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
 398 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
 399 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
 400 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
 401
 402
 403 Version 1.46.0 (2020-08-27)
 404 ==========================
 405
 406 Language
 407 --------
 408 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
 409 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
 410   const functions.][73862]
 411 - [The `#[track_caller]` attribute can now be added to functions to use the
 412   function's caller's location information for panic messages.][72445]
 413 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
 414   `x.0.0` over `(x.0).0`.
 415 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
 416   You currently can't use `mem::transmute` in constant functions.
 417
 418 Compiler
 419 --------
 420 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
 421 - [Enabled static "Position Independent Executables" by default
 422   for `x86_64-unknown-linux-musl`.][70740]
 423
 424 Libraries
 425 ---------
 426 - [`mem::forget` is now a `const fn`.][73887]
 427 - [`String` now implements `From<char>`.][73466]
 428 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
 429   integer types.][73032]
 430 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
 431 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
 432   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
 433 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
 434 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
 435 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
 436
 437 Stabilized APIs
 438 ---------------
 439 - [`Option::zip`]
 440 - [`vec::Drain::as_slice`]
 441
 442 Cargo
 443 -----
 444 Added a number of new environment variables that are now available when
 445 compiling your crate.
 446
 447 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
 448   the specific binary being compiled and the name of the crate.
 449 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
 450 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
 451
 452 Compatibility Notes
 453 -------------------
 454 - [The target configuration option `abi_blacklist` has been renamed
 455   to `unsupported_abis`.][74150] The old name will still continue to work.
 456 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
 457   This was previously accepted but will become a hard error in a future release.
 458 - [Rustc will fail to compile if you have a struct with
 459   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
 460   allowed on `enum`s.
 461 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
 462   ensure that spans have the correct information, and may cause breakage if you
 463   were relying on receiving spans with dummy information.
 464 - [The InnoSetup installer for Windows is no longer available.][72569] This was
 465   a legacy installer that was replaced by a MSI installer a few years ago but
 466   was still being built.
 467 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
 468 - [Rustc will no longer accept overlapping trait implementations that only
 469   differ in how the lifetime was bound.][72493]
 470 - [Rustc now correctly relates the lifetime of an existential associated
 471   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
 472   you to pass a shorter lifetime than expected.
 473 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
 474   The library will need to be installed for `rustc` to work, even though we
 475   expect it to be already available on most systems.
 476 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
 477   under QEMU.][74820]
 478 - [Pretty printing of some tokens in procedural macros changed.][75453] The
 479   exact output returned by rustc's pretty printing is an unstable
 480   implementation detail: we recommend any macro relying on it to switch to a
 481   more robust parsing system.
 482
 483 [75453]: https://github.com/rust-lang/rust/issues/75453/
 484 [74820]: https://github.com/rust-lang/rust/issues/74820/
 485 [74420]: https://github.com/rust-lang/rust/issues/74420/
 486 [74109]: https://github.com/rust-lang/rust/pull/74109/
 487 [74150]: https://github.com/rust-lang/rust/pull/74150/
 488 [73862]: https://github.com/rust-lang/rust/pull/73862/
 489 [73887]: https://github.com/rust-lang/rust/pull/73887/
 490 [73466]: https://github.com/rust-lang/rust/pull/73466/
 491 [73516]: https://github.com/rust-lang/rust/pull/73516/
 492 [73293]: https://github.com/rust-lang/rust/pull/73293/
 493 [73007]: https://github.com/rust-lang/rust/pull/73007/
 494 [73032]: https://github.com/rust-lang/rust/pull/73032/
 495 [72920]: https://github.com/rust-lang/rust/pull/72920/
 496 [72569]: https://github.com/rust-lang/rust/pull/72569/
 497 [72583]: https://github.com/rust-lang/rust/pull/72583/
 498 [72584]: https://github.com/rust-lang/rust/pull/72584/
 499 [72717]: https://github.com/rust-lang/rust/pull/72717/
 500 [72437]: https://github.com/rust-lang/rust/pull/72437/
 501 [72445]: https://github.com/rust-lang/rust/pull/72445/
 502 [72486]: https://github.com/rust-lang/rust/pull/72486/
 503 [72493]: https://github.com/rust-lang/rust/pull/72493/
 504 [72331]: https://github.com/rust-lang/rust/pull/72331/
 505 [71896]: https://github.com/rust-lang/rust/pull/71896/
 506 [71660]: https://github.com/rust-lang/rust/pull/71660/
 507 [71322]: https://github.com/rust-lang/rust/pull/71322/
 508 [70740]: https://github.com/rust-lang/rust/pull/70740/
 509 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
 510 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
 511 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
 512 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
 513 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
 514
 515
 516 Version 1.45.2 (2020-08-03)
 517 ==========================
 518
 519 * [Fix bindings in tuple struct patterns][74954]
 520 * [Fix track_caller integration with trait objects][74784]
 521
 522 [74954]: https://github.com/rust-lang/rust/issues/74954
 523 [74784]: https://github.com/rust-lang/rust/issues/74784
 524
 525
 526 Version 1.45.1 (2020-07-30)
 527 ==========================
 528
 529 * [Fix const propagation with references.][73613]
 530 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
 531 * [Avoid spurious implicit region bound.][74509]
 532 * [Install clippy on x.py install][74457]
 533
 534 [73613]: https://github.com/rust-lang/rust/pull/73613
 535 [73078]: https://github.com/rust-lang/rust/issues/73078
 536 [74509]: https://github.com/rust-lang/rust/pull/74509
 537 [74457]: https://github.com/rust-lang/rust/pull/74457
 538
 539
 540 Version 1.45.0 (2020-07-16)
 541 ==========================
 542
 543 Language
 544 --------
 545 - [Out of range float to int conversions using `as` has been defined as a saturating
 546   conversion.][71269] This was previously undefined behaviour, but you can use the
 547    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
 548    may be desirable in rare performance sensitive situations.
 549 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
 550   using `u64`.][70705]
 551 - [Function like procedural macros can now be used in expression, pattern, and  statement
 552   positions.][68717] This means you can now use a function-like procedural macro
 553   anywhere you can use a declarative (`macro_rules!`) macro.
 554
 555 Compiler
 556 --------
 557 - [You can now override individual target features through the `target-feature`
 558   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
 559   equivalent to `-C target-feature=+avx2,+fma`.
 560 - [Added the `force-unwind-tables` flag.][69984] This option allows
 561   rustc to always generate unwind tables regardless of panic strategy.
 562 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
 563   to include LLVM bitcode into generated `rlib`s (this is on by default).
 564 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
 565 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
 566 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
 567 - [Upgraded to LLVM 10.][67759]
 568
 569 \* Refer to Rust's [platform support page][forge-platform-support] for more
 570 information on Rust's tiered platform support.
 571
 572
 573 Libraries
 574 ---------
 575 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
 576   and `Ord`.][72239]
 577 - [`proc_macro::TokenStream` now implements `Default`.][72234]
 578 - [You can now use `char` with
 579   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
 580   a range of codepoints.][72413] E.g.
 581   you can now write the following;
 582   ```rust
 583   for ch in 'a'..='z' {
 584       print!("{}", ch);
 585   }
 586   println!();
 587   // Prints "abcdefghijklmnopqrstuvwxyz"
 588   ```
 589 - [`OsString` now implements `FromStr`.][71662]
 590 - [The `saturating_neg` method has been added to all signed integer primitive
 591   types, and the `saturating_abs` method has been added for all integer
 592   primitive types.][71886]
 593 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
 594   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
 595   or `Path`.][71447]
 596 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
 597 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
 598   integer types.][69813]
 599 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
 600   integer types.][72324]
 601 - [The `fetch_update` method has been added to all atomic integer types.][71843]
 602
 603 Stabilized APIs
 604 ---------------
 605 - [`Arc::as_ptr`]
 606 - [`BTreeMap::remove_entry`]
 607 - [`Rc::as_ptr`]
 608 - [`rc::Weak::as_ptr`]
 609 - [`rc::Weak::from_raw`]
 610 - [`rc::Weak::into_raw`]
 611 - [`str::strip_prefix`]
 612 - [`str::strip_suffix`]
 613 - [`sync::Weak::as_ptr`]
 614 - [`sync::Weak::from_raw`]
 615 - [`sync::Weak::into_raw`]
 616 - [`char::UNICODE_VERSION`]
 617 - [`Span::resolved_at`]
 618 - [`Span::located_at`]
 619 - [`Span::mixed_site`]
 620 - [`unix::process::CommandExt::arg0`]
 621
 622 Cargo
 623 -----
 624
 625 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
 626   time.][cargo/8066]
 627
 628 Misc
 629 ----
 630 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
 631   `~~outdated information~~` becomes "~~outdated information~~".
 632 - [Added an emoji to Rustdoc's deprecated API message.][72014]
 633
 634 Compatibility Notes
 635 -------------------
 636 - [Trying to self initialize a static value (that is creating a value using
 637   itself) is unsound and now causes a compile error.][71140]
 638 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
 639   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
 640 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
 641   previously undocumented and not intended for public use. Rustdoc still provides
 642   a non-zero exit code on errors.
 643 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
 644   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
 645   flags while cargo is adding `embed-bitcode` itself. The recommended way to
 646   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
 647   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
 648
 649 Internals Only
 650 --------------
 651 - [Make clippy a git subtree instead of a git submodule][70655]
 652 - [Unify the undo log of all snapshot types][69464]
 653
 654 [71848]: https://github.com/rust-lang/rust/issues/71848/
 655 [73420]: https://github.com/rust-lang/rust/issues/73420/
 656 [72324]: https://github.com/rust-lang/rust/pull/72324/
 657 [71843]: https://github.com/rust-lang/rust/pull/71843/
 658 [71886]: https://github.com/rust-lang/rust/pull/71886/
 659 [72234]: https://github.com/rust-lang/rust/pull/72234/
 660 [72239]: https://github.com/rust-lang/rust/pull/72239/
 661 [72397]: https://github.com/rust-lang/rust/pull/72397/
 662 [72413]: https://github.com/rust-lang/rust/pull/72413/
 663 [72014]: https://github.com/rust-lang/rust/pull/72014/
 664 [72062]: https://github.com/rust-lang/rust/pull/72062/
 665 [72094]: https://github.com/rust-lang/rust/pull/72094/
 666 [72133]: https://github.com/rust-lang/rust/pull/72133/
 667 [67759]: https://github.com/rust-lang/rust/pull/67759/
 668 [71900]: https://github.com/rust-lang/rust/pull/71900/
 669 [71928]: https://github.com/rust-lang/rust/pull/71928/
 670 [71662]: https://github.com/rust-lang/rust/pull/71662/
 671 [71716]: https://github.com/rust-lang/rust/pull/71716/
 672 [71447]: https://github.com/rust-lang/rust/pull/71447/
 673 [71269]: https://github.com/rust-lang/rust/pull/71269/
 674 [71095]: https://github.com/rust-lang/rust/pull/71095/
 675 [71140]: https://github.com/rust-lang/rust/pull/71140/
 676 [70655]: https://github.com/rust-lang/rust/pull/70655/
 677 [70705]: https://github.com/rust-lang/rust/pull/70705/
 678 [69984]: https://github.com/rust-lang/rust/pull/69984/
 679 [69813]: https://github.com/rust-lang/rust/pull/69813/
 680 [69464]: https://github.com/rust-lang/rust/pull/69464/
 681 [68717]: https://github.com/rust-lang/rust/pull/68717/
 682 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
 683 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
 684 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
 685 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
 686 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
 687 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
 688 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
 689 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
 690 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
 691 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
 692 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
 693 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
 694 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
 695 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
 696 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
 697 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
 698 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
 699
 700
 701 Version 1.44.1 (2020-06-18)
 702 ===========================
 703
 704 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
 705 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
 706 * [Fix crashes when finding backtrace on macOS.][71397]
 707 * [Clippy applies lint levels into different files.][clippy/5356]
 708
 709 [71397]: https://github.com/rust-lang/rust/issues/71397
 710 [73078]: https://github.com/rust-lang/rust/issues/73078
 711 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
 712 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
 713
 714
 715 Version 1.44.0 (2020-06-04)
 716 ==========================
 717
 718 Language
 719 --------
 720 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
 721 - [Added the `unused_braces` lint.][70081]
 722
 723 **Syntax-only changes**
 724
 725 - [Expansion-driven outline module parsing][69838]
 726 ```rust
 727 #[cfg(FALSE)]
 728 mod foo {
 729     mod bar {
 730         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
 731     }
 732 }
 733 ```
 734
 735 These are still rejected semantically, so you will likely receive an error but
 736 these changes can be seen and parsed by macros and conditional compilation.
 737
 738 Compiler
 739 --------
 740 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
 741   Additionally when in incremental mode rustc defaults to 256 codegen units.
 742 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
 743   a panic is thrown.][67502]
 744 - [Added tier 3\* support for the `aarch64-unknown-none` and
 745   `aarch64-unknown-none-softfloat` targets.][68334]
 746 - [Added tier 3 support for `arm64-apple-tvos` and
 747   `x86_64-apple-tvos` targets.][68191]
 748
 749
 750 Libraries
 751 ---------
 752 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
 753   `vec![]` to be able to be used in `const` contexts.
 754 - [`convert::Infallible` now implements `Hash`.][70281]
 755 - [`OsString` now implements `DerefMut` and `IndexMut` returning
 756   a `&mut OsStr`.][70048]
 757 - [Unicode 13 is now supported.][69929]
 758 - [`String` now implements `From<&mut str>`.][69661]
 759 - [`IoSlice` now implements `Copy`.][69403]
 760 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
 761 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
 762 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
 763   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
 764   integer types.][69373]
 765
 766 Stabilized APIs
 767 ---------------
 768 - [`PathBuf::with_capacity`]
 769 - [`PathBuf::capacity`]
 770 - [`PathBuf::clear`]
 771 - [`PathBuf::reserve`]
 772 - [`PathBuf::reserve_exact`]
 773 - [`PathBuf::shrink_to_fit`]
 774 - [`f32::to_int_unchecked`]
 775 - [`f64::to_int_unchecked`]
 776 - [`Layout::align_to`]
 777 - [`Layout::pad_to_align`]
 778 - [`Layout::array`]
 779 - [`Layout::extend`]
 780
 781 Cargo
 782 -----
 783 - [Added the `cargo tree` command which will print a tree graph of
 784   your dependencies.][cargo/8062] E.g.
 785   ```
 786     mdbook v0.3.2 (/Users/src/rust/mdbook)
 787   ├── ammonia v3.0.0
 788   │   ├── html5ever v0.24.0
 789   │   │   ├── log v0.4.8
 790   │   │   │   └── cfg-if v0.1.9
 791   │   │   ├── mac v0.1.1
 792   │   │   └── markup5ever v0.9.0
 793   │   │       ├── log v0.4.8 (*)
 794   │   │       ├── phf v0.7.24
 795   │   │       │   └── phf_shared v0.7.24
 796   │   │       │       ├── siphasher v0.2.3
 797   │   │       │       └── unicase v1.4.2
 798   │   │       │           [build-dependencies]
 799   │   │       │           └── version_check v0.1.5
 800   ...
 801   ```
 802   You can also display dependencies on multiple versions of the same crate with
 803   `cargo tree -d` (short for `cargo tree --duplicates`).
 804
 805 Misc
 806 ----
 807 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
 808   the version in the sidebar.][69494]
 809
 810 Compatibility Notes
 811 -------------------
 812 - [Rustc now correctly generates static libraries on Windows GNU targets with
 813   the `.a` extension, rather than the previous `.lib`.][70937]
 814 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
 815 - [The `file_name` property in JSON output of macro errors now points the actual
 816   source file rather than the previous format of `<NAME macros>`.][70969]
 817   **Note:** this may not point to a file that actually exists on the user's system.
 818 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
 819 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
 820   not allow zero initialization such as `NonZeroU8`.][66059] This was
 821   previously a warning.
 822 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
 823   operator has been defined as a saturating operation.][71269] This was previously
 824   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
 825   continue using the current behaviour, which may be desirable in rare performance
 826   sensitive situations.
 827
 828 Internal Only
 829 -------------
 830 These changes provide no direct user facing benefits, but represent significant
 831 improvements to the internals and overall performance of rustc and
 832 related tools.
 833
 834 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
 835 - [Replace big JS dict with JSON parsing.][71250]
 836
 837 [69373]: https://github.com/rust-lang/rust/pull/69373/
 838 [66059]: https://github.com/rust-lang/rust/pull/66059/
 839 [68191]: https://github.com/rust-lang/rust/pull/68191/
 840 [68899]: https://github.com/rust-lang/rust/pull/68899/
 841 [71147]: https://github.com/rust-lang/rust/pull/71147/
 842 [71250]: https://github.com/rust-lang/rust/pull/71250/
 843 [70937]: https://github.com/rust-lang/rust/pull/70937/
 844 [70969]: https://github.com/rust-lang/rust/pull/70969/
 845 [70632]: https://github.com/rust-lang/rust/pull/70632/
 846 [70281]: https://github.com/rust-lang/rust/pull/70281/
 847 [70345]: https://github.com/rust-lang/rust/pull/70345/
 848 [70048]: https://github.com/rust-lang/rust/pull/70048/
 849 [70081]: https://github.com/rust-lang/rust/pull/70081/
 850 [70156]: https://github.com/rust-lang/rust/pull/70156/
 851 [71269]: https://github.com/rust-lang/rust/pull/71269/
 852 [69838]: https://github.com/rust-lang/rust/pull/69838/
 853 [69929]: https://github.com/rust-lang/rust/pull/69929/
 854 [69661]: https://github.com/rust-lang/rust/pull/69661/
 855 [69778]: https://github.com/rust-lang/rust/pull/69778/
 856 [69494]: https://github.com/rust-lang/rust/pull/69494/
 857 [69403]: https://github.com/rust-lang/rust/pull/69403/
 858 [69033]: https://github.com/rust-lang/rust/pull/69033/
 859 [68692]: https://github.com/rust-lang/rust/pull/68692/
 860 [68334]: https://github.com/rust-lang/rust/pull/68334/
 861 [67502]: https://github.com/rust-lang/rust/pull/67502/
 862 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
 863 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
 864 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
 865 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
 866 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
 867 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
 868 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
 869 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
 870 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
 871 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
 872 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
 873 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
 874 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
 875
 876
 877 Version 1.43.1 (2020-05-07)
 878 ===========================
 879
 880 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
 881 * [Fixed the stabilization of AVX-512 features.][71473]
 882 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
 883
 884 [71430]: https://github.com/rust-lang/rust/pull/71430
 885 [71473]: https://github.com/rust-lang/rust/issues/71473
 886 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
 887
 888
 889 Version 1.43.0 (2020-04-23)
 890 ==========================
 891
 892 Language
 893 --------
 894 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
 895   the type inferred correctly.][68129]
 896 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
 897
 898 **Syntax only changes**
 899 - [Allow `type Foo: Ord` syntactically.][69361]
 900 - [Fuse associated and extern items up to defaultness.][69194]
 901 - [Syntactically allow `self` in all `fn` contexts.][68764]
 902 - [Merge `fn` syntax + cleanup item parsing.][68728]
 903 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
 904   For example, you may now write:
 905   ```rust
 906   macro_rules! mac_trait {
 907       ($i:item) => {
 908           trait T { $i }
 909       }
 910   }
 911   mac_trait! {
 912       fn foo() {}
 913   }
 914   ```
 915
 916 These are still rejected *semantically*, so you will likely receive an error but
 917 these changes can be seen and parsed by macros and
 918 conditional compilation.
 919
 920
 921 Compiler
 922 --------
 923 - [You can now pass multiple lint flags to rustc to override the previous
 924   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
 925   everything in the `unused` lint group except `unused-variables` which
 926   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
 927   everything in the `unused` lint group **including** `unused-variables` since
 928   the allow flag is specified before the deny flag (and therefore overridden).
 929 - [rustc will now prefer your system MinGW libraries over its bundled libraries
 930   if they are available on `windows-gnu`.][67429]
 931 - [rustc now buffers errors/warnings printed in JSON.][69227]
 932
 933 Libraries
 934 ---------
 935 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
 936   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
 937   respectively.][69538] **Note** These conversions are only available when `N`
 938   is `0..=32`.
 939 - [You can now use associated constants on floats and integers directly, rather
 940   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
 941   `f32::NAN` with no imports.
 942 - [`u8::is_ascii` is now `const`.][68984]
 943 - [`String` now implements `AsMut<str>`.][68742]
 944 - [Added the `primitive` module to `std` and `core`.][67637] This module
 945   reexports Rust's primitive types. This is mainly useful in macros
 946   where you want avoid these types being shadowed.
 947 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
 948 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
 949
 950 Stabilized APIs
 951 ---------------
 952 - [`Once::is_completed`]
 953 - [`f32::LOG10_2`]
 954 - [`f32::LOG2_10`]
 955 - [`f64::LOG10_2`]
 956 - [`f64::LOG2_10`]
 957 - [`iter::once_with`]
 958
 959 Cargo
 960 -----
 961 - [You can now set config `[profile]`s in your `.cargo/config`, or through
 962   your environment.][cargo/7823]
 963 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
 964   executable path when running integration tests or benchmarks.][cargo/7697]
 965   `<name>` is the name of your binary as-is e.g. If you wanted the executable
 966   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
 967
 968 Misc
 969 ----
 970 - [Certain checks in the `const_err` lint were deemed unrelated to const
 971   evaluation][69185], and have been moved to the `unconditional_panic` and
 972   `arithmetic_overflow` lints.
 973
 974 Compatibility Notes
 975 -------------------
 976
 977 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
 978   has been a warning since 1.36.0.
 979 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
 980   led to some instances being accepted, and now correctly emits a hard error.
 981
 982 [69340]: https://github.com/rust-lang/rust/pull/69340
 983
 984 Internal Only
 985 -------------
 986 These changes provide no direct user facing benefits, but represent significant
 987 improvements to the internals and overall performance of `rustc` and
 988 related tools.
 989
 990 - [All components are now built with `opt-level=3` instead of `2`.][67878]
 991 - [Improved how rustc generates drop code.][67332]
 992 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
 993 - [traits: preallocate 2 Vecs of known initial size][69022]
 994 - [Avoid exponential behaviour when relating types][68772]
 995 - [Skip `Drop` terminators for enum variants without drop glue][68943]
 996 - [Improve performance of coherence checks][68966]
 997 - [Deduplicate types in the generator witness][68672]
 998 - [Invert control in struct_lint_level.][68725]
 999
1000 [67332]: https://github.com/rust-lang/rust/pull/67332/
1001 [67429]: https://github.com/rust-lang/rust/pull/67429/
1002 [67637]: https://github.com/rust-lang/rust/pull/67637/
1003 [67642]: https://github.com/rust-lang/rust/pull/67642/
1004 [67878]: https://github.com/rust-lang/rust/pull/67878/
1005 [67885]: https://github.com/rust-lang/rust/pull/67885/
1006 [68129]: https://github.com/rust-lang/rust/pull/68129/
1007 [68672]: https://github.com/rust-lang/rust/pull/68672/
1008 [68725]: https://github.com/rust-lang/rust/pull/68725/
1009 [68728]: https://github.com/rust-lang/rust/pull/68728/
1010 [68738]: https://github.com/rust-lang/rust/pull/68738/
1011 [68742]: https://github.com/rust-lang/rust/pull/68742/
1012 [68764]: https://github.com/rust-lang/rust/pull/68764/
1013 [68772]: https://github.com/rust-lang/rust/pull/68772/
1014 [68943]: https://github.com/rust-lang/rust/pull/68943/
1015 [68952]: https://github.com/rust-lang/rust/pull/68952/
1016 [68966]: https://github.com/rust-lang/rust/pull/68966/
1017 [68984]: https://github.com/rust-lang/rust/pull/68984/
1018 [69022]: https://github.com/rust-lang/rust/pull/69022/
1019 [69185]: https://github.com/rust-lang/rust/pull/69185/
1020 [69194]: https://github.com/rust-lang/rust/pull/69194/
1021 [69201]: https://github.com/rust-lang/rust/pull/69201/
1022 [69227]: https://github.com/rust-lang/rust/pull/69227/
1023 [69548]: https://github.com/rust-lang/rust/pull/69548/
1024 [69256]: https://github.com/rust-lang/rust/pull/69256/
1025 [69361]: https://github.com/rust-lang/rust/pull/69361/
1026 [69366]: https://github.com/rust-lang/rust/pull/69366/
1027 [69538]: https://github.com/rust-lang/rust/pull/69538/
1028 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
1029 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
1030 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
1031 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
1032 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
1033 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
1034 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
1035 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
1036
1037
1038 Version 1.42.0 (2020-03-12)
1039 ==========================
1040
1041 Language
1042 --------
1043 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
1044   ```rust
1045   fn foo(words: &[&str]) {
1046       match words {
1047           ["Hello", "World", "!", ..] => println!("Hello World!"),
1048           ["Foo", "Bar", ..] => println!("Baz"),
1049           rest => println!("{:?}", rest),
1050       }
1051   }
1052   ```
1053 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
1054   that you can create an enum that has the exact layout and ABI of the type
1055   it contains.
1056 - [There are some *syntax-only* changes:][67131]
1057    - `default` is syntactically allowed before items in `trait` definitions.
1058    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
1059      leave out their bodies in favor of `;`.
1060    - Bounds on associated types in `impl`s are now syntactically allowed
1061      (e.g. `type Foo: Ord;`).
1062    - `...` (the C-variadic type) may occur syntactically directly as the type of
1063       any function parameter.
1064
1065   These are still rejected *semantically*, so you will likely receive an error
1066   but these changes can be seen and parsed by procedural macros and
1067   conditional compilation.
1068
1069 Compiler
1070 --------
1071 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
1072 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
1073 - [`Option::{expect,unwrap}` and
1074    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
1075    pointing to the location where they were called, rather than
1076    `core`'s internals. ][67887]
1077
1078 \* Refer to Rust's [platform support page][forge-platform-support] for more
1079 information on Rust's tiered platform support.
1080
1081 Libraries
1082 ---------
1083 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
1084 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
1085    to implement `Sized`.][67935]
1086 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
1087 - [`Layout::new` is now `const`.][66254]
1088 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
1089
1090
1091 Stabilized APIs
1092 ---------------
1093 - [`CondVar::wait_while`]
1094 - [`CondVar::wait_timeout_while`]
1095 - [`DebugMap::key`]
1096 - [`DebugMap::value`]
1097 - [`ManuallyDrop::take`]
1098 - [`matches!`]
1099 - [`ptr::slice_from_raw_parts_mut`]
1100 - [`ptr::slice_from_raw_parts`]
1101
1102 Cargo
1103 -----
1104 - [You no longer need to include `extern crate proc_macro;` to be able to
1105   `use proc_macro;` in the `2018` edition.][cargo/7700]
1106
1107 Compatibility Notes
1108 -------------------
1109 - [`Error::description` has been deprecated, and its use will now produce a
1110   warning.][66919] It's recommended to use `Display`/`to_string` instead.
1111
1112 [68253]: https://github.com/rust-lang/rust/pull/68253/
1113 [68348]: https://github.com/rust-lang/rust/pull/68348/
1114 [67935]: https://github.com/rust-lang/rust/pull/67935/
1115 [68339]: https://github.com/rust-lang/rust/pull/68339/
1116 [68122]: https://github.com/rust-lang/rust/pull/68122/
1117 [67712]: https://github.com/rust-lang/rust/pull/67712/
1118 [67887]: https://github.com/rust-lang/rust/pull/67887/
1119 [67131]: https://github.com/rust-lang/rust/pull/67131/
1120 [67233]: https://github.com/rust-lang/rust/pull/67233/
1121 [66899]: https://github.com/rust-lang/rust/pull/66899/
1122 [66919]: https://github.com/rust-lang/rust/pull/66919/
1123 [66254]: https://github.com/rust-lang/rust/pull/66254/
1124 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
1125 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
1126 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
1127 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
1128 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
1129 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
1130 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
1131 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
1132 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
1133
1134
1135 Version 1.41.1 (2020-02-27)
1136 ===========================
1137
1138 * [Always check types of static items][69145]
1139 * [Always check lifetime bounds of `Copy` impls][69145]
1140 * [Fix miscompilation in callers of `Layout::repeat`][69225]
1141
1142 [69225]: https://github.com/rust-lang/rust/issues/69225
1143 [69145]: https://github.com/rust-lang/rust/pull/69145
1144
1145
1146 Version 1.41.0 (2020-01-30)
1147 ===========================
1148
1149 Language
1150 --------
1151
1152 - [You can now pass type parameters to foreign items when implementing
1153   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
1154 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
1155   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
1156   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
1157 - [You can now use any valid identifier in a `format_args` macro.][66847]
1158   Previously identifiers starting with an underscore were not allowed.
1159 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
1160   enum variants.][66183] These are still rejected semantically, but
1161   can be seen and parsed by procedural macros and conditional compilation.
1162
1163 Compiler
1164 --------
1165
1166 - [Rustc will now warn if you have unused loop `'label`s.][66325]
1167 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
1168 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
1169 - [You can now pass an arguments file passing the `@path` syntax
1170   to rustc.][66172] Note that the format differs somewhat from what is
1171   found in other tooling; please see [the documentation][argfile-docs] for
1172   more information.
1173 - [You can now provide `--extern` flag without a path, indicating that it is
1174   available from the search path or specified with an `-L` flag.][64882]
1175
1176 \* Refer to Rust's [platform support page][forge-platform-support] for more
1177 information on Rust's tiered platform support.
1178
1179 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
1180
1181 Libraries
1182 ---------
1183
1184 - [The `core::panic` module is now stable.][66771] It was already stable
1185   through `std`.
1186 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
1187   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
1188 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
1189
1190 Stabilized APIs
1191 ---------------
1192
1193 - [`Result::map_or`]
1194 - [`Result::map_or_else`]
1195 - [`std::rc::Weak::weak_count`]
1196 - [`std::rc::Weak::strong_count`]
1197 - [`std::sync::Weak::weak_count`]
1198 - [`std::sync::Weak::strong_count`]
1199
1200 Cargo
1201 -----
1202
1203 - [Cargo will now document all the private items for binary crates
1204   by default.][cargo/7593]
1205 - [`cargo-install` will now reinstall the package if it detects that it is out
1206   of date.][cargo/7560]
1207 - [Cargo.lock now uses a more git friendly format that should help to reduce
1208   merge conflicts.][cargo/7579]
1209 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
1210   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
1211   optimisation level to `2` for debug builds. You can also use
1212   `[profile.<profile>.build-override]` to override build scripts and
1213   their dependencies.
1214
1215 Misc
1216 ----
1217
1218 - [You can now specify `edition` in documentation code blocks to compile the block
1219   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
1220   should be compiled the 2018 edition of Rust.
1221 - [You can now provide custom themes to rustdoc with `--theme`, and check the
1222   current theme with `--check-theme`.][54733]
1223 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
1224
1225 Compatibility Notes
1226 -------------------
1227
1228 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
1229   Apple targets.][apple-32bit-drop] This means that the source code is still
1230   available to build, but the targets are no longer being tested and release
1231   binaries for those platforms will no longer be distributed by the Rust project.
1232   Please refer to the linked blog post for more information.
1233
1234 [54733]: https://github.com/rust-lang/rust/pull/54733/
1235 [61351]: https://github.com/rust-lang/rust/pull/61351/
1236 [67255]: https://github.com/rust-lang/rust/pull/67255/
1237 [66661]: https://github.com/rust-lang/rust/pull/66661/
1238 [66771]: https://github.com/rust-lang/rust/pull/66771/
1239 [66847]: https://github.com/rust-lang/rust/pull/66847/
1240 [66238]: https://github.com/rust-lang/rust/pull/66238/
1241 [66277]: https://github.com/rust-lang/rust/pull/66277/
1242 [66325]: https://github.com/rust-lang/rust/pull/66325/
1243 [66172]: https://github.com/rust-lang/rust/pull/66172/
1244 [66183]: https://github.com/rust-lang/rust/pull/66183/
1245 [65879]: https://github.com/rust-lang/rust/pull/65879/
1246 [65013]: https://github.com/rust-lang/rust/pull/65013/
1247 [64882]: https://github.com/rust-lang/rust/pull/64882/
1248 [64325]: https://github.com/rust-lang/rust/pull/64325/
1249 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
1250 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
1251 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
1252 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
1253 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
1254 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
1255 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
1256 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
1257 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
1258 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
1259 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
1260
1261 Version 1.40.0 (2019-12-19)
1262 ===========================
1263
1264 Language
1265 --------
1266 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
1267   `const` contexts.][65188] e.g.
1268
1269   ```rust
1270   pub struct Point(i32, i32);
1271
1272   const ORIGIN: Point = {
1273       let constructor = Point;
1274
1275       constructor(0, 0)
1276   };
1277   ```
1278
1279 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
1280   indicate that there may be variants or fields added in the future.][64639]
1281   For example this requires adding a wild-card branch (`_ => {}`) to any match
1282   statements on a non-exhaustive `enum`. [(RFC 2008)]
1283 - [You can now use function-like procedural macros in `extern` blocks and in
1284   type positions.][63931] e.g. `type Generated = macro!();`
1285 - [Function-like and attribute procedural macros can now emit
1286   `macro_rules!` items, so you can now have your macros generate macros.][64035]
1287 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
1288   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
1289   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
1290
1291 Compiler
1292 --------
1293 - [Added tier 3 support\* for the
1294   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
1295 - [Added tier 3 support for the
1296   `aarch64-unknown-none-softfloat` target.][64589]
1297 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
1298   `mips64el-unknown-linux-muslabi64` targets.][65843]
1299
1300 \* Refer to Rust's [platform support page][forge-platform-support] for more
1301   information on Rust's tiered platform support.
1302
1303 Libraries
1304 ---------
1305 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
1306
1307 Stabilized APIs
1308 ---------------
1309 - [`BTreeMap::get_key_value`]
1310 - [`HashMap::get_key_value`]
1311 - [`Option::as_deref_mut`]
1312 - [`Option::as_deref`]
1313 - [`Option::flatten`]
1314 - [`UdpSocket::peer_addr`]
1315 - [`f32::to_be_bytes`]
1316 - [`f32::to_le_bytes`]
1317 - [`f32::to_ne_bytes`]
1318 - [`f64::to_be_bytes`]
1319 - [`f64::to_le_bytes`]
1320 - [`f64::to_ne_bytes`]
1321 - [`f32::from_be_bytes`]
1322 - [`f32::from_le_bytes`]
1323 - [`f32::from_ne_bytes`]
1324 - [`f64::from_be_bytes`]
1325 - [`f64::from_le_bytes`]
1326 - [`f64::from_ne_bytes`]
1327 - [`mem::take`]
1328 - [`slice::repeat`]
1329 - [`todo!`]
1330
1331 Cargo
1332 -----
1333 - [Cargo will now always display warnings, rather than only on
1334   fresh builds.][cargo/7450]
1335 - [Feature flags (except `--all-features`) passed to a virtual workspace will
1336   now produce an error.][cargo/7507] Previously these flags were ignored.
1337 - [You can now publish `dev-dependencies` without including
1338   a `version`.][cargo/7333]
1339
1340 Misc
1341 ----
1342 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
1343   when running documentation tests with `rustdoc`.][63803]
1344
1345 Compatibility Notes
1346 -------------------
1347 - [As previously announced, any previous NLL warnings in the 2015 edition are
1348   now hard errors.][64221]
1349 - [The `include!` macro will now warn if it failed to include the
1350   entire file.][64284] The `include!` macro unintentionally only includes the
1351   first _expression_ in a file, and this can be unintuitive. This will become
1352   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
1353 - [Using `#[inline]` on function prototypes and consts now emits a warning under
1354   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
1355   or `extern` blocks now correctly emits a hard error.
1356
1357 [65294]: https://github.com/rust-lang/rust/pull/65294/
1358 [66103]: https://github.com/rust-lang/rust/pull/66103/
1359 [65843]: https://github.com/rust-lang/rust/pull/65843/
1360 [65188]: https://github.com/rust-lang/rust/pull/65188/
1361 [65092]: https://github.com/rust-lang/rust/pull/65092/
1362 [64589]: https://github.com/rust-lang/rust/pull/64589/
1363 [64639]: https://github.com/rust-lang/rust/pull/64639/
1364 [64221]: https://github.com/rust-lang/rust/pull/64221/
1365 [64284]: https://github.com/rust-lang/rust/pull/64284/
1366 [63931]: https://github.com/rust-lang/rust/pull/63931/
1367 [64035]: https://github.com/rust-lang/rust/pull/64035/
1368 [63674]: https://github.com/rust-lang/rust/pull/63674/
1369 [63803]: https://github.com/rust-lang/rust/pull/63803/
1370 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
1371 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
1372 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
1373 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
1374 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
1375 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
1376 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
1377 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
1378 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
1379 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
1380 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
1381 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
1382 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
1383 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
1384 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
1385 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
1386 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
1387 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
1388 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
1389 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
1390 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
1391 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
1392 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
1393 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
1394 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
1395 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
1396
1397
1398 Version 1.39.0 (2019-11-07)
1399 ===========================
1400
1401 Language
1402 --------
1403 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
1404   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
1405 - [You can now use certain attributes on function, closure, and function pointer
1406   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
1407   `deny`, `forbid` as well as inert helper attributes used by procedural macro
1408   attributes applied to items. e.g.
1409   ```rust
1410   fn len(
1411       #[cfg(windows)] slice: &[u16],
1412       #[cfg(not(windows))] slice: &[u8],
1413   ) -> usize {
1414       slice.len()
1415   }
1416   ```
1417 - [You can now take shared references to bind-by-move patterns in the `if` guards
1418   of `match` arms.][63118] e.g.
1419   ```rust
1420   fn main() {
1421       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
1422
1423       match array {
1424           nums
1425   //      ---- `nums` is bound by move.
1426               if nums.iter().sum::<u8>() == 10
1427   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
1428           => {
1429               drop(nums);
1430   //          ----------- Legal as `nums` was bound by move and so we have ownership.
1431           }
1432           _ => unreachable!(),
1433       }
1434   }
1435   ```
1436
1437
1438
1439 Compiler
1440 --------
1441 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
1442 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
1443 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
1444   **Note** Cargo currently doesn't use this feature. Refer to
1445   [cargo#7315][cargo/7315] to track this feature's progress.
1446 - [You can now pass `--show-output` argument to test binaries to print the
1447   output of successful tests.][62600]
1448
1449
1450 \* Refer to Rust's [platform support page][forge-platform-support] for more
1451 information on Rust's tiered platform support.
1452
1453 Libraries
1454 ---------
1455 - [`Vec::new` and `String::new` are now `const` functions.][64028]
1456 - [`LinkedList::new` is now a `const` function.][63684]
1457 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
1458 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
1459   now `const`.][63786]
1460
1461 Stabilized APIs
1462 ---------------
1463 - [`Pin::into_inner`]
1464 - [`Instant::checked_duration_since`]
1465 - [`Instant::saturating_duration_since`]
1466
1467 Cargo
1468 -----
1469 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
1470 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
1471   `--all` is now deprecated.
1472
1473 Misc
1474 ----
1475 - [You can now pass `-Clinker` to rustdoc to control the linker used
1476   for compiling doctests.][63834]
1477
1478 Compatibility Notes
1479 -------------------
1480 - [Code that was previously accepted by the old borrow checker, but rejected by
1481   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
1482   previously a warning, and will also become a hard error in the Rust 2015
1483   edition in the 1.40.0 release.
1484 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
1485   run tests.][63827] This should improve performance when running a large
1486   amount of doctests.
1487 - [The `try!` macro will now issue a deprecation warning.][62672] It is
1488   recommended to use the `?` operator instead.
1489 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
1490   returned `0.0`.
1491
1492 [62600]: https://github.com/rust-lang/rust/pull/62600/
1493 [62672]: https://github.com/rust-lang/rust/pull/62672/
1494 [63118]: https://github.com/rust-lang/rust/pull/63118/
1495 [63209]: https://github.com/rust-lang/rust/pull/63209/
1496 [63402]: https://github.com/rust-lang/rust/pull/63402/
1497 [63565]: https://github.com/rust-lang/rust/pull/63565/
1498 [63595]: https://github.com/rust-lang/rust/pull/63595/
1499 [63684]: https://github.com/rust-lang/rust/pull/63684/
1500 [63698]: https://github.com/rust-lang/rust/pull/63698/
1501 [63770]: https://github.com/rust-lang/rust/pull/63770/
1502 [63786]: https://github.com/rust-lang/rust/pull/63786/
1503 [63827]: https://github.com/rust-lang/rust/pull/63827/
1504 [63834]: https://github.com/rust-lang/rust/pull/63834/
1505 [63927]: https://github.com/rust-lang/rust/pull/63927/
1506 [63933]: https://github.com/rust-lang/rust/pull/63933/
1507 [63934]: https://github.com/rust-lang/rust/pull/63934/
1508 [63938]: https://github.com/rust-lang/rust/pull/63938/
1509 [63940]: https://github.com/rust-lang/rust/pull/63940/
1510 [63941]: https://github.com/rust-lang/rust/pull/63941/
1511 [63945]: https://github.com/rust-lang/rust/pull/63945/
1512 [64010]: https://github.com/rust-lang/rust/pull/64010/
1513 [64028]: https://github.com/rust-lang/rust/pull/64028/
1514 [64334]: https://github.com/rust-lang/rust/pull/64334/
1515 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
1516 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
1517 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
1518 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
1519 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
1520 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
1521
1522 Version 1.38.0 (2019-09-26)
1523 ==========================
1524
1525 Language
1526 --------
1527 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
1528 - [The `#[deprecated]` attribute can now be used on macros.][62042]
1529
1530 Compiler
1531 --------
1532 - [Added pipelined compilation support to `rustc`.][62766] This will
1533   improve compilation times in some cases. For further information please refer
1534   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
1535 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
1536   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
1537   `x86_64-uwp-windows-msvc` targets.][60260]
1538 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
1539   `armv7-unknown-linux-musleabi` targets.][63107]
1540 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
1541 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
1542 - [Upgraded to LLVM 9.][62592]
1543
1544 \* Refer to Rust's [platform support page][forge-platform-support] for more
1545 information on Rust's tiered platform support.
1546
1547 Libraries
1548 ---------
1549 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
1550 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
1551   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
1552   is available at `std::clone::Clone`). This also makes all built-in macros
1553   available in `std`/`core` root. e.g. `std::include_bytes!`.
1554 - [`str::Chars` now implements `Debug`.][63000]
1555 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
1556 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
1557 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
1558 - [Added euclidean remainder and division operations (`div_euclid`,
1559   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
1560   `overflowing`, and `wrapping` versions are available for all
1561   integer primitives.
1562 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
1563   `PartialEq`.][61491]
1564 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
1565
1566 Stabilized APIs
1567 ---------------
1568 - [`<*const T>::cast`]
1569 - [`<*mut T>::cast`]
1570 - [`Duration::as_secs_f32`]
1571 - [`Duration::as_secs_f64`]
1572 - [`Duration::div_f32`]
1573 - [`Duration::div_f64`]
1574 - [`Duration::from_secs_f32`]
1575 - [`Duration::from_secs_f64`]
1576 - [`Duration::mul_f32`]
1577 - [`Duration::mul_f64`]
1578 - [`any::type_name`]
1579
1580 Cargo
1581 -----
1582 - [Added pipelined compilation support to `cargo`.][cargo/7143]
1583 - [You can now pass the `--features` option multiple times to enable
1584   multiple features.][cargo/7084]
1585
1586 Misc
1587 ----
1588 - [`rustc` will now warn about some incorrect uses of
1589   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
1590
1591 Compatibility Notes
1592 -------------------
1593 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
1594   1.38.0.
1595 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
1596   issues][62896] with certain crates such as libc.
1597
1598 [60260]: https://github.com/rust-lang/rust/pull/60260/
1599 [61457]: https://github.com/rust-lang/rust/pull/61457/
1600 [61491]: https://github.com/rust-lang/rust/pull/61491/
1601 [61884]: https://github.com/rust-lang/rust/pull/61884/
1602 [61953]: https://github.com/rust-lang/rust/pull/61953/
1603 [62042]: https://github.com/rust-lang/rust/pull/62042/
1604 [62528]: https://github.com/rust-lang/rust/pull/62528/
1605 [62583]: https://github.com/rust-lang/rust/pull/62583/
1606 [62735]: https://github.com/rust-lang/rust/pull/62735/
1607 [62766]: https://github.com/rust-lang/rust/pull/62766/
1608 [62784]: https://github.com/rust-lang/rust/pull/62784/
1609 [62592]: https://github.com/rust-lang/rust/pull/62592/
1610 [62785]: https://github.com/rust-lang/rust/issues/62785/
1611 [62814]: https://github.com/rust-lang/rust/pull/62814/
1612 [62896]: https://github.com/rust-lang/rust/issues/62896/
1613 [63000]: https://github.com/rust-lang/rust/pull/63000/
1614 [63056]: https://github.com/rust-lang/rust/pull/63056/
1615 [63107]: https://github.com/rust-lang/rust/pull/63107/
1616 [63346]: https://github.com/rust-lang/rust/pull/63346/
1617 [63421]: https://github.com/rust-lang/rust/pull/63421/
1618 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
1619 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
1620 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1621 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1622 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
1623 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
1624 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
1625 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
1626 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
1627 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
1628 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
1629 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
1630 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
1631 [forge-platform-support]: https://forge.rust-lang.org/release/platform-support.html
1632 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
1633
1634 Version 1.37.0 (2019-08-15)
1635 ==========================
1636
1637 Language
1638 --------
1639 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
1640   [`Box`][62228], or an [array][62235] and unused.
1641 - [You can now use the `cfg` and `cfg_attr` attributes on
1642   generic parameters.][61547]
1643 - [You can now use enum variants through type alias.][61682] e.g. You can
1644   write the following:
1645   ```rust
1646   type MyOption = Option<u8>;
1647
1648   fn increment_or_zero(x: MyOption) -> u8 {
1649       match x {
1650           MyOption::Some(y) => y + 1,
1651           MyOption::None => 0,
1652       }
1653   }
1654   ```
1655 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
1656   `const _: u32 = 5;`.
1657 - [You can now use `#[repr(align(X)]` on enums.][61229]
1658 - [The  `?` Kleene macro operator is now available in the
1659   2015 edition.][60932]
1660
1661 Compiler
1662 --------
1663 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
1664   and `-C profile-use` flags.][61268] For more information on how to use profile
1665   guided optimization, please refer to the [rustc book][rustc-book-pgo].
1666 - [The `rust-lldb` wrapper script should now work again.][61827]
1667
1668 Libraries
1669 ---------
1670 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
1671
1672 Stabilized APIs
1673 ---------------
1674 - [`BufReader::buffer`]
1675 - [`BufWriter::buffer`]
1676 - [`Cell::from_mut`]
1677 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
1678 - [`DoubleEndedIterator::nth_back`]
1679 - [`Option::xor`]
1680 - [`Wrapping::reverse_bits`]
1681 - [`i128::reverse_bits`]
1682 - [`i16::reverse_bits`]
1683 - [`i32::reverse_bits`]
1684 - [`i64::reverse_bits`]
1685 - [`i8::reverse_bits`]
1686 - [`isize::reverse_bits`]
1687 - [`slice::copy_within`]
1688 - [`u128::reverse_bits`]
1689 - [`u16::reverse_bits`]
1690 - [`u32::reverse_bits`]
1691 - [`u64::reverse_bits`]
1692 - [`u8::reverse_bits`]
1693 - [`usize::reverse_bits`]
1694
1695 Cargo
1696 -----
1697 - [`Cargo.lock` files are now included by default when publishing executable crates
1698   with executables.][cargo/7026]
1699 - [You can now specify `default-run="foo"` in `[package]` to specify the
1700   default executable to use for `cargo run`.][cargo/7056]
1701
1702 Misc
1703 ----
1704
1705 Compatibility Notes
1706 -------------------
1707 - [Using `...` for inclusive range patterns will now warn by default.][61342]
1708   Please transition your code to using the `..=` syntax for inclusive
1709   ranges instead.
1710 - [Using a trait object without the `dyn` will now warn by default.][61203]
1711   Please transition your code to use `dyn Trait` for trait objects instead.
1712
1713 [62228]: https://github.com/rust-lang/rust/pull/62228/
1714 [62235]: https://github.com/rust-lang/rust/pull/62235/
1715 [61802]: https://github.com/rust-lang/rust/pull/61802/
1716 [61827]: https://github.com/rust-lang/rust/pull/61827/
1717 [61547]: https://github.com/rust-lang/rust/pull/61547/
1718 [61682]: https://github.com/rust-lang/rust/pull/61682/
1719 [61268]: https://github.com/rust-lang/rust/pull/61268/
1720 [61342]: https://github.com/rust-lang/rust/pull/61342/
1721 [61347]: https://github.com/rust-lang/rust/pull/61347/
1722 [61100]: https://github.com/rust-lang/rust/pull/61100/
1723 [61203]: https://github.com/rust-lang/rust/pull/61203/
1724 [61229]: https://github.com/rust-lang/rust/pull/61229/
1725 [60932]: https://github.com/rust-lang/rust/pull/60932/
1726 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
1727 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
1728 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
1729 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
1730 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
1731 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
1732 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
1733 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
1734 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
1735 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
1736 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
1737 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
1738 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
1739 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
1740 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
1741 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
1742 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
1743 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
1744 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
1745 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
1746 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
1747 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
1748 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
1749 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
1750
1751
1752 Version 1.36.0 (2019-07-04)
1753 ==========================
1754
1755 Language
1756 --------
1757 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
1758 - [The order of traits in trait objects no longer affects the semantics of that
1759   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
1760   `dyn fmt::Debug + Send`, where this was previously not the case.
1761
1762 Libraries
1763 ---------
1764 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
1765 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
1766 - [`mem::needs_drop` is now available as a const fn.][60364]
1767 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
1768 - [`String` now implements `BorrowMut<str>`.][60404]
1769 - [`io::Cursor` now implements `Default`.][60234]
1770 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
1771 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
1772   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
1773   environment has access to heap memory allocation.
1774 - [`String` now implements `From<&String>`.][59825]
1775 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
1776   return a tuple of each argument when there is multiple arguments.
1777 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
1778   not used.][59648]
1779
1780 Stabilized APIs
1781 ---------------
1782 - [`VecDeque::rotate_left`]
1783 - [`VecDeque::rotate_right`]
1784 - [`Iterator::copied`]
1785 - [`io::IoSlice`]
1786 - [`io::IoSliceMut`]
1787 - [`Read::read_vectored`]
1788 - [`Write::write_vectored`]
1789 - [`str::as_mut_ptr`]
1790 - [`mem::MaybeUninit`]
1791 - [`pointer::align_offset`]
1792 - [`future::Future`]
1793 - [`task::Context`]
1794 - [`task::RawWaker`]
1795 - [`task::RawWakerVTable`]
1796 - [`task::Waker`]
1797 - [`task::Poll`]
1798
1799 Cargo
1800 -----
1801 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
1802 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
1803
1804 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
1805
1806 Clippy
1807 ------
1808 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
1809
1810 Misc
1811 ----
1812
1813 Compatibility Notes
1814 -------------------
1815 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
1816   longer recommended, and will be deprecated in 1.39.0.
1817
1818 [60318]: https://github.com/rust-lang/rust/pull/60318/
1819 [60364]: https://github.com/rust-lang/rust/pull/60364/
1820 [60370]: https://github.com/rust-lang/rust/pull/60370/
1821 [60404]: https://github.com/rust-lang/rust/pull/60404/
1822 [60234]: https://github.com/rust-lang/rust/pull/60234/
1823 [60244]: https://github.com/rust-lang/rust/pull/60244/
1824 [58623]: https://github.com/rust-lang/rust/pull/58623/
1825 [59648]: https://github.com/rust-lang/rust/pull/59648/
1826 [59675]: https://github.com/rust-lang/rust/pull/59675/
1827 [59825]: https://github.com/rust-lang/rust/pull/59825/
1828 [59826]: https://github.com/rust-lang/rust/pull/59826/
1829 [59445]: https://github.com/rust-lang/rust/pull/59445/
1830 [59114]: https://github.com/rust-lang/rust/pull/59114/
1831 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
1832 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
1833 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
1834 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
1835 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
1836 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
1837 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
1838 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
1839 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
1840 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
1841 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
1842 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
1843 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
1844 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
1845 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
1846 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
1847 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
1848 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
1849 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
1850 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
1851
1852
1853 Version 1.35.0 (2019-05-23)
1854 ==========================
1855
1856 Language
1857 --------
1858 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
1859   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
1860 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
1861   ```rust
1862   unsafe fn call_unsafe(func: unsafe fn()) {
1863       func()
1864   }
1865
1866   pub fn main() {
1867       unsafe { call_unsafe(|| {}); }
1868   }
1869   ```
1870
1871
1872 Compiler
1873 --------
1874 - [Added the `armv6-unknown-freebsd-gnueabihf` and
1875   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
1876 - [Added the `wasm32-unknown-wasi` target.][59464]
1877
1878
1879 Libraries
1880 ---------
1881 - [`Thread` will now show its ID in `Debug` output.][59460]
1882 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
1883 - [`alloc::System` now implements `Default`.][59451]
1884 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
1885   last field.][59076]
1886 - [`char::{ToLowercase, ToUppercase}` now
1887   implement `ExactSizeIterator`.][58778]
1888 - [All `NonZero` numeric types now implement `FromStr`.][58717]
1889 - [Removed the `Read` trait bounds
1890   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
1891 - [You can now call the `dbg!` macro without any parameters to print the file
1892   and line where it is called.][57847]
1893 - [In place ASCII case conversions are now up to 4× faster.][59283]
1894   e.g. `str::make_ascii_lowercase`
1895 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
1896   and `Send`.][58369]
1897
1898 Stabilized APIs
1899 ---------------
1900 - [`f32::copysign`]
1901 - [`f64::copysign`]
1902 - [`RefCell::replace_with`]
1903 - [`RefCell::map_split`]
1904 - [`ptr::hash`]
1905 - [`Range::contains`]
1906 - [`RangeFrom::contains`]
1907 - [`RangeTo::contains`]
1908 - [`RangeInclusive::contains`]
1909 - [`RangeToInclusive::contains`]
1910 - [`Option::copied`]
1911
1912 Cargo
1913 -----
1914 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
1915   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
1916   platform specific.
1917
1918 Misc
1919 ----
1920 - [The Rust toolchain is now available natively for musl based distros.][58575]
1921
1922 [59460]: https://github.com/rust-lang/rust/pull/59460/
1923 [59464]: https://github.com/rust-lang/rust/pull/59464/
1924 [59500]: https://github.com/rust-lang/rust/pull/59500/
1925 [59512]: https://github.com/rust-lang/rust/pull/59512/
1926 [59580]: https://github.com/rust-lang/rust/pull/59580/
1927 [59283]: https://github.com/rust-lang/rust/pull/59283/
1928 [59451]: https://github.com/rust-lang/rust/pull/59451/
1929 [59076]: https://github.com/rust-lang/rust/pull/59076/
1930 [58778]: https://github.com/rust-lang/rust/pull/58778/
1931 [58717]: https://github.com/rust-lang/rust/pull/58717/
1932 [58369]: https://github.com/rust-lang/rust/pull/58369/
1933 [58423]: https://github.com/rust-lang/rust/pull/58423/
1934 [58080]: https://github.com/rust-lang/rust/pull/58080/
1935 [57847]: https://github.com/rust-lang/rust/pull/57847/
1936 [58575]: https://github.com/rust-lang/rust/pull/58575
1937 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
1938 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
1939 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
1940 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
1941 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
1942 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
1943 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
1944 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
1945 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
1946 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
1947 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
1948 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
1949
1950 Version 1.34.2 (2019-05-14)
1951 ===========================
1952
1953 * [Destabilize the `Error::type_id` function due to a security
1954    vulnerability][60785] ([CVE-2019-12083])
1955
1956 [60785]: https://github.com/rust-lang/rust/pull/60785
1957 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
1958
1959 Version 1.34.1 (2019-04-25)
1960 ===========================
1961
1962 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
1963 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
1964 * [Fix Clippy panic when checking some macros][clippy/3805]
1965
1966 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
1967 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
1968 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
1969
1970 Version 1.34.0 (2019-04-11)
1971 ==========================
1972
1973 Language
1974 --------
1975 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
1976   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
1977   but had no effect.
1978 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
1979   `#[attr{}]` procedural macros.][57367]
1980 - [You can now write `extern crate self as foo;`][57407] to import your
1981   crate's root into the extern prelude.
1982
1983
1984 Compiler
1985 --------
1986 - [You can now target `riscv64imac-unknown-none-elf` and
1987   `riscv64gc-unknown-none-elf`.][58406]
1988 - [You can now enable linker plugin LTO optimisations with
1989   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
1990   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
1991   boundaries.
1992 - [You can now target `powerpc64-unknown-freebsd`.][57809]
1993
1994
1995 Libraries
1996 ---------
1997 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
1998   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
1999   the `Hash` trait to create an iterator.
2000 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
2001   methods.][58421] Most notably you no longer require the `Ord` trait to create
2002   an iterator.
2003 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
2004   for all numeric types.][58044]
2005 - [Indexing a `str` is now generic over all types that
2006   implement `SliceIndex<str>`.][57604]
2007 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
2008   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
2009   produce a warning if their returning type is unused.
2010 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
2011   `overflowing_pow` are now available for all numeric types.][57873] These are
2012   equivalent to methods such as `wrapping_add` for the `pow` operation.
2013
2014
2015 Stabilized APIs
2016 ---------------
2017
2018 #### std & core
2019 * [`Any::type_id`]
2020 * [`Error::type_id`]
2021 * [`atomic::AtomicI16`]
2022 * [`atomic::AtomicI32`]
2023 * [`atomic::AtomicI64`]
2024 * [`atomic::AtomicI8`]
2025 * [`atomic::AtomicU16`]
2026 * [`atomic::AtomicU32`]
2027 * [`atomic::AtomicU64`]
2028 * [`atomic::AtomicU8`]
2029 * [`convert::Infallible`]
2030 * [`convert::TryFrom`]
2031 * [`convert::TryInto`]
2032 * [`iter::from_fn`]
2033 * [`iter::successors`]
2034 * [`num::NonZeroI128`]
2035 * [`num::NonZeroI16`]
2036 * [`num::NonZeroI32`]
2037 * [`num::NonZeroI64`]
2038 * [`num::NonZeroI8`]
2039 * [`num::NonZeroIsize`]
2040 * [`slice::sort_by_cached_key`]
2041 * [`str::escape_debug`]
2042 * [`str::escape_default`]
2043 * [`str::escape_unicode`]
2044 * [`str::split_ascii_whitespace`]
2045
2046 #### std
2047 * [`Instant::checked_add`]
2048 * [`Instant::checked_sub`]
2049 * [`SystemTime::checked_add`]
2050 * [`SystemTime::checked_sub`]
2051
2052 Cargo
2053 -----
2054 - [You can now use alternative registries to crates.io.][cargo/6654]
2055
2056 Misc
2057 ----
2058 - [You can now use the `?` operator in your documentation tests without manually
2059   adding `fn main() -> Result<(), _> {}`.][56470]
2060
2061 Compatibility Notes
2062 -------------------
2063 - [`Command::before_exec` is being replaced by the unsafe method
2064   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
2065 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
2066   can now use `const` functions in `static` variables.
2067
2068 [58370]: https://github.com/rust-lang/rust/pull/58370/
2069 [58406]: https://github.com/rust-lang/rust/pull/58406/
2070 [58421]: https://github.com/rust-lang/rust/pull/58421/
2071 [58166]: https://github.com/rust-lang/rust/pull/58166/
2072 [58044]: https://github.com/rust-lang/rust/pull/58044/
2073 [58057]: https://github.com/rust-lang/rust/pull/58057/
2074 [58059]: https://github.com/rust-lang/rust/pull/58059/
2075 [57809]: https://github.com/rust-lang/rust/pull/57809/
2076 [57873]: https://github.com/rust-lang/rust/pull/57873/
2077 [57604]: https://github.com/rust-lang/rust/pull/57604/
2078 [57367]: https://github.com/rust-lang/rust/pull/57367/
2079 [57407]: https://github.com/rust-lang/rust/pull/57407/
2080 [57425]: https://github.com/rust-lang/rust/pull/57425/
2081 [57106]: https://github.com/rust-lang/rust/pull/57106/
2082 [56470]: https://github.com/rust-lang/rust/pull/56470/
2083 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
2084 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
2085 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
2086 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
2087 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
2088 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
2089 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
2090 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
2091 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
2092 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
2093 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
2094 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
2095 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
2096 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
2097 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
2098 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
2099 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
2100 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
2101 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
2102 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
2103 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
2104 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
2105 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
2106 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
2107 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
2108 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
2109 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
2110 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
2111 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
2112 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
2113 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
2114
2115
2116 Version 1.33.0 (2019-02-28)
2117 ==========================
2118
2119 Language
2120 --------
2121 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
2122   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
2123 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
2124   E.g. You can have match statement on a `u8` that covers `0..=255` and
2125   you would no longer be required to have a `_ => unreachable!()` case.
2126 - [You can now have multiple patterns in `if let` and `while let`
2127   expressions.][57532] You can do this with the same syntax as a `match`
2128   expression. E.g.
2129   ```rust
2130   enum Creature {
2131       Crab(String),
2132       Lobster(String),
2133       Person(String),
2134   }
2135
2136   fn main() {
2137       let state = Creature::Crab("Ferris");
2138
2139       if let Creature::Crab(name) | Creature::Person(name) = state {
2140           println!("This creature's name is: {}", name);
2141       }
2142   }
2143   ```
2144 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
2145   this feature will by default produce a warning as this behaviour can be
2146   unintuitive. E.g. `if let _ = 5 {}`
2147 - [You can now use `let` bindings, assignments, expression statements,
2148   and irrefutable pattern destructuring in const functions.][57175]
2149 - [You can now call unsafe const functions.][57067] E.g.
2150   ```rust
2151   const unsafe fn foo() -> i32 { 5 }
2152   const fn bar() -> i32 {
2153       unsafe { foo() }
2154   }
2155   ```
2156 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
2157   E.g. `#[cfg_attr(all(), must_use, optimize)]`
2158 - [You can now specify a specific alignment with the `#[repr(packed)]`
2159   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
2160   with an alignment of 2 bytes and a size of 6 bytes.
2161 - [You can now import an item from a module as an `_`.][56303] This allows you to
2162   import a trait's impls, and not have the name in the namespace. E.g.
2163   ```rust
2164   use std::io::Read as _;
2165
2166   // Allowed as there is only one `Read` in the module.
2167   pub trait Read {}
2168   ```
2169 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
2170
2171 Compiler
2172 --------
2173 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
2174   command line argument.][56351]
2175 - [The minimum required LLVM version has been bumped to 6.0.][56642]
2176 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
2177 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
2178   tier 2 support.][57130] Visit the [platform support][platform-support] page for
2179   information on Rust's platform support.
2180 - [Added support for the `thumbv7neon-linux-androideabi` and
2181   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
2182 - [Added support for the `x86_64-unknown-uefi` target.][56769]
2183
2184 Libraries
2185 ---------
2186 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
2187   functions for all numeric types.][57566]
2188 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
2189   are now `const` functions for all numeric types.][57105]
2190 - [The methods `is_positive` and `is_negative` are now `const` functions for
2191   all signed numeric types.][57105]
2192 - [The `get` method for all `NonZero` types is now `const`.][57167]
2193 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
2194   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
2195   numeric types.][57234]
2196 - [`Ipv4Addr::new` is now a `const` function][57234]
2197
2198 Stabilized APIs
2199 ---------------
2200 - [`unix::FileExt::read_exact_at`]
2201 - [`unix::FileExt::write_all_at`]
2202 - [`Option::transpose`]
2203 - [`Result::transpose`]
2204 - [`convert::identity`]
2205 - [`pin::Pin`]
2206 - [`marker::Unpin`]
2207 - [`marker::PhantomPinned`]
2208 - [`Vec::resize_with`]
2209 - [`VecDeque::resize_with`]
2210 - [`Duration::as_millis`]
2211 - [`Duration::as_micros`]
2212 - [`Duration::as_nanos`]
2213
2214
2215 Cargo
2216 -----
2217 - [You can now publish crates that require a feature flag to compile with
2218   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
2219 - [Cargo should now rebuild a crate if a file was modified during the initial
2220   build.][cargo/6484]
2221
2222 Compatibility Notes
2223 -------------------
2224 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
2225   are now deprecated in the standard library, and their usage will now produce a warning.
2226   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
2227   methods instead.
2228 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
2229   downcasting.
2230 - [Libtest no longer creates a new thread for each test when
2231   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
2232
2233 [55982]: https://github.com/rust-lang/rust/pull/55982/
2234 [56243]: https://github.com/rust-lang/rust/pull/56243
2235 [56303]: https://github.com/rust-lang/rust/pull/56303/
2236 [56351]: https://github.com/rust-lang/rust/pull/56351/
2237 [56362]: https://github.com/rust-lang/rust/pull/56362
2238 [56642]: https://github.com/rust-lang/rust/pull/56642/
2239 [56769]: https://github.com/rust-lang/rust/pull/56769/
2240 [56805]: https://github.com/rust-lang/rust/pull/56805
2241 [56947]: https://github.com/rust-lang/rust/pull/56947/
2242 [57049]: https://github.com/rust-lang/rust/pull/57049/
2243 [57067]: https://github.com/rust-lang/rust/pull/57067/
2244 [57105]: https://github.com/rust-lang/rust/pull/57105
2245 [57130]: https://github.com/rust-lang/rust/pull/57130/
2246 [57167]: https://github.com/rust-lang/rust/pull/57167/
2247 [57175]: https://github.com/rust-lang/rust/pull/57175/
2248 [57234]: https://github.com/rust-lang/rust/pull/57234/
2249 [57332]: https://github.com/rust-lang/rust/pull/57332/
2250 [57465]: https://github.com/rust-lang/rust/pull/57465/
2251 [57532]: https://github.com/rust-lang/rust/pull/57532/
2252 [57535]: https://github.com/rust-lang/rust/pull/57535/
2253 [57566]: https://github.com/rust-lang/rust/pull/57566/
2254 [57615]: https://github.com/rust-lang/rust/pull/57615/
2255 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
2256 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
2257 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
2258 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
2259 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
2260 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
2261 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
2262 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
2263 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
2264 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
2265 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
2266 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
2267 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
2268 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
2269 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
2270 [platform-support]: https://forge.rust-lang.org/platform-support.html
2271
2272 Version 1.32.0 (2019-01-17)
2273 ==========================
2274
2275 Language
2276 --------
2277 #### 2018 edition
2278 - [You can now use the `?` operator in macro definitions.][56245] The `?`
2279   operator allows you to specify zero or one repetitions similar to the `*` and
2280   `+` operators.
2281 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
2282   now always resolve to the item (`enum`, `struct`, etc.) available in the
2283   module if present, before resolving to a external crate or an item the prelude.][56759]
2284   E.g.
2285   ```rust
2286   enum Color { Red, Green, Blue }
2287
2288   use Color::*;
2289   ```
2290
2291 #### All editions
2292 - [You can now match against `PhantomData<T>` types.][55837]
2293 - [You can now match against literals in macros with the `literal`
2294   specifier.][56072] This will match against a literal of any type.
2295   E.g. `1`, `'A'`, `"Hello World"`
2296 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
2297   ```rust
2298   struct Point(i32, i32);
2299
2300   impl Point {
2301       pub fn new(x: i32, y: i32) -> Self {
2302           Self(x, y)
2303       }
2304
2305       pub fn is_origin(&self) -> bool {
2306           match self {
2307               Self(0, 0) => true,
2308               _ => false,
2309           }
2310       }
2311   }
2312   ```
2313 - [Self can also now be used in type definitions.][56366] E.g.
2314   ```rust
2315   enum List<T>
2316   where
2317       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
2318   {
2319       Nil,
2320       Cons(T, Box<Self>) // likewise here
2321   }
2322   ```
2323 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
2324   a `impl Trait` or `dyn Trait` is returned and unused in the program.
2325
2326 Compiler
2327 --------
2328 - [The default allocator has changed from jemalloc to the default allocator on
2329   your system.][55238] The compiler itself on Linux & macOS will still use
2330   jemalloc, but programs compiled with it will use the system allocator.
2331 - [Added the `aarch64-pc-windows-msvc` target.][55702]
2332
2333 Libraries
2334 ---------
2335 - [`PathBuf` now implements `FromStr`.][55148]
2336 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
2337 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
2338   easily debug expressions in your rust program. E.g.
2339   ```rust
2340   let a = 2;
2341   let b = dbg!(a * 2) + 1;
2342   //      ^-- prints: [src/main.rs:4] a * 2 = 4
2343   assert_eq!(b, 5);
2344   ```
2345
2346 The following APIs are now `const` functions and can be used in a
2347 `const` context.
2348
2349 - [`Cell::as_ptr`]
2350 - [`UnsafeCell::get`]
2351 - [`char::is_ascii`]
2352 - [`iter::empty`]
2353 - [`ManuallyDrop::new`]
2354 - [`ManuallyDrop::into_inner`]
2355 - [`RangeInclusive::start`]
2356 - [`RangeInclusive::end`]
2357 - [`NonNull::as_ptr`]
2358 - [`slice::as_ptr`]
2359 - [`str::as_ptr`]
2360 - [`Duration::as_secs`]
2361 - [`Duration::subsec_millis`]
2362 - [`Duration::subsec_micros`]
2363 - [`Duration::subsec_nanos`]
2364 - [`CStr::as_ptr`]
2365 - [`Ipv4Addr::is_unspecified`]
2366 - [`Ipv6Addr::new`]
2367 - [`Ipv6Addr::octets`]
2368
2369 Stabilized APIs
2370 ---------------
2371 - [`i8::to_be_bytes`]
2372 - [`i8::to_le_bytes`]
2373 - [`i8::to_ne_bytes`]
2374 - [`i8::from_be_bytes`]
2375 - [`i8::from_le_bytes`]
2376 - [`i8::from_ne_bytes`]
2377 - [`i16::to_be_bytes`]
2378 - [`i16::to_le_bytes`]
2379 - [`i16::to_ne_bytes`]
2380 - [`i16::from_be_bytes`]
2381 - [`i16::from_le_bytes`]
2382 - [`i16::from_ne_bytes`]
2383 - [`i32::to_be_bytes`]
2384 - [`i32::to_le_bytes`]
2385 - [`i32::to_ne_bytes`]
2386 - [`i32::from_be_bytes`]
2387 - [`i32::from_le_bytes`]
2388 - [`i32::from_ne_bytes`]
2389 - [`i64::to_be_bytes`]
2390 - [`i64::to_le_bytes`]
2391 - [`i64::to_ne_bytes`]
2392 - [`i64::from_be_bytes`]
2393 - [`i64::from_le_bytes`]
2394 - [`i64::from_ne_bytes`]
2395 - [`i128::to_be_bytes`]
2396 - [`i128::to_le_bytes`]
2397 - [`i128::to_ne_bytes`]
2398 - [`i128::from_be_bytes`]
2399 - [`i128::from_le_bytes`]
2400 - [`i128::from_ne_bytes`]
2401 - [`isize::to_be_bytes`]
2402 - [`isize::to_le_bytes`]
2403 - [`isize::to_ne_bytes`]
2404 - [`isize::from_be_bytes`]
2405 - [`isize::from_le_bytes`]
2406 - [`isize::from_ne_bytes`]
2407 - [`u8::to_be_bytes`]
2408 - [`u8::to_le_bytes`]
2409 - [`u8::to_ne_bytes`]
2410 - [`u8::from_be_bytes`]
2411 - [`u8::from_le_bytes`]
2412 - [`u8::from_ne_bytes`]
2413 - [`u16::to_be_bytes`]
2414 - [`u16::to_le_bytes`]
2415 - [`u16::to_ne_bytes`]
2416 - [`u16::from_be_bytes`]
2417 - [`u16::from_le_bytes`]
2418 - [`u16::from_ne_bytes`]
2419 - [`u32::to_be_bytes`]
2420 - [`u32::to_le_bytes`]
2421 - [`u32::to_ne_bytes`]
2422 - [`u32::from_be_bytes`]
2423 - [`u32::from_le_bytes`]
2424 - [`u32::from_ne_bytes`]
2425 - [`u64::to_be_bytes`]
2426 - [`u64::to_le_bytes`]
2427 - [`u64::to_ne_bytes`]
2428 - [`u64::from_be_bytes`]
2429 - [`u64::from_le_bytes`]
2430 - [`u64::from_ne_bytes`]
2431 - [`u128::to_be_bytes`]
2432 - [`u128::to_le_bytes`]
2433 - [`u128::to_ne_bytes`]
2434 - [`u128::from_be_bytes`]
2435 - [`u128::from_le_bytes`]
2436 - [`u128::from_ne_bytes`]
2437 - [`usize::to_be_bytes`]
2438 - [`usize::to_le_bytes`]
2439 - [`usize::to_ne_bytes`]
2440 - [`usize::from_be_bytes`]
2441 - [`usize::from_le_bytes`]
2442 - [`usize::from_ne_bytes`]
2443
2444 Cargo
2445 -----
2446 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
2447 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
2448
2449 Misc
2450 ----
2451 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
2452
2453 Compatibility Notes
2454 -------------------
2455 - [The argument types for AVX's
2456   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
2457   been changed from `*const` to `*mut` as the previous implementation
2458   was unsound.
2459
2460
2461 [55148]: https://github.com/rust-lang/rust/pull/55148/
2462 [55238]: https://github.com/rust-lang/rust/pull/55238/
2463 [55280]: https://github.com/rust-lang/rust/pull/55280/
2464 [55610]: https://github.com/rust-lang/rust/pull/55610/
2465 [55663]: https://github.com/rust-lang/rust/pull/55663/
2466 [55702]: https://github.com/rust-lang/rust/pull/55702/
2467 [55837]: https://github.com/rust-lang/rust/pull/55837/
2468 [55843]: https://github.com/rust-lang/rust/pull/55843/
2469 [56072]: https://github.com/rust-lang/rust/pull/56072/
2470 [56245]: https://github.com/rust-lang/rust/pull/56245/
2471 [56365]: https://github.com/rust-lang/rust/pull/56365/
2472 [56366]: https://github.com/rust-lang/rust/pull/56366/
2473 [56395]: https://github.com/rust-lang/rust/pull/56395/
2474 [56759]: https://github.com/rust-lang/rust/pull/56759/
2475 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
2476 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
2477 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
2478 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
2479 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
2480 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2481 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2482 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
2483 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
2484 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
2485 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
2486 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
2487 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
2488 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
2489 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
2490 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
2491 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
2492 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
2493 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
2494 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
2495 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
2496 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
2497 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
2498 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
2499 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
2500 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
2501 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
2502 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
2503 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
2504 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
2505 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
2506 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
2507 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
2508 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
2509 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
2510 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
2511 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
2512 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
2513 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
2514 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
2515 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
2516 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
2517 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
2518 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
2519 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
2520 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
2521 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
2522 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
2523 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
2524 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
2525 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
2526 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
2527 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
2528 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
2529 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
2530 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
2531 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
2532 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
2533 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
2534 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
2535 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
2536 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
2537 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
2538 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
2539 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
2540 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
2541 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
2542 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
2543 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
2544 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
2545 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
2546 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
2547 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
2548 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
2549 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
2550 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
2551 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
2552 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
2553 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
2554 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
2555 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
2556 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
2557 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
2558 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
2559 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
2560 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
2561 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
2562 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
2563 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
2564 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
2565 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
2566 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
2567 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
2568
2569
2570 Version 1.31.1 (2018-12-20)
2571 ===========================
2572
2573 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
2574 - [Fix broken go-to-definition in RLS][rls/1171]
2575 - [Fix infinite loop on hover in RLS][rls/1170]
2576
2577 [56562]: https://github.com/rust-lang/rust/pull/56562
2578 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
2579 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
2580
2581 Version 1.31.0 (2018-12-06)
2582 ==========================
2583
2584 Language
2585 --------
2586 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
2587 - [New lifetime elision rules now allow for eliding lifetimes in functions and
2588   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
2589   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
2590   in structs.
2591 - [You can now define and use `const` functions.][54835] These are currently
2592   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
2593   [language reference][const-reference] for what exactly is available.
2594 - [You can now use tool lints, which allow you to scope lints from external
2595   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
2596 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
2597   a crate, not just in exported functions.][54451]
2598 - [You can now use parentheses in pattern matches.][54497]
2599
2600 Compiler
2601 --------
2602 - [Updated musl to 1.1.20][54430]
2603
2604 Libraries
2605 ---------
2606 - [You can now convert `num::NonZero*` types to their raw equivalents using the
2607   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
2608 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
2609   into `Option<&mut T>` using the `From` trait.][53218]
2610 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
2611
2612
2613 Stabilized APIs
2614 ---------------
2615 - [`slice::align_to`]
2616 - [`slice::align_to_mut`]
2617 - [`slice::chunks_exact`]
2618 - [`slice::chunks_exact_mut`]
2619 - [`slice::rchunks`]
2620 - [`slice::rchunks_mut`]
2621 - [`slice::rchunks_exact`]
2622 - [`slice::rchunks_exact_mut`]
2623 - [`Option::replace`]
2624
2625 Cargo
2626 -----
2627 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
2628 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
2629   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
2630
2631 [52813]: https://github.com/rust-lang/rust/pull/52813/
2632 [53218]: https://github.com/rust-lang/rust/pull/53218/
2633 [53555]: https://github.com/rust-lang/rust/issues/53555/
2634 [54057]: https://github.com/rust-lang/rust/pull/54057/
2635 [54240]: https://github.com/rust-lang/rust/pull/54240/
2636 [54430]: https://github.com/rust-lang/rust/pull/54430/
2637 [54451]: https://github.com/rust-lang/rust/pull/54451/
2638 [54497]: https://github.com/rust-lang/rust/pull/54497/
2639 [54778]: https://github.com/rust-lang/rust/pull/54778/
2640 [54835]: https://github.com/rust-lang/rust/pull/54835/
2641 [54870]: https://github.com/rust-lang/rust/pull/54870/
2642 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
2643 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
2644 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
2645 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
2646 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
2647 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
2648 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2649 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
2650 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2651 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
2652 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
2653 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
2654 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
2655 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
2656
2657 Version 1.30.1 (2018-11-08)
2658 ===========================
2659
2660 - [Fixed overflow ICE in rustdoc][54199]
2661 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
2662
2663 [54199]: https://github.com/rust-lang/rust/pull/54199
2664 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
2665
2666 Version 1.30.0 (2018-10-25)
2667 ==========================
2668
2669 Language
2670 --------
2671 - [Procedural macros are now available.][52081] These kinds of macros allow for
2672   more powerful code generation. There is a [new chapter available][proc-macros]
2673   in the Rust Programming Language book that goes further in depth.
2674 - [You can now use keywords as identifiers using the raw identifiers
2675   syntax (`r#`),][53236] e.g. `let r#for = true;`
2676 - [Using anonymous parameters in traits is now deprecated with a warning and
2677   will be a hard error in the 2018 edition.][53272]
2678 - [You can now use `crate` in paths.][54404] This allows you to refer to the
2679   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
2680 - [Using a external crate no longer requires being prefixed with `::`.][54404]
2681   Previously, using a external crate in a module without a use statement
2682   required `let json = ::serde_json::from_str(foo);` but can now be written
2683   as `let json = serde_json::from_str(foo);`.
2684 - [You can now apply the `#[used]` attribute to static items to prevent the
2685   compiler from optimising them away, even if they appear to be unused,][51363]
2686   e.g. `#[used] static FOO: u32 = 1;`
2687 - [You can now import and reexport macros from other crates with the `use`
2688   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
2689   the root module of the crate. If your macro relies on calling other local
2690   macros, it is recommended to export with the
2691   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
2692   those macros.
2693 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
2694   using the `vis` specifier.][53370]
2695 - [Non-macro attributes now allow all forms of literals, not just
2696   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
2697   write `#[attr(true)]`.
2698 - [You can now specify a function to handle a panic in the Rust runtime with the
2699   `#[panic_handler]` attribute.][51366]
2700
2701 Compiler
2702 --------
2703 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
2704 - [Added the `aarch64-unknown-netbsd` target][53165]
2705 - [Upgraded to LLVM 8.][53611]
2706
2707 Libraries
2708 ---------
2709 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
2710
2711 Stabilized APIs
2712 ---------------
2713 - [`Ipv4Addr::BROADCAST`]
2714 - [`Ipv4Addr::LOCALHOST`]
2715 - [`Ipv4Addr::UNSPECIFIED`]
2716 - [`Ipv6Addr::LOCALHOST`]
2717 - [`Ipv6Addr::UNSPECIFIED`]
2718 - [`Iterator::find_map`]
2719
2720   The following methods are replacement methods for `trim_left`, `trim_right`,
2721   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
2722   in 1.33.0:
2723 - [`str::trim_end_matches`]
2724 - [`str::trim_end`]
2725 - [`str::trim_start_matches`]
2726 - [`str::trim_start`]
2727
2728 Cargo
2729 ----
2730 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
2731 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
2732   equivalent to calling `rustdoc --error-format=json`.
2733 - [Cargo will now provide a progress bar for builds.][cargo/5995]
2734
2735 Misc
2736 ----
2737 - [`rustdoc` allows you to specify what edition to treat your code as with the
2738   `--edition` option.][54057]
2739 - [`rustdoc` now has the `--color` (specify whether to output color) and
2740   `--error-format` (specify error format, e.g. `json`) options.][53003]
2741 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
2742   debug symbols.][53774]
2743 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
2744   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
2745
2746 [50911]: https://github.com/rust-lang/rust/pull/50911/
2747 [51363]: https://github.com/rust-lang/rust/pull/51363/
2748 [51366]: https://github.com/rust-lang/rust/pull/51366/
2749 [52081]: https://github.com/rust-lang/rust/pull/52081/
2750 [53003]: https://github.com/rust-lang/rust/pull/53003/
2751 [53033]: https://github.com/rust-lang/rust/pull/53033/
2752 [53044]: https://github.com/rust-lang/rust/pull/53044/
2753 [53165]: https://github.com/rust-lang/rust/pull/53165/
2754 [53611]: https://github.com/rust-lang/rust/pull/53611/
2755 [53213]: https://github.com/rust-lang/rust/pull/53213/
2756 [53236]: https://github.com/rust-lang/rust/pull/53236/
2757 [53272]: https://github.com/rust-lang/rust/pull/53272/
2758 [53370]: https://github.com/rust-lang/rust/pull/53370/
2759 [53459]: https://github.com/rust-lang/rust/pull/53459/
2760 [53774]: https://github.com/rust-lang/rust/pull/53774/
2761 [53822]: https://github.com/rust-lang/rust/pull/53822/
2762 [54057]: https://github.com/rust-lang/rust/pull/54057/
2763 [54146]: https://github.com/rust-lang/rust/pull/54146/
2764 [54404]: https://github.com/rust-lang/rust/pull/54404/
2765 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
2766 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
2767 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
2768 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
2769
2770 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
2771 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
2772 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
2773 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
2774 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
2775 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
2776 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
2777 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
2778 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
2779 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
2780
2781
2782 Version 1.29.2 (2018-10-11)
2783 ===========================
2784
2785 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
2786 - The `rls-preview` component on the windows-gnu targets has been restored.
2787
2788 [54639]: https://github.com/rust-lang/rust/pull/54639
2789
2790
2791 Version 1.29.1 (2018-09-25)
2792 ===========================
2793
2794 Security Notes
2795 --------------
2796
2797 - The standard library's `str::repeat` function contained an out of bounds write
2798   caused by an integer overflow. This has been fixed by deterministically
2799   panicking when an overflow happens.
2800
2801   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
2802   us.
2803
2804
2805 Version 1.29.0 (2018-09-13)
2806 ==========================
2807
2808 Compiler
2809 --------
2810 - [Bumped minimum LLVM version to 5.0.][51899]
2811 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
2812 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
2813 - [Upgraded to LLVM 7.][51966]
2814
2815 Libraries
2816 ---------
2817 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
2818 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
2819 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
2820 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
2821   for `&str`.][51178]
2822 - [`Cell<T>` now allows `T` to be unsized.][50494]
2823 - [`SocketAddr` is now stable on Redox.][52656]
2824
2825 Stabilized APIs
2826 ---------------
2827 - [`Arc::downcast`]
2828 - [`Iterator::flatten`]
2829 - [`Rc::downcast`]
2830
2831 Cargo
2832 -----
2833 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
2834   `--locked` to disable this behavior.
2835 - [`cargo-install` will now allow you to cross compile an install
2836   using `--target`.][cargo/5614]
2837 - [Added the `cargo-fix` subcommand to automatically move project code from
2838   2015 edition to 2018.][cargo/5723]
2839 - [`cargo doc` can now optionally document private types using the
2840   `--document-private-items` flag.][cargo/5543]
2841
2842 Misc
2843 ----
2844 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
2845   the specified level to that level.][52354] For example `--cap-lints warn`
2846   will demote `deny` and `forbid` lints to `warn`.
2847 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
2848   fails and `101` if there is a panic.][52197]
2849 - [A preview of clippy has been made available through rustup.][51122]
2850   You can install the preview with `rustup component add clippy-preview`.
2851
2852 Compatibility Notes
2853 -------------------
2854 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
2855   Use `str::get_unchecked(begin..end)` instead.
2856 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
2857   Consider using the `home_dir` function from
2858   https://crates.io/crates/dirs instead.
2859 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
2860 - [`cfg` attributes and `--cfg` command line flags are now more
2861   strictly validated.][53893]
2862
2863 [53893]: https://github.com/rust-lang/rust/pull/53893/
2864 [52861]: https://github.com/rust-lang/rust/pull/52861/
2865 [51966]: https://github.com/rust-lang/rust/pull/51966/
2866 [52656]: https://github.com/rust-lang/rust/pull/52656/
2867 [52239]: https://github.com/rust-lang/rust/pull/52239/
2868 [52330]: https://github.com/rust-lang/rust/pull/52330/
2869 [52354]: https://github.com/rust-lang/rust/pull/52354/
2870 [52402]: https://github.com/rust-lang/rust/pull/52402/
2871 [52103]: https://github.com/rust-lang/rust/pull/52103/
2872 [52197]: https://github.com/rust-lang/rust/pull/52197/
2873 [51807]: https://github.com/rust-lang/rust/pull/51807/
2874 [51899]: https://github.com/rust-lang/rust/pull/51899/
2875 [51912]: https://github.com/rust-lang/rust/pull/51912/
2876 [51511]: https://github.com/rust-lang/rust/pull/51511/
2877 [51619]: https://github.com/rust-lang/rust/pull/51619/
2878 [51656]: https://github.com/rust-lang/rust/pull/51656/
2879 [51178]: https://github.com/rust-lang/rust/pull/51178/
2880 [51122]: https://github.com/rust-lang/rust/pull/51122
2881 [50494]: https://github.com/rust-lang/rust/pull/50494/
2882 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
2883 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
2884 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
2885 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
2886 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
2887 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
2888 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
2889
2890
2891 Version 1.28.0 (2018-08-02)
2892 ===========================
2893
2894 Language
2895 --------
2896 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
2897   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
2898   the inner type across Foreign Function Interface (FFI) boundaries.
2899 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
2900   and can now be used as identifiers.][51196]
2901 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
2902   stable.][51241] This will allow users to specify a global allocator for
2903   their program.
2904 - [Unit test functions marked with the `#[test]` attribute can now return
2905   `Result<(), E: Debug>` in addition to `()`.][51298]
2906 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
2907   allows macros to easily target lifetimes.
2908
2909 Compiler
2910 --------
2911 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
2912   prioritise making smaller binary sizes. `z` is the same as `s` with the
2913   exception that it does not vectorise loops, which typically results in an even
2914   smaller binary.
2915 - [The short error format is now stable.][49546] Specified with
2916   `--error-format=short` this option will provide a more compressed output of
2917   rust error messages.
2918 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
2919 - [Reduced the number of allocations in the macro parser.][50855] This can
2920   improve compile times of macro heavy crates on average by 5%.
2921
2922 Libraries
2923 ---------
2924 - [Implemented `Default` for `&mut str`.][51306]
2925 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
2926 - [Implemented `Extend` for `()`.][50234]
2927 - [The `Debug` implementation of `time::Duration` should now be more easily
2928   human readable.][50364] Previously a `Duration` of one second would printed as
2929   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
2930 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
2931   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
2932   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
2933   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
2934   for `PathBuf`.][50170]
2935 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
2936   and `Wrapping<i128>`.][50465]
2937 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
2938   possible.][51050] This can provide up to a 40% speed increase.
2939 - [Improved error messages when using `format!`.][50610]
2940
2941 Stabilized APIs
2942 ---------------
2943 - [`Iterator::step_by`]
2944 - [`Path::ancestors`]
2945 - [`SystemTime::UNIX_EPOCH`]
2946 - [`alloc::GlobalAlloc`]
2947 - [`alloc::Layout`]
2948 - [`alloc::LayoutErr`]
2949 - [`alloc::System`]
2950 - [`alloc::alloc`]
2951 - [`alloc::alloc_zeroed`]
2952 - [`alloc::dealloc`]
2953 - [`alloc::realloc`]
2954 - [`alloc::handle_alloc_error`]
2955 - [`btree_map::Entry::or_default`]
2956 - [`fmt::Alignment`]
2957 - [`hash_map::Entry::or_default`]
2958 - [`iter::repeat_with`]
2959 - [`num::NonZeroUsize`]
2960 - [`num::NonZeroU128`]
2961 - [`num::NonZeroU16`]
2962 - [`num::NonZeroU32`]
2963 - [`num::NonZeroU64`]
2964 - [`num::NonZeroU8`]
2965 - [`ops::RangeBounds`]
2966 - [`slice::SliceIndex`]
2967 - [`slice::from_mut`]
2968 - [`slice::from_ref`]
2969 - [`{Any + Send + Sync}::downcast_mut`]
2970 - [`{Any + Send + Sync}::downcast_ref`]
2971 - [`{Any + Send + Sync}::is`]
2972
2973 Cargo
2974 -----
2975 - [Cargo will now no longer allow you to publish crates with build scripts that
2976   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
2977   considered to be immutable.
2978
2979 Misc
2980 ----
2981 - [The `suggestion_applicability` field in `rustc`'s json output is now
2982   stable.][50486] This will allow dev tools to check whether a code suggestion
2983   would apply to them.
2984
2985 Compatibility Notes
2986 -------------------
2987 - [Rust will consider trait objects with duplicated constraints to be the same
2988   type as without the duplicated constraint.][51276] For example the below code will
2989   now fail to compile.
2990   ```rust
2991   trait Trait {}
2992
2993   impl Trait + Send {
2994       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
2995   }
2996
2997   impl Trait + Send + Send {
2998       fn test(&self) { println!("two"); }
2999   }
3000   ```
3001
3002 [49546]: https://github.com/rust-lang/rust/pull/49546/
3003 [50143]: https://github.com/rust-lang/rust/pull/50143/
3004 [50170]: https://github.com/rust-lang/rust/pull/50170/
3005 [50234]: https://github.com/rust-lang/rust/pull/50234/
3006 [50265]: https://github.com/rust-lang/rust/pull/50265/
3007 [50364]: https://github.com/rust-lang/rust/pull/50364/
3008 [50385]: https://github.com/rust-lang/rust/pull/50385/
3009 [50465]: https://github.com/rust-lang/rust/pull/50465/
3010 [50486]: https://github.com/rust-lang/rust/pull/50486/
3011 [50554]: https://github.com/rust-lang/rust/pull/50554/
3012 [50610]: https://github.com/rust-lang/rust/pull/50610/
3013 [50855]: https://github.com/rust-lang/rust/pull/50855/
3014 [51050]: https://github.com/rust-lang/rust/pull/51050/
3015 [51196]: https://github.com/rust-lang/rust/pull/51196/
3016 [51200]: https://github.com/rust-lang/rust/pull/51200/
3017 [51241]: https://github.com/rust-lang/rust/pull/51241/
3018 [51276]: https://github.com/rust-lang/rust/pull/51276/
3019 [51298]: https://github.com/rust-lang/rust/pull/51298/
3020 [51306]: https://github.com/rust-lang/rust/pull/51306/
3021 [51562]: https://github.com/rust-lang/rust/pull/51562/
3022 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
3023 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
3024 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
3025 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
3026 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
3027 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
3028 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
3029 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
3030 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
3031 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
3032 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
3033 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
3034 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
3035 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
3036 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
3037 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
3038 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
3039 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
3040 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
3041 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
3042 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
3043 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
3044 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
3045 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
3046 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
3047 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
3048 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
3049 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
3050 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
3051 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
3052
3053 Version 1.27.2 (2018-07-20)
3054 ===========================
3055
3056 Compatibility Notes
3057 -------------------
3058
3059 - The borrow checker was fixed to avoid potential unsoundness when using
3060   match ergonomics: [#52213][52213].
3061
3062 [52213]: https://github.com/rust-lang/rust/issues/52213
3063
3064 Version 1.27.1 (2018-07-10)
3065 ===========================
3066
3067 Security Notes
3068 --------------
3069
3070 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
3071   when running, which enabled executing code as some other user on a
3072   given machine. This release fixes that vulnerability; you can read
3073   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
3074
3075   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
3076
3077 Compatibility Notes
3078 -------------------
3079
3080 - The borrow checker was fixed to avoid an additional potential unsoundness when using
3081   match ergonomics: [#51415][51415], [#49534][49534].
3082
3083 [51415]: https://github.com/rust-lang/rust/issues/51415
3084 [49534]: https://github.com/rust-lang/rust/issues/49534
3085 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
3086 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
3087
3088 Version 1.27.0 (2018-06-21)
3089 ==========================
3090
3091 Language
3092 --------
3093 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
3094   be used as an identifier.
3095 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
3096   bare `Trait` syntax, and should make it clearer when being used in tandem with
3097   `impl Trait` because it is equivalent to the following syntax:
3098   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
3099   `Box<Trait> == Box<dyn Trait>`.
3100 - [Attributes on generic parameters such as types and lifetimes are
3101   now stable.][48851] e.g.
3102   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
3103 - [The `#[must_use]` attribute can now also be used on functions as well as
3104   types.][48925] It provides a lint that by default warns users when the
3105   value returned by a function has not been used.
3106
3107 Compiler
3108 --------
3109 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
3110
3111 Libraries
3112 ---------
3113 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
3114   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
3115   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
3116   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
3117   the `cfg` attribute.
3118 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
3119   std are now available in core.][49896]
3120 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
3121   to `Self`.][49630]
3122 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
3123   that the operation isn't done in place.
3124 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
3125   the `#[must_use]` attribute][49533] to warn about unused potentially
3126   expensive allocations.
3127
3128 Stabilized APIs
3129 ---------------
3130 - [`DoubleEndedIterator::rfind`]
3131 - [`DoubleEndedIterator::rfold`]
3132 - [`DoubleEndedIterator::try_rfold`]
3133 - [`Duration::from_micros`]
3134 - [`Duration::from_nanos`]
3135 - [`Duration::subsec_micros`]
3136 - [`Duration::subsec_millis`]
3137 - [`HashMap::remove_entry`]
3138 - [`Iterator::try_fold`]
3139 - [`Iterator::try_for_each`]
3140 - [`NonNull::cast`]
3141 - [`Option::filter`]
3142 - [`String::replace_range`]
3143 - [`Take::set_limit`]
3144 - [`hint::unreachable_unchecked`]
3145 - [`os::unix::process::parent_id`]
3146 - [`ptr::swap_nonoverlapping`]
3147 - [`slice::rsplit_mut`]
3148 - [`slice::rsplit`]
3149 - [`slice::swap_with_slice`]
3150
3151 Cargo
3152 -----
3153 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
3154   `readme`, and `repository` fields.][cargo/5386]
3155 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
3156 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
3157   a different directory than `target` for placing compilation artifacts.
3158 - [Cargo will be adding automatic target inference for binaries, benchmarks,
3159   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
3160   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
3161   where cargo would infer a binary, Cargo will produce a warning. You can
3162   disable this feature ahead of time by setting any of the following to false:
3163   `autobins`, `autobenches`, `autoexamples`, `autotests`.
3164 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
3165   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
3166
3167 Misc
3168 ----
3169 - [Added “The Rustc book” into the official documentation.][49707]
3170   [“The Rustc book”] documents and teaches how to use the rustc compiler.
3171 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
3172
3173 Compatibility Notes
3174 -------------------
3175 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
3176   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
3177   compile, `"".is_empty()` will still compile.
3178 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
3179   will only print the inner type.][48553] E.g.
3180   `print!("{:?}", AtomicBool::new(true))` will print `true`,
3181   not `AtomicBool(true)`.
3182 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
3183   could enter higher numbers but they were not supported by LLVM. Up to 512MB
3184   alignment should cover all use cases.
3185 - The `.description()` method on the `std::error::Error` trait
3186   [has been soft-deprecated][50163]. It is no longer required to implement it.
3187
3188 [48553]: https://github.com/rust-lang/rust/pull/48553/
3189 [48851]: https://github.com/rust-lang/rust/pull/48851/
3190 [48925]: https://github.com/rust-lang/rust/pull/48925/
3191 [49533]: https://github.com/rust-lang/rust/pull/49533/
3192 [49623]: https://github.com/rust-lang/rust/pull/49623/
3193 [49630]: https://github.com/rust-lang/rust/pull/49630/
3194 [49664]: https://github.com/rust-lang/rust/pull/49664/
3195 [49699]: https://github.com/rust-lang/rust/pull/49699/
3196 [49707]: https://github.com/rust-lang/rust/pull/49707/
3197 [49719]: https://github.com/rust-lang/rust/pull/49719/
3198 [49896]: https://github.com/rust-lang/rust/pull/49896/
3199 [49968]: https://github.com/rust-lang/rust/pull/49968/
3200 [50163]: https://github.com/rust-lang/rust/pull/50163
3201 [50177]: https://github.com/rust-lang/rust/pull/50177/
3202 [50378]: https://github.com/rust-lang/rust/pull/50378/
3203 [50398]: https://github.com/rust-lang/rust/pull/50398/
3204 [50423]: https://github.com/rust-lang/rust/pull/50423/
3205 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
3206 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
3207 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
3208 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
3209 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
3210 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
3211 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
3212 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
3213 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
3214 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
3215 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
3216 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3217 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3218 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
3219 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
3220 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
3221 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
3222 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
3223 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
3224 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
3225 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
3226 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
3227 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3228 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
3229 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
3230 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
3231 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
3232 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
3233 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
3234 [“The Rustc book”]: https://doc.rust-lang.org/rustc
3235
3236
3237 Version 1.26.2 (2018-06-05)
3238 ==========================
3239
3240 Compatibility Notes
3241 -------------------
3242
3243 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
3244
3245 [51117]: https://github.com/rust-lang/rust/issues/51117
3246
3247
3248 Version 1.26.1 (2018-05-29)
3249 ==========================
3250
3251 Tools
3252 -----
3253
3254 - [RLS now works on Windows.][50646]
3255 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
3256
3257
3258 Compatibility Notes
3259 --------
3260
3261 - [`fn main() -> impl Trait` no longer works for non-Termination
3262   trait.][50656]
3263   This reverts an accidental stabilization.
3264 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
3265 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
3266
3267 [50646]: https://github.com/rust-lang/rust/issues/50646
3268 [50656]: https://github.com/rust-lang/rust/pull/50656
3269 [50812]: https://github.com/rust-lang/rust/pull/50812
3270 [50950]: https://github.com/rust-lang/rust/issues/50950
3271 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
3272
3273 Version 1.26.0 (2018-05-10)
3274 ==========================
3275
3276 Language
3277 --------
3278 - [Closures now implement `Copy` and/or `Clone` if all captured variables
3279   implement either or both traits.][49299]
3280 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
3281 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
3282   lifetime can be elided.][49458]
3283 - [`impl Trait` is now stable allowing you to have abstract types in returns
3284    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
3285   `fn open(path: impl AsRef<Path>)`.
3286 - [Pattern matching will now automatically apply dereferences.][49394]
3287 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
3288 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
3289 - [A lot of operations are now available in a const context.][46882] E.g. You
3290   can now index into constant arrays, reference and dereference into constants,
3291   and use tuple struct constructors.
3292 - [Fixed entry slice patterns are now stable.][48516] E.g.
3293   ```rust
3294   let points = [1, 2, 3, 4];
3295   match points {
3296       [1, 2, 3, 4] => println!("All points were sequential."),
3297       _ => println!("Not all points were sequential."),
3298   }
3299   ```
3300
3301
3302 Compiler
3303 --------
3304 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
3305 - [Fixed exponential projection complexity on nested types.][48296]
3306   This can provide up to a ~12% reduction in compile times for certain crates.
3307 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
3308   to remap path prefixes outputted by the compiler.
3309 - [Added `powerpc-unknown-netbsd` target.][48281]
3310
3311 Libraries
3312 ---------
3313 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
3314 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
3315   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
3316 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
3317 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
3318 - [`ascii::escape_default` is now available in libcore.][48735]
3319 - [Trailing commas are now supported in std and core macros.][48056]
3320 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
3321 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
3322
3323 Stabilized APIs
3324 ---------------
3325 - [`*const T::add`]
3326 - [`*const T::copy_to_nonoverlapping`]
3327 - [`*const T::copy_to`]
3328 - [`*const T::read_unaligned`]
3329 - [`*const T::read_volatile`]
3330 - [`*const T::read`]
3331 - [`*const T::sub`]
3332 - [`*const T::wrapping_add`]
3333 - [`*const T::wrapping_sub`]
3334 - [`*mut T::add`]
3335 - [`*mut T::copy_to_nonoverlapping`]
3336 - [`*mut T::copy_to`]
3337 - [`*mut T::read_unaligned`]
3338 - [`*mut T::read_volatile`]
3339 - [`*mut T::read`]
3340 - [`*mut T::replace`]
3341 - [`*mut T::sub`]
3342 - [`*mut T::swap`]
3343 - [`*mut T::wrapping_add`]
3344 - [`*mut T::wrapping_sub`]
3345 - [`*mut T::write_bytes`]
3346 - [`*mut T::write_unaligned`]
3347 - [`*mut T::write_volatile`]
3348 - [`*mut T::write`]
3349 - [`Box::leak`]
3350 - [`FromUtf8Error::as_bytes`]
3351 - [`LocalKey::try_with`]
3352 - [`Option::cloned`]
3353 - [`btree_map::Entry::and_modify`]
3354 - [`fs::read_to_string`]
3355 - [`fs::read`]
3356 - [`fs::write`]
3357 - [`hash_map::Entry::and_modify`]
3358 - [`iter::FusedIterator`]
3359 - [`ops::RangeInclusive`]
3360 - [`ops::RangeToInclusive`]
3361 - [`process::id`]
3362 - [`slice::rotate_left`]
3363 - [`slice::rotate_right`]
3364 - [`String::retain`]
3365
3366
3367 Cargo
3368 -----
3369 - [Cargo will now output path to custom commands when `-v` is
3370   passed with `--list`][cargo/5041]
3371 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
3372
3373 Misc
3374 ----
3375 - [The second edition of "The Rust Programming Language" book is now recommended
3376   over the first.][48404]
3377
3378 Compatibility Notes
3379 -------------------
3380
3381 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
3382   syntax is now invalid.
3383   ```
3384   use std::ops::Fn as dyn;
3385   fn g(_: Box<dyn(std::fmt::Debug)>) {}
3386   ```
3387 - [The result of dereferences are no longer promoted to `'static`.][47408]
3388   e.g.
3389   ```rust
3390   fn main() {
3391       const PAIR: &(i32, i32) = &(0, 1);
3392       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
3393   }
3394   ```
3395 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
3396 - [`".e0"` will now no longer parse as `0.0` and will instead cause
3397   an error.][48235]
3398 - [Removed hoedown from rustdoc.][48274]
3399 - [Bounds on higher-kinded lifetimes a hard error.][48326]
3400
3401 [46882]: https://github.com/rust-lang/rust/pull/46882
3402 [47379]: https://github.com/rust-lang/rust/pull/47379
3403 [47408]: https://github.com/rust-lang/rust/pull/47408
3404 [47813]: https://github.com/rust-lang/rust/pull/47813
3405 [48056]: https://github.com/rust-lang/rust/pull/48056
3406 [48125]: https://github.com/rust-lang/rust/pull/48125
3407 [48166]: https://github.com/rust-lang/rust/pull/48166
3408 [48235]: https://github.com/rust-lang/rust/pull/48235
3409 [48274]: https://github.com/rust-lang/rust/pull/48274
3410 [48281]: https://github.com/rust-lang/rust/pull/48281
3411 [48296]: https://github.com/rust-lang/rust/pull/48296
3412 [48326]: https://github.com/rust-lang/rust/pull/48326
3413 [48359]: https://github.com/rust-lang/rust/pull/48359
3414 [48404]: https://github.com/rust-lang/rust/pull/48404
3415 [48481]: https://github.com/rust-lang/rust/pull/48481
3416 [48516]: https://github.com/rust-lang/rust/pull/48516
3417 [48628]: https://github.com/rust-lang/rust/pull/48628
3418 [48629]: https://github.com/rust-lang/rust/pull/48629
3419 [48657]: https://github.com/rust-lang/rust/pull/48657
3420 [48735]: https://github.com/rust-lang/rust/pull/48735
3421 [48978]: https://github.com/rust-lang/rust/pull/48978
3422 [49101]: https://github.com/rust-lang/rust/pull/49101
3423 [49109]: https://github.com/rust-lang/rust/pull/49109
3424 [49121]: https://github.com/rust-lang/rust/pull/49121
3425 [49162]: https://github.com/rust-lang/rust/pull/49162
3426 [49184]: https://github.com/rust-lang/rust/pull/49184
3427 [49234]: https://github.com/rust-lang/rust/pull/49234
3428 [49255]: https://github.com/rust-lang/rust/pull/49255
3429 [49299]: https://github.com/rust-lang/rust/pull/49299
3430 [49305]: https://github.com/rust-lang/rust/pull/49305
3431 [49394]: https://github.com/rust-lang/rust/pull/49394
3432 [49458]: https://github.com/rust-lang/rust/pull/49458
3433 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
3434 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
3435 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
3436 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
3437 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
3438 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
3439 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
3440 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
3441 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
3442 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
3443 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
3444 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
3445 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
3446 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
3447 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
3448 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
3449 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
3450 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
3451 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
3452 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
3453 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
3454 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
3455 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
3456 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
3457 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
3458 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
3459 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
3460 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
3461 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
3462 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
3463 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
3464 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
3465 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
3466 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
3467 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
3468 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
3469 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3470 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
3471 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
3472 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
3473 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
3474 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
3475
3476
3477 Version 1.25.0 (2018-03-29)
3478 ==========================
3479
3480 Language
3481 --------
3482 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
3483 - [You can now use nested groups of imports.][47948]
3484   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
3485 - [You can now have `|` at the start of a match arm.][47947] e.g.
3486 ```rust
3487 enum Foo { A, B, C }
3488
3489 fn main() {
3490     let x = Foo::A;
3491     match x {
3492         | Foo::A
3493         | Foo::B => println!("AB"),
3494         | Foo::C => println!("C"),
3495     }
3496 }
3497 ```
3498
3499 Compiler
3500 --------
3501 - [Upgraded to LLVM 6.][47828]
3502 - [Added `-C lto=val` option.][47521]
3503 - [Added `i586-unknown-linux-musl` target][47282]
3504
3505 Libraries
3506 ---------
3507 - [Impl Send for `process::Command` on Unix.][47760]
3508 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
3509 - [`UnsafeCell::into_inner` is now safe.][47204]
3510 - [Implement libstd for CloudABI.][47268]
3511 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
3512 - [Implement `AsRef<Path>` for Component][46985]
3513 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
3514 - [Moved `Duration` to libcore.][46666]
3515
3516 Stabilized APIs
3517 ---------------
3518 - [`Location::column`]
3519 - [`ptr::NonNull`]
3520
3521 The following functions can now be used in a constant expression.
3522 eg. `static MINUTE: Duration = Duration::from_secs(60);`
3523 - [`Duration::new`][47300]
3524 - [`Duration::from_secs`][47300]
3525 - [`Duration::from_millis`][47300]
3526
3527 Cargo
3528 -----
3529 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
3530 - [`cargo new` now defaults to creating a binary crate, instead of a
3531   library crate.][cargo/5029]
3532
3533 Misc
3534 ----
3535 - [Rust by example is now shipped with new releases][46196]
3536
3537 Compatibility Notes
3538 -------------------
3539 - [Deprecated `net::lookup_host`.][47510]
3540 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
3541 - The borrow checker was sometimes incorrectly permitting overlapping borrows
3542   around indexing operations (see [#47349][47349]). This has been fixed (which also
3543   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
3544 - [Removed deprecated unstable attribute `#[simd]`.][47251]
3545
3546 [33903]: https://github.com/rust-lang/rust/pull/33903
3547 [47947]: https://github.com/rust-lang/rust/pull/47947
3548 [47948]: https://github.com/rust-lang/rust/pull/47948
3549 [47760]: https://github.com/rust-lang/rust/pull/47760
3550 [47790]: https://github.com/rust-lang/rust/pull/47790
3551 [47828]: https://github.com/rust-lang/rust/pull/47828
3552 [47398]: https://github.com/rust-lang/rust/pull/47398
3553 [47510]: https://github.com/rust-lang/rust/pull/47510
3554 [47521]: https://github.com/rust-lang/rust/pull/47521
3555 [47204]: https://github.com/rust-lang/rust/pull/47204
3556 [47251]: https://github.com/rust-lang/rust/pull/47251
3557 [47268]: https://github.com/rust-lang/rust/pull/47268
3558 [47282]: https://github.com/rust-lang/rust/pull/47282
3559 [47300]: https://github.com/rust-lang/rust/pull/47300
3560 [47349]: https://github.com/rust-lang/rust/pull/47349
3561 [46931]: https://github.com/rust-lang/rust/pull/46931
3562 [46985]: https://github.com/rust-lang/rust/pull/46985
3563 [47006]: https://github.com/rust-lang/rust/pull/47006
3564 [46830]: https://github.com/rust-lang/rust/pull/46830
3565 [46095]: https://github.com/rust-lang/rust/pull/46095
3566 [46666]: https://github.com/rust-lang/rust/pull/46666
3567 [46196]: https://github.com/rust-lang/rust/pull/46196
3568 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
3569 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
3570 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
3571 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
3572 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
3573
3574
3575 Version 1.24.1 (2018-03-01)
3576 ==========================
3577
3578  - [Do not abort when unwinding through FFI][48251]
3579  - [Emit UTF-16 files for linker arguments on Windows][48318]
3580  - [Make the error index generator work again][48308]
3581  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
3582
3583 [48251]: https://github.com/rust-lang/rust/issues/48251
3584 [48308]: https://github.com/rust-lang/rust/issues/48308
3585 [48318]: https://github.com/rust-lang/rust/issues/48318
3586 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
3587
3588
3589 Version 1.24.0 (2018-02-15)
3590 ==========================
3591
3592 Language
3593 --------
3594 - [External `sysv64` ffi is now available.][46528]
3595   eg. `extern "sysv64" fn foo () {}`
3596
3597 Compiler
3598 --------
3599 - [rustc now uses 16 codegen units by default for release builds.][46910]
3600   For the fastest builds, utilize `codegen-units=1`.
3601 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
3602 - [Add `aarch64-unknown-openbsd` support][46760]
3603
3604 Libraries
3605 ---------
3606 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
3607   improvement in performance in the majority of cases.
3608 - [`OsStr`'s `Debug` implementation is now lossless and consistent
3609   with Windows.][46798]
3610 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
3611 - [impl `From<bool>` for `AtomicBool`][46293]
3612 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
3613 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
3614 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
3615 - [float::from_bits now just uses transmute.][46012] This provides
3616   some optimisations from LLVM.
3617 - [Copied `AsciiExt` methods onto `char`][46077]
3618 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
3619 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
3620 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
3621 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
3622
3623 Stabilized APIs
3624 ---------------
3625 - [`RefCell::replace`]
3626 - [`RefCell::swap`]
3627 - [`atomic::spin_loop_hint`]
3628
3629 The following functions can now be used in a constant expression.
3630 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
3631
3632 - [`AtomicBool::new`][46287]
3633 - [`AtomicUsize::new`][46287]
3634 - [`AtomicIsize::new`][46287]
3635 - [`AtomicPtr::new`][46287]
3636 - [`Cell::new`][46287]
3637 - [`{integer}::min_value`][46287]
3638 - [`{integer}::max_value`][46287]
3639 - [`mem::size_of`][46287]
3640 - [`mem::align_of`][46287]
3641 - [`ptr::null`][46287]
3642 - [`ptr::null_mut`][46287]
3643 - [`RefCell::new`][46287]
3644 - [`UnsafeCell::new`][46287]
3645
3646 Cargo
3647 -----
3648 - [Added a `workspace.default-members` config that
3649   overrides implied `--all` in virtual workspaces.][cargo/4743]
3650 - [Enable incremental by default on development builds.][cargo/4817] Also added
3651   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
3652   per-project or global basis respectively.
3653
3654 Misc
3655 ----
3656
3657 Compatibility Notes
3658 -------------------
3659 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
3660 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
3661   in accordance with IETF RFC 4291 §2.2.
3662 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
3663 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
3664   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
3665 - [Leading zeros in tuple struct members is now an error][47084]
3666 - [`column!()` macro is one-based instead of zero-based][46977]
3667 - [`fmt::Arguments` can no longer be shared across threads][45198]
3668 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
3669 - [Cargo sets a different working directory for the compiler][cargo/4788]
3670
3671 [44884]: https://github.com/rust-lang/rust/pull/44884
3672 [45198]: https://github.com/rust-lang/rust/pull/45198
3673 [45506]: https://github.com/rust-lang/rust/pull/45506
3674 [45904]: https://github.com/rust-lang/rust/pull/45904
3675 [45990]: https://github.com/rust-lang/rust/pull/45990
3676 [46012]: https://github.com/rust-lang/rust/pull/46012
3677 [46077]: https://github.com/rust-lang/rust/pull/46077
3678 [46094]: https://github.com/rust-lang/rust/pull/46094
3679 [46284]: https://github.com/rust-lang/rust/pull/46284
3680 [46287]: https://github.com/rust-lang/rust/pull/46287
3681 [46293]: https://github.com/rust-lang/rust/pull/46293
3682 [46528]: https://github.com/rust-lang/rust/pull/46528
3683 [46671]: https://github.com/rust-lang/rust/pull/46671
3684 [46713]: https://github.com/rust-lang/rust/pull/46713
3685 [46735]: https://github.com/rust-lang/rust/pull/46735
3686 [46749]: https://github.com/rust-lang/rust/pull/46749
3687 [46760]: https://github.com/rust-lang/rust/pull/46760
3688 [46798]: https://github.com/rust-lang/rust/pull/46798
3689 [46828]: https://github.com/rust-lang/rust/pull/46828
3690 [46831]: https://github.com/rust-lang/rust/pull/46831
3691 [46833]: https://github.com/rust-lang/rust/pull/46833
3692 [46910]: https://github.com/rust-lang/rust/pull/46910
3693 [46977]: https://github.com/rust-lang/rust/pull/46977
3694 [47018]: https://github.com/rust-lang/rust/pull/47018
3695 [47080]: https://github.com/rust-lang/rust/pull/47080
3696 [47084]: https://github.com/rust-lang/rust/pull/47084
3697 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
3698 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
3699 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
3700 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
3701 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
3702 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
3703
3704
3705 Version 1.23.0 (2018-01-04)
3706 ==========================
3707
3708 Language
3709 --------
3710 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
3711 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
3712   Which should fix some confusing errors in some operations.
3713
3714 Compiler
3715 --------
3716 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
3717   undefined behavior.][45920]
3718 - [rustc now suggests renaming import if names clash.][45660]
3719 - [Display errors/warnings correctly when there are zero-width or
3720   wide characters.][45711]
3721 - [rustc now avoids unnecessary copies of arguments that are
3722   simple bindings][45380] This should improve memory usage on average by 5-10%.
3723 - [Updated musl used to build musl rustc to 1.1.17][45393]
3724
3725 Libraries
3726 ---------
3727 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
3728 - [Implement Hash for raw pointers to unsized types][45483]
3729 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
3730 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
3731 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
3732 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
3733   and `<*mut T>::as_mut`][44932]
3734 - [Optimized `Thread::{park, unpark}` implementation][45524]
3735 - [Improved `SliceExt::binary_search` performance.][45333]
3736 - [impl `FromIterator<()>` for `()`][45379]
3737 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
3738   is now deprecated.
3739
3740 Stabilized APIs
3741 ---------------
3742
3743 Cargo
3744 -----
3745 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
3746   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
3747 - [Added unit test checking to `cargo check`][cargo/4592]
3748 - [Cargo now lets you install a specific version
3749   using `cargo install --version`][cargo/4637]
3750
3751 Misc
3752 ----
3753 - [Releases now ship with the Cargo book documentation.][45692]
3754 - [rustdoc now prints rendering warnings on every run.][45324]
3755
3756 Compatibility Notes
3757 -------------------
3758 - [Changes have been made to type equality to make it more correct,
3759   in rare cases this could break some code.][45853] [Tracking issue for
3760   further information][45852]
3761 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
3762 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
3763   Android 9, the minimum supported version is Android 14.
3764 - [Bumped the minimum LLVM to 3.9][45326]
3765
3766 [44042]: https://github.com/rust-lang/rust/pull/44042
3767 [44932]: https://github.com/rust-lang/rust/pull/44932
3768 [45267]: https://github.com/rust-lang/rust/pull/45267
3769 [45324]: https://github.com/rust-lang/rust/pull/45324
3770 [45326]: https://github.com/rust-lang/rust/pull/45326
3771 [45333]: https://github.com/rust-lang/rust/pull/45333
3772 [45379]: https://github.com/rust-lang/rust/pull/45379
3773 [45380]: https://github.com/rust-lang/rust/pull/45380
3774 [45393]: https://github.com/rust-lang/rust/pull/45393
3775 [45435]: https://github.com/rust-lang/rust/pull/45435
3776 [45483]: https://github.com/rust-lang/rust/pull/45483
3777 [45524]: https://github.com/rust-lang/rust/pull/45524
3778 [45571]: https://github.com/rust-lang/rust/pull/45571
3779 [45580]: https://github.com/rust-lang/rust/pull/45580
3780 [45610]: https://github.com/rust-lang/rust/pull/45610
3781 [45660]: https://github.com/rust-lang/rust/pull/45660
3782 [45692]: https://github.com/rust-lang/rust/pull/45692
3783 [45711]: https://github.com/rust-lang/rust/pull/45711
3784 [45772]: https://github.com/rust-lang/rust/pull/45772
3785 [45852]: https://github.com/rust-lang/rust/issues/45852
3786 [45853]: https://github.com/rust-lang/rust/pull/45853
3787 [45887]: https://github.com/rust-lang/rust/pull/45887
3788 [45920]: https://github.com/rust-lang/rust/pull/45920
3789 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
3790 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
3791 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
3792
3793
3794 Version 1.22.1 (2017-11-22)
3795 ==========================
3796
3797 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
3798
3799 [46183]: https://github.com/rust-lang/rust/pull/46183
3800
3801 Version 1.22.0 (2017-11-22)
3802 ==========================
3803
3804 Language
3805 --------
3806 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
3807 - [Now accepts underscores in unicode escapes][43716]
3808 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
3809 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
3810
3811 Compiler
3812 --------
3813 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
3814 - [rustc will no longer inline in codegen units when compiling for debug][45075]
3815   This should decrease compile times for debug builds.
3816 - [strict memory alignment now enabled on ARMv6][45094]
3817 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
3818
3819 Libraries
3820 ---------
3821 - [Allow atomic operations up to 32 bits
3822   on `armv5te_unknown_linux_gnueabi`][44978]
3823 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
3824 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
3825 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
3826 - [Properly detect overflow in `Instant += Duration`.][44220]
3827 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
3828 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
3829 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
3830
3831 Stabilized APIs
3832 ---------------
3833
3834 Cargo
3835 -----
3836 - [Cargo will now build multi file examples in subdirectories of the `examples`
3837   folder that have a `main.rs` file.][cargo/4496]
3838 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
3839   the old format will continue to work and can be updated with `cargo update`.
3840 - [Now supports vendoring git repositories][cargo/3992]
3841
3842 Misc
3843 ----
3844 - [`libbacktrace` is now available on Apple platforms.][44251]
3845 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
3846   This now lets you specify that a given code example will fail to compile.
3847
3848 Compatibility Notes
3849 -------------------
3850 - [The minimum Android version that rustc can build for has been bumped
3851   to `4.0` from `2.3`][45656]
3852 - [Allowing `T op= &T` for numeric types has broken some type
3853   inference cases][45480]
3854
3855
3856 [42526]: https://github.com/rust-lang/rust/pull/42526
3857 [43017]: https://github.com/rust-lang/rust/pull/43017
3858 [43716]: https://github.com/rust-lang/rust/pull/43716
3859 [43949]: https://github.com/rust-lang/rust/pull/43949
3860 [44015]: https://github.com/rust-lang/rust/pull/44015
3861 [44220]: https://github.com/rust-lang/rust/pull/44220
3862 [44251]: https://github.com/rust-lang/rust/pull/44251
3863 [44287]: https://github.com/rust-lang/rust/pull/44287
3864 [44303]: https://github.com/rust-lang/rust/pull/44303
3865 [44456]: https://github.com/rust-lang/rust/pull/44456
3866 [44466]: https://github.com/rust-lang/rust/pull/44466
3867 [44895]: https://github.com/rust-lang/rust/pull/44895
3868 [44966]: https://github.com/rust-lang/rust/pull/44966
3869 [44978]: https://github.com/rust-lang/rust/pull/44978
3870 [45041]: https://github.com/rust-lang/rust/pull/45041
3871 [45064]: https://github.com/rust-lang/rust/pull/45064
3872 [45075]: https://github.com/rust-lang/rust/pull/45075
3873 [45094]: https://github.com/rust-lang/rust/pull/45094
3874 [45095]: https://github.com/rust-lang/rust/pull/45095
3875 [45480]: https://github.com/rust-lang/rust/issues/45480
3876 [45656]: https://github.com/rust-lang/rust/pull/45656
3877 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
3878 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
3879 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
3880
3881
3882
3883
3884
3885
3886 Version 1.21.0 (2017-10-12)
3887 ==========================
3888
3889 Language
3890 --------
3891 - [You can now use static references for literals.][43838]
3892   Example:
3893   ```rust
3894   fn main() {
3895       let x: &'static u32 = &0;
3896   }
3897   ```
3898 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
3899   Example:
3900   ```rust
3901   my_macro!(Vec<i32>::new); // Always worked
3902   my_macro!(Vec::<i32>::new); // Now works
3903   ```
3904
3905 Compiler
3906 --------
3907 - [Upgraded jemalloc to 4.5.0][43911]
3908 - [Enabled unwinding panics on Redox][43917]
3909 - [Now runs LLVM in parallel during translation phase.][43506]
3910   This should reduce peak memory usage.
3911
3912 Libraries
3913 ---------
3914 - [Generate builtin impls for `Clone` for all arrays and tuples that
3915   are `T: Clone`][43690]
3916 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
3917 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
3918   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
3919
3920 Stabilized APIs
3921 ---------------
3922
3923 [`std::mem::discriminant`]
3924
3925 Cargo
3926 -----
3927 - [You can now call `cargo install` with multiple package names][cargo/4216]
3928 - [Cargo commands inside a virtual workspace will now implicitly
3929   pass `--all`][cargo/4335]
3930 - [Added a `[patch]` section to `Cargo.toml` to handle
3931   prepublication dependencies][cargo/4123] [RFC 1969]
3932 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
3933   like patterns][cargo/4270]
3934 - [Added the `--all-targets` option][cargo/4400]
3935 - [Using required dependencies as a feature is now deprecated and emits
3936   a warning][cargo/4364]
3937
3938
3939 Misc
3940 ----
3941 - [Cargo docs are moving][43916]
3942   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
3943 - [The rustdoc book is now available][43863]
3944   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
3945 - [Added a preview of RLS has been made available through rustup][44204]
3946   Install with `rustup component add rls-preview`
3947 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
3948   Previously only showed `std::os::unix`.
3949
3950 Compatibility Notes
3951 -------------------
3952 - [Changes in method matching against higher-ranked types][43880] This may cause
3953   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
3954 - [rustc's JSON error output's byte position start at top of file.][42973]
3955   Was previously relative to the rustc's internal `CodeMap` struct which
3956   required the unstable library `libsyntax` to correctly use.
3957 - [`unused_results` lint no longer ignores booleans][43728]
3958
3959 [42565]: https://github.com/rust-lang/rust/pull/42565
3960 [42973]: https://github.com/rust-lang/rust/pull/42973
3961 [43348]: https://github.com/rust-lang/rust/pull/43348
3962 [43459]: https://github.com/rust-lang/rust/pull/43459
3963 [43506]: https://github.com/rust-lang/rust/pull/43506
3964 [43540]: https://github.com/rust-lang/rust/pull/43540
3965 [43690]: https://github.com/rust-lang/rust/pull/43690
3966 [43728]: https://github.com/rust-lang/rust/pull/43728
3967 [43838]: https://github.com/rust-lang/rust/pull/43838
3968 [43863]: https://github.com/rust-lang/rust/pull/43863
3969 [43880]: https://github.com/rust-lang/rust/pull/43880
3970 [43911]: https://github.com/rust-lang/rust/pull/43911
3971 [43916]: https://github.com/rust-lang/rust/pull/43916
3972 [43917]: https://github.com/rust-lang/rust/pull/43917
3973 [44204]: https://github.com/rust-lang/rust/pull/44204
3974 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
3975 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
3976 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3977 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
3978 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
3979 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
3980 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
3981 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
3982 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
3983
3984 Version 1.20.0 (2017-08-31)
3985 ===========================
3986
3987 Language
3988 --------
3989 - [Associated constants are now stabilised.][42809]
3990 - [A lot of macro bugs are now fixed.][42913]
3991
3992 Compiler
3993 --------
3994
3995 - [Struct fields are now properly coerced to the expected field type.][42807]
3996 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
3997   `wasm32-experimental-emscripten` target.
3998 - [Changed some of the error messages to be more helpful.][42033]
3999 - [Add support for RELRO(RELocation Read-Only) for platforms that support
4000   it.][43170]
4001 - [rustc now reports the total number of errors on compilation failure][43015]
4002   previously this was only the number of errors in the pass that failed.
4003 - [Expansion in rustc has been sped up 29x.][42533]
4004 - [added `msp430-none-elf` target.][43099]
4005 - [rustc will now suggest one-argument enum variant to fix type mismatch when
4006   applicable][43178]
4007 - [Fixes backtraces on Redox][43228]
4008 - [rustc now identifies different versions of same crate when absolute paths of
4009   different types match in an error message.][42826]
4010
4011 Libraries
4012 ---------
4013
4014
4015 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
4016 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
4017   tuples.][43011]
4018 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
4019   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
4020 - [Impl `Clone` for `DefaultHasher`.][42799]
4021 - [Impl `Sync` for `SyncSender`.][42397]
4022 - [Impl `FromStr` for `char`][42271]
4023 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
4024   NaN.][42431]
4025 - [allow messages in the `unimplemented!()` macro.][42155]
4026   ie. `unimplemented!("Waiting for 1.21 to be stable")`
4027 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
4028 - [Upgrade to Unicode 10.0.0][42999]
4029 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
4030 - [Skip the main thread's manual stack guard on Linux][43072]
4031 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
4032 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
4033   previously 2^15.
4034 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
4035
4036 Stabilized APIs
4037 ---------------
4038
4039 - [`CStr::into_c_string`]
4040 - [`CString::as_c_str`]
4041 - [`CString::into_boxed_c_str`]
4042 - [`Chain::get_mut`]
4043 - [`Chain::get_ref`]
4044 - [`Chain::into_inner`]
4045 - [`Option::get_or_insert_with`]
4046 - [`Option::get_or_insert`]
4047 - [`OsStr::into_os_string`]
4048 - [`OsString::into_boxed_os_str`]
4049 - [`Take::get_mut`]
4050 - [`Take::get_ref`]
4051 - [`Utf8Error::error_len`]
4052 - [`char::EscapeDebug`]
4053 - [`char::escape_debug`]
4054 - [`compile_error!`]
4055 - [`f32::from_bits`]
4056 - [`f32::to_bits`]
4057 - [`f64::from_bits`]
4058 - [`f64::to_bits`]
4059 - [`mem::ManuallyDrop`]
4060 - [`slice::sort_unstable_by_key`]
4061 - [`slice::sort_unstable_by`]
4062 - [`slice::sort_unstable`]
4063 - [`str::from_boxed_utf8_unchecked`]
4064 - [`str::as_bytes_mut`]
4065 - [`str::as_bytes_mut`]
4066 - [`str::from_utf8_mut`]
4067 - [`str::from_utf8_unchecked_mut`]
4068 - [`str::get_mut`]
4069 - [`str::get_unchecked_mut`]
4070 - [`str::get_unchecked`]
4071 - [`str::get`]
4072 - [`str::into_boxed_bytes`]
4073
4074
4075 Cargo
4076 -----
4077 - [Cargo API token location moved from `~/.cargo/config` to
4078   `~/.cargo/credentials`.][cargo/3978]
4079 - [Cargo will now build `main.rs` binaries that are in sub-directories of
4080   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
4081   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
4082 - [You can now specify version of a binary when installed through
4083   `cargo install` using `--vers`.][cargo/4229]
4084 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
4085   failure.][cargo/4248]
4086 - [Changed the convention around which file is the crate root.][cargo/4259]
4087 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
4088   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
4089
4090 Compatibility Notes
4091 -------------------
4092
4093 - [Functions with `'static` in their return types will now not be as usable as
4094   if they were using lifetime parameters instead.][42417]
4095 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
4096   takes the sign of NaN into account where previously didn't.][42430]
4097
4098 [42033]: https://github.com/rust-lang/rust/pull/42033
4099 [42155]: https://github.com/rust-lang/rust/pull/42155
4100 [42271]: https://github.com/rust-lang/rust/pull/42271
4101 [42397]: https://github.com/rust-lang/rust/pull/42397
4102 [42417]: https://github.com/rust-lang/rust/pull/42417
4103 [42430]: https://github.com/rust-lang/rust/pull/42430
4104 [42431]: https://github.com/rust-lang/rust/pull/42431
4105 [42533]: https://github.com/rust-lang/rust/pull/42533
4106 [42571]: https://github.com/rust-lang/rust/pull/42571
4107 [42613]: https://github.com/rust-lang/rust/pull/42613
4108 [42799]: https://github.com/rust-lang/rust/pull/42799
4109 [42807]: https://github.com/rust-lang/rust/pull/42807
4110 [42809]: https://github.com/rust-lang/rust/pull/42809
4111 [42822]: https://github.com/rust-lang/rust/pull/42822
4112 [42826]: https://github.com/rust-lang/rust/pull/42826
4113 [42854]: https://github.com/rust-lang/rust/pull/42854
4114 [42913]: https://github.com/rust-lang/rust/pull/42913
4115 [42999]: https://github.com/rust-lang/rust/pull/42999
4116 [43011]: https://github.com/rust-lang/rust/pull/43011
4117 [43015]: https://github.com/rust-lang/rust/pull/43015
4118 [43072]: https://github.com/rust-lang/rust/pull/43072
4119 [43077]: https://github.com/rust-lang/rust/pull/43077
4120 [43097]: https://github.com/rust-lang/rust/pull/43097
4121 [43099]: https://github.com/rust-lang/rust/pull/43099
4122 [43170]: https://github.com/rust-lang/rust/pull/43170
4123 [43178]: https://github.com/rust-lang/rust/pull/43178
4124 [43185]: https://github.com/rust-lang/rust/pull/43185
4125 [43228]: https://github.com/rust-lang/rust/pull/43228
4126 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
4127 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
4128 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
4129 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
4130 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
4131 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4132 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
4133 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
4134 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
4135 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
4136 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
4137 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
4138 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
4139 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
4140 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
4141 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
4142 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
4143 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
4144 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
4145 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
4146 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
4147 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
4148 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
4149 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
4150 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
4151 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
4152 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
4153 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
4154 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
4155 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
4156 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
4157 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
4158 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
4159 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
4160 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
4161 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
4162 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
4163 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
4164 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
4165
4166
4167 Version 1.19.0 (2017-07-20)
4168 ===========================
4169
4170 Language
4171 --------
4172
4173 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
4174   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
4175 - [Macro recursion limit increased to 1024 from 64.][41676]
4176 - [Added lint for detecting unused macros.][41907]
4177 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
4178   For example: `let x = loop { break 7; };`
4179 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
4180   contain `Copy` types and cannot have a `Drop` implementation.
4181   Example: `union Foo { bar: u8, baz: usize }`
4182 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
4183   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
4184
4185 Compiler
4186 --------
4187
4188 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
4189 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
4190   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
4191   you should use `--target armv7-linux-androideabi`.
4192 - [Fixed ICE when removing a source file between compilation sessions.][41873]
4193 - [Minor optimisation of string operations.][42037]
4194 - [Compiler error message is now `aborting due to previous error(s)` instead of
4195   `aborting due to N previous errors`][42150] This was previously inaccurate and
4196   would only count certain kinds of errors.
4197 - [The compiler now supports Visual Studio 2017][42225]
4198 - [The compiler is now built against LLVM 4.0.1 by default][42948]
4199 - [Added a lot][42264] of [new error codes][42302]
4200 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
4201   libraries with C Run-time Libraries(CRT) to be statically linked.
4202 - [Fixed various ARM codegen bugs][42740]
4203
4204 Libraries
4205 ---------
4206
4207 - [`String` now implements `FromIterator<Cow<'a, str>>` and
4208   `Extend<Cow<'a, str>>`][41449]
4209 - [`Vec` now implements `From<&mut [T]>`][41530]
4210 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
4211 - [`SplitWhitespace` now implements `Clone`][41659]
4212 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
4213   1.5x faster][41764]
4214 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
4215   macros, but for printing to stderr.
4216
4217 Stabilized APIs
4218 ---------------
4219
4220 - [`OsString::shrink_to_fit`]
4221 - [`cmp::Reverse`]
4222 - [`Command::envs`]
4223 - [`thread::ThreadId`]
4224
4225 Cargo
4226 -----
4227
4228 - [Build scripts can now add environment variables to the environment
4229   the crate is being compiled in.
4230   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
4231 - [Subcommands now replace the current process rather than spawning a new
4232   child process][cargo/3970]
4233 - [Workspace members can now accept glob file patterns][cargo/3979]
4234 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
4235   the members in a given workspace.][cargo/3988]
4236 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
4237 - [Target directory path is now in the cargo metadata][cargo/4022]
4238 - [Cargo no longer checks out a local working directory for the
4239   crates.io index][cargo/4026] This should provide smaller file size for the
4240   registry, and improve cloning times, especially on Windows machines.
4241 - [Added an `--exclude` option for excluding certain packages when using the
4242   `--all` option][cargo/4031]
4243 - [Cargo will now automatically retry when receiving a 5xx error
4244   from crates.io][cargo/4032]
4245 - [The `--features` option now accepts multiple comma or space
4246   delimited values.][cargo/4084]
4247 - [Added support for custom target specific runners][cargo/3954]
4248
4249 Misc
4250 ----
4251
4252 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
4253   Windows Debugger.
4254 - [Rust will now release XZ compressed packages][rust-installer/57]
4255 - [rustup will now prefer to download rust packages with
4256   XZ compression][rustup/1100] over GZip packages.
4257 - [Added the ability to escape `#` in rust documentation][41785] By adding
4258   additional `#`'s ie. `##` is now `#`
4259
4260 Compatibility Notes
4261 -------------------
4262
4263 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
4264 - [`-Z` flags are now no longer allowed to be used on the stable
4265   compiler.][41751] This has been a warning for a year previous to this.
4266 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
4267   longer works][42844]. Users should migrate to the built-in `check`
4268   command, which has been available since 1.16.
4269 - [Ending a float literal with `._` is now a hard error.
4270   Example: `42._` .][41946]
4271 - [Any use of a private `extern crate` outside of its module is now a
4272   hard error.][36886] This was previously a warning.
4273 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
4274   relative while the `::` prefix makes a path absolute, but was ignored and the
4275   path was relative regardless.
4276 - [Floating point constants in match patterns is now a hard error][36890]
4277   This was previously a warning.
4278 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
4279   match patterns is now a hard error][36891] This was previously a warning.
4280 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
4281   a warning.
4282 - [From the pound escape, lines consisting of multiple `#`s are
4283   now visible][41785]
4284 - [It is an error to re-export private enum variants][42460]. This is
4285   known to break a number of crates that depend on an older version of
4286   mustache.
4287 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
4288   to use it to find the linker, and the build will fail where it did
4289   not previously][42607]
4290
4291 [36886]: https://github.com/rust-lang/rust/issues/36886
4292 [36888]: https://github.com/rust-lang/rust/issues/36888
4293 [36890]: https://github.com/rust-lang/rust/issues/36890
4294 [36891]: https://github.com/rust-lang/rust/issues/36891
4295 [36892]: https://github.com/rust-lang/rust/issues/36892
4296 [37406]: https://github.com/rust-lang/rust/issues/37406
4297 [39983]: https://github.com/rust-lang/rust/pull/39983
4298 [41145]: https://github.com/rust-lang/rust/pull/41145
4299 [41192]: https://github.com/rust-lang/rust/pull/41192
4300 [41258]: https://github.com/rust-lang/rust/pull/41258
4301 [41370]: https://github.com/rust-lang/rust/pull/41370
4302 [41449]: https://github.com/rust-lang/rust/pull/41449
4303 [41530]: https://github.com/rust-lang/rust/pull/41530
4304 [41624]: https://github.com/rust-lang/rust/pull/41624
4305 [41656]: https://github.com/rust-lang/rust/pull/41656
4306 [41659]: https://github.com/rust-lang/rust/pull/41659
4307 [41676]: https://github.com/rust-lang/rust/pull/41676
4308 [41751]: https://github.com/rust-lang/rust/pull/41751
4309 [41764]: https://github.com/rust-lang/rust/pull/41764
4310 [41785]: https://github.com/rust-lang/rust/pull/41785
4311 [41873]: https://github.com/rust-lang/rust/pull/41873
4312 [41907]: https://github.com/rust-lang/rust/pull/41907
4313 [41946]: https://github.com/rust-lang/rust/pull/41946
4314 [42016]: https://github.com/rust-lang/rust/pull/42016
4315 [42037]: https://github.com/rust-lang/rust/pull/42037
4316 [42068]: https://github.com/rust-lang/rust/pull/42068
4317 [42150]: https://github.com/rust-lang/rust/pull/42150
4318 [42162]: https://github.com/rust-lang/rust/pull/42162
4319 [42225]: https://github.com/rust-lang/rust/pull/42225
4320 [42264]: https://github.com/rust-lang/rust/pull/42264
4321 [42302]: https://github.com/rust-lang/rust/pull/42302
4322 [42460]: https://github.com/rust-lang/rust/issues/42460
4323 [42607]: https://github.com/rust-lang/rust/issues/42607
4324 [42740]: https://github.com/rust-lang/rust/pull/42740
4325 [42844]: https://github.com/rust-lang/rust/issues/42844
4326 [42948]: https://github.com/rust-lang/rust/pull/42948
4327 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
4328 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
4329 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
4330 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
4331 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
4332 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
4333 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
4334 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
4335 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
4336 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
4337 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
4338 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
4339 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
4340 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
4341 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
4342 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
4343 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
4344 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
4345 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
4346 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
4347 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
4348 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
4349
4350
4351 Version 1.18.0 (2017-06-08)
4352 ===========================
4353
4354 Language
4355 --------
4356
4357 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
4358   make the item visible to just that module tree. Also accepts the keyword
4359   `crate` to make something public to the whole crate but not users of the
4360   library. Example: `pub(crate) mod utils;`. [RFC 1422].
4361 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
4362   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
4363 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
4364   types like `Write + Send`, trailing `+` are now supported in trait objects,
4365   and better error reporting for trait objects starting with `?Sized`.
4366 - [0e+10 is now a valid floating point literal][40589]
4367 - [Now warns if you bind a lifetime parameter to 'static][40734]
4368 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
4369   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
4370   representation in some cases.][40377]
4371
4372 Compiler
4373 --------
4374
4375 - [rustc can now emit mir with `--emit mir`][39891]
4376 - [Improved LLVM IR for trivial functions][40367]
4377 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
4378 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
4379   opportunities found through profiling
4380 - [Improved backtrace formatting when panicking][38165]
4381
4382 Libraries
4383 ---------
4384
4385 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
4386   iterator hasn't been advanced the original `Vec` is reassembled with no actual
4387   iteration or reallocation.
4388 - [Simplified HashMap Bucket interface][40561] provides performance
4389   improvements for iterating and cloning.
4390 - [Specialize Vec::from_elem to use calloc][40409]
4391 - [Fixed Race condition in fs::create_dir_all][39799]
4392 - [No longer caching stdio on Windows][40516]
4393 - [Optimized insertion sort in slice][40807] insertion sort in some cases
4394   2.50%~ faster and in one case now 12.50% faster.
4395 - [Optimized `AtomicBool::fetch_nand`][41143]
4396
4397 Stabilized APIs
4398 ---------------
4399
4400 - [`Child::try_wait`]
4401 - [`HashMap::retain`]
4402 - [`HashSet::retain`]
4403 - [`PeekMut::pop`]
4404 - [`TcpStream::peek`]
4405 - [`UdpSocket::peek`]
4406 - [`UdpSocket::peek_from`]
4407
4408 Cargo
4409 -----
4410
4411 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
4412   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
4413 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
4414 - [Added Android build support][cargo/3885]
4415 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
4416   of a certain type, for example `cargo build --bins` will build all
4417   binaries.
4418 - [Added support for haiku][cargo/3952]
4419
4420 Misc
4421 ----
4422
4423 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
4424 - [Added rust-windbg script for better debugging on Windows][39983]
4425 - [Rust now uses the official cross compiler for NetBSD][40612]
4426 - [rustdoc now accepts `#` at the start of files][40828]
4427 - [Fixed jemalloc support for musl][41168]
4428
4429 Compatibility Notes
4430 -------------------
4431
4432 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
4433   always placed after the sign if it exists and before the digits. With the `#`
4434   flag the zeroes are placed after the prefix and before the digits.
4435 - [Due to the struct field optimisation][40377], using `transmute` on structs
4436   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
4437   always been undefined behavior, but is now more likely to break in practice.
4438 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
4439   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
4440   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
4441 - [Overlapping inherent `impl`s are now a hard error][40728]
4442 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
4443 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
4444   `out.asm` and `out.ll` instead of only one of the filetypes.
4445 - [ calling a function that returns `Self` will no longer work][41805] when
4446   the size of `Self` cannot be statically determined.
4447 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
4448   this has caused a few regressions namely:
4449
4450   - Changed the link order of local static/dynamic libraries (respecting the
4451     order on given rather than having the compiler reorder).
4452   - Changed how MinGW is linked, native code linked to dynamic libraries
4453     may require manually linking to the gcc support library (for the native
4454     code itself)
4455
4456 [38165]: https://github.com/rust-lang/rust/pull/38165
4457 [39799]: https://github.com/rust-lang/rust/pull/39799
4458 [39891]: https://github.com/rust-lang/rust/pull/39891
4459 [39983]: https://github.com/rust-lang/rust/pull/39983
4460 [40043]: https://github.com/rust-lang/rust/pull/40043
4461 [40241]: https://github.com/rust-lang/rust/pull/40241
4462 [40338]: https://github.com/rust-lang/rust/pull/40338
4463 [40367]: https://github.com/rust-lang/rust/pull/40367
4464 [40377]: https://github.com/rust-lang/rust/pull/40377
4465 [40409]: https://github.com/rust-lang/rust/pull/40409
4466 [40516]: https://github.com/rust-lang/rust/pull/40516
4467 [40556]: https://github.com/rust-lang/rust/pull/40556
4468 [40561]: https://github.com/rust-lang/rust/pull/40561
4469 [40589]: https://github.com/rust-lang/rust/pull/40589
4470 [40612]: https://github.com/rust-lang/rust/pull/40612
4471 [40723]: https://github.com/rust-lang/rust/pull/40723
4472 [40728]: https://github.com/rust-lang/rust/pull/40728
4473 [40731]: https://github.com/rust-lang/rust/pull/40731
4474 [40734]: https://github.com/rust-lang/rust/pull/40734
4475 [40805]: https://github.com/rust-lang/rust/pull/40805
4476 [40807]: https://github.com/rust-lang/rust/pull/40807
4477 [40828]: https://github.com/rust-lang/rust/pull/40828
4478 [40870]: https://github.com/rust-lang/rust/pull/40870
4479 [41085]: https://github.com/rust-lang/rust/pull/41085
4480 [41143]: https://github.com/rust-lang/rust/pull/41143
4481 [41168]: https://github.com/rust-lang/rust/pull/41168
4482 [41270]: https://github.com/rust-lang/rust/issues/41270
4483 [41469]: https://github.com/rust-lang/rust/pull/41469
4484 [41805]: https://github.com/rust-lang/rust/issues/41805
4485 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
4486 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
4487 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
4488 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
4489 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
4490 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
4491 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
4492 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
4493 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
4494 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
4495 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
4496 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
4497 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
4498 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
4499
4500
4501 Version 1.17.0 (2017-04-27)
4502 ===========================
4503
4504 Language
4505 --------
4506
4507 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
4508 * [Fields of structs may be initialized without duplicating the field/variable
4509   names][39761]. [RFC 1682]
4510 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
4511 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4512   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
4513   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
4514   `'b`. Soundness fix.
4515 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
4516 * [Static variables may contain references to other statics][40027]
4517
4518 Compiler
4519 --------
4520
4521 * [Exit quickly on only `--emit dep-info`][40336]
4522 * [Make `-C relocation-model` more correctly determine whether the linker
4523   creates a position-independent executable][40245]
4524 * [Add `-C overflow-checks` to directly control whether integer overflow
4525   panics][40037]
4526 * [The rustc type checker now checks items on demand instead of in a single
4527   in-order pass][40008]. This is mostly an internal refactoring in support of
4528   future work, including incremental type checking, but also resolves [RFC
4529   1647], allowing `Self` to appear in `impl` `where` clauses.
4530 * [Optimize vtable loads][39995]
4531 * [Turn off vectorization for Emscripten targets][39990]
4532 * [Provide suggestions for unknown macros imported with `use`][39953]
4533 * [Fix ICEs in path resolution][39939]
4534 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
4535 * [Add clearer error message using `&str + &str`][39116]
4536
4537 Stabilized APIs
4538 ---------------
4539
4540 * [`Arc::into_raw`]
4541 * [`Arc::from_raw`]
4542 * [`Arc::ptr_eq`]
4543 * [`Rc::into_raw`]
4544 * [`Rc::from_raw`]
4545 * [`Rc::ptr_eq`]
4546 * [`Ordering::then`]
4547 * [`Ordering::then_with`]
4548 * [`BTreeMap::range`]
4549 * [`BTreeMap::range_mut`]
4550 * [`collections::Bound`]
4551 * [`process::abort`]
4552 * [`ptr::read_unaligned`]
4553 * [`ptr::write_unaligned`]
4554 * [`Result::expect_err`]
4555 * [`Cell::swap`]
4556 * [`Cell::replace`]
4557 * [`Cell::into_inner`]
4558 * [`Cell::take`]
4559
4560 Libraries
4561 ---------
4562
4563 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
4564 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
4565 * [`String` implements `FromIterator<&char>`][40028]
4566 * `Box` [implements][40009] a number of new conversions:
4567   `From<Box<str>> for String`,
4568   `From<Box<[T]>> for Vec<T>`,
4569   `From<Box<CStr>> for CString`,
4570   `From<Box<OsStr>> for OsString`,
4571   `From<Box<Path>> for PathBuf`,
4572   `Into<Box<str>> for String`,
4573   `Into<Box<[T]>> for Vec<T>`,
4574   `Into<Box<CStr>> for CString`,
4575   `Into<Box<OsStr>> for OsString`,
4576   `Into<Box<Path>> for PathBuf`,
4577   `Default for Box<str>`,
4578   `Default for Box<CStr>`,
4579   `Default for Box<OsStr>`,
4580   `From<&CStr> for Box<CStr>`,
4581   `From<&OsStr> for Box<OsStr>`,
4582   `From<&Path> for Box<Path>`
4583 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
4584 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
4585 * [Slightly optimize `slice::sort`][39538]
4586 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
4587 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
4588   `Box<str>` implements `From<&str>`][39438]
4589 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
4590   `From<(I, u16)> where I: Into<IpAddr>`][39372]
4591 * [`format!` estimates the needed capacity before writing a string][39356]
4592 * [Support unprivileged symlink creation in Windows][38921]
4593 * [`PathBuf` implements `Default`][38764]
4594 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
4595 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
4596   and poor hash functions.
4597
4598 Cargo
4599 -----
4600
4601 * [Add `cargo check --all`][cargo/3731]
4602 * [Add an option to ignore SSL revocation checking][cargo/3699]
4603 * [Add `cargo run --package`][cargo/3691]
4604 * [Add `required_features`][cargo/3667]
4605 * [Assume `build.rs` is a build script][cargo/3664]
4606 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
4607
4608 Misc
4609 ----
4610
4611 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
4612   `rustbook`][39633]
4613 * [The "Unstable Book" documents nightly-only features][ubook]
4614 * [Improve the style of the sidebar in rustdoc output][40265]
4615 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
4616 * [Fix MSP430 breakage due to `i128`][40257]
4617 * [Preliminary Solaris/SPARCv9 support][39903]
4618 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
4619   run without installing the MSVC runtime.
4620 * [`rustdoc --test` includes file names in test names][39788]
4621 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
4622   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
4623 * [Initial support for `aarch64-unknown-freebsd`][39491]
4624 * [Initial support for `i686-unknown-netbsd`][39426]
4625 * [This release no longer includes the old makefile build system][39431]. Rust
4626   is built with a custom build system, written in Rust, and with Cargo.
4627 * [Add Debug implementations for libcollection structs][39002]
4628 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
4629 * [`--test-threads=0` produces an error][38945]
4630 * [`rustup` installs documentation by default][40526]
4631 * [The Rust source includes NatVis visualizations][39843]. These can be used by
4632   WinDbg and Visual Studio to improve the debugging experience.
4633
4634 Compatibility Notes
4635 -------------------
4636
4637 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
4638   workaround, either use MSVC 2015 or run vcvars.bat.
4639 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4640   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
4641   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
4642   fix.
4643 * [`format!` and `Display::to_string` panic if an underlying formatting
4644   implementation returns an error][40117]. Previously the error was silently
4645   ignored. It is incorrect for `write_fmt` to return an error when writing
4646   to a string.
4647 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
4648   crates were marked stable and could be accessed from the stable toolchain.
4649 * [Rust git source no longer includes vendored crates][39728]. Those that need
4650   to build with vendored crates should build from release tarballs.
4651 * [Fix inert attributes from `proc_macro_derives`][39572]
4652 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
4653   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
4654   build system.
4655 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
4656   existing code generally ignores the type of dead-code unless a type-hint is
4657   provided; this can cause surprising inference interactions particularly around
4658   defaulting. The new code uniformly ignores the result type of dead-code.
4659 * [Tuple-struct constructors with private fields are no longer visible][38932]
4660 * [Lifetime parameters that do not appear in the arguments are now considered
4661   early-bound][38897], resolving a soundness bug (#[32330]). The
4662   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
4663   April of 2016.
4664 * [rustdoc: fix doctests with non-feature crate attributes][38161]
4665 * [Make transmuting from fn item types to pointer-sized types a hard
4666   error][34198]
4667
4668 [27787]: https://github.com/rust-lang/rust/issues/27787
4669 [32330]: https://github.com/rust-lang/rust/issues/32330
4670 [34198]: https://github.com/rust-lang/rust/pull/34198
4671 [38161]: https://github.com/rust-lang/rust/pull/38161
4672 [38368]: https://github.com/rust-lang/rust/pull/38368
4673 [38584]: https://github.com/rust-lang/rust/issues/38584
4674 [38661]: https://github.com/rust-lang/rust/pull/38661
4675 [38764]: https://github.com/rust-lang/rust/pull/38764
4676 [38864]: https://github.com/rust-lang/rust/issues/38864
4677 [38897]: https://github.com/rust-lang/rust/pull/38897
4678 [38921]: https://github.com/rust-lang/rust/pull/38921
4679 [38932]: https://github.com/rust-lang/rust/pull/38932
4680 [38945]: https://github.com/rust-lang/rust/pull/38945
4681 [38981]: https://github.com/rust-lang/rust/pull/38981
4682 [39002]: https://github.com/rust-lang/rust/pull/39002
4683 [39116]: https://github.com/rust-lang/rust/pull/39116
4684 [39193]: https://github.com/rust-lang/rust/pull/39193
4685 [39265]: https://github.com/rust-lang/rust/pull/39265
4686 [39356]: https://github.com/rust-lang/rust/pull/39356
4687 [39372]: https://github.com/rust-lang/rust/pull/39372
4688 [39426]: https://github.com/rust-lang/rust/pull/39426
4689 [39431]: https://github.com/rust-lang/rust/pull/39431
4690 [39438]: https://github.com/rust-lang/rust/pull/39438
4691 [39440]: https://github.com/rust-lang/rust/pull/39440
4692 [39485]: https://github.com/rust-lang/rust/pull/39485
4693 [39491]: https://github.com/rust-lang/rust/pull/39491
4694 [39518]: https://github.com/rust-lang/rust/pull/39518
4695 [39538]: https://github.com/rust-lang/rust/pull/39538
4696 [39572]: https://github.com/rust-lang/rust/pull/39572
4697 [39633]: https://github.com/rust-lang/rust/pull/39633
4698 [39642]: https://github.com/rust-lang/rust/pull/39642
4699 [39728]: https://github.com/rust-lang/rust/pull/39728
4700 [39761]: https://github.com/rust-lang/rust/pull/39761
4701 [39788]: https://github.com/rust-lang/rust/pull/39788
4702 [39793]: https://github.com/rust-lang/rust/pull/39793
4703 [39837]: https://github.com/rust-lang/rust/pull/39837
4704 [39843]: https://github.com/rust-lang/rust/pull/39843
4705 [39851]: https://github.com/rust-lang/rust/pull/39851
4706 [39903]: https://github.com/rust-lang/rust/pull/39903
4707 [39939]: https://github.com/rust-lang/rust/pull/39939
4708 [39953]: https://github.com/rust-lang/rust/pull/39953
4709 [39960]: https://github.com/rust-lang/rust/pull/39960
4710 [39990]: https://github.com/rust-lang/rust/pull/39990
4711 [39995]: https://github.com/rust-lang/rust/pull/39995
4712 [40008]: https://github.com/rust-lang/rust/pull/40008
4713 [40009]: https://github.com/rust-lang/rust/pull/40009
4714 [40027]: https://github.com/rust-lang/rust/pull/40027
4715 [40028]: https://github.com/rust-lang/rust/pull/40028
4716 [40037]: https://github.com/rust-lang/rust/pull/40037
4717 [40117]: https://github.com/rust-lang/rust/pull/40117
4718 [40166]: https://github.com/rust-lang/rust/pull/40166
4719 [40245]: https://github.com/rust-lang/rust/pull/40245
4720 [40257]: https://github.com/rust-lang/rust/pull/40257
4721 [40261]: https://github.com/rust-lang/rust/pull/40261
4722 [40265]: https://github.com/rust-lang/rust/pull/40265
4723 [40319]: https://github.com/rust-lang/rust/pull/40319
4724 [40336]: https://github.com/rust-lang/rust/pull/40336
4725 [40526]: https://github.com/rust-lang/rust/pull/40526
4726 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4727 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
4728 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
4729 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
4730 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
4731 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
4732 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
4733 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
4734 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
4735 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
4736 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
4737 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
4738 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
4739 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
4740 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
4741 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
4742 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
4743 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
4744 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
4745 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
4746 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
4747 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
4748 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
4749 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
4750 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
4751 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
4752 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
4753 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
4754 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
4755 [mdbook]: https://crates.io/crates/mdbook
4756 [ubook]: https://doc.rust-lang.org/unstable-book/
4757
4758
4759 Version 1.16.0 (2017-03-16)
4760 ===========================
4761
4762 Language
4763 --------
4764
4765 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4766 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4767   match patterns][38069]
4768 * [Clean up semantics of `self` in an import list][38313]
4769 * [`Self` may appear in `impl` headers][38920]
4770 * [`Self` may appear in struct expressions][39282]
4771
4772 Compiler
4773 --------
4774
4775 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
4776   a `.rmeta` file containing only crate metadata][38571]. This can be
4777   used by tools like the Rust Language Service to perform
4778   metadata-only builds.
4779 * [Levenshtein based typo suggestions now work in most places, while
4780   previously they worked only for fields and sometimes for local
4781   variables][38927]. Together with the overhaul of "no
4782   resolution"/"unexpected resolution" errors (#[38154]) they result in
4783   large and systematic improvement in resolution diagnostics.
4784 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
4785   `U`][38670]
4786 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
4787 * [`rustc` no longer attempts to provide "consider using an explicit
4788   lifetime" suggestions][37057]. They were inaccurate.
4789
4790 Stabilized APIs
4791 ---------------
4792
4793 * [`VecDeque::truncate`]
4794 * [`VecDeque::resize`]
4795 * [`String::insert_str`]
4796 * [`Duration::checked_add`]
4797 * [`Duration::checked_sub`]
4798 * [`Duration::checked_div`]
4799 * [`Duration::checked_mul`]
4800 * [`str::replacen`]
4801 * [`str::repeat`]
4802 * [`SocketAddr::is_ipv4`]
4803 * [`SocketAddr::is_ipv6`]
4804 * [`IpAddr::is_ipv4`]
4805 * [`IpAddr::is_ipv6`]
4806 * [`Vec::dedup_by`]
4807 * [`Vec::dedup_by_key`]
4808 * [`Result::unwrap_or_default`]
4809 * [`<*const T>::wrapping_offset`]
4810 * [`<*mut T>::wrapping_offset`]
4811 * `CommandExt::creation_flags`
4812 * [`File::set_permissions`]
4813 * [`String::split_off`]
4814
4815 Libraries
4816 ---------
4817
4818 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
4819   their argument by `Borrow` parameter][37761]
4820 * [All public types in std implement `Debug`][38006]
4821 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
4822 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
4823 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4824   Windows][38274]
4825 * [std: Fix partial writes in `LineWriter`][38062]
4826 * [std: Clamp max read/write sizes on Unix][38062]
4827 * [Use more specific panic message for `&str` slicing errors][38066]
4828 * [`TcpListener::set_only_v6` is deprecated][38304]. This
4829   functionality cannot be achieved in std currently.
4830 * [`writeln!`, like `println!`, now accepts a form with no string
4831   or formatting arguments, to just print a newline][38469]
4832 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
4833 * [Reduce the size of static data in `std_unicode::tables`][38781]
4834 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
4835   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
4836   `Display`][38909]
4837 * [`Duration` implements `Sum`][38712]
4838 * [`String` implements `ToSocketAddrs`][39048]
4839
4840 Cargo
4841 -----
4842
4843 * [The `cargo check` command does a type check of a project without
4844   building it][cargo/3296]
4845 * [crates.io will display CI badges from Travis and AppVeyor, if
4846   specified in Cargo.toml][cargo/3546]
4847 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
4848 * [Compilation profiles accept integer values for `debug`, in addition
4849   to `true` and `false`. These are passed to `rustc` as the value to
4850   `-C debuginfo`][cargo/3534]
4851 * [Implement `cargo --version --verbose`][cargo/3604]
4852 * [All builds now output 'dep-info' build dependencies compatible with
4853   make and ninja][cargo/3557]
4854 * [Build all workspace members with `build --all`][cargo/3511]
4855 * [Document all workspace members with `doc --all`][cargo/3515]
4856 * [Path deps outside workspace are not members][cargo/3443]
4857
4858 Misc
4859 ----
4860
4861 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
4862   the path to the Rust implementation][38589]
4863 * [The `armv7-linux-androideabi` target no longer enables NEON
4864   extensions, per Google's ABI guide][38413]
4865 * [The stock standard library can be compiled for Redox OS][38401]
4866 * [Rust has initial SPARC support][38726]. Tier 3. No builds
4867   available.
4868 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
4869   builds available.
4870 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
4871
4872 Compatibility Notes
4873 -------------------
4874
4875 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4876   match patterns][38069]
4877 * In this release, references to uninhabited types can not be
4878   pattern-matched. This was accidentally allowed in 1.15.
4879 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4880 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4881   Windows][38274]
4882 * [Clean up semantics of `self` in an import list][38313]
4883 * Reimplemented lifetime elision. This change was almost entirely compatible
4884   with existing code, but it did close a number of small bugs and loopholes,
4885   as well as being more accepting in some other [cases][41105].
4886
4887 [37057]: https://github.com/rust-lang/rust/pull/37057
4888 [37761]: https://github.com/rust-lang/rust/pull/37761
4889 [38006]: https://github.com/rust-lang/rust/pull/38006
4890 [38051]: https://github.com/rust-lang/rust/pull/38051
4891 [38062]: https://github.com/rust-lang/rust/pull/38062
4892 [38062]: https://github.com/rust-lang/rust/pull/38622
4893 [38066]: https://github.com/rust-lang/rust/pull/38066
4894 [38069]: https://github.com/rust-lang/rust/pull/38069
4895 [38131]: https://github.com/rust-lang/rust/pull/38131
4896 [38154]: https://github.com/rust-lang/rust/pull/38154
4897 [38274]: https://github.com/rust-lang/rust/pull/38274
4898 [38304]: https://github.com/rust-lang/rust/pull/38304
4899 [38313]: https://github.com/rust-lang/rust/pull/38313
4900 [38314]: https://github.com/rust-lang/rust/pull/38314
4901 [38327]: https://github.com/rust-lang/rust/pull/38327
4902 [38401]: https://github.com/rust-lang/rust/pull/38401
4903 [38413]: https://github.com/rust-lang/rust/pull/38413
4904 [38469]: https://github.com/rust-lang/rust/pull/38469
4905 [38559]: https://github.com/rust-lang/rust/pull/38559
4906 [38571]: https://github.com/rust-lang/rust/pull/38571
4907 [38580]: https://github.com/rust-lang/rust/pull/38580
4908 [38589]: https://github.com/rust-lang/rust/pull/38589
4909 [38670]: https://github.com/rust-lang/rust/pull/38670
4910 [38712]: https://github.com/rust-lang/rust/pull/38712
4911 [38726]: https://github.com/rust-lang/rust/pull/38726
4912 [38781]: https://github.com/rust-lang/rust/pull/38781
4913 [38798]: https://github.com/rust-lang/rust/pull/38798
4914 [38909]: https://github.com/rust-lang/rust/pull/38909
4915 [38920]: https://github.com/rust-lang/rust/pull/38920
4916 [38927]: https://github.com/rust-lang/rust/pull/38927
4917 [39048]: https://github.com/rust-lang/rust/pull/39048
4918 [39282]: https://github.com/rust-lang/rust/pull/39282
4919 [39379]: https://github.com/rust-lang/rust/pull/39379
4920 [41105]: https://github.com/rust-lang/rust/issues/41105
4921 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4922 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4923 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
4924 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
4925 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
4926 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
4927 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
4928 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
4929 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
4930 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
4931 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
4932 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
4933 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
4934 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
4935 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
4936 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
4937 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
4938 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
4939 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
4940 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
4941 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
4942 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
4943 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
4944 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
4945 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
4946 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
4947 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
4948 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
4949 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
4950 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4951
4952
4953 Version 1.15.1 (2017-02-09)
4954 ===========================
4955
4956 * [Fix IntoIter::as_mut_slice's signature][39466]
4957 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
4958
4959 [39466]: https://github.com/rust-lang/rust/pull/39466
4960 [39523]: https://github.com/rust-lang/rust/pull/39523
4961
4962
4963 Version 1.15.0 (2017-02-02)
4964 ===========================
4965
4966 Language
4967 --------
4968
4969 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
4970   stable. This allows popular code-generating crates like Serde and Diesel to
4971   work ergonomically. [RFC 1681].
4972 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
4973   with curly braces][36868]. Part of [RFC 1506].
4974 * [A number of minor changes to name resolution have been activated][37127].
4975   They add up to more consistent semantics, allowing for future evolution of
4976   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4977   details of what is different. The breaking changes here have been transitioned
4978   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4979 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
4980   bounds][38279]
4981 * [`?Sized` can be used in `where` clauses][37791]
4982 * [There is now a limit on the size of monomorphized types and it can be
4983   modified with the `#![type_size_limit]` crate attribute, similarly to
4984   the `#![recursion_limit]` attribute][37789]
4985
4986 Compiler
4987 --------
4988
4989 * [On Windows, the compiler will apply dllimport attributes when linking to
4990   extern functions][37973]. Additional attributes and flags can control which
4991   library kind is linked and its name. [RFC 1717].
4992 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4993 * [The `--test` flag works with procedural macro crates][38107]
4994 * [Fix `extern "aapcs" fn` ABI][37814]
4995 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
4996 * [The `format!` expander recognizes incorrect `printf` and shell-style
4997   formatting directives and suggests the correct format][37613].
4998 * [Only report one error for all unused imports in an import list][37456]
4999
5000 Compiler Performance
5001 --------------------
5002
5003 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
5004 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
5005 * [Don't clone in `UnificationTable::probe`][37848]
5006 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
5007 * [Use small vectors in type walker][37760]
5008 * [Macro expansion performance was improved][37701]
5009 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
5010 * [Replace FNV with a faster hash function][37229]
5011
5012 Stabilized APIs
5013 ---------------
5014
5015 * [`std::iter::Iterator::min_by`]
5016 * [`std::iter::Iterator::max_by`]
5017 * [`std::os::*::fs::FileExt`]
5018 * [`std::sync::atomic::Atomic*::get_mut`]
5019 * [`std::sync::atomic::Atomic*::into_inner`]
5020 * [`std::vec::IntoIter::as_slice`]
5021 * [`std::vec::IntoIter::as_mut_slice`]
5022 * [`std::sync::mpsc::Receiver::try_iter`]
5023 * [`std::os::unix::process::CommandExt::before_exec`]
5024 * [`std::rc::Rc::strong_count`]
5025 * [`std::rc::Rc::weak_count`]
5026 * [`std::sync::Arc::strong_count`]
5027 * [`std::sync::Arc::weak_count`]
5028 * [`std::char::encode_utf8`]
5029 * [`std::char::encode_utf16`]
5030 * [`std::cell::Ref::clone`]
5031 * [`std::io::Take::into_inner`]
5032
5033 Libraries
5034 ---------
5035
5036 * [The standard sorting algorithm has been rewritten for dramatic performance
5037   improvements][38192]. It is a hybrid merge sort, drawing influences from
5038   Timsort. Previously it was a naive merge sort.
5039 * [`Iterator::nth` no longer has a `Sized` bound][38134]
5040 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
5041   performance.
5042 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
5043   and `char_indices().last()`][37882]
5044 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
5045 * [Chinese characters display correctly in `fmt::Debug`][37855]
5046 * [Derive `Default` for `Duration`][37699]
5047 * [Support creation of anonymous pipes on WinXP/2k][37677]
5048 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
5049 * [Don't pass overlapped handles to processes][38835]
5050
5051 Cargo
5052 -----
5053
5054 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5055   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5056   should instead check the variable at runtime with `std::env`. That the value
5057   was set at build time was a bug, and incorrect when cross-compiling. This
5058   change is known to cause breakage.
5059 * [Add `--all` flag to `cargo test`][cargo/3221]
5060 * [Compile statically against the MSVC CRT][cargo/3363]
5061 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
5062 * [Link OpenSSL statically on OSX][cargo/3311]
5063 * [Apply new fingerprinting to build dir outputs][cargo/3310]
5064 * [Test for bad path overrides with summaries][cargo/3336]
5065 * [Require `cargo install --vers` to take a semver version][cargo/3338]
5066 * [Fix retrying crate downloads for network errors][cargo/3348]
5067 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
5068 * [Emit more info on --message-format=json][cargo/3319]
5069 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
5070 * [Don't ignore errors in workspace manifest][cargo/3409]
5071 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
5072
5073 Tooling
5074 -------
5075
5076 * [Test runners (binaries built with `--test`) now support a `--list` argument
5077   that lists the tests it contains][38185]
5078 * [Test runners now support a `--exact` argument that makes the test filter
5079   match exactly, instead of matching only a substring of the test name][38181]
5080 * [rustdoc supports a `--playground-url` flag][37763]
5081 * [rustdoc provides more details about `#[should_panic]` errors][37749]
5082
5083 Misc
5084 ----
5085
5086 * [The Rust build system is now written in Rust][37817]. The Makefiles may
5087   continue to be used in this release by passing `--disable-rustbuild` to the
5088   configure script, but they will be deleted soon. Note that the new build
5089   system uses a different on-disk layout that will likely affect any scripts
5090   building Rust.
5091 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
5092   releases.
5093 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
5094 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
5095   releases.
5096
5097 Compatibility Notes
5098 -------------------
5099
5100 * [A number of minor changes to name resolution have been activated][37127].
5101   They add up to more consistent semantics, allowing for future evolution of
5102   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5103   details of what is different. The breaking changes here have been transitioned
5104   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5105 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5106   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5107   should instead check the variable at runtime with `std::env`. That the value
5108   was set at build time was a bug, and incorrect when cross-compiling. This
5109   change is known to cause breakage.
5110 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
5111   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
5112   1.10 and is now an error by default. It will become a hard error in the near
5113   future.
5114 * [The semantics relating modules to file system directories are changing in
5115   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
5116   lint, which is a warning in this release, and will become a hard error in the
5117   future.
5118 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5119 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
5120   the underlying iterator][37834]
5121
5122 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
5123 [33685]: https://github.com/rust-lang/rust/issues/33685
5124 [36868]: https://github.com/rust-lang/rust/pull/36868
5125 [37127]: https://github.com/rust-lang/rust/pull/37127
5126 [37229]: https://github.com/rust-lang/rust/pull/37229
5127 [37456]: https://github.com/rust-lang/rust/pull/37456
5128 [37527]: https://github.com/rust-lang/rust/pull/37527
5129 [37602]: https://github.com/rust-lang/rust/pull/37602
5130 [37613]: https://github.com/rust-lang/rust/pull/37613
5131 [37615]: https://github.com/rust-lang/rust/pull/37615
5132 [37636]: https://github.com/rust-lang/rust/pull/37636
5133 [37627]: https://github.com/rust-lang/rust/pull/37627
5134 [37642]: https://github.com/rust-lang/rust/pull/37642
5135 [37677]: https://github.com/rust-lang/rust/pull/37677
5136 [37699]: https://github.com/rust-lang/rust/pull/37699
5137 [37701]: https://github.com/rust-lang/rust/pull/37701
5138 [37705]: https://github.com/rust-lang/rust/pull/37705
5139 [37749]: https://github.com/rust-lang/rust/pull/37749
5140 [37760]: https://github.com/rust-lang/rust/pull/37760
5141 [37763]: https://github.com/rust-lang/rust/pull/37763
5142 [37764]: https://github.com/rust-lang/rust/pull/37764
5143 [37789]: https://github.com/rust-lang/rust/pull/37789
5144 [37791]: https://github.com/rust-lang/rust/pull/37791
5145 [37814]: https://github.com/rust-lang/rust/pull/37814
5146 [37817]: https://github.com/rust-lang/rust/pull/37817
5147 [37834]: https://github.com/rust-lang/rust/pull/37834
5148 [37848]: https://github.com/rust-lang/rust/pull/37848
5149 [37855]: https://github.com/rust-lang/rust/pull/37855
5150 [37882]: https://github.com/rust-lang/rust/pull/37882
5151 [37888]: https://github.com/rust-lang/rust/pull/37888
5152 [37973]: https://github.com/rust-lang/rust/pull/37973
5153 [37979]: https://github.com/rust-lang/rust/pull/37979
5154 [38086]: https://github.com/rust-lang/rust/pull/38086
5155 [38107]: https://github.com/rust-lang/rust/pull/38107
5156 [38117]: https://github.com/rust-lang/rust/pull/38117
5157 [38134]: https://github.com/rust-lang/rust/pull/38134
5158 [38146]: https://github.com/rust-lang/rust/pull/38146
5159 [38181]: https://github.com/rust-lang/rust/pull/38181
5160 [38182]: https://github.com/rust-lang/rust/pull/38182
5161 [38185]: https://github.com/rust-lang/rust/pull/38185
5162 [38192]: https://github.com/rust-lang/rust/pull/38192
5163 [38279]: https://github.com/rust-lang/rust/pull/38279
5164 [38835]: https://github.com/rust-lang/rust/pull/38835
5165 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5166 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5167 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
5168 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
5169 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
5170 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
5171 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
5172 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
5173 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
5174 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
5175 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
5176 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
5177 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
5178 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
5179 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
5180 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
5181 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
5182 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
5183 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
5184 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
5185 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
5186 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
5187 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
5188 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
5189 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
5190 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
5191 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
5192 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
5193 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
5194 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
5195 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
5196 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
5197 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
5198 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
5199 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
5200 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
5201 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
5202 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
5203
5204
5205 Version 1.14.0 (2016-12-22)
5206 ===========================
5207
5208 Language
5209 --------
5210
5211 * [`..` matches multiple tuple fields in enum variants, structs
5212   and tuples][36843]. [RFC 1492].
5213 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
5214 * [`use *` and `use ::*` both glob-import from the crate root][37367]
5215 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
5216   dereferencing][36822]
5217
5218 Compiler
5219 --------
5220
5221 * [Mark enums with non-zero discriminant as non-zero][37224]
5222 * [Lower-case `static mut` names are linted like other
5223   statics and consts][37162]
5224 * [Fix ICE on some macros in const integer positions
5225    (e.g. `[u8; m!()]`)][36819]
5226 * [Improve error message and snippet for "did you mean `x`"][36798]
5227 * [Add a panic-strategy field to the target specification][36794]
5228 * [Include LLVM version in `--version --verbose`][37200]
5229
5230 Compile-time Optimizations
5231 --------------------------
5232
5233 * [Improve macro expansion performance][37569]
5234 * [Shrink `Expr_::ExprInlineAsm`][37445]
5235 * [Replace all uses of SHA-256 with BLAKE2b][37439]
5236 * [Reduce the number of bytes hashed by `IchHasher`][37427]
5237 * [Avoid more allocations when compiling html5ever][37373]
5238 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
5239 * [Avoid some allocations in the macro parser][37318]
5240 * [Use a faster deflate setting][37298]
5241 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
5242   during interning of slices][37270]
5243 * [Optimize `write_metadata`][37267]
5244 * [Don't process obligation forest cycles when stalled][37231]
5245 * [Avoid many `CrateConfig` clones][37161]
5246 * [Optimize `Substs::super_fold_with`][37108]
5247 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
5248 * [Speed up `plug_leaks`][36917]
5249
5250 Libraries
5251 ---------
5252
5253 * [`println!()`, with no arguments, prints newline][36825].
5254   Previously, an empty string was required to achieve the same.
5255 * [`Wrapping` impls standard binary and unary operators, as well as
5256    the `Sum` and `Product` iterators][37356]
5257 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
5258   Vec<T>`][37326]
5259 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
5260   `VecDeque` iterators][37315]
5261 * [Improve `SipHasher` performance on small values][37312]
5262 * [Add Iterator trait TrustedLen to enable better FromIterator /
5263   Extend][37306]
5264 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
5265 * [`ReadDir` implements `Debug`][37221]
5266 * [Implement `RefUnwindSafe` for atomic types][37178]
5267 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
5268 * [Avoid allocations in `Decoder::read_str`][37064]
5269 * [`io::Error` implements `From<io::ErrorKind>`][37037]
5270 * [Impl `Debug` for raw pointers to unsized data][36880]
5271 * [Don't reuse `HashMap` random seeds][37470]
5272 * [The internal memory layout of `HashMap` is more cache-friendly, for
5273   significant improvements in some operations][36692]
5274 * [`HashMap` uses less memory on 32-bit architectures][36595]
5275 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
5276
5277 Cargo
5278 -----
5279
5280 * [Expose rustc cfg values to build scripts][cargo/3243]
5281 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
5282 * [Fix passing --features when testing multiple packages][cargo/3280]
5283 * [Use a single profile set per workspace][cargo/3249]
5284 * [Load `replace` sections from lock files][cargo/3220]
5285 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
5286
5287 Tooling
5288 -------
5289
5290 * [rustup is the recommended Rust installation method][1.14rustup]
5291 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
5292   S390x. These are [tier 2] platforms and may have major defects. Follow the
5293   instructions on the website to install, or add the targets to an existing
5294   installation with `rustup target add`. The new target triples are:
5295   - `mips-unknown-linux-gnu`
5296   - `mipsel-unknown-linux-gnu`
5297   - `mips64-unknown-linux-gnuabi64`
5298   - `mips64el-unknown-linux-gnuabi64 `
5299   - `powerpc-unknown-linux-gnu`
5300   - `powerpc64-unknown-linux-gnu`
5301   - `powerpc64le-unknown-linux-gnu`
5302   - `s390x-unknown-linux-gnu `
5303 * This release includes target (std) builds for ARM Linux running MUSL
5304   libc. These are [tier 2] platforms and may have major defects. Add the
5305   following triples to an existing rustup installation with `rustup target add`:
5306   - `arm-unknown-linux-musleabi`
5307   - `arm-unknown-linux-musleabihf`
5308   - `armv7-unknown-linux-musleabihf`
5309 * This release includes [experimental support for WebAssembly][1.14wasm], via
5310   the `wasm32-unknown-emscripten` target. This target is known to have major
5311   defects. Please test, report, and fix.
5312 * rustup no longer installs documentation by default. Run `rustup
5313   component add rust-docs` to install.
5314 * [Fix line stepping in debugger][37310]
5315 * [Enable line number debuginfo in releases][37280]
5316
5317 Misc
5318 ----
5319
5320 * [Disable jemalloc on aarch64/powerpc/mips][37392]
5321 * [Add support for Fuchsia OS][37313]
5322 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
5323
5324 Compatibility Notes
5325 -------------------
5326
5327 * [A number of forward-compatibility lints used by the compiler
5328   to gradually introduce language changes have been converted
5329   to deny by default][36894]:
5330   - ["use of inaccessible extern crate erroneously allowed"][36886]
5331   - ["type parameter default erroneously allowed in invalid location"][36887]
5332   - ["detects super or self keywords at the beginning of global path"][36888]
5333   - ["two overlapping inherent impls define an item with the same name
5334     were erroneously allowed"][36889]
5335   - ["floating-point constants cannot be used in patterns"][36890]
5336   - ["constants of struct or enum type can only be used in a pattern if
5337      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
5338   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
5339 * [Prohibit patterns in trait methods without bodies][37378]
5340 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
5341 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
5342 * [The `$crate` macro variable is accepted in fewer locations][37213]
5343 * [Impls specifying extra region requirements beyond the trait
5344   they implement are rejected][37167]
5345 * [Enums may not be unsized][37111]. Unsized enums are intended to
5346   work but never have. For now they are forbidden.
5347 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
5348
5349 [tier 2]: https://forge.rust-lang.org/platform-support.html
5350 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
5351 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
5352 [36430]: https://github.com/rust-lang/rust/pull/36430
5353 [36595]: https://github.com/rust-lang/rust/pull/36595
5354 [36595]: https://github.com/rust-lang/rust/pull/36595
5355 [36692]: https://github.com/rust-lang/rust/pull/36692
5356 [36767]: https://github.com/rust-lang/rust/pull/36767
5357 [36794]: https://github.com/rust-lang/rust/pull/36794
5358 [36798]: https://github.com/rust-lang/rust/pull/36798
5359 [36819]: https://github.com/rust-lang/rust/pull/36819
5360 [36822]: https://github.com/rust-lang/rust/pull/36822
5361 [36825]: https://github.com/rust-lang/rust/pull/36825
5362 [36843]: https://github.com/rust-lang/rust/pull/36843
5363 [36880]: https://github.com/rust-lang/rust/pull/36880
5364 [36886]: https://github.com/rust-lang/rust/issues/36886
5365 [36887]: https://github.com/rust-lang/rust/issues/36887
5366 [36888]: https://github.com/rust-lang/rust/issues/36888
5367 [36889]: https://github.com/rust-lang/rust/issues/36889
5368 [36890]: https://github.com/rust-lang/rust/issues/36890
5369 [36891]: https://github.com/rust-lang/rust/issues/36891
5370 [36892]: https://github.com/rust-lang/rust/issues/36892
5371 [36894]: https://github.com/rust-lang/rust/pull/36894
5372 [36917]: https://github.com/rust-lang/rust/pull/36917
5373 [36993]: https://github.com/rust-lang/rust/pull/36993
5374 [37037]: https://github.com/rust-lang/rust/pull/37037
5375 [37064]: https://github.com/rust-lang/rust/pull/37064
5376 [37094]: https://github.com/rust-lang/rust/pull/37094
5377 [37108]: https://github.com/rust-lang/rust/pull/37108
5378 [37111]: https://github.com/rust-lang/rust/pull/37111
5379 [37161]: https://github.com/rust-lang/rust/pull/37161
5380 [37162]: https://github.com/rust-lang/rust/pull/37162
5381 [37167]: https://github.com/rust-lang/rust/pull/37167
5382 [37178]: https://github.com/rust-lang/rust/pull/37178
5383 [37200]: https://github.com/rust-lang/rust/pull/37200
5384 [37213]: https://github.com/rust-lang/rust/pull/37213
5385 [37221]: https://github.com/rust-lang/rust/pull/37221
5386 [37224]: https://github.com/rust-lang/rust/pull/37224
5387 [37230]: https://github.com/rust-lang/rust/pull/37230
5388 [37231]: https://github.com/rust-lang/rust/pull/37231
5389 [37247]: https://github.com/rust-lang/rust/pull/37247
5390 [37267]: https://github.com/rust-lang/rust/pull/37267
5391 [37270]: https://github.com/rust-lang/rust/pull/37270
5392 [37273]: https://github.com/rust-lang/rust/pull/37273
5393 [37280]: https://github.com/rust-lang/rust/pull/37280
5394 [37298]: https://github.com/rust-lang/rust/pull/37298
5395 [37306]: https://github.com/rust-lang/rust/pull/37306
5396 [37310]: https://github.com/rust-lang/rust/pull/37310
5397 [37312]: https://github.com/rust-lang/rust/pull/37312
5398 [37313]: https://github.com/rust-lang/rust/pull/37313
5399 [37315]: https://github.com/rust-lang/rust/pull/37315
5400 [37318]: https://github.com/rust-lang/rust/pull/37318
5401 [37322]: https://github.com/rust-lang/rust/pull/37322
5402 [37326]: https://github.com/rust-lang/rust/pull/37326
5403 [37351]: https://github.com/rust-lang/rust/pull/37351
5404 [37356]: https://github.com/rust-lang/rust/pull/37356
5405 [37367]: https://github.com/rust-lang/rust/pull/37367
5406 [37373]: https://github.com/rust-lang/rust/pull/37373
5407 [37378]: https://github.com/rust-lang/rust/pull/37378
5408 [37389]: https://github.com/rust-lang/rust/pull/37389
5409 [37392]: https://github.com/rust-lang/rust/pull/37392
5410 [37427]: https://github.com/rust-lang/rust/pull/37427
5411 [37439]: https://github.com/rust-lang/rust/pull/37439
5412 [37445]: https://github.com/rust-lang/rust/pull/37445
5413 [37470]: https://github.com/rust-lang/rust/pull/37470
5414 [37569]: https://github.com/rust-lang/rust/pull/37569
5415 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5416 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
5417 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
5418 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
5419 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
5420 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
5421 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
5422
5423
5424 Version 1.13.0 (2016-11-10)
5425 ===========================
5426
5427 Language
5428 --------
5429
5430 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
5431   errors, like the `try!` macro, described in [RFC 0243].
5432 * [Stabilize macros in type position][36014]. Described in [RFC 873].
5433 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
5434 * [Fix `#[derive]` for empty tuple structs/variants][35728]
5435 * [Fix lifetime rules for 'if' conditions][36029]
5436 * [Avoid loading and parsing unconfigured non-inline modules][36482]
5437
5438 Compiler
5439 --------
5440
5441 * [Add the `-C link-arg` argument][36574]
5442 * [Remove the old AST-based backend from rustc_trans][35764]
5443 * [Don't enable NEON by default on armv7 Linux][35814]
5444 * [Fix debug line number info for macro expansions][35238]
5445 * [Do not emit "class method" debuginfo for types that are not
5446   DICompositeType][36008]
5447 * [Warn about multiple conflicting #[repr] hints][34623]
5448 * [When sizing DST, don't double-count nested struct prefixes][36351]
5449 * [Default RUST_MIN_STACK to 16MiB for now][36505]
5450 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
5451 * [Reject macros with empty repetitions to avoid infinite loop][36721]
5452 * [Expand macros without recursing to avoid stack overflows][36214]
5453
5454 Diagnostics
5455 -----------
5456
5457 * [Replace macro backtraces with labeled local uses][35702]
5458 * [Improve error message for misplaced doc comments][33922]
5459 * [Buffer unix and lock windows to prevent message interleaving][35975]
5460 * [Update lifetime errors to specifically note temporaries][36171]
5461 * [Special case a few colors for Windows][36178]
5462 * [Suggest `use self` when such an import resolves][36289]
5463 * [Be more specific when type parameter shadows primitive type][36338]
5464 * Many minor improvements
5465
5466 Compile-time Optimizations
5467 --------------------------
5468
5469 * [Compute and cache HIR hashes at beginning][35854]
5470 * [Don't hash types in loan paths][36004]
5471 * [Cache projections in trans][35761]
5472 * [Optimize the parser's last token handling][36527]
5473 * [Only instantiate #[inline] functions in codegen units referencing
5474   them][36524]. This leads to big improvements in cases where crates export
5475   define many inline functions without using them directly.
5476 * [Lazily allocate TypedArena's first chunk][36592]
5477 * [Don't allocate during default HashSet creation][36734]
5478
5479 Stabilized APIs
5480 ---------------
5481
5482 * [`checked_abs`]
5483 * [`wrapping_abs`]
5484 * [`overflowing_abs`]
5485 * [`RefCell::try_borrow`]
5486 * [`RefCell::try_borrow_mut`]
5487
5488 Libraries
5489 ---------
5490
5491 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
5492 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
5493   covariant][35354]
5494 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
5495 * [Implement `Debug` for `std::vec::IntoIter`][35707]
5496 * [`CString`: avoid excessive growth just to 0-terminate][35871]
5497 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
5498 * [Use arc4rand on FreeBSD][35884]
5499 * [memrchr: Correct aligned offset computation][35969]
5500 * [Improve Demangling of Rust Symbols][36059]
5501 * [Use monotonic time in condition variables][35048]
5502 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
5503 * [Implement conversion traits for `char`][35755]
5504 * [Fix illegal instruction caused by overflow in channel cloning][36104]
5505 * [Zero first byte of CString on drop][36264]
5506 * [Inherit overflow checks for sum and product][36372]
5507 * [Add missing Eq implementations][36423]
5508 * [Implement `Debug` for `DirEntry`][36631]
5509 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
5510   `errno`][36754]
5511 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5512 * [Implement more traits for `std::io::ErrorKind`][35911]
5513 * [Optimize BinaryHeap bounds checking][36072]
5514 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
5515   `extend_with_element`][36355]
5516 * [Fix overflow checking in unsigned pow()][34942]
5517
5518 Cargo
5519 -----
5520
5521 * This release includes security fixes to both curl and OpenSSL.
5522 * [Fix transitive doctests when panic=abort][cargo/3021]
5523 * [Add --all-features flag to cargo][cargo/3038]
5524 * [Reject path-based dependencies in `cargo package`][cargo/3060]
5525 * [Don't parse the home directory more than once][cargo/3078]
5526 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
5527 * [Update OpenSSL to 1.0.2j][cargo/3121]
5528 * [Add license and license_file to cargo metadata output][cargo/3110]
5529 * [Make crates-io registry URL optional in config; ignore all changes to
5530   source.crates-io][cargo/3089]
5531 * [Don't download dependencies from other platforms][cargo/3123]
5532 * [Build transitive dev-dependencies when needed][cargo/3125]
5533 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
5534 * [Avoid updating registry when adding existing deps][cargo/3144]
5535 * [Warn about path overrides that won't work][cargo/3136]
5536 * [Use workspaces during `cargo install`][cargo/3146]
5537 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
5538 * [Add --message-format flag][cargo/3000]
5539 * [Pass target environment for rustdoc][cargo/3205]
5540 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
5541 * [Update curl and curl-sys][cargo/3241]
5542 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
5543
5544 Tooling
5545 -------
5546
5547 * [rustdoc: Add the `--sysroot` argument][36586]
5548 * [rustdoc: Fix a couple of issues with the search results][35655]
5549 * [rustdoc: remove the `!` from macro URLs and titles][35234]
5550 * [gdb: Fix pretty-printing special-cased Rust types][35585]
5551 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
5552
5553 Misc
5554 ----
5555
5556 * [Remove unmaintained style guide][35124]
5557 * [Add s390x support][36369]
5558 * [Initial work at Haiku OS support][36727]
5559 * [Add mips-uclibc targets][35734]
5560 * [Crate-ify compiler-rt into compiler-builtins][35021]
5561 * [Add rustc version info (git hash + date) to dist tarball][36213]
5562 * Many documentation improvements
5563
5564 Compatibility Notes
5565 -------------------
5566
5567 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5568 * [Deny (by default) transmuting from fn item types to pointer-sized
5569   types][34923]. Continuing the long transition to zero-sized fn items,
5570   per [RFC 401].
5571 * [Fix `#[derive]` for empty tuple structs/variants][35728].
5572   Part of [RFC 1506].
5573 * [Issue deprecation warnings for safe accesses to extern statics][36173]
5574 * [Fix lifetime rules for 'if' conditions][36029].
5575 * [Inherit overflow checks for sum and product][36372].
5576 * [Forbid user-defined macros named "macro_rules"][36730].
5577
5578 [33922]: https://github.com/rust-lang/rust/pull/33922
5579 [34623]: https://github.com/rust-lang/rust/pull/34623
5580 [34923]: https://github.com/rust-lang/rust/pull/34923
5581 [34942]: https://github.com/rust-lang/rust/pull/34942
5582 [34982]: https://github.com/rust-lang/rust/pull/34982
5583 [35021]: https://github.com/rust-lang/rust/pull/35021
5584 [35048]: https://github.com/rust-lang/rust/pull/35048
5585 [35074]: https://github.com/rust-lang/rust/pull/35074
5586 [35124]: https://github.com/rust-lang/rust/pull/35124
5587 [35234]: https://github.com/rust-lang/rust/pull/35234
5588 [35238]: https://github.com/rust-lang/rust/pull/35238
5589 [35354]: https://github.com/rust-lang/rust/pull/35354
5590 [35559]: https://github.com/rust-lang/rust/pull/35559
5591 [35585]: https://github.com/rust-lang/rust/pull/35585
5592 [35627]: https://github.com/rust-lang/rust/pull/35627
5593 [35655]: https://github.com/rust-lang/rust/pull/35655
5594 [35702]: https://github.com/rust-lang/rust/pull/35702
5595 [35707]: https://github.com/rust-lang/rust/pull/35707
5596 [35728]: https://github.com/rust-lang/rust/pull/35728
5597 [35734]: https://github.com/rust-lang/rust/pull/35734
5598 [35755]: https://github.com/rust-lang/rust/pull/35755
5599 [35761]: https://github.com/rust-lang/rust/pull/35761
5600 [35764]: https://github.com/rust-lang/rust/pull/35764
5601 [35814]: https://github.com/rust-lang/rust/pull/35814
5602 [35854]: https://github.com/rust-lang/rust/pull/35854
5603 [35871]: https://github.com/rust-lang/rust/pull/35871
5604 [35884]: https://github.com/rust-lang/rust/pull/35884
5605 [35911]: https://github.com/rust-lang/rust/pull/35911
5606 [35969]: https://github.com/rust-lang/rust/pull/35969
5607 [35975]: https://github.com/rust-lang/rust/pull/35975
5608 [36004]: https://github.com/rust-lang/rust/pull/36004
5609 [36008]: https://github.com/rust-lang/rust/pull/36008
5610 [36014]: https://github.com/rust-lang/rust/pull/36014
5611 [36029]: https://github.com/rust-lang/rust/pull/36029
5612 [36059]: https://github.com/rust-lang/rust/pull/36059
5613 [36072]: https://github.com/rust-lang/rust/pull/36072
5614 [36101]: https://github.com/rust-lang/rust/pull/36101
5615 [36104]: https://github.com/rust-lang/rust/pull/36104
5616 [36171]: https://github.com/rust-lang/rust/pull/36171
5617 [36173]: https://github.com/rust-lang/rust/pull/36173
5618 [36178]: https://github.com/rust-lang/rust/pull/36178
5619 [36213]: https://github.com/rust-lang/rust/pull/36213
5620 [36214]: https://github.com/rust-lang/rust/pull/36214
5621 [36264]: https://github.com/rust-lang/rust/pull/36264
5622 [36266]: https://github.com/rust-lang/rust/pull/36266
5623 [36289]: https://github.com/rust-lang/rust/pull/36289
5624 [36338]: https://github.com/rust-lang/rust/pull/36338
5625 [36351]: https://github.com/rust-lang/rust/pull/36351
5626 [36355]: https://github.com/rust-lang/rust/pull/36355
5627 [36369]: https://github.com/rust-lang/rust/pull/36369
5628 [36372]: https://github.com/rust-lang/rust/pull/36372
5629 [36423]: https://github.com/rust-lang/rust/pull/36423
5630 [36482]: https://github.com/rust-lang/rust/pull/36482
5631 [36505]: https://github.com/rust-lang/rust/pull/36505
5632 [36524]: https://github.com/rust-lang/rust/pull/36524
5633 [36527]: https://github.com/rust-lang/rust/pull/36527
5634 [36551]: https://github.com/rust-lang/rust/pull/36551
5635 [36574]: https://github.com/rust-lang/rust/pull/36574
5636 [36586]: https://github.com/rust-lang/rust/pull/36586
5637 [36592]: https://github.com/rust-lang/rust/pull/36592
5638 [36631]: https://github.com/rust-lang/rust/pull/36631
5639 [36639]: https://github.com/rust-lang/rust/pull/36639
5640 [36721]: https://github.com/rust-lang/rust/pull/36721
5641 [36727]: https://github.com/rust-lang/rust/pull/36727
5642 [36730]: https://github.com/rust-lang/rust/pull/36730
5643 [36734]: https://github.com/rust-lang/rust/pull/36734
5644 [36754]: https://github.com/rust-lang/rust/pull/36754
5645 [36995]: https://github.com/rust-lang/rust/pull/36995
5646 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
5647 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
5648 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5649 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
5650 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
5651 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
5652 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
5653 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
5654 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
5655 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
5656 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
5657 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
5658 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
5659 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
5660 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
5661 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
5662 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
5663 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
5664 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
5665 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
5666 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
5667 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
5668 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
5669 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
5670 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
5671 [rustup]: https://www.rustup.rs
5672 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
5673 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
5674 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
5675 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
5676 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
5677 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
5678 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
5679
5680
5681 Version 1.12.1 (2016-10-20)
5682 ===========================
5683
5684 Regression Fixes
5685 ----------------
5686
5687 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
5688 * [Confusion with double negation and booleans][36856]
5689 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
5690 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
5691 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
5692 * [Corrupted memory after updated to 1.12][36936]
5693 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
5694 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
5695 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
5696
5697 [36381]: https://github.com/rust-lang/rust/issues/36381
5698 [36856]: https://github.com/rust-lang/rust/issues/36856
5699 [36875]: https://github.com/rust-lang/rust/issues/36875
5700 [36924]: https://github.com/rust-lang/rust/issues/36924
5701 [36926]: https://github.com/rust-lang/rust/issues/36926
5702 [36936]: https://github.com/rust-lang/rust/issues/36936
5703 [37026]: https://github.com/rust-lang/rust/issues/37026
5704 [37112]: https://github.com/rust-lang/rust/issues/37112
5705 [37153]: https://github.com/rust-lang/rust/issues/37153
5706
5707
5708 Version 1.12.0 (2016-09-29)
5709 ===========================
5710
5711 Highlights
5712 ----------
5713
5714 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5715   This translation pass is far simpler than the previous AST->LLVM pass, and
5716   creates opportunities to perform new optimizations directly on the MIR. It
5717   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5718 * [`rustc` presents a new, more readable error format, along with
5719   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5720   Most common editors supporting Rust have been updated to work with it. It was
5721   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5722
5723 Compiler
5724 --------
5725
5726 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5727   This translation pass is far simpler than the previous AST->LLVM pass, and
5728   creates opportunities to perform new optimizations directly on the MIR. It
5729   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5730 * [Print the Rust target name, not the LLVM target name, with
5731   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
5732 * [The computation of `TypeId` is correct in some cases where it was previously
5733   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
5734 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
5735 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
5736   `--print relocation-models`, and `--print code-models` print the available
5737   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
5738   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
5739 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
5740   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
5741   These targets produce statically-linked binaries. There are no binary release
5742   builds yet though.
5743
5744 Diagnostics
5745 -----------
5746
5747 * [`rustc` presents a new, more readable error format, along with
5748   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5749   Most common editors supporting Rust have been updated to work with it. It was
5750   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5751 * [In error descriptions, references are now described in plain English,
5752   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
5753 * [In error type descriptions, unknown numeric types are named `{integer}` or
5754   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
5755 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
5756
5757 Language
5758 --------
5759
5760 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
5761 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
5762 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
5763   useful](https://github.com/rust-lang/rust/pull/34908)
5764 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
5765   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
5766 * [Semicolons are properly required as statement delimiters inside
5767   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
5768 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
5769
5770 Stabilized APIs
5771 ---------------
5772
5773 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
5774 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
5775 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
5776 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
5777 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
5778 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
5779 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
5780 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
5781 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
5782 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
5783   Both on Unix and Windows.
5784 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
5785 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
5786 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
5787 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
5788 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
5789 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
5790 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
5791 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
5792
5793 Libraries
5794 ---------
5795
5796 * [The `format!` macro and friends now allow a single argument to be formatted
5797   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
5798 * [The lifetime bounds on `[T]::binary_search_by` and
5799   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
5800 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
5801 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
5802 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
5803 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
5804 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
5805 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
5806 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
5807 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
5808   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
5809 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
5810   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
5811 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
5812 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
5813   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
5814 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
5815 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
5816 * [`mpsc::sync_channel` `Receiver`s return any available message before
5817   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
5818 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
5819 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
5820
5821 Cargo
5822 -----
5823
5824 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
5825 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
5826 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
5827 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
5828 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
5829 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
5830 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
5831 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
5832 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
5833 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
5834 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
5835 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
5836 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
5837 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
5838 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
5839 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
5840
5841 Performance
5842 -----------
5843
5844 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
5845 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
5846
5847 Tooling
5848 -------
5849
5850 * [Test binaries now support a `--test-threads` argument to specify the number
5851   of threads used to run tests, and which acts the same as the
5852   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
5853 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
5854 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
5855 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5856 * [Rust releases now come with source packages that can be installed by rustup
5857   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
5858   The resulting source code can be used by tools and IDES, located in the
5859   sysroot under `lib/rustlib/src`.
5860
5861 Misc
5862 ----
5863
5864 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
5865 * Many minor improvements to the documentation.
5866 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
5867
5868 Compatibility Notes
5869 -------------------
5870
5871 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
5872   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
5873 * [When formatting strings, if "precision" is specified, the "fill",
5874   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
5875 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
5876
5877
5878 Version 1.11.0 (2016-08-18)
5879 ===========================
5880
5881 Language
5882 --------
5883
5884 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
5885 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
5886 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
5887 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
5888
5889 Stabilized APIs
5890 ---------------
5891
5892 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
5893 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
5894 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
5895 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
5896 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
5897 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
5898   (in libcore - previously stabilized in libstd)
5899 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
5900   (in libcore - previously stabilized in libstd)
5901 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
5902   (in libcore - previously stabilized in libstd)
5903 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
5904   (in libcore - previously stabilized in libstd)
5905 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5906 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5907 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
5908 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
5909
5910 Libraries
5911 ---------
5912
5913 * [The `thread_local!` macro supports multiple definitions in a single
5914    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
5915 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
5916 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
5917   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
5918 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
5919 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
5920 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
5921 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
5922
5923 Cargo
5924 -----
5925
5926 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
5927 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
5928 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
5929 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
5930 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
5931   and `-vv` prints warnings for all crates.
5932 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
5933 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
5934   This provides room for expansion by arbitrary tools.
5935 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
5936 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
5937 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
5938 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
5939 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
5940 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
5941 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
5942
5943 Performance
5944 -----------
5945
5946 * [Caching projections speeds up type check dramatically for some
5947   workloads](https://github.com/rust-lang/rust/pull/33816)
5948 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
5949   This hasher is faster, but is believed to provide sufficient
5950   protection from collision attacks.
5951 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
5952
5953 Rustdoc
5954 -------
5955
5956 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
5957 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
5958 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
5959 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
5960 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
5961
5962 Tooling
5963 -------
5964
5965 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
5966 * [When emitting debug info, rustc emits frame pointers for closures,
5967   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
5968 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5969 * Many more errors have been given error codes and extended
5970   explanations
5971 * API documentation continues to be improved, with many new examples
5972
5973 Misc
5974 ----
5975
5976 * [rustc no longer hangs when dependencies recursively re-export
5977   submodules](https://github.com/rust-lang/rust/pull/34542)
5978 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
5979 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
5980   rewritten](https://github.com/rust-lang/rust/pull/33895)
5981 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
5982   No targets use this yet, but it works toward AVR support.
5983
5984 Compatibility Notes
5985 -------------------
5986
5987 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
5988 * [The new follow-set rules that place restrictions on `macro_rules!`
5989   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
5990   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
5991   and has been a warning since 1.10.
5992 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
5993   This causes breakage in some corner cases.
5994
5995
5996 Version 1.10.0 (2016-07-07)
5997 ===========================
5998
5999 Language
6000 --------
6001
6002 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
6003   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
6004 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
6005 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
6006 * [`panic!` can be converted to a runtime abort with the
6007   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
6008   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6009 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
6010   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
6011   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
6012   Note that Cargo does not yet directly support cdylibs.
6013
6014 Stabilized APIs
6015 ---------------
6016
6017 * `os::windows::fs::OpenOptionsExt::access_mode`
6018 * `os::windows::fs::OpenOptionsExt::share_mode`
6019 * `os::windows::fs::OpenOptionsExt::custom_flags`
6020 * `os::windows::fs::OpenOptionsExt::attributes`
6021 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
6022 * `os::unix::fs::OpenOptionsExt::custom_flags`
6023 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
6024 * `Default for sync::Weak`
6025 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
6026 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
6027 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
6028 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
6029 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
6030 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
6031 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
6032 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
6033 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
6034 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
6035 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
6036 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
6037 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
6038 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
6039 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
6040 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
6041 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
6042 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
6043 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
6044 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
6045 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
6046 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
6047 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
6048 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
6049 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
6050 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6051 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6052 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6053 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6054 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
6055 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
6056 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
6057 * Read/Write/RawFd impls for `UnixStream`
6058 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
6059 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
6060 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
6061 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
6062 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
6063 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
6064 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
6065 * RawFd impls for `UnixListener`
6066 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
6067 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
6068 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
6069 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
6070 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
6071 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
6072 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
6073 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
6074 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
6075 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
6076 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
6077 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
6078 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
6079 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
6080 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
6081 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
6082 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
6083 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
6084 * RawFd impls for `UnixDatagram`
6085 * `{BTree,Hash}Map::values_mut`
6086 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
6087
6088 Libraries
6089 ---------
6090
6091 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
6092   The semantics of this minor method are subtle and probably not what
6093   most people want.
6094 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
6095 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
6096   will fall back to `/dev/urandom` temporarily to avoid blocking
6097   during early boot](https://github.com/rust-lang/rust/pull/33086).
6098 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
6099 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
6100 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
6101 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
6102 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
6103 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
6104   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
6105
6106 Cargo
6107 -----
6108 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
6109   This controls the runtime behavior of the `panic!` macro
6110   and can be either "unwind" (the default), or "abort".
6111   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6112 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
6113 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
6114 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
6115   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
6116 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
6117 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
6118 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
6119   By default they are retried twice, which can be customized with the
6120   `net.retry` value in `.cargo/config`.
6121 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
6122 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
6123 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
6124 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
6125   Makes it possible to install multiple crates in parallel.
6126 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
6127 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
6128 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
6129 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
6130 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
6131 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
6132
6133 Performance
6134 -----------
6135
6136 * [rustc memory usage was reduced by refactoring the context used for
6137   type checking](https://github.com/rust-lang/rust/pull/33425).
6138 * [Speed up creation of `HashMap`s by caching the random keys used
6139   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
6140 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
6141 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
6142 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
6143   10x faster than the previous lookup tables.
6144 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
6145
6146 Usability
6147 ---------
6148
6149 * Many incremental improvements to documentation and rustdoc.
6150 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
6151 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
6152 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
6153 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
6154 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
6155 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
6156 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
6157
6158 Misc
6159 ----
6160
6161 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
6162 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
6163 * [`std` no longer prints backtraces on platforms where the running
6164   module must be loaded with `env::current_exe`, which can't be relied
6165   on](https://github.com/rust-lang/rust/pull/33554).
6166 * This release includes std binaries for the i586-unknown-linux-gnu,
6167   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
6168   i586 target is for old x86 hardware without SSE2, and the armv7
6169   target is for Android running on modern ARM architectures.
6170 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
6171   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
6172 * [On Unix the runtime aborts by calling `libc::abort` instead of
6173   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
6174 * [Rust is now bootstrapped from the previous release of Rust,
6175   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
6176
6177 Compatibility Notes
6178 -------------------
6179
6180 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
6181 * [`target_env` for Linux ARM targets is just `gnu`, not
6182   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
6183 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
6184 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
6185 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
6186   Affects how macros are parsed.
6187 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
6188 * [Feature-gated attributes on macro-generated macro invocations are
6189   now rejected](https://github.com/rust-lang/rust/pull/32791).
6190 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
6191   This caused some minor changes to type inference.
6192
6193
6194 Version 1.9.0 (2016-05-26)
6195 ==========================
6196
6197 Language
6198 --------
6199
6200 * The `#[deprecated]` attribute when applied to an API will generate
6201   warnings when used. The warnings may be suppressed with
6202   `#[allow(deprecated)]`. [RFC 1270].
6203 * [`fn` item types are zero sized, and each `fn` names a unique
6204   type][1.9fn]. This will break code that transmutes `fn`s, so calling
6205   `transmute` on a `fn` type will generate a warning for a few cycles,
6206   then will be converted to an error.
6207 * [Field and method resolution understand visibility, so private
6208   fields and methods cannot prevent the proper use of public fields
6209   and methods][1.9fv].
6210 * [The parser considers unicode codepoints in the
6211   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
6212
6213 Stabilized APIs
6214 ---------------
6215
6216 * [`std::panic`]
6217 * [`std::panic::catch_unwind`] (renamed from `recover`)
6218 * [`std::panic::resume_unwind`] (renamed from `propagate`)
6219 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
6220 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
6221 * [`str::is_char_boundary`]
6222 * [`<*const T>::as_ref`]
6223 * [`<*mut T>::as_ref`]
6224 * [`<*mut T>::as_mut`]
6225 * [`AsciiExt::make_ascii_uppercase`]
6226 * [`AsciiExt::make_ascii_lowercase`]
6227 * [`char::decode_utf16`]
6228 * [`char::DecodeUtf16`]
6229 * [`char::DecodeUtf16Error`]
6230 * [`char::DecodeUtf16Error::unpaired_surrogate`]
6231 * [`BTreeSet::take`]
6232 * [`BTreeSet::replace`]
6233 * [`BTreeSet::get`]
6234 * [`HashSet::take`]
6235 * [`HashSet::replace`]
6236 * [`HashSet::get`]
6237 * [`OsString::with_capacity`]
6238 * [`OsString::clear`]
6239 * [`OsString::capacity`]
6240 * [`OsString::reserve`]
6241 * [`OsString::reserve_exact`]
6242 * [`OsStr::is_empty`]
6243 * [`OsStr::len`]
6244 * [`std::os::unix::thread`]
6245 * [`RawPthread`]
6246 * [`JoinHandleExt`]
6247 * [`JoinHandleExt::as_pthread_t`]
6248 * [`JoinHandleExt::into_pthread_t`]
6249 * [`HashSet::hasher`]
6250 * [`HashMap::hasher`]
6251 * [`CommandExt::exec`]
6252 * [`File::try_clone`]
6253 * [`SocketAddr::set_ip`]
6254 * [`SocketAddr::set_port`]
6255 * [`SocketAddrV4::set_ip`]
6256 * [`SocketAddrV4::set_port`]
6257 * [`SocketAddrV6::set_ip`]
6258 * [`SocketAddrV6::set_port`]
6259 * [`SocketAddrV6::set_flowinfo`]
6260 * [`SocketAddrV6::set_scope_id`]
6261 * [`slice::copy_from_slice`]
6262 * [`ptr::read_volatile`]
6263 * [`ptr::write_volatile`]
6264 * [`OpenOptions::create_new`]
6265 * [`TcpStream::set_nodelay`]
6266 * [`TcpStream::nodelay`]
6267 * [`TcpStream::set_ttl`]
6268 * [`TcpStream::ttl`]
6269 * [`TcpStream::set_only_v6`]
6270 * [`TcpStream::only_v6`]
6271 * [`TcpStream::take_error`]
6272 * [`TcpStream::set_nonblocking`]
6273 * [`TcpListener::set_ttl`]
6274 * [`TcpListener::ttl`]
6275 * [`TcpListener::set_only_v6`]
6276 * [`TcpListener::only_v6`]
6277 * [`TcpListener::take_error`]
6278 * [`TcpListener::set_nonblocking`]
6279 * [`UdpSocket::set_broadcast`]
6280 * [`UdpSocket::broadcast`]
6281 * [`UdpSocket::set_multicast_loop_v4`]
6282 * [`UdpSocket::multicast_loop_v4`]
6283 * [`UdpSocket::set_multicast_ttl_v4`]
6284 * [`UdpSocket::multicast_ttl_v4`]
6285 * [`UdpSocket::set_multicast_loop_v6`]
6286 * [`UdpSocket::multicast_loop_v6`]
6287 * [`UdpSocket::set_multicast_ttl_v6`]
6288 * [`UdpSocket::multicast_ttl_v6`]
6289 * [`UdpSocket::set_ttl`]
6290 * [`UdpSocket::ttl`]
6291 * [`UdpSocket::set_only_v6`]
6292 * [`UdpSocket::only_v6`]
6293 * [`UdpSocket::join_multicast_v4`]
6294 * [`UdpSocket::join_multicast_v6`]
6295 * [`UdpSocket::leave_multicast_v4`]
6296 * [`UdpSocket::leave_multicast_v6`]
6297 * [`UdpSocket::take_error`]
6298 * [`UdpSocket::connect`]
6299 * [`UdpSocket::send`]
6300 * [`UdpSocket::recv`]
6301 * [`UdpSocket::set_nonblocking`]
6302
6303 Libraries
6304 ---------
6305
6306 * [`std::sync::Once` is poisoned if its initialization function
6307   fails][1.9o].
6308 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
6309 * [Most types implement `fmt::Debug`][1.9db].
6310 * [The default buffer size used by `BufReader` and `BufWriter` was
6311   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
6312   used by other languages.
6313 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
6314   `Duration` additionally implements `*=` and `/=`][1.9ta].
6315 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
6316 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
6317 * [`Chain` implements `BufRead`][1.9ch].
6318 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
6319
6320 Cargo
6321 -----
6322
6323 * [Cargo can now run concurrently][1.9cc].
6324 * [Top-level overrides allow specific revisions of crates to be
6325   overridden through the entire crate graph][1.9ct].  This is intended
6326   to make upgrades easier for large projects, by allowing crates to be
6327   forked temporarily until they've been upgraded and republished.
6328 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
6329 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
6330   on the commandline][1.9cf]. `rustc` arguments can also be specified
6331   in the `build.rustflags` configuration key.
6332
6333 Performance
6334 -----------
6335
6336 * [The time complexity of comparing variables for equivalence during type
6337   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
6338   to major compilation time improvement in some scenarios.
6339 * [`ToString` is specialized for `str`, giving it the same performance
6340   as `to_owned`][1.9ts].
6341 * [Spawning processes with `Command::output` no longer creates extra
6342   threads][1.9sp].
6343 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
6344   for C-like enums][1.9cl].
6345
6346 Misc
6347 ----
6348
6349 * [Passing the `--quiet` flag to a test runner will produce
6350   much-abbreviated output][1.9q].
6351 * The Rust Project now publishes std binaries for the
6352   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
6353   `i586-pc-windows-msvc` targets.
6354
6355 Compatibility Notes
6356 -------------------
6357
6358 * [`std::sync::Once` is poisoned if its initialization function
6359   fails][1.9o].
6360 * [It is illegal to define methods with the same name in overlapping
6361   inherent `impl` blocks][1.9sn].
6362 * [`fn` item types are zero sized, and each `fn` names a unique
6363   type][1.9fn]. This will break code that transmutes `fn`s, so calling
6364   `transmute` on a `fn` type will generate a warning for a few cycles,
6365   then will be converted to an error.
6366 * [Improvements to const evaluation may trigger new errors when integer
6367   literals are out of range][1.9ce].
6368
6369
6370 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
6371 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
6372 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
6373 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
6374 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
6375 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
6376 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
6377 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
6378 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
6379 [1.9db]: https://github.com/rust-lang/rust/pull/32054
6380 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
6381 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
6382 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
6383 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
6384 [1.9o]: https://github.com/rust-lang/rust/pull/32325
6385 [1.9q]: https://github.com/rust-lang/rust/pull/31887
6386 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
6387 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
6388 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
6389 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
6390 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
6391 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
6392 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
6393 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
6394 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6395 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
6396 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6397 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
6398 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
6399 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
6400 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
6401 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
6402 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
6403 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
6404 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
6405 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
6406 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
6407 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
6408 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
6409 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
6410 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
6411 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
6412 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
6413 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
6414 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
6415 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
6416 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
6417 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
6418 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
6419 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
6420 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
6421 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
6422 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
6423 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
6424 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
6425 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
6426 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
6427 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
6428 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
6429 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
6430 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6431 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6432 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6433 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6434 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6435 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6436 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
6437 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6438 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
6439 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6440 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6441 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6442 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6443 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6444 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
6445 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
6446 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
6447 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
6448 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
6449 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
6450 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
6451 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
6452 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
6453 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
6454 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
6455 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
6456 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
6457 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
6458 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
6459 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
6460 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
6461 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
6462 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
6463 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
6464 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
6465 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
6466 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
6467 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
6468 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
6469 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
6470 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
6471 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
6472 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
6473 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
6474 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
6475 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
6476 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
6477 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
6478 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
6479 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
6480
6481
6482 Version 1.8.0 (2016-04-14)
6483 ==========================
6484
6485 Language
6486 --------
6487
6488 * Rust supports overloading of compound assignment statements like
6489   `+=` by implementing the [`AddAssign`], [`SubAssign`],
6490   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
6491   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
6492   traits. [RFC 953].
6493 * Empty structs can be defined with braces, as in `struct Foo { }`, in
6494   addition to the non-braced form, `struct Foo;`. [RFC 218].
6495
6496 Libraries
6497 ---------
6498
6499 * Stabilized APIs:
6500   * [`str::encode_utf16`] (renamed from `utf16_units`)
6501   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
6502   * [`Ref::map`]
6503   * [`RefMut::map`]
6504   * [`ptr::drop_in_place`]
6505   * [`time::Instant`]
6506   * [`time::SystemTime`]
6507   * [`Instant::now`]
6508   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
6509   * [`Instant::elapsed`]
6510   * [`SystemTime::now`]
6511   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
6512   * [`SystemTime::elapsed`]
6513   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
6514   * [`SystemTimeError`]
6515   * [`SystemTimeError::duration`]
6516   * Various impls for `SystemTimeError`
6517   * [`UNIX_EPOCH`]
6518   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
6519     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
6520     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
6521 * [The `write!` and `writeln!` macros correctly emit errors if any of
6522   their arguments can't be formatted][1.8w].
6523 * [Various I/O functions support large files on 32-bit Linux][1.8l].
6524 * [The Unix-specific `raw` modules, which contain a number of
6525   redefined C types are deprecated][1.8r], including `os::raw::unix`,
6526   `os::raw::macos`, and `os::raw::linux`. These modules defined types
6527   such as `ino_t` and `dev_t`. The inconsistency of these definitions
6528   across platforms was making it difficult to implement `std`
6529   correctly. Those that need these definitions should use the `libc`
6530   crate. [RFC 1415].
6531 * The Unix-specific `MetadataExt` traits, including
6532   `os::unix::fs::MetadataExt`, which expose values such as inode
6533   numbers [no longer return platform-specific types][1.8r], but
6534   instead return widened integers. [RFC 1415].
6535 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
6536 * [Atomic loads and stores are not volatile][1.8a].
6537 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
6538
6539 Performance
6540 -----------
6541
6542 * [Inlining hash functions lead to a 3% compile-time improvement in
6543   some workloads][1.8h].
6544 * When using jemalloc, its symbols are [unprefixed so that it
6545   overrides the libc malloc implementation][1.8h]. This means that for
6546   rustc, LLVM is now using jemalloc, which results in a 6%
6547   compile-time improvement on a specific workload.
6548 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
6549
6550 Misc
6551 ----
6552
6553 * [32-bit MSVC builds finally implement unwinding][1.8ms].
6554   i686-pc-windows-msvc is now considered a tier-1 platform.
6555 * [The `--print targets` flag prints a list of supported targets][1.8t].
6556 * [The `--print cfg` flag prints the `cfg`s defined for the current
6557   target][1.8cf].
6558 * [`rustc` can be built with an new Cargo-based build system, written
6559   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
6560   build system. To enable it configure with `configure --rustbuild`.
6561 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
6562   variants while also indicating the total number of missing variants
6563   if more than 3][1.8m].
6564 * [Executable stacks are disabled on Linux and BSD][1.8nx].
6565 * The Rust Project now publishes binary releases of the standard
6566   library for a number of tier-2 targets:
6567   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
6568   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
6569   `x86_64-rumprun-netbsd`. These can be installed with
6570   tools such as [multirust][1.8mr].
6571
6572 Cargo
6573 -----
6574
6575 * [`cargo init` creates a new Cargo project in the current
6576   directory][1.8ci].  It is otherwise like `cargo new`.
6577 * [Cargo has configuration keys for `-v` and
6578   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
6579   `[term]` section of `.cargo/config`.
6580 * [Configuration keys that evaluate to strings or integers can be set
6581   via environment variables][1.8ce]. For example the `build.jobs` key
6582   can be set via `CARGO_BUILD_JOBS`. Environment variables take
6583   precedence over config files.
6584 * [Target-specific dependencies support Rust `cfg` syntax for
6585   describing targets][1.8cfg] so that dependencies for multiple
6586   targets can be specified together. [RFC 1361].
6587 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
6588   `RUSTDOC` take precedence over the `build.target-dir`,
6589   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
6590 * [The child process tree is killed on Windows when Cargo is
6591   killed][1.8ck].
6592 * [The `build.target` configuration value sets the target platform,
6593   like `--target`][1.8ct].
6594
6595 Compatibility Notes
6596 -------------------
6597
6598 * [Unstable compiler flags have been further restricted][1.8u]. Since
6599   1.0 `-Z` flags have been considered unstable, and other flags that
6600   were considered unstable additionally required passing `-Z
6601   unstable-options` to access. Unlike unstable language and library
6602   features though, these options have been accessible on the stable
6603   release channel. Going forward, *new unstable flags will not be
6604   available on the stable release channel*, and old unstable flags
6605   will warn about their usage. In the future, all unstable flags will
6606   be unavailable on the stable release channel.
6607 * [It is no longer possible to `match` on empty enum variants using
6608   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
6609 * The Unix-specific `MetadataExt` traits, including
6610   `os::unix::fs::MetadataExt`, which expose values such as inode
6611   numbers [no longer return platform-specific types][1.8r], but
6612   instead return widened integers. [RFC 1415].
6613 * [Modules sourced from the filesystem cannot appear within arbitrary
6614   blocks, but only within other modules][1.8mf].
6615 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
6616 * On Unix, [stack overflow triggers a runtime abort instead of a
6617   SIGSEGV][1.8so].
6618 * [`Command::spawn` and its equivalents return an error if any of
6619   its command-line arguments contain interior `NUL`s][1.8n].
6620 * [Tuple and unit enum variants from other crates are in the type
6621   namespace][1.8tn].
6622 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
6623   type instead of `.a` files][1.8st]. Additionally, for the MSVC
6624   toolchain, `rustc` emits import libraries named `foo.dll.lib`
6625   instead of `foo.lib`.
6626
6627
6628 [1.8a]: https://github.com/rust-lang/rust/pull/30962
6629 [1.8b]: https://github.com/rust-lang/rust/pull/31123
6630 [1.8c]: https://github.com/rust-lang/rust/pull/31530
6631 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
6632 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
6633 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
6634 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
6635 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
6636 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
6637 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
6638 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
6639 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
6640 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
6641 [1.8h]: https://github.com/rust-lang/rust/pull/31460
6642 [1.8l]: https://github.com/rust-lang/rust/pull/31668
6643 [1.8m]: https://github.com/rust-lang/rust/pull/31020
6644 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
6645 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
6646 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
6647 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
6648 [1.8n]: https://github.com/rust-lang/rust/pull/31056
6649 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
6650 [1.8r]: https://github.com/rust-lang/rust/pull/31551
6651 [1.8so]: https://github.com/rust-lang/rust/pull/31333
6652 [1.8st]: https://github.com/rust-lang/rust/pull/29520
6653 [1.8t]: https://github.com/rust-lang/rust/pull/31358
6654 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
6655 [1.8u]: https://github.com/rust-lang/rust/pull/31793
6656 [1.8v]: https://github.com/rust-lang/rust/pull/31757
6657 [1.8w]: https://github.com/rust-lang/rust/pull/31904
6658 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
6659 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
6660 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
6661 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
6662 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
6663 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
6664 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
6665 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
6666 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
6667 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
6668 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
6669 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
6670 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
6671 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
6672 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
6673 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
6674 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
6675 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
6676 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
6677 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
6678 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
6679 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
6680 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
6681 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
6682 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
6683 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
6684 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
6685 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
6686 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
6687 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
6688
6689
6690 Version 1.7.0 (2016-03-03)
6691 ==========================
6692
6693 Libraries
6694 ---------
6695
6696 * Stabilized APIs
6697   * `Path`
6698     * [`Path::strip_prefix`] (renamed from relative_from)
6699     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
6700   * `Ipv4Addr`
6701     * [`Ipv4Addr::is_loopback`]
6702     * [`Ipv4Addr::is_private`]
6703     * [`Ipv4Addr::is_link_local`]
6704     * [`Ipv4Addr::is_multicast`]
6705     * [`Ipv4Addr::is_broadcast`]
6706     * [`Ipv4Addr::is_documentation`]
6707   * `Ipv6Addr`
6708     * [`Ipv6Addr::is_unspecified`]
6709     * [`Ipv6Addr::is_loopback`]
6710     * [`Ipv6Addr::is_multicast`]
6711   * `Vec`
6712     * [`Vec::as_slice`]
6713     * [`Vec::as_mut_slice`]
6714   * `String`
6715     * [`String::as_str`]
6716     * [`String::as_mut_str`]
6717   * Slices
6718     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
6719     be the same length
6720     * `<[T]>::`[`sort_by_key`]
6721   * checked, saturated, and overflowing operations
6722     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
6723     * [`i32::saturating_mul`]
6724     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
6725     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
6726     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
6727     * [`u32::saturating_mul`]
6728     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
6729     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
6730     * and checked, saturated, and overflowing operations for other primitive types
6731   * FFI
6732     * [`ffi::IntoStringError`]
6733     * [`CString::into_string`]
6734     * [`CString::into_bytes`]
6735     * [`CString::into_bytes_with_nul`]
6736     * `From<CString> for Vec<u8>`
6737   * `IntoStringError`
6738     * [`IntoStringError::into_cstring`]
6739     * [`IntoStringError::utf8_error`]
6740     * `Error for IntoStringError`
6741   * Hashing
6742     * [`std::hash::BuildHasher`]
6743     * [`BuildHasher::Hasher`]
6744     * [`BuildHasher::build_hasher`]
6745     * [`std::hash::BuildHasherDefault`]
6746     * [`HashMap::with_hasher`]
6747     * [`HashMap::with_capacity_and_hasher`]
6748     * [`HashSet::with_hasher`]
6749     * [`HashSet::with_capacity_and_hasher`]
6750     * [`std::collections::hash_map::RandomState`]
6751     * [`RandomState::new`]
6752 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
6753   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
6754   from bytes is faster.
6755 * [The performance of `LineWriter` (and thus `io::stdout`) was
6756   improved by using `memchr` to search for newlines][1.7m].
6757 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
6758   `f64` variants were stabilized previously.
6759 * [`BTreeMap` was rewritten to use less memory and improve the performance
6760   of insertion and iteration, the latter by as much as 5x][1.7bm].
6761 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
6762   covariant over their contained type][1.7bt].
6763 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
6764   over their contained type][1.7ll].
6765 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
6766   searching methods.
6767 * [`Any` is implemented for unsized types][1.7a].
6768 * [`Hash` is implemented for `Duration`][1.7h].
6769
6770 Misc
6771 ----
6772
6773 * [When running tests with `--test`, rustdoc will pass `--cfg`
6774   arguments to the compiler][1.7dt].
6775 * [The compiler is built with RPATH information by default][1.7rpa].
6776   This means that it will be possible to run `rustc` when installed in
6777   unusual configurations without configuring the dynamic linker search
6778   path explicitly.
6779 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
6780   any RPATH entries (emitted with `-C rpath`) *not* take precedence
6781   over `LD_LIBRARY_PATH`.
6782
6783 Cargo
6784 -----
6785
6786 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
6787   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
6788 * [The `rerun-if-changed` build script directive no longer causes the
6789   build script to incorrectly run twice in certain scenarios][1.7rr].
6790
6791 Compatibility Notes
6792 -------------------
6793
6794 * Soundness fixes to the interactions between associated types and
6795   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
6796   code that violates the new rules. This is a significant change that
6797   is known to break existing code, so it has emitted warnings for the
6798   new error cases since 1.4 to give crate authors time to adapt. The
6799   details of what is changing are subtle; read the RFC for more.
6800 * [Several bugs in the compiler's visibility calculations were
6801   fixed][1.7v]. Since this was found to break significant amounts of
6802   code, the new errors will be emitted as warnings for several release
6803   cycles, under the `private_in_public` lint.
6804 * Defaulted type parameters were accidentally accepted in positions
6805   that were not intended. In this release, [defaulted type parameters
6806   appearing outside of type definitions will generate a
6807   warning][1.7d], which will become an error in future releases.
6808 * [Parsing "." as a float results in an error instead of 0][1.7p].
6809   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
6810 * [Borrows of closure parameters may not outlive the closure][1.7bc].
6811
6812 [1.7a]: https://github.com/rust-lang/rust/pull/30928
6813 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
6814 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
6815 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
6816 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
6817 [1.7d]: https://github.com/rust-lang/rust/pull/30724
6818 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
6819 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
6820 [1.7f]: https://github.com/rust-lang/rust/pull/30672
6821 [1.7h]: https://github.com/rust-lang/rust/pull/30818
6822 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
6823 [1.7m]: https://github.com/rust-lang/rust/pull/30381
6824 [1.7p]: https://github.com/rust-lang/rust/pull/30681
6825 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
6826 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
6827 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
6828 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
6829 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
6830 [1.7v]: https://github.com/rust-lang/rust/pull/29973
6831 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6832 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6833 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
6834 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
6835 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
6836 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
6837 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
6838 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
6839 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
6840 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
6841 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
6842 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
6843 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
6844 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
6845 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
6846 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
6847 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
6848 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
6849 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
6850 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
6851 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
6852 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
6853 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
6854 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
6855 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
6856 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
6857 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
6858 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
6859 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
6860 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
6861 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
6862 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
6863 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
6864 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
6865 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
6866 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
6867 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
6868 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
6869 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
6870 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
6871 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
6872 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
6873 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
6874 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
6875 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
6876 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
6877 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
6878 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6879 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
6880 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6881 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
6882 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
6883 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
6884 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
6885 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
6886 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
6887 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
6888 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
6889 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
6890 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
6891
6892
6893 Version 1.6.0 (2016-01-21)
6894 ==========================
6895
6896 Language
6897 --------
6898
6899 * The `#![no_std]` attribute causes a crate to not be linked to the
6900   standard library, but only the [core library][1.6co], as described
6901   in [RFC 1184]. The core library defines common types and traits but
6902   has no platform dependencies whatsoever, and is the basis for Rust
6903   software in environments that cannot support a full port of the
6904   standard library, such as operating systems. Most of the core
6905   library is now stable.
6906
6907 Libraries
6908 ---------
6909
6910 * Stabilized APIs:
6911   [`Read::read_exact`],
6912   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
6913   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
6914   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
6915   [`os::unix::fs::DirBuilderExt`],
6916   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
6917   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
6918   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
6919   [`collections::hash_map::Drain`],
6920   [`collections::hash_map::HashMap::drain`],
6921   [`collections::hash_set::Drain`],
6922   [`collections::hash_set::HashSet::drain`],
6923   [`collections::binary_heap::Drain`],
6924   [`collections::binary_heap::BinaryHeap::drain`],
6925   [`Vec::extend_from_slice`] (renamed from `push_all`),
6926   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
6927   [`RwLock::into_inner`],
6928   [`Iterator::min_by_key`] (renamed from `min_by`),
6929   [`Iterator::max_by_key`] (renamed from `max_by`).
6930 * The [core library][1.6co] is stable, as are most of its APIs.
6931 * [The `assert_eq!` macro supports arguments that don't implement
6932   `Sized`][1.6ae], such as arrays. In this way it behaves more like
6933   `assert!`.
6934 * Several timer functions that take duration in milliseconds [are
6935   deprecated in favor of those that take `Duration`][1.6ms]. These
6936   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
6937   `thread::park_timeout_ms`.
6938 * The algorithm by which `Vec` reserves additional elements was
6939   [tweaked to not allocate excessive space][1.6a] while still growing
6940   exponentially.
6941 * `From` conversions are [implemented from integers to floats][1.6f]
6942   in cases where the conversion is lossless. Thus they are not
6943   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
6944   or `f64`. They are also not implemented for `isize` and `usize`
6945   because the implementations would be platform-specific. `From` is
6946   also implemented from `f32` to `f64`.
6947 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
6948 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
6949 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
6950 * [`BinaryHeap` was refactored][1.6bh] for modest performance
6951   improvements.
6952 * Sorting slices that are already sorted [is 50% faster in some
6953   cases][1.6s].
6954
6955 Cargo
6956 -----
6957
6958 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
6959 * Cargo build scripts can specify their dependencies by emitting the
6960   [`rerun-if-changed`][1.6rr] key.
6961 * crates.io will reject publication of crates with dependencies that
6962   have a wildcard version constraint. Crates with wildcard
6963   dependencies were seen to cause a variety of problems, as described
6964   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
6965   warning.
6966 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
6967   release folder.  A variety of artifacts that Cargo failed to clean
6968   are now correctly deleted.
6969
6970 Misc
6971 ----
6972
6973 * The `unreachable_code` lint [warns when a function call's argument
6974   diverges][1.6dv].
6975 * The parser indicates [failures that may be caused by
6976   confusingly-similar Unicode characters][1.6uc]
6977 * Certain macro errors [are reported at definition time][1.6m], not
6978   expansion.
6979
6980 Compatibility Notes
6981 -------------------
6982
6983 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
6984   environment variable when locating crates. This was a pre-cargo
6985   feature for integrating with the package manager that was
6986   accidentally never removed.
6987 * [A number of bugs were fixed in the privacy checker][1.6p] that
6988   could cause previously-accepted code to break.
6989 * [Modules and unit/tuple structs may not share the same name][1.6ts].
6990 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
6991   struct pattern syntax (`Foo(..)`) can no longer be used to match
6992   unit structs. This is a warning now, but will become an error in
6993   future releases. Patterns that share the same name as a const are
6994   now an error.
6995 * A bug was fixed that causes [rustc not to apply default type
6996   parameters][1.6xc] when resolving certain method implementations of
6997   traits defined in other crates.
6998
6999 [1.6a]: https://github.com/rust-lang/rust/pull/29454
7000 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
7001 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
7002 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
7003 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
7004 [1.6co]: http://doc.rust-lang.org/core/index.html
7005 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
7006 [1.6f]: https://github.com/rust-lang/rust/pull/29129
7007 [1.6m]: https://github.com/rust-lang/rust/pull/29828
7008 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
7009 [1.6p]: https://github.com/rust-lang/rust/pull/29726
7010 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
7011 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
7012 [1.6s]: https://github.com/rust-lang/rust/pull/29675
7013 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
7014 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
7015 [1.6us]: https://github.com/rust-lang/rust/pull/29383
7016 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
7017 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
7018 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7019 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
7020 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
7021 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
7022 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
7023 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
7024 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
7025 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
7026 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
7027 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
7028 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
7029 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
7030 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
7031 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
7032 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
7033 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
7034 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
7035 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
7036 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
7037 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
7038 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
7039 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
7040 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
7041 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
7042 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
7043 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
7044 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
7045 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
7046
7047
7048 Version 1.5.0 (2015-12-10)
7049 ==========================
7050
7051 * ~700 changes, numerous bugfixes
7052
7053 Highlights
7054 ----------
7055
7056 * Stabilized APIs:
7057   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
7058   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
7059   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
7060   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
7061   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
7062   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
7063   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
7064   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
7065   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
7066   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
7067   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
7068   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
7069   [`Path::read_link`], [`Path::symlink_metadata`],
7070   [`Utf8Error::valid_up_to`], [`Vec::resize`],
7071   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
7072   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
7073   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
7074   [`slice::split_first_mut`], [`slice::split_first`],
7075   [`slice::split_last_mut`], [`slice::split_last`],
7076   [`char::from_u32_unchecked`], [`fs::canonicalize`],
7077   [`str::MatchIndices`], [`str::RMatchIndices`],
7078   [`str::match_indices`], [`str::rmatch_indices`],
7079   [`str::slice_mut_unchecked`], [`string::ParseError`].
7080 * Rust applications hosted on crates.io can be installed locally to
7081   `~/.cargo/bin` with the [`cargo install`] command. Among other
7082   things this makes it easier to augment Cargo with new subcommands:
7083   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
7084   invoked as `cargo foo`.
7085 * Crates with wildcard (`*`) dependencies will [emit warnings when
7086   published][1.5w]. In 1.6 it will no longer be possible to publish
7087   crates with wildcard dependencies.
7088
7089 Breaking Changes
7090 ----------------
7091
7092 * The rules determining when a particular lifetime must outlive
7093   a particular value (known as '[dropck]') have been [modified
7094   to not rely on parametricity][1.5p].
7095 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
7096   and `Arc`][1.5a]. Because these smart pointer types implement
7097   `Deref`, this causes breakage in cases where the interior type
7098   contains methods of the same name.
7099 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
7100   that they could drop their content. Soundness fix.
7101 * All method invocations are [properly checked][1.5wf1] for
7102   [well-formedness][1.5wf2]. Soundness fix.
7103 * Traits whose supertraits contain `Self` are [not object
7104   safe][1.5o]. Soundness fix.
7105 * Target specifications support a [`no_default_libraries`][1.5nd]
7106   setting that controls whether `-nodefaultlibs` is passed to the
7107   linker, and in turn the `is_like_windows` setting no longer affects
7108   the `-nodefaultlibs` flag.
7109 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
7110 * The `#[inline]` and `#[repr]` attributes [can only appear
7111   in valid locations][1.5at].
7112 * Native libraries linked from the local crate are [passed to
7113   the linker before native libraries from upstream crates][1.5nl].
7114 * Two rarely-used attributes, `#[no_debug]` and
7115   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
7116 * Negation of unsigned integers, which has been a warning for
7117   several releases, [is now behind a feature gate and will
7118   generate errors][1.5nu].
7119 * The parser accidentally accepted visibility modifiers on
7120   enum variants, a bug [which has been fixed][1.5ev].
7121 * [A bug was fixed that allowed `use` statements to import unstable
7122   features][1.5use].
7123
7124 Language
7125 --------
7126
7127 * When evaluating expressions at compile-time that are not
7128   compile-time constants (const-evaluating expressions in non-const
7129   contexts), incorrect code such as overlong bitshifts and arithmetic
7130   overflow will [generate a warning instead of an error][1.5ce],
7131   delaying the error until runtime. This will allow the
7132   const-evaluator to be expanded in the future backwards-compatibly.
7133 * The `improper_ctypes` lint [no longer warns about using `isize` and
7134   `usize` in FFI][1.5ict].
7135
7136 Libraries
7137 ---------
7138
7139 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
7140   invariant][1.5c].
7141 * `Default` is [implemented for mutable slices][1.5d].
7142 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
7143 * There are now `From` conversions [between floating point
7144   types][1.5f] where the conversions are lossless.
7145 * There are now `From` conversions [between integer types][1.5i] where
7146   the conversions are lossless.
7147 * [`fs::Metadata` implements `Clone`][1.5fs].
7148 * The `parse` method [accepts a leading "+" when parsing
7149   integers][1.5pi].
7150 * [`AsMut` is implemented for `Vec`][1.5am].
7151 * The `clone_from` implementations for `String` and `BinaryHeap` [have
7152   been optimized][1.5cf] and no longer rely on the default impl.
7153 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
7154   `unsafe extern "C"` function types now [implement `Clone`,
7155   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
7156   `fmt::Debug` for up to 12 arguments][1.5fp].
7157 * [Dropping `Vec`s is much faster in unoptimized builds when the
7158   element types don't implement `Drop`][1.5dv].
7159 * A bug that caused in incorrect behavior when [combining `VecDeque`
7160   with zero-sized types][1.5vdz] was resolved.
7161 * [`PartialOrd` for slices is faster][1.5po].
7162
7163 Miscellaneous
7164 -------------
7165
7166 * [Crate metadata size was reduced by 20%][1.5md].
7167 * [Improvements to code generation reduced the size of libcore by 3.3
7168   MB and rustc's memory usage by 18MB][1.5m].
7169 * [Improvements to deref translation increased performance in
7170   unoptimized builds][1.5dr].
7171 * Various errors in trait resolution [are deduplicated to only be
7172   reported once][1.5te].
7173 * Rust has preliminary [support for rumprun kernels][1.5rr].
7174 * Rust has preliminary [support for NetBSD on amd64][1.5na].
7175
7176 [1.5use]: https://github.com/rust-lang/rust/pull/28364
7177 [1.5po]: https://github.com/rust-lang/rust/pull/28436
7178 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
7179 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
7180 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
7181 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
7182 [1.5md]: https://github.com/rust-lang/rust/pull/28521
7183 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
7184 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
7185 [1.5na]: https://github.com/rust-lang/rust/pull/28543
7186 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
7187 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
7188 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
7189 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
7190 [1.5te]: https://github.com/rust-lang/rust/pull/28645
7191 [1.5at]: https://github.com/rust-lang/rust/pull/28650
7192 [1.5am]: https://github.com/rust-lang/rust/pull/28663
7193 [1.5m]: https://github.com/rust-lang/rust/pull/28778
7194 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
7195 [1.5a]: https://github.com/rust-lang/rust/pull/28811
7196 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
7197 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
7198 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
7199 [1.5i]: https://github.com/rust-lang/rust/pull/28921
7200 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
7201 [1.5f]: https://github.com/rust-lang/rust/pull/29129
7202 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
7203 [1.5s]: https://github.com/rust-lang/rust/pull/29190
7204 [1.5d]: https://github.com/rust-lang/rust/pull/29245
7205 [1.5o]: https://github.com/rust-lang/rust/pull/29259
7206 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
7207 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7208 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
7209 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
7210 [1.5c]: https://github.com/rust-lang/rust/pull/29110
7211 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7212 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
7213 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
7214 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
7215 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
7216 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
7217 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
7218 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
7219 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
7220 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
7221 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
7222 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
7223 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
7224 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
7225 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
7226 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
7227 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
7228 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
7229 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
7230 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
7231 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
7232 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
7233 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
7234 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
7235 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
7236 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
7237 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
7238 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
7239 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
7240 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
7241 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
7242 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
7243 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
7244 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
7245 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
7246 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
7247 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
7248 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
7249 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
7250 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
7251 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
7252 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
7253 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
7254 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
7255 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
7256 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
7257 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
7258 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
7259 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
7260 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
7261 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
7262 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
7263 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
7264 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
7265
7266 Version 1.4.0 (2015-10-29)
7267 ==========================
7268
7269 * ~1200 changes, numerous bugfixes
7270
7271 Highlights
7272 ----------
7273
7274 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
7275   GNU) are now supported and recommended for use.
7276
7277 Breaking Changes
7278 ----------------
7279
7280 * [Several changes have been made to fix type soundness and improve
7281   the behavior of associated types][sound]. See [RFC 1214]. Although
7282   we have mostly introduced these changes as warnings this release, to
7283   become errors next release, there are still some scenarios that will
7284   see immediate breakage.
7285 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
7286   line breaks in addition to `\n`][crlf].
7287 * [Loans of `'static` lifetime extend to the end of a function][stat].
7288 * [`str::parse` no longer introduces avoidable rounding error when
7289   parsing floating point numbers. Together with earlier changes to
7290   float formatting/output, "round trips" like f.to_string().parse()
7291   now preserve the value of f exactly. Additionally, leading plus
7292   signs are now accepted][fp3].
7293
7294
7295 Language
7296 --------
7297
7298 * `use` statements that import multiple items [can now rename
7299   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
7300 * [Binops work correctly on fat pointers][binfat].
7301 * `pub extern crate`, which does not behave as expected, [issues a
7302   warning][pec] until a better solution is found.
7303
7304 Libraries
7305 ---------
7306
7307 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
7308   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
7309   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
7310   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
7311   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
7312   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
7313   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
7314   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
7315   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
7316   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
7317   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
7318   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
7319   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
7320   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
7321   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
7322   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
7323   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
7324   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
7325   [`thread::sleep`].
7326 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
7327   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
7328   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
7329   `f64::from_str_radix`.
7330 * [Reverse-searching strings is faster with the 'two-way'
7331   algorithm][s].
7332 * [`std::io::copy` allows `?Sized` arguments][cc].
7333 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
7334   [override `count`, `nth` and `last` with an O(1)
7335   implementation][it].
7336 * [`Default` is implemented for arrays up to `[T; 32]`][d].
7337 * [`IntoRawFd` has been added to the Unix-specific prelude,
7338   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
7339   prelude][pr].
7340 * [`Extend<String>` and `FromIterator<String` are both implemented for
7341   `String`][es].
7342 * [`IntoIterator` is implemented for references to `Option` and
7343   `Result`][into2].
7344 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
7345   Copy`][ext] as part of [RFC 839]. This will cause type inference
7346   breakage in rare situations.
7347 * [`BinaryHeap` implements `Debug`][bh2].
7348 * [`Borrow` and `BorrowMut` are implemented for fixed-size
7349   arrays][bm].
7350 * [`extern fn`s with the "Rust" and "C" ABIs implement common
7351   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
7352 * [String comparison is faster][faststr].
7353 * `&mut T` where `T: std::fmt::Write` [also implements
7354   `std::fmt::Write`][mutw].
7355 * [A stable regression in `VecDeque::push_back` and other
7356   capacity-altering methods that caused panics for zero-sized types
7357   was fixed][vd].
7358 * [Function pointers implement traits for up to 12 parameters][fp2].
7359
7360 Miscellaneous
7361 -------------
7362
7363 * The compiler [no longer uses the 'morestack' feature to prevent
7364   stack overflow][mm]. Instead it uses guard pages and stack
7365   probes (though stack probes are not yet implemented on any platform
7366   but Windows).
7367 * [The compiler matches traits faster when projections are involved][p].
7368 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
7369   `usize`][ffi].
7370 * [Cargo now displays useful information about what its doing during
7371   `cargo update`][cu].
7372
7373 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
7374 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
7375 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
7376 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
7377 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
7378 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
7379 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
7380 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
7381 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
7382 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
7383 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
7384 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
7385 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
7386 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
7387 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
7388 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
7389 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
7390 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
7391 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7392 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7393 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7394 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7395 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7396 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7397 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7398 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7399 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
7400 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
7401 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
7402 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
7403 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
7404 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
7405 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
7406 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
7407 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
7408 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
7409 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
7410 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
7411 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
7412 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
7413 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
7414 [bh2]: https://github.com/rust-lang/rust/pull/28156
7415 [binfat]: https://github.com/rust-lang/rust/pull/28270
7416 [bm]: https://github.com/rust-lang/rust/pull/28197
7417 [cc]: https://github.com/rust-lang/rust/pull/27531
7418 [crlf]: https://github.com/rust-lang/rust/pull/28034
7419 [cu]: https://github.com/rust-lang/cargo/pull/1931
7420 [d]: https://github.com/rust-lang/rust/pull/27825
7421 [dep]: https://github.com/rust-lang/rust/pull/28339
7422 [es]: https://github.com/rust-lang/rust/pull/27956
7423 [ext]: https://github.com/rust-lang/rust/pull/28094
7424 [faststr]: https://github.com/rust-lang/rust/pull/28338
7425 [ffi]: https://github.com/rust-lang/rust/pull/28779
7426 [fp]: https://github.com/rust-lang/rust/pull/28268
7427 [fp2]: https://github.com/rust-lang/rust/pull/28560
7428 [fp3]: https://github.com/rust-lang/rust/pull/27307
7429 [i]: https://github.com/rust-lang/rust/pull/27451
7430 [into2]: https://github.com/rust-lang/rust/pull/28039
7431 [it]: https://github.com/rust-lang/rust/pull/27652
7432 [mm]: https://github.com/rust-lang/rust/pull/27338
7433 [mutw]: https://github.com/rust-lang/rust/pull/28368
7434 [sound]: https://github.com/rust-lang/rust/pull/27641
7435 [p]: https://github.com/rust-lang/rust/pull/27866
7436 [pec]: https://github.com/rust-lang/rust/pull/28486
7437 [pr]: https://github.com/rust-lang/rust/pull/27896
7438 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7439 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7440 [s]: https://github.com/rust-lang/rust/pull/27474
7441 [stab]: https://github.com/rust-lang/rust/pull/28339
7442 [stat]: https://github.com/rust-lang/rust/pull/28321
7443 [vd]: https://github.com/rust-lang/rust/pull/28494
7444
7445 Version 1.3.0 (2015-09-17)
7446 ==============================
7447
7448 * ~900 changes, numerous bugfixes
7449
7450 Highlights
7451 ----------
7452
7453 * The [new object lifetime defaults][nold] have been [turned
7454   on][nold2] after a cycle of warnings about the change. Now types
7455   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
7456   being interpreted as `&'a Box<Trait+'a>` to `&'a
7457   Box<Trait+'static>`.
7458 * [The Rustonomicon][nom] is a new book in the official documentation
7459   that dives into writing unsafe Rust.
7460 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
7461   timekeeping is employed by other std APIs, as well as out-of-tree
7462   time crates.
7463
7464 Breaking Changes
7465 ----------------
7466
7467 * The [new object lifetime defaults][nold] have been [turned
7468   on][nold2] after a cycle of warnings about the change.
7469 * There is a known [regression][lr] in how object lifetime elision is
7470   interpreted, the proper solution for which is undetermined.
7471 * The `#[prelude_import]` attribute, an internal implementation
7472   detail, was accidentally stabilized previously. [It has been put
7473   behind the `prelude_import` feature gate][pi]. This change is
7474   believed to break no existing code.
7475 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7476   [more sane for dynamically sized types][dst3]. Code that relied on
7477   the previous behavior is thought to be broken.
7478 * The `dropck` rules, which checks that destructors can't access
7479   destroyed values, [have been updated][dropck] to match the
7480   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
7481   cause some previously-compiling code to no longer build.
7482
7483 Language
7484 --------
7485
7486 * The [new object lifetime defaults][nold] have been [turned
7487   on][nold2] after a cycle of warnings about the change.
7488 * Semicolons may [now follow types and paths in
7489   macros](https://github.com/rust-lang/rust/pull/27000).
7490 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7491   [more sane for dynamically sized types][dst3]. Code that relied on
7492   the previous behavior is not known to exist, and suspected to be
7493   broken.
7494 * `'static` variables [may now be recursive][st].
7495 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
7496   implementations correctly.
7497 * The `dropck` rules, which checks that destructors can't access
7498   destroyed values, [have been updated][dropck] to match the
7499   [RFC][dropckrfc].
7500
7501 Libraries
7502 ---------
7503
7504 * The [`Duration`] API, [has been stabilized][ds], as well as the
7505   `std::time` module, which presently contains only `Duration`.
7506 * `Box<str>` and `Box<[T]>` both implement `Clone`.
7507 * The owned C string, [`CString`], implements [`Borrow`] and the
7508   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
7509   these allow C strings to be borrowed and cloned in generic code.
7510 * [`CStr`] implements [`Debug`].
7511 * [`AtomicPtr`] implements [`Debug`].
7512 * [`Error`] trait objects [can be downcast to their concrete types][e]
7513   in many common configurations, using the [`is`], [`downcast`],
7514   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
7515   [`Any`] trait.
7516 * Searching for substrings now [employs the two-way algorithm][search]
7517   instead of doing a naive search. This gives major speedups to a
7518   number of methods, including [`contains`][sc], [`find`][sf],
7519   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
7520   [`ends_with`][sew] are also faster.
7521 * The performance of `PartialEq` for slices is [much faster][ps].
7522 * The [`Hash`] trait offers the default method, [`hash_slice`], which
7523   is overridden and optimized by the implementations for scalars.
7524 * The [`Hasher`] trait now has a number of specialized `write_*`
7525   methods for primitive types, for efficiency.
7526 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
7527   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
7528   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
7529   of [`std::error::Error::cause`][iec] also delegates to the inner
7530   error.
7531 * [`process::Child`][pc] gained the [`id`] method, which returns a
7532   `u32` representing the platform-specific process identifier.
7533 * The [`connect`] method on slices is deprecated, replaced by the new
7534   [`join`] method (note that both of these are on the *unstable*
7535   [`SliceConcatExt`] trait, but through the magic of the prelude are
7536   available to stable code anyway).
7537 * The [`Div`] operator is implemented for [`Wrapping`] types.
7538 * [`DerefMut` is implemented for `String`][dms].
7539 * Performance of SipHash (the default hasher for `HashMap`) is
7540   [better for long data][sh].
7541 * [`AtomicPtr`] implements [`Send`].
7542 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
7543   are now [specialized to use uninitialized buffers for increased
7544   performance][rte].
7545 * Lifetime parameters of foreign functions [are now resolved
7546   properly][f].
7547
7548 Misc
7549 ----
7550
7551 * Rust can now, with some coercion, [produce programs that run on
7552   Windows XP][xp], though XP is not considered a supported platform.
7553 * Porting Rust on Windows from the GNU toolchain to MSVC continues
7554   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
7555   recommended for use in 1.3, though should be fully-functional
7556   in the [64-bit 1.4 beta][b14].
7557 * On Fedora-based systems installation will [properly configure the
7558   dynamic linker][fl].
7559 * The compiler gained many new extended error descriptions, which can
7560   be accessed with the `--explain` flag.
7561 * The `dropck` pass, which checks that destructors can't access
7562   destroyed values, [has been rewritten][dropck]. This fixes some
7563   soundness holes, and as such will cause some previously-compiling
7564   code to no longer build.
7565 * `rustc` now uses [LLVM to write archive files where possible][ar].
7566   Eventually this will eliminate the compiler's dependency on the ar
7567   utility.
7568 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
7569   supported FreeBSD on x86_64).
7570 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
7571   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
7572   more strict.
7573 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
7574   will kill the process instead of leaking][nlp].
7575
7576 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
7577 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
7578 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
7579 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
7580 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
7581 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7582 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7583 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
7584 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
7585 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
7586 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
7587 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
7588 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
7589 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7590 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
7591 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
7592 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
7593 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
7594 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7595 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
7596 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
7597 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
7598 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
7599 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7600 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
7601 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
7602 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
7603 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
7604 [ar]: https://github.com/rust-lang/rust/pull/26926
7605 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
7606 [dms]: https://github.com/rust-lang/rust/pull/26241
7607 [dropck]: https://github.com/rust-lang/rust/pull/27261
7608 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7609 [ds]: https://github.com/rust-lang/rust/pull/26818
7610 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
7611 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
7612 [dst3]: https://github.com/rust-lang/rust/pull/27351
7613 [e]: https://github.com/rust-lang/rust/pull/24793
7614 [f]: https://github.com/rust-lang/rust/pull/26588
7615 [fb]: https://github.com/rust-lang/rust/pull/26959
7616 [fl]: https://github.com/rust-lang/rust-installer/pull/41
7617 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7618 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
7619 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
7620 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
7621 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
7622 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
7623 [lic]: https://github.com/rust-lang/rust/pull/26583
7624 [lnu]: https://github.com/rust-lang/rust/pull/27026
7625 [lr]: https://github.com/rust-lang/rust/issues/27248
7626 [lum]: https://github.com/rust-lang/rust/pull/26378
7627 [lur]: https://github.com/rust-lang/rust/pull/26783
7628 [nlp]: https://github.com/rust-lang/rust/pull/27176
7629 [nold2]: https://github.com/rust-lang/rust/pull/27045
7630 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
7631 [nom]: http://doc.rust-lang.org/nightly/nomicon/
7632 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
7633 [pi]: https://github.com/rust-lang/rust/pull/26699
7634 [ps]: https://github.com/rust-lang/rust/pull/26884
7635 [rte]: https://github.com/rust-lang/rust/pull/26950
7636 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
7637 [search]: https://github.com/rust-lang/rust/pull/26327
7638 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
7639 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
7640 [sh]: https://github.com/rust-lang/rust/pull/27280
7641 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
7642 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
7643 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
7644 [st]: https://github.com/rust-lang/rust/pull/26630
7645 [win1]: https://github.com/rust-lang/rust/pull/26569
7646 [win2]: https://github.com/rust-lang/rust/pull/26741
7647 [win3]: https://github.com/rust-lang/rust/pull/26741
7648 [win4]: https://github.com/rust-lang/rust/pull/27210
7649 [xp]: https://github.com/rust-lang/rust/pull/26569
7650
7651 Version 1.2.0 (2015-08-07)
7652 ==========================
7653
7654 * ~1200 changes, numerous bugfixes
7655
7656 Highlights
7657 ----------
7658
7659 * [Dynamically-sized-type coercions][dst] allow smart pointer types
7660   like `Rc` to contain types without a fixed size, arrays and trait
7661   objects, finally enabling use of `Rc<[T]>` and completing the
7662   implementation of DST.
7663 * [Parallel codegen][parcodegen] is now working again, which can
7664   substantially speed up large builds in debug mode; It also gets
7665   another ~33% speedup when bootstrapping on a 4 core machine (using 8
7666   jobs). It's not enabled by default, but will be "in the near
7667   future". It can be activated with the `-C codegen-units=N` flag to
7668   `rustc`.
7669 * This is the first release with [experimental support for linking
7670   with the MSVC linker and lib C on Windows (instead of using the GNU
7671   variants via MinGW)][win]. It is yet recommended only for the most
7672   intrepid Rustaceans.
7673 * Benchmark compilations are showing a 30% improvement in
7674   bootstrapping over 1.1.
7675
7676 Breaking Changes
7677 ----------------
7678
7679 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
7680   unicode case mapping, which is a previously-planned change in
7681   behavior and considered a bugfix.
7682 * [`mem::align_of`] now specifies [the *minimum alignment* for
7683   T][align], which is usually the alignment programs are interested
7684   in, and the same value reported by clang's
7685   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
7686   break real code.
7687 * [The `#[packed]` attribute is no longer silently accepted by the
7688   compiler][packed]. This attribute did nothing and code that
7689   mentioned it likely did not work as intended.
7690 * Associated type defaults are [now behind the
7691   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
7692   defaults *did not work*, but could be mentioned syntactically. As
7693   such this breakage has minimal impact.
7694
7695 Language
7696 --------
7697
7698 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
7699   matching against dereferenceable values.
7700
7701 Libraries
7702 ---------
7703
7704 * The [`Extend`] trait, which grows a collection from an iterator, is
7705   implemented over iterators of references, for `String`, `Vec`,
7706   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
7707   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
7708 * The [`iter::once`] function returns an iterator that yields a single
7709   element, and [`iter::empty`] returns an iterator that yields no
7710   elements.
7711 * The [`matches`] and [`rmatches`] methods on `str` return iterators
7712   over substring matches.
7713 * [`Cell`] and [`RefCell`] both implement `Eq`.
7714 * A number of methods for wrapping arithmetic are added to the
7715   integral types, [`wrapping_div`], [`wrapping_rem`],
7716   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
7717   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
7718   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
7719   type.. It is illegal for the default arithmetic operations in Rust
7720   to overflow; the desire to wrap must be explicit.
7721 * The `{:#?}` formatting specifier [displays the alternate,
7722   pretty-printed][debugfmt] form of the `Debug` formatter. This
7723   feature was actually introduced prior to 1.0 with little
7724   fanfare.
7725 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
7726   for writing data to formatted strings, similar to [`io::Write`].
7727 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
7728   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
7729   are used by code generators to emit implementations of [`Debug`].
7730 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
7731   methods that convert case, following Unicode case mapping.
7732 * It is now easier to handle poisoned locks. The [`PoisonError`]
7733   type, returned by failing lock operations, exposes `into_inner`,
7734   `get_ref`, and `get_mut`, which all give access to the inner lock
7735   guard, and allow the poisoned lock to continue to operate. The
7736   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
7737   poisoned lock without attempting to take the lock.
7738 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
7739   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
7740   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
7741   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
7742   `ChildStderr`.
7743 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
7744   malformed input.
7745
7746 Misc
7747 ----
7748
7749 * `rustc` employs smarter heuristics for guessing at [typos].
7750 * `rustc` emits more efficient code for [no-op conversions between
7751   unsafe pointers][nop].
7752 * Fat pointers are now [passed in pairs of immediate arguments][fat],
7753   resulting in faster compile times and smaller code.
7754
7755 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
7756 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7757 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
7758 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
7759 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
7760 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
7761 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
7762 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
7763 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
7764 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
7765 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
7766 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
7767 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
7768 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
7769 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
7770 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
7771 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7772 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
7773 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
7774 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
7775 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
7776 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
7777 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
7778 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
7779 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
7780 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7781 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
7782 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
7783 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
7784 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
7785 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
7786 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
7787 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
7788 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7789 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7790 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
7791 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
7792 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
7793 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
7794 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
7795 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
7796 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7797 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
7798 [align]: https://github.com/rust-lang/rust/pull/25646
7799 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
7800 [typos]: https://github.com/rust-lang/rust/pull/26087
7801 [nop]: https://github.com/rust-lang/rust/pull/26336
7802 [fat]: https://github.com/rust-lang/rust/pull/26411
7803 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
7804 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
7805 [packed]: https://github.com/rust-lang/rust/pull/25541
7806 [ad]: https://github.com/rust-lang/rust/pull/27382
7807 [win]: https://github.com/rust-lang/rust/pull/25350
7808
7809 Version 1.1.0 (2015-06-25)
7810 =========================
7811
7812 * ~850 changes, numerous bugfixes
7813
7814 Highlights
7815 ----------
7816
7817 * The [`std::fs` module has been expanded][fs] to expand the set of
7818   functionality exposed:
7819   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
7820     don't incur a syscall on some platforms.
7821   * A `symlink_metadata` function has been added.
7822   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
7823     access to all underlying information.
7824 * The compiler now contains extended explanations of many errors. When an error
7825   with an explanation occurs the compiler suggests using the `--explain` flag
7826   to read the explanation. Error explanations are also [available online][err-index].
7827 * Thanks to multiple [improvements][sk] to [type checking][pre], as
7828   well as other work, the time to bootstrap the compiler decreased by
7829   32%.
7830
7831 Libraries
7832 ---------
7833
7834 * The [`str::split_whitespace`] method splits a string on unicode
7835   whitespace boundaries.
7836 * On both Windows and Unix, new extension traits provide conversion of
7837   I/O types to and from the underlying system handles. On Unix, these
7838   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
7839   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
7840   `TcpListener`, and `UpdSocket`. Further implementations for
7841   `std::process` will be stabilized later.
7842 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
7843   Windows, symlinks can be created with
7844   `std::os::windows::symlink_dir` and
7845   `std::os::windows::symlink_file`.
7846 * The `mpsc::Receiver` type can now be converted into an iterator with
7847   `into_iter` on the [`IntoIterator`] trait.
7848 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
7849   implementation of the [`From`] trait.
7850 * The `Debug` implementation for `RangeFull` [creates output that is
7851   more consistent with other implementations][rf].
7852 * [`Debug` is implemented for `File`][file].
7853 * The `Default` implementation for `Arc` [no longer requires `Sync +
7854   Send`][arc].
7855 * [The `Iterator` methods `count`, `nth`, and `last` have been
7856   overridden for slices to have O(1) performance instead of O(n)][si].
7857 * Incorrect handling of paths on Windows has been improved in both the
7858   compiler and the standard library.
7859 * [`AtomicPtr` gained a `Default` implementation][ap].
7860 * In accordance with Rust's policy on arithmetic overflow `abs` now
7861   [panics on overflow when debug assertions are enabled][abs].
7862 * The [`Cloned`] iterator, which was accidentally left unstable for
7863   1.0 [has been stabilized][c].
7864 * The [`Incoming`] iterator, which iterates over incoming TCP
7865   connections, and which was accidentally unnamable in 1.0, [is now
7866   properly exported][inc].
7867 * [`BinaryHeap`] no longer corrupts itself [when functions called by
7868   `sift_up` or `sift_down` panic][bh].
7869 * The [`split_off`] method of `LinkedList` [no longer corrupts
7870   the list in certain scenarios][ll].
7871
7872 Misc
7873 ----
7874
7875 * Type checking performance [has improved notably][sk] with
7876   [multiple improvements][pre].
7877 * The compiler [suggests code changes][ch] for more errors.
7878 * rustc and it's build system have experimental support for [building
7879   toolchains against MUSL][m] instead of glibc on Linux.
7880 * The compiler defines the `target_env` cfg value, which is used for
7881   distinguishing toolchains that are otherwise for the same
7882   platform. Presently this is set to `gnu` for common GNU Linux
7883   targets and for MinGW targets, and `musl` for MUSL Linux targets.
7884 * The [`cargo rustc`][crc] command invokes a build with custom flags
7885   to rustc.
7886 * [Android executables are always position independent][pie].
7887 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
7888   with `Drop`][drop].
7889
7890 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
7891 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7892 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7893 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
7894 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
7895 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
7896 [rf]: https://github.com/rust-lang/rust/pull/24491
7897 [err-index]: https://doc.rust-lang.org/error-index.html
7898 [sk]: https://github.com/rust-lang/rust/pull/24615
7899 [pre]: https://github.com/rust-lang/rust/pull/25323
7900 [file]: https://github.com/rust-lang/rust/pull/24598
7901 [ch]: https://github.com/rust-lang/rust/pull/24683
7902 [arc]: https://github.com/rust-lang/rust/pull/24695
7903 [si]: https://github.com/rust-lang/rust/pull/24701
7904 [ap]: https://github.com/rust-lang/rust/pull/24834
7905 [m]: https://github.com/rust-lang/rust/pull/24777
7906 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
7907 [crc]: https://github.com/rust-lang/cargo/pull/1568
7908 [pie]: https://github.com/rust-lang/rust/pull/24953
7909 [abs]: https://github.com/rust-lang/rust/pull/25441
7910 [c]: https://github.com/rust-lang/rust/pull/25496
7911 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
7912 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
7913 [inc]: https://github.com/rust-lang/rust/pull/25522
7914 [bh]: https://github.com/rust-lang/rust/pull/25856
7915 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
7916 [ll]: https://github.com/rust-lang/rust/pull/26022
7917 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
7918 [drop]: https://github.com/rust-lang/rust/pull/24935
7919
7920 Version 1.0.0 (2015-05-15)
7921 ========================
7922
7923 * ~1500 changes, numerous bugfixes
7924
7925 Highlights
7926 ----------
7927
7928 * The vast majority of the standard library is now `#[stable]`. It is
7929   no longer possible to use unstable features with a stable build of
7930   the compiler.
7931 * Many popular crates on [crates.io] now work on the stable release
7932   channel.
7933 * Arithmetic on basic integer types now [checks for overflow in debug
7934   builds][overflow].
7935
7936 Language
7937 --------
7938
7939 * Several [restrictions have been added to trait coherence][coh] in
7940   order to make it easier for upstream authors to change traits
7941   without breaking downstream code.
7942 * Digits of binary and octal literals are [lexed more eagerly][lex] to
7943   improve error messages and macro behavior. For example, `0b1234` is
7944   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
7945 * Trait bounds [are always invariant][inv], eliminating the need for
7946   the `PhantomFn` and `MarkerTrait` lang items, which have been
7947   removed.
7948 * ["-" is no longer a valid character in crate names][cr], the `extern crate
7949   "foo" as bar` syntax has been replaced with `extern crate foo as
7950   bar`, and Cargo now automatically translates "-" in *package* names
7951   to underscore for the crate name.
7952 * [Lifetime shadowing is an error][lt].
7953 * [`Send` no longer implies `'static`][send-rfc].
7954 * [UFCS now supports trait-less associated paths][moar-ufcs] like
7955   `MyType::default()`.
7956 * Primitive types [now have inherent methods][prim-inherent],
7957   obviating the need for extension traits like `SliceExt`.
7958 * Methods with `Self: Sized` in their `where` clause are [considered
7959   object-safe][self-sized], allowing many extension traits like
7960   `IteratorExt` to be merged into the traits they extended.
7961 * You can now [refer to associated types][assoc-where] whose
7962   corresponding trait bounds appear only in a `where` clause.
7963 * The final bits of [OIBIT landed][oibit-final], meaning that traits
7964   like `Send` and `Sync` are now library-defined.
7965 * A [Reflect trait][reflect] was introduced, which means that
7966   downcasting via the `Any` trait is effectively limited to concrete
7967   types. This helps retain the potentially-important "parametricity"
7968   property: generic code cannot behave differently for different type
7969   arguments except in minor ways.
7970 * The `unsafe_destructor` feature is now deprecated in favor of the
7971   [new `dropck`][dropck]. This change is a major reduction in unsafe
7972   code.
7973
7974 Libraries
7975 ---------
7976
7977 * The `thread_local` module [has been renamed to `std::thread`][th].
7978 * The methods of `IteratorExt` [have been moved to the `Iterator`
7979   trait itself][ie].
7980 * Several traits that implement Rust's conventions for type
7981   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
7982   [centralized in the `std::convert` module][con].
7983 * The `FromError` trait [was removed in favor of `From`][fe].
7984 * The basic sleep function [has moved to
7985   `std::thread::sleep_ms`][slp].
7986 * The `splitn` function now takes an `n` parameter that represents the
7987   number of items yielded by the returned iterator [instead of the
7988   number of 'splits'][spl].
7989 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
7990 * [Derived implementations of `PartialOrd` now order enums according
7991   to their explicitly-assigned discriminants][po].
7992 * [Methods for searching strings are generic over `Pattern`s][pat],
7993   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
7994   some others.
7995 * [In method resolution, object methods are resolved before inherent
7996   methods][meth].
7997 * [`String::from_str` has been deprecated in favor of the `From` impl,
7998   `String::from`][sf].
7999 * [`io::Error` implements `Sync`][ios].
8000 * [The `words` method on `&str` has been replaced with
8001   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
8002   a word?'
8003 * The new path and IO modules are complete and `#[stable]`. This
8004   was the major library focus for this cycle.
8005 * The path API was [revised][path-normalize] to normalize `.`,
8006   adjusting the tradeoffs in favor of the most common usage.
8007 * A large number of remaining APIs in `std` were also stabilized
8008   during this cycle; about 75% of the non-deprecated API surface
8009   is now stable.
8010 * The new [string pattern API][string-pattern] landed, which makes
8011   the string slice API much more internally consistent and flexible.
8012 * A new set of [generic conversion traits][conversion] replaced
8013   many existing ad hoc traits.
8014 * Generic numeric traits were [completely removed][num-traits]. This
8015   was made possible thanks to inherent methods for primitive types,
8016   and the removal gives maximal flexibility for designing a numeric
8017   hierarchy in the future.
8018 * The `Fn` traits are now related via [inheritance][fn-inherit]
8019   and provide ergonomic [blanket implementations][fn-blanket].
8020 * The `Index` and `IndexMut` traits were changed to
8021   [take the index by value][index-value], enabling code like
8022   `hash_map["string"]` to work.
8023 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
8024   `Copy` data is known to be `Clone` as well.
8025
8026 Misc
8027 ----
8028
8029 * Many errors now have extended explanations that can be accessed with
8030   the `--explain` flag to `rustc`.
8031 * Many new examples have been added to the standard library
8032   documentation.
8033 * rustdoc has received a number of improvements focused on completion
8034   and polish.
8035 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
8036 * Much headway was made on ecosystem-wide CI, making it possible
8037   to [compare builds for breakage][ci-compare].
8038
8039
8040 [crates.io]: http://crates.io
8041 [clo]: https://github.com/rust-lang/rust/pull/24034
8042 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
8043 [con]: https://github.com/rust-lang/rust/pull/23875
8044 [cr]: https://github.com/rust-lang/rust/pull/23419
8045 [fe]: https://github.com/rust-lang/rust/pull/23879
8046 [ie]: https://github.com/rust-lang/rust/pull/23300
8047 [inv]: https://github.com/rust-lang/rust/pull/23938
8048 [ios]: https://github.com/rust-lang/rust/pull/24133
8049 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
8050 [lt]: https://github.com/rust-lang/rust/pull/24057
8051 [meth]: https://github.com/rust-lang/rust/pull/24056
8052 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
8053 [po]: https://github.com/rust-lang/rust/pull/24270
8054 [sf]: https://github.com/rust-lang/rust/pull/24517
8055 [slp]: https://github.com/rust-lang/rust/pull/23949
8056 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
8057 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
8058 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
8059 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
8060 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
8061 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
8062 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
8063 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
8064 [self-sized]: https://github.com/rust-lang/rust/pull/22301
8065 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
8066 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
8067 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
8068 [reflect]: https://github.com/rust-lang/rust/pull/23712
8069 [conversion]: https://github.com/rust-lang/rfcs/pull/529
8070 [num-traits]: https://github.com/rust-lang/rust/pull/23549
8071 [index-value]: https://github.com/rust-lang/rust/pull/23601
8072 [dropck]: https://github.com/rust-lang/rfcs/pull/769
8073 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
8074 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
8075 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
8076 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
8077 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
8078
8079
8080 Version 1.0.0-alpha.2 (2015-02-20)
8081 =====================================
8082
8083 * ~1300 changes, numerous bugfixes
8084
8085 * Highlights
8086
8087     * The various I/O modules were [overhauled][io-rfc] to reduce
8088       unnecessary abstractions and provide better interoperation with
8089       the underlying platform. The old `io` module remains temporarily
8090       at `std::old_io`.
8091     * The standard library now [participates in feature gating][feat],
8092       so use of unstable libraries now requires a `#![feature(...)]`
8093       attribute. The impact of this change is [described on the
8094       forum][feat-forum]. [RFC][feat-rfc].
8095
8096 * Language
8097
8098     * `for` loops [now operate on the `IntoIterator` trait][into],
8099       which eliminates the need to call `.iter()`, etc. to iterate
8100       over collections. There are some new subtleties to remember
8101       though regarding what sort of iterators various types yield, in
8102       particular that `for foo in bar { }` yields values from a move
8103       iterator, destroying the original collection. [RFC][into-rfc].
8104     * Objects now have [default lifetime bounds][obj], so you don't
8105       have to write `Box<Trait+'static>` when you don't care about
8106       storing references. [RFC][obj-rfc].
8107     * In types that implement `Drop`, [lifetimes must outlive the
8108       value][drop]. This will soon make it possible to safely
8109       implement `Drop` for types where `#[unsafe_destructor]` is now
8110       required. Read the [gorgeous RFC][drop-rfc] for details.
8111     * The fully qualified <T as Trait>::X syntax lets you set the Self
8112       type for a trait method or associated type. [RFC][ufcs-rfc].
8113     * References to types that implement `Deref<U>` now [automatically
8114       coerce to references][deref] to the dereferenced type `U`,
8115       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
8116       should eliminate many unsightly uses of `&*`, as when converting
8117       from references to vectors into references to
8118       slices. [RFC][deref-rfc].
8119     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
8120       `|:|`) is obsolete and closure kind is inferred from context.
8121     * [`Self` is a keyword][Self].
8122
8123 * Libraries
8124
8125     * The `Show` and `String` formatting traits [have been
8126       renamed][fmt] to `Debug` and `Display` to more clearly reflect
8127       their related purposes. Automatically getting a string
8128       conversion to use with `format!("{:?}", something_to_debug)` is
8129       now written `#[derive(Debug)]`.
8130     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
8131       OsStr}`, provide strings in platform-specific encodings for easier
8132       interop with system APIs. [RFC][osstr-rfc].
8133     * The `boxed::into_raw` and `Box::from_raw` functions [convert
8134       between `Box<T>` and `*mut T`][boxraw], a common pattern for
8135       creating raw pointers.
8136
8137 * Tooling
8138
8139     * Certain long error messages of the form 'expected foo found bar'
8140       are now [split neatly across multiple
8141       lines][multiline]. Examples in the PR.
8142     * On Unix Rust can be [uninstalled][un] by running
8143       `/usr/local/lib/rustlib/uninstall.sh`.
8144     * The `#[rustc_on_unimplemented]` attribute, requiring the
8145       'on_unimplemented' feature, lets rustc [display custom error
8146       messages when a trait is expected to be implemented for a type
8147       but is not][onun].
8148
8149 * Misc
8150
8151     * Rust is tested against a [LALR grammar][lalr], which parses
8152       almost all the Rust files that rustc does.
8153
8154 [boxraw]: https://github.com/rust-lang/rust/pull/21318
8155 [close]: https://github.com/rust-lang/rust/pull/21843
8156 [deref]: https://github.com/rust-lang/rust/pull/21351
8157 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
8158 [drop]: https://github.com/rust-lang/rust/pull/21972
8159 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8160 [feat]: https://github.com/rust-lang/rust/pull/21248
8161 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
8162 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
8163 [fmt]: https://github.com/rust-lang/rust/pull/21457
8164 [into]: https://github.com/rust-lang/rust/pull/20790
8165 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
8166 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8167 [lalr]: https://github.com/rust-lang/rust/pull/21452
8168 [multiline]: https://github.com/rust-lang/rust/pull/19870
8169 [obj]: https://github.com/rust-lang/rust/pull/22230
8170 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
8171 [onun]: https://github.com/rust-lang/rust/pull/20889
8172 [osstr]: https://github.com/rust-lang/rust/pull/21488
8173 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8174 [Self]: https://github.com/rust-lang/rust/pull/22158
8175 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
8176 [un]: https://github.com/rust-lang/rust/pull/22256
8177
8178
8179 Version 1.0.0-alpha (2015-01-09)
8180 ==================================
8181
8182   * ~2400 changes, numerous bugfixes
8183
8184   * Highlights
8185
8186     * The language itself is considered feature complete for 1.0,
8187       though there will be many usability improvements and bugfixes
8188       before the final release.
8189     * Nearly 50% of the public API surface of the standard library has
8190       been declared 'stable'. Those interfaces are unlikely to change
8191       before 1.0.
8192     * The long-running debate over integer types has been
8193       [settled][ints]: Rust will ship with types named `isize` and
8194       `usize`, rather than `int` and `uint`, for pointer-sized
8195       integers. Guidelines will be rolled out during the alpha cycle.
8196     * Most crates that are not `std` have been moved out of the Rust
8197       distribution into the Cargo ecosystem so they can evolve
8198       separately and don't need to be stabilized as quickly, including
8199       'time', 'getopts', 'num', 'regex', and 'term'.
8200     * Documentation continues to be expanded with more API coverage, more
8201       examples, and more in-depth explanations. The guides have been
8202       consolidated into [The Rust Programming Language][trpl].
8203     * "[Rust By Example][rbe]" is now maintained by the Rust team.
8204     * All official Rust binary installers now come with [Cargo], the
8205       Rust package manager.
8206
8207 * Language
8208
8209     * Closures have been [completely redesigned][unboxed] to be
8210       implemented in terms of traits, can now be used as generic type
8211       bounds and thus monomorphized and inlined, or via an opaque
8212       pointer (boxed) as in the old system. The new system is often
8213       referred to as 'unboxed' closures.
8214     * Traits now support [associated types][assoc], allowing families
8215       of related types to be defined together and used generically in
8216       powerful ways.
8217     * Enum variants are [namespaced by their type names][enum].
8218     * [`where` clauses][where] provide a more versatile and attractive
8219       syntax for specifying generic bounds, though the previous syntax
8220       remains valid.
8221     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
8222       numeric types.
8223     * Rust [no longer has a runtime][rt] of any description, and only
8224       supports OS threads, not green threads.
8225     * At long last, Rust has been overhauled for 'dynamically-sized
8226       types' ([DST]), which integrates 'fat pointers' (object types,
8227       arrays, and `str`) more deeply into the type system, making it
8228       more consistent.
8229     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
8230       `..j` that produce range types and which, when combined with the
8231       `Index` operator and multidispatch, leads to a convenient slice
8232       notation, `[i..j]`.
8233     * The new range syntax revealed an ambiguity in the fixed-length
8234       array syntax, so now fixed length arrays [are written `[T;
8235       N]`][arrays].
8236     * The `Copy` trait is no longer implemented automatically. Unsafe
8237       pointers no longer implement `Sync` and `Send` so types
8238       containing them don't automatically either. `Sync` and `Send`
8239       are now 'unsafe traits' so one can "forcibly" implement them via
8240       `unsafe impl` if a type confirms to the requirements for them
8241       even though the internals do not (e.g. structs containing unsafe
8242       pointers like `Arc`). These changes are intended to prevent some
8243       footguns and are collectively known as [opt-in built-in
8244       traits][oibit] (though `Sync` and `Send` will soon become pure
8245       library types unknown to the compiler).
8246     * Operator traits now take their operands [by value][ops], and
8247       comparison traits can use multidispatch to compare one type
8248       against multiple other types, allowing e.g. `String` to be
8249       compared with `&str`.
8250     * `if let` and `while let` are no longer feature-gated.
8251     * Rust has adopted a more [uniform syntax for escaping unicode
8252       characters][unicode].
8253     * `macro_rules!` [has been declared stable][mac]. Though it is a
8254       flawed system it is sufficiently popular that it must be usable
8255       for 1.0. Effort has gone into [future-proofing][mac-future] it
8256       in ways that will allow other macro systems to be developed in
8257       parallel, and won't otherwise impact the evolution of the
8258       language.
8259     * The prelude has been [pared back significantly][prelude] such
8260       that it is the minimum necessary to support the most pervasive
8261       code patterns, and through [generalized where clauses][where]
8262       many of the prelude extension traits have been consolidated.
8263     * Rust's rudimentary reflection [has been removed][refl], as it
8264       incurred too much code generation for little benefit.
8265     * [Struct variants][structvars] are no longer feature-gated.
8266     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
8267       known as 'higher-ranked trait bounds', this crucially allows
8268       unboxed closures to work.
8269     * Macros invocations surrounded by parens or square brackets and
8270       not terminated by a semicolon are [parsed as
8271       expressions][macros], which makes expressions like `vec![1i32,
8272       2, 3].len()` work as expected.
8273     * Trait objects now implement their traits automatically, and
8274       traits that can be coerced to objects now must be [object
8275       safe][objsafe].
8276     * Automatically deriving traits is now done with `#[derive(...)]`
8277       not `#[deriving(...)]` for [consistency with other naming
8278       conventions][derive].
8279     * Importing the containing module or enum at the same time as
8280       items or variants they contain is [now done with `self` instead
8281       of `mod`][self], as in use `foo::{self, bar}`
8282     * Glob imports are no longer feature-gated.
8283     * The `box` operator and `box` patterns have been feature-gated
8284       pending a redesign. For now unique boxes should be allocated
8285       like other containers, with `Box::new`.
8286
8287 * Libraries
8288
8289     * A [series][coll1] of [efforts][coll2] to establish
8290       [conventions][coll3] for collections types has resulted in API
8291       improvements throughout the standard library.
8292     * New [APIs for error handling][err] provide ergonomic interop
8293       between error types, and [new conventions][err-conv] describe
8294       more clearly the recommended error handling strategies in Rust.
8295     * The `fail!` macro has been renamed to [`panic!`][panic] so that
8296       it is easier to discuss failure in the context of error handling
8297       without making clarifications as to whether you are referring to
8298       the 'fail' macro or failure more generally.
8299     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
8300       syscall when available.
8301     * The 'serialize' crate has been renamed 'rustc-serialize' and
8302       moved out of the distribution to Cargo. Although it is widely
8303       used now, it is expected to be superseded in the near future.
8304     * The `Show` formatter, typically implemented with
8305       `#[derive(Show)]` is [now requested with the `{:?}`
8306       specifier][show] and is intended for use by all types, for uses
8307       such as `println!` debugging. The new `String` formatter must be
8308       implemented by hand, uses the `{}` specifier, and is intended
8309       for full-fidelity conversions of things that can logically be
8310       represented as strings.
8311
8312 * Tooling
8313
8314     * [Flexible target specification][flex] allows rustc's code
8315       generation to be configured to support otherwise-unsupported
8316       platforms.
8317     * Rust comes with rust-gdb and rust-lldb scripts that launch their
8318       respective debuggers with Rust-appropriate pretty-printing.
8319     * The Windows installation of Rust is distributed with the
8320       MinGW components currently required to link binaries on that
8321       platform.
8322
8323 * Misc
8324
8325     * Nullable enum optimizations have been extended to more types so
8326       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
8327       space than the inner types themselves.
8328     * Work has begun on supporting AArch64.
8329
8330 [Cargo]: https://crates.io
8331 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
8332 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
8333 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
8334 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
8335 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
8336 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
8337 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
8338 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
8339 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
8340 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
8341 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
8342 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
8343 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
8344 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
8345 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
8346 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
8347 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
8348 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
8349 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
8350 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
8351 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
8352 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
8353 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
8354 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
8355 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
8356 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
8357 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
8358 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
8359 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
8360 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
8361 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
8362 [trpl]: https://doc.rust-lang.org/book/index.html
8363 [rbe]: http://rustbyexample.com/
8364
8365
8366 Version 0.12.0 (2014-10-09)
8367 =============================
8368
8369   * ~1900 changes, numerous bugfixes
8370
8371   * Highlights
8372
8373     * The introductory documentation (now called The Rust Guide) has
8374       been completely rewritten, as have a number of supplementary
8375       guides.
8376     * Rust's package manager, Cargo, continues to improve and is
8377       sometimes considered to be quite awesome.
8378     * Many API's in `std` have been reviewed and updated for
8379       consistency with the in-development Rust coding
8380       guidelines. The standard library documentation tracks
8381       stabilization progress.
8382     * Minor libraries have been moved out-of-tree to the rust-lang org
8383       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
8384       be installed with Cargo.
8385     * Lifetime elision allows lifetime annotations to be left off of
8386       function declarations in many common scenarios.
8387     * Rust now works on 64-bit Windows.
8388
8389   * Language
8390     * Indexing can be overloaded with the `Index` and `IndexMut`
8391       traits.
8392     * The `if let` construct takes a branch only if the `let` pattern
8393       matches, currently behind the 'if_let' feature gate.
8394     * 'where clauses', a more flexible syntax for specifying trait
8395       bounds that is more aesthetic, have been added for traits and
8396       free functions. Where clauses will in the future make it
8397       possible to constrain associated types, which would be
8398       impossible with the existing syntax.
8399     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
8400       the 'slicing_syntax' feature gate, and can be overloaded with
8401       the `Slice` or `SliceMut` traits.
8402     * The syntax for matching of sub-slices has been changed to use a
8403       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
8404       consistency with other uses of `..` and to future-proof
8405       potential additional uses of the syntax.
8406     * The syntax for matching inclusive ranges in patterns has changed
8407       from `0..3` to `0...4` to be consistent with the exclusive range
8408       syntax for slicing.
8409     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
8410       c]`) has been put behind the 'advanced_slice_patterns' feature
8411       gate and may be removed in the future.
8412     * Components of tuples and tuple structs can be extracted using
8413       the `value.0` syntax, currently behind the `tuple_indexing`
8414       feature gate.
8415     * The `#[crate_id]` attribute is no longer supported; versioning
8416       is handled by the package manager.
8417     * Renaming crate imports are now written `extern crate foo as bar`
8418       instead of `extern crate bar = foo`.
8419     * Renaming use statements are now written `use foo as bar` instead
8420       of `use bar = foo`.
8421     * `let` and `match` bindings and argument names in macros are now
8422       hygienic.
8423     * The new, more efficient, closure types ('unboxed closures') have
8424       been added under a feature gate, 'unboxed_closures'. These will
8425       soon replace the existing closure types, once higher-ranked
8426       trait lifetimes are added to the language.
8427     * `move` has been added as a keyword, for indicating closures
8428       that capture by value.
8429     * Mutation and assignment is no longer allowed in pattern guards.
8430     * Generic structs and enums can now have trait bounds.
8431     * The `Share` trait is now called `Sync` to free up the term
8432       'shared' to refer to 'shared reference' (the default reference
8433       type.
8434     * Dynamically-sized types have been mostly implemented,
8435       unifying the behavior of fat-pointer types with the rest of the
8436       type system.
8437     * As part of dynamically-sized types, the `Sized` trait has been
8438       introduced, which qualifying types implement by default, and
8439       which type parameters expect by default. To specify that a type
8440       parameter does not need to be sized, write `<Sized? T>`. Most
8441       types are `Sized`, notable exceptions being unsized arrays
8442       (`[T]`) and trait types.
8443     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
8444     * Lifetime bounds can now be applied to type parameters and object
8445       types.
8446     * The old, reference counted GC type, `Gc<T>` which was once
8447       denoted by the `@` sigil, has finally been removed. GC will be
8448       revisited in the future.
8449
8450   * Libraries
8451     * Library documentation has been improved for a number of modules.
8452     * Bit-vectors, collections::bitv has been modernized.
8453     * The url crate is deprecated in favor of
8454       http://github.com/servo/rust-url, which can be installed with
8455       Cargo.
8456     * Most I/O stream types can be cloned and subsequently closed from
8457       a different thread.
8458     * A `std::time::Duration` type has been added for use in I/O
8459       methods that rely on timers, as well as in the 'time' crate's
8460       `Timespec` arithmetic.
8461     * The runtime I/O abstraction layer that enabled the green thread
8462       scheduler to do non-thread-blocking I/O has been removed, along
8463       with the libuv-based implementation employed by the green thread
8464       scheduler. This will greatly simplify the future I/O work.
8465     * `collections::btree` has been rewritten to have a more
8466       idiomatic and efficient design.
8467
8468   * Tooling
8469     * rustdoc output now indicates the stability levels of API's.
8470     * The `--crate-name` flag can specify the name of the crate
8471       being compiled, like `#[crate_name]`.
8472     * The `-C metadata` specifies additional metadata to hash into
8473       symbol names, and `-C extra-filename` specifies additional
8474       information to put into the output filename, for use by the
8475       package manager for versioning.
8476     * debug info generation has continued to improve and should be
8477       more reliable under both gdb and lldb.
8478     * rustc has experimental support for compiling in parallel
8479       using the `-C codegen-units` flag.
8480     * rustc no longer encodes rpath information into binaries by
8481       default.
8482
8483   * Misc
8484     * Stack usage has been optimized with LLVM lifetime annotations.
8485     * Official Rust binaries on Linux are more compatible with older
8486       kernels and distributions, built on CentOS 5.10.
8487
8488
8489 Version 0.11.0 (2014-07-02)
8490 ==========================
8491
8492   * ~1700 changes, numerous bugfixes
8493
8494   * Language
8495     * ~[T] has been removed from the language. This type is superseded by
8496       the Vec<T> type.
8497     * ~str has been removed from the language. This type is superseded by
8498       the String type.
8499     * ~T has been removed from the language. This type is superseded by the
8500       Box<T> type.
8501     * @T has been removed from the language. This type is superseded by the
8502       standard library's std::gc::Gc<T> type.
8503     * Struct fields are now all private by default.
8504     * Vector indices and shift amounts are both required to be a `uint`
8505       instead of any integral type.
8506     * Byte character, byte string, and raw byte string literals are now all
8507       supported by prefixing the normal literal with a `b`.
8508     * Multiple ABIs are no longer allowed in an ABI string
8509     * The syntax for lifetimes on closures/procedures has been tweaked
8510       slightly: `<'a>|A, B|: 'b + K -> T`
8511     * Floating point modulus has been removed from the language; however it
8512       is still provided by a library implementation.
8513     * Private enum variants are now disallowed.
8514     * The `priv` keyword has been removed from the language.
8515     * A closure can no longer be invoked through a &-pointer.
8516     * The `use foo, bar, baz;` syntax has been removed from the language.
8517     * The transmute intrinsic no longer works on type parameters.
8518     * Statics now allow blocks/items in their definition.
8519     * Trait bounds are separated from objects with + instead of : now.
8520     * Objects can no longer be read while they are mutably borrowed.
8521     * The address of a static is now marked as insignificant unless the
8522       #[inline(never)] attribute is placed it.
8523     * The #[unsafe_destructor] attribute is now behind a feature gate.
8524     * Struct literals are no longer allowed in ambiguous positions such as
8525       if, while, match, and for..in.
8526     * Declaration of lang items and intrinsics are now feature-gated by
8527       default.
8528     * Integral literals no longer default to `int`, and floating point
8529       literals no longer default to `f64`. Literals must be suffixed with an
8530       appropriate type if inference cannot determine the type of the
8531       literal.
8532     * The Box<T> type is no longer implicitly borrowed to &mut T.
8533     * Procedures are now required to not capture borrowed references.
8534
8535   * Libraries
8536     * The standard library is now a "facade" over a number of underlying
8537       libraries. This means that development on the standard library should
8538       be speedier due to smaller crates, as well as a clearer line between
8539       all dependencies.
8540     * A new library, libcore, lives under the standard library's facade
8541       which is Rust's "0-assumption" library, suitable for embedded and
8542       kernel development for example.
8543     * A regex crate has been added to the standard distribution. This crate
8544       includes statically compiled regular expressions.
8545     * The unwrap/unwrap_err methods on Result require a Show bound for
8546       better error messages.
8547     * The return types of the std::comm primitives have been centralized
8548       around the Result type.
8549     * A number of I/O primitives have gained the ability to time out their
8550       operations.
8551     * A number of I/O primitives have gained the ability to close their
8552       reading/writing halves to cancel pending operations.
8553     * Reverse iterator methods have been removed in favor of `rev()` on
8554       their forward-iteration counterparts.
8555     * A bitflags! macro has been added to enable easy interop with C and
8556       management of bit flags.
8557     * A debug_assert! macro is now provided which is disabled when
8558       `--cfg ndebug` is passed to the compiler.
8559     * A graphviz crate has been added for creating .dot files.
8560     * The std::cast module has been migrated into std::mem.
8561     * The std::local_data api has been migrated from freestanding functions
8562       to being based on methods.
8563     * The Pod trait has been renamed to Copy.
8564     * jemalloc has been added as the default allocator for types.
8565     * The API for allocating memory has been changed to use proper alignment
8566       and sized deallocation
8567     * Connecting a TcpStream or binding a TcpListener is now based on a
8568       string address and a u16 port. This allows connecting to a hostname as
8569       opposed to an IP.
8570     * The Reader trait now contains a core method, read_at_least(), which
8571       correctly handles many repeated 0-length reads.
8572     * The process-spawning API is now centered around a builder-style
8573       Command struct.
8574     * The :? printing qualifier has been moved from the standard library to
8575       an external libdebug crate.
8576     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
8577       have been renamed to Eq/Ord.
8578     * The select/plural methods have been removed from format!. The escapes
8579       for { and } have also changed from \{ and \} to {{ and }},
8580       respectively.
8581     * The TaskBuilder API has been re-worked to be a true builder, and
8582       extension traits for spawning native/green tasks have been added.
8583
8584   * Tooling
8585     * All breaking changes to the language or libraries now have their
8586       commit message annotated with `[breaking-change]` to allow for easy
8587       discovery of breaking changes.
8588     * The compiler will now try to suggest how to annotate lifetimes if a
8589       lifetime-related error occurs.
8590     * Debug info continues to be improved greatly with general bug fixes and
8591       better support for situations like link time optimization (LTO).
8592     * Usage of syntax extensions when cross-compiling has been fixed.
8593     * Functionality equivalent to GCC & Clang's -ffunction-sections,
8594       -fdata-sections and --gc-sections has been enabled by default
8595     * The compiler is now stricter about where it will load module files
8596       from when a module is declared via `mod foo;`.
8597     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
8598       Syntax extensions are now discovered via a "plugin registrar" type
8599       which will be extended in the future to other various plugins.
8600     * Lints have been restructured to allow for dynamically loadable lints.
8601     * A number of rustdoc improvements:
8602       * The HTML output has been visually redesigned.
8603       * Markdown is now powered by hoedown instead of sundown.
8604       * Searching heuristics have been greatly improved.
8605       * The search index has been reduced in size by a great amount.
8606       * Cross-crate documentation via `pub use` has been greatly improved.
8607       * Primitive types are now hyperlinked and documented.
8608     * Documentation has been moved from static.rust-lang.org/doc to
8609       doc.rust-lang.org
8610     * A new sandbox, play.rust-lang.org, is available for running and
8611       sharing rust code examples on-line.
8612     * Unused attributes are now more robustly warned about.
8613     * The dead_code lint now warns about unused struct fields.
8614     * Cross-compiling to iOS is now supported.
8615     * Cross-compiling to mipsel is now supported.
8616     * Stability attributes are now inherited by default and no longer apply
8617       to intra-crate usage, only inter-crate usage.
8618     * Error message related to non-exhaustive match expressions have been
8619       greatly improved.
8620
8621
8622 Version 0.10 (2014-04-03)
8623 =========================
8624
8625   * ~1500 changes, numerous bugfixes
8626
8627   * Language
8628     * A new RFC process is now in place for modifying the language.
8629     * Patterns with `@`-pointers have been removed from the language.
8630     * Patterns with unique vectors (`~[T]`) have been removed from the
8631       language.
8632     * Patterns with unique strings (`~str`) have been removed from the
8633       language.
8634     * `@str` has been removed from the language.
8635     * `@[T]` has been removed from the language.
8636     * `@self` has been removed from the language.
8637     * `@Trait` has been removed from the language.
8638     * Headers on `~` allocations which contain `@` boxes inside the type for
8639       reference counting have been removed.
8640     * The semantics around the lifetimes of temporary expressions have changed,
8641       see #3511 and #11585 for more information.
8642     * Cross-crate syntax extensions are now possible, but feature gated. See
8643       #11151 for more information. This includes both `macro_rules!` macros as
8644       well as syntax extensions such as `format!`.
8645     * New lint modes have been added, and older ones have been turned on to be
8646       warn-by-default.
8647       * Unnecessary parentheses
8648       * Uppercase statics
8649       * Camel Case types
8650       * Uppercase variables
8651       * Publicly visible private types
8652       * `#[deriving]` with raw pointers
8653     * Unsafe functions can no longer be coerced to closures.
8654     * Various obscure macros such as `log_syntax!` are now behind feature gates.
8655     * The `#[simd]` attribute is now behind a feature gate.
8656     * Visibility is no longer allowed on `extern crate` statements, and
8657       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
8658     * Trailing commas are now allowed in argument lists and tuple patterns.
8659     * The `do` keyword has been removed, it is now a reserved keyword.
8660     * Default type parameters have been implemented, but are feature gated.
8661     * Borrowed variables through captures in closures are now considered soundly.
8662     * `extern mod` is now `extern crate`
8663     * The `Freeze` trait has been removed.
8664     * The `Share` trait has been added for types that can be shared among
8665       threads.
8666     * Labels in macros are now hygienic.
8667     * Expression/statement macro invocations can be delimited with `{}` now.
8668     * Treatment of types allowed in `static mut` locations has been tweaked.
8669     * The `*` and `.` operators are now overloadable through the `Deref` and
8670       `DerefMut` traits.
8671     * `~Trait` and `proc` no longer have `Send` bounds by default.
8672     * Partial type hints are now supported with the `_` type marker.
8673     * An `Unsafe` type was introduced for interior mutability. It is now
8674       considered undefined to transmute from `&T` to `&mut T` without using the
8675       `Unsafe` type.
8676     * The #[linkage] attribute was implemented for extern statics/functions.
8677     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
8678     * `Pod` was renamed to `Copy`.
8679
8680   * Libraries
8681     * The `libextra` library has been removed. It has now been decomposed into
8682       component libraries with smaller and more focused nuggets of
8683       functionality. The full list of libraries can be found on the
8684       documentation index page.
8685     * std: `std::condition` has been removed. All I/O errors are now propagated
8686       through the `Result` type. In order to assist with error handling, a
8687       `try!` macro for unwrapping errors with an early return and a lint for
8688       unused results has been added. See #12039 for more information.
8689     * std: The `vec` module has been renamed to `slice`.
8690     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
8691       This will become the only growable vector in the future.
8692     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
8693       are now found at `std::io::BufferedReader` instead of
8694       `std::io::buffered::BufferedReader`.
8695     * std: `print` and `println` are no longer in the prelude, the `print!` and
8696       `println!` macros are intended to be used instead.
8697     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
8698       attempts to statically prevent cycles.
8699     * std: The standard distribution is adopting the policy of pushing failure
8700       to the user rather than failing in libraries. Many functions (such as
8701       `slice::last()`) now return `Option<T>` instead of `T` + failing.
8702     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
8703       deriving mode: `#[deriving(Show)]`.
8704     * std: `ToStr` is now implemented for all types implementing `Show`.
8705     * std: The formatting trait methods now take `&self` instead of `&T`
8706     * std: The `invert()` method on iterators has been renamed to `rev()`
8707     * std: `std::num` has seen a reduction in the genericity of its traits,
8708       consolidating functionality into a few core traits.
8709     * std: Backtraces are now printed on task failure if the environment
8710       variable `RUST_BACKTRACE` is present.
8711     * std: Naming conventions for iterators have been standardized. More details
8712       can be found on the wiki's style guide.
8713     * std: `eof()` has been removed from the `Reader` trait. Specific types may
8714       still implement the function.
8715     * std: Networking types are now cloneable to allow simultaneous reads/writes.
8716     * std: `assert_approx_eq!` has been removed
8717     * std: The `e` and `E` formatting specifiers for floats have been added to
8718       print them in exponential notation.
8719     * std: The `Times` trait has been removed
8720     * std: Indications of variance and opting out of builtin bounds is done
8721       through marker types in `std::kinds::marker` now
8722     * std: `hash` has been rewritten, `IterBytes` has been removed, and
8723       `#[deriving(Hash)]` is now possible.
8724     * std: `SharedChan` has been removed, `Sender` is now cloneable.
8725     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
8726     * std: `Chan::new` is now `channel()`.
8727     * std: A new synchronous channel type has been implemented.
8728     * std: A `select!` macro is now provided for selecting over `Receiver`s.
8729     * std: `hashmap` and `trie` have been moved to `libcollections`
8730     * std: `run` has been rolled into `io::process`
8731     * std: `assert_eq!` now uses `{}` instead of `{:?}`
8732     * std: The equality and comparison traits have seen some reorganization.
8733     * std: `rand` has moved to `librand`.
8734     * std: `to_{lower,upper}case` has been implemented for `char`.
8735     * std: Logging has been moved to `liblog`.
8736     * collections: `HashMap` has been rewritten for higher performance and less
8737       memory usage.
8738     * native: The default runtime is now `libnative`. If `libgreen` is desired,
8739       it can be booted manually. The runtime guide has more information and
8740       examples.
8741     * native: All I/O functionality except signals has been implemented.
8742     * green: Task spawning with `libgreen` has been optimized with stack caching
8743       and various trimming of code.
8744     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
8745     * sync: The `extra::sync` module has been updated to modern rust (and moved
8746       to the `sync` library), tweaking and improving various interfaces while
8747       dropping redundant functionality.
8748     * sync: A new `Barrier` type has been added to the `sync` library.
8749     * sync: An efficient mutex for native and green tasks has been implemented.
8750     * serialize: The `base64` module has seen some improvement. It treats
8751       newlines better, has non-string error values, and has seen general
8752       cleanup.
8753     * fourcc: A `fourcc!` macro was introduced
8754     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
8755       hexadecimal literal.
8756
8757   * Tooling
8758     * `rustpkg` has been deprecated and removed from the main repository. Its
8759       replacement, `cargo`, is under development.
8760     * Nightly builds of rust are now available
8761     * The memory usage of rustc has been improved many times throughout this
8762       release cycle.
8763     * The build process supports disabling rpath support for the rustc binary
8764       itself.
8765     * Code generation has improved in some cases, giving more information to the
8766       LLVM optimization passes to enable more extensive optimizations.
8767     * Debuginfo compatibility with lldb on OSX has been restored.
8768     * The master branch is now gated on an android bot, making building for
8769       android much more reliable.
8770     * Output flags have been centralized into one `--emit` flag.
8771     * Crate type flags have been centralized into one `--crate-type` flag.
8772     * Codegen flags have been consolidated behind a `-C` flag.
8773     * Linking against outdated crates now has improved error messages.
8774     * Error messages with lifetimes will often suggest how to annotate the
8775       function to fix the error.
8776     * Many more types are documented in the standard library, and new guides
8777       were written.
8778     * Many `rustdoc` improvements:
8779       * code blocks are syntax highlighted.
8780       * render standalone markdown files.
8781       * the --test flag tests all code blocks by default.
8782       * exported macros are displayed.
8783       * re-exported types have their documentation inlined at the location of the
8784         first re-export.
8785       * search works across crates that have been rendered to the same output
8786         directory.
8787
8788
8789 Version 0.9 (2014-01-09)
8790 ==========================
8791
8792    * ~1800 changes, numerous bugfixes
8793
8794    * Language
8795       * The `float` type has been removed. Use `f32` or `f64` instead.
8796       * A new facility for enabling experimental features (feature gating) has
8797         been added, using the crate-level `#[feature(foo)]` attribute.
8798       * Managed boxes (@) are now behind a feature gate
8799         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
8800         standard library's `Gc` or `Rc` types instead.
8801       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
8802       * Jumping back to the top of a loop is now done with `continue` instead of
8803         `loop`.
8804       * Strings can no longer be mutated through index assignment.
8805       * Raw strings can be created via the basic `r"foo"` syntax or with matched
8806         hash delimiters, as in `r###"foo"###`.
8807       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
8808         called once.
8809       * The `&fn` type is now written `|args| -> ret` to match the literal form.
8810       * `@fn`s have been removed.
8811       * `do` only works with procs in order to make it obvious what the cost
8812         of `do` is.
8813       * Single-element tuple-like structs can no longer be dereferenced to
8814         obtain the inner value. A more comprehensive solution for overloading
8815         the dereference operator will be provided in the future.
8816       * The `#[link(...)]` attribute has been replaced with
8817         `#[crate_id = "name#vers"]`.
8818       * Empty `impl`s must be terminated with empty braces and may not be
8819         terminated with a semicolon.
8820       * Keywords are no longer allowed as lifetime names; the `self` lifetime
8821         no longer has any special meaning.
8822       * The old `fmt!` string formatting macro has been removed.
8823       * `printf!` and `printfln!` (old-style formatting) removed in favor of
8824         `print!` and `println!`.
8825       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
8826       * The `extern mod foo (name = "bar")` syntax has been removed. Use
8827         `extern mod foo = "bar"` instead.
8828       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
8829       * Macros can have attributes.
8830       * Macros can expand to items with attributes.
8831       * Macros can expand to multiple items.
8832       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
8833       * Comments may be nested.
8834       * Values automatically coerce to trait objects they implement, without
8835         an explicit `as`.
8836       * Enum discriminants are no longer an entire word but as small as needed to
8837         contain all the variants. The `repr` attribute can be used to override
8838         the discriminant size, as in `#[repr(int)]` for integer-sized, and
8839         `#[repr(C)]` to match C enums.
8840       * Non-string literals are not allowed in attributes (they never worked).
8841       * The FFI now supports variadic functions.
8842       * Octal numeric literals, as in `0o7777`.
8843       * The `concat!` syntax extension performs compile-time string concatenation.
8844       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
8845         removed as Rust no longer uses segmented stacks.
8846       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
8847       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
8848         not `*`; ignoring remaining fields of a struct is also done with `..`,
8849         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
8850       * `rustc` supports the "win64" calling convention via `extern "win64"`.
8851       * `rustc` supports the "system" calling convention, which defaults to the
8852         preferred convention for the target platform, "stdcall" on 32-bit Windows,
8853         "C" elsewhere.
8854       * The `type_overflow` lint (default: warn) checks literals for overflow.
8855       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
8856       * The `attribute_usage` lint (default: warn) warns about unknown
8857         attributes.
8858       * The `unknown_features` lint (default: warn) warns about unknown
8859         feature gates.
8860       * The `dead_code` lint (default: warn) checks for dead code.
8861       * Rust libraries can be linked statically to one another
8862       * `#[link_args]` is behind the `link_args` feature gate.
8863       * Native libraries are now linked with `#[link(name = "foo")]`
8864       * Native libraries can be statically linked to a rust crate
8865         (`#[link(name = "foo", kind = "static")]`).
8866       * Native OS X frameworks are now officially supported
8867         (`#[link(name = "foo", kind = "framework")]`).
8868       * The `#[thread_local]` attribute creates thread-local (not task-local)
8869         variables. Currently behind the `thread_local` feature gate.
8870       * The `return` keyword may be used in closures.
8871       * Types that can be copied via a memcpy implement the `Pod` kind.
8872       * The `cfg` attribute can now be used on struct fields and enum variants.
8873
8874    * Libraries
8875       * std: The `option` and `result` API's have been overhauled to make them
8876         simpler, more consistent, and more composable.
8877       * std: The entire `std::io` module has been replaced with one that is
8878         more comprehensive and that properly interfaces with the underlying
8879         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
8880         implemented.
8881       * std: `io::util` contains a number of useful implementations of
8882         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
8883         `ZeroReader`, `TeeReader`.
8884       * std: The reference counted pointer type `extra::rc` moved into std.
8885       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
8886         just a wrapper around it).
8887       * std: The `Either` type has been removed.
8888       * std: `fmt::Default` can be implemented for any type to provide default
8889         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
8890       * std: The `rand` API continues to be tweaked.
8891       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
8892         on failure in gdb, is now named `rust_fail`.
8893       * std: The `each_key` and `each_value` methods on `HashMap` have been
8894         replaced by the `keys` and `values` iterators.
8895       * std: Functions dealing with type size and alignment have moved from the
8896         `sys` module to the `mem` module.
8897       * std: The `path` module was written and API changed.
8898       * std: `str::from_utf8` has been changed to cast instead of allocate.
8899       * std: `starts_with` and `ends_with` methods added to vectors via the
8900         `ImmutableEqVector` trait, which is in the prelude.
8901       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
8902         if the index is out of bounds.
8903       * std: Task failure no longer propagates between tasks, as the model was
8904         complex, expensive, and incompatible with thread-based tasks.
8905       * std: The `Any` type can be used for dynamic typing.
8906       * std: `~Any` can be passed to the `fail!` macro and retrieved via
8907         `task::try`.
8908       * std: Methods that produce iterators generally do not have an `_iter`
8909         suffix now.
8910       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
8911         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
8912       * std: `util::ignore` renamed to `prelude::drop`.
8913       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
8914         trait.
8915       * std: `vec::raw` has seen a lot of cleanup and API changes.
8916       * std: The standard library no longer includes any C++ code, and very
8917         minimal C, eliminating the dependency on libstdc++.
8918       * std: Runtime scheduling and I/O functionality has been factored out into
8919         extensible interfaces and is now implemented by two different crates:
8920         libnative, for native threading and I/O; and libgreen, for green threading
8921         and I/O. This paves the way for using the standard library in more limited
8922         embedded environments.
8923       * std: The `comm` module has been rewritten to be much faster, have a
8924         simpler, more consistent API, and to work for both native and green
8925         threading.
8926       * std: All libuv dependencies have been moved into the rustuv crate.
8927       * native: New implementations of runtime scheduling on top of OS threads.
8928       * native: New native implementations of TCP, UDP, file I/O, process spawning,
8929         and other I/O.
8930       * green: The green thread scheduler and message passing types are almost
8931         entirely lock-free.
8932       * extra: The `flatpipes` module had bitrotted and was removed.
8933       * extra: All crypto functions have been removed and Rust now has a policy of
8934         not reimplementing crypto in the standard library. In the future crypto
8935         will be provided by external crates with bindings to established libraries.
8936       * extra: `c_vec` has been modernized.
8937       * extra: The `sort` module has been removed. Use the `sort` method on
8938         mutable slices.
8939
8940    * Tooling
8941       * The `rust` and `rusti` commands have been removed, due to lack of
8942         maintenance.
8943       * `rustdoc` was completely rewritten.
8944       * `rustdoc` can test code examples in documentation.
8945       * `rustpkg` can test packages with the argument, 'test'.
8946       * `rustpkg` supports arbitrary dependencies, including C libraries.
8947       * `rustc`'s support for generating debug info is improved again.
8948       * `rustc` has better error reporting for unbalanced delimiters.
8949       * `rustc`'s JIT support was removed due to bitrot.
8950       * Executables and static libraries can be built with LTO (-Z lto)
8951       * `rustc` adds a `--dep-info` flag for communicating dependencies to
8952         build tools.
8953
8954
8955 Version 0.8 (2013-09-26)
8956 ============================
8957
8958    * ~2200 changes, numerous bugfixes
8959
8960    * Language
8961       * The `for` loop syntax has changed to work with the `Iterator` trait.
8962       * At long last, unwinding works on Windows.
8963       * Default methods are ready for use.
8964       * Many trait inheritance bugs fixed.
8965       * Owned and borrowed trait objects work more reliably.
8966       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
8967       * rustc can omit emission of code for the `debug!` macro if it is passed
8968         `--cfg ndebug`
8969       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
8970         for foo.rs, then foo/mod.rs, and will generate an error when both are
8971         present.
8972       * Strings no longer contain trailing nulls. The new `std::c_str` module
8973         provides new mechanisms for converting to C strings.
8974       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
8975       * The FFI has been overhauled such that foreign functions are called directly,
8976         instead of through a stack-switching wrapper.
8977       * Calling a foreign function must be done through a Rust function with the
8978         `#[fixed_stack_segment]` attribute.
8979       * The `externfn!` macro can be used to declare both a foreign function and
8980         a `#[fixed_stack_segment]` wrapper at once.
8981       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
8982       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
8983       * `priv` is disallowed everywhere except for struct fields and enum variants.
8984       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
8985       * `ref` bindings in irrefutable patterns work correctly now.
8986       * `char` is now prevented from containing invalid code points.
8987       * Casting to `bool` is no longer allowed.
8988       * `\0` is now accepted as an escape in chars and strings.
8989       * `yield` is a reserved keyword.
8990       * `typeof` is a reserved keyword.
8991       * Crates may be imported by URL with `extern mod foo = "url";`.
8992       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
8993       * Static vectors can be initialized with repeating elements,
8994         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
8995       * Static structs can be initialized with functional record update,
8996         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
8997       * `cfg!` can be used to conditionally execute code based on the crate
8998         configuration, similarly to `#[cfg(...)]`.
8999       * The `unnecessary_qualification` lint detects unneeded module
9000         prefixes (default: allow).
9001       * Arithmetic operations have been implemented on the SIMD types in
9002         `std::unstable::simd`.
9003       * Exchange allocation headers were removed, reducing memory usage.
9004       * `format!` implements a completely new, extensible, and higher-performance
9005         string formatting system. It will replace `fmt!`.
9006       * `print!` and `println!` write formatted strings (using the `format!`
9007         extension) to stdout.
9008       * `write!` and `writeln!` write formatted strings (using the `format!`
9009         extension) to the new Writers in `std::rt::io`.
9010       * The library section in which a function or static is placed may
9011         be specified with `#[link_section = "..."]`.
9012       * The `proto!` syntax extension for defining bounded message protocols
9013         was removed.
9014       * `macro_rules!` is hygienic for `let` declarations.
9015       * The `#[export_name]` attribute specifies the name of a symbol.
9016       * `unreachable!` can be used to indicate unreachable code, and fails
9017         if executed.
9018
9019    * Libraries
9020       * std: Transitioned to the new runtime, written in Rust.
9021       * std: Added an experimental I/O library, `rt::io`, based on the new
9022         runtime.
9023       * std: A new generic `range` function was added to the prelude, replacing
9024         `uint::range` and friends.
9025       * std: `range_rev` no longer exists. Since range is an iterator it can be
9026         reversed with `range(lo, hi).invert()`.
9027       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
9028         renamed to `unwrap_or`.
9029       * std: The `iterator` module was renamed to `iter`.
9030       * std: Integral types now support the `checked_add`, `checked_sub`, and
9031         `checked_mul` operations for detecting overflow.
9032       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
9033         consistency.
9034       * std: Methods are standardizing on conventions for casting methods:
9035         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
9036         and cheap casts.
9037       * std: The `CString` type in `c_str` provides new ways to convert to and
9038         from C strings.
9039       * std: `DoubleEndedIterator` can yield elements in two directions.
9040       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
9041         two splices.
9042       * std: `str::from_bytes` renamed to `str::from_utf8`.
9043       * std: `pop_opt` and `shift_opt` methods added to vectors.
9044       * std: The task-local data interface no longer uses @, and keys are
9045         no longer function pointers.
9046       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
9047       * std: Added `SharedPort` to `comm`.
9048       * std: `Eq` has a default method for `ne`; only `eq` is required
9049         in implementations.
9050       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
9051         is required in implementations.
9052       * std: `is_utf8` performance is improved, impacting many string functions.
9053       * std: `os::MemoryMap` provides cross-platform mmap.
9054       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
9055         are not 'in-bounds' are considered undefined.
9056       * std: Many freestanding functions in `vec` removed in favor of methods.
9057       * std: Many freestanding functions on scalar types removed in favor of
9058         methods.
9059       * std: Many options to task builders were removed since they don't make
9060         sense in the new scheduler design.
9061       * std: More containers implement `FromIterator` so can be created by the
9062         `collect` method.
9063       * std: More complete atomic types in `unstable::atomics`.
9064       * std: `comm::PortSet` removed.
9065       * std: Mutating methods in the `Set` and `Map` traits have been moved into
9066         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
9067         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
9068         default implementations.
9069       * std: Various `from_str` functions were removed in favor of a generic
9070         `from_str` which is available in the prelude.
9071       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
9072       * extra: `dlist`, the doubly-linked list was modernized.
9073       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
9074       * extra: Added `glob` module, replacing `std::os::glob`.
9075       * extra: `rope` was removed.
9076       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
9077       * extra: `net`, and `timer` were removed. The experimental replacements
9078         are `std::rt::io::net` and `std::rt::io::timer`.
9079       * extra: Iterators implemented for `SmallIntMap`.
9080       * extra: Iterators implemented for `Bitv` and `BitvSet`.
9081       * extra: `SmallIntSet` removed. Use `BitvSet`.
9082       * extra: Performance of JSON parsing greatly improved.
9083       * extra: `semver` updated to SemVer 2.0.0.
9084       * extra: `term` handles more terminals correctly.
9085       * extra: `dbg` module removed.
9086       * extra: `par` module removed.
9087       * extra: `future` was cleaned up, with some method renames.
9088       * extra: Most free functions in `getopts` were converted to methods.
9089
9090    * Other
9091       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
9092       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
9093         similarly to gcc's `--march` flag.
9094       * rustc's performance compiling small crates is much better.
9095       * rustpkg has received many improvements.
9096       * rustpkg supports git tags as package IDs.
9097       * rustpkg builds into target-specific directories so it can be used for
9098         cross-compiling.
9099       * The number of concurrent test tasks is controlled by the environment
9100         variable RUST_TEST_TASKS.
9101       * The test harness can now report metrics for benchmarks.
9102       * All tools have man pages.
9103       * Programs compiled with `--test` now support the `-h` and `--help` flags.
9104       * The runtime uses jemalloc for allocations.
9105       * Segmented stacks are temporarily disabled as part of the transition to
9106         the new runtime. Stack overflows are possible!
9107       * A new documentation backend, rustdoc_ng, is available for use. It is
9108         still invoked through the normal `rustdoc` command.
9109
9110
9111 Version 0.7 (2013-07-03)
9112 =======================
9113
9114    * ~2000 changes, numerous bugfixes
9115
9116    * Language
9117       * `impl`s no longer accept a visibility qualifier. Put them on methods
9118         instead.
9119       * The borrow checker has been rewritten with flow-sensitivity, fixing
9120         many bugs and inconveniences.
9121       * The `self` parameter no longer implicitly means `&'self self`,
9122         and can be explicitly marked with a lifetime.
9123       * Overloadable compound operators (`+=`, etc.) have been temporarily
9124         removed due to bugs.
9125       * The `for` loop protocol now requires `for`-iterators to return `bool`
9126         so they compose better.
9127       * The `Durable` trait is replaced with the `'static` bounds.
9128       * Trait default methods work more often.
9129       * Structs with the `#[packed]` attribute have byte alignment and
9130         no padding between fields.
9131       * Type parameters bound by `Copy` must now be copied explicitly with
9132         the `copy` keyword.
9133       * It is now illegal to move out of a dereferenced unsafe pointer.
9134       * `Option<~T>` is now represented as a nullable pointer.
9135       * `@mut` does dynamic borrow checks correctly.
9136       * The `main` function is only detected at the topmost level of the crate.
9137         The `#[main]` attribute is still valid anywhere.
9138       * Struct fields may no longer be mutable. Use inherited mutability.
9139       * The `#[no_send]` attribute makes a type that would otherwise be
9140         `Send`, not.
9141       * The `#[no_freeze]` attribute makes a type that would otherwise be
9142         `Freeze`, not.
9143       * Unbounded recursion will abort the process after reaching the limit
9144         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
9145       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
9146         are never implicitly copyable.
9147       * `#[static_assert]` makes compile-time assertions about static bools.
9148       * At long last, 'argument modes' no longer exist.
9149       * The rarely used `use mod` statement no longer exists.
9150
9151    * Syntax extensions
9152       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
9153         argument list.
9154       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
9155         `Rand`, `Zero` and `ToStr` can all be automatically derived with
9156         `#[deriving(...)]`.
9157       * The `bytes!` macro returns a vector of bytes for string, u8, char,
9158         and unsuffixed integer literals.
9159
9160    * Libraries
9161       * The `core` crate was renamed to `std`.
9162       * The `std` crate was renamed to `extra`.
9163       * More and improved documentation.
9164       * std: `iterator` module for external iterator objects.
9165       * Many old-style (internal, higher-order function) iterators replaced by
9166         implementations of `Iterator`.
9167       * std: Many old internal vector and string iterators,
9168         incl. `any`, `all`. removed.
9169       * std: The `finalize` method of `Drop` renamed to `drop`.
9170       * std: The `drop` method now takes `&mut self` instead of `&self`.
9171       * std: The prelude no longer re-exports any modules, only types and traits.
9172       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
9173         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
9174       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
9175         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
9176       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
9177         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
9178       * std: Many types implement `Clone`.
9179       * std: `path` type renamed to `Path`.
9180       * std: `mut` module and `Mut` type removed.
9181       * std: Many standalone functions removed in favor of methods and iterators
9182         in `vec`, `str`. In the future methods will also work as functions.
9183       * std: `reinterpret_cast` removed. Use `transmute`.
9184       * std: ascii string handling in `std::ascii`.
9185       * std: `Rand` is implemented for ~/@.
9186       * std: `run` module for spawning processes overhauled.
9187       * std: Various atomic types added to `unstable::atomic`.
9188       * std: Various types implement `Zero`.
9189       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
9190       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
9191       * std: Added `os::mkdir_recursive`.
9192       * std: Added `os::glob` function performs filesystems globs.
9193       * std: `FuzzyEq` renamed to `ApproxEq`.
9194       * std: `Map` now defines `pop` and `swap` methods.
9195       * std: `Cell` constructors converted to static methods.
9196       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
9197       * extra: `flate` module moved from `std` to `extra`.
9198       * extra: `fileinput` module for iterating over a series of files.
9199       * extra: `Complex` number type and `complex` module.
9200       * extra: `Rational` number type and `rational` module.
9201       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
9202       * extra: `term` uses terminfo now, is more correct.
9203       * extra: `arc` functions converted to methods.
9204       * extra: Implementation of fixed output size variations of SHA-2.
9205
9206    * Tooling
9207       * `unused_variables` lint mode for unused variables (default: warn).
9208       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
9209         (default: warn).
9210       * `unused_mut` lint mode for identifying unused `mut` qualifiers
9211         (default: warn).
9212       * `dead_assignment` lint mode for unread variables (default: warn).
9213       * `unnecessary_allocation` lint mode detects some heap allocations that are
9214         immediately borrowed so could be written without allocating (default: warn).
9215       * `missing_doc` lint mode (default: allow).
9216       * `unreachable_code` lint mode (default: warn).
9217       * The `rusti` command has been rewritten and a number of bugs addressed.
9218       * rustc outputs in color on more terminals.
9219       * rustc accepts a `--link-args` flag to pass arguments to the linker.
9220       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
9221       * Compiling with `-g` will make the binary record information about
9222         dynamic borrowcheck failures for debugging.
9223       * rustdoc has a nicer stylesheet.
9224       * Various improvements to rustdoc.
9225       * Improvements to rustpkg (see the detailed release notes).
9226
9227
9228 Version 0.6 (2013-04-03)
9229 ========================
9230
9231    * ~2100 changes, numerous bugfixes
9232
9233    * Syntax changes
9234       * The self type parameter in traits is now spelled `Self`
9235       * The `self` parameter in trait and impl methods must now be explicitly
9236         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
9237       * Static methods no longer require the `static` keyword and instead
9238         are distinguished by the lack of a `self` parameter
9239       * Replaced the `Durable` trait with the `'static` lifetime
9240       * The old closure type syntax with the trailing sigil has been
9241         removed in favor of the more consistent leading sigil
9242       * `super` is a keyword, and may be prefixed to paths
9243       * Trait bounds are separated with `+` instead of whitespace
9244       * Traits are implemented with `impl Trait for Type`
9245         instead of `impl Type: Trait`
9246       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
9247       * The `export` keyword has finally been removed
9248       * The `move` keyword has been removed (see "Semantic changes")
9249       * The interior mutability qualifier on vectors, `[mut T]`, has been
9250         removed. Use `&mut [T]`, etc.
9251       * `mut` is no longer valid in `~mut T`. Use inherited mutability
9252       * `fail` is no longer a keyword. Use `fail!()`
9253       * `assert` is no longer a keyword. Use `assert!()`
9254       * `log` is no longer a keyword. use `debug!`, etc.
9255       * 1-tuples may be represented as `(T,)`
9256       * Struct fields may no longer be `mut`. Use inherited mutability,
9257         `@mut T`, `core::mut` or `core::cell`
9258       * `extern mod { ... }` is no longer valid syntax for foreign
9259         function modules. Use extern blocks: `extern { ... }`
9260       * Newtype enums removed. Use tuple-structs.
9261       * Trait implementations no longer support visibility modifiers
9262       * Pattern matching over vectors improved and expanded
9263       * `const` renamed to `static` to correspond to lifetime name,
9264         and make room for future `static mut` unsafe mutable globals.
9265       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
9266       * `Clone` implementations can be automatically generated with
9267         `#[deriving(Clone)]`
9268       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
9269         instead of `foo as Bar`.
9270       * Fixed length vector types are now written as `[int, .. 3]`
9271         instead of `[int * 3]`.
9272       * Fixed length vector types can express the length as a constant
9273         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
9274
9275    * Semantic changes
9276       * Types with owned pointers or custom destructors move by default,
9277         eliminating the `move` keyword
9278       * All foreign functions are considered unsafe
9279       * &mut is now unaliasable
9280       * Writes to borrowed @mut pointers are prevented dynamically
9281       * () has size 0
9282       * The name of the main function can be customized using #[main]
9283       * The default type of an inferred closure is &fn instead of @fn
9284       * `use` statements may no longer be "chained" - they cannot import
9285         identifiers imported by previous `use` statements
9286       * `use` statements are crate relative, importing from the "top"
9287         of the crate by default. Paths may be prefixed with `super::`
9288         or `self::` to change the search behavior.
9289       * Method visibility is inherited from the implementation declaration
9290       * Structural records have been removed
9291       * Many more types can be used in static items, including enums
9292         'static-lifetime pointers and vectors
9293       * Pattern matching over vectors improved and expanded
9294       * Typechecking of closure types has been overhauled to
9295         improve inference and eliminate unsoundness
9296       * Macros leave scope at the end of modules, unless that module is
9297         tagged with #[macro_escape]
9298
9299    * Libraries
9300       * Added big integers to `std::bigint`
9301       * Removed `core::oldcomm` module
9302       * Added pipe-based `core::comm` module
9303       * Numeric traits have been reorganized under `core::num`
9304       * `vec::slice` finally returns a slice
9305       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
9306       * Containers reorganized around traits in `core::container`
9307       * `core::dvec` removed, `~[T]` is a drop-in replacement
9308       * `core::send_map` renamed to `core::hashmap`
9309       * `std::map` removed; replaced with `core::hashmap`
9310       * `std::treemap` reimplemented as an owned balanced tree
9311       * `std::deque` and `std::smallintmap` reimplemented as owned containers
9312       * `core::trie` added as a fast ordered map for integer keys
9313       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
9314       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
9315         overload the comparison operators, whereas `TotalOrd` is used
9316         by certain container types
9317
9318    * Other
9319       * Replaced the 'cargo' package manager with 'rustpkg'
9320       * Added all-purpose 'rust' tool
9321       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
9322       * rustc now *attempts* to offer spelling suggestions
9323       * Improved support for ARM and Android
9324       * Preliminary MIPS backend
9325       * Improved foreign function ABI implementation for x86, x86_64
9326       * Various memory usage improvements
9327       * Rust code may be embedded in foreign code under limited circumstances
9328       * Inline assembler supported by new asm!() syntax extension.
9329
9330
9331 Version 0.5 (2012-12-21)
9332 ===========================
9333
9334    * ~900 changes, numerous bugfixes
9335
9336    * Syntax changes
9337       * Removed `<-` move operator
9338       * Completed the transition from the `#fmt` extension syntax to `fmt!`
9339       * Removed old fixed length vector syntax - `[T]/N`
9340       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
9341       * Macros may now expand to items and statements
9342       * `a.b()` is always parsed as a method call, never as a field projection
9343       * `Eq` and `IterBytes` implementations can be automatically generated
9344         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
9345       * Removed the special crate language for `.rc` files
9346       * Function arguments may consist of any irrefutable pattern
9347
9348    * Semantic changes
9349       * `&` and `~` pointers may point to objects
9350       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
9351       * Enum variants may be structs
9352       * Destructors can be added to all nominal types with the Drop trait
9353       * Structs and nullary enum variants may be constants
9354       * Values that cannot be implicitly copied are now automatically moved
9355         without writing `move` explicitly
9356       * `&T` may now be coerced to `*T`
9357       * Coercions happen in `let` statements as well as function calls
9358       * `use` statements now take crate-relative paths
9359       * The module and type namespaces have been merged so that static
9360         method names can be resolved under the trait in which they are
9361         declared
9362
9363    * Improved support for language features
9364       * Trait inheritance works in many scenarios
9365       * More support for explicit self arguments in methods - `self`, `&self`
9366         `@self`, and `~self` all generally work as expected
9367       * Static methods work in more situations
9368       * Experimental: Traits may declare default methods for the implementations
9369         to use
9370
9371    * Libraries
9372       * New condition handling system in `core::condition`
9373       * Timsort added to `std::sort`
9374       * New priority queue, `std::priority_queue`
9375       * Pipes for serializable types, `std::flatpipes'
9376       * Serialization overhauled to be trait-based
9377       * Expanded `getopts` definitions
9378       * Moved futures to `std`
9379       * More functions are pure now
9380       * `core::comm` renamed to `oldcomm`. Still deprecated
9381       * `rustdoc` and `cargo` are libraries now
9382
9383    * Misc
9384       * Added a preliminary REPL, `rusti`
9385       * License changed from MIT to dual MIT/APL2
9386
9387
9388 Version 0.4 (2012-10-15)
9389 ==========================
9390
9391    * ~2000 changes, numerous bugfixes
9392
9393    * Syntax
9394       * All keywords are now strict and may not be used as identifiers anywhere
9395       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
9396         'of', 'with', 'to', 'class'.
9397       * Classes are replaced with simpler structs
9398       * Explicit method self types
9399       * `ret` became `return` and `alt` became `match`
9400       * `import` is now `use`; `use is now `extern mod`
9401       * `extern mod { ... }` is now `extern { ... }`
9402       * `use mod` is the recommended way to import modules
9403       * `pub` and `priv` replace deprecated export lists
9404       * The syntax of `match` pattern arms now uses fat arrow (=>)
9405       * `main` no longer accepts an args vector; use `os::args` instead
9406
9407    * Semantics
9408       * Trait implementations are now coherent, ala Haskell typeclasses
9409       * Trait methods may be static
9410       * Argument modes are deprecated
9411       * Borrowed pointers are much more mature and recommended for use
9412       * Strings and vectors in the static region are stored in constant memory
9413       * Typestate was removed
9414       * Resolution rewritten to be more reliable
9415       * Support for 'dual-mode' data structures (freezing and thawing)
9416
9417    * Libraries
9418       * Most binary operators can now be overloaded via the traits in
9419         `core::ops'
9420       * `std::net::url` for representing URLs
9421       * Sendable hash maps in `core::send_map`
9422       * `core::task' gained a (currently unsafe) task-local storage API
9423
9424    * Concurrency
9425       * An efficient new intertask communication primitive called the pipe,
9426         along with a number of higher-level channel types, in `core::pipes`
9427       * `std::arc`, an atomically reference counted, immutable, shared memory
9428         type
9429       * `std::sync`, various exotic synchronization tools based on arcs and pipes
9430       * Futures are now based on pipes and sendable
9431       * More robust linked task failure
9432       * Improved task builder API
9433
9434    * Other
9435       * Improved error reporting
9436       * Preliminary JIT support
9437       * Preliminary work on precise GC
9438       * Extensive architectural improvements to rustc
9439       * Begun a transition away from buggy C++-based reflection (shape) code to
9440         Rust-based (visitor) code
9441       * All hash functions and tables converted to secure, randomized SipHash
9442
9443
9444 Version 0.3  (2012-07-12)
9445 ========================
9446
9447    * ~1900 changes, numerous bugfixes
9448
9449    * New coding conveniences
9450       * Integer-literal suffix inference
9451       * Per-item control over warnings, errors
9452       * #[cfg(windows)] and #[cfg(unix)] attributes
9453       * Documentation comments
9454       * More compact closure syntax
9455       * 'do' expressions for treating higher-order functions as
9456         control structures
9457       * *-patterns (wildcard extended to all constructor fields)
9458
9459    * Semantic cleanup
9460       * Name resolution pass and exhaustiveness checker rewritten
9461       * Region pointers and borrow checking supersede alias
9462         analysis
9463       * Init-ness checking is now provided by a region-based liveness
9464         pass instead of the typestate pass; same for last-use analysis
9465       * Extensive work on region pointers
9466
9467    * Experimental new language features
9468       * Slices and fixed-size, interior-allocated vectors
9469       * #!-comments for lang versioning, shell execution
9470       * Destructors and iface implementation for classes;
9471         type-parameterized classes and class methods
9472       * 'const' type kind for types that can be used to implement
9473         shared-memory concurrency patterns
9474
9475    * Type reflection
9476
9477    * Removal of various obsolete features
9478       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
9479                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
9480
9481       * Constructs: do-while loops ('do' repurposed), fn binding,
9482                     resources (replaced by destructors)
9483
9484    * Compiler reorganization
9485       * Syntax-layer of compiler split into separate crate
9486       * Clang (from LLVM project) integrated into build
9487       * Typechecker split into sub-modules
9488
9489    * New library code
9490       * New time functions
9491       * Extension methods for many built-in types
9492       * Arc: atomic-refcount read-only / exclusive-use shared cells
9493       * Par: parallel map and search routines
9494       * Extensive work on libuv interface
9495       * Much vector code moved to libraries
9496       * Syntax extensions: #line, #col, #file, #mod, #stringify,
9497         #include, #include_str, #include_bin
9498
9499    * Tool improvements
9500       * Cargo automatically resolves dependencies
9501
9502
9503 Version 0.2  (2012-03-29)
9504 =========================
9505
9506    * >1500 changes, numerous bugfixes
9507
9508    * New docs and doc tooling
9509
9510    * New port: FreeBSD x86_64
9511
9512    * Compilation model enhancements
9513       * Generics now specialized, multiply instantiated
9514       * Functions now inlined across separate crates
9515
9516    * Scheduling, stack and threading fixes
9517       * Noticeably improved message-passing performance
9518       * Explicit schedulers
9519       * Callbacks from C
9520       * Helgrind clean
9521
9522    * Experimental new language features
9523       * Operator overloading
9524       * Region pointers
9525       * Classes
9526
9527    * Various language extensions
9528       * C-callback function types: 'crust fn ...'
9529       * Infinite-loop construct: 'loop { ... }'
9530       * Shorten 'mutable' to 'mut'
9531       * Required mutable-local qualifier: 'let mut ...'
9532       * Basic glob-exporting: 'export foo::*;'
9533       * Alt now exhaustive, 'alt check' for runtime-checked
9534       * Block-function form of 'for' loop, with 'break' and 'ret'.
9535
9536    * New library code
9537       * AST quasi-quote syntax extension
9538       * Revived libuv interface
9539       * New modules: core::{future, iter}, std::arena
9540       * Merged per-platform std::{os*, fs*} to core::{libc, os}
9541       * Extensive cleanup, regularization in libstd, libcore
9542
9543
9544 Version 0.1  (2012-01-20)
9545 ===============================
9546
9547    * Most language features work, including:
9548       * Unique pointers, unique closures, move semantics
9549       * Interface-constrained generics
9550       * Static interface dispatch
9551       * Stack growth
9552       * Multithread task scheduling
9553       * Typestate predicates
9554       * Failure unwinding, destructors
9555       * Pattern matching and destructuring assignment
9556       * Lightweight block-lambda syntax
9557       * Preliminary macro-by-example
9558
9559    * Compiler works with the following configurations:
9560       * Linux: x86 and x86_64 hosts and targets
9561       * macOS: x86 and x86_64 hosts and targets
9562       * Windows: x86 hosts and targets
9563
9564    * Cross compilation / multi-target configuration supported.
9565
9566    * Preliminary API-documentation and package-management tools included.
9567
9568 Known issues:
9569
9570    * Documentation is incomplete.
9571
9572    * Performance is below intended target.
9573
9574    * Standard library APIs are subject to extensive change, reorganization.
9575
9576    * Language-level versioning is not yet operational - future code will
9577      break unexpectedly.