RELEASES.md

   1 Version 1.48.0 (2020-11-19)
   2 ==========================
   3
   4 Language
   5 --------
   6
   7 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
   8   is still rejected *semantically*, but can now be parsed by procedural macros.
   9
  10 Compiler
  11 --------
  12 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
  13   `rustc` whether to link its own C runtime and libraries or to rely on a external
  14   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
  15 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
  16   Note: If you're using cargo you must explicitly pass the `--target` flag.
  17 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
  18
  19 \* Refer to Rust's [platform support page][forge-platform-support] for more
  20 information on Rust's tiered platform support.
  21
  22 Libraries
  23 ---------
  24 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
  25   and `&Stderr`.][76275]
  26 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
  27 - [The `matches!` macro now supports having a trailing comma.][74880]
  28 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
  29 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
  30
  31 Stabilized APIs
  32 ---------------
  33 - [`slice::as_ptr_range`]
  34 - [`slice::as_mut_ptr_range`]
  35 - [`VecDeque::make_contiguous`]
  36 - [`future::pending`]
  37 - [`future::ready`]
  38
  39 The following previously stable methods are now `const fn`'s:
  40
  41 - [`Option::is_some`]
  42 - [`Option::is_none`]
  43 - [`Option::as_ref`]
  44 - [`Result::is_ok`]
  45 - [`Result::is_err`]
  46 - [`Result::as_ref`]
  47 - [`Ordering::reverse`]
  48 - [`Ordering::then`]
  49
  50 Cargo
  51 -----
  52
  53 Rustdoc
  54 -------
  55 - [You can now link to items in `rustdoc` using the intra-doc link
  56   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
  57   a link to `std::future`'s documentation. See ["Linking to items by
  58   name"][intradoc-links] for more information.
  59 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
  60   when searching through `rustdoc`'s UI.][75740]
  61
  62 Compatibility Notes
  63 -------------------
  64 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
  65   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
  66   promoted to `'static` lifetime any more inside `const fn`s.
  67 - [Associated type bindings on trait objects are now verified to meet the bounds
  68   declared on the trait when checking that they implement the trait.][27675]
  69 - [When trait bounds on associated types or opaque types are ambiguous, the
  70   compiler no longer makes an arbitrary choice on which bound to use.][54121]
  71 - [Fixed recursive nonterminals not being expanded in macros during
  72   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
  73   correctly handling recursive nonterminal tokens.
  74 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
  75 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
  76   in places where they have no effect.][73461]
  77 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
  78   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
  79 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
  80   disallow zero-initialization.][71274]
  81 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
  82 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
  83   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
  84   see the [`catch_unwind`] documentation for further information.
  85
  86
  87
  88 Internal Only
  89 -------------
  90 These changes provide no direct user facing benefits, but represent significant
  91 improvements to the internals and overall performance of rustc and
  92 related tools.
  93
  94 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
  95   You can continue building with `make` by setting `ninja=false` in
  96   your `config.toml`.
  97 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
  98 - [Made `ensure_sufficient_stack()` non-generic][76680]
  99
 100 [78143]: https://github.com/rust-lang/rust/issues/78143
 101 [76680]: https://github.com/rust-lang/rust/pull/76680/
 102 [76030]: https://github.com/rust-lang/rust/pull/76030/
 103 [70212]: https://github.com/rust-lang/rust/pull/70212/
 104 [27675]: https://github.com/rust-lang/rust/issues/27675/
 105 [54121]: https://github.com/rust-lang/rust/issues/54121/
 106 [71274]: https://github.com/rust-lang/rust/pull/71274/
 107 [77386]: https://github.com/rust-lang/rust/pull/77386/
 108 [77153]: https://github.com/rust-lang/rust/pull/77153/
 109 [77055]: https://github.com/rust-lang/rust/pull/77055/
 110 [76275]: https://github.com/rust-lang/rust/pull/76275/
 111 [76310]: https://github.com/rust-lang/rust/pull/76310/
 112 [76420]: https://github.com/rust-lang/rust/pull/76420/
 113 [76158]: https://github.com/rust-lang/rust/pull/76158/
 114 [75857]: https://github.com/rust-lang/rust/pull/75857/
 115 [75585]: https://github.com/rust-lang/rust/pull/75585/
 116 [75740]: https://github.com/rust-lang/rust/pull/75740/
 117 [75502]: https://github.com/rust-lang/rust/pull/75502/
 118 [74880]: https://github.com/rust-lang/rust/pull/74880/
 119 [74922]: https://github.com/rust-lang/rust/pull/74922/
 120 [74430]: https://github.com/rust-lang/rust/pull/74430/
 121 [74194]: https://github.com/rust-lang/rust/pull/74194/
 122 [73461]: https://github.com/rust-lang/rust/pull/73461/
 123 [73166]: https://github.com/rust-lang/rust/pull/73166/
 124 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
 125 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
 126 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
 127 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
 128 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
 129 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
 130 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
 131 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
 132 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
 133 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
 134 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
 135 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
 136 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
 137 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
 138 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
 139
 140
 141 Version 1.47.0 (2020-10-08)
 142 ==========================
 143
 144 Language
 145 --------
 146 - [Closures will now warn when not used.][74869]
 147
 148 Compiler
 149 --------
 150 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
 151   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
 152   platforms.
 153 - [Upgraded to LLVM 11.][73526]
 154 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
 155 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
 156 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
 157
 158 \* Refer to Rust's [platform support page][forge-platform-support] for more
 159 information on Rust's tiered platform support.
 160
 161 Libraries
 162 ---------
 163 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
 164 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
 165   those of length less than 33.][74060]
 166 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
 167 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
 168   `PartialEq`, and `PartialOrd`.][73583]
 169
 170 Stabilized APIs
 171 ---------------
 172 - [`Ident::new_raw`]
 173 - [`Range::is_empty`]
 174 - [`RangeInclusive::is_empty`]
 175 - [`Result::as_deref`]
 176 - [`Result::as_deref_mut`]
 177 - [`Vec::leak`]
 178 - [`pointer::offset_from`]
 179 - [`f32::TAU`]
 180 - [`f64::TAU`]
 181
 182 The following previously stable APIs have now been made const.
 183
 184 - [The `new` method for all `NonZero` integers.][73858]
 185 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
 186   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
 187   methods for all integers.][73858]
 188 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
 189   signed integers.][73858]
 190 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
 191   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
 192   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
 193   `is_ascii_control` methods for `char` and `u8`.][73858]
 194
 195 Cargo
 196 -----
 197 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
 198   You can override this by setting the following in your `Cargo.toml`.
 199   ```toml
 200   [profile.release.build-override]
 201   opt-level = 3
 202   ```
 203 - [`cargo-help` will now display man pages for commands rather just the
 204   `--help` text.][cargo/8456]
 205 - [`cargo-metadata` now emits a `test` field indicating if a target has
 206   tests enabled.][cargo/8478]
 207 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
 208 - [`cargo-publish` will now use an alternative registry by default if it's the
 209   only registry specified in `package.publish`.][cargo/8571]
 210
 211 Misc
 212 ----
 213 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
 214   type based search.][75366]
 215 - [Added the Ayu theme to rustdoc.][71237]
 216
 217 Compatibility Notes
 218 -------------------
 219 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
 220 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
 221 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
 222   help to preserve more span information.][73084] These changes may cause
 223   compiliation errors if your macro was unhygenic or didn't correctly handle
 224   `Delimiter::None`.
 225 - [Moved support for the CloudABI target to tier 3.][75568]
 226 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
 227 - [Added the `rustc-docs` component.][75560] This allows you to install
 228   and read the documentation for the compiler internal APIs. (Currently only
 229   available for `x86_64-unknown-linux-gnu`.)
 230
 231 Internal Only
 232 --------
 233
 234 - [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.
 235
 236 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
 237 [75048]: https://github.com/rust-lang/rust/pull/75048/
 238 [74163]: https://github.com/rust-lang/rust/pull/74163/
 239 [71237]: https://github.com/rust-lang/rust/pull/71237/
 240 [74869]: https://github.com/rust-lang/rust/pull/74869/
 241 [73858]: https://github.com/rust-lang/rust/pull/73858/
 242 [75716]: https://github.com/rust-lang/rust/pull/75716/
 243 [75908]: https://github.com/rust-lang/rust/pull/75908/
 244 [75516]: https://github.com/rust-lang/rust/pull/75516/
 245 [75560]: https://github.com/rust-lang/rust/pull/75560/
 246 [75568]: https://github.com/rust-lang/rust/pull/75568/
 247 [75366]: https://github.com/rust-lang/rust/pull/75366/
 248 [75204]: https://github.com/rust-lang/rust/pull/75204/
 249 [74650]: https://github.com/rust-lang/rust/pull/74650/
 250 [74419]: https://github.com/rust-lang/rust/pull/74419/
 251 [73964]: https://github.com/rust-lang/rust/pull/73964/
 252 [74021]: https://github.com/rust-lang/rust/pull/74021/
 253 [74060]: https://github.com/rust-lang/rust/pull/74060/
 254 [73893]: https://github.com/rust-lang/rust/pull/73893/
 255 [73526]: https://github.com/rust-lang/rust/pull/73526/
 256 [73583]: https://github.com/rust-lang/rust/pull/73583/
 257 [73084]: https://github.com/rust-lang/rust/pull/73084/
 258 [73197]: https://github.com/rust-lang/rust/pull/73197/
 259 [72488]: https://github.com/rust-lang/rust/pull/72488/
 260 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
 261 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
 262 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
 263 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
 264 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
 265 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
 266 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
 267 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
 268 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
 269 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
 270 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
 271 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
 272 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
 273 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
 274 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
 275
 276
 277 Version 1.46.0 (2020-08-27)
 278 ==========================
 279
 280 Language
 281 --------
 282 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
 283 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
 284   const functions.][73862]
 285 - [The `#[track_caller]` attribute can now be added to functions to use the
 286   function's caller's location information for panic messages.][72445]
 287 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
 288   `x.0.0` over `(x.0).0`.
 289 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
 290   You currently can't use `mem::transmute` in constant functions.
 291
 292 Compiler
 293 --------
 294 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
 295 - [Enabled static "Position Independent Executables" by default
 296   for `x86_64-unknown-linux-musl`.][70740]
 297
 298 Libraries
 299 ---------
 300 - [`mem::forget` is now a `const fn`.][73887]
 301 - [`String` now implements `From<char>`.][73466]
 302 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
 303   integer types.][73032]
 304 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
 305 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
 306   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
 307 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
 308 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
 309 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
 310
 311 Stabilized APIs
 312 ---------------
 313 - [`Option::zip`]
 314 - [`vec::Drain::as_slice`]
 315
 316 Cargo
 317 -----
 318 Added a number of new environment variables that are now available when
 319 compiling your crate.
 320
 321 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
 322   the specific binary being compiled and the name of the crate.
 323 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
 324 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
 325
 326 Compatibility Notes
 327 -------------------
 328 - [The target configuration option `abi_blacklist` has been renamed
 329   to `unsupported_abis`.][74150] The old name will still continue to work.
 330 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
 331   This was previously accepted but will become a hard error in a future release.
 332 - [Rustc will fail to compile if you have a struct with
 333   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
 334   allowed on `enum`s.
 335 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
 336   ensure that spans have the correct information, and may cause breakage if you
 337   were relying on receiving spans with dummy information.
 338 - [The InnoSetup installer for Windows is no longer available.][72569] This was
 339   a legacy installer that was replaced by a MSI installer a few years ago but
 340   was still being built.
 341 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
 342 - [Rustc will no longer accept overlapping trait implementations that only
 343   differ in how the lifetime was bound.][72493]
 344 - [Rustc now correctly relates the lifetime of an existential associated
 345   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
 346   you to pass a shorter lifetime than expected.
 347 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
 348   The library will need to be installed for `rustc` to work, even though we
 349   expect it to be already available on most systems.
 350 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
 351   under QEMU.][74820]
 352 - [Pretty printing of some tokens in procedural macros changed.][75453] The
 353   exact output returned by rustc's pretty printing is an unstable
 354   implementation detail: we recommend any macro relying on it to switch to a
 355   more robust parsing system.
 356
 357 [75453]: https://github.com/rust-lang/rust/issues/75453/
 358 [74820]: https://github.com/rust-lang/rust/issues/74820/
 359 [74420]: https://github.com/rust-lang/rust/issues/74420/
 360 [74109]: https://github.com/rust-lang/rust/pull/74109/
 361 [74150]: https://github.com/rust-lang/rust/pull/74150/
 362 [73862]: https://github.com/rust-lang/rust/pull/73862/
 363 [73887]: https://github.com/rust-lang/rust/pull/73887/
 364 [73466]: https://github.com/rust-lang/rust/pull/73466/
 365 [73516]: https://github.com/rust-lang/rust/pull/73516/
 366 [73293]: https://github.com/rust-lang/rust/pull/73293/
 367 [73007]: https://github.com/rust-lang/rust/pull/73007/
 368 [73032]: https://github.com/rust-lang/rust/pull/73032/
 369 [72920]: https://github.com/rust-lang/rust/pull/72920/
 370 [72569]: https://github.com/rust-lang/rust/pull/72569/
 371 [72583]: https://github.com/rust-lang/rust/pull/72583/
 372 [72584]: https://github.com/rust-lang/rust/pull/72584/
 373 [72717]: https://github.com/rust-lang/rust/pull/72717/
 374 [72437]: https://github.com/rust-lang/rust/pull/72437/
 375 [72445]: https://github.com/rust-lang/rust/pull/72445/
 376 [72486]: https://github.com/rust-lang/rust/pull/72486/
 377 [72493]: https://github.com/rust-lang/rust/pull/72493/
 378 [72331]: https://github.com/rust-lang/rust/pull/72331/
 379 [71896]: https://github.com/rust-lang/rust/pull/71896/
 380 [71660]: https://github.com/rust-lang/rust/pull/71660/
 381 [71322]: https://github.com/rust-lang/rust/pull/71322/
 382 [70740]: https://github.com/rust-lang/rust/pull/70740/
 383 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
 384 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
 385 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
 386 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
 387 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
 388
 389
 390 Version 1.45.2 (2020-08-03)
 391 ==========================
 392
 393 * [Fix bindings in tuple struct patterns][74954]
 394 * [Fix track_caller integration with trait objects][74784]
 395
 396 [74954]: https://github.com/rust-lang/rust/issues/74954
 397 [74784]: https://github.com/rust-lang/rust/issues/74784
 398
 399
 400 Version 1.45.1 (2020-07-30)
 401 ==========================
 402
 403 * [Fix const propagation with references.][73613]
 404 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
 405 * [Avoid spurious implicit region bound.][74509]
 406 * [Install clippy on x.py install][74457]
 407
 408 [73613]: https://github.com/rust-lang/rust/pull/73613
 409 [73078]: https://github.com/rust-lang/rust/issues/73078
 410 [74509]: https://github.com/rust-lang/rust/pull/74509
 411 [74457]: https://github.com/rust-lang/rust/pull/74457
 412
 413
 414 Version 1.45.0 (2020-07-16)
 415 ==========================
 416
 417 Language
 418 --------
 419 - [Out of range float to int conversions using `as` has been defined as a saturating
 420   conversion.][71269] This was previously undefined behaviour, but you can use the
 421    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
 422    may be desirable in rare performance sensitive situations.
 423 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
 424   using `u64`.][70705]
 425 - [Function like procedural macros can now be used in expression, pattern, and  statement
 426   positions.][68717] This means you can now use a function-like procedural macro
 427   anywhere you can use a declarative (`macro_rules!`) macro.
 428
 429 Compiler
 430 --------
 431 - [You can now override individual target features through the `target-feature`
 432   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
 433   equivalent to `-C target-feature=+avx2,+fma`.
 434 - [Added the `force-unwind-tables` flag.][69984] This option allows
 435   rustc to always generate unwind tables regardless of panic strategy.
 436 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
 437   to include LLVM bitcode into generated `rlib`s (this is on by default).
 438 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
 439 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
 440 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
 441
 442 \* Refer to Rust's [platform support page][forge-platform-support] for more
 443 information on Rust's tiered platform support.
 444
 445
 446 Libraries
 447 ---------
 448 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
 449   and `Ord`.][72239]
 450 - [`proc_macro::TokenStream` now implements `Default`.][72234]
 451 - [You can now use `char` with
 452   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
 453   a range of codepoints.][72413] E.g.
 454   you can now write the following;
 455   ```rust
 456   for ch in 'a'..='z' {
 457       print!("{}", ch);
 458   }
 459   println!();
 460   // Prints "abcdefghijklmnopqrstuvwxyz"
 461   ```
 462 - [`OsString` now implements `FromStr`.][71662]
 463 - [The `saturating_neg` method has been added to all signed integer primitive
 464   types, and the `saturating_abs` method has been added for all integer
 465   primitive types.][71886]
 466 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
 467   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
 468   or `Path`.][71447]
 469 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
 470 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
 471   integer types.][69813]
 472 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
 473   integer types.][72324]
 474 - [The `fetch_update` method has been added to all atomic integer types.][71843]
 475
 476 Stabilized APIs
 477 ---------------
 478 - [`Arc::as_ptr`]
 479 - [`BTreeMap::remove_entry`]
 480 - [`Rc::as_ptr`]
 481 - [`rc::Weak::as_ptr`]
 482 - [`rc::Weak::from_raw`]
 483 - [`rc::Weak::into_raw`]
 484 - [`str::strip_prefix`]
 485 - [`str::strip_suffix`]
 486 - [`sync::Weak::as_ptr`]
 487 - [`sync::Weak::from_raw`]
 488 - [`sync::Weak::into_raw`]
 489 - [`char::UNICODE_VERSION`]
 490 - [`Span::resolved_at`]
 491 - [`Span::located_at`]
 492 - [`Span::mixed_site`]
 493 - [`unix::process::CommandExt::arg0`]
 494
 495 Cargo
 496 -----
 497
 498 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
 499   time.][cargo/8066]
 500
 501 Misc
 502 ----
 503 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
 504   `~~outdated information~~` becomes "~~outdated information~~".
 505 - [Added an emoji to Rustdoc's deprecated API message.][72014]
 506
 507 Compatibility Notes
 508 -------------------
 509 - [Trying to self initialize a static value (that is creating a value using
 510   itself) is unsound and now causes a compile error.][71140]
 511 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
 512   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
 513 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
 514   previously undocumented and not intended for public use. Rustdoc still provides
 515   a non-zero exit code on errors.
 516 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
 517   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
 518   flags while cargo is adding `embed-bitcode` itself. The recommended way to
 519   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
 520   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
 521
 522 Internals Only
 523 --------------
 524 - [Make clippy a git subtree instead of a git submodule][70655]
 525 - [Unify the undo log of all snapshot types][69464]
 526
 527 [71848]: https://github.com/rust-lang/rust/issues/71848/
 528 [73420]: https://github.com/rust-lang/rust/issues/73420/
 529 [72324]: https://github.com/rust-lang/rust/pull/72324/
 530 [71843]: https://github.com/rust-lang/rust/pull/71843/
 531 [71886]: https://github.com/rust-lang/rust/pull/71886/
 532 [72234]: https://github.com/rust-lang/rust/pull/72234/
 533 [72239]: https://github.com/rust-lang/rust/pull/72239/
 534 [72397]: https://github.com/rust-lang/rust/pull/72397/
 535 [72413]: https://github.com/rust-lang/rust/pull/72413/
 536 [72014]: https://github.com/rust-lang/rust/pull/72014/
 537 [72062]: https://github.com/rust-lang/rust/pull/72062/
 538 [72094]: https://github.com/rust-lang/rust/pull/72094/
 539 [72133]: https://github.com/rust-lang/rust/pull/72133/
 540 [71900]: https://github.com/rust-lang/rust/pull/71900/
 541 [71928]: https://github.com/rust-lang/rust/pull/71928/
 542 [71662]: https://github.com/rust-lang/rust/pull/71662/
 543 [71716]: https://github.com/rust-lang/rust/pull/71716/
 544 [71447]: https://github.com/rust-lang/rust/pull/71447/
 545 [71269]: https://github.com/rust-lang/rust/pull/71269/
 546 [71095]: https://github.com/rust-lang/rust/pull/71095/
 547 [71140]: https://github.com/rust-lang/rust/pull/71140/
 548 [70655]: https://github.com/rust-lang/rust/pull/70655/
 549 [70705]: https://github.com/rust-lang/rust/pull/70705/
 550 [69984]: https://github.com/rust-lang/rust/pull/69984/
 551 [69813]: https://github.com/rust-lang/rust/pull/69813/
 552 [69464]: https://github.com/rust-lang/rust/pull/69464/
 553 [68717]: https://github.com/rust-lang/rust/pull/68717/
 554 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
 555 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
 556 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
 557 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
 558 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
 559 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
 560 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
 561 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
 562 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
 563 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
 564 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
 565 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
 566 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
 567 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
 568 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
 569 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
 570 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
 571
 572
 573 Version 1.44.1 (2020-06-18)
 574 ===========================
 575
 576 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
 577 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
 578 * [Fix crashes when finding backtrace on macOS.][71397]
 579 * [Clippy applies lint levels into different files.][clippy/5356]
 580
 581 [71397]: https://github.com/rust-lang/rust/issues/71397
 582 [73078]: https://github.com/rust-lang/rust/issues/73078
 583 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
 584 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
 585
 586
 587 Version 1.44.0 (2020-06-04)
 588 ==========================
 589
 590 Language
 591 --------
 592 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
 593 - [Added the `unused_braces` lint.][70081]
 594
 595 **Syntax-only changes**
 596
 597 - [Expansion-driven outline module parsing][69838]
 598 ```rust
 599 #[cfg(FALSE)]
 600 mod foo {
 601     mod bar {
 602         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
 603     }
 604 }
 605 ```
 606
 607 These are still rejected semantically, so you will likely receive an error but
 608 these changes can be seen and parsed by macros and conditional compilation.
 609
 610 Compiler
 611 --------
 612 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
 613   Additionally when in incremental mode rustc defaults to 256 codegen units.
 614 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
 615   a panic is thrown.][67502]
 616 - [Added tier 3\* support for the `aarch64-unknown-none` and
 617   `aarch64-unknown-none-softfloat` targets.][68334]
 618 - [Added tier 3 support for `arm64-apple-tvos` and
 619   `x86_64-apple-tvos` targets.][68191]
 620
 621
 622 Libraries
 623 ---------
 624 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
 625   `vec![]` to be able to be used in `const` contexts.
 626 - [`convert::Infallible` now implements `Hash`.][70281]
 627 - [`OsString` now implements `DerefMut` and `IndexMut` returning
 628   a `&mut OsStr`.][70048]
 629 - [Unicode 13 is now supported.][69929]
 630 - [`String` now implements `From<&mut str>`.][69661]
 631 - [`IoSlice` now implements `Copy`.][69403]
 632 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
 633 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
 634 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
 635   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
 636   integer types.][69373]
 637
 638 Stabilized APIs
 639 ---------------
 640 - [`PathBuf::with_capacity`]
 641 - [`PathBuf::capacity`]
 642 - [`PathBuf::clear`]
 643 - [`PathBuf::reserve`]
 644 - [`PathBuf::reserve_exact`]
 645 - [`PathBuf::shrink_to_fit`]
 646 - [`f32::to_int_unchecked`]
 647 - [`f64::to_int_unchecked`]
 648 - [`Layout::align_to`]
 649 - [`Layout::pad_to_align`]
 650 - [`Layout::array`]
 651 - [`Layout::extend`]
 652
 653 Cargo
 654 -----
 655 - [Added the `cargo tree` command which will print a tree graph of
 656   your dependencies.][cargo/8062] E.g.
 657   ```
 658     mdbook v0.3.2 (/Users/src/rust/mdbook)
 659   ├── ammonia v3.0.0
 660   │   ├── html5ever v0.24.0
 661   │   │   ├── log v0.4.8
 662   │   │   │   └── cfg-if v0.1.9
 663   │   │   ├── mac v0.1.1
 664   │   │   └── markup5ever v0.9.0
 665   │   │       ├── log v0.4.8 (*)
 666   │   │       ├── phf v0.7.24
 667   │   │       │   └── phf_shared v0.7.24
 668   │   │       │       ├── siphasher v0.2.3
 669   │   │       │       └── unicase v1.4.2
 670   │   │       │           [build-dependencies]
 671   │   │       │           └── version_check v0.1.5
 672   ...
 673   ```
 674   You can also display dependencies on multiple versions of the same crate with
 675   `cargo tree -d` (short for `cargo tree --duplicates`).
 676
 677 Misc
 678 ----
 679 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
 680   the version in the sidebar.][69494]
 681
 682 Compatibility Notes
 683 -------------------
 684 - [Rustc now correctly generates static libraries on Windows GNU targets with
 685   the `.a` extension, rather than the previous `.lib`.][70937]
 686 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
 687 - [The `file_name` property in JSON output of macro errors now points the actual
 688   source file rather than the previous format of `<NAME macros>`.][70969]
 689   **Note:** this may not point to a file that actually exists on the user's system.
 690 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
 691 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
 692   not allow zero initialization such as `NonZeroU8`.][66059] This was
 693   previously a warning.
 694 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
 695   operator has been defined as a saturating operation.][71269] This was previously
 696   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
 697   continue using the current behaviour, which may be desirable in rare performance
 698   sensitive situations.
 699
 700 Internal Only
 701 -------------
 702 These changes provide no direct user facing benefits, but represent significant
 703 improvements to the internals and overall performance of rustc and
 704 related tools.
 705
 706 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
 707 - [Replace big JS dict with JSON parsing.][71250]
 708
 709 [69373]: https://github.com/rust-lang/rust/pull/69373/
 710 [66059]: https://github.com/rust-lang/rust/pull/66059/
 711 [68191]: https://github.com/rust-lang/rust/pull/68191/
 712 [68899]: https://github.com/rust-lang/rust/pull/68899/
 713 [71147]: https://github.com/rust-lang/rust/pull/71147/
 714 [71250]: https://github.com/rust-lang/rust/pull/71250/
 715 [70937]: https://github.com/rust-lang/rust/pull/70937/
 716 [70969]: https://github.com/rust-lang/rust/pull/70969/
 717 [70632]: https://github.com/rust-lang/rust/pull/70632/
 718 [70281]: https://github.com/rust-lang/rust/pull/70281/
 719 [70345]: https://github.com/rust-lang/rust/pull/70345/
 720 [70048]: https://github.com/rust-lang/rust/pull/70048/
 721 [70081]: https://github.com/rust-lang/rust/pull/70081/
 722 [70156]: https://github.com/rust-lang/rust/pull/70156/
 723 [71269]: https://github.com/rust-lang/rust/pull/71269/
 724 [69838]: https://github.com/rust-lang/rust/pull/69838/
 725 [69929]: https://github.com/rust-lang/rust/pull/69929/
 726 [69661]: https://github.com/rust-lang/rust/pull/69661/
 727 [69778]: https://github.com/rust-lang/rust/pull/69778/
 728 [69494]: https://github.com/rust-lang/rust/pull/69494/
 729 [69403]: https://github.com/rust-lang/rust/pull/69403/
 730 [69033]: https://github.com/rust-lang/rust/pull/69033/
 731 [68692]: https://github.com/rust-lang/rust/pull/68692/
 732 [68334]: https://github.com/rust-lang/rust/pull/68334/
 733 [67502]: https://github.com/rust-lang/rust/pull/67502/
 734 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
 735 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
 736 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
 737 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
 738 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
 739 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
 740 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
 741 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
 742 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
 743 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
 744 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
 745 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
 746 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
 747
 748
 749 Version 1.43.1 (2020-05-07)
 750 ===========================
 751
 752 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
 753 * [Fixed the stabilization of AVX-512 features.][71473]
 754 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
 755
 756 [71430]: https://github.com/rust-lang/rust/pull/71430
 757 [71473]: https://github.com/rust-lang/rust/issues/71473
 758 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
 759
 760
 761 Version 1.43.0 (2020-04-23)
 762 ==========================
 763
 764 Language
 765 --------
 766 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
 767   the type inferred correctly.][68129]
 768 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
 769
 770 **Syntax only changes**
 771 - [Allow `type Foo: Ord` syntactically.][69361]
 772 - [Fuse associated and extern items up to defaultness.][69194]
 773 - [Syntactically allow `self` in all `fn` contexts.][68764]
 774 - [Merge `fn` syntax + cleanup item parsing.][68728]
 775 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
 776   For example, you may now write:
 777   ```rust
 778   macro_rules! mac_trait {
 779       ($i:item) => {
 780           trait T { $i }
 781       }
 782   }
 783   mac_trait! {
 784       fn foo() {}
 785   }
 786   ```
 787
 788 These are still rejected *semantically*, so you will likely receive an error but
 789 these changes can be seen and parsed by macros and
 790 conditional compilation.
 791
 792
 793 Compiler
 794 --------
 795 - [You can now pass multiple lint flags to rustc to override the previous
 796   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
 797   everything in the `unused` lint group except `unused-variables` which
 798   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
 799   everything in the `unused` lint group **including** `unused-variables` since
 800   the allow flag is specified before the deny flag (and therefore overridden).
 801 - [rustc will now prefer your system MinGW libraries over its bundled libraries
 802   if they are available on `windows-gnu`.][67429]
 803 - [rustc now buffers errors/warnings printed in JSON.][69227]
 804
 805 Libraries
 806 ---------
 807 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
 808   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
 809   respectively.][69538] **Note** These conversions are only available when `N`
 810   is `0..=32`.
 811 - [You can now use associated constants on floats and integers directly, rather
 812   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
 813   `f32::NAN` with no imports.
 814 - [`u8::is_ascii` is now `const`.][68984]
 815 - [`String` now implements `AsMut<str>`.][68742]
 816 - [Added the `primitive` module to `std` and `core`.][67637] This module
 817   reexports Rust's primitive types. This is mainly useful in macros
 818   where you want avoid these types being shadowed.
 819 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
 820 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
 821
 822 Stabilized APIs
 823 ---------------
 824 - [`Once::is_completed`]
 825 - [`f32::LOG10_2`]
 826 - [`f32::LOG2_10`]
 827 - [`f64::LOG10_2`]
 828 - [`f64::LOG2_10`]
 829 - [`iter::once_with`]
 830
 831 Cargo
 832 -----
 833 - [You can now set config `[profile]`s in your `.cargo/config`, or through
 834   your environment.][cargo/7823]
 835 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
 836   executable path when running integration tests or benchmarks.][cargo/7697]
 837   `<name>` is the name of your binary as-is e.g. If you wanted the executable
 838   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
 839
 840 Misc
 841 ----
 842 - [Certain checks in the `const_err` lint were deemed unrelated to const
 843   evaluation][69185], and have been moved to the `unconditional_panic` and
 844   `arithmetic_overflow` lints.
 845
 846 Compatibility Notes
 847 -------------------
 848
 849 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
 850   has been a warning since 1.36.0.
 851 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
 852   led to some instances being accepted, and now correctly emits a hard error.
 853
 854 [69340]: https://github.com/rust-lang/rust/pull/69340
 855
 856 Internal Only
 857 -------------
 858 These changes provide no direct user facing benefits, but represent significant
 859 improvements to the internals and overall performance of `rustc` and
 860 related tools.
 861
 862 - [All components are now built with `opt-level=3` instead of `2`.][67878]
 863 - [Improved how rustc generates drop code.][67332]
 864 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
 865 - [traits: preallocate 2 Vecs of known initial size][69022]
 866 - [Avoid exponential behaviour when relating types][68772]
 867 - [Skip `Drop` terminators for enum variants without drop glue][68943]
 868 - [Improve performance of coherence checks][68966]
 869 - [Deduplicate types in the generator witness][68672]
 870 - [Invert control in struct_lint_level.][68725]
 871
 872 [67332]: https://github.com/rust-lang/rust/pull/67332/
 873 [67429]: https://github.com/rust-lang/rust/pull/67429/
 874 [67637]: https://github.com/rust-lang/rust/pull/67637/
 875 [67642]: https://github.com/rust-lang/rust/pull/67642/
 876 [67878]: https://github.com/rust-lang/rust/pull/67878/
 877 [67885]: https://github.com/rust-lang/rust/pull/67885/
 878 [68129]: https://github.com/rust-lang/rust/pull/68129/
 879 [68672]: https://github.com/rust-lang/rust/pull/68672/
 880 [68725]: https://github.com/rust-lang/rust/pull/68725/
 881 [68728]: https://github.com/rust-lang/rust/pull/68728/
 882 [68738]: https://github.com/rust-lang/rust/pull/68738/
 883 [68742]: https://github.com/rust-lang/rust/pull/68742/
 884 [68764]: https://github.com/rust-lang/rust/pull/68764/
 885 [68772]: https://github.com/rust-lang/rust/pull/68772/
 886 [68943]: https://github.com/rust-lang/rust/pull/68943/
 887 [68952]: https://github.com/rust-lang/rust/pull/68952/
 888 [68966]: https://github.com/rust-lang/rust/pull/68966/
 889 [68984]: https://github.com/rust-lang/rust/pull/68984/
 890 [69022]: https://github.com/rust-lang/rust/pull/69022/
 891 [69185]: https://github.com/rust-lang/rust/pull/69185/
 892 [69194]: https://github.com/rust-lang/rust/pull/69194/
 893 [69201]: https://github.com/rust-lang/rust/pull/69201/
 894 [69227]: https://github.com/rust-lang/rust/pull/69227/
 895 [69548]: https://github.com/rust-lang/rust/pull/69548/
 896 [69256]: https://github.com/rust-lang/rust/pull/69256/
 897 [69361]: https://github.com/rust-lang/rust/pull/69361/
 898 [69366]: https://github.com/rust-lang/rust/pull/69366/
 899 [69538]: https://github.com/rust-lang/rust/pull/69538/
 900 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
 901 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
 902 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
 903 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
 904 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
 905 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
 906 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
 907 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
 908
 909
 910 Version 1.42.0 (2020-03-12)
 911 ==========================
 912
 913 Language
 914 --------
 915 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
 916   ```rust
 917   fn foo(words: &[&str]) {
 918       match words {
 919           ["Hello", "World", "!", ..] => println!("Hello World!"),
 920           ["Foo", "Bar", ..] => println!("Baz"),
 921           rest => println!("{:?}", rest),
 922       }
 923   }
 924   ```
 925 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
 926   that you can create an enum that has the exact layout and ABI of the type
 927   it contains.
 928 - [There are some *syntax-only* changes:][67131]
 929    - `default` is syntactically allowed before items in `trait` definitions.
 930    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
 931      leave out their bodies in favor of `;`.
 932    - Bounds on associated types in `impl`s are now syntactically allowed
 933      (e.g. `type Foo: Ord;`).
 934    - `...` (the C-variadic type) may occur syntactically directly as the type of
 935       any function parameter.
 936
 937   These are still rejected *semantically*, so you will likely receive an error
 938   but these changes can be seen and parsed by procedural macros and
 939   conditional compilation.
 940
 941 Compiler
 942 --------
 943 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
 944 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
 945 - [`Option::{expect,unwrap}` and
 946    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
 947    pointing to the location where they were called, rather than
 948    `core`'s internals. ][67887]
 949
 950 \* Refer to Rust's [platform support page][forge-platform-support] for more
 951 information on Rust's tiered platform support.
 952
 953 Libraries
 954 ---------
 955 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
 956 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
 957    to implement `Sized`.][67935]
 958 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
 959 - [`Layout::new` is now `const`.][66254]
 960 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
 961
 962
 963 Stabilized APIs
 964 ---------------
 965 - [`CondVar::wait_while`]
 966 - [`CondVar::wait_timeout_while`]
 967 - [`DebugMap::key`]
 968 - [`DebugMap::value`]
 969 - [`ManuallyDrop::take`]
 970 - [`matches!`]
 971 - [`ptr::slice_from_raw_parts_mut`]
 972 - [`ptr::slice_from_raw_parts`]
 973
 974 Cargo
 975 -----
 976 - [You no longer need to include `extern crate proc_macro;` to be able to
 977   `use proc_macro;` in the `2018` edition.][cargo/7700]
 978
 979 Compatibility Notes
 980 -------------------
 981 - [`Error::description` has been deprecated, and its use will now produce a
 982   warning.][66919] It's recommended to use `Display`/`to_string` instead.
 983
 984 [68253]: https://github.com/rust-lang/rust/pull/68253/
 985 [68348]: https://github.com/rust-lang/rust/pull/68348/
 986 [67935]: https://github.com/rust-lang/rust/pull/67935/
 987 [68339]: https://github.com/rust-lang/rust/pull/68339/
 988 [68122]: https://github.com/rust-lang/rust/pull/68122/
 989 [67712]: https://github.com/rust-lang/rust/pull/67712/
 990 [67887]: https://github.com/rust-lang/rust/pull/67887/
 991 [67131]: https://github.com/rust-lang/rust/pull/67131/
 992 [67233]: https://github.com/rust-lang/rust/pull/67233/
 993 [66899]: https://github.com/rust-lang/rust/pull/66899/
 994 [66919]: https://github.com/rust-lang/rust/pull/66919/
 995 [66254]: https://github.com/rust-lang/rust/pull/66254/
 996 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
 997 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
 998 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
 999 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
1000 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
1001 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
1002 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
1003 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
1004 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
1005
1006
1007 Version 1.41.1 (2020-02-27)
1008 ===========================
1009
1010 * [Always check types of static items][69145]
1011 * [Always check lifetime bounds of `Copy` impls][69145]
1012 * [Fix miscompilation in callers of `Layout::repeat`][69225]
1013
1014 [69225]: https://github.com/rust-lang/rust/issues/69225
1015 [69145]: https://github.com/rust-lang/rust/pull/69145
1016
1017
1018 Version 1.41.0 (2020-01-30)
1019 ===========================
1020
1021 Language
1022 --------
1023
1024 - [You can now pass type parameters to foreign items when implementing
1025   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
1026 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
1027   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
1028   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
1029 - [You can now use any valid identifier in a `format_args` macro.][66847]
1030   Previously identifiers starting with an underscore were not allowed.
1031 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
1032   enum variants.][66183] These are still rejected semantically, but
1033   can be seen and parsed by procedural macros and conditional compilation.
1034
1035 Compiler
1036 --------
1037
1038 - [Rustc will now warn if you have unused loop `'label`s.][66325]
1039 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
1040 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
1041 - [You can now pass an arguments file passing the `@path` syntax
1042   to rustc.][66172] Note that the format differs somewhat from what is
1043   found in other tooling; please see [the documentation][argfile-docs] for
1044   more information.
1045 - [You can now provide `--extern` flag without a path, indicating that it is
1046   available from the search path or specified with an `-L` flag.][64882]
1047
1048 \* Refer to Rust's [platform support page][forge-platform-support] for more
1049 information on Rust's tiered platform support.
1050
1051 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
1052
1053 Libraries
1054 ---------
1055
1056 - [The `core::panic` module is now stable.][66771] It was already stable
1057   through `std`.
1058 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
1059   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
1060 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
1061
1062 Stabilized APIs
1063 ---------------
1064
1065 - [`Result::map_or`]
1066 - [`Result::map_or_else`]
1067 - [`std::rc::Weak::weak_count`]
1068 - [`std::rc::Weak::strong_count`]
1069 - [`std::sync::Weak::weak_count`]
1070 - [`std::sync::Weak::strong_count`]
1071
1072 Cargo
1073 -----
1074
1075 - [Cargo will now document all the private items for binary crates
1076   by default.][cargo/7593]
1077 - [`cargo-install` will now reinstall the package if it detects that it is out
1078   of date.][cargo/7560]
1079 - [Cargo.lock now uses a more git friendly format that should help to reduce
1080   merge conflicts.][cargo/7579]
1081 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
1082   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
1083   optimisation level to `2` for debug builds. You can also use
1084   `[profile.<profile>.build-override]` to override build scripts and
1085   their dependencies.
1086
1087 Misc
1088 ----
1089
1090 - [You can now specify `edition` in documentation code blocks to compile the block
1091   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
1092   should be compiled the 2018 edition of Rust.
1093 - [You can now provide custom themes to rustdoc with `--theme`, and check the
1094   current theme with `--check-theme`.][54733]
1095 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
1096
1097 Compatibility Notes
1098 -------------------
1099
1100 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
1101   Apple targets.][apple-32bit-drop] This means that the source code is still
1102   available to build, but the targets are no longer being tested and release
1103   binaries for those platforms will no longer be distributed by the Rust project.
1104   Please refer to the linked blog post for more information.
1105
1106 [54733]: https://github.com/rust-lang/rust/pull/54733/
1107 [61351]: https://github.com/rust-lang/rust/pull/61351/
1108 [67255]: https://github.com/rust-lang/rust/pull/67255/
1109 [66661]: https://github.com/rust-lang/rust/pull/66661/
1110 [66771]: https://github.com/rust-lang/rust/pull/66771/
1111 [66847]: https://github.com/rust-lang/rust/pull/66847/
1112 [66238]: https://github.com/rust-lang/rust/pull/66238/
1113 [66277]: https://github.com/rust-lang/rust/pull/66277/
1114 [66325]: https://github.com/rust-lang/rust/pull/66325/
1115 [66172]: https://github.com/rust-lang/rust/pull/66172/
1116 [66183]: https://github.com/rust-lang/rust/pull/66183/
1117 [65879]: https://github.com/rust-lang/rust/pull/65879/
1118 [65013]: https://github.com/rust-lang/rust/pull/65013/
1119 [64882]: https://github.com/rust-lang/rust/pull/64882/
1120 [64325]: https://github.com/rust-lang/rust/pull/64325/
1121 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
1122 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
1123 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
1124 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
1125 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
1126 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
1127 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
1128 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
1129 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
1130 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
1131 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
1132
1133 Version 1.40.0 (2019-12-19)
1134 ===========================
1135
1136 Language
1137 --------
1138 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
1139   `const` contexts.][65188] e.g.
1140
1141   ```rust
1142   pub struct Point(i32, i32);
1143
1144   const ORIGIN: Point = {
1145       let constructor = Point;
1146
1147       constructor(0, 0)
1148   };
1149   ```
1150
1151 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
1152   indicate that there may be variants or fields added in the future.][64639]
1153   For example this requires adding a wild-card branch (`_ => {}`) to any match
1154   statements on a non-exhaustive `enum`. [(RFC 2008)]
1155 - [You can now use function-like procedural macros in `extern` blocks and in
1156   type positions.][63931] e.g. `type Generated = macro!();`
1157 - [Function-like and attribute procedural macros can now emit
1158   `macro_rules!` items, so you can now have your macros generate macros.][64035]
1159 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
1160   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
1161   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
1162
1163 Compiler
1164 --------
1165 - [Added tier 3 support\* for the
1166   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
1167 - [Added tier 3 support for the
1168   `aarch64-unknown-none-softfloat` target.][64589]
1169 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
1170   `mips64el-unknown-linux-muslabi64` targets.][65843]
1171
1172 \* Refer to Rust's [platform support page][forge-platform-support] for more
1173   information on Rust's tiered platform support.
1174
1175 Libraries
1176 ---------
1177 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
1178
1179 Stabilized APIs
1180 ---------------
1181 - [`BTreeMap::get_key_value`]
1182 - [`HashMap::get_key_value`]
1183 - [`Option::as_deref_mut`]
1184 - [`Option::as_deref`]
1185 - [`Option::flatten`]
1186 - [`UdpSocket::peer_addr`]
1187 - [`f32::to_be_bytes`]
1188 - [`f32::to_le_bytes`]
1189 - [`f32::to_ne_bytes`]
1190 - [`f64::to_be_bytes`]
1191 - [`f64::to_le_bytes`]
1192 - [`f64::to_ne_bytes`]
1193 - [`f32::from_be_bytes`]
1194 - [`f32::from_le_bytes`]
1195 - [`f32::from_ne_bytes`]
1196 - [`f64::from_be_bytes`]
1197 - [`f64::from_le_bytes`]
1198 - [`f64::from_ne_bytes`]
1199 - [`mem::take`]
1200 - [`slice::repeat`]
1201 - [`todo!`]
1202
1203 Cargo
1204 -----
1205 - [Cargo will now always display warnings, rather than only on
1206   fresh builds.][cargo/7450]
1207 - [Feature flags (except `--all-features`) passed to a virtual workspace will
1208   now produce an error.][cargo/7507] Previously these flags were ignored.
1209 - [You can now publish `dev-dependencies` without including
1210   a `version`.][cargo/7333]
1211
1212 Misc
1213 ----
1214 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
1215   when running documentation tests with `rustdoc`.][63803]
1216
1217 Compatibility Notes
1218 -------------------
1219 - [As previously announced, any previous NLL warnings in the 2015 edition are
1220   now hard errors.][64221]
1221 - [The `include!` macro will now warn if it failed to include the
1222   entire file.][64284] The `include!` macro unintentionally only includes the
1223   first _expression_ in a file, and this can be unintuitive. This will become
1224   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
1225 - [Using `#[inline]` on function prototypes and consts now emits a warning under
1226   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
1227   or `extern` blocks now correctly emits a hard error.
1228
1229 [65294]: https://github.com/rust-lang/rust/pull/65294/
1230 [66103]: https://github.com/rust-lang/rust/pull/66103/
1231 [65843]: https://github.com/rust-lang/rust/pull/65843/
1232 [65188]: https://github.com/rust-lang/rust/pull/65188/
1233 [65092]: https://github.com/rust-lang/rust/pull/65092/
1234 [64589]: https://github.com/rust-lang/rust/pull/64589/
1235 [64639]: https://github.com/rust-lang/rust/pull/64639/
1236 [64221]: https://github.com/rust-lang/rust/pull/64221/
1237 [64284]: https://github.com/rust-lang/rust/pull/64284/
1238 [63931]: https://github.com/rust-lang/rust/pull/63931/
1239 [64035]: https://github.com/rust-lang/rust/pull/64035/
1240 [63674]: https://github.com/rust-lang/rust/pull/63674/
1241 [63803]: https://github.com/rust-lang/rust/pull/63803/
1242 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
1243 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
1244 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
1245 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
1246 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
1247 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
1248 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
1249 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
1250 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
1251 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
1252 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
1253 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
1254 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
1255 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
1256 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
1257 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
1258 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
1259 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
1260 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
1261 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
1262 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
1263 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
1264 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
1265 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
1266 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
1267 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
1268
1269
1270 Version 1.39.0 (2019-11-07)
1271 ===========================
1272
1273 Language
1274 --------
1275 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
1276   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
1277 - [You can now use certain attributes on function, closure, and function pointer
1278   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
1279   `deny`, `forbid` as well as inert helper attributes used by procedural macro
1280   attributes applied to items. e.g.
1281   ```rust
1282   fn len(
1283       #[cfg(windows)] slice: &[u16],
1284       #[cfg(not(windows))] slice: &[u8],
1285   ) -> usize {
1286       slice.len()
1287   }
1288   ```
1289 - [You can now take shared references to bind-by-move patterns in the `if` guards
1290   of `match` arms.][63118] e.g.
1291   ```rust
1292   fn main() {
1293       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
1294
1295       match array {
1296           nums
1297   //      ---- `nums` is bound by move.
1298               if nums.iter().sum::<u8>() == 10
1299   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
1300           => {
1301               drop(nums);
1302   //          ----------- Legal as `nums` was bound by move and so we have ownership.
1303           }
1304           _ => unreachable!(),
1305       }
1306   }
1307   ```
1308
1309
1310
1311 Compiler
1312 --------
1313 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
1314 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
1315 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
1316   **Note** Cargo currently doesn't use this feature. Refer to
1317   [cargo#7315][cargo/7315] to track this feature's progress.
1318 - [You can now pass `--show-output` argument to test binaries to print the
1319   output of successful tests.][62600]
1320
1321
1322 \* Refer to Rust's [platform support page][forge-platform-support] for more
1323 information on Rust's tiered platform support.
1324
1325 Libraries
1326 ---------
1327 - [`Vec::new` and `String::new` are now `const` functions.][64028]
1328 - [`LinkedList::new` is now a `const` function.][63684]
1329 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
1330 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
1331   now `const`.][63786]
1332
1333 Stabilized APIs
1334 ---------------
1335 - [`Pin::into_inner`]
1336 - [`Instant::checked_duration_since`]
1337 - [`Instant::saturating_duration_since`]
1338
1339 Cargo
1340 -----
1341 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
1342 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
1343   `--all` is now deprecated.
1344
1345 Misc
1346 ----
1347 - [You can now pass `-Clinker` to rustdoc to control the linker used
1348   for compiling doctests.][63834]
1349
1350 Compatibility Notes
1351 -------------------
1352 - [Code that was previously accepted by the old borrow checker, but rejected by
1353   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
1354   previously a warning, and will also become a hard error in the Rust 2015
1355   edition in the 1.40.0 release.
1356 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
1357   run tests.][63827] This should improve performance when running a large
1358   amount of doctests.
1359 - [The `try!` macro will now issue a deprecation warning.][62672] It is
1360   recommended to use the `?` operator instead.
1361 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
1362   returned `0.0`.
1363
1364 [62600]: https://github.com/rust-lang/rust/pull/62600/
1365 [62672]: https://github.com/rust-lang/rust/pull/62672/
1366 [63118]: https://github.com/rust-lang/rust/pull/63118/
1367 [63209]: https://github.com/rust-lang/rust/pull/63209/
1368 [63402]: https://github.com/rust-lang/rust/pull/63402/
1369 [63565]: https://github.com/rust-lang/rust/pull/63565/
1370 [63595]: https://github.com/rust-lang/rust/pull/63595/
1371 [63684]: https://github.com/rust-lang/rust/pull/63684/
1372 [63698]: https://github.com/rust-lang/rust/pull/63698/
1373 [63770]: https://github.com/rust-lang/rust/pull/63770/
1374 [63786]: https://github.com/rust-lang/rust/pull/63786/
1375 [63827]: https://github.com/rust-lang/rust/pull/63827/
1376 [63834]: https://github.com/rust-lang/rust/pull/63834/
1377 [63927]: https://github.com/rust-lang/rust/pull/63927/
1378 [63933]: https://github.com/rust-lang/rust/pull/63933/
1379 [63934]: https://github.com/rust-lang/rust/pull/63934/
1380 [63938]: https://github.com/rust-lang/rust/pull/63938/
1381 [63940]: https://github.com/rust-lang/rust/pull/63940/
1382 [63941]: https://github.com/rust-lang/rust/pull/63941/
1383 [63945]: https://github.com/rust-lang/rust/pull/63945/
1384 [64010]: https://github.com/rust-lang/rust/pull/64010/
1385 [64028]: https://github.com/rust-lang/rust/pull/64028/
1386 [64334]: https://github.com/rust-lang/rust/pull/64334/
1387 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
1388 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
1389 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
1390 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
1391 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
1392 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
1393
1394 Version 1.38.0 (2019-09-26)
1395 ==========================
1396
1397 Language
1398 --------
1399 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
1400 - [The `#[deprecated]` attribute can now be used on macros.][62042]
1401
1402 Compiler
1403 --------
1404 - [Added pipelined compilation support to `rustc`.][62766] This will
1405   improve compilation times in some cases. For further information please refer
1406   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
1407 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
1408   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
1409   `x86_64-uwp-windows-msvc` targets.][60260]
1410 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
1411   `armv7-unknown-linux-musleabi` targets.][63107]
1412 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
1413 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
1414
1415 \* Refer to Rust's [platform support page][forge-platform-support] for more
1416 information on Rust's tiered platform support.
1417
1418 Libraries
1419 ---------
1420 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
1421 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
1422   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
1423   is available at `std::clone::Clone`). This also makes all built-in macros
1424   available in `std`/`core` root. e.g. `std::include_bytes!`.
1425 - [`str::Chars` now implements `Debug`.][63000]
1426 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
1427 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
1428 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
1429 - [Added euclidean remainder and division operations (`div_euclid`,
1430   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
1431   `overflowing`, and `wrapping` versions are available for all
1432   integer primitives.
1433 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
1434   `PartialEq`.][61491]
1435 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
1436
1437 Stabilized APIs
1438 ---------------
1439 - [`<*const T>::cast`]
1440 - [`<*mut T>::cast`]
1441 - [`Duration::as_secs_f32`]
1442 - [`Duration::as_secs_f64`]
1443 - [`Duration::div_f32`]
1444 - [`Duration::div_f64`]
1445 - [`Duration::from_secs_f32`]
1446 - [`Duration::from_secs_f64`]
1447 - [`Duration::mul_f32`]
1448 - [`Duration::mul_f64`]
1449 - [`any::type_name`]
1450
1451 Cargo
1452 -----
1453 - [Added pipelined compilation support to `cargo`.][cargo/7143]
1454 - [You can now pass the `--features` option multiple times to enable
1455   multiple features.][cargo/7084]
1456
1457 Misc
1458 ----
1459 - [`rustc` will now warn about some incorrect uses of
1460   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
1461
1462 Compatibility Notes
1463 -------------------
1464 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
1465   1.38.0.
1466 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
1467   issues][62896] with certain crates such as libc.
1468
1469 [60260]: https://github.com/rust-lang/rust/pull/60260/
1470 [61457]: https://github.com/rust-lang/rust/pull/61457/
1471 [61491]: https://github.com/rust-lang/rust/pull/61491/
1472 [61884]: https://github.com/rust-lang/rust/pull/61884/
1473 [61953]: https://github.com/rust-lang/rust/pull/61953/
1474 [62042]: https://github.com/rust-lang/rust/pull/62042/
1475 [62528]: https://github.com/rust-lang/rust/pull/62528/
1476 [62583]: https://github.com/rust-lang/rust/pull/62583/
1477 [62735]: https://github.com/rust-lang/rust/pull/62735/
1478 [62766]: https://github.com/rust-lang/rust/pull/62766/
1479 [62784]: https://github.com/rust-lang/rust/pull/62784/
1480 [62785]: https://github.com/rust-lang/rust/issues/62785/
1481 [62814]: https://github.com/rust-lang/rust/pull/62814/
1482 [62896]: https://github.com/rust-lang/rust/issues/62896/
1483 [63000]: https://github.com/rust-lang/rust/pull/63000/
1484 [63056]: https://github.com/rust-lang/rust/pull/63056/
1485 [63107]: https://github.com/rust-lang/rust/pull/63107/
1486 [63346]: https://github.com/rust-lang/rust/pull/63346/
1487 [63421]: https://github.com/rust-lang/rust/pull/63421/
1488 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
1489 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
1490 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1491 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1492 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
1493 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
1494 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
1495 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
1496 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
1497 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
1498 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
1499 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
1500 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
1501 [forge-platform-support]: https://forge.rust-lang.org/release/platform-support.html
1502 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
1503
1504 Version 1.37.0 (2019-08-15)
1505 ==========================
1506
1507 Language
1508 --------
1509 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
1510   [`Box`][62228], or an [array][62235] and unused.
1511 - [You can now use the `cfg` and `cfg_attr` attributes on
1512   generic parameters.][61547]
1513 - [You can now use enum variants through type alias.][61682] e.g. You can
1514   write the following:
1515   ```rust
1516   type MyOption = Option<u8>;
1517
1518   fn increment_or_zero(x: MyOption) -> u8 {
1519       match x {
1520           MyOption::Some(y) => y + 1,
1521           MyOption::None => 0,
1522       }
1523   }
1524   ```
1525 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
1526   `const _: u32 = 5;`.
1527 - [You can now use `#[repr(align(X)]` on enums.][61229]
1528 - [The  `?` Kleene macro operator is now available in the
1529   2015 edition.][60932]
1530
1531 Compiler
1532 --------
1533 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
1534   and `-C profile-use` flags.][61268] For more information on how to use profile
1535   guided optimization, please refer to the [rustc book][rustc-book-pgo].
1536 - [The `rust-lldb` wrapper script should now work again.][61827]
1537
1538 Libraries
1539 ---------
1540 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
1541
1542 Stabilized APIs
1543 ---------------
1544 - [`BufReader::buffer`]
1545 - [`BufWriter::buffer`]
1546 - [`Cell::from_mut`]
1547 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
1548 - [`DoubleEndedIterator::nth_back`]
1549 - [`Option::xor`]
1550 - [`Wrapping::reverse_bits`]
1551 - [`i128::reverse_bits`]
1552 - [`i16::reverse_bits`]
1553 - [`i32::reverse_bits`]
1554 - [`i64::reverse_bits`]
1555 - [`i8::reverse_bits`]
1556 - [`isize::reverse_bits`]
1557 - [`slice::copy_within`]
1558 - [`u128::reverse_bits`]
1559 - [`u16::reverse_bits`]
1560 - [`u32::reverse_bits`]
1561 - [`u64::reverse_bits`]
1562 - [`u8::reverse_bits`]
1563 - [`usize::reverse_bits`]
1564
1565 Cargo
1566 -----
1567 - [`Cargo.lock` files are now included by default when publishing executable crates
1568   with executables.][cargo/7026]
1569 - [You can now specify `default-run="foo"` in `[package]` to specify the
1570   default executable to use for `cargo run`.][cargo/7056]
1571
1572 Misc
1573 ----
1574
1575 Compatibility Notes
1576 -------------------
1577 - [Using `...` for inclusive range patterns will now warn by default.][61342]
1578   Please transition your code to using the `..=` syntax for inclusive
1579   ranges instead.
1580 - [Using a trait object without the `dyn` will now warn by default.][61203]
1581   Please transition your code to use `dyn Trait` for trait objects instead.
1582
1583 [62228]: https://github.com/rust-lang/rust/pull/62228/
1584 [62235]: https://github.com/rust-lang/rust/pull/62235/
1585 [61802]: https://github.com/rust-lang/rust/pull/61802/
1586 [61827]: https://github.com/rust-lang/rust/pull/61827/
1587 [61547]: https://github.com/rust-lang/rust/pull/61547/
1588 [61682]: https://github.com/rust-lang/rust/pull/61682/
1589 [61268]: https://github.com/rust-lang/rust/pull/61268/
1590 [61342]: https://github.com/rust-lang/rust/pull/61342/
1591 [61347]: https://github.com/rust-lang/rust/pull/61347/
1592 [61100]: https://github.com/rust-lang/rust/pull/61100/
1593 [61203]: https://github.com/rust-lang/rust/pull/61203/
1594 [61229]: https://github.com/rust-lang/rust/pull/61229/
1595 [60932]: https://github.com/rust-lang/rust/pull/60932/
1596 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
1597 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
1598 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
1599 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
1600 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
1601 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
1602 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
1603 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
1604 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
1605 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
1606 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
1607 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
1608 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
1609 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
1610 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
1611 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
1612 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
1613 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
1614 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
1615 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
1616 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
1617 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
1618 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
1619 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
1620
1621
1622 Version 1.36.0 (2019-07-04)
1623 ==========================
1624
1625 Language
1626 --------
1627 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
1628 - [The order of traits in trait objects no longer affects the semantics of that
1629   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
1630   `dyn fmt::Debug + Send`, where this was previously not the case.
1631
1632 Libraries
1633 ---------
1634 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
1635 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
1636 - [`mem::needs_drop` is now available as a const fn.][60364]
1637 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
1638 - [`String` now implements `BorrowMut<str>`.][60404]
1639 - [`io::Cursor` now implements `Default`.][60234]
1640 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
1641 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
1642   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
1643   environment has access to heap memory allocation.
1644 - [`String` now implements `From<&String>`.][59825]
1645 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
1646   return a tuple of each argument when there is multiple arguments.
1647 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
1648   not used.][59648]
1649
1650 Stabilized APIs
1651 ---------------
1652 - [`VecDeque::rotate_left`]
1653 - [`VecDeque::rotate_right`]
1654 - [`Iterator::copied`]
1655 - [`io::IoSlice`]
1656 - [`io::IoSliceMut`]
1657 - [`Read::read_vectored`]
1658 - [`Write::write_vectored`]
1659 - [`str::as_mut_ptr`]
1660 - [`mem::MaybeUninit`]
1661 - [`pointer::align_offset`]
1662 - [`future::Future`]
1663 - [`task::Context`]
1664 - [`task::RawWaker`]
1665 - [`task::RawWakerVTable`]
1666 - [`task::Waker`]
1667 - [`task::Poll`]
1668
1669 Cargo
1670 -----
1671 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
1672 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
1673
1674 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
1675
1676 Clippy
1677 ------
1678 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
1679
1680 Misc
1681 ----
1682
1683 Compatibility Notes
1684 -------------------
1685 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
1686   longer recommended, and will be deprecated in 1.39.0.
1687
1688 [60318]: https://github.com/rust-lang/rust/pull/60318/
1689 [60364]: https://github.com/rust-lang/rust/pull/60364/
1690 [60370]: https://github.com/rust-lang/rust/pull/60370/
1691 [60404]: https://github.com/rust-lang/rust/pull/60404/
1692 [60234]: https://github.com/rust-lang/rust/pull/60234/
1693 [60244]: https://github.com/rust-lang/rust/pull/60244/
1694 [58623]: https://github.com/rust-lang/rust/pull/58623/
1695 [59648]: https://github.com/rust-lang/rust/pull/59648/
1696 [59675]: https://github.com/rust-lang/rust/pull/59675/
1697 [59825]: https://github.com/rust-lang/rust/pull/59825/
1698 [59826]: https://github.com/rust-lang/rust/pull/59826/
1699 [59445]: https://github.com/rust-lang/rust/pull/59445/
1700 [59114]: https://github.com/rust-lang/rust/pull/59114/
1701 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
1702 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
1703 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
1704 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
1705 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
1706 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
1707 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
1708 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
1709 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
1710 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
1711 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
1712 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
1713 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
1714 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
1715 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
1716 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
1717 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
1718 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
1719 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
1720 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
1721
1722
1723 Version 1.35.0 (2019-05-23)
1724 ==========================
1725
1726 Language
1727 --------
1728 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
1729   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
1730 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
1731   ```rust
1732   unsafe fn call_unsafe(func: unsafe fn()) {
1733       func()
1734   }
1735
1736   pub fn main() {
1737       unsafe { call_unsafe(|| {}); }
1738   }
1739   ```
1740
1741
1742 Compiler
1743 --------
1744 - [Added the `armv6-unknown-freebsd-gnueabihf` and
1745   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
1746 - [Added the `wasm32-unknown-wasi` target.][59464]
1747
1748
1749 Libraries
1750 ---------
1751 - [`Thread` will now show its ID in `Debug` output.][59460]
1752 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
1753 - [`alloc::System` now implements `Default`.][59451]
1754 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
1755   last field.][59076]
1756 - [`char::{ToLowercase, ToUppercase}` now
1757   implement `ExactSizeIterator`.][58778]
1758 - [All `NonZero` numeric types now implement `FromStr`.][58717]
1759 - [Removed the `Read` trait bounds
1760   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
1761 - [You can now call the `dbg!` macro without any parameters to print the file
1762   and line where it is called.][57847]
1763 - [In place ASCII case conversions are now up to 4× faster.][59283]
1764   e.g. `str::make_ascii_lowercase`
1765 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
1766   and `Send`.][58369]
1767
1768 Stabilized APIs
1769 ---------------
1770 - [`f32::copysign`]
1771 - [`f64::copysign`]
1772 - [`RefCell::replace_with`]
1773 - [`RefCell::map_split`]
1774 - [`ptr::hash`]
1775 - [`Range::contains`]
1776 - [`RangeFrom::contains`]
1777 - [`RangeTo::contains`]
1778 - [`RangeInclusive::contains`]
1779 - [`RangeToInclusive::contains`]
1780 - [`Option::copied`]
1781
1782 Cargo
1783 -----
1784 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
1785   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
1786   platform specific.
1787
1788 Misc
1789 ----
1790 - [The Rust toolchain is now available natively for musl based distros.][58575]
1791
1792 [59460]: https://github.com/rust-lang/rust/pull/59460/
1793 [59464]: https://github.com/rust-lang/rust/pull/59464/
1794 [59500]: https://github.com/rust-lang/rust/pull/59500/
1795 [59512]: https://github.com/rust-lang/rust/pull/59512/
1796 [59580]: https://github.com/rust-lang/rust/pull/59580/
1797 [59283]: https://github.com/rust-lang/rust/pull/59283/
1798 [59451]: https://github.com/rust-lang/rust/pull/59451/
1799 [59076]: https://github.com/rust-lang/rust/pull/59076/
1800 [58778]: https://github.com/rust-lang/rust/pull/58778/
1801 [58717]: https://github.com/rust-lang/rust/pull/58717/
1802 [58369]: https://github.com/rust-lang/rust/pull/58369/
1803 [58423]: https://github.com/rust-lang/rust/pull/58423/
1804 [58080]: https://github.com/rust-lang/rust/pull/58080/
1805 [57847]: https://github.com/rust-lang/rust/pull/57847/
1806 [58575]: https://github.com/rust-lang/rust/pull/58575
1807 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
1808 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
1809 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
1810 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
1811 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
1812 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
1813 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
1814 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
1815 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
1816 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
1817 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
1818 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
1819
1820 Version 1.34.2 (2019-05-14)
1821 ===========================
1822
1823 * [Destabilize the `Error::type_id` function due to a security
1824    vulnerability][60785] ([CVE-2019-12083])
1825
1826 [60785]: https://github.com/rust-lang/rust/pull/60785
1827 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
1828
1829 Version 1.34.1 (2019-04-25)
1830 ===========================
1831
1832 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
1833 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
1834 * [Fix Clippy panic when checking some macros][clippy/3805]
1835
1836 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
1837 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
1838 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
1839
1840 Version 1.34.0 (2019-04-11)
1841 ==========================
1842
1843 Language
1844 --------
1845 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
1846   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
1847   but had no effect.
1848 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
1849   `#[attr{}]` procedural macros.][57367]
1850 - [You can now write `extern crate self as foo;`][57407] to import your
1851   crate's root into the extern prelude.
1852
1853
1854 Compiler
1855 --------
1856 - [You can now target `riscv64imac-unknown-none-elf` and
1857   `riscv64gc-unknown-none-elf`.][58406]
1858 - [You can now enable linker plugin LTO optimisations with
1859   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
1860   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
1861   boundaries.
1862 - [You can now target `powerpc64-unknown-freebsd`.][57809]
1863
1864
1865 Libraries
1866 ---------
1867 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
1868   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
1869   the `Hash` trait to create an iterator.
1870 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
1871   methods.][58421] Most notably you no longer require the `Ord` trait to create
1872   an iterator.
1873 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
1874   for all numeric types.][58044]
1875 - [Indexing a `str` is now generic over all types that
1876   implement `SliceIndex<str>`.][57604]
1877 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
1878   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
1879   produce a warning if their returning type is unused.
1880 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
1881   `overflowing_pow` are now available for all numeric types.][57873] These are
1882   equivalent to methods such as `wrapping_add` for the `pow` operation.
1883
1884
1885 Stabilized APIs
1886 ---------------
1887
1888 #### std & core
1889 * [`Any::type_id`]
1890 * [`Error::type_id`]
1891 * [`atomic::AtomicI16`]
1892 * [`atomic::AtomicI32`]
1893 * [`atomic::AtomicI64`]
1894 * [`atomic::AtomicI8`]
1895 * [`atomic::AtomicU16`]
1896 * [`atomic::AtomicU32`]
1897 * [`atomic::AtomicU64`]
1898 * [`atomic::AtomicU8`]
1899 * [`convert::Infallible`]
1900 * [`convert::TryFrom`]
1901 * [`convert::TryInto`]
1902 * [`iter::from_fn`]
1903 * [`iter::successors`]
1904 * [`num::NonZeroI128`]
1905 * [`num::NonZeroI16`]
1906 * [`num::NonZeroI32`]
1907 * [`num::NonZeroI64`]
1908 * [`num::NonZeroI8`]
1909 * [`num::NonZeroIsize`]
1910 * [`slice::sort_by_cached_key`]
1911 * [`str::escape_debug`]
1912 * [`str::escape_default`]
1913 * [`str::escape_unicode`]
1914 * [`str::split_ascii_whitespace`]
1915
1916 #### std
1917 * [`Instant::checked_add`]
1918 * [`Instant::checked_sub`]
1919 * [`SystemTime::checked_add`]
1920 * [`SystemTime::checked_sub`]
1921
1922 Cargo
1923 -----
1924 - [You can now use alternative registries to crates.io.][cargo/6654]
1925
1926 Misc
1927 ----
1928 - [You can now use the `?` operator in your documentation tests without manually
1929   adding `fn main() -> Result<(), _> {}`.][56470]
1930
1931 Compatibility Notes
1932 -------------------
1933 - [`Command::before_exec` is being replaced by the unsafe method
1934   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
1935 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
1936   can now use `const` functions in `static` variables.
1937
1938 [58370]: https://github.com/rust-lang/rust/pull/58370/
1939 [58406]: https://github.com/rust-lang/rust/pull/58406/
1940 [58421]: https://github.com/rust-lang/rust/pull/58421/
1941 [58166]: https://github.com/rust-lang/rust/pull/58166/
1942 [58044]: https://github.com/rust-lang/rust/pull/58044/
1943 [58057]: https://github.com/rust-lang/rust/pull/58057/
1944 [58059]: https://github.com/rust-lang/rust/pull/58059/
1945 [57809]: https://github.com/rust-lang/rust/pull/57809/
1946 [57873]: https://github.com/rust-lang/rust/pull/57873/
1947 [57604]: https://github.com/rust-lang/rust/pull/57604/
1948 [57367]: https://github.com/rust-lang/rust/pull/57367/
1949 [57407]: https://github.com/rust-lang/rust/pull/57407/
1950 [57425]: https://github.com/rust-lang/rust/pull/57425/
1951 [57106]: https://github.com/rust-lang/rust/pull/57106/
1952 [56470]: https://github.com/rust-lang/rust/pull/56470/
1953 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
1954 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
1955 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
1956 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
1957 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
1958 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
1959 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
1960 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
1961 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
1962 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
1963 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
1964 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
1965 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
1966 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
1967 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
1968 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
1969 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
1970 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
1971 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
1972 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
1973 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
1974 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
1975 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
1976 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
1977 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
1978 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
1979 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
1980 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
1981 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
1982 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
1983 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
1984
1985
1986 Version 1.33.0 (2019-02-28)
1987 ==========================
1988
1989 Language
1990 --------
1991 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
1992   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
1993 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
1994   E.g. You can have match statement on a `u8` that covers `0..=255` and
1995   you would no longer be required to have a `_ => unreachable!()` case.
1996 - [You can now have multiple patterns in `if let` and `while let`
1997   expressions.][57532] You can do this with the same syntax as a `match`
1998   expression. E.g.
1999   ```rust
2000   enum Creature {
2001       Crab(String),
2002       Lobster(String),
2003       Person(String),
2004   }
2005
2006   fn main() {
2007       let state = Creature::Crab("Ferris");
2008
2009       if let Creature::Crab(name) | Creature::Person(name) = state {
2010           println!("This creature's name is: {}", name);
2011       }
2012   }
2013   ```
2014 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
2015   this feature will by default produce a warning as this behaviour can be
2016   unintuitive. E.g. `if let _ = 5 {}`
2017 - [You can now use `let` bindings, assignments, expression statements,
2018   and irrefutable pattern destructuring in const functions.][57175]
2019 - [You can now call unsafe const functions.][57067] E.g.
2020   ```rust
2021   const unsafe fn foo() -> i32 { 5 }
2022   const fn bar() -> i32 {
2023       unsafe { foo() }
2024   }
2025   ```
2026 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
2027   E.g. `#[cfg_attr(all(), must_use, optimize)]`
2028 - [You can now specify a specific alignment with the `#[repr(packed)]`
2029   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
2030   with an alignment of 2 bytes and a size of 6 bytes.
2031 - [You can now import an item from a module as an `_`.][56303] This allows you to
2032   import a trait's impls, and not have the name in the namespace. E.g.
2033   ```rust
2034   use std::io::Read as _;
2035
2036   // Allowed as there is only one `Read` in the module.
2037   pub trait Read {}
2038   ```
2039 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
2040
2041 Compiler
2042 --------
2043 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
2044   command line argument.][56351]
2045 - [The minimum required LLVM version has been bumped to 6.0.][56642]
2046 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
2047 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
2048   tier 2 support.][57130] Visit the [platform support][platform-support] page for
2049   information on Rust's platform support.
2050 - [Added support for the `thumbv7neon-linux-androideabi` and
2051   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
2052 - [Added support for the `x86_64-unknown-uefi` target.][56769]
2053
2054 Libraries
2055 ---------
2056 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
2057   functions for all numeric types.][57566]
2058 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
2059   are now `const` functions for all numeric types.][57105]
2060 - [The methods `is_positive` and `is_negative` are now `const` functions for
2061   all signed numeric types.][57105]
2062 - [The `get` method for all `NonZero` types is now `const`.][57167]
2063 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
2064   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
2065   numeric types.][57234]
2066 - [`Ipv4Addr::new` is now a `const` function][57234]
2067
2068 Stabilized APIs
2069 ---------------
2070 - [`unix::FileExt::read_exact_at`]
2071 - [`unix::FileExt::write_all_at`]
2072 - [`Option::transpose`]
2073 - [`Result::transpose`]
2074 - [`convert::identity`]
2075 - [`pin::Pin`]
2076 - [`marker::Unpin`]
2077 - [`marker::PhantomPinned`]
2078 - [`Vec::resize_with`]
2079 - [`VecDeque::resize_with`]
2080 - [`Duration::as_millis`]
2081 - [`Duration::as_micros`]
2082 - [`Duration::as_nanos`]
2083
2084
2085 Cargo
2086 -----
2087 - [You can now publish crates that require a feature flag to compile with
2088   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
2089 - [Cargo should now rebuild a crate if a file was modified during the initial
2090   build.][cargo/6484]
2091
2092 Compatibility Notes
2093 -------------------
2094 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
2095   are now deprecated in the standard library, and their usage will now produce a warning.
2096   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
2097   methods instead.
2098 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
2099   downcasting.
2100 - [Libtest no longer creates a new thread for each test when
2101   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
2102
2103 [55982]: https://github.com/rust-lang/rust/pull/55982/
2104 [56243]: https://github.com/rust-lang/rust/pull/56243
2105 [56303]: https://github.com/rust-lang/rust/pull/56303/
2106 [56351]: https://github.com/rust-lang/rust/pull/56351/
2107 [56362]: https://github.com/rust-lang/rust/pull/56362
2108 [56642]: https://github.com/rust-lang/rust/pull/56642/
2109 [56769]: https://github.com/rust-lang/rust/pull/56769/
2110 [56805]: https://github.com/rust-lang/rust/pull/56805
2111 [56947]: https://github.com/rust-lang/rust/pull/56947/
2112 [57049]: https://github.com/rust-lang/rust/pull/57049/
2113 [57067]: https://github.com/rust-lang/rust/pull/57067/
2114 [57105]: https://github.com/rust-lang/rust/pull/57105
2115 [57130]: https://github.com/rust-lang/rust/pull/57130/
2116 [57167]: https://github.com/rust-lang/rust/pull/57167/
2117 [57175]: https://github.com/rust-lang/rust/pull/57175/
2118 [57234]: https://github.com/rust-lang/rust/pull/57234/
2119 [57332]: https://github.com/rust-lang/rust/pull/57332/
2120 [57465]: https://github.com/rust-lang/rust/pull/57465/
2121 [57532]: https://github.com/rust-lang/rust/pull/57532/
2122 [57535]: https://github.com/rust-lang/rust/pull/57535/
2123 [57566]: https://github.com/rust-lang/rust/pull/57566/
2124 [57615]: https://github.com/rust-lang/rust/pull/57615/
2125 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
2126 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
2127 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
2128 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
2129 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
2130 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
2131 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
2132 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
2133 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
2134 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
2135 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
2136 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
2137 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
2138 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
2139 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
2140 [platform-support]: https://forge.rust-lang.org/platform-support.html
2141
2142 Version 1.32.0 (2019-01-17)
2143 ==========================
2144
2145 Language
2146 --------
2147 #### 2018 edition
2148 - [You can now use the `?` operator in macro definitions.][56245] The `?`
2149   operator allows you to specify zero or one repetitions similar to the `*` and
2150   `+` operators.
2151 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
2152   now always resolve to the item (`enum`, `struct`, etc.) available in the
2153   module if present, before resolving to a external crate or an item the prelude.][56759]
2154   E.g.
2155   ```rust
2156   enum Color { Red, Green, Blue }
2157
2158   use Color::*;
2159   ```
2160
2161 #### All editions
2162 - [You can now match against `PhantomData<T>` types.][55837]
2163 - [You can now match against literals in macros with the `literal`
2164   specifier.][56072] This will match against a literal of any type.
2165   E.g. `1`, `'A'`, `"Hello World"`
2166 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
2167   ```rust
2168   struct Point(i32, i32);
2169
2170   impl Point {
2171       pub fn new(x: i32, y: i32) -> Self {
2172           Self(x, y)
2173       }
2174
2175       pub fn is_origin(&self) -> bool {
2176           match self {
2177               Self(0, 0) => true,
2178               _ => false,
2179           }
2180       }
2181   }
2182   ```
2183 - [Self can also now be used in type definitions.][56366] E.g.
2184   ```rust
2185   enum List<T>
2186   where
2187       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
2188   {
2189       Nil,
2190       Cons(T, Box<Self>) // likewise here
2191   }
2192   ```
2193 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
2194   a `impl Trait` or `dyn Trait` is returned and unused in the program.
2195
2196 Compiler
2197 --------
2198 - [The default allocator has changed from jemalloc to the default allocator on
2199   your system.][55238] The compiler itself on Linux & macOS will still use
2200   jemalloc, but programs compiled with it will use the system allocator.
2201 - [Added the `aarch64-pc-windows-msvc` target.][55702]
2202
2203 Libraries
2204 ---------
2205 - [`PathBuf` now implements `FromStr`.][55148]
2206 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
2207 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
2208   easily debug expressions in your rust program. E.g.
2209   ```rust
2210   let a = 2;
2211   let b = dbg!(a * 2) + 1;
2212   //      ^-- prints: [src/main.rs:4] a * 2 = 4
2213   assert_eq!(b, 5);
2214   ```
2215
2216 The following APIs are now `const` functions and can be used in a
2217 `const` context.
2218
2219 - [`Cell::as_ptr`]
2220 - [`UnsafeCell::get`]
2221 - [`char::is_ascii`]
2222 - [`iter::empty`]
2223 - [`ManuallyDrop::new`]
2224 - [`ManuallyDrop::into_inner`]
2225 - [`RangeInclusive::start`]
2226 - [`RangeInclusive::end`]
2227 - [`NonNull::as_ptr`]
2228 - [`slice::as_ptr`]
2229 - [`str::as_ptr`]
2230 - [`Duration::as_secs`]
2231 - [`Duration::subsec_millis`]
2232 - [`Duration::subsec_micros`]
2233 - [`Duration::subsec_nanos`]
2234 - [`CStr::as_ptr`]
2235 - [`Ipv4Addr::is_unspecified`]
2236 - [`Ipv6Addr::new`]
2237 - [`Ipv6Addr::octets`]
2238
2239 Stabilized APIs
2240 ---------------
2241 - [`i8::to_be_bytes`]
2242 - [`i8::to_le_bytes`]
2243 - [`i8::to_ne_bytes`]
2244 - [`i8::from_be_bytes`]
2245 - [`i8::from_le_bytes`]
2246 - [`i8::from_ne_bytes`]
2247 - [`i16::to_be_bytes`]
2248 - [`i16::to_le_bytes`]
2249 - [`i16::to_ne_bytes`]
2250 - [`i16::from_be_bytes`]
2251 - [`i16::from_le_bytes`]
2252 - [`i16::from_ne_bytes`]
2253 - [`i32::to_be_bytes`]
2254 - [`i32::to_le_bytes`]
2255 - [`i32::to_ne_bytes`]
2256 - [`i32::from_be_bytes`]
2257 - [`i32::from_le_bytes`]
2258 - [`i32::from_ne_bytes`]
2259 - [`i64::to_be_bytes`]
2260 - [`i64::to_le_bytes`]
2261 - [`i64::to_ne_bytes`]
2262 - [`i64::from_be_bytes`]
2263 - [`i64::from_le_bytes`]
2264 - [`i64::from_ne_bytes`]
2265 - [`i128::to_be_bytes`]
2266 - [`i128::to_le_bytes`]
2267 - [`i128::to_ne_bytes`]
2268 - [`i128::from_be_bytes`]
2269 - [`i128::from_le_bytes`]
2270 - [`i128::from_ne_bytes`]
2271 - [`isize::to_be_bytes`]
2272 - [`isize::to_le_bytes`]
2273 - [`isize::to_ne_bytes`]
2274 - [`isize::from_be_bytes`]
2275 - [`isize::from_le_bytes`]
2276 - [`isize::from_ne_bytes`]
2277 - [`u8::to_be_bytes`]
2278 - [`u8::to_le_bytes`]
2279 - [`u8::to_ne_bytes`]
2280 - [`u8::from_be_bytes`]
2281 - [`u8::from_le_bytes`]
2282 - [`u8::from_ne_bytes`]
2283 - [`u16::to_be_bytes`]
2284 - [`u16::to_le_bytes`]
2285 - [`u16::to_ne_bytes`]
2286 - [`u16::from_be_bytes`]
2287 - [`u16::from_le_bytes`]
2288 - [`u16::from_ne_bytes`]
2289 - [`u32::to_be_bytes`]
2290 - [`u32::to_le_bytes`]
2291 - [`u32::to_ne_bytes`]
2292 - [`u32::from_be_bytes`]
2293 - [`u32::from_le_bytes`]
2294 - [`u32::from_ne_bytes`]
2295 - [`u64::to_be_bytes`]
2296 - [`u64::to_le_bytes`]
2297 - [`u64::to_ne_bytes`]
2298 - [`u64::from_be_bytes`]
2299 - [`u64::from_le_bytes`]
2300 - [`u64::from_ne_bytes`]
2301 - [`u128::to_be_bytes`]
2302 - [`u128::to_le_bytes`]
2303 - [`u128::to_ne_bytes`]
2304 - [`u128::from_be_bytes`]
2305 - [`u128::from_le_bytes`]
2306 - [`u128::from_ne_bytes`]
2307 - [`usize::to_be_bytes`]
2308 - [`usize::to_le_bytes`]
2309 - [`usize::to_ne_bytes`]
2310 - [`usize::from_be_bytes`]
2311 - [`usize::from_le_bytes`]
2312 - [`usize::from_ne_bytes`]
2313
2314 Cargo
2315 -----
2316 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
2317 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
2318
2319 Misc
2320 ----
2321 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
2322
2323 Compatibility Notes
2324 -------------------
2325 - [The argument types for AVX's
2326   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
2327   been changed from `*const` to `*mut` as the previous implementation
2328   was unsound.
2329
2330
2331 [55148]: https://github.com/rust-lang/rust/pull/55148/
2332 [55238]: https://github.com/rust-lang/rust/pull/55238/
2333 [55280]: https://github.com/rust-lang/rust/pull/55280/
2334 [55610]: https://github.com/rust-lang/rust/pull/55610/
2335 [55663]: https://github.com/rust-lang/rust/pull/55663/
2336 [55702]: https://github.com/rust-lang/rust/pull/55702/
2337 [55837]: https://github.com/rust-lang/rust/pull/55837/
2338 [55843]: https://github.com/rust-lang/rust/pull/55843/
2339 [56072]: https://github.com/rust-lang/rust/pull/56072/
2340 [56245]: https://github.com/rust-lang/rust/pull/56245/
2341 [56365]: https://github.com/rust-lang/rust/pull/56365/
2342 [56366]: https://github.com/rust-lang/rust/pull/56366/
2343 [56395]: https://github.com/rust-lang/rust/pull/56395/
2344 [56759]: https://github.com/rust-lang/rust/pull/56759/
2345 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
2346 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
2347 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
2348 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
2349 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
2350 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2351 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2352 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
2353 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
2354 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
2355 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
2356 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
2357 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
2358 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
2359 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
2360 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
2361 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
2362 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
2363 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
2364 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
2365 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
2366 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
2367 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
2368 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
2369 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
2370 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
2371 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
2372 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
2373 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
2374 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
2375 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
2376 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
2377 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
2378 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
2379 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
2380 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
2381 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
2382 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
2383 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
2384 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
2385 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
2386 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
2387 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
2388 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
2389 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
2390 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
2391 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
2392 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
2393 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
2394 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
2395 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
2396 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
2397 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
2398 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
2399 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
2400 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
2401 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
2402 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
2403 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
2404 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
2405 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
2406 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
2407 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
2408 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
2409 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
2410 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
2411 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
2412 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
2413 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
2414 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
2415 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
2416 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
2417 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
2418 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
2419 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
2420 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
2421 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
2422 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
2423 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
2424 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
2425 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
2426 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
2427 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
2428 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
2429 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
2430 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
2431 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
2432 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
2433 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
2434 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
2435 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
2436 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
2437 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
2438
2439
2440 Version 1.31.1 (2018-12-20)
2441 ===========================
2442
2443 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
2444 - [Fix broken go-to-definition in RLS][rls/1171]
2445 - [Fix infinite loop on hover in RLS][rls/1170]
2446
2447 [56562]: https://github.com/rust-lang/rust/pull/56562
2448 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
2449 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
2450
2451 Version 1.31.0 (2018-12-06)
2452 ==========================
2453
2454 Language
2455 --------
2456 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
2457 - [New lifetime elision rules now allow for eliding lifetimes in functions and
2458   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
2459   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
2460   in structs.
2461 - [You can now define and use `const` functions.][54835] These are currently
2462   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
2463   [language reference][const-reference] for what exactly is available.
2464 - [You can now use tool lints, which allow you to scope lints from external
2465   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
2466 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
2467   a crate, not just in exported functions.][54451]
2468 - [You can now use parentheses in pattern matches.][54497]
2469
2470 Compiler
2471 --------
2472 - [Updated musl to 1.1.20][54430]
2473
2474 Libraries
2475 ---------
2476 - [You can now convert `num::NonZero*` types to their raw equivalents using the
2477   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
2478 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
2479   into `Option<&mut T>` using the `From` trait.][53218]
2480 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
2481
2482
2483 Stabilized APIs
2484 ---------------
2485 - [`slice::align_to`]
2486 - [`slice::align_to_mut`]
2487 - [`slice::chunks_exact`]
2488 - [`slice::chunks_exact_mut`]
2489 - [`slice::rchunks`]
2490 - [`slice::rchunks_mut`]
2491 - [`slice::rchunks_exact`]
2492 - [`slice::rchunks_exact_mut`]
2493 - [`Option::replace`]
2494
2495 Cargo
2496 -----
2497 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
2498 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
2499   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
2500
2501 [52813]: https://github.com/rust-lang/rust/pull/52813/
2502 [53218]: https://github.com/rust-lang/rust/pull/53218/
2503 [53555]: https://github.com/rust-lang/rust/issues/53555/
2504 [54057]: https://github.com/rust-lang/rust/pull/54057/
2505 [54240]: https://github.com/rust-lang/rust/pull/54240/
2506 [54430]: https://github.com/rust-lang/rust/pull/54430/
2507 [54451]: https://github.com/rust-lang/rust/pull/54451/
2508 [54497]: https://github.com/rust-lang/rust/pull/54497/
2509 [54778]: https://github.com/rust-lang/rust/pull/54778/
2510 [54835]: https://github.com/rust-lang/rust/pull/54835/
2511 [54870]: https://github.com/rust-lang/rust/pull/54870/
2512 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
2513 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
2514 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
2515 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
2516 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
2517 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
2518 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2519 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
2520 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2521 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
2522 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
2523 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
2524 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
2525 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
2526
2527 Version 1.30.1 (2018-11-08)
2528 ===========================
2529
2530 - [Fixed overflow ICE in rustdoc][54199]
2531 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
2532
2533 [54199]: https://github.com/rust-lang/rust/pull/54199
2534 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
2535
2536 Version 1.30.0 (2018-10-25)
2537 ==========================
2538
2539 Language
2540 --------
2541 - [Procedural macros are now available.][52081] These kinds of macros allow for
2542   more powerful code generation. There is a [new chapter available][proc-macros]
2543   in the Rust Programming Language book that goes further in depth.
2544 - [You can now use keywords as identifiers using the raw identifiers
2545   syntax (`r#`),][53236] e.g. `let r#for = true;`
2546 - [Using anonymous parameters in traits is now deprecated with a warning and
2547   will be a hard error in the 2018 edition.][53272]
2548 - [You can now use `crate` in paths.][54404] This allows you to refer to the
2549   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
2550 - [Using a external crate no longer requires being prefixed with `::`.][54404]
2551   Previously, using a external crate in a module without a use statement
2552   required `let json = ::serde_json::from_str(foo);` but can now be written
2553   as `let json = serde_json::from_str(foo);`.
2554 - [You can now apply the `#[used]` attribute to static items to prevent the
2555   compiler from optimising them away, even if they appear to be unused,][51363]
2556   e.g. `#[used] static FOO: u32 = 1;`
2557 - [You can now import and reexport macros from other crates with the `use`
2558   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
2559   the root module of the crate. If your macro relies on calling other local
2560   macros, it is recommended to export with the
2561   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
2562   those macros.
2563 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
2564   using the `vis` specifier.][53370]
2565 - [Non-macro attributes now allow all forms of literals, not just
2566   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
2567   write `#[attr(true)]`.
2568 - [You can now specify a function to handle a panic in the Rust runtime with the
2569   `#[panic_handler]` attribute.][51366]
2570
2571 Compiler
2572 --------
2573 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
2574 - [Added the `aarch64-unknown-netbsd` target][53165]
2575
2576 Libraries
2577 ---------
2578 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
2579
2580 Stabilized APIs
2581 ---------------
2582 - [`Ipv4Addr::BROADCAST`]
2583 - [`Ipv4Addr::LOCALHOST`]
2584 - [`Ipv4Addr::UNSPECIFIED`]
2585 - [`Ipv6Addr::LOCALHOST`]
2586 - [`Ipv6Addr::UNSPECIFIED`]
2587 - [`Iterator::find_map`]
2588
2589   The following methods are replacement methods for `trim_left`, `trim_right`,
2590   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
2591   in 1.33.0:
2592 - [`str::trim_end_matches`]
2593 - [`str::trim_end`]
2594 - [`str::trim_start_matches`]
2595 - [`str::trim_start`]
2596
2597 Cargo
2598 ----
2599 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
2600 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
2601   equivalent to calling `rustdoc --error-format=json`.
2602 - [Cargo will now provide a progress bar for builds.][cargo/5995]
2603
2604 Misc
2605 ----
2606 - [`rustdoc` allows you to specify what edition to treat your code as with the
2607   `--edition` option.][54057]
2608 - [`rustdoc` now has the `--color` (specify whether to output color) and
2609   `--error-format` (specify error format, e.g. `json`) options.][53003]
2610 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
2611   debug symbols.][53774]
2612 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
2613   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
2614
2615 [50911]: https://github.com/rust-lang/rust/pull/50911/
2616 [51363]: https://github.com/rust-lang/rust/pull/51363/
2617 [51366]: https://github.com/rust-lang/rust/pull/51366/
2618 [52081]: https://github.com/rust-lang/rust/pull/52081/
2619 [53003]: https://github.com/rust-lang/rust/pull/53003/
2620 [53033]: https://github.com/rust-lang/rust/pull/53033/
2621 [53044]: https://github.com/rust-lang/rust/pull/53044/
2622 [53165]: https://github.com/rust-lang/rust/pull/53165/
2623 [53213]: https://github.com/rust-lang/rust/pull/53213/
2624 [53236]: https://github.com/rust-lang/rust/pull/53236/
2625 [53272]: https://github.com/rust-lang/rust/pull/53272/
2626 [53370]: https://github.com/rust-lang/rust/pull/53370/
2627 [53459]: https://github.com/rust-lang/rust/pull/53459/
2628 [53774]: https://github.com/rust-lang/rust/pull/53774/
2629 [53822]: https://github.com/rust-lang/rust/pull/53822/
2630 [54057]: https://github.com/rust-lang/rust/pull/54057/
2631 [54146]: https://github.com/rust-lang/rust/pull/54146/
2632 [54404]: https://github.com/rust-lang/rust/pull/54404/
2633 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
2634 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
2635 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
2636 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
2637
2638 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
2639 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
2640 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
2641 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
2642 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
2643 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
2644 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
2645 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
2646 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
2647 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
2648
2649
2650 Version 1.29.2 (2018-10-11)
2651 ===========================
2652
2653 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
2654 - The `rls-preview` component on the windows-gnu targets has been restored.
2655
2656 [54639]: https://github.com/rust-lang/rust/pull/54639
2657
2658
2659 Version 1.29.1 (2018-09-25)
2660 ===========================
2661
2662 Security Notes
2663 --------------
2664
2665 - The standard library's `str::repeat` function contained an out of bounds write
2666   caused by an integer overflow. This has been fixed by deterministically
2667   panicking when an overflow happens.
2668
2669   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
2670   us.
2671
2672
2673 Version 1.29.0 (2018-09-13)
2674 ==========================
2675
2676 Compiler
2677 --------
2678 - [Bumped minimum LLVM version to 5.0.][51899]
2679 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
2680 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
2681
2682 Libraries
2683 ---------
2684 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
2685 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
2686 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
2687 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
2688   for `&str`.][51178]
2689 - [`Cell<T>` now allows `T` to be unsized.][50494]
2690 - [`SocketAddr` is now stable on Redox.][52656]
2691
2692 Stabilized APIs
2693 ---------------
2694 - [`Arc::downcast`]
2695 - [`Iterator::flatten`]
2696 - [`Rc::downcast`]
2697
2698 Cargo
2699 -----
2700 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
2701   `--locked` to disable this behavior.
2702 - [`cargo-install` will now allow you to cross compile an install
2703   using `--target`.][cargo/5614]
2704 - [Added the `cargo-fix` subcommand to automatically move project code from
2705   2015 edition to 2018.][cargo/5723]
2706 - [`cargo doc` can now optionally document private types using the
2707   `--document-private-items` flag.][cargo/5543]
2708
2709 Misc
2710 ----
2711 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
2712   the specified level to that level.][52354] For example `--cap-lints warn`
2713   will demote `deny` and `forbid` lints to `warn`.
2714 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
2715   fails and `101` if there is a panic.][52197]
2716 - [A preview of clippy has been made available through rustup.][51122]
2717   You can install the preview with `rustup component add clippy-preview`.
2718
2719 Compatibility Notes
2720 -------------------
2721 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
2722   Use `str::get_unchecked(begin..end)` instead.
2723 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
2724   Consider using the `home_dir` function from
2725   https://crates.io/crates/dirs instead.
2726 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
2727 - [`cfg` attributes and `--cfg` command line flags are now more
2728   strictly validated.][53893]
2729
2730 [53893]: https://github.com/rust-lang/rust/pull/53893/
2731 [52861]: https://github.com/rust-lang/rust/pull/52861/
2732 [52656]: https://github.com/rust-lang/rust/pull/52656/
2733 [52239]: https://github.com/rust-lang/rust/pull/52239/
2734 [52330]: https://github.com/rust-lang/rust/pull/52330/
2735 [52354]: https://github.com/rust-lang/rust/pull/52354/
2736 [52402]: https://github.com/rust-lang/rust/pull/52402/
2737 [52103]: https://github.com/rust-lang/rust/pull/52103/
2738 [52197]: https://github.com/rust-lang/rust/pull/52197/
2739 [51807]: https://github.com/rust-lang/rust/pull/51807/
2740 [51899]: https://github.com/rust-lang/rust/pull/51899/
2741 [51912]: https://github.com/rust-lang/rust/pull/51912/
2742 [51511]: https://github.com/rust-lang/rust/pull/51511/
2743 [51619]: https://github.com/rust-lang/rust/pull/51619/
2744 [51656]: https://github.com/rust-lang/rust/pull/51656/
2745 [51178]: https://github.com/rust-lang/rust/pull/51178/
2746 [51122]: https://github.com/rust-lang/rust/pull/51122
2747 [50494]: https://github.com/rust-lang/rust/pull/50494/
2748 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
2749 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
2750 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
2751 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
2752 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
2753 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
2754 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
2755
2756
2757 Version 1.28.0 (2018-08-02)
2758 ===========================
2759
2760 Language
2761 --------
2762 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
2763   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
2764   the inner type across Foreign Function Interface (FFI) boundaries.
2765 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
2766   and can now be used as identifiers.][51196]
2767 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
2768   stable.][51241] This will allow users to specify a global allocator for
2769   their program.
2770 - [Unit test functions marked with the `#[test]` attribute can now return
2771   `Result<(), E: Debug>` in addition to `()`.][51298]
2772 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
2773   allows macros to easily target lifetimes.
2774
2775 Compiler
2776 --------
2777 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
2778   prioritise making smaller binary sizes. `z` is the same as `s` with the
2779   exception that it does not vectorise loops, which typically results in an even
2780   smaller binary.
2781 - [The short error format is now stable.][49546] Specified with
2782   `--error-format=short` this option will provide a more compressed output of
2783   rust error messages.
2784 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
2785 - [Reduced the number of allocations in the macro parser.][50855] This can
2786   improve compile times of macro heavy crates on average by 5%.
2787
2788 Libraries
2789 ---------
2790 - [Implemented `Default` for `&mut str`.][51306]
2791 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
2792 - [Implemented `Extend` for `()`.][50234]
2793 - [The `Debug` implementation of `time::Duration` should now be more easily
2794   human readable.][50364] Previously a `Duration` of one second would printed as
2795   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
2796 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
2797   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
2798   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
2799   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
2800   for `PathBuf`.][50170]
2801 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
2802   and `Wrapping<i128>`.][50465]
2803 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
2804   possible.][51050] This can provide up to a 40% speed increase.
2805 - [Improved error messages when using `format!`.][50610]
2806
2807 Stabilized APIs
2808 ---------------
2809 - [`Iterator::step_by`]
2810 - [`Path::ancestors`]
2811 - [`SystemTime::UNIX_EPOCH`]
2812 - [`alloc::GlobalAlloc`]
2813 - [`alloc::Layout`]
2814 - [`alloc::LayoutErr`]
2815 - [`alloc::System`]
2816 - [`alloc::alloc`]
2817 - [`alloc::alloc_zeroed`]
2818 - [`alloc::dealloc`]
2819 - [`alloc::realloc`]
2820 - [`alloc::handle_alloc_error`]
2821 - [`btree_map::Entry::or_default`]
2822 - [`fmt::Alignment`]
2823 - [`hash_map::Entry::or_default`]
2824 - [`iter::repeat_with`]
2825 - [`num::NonZeroUsize`]
2826 - [`num::NonZeroU128`]
2827 - [`num::NonZeroU16`]
2828 - [`num::NonZeroU32`]
2829 - [`num::NonZeroU64`]
2830 - [`num::NonZeroU8`]
2831 - [`ops::RangeBounds`]
2832 - [`slice::SliceIndex`]
2833 - [`slice::from_mut`]
2834 - [`slice::from_ref`]
2835 - [`{Any + Send + Sync}::downcast_mut`]
2836 - [`{Any + Send + Sync}::downcast_ref`]
2837 - [`{Any + Send + Sync}::is`]
2838
2839 Cargo
2840 -----
2841 - [Cargo will now no longer allow you to publish crates with build scripts that
2842   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
2843   considered to be immutable.
2844
2845 Misc
2846 ----
2847 - [The `suggestion_applicability` field in `rustc`'s json output is now
2848   stable.][50486] This will allow dev tools to check whether a code suggestion
2849   would apply to them.
2850
2851 Compatibility Notes
2852 -------------------
2853 - [Rust will consider trait objects with duplicated constraints to be the same
2854   type as without the duplicated constraint.][51276] For example the below code will
2855   now fail to compile.
2856   ```rust
2857   trait Trait {}
2858
2859   impl Trait + Send {
2860       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
2861   }
2862
2863   impl Trait + Send + Send {
2864       fn test(&self) { println!("two"); }
2865   }
2866   ```
2867
2868 [49546]: https://github.com/rust-lang/rust/pull/49546/
2869 [50143]: https://github.com/rust-lang/rust/pull/50143/
2870 [50170]: https://github.com/rust-lang/rust/pull/50170/
2871 [50234]: https://github.com/rust-lang/rust/pull/50234/
2872 [50265]: https://github.com/rust-lang/rust/pull/50265/
2873 [50364]: https://github.com/rust-lang/rust/pull/50364/
2874 [50385]: https://github.com/rust-lang/rust/pull/50385/
2875 [50465]: https://github.com/rust-lang/rust/pull/50465/
2876 [50486]: https://github.com/rust-lang/rust/pull/50486/
2877 [50554]: https://github.com/rust-lang/rust/pull/50554/
2878 [50610]: https://github.com/rust-lang/rust/pull/50610/
2879 [50855]: https://github.com/rust-lang/rust/pull/50855/
2880 [51050]: https://github.com/rust-lang/rust/pull/51050/
2881 [51196]: https://github.com/rust-lang/rust/pull/51196/
2882 [51200]: https://github.com/rust-lang/rust/pull/51200/
2883 [51241]: https://github.com/rust-lang/rust/pull/51241/
2884 [51276]: https://github.com/rust-lang/rust/pull/51276/
2885 [51298]: https://github.com/rust-lang/rust/pull/51298/
2886 [51306]: https://github.com/rust-lang/rust/pull/51306/
2887 [51562]: https://github.com/rust-lang/rust/pull/51562/
2888 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
2889 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
2890 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
2891 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
2892 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
2893 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
2894 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
2895 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
2896 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
2897 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
2898 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
2899 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
2900 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
2901 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
2902 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
2903 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
2904 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
2905 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
2906 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
2907 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
2908 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
2909 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
2910 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
2911 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
2912 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
2913 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
2914 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
2915 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
2916 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
2917 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
2918
2919 Version 1.27.2 (2018-07-20)
2920 ===========================
2921
2922 Compatibility Notes
2923 -------------------
2924
2925 - The borrow checker was fixed to avoid potential unsoundness when using
2926   match ergonomics: [#52213][52213].
2927
2928 [52213]: https://github.com/rust-lang/rust/issues/52213
2929
2930 Version 1.27.1 (2018-07-10)
2931 ===========================
2932
2933 Security Notes
2934 --------------
2935
2936 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
2937   when running, which enabled executing code as some other user on a
2938   given machine. This release fixes that vulnerability; you can read
2939   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
2940
2941   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
2942
2943 Compatibility Notes
2944 -------------------
2945
2946 - The borrow checker was fixed to avoid an additional potential unsoundness when using
2947   match ergonomics: [#51415][51415], [#49534][49534].
2948
2949 [51415]: https://github.com/rust-lang/rust/issues/51415
2950 [49534]: https://github.com/rust-lang/rust/issues/49534
2951 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
2952 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
2953
2954 Version 1.27.0 (2018-06-21)
2955 ==========================
2956
2957 Language
2958 --------
2959 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
2960   be used as an identifier.
2961 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
2962   bare `Trait` syntax, and should make it clearer when being used in tandem with
2963   `impl Trait` because it is equivalent to the following syntax:
2964   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
2965   `Box<Trait> == Box<dyn Trait>`.
2966 - [Attributes on generic parameters such as types and lifetimes are
2967   now stable.][48851] e.g.
2968   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
2969 - [The `#[must_use]` attribute can now also be used on functions as well as
2970   types.][48925] It provides a lint that by default warns users when the
2971   value returned by a function has not been used.
2972
2973 Compiler
2974 --------
2975 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
2976
2977 Libraries
2978 ---------
2979 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
2980   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
2981   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
2982   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
2983   the `cfg` attribute.
2984 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
2985   std are now available in core.][49896]
2986 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
2987   to `Self`.][49630]
2988 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
2989   that the operation isn't done in place.
2990 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
2991   the `#[must_use]` attribute][49533] to warn about unused potentially
2992   expensive allocations.
2993
2994 Stabilized APIs
2995 ---------------
2996 - [`DoubleEndedIterator::rfind`]
2997 - [`DoubleEndedIterator::rfold`]
2998 - [`DoubleEndedIterator::try_rfold`]
2999 - [`Duration::from_micros`]
3000 - [`Duration::from_nanos`]
3001 - [`Duration::subsec_micros`]
3002 - [`Duration::subsec_millis`]
3003 - [`HashMap::remove_entry`]
3004 - [`Iterator::try_fold`]
3005 - [`Iterator::try_for_each`]
3006 - [`NonNull::cast`]
3007 - [`Option::filter`]
3008 - [`String::replace_range`]
3009 - [`Take::set_limit`]
3010 - [`hint::unreachable_unchecked`]
3011 - [`os::unix::process::parent_id`]
3012 - [`ptr::swap_nonoverlapping`]
3013 - [`slice::rsplit_mut`]
3014 - [`slice::rsplit`]
3015 - [`slice::swap_with_slice`]
3016
3017 Cargo
3018 -----
3019 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
3020   `readme`, and `repository` fields.][cargo/5386]
3021 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
3022 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
3023   a different directory than `target` for placing compilation artifacts.
3024 - [Cargo will be adding automatic target inference for binaries, benchmarks,
3025   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
3026   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
3027   where cargo would infer a binary, Cargo will produce a warning. You can
3028   disable this feature ahead of time by setting any of the following to false:
3029   `autobins`, `autobenches`, `autoexamples`, `autotests`.
3030 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
3031   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
3032
3033 Misc
3034 ----
3035 - [Added “The Rustc book” into the official documentation.][49707]
3036   [“The Rustc book”] documents and teaches how to use the rustc compiler.
3037 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
3038
3039 Compatibility Notes
3040 -------------------
3041 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
3042   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
3043   compile, `"".is_empty()` will still compile.
3044 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
3045   will only print the inner type.][48553] E.g.
3046   `print!("{:?}", AtomicBool::new(true))` will print `true`,
3047   not `AtomicBool(true)`.
3048 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
3049   could enter higher numbers but they were not supported by LLVM. Up to 512MB
3050   alignment should cover all use cases.
3051 - The `.description()` method on the `std::error::Error` trait
3052   [has been soft-deprecated][50163]. It is no longer required to implement it.
3053
3054 [48553]: https://github.com/rust-lang/rust/pull/48553/
3055 [48851]: https://github.com/rust-lang/rust/pull/48851/
3056 [48925]: https://github.com/rust-lang/rust/pull/48925/
3057 [49533]: https://github.com/rust-lang/rust/pull/49533/
3058 [49623]: https://github.com/rust-lang/rust/pull/49623/
3059 [49630]: https://github.com/rust-lang/rust/pull/49630/
3060 [49664]: https://github.com/rust-lang/rust/pull/49664/
3061 [49699]: https://github.com/rust-lang/rust/pull/49699/
3062 [49707]: https://github.com/rust-lang/rust/pull/49707/
3063 [49719]: https://github.com/rust-lang/rust/pull/49719/
3064 [49896]: https://github.com/rust-lang/rust/pull/49896/
3065 [49968]: https://github.com/rust-lang/rust/pull/49968/
3066 [50163]: https://github.com/rust-lang/rust/pull/50163
3067 [50177]: https://github.com/rust-lang/rust/pull/50177/
3068 [50378]: https://github.com/rust-lang/rust/pull/50378/
3069 [50398]: https://github.com/rust-lang/rust/pull/50398/
3070 [50423]: https://github.com/rust-lang/rust/pull/50423/
3071 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
3072 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
3073 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
3074 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
3075 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
3076 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
3077 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
3078 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
3079 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
3080 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
3081 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
3082 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3083 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3084 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
3085 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
3086 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
3087 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
3088 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
3089 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
3090 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
3091 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
3092 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
3093 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3094 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
3095 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
3096 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
3097 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
3098 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
3099 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
3100 [“The Rustc book”]: https://doc.rust-lang.org/rustc
3101
3102
3103 Version 1.26.2 (2018-06-05)
3104 ==========================
3105
3106 Compatibility Notes
3107 -------------------
3108
3109 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
3110
3111 [51117]: https://github.com/rust-lang/rust/issues/51117
3112
3113
3114 Version 1.26.1 (2018-05-29)
3115 ==========================
3116
3117 Tools
3118 -----
3119
3120 - [RLS now works on Windows.][50646]
3121 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
3122
3123
3124 Compatibility Notes
3125 --------
3126
3127 - [`fn main() -> impl Trait` no longer works for non-Termination
3128   trait.][50656]
3129   This reverts an accidental stabilization.
3130 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
3131 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
3132
3133 [50646]: https://github.com/rust-lang/rust/issues/50646
3134 [50656]: https://github.com/rust-lang/rust/pull/50656
3135 [50812]: https://github.com/rust-lang/rust/pull/50812
3136 [50950]: https://github.com/rust-lang/rust/issues/50950
3137 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
3138
3139 Version 1.26.0 (2018-05-10)
3140 ==========================
3141
3142 Language
3143 --------
3144 - [Closures now implement `Copy` and/or `Clone` if all captured variables
3145   implement either or both traits.][49299]
3146 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
3147 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
3148   lifetime can be elided.][49458]
3149 - [`impl Trait` is now stable allowing you to have abstract types in returns
3150    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
3151   `fn open(path: impl AsRef<Path>)`.
3152 - [Pattern matching will now automatically apply dereferences.][49394]
3153 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
3154 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
3155 - [A lot of operations are now available in a const context.][46882] E.g. You
3156   can now index into constant arrays, reference and dereference into constants,
3157   and use tuple struct constructors.
3158 - [Fixed entry slice patterns are now stable.][48516] E.g.
3159   ```rust
3160   let points = [1, 2, 3, 4];
3161   match points {
3162       [1, 2, 3, 4] => println!("All points were sequential."),
3163       _ => println!("Not all points were sequential."),
3164   }
3165   ```
3166
3167
3168 Compiler
3169 --------
3170 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
3171 - [Fixed exponential projection complexity on nested types.][48296]
3172   This can provide up to a ~12% reduction in compile times for certain crates.
3173 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
3174   to remap path prefixes outputted by the compiler.
3175 - [Added `powerpc-unknown-netbsd` target.][48281]
3176
3177 Libraries
3178 ---------
3179 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
3180 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
3181   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
3182 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
3183 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
3184 - [`ascii::escape_default` is now available in libcore.][48735]
3185 - [Trailing commas are now supported in std and core macros.][48056]
3186 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
3187 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
3188
3189 Stabilized APIs
3190 ---------------
3191 - [`*const T::add`]
3192 - [`*const T::copy_to_nonoverlapping`]
3193 - [`*const T::copy_to`]
3194 - [`*const T::read_unaligned`]
3195 - [`*const T::read_volatile`]
3196 - [`*const T::read`]
3197 - [`*const T::sub`]
3198 - [`*const T::wrapping_add`]
3199 - [`*const T::wrapping_sub`]
3200 - [`*mut T::add`]
3201 - [`*mut T::copy_to_nonoverlapping`]
3202 - [`*mut T::copy_to`]
3203 - [`*mut T::read_unaligned`]
3204 - [`*mut T::read_volatile`]
3205 - [`*mut T::read`]
3206 - [`*mut T::replace`]
3207 - [`*mut T::sub`]
3208 - [`*mut T::swap`]
3209 - [`*mut T::wrapping_add`]
3210 - [`*mut T::wrapping_sub`]
3211 - [`*mut T::write_bytes`]
3212 - [`*mut T::write_unaligned`]
3213 - [`*mut T::write_volatile`]
3214 - [`*mut T::write`]
3215 - [`Box::leak`]
3216 - [`FromUtf8Error::as_bytes`]
3217 - [`LocalKey::try_with`]
3218 - [`Option::cloned`]
3219 - [`btree_map::Entry::and_modify`]
3220 - [`fs::read_to_string`]
3221 - [`fs::read`]
3222 - [`fs::write`]
3223 - [`hash_map::Entry::and_modify`]
3224 - [`iter::FusedIterator`]
3225 - [`ops::RangeInclusive`]
3226 - [`ops::RangeToInclusive`]
3227 - [`process::id`]
3228 - [`slice::rotate_left`]
3229 - [`slice::rotate_right`]
3230 - [`String::retain`]
3231
3232
3233 Cargo
3234 -----
3235 - [Cargo will now output path to custom commands when `-v` is
3236   passed with `--list`][cargo/5041]
3237 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
3238
3239 Misc
3240 ----
3241 - [The second edition of "The Rust Programming Language" book is now recommended
3242   over the first.][48404]
3243
3244 Compatibility Notes
3245 -------------------
3246
3247 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
3248   syntax is now invalid.
3249   ```
3250   use std::ops::Fn as dyn;
3251   fn g(_: Box<dyn(std::fmt::Debug)>) {}
3252   ```
3253 - [The result of dereferences are no longer promoted to `'static`.][47408]
3254   e.g.
3255   ```rust
3256   fn main() {
3257       const PAIR: &(i32, i32) = &(0, 1);
3258       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
3259   }
3260   ```
3261 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
3262 - [`".e0"` will now no longer parse as `0.0` and will instead cause
3263   an error.][48235]
3264 - [Removed hoedown from rustdoc.][48274]
3265 - [Bounds on higher-kinded lifetimes a hard error.][48326]
3266
3267 [46882]: https://github.com/rust-lang/rust/pull/46882
3268 [47379]: https://github.com/rust-lang/rust/pull/47379
3269 [47408]: https://github.com/rust-lang/rust/pull/47408
3270 [47813]: https://github.com/rust-lang/rust/pull/47813
3271 [48056]: https://github.com/rust-lang/rust/pull/48056
3272 [48125]: https://github.com/rust-lang/rust/pull/48125
3273 [48166]: https://github.com/rust-lang/rust/pull/48166
3274 [48235]: https://github.com/rust-lang/rust/pull/48235
3275 [48274]: https://github.com/rust-lang/rust/pull/48274
3276 [48281]: https://github.com/rust-lang/rust/pull/48281
3277 [48296]: https://github.com/rust-lang/rust/pull/48296
3278 [48326]: https://github.com/rust-lang/rust/pull/48326
3279 [48359]: https://github.com/rust-lang/rust/pull/48359
3280 [48404]: https://github.com/rust-lang/rust/pull/48404
3281 [48481]: https://github.com/rust-lang/rust/pull/48481
3282 [48516]: https://github.com/rust-lang/rust/pull/48516
3283 [48628]: https://github.com/rust-lang/rust/pull/48628
3284 [48629]: https://github.com/rust-lang/rust/pull/48629
3285 [48657]: https://github.com/rust-lang/rust/pull/48657
3286 [48735]: https://github.com/rust-lang/rust/pull/48735
3287 [48978]: https://github.com/rust-lang/rust/pull/48978
3288 [49101]: https://github.com/rust-lang/rust/pull/49101
3289 [49109]: https://github.com/rust-lang/rust/pull/49109
3290 [49121]: https://github.com/rust-lang/rust/pull/49121
3291 [49162]: https://github.com/rust-lang/rust/pull/49162
3292 [49184]: https://github.com/rust-lang/rust/pull/49184
3293 [49234]: https://github.com/rust-lang/rust/pull/49234
3294 [49255]: https://github.com/rust-lang/rust/pull/49255
3295 [49299]: https://github.com/rust-lang/rust/pull/49299
3296 [49305]: https://github.com/rust-lang/rust/pull/49305
3297 [49394]: https://github.com/rust-lang/rust/pull/49394
3298 [49458]: https://github.com/rust-lang/rust/pull/49458
3299 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
3300 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
3301 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
3302 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
3303 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
3304 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
3305 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
3306 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
3307 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
3308 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
3309 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
3310 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
3311 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
3312 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
3313 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
3314 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
3315 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
3316 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
3317 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
3318 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
3319 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
3320 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
3321 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
3322 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
3323 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
3324 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
3325 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
3326 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
3327 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
3328 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
3329 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
3330 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
3331 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
3332 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
3333 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
3334 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
3335 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3336 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
3337 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
3338 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
3339 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
3340 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
3341
3342
3343 Version 1.25.0 (2018-03-29)
3344 ==========================
3345
3346 Language
3347 --------
3348 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
3349 - [You can now use nested groups of imports.][47948]
3350   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
3351 - [You can now have `|` at the start of a match arm.][47947] e.g.
3352 ```rust
3353 enum Foo { A, B, C }
3354
3355 fn main() {
3356     let x = Foo::A;
3357     match x {
3358         | Foo::A
3359         | Foo::B => println!("AB"),
3360         | Foo::C => println!("C"),
3361     }
3362 }
3363 ```
3364
3365 Compiler
3366 --------
3367 - [Upgraded to LLVM 6.][47828]
3368 - [Added `-C lto=val` option.][47521]
3369 - [Added `i586-unknown-linux-musl` target][47282]
3370
3371 Libraries
3372 ---------
3373 - [Impl Send for `process::Command` on Unix.][47760]
3374 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
3375 - [`UnsafeCell::into_inner` is now safe.][47204]
3376 - [Implement libstd for CloudABI.][47268]
3377 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
3378 - [Implement `AsRef<Path>` for Component][46985]
3379 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
3380 - [Moved `Duration` to libcore.][46666]
3381
3382 Stabilized APIs
3383 ---------------
3384 - [`Location::column`]
3385 - [`ptr::NonNull`]
3386
3387 The following functions can now be used in a constant expression.
3388 eg. `static MINUTE: Duration = Duration::from_secs(60);`
3389 - [`Duration::new`][47300]
3390 - [`Duration::from_secs`][47300]
3391 - [`Duration::from_millis`][47300]
3392
3393 Cargo
3394 -----
3395 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
3396 - [`cargo new` now defaults to creating a binary crate, instead of a
3397   library crate.][cargo/5029]
3398
3399 Misc
3400 ----
3401 - [Rust by example is now shipped with new releases][46196]
3402
3403 Compatibility Notes
3404 -------------------
3405 - [Deprecated `net::lookup_host`.][47510]
3406 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
3407 - The borrow checker was sometimes incorrectly permitting overlapping borrows
3408   around indexing operations (see [#47349][47349]). This has been fixed (which also
3409   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
3410 - [Removed deprecated unstable attribute `#[simd]`.][47251]
3411
3412 [33903]: https://github.com/rust-lang/rust/pull/33903
3413 [47947]: https://github.com/rust-lang/rust/pull/47947
3414 [47948]: https://github.com/rust-lang/rust/pull/47948
3415 [47760]: https://github.com/rust-lang/rust/pull/47760
3416 [47790]: https://github.com/rust-lang/rust/pull/47790
3417 [47828]: https://github.com/rust-lang/rust/pull/47828
3418 [47398]: https://github.com/rust-lang/rust/pull/47398
3419 [47510]: https://github.com/rust-lang/rust/pull/47510
3420 [47521]: https://github.com/rust-lang/rust/pull/47521
3421 [47204]: https://github.com/rust-lang/rust/pull/47204
3422 [47251]: https://github.com/rust-lang/rust/pull/47251
3423 [47268]: https://github.com/rust-lang/rust/pull/47268
3424 [47282]: https://github.com/rust-lang/rust/pull/47282
3425 [47300]: https://github.com/rust-lang/rust/pull/47300
3426 [47349]: https://github.com/rust-lang/rust/pull/47349
3427 [46931]: https://github.com/rust-lang/rust/pull/46931
3428 [46985]: https://github.com/rust-lang/rust/pull/46985
3429 [47006]: https://github.com/rust-lang/rust/pull/47006
3430 [46830]: https://github.com/rust-lang/rust/pull/46830
3431 [46095]: https://github.com/rust-lang/rust/pull/46095
3432 [46666]: https://github.com/rust-lang/rust/pull/46666
3433 [46196]: https://github.com/rust-lang/rust/pull/46196
3434 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
3435 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
3436 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
3437 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
3438 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
3439
3440
3441 Version 1.24.1 (2018-03-01)
3442 ==========================
3443
3444  - [Do not abort when unwinding through FFI][48251]
3445  - [Emit UTF-16 files for linker arguments on Windows][48318]
3446  - [Make the error index generator work again][48308]
3447  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
3448
3449 [48251]: https://github.com/rust-lang/rust/issues/48251
3450 [48308]: https://github.com/rust-lang/rust/issues/48308
3451 [48318]: https://github.com/rust-lang/rust/issues/48318
3452 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
3453
3454
3455 Version 1.24.0 (2018-02-15)
3456 ==========================
3457
3458 Language
3459 --------
3460 - [External `sysv64` ffi is now available.][46528]
3461   eg. `extern "sysv64" fn foo () {}`
3462
3463 Compiler
3464 --------
3465 - [rustc now uses 16 codegen units by default for release builds.][46910]
3466   For the fastest builds, utilize `codegen-units=1`.
3467 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
3468 - [Add `aarch64-unknown-openbsd` support][46760]
3469
3470 Libraries
3471 ---------
3472 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
3473   improvement in performance in the majority of cases.
3474 - [`OsStr`'s `Debug` implementation is now lossless and consistent
3475   with Windows.][46798]
3476 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
3477 - [impl `From<bool>` for `AtomicBool`][46293]
3478 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
3479 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
3480 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
3481 - [float::from_bits now just uses transmute.][46012] This provides
3482   some optimisations from LLVM.
3483 - [Copied `AsciiExt` methods onto `char`][46077]
3484 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
3485 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
3486 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
3487 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
3488
3489 Stabilized APIs
3490 ---------------
3491 - [`RefCell::replace`]
3492 - [`RefCell::swap`]
3493 - [`atomic::spin_loop_hint`]
3494
3495 The following functions can now be used in a constant expression.
3496 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
3497
3498 - [`AtomicBool::new`][46287]
3499 - [`AtomicUsize::new`][46287]
3500 - [`AtomicIsize::new`][46287]
3501 - [`AtomicPtr::new`][46287]
3502 - [`Cell::new`][46287]
3503 - [`{integer}::min_value`][46287]
3504 - [`{integer}::max_value`][46287]
3505 - [`mem::size_of`][46287]
3506 - [`mem::align_of`][46287]
3507 - [`ptr::null`][46287]
3508 - [`ptr::null_mut`][46287]
3509 - [`RefCell::new`][46287]
3510 - [`UnsafeCell::new`][46287]
3511
3512 Cargo
3513 -----
3514 - [Added a `workspace.default-members` config that
3515   overrides implied `--all` in virtual workspaces.][cargo/4743]
3516 - [Enable incremental by default on development builds.][cargo/4817] Also added
3517   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
3518   per-project or global basis respectively.
3519
3520 Misc
3521 ----
3522
3523 Compatibility Notes
3524 -------------------
3525 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
3526 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
3527   in accordance with IETF RFC 4291 §2.2.
3528 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
3529 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
3530   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
3531 - [Leading zeros in tuple struct members is now an error][47084]
3532 - [`column!()` macro is one-based instead of zero-based][46977]
3533 - [`fmt::Arguments` can no longer be shared across threads][45198]
3534 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
3535 - [Cargo sets a different working directory for the compiler][cargo/4788]
3536
3537 [44884]: https://github.com/rust-lang/rust/pull/44884
3538 [45198]: https://github.com/rust-lang/rust/pull/45198
3539 [45506]: https://github.com/rust-lang/rust/pull/45506
3540 [45904]: https://github.com/rust-lang/rust/pull/45904
3541 [45990]: https://github.com/rust-lang/rust/pull/45990
3542 [46012]: https://github.com/rust-lang/rust/pull/46012
3543 [46077]: https://github.com/rust-lang/rust/pull/46077
3544 [46094]: https://github.com/rust-lang/rust/pull/46094
3545 [46284]: https://github.com/rust-lang/rust/pull/46284
3546 [46287]: https://github.com/rust-lang/rust/pull/46287
3547 [46293]: https://github.com/rust-lang/rust/pull/46293
3548 [46528]: https://github.com/rust-lang/rust/pull/46528
3549 [46671]: https://github.com/rust-lang/rust/pull/46671
3550 [46713]: https://github.com/rust-lang/rust/pull/46713
3551 [46735]: https://github.com/rust-lang/rust/pull/46735
3552 [46749]: https://github.com/rust-lang/rust/pull/46749
3553 [46760]: https://github.com/rust-lang/rust/pull/46760
3554 [46798]: https://github.com/rust-lang/rust/pull/46798
3555 [46828]: https://github.com/rust-lang/rust/pull/46828
3556 [46831]: https://github.com/rust-lang/rust/pull/46831
3557 [46833]: https://github.com/rust-lang/rust/pull/46833
3558 [46910]: https://github.com/rust-lang/rust/pull/46910
3559 [46977]: https://github.com/rust-lang/rust/pull/46977
3560 [47018]: https://github.com/rust-lang/rust/pull/47018
3561 [47080]: https://github.com/rust-lang/rust/pull/47080
3562 [47084]: https://github.com/rust-lang/rust/pull/47084
3563 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
3564 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
3565 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
3566 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
3567 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
3568 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
3569
3570
3571 Version 1.23.0 (2018-01-04)
3572 ==========================
3573
3574 Language
3575 --------
3576 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
3577 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
3578   Which should fix some confusing errors in some operations.
3579
3580 Compiler
3581 --------
3582 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
3583   undefined behavior.][45920]
3584 - [rustc now suggests renaming import if names clash.][45660]
3585 - [Display errors/warnings correctly when there are zero-width or
3586   wide characters.][45711]
3587 - [rustc now avoids unnecessary copies of arguments that are
3588   simple bindings][45380] This should improve memory usage on average by 5-10%.
3589 - [Updated musl used to build musl rustc to 1.1.17][45393]
3590
3591 Libraries
3592 ---------
3593 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
3594 - [Implement Hash for raw pointers to unsized types][45483]
3595 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
3596 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
3597 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
3598 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
3599   and `<*mut T>::as_mut`][44932]
3600 - [Optimized `Thread::{park, unpark}` implementation][45524]
3601 - [Improved `SliceExt::binary_search` performance.][45333]
3602 - [impl `FromIterator<()>` for `()`][45379]
3603 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
3604   is now deprecated.
3605
3606 Stabilized APIs
3607 ---------------
3608
3609 Cargo
3610 -----
3611 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
3612   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
3613 - [Added unit test checking to `cargo check`][cargo/4592]
3614 - [Cargo now lets you install a specific version
3615   using `cargo install --version`][cargo/4637]
3616
3617 Misc
3618 ----
3619 - [Releases now ship with the Cargo book documentation.][45692]
3620 - [rustdoc now prints rendering warnings on every run.][45324]
3621
3622 Compatibility Notes
3623 -------------------
3624 - [Changes have been made to type equality to make it more correct,
3625   in rare cases this could break some code.][45853] [Tracking issue for
3626   further information][45852]
3627 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
3628 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
3629   Android 9, the minimum supported version is Android 14.
3630 - [Bumped the minimum LLVM to 3.9][45326]
3631
3632 [44042]: https://github.com/rust-lang/rust/pull/44042
3633 [44932]: https://github.com/rust-lang/rust/pull/44932
3634 [45267]: https://github.com/rust-lang/rust/pull/45267
3635 [45324]: https://github.com/rust-lang/rust/pull/45324
3636 [45326]: https://github.com/rust-lang/rust/pull/45326
3637 [45333]: https://github.com/rust-lang/rust/pull/45333
3638 [45379]: https://github.com/rust-lang/rust/pull/45379
3639 [45380]: https://github.com/rust-lang/rust/pull/45380
3640 [45393]: https://github.com/rust-lang/rust/pull/45393
3641 [45435]: https://github.com/rust-lang/rust/pull/45435
3642 [45483]: https://github.com/rust-lang/rust/pull/45483
3643 [45524]: https://github.com/rust-lang/rust/pull/45524
3644 [45571]: https://github.com/rust-lang/rust/pull/45571
3645 [45580]: https://github.com/rust-lang/rust/pull/45580
3646 [45610]: https://github.com/rust-lang/rust/pull/45610
3647 [45660]: https://github.com/rust-lang/rust/pull/45660
3648 [45692]: https://github.com/rust-lang/rust/pull/45692
3649 [45711]: https://github.com/rust-lang/rust/pull/45711
3650 [45772]: https://github.com/rust-lang/rust/pull/45772
3651 [45852]: https://github.com/rust-lang/rust/issues/45852
3652 [45853]: https://github.com/rust-lang/rust/pull/45853
3653 [45887]: https://github.com/rust-lang/rust/pull/45887
3654 [45920]: https://github.com/rust-lang/rust/pull/45920
3655 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
3656 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
3657 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
3658
3659
3660 Version 1.22.1 (2017-11-22)
3661 ==========================
3662
3663 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
3664
3665 [46183]: https://github.com/rust-lang/rust/pull/46183
3666
3667 Version 1.22.0 (2017-11-22)
3668 ==========================
3669
3670 Language
3671 --------
3672 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
3673 - [Now accepts underscores in unicode escapes][43716]
3674 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
3675 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
3676
3677 Compiler
3678 --------
3679 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
3680 - [rustc will no longer inline in codegen units when compiling for debug][45075]
3681   This should decrease compile times for debug builds.
3682 - [strict memory alignment now enabled on ARMv6][45094]
3683 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
3684
3685 Libraries
3686 ---------
3687 - [Allow atomic operations up to 32 bits
3688   on `armv5te_unknown_linux_gnueabi`][44978]
3689 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
3690 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
3691 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
3692 - [Properly detect overflow in `Instant += Duration`.][44220]
3693 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
3694 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
3695 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
3696
3697 Stabilized APIs
3698 ---------------
3699
3700 Cargo
3701 -----
3702 - [Cargo will now build multi file examples in subdirectories of the `examples`
3703   folder that have a `main.rs` file.][cargo/4496]
3704 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
3705   the old format will continue to work and can be updated with `cargo update`.
3706 - [Now supports vendoring git repositories][cargo/3992]
3707
3708 Misc
3709 ----
3710 - [`libbacktrace` is now available on Apple platforms.][44251]
3711 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
3712   This now lets you specify that a given code example will fail to compile.
3713
3714 Compatibility Notes
3715 -------------------
3716 - [The minimum Android version that rustc can build for has been bumped
3717   to `4.0` from `2.3`][45656]
3718 - [Allowing `T op= &T` for numeric types has broken some type
3719   inference cases][45480]
3720
3721
3722 [42526]: https://github.com/rust-lang/rust/pull/42526
3723 [43017]: https://github.com/rust-lang/rust/pull/43017
3724 [43716]: https://github.com/rust-lang/rust/pull/43716
3725 [43949]: https://github.com/rust-lang/rust/pull/43949
3726 [44015]: https://github.com/rust-lang/rust/pull/44015
3727 [44220]: https://github.com/rust-lang/rust/pull/44220
3728 [44251]: https://github.com/rust-lang/rust/pull/44251
3729 [44287]: https://github.com/rust-lang/rust/pull/44287
3730 [44303]: https://github.com/rust-lang/rust/pull/44303
3731 [44456]: https://github.com/rust-lang/rust/pull/44456
3732 [44466]: https://github.com/rust-lang/rust/pull/44466
3733 [44895]: https://github.com/rust-lang/rust/pull/44895
3734 [44966]: https://github.com/rust-lang/rust/pull/44966
3735 [44978]: https://github.com/rust-lang/rust/pull/44978
3736 [45041]: https://github.com/rust-lang/rust/pull/45041
3737 [45064]: https://github.com/rust-lang/rust/pull/45064
3738 [45075]: https://github.com/rust-lang/rust/pull/45075
3739 [45094]: https://github.com/rust-lang/rust/pull/45094
3740 [45095]: https://github.com/rust-lang/rust/pull/45095
3741 [45480]: https://github.com/rust-lang/rust/issues/45480
3742 [45656]: https://github.com/rust-lang/rust/pull/45656
3743 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
3744 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
3745 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
3746
3747
3748
3749
3750
3751
3752 Version 1.21.0 (2017-10-12)
3753 ==========================
3754
3755 Language
3756 --------
3757 - [You can now use static references for literals.][43838]
3758   Example:
3759   ```rust
3760   fn main() {
3761       let x: &'static u32 = &0;
3762   }
3763   ```
3764 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
3765   Example:
3766   ```rust
3767   my_macro!(Vec<i32>::new); // Always worked
3768   my_macro!(Vec::<i32>::new); // Now works
3769   ```
3770
3771 Compiler
3772 --------
3773 - [Upgraded jemalloc to 4.5.0][43911]
3774 - [Enabled unwinding panics on Redox][43917]
3775 - [Now runs LLVM in parallel during translation phase.][43506]
3776   This should reduce peak memory usage.
3777
3778 Libraries
3779 ---------
3780 - [Generate builtin impls for `Clone` for all arrays and tuples that
3781   are `T: Clone`][43690]
3782 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
3783 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
3784   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
3785
3786 Stabilized APIs
3787 ---------------
3788
3789 [`std::mem::discriminant`]
3790
3791 Cargo
3792 -----
3793 - [You can now call `cargo install` with multiple package names][cargo/4216]
3794 - [Cargo commands inside a virtual workspace will now implicitly
3795   pass `--all`][cargo/4335]
3796 - [Added a `[patch]` section to `Cargo.toml` to handle
3797   prepublication dependencies][cargo/4123] [RFC 1969]
3798 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
3799   like patterns][cargo/4270]
3800 - [Added the `--all-targets` option][cargo/4400]
3801 - [Using required dependencies as a feature is now deprecated and emits
3802   a warning][cargo/4364]
3803
3804
3805 Misc
3806 ----
3807 - [Cargo docs are moving][43916]
3808   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
3809 - [The rustdoc book is now available][43863]
3810   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
3811 - [Added a preview of RLS has been made available through rustup][44204]
3812   Install with `rustup component add rls-preview`
3813 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
3814   Previously only showed `std::os::unix`.
3815
3816 Compatibility Notes
3817 -------------------
3818 - [Changes in method matching against higher-ranked types][43880] This may cause
3819   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
3820 - [rustc's JSON error output's byte position start at top of file.][42973]
3821   Was previously relative to the rustc's internal `CodeMap` struct which
3822   required the unstable library `libsyntax` to correctly use.
3823 - [`unused_results` lint no longer ignores booleans][43728]
3824
3825 [42565]: https://github.com/rust-lang/rust/pull/42565
3826 [42973]: https://github.com/rust-lang/rust/pull/42973
3827 [43348]: https://github.com/rust-lang/rust/pull/43348
3828 [43459]: https://github.com/rust-lang/rust/pull/43459
3829 [43506]: https://github.com/rust-lang/rust/pull/43506
3830 [43540]: https://github.com/rust-lang/rust/pull/43540
3831 [43690]: https://github.com/rust-lang/rust/pull/43690
3832 [43728]: https://github.com/rust-lang/rust/pull/43728
3833 [43838]: https://github.com/rust-lang/rust/pull/43838
3834 [43863]: https://github.com/rust-lang/rust/pull/43863
3835 [43880]: https://github.com/rust-lang/rust/pull/43880
3836 [43911]: https://github.com/rust-lang/rust/pull/43911
3837 [43916]: https://github.com/rust-lang/rust/pull/43916
3838 [43917]: https://github.com/rust-lang/rust/pull/43917
3839 [44204]: https://github.com/rust-lang/rust/pull/44204
3840 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
3841 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
3842 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3843 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
3844 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
3845 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
3846 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
3847 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
3848 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
3849
3850 Version 1.20.0 (2017-08-31)
3851 ===========================
3852
3853 Language
3854 --------
3855 - [Associated constants are now stabilised.][42809]
3856 - [A lot of macro bugs are now fixed.][42913]
3857
3858 Compiler
3859 --------
3860
3861 - [Struct fields are now properly coerced to the expected field type.][42807]
3862 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
3863   `wasm32-experimental-emscripten` target.
3864 - [Changed some of the error messages to be more helpful.][42033]
3865 - [Add support for RELRO(RELocation Read-Only) for platforms that support
3866   it.][43170]
3867 - [rustc now reports the total number of errors on compilation failure][43015]
3868   previously this was only the number of errors in the pass that failed.
3869 - [Expansion in rustc has been sped up 29x.][42533]
3870 - [added `msp430-none-elf` target.][43099]
3871 - [rustc will now suggest one-argument enum variant to fix type mismatch when
3872   applicable][43178]
3873 - [Fixes backtraces on Redox][43228]
3874 - [rustc now identifies different versions of same crate when absolute paths of
3875   different types match in an error message.][42826]
3876
3877 Libraries
3878 ---------
3879
3880
3881 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
3882 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
3883   tuples.][43011]
3884 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
3885   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
3886 - [Impl `Clone` for `DefaultHasher`.][42799]
3887 - [Impl `Sync` for `SyncSender`.][42397]
3888 - [Impl `FromStr` for `char`][42271]
3889 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
3890   NaN.][42431]
3891 - [allow messages in the `unimplemented!()` macro.][42155]
3892   ie. `unimplemented!("Waiting for 1.21 to be stable")`
3893 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
3894 - [Upgrade to Unicode 10.0.0][42999]
3895 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
3896 - [Skip the main thread's manual stack guard on Linux][43072]
3897 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
3898 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
3899   previously 2^15.
3900 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
3901
3902 Stabilized APIs
3903 ---------------
3904
3905 - [`CStr::into_c_string`]
3906 - [`CString::as_c_str`]
3907 - [`CString::into_boxed_c_str`]
3908 - [`Chain::get_mut`]
3909 - [`Chain::get_ref`]
3910 - [`Chain::into_inner`]
3911 - [`Option::get_or_insert_with`]
3912 - [`Option::get_or_insert`]
3913 - [`OsStr::into_os_string`]
3914 - [`OsString::into_boxed_os_str`]
3915 - [`Take::get_mut`]
3916 - [`Take::get_ref`]
3917 - [`Utf8Error::error_len`]
3918 - [`char::EscapeDebug`]
3919 - [`char::escape_debug`]
3920 - [`compile_error!`]
3921 - [`f32::from_bits`]
3922 - [`f32::to_bits`]
3923 - [`f64::from_bits`]
3924 - [`f64::to_bits`]
3925 - [`mem::ManuallyDrop`]
3926 - [`slice::sort_unstable_by_key`]
3927 - [`slice::sort_unstable_by`]
3928 - [`slice::sort_unstable`]
3929 - [`str::from_boxed_utf8_unchecked`]
3930 - [`str::as_bytes_mut`]
3931 - [`str::as_bytes_mut`]
3932 - [`str::from_utf8_mut`]
3933 - [`str::from_utf8_unchecked_mut`]
3934 - [`str::get_mut`]
3935 - [`str::get_unchecked_mut`]
3936 - [`str::get_unchecked`]
3937 - [`str::get`]
3938 - [`str::into_boxed_bytes`]
3939
3940
3941 Cargo
3942 -----
3943 - [Cargo API token location moved from `~/.cargo/config` to
3944   `~/.cargo/credentials`.][cargo/3978]
3945 - [Cargo will now build `main.rs` binaries that are in sub-directories of
3946   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
3947   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
3948 - [You can now specify version of a binary when installed through
3949   `cargo install` using `--vers`.][cargo/4229]
3950 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
3951   failure.][cargo/4248]
3952 - [Changed the convention around which file is the crate root.][cargo/4259]
3953 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
3954   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
3955
3956 Compatibility Notes
3957 -------------------
3958
3959 - [Functions with `'static` in their return types will now not be as usable as
3960   if they were using lifetime parameters instead.][42417]
3961 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
3962   takes the sign of NaN into account where previously didn't.][42430]
3963
3964 [42033]: https://github.com/rust-lang/rust/pull/42033
3965 [42155]: https://github.com/rust-lang/rust/pull/42155
3966 [42271]: https://github.com/rust-lang/rust/pull/42271
3967 [42397]: https://github.com/rust-lang/rust/pull/42397
3968 [42417]: https://github.com/rust-lang/rust/pull/42417
3969 [42430]: https://github.com/rust-lang/rust/pull/42430
3970 [42431]: https://github.com/rust-lang/rust/pull/42431
3971 [42533]: https://github.com/rust-lang/rust/pull/42533
3972 [42571]: https://github.com/rust-lang/rust/pull/42571
3973 [42613]: https://github.com/rust-lang/rust/pull/42613
3974 [42799]: https://github.com/rust-lang/rust/pull/42799
3975 [42807]: https://github.com/rust-lang/rust/pull/42807
3976 [42809]: https://github.com/rust-lang/rust/pull/42809
3977 [42822]: https://github.com/rust-lang/rust/pull/42822
3978 [42826]: https://github.com/rust-lang/rust/pull/42826
3979 [42854]: https://github.com/rust-lang/rust/pull/42854
3980 [42913]: https://github.com/rust-lang/rust/pull/42913
3981 [42999]: https://github.com/rust-lang/rust/pull/42999
3982 [43011]: https://github.com/rust-lang/rust/pull/43011
3983 [43015]: https://github.com/rust-lang/rust/pull/43015
3984 [43072]: https://github.com/rust-lang/rust/pull/43072
3985 [43077]: https://github.com/rust-lang/rust/pull/43077
3986 [43097]: https://github.com/rust-lang/rust/pull/43097
3987 [43099]: https://github.com/rust-lang/rust/pull/43099
3988 [43170]: https://github.com/rust-lang/rust/pull/43170
3989 [43178]: https://github.com/rust-lang/rust/pull/43178
3990 [43185]: https://github.com/rust-lang/rust/pull/43185
3991 [43228]: https://github.com/rust-lang/rust/pull/43228
3992 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
3993 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
3994 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
3995 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
3996 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
3997 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3998 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
3999 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
4000 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
4001 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
4002 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
4003 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
4004 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
4005 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
4006 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
4007 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
4008 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
4009 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
4010 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
4011 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
4012 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
4013 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
4014 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
4015 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
4016 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
4017 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
4018 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
4019 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
4020 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
4021 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
4022 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
4023 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
4024 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
4025 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
4026 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
4027 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
4028 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
4029 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
4030 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
4031
4032
4033 Version 1.19.0 (2017-07-20)
4034 ===========================
4035
4036 Language
4037 --------
4038
4039 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
4040   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
4041 - [Macro recursion limit increased to 1024 from 64.][41676]
4042 - [Added lint for detecting unused macros.][41907]
4043 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
4044   For example: `let x = loop { break 7; };`
4045 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
4046   contain `Copy` types and cannot have a `Drop` implementation.
4047   Example: `union Foo { bar: u8, baz: usize }`
4048 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
4049   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
4050
4051 Compiler
4052 --------
4053
4054 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
4055 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
4056   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
4057   you should use `--target armv7-linux-androideabi`.
4058 - [Fixed ICE when removing a source file between compilation sessions.][41873]
4059 - [Minor optimisation of string operations.][42037]
4060 - [Compiler error message is now `aborting due to previous error(s)` instead of
4061   `aborting due to N previous errors`][42150] This was previously inaccurate and
4062   would only count certain kinds of errors.
4063 - [The compiler now supports Visual Studio 2017][42225]
4064 - [The compiler is now built against LLVM 4.0.1 by default][42948]
4065 - [Added a lot][42264] of [new error codes][42302]
4066 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
4067   libraries with C Run-time Libraries(CRT) to be statically linked.
4068 - [Fixed various ARM codegen bugs][42740]
4069
4070 Libraries
4071 ---------
4072
4073 - [`String` now implements `FromIterator<Cow<'a, str>>` and
4074   `Extend<Cow<'a, str>>`][41449]
4075 - [`Vec` now implements `From<&mut [T]>`][41530]
4076 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
4077 - [`SplitWhitespace` now implements `Clone`][41659]
4078 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
4079   1.5x faster][41764]
4080 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
4081   macros, but for printing to stderr.
4082
4083 Stabilized APIs
4084 ---------------
4085
4086 - [`OsString::shrink_to_fit`]
4087 - [`cmp::Reverse`]
4088 - [`Command::envs`]
4089 - [`thread::ThreadId`]
4090
4091 Cargo
4092 -----
4093
4094 - [Build scripts can now add environment variables to the environment
4095   the crate is being compiled in.
4096   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
4097 - [Subcommands now replace the current process rather than spawning a new
4098   child process][cargo/3970]
4099 - [Workspace members can now accept glob file patterns][cargo/3979]
4100 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
4101   the members in a given workspace.][cargo/3988]
4102 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
4103 - [Target directory path is now in the cargo metadata][cargo/4022]
4104 - [Cargo no longer checks out a local working directory for the
4105   crates.io index][cargo/4026] This should provide smaller file size for the
4106   registry, and improve cloning times, especially on Windows machines.
4107 - [Added an `--exclude` option for excluding certain packages when using the
4108   `--all` option][cargo/4031]
4109 - [Cargo will now automatically retry when receiving a 5xx error
4110   from crates.io][cargo/4032]
4111 - [The `--features` option now accepts multiple comma or space
4112   delimited values.][cargo/4084]
4113 - [Added support for custom target specific runners][cargo/3954]
4114
4115 Misc
4116 ----
4117
4118 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
4119   Windows Debugger.
4120 - [Rust will now release XZ compressed packages][rust-installer/57]
4121 - [rustup will now prefer to download rust packages with
4122   XZ compression][rustup/1100] over GZip packages.
4123 - [Added the ability to escape `#` in rust documentation][41785] By adding
4124   additional `#`'s ie. `##` is now `#`
4125
4126 Compatibility Notes
4127 -------------------
4128
4129 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
4130 - [`-Z` flags are now no longer allowed to be used on the stable
4131   compiler.][41751] This has been a warning for a year previous to this.
4132 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
4133   longer works][42844]. Users should migrate to the built-in `check`
4134   command, which has been available since 1.16.
4135 - [Ending a float literal with `._` is now a hard error.
4136   Example: `42._` .][41946]
4137 - [Any use of a private `extern crate` outside of its module is now a
4138   hard error.][36886] This was previously a warning.
4139 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
4140   relative while the `::` prefix makes a path absolute, but was ignored and the
4141   path was relative regardless.
4142 - [Floating point constants in match patterns is now a hard error][36890]
4143   This was previously a warning.
4144 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
4145   match patterns is now a hard error][36891] This was previously a warning.
4146 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
4147   a warning.
4148 - [From the pound escape, lines consisting of multiple `#`s are
4149   now visible][41785]
4150 - [It is an error to re-export private enum variants][42460]. This is
4151   known to break a number of crates that depend on an older version of
4152   mustache.
4153 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
4154   to use it to find the linker, and the build will fail where it did
4155   not previously][42607]
4156
4157 [36886]: https://github.com/rust-lang/rust/issues/36886
4158 [36888]: https://github.com/rust-lang/rust/issues/36888
4159 [36890]: https://github.com/rust-lang/rust/issues/36890
4160 [36891]: https://github.com/rust-lang/rust/issues/36891
4161 [36892]: https://github.com/rust-lang/rust/issues/36892
4162 [37406]: https://github.com/rust-lang/rust/issues/37406
4163 [39983]: https://github.com/rust-lang/rust/pull/39983
4164 [41145]: https://github.com/rust-lang/rust/pull/41145
4165 [41192]: https://github.com/rust-lang/rust/pull/41192
4166 [41258]: https://github.com/rust-lang/rust/pull/41258
4167 [41370]: https://github.com/rust-lang/rust/pull/41370
4168 [41449]: https://github.com/rust-lang/rust/pull/41449
4169 [41530]: https://github.com/rust-lang/rust/pull/41530
4170 [41624]: https://github.com/rust-lang/rust/pull/41624
4171 [41656]: https://github.com/rust-lang/rust/pull/41656
4172 [41659]: https://github.com/rust-lang/rust/pull/41659
4173 [41676]: https://github.com/rust-lang/rust/pull/41676
4174 [41751]: https://github.com/rust-lang/rust/pull/41751
4175 [41764]: https://github.com/rust-lang/rust/pull/41764
4176 [41785]: https://github.com/rust-lang/rust/pull/41785
4177 [41873]: https://github.com/rust-lang/rust/pull/41873
4178 [41907]: https://github.com/rust-lang/rust/pull/41907
4179 [41946]: https://github.com/rust-lang/rust/pull/41946
4180 [42016]: https://github.com/rust-lang/rust/pull/42016
4181 [42037]: https://github.com/rust-lang/rust/pull/42037
4182 [42068]: https://github.com/rust-lang/rust/pull/42068
4183 [42150]: https://github.com/rust-lang/rust/pull/42150
4184 [42162]: https://github.com/rust-lang/rust/pull/42162
4185 [42225]: https://github.com/rust-lang/rust/pull/42225
4186 [42264]: https://github.com/rust-lang/rust/pull/42264
4187 [42302]: https://github.com/rust-lang/rust/pull/42302
4188 [42460]: https://github.com/rust-lang/rust/issues/42460
4189 [42607]: https://github.com/rust-lang/rust/issues/42607
4190 [42740]: https://github.com/rust-lang/rust/pull/42740
4191 [42844]: https://github.com/rust-lang/rust/issues/42844
4192 [42948]: https://github.com/rust-lang/rust/pull/42948
4193 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
4194 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
4195 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
4196 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
4197 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
4198 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
4199 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
4200 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
4201 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
4202 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
4203 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
4204 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
4205 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
4206 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
4207 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
4208 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
4209 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
4210 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
4211 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
4212 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
4213 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
4214 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
4215
4216
4217 Version 1.18.0 (2017-06-08)
4218 ===========================
4219
4220 Language
4221 --------
4222
4223 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
4224   make the item visible to just that module tree. Also accepts the keyword
4225   `crate` to make something public to the whole crate but not users of the
4226   library. Example: `pub(crate) mod utils;`. [RFC 1422].
4227 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
4228   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
4229 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
4230   types like `Write + Send`, trailing `+` are now supported in trait objects,
4231   and better error reporting for trait objects starting with `?Sized`.
4232 - [0e+10 is now a valid floating point literal][40589]
4233 - [Now warns if you bind a lifetime parameter to 'static][40734]
4234 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
4235   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
4236   representation in some cases.][40377]
4237
4238 Compiler
4239 --------
4240
4241 - [rustc can now emit mir with `--emit mir`][39891]
4242 - [Improved LLVM IR for trivial functions][40367]
4243 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
4244 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
4245   opportunities found through profiling
4246 - [Improved backtrace formatting when panicking][38165]
4247
4248 Libraries
4249 ---------
4250
4251 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
4252   iterator hasn't been advanced the original `Vec` is reassembled with no actual
4253   iteration or reallocation.
4254 - [Simplified HashMap Bucket interface][40561] provides performance
4255   improvements for iterating and cloning.
4256 - [Specialize Vec::from_elem to use calloc][40409]
4257 - [Fixed Race condition in fs::create_dir_all][39799]
4258 - [No longer caching stdio on Windows][40516]
4259 - [Optimized insertion sort in slice][40807] insertion sort in some cases
4260   2.50%~ faster and in one case now 12.50% faster.
4261 - [Optimized `AtomicBool::fetch_nand`][41143]
4262
4263 Stabilized APIs
4264 ---------------
4265
4266 - [`Child::try_wait`]
4267 - [`HashMap::retain`]
4268 - [`HashSet::retain`]
4269 - [`PeekMut::pop`]
4270 - [`TcpStream::peek`]
4271 - [`UdpSocket::peek`]
4272 - [`UdpSocket::peek_from`]
4273
4274 Cargo
4275 -----
4276
4277 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
4278   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
4279 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
4280 - [Added Android build support][cargo/3885]
4281 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
4282   of a certain type, for example `cargo build --bins` will build all
4283   binaries.
4284 - [Added support for haiku][cargo/3952]
4285
4286 Misc
4287 ----
4288
4289 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
4290 - [Added rust-windbg script for better debugging on Windows][39983]
4291 - [Rust now uses the official cross compiler for NetBSD][40612]
4292 - [rustdoc now accepts `#` at the start of files][40828]
4293 - [Fixed jemalloc support for musl][41168]
4294
4295 Compatibility Notes
4296 -------------------
4297
4298 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
4299   always placed after the sign if it exists and before the digits. With the `#`
4300   flag the zeroes are placed after the prefix and before the digits.
4301 - [Due to the struct field optimisation][40377], using `transmute` on structs
4302   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
4303   always been undefined behavior, but is now more likely to break in practice.
4304 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
4305   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
4306   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
4307 - [Overlapping inherent `impl`s are now a hard error][40728]
4308 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
4309 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
4310   `out.asm` and `out.ll` instead of only one of the filetypes.
4311 - [ calling a function that returns `Self` will no longer work][41805] when
4312   the size of `Self` cannot be statically determined.
4313 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
4314   this has caused a few regressions namely:
4315
4316   - Changed the link order of local static/dynamic libraries (respecting the
4317     order on given rather than having the compiler reorder).
4318   - Changed how MinGW is linked, native code linked to dynamic libraries
4319     may require manually linking to the gcc support library (for the native
4320     code itself)
4321
4322 [38165]: https://github.com/rust-lang/rust/pull/38165
4323 [39799]: https://github.com/rust-lang/rust/pull/39799
4324 [39891]: https://github.com/rust-lang/rust/pull/39891
4325 [39983]: https://github.com/rust-lang/rust/pull/39983
4326 [40043]: https://github.com/rust-lang/rust/pull/40043
4327 [40241]: https://github.com/rust-lang/rust/pull/40241
4328 [40338]: https://github.com/rust-lang/rust/pull/40338
4329 [40367]: https://github.com/rust-lang/rust/pull/40367
4330 [40377]: https://github.com/rust-lang/rust/pull/40377
4331 [40409]: https://github.com/rust-lang/rust/pull/40409
4332 [40516]: https://github.com/rust-lang/rust/pull/40516
4333 [40556]: https://github.com/rust-lang/rust/pull/40556
4334 [40561]: https://github.com/rust-lang/rust/pull/40561
4335 [40589]: https://github.com/rust-lang/rust/pull/40589
4336 [40612]: https://github.com/rust-lang/rust/pull/40612
4337 [40723]: https://github.com/rust-lang/rust/pull/40723
4338 [40728]: https://github.com/rust-lang/rust/pull/40728
4339 [40731]: https://github.com/rust-lang/rust/pull/40731
4340 [40734]: https://github.com/rust-lang/rust/pull/40734
4341 [40805]: https://github.com/rust-lang/rust/pull/40805
4342 [40807]: https://github.com/rust-lang/rust/pull/40807
4343 [40828]: https://github.com/rust-lang/rust/pull/40828
4344 [40870]: https://github.com/rust-lang/rust/pull/40870
4345 [41085]: https://github.com/rust-lang/rust/pull/41085
4346 [41143]: https://github.com/rust-lang/rust/pull/41143
4347 [41168]: https://github.com/rust-lang/rust/pull/41168
4348 [41270]: https://github.com/rust-lang/rust/issues/41270
4349 [41469]: https://github.com/rust-lang/rust/pull/41469
4350 [41805]: https://github.com/rust-lang/rust/issues/41805
4351 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
4352 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
4353 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
4354 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
4355 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
4356 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
4357 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
4358 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
4359 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
4360 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
4361 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
4362 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
4363 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
4364 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
4365
4366
4367 Version 1.17.0 (2017-04-27)
4368 ===========================
4369
4370 Language
4371 --------
4372
4373 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
4374 * [Fields of structs may be initialized without duplicating the field/variable
4375   names][39761]. [RFC 1682]
4376 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
4377 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4378   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
4379   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
4380   `'b`. Soundness fix.
4381 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
4382 * [Static variables may contain references to other statics][40027]
4383
4384 Compiler
4385 --------
4386
4387 * [Exit quickly on only `--emit dep-info`][40336]
4388 * [Make `-C relocation-model` more correctly determine whether the linker
4389   creates a position-independent executable][40245]
4390 * [Add `-C overflow-checks` to directly control whether integer overflow
4391   panics][40037]
4392 * [The rustc type checker now checks items on demand instead of in a single
4393   in-order pass][40008]. This is mostly an internal refactoring in support of
4394   future work, including incremental type checking, but also resolves [RFC
4395   1647], allowing `Self` to appear in `impl` `where` clauses.
4396 * [Optimize vtable loads][39995]
4397 * [Turn off vectorization for Emscripten targets][39990]
4398 * [Provide suggestions for unknown macros imported with `use`][39953]
4399 * [Fix ICEs in path resolution][39939]
4400 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
4401 * [Add clearer error message using `&str + &str`][39116]
4402
4403 Stabilized APIs
4404 ---------------
4405
4406 * [`Arc::into_raw`]
4407 * [`Arc::from_raw`]
4408 * [`Arc::ptr_eq`]
4409 * [`Rc::into_raw`]
4410 * [`Rc::from_raw`]
4411 * [`Rc::ptr_eq`]
4412 * [`Ordering::then`]
4413 * [`Ordering::then_with`]
4414 * [`BTreeMap::range`]
4415 * [`BTreeMap::range_mut`]
4416 * [`collections::Bound`]
4417 * [`process::abort`]
4418 * [`ptr::read_unaligned`]
4419 * [`ptr::write_unaligned`]
4420 * [`Result::expect_err`]
4421 * [`Cell::swap`]
4422 * [`Cell::replace`]
4423 * [`Cell::into_inner`]
4424 * [`Cell::take`]
4425
4426 Libraries
4427 ---------
4428
4429 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
4430 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
4431 * [`String` implements `FromIterator<&char>`][40028]
4432 * `Box` [implements][40009] a number of new conversions:
4433   `From<Box<str>> for String`,
4434   `From<Box<[T]>> for Vec<T>`,
4435   `From<Box<CStr>> for CString`,
4436   `From<Box<OsStr>> for OsString`,
4437   `From<Box<Path>> for PathBuf`,
4438   `Into<Box<str>> for String`,
4439   `Into<Box<[T]>> for Vec<T>`,
4440   `Into<Box<CStr>> for CString`,
4441   `Into<Box<OsStr>> for OsString`,
4442   `Into<Box<Path>> for PathBuf`,
4443   `Default for Box<str>`,
4444   `Default for Box<CStr>`,
4445   `Default for Box<OsStr>`,
4446   `From<&CStr> for Box<CStr>`,
4447   `From<&OsStr> for Box<OsStr>`,
4448   `From<&Path> for Box<Path>`
4449 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
4450 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
4451 * [Slightly optimize `slice::sort`][39538]
4452 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
4453 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
4454   `Box<str>` implements `From<&str>`][39438]
4455 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
4456   `From<(I, u16)> where I: Into<IpAddr>`][39372]
4457 * [`format!` estimates the needed capacity before writing a string][39356]
4458 * [Support unprivileged symlink creation in Windows][38921]
4459 * [`PathBuf` implements `Default`][38764]
4460 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
4461 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
4462   and poor hash functions.
4463
4464 Cargo
4465 -----
4466
4467 * [Add `cargo check --all`][cargo/3731]
4468 * [Add an option to ignore SSL revocation checking][cargo/3699]
4469 * [Add `cargo run --package`][cargo/3691]
4470 * [Add `required_features`][cargo/3667]
4471 * [Assume `build.rs` is a build script][cargo/3664]
4472 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
4473
4474 Misc
4475 ----
4476
4477 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
4478   `rustbook`][39633]
4479 * [The "Unstable Book" documents nightly-only features][ubook]
4480 * [Improve the style of the sidebar in rustdoc output][40265]
4481 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
4482 * [Fix MSP430 breakage due to `i128`][40257]
4483 * [Preliminary Solaris/SPARCv9 support][39903]
4484 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
4485   run without installing the MSVC runtime.
4486 * [`rustdoc --test` includes file names in test names][39788]
4487 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
4488   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
4489 * [Initial support for `aarch64-unknown-freebsd`][39491]
4490 * [Initial support for `i686-unknown-netbsd`][39426]
4491 * [This release no longer includes the old makefile build system][39431]. Rust
4492   is built with a custom build system, written in Rust, and with Cargo.
4493 * [Add Debug implementations for libcollection structs][39002]
4494 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
4495 * [`--test-threads=0` produces an error][38945]
4496 * [`rustup` installs documentation by default][40526]
4497 * [The Rust source includes NatVis visualizations][39843]. These can be used by
4498   WinDbg and Visual Studio to improve the debugging experience.
4499
4500 Compatibility Notes
4501 -------------------
4502
4503 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
4504   workaround, either use MSVC 2015 or run vcvars.bat.
4505 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4506   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
4507   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
4508   fix.
4509 * [`format!` and `Display::to_string` panic if an underlying formatting
4510   implementation returns an error][40117]. Previously the error was silently
4511   ignored. It is incorrect for `write_fmt` to return an error when writing
4512   to a string.
4513 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
4514   crates were marked stable and could be accessed from the stable toolchain.
4515 * [Rust git source no longer includes vendored crates][39728]. Those that need
4516   to build with vendored crates should build from release tarballs.
4517 * [Fix inert attributes from `proc_macro_derives`][39572]
4518 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
4519   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
4520   build system.
4521 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
4522   existing code generally ignores the type of dead-code unless a type-hint is
4523   provided; this can cause surprising inference interactions particularly around
4524   defaulting. The new code uniformly ignores the result type of dead-code.
4525 * [Tuple-struct constructors with private fields are no longer visible][38932]
4526 * [Lifetime parameters that do not appear in the arguments are now considered
4527   early-bound][38897], resolving a soundness bug (#[32330]). The
4528   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
4529   April of 2016.
4530 * [rustdoc: fix doctests with non-feature crate attributes][38161]
4531 * [Make transmuting from fn item types to pointer-sized types a hard
4532   error][34198]
4533
4534 [27787]: https://github.com/rust-lang/rust/issues/27787
4535 [32330]: https://github.com/rust-lang/rust/issues/32330
4536 [34198]: https://github.com/rust-lang/rust/pull/34198
4537 [38161]: https://github.com/rust-lang/rust/pull/38161
4538 [38368]: https://github.com/rust-lang/rust/pull/38368
4539 [38584]: https://github.com/rust-lang/rust/issues/38584
4540 [38661]: https://github.com/rust-lang/rust/pull/38661
4541 [38764]: https://github.com/rust-lang/rust/pull/38764
4542 [38864]: https://github.com/rust-lang/rust/issues/38864
4543 [38897]: https://github.com/rust-lang/rust/pull/38897
4544 [38921]: https://github.com/rust-lang/rust/pull/38921
4545 [38932]: https://github.com/rust-lang/rust/pull/38932
4546 [38945]: https://github.com/rust-lang/rust/pull/38945
4547 [38981]: https://github.com/rust-lang/rust/pull/38981
4548 [39002]: https://github.com/rust-lang/rust/pull/39002
4549 [39116]: https://github.com/rust-lang/rust/pull/39116
4550 [39193]: https://github.com/rust-lang/rust/pull/39193
4551 [39265]: https://github.com/rust-lang/rust/pull/39265
4552 [39356]: https://github.com/rust-lang/rust/pull/39356
4553 [39372]: https://github.com/rust-lang/rust/pull/39372
4554 [39426]: https://github.com/rust-lang/rust/pull/39426
4555 [39431]: https://github.com/rust-lang/rust/pull/39431
4556 [39438]: https://github.com/rust-lang/rust/pull/39438
4557 [39440]: https://github.com/rust-lang/rust/pull/39440
4558 [39485]: https://github.com/rust-lang/rust/pull/39485
4559 [39491]: https://github.com/rust-lang/rust/pull/39491
4560 [39518]: https://github.com/rust-lang/rust/pull/39518
4561 [39538]: https://github.com/rust-lang/rust/pull/39538
4562 [39572]: https://github.com/rust-lang/rust/pull/39572
4563 [39633]: https://github.com/rust-lang/rust/pull/39633
4564 [39642]: https://github.com/rust-lang/rust/pull/39642
4565 [39728]: https://github.com/rust-lang/rust/pull/39728
4566 [39761]: https://github.com/rust-lang/rust/pull/39761
4567 [39788]: https://github.com/rust-lang/rust/pull/39788
4568 [39793]: https://github.com/rust-lang/rust/pull/39793
4569 [39837]: https://github.com/rust-lang/rust/pull/39837
4570 [39843]: https://github.com/rust-lang/rust/pull/39843
4571 [39851]: https://github.com/rust-lang/rust/pull/39851
4572 [39903]: https://github.com/rust-lang/rust/pull/39903
4573 [39939]: https://github.com/rust-lang/rust/pull/39939
4574 [39953]: https://github.com/rust-lang/rust/pull/39953
4575 [39960]: https://github.com/rust-lang/rust/pull/39960
4576 [39990]: https://github.com/rust-lang/rust/pull/39990
4577 [39995]: https://github.com/rust-lang/rust/pull/39995
4578 [40008]: https://github.com/rust-lang/rust/pull/40008
4579 [40009]: https://github.com/rust-lang/rust/pull/40009
4580 [40027]: https://github.com/rust-lang/rust/pull/40027
4581 [40028]: https://github.com/rust-lang/rust/pull/40028
4582 [40037]: https://github.com/rust-lang/rust/pull/40037
4583 [40117]: https://github.com/rust-lang/rust/pull/40117
4584 [40166]: https://github.com/rust-lang/rust/pull/40166
4585 [40245]: https://github.com/rust-lang/rust/pull/40245
4586 [40257]: https://github.com/rust-lang/rust/pull/40257
4587 [40261]: https://github.com/rust-lang/rust/pull/40261
4588 [40265]: https://github.com/rust-lang/rust/pull/40265
4589 [40319]: https://github.com/rust-lang/rust/pull/40319
4590 [40336]: https://github.com/rust-lang/rust/pull/40336
4591 [40526]: https://github.com/rust-lang/rust/pull/40526
4592 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4593 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
4594 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
4595 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
4596 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
4597 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
4598 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
4599 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
4600 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
4601 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
4602 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
4603 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
4604 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
4605 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
4606 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
4607 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
4608 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
4609 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
4610 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
4611 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
4612 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
4613 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
4614 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
4615 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
4616 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
4617 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
4618 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
4619 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
4620 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
4621 [mdbook]: https://crates.io/crates/mdbook
4622 [ubook]: https://doc.rust-lang.org/unstable-book/
4623
4624
4625 Version 1.16.0 (2017-03-16)
4626 ===========================
4627
4628 Language
4629 --------
4630
4631 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4632 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4633   match patterns][38069]
4634 * [Clean up semantics of `self` in an import list][38313]
4635 * [`Self` may appear in `impl` headers][38920]
4636 * [`Self` may appear in struct expressions][39282]
4637
4638 Compiler
4639 --------
4640
4641 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
4642   a `.rmeta` file containing only crate metadata][38571]. This can be
4643   used by tools like the Rust Language Service to perform
4644   metadata-only builds.
4645 * [Levenshtein based typo suggestions now work in most places, while
4646   previously they worked only for fields and sometimes for local
4647   variables][38927]. Together with the overhaul of "no
4648   resolution"/"unexpected resolution" errors (#[38154]) they result in
4649   large and systematic improvement in resolution diagnostics.
4650 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
4651   `U`][38670]
4652 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
4653 * [`rustc` no longer attempts to provide "consider using an explicit
4654   lifetime" suggestions][37057]. They were inaccurate.
4655
4656 Stabilized APIs
4657 ---------------
4658
4659 * [`VecDeque::truncate`]
4660 * [`VecDeque::resize`]
4661 * [`String::insert_str`]
4662 * [`Duration::checked_add`]
4663 * [`Duration::checked_sub`]
4664 * [`Duration::checked_div`]
4665 * [`Duration::checked_mul`]
4666 * [`str::replacen`]
4667 * [`str::repeat`]
4668 * [`SocketAddr::is_ipv4`]
4669 * [`SocketAddr::is_ipv6`]
4670 * [`IpAddr::is_ipv4`]
4671 * [`IpAddr::is_ipv6`]
4672 * [`Vec::dedup_by`]
4673 * [`Vec::dedup_by_key`]
4674 * [`Result::unwrap_or_default`]
4675 * [`<*const T>::wrapping_offset`]
4676 * [`<*mut T>::wrapping_offset`]
4677 * `CommandExt::creation_flags`
4678 * [`File::set_permissions`]
4679 * [`String::split_off`]
4680
4681 Libraries
4682 ---------
4683
4684 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
4685   their argument by `Borrow` parameter][37761]
4686 * [All public types in std implement `Debug`][38006]
4687 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
4688 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
4689 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4690   Windows][38274]
4691 * [std: Fix partial writes in `LineWriter`][38062]
4692 * [std: Clamp max read/write sizes on Unix][38062]
4693 * [Use more specific panic message for `&str` slicing errors][38066]
4694 * [`TcpListener::set_only_v6` is deprecated][38304]. This
4695   functionality cannot be achieved in std currently.
4696 * [`writeln!`, like `println!`, now accepts a form with no string
4697   or formatting arguments, to just print a newline][38469]
4698 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
4699 * [Reduce the size of static data in `std_unicode::tables`][38781]
4700 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
4701   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
4702   `Display`][38909]
4703 * [`Duration` implements `Sum`][38712]
4704 * [`String` implements `ToSocketAddrs`][39048]
4705
4706 Cargo
4707 -----
4708
4709 * [The `cargo check` command does a type check of a project without
4710   building it][cargo/3296]
4711 * [crates.io will display CI badges from Travis and AppVeyor, if
4712   specified in Cargo.toml][cargo/3546]
4713 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
4714 * [Compilation profiles accept integer values for `debug`, in addition
4715   to `true` and `false`. These are passed to `rustc` as the value to
4716   `-C debuginfo`][cargo/3534]
4717 * [Implement `cargo --version --verbose`][cargo/3604]
4718 * [All builds now output 'dep-info' build dependencies compatible with
4719   make and ninja][cargo/3557]
4720 * [Build all workspace members with `build --all`][cargo/3511]
4721 * [Document all workspace members with `doc --all`][cargo/3515]
4722 * [Path deps outside workspace are not members][cargo/3443]
4723
4724 Misc
4725 ----
4726
4727 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
4728   the path to the Rust implementation][38589]
4729 * [The `armv7-linux-androideabi` target no longer enables NEON
4730   extensions, per Google's ABI guide][38413]
4731 * [The stock standard library can be compiled for Redox OS][38401]
4732 * [Rust has initial SPARC support][38726]. Tier 3. No builds
4733   available.
4734 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
4735   builds available.
4736 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
4737
4738 Compatibility Notes
4739 -------------------
4740
4741 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4742   match patterns][38069]
4743 * In this release, references to uninhabited types can not be
4744   pattern-matched. This was accidentally allowed in 1.15.
4745 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4746 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4747   Windows][38274]
4748 * [Clean up semantics of `self` in an import list][38313]
4749 * Reimplemented lifetime elision. This change was almost entirely compatible
4750   with existing code, but it did close a number of small bugs and loopholes,
4751   as well as being more accepting in some other [cases][41105].
4752
4753 [37057]: https://github.com/rust-lang/rust/pull/37057
4754 [37761]: https://github.com/rust-lang/rust/pull/37761
4755 [38006]: https://github.com/rust-lang/rust/pull/38006
4756 [38051]: https://github.com/rust-lang/rust/pull/38051
4757 [38062]: https://github.com/rust-lang/rust/pull/38062
4758 [38062]: https://github.com/rust-lang/rust/pull/38622
4759 [38066]: https://github.com/rust-lang/rust/pull/38066
4760 [38069]: https://github.com/rust-lang/rust/pull/38069
4761 [38131]: https://github.com/rust-lang/rust/pull/38131
4762 [38154]: https://github.com/rust-lang/rust/pull/38154
4763 [38274]: https://github.com/rust-lang/rust/pull/38274
4764 [38304]: https://github.com/rust-lang/rust/pull/38304
4765 [38313]: https://github.com/rust-lang/rust/pull/38313
4766 [38314]: https://github.com/rust-lang/rust/pull/38314
4767 [38327]: https://github.com/rust-lang/rust/pull/38327
4768 [38401]: https://github.com/rust-lang/rust/pull/38401
4769 [38413]: https://github.com/rust-lang/rust/pull/38413
4770 [38469]: https://github.com/rust-lang/rust/pull/38469
4771 [38559]: https://github.com/rust-lang/rust/pull/38559
4772 [38571]: https://github.com/rust-lang/rust/pull/38571
4773 [38580]: https://github.com/rust-lang/rust/pull/38580
4774 [38589]: https://github.com/rust-lang/rust/pull/38589
4775 [38670]: https://github.com/rust-lang/rust/pull/38670
4776 [38712]: https://github.com/rust-lang/rust/pull/38712
4777 [38726]: https://github.com/rust-lang/rust/pull/38726
4778 [38781]: https://github.com/rust-lang/rust/pull/38781
4779 [38798]: https://github.com/rust-lang/rust/pull/38798
4780 [38909]: https://github.com/rust-lang/rust/pull/38909
4781 [38920]: https://github.com/rust-lang/rust/pull/38920
4782 [38927]: https://github.com/rust-lang/rust/pull/38927
4783 [39048]: https://github.com/rust-lang/rust/pull/39048
4784 [39282]: https://github.com/rust-lang/rust/pull/39282
4785 [39379]: https://github.com/rust-lang/rust/pull/39379
4786 [41105]: https://github.com/rust-lang/rust/issues/41105
4787 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4788 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4789 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
4790 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
4791 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
4792 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
4793 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
4794 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
4795 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
4796 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
4797 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
4798 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
4799 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
4800 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
4801 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
4802 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
4803 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
4804 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
4805 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
4806 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
4807 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
4808 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
4809 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
4810 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
4811 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
4812 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
4813 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
4814 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
4815 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
4816 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4817
4818
4819 Version 1.15.1 (2017-02-09)
4820 ===========================
4821
4822 * [Fix IntoIter::as_mut_slice's signature][39466]
4823 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
4824
4825 [39466]: https://github.com/rust-lang/rust/pull/39466
4826 [39523]: https://github.com/rust-lang/rust/pull/39523
4827
4828
4829 Version 1.15.0 (2017-02-02)
4830 ===========================
4831
4832 Language
4833 --------
4834
4835 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
4836   stable. This allows popular code-generating crates like Serde and Diesel to
4837   work ergonomically. [RFC 1681].
4838 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
4839   with curly braces][36868]. Part of [RFC 1506].
4840 * [A number of minor changes to name resolution have been activated][37127].
4841   They add up to more consistent semantics, allowing for future evolution of
4842   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4843   details of what is different. The breaking changes here have been transitioned
4844   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4845 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
4846   bounds][38279]
4847 * [`?Sized` can be used in `where` clauses][37791]
4848 * [There is now a limit on the size of monomorphized types and it can be
4849   modified with the `#![type_size_limit]` crate attribute, similarly to
4850   the `#![recursion_limit]` attribute][37789]
4851
4852 Compiler
4853 --------
4854
4855 * [On Windows, the compiler will apply dllimport attributes when linking to
4856   extern functions][37973]. Additional attributes and flags can control which
4857   library kind is linked and its name. [RFC 1717].
4858 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4859 * [The `--test` flag works with procedural macro crates][38107]
4860 * [Fix `extern "aapcs" fn` ABI][37814]
4861 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
4862 * [The `format!` expander recognizes incorrect `printf` and shell-style
4863   formatting directives and suggests the correct format][37613].
4864 * [Only report one error for all unused imports in an import list][37456]
4865
4866 Compiler Performance
4867 --------------------
4868
4869 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
4870 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
4871 * [Don't clone in `UnificationTable::probe`][37848]
4872 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
4873 * [Use small vectors in type walker][37760]
4874 * [Macro expansion performance was improved][37701]
4875 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
4876 * [Replace FNV with a faster hash function][37229]
4877
4878 Stabilized APIs
4879 ---------------
4880
4881 * [`std::iter::Iterator::min_by`]
4882 * [`std::iter::Iterator::max_by`]
4883 * [`std::os::*::fs::FileExt`]
4884 * [`std::sync::atomic::Atomic*::get_mut`]
4885 * [`std::sync::atomic::Atomic*::into_inner`]
4886 * [`std::vec::IntoIter::as_slice`]
4887 * [`std::vec::IntoIter::as_mut_slice`]
4888 * [`std::sync::mpsc::Receiver::try_iter`]
4889 * [`std::os::unix::process::CommandExt::before_exec`]
4890 * [`std::rc::Rc::strong_count`]
4891 * [`std::rc::Rc::weak_count`]
4892 * [`std::sync::Arc::strong_count`]
4893 * [`std::sync::Arc::weak_count`]
4894 * [`std::char::encode_utf8`]
4895 * [`std::char::encode_utf16`]
4896 * [`std::cell::Ref::clone`]
4897 * [`std::io::Take::into_inner`]
4898
4899 Libraries
4900 ---------
4901
4902 * [The standard sorting algorithm has been rewritten for dramatic performance
4903   improvements][38192]. It is a hybrid merge sort, drawing influences from
4904   Timsort. Previously it was a naive merge sort.
4905 * [`Iterator::nth` no longer has a `Sized` bound][38134]
4906 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
4907   performance.
4908 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
4909   and `char_indices().last()`][37882]
4910 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
4911 * [Chinese characters display correctly in `fmt::Debug`][37855]
4912 * [Derive `Default` for `Duration`][37699]
4913 * [Support creation of anonymous pipes on WinXP/2k][37677]
4914 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
4915 * [Don't pass overlapped handles to processes][38835]
4916
4917 Cargo
4918 -----
4919
4920 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4921   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4922   should instead check the variable at runtime with `std::env`. That the value
4923   was set at build time was a bug, and incorrect when cross-compiling. This
4924   change is known to cause breakage.
4925 * [Add `--all` flag to `cargo test`][cargo/3221]
4926 * [Compile statically against the MSVC CRT][cargo/3363]
4927 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
4928 * [Link OpenSSL statically on OSX][cargo/3311]
4929 * [Apply new fingerprinting to build dir outputs][cargo/3310]
4930 * [Test for bad path overrides with summaries][cargo/3336]
4931 * [Require `cargo install --vers` to take a semver version][cargo/3338]
4932 * [Fix retrying crate downloads for network errors][cargo/3348]
4933 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
4934 * [Emit more info on --message-format=json][cargo/3319]
4935 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
4936 * [Don't ignore errors in workspace manifest][cargo/3409]
4937 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
4938
4939 Tooling
4940 -------
4941
4942 * [Test runners (binaries built with `--test`) now support a `--list` argument
4943   that lists the tests it contains][38185]
4944 * [Test runners now support a `--exact` argument that makes the test filter
4945   match exactly, instead of matching only a substring of the test name][38181]
4946 * [rustdoc supports a `--playground-url` flag][37763]
4947 * [rustdoc provides more details about `#[should_panic]` errors][37749]
4948
4949 Misc
4950 ----
4951
4952 * [The Rust build system is now written in Rust][37817]. The Makefiles may
4953   continue to be used in this release by passing `--disable-rustbuild` to the
4954   configure script, but they will be deleted soon. Note that the new build
4955   system uses a different on-disk layout that will likely affect any scripts
4956   building Rust.
4957 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
4958   releases.
4959 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
4960 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
4961   releases.
4962
4963 Compatibility Notes
4964 -------------------
4965
4966 * [A number of minor changes to name resolution have been activated][37127].
4967   They add up to more consistent semantics, allowing for future evolution of
4968   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4969   details of what is different. The breaking changes here have been transitioned
4970   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4971 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4972   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4973   should instead check the variable at runtime with `std::env`. That the value
4974   was set at build time was a bug, and incorrect when cross-compiling. This
4975   change is known to cause breakage.
4976 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
4977   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
4978   1.10 and is now an error by default. It will become a hard error in the near
4979   future.
4980 * [The semantics relating modules to file system directories are changing in
4981   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
4982   lint, which is a warning in this release, and will become a hard error in the
4983   future.
4984 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4985 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
4986   the underlying iterator][37834]
4987
4988 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
4989 [33685]: https://github.com/rust-lang/rust/issues/33685
4990 [36868]: https://github.com/rust-lang/rust/pull/36868
4991 [37127]: https://github.com/rust-lang/rust/pull/37127
4992 [37229]: https://github.com/rust-lang/rust/pull/37229
4993 [37456]: https://github.com/rust-lang/rust/pull/37456
4994 [37527]: https://github.com/rust-lang/rust/pull/37527
4995 [37602]: https://github.com/rust-lang/rust/pull/37602
4996 [37613]: https://github.com/rust-lang/rust/pull/37613
4997 [37615]: https://github.com/rust-lang/rust/pull/37615
4998 [37636]: https://github.com/rust-lang/rust/pull/37636
4999 [37627]: https://github.com/rust-lang/rust/pull/37627
5000 [37642]: https://github.com/rust-lang/rust/pull/37642
5001 [37677]: https://github.com/rust-lang/rust/pull/37677
5002 [37699]: https://github.com/rust-lang/rust/pull/37699
5003 [37701]: https://github.com/rust-lang/rust/pull/37701
5004 [37705]: https://github.com/rust-lang/rust/pull/37705
5005 [37749]: https://github.com/rust-lang/rust/pull/37749
5006 [37760]: https://github.com/rust-lang/rust/pull/37760
5007 [37763]: https://github.com/rust-lang/rust/pull/37763
5008 [37764]: https://github.com/rust-lang/rust/pull/37764
5009 [37789]: https://github.com/rust-lang/rust/pull/37789
5010 [37791]: https://github.com/rust-lang/rust/pull/37791
5011 [37814]: https://github.com/rust-lang/rust/pull/37814
5012 [37817]: https://github.com/rust-lang/rust/pull/37817
5013 [37834]: https://github.com/rust-lang/rust/pull/37834
5014 [37848]: https://github.com/rust-lang/rust/pull/37848
5015 [37855]: https://github.com/rust-lang/rust/pull/37855
5016 [37882]: https://github.com/rust-lang/rust/pull/37882
5017 [37888]: https://github.com/rust-lang/rust/pull/37888
5018 [37973]: https://github.com/rust-lang/rust/pull/37973
5019 [37979]: https://github.com/rust-lang/rust/pull/37979
5020 [38086]: https://github.com/rust-lang/rust/pull/38086
5021 [38107]: https://github.com/rust-lang/rust/pull/38107
5022 [38117]: https://github.com/rust-lang/rust/pull/38117
5023 [38134]: https://github.com/rust-lang/rust/pull/38134
5024 [38146]: https://github.com/rust-lang/rust/pull/38146
5025 [38181]: https://github.com/rust-lang/rust/pull/38181
5026 [38182]: https://github.com/rust-lang/rust/pull/38182
5027 [38185]: https://github.com/rust-lang/rust/pull/38185
5028 [38192]: https://github.com/rust-lang/rust/pull/38192
5029 [38279]: https://github.com/rust-lang/rust/pull/38279
5030 [38835]: https://github.com/rust-lang/rust/pull/38835
5031 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5032 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5033 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
5034 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
5035 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
5036 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
5037 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
5038 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
5039 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
5040 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
5041 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
5042 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
5043 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
5044 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
5045 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
5046 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
5047 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
5048 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
5049 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
5050 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
5051 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
5052 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
5053 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
5054 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
5055 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
5056 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
5057 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
5058 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
5059 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
5060 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
5061 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
5062 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
5063 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
5064 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
5065 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
5066 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
5067 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
5068 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
5069
5070
5071 Version 1.14.0 (2016-12-22)
5072 ===========================
5073
5074 Language
5075 --------
5076
5077 * [`..` matches multiple tuple fields in enum variants, structs
5078   and tuples][36843]. [RFC 1492].
5079 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
5080 * [`use *` and `use ::*` both glob-import from the crate root][37367]
5081 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
5082   dereferencing][36822]
5083
5084 Compiler
5085 --------
5086
5087 * [Mark enums with non-zero discriminant as non-zero][37224]
5088 * [Lower-case `static mut` names are linted like other
5089   statics and consts][37162]
5090 * [Fix ICE on some macros in const integer positions
5091    (e.g. `[u8; m!()]`)][36819]
5092 * [Improve error message and snippet for "did you mean `x`"][36798]
5093 * [Add a panic-strategy field to the target specification][36794]
5094 * [Include LLVM version in `--version --verbose`][37200]
5095
5096 Compile-time Optimizations
5097 --------------------------
5098
5099 * [Improve macro expansion performance][37569]
5100 * [Shrink `Expr_::ExprInlineAsm`][37445]
5101 * [Replace all uses of SHA-256 with BLAKE2b][37439]
5102 * [Reduce the number of bytes hashed by `IchHasher`][37427]
5103 * [Avoid more allocations when compiling html5ever][37373]
5104 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
5105 * [Avoid some allocations in the macro parser][37318]
5106 * [Use a faster deflate setting][37298]
5107 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
5108   during interning of slices][37270]
5109 * [Optimize `write_metadata`][37267]
5110 * [Don't process obligation forest cycles when stalled][37231]
5111 * [Avoid many `CrateConfig` clones][37161]
5112 * [Optimize `Substs::super_fold_with`][37108]
5113 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
5114 * [Speed up `plug_leaks`][36917]
5115
5116 Libraries
5117 ---------
5118
5119 * [`println!()`, with no arguments, prints newline][36825].
5120   Previously, an empty string was required to achieve the same.
5121 * [`Wrapping` impls standard binary and unary operators, as well as
5122    the `Sum` and `Product` iterators][37356]
5123 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
5124   Vec<T>`][37326]
5125 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
5126   `VecDeque` iterators][37315]
5127 * [Improve `SipHasher` performance on small values][37312]
5128 * [Add Iterator trait TrustedLen to enable better FromIterator /
5129   Extend][37306]
5130 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
5131 * [`ReadDir` implements `Debug`][37221]
5132 * [Implement `RefUnwindSafe` for atomic types][37178]
5133 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
5134 * [Avoid allocations in `Decoder::read_str`][37064]
5135 * [`io::Error` implements `From<io::ErrorKind>`][37037]
5136 * [Impl `Debug` for raw pointers to unsized data][36880]
5137 * [Don't reuse `HashMap` random seeds][37470]
5138 * [The internal memory layout of `HashMap` is more cache-friendly, for
5139   significant improvements in some operations][36692]
5140 * [`HashMap` uses less memory on 32-bit architectures][36595]
5141 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
5142
5143 Cargo
5144 -----
5145
5146 * [Expose rustc cfg values to build scripts][cargo/3243]
5147 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
5148 * [Fix passing --features when testing multiple packages][cargo/3280]
5149 * [Use a single profile set per workspace][cargo/3249]
5150 * [Load `replace` sections from lock files][cargo/3220]
5151 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
5152
5153 Tooling
5154 -------
5155
5156 * [rustup is the recommended Rust installation method][1.14rustup]
5157 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
5158   S390x. These are [tier 2] platforms and may have major defects. Follow the
5159   instructions on the website to install, or add the targets to an existing
5160   installation with `rustup target add`. The new target triples are:
5161   - `mips-unknown-linux-gnu`
5162   - `mipsel-unknown-linux-gnu`
5163   - `mips64-unknown-linux-gnuabi64`
5164   - `mips64el-unknown-linux-gnuabi64 `
5165   - `powerpc-unknown-linux-gnu`
5166   - `powerpc64-unknown-linux-gnu`
5167   - `powerpc64le-unknown-linux-gnu`
5168   - `s390x-unknown-linux-gnu `
5169 * This release includes target (std) builds for ARM Linux running MUSL
5170   libc. These are [tier 2] platforms and may have major defects. Add the
5171   following triples to an existing rustup installation with `rustup target add`:
5172   - `arm-unknown-linux-musleabi`
5173   - `arm-unknown-linux-musleabihf`
5174   - `armv7-unknown-linux-musleabihf`
5175 * This release includes [experimental support for WebAssembly][1.14wasm], via
5176   the `wasm32-unknown-emscripten` target. This target is known to have major
5177   defects. Please test, report, and fix.
5178 * rustup no longer installs documentation by default. Run `rustup
5179   component add rust-docs` to install.
5180 * [Fix line stepping in debugger][37310]
5181 * [Enable line number debuginfo in releases][37280]
5182
5183 Misc
5184 ----
5185
5186 * [Disable jemalloc on aarch64/powerpc/mips][37392]
5187 * [Add support for Fuchsia OS][37313]
5188 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
5189
5190 Compatibility Notes
5191 -------------------
5192
5193 * [A number of forward-compatibility lints used by the compiler
5194   to gradually introduce language changes have been converted
5195   to deny by default][36894]:
5196   - ["use of inaccessible extern crate erroneously allowed"][36886]
5197   - ["type parameter default erroneously allowed in invalid location"][36887]
5198   - ["detects super or self keywords at the beginning of global path"][36888]
5199   - ["two overlapping inherent impls define an item with the same name
5200     were erroneously allowed"][36889]
5201   - ["floating-point constants cannot be used in patterns"][36890]
5202   - ["constants of struct or enum type can only be used in a pattern if
5203      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
5204   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
5205 * [Prohibit patterns in trait methods without bodies][37378]
5206 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
5207 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
5208 * [The `$crate` macro variable is accepted in fewer locations][37213]
5209 * [Impls specifying extra region requirements beyond the trait
5210   they implement are rejected][37167]
5211 * [Enums may not be unsized][37111]. Unsized enums are intended to
5212   work but never have. For now they are forbidden.
5213 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
5214
5215 [tier 2]: https://forge.rust-lang.org/platform-support.html
5216 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
5217 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
5218 [36430]: https://github.com/rust-lang/rust/pull/36430
5219 [36595]: https://github.com/rust-lang/rust/pull/36595
5220 [36595]: https://github.com/rust-lang/rust/pull/36595
5221 [36692]: https://github.com/rust-lang/rust/pull/36692
5222 [36767]: https://github.com/rust-lang/rust/pull/36767
5223 [36794]: https://github.com/rust-lang/rust/pull/36794
5224 [36798]: https://github.com/rust-lang/rust/pull/36798
5225 [36819]: https://github.com/rust-lang/rust/pull/36819
5226 [36822]: https://github.com/rust-lang/rust/pull/36822
5227 [36825]: https://github.com/rust-lang/rust/pull/36825
5228 [36843]: https://github.com/rust-lang/rust/pull/36843
5229 [36880]: https://github.com/rust-lang/rust/pull/36880
5230 [36886]: https://github.com/rust-lang/rust/issues/36886
5231 [36887]: https://github.com/rust-lang/rust/issues/36887
5232 [36888]: https://github.com/rust-lang/rust/issues/36888
5233 [36889]: https://github.com/rust-lang/rust/issues/36889
5234 [36890]: https://github.com/rust-lang/rust/issues/36890
5235 [36891]: https://github.com/rust-lang/rust/issues/36891
5236 [36892]: https://github.com/rust-lang/rust/issues/36892
5237 [36894]: https://github.com/rust-lang/rust/pull/36894
5238 [36917]: https://github.com/rust-lang/rust/pull/36917
5239 [36993]: https://github.com/rust-lang/rust/pull/36993
5240 [37037]: https://github.com/rust-lang/rust/pull/37037
5241 [37064]: https://github.com/rust-lang/rust/pull/37064
5242 [37094]: https://github.com/rust-lang/rust/pull/37094
5243 [37108]: https://github.com/rust-lang/rust/pull/37108
5244 [37111]: https://github.com/rust-lang/rust/pull/37111
5245 [37161]: https://github.com/rust-lang/rust/pull/37161
5246 [37162]: https://github.com/rust-lang/rust/pull/37162
5247 [37167]: https://github.com/rust-lang/rust/pull/37167
5248 [37178]: https://github.com/rust-lang/rust/pull/37178
5249 [37200]: https://github.com/rust-lang/rust/pull/37200
5250 [37213]: https://github.com/rust-lang/rust/pull/37213
5251 [37221]: https://github.com/rust-lang/rust/pull/37221
5252 [37224]: https://github.com/rust-lang/rust/pull/37224
5253 [37230]: https://github.com/rust-lang/rust/pull/37230
5254 [37231]: https://github.com/rust-lang/rust/pull/37231
5255 [37247]: https://github.com/rust-lang/rust/pull/37247
5256 [37267]: https://github.com/rust-lang/rust/pull/37267
5257 [37270]: https://github.com/rust-lang/rust/pull/37270
5258 [37273]: https://github.com/rust-lang/rust/pull/37273
5259 [37280]: https://github.com/rust-lang/rust/pull/37280
5260 [37298]: https://github.com/rust-lang/rust/pull/37298
5261 [37306]: https://github.com/rust-lang/rust/pull/37306
5262 [37310]: https://github.com/rust-lang/rust/pull/37310
5263 [37312]: https://github.com/rust-lang/rust/pull/37312
5264 [37313]: https://github.com/rust-lang/rust/pull/37313
5265 [37315]: https://github.com/rust-lang/rust/pull/37315
5266 [37318]: https://github.com/rust-lang/rust/pull/37318
5267 [37322]: https://github.com/rust-lang/rust/pull/37322
5268 [37326]: https://github.com/rust-lang/rust/pull/37326
5269 [37351]: https://github.com/rust-lang/rust/pull/37351
5270 [37356]: https://github.com/rust-lang/rust/pull/37356
5271 [37367]: https://github.com/rust-lang/rust/pull/37367
5272 [37373]: https://github.com/rust-lang/rust/pull/37373
5273 [37378]: https://github.com/rust-lang/rust/pull/37378
5274 [37389]: https://github.com/rust-lang/rust/pull/37389
5275 [37392]: https://github.com/rust-lang/rust/pull/37392
5276 [37427]: https://github.com/rust-lang/rust/pull/37427
5277 [37439]: https://github.com/rust-lang/rust/pull/37439
5278 [37445]: https://github.com/rust-lang/rust/pull/37445
5279 [37470]: https://github.com/rust-lang/rust/pull/37470
5280 [37569]: https://github.com/rust-lang/rust/pull/37569
5281 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5282 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
5283 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
5284 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
5285 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
5286 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
5287 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
5288
5289
5290 Version 1.13.0 (2016-11-10)
5291 ===========================
5292
5293 Language
5294 --------
5295
5296 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
5297   errors, like the `try!` macro, described in [RFC 0243].
5298 * [Stabilize macros in type position][36014]. Described in [RFC 873].
5299 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
5300 * [Fix `#[derive]` for empty tuple structs/variants][35728]
5301 * [Fix lifetime rules for 'if' conditions][36029]
5302 * [Avoid loading and parsing unconfigured non-inline modules][36482]
5303
5304 Compiler
5305 --------
5306
5307 * [Add the `-C link-arg` argument][36574]
5308 * [Remove the old AST-based backend from rustc_trans][35764]
5309 * [Don't enable NEON by default on armv7 Linux][35814]
5310 * [Fix debug line number info for macro expansions][35238]
5311 * [Do not emit "class method" debuginfo for types that are not
5312   DICompositeType][36008]
5313 * [Warn about multiple conflicting #[repr] hints][34623]
5314 * [When sizing DST, don't double-count nested struct prefixes][36351]
5315 * [Default RUST_MIN_STACK to 16MiB for now][36505]
5316 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
5317 * [Reject macros with empty repetitions to avoid infinite loop][36721]
5318 * [Expand macros without recursing to avoid stack overflows][36214]
5319
5320 Diagnostics
5321 -----------
5322
5323 * [Replace macro backtraces with labeled local uses][35702]
5324 * [Improve error message for misplaced doc comments][33922]
5325 * [Buffer unix and lock windows to prevent message interleaving][35975]
5326 * [Update lifetime errors to specifically note temporaries][36171]
5327 * [Special case a few colors for Windows][36178]
5328 * [Suggest `use self` when such an import resolves][36289]
5329 * [Be more specific when type parameter shadows primitive type][36338]
5330 * Many minor improvements
5331
5332 Compile-time Optimizations
5333 --------------------------
5334
5335 * [Compute and cache HIR hashes at beginning][35854]
5336 * [Don't hash types in loan paths][36004]
5337 * [Cache projections in trans][35761]
5338 * [Optimize the parser's last token handling][36527]
5339 * [Only instantiate #[inline] functions in codegen units referencing
5340   them][36524]. This leads to big improvements in cases where crates export
5341   define many inline functions without using them directly.
5342 * [Lazily allocate TypedArena's first chunk][36592]
5343 * [Don't allocate during default HashSet creation][36734]
5344
5345 Stabilized APIs
5346 ---------------
5347
5348 * [`checked_abs`]
5349 * [`wrapping_abs`]
5350 * [`overflowing_abs`]
5351 * [`RefCell::try_borrow`]
5352 * [`RefCell::try_borrow_mut`]
5353
5354 Libraries
5355 ---------
5356
5357 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
5358 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
5359   covariant][35354]
5360 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
5361 * [Implement `Debug` for `std::vec::IntoIter`][35707]
5362 * [`CString`: avoid excessive growth just to 0-terminate][35871]
5363 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
5364 * [Use arc4rand on FreeBSD][35884]
5365 * [memrchr: Correct aligned offset computation][35969]
5366 * [Improve Demangling of Rust Symbols][36059]
5367 * [Use monotonic time in condition variables][35048]
5368 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
5369 * [Implement conversion traits for `char`][35755]
5370 * [Fix illegal instruction caused by overflow in channel cloning][36104]
5371 * [Zero first byte of CString on drop][36264]
5372 * [Inherit overflow checks for sum and product][36372]
5373 * [Add missing Eq implementations][36423]
5374 * [Implement `Debug` for `DirEntry`][36631]
5375 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
5376   `errno`][36754]
5377 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5378 * [Implement more traits for `std::io::ErrorKind`][35911]
5379 * [Optimize BinaryHeap bounds checking][36072]
5380 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
5381   `extend_with_element`][36355]
5382 * [Fix overflow checking in unsigned pow()][34942]
5383
5384 Cargo
5385 -----
5386
5387 * This release includes security fixes to both curl and OpenSSL.
5388 * [Fix transitive doctests when panic=abort][cargo/3021]
5389 * [Add --all-features flag to cargo][cargo/3038]
5390 * [Reject path-based dependencies in `cargo package`][cargo/3060]
5391 * [Don't parse the home directory more than once][cargo/3078]
5392 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
5393 * [Update OpenSSL to 1.0.2j][cargo/3121]
5394 * [Add license and license_file to cargo metadata output][cargo/3110]
5395 * [Make crates-io registry URL optional in config; ignore all changes to
5396   source.crates-io][cargo/3089]
5397 * [Don't download dependencies from other platforms][cargo/3123]
5398 * [Build transitive dev-dependencies when needed][cargo/3125]
5399 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
5400 * [Avoid updating registry when adding existing deps][cargo/3144]
5401 * [Warn about path overrides that won't work][cargo/3136]
5402 * [Use workspaces during `cargo install`][cargo/3146]
5403 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
5404 * [Add --message-format flag][cargo/3000]
5405 * [Pass target environment for rustdoc][cargo/3205]
5406 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
5407 * [Update curl and curl-sys][cargo/3241]
5408 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
5409
5410 Tooling
5411 -------
5412
5413 * [rustdoc: Add the `--sysroot` argument][36586]
5414 * [rustdoc: Fix a couple of issues with the search results][35655]
5415 * [rustdoc: remove the `!` from macro URLs and titles][35234]
5416 * [gdb: Fix pretty-printing special-cased Rust types][35585]
5417 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
5418
5419 Misc
5420 ----
5421
5422 * [Remove unmaintained style guide][35124]
5423 * [Add s390x support][36369]
5424 * [Initial work at Haiku OS support][36727]
5425 * [Add mips-uclibc targets][35734]
5426 * [Crate-ify compiler-rt into compiler-builtins][35021]
5427 * [Add rustc version info (git hash + date) to dist tarball][36213]
5428 * Many documentation improvements
5429
5430 Compatibility Notes
5431 -------------------
5432
5433 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5434 * [Deny (by default) transmuting from fn item types to pointer-sized
5435   types][34923]. Continuing the long transition to zero-sized fn items,
5436   per [RFC 401].
5437 * [Fix `#[derive]` for empty tuple structs/variants][35728].
5438   Part of [RFC 1506].
5439 * [Issue deprecation warnings for safe accesses to extern statics][36173]
5440 * [Fix lifetime rules for 'if' conditions][36029].
5441 * [Inherit overflow checks for sum and product][36372].
5442 * [Forbid user-defined macros named "macro_rules"][36730].
5443
5444 [33922]: https://github.com/rust-lang/rust/pull/33922
5445 [34623]: https://github.com/rust-lang/rust/pull/34623
5446 [34923]: https://github.com/rust-lang/rust/pull/34923
5447 [34942]: https://github.com/rust-lang/rust/pull/34942
5448 [34982]: https://github.com/rust-lang/rust/pull/34982
5449 [35021]: https://github.com/rust-lang/rust/pull/35021
5450 [35048]: https://github.com/rust-lang/rust/pull/35048
5451 [35074]: https://github.com/rust-lang/rust/pull/35074
5452 [35124]: https://github.com/rust-lang/rust/pull/35124
5453 [35234]: https://github.com/rust-lang/rust/pull/35234
5454 [35238]: https://github.com/rust-lang/rust/pull/35238
5455 [35354]: https://github.com/rust-lang/rust/pull/35354
5456 [35559]: https://github.com/rust-lang/rust/pull/35559
5457 [35585]: https://github.com/rust-lang/rust/pull/35585
5458 [35627]: https://github.com/rust-lang/rust/pull/35627
5459 [35655]: https://github.com/rust-lang/rust/pull/35655
5460 [35702]: https://github.com/rust-lang/rust/pull/35702
5461 [35707]: https://github.com/rust-lang/rust/pull/35707
5462 [35728]: https://github.com/rust-lang/rust/pull/35728
5463 [35734]: https://github.com/rust-lang/rust/pull/35734
5464 [35755]: https://github.com/rust-lang/rust/pull/35755
5465 [35761]: https://github.com/rust-lang/rust/pull/35761
5466 [35764]: https://github.com/rust-lang/rust/pull/35764
5467 [35814]: https://github.com/rust-lang/rust/pull/35814
5468 [35854]: https://github.com/rust-lang/rust/pull/35854
5469 [35871]: https://github.com/rust-lang/rust/pull/35871
5470 [35884]: https://github.com/rust-lang/rust/pull/35884
5471 [35911]: https://github.com/rust-lang/rust/pull/35911
5472 [35969]: https://github.com/rust-lang/rust/pull/35969
5473 [35975]: https://github.com/rust-lang/rust/pull/35975
5474 [36004]: https://github.com/rust-lang/rust/pull/36004
5475 [36008]: https://github.com/rust-lang/rust/pull/36008
5476 [36014]: https://github.com/rust-lang/rust/pull/36014
5477 [36029]: https://github.com/rust-lang/rust/pull/36029
5478 [36059]: https://github.com/rust-lang/rust/pull/36059
5479 [36072]: https://github.com/rust-lang/rust/pull/36072
5480 [36101]: https://github.com/rust-lang/rust/pull/36101
5481 [36104]: https://github.com/rust-lang/rust/pull/36104
5482 [36171]: https://github.com/rust-lang/rust/pull/36171
5483 [36173]: https://github.com/rust-lang/rust/pull/36173
5484 [36178]: https://github.com/rust-lang/rust/pull/36178
5485 [36213]: https://github.com/rust-lang/rust/pull/36213
5486 [36214]: https://github.com/rust-lang/rust/pull/36214
5487 [36264]: https://github.com/rust-lang/rust/pull/36264
5488 [36266]: https://github.com/rust-lang/rust/pull/36266
5489 [36289]: https://github.com/rust-lang/rust/pull/36289
5490 [36338]: https://github.com/rust-lang/rust/pull/36338
5491 [36351]: https://github.com/rust-lang/rust/pull/36351
5492 [36355]: https://github.com/rust-lang/rust/pull/36355
5493 [36369]: https://github.com/rust-lang/rust/pull/36369
5494 [36372]: https://github.com/rust-lang/rust/pull/36372
5495 [36423]: https://github.com/rust-lang/rust/pull/36423
5496 [36482]: https://github.com/rust-lang/rust/pull/36482
5497 [36505]: https://github.com/rust-lang/rust/pull/36505
5498 [36524]: https://github.com/rust-lang/rust/pull/36524
5499 [36527]: https://github.com/rust-lang/rust/pull/36527
5500 [36551]: https://github.com/rust-lang/rust/pull/36551
5501 [36574]: https://github.com/rust-lang/rust/pull/36574
5502 [36586]: https://github.com/rust-lang/rust/pull/36586
5503 [36592]: https://github.com/rust-lang/rust/pull/36592
5504 [36631]: https://github.com/rust-lang/rust/pull/36631
5505 [36639]: https://github.com/rust-lang/rust/pull/36639
5506 [36721]: https://github.com/rust-lang/rust/pull/36721
5507 [36727]: https://github.com/rust-lang/rust/pull/36727
5508 [36730]: https://github.com/rust-lang/rust/pull/36730
5509 [36734]: https://github.com/rust-lang/rust/pull/36734
5510 [36754]: https://github.com/rust-lang/rust/pull/36754
5511 [36995]: https://github.com/rust-lang/rust/pull/36995
5512 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
5513 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
5514 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5515 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
5516 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
5517 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
5518 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
5519 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
5520 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
5521 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
5522 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
5523 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
5524 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
5525 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
5526 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
5527 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
5528 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
5529 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
5530 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
5531 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
5532 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
5533 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
5534 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
5535 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
5536 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
5537 [rustup]: https://www.rustup.rs
5538 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
5539 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
5540 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
5541 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
5542 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
5543 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
5544 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
5545
5546
5547 Version 1.12.1 (2016-10-20)
5548 ===========================
5549
5550 Regression Fixes
5551 ----------------
5552
5553 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
5554 * [Confusion with double negation and booleans][36856]
5555 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
5556 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
5557 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
5558 * [Corrupted memory after updated to 1.12][36936]
5559 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
5560 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
5561 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
5562
5563 [36381]: https://github.com/rust-lang/rust/issues/36381
5564 [36856]: https://github.com/rust-lang/rust/issues/36856
5565 [36875]: https://github.com/rust-lang/rust/issues/36875
5566 [36924]: https://github.com/rust-lang/rust/issues/36924
5567 [36926]: https://github.com/rust-lang/rust/issues/36926
5568 [36936]: https://github.com/rust-lang/rust/issues/36936
5569 [37026]: https://github.com/rust-lang/rust/issues/37026
5570 [37112]: https://github.com/rust-lang/rust/issues/37112
5571 [37153]: https://github.com/rust-lang/rust/issues/37153
5572
5573
5574 Version 1.12.0 (2016-09-29)
5575 ===========================
5576
5577 Highlights
5578 ----------
5579
5580 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5581   This translation pass is far simpler than the previous AST->LLVM pass, and
5582   creates opportunities to perform new optimizations directly on the MIR. It
5583   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5584 * [`rustc` presents a new, more readable error format, along with
5585   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5586   Most common editors supporting Rust have been updated to work with it. It was
5587   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5588
5589 Compiler
5590 --------
5591
5592 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5593   This translation pass is far simpler than the previous AST->LLVM pass, and
5594   creates opportunities to perform new optimizations directly on the MIR. It
5595   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5596 * [Print the Rust target name, not the LLVM target name, with
5597   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
5598 * [The computation of `TypeId` is correct in some cases where it was previously
5599   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
5600 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
5601 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
5602   `--print relocation-models`, and `--print code-models` print the available
5603   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
5604   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
5605 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
5606   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
5607   These targets produce statically-linked binaries. There are no binary release
5608   builds yet though.
5609
5610 Diagnostics
5611 -----------
5612
5613 * [`rustc` presents a new, more readable error format, along with
5614   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5615   Most common editors supporting Rust have been updated to work with it. It was
5616   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5617 * [In error descriptions, references are now described in plain English,
5618   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
5619 * [In error type descriptions, unknown numeric types are named `{integer}` or
5620   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
5621 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
5622
5623 Language
5624 --------
5625
5626 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
5627 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
5628 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
5629   useful](https://github.com/rust-lang/rust/pull/34908)
5630 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
5631   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
5632 * [Semicolons are properly required as statement delimiters inside
5633   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
5634 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
5635
5636 Stabilized APIs
5637 ---------------
5638
5639 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
5640 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
5641 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
5642 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
5643 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
5644 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
5645 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
5646 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
5647 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
5648 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
5649   Both on Unix and Windows.
5650 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
5651 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
5652 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
5653 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
5654 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
5655 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
5656 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
5657 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
5658
5659 Libraries
5660 ---------
5661
5662 * [The `format!` macro and friends now allow a single argument to be formatted
5663   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
5664 * [The lifetime bounds on `[T]::binary_search_by` and
5665   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
5666 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
5667 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
5668 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
5669 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
5670 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
5671 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
5672 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
5673 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
5674   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
5675 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
5676   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
5677 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
5678 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
5679   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
5680 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
5681 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
5682 * [`mpsc::sync_channel` `Receiver`s return any available message before
5683   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
5684 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
5685 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
5686
5687 Cargo
5688 -----
5689
5690 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
5691 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
5692 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
5693 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
5694 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
5695 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
5696 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
5697 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
5698 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
5699 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
5700 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
5701 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
5702 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
5703 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
5704 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
5705 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
5706
5707 Performance
5708 -----------
5709
5710 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
5711 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
5712
5713 Tooling
5714 -------
5715
5716 * [Test binaries now support a `--test-threads` argument to specify the number
5717   of threads used to run tests, and which acts the same as the
5718   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
5719 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
5720 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
5721 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5722 * [Rust releases now come with source packages that can be installed by rustup
5723   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
5724   The resulting source code can be used by tools and IDES, located in the
5725   sysroot under `lib/rustlib/src`.
5726
5727 Misc
5728 ----
5729
5730 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
5731 * Many minor improvements to the documentation.
5732 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
5733
5734 Compatibility Notes
5735 -------------------
5736
5737 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
5738   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
5739 * [When formatting strings, if "precision" is specified, the "fill",
5740   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
5741 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
5742
5743
5744 Version 1.11.0 (2016-08-18)
5745 ===========================
5746
5747 Language
5748 --------
5749
5750 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
5751 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
5752 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
5753 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
5754
5755 Stabilized APIs
5756 ---------------
5757
5758 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
5759 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
5760 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
5761 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
5762 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
5763 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
5764   (in libcore - previously stabilized in libstd)
5765 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
5766   (in libcore - previously stabilized in libstd)
5767 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
5768   (in libcore - previously stabilized in libstd)
5769 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
5770   (in libcore - previously stabilized in libstd)
5771 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5772 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5773 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
5774 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
5775
5776 Libraries
5777 ---------
5778
5779 * [The `thread_local!` macro supports multiple definitions in a single
5780    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
5781 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
5782 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
5783   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
5784 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
5785 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
5786 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
5787 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
5788
5789 Cargo
5790 -----
5791
5792 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
5793 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
5794 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
5795 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
5796 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
5797   and `-vv` prints warnings for all crates.
5798 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
5799 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
5800   This provides room for expansion by arbitrary tools.
5801 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
5802 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
5803 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
5804 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
5805 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
5806 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
5807 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
5808
5809 Performance
5810 -----------
5811
5812 * [Caching projections speeds up type check dramatically for some
5813   workloads](https://github.com/rust-lang/rust/pull/33816)
5814 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
5815   This hasher is faster, but is believed to provide sufficient
5816   protection from collision attacks.
5817 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
5818
5819 Rustdoc
5820 -------
5821
5822 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
5823 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
5824 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
5825 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
5826 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
5827
5828 Tooling
5829 -------
5830
5831 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
5832 * [When emitting debug info, rustc emits frame pointers for closures,
5833   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
5834 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5835 * Many more errors have been given error codes and extended
5836   explanations
5837 * API documentation continues to be improved, with many new examples
5838
5839 Misc
5840 ----
5841
5842 * [rustc no longer hangs when dependencies recursively re-export
5843   submodules](https://github.com/rust-lang/rust/pull/34542)
5844 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
5845 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
5846   rewritten](https://github.com/rust-lang/rust/pull/33895)
5847 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
5848   No targets use this yet, but it works toward AVR support.
5849
5850 Compatibility Notes
5851 -------------------
5852
5853 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
5854 * [The new follow-set rules that place restrictions on `macro_rules!`
5855   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
5856   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
5857   and has been a warning since 1.10.
5858 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
5859   This causes breakage in some corner cases.
5860
5861
5862 Version 1.10.0 (2016-07-07)
5863 ===========================
5864
5865 Language
5866 --------
5867
5868 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
5869   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
5870 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
5871 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
5872 * [`panic!` can be converted to a runtime abort with the
5873   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
5874   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5875 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
5876   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
5877   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
5878   Note that Cargo does not yet directly support cdylibs.
5879
5880 Stabilized APIs
5881 ---------------
5882
5883 * `os::windows::fs::OpenOptionsExt::access_mode`
5884 * `os::windows::fs::OpenOptionsExt::share_mode`
5885 * `os::windows::fs::OpenOptionsExt::custom_flags`
5886 * `os::windows::fs::OpenOptionsExt::attributes`
5887 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
5888 * `os::unix::fs::OpenOptionsExt::custom_flags`
5889 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
5890 * `Default for sync::Weak`
5891 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
5892 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
5893 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
5894 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
5895 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
5896 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
5897 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
5898 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
5899 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
5900 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
5901 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
5902 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
5903 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
5904 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
5905 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
5906 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
5907 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
5908 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
5909 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
5910 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
5911 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
5912 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
5913 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
5914 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
5915 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
5916 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5917 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5918 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5919 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5920 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
5921 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
5922 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
5923 * Read/Write/RawFd impls for `UnixStream`
5924 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
5925 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
5926 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
5927 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
5928 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
5929 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
5930 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
5931 * RawFd impls for `UnixListener`
5932 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
5933 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
5934 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
5935 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
5936 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
5937 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
5938 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
5939 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
5940 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
5941 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
5942 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
5943 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
5944 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
5945 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
5946 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
5947 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
5948 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
5949 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
5950 * RawFd impls for `UnixDatagram`
5951 * `{BTree,Hash}Map::values_mut`
5952 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
5953
5954 Libraries
5955 ---------
5956
5957 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
5958   The semantics of this minor method are subtle and probably not what
5959   most people want.
5960 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
5961 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
5962   will fall back to `/dev/urandom` temporarily to avoid blocking
5963   during early boot](https://github.com/rust-lang/rust/pull/33086).
5964 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
5965 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
5966 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
5967 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
5968 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
5969 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
5970   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
5971
5972 Cargo
5973 -----
5974 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
5975   This controls the runtime behavior of the `panic!` macro
5976   and can be either "unwind" (the default), or "abort".
5977   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5978 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
5979 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
5980 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
5981   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
5982 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
5983 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
5984 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
5985   By default they are retried twice, which can be customized with the
5986   `net.retry` value in `.cargo/config`.
5987 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
5988 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
5989 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
5990 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
5991   Makes it possible to install multiple crates in parallel.
5992 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
5993 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
5994 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
5995 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
5996 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
5997 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
5998
5999 Performance
6000 -----------
6001
6002 * [rustc memory usage was reduced by refactoring the context used for
6003   type checking](https://github.com/rust-lang/rust/pull/33425).
6004 * [Speed up creation of `HashMap`s by caching the random keys used
6005   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
6006 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
6007 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
6008 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
6009   10x faster than the previous lookup tables.
6010 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
6011
6012 Usability
6013 ---------
6014
6015 * Many incremental improvements to documentation and rustdoc.
6016 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
6017 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
6018 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
6019 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
6020 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
6021 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
6022 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
6023
6024 Misc
6025 ----
6026
6027 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
6028 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
6029 * [`std` no longer prints backtraces on platforms where the running
6030   module must be loaded with `env::current_exe`, which can't be relied
6031   on](https://github.com/rust-lang/rust/pull/33554).
6032 * This release includes std binaries for the i586-unknown-linux-gnu,
6033   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
6034   i586 target is for old x86 hardware without SSE2, and the armv7
6035   target is for Android running on modern ARM architectures.
6036 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
6037   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
6038 * [On Unix the runtime aborts by calling `libc::abort` instead of
6039   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
6040 * [Rust is now bootstrapped from the previous release of Rust,
6041   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
6042
6043 Compatibility Notes
6044 -------------------
6045
6046 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
6047 * [`target_env` for Linux ARM targets is just `gnu`, not
6048   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
6049 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
6050 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
6051 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
6052   Affects how macros are parsed.
6053 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
6054 * [Feature-gated attributes on macro-generated macro invocations are
6055   now rejected](https://github.com/rust-lang/rust/pull/32791).
6056 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
6057   This caused some minor changes to type inference.
6058
6059
6060 Version 1.9.0 (2016-05-26)
6061 ==========================
6062
6063 Language
6064 --------
6065
6066 * The `#[deprecated]` attribute when applied to an API will generate
6067   warnings when used. The warnings may be suppressed with
6068   `#[allow(deprecated)]`. [RFC 1270].
6069 * [`fn` item types are zero sized, and each `fn` names a unique
6070   type][1.9fn]. This will break code that transmutes `fn`s, so calling
6071   `transmute` on a `fn` type will generate a warning for a few cycles,
6072   then will be converted to an error.
6073 * [Field and method resolution understand visibility, so private
6074   fields and methods cannot prevent the proper use of public fields
6075   and methods][1.9fv].
6076 * [The parser considers unicode codepoints in the
6077   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
6078
6079 Stabilized APIs
6080 ---------------
6081
6082 * [`std::panic`]
6083 * [`std::panic::catch_unwind`] (renamed from `recover`)
6084 * [`std::panic::resume_unwind`] (renamed from `propagate`)
6085 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
6086 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
6087 * [`str::is_char_boundary`]
6088 * [`<*const T>::as_ref`]
6089 * [`<*mut T>::as_ref`]
6090 * [`<*mut T>::as_mut`]
6091 * [`AsciiExt::make_ascii_uppercase`]
6092 * [`AsciiExt::make_ascii_lowercase`]
6093 * [`char::decode_utf16`]
6094 * [`char::DecodeUtf16`]
6095 * [`char::DecodeUtf16Error`]
6096 * [`char::DecodeUtf16Error::unpaired_surrogate`]
6097 * [`BTreeSet::take`]
6098 * [`BTreeSet::replace`]
6099 * [`BTreeSet::get`]
6100 * [`HashSet::take`]
6101 * [`HashSet::replace`]
6102 * [`HashSet::get`]
6103 * [`OsString::with_capacity`]
6104 * [`OsString::clear`]
6105 * [`OsString::capacity`]
6106 * [`OsString::reserve`]
6107 * [`OsString::reserve_exact`]
6108 * [`OsStr::is_empty`]
6109 * [`OsStr::len`]
6110 * [`std::os::unix::thread`]
6111 * [`RawPthread`]
6112 * [`JoinHandleExt`]
6113 * [`JoinHandleExt::as_pthread_t`]
6114 * [`JoinHandleExt::into_pthread_t`]
6115 * [`HashSet::hasher`]
6116 * [`HashMap::hasher`]
6117 * [`CommandExt::exec`]
6118 * [`File::try_clone`]
6119 * [`SocketAddr::set_ip`]
6120 * [`SocketAddr::set_port`]
6121 * [`SocketAddrV4::set_ip`]
6122 * [`SocketAddrV4::set_port`]
6123 * [`SocketAddrV6::set_ip`]
6124 * [`SocketAddrV6::set_port`]
6125 * [`SocketAddrV6::set_flowinfo`]
6126 * [`SocketAddrV6::set_scope_id`]
6127 * [`slice::copy_from_slice`]
6128 * [`ptr::read_volatile`]
6129 * [`ptr::write_volatile`]
6130 * [`OpenOptions::create_new`]
6131 * [`TcpStream::set_nodelay`]
6132 * [`TcpStream::nodelay`]
6133 * [`TcpStream::set_ttl`]
6134 * [`TcpStream::ttl`]
6135 * [`TcpStream::set_only_v6`]
6136 * [`TcpStream::only_v6`]
6137 * [`TcpStream::take_error`]
6138 * [`TcpStream::set_nonblocking`]
6139 * [`TcpListener::set_ttl`]
6140 * [`TcpListener::ttl`]
6141 * [`TcpListener::set_only_v6`]
6142 * [`TcpListener::only_v6`]
6143 * [`TcpListener::take_error`]
6144 * [`TcpListener::set_nonblocking`]
6145 * [`UdpSocket::set_broadcast`]
6146 * [`UdpSocket::broadcast`]
6147 * [`UdpSocket::set_multicast_loop_v4`]
6148 * [`UdpSocket::multicast_loop_v4`]
6149 * [`UdpSocket::set_multicast_ttl_v4`]
6150 * [`UdpSocket::multicast_ttl_v4`]
6151 * [`UdpSocket::set_multicast_loop_v6`]
6152 * [`UdpSocket::multicast_loop_v6`]
6153 * [`UdpSocket::set_multicast_ttl_v6`]
6154 * [`UdpSocket::multicast_ttl_v6`]
6155 * [`UdpSocket::set_ttl`]
6156 * [`UdpSocket::ttl`]
6157 * [`UdpSocket::set_only_v6`]
6158 * [`UdpSocket::only_v6`]
6159 * [`UdpSocket::join_multicast_v4`]
6160 * [`UdpSocket::join_multicast_v6`]
6161 * [`UdpSocket::leave_multicast_v4`]
6162 * [`UdpSocket::leave_multicast_v6`]
6163 * [`UdpSocket::take_error`]
6164 * [`UdpSocket::connect`]
6165 * [`UdpSocket::send`]
6166 * [`UdpSocket::recv`]
6167 * [`UdpSocket::set_nonblocking`]
6168
6169 Libraries
6170 ---------
6171
6172 * [`std::sync::Once` is poisoned if its initialization function
6173   fails][1.9o].
6174 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
6175 * [Most types implement `fmt::Debug`][1.9db].
6176 * [The default buffer size used by `BufReader` and `BufWriter` was
6177   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
6178   used by other languages.
6179 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
6180   `Duration` additionally implements `*=` and `/=`][1.9ta].
6181 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
6182 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
6183 * [`Chain` implements `BufRead`][1.9ch].
6184 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
6185
6186 Cargo
6187 -----
6188
6189 * [Cargo can now run concurrently][1.9cc].
6190 * [Top-level overrides allow specific revisions of crates to be
6191   overridden through the entire crate graph][1.9ct].  This is intended
6192   to make upgrades easier for large projects, by allowing crates to be
6193   forked temporarily until they've been upgraded and republished.
6194 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
6195 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
6196   on the commandline][1.9cf]. `rustc` arguments can also be specified
6197   in the `build.rustflags` configuration key.
6198
6199 Performance
6200 -----------
6201
6202 * [The time complexity of comparing variables for equivalence during type
6203   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
6204   to major compilation time improvement in some scenarios.
6205 * [`ToString` is specialized for `str`, giving it the same performance
6206   as `to_owned`][1.9ts].
6207 * [Spawning processes with `Command::output` no longer creates extra
6208   threads][1.9sp].
6209 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
6210   for C-like enums][1.9cl].
6211
6212 Misc
6213 ----
6214
6215 * [Passing the `--quiet` flag to a test runner will produce
6216   much-abbreviated output][1.9q].
6217 * The Rust Project now publishes std binaries for the
6218   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
6219   `i586-pc-windows-msvc` targets.
6220
6221 Compatibility Notes
6222 -------------------
6223
6224 * [`std::sync::Once` is poisoned if its initialization function
6225   fails][1.9o].
6226 * [It is illegal to define methods with the same name in overlapping
6227   inherent `impl` blocks][1.9sn].
6228 * [`fn` item types are zero sized, and each `fn` names a unique
6229   type][1.9fn]. This will break code that transmutes `fn`s, so calling
6230   `transmute` on a `fn` type will generate a warning for a few cycles,
6231   then will be converted to an error.
6232 * [Improvements to const evaluation may trigger new errors when integer
6233   literals are out of range][1.9ce].
6234
6235
6236 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
6237 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
6238 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
6239 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
6240 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
6241 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
6242 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
6243 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
6244 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
6245 [1.9db]: https://github.com/rust-lang/rust/pull/32054
6246 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
6247 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
6248 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
6249 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
6250 [1.9o]: https://github.com/rust-lang/rust/pull/32325
6251 [1.9q]: https://github.com/rust-lang/rust/pull/31887
6252 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
6253 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
6254 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
6255 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
6256 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
6257 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
6258 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
6259 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
6260 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6261 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
6262 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6263 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
6264 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
6265 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
6266 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
6267 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
6268 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
6269 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
6270 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
6271 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
6272 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
6273 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
6274 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
6275 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
6276 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
6277 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
6278 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
6279 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
6280 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
6281 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
6282 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
6283 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
6284 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
6285 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
6286 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
6287 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
6288 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
6289 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
6290 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
6291 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
6292 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
6293 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
6294 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
6295 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
6296 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6297 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6298 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6299 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6300 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6301 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6302 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
6303 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6304 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
6305 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6306 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6307 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6308 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6309 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6310 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
6311 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
6312 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
6313 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
6314 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
6315 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
6316 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
6317 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
6318 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
6319 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
6320 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
6321 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
6322 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
6323 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
6324 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
6325 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
6326 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
6327 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
6328 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
6329 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
6330 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
6331 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
6332 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
6333 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
6334 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
6335 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
6336 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
6337 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
6338 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
6339 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
6340 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
6341 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
6342 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
6343 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
6344 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
6345 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
6346
6347
6348 Version 1.8.0 (2016-04-14)
6349 ==========================
6350
6351 Language
6352 --------
6353
6354 * Rust supports overloading of compound assignment statements like
6355   `+=` by implementing the [`AddAssign`], [`SubAssign`],
6356   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
6357   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
6358   traits. [RFC 953].
6359 * Empty structs can be defined with braces, as in `struct Foo { }`, in
6360   addition to the non-braced form, `struct Foo;`. [RFC 218].
6361
6362 Libraries
6363 ---------
6364
6365 * Stabilized APIs:
6366   * [`str::encode_utf16`] (renamed from `utf16_units`)
6367   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
6368   * [`Ref::map`]
6369   * [`RefMut::map`]
6370   * [`ptr::drop_in_place`]
6371   * [`time::Instant`]
6372   * [`time::SystemTime`]
6373   * [`Instant::now`]
6374   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
6375   * [`Instant::elapsed`]
6376   * [`SystemTime::now`]
6377   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
6378   * [`SystemTime::elapsed`]
6379   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
6380   * [`SystemTimeError`]
6381   * [`SystemTimeError::duration`]
6382   * Various impls for `SystemTimeError`
6383   * [`UNIX_EPOCH`]
6384   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
6385     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
6386     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
6387 * [The `write!` and `writeln!` macros correctly emit errors if any of
6388   their arguments can't be formatted][1.8w].
6389 * [Various I/O functions support large files on 32-bit Linux][1.8l].
6390 * [The Unix-specific `raw` modules, which contain a number of
6391   redefined C types are deprecated][1.8r], including `os::raw::unix`,
6392   `os::raw::macos`, and `os::raw::linux`. These modules defined types
6393   such as `ino_t` and `dev_t`. The inconsistency of these definitions
6394   across platforms was making it difficult to implement `std`
6395   correctly. Those that need these definitions should use the `libc`
6396   crate. [RFC 1415].
6397 * The Unix-specific `MetadataExt` traits, including
6398   `os::unix::fs::MetadataExt`, which expose values such as inode
6399   numbers [no longer return platform-specific types][1.8r], but
6400   instead return widened integers. [RFC 1415].
6401 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
6402 * [Atomic loads and stores are not volatile][1.8a].
6403 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
6404
6405 Performance
6406 -----------
6407
6408 * [Inlining hash functions lead to a 3% compile-time improvement in
6409   some workloads][1.8h].
6410 * When using jemalloc, its symbols are [unprefixed so that it
6411   overrides the libc malloc implementation][1.8h]. This means that for
6412   rustc, LLVM is now using jemalloc, which results in a 6%
6413   compile-time improvement on a specific workload.
6414 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
6415
6416 Misc
6417 ----
6418
6419 * [32-bit MSVC builds finally implement unwinding][1.8ms].
6420   i686-pc-windows-msvc is now considered a tier-1 platform.
6421 * [The `--print targets` flag prints a list of supported targets][1.8t].
6422 * [The `--print cfg` flag prints the `cfg`s defined for the current
6423   target][1.8cf].
6424 * [`rustc` can be built with an new Cargo-based build system, written
6425   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
6426   build system. To enable it configure with `configure --rustbuild`.
6427 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
6428   variants while also indicating the total number of missing variants
6429   if more than 3][1.8m].
6430 * [Executable stacks are disabled on Linux and BSD][1.8nx].
6431 * The Rust Project now publishes binary releases of the standard
6432   library for a number of tier-2 targets:
6433   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
6434   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
6435   `x86_64-rumprun-netbsd`. These can be installed with
6436   tools such as [multirust][1.8mr].
6437
6438 Cargo
6439 -----
6440
6441 * [`cargo init` creates a new Cargo project in the current
6442   directory][1.8ci].  It is otherwise like `cargo new`.
6443 * [Cargo has configuration keys for `-v` and
6444   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
6445   `[term]` section of `.cargo/config`.
6446 * [Configuration keys that evaluate to strings or integers can be set
6447   via environment variables][1.8ce]. For example the `build.jobs` key
6448   can be set via `CARGO_BUILD_JOBS`. Environment variables take
6449   precedence over config files.
6450 * [Target-specific dependencies support Rust `cfg` syntax for
6451   describing targets][1.8cfg] so that dependencies for multiple
6452   targets can be specified together. [RFC 1361].
6453 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
6454   `RUSTDOC` take precedence over the `build.target-dir`,
6455   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
6456 * [The child process tree is killed on Windows when Cargo is
6457   killed][1.8ck].
6458 * [The `build.target` configuration value sets the target platform,
6459   like `--target`][1.8ct].
6460
6461 Compatibility Notes
6462 -------------------
6463
6464 * [Unstable compiler flags have been further restricted][1.8u]. Since
6465   1.0 `-Z` flags have been considered unstable, and other flags that
6466   were considered unstable additionally required passing `-Z
6467   unstable-options` to access. Unlike unstable language and library
6468   features though, these options have been accessible on the stable
6469   release channel. Going forward, *new unstable flags will not be
6470   available on the stable release channel*, and old unstable flags
6471   will warn about their usage. In the future, all unstable flags will
6472   be unavailable on the stable release channel.
6473 * [It is no longer possible to `match` on empty enum variants using
6474   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
6475 * The Unix-specific `MetadataExt` traits, including
6476   `os::unix::fs::MetadataExt`, which expose values such as inode
6477   numbers [no longer return platform-specific types][1.8r], but
6478   instead return widened integers. [RFC 1415].
6479 * [Modules sourced from the filesystem cannot appear within arbitrary
6480   blocks, but only within other modules][1.8mf].
6481 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
6482 * On Unix, [stack overflow triggers a runtime abort instead of a
6483   SIGSEGV][1.8so].
6484 * [`Command::spawn` and its equivalents return an error if any of
6485   its command-line arguments contain interior `NUL`s][1.8n].
6486 * [Tuple and unit enum variants from other crates are in the type
6487   namespace][1.8tn].
6488 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
6489   type instead of `.a` files][1.8st]. Additionally, for the MSVC
6490   toolchain, `rustc` emits import libraries named `foo.dll.lib`
6491   instead of `foo.lib`.
6492
6493
6494 [1.8a]: https://github.com/rust-lang/rust/pull/30962
6495 [1.8b]: https://github.com/rust-lang/rust/pull/31123
6496 [1.8c]: https://github.com/rust-lang/rust/pull/31530
6497 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
6498 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
6499 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
6500 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
6501 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
6502 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
6503 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
6504 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
6505 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
6506 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
6507 [1.8h]: https://github.com/rust-lang/rust/pull/31460
6508 [1.8l]: https://github.com/rust-lang/rust/pull/31668
6509 [1.8m]: https://github.com/rust-lang/rust/pull/31020
6510 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
6511 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
6512 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
6513 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
6514 [1.8n]: https://github.com/rust-lang/rust/pull/31056
6515 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
6516 [1.8r]: https://github.com/rust-lang/rust/pull/31551
6517 [1.8so]: https://github.com/rust-lang/rust/pull/31333
6518 [1.8st]: https://github.com/rust-lang/rust/pull/29520
6519 [1.8t]: https://github.com/rust-lang/rust/pull/31358
6520 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
6521 [1.8u]: https://github.com/rust-lang/rust/pull/31793
6522 [1.8v]: https://github.com/rust-lang/rust/pull/31757
6523 [1.8w]: https://github.com/rust-lang/rust/pull/31904
6524 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
6525 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
6526 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
6527 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
6528 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
6529 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
6530 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
6531 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
6532 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
6533 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
6534 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
6535 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
6536 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
6537 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
6538 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
6539 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
6540 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
6541 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
6542 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
6543 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
6544 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
6545 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
6546 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
6547 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
6548 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
6549 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
6550 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
6551 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
6552 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
6553 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
6554
6555
6556 Version 1.7.0 (2016-03-03)
6557 ==========================
6558
6559 Libraries
6560 ---------
6561
6562 * Stabilized APIs
6563   * `Path`
6564     * [`Path::strip_prefix`] (renamed from relative_from)
6565     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
6566   * `Ipv4Addr`
6567     * [`Ipv4Addr::is_loopback`]
6568     * [`Ipv4Addr::is_private`]
6569     * [`Ipv4Addr::is_link_local`]
6570     * [`Ipv4Addr::is_multicast`]
6571     * [`Ipv4Addr::is_broadcast`]
6572     * [`Ipv4Addr::is_documentation`]
6573   * `Ipv6Addr`
6574     * [`Ipv6Addr::is_unspecified`]
6575     * [`Ipv6Addr::is_loopback`]
6576     * [`Ipv6Addr::is_multicast`]
6577   * `Vec`
6578     * [`Vec::as_slice`]
6579     * [`Vec::as_mut_slice`]
6580   * `String`
6581     * [`String::as_str`]
6582     * [`String::as_mut_str`]
6583   * Slices
6584     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
6585     be the same length
6586     * `<[T]>::`[`sort_by_key`]
6587   * checked, saturated, and overflowing operations
6588     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
6589     * [`i32::saturating_mul`]
6590     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
6591     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
6592     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
6593     * [`u32::saturating_mul`]
6594     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
6595     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
6596     * and checked, saturated, and overflowing operations for other primitive types
6597   * FFI
6598     * [`ffi::IntoStringError`]
6599     * [`CString::into_string`]
6600     * [`CString::into_bytes`]
6601     * [`CString::into_bytes_with_nul`]
6602     * `From<CString> for Vec<u8>`
6603   * `IntoStringError`
6604     * [`IntoStringError::into_cstring`]
6605     * [`IntoStringError::utf8_error`]
6606     * `Error for IntoStringError`
6607   * Hashing
6608     * [`std::hash::BuildHasher`]
6609     * [`BuildHasher::Hasher`]
6610     * [`BuildHasher::build_hasher`]
6611     * [`std::hash::BuildHasherDefault`]
6612     * [`HashMap::with_hasher`]
6613     * [`HashMap::with_capacity_and_hasher`]
6614     * [`HashSet::with_hasher`]
6615     * [`HashSet::with_capacity_and_hasher`]
6616     * [`std::collections::hash_map::RandomState`]
6617     * [`RandomState::new`]
6618 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
6619   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
6620   from bytes is faster.
6621 * [The performance of `LineWriter` (and thus `io::stdout`) was
6622   improved by using `memchr` to search for newlines][1.7m].
6623 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
6624   `f64` variants were stabilized previously.
6625 * [`BTreeMap` was rewritten to use less memory and improve the performance
6626   of insertion and iteration, the latter by as much as 5x][1.7bm].
6627 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
6628   covariant over their contained type][1.7bt].
6629 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
6630   over their contained type][1.7ll].
6631 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
6632   searching methods.
6633 * [`Any` is implemented for unsized types][1.7a].
6634 * [`Hash` is implemented for `Duration`][1.7h].
6635
6636 Misc
6637 ----
6638
6639 * [When running tests with `--test`, rustdoc will pass `--cfg`
6640   arguments to the compiler][1.7dt].
6641 * [The compiler is built with RPATH information by default][1.7rpa].
6642   This means that it will be possible to run `rustc` when installed in
6643   unusual configurations without configuring the dynamic linker search
6644   path explicitly.
6645 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
6646   any RPATH entries (emitted with `-C rpath`) *not* take precedence
6647   over `LD_LIBRARY_PATH`.
6648
6649 Cargo
6650 -----
6651
6652 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
6653   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
6654 * [The `rerun-if-changed` build script directive no longer causes the
6655   build script to incorrectly run twice in certain scenarios][1.7rr].
6656
6657 Compatibility Notes
6658 -------------------
6659
6660 * Soundness fixes to the interactions between associated types and
6661   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
6662   code that violates the new rules. This is a significant change that
6663   is known to break existing code, so it has emitted warnings for the
6664   new error cases since 1.4 to give crate authors time to adapt. The
6665   details of what is changing are subtle; read the RFC for more.
6666 * [Several bugs in the compiler's visibility calculations were
6667   fixed][1.7v]. Since this was found to break significant amounts of
6668   code, the new errors will be emitted as warnings for several release
6669   cycles, under the `private_in_public` lint.
6670 * Defaulted type parameters were accidentally accepted in positions
6671   that were not intended. In this release, [defaulted type parameters
6672   appearing outside of type definitions will generate a
6673   warning][1.7d], which will become an error in future releases.
6674 * [Parsing "." as a float results in an error instead of 0][1.7p].
6675   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
6676 * [Borrows of closure parameters may not outlive the closure][1.7bc].
6677
6678 [1.7a]: https://github.com/rust-lang/rust/pull/30928
6679 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
6680 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
6681 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
6682 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
6683 [1.7d]: https://github.com/rust-lang/rust/pull/30724
6684 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
6685 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
6686 [1.7f]: https://github.com/rust-lang/rust/pull/30672
6687 [1.7h]: https://github.com/rust-lang/rust/pull/30818
6688 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
6689 [1.7m]: https://github.com/rust-lang/rust/pull/30381
6690 [1.7p]: https://github.com/rust-lang/rust/pull/30681
6691 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
6692 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
6693 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
6694 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
6695 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
6696 [1.7v]: https://github.com/rust-lang/rust/pull/29973
6697 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6698 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6699 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
6700 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
6701 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
6702 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
6703 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
6704 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
6705 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
6706 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
6707 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
6708 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
6709 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
6710 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
6711 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
6712 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
6713 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
6714 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
6715 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
6716 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
6717 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
6718 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
6719 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
6720 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
6721 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
6722 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
6723 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
6724 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
6725 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
6726 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
6727 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
6728 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
6729 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
6730 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
6731 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
6732 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
6733 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
6734 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
6735 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
6736 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
6737 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
6738 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
6739 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
6740 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
6741 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
6742 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
6743 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
6744 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6745 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
6746 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6747 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
6748 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
6749 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
6750 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
6751 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
6752 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
6753 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
6754 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
6755 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
6756 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
6757
6758
6759 Version 1.6.0 (2016-01-21)
6760 ==========================
6761
6762 Language
6763 --------
6764
6765 * The `#![no_std]` attribute causes a crate to not be linked to the
6766   standard library, but only the [core library][1.6co], as described
6767   in [RFC 1184]. The core library defines common types and traits but
6768   has no platform dependencies whatsoever, and is the basis for Rust
6769   software in environments that cannot support a full port of the
6770   standard library, such as operating systems. Most of the core
6771   library is now stable.
6772
6773 Libraries
6774 ---------
6775
6776 * Stabilized APIs:
6777   [`Read::read_exact`],
6778   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
6779   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
6780   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
6781   [`os::unix::fs::DirBuilderExt`],
6782   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
6783   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
6784   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
6785   [`collections::hash_map::Drain`],
6786   [`collections::hash_map::HashMap::drain`],
6787   [`collections::hash_set::Drain`],
6788   [`collections::hash_set::HashSet::drain`],
6789   [`collections::binary_heap::Drain`],
6790   [`collections::binary_heap::BinaryHeap::drain`],
6791   [`Vec::extend_from_slice`] (renamed from `push_all`),
6792   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
6793   [`RwLock::into_inner`],
6794   [`Iterator::min_by_key`] (renamed from `min_by`),
6795   [`Iterator::max_by_key`] (renamed from `max_by`).
6796 * The [core library][1.6co] is stable, as are most of its APIs.
6797 * [The `assert_eq!` macro supports arguments that don't implement
6798   `Sized`][1.6ae], such as arrays. In this way it behaves more like
6799   `assert!`.
6800 * Several timer functions that take duration in milliseconds [are
6801   deprecated in favor of those that take `Duration`][1.6ms]. These
6802   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
6803   `thread::park_timeout_ms`.
6804 * The algorithm by which `Vec` reserves additional elements was
6805   [tweaked to not allocate excessive space][1.6a] while still growing
6806   exponentially.
6807 * `From` conversions are [implemented from integers to floats][1.6f]
6808   in cases where the conversion is lossless. Thus they are not
6809   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
6810   or `f64`. They are also not implemented for `isize` and `usize`
6811   because the implementations would be platform-specific. `From` is
6812   also implemented from `f32` to `f64`.
6813 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
6814 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
6815 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
6816 * [`BinaryHeap` was refactored][1.6bh] for modest performance
6817   improvements.
6818 * Sorting slices that are already sorted [is 50% faster in some
6819   cases][1.6s].
6820
6821 Cargo
6822 -----
6823
6824 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
6825 * Cargo build scripts can specify their dependencies by emitting the
6826   [`rerun-if-changed`][1.6rr] key.
6827 * crates.io will reject publication of crates with dependencies that
6828   have a wildcard version constraint. Crates with wildcard
6829   dependencies were seen to cause a variety of problems, as described
6830   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
6831   warning.
6832 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
6833   release folder.  A variety of artifacts that Cargo failed to clean
6834   are now correctly deleted.
6835
6836 Misc
6837 ----
6838
6839 * The `unreachable_code` lint [warns when a function call's argument
6840   diverges][1.6dv].
6841 * The parser indicates [failures that may be caused by
6842   confusingly-similar Unicode characters][1.6uc]
6843 * Certain macro errors [are reported at definition time][1.6m], not
6844   expansion.
6845
6846 Compatibility Notes
6847 -------------------
6848
6849 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
6850   environment variable when locating crates. This was a pre-cargo
6851   feature for integrating with the package manager that was
6852   accidentally never removed.
6853 * [A number of bugs were fixed in the privacy checker][1.6p] that
6854   could cause previously-accepted code to break.
6855 * [Modules and unit/tuple structs may not share the same name][1.6ts].
6856 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
6857   struct pattern syntax (`Foo(..)`) can no longer be used to match
6858   unit structs. This is a warning now, but will become an error in
6859   future releases. Patterns that share the same name as a const are
6860   now an error.
6861 * A bug was fixed that causes [rustc not to apply default type
6862   parameters][1.6xc] when resolving certain method implementations of
6863   traits defined in other crates.
6864
6865 [1.6a]: https://github.com/rust-lang/rust/pull/29454
6866 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
6867 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
6868 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
6869 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
6870 [1.6co]: http://doc.rust-lang.org/core/index.html
6871 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
6872 [1.6f]: https://github.com/rust-lang/rust/pull/29129
6873 [1.6m]: https://github.com/rust-lang/rust/pull/29828
6874 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
6875 [1.6p]: https://github.com/rust-lang/rust/pull/29726
6876 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
6877 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
6878 [1.6s]: https://github.com/rust-lang/rust/pull/29675
6879 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
6880 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
6881 [1.6us]: https://github.com/rust-lang/rust/pull/29383
6882 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
6883 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
6884 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6885 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
6886 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
6887 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
6888 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
6889 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
6890 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
6891 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
6892 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
6893 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
6894 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
6895 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
6896 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
6897 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
6898 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
6899 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
6900 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
6901 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
6902 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
6903 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
6904 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
6905 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
6906 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
6907 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
6908 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
6909 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
6910 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
6911 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
6912
6913
6914 Version 1.5.0 (2015-12-10)
6915 ==========================
6916
6917 * ~700 changes, numerous bugfixes
6918
6919 Highlights
6920 ----------
6921
6922 * Stabilized APIs:
6923   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
6924   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
6925   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
6926   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
6927   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
6928   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
6929   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
6930   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
6931   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
6932   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
6933   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
6934   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
6935   [`Path::read_link`], [`Path::symlink_metadata`],
6936   [`Utf8Error::valid_up_to`], [`Vec::resize`],
6937   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
6938   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
6939   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
6940   [`slice::split_first_mut`], [`slice::split_first`],
6941   [`slice::split_last_mut`], [`slice::split_last`],
6942   [`char::from_u32_unchecked`], [`fs::canonicalize`],
6943   [`str::MatchIndices`], [`str::RMatchIndices`],
6944   [`str::match_indices`], [`str::rmatch_indices`],
6945   [`str::slice_mut_unchecked`], [`string::ParseError`].
6946 * Rust applications hosted on crates.io can be installed locally to
6947   `~/.cargo/bin` with the [`cargo install`] command. Among other
6948   things this makes it easier to augment Cargo with new subcommands:
6949   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
6950   invoked as `cargo foo`.
6951 * Crates with wildcard (`*`) dependencies will [emit warnings when
6952   published][1.5w]. In 1.6 it will no longer be possible to publish
6953   crates with wildcard dependencies.
6954
6955 Breaking Changes
6956 ----------------
6957
6958 * The rules determining when a particular lifetime must outlive
6959   a particular value (known as '[dropck]') have been [modified
6960   to not rely on parametricity][1.5p].
6961 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
6962   and `Arc`][1.5a]. Because these smart pointer types implement
6963   `Deref`, this causes breakage in cases where the interior type
6964   contains methods of the same name.
6965 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
6966   that they could drop their content. Soundness fix.
6967 * All method invocations are [properly checked][1.5wf1] for
6968   [well-formedness][1.5wf2]. Soundness fix.
6969 * Traits whose supertraits contain `Self` are [not object
6970   safe][1.5o]. Soundness fix.
6971 * Target specifications support a [`no_default_libraries`][1.5nd]
6972   setting that controls whether `-nodefaultlibs` is passed to the
6973   linker, and in turn the `is_like_windows` setting no longer affects
6974   the `-nodefaultlibs` flag.
6975 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
6976 * The `#[inline]` and `#[repr]` attributes [can only appear
6977   in valid locations][1.5at].
6978 * Native libraries linked from the local crate are [passed to
6979   the linker before native libraries from upstream crates][1.5nl].
6980 * Two rarely-used attributes, `#[no_debug]` and
6981   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
6982 * Negation of unsigned integers, which has been a warning for
6983   several releases, [is now behind a feature gate and will
6984   generate errors][1.5nu].
6985 * The parser accidentally accepted visibility modifiers on
6986   enum variants, a bug [which has been fixed][1.5ev].
6987 * [A bug was fixed that allowed `use` statements to import unstable
6988   features][1.5use].
6989
6990 Language
6991 --------
6992
6993 * When evaluating expressions at compile-time that are not
6994   compile-time constants (const-evaluating expressions in non-const
6995   contexts), incorrect code such as overlong bitshifts and arithmetic
6996   overflow will [generate a warning instead of an error][1.5ce],
6997   delaying the error until runtime. This will allow the
6998   const-evaluator to be expanded in the future backwards-compatibly.
6999 * The `improper_ctypes` lint [no longer warns about using `isize` and
7000   `usize` in FFI][1.5ict].
7001
7002 Libraries
7003 ---------
7004
7005 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
7006   invariant][1.5c].
7007 * `Default` is [implemented for mutable slices][1.5d].
7008 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
7009 * There are now `From` conversions [between floating point
7010   types][1.5f] where the conversions are lossless.
7011 * There are now `From` conversions [between integer types][1.5i] where
7012   the conversions are lossless.
7013 * [`fs::Metadata` implements `Clone`][1.5fs].
7014 * The `parse` method [accepts a leading "+" when parsing
7015   integers][1.5pi].
7016 * [`AsMut` is implemented for `Vec`][1.5am].
7017 * The `clone_from` implementations for `String` and `BinaryHeap` [have
7018   been optimized][1.5cf] and no longer rely on the default impl.
7019 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
7020   `unsafe extern "C"` function types now [implement `Clone`,
7021   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
7022   `fmt::Debug` for up to 12 arguments][1.5fp].
7023 * [Dropping `Vec`s is much faster in unoptimized builds when the
7024   element types don't implement `Drop`][1.5dv].
7025 * A bug that caused in incorrect behavior when [combining `VecDeque`
7026   with zero-sized types][1.5vdz] was resolved.
7027 * [`PartialOrd` for slices is faster][1.5po].
7028
7029 Miscellaneous
7030 -------------
7031
7032 * [Crate metadata size was reduced by 20%][1.5md].
7033 * [Improvements to code generation reduced the size of libcore by 3.3
7034   MB and rustc's memory usage by 18MB][1.5m].
7035 * [Improvements to deref translation increased performance in
7036   unoptimized builds][1.5dr].
7037 * Various errors in trait resolution [are deduplicated to only be
7038   reported once][1.5te].
7039 * Rust has preliminary [support for rumprun kernels][1.5rr].
7040 * Rust has preliminary [support for NetBSD on amd64][1.5na].
7041
7042 [1.5use]: https://github.com/rust-lang/rust/pull/28364
7043 [1.5po]: https://github.com/rust-lang/rust/pull/28436
7044 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
7045 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
7046 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
7047 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
7048 [1.5md]: https://github.com/rust-lang/rust/pull/28521
7049 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
7050 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
7051 [1.5na]: https://github.com/rust-lang/rust/pull/28543
7052 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
7053 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
7054 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
7055 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
7056 [1.5te]: https://github.com/rust-lang/rust/pull/28645
7057 [1.5at]: https://github.com/rust-lang/rust/pull/28650
7058 [1.5am]: https://github.com/rust-lang/rust/pull/28663
7059 [1.5m]: https://github.com/rust-lang/rust/pull/28778
7060 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
7061 [1.5a]: https://github.com/rust-lang/rust/pull/28811
7062 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
7063 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
7064 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
7065 [1.5i]: https://github.com/rust-lang/rust/pull/28921
7066 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
7067 [1.5f]: https://github.com/rust-lang/rust/pull/29129
7068 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
7069 [1.5s]: https://github.com/rust-lang/rust/pull/29190
7070 [1.5d]: https://github.com/rust-lang/rust/pull/29245
7071 [1.5o]: https://github.com/rust-lang/rust/pull/29259
7072 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
7073 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7074 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
7075 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
7076 [1.5c]: https://github.com/rust-lang/rust/pull/29110
7077 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7078 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
7079 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
7080 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
7081 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
7082 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
7083 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
7084 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
7085 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
7086 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
7087 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
7088 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
7089 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
7090 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
7091 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
7092 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
7093 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
7094 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
7095 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
7096 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
7097 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
7098 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
7099 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
7100 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
7101 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
7102 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
7103 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
7104 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
7105 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
7106 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
7107 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
7108 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
7109 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
7110 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
7111 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
7112 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
7113 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
7114 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
7115 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
7116 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
7117 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
7118 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
7119 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
7120 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
7121 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
7122 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
7123 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
7124 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
7125 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
7126 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
7127 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
7128 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
7129 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
7130 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
7131
7132 Version 1.4.0 (2015-10-29)
7133 ==========================
7134
7135 * ~1200 changes, numerous bugfixes
7136
7137 Highlights
7138 ----------
7139
7140 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
7141   GNU) are now supported and recommended for use.
7142
7143 Breaking Changes
7144 ----------------
7145
7146 * [Several changes have been made to fix type soundness and improve
7147   the behavior of associated types][sound]. See [RFC 1214]. Although
7148   we have mostly introduced these changes as warnings this release, to
7149   become errors next release, there are still some scenarios that will
7150   see immediate breakage.
7151 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
7152   line breaks in addition to `\n`][crlf].
7153 * [Loans of `'static` lifetime extend to the end of a function][stat].
7154 * [`str::parse` no longer introduces avoidable rounding error when
7155   parsing floating point numbers. Together with earlier changes to
7156   float formatting/output, "round trips" like f.to_string().parse()
7157   now preserve the value of f exactly. Additionally, leading plus
7158   signs are now accepted][fp3].
7159
7160
7161 Language
7162 --------
7163
7164 * `use` statements that import multiple items [can now rename
7165   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
7166 * [Binops work correctly on fat pointers][binfat].
7167 * `pub extern crate`, which does not behave as expected, [issues a
7168   warning][pec] until a better solution is found.
7169
7170 Libraries
7171 ---------
7172
7173 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
7174   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
7175   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
7176   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
7177   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
7178   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
7179   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
7180   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
7181   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
7182   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
7183   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
7184   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
7185   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
7186   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
7187   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
7188   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
7189   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
7190   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
7191   [`thread::sleep`].
7192 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
7193   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
7194   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
7195   `f64::from_str_radix`.
7196 * [Reverse-searching strings is faster with the 'two-way'
7197   algorithm][s].
7198 * [`std::io::copy` allows `?Sized` arguments][cc].
7199 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
7200   [override `count`, `nth` and `last` with an O(1)
7201   implementation][it].
7202 * [`Default` is implemented for arrays up to `[T; 32]`][d].
7203 * [`IntoRawFd` has been added to the Unix-specific prelude,
7204   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
7205   prelude][pr].
7206 * [`Extend<String>` and `FromIterator<String` are both implemented for
7207   `String`][es].
7208 * [`IntoIterator` is implemented for references to `Option` and
7209   `Result`][into2].
7210 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
7211   Copy`][ext] as part of [RFC 839]. This will cause type inference
7212   breakage in rare situations.
7213 * [`BinaryHeap` implements `Debug`][bh2].
7214 * [`Borrow` and `BorrowMut` are implemented for fixed-size
7215   arrays][bm].
7216 * [`extern fn`s with the "Rust" and "C" ABIs implement common
7217   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
7218 * [String comparison is faster][faststr].
7219 * `&mut T` where `T: std::fmt::Write` [also implements
7220   `std::fmt::Write`][mutw].
7221 * [A stable regression in `VecDeque::push_back` and other
7222   capacity-altering methods that caused panics for zero-sized types
7223   was fixed][vd].
7224 * [Function pointers implement traits for up to 12 parameters][fp2].
7225
7226 Miscellaneous
7227 -------------
7228
7229 * The compiler [no longer uses the 'morestack' feature to prevent
7230   stack overflow][mm]. Instead it uses guard pages and stack
7231   probes (though stack probes are not yet implemented on any platform
7232   but Windows).
7233 * [The compiler matches traits faster when projections are involved][p].
7234 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
7235   `usize`][ffi].
7236 * [Cargo now displays useful information about what its doing during
7237   `cargo update`][cu].
7238
7239 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
7240 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
7241 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
7242 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
7243 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
7244 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
7245 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
7246 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
7247 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
7248 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
7249 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
7250 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
7251 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
7252 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
7253 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
7254 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
7255 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
7256 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
7257 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7258 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7259 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7260 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7261 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7262 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7263 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7264 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7265 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
7266 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
7267 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
7268 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
7269 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
7270 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
7271 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
7272 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
7273 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
7274 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
7275 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
7276 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
7277 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
7278 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
7279 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
7280 [bh2]: https://github.com/rust-lang/rust/pull/28156
7281 [binfat]: https://github.com/rust-lang/rust/pull/28270
7282 [bm]: https://github.com/rust-lang/rust/pull/28197
7283 [cc]: https://github.com/rust-lang/rust/pull/27531
7284 [crlf]: https://github.com/rust-lang/rust/pull/28034
7285 [cu]: https://github.com/rust-lang/cargo/pull/1931
7286 [d]: https://github.com/rust-lang/rust/pull/27825
7287 [dep]: https://github.com/rust-lang/rust/pull/28339
7288 [es]: https://github.com/rust-lang/rust/pull/27956
7289 [ext]: https://github.com/rust-lang/rust/pull/28094
7290 [faststr]: https://github.com/rust-lang/rust/pull/28338
7291 [ffi]: https://github.com/rust-lang/rust/pull/28779
7292 [fp]: https://github.com/rust-lang/rust/pull/28268
7293 [fp2]: https://github.com/rust-lang/rust/pull/28560
7294 [fp3]: https://github.com/rust-lang/rust/pull/27307
7295 [i]: https://github.com/rust-lang/rust/pull/27451
7296 [into2]: https://github.com/rust-lang/rust/pull/28039
7297 [it]: https://github.com/rust-lang/rust/pull/27652
7298 [mm]: https://github.com/rust-lang/rust/pull/27338
7299 [mutw]: https://github.com/rust-lang/rust/pull/28368
7300 [sound]: https://github.com/rust-lang/rust/pull/27641
7301 [p]: https://github.com/rust-lang/rust/pull/27866
7302 [pec]: https://github.com/rust-lang/rust/pull/28486
7303 [pr]: https://github.com/rust-lang/rust/pull/27896
7304 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7305 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7306 [s]: https://github.com/rust-lang/rust/pull/27474
7307 [stab]: https://github.com/rust-lang/rust/pull/28339
7308 [stat]: https://github.com/rust-lang/rust/pull/28321
7309 [vd]: https://github.com/rust-lang/rust/pull/28494
7310
7311 Version 1.3.0 (2015-09-17)
7312 ==============================
7313
7314 * ~900 changes, numerous bugfixes
7315
7316 Highlights
7317 ----------
7318
7319 * The [new object lifetime defaults][nold] have been [turned
7320   on][nold2] after a cycle of warnings about the change. Now types
7321   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
7322   being interpreted as `&'a Box<Trait+'a>` to `&'a
7323   Box<Trait+'static>`.
7324 * [The Rustonomicon][nom] is a new book in the official documentation
7325   that dives into writing unsafe Rust.
7326 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
7327   timekeeping is employed by other std APIs, as well as out-of-tree
7328   time crates.
7329
7330 Breaking Changes
7331 ----------------
7332
7333 * The [new object lifetime defaults][nold] have been [turned
7334   on][nold2] after a cycle of warnings about the change.
7335 * There is a known [regression][lr] in how object lifetime elision is
7336   interpreted, the proper solution for which is undetermined.
7337 * The `#[prelude_import]` attribute, an internal implementation
7338   detail, was accidentally stabilized previously. [It has been put
7339   behind the `prelude_import` feature gate][pi]. This change is
7340   believed to break no existing code.
7341 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7342   [more sane for dynamically sized types][dst3]. Code that relied on
7343   the previous behavior is thought to be broken.
7344 * The `dropck` rules, which checks that destructors can't access
7345   destroyed values, [have been updated][dropck] to match the
7346   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
7347   cause some previously-compiling code to no longer build.
7348
7349 Language
7350 --------
7351
7352 * The [new object lifetime defaults][nold] have been [turned
7353   on][nold2] after a cycle of warnings about the change.
7354 * Semicolons may [now follow types and paths in
7355   macros](https://github.com/rust-lang/rust/pull/27000).
7356 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7357   [more sane for dynamically sized types][dst3]. Code that relied on
7358   the previous behavior is not known to exist, and suspected to be
7359   broken.
7360 * `'static` variables [may now be recursive][st].
7361 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
7362   implementations correctly.
7363 * The `dropck` rules, which checks that destructors can't access
7364   destroyed values, [have been updated][dropck] to match the
7365   [RFC][dropckrfc].
7366
7367 Libraries
7368 ---------
7369
7370 * The [`Duration`] API, [has been stabilized][ds], as well as the
7371   `std::time` module, which presently contains only `Duration`.
7372 * `Box<str>` and `Box<[T]>` both implement `Clone`.
7373 * The owned C string, [`CString`], implements [`Borrow`] and the
7374   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
7375   these allow C strings to be borrowed and cloned in generic code.
7376 * [`CStr`] implements [`Debug`].
7377 * [`AtomicPtr`] implements [`Debug`].
7378 * [`Error`] trait objects [can be downcast to their concrete types][e]
7379   in many common configurations, using the [`is`], [`downcast`],
7380   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
7381   [`Any`] trait.
7382 * Searching for substrings now [employs the two-way algorithm][search]
7383   instead of doing a naive search. This gives major speedups to a
7384   number of methods, including [`contains`][sc], [`find`][sf],
7385   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
7386   [`ends_with`][sew] are also faster.
7387 * The performance of `PartialEq` for slices is [much faster][ps].
7388 * The [`Hash`] trait offers the default method, [`hash_slice`], which
7389   is overridden and optimized by the implementations for scalars.
7390 * The [`Hasher`] trait now has a number of specialized `write_*`
7391   methods for primitive types, for efficiency.
7392 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
7393   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
7394   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
7395   of [`std::error::Error::cause`][iec] also delegates to the inner
7396   error.
7397 * [`process::Child`][pc] gained the [`id`] method, which returns a
7398   `u32` representing the platform-specific process identifier.
7399 * The [`connect`] method on slices is deprecated, replaced by the new
7400   [`join`] method (note that both of these are on the *unstable*
7401   [`SliceConcatExt`] trait, but through the magic of the prelude are
7402   available to stable code anyway).
7403 * The [`Div`] operator is implemented for [`Wrapping`] types.
7404 * [`DerefMut` is implemented for `String`][dms].
7405 * Performance of SipHash (the default hasher for `HashMap`) is
7406   [better for long data][sh].
7407 * [`AtomicPtr`] implements [`Send`].
7408 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
7409   are now [specialized to use uninitialized buffers for increased
7410   performance][rte].
7411 * Lifetime parameters of foreign functions [are now resolved
7412   properly][f].
7413
7414 Misc
7415 ----
7416
7417 * Rust can now, with some coercion, [produce programs that run on
7418   Windows XP][xp], though XP is not considered a supported platform.
7419 * Porting Rust on Windows from the GNU toolchain to MSVC continues
7420   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
7421   recommended for use in 1.3, though should be fully-functional
7422   in the [64-bit 1.4 beta][b14].
7423 * On Fedora-based systems installation will [properly configure the
7424   dynamic linker][fl].
7425 * The compiler gained many new extended error descriptions, which can
7426   be accessed with the `--explain` flag.
7427 * The `dropck` pass, which checks that destructors can't access
7428   destroyed values, [has been rewritten][dropck]. This fixes some
7429   soundness holes, and as such will cause some previously-compiling
7430   code to no longer build.
7431 * `rustc` now uses [LLVM to write archive files where possible][ar].
7432   Eventually this will eliminate the compiler's dependency on the ar
7433   utility.
7434 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
7435   supported FreeBSD on x86_64).
7436 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
7437   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
7438   more strict.
7439 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
7440   will kill the process instead of leaking][nlp].
7441
7442 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
7443 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
7444 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
7445 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
7446 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
7447 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7448 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7449 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
7450 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
7451 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
7452 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
7453 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
7454 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
7455 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7456 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
7457 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
7458 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
7459 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
7460 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7461 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
7462 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
7463 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
7464 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
7465 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7466 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
7467 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
7468 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
7469 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
7470 [ar]: https://github.com/rust-lang/rust/pull/26926
7471 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
7472 [dms]: https://github.com/rust-lang/rust/pull/26241
7473 [dropck]: https://github.com/rust-lang/rust/pull/27261
7474 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7475 [ds]: https://github.com/rust-lang/rust/pull/26818
7476 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
7477 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
7478 [dst3]: https://github.com/rust-lang/rust/pull/27351
7479 [e]: https://github.com/rust-lang/rust/pull/24793
7480 [f]: https://github.com/rust-lang/rust/pull/26588
7481 [fb]: https://github.com/rust-lang/rust/pull/26959
7482 [fl]: https://github.com/rust-lang/rust-installer/pull/41
7483 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7484 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
7485 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
7486 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
7487 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
7488 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
7489 [lic]: https://github.com/rust-lang/rust/pull/26583
7490 [lnu]: https://github.com/rust-lang/rust/pull/27026
7491 [lr]: https://github.com/rust-lang/rust/issues/27248
7492 [lum]: https://github.com/rust-lang/rust/pull/26378
7493 [lur]: https://github.com/rust-lang/rust/pull/26783
7494 [nlp]: https://github.com/rust-lang/rust/pull/27176
7495 [nold2]: https://github.com/rust-lang/rust/pull/27045
7496 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
7497 [nom]: http://doc.rust-lang.org/nightly/nomicon/
7498 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
7499 [pi]: https://github.com/rust-lang/rust/pull/26699
7500 [ps]: https://github.com/rust-lang/rust/pull/26884
7501 [rte]: https://github.com/rust-lang/rust/pull/26950
7502 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
7503 [search]: https://github.com/rust-lang/rust/pull/26327
7504 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
7505 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
7506 [sh]: https://github.com/rust-lang/rust/pull/27280
7507 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
7508 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
7509 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
7510 [st]: https://github.com/rust-lang/rust/pull/26630
7511 [win1]: https://github.com/rust-lang/rust/pull/26569
7512 [win2]: https://github.com/rust-lang/rust/pull/26741
7513 [win3]: https://github.com/rust-lang/rust/pull/26741
7514 [win4]: https://github.com/rust-lang/rust/pull/27210
7515 [xp]: https://github.com/rust-lang/rust/pull/26569
7516
7517 Version 1.2.0 (2015-08-07)
7518 ==========================
7519
7520 * ~1200 changes, numerous bugfixes
7521
7522 Highlights
7523 ----------
7524
7525 * [Dynamically-sized-type coercions][dst] allow smart pointer types
7526   like `Rc` to contain types without a fixed size, arrays and trait
7527   objects, finally enabling use of `Rc<[T]>` and completing the
7528   implementation of DST.
7529 * [Parallel codegen][parcodegen] is now working again, which can
7530   substantially speed up large builds in debug mode; It also gets
7531   another ~33% speedup when bootstrapping on a 4 core machine (using 8
7532   jobs). It's not enabled by default, but will be "in the near
7533   future". It can be activated with the `-C codegen-units=N` flag to
7534   `rustc`.
7535 * This is the first release with [experimental support for linking
7536   with the MSVC linker and lib C on Windows (instead of using the GNU
7537   variants via MinGW)][win]. It is yet recommended only for the most
7538   intrepid Rustaceans.
7539 * Benchmark compilations are showing a 30% improvement in
7540   bootstrapping over 1.1.
7541
7542 Breaking Changes
7543 ----------------
7544
7545 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
7546   unicode case mapping, which is a previously-planned change in
7547   behavior and considered a bugfix.
7548 * [`mem::align_of`] now specifies [the *minimum alignment* for
7549   T][align], which is usually the alignment programs are interested
7550   in, and the same value reported by clang's
7551   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
7552   break real code.
7553 * [The `#[packed]` attribute is no longer silently accepted by the
7554   compiler][packed]. This attribute did nothing and code that
7555   mentioned it likely did not work as intended.
7556 * Associated type defaults are [now behind the
7557   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
7558   defaults *did not work*, but could be mentioned syntactically. As
7559   such this breakage has minimal impact.
7560
7561 Language
7562 --------
7563
7564 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
7565   matching against dereferenceable values.
7566
7567 Libraries
7568 ---------
7569
7570 * The [`Extend`] trait, which grows a collection from an iterator, is
7571   implemented over iterators of references, for `String`, `Vec`,
7572   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
7573   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
7574 * The [`iter::once`] function returns an iterator that yields a single
7575   element, and [`iter::empty`] returns an iterator that yields no
7576   elements.
7577 * The [`matches`] and [`rmatches`] methods on `str` return iterators
7578   over substring matches.
7579 * [`Cell`] and [`RefCell`] both implement `Eq`.
7580 * A number of methods for wrapping arithmetic are added to the
7581   integral types, [`wrapping_div`], [`wrapping_rem`],
7582   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
7583   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
7584   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
7585   type.. It is illegal for the default arithmetic operations in Rust
7586   to overflow; the desire to wrap must be explicit.
7587 * The `{:#?}` formatting specifier [displays the alternate,
7588   pretty-printed][debugfmt] form of the `Debug` formatter. This
7589   feature was actually introduced prior to 1.0 with little
7590   fanfare.
7591 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
7592   for writing data to formatted strings, similar to [`io::Write`].
7593 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
7594   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
7595   are used by code generators to emit implementations of [`Debug`].
7596 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
7597   methods that convert case, following Unicode case mapping.
7598 * It is now easier to handle poisoned locks. The [`PoisonError`]
7599   type, returned by failing lock operations, exposes `into_inner`,
7600   `get_ref`, and `get_mut`, which all give access to the inner lock
7601   guard, and allow the poisoned lock to continue to operate. The
7602   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
7603   poisoned lock without attempting to take the lock.
7604 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
7605   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
7606   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
7607   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
7608   `ChildStderr`.
7609 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
7610   malformed input.
7611
7612 Misc
7613 ----
7614
7615 * `rustc` employs smarter heuristics for guessing at [typos].
7616 * `rustc` emits more efficient code for [no-op conversions between
7617   unsafe pointers][nop].
7618 * Fat pointers are now [passed in pairs of immediate arguments][fat],
7619   resulting in faster compile times and smaller code.
7620
7621 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
7622 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7623 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
7624 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
7625 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
7626 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
7627 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
7628 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
7629 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
7630 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
7631 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
7632 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
7633 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
7634 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
7635 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
7636 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
7637 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7638 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
7639 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
7640 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
7641 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
7642 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
7643 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
7644 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
7645 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
7646 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7647 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
7648 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
7649 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
7650 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
7651 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
7652 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
7653 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
7654 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7655 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7656 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
7657 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
7658 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
7659 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
7660 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
7661 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
7662 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7663 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
7664 [align]: https://github.com/rust-lang/rust/pull/25646
7665 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
7666 [typos]: https://github.com/rust-lang/rust/pull/26087
7667 [nop]: https://github.com/rust-lang/rust/pull/26336
7668 [fat]: https://github.com/rust-lang/rust/pull/26411
7669 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
7670 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
7671 [packed]: https://github.com/rust-lang/rust/pull/25541
7672 [ad]: https://github.com/rust-lang/rust/pull/27382
7673 [win]: https://github.com/rust-lang/rust/pull/25350
7674
7675 Version 1.1.0 (2015-06-25)
7676 =========================
7677
7678 * ~850 changes, numerous bugfixes
7679
7680 Highlights
7681 ----------
7682
7683 * The [`std::fs` module has been expanded][fs] to expand the set of
7684   functionality exposed:
7685   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
7686     don't incur a syscall on some platforms.
7687   * A `symlink_metadata` function has been added.
7688   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
7689     access to all underlying information.
7690 * The compiler now contains extended explanations of many errors. When an error
7691   with an explanation occurs the compiler suggests using the `--explain` flag
7692   to read the explanation. Error explanations are also [available online][err-index].
7693 * Thanks to multiple [improvements][sk] to [type checking][pre], as
7694   well as other work, the time to bootstrap the compiler decreased by
7695   32%.
7696
7697 Libraries
7698 ---------
7699
7700 * The [`str::split_whitespace`] method splits a string on unicode
7701   whitespace boundaries.
7702 * On both Windows and Unix, new extension traits provide conversion of
7703   I/O types to and from the underlying system handles. On Unix, these
7704   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
7705   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
7706   `TcpListener`, and `UpdSocket`. Further implementations for
7707   `std::process` will be stabilized later.
7708 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
7709   Windows, symlinks can be created with
7710   `std::os::windows::symlink_dir` and
7711   `std::os::windows::symlink_file`.
7712 * The `mpsc::Receiver` type can now be converted into an iterator with
7713   `into_iter` on the [`IntoIterator`] trait.
7714 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
7715   implementation of the [`From`] trait.
7716 * The `Debug` implementation for `RangeFull` [creates output that is
7717   more consistent with other implementations][rf].
7718 * [`Debug` is implemented for `File`][file].
7719 * The `Default` implementation for `Arc` [no longer requires `Sync +
7720   Send`][arc].
7721 * [The `Iterator` methods `count`, `nth`, and `last` have been
7722   overridden for slices to have O(1) performance instead of O(n)][si].
7723 * Incorrect handling of paths on Windows has been improved in both the
7724   compiler and the standard library.
7725 * [`AtomicPtr` gained a `Default` implementation][ap].
7726 * In accordance with Rust's policy on arithmetic overflow `abs` now
7727   [panics on overflow when debug assertions are enabled][abs].
7728 * The [`Cloned`] iterator, which was accidentally left unstable for
7729   1.0 [has been stabilized][c].
7730 * The [`Incoming`] iterator, which iterates over incoming TCP
7731   connections, and which was accidentally unnamable in 1.0, [is now
7732   properly exported][inc].
7733 * [`BinaryHeap`] no longer corrupts itself [when functions called by
7734   `sift_up` or `sift_down` panic][bh].
7735 * The [`split_off`] method of `LinkedList` [no longer corrupts
7736   the list in certain scenarios][ll].
7737
7738 Misc
7739 ----
7740
7741 * Type checking performance [has improved notably][sk] with
7742   [multiple improvements][pre].
7743 * The compiler [suggests code changes][ch] for more errors.
7744 * rustc and it's build system have experimental support for [building
7745   toolchains against MUSL][m] instead of glibc on Linux.
7746 * The compiler defines the `target_env` cfg value, which is used for
7747   distinguishing toolchains that are otherwise for the same
7748   platform. Presently this is set to `gnu` for common GNU Linux
7749   targets and for MinGW targets, and `musl` for MUSL Linux targets.
7750 * The [`cargo rustc`][crc] command invokes a build with custom flags
7751   to rustc.
7752 * [Android executables are always position independent][pie].
7753 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
7754   with `Drop`][drop].
7755
7756 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
7757 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7758 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7759 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
7760 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
7761 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
7762 [rf]: https://github.com/rust-lang/rust/pull/24491
7763 [err-index]: https://doc.rust-lang.org/error-index.html
7764 [sk]: https://github.com/rust-lang/rust/pull/24615
7765 [pre]: https://github.com/rust-lang/rust/pull/25323
7766 [file]: https://github.com/rust-lang/rust/pull/24598
7767 [ch]: https://github.com/rust-lang/rust/pull/24683
7768 [arc]: https://github.com/rust-lang/rust/pull/24695
7769 [si]: https://github.com/rust-lang/rust/pull/24701
7770 [ap]: https://github.com/rust-lang/rust/pull/24834
7771 [m]: https://github.com/rust-lang/rust/pull/24777
7772 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
7773 [crc]: https://github.com/rust-lang/cargo/pull/1568
7774 [pie]: https://github.com/rust-lang/rust/pull/24953
7775 [abs]: https://github.com/rust-lang/rust/pull/25441
7776 [c]: https://github.com/rust-lang/rust/pull/25496
7777 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
7778 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
7779 [inc]: https://github.com/rust-lang/rust/pull/25522
7780 [bh]: https://github.com/rust-lang/rust/pull/25856
7781 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
7782 [ll]: https://github.com/rust-lang/rust/pull/26022
7783 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
7784 [drop]: https://github.com/rust-lang/rust/pull/24935
7785
7786 Version 1.0.0 (2015-05-15)
7787 ========================
7788
7789 * ~1500 changes, numerous bugfixes
7790
7791 Highlights
7792 ----------
7793
7794 * The vast majority of the standard library is now `#[stable]`. It is
7795   no longer possible to use unstable features with a stable build of
7796   the compiler.
7797 * Many popular crates on [crates.io] now work on the stable release
7798   channel.
7799 * Arithmetic on basic integer types now [checks for overflow in debug
7800   builds][overflow].
7801
7802 Language
7803 --------
7804
7805 * Several [restrictions have been added to trait coherence][coh] in
7806   order to make it easier for upstream authors to change traits
7807   without breaking downstream code.
7808 * Digits of binary and octal literals are [lexed more eagerly][lex] to
7809   improve error messages and macro behavior. For example, `0b1234` is
7810   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
7811 * Trait bounds [are always invariant][inv], eliminating the need for
7812   the `PhantomFn` and `MarkerTrait` lang items, which have been
7813   removed.
7814 * ["-" is no longer a valid character in crate names][cr], the `extern crate
7815   "foo" as bar` syntax has been replaced with `extern crate foo as
7816   bar`, and Cargo now automatically translates "-" in *package* names
7817   to underscore for the crate name.
7818 * [Lifetime shadowing is an error][lt].
7819 * [`Send` no longer implies `'static`][send-rfc].
7820 * [UFCS now supports trait-less associated paths][moar-ufcs] like
7821   `MyType::default()`.
7822 * Primitive types [now have inherent methods][prim-inherent],
7823   obviating the need for extension traits like `SliceExt`.
7824 * Methods with `Self: Sized` in their `where` clause are [considered
7825   object-safe][self-sized], allowing many extension traits like
7826   `IteratorExt` to be merged into the traits they extended.
7827 * You can now [refer to associated types][assoc-where] whose
7828   corresponding trait bounds appear only in a `where` clause.
7829 * The final bits of [OIBIT landed][oibit-final], meaning that traits
7830   like `Send` and `Sync` are now library-defined.
7831 * A [Reflect trait][reflect] was introduced, which means that
7832   downcasting via the `Any` trait is effectively limited to concrete
7833   types. This helps retain the potentially-important "parametricity"
7834   property: generic code cannot behave differently for different type
7835   arguments except in minor ways.
7836 * The `unsafe_destructor` feature is now deprecated in favor of the
7837   [new `dropck`][dropck]. This change is a major reduction in unsafe
7838   code.
7839
7840 Libraries
7841 ---------
7842
7843 * The `thread_local` module [has been renamed to `std::thread`][th].
7844 * The methods of `IteratorExt` [have been moved to the `Iterator`
7845   trait itself][ie].
7846 * Several traits that implement Rust's conventions for type
7847   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
7848   [centralized in the `std::convert` module][con].
7849 * The `FromError` trait [was removed in favor of `From`][fe].
7850 * The basic sleep function [has moved to
7851   `std::thread::sleep_ms`][slp].
7852 * The `splitn` function now takes an `n` parameter that represents the
7853   number of items yielded by the returned iterator [instead of the
7854   number of 'splits'][spl].
7855 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
7856 * [Derived implementations of `PartialOrd` now order enums according
7857   to their explicitly-assigned discriminants][po].
7858 * [Methods for searching strings are generic over `Pattern`s][pat],
7859   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
7860   some others.
7861 * [In method resolution, object methods are resolved before inherent
7862   methods][meth].
7863 * [`String::from_str` has been deprecated in favor of the `From` impl,
7864   `String::from`][sf].
7865 * [`io::Error` implements `Sync`][ios].
7866 * [The `words` method on `&str` has been replaced with
7867   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
7868   a word?'
7869 * The new path and IO modules are complete and `#[stable]`. This
7870   was the major library focus for this cycle.
7871 * The path API was [revised][path-normalize] to normalize `.`,
7872   adjusting the tradeoffs in favor of the most common usage.
7873 * A large number of remaining APIs in `std` were also stabilized
7874   during this cycle; about 75% of the non-deprecated API surface
7875   is now stable.
7876 * The new [string pattern API][string-pattern] landed, which makes
7877   the string slice API much more internally consistent and flexible.
7878 * A new set of [generic conversion traits][conversion] replaced
7879   many existing ad hoc traits.
7880 * Generic numeric traits were [completely removed][num-traits]. This
7881   was made possible thanks to inherent methods for primitive types,
7882   and the removal gives maximal flexibility for designing a numeric
7883   hierarchy in the future.
7884 * The `Fn` traits are now related via [inheritance][fn-inherit]
7885   and provide ergonomic [blanket implementations][fn-blanket].
7886 * The `Index` and `IndexMut` traits were changed to
7887   [take the index by value][index-value], enabling code like
7888   `hash_map["string"]` to work.
7889 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
7890   `Copy` data is known to be `Clone` as well.
7891
7892 Misc
7893 ----
7894
7895 * Many errors now have extended explanations that can be accessed with
7896   the `--explain` flag to `rustc`.
7897 * Many new examples have been added to the standard library
7898   documentation.
7899 * rustdoc has received a number of improvements focused on completion
7900   and polish.
7901 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
7902 * Much headway was made on ecosystem-wide CI, making it possible
7903   to [compare builds for breakage][ci-compare].
7904
7905
7906 [crates.io]: http://crates.io
7907 [clo]: https://github.com/rust-lang/rust/pull/24034
7908 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
7909 [con]: https://github.com/rust-lang/rust/pull/23875
7910 [cr]: https://github.com/rust-lang/rust/pull/23419
7911 [fe]: https://github.com/rust-lang/rust/pull/23879
7912 [ie]: https://github.com/rust-lang/rust/pull/23300
7913 [inv]: https://github.com/rust-lang/rust/pull/23938
7914 [ios]: https://github.com/rust-lang/rust/pull/24133
7915 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
7916 [lt]: https://github.com/rust-lang/rust/pull/24057
7917 [meth]: https://github.com/rust-lang/rust/pull/24056
7918 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
7919 [po]: https://github.com/rust-lang/rust/pull/24270
7920 [sf]: https://github.com/rust-lang/rust/pull/24517
7921 [slp]: https://github.com/rust-lang/rust/pull/23949
7922 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
7923 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
7924 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
7925 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
7926 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
7927 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
7928 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
7929 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
7930 [self-sized]: https://github.com/rust-lang/rust/pull/22301
7931 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
7932 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
7933 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
7934 [reflect]: https://github.com/rust-lang/rust/pull/23712
7935 [conversion]: https://github.com/rust-lang/rfcs/pull/529
7936 [num-traits]: https://github.com/rust-lang/rust/pull/23549
7937 [index-value]: https://github.com/rust-lang/rust/pull/23601
7938 [dropck]: https://github.com/rust-lang/rfcs/pull/769
7939 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
7940 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
7941 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
7942 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
7943 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
7944
7945
7946 Version 1.0.0-alpha.2 (2015-02-20)
7947 =====================================
7948
7949 * ~1300 changes, numerous bugfixes
7950
7951 * Highlights
7952
7953     * The various I/O modules were [overhauled][io-rfc] to reduce
7954       unnecessary abstractions and provide better interoperation with
7955       the underlying platform. The old `io` module remains temporarily
7956       at `std::old_io`.
7957     * The standard library now [participates in feature gating][feat],
7958       so use of unstable libraries now requires a `#![feature(...)]`
7959       attribute. The impact of this change is [described on the
7960       forum][feat-forum]. [RFC][feat-rfc].
7961
7962 * Language
7963
7964     * `for` loops [now operate on the `IntoIterator` trait][into],
7965       which eliminates the need to call `.iter()`, etc. to iterate
7966       over collections. There are some new subtleties to remember
7967       though regarding what sort of iterators various types yield, in
7968       particular that `for foo in bar { }` yields values from a move
7969       iterator, destroying the original collection. [RFC][into-rfc].
7970     * Objects now have [default lifetime bounds][obj], so you don't
7971       have to write `Box<Trait+'static>` when you don't care about
7972       storing references. [RFC][obj-rfc].
7973     * In types that implement `Drop`, [lifetimes must outlive the
7974       value][drop]. This will soon make it possible to safely
7975       implement `Drop` for types where `#[unsafe_destructor]` is now
7976       required. Read the [gorgeous RFC][drop-rfc] for details.
7977     * The fully qualified <T as Trait>::X syntax lets you set the Self
7978       type for a trait method or associated type. [RFC][ufcs-rfc].
7979     * References to types that implement `Deref<U>` now [automatically
7980       coerce to references][deref] to the dereferenced type `U`,
7981       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
7982       should eliminate many unsightly uses of `&*`, as when converting
7983       from references to vectors into references to
7984       slices. [RFC][deref-rfc].
7985     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
7986       `|:|`) is obsolete and closure kind is inferred from context.
7987     * [`Self` is a keyword][Self].
7988
7989 * Libraries
7990
7991     * The `Show` and `String` formatting traits [have been
7992       renamed][fmt] to `Debug` and `Display` to more clearly reflect
7993       their related purposes. Automatically getting a string
7994       conversion to use with `format!("{:?}", something_to_debug)` is
7995       now written `#[derive(Debug)]`.
7996     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
7997       OsStr}`, provide strings in platform-specific encodings for easier
7998       interop with system APIs. [RFC][osstr-rfc].
7999     * The `boxed::into_raw` and `Box::from_raw` functions [convert
8000       between `Box<T>` and `*mut T`][boxraw], a common pattern for
8001       creating raw pointers.
8002
8003 * Tooling
8004
8005     * Certain long error messages of the form 'expected foo found bar'
8006       are now [split neatly across multiple
8007       lines][multiline]. Examples in the PR.
8008     * On Unix Rust can be [uninstalled][un] by running
8009       `/usr/local/lib/rustlib/uninstall.sh`.
8010     * The `#[rustc_on_unimplemented]` attribute, requiring the
8011       'on_unimplemented' feature, lets rustc [display custom error
8012       messages when a trait is expected to be implemented for a type
8013       but is not][onun].
8014
8015 * Misc
8016
8017     * Rust is tested against a [LALR grammar][lalr], which parses
8018       almost all the Rust files that rustc does.
8019
8020 [boxraw]: https://github.com/rust-lang/rust/pull/21318
8021 [close]: https://github.com/rust-lang/rust/pull/21843
8022 [deref]: https://github.com/rust-lang/rust/pull/21351
8023 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
8024 [drop]: https://github.com/rust-lang/rust/pull/21972
8025 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8026 [feat]: https://github.com/rust-lang/rust/pull/21248
8027 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
8028 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
8029 [fmt]: https://github.com/rust-lang/rust/pull/21457
8030 [into]: https://github.com/rust-lang/rust/pull/20790
8031 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
8032 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8033 [lalr]: https://github.com/rust-lang/rust/pull/21452
8034 [multiline]: https://github.com/rust-lang/rust/pull/19870
8035 [obj]: https://github.com/rust-lang/rust/pull/22230
8036 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
8037 [onun]: https://github.com/rust-lang/rust/pull/20889
8038 [osstr]: https://github.com/rust-lang/rust/pull/21488
8039 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8040 [Self]: https://github.com/rust-lang/rust/pull/22158
8041 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
8042 [un]: https://github.com/rust-lang/rust/pull/22256
8043
8044
8045 Version 1.0.0-alpha (2015-01-09)
8046 ==================================
8047
8048   * ~2400 changes, numerous bugfixes
8049
8050   * Highlights
8051
8052     * The language itself is considered feature complete for 1.0,
8053       though there will be many usability improvements and bugfixes
8054       before the final release.
8055     * Nearly 50% of the public API surface of the standard library has
8056       been declared 'stable'. Those interfaces are unlikely to change
8057       before 1.0.
8058     * The long-running debate over integer types has been
8059       [settled][ints]: Rust will ship with types named `isize` and
8060       `usize`, rather than `int` and `uint`, for pointer-sized
8061       integers. Guidelines will be rolled out during the alpha cycle.
8062     * Most crates that are not `std` have been moved out of the Rust
8063       distribution into the Cargo ecosystem so they can evolve
8064       separately and don't need to be stabilized as quickly, including
8065       'time', 'getopts', 'num', 'regex', and 'term'.
8066     * Documentation continues to be expanded with more API coverage, more
8067       examples, and more in-depth explanations. The guides have been
8068       consolidated into [The Rust Programming Language][trpl].
8069     * "[Rust By Example][rbe]" is now maintained by the Rust team.
8070     * All official Rust binary installers now come with [Cargo], the
8071       Rust package manager.
8072
8073 * Language
8074
8075     * Closures have been [completely redesigned][unboxed] to be
8076       implemented in terms of traits, can now be used as generic type
8077       bounds and thus monomorphized and inlined, or via an opaque
8078       pointer (boxed) as in the old system. The new system is often
8079       referred to as 'unboxed' closures.
8080     * Traits now support [associated types][assoc], allowing families
8081       of related types to be defined together and used generically in
8082       powerful ways.
8083     * Enum variants are [namespaced by their type names][enum].
8084     * [`where` clauses][where] provide a more versatile and attractive
8085       syntax for specifying generic bounds, though the previous syntax
8086       remains valid.
8087     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
8088       numeric types.
8089     * Rust [no longer has a runtime][rt] of any description, and only
8090       supports OS threads, not green threads.
8091     * At long last, Rust has been overhauled for 'dynamically-sized
8092       types' ([DST]), which integrates 'fat pointers' (object types,
8093       arrays, and `str`) more deeply into the type system, making it
8094       more consistent.
8095     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
8096       `..j` that produce range types and which, when combined with the
8097       `Index` operator and multidispatch, leads to a convenient slice
8098       notation, `[i..j]`.
8099     * The new range syntax revealed an ambiguity in the fixed-length
8100       array syntax, so now fixed length arrays [are written `[T;
8101       N]`][arrays].
8102     * The `Copy` trait is no longer implemented automatically. Unsafe
8103       pointers no longer implement `Sync` and `Send` so types
8104       containing them don't automatically either. `Sync` and `Send`
8105       are now 'unsafe traits' so one can "forcibly" implement them via
8106       `unsafe impl` if a type confirms to the requirements for them
8107       even though the internals do not (e.g. structs containing unsafe
8108       pointers like `Arc`). These changes are intended to prevent some
8109       footguns and are collectively known as [opt-in built-in
8110       traits][oibit] (though `Sync` and `Send` will soon become pure
8111       library types unknown to the compiler).
8112     * Operator traits now take their operands [by value][ops], and
8113       comparison traits can use multidispatch to compare one type
8114       against multiple other types, allowing e.g. `String` to be
8115       compared with `&str`.
8116     * `if let` and `while let` are no longer feature-gated.
8117     * Rust has adopted a more [uniform syntax for escaping unicode
8118       characters][unicode].
8119     * `macro_rules!` [has been declared stable][mac]. Though it is a
8120       flawed system it is sufficiently popular that it must be usable
8121       for 1.0. Effort has gone into [future-proofing][mac-future] it
8122       in ways that will allow other macro systems to be developed in
8123       parallel, and won't otherwise impact the evolution of the
8124       language.
8125     * The prelude has been [pared back significantly][prelude] such
8126       that it is the minimum necessary to support the most pervasive
8127       code patterns, and through [generalized where clauses][where]
8128       many of the prelude extension traits have been consolidated.
8129     * Rust's rudimentary reflection [has been removed][refl], as it
8130       incurred too much code generation for little benefit.
8131     * [Struct variants][structvars] are no longer feature-gated.
8132     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
8133       known as 'higher-ranked trait bounds', this crucially allows
8134       unboxed closures to work.
8135     * Macros invocations surrounded by parens or square brackets and
8136       not terminated by a semicolon are [parsed as
8137       expressions][macros], which makes expressions like `vec![1i32,
8138       2, 3].len()` work as expected.
8139     * Trait objects now implement their traits automatically, and
8140       traits that can be coerced to objects now must be [object
8141       safe][objsafe].
8142     * Automatically deriving traits is now done with `#[derive(...)]`
8143       not `#[deriving(...)]` for [consistency with other naming
8144       conventions][derive].
8145     * Importing the containing module or enum at the same time as
8146       items or variants they contain is [now done with `self` instead
8147       of `mod`][self], as in use `foo::{self, bar}`
8148     * Glob imports are no longer feature-gated.
8149     * The `box` operator and `box` patterns have been feature-gated
8150       pending a redesign. For now unique boxes should be allocated
8151       like other containers, with `Box::new`.
8152
8153 * Libraries
8154
8155     * A [series][coll1] of [efforts][coll2] to establish
8156       [conventions][coll3] for collections types has resulted in API
8157       improvements throughout the standard library.
8158     * New [APIs for error handling][err] provide ergonomic interop
8159       between error types, and [new conventions][err-conv] describe
8160       more clearly the recommended error handling strategies in Rust.
8161     * The `fail!` macro has been renamed to [`panic!`][panic] so that
8162       it is easier to discuss failure in the context of error handling
8163       without making clarifications as to whether you are referring to
8164       the 'fail' macro or failure more generally.
8165     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
8166       syscall when available.
8167     * The 'serialize' crate has been renamed 'rustc-serialize' and
8168       moved out of the distribution to Cargo. Although it is widely
8169       used now, it is expected to be superseded in the near future.
8170     * The `Show` formatter, typically implemented with
8171       `#[derive(Show)]` is [now requested with the `{:?}`
8172       specifier][show] and is intended for use by all types, for uses
8173       such as `println!` debugging. The new `String` formatter must be
8174       implemented by hand, uses the `{}` specifier, and is intended
8175       for full-fidelity conversions of things that can logically be
8176       represented as strings.
8177
8178 * Tooling
8179
8180     * [Flexible target specification][flex] allows rustc's code
8181       generation to be configured to support otherwise-unsupported
8182       platforms.
8183     * Rust comes with rust-gdb and rust-lldb scripts that launch their
8184       respective debuggers with Rust-appropriate pretty-printing.
8185     * The Windows installation of Rust is distributed with the
8186       MinGW components currently required to link binaries on that
8187       platform.
8188
8189 * Misc
8190
8191     * Nullable enum optimizations have been extended to more types so
8192       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
8193       space than the inner types themselves.
8194     * Work has begun on supporting AArch64.
8195
8196 [Cargo]: https://crates.io
8197 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
8198 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
8199 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
8200 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
8201 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
8202 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
8203 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
8204 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
8205 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
8206 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
8207 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
8208 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
8209 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
8210 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
8211 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
8212 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
8213 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
8214 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
8215 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
8216 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
8217 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
8218 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
8219 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
8220 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
8221 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
8222 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
8223 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
8224 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
8225 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
8226 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
8227 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
8228 [trpl]: https://doc.rust-lang.org/book/index.html
8229 [rbe]: http://rustbyexample.com/
8230
8231
8232 Version 0.12.0 (2014-10-09)
8233 =============================
8234
8235   * ~1900 changes, numerous bugfixes
8236
8237   * Highlights
8238
8239     * The introductory documentation (now called The Rust Guide) has
8240       been completely rewritten, as have a number of supplementary
8241       guides.
8242     * Rust's package manager, Cargo, continues to improve and is
8243       sometimes considered to be quite awesome.
8244     * Many API's in `std` have been reviewed and updated for
8245       consistency with the in-development Rust coding
8246       guidelines. The standard library documentation tracks
8247       stabilization progress.
8248     * Minor libraries have been moved out-of-tree to the rust-lang org
8249       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
8250       be installed with Cargo.
8251     * Lifetime elision allows lifetime annotations to be left off of
8252       function declarations in many common scenarios.
8253     * Rust now works on 64-bit Windows.
8254
8255   * Language
8256     * Indexing can be overloaded with the `Index` and `IndexMut`
8257       traits.
8258     * The `if let` construct takes a branch only if the `let` pattern
8259       matches, currently behind the 'if_let' feature gate.
8260     * 'where clauses', a more flexible syntax for specifying trait
8261       bounds that is more aesthetic, have been added for traits and
8262       free functions. Where clauses will in the future make it
8263       possible to constrain associated types, which would be
8264       impossible with the existing syntax.
8265     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
8266       the 'slicing_syntax' feature gate, and can be overloaded with
8267       the `Slice` or `SliceMut` traits.
8268     * The syntax for matching of sub-slices has been changed to use a
8269       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
8270       consistency with other uses of `..` and to future-proof
8271       potential additional uses of the syntax.
8272     * The syntax for matching inclusive ranges in patterns has changed
8273       from `0..3` to `0...4` to be consistent with the exclusive range
8274       syntax for slicing.
8275     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
8276       c]`) has been put behind the 'advanced_slice_patterns' feature
8277       gate and may be removed in the future.
8278     * Components of tuples and tuple structs can be extracted using
8279       the `value.0` syntax, currently behind the `tuple_indexing`
8280       feature gate.
8281     * The `#[crate_id]` attribute is no longer supported; versioning
8282       is handled by the package manager.
8283     * Renaming crate imports are now written `extern crate foo as bar`
8284       instead of `extern crate bar = foo`.
8285     * Renaming use statements are now written `use foo as bar` instead
8286       of `use bar = foo`.
8287     * `let` and `match` bindings and argument names in macros are now
8288       hygienic.
8289     * The new, more efficient, closure types ('unboxed closures') have
8290       been added under a feature gate, 'unboxed_closures'. These will
8291       soon replace the existing closure types, once higher-ranked
8292       trait lifetimes are added to the language.
8293     * `move` has been added as a keyword, for indicating closures
8294       that capture by value.
8295     * Mutation and assignment is no longer allowed in pattern guards.
8296     * Generic structs and enums can now have trait bounds.
8297     * The `Share` trait is now called `Sync` to free up the term
8298       'shared' to refer to 'shared reference' (the default reference
8299       type.
8300     * Dynamically-sized types have been mostly implemented,
8301       unifying the behavior of fat-pointer types with the rest of the
8302       type system.
8303     * As part of dynamically-sized types, the `Sized` trait has been
8304       introduced, which qualifying types implement by default, and
8305       which type parameters expect by default. To specify that a type
8306       parameter does not need to be sized, write `<Sized? T>`. Most
8307       types are `Sized`, notable exceptions being unsized arrays
8308       (`[T]`) and trait types.
8309     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
8310     * Lifetime bounds can now be applied to type parameters and object
8311       types.
8312     * The old, reference counted GC type, `Gc<T>` which was once
8313       denoted by the `@` sigil, has finally been removed. GC will be
8314       revisited in the future.
8315
8316   * Libraries
8317     * Library documentation has been improved for a number of modules.
8318     * Bit-vectors, collections::bitv has been modernized.
8319     * The url crate is deprecated in favor of
8320       http://github.com/servo/rust-url, which can be installed with
8321       Cargo.
8322     * Most I/O stream types can be cloned and subsequently closed from
8323       a different thread.
8324     * A `std::time::Duration` type has been added for use in I/O
8325       methods that rely on timers, as well as in the 'time' crate's
8326       `Timespec` arithmetic.
8327     * The runtime I/O abstraction layer that enabled the green thread
8328       scheduler to do non-thread-blocking I/O has been removed, along
8329       with the libuv-based implementation employed by the green thread
8330       scheduler. This will greatly simplify the future I/O work.
8331     * `collections::btree` has been rewritten to have a more
8332       idiomatic and efficient design.
8333
8334   * Tooling
8335     * rustdoc output now indicates the stability levels of API's.
8336     * The `--crate-name` flag can specify the name of the crate
8337       being compiled, like `#[crate_name]`.
8338     * The `-C metadata` specifies additional metadata to hash into
8339       symbol names, and `-C extra-filename` specifies additional
8340       information to put into the output filename, for use by the
8341       package manager for versioning.
8342     * debug info generation has continued to improve and should be
8343       more reliable under both gdb and lldb.
8344     * rustc has experimental support for compiling in parallel
8345       using the `-C codegen-units` flag.
8346     * rustc no longer encodes rpath information into binaries by
8347       default.
8348
8349   * Misc
8350     * Stack usage has been optimized with LLVM lifetime annotations.
8351     * Official Rust binaries on Linux are more compatible with older
8352       kernels and distributions, built on CentOS 5.10.
8353
8354
8355 Version 0.11.0 (2014-07-02)
8356 ==========================
8357
8358   * ~1700 changes, numerous bugfixes
8359
8360   * Language
8361     * ~[T] has been removed from the language. This type is superseded by
8362       the Vec<T> type.
8363     * ~str has been removed from the language. This type is superseded by
8364       the String type.
8365     * ~T has been removed from the language. This type is superseded by the
8366       Box<T> type.
8367     * @T has been removed from the language. This type is superseded by the
8368       standard library's std::gc::Gc<T> type.
8369     * Struct fields are now all private by default.
8370     * Vector indices and shift amounts are both required to be a `uint`
8371       instead of any integral type.
8372     * Byte character, byte string, and raw byte string literals are now all
8373       supported by prefixing the normal literal with a `b`.
8374     * Multiple ABIs are no longer allowed in an ABI string
8375     * The syntax for lifetimes on closures/procedures has been tweaked
8376       slightly: `<'a>|A, B|: 'b + K -> T`
8377     * Floating point modulus has been removed from the language; however it
8378       is still provided by a library implementation.
8379     * Private enum variants are now disallowed.
8380     * The `priv` keyword has been removed from the language.
8381     * A closure can no longer be invoked through a &-pointer.
8382     * The `use foo, bar, baz;` syntax has been removed from the language.
8383     * The transmute intrinsic no longer works on type parameters.
8384     * Statics now allow blocks/items in their definition.
8385     * Trait bounds are separated from objects with + instead of : now.
8386     * Objects can no longer be read while they are mutably borrowed.
8387     * The address of a static is now marked as insignificant unless the
8388       #[inline(never)] attribute is placed it.
8389     * The #[unsafe_destructor] attribute is now behind a feature gate.
8390     * Struct literals are no longer allowed in ambiguous positions such as
8391       if, while, match, and for..in.
8392     * Declaration of lang items and intrinsics are now feature-gated by
8393       default.
8394     * Integral literals no longer default to `int`, and floating point
8395       literals no longer default to `f64`. Literals must be suffixed with an
8396       appropriate type if inference cannot determine the type of the
8397       literal.
8398     * The Box<T> type is no longer implicitly borrowed to &mut T.
8399     * Procedures are now required to not capture borrowed references.
8400
8401   * Libraries
8402     * The standard library is now a "facade" over a number of underlying
8403       libraries. This means that development on the standard library should
8404       be speedier due to smaller crates, as well as a clearer line between
8405       all dependencies.
8406     * A new library, libcore, lives under the standard library's facade
8407       which is Rust's "0-assumption" library, suitable for embedded and
8408       kernel development for example.
8409     * A regex crate has been added to the standard distribution. This crate
8410       includes statically compiled regular expressions.
8411     * The unwrap/unwrap_err methods on Result require a Show bound for
8412       better error messages.
8413     * The return types of the std::comm primitives have been centralized
8414       around the Result type.
8415     * A number of I/O primitives have gained the ability to time out their
8416       operations.
8417     * A number of I/O primitives have gained the ability to close their
8418       reading/writing halves to cancel pending operations.
8419     * Reverse iterator methods have been removed in favor of `rev()` on
8420       their forward-iteration counterparts.
8421     * A bitflags! macro has been added to enable easy interop with C and
8422       management of bit flags.
8423     * A debug_assert! macro is now provided which is disabled when
8424       `--cfg ndebug` is passed to the compiler.
8425     * A graphviz crate has been added for creating .dot files.
8426     * The std::cast module has been migrated into std::mem.
8427     * The std::local_data api has been migrated from freestanding functions
8428       to being based on methods.
8429     * The Pod trait has been renamed to Copy.
8430     * jemalloc has been added as the default allocator for types.
8431     * The API for allocating memory has been changed to use proper alignment
8432       and sized deallocation
8433     * Connecting a TcpStream or binding a TcpListener is now based on a
8434       string address and a u16 port. This allows connecting to a hostname as
8435       opposed to an IP.
8436     * The Reader trait now contains a core method, read_at_least(), which
8437       correctly handles many repeated 0-length reads.
8438     * The process-spawning API is now centered around a builder-style
8439       Command struct.
8440     * The :? printing qualifier has been moved from the standard library to
8441       an external libdebug crate.
8442     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
8443       have been renamed to Eq/Ord.
8444     * The select/plural methods have been removed from format!. The escapes
8445       for { and } have also changed from \{ and \} to {{ and }},
8446       respectively.
8447     * The TaskBuilder API has been re-worked to be a true builder, and
8448       extension traits for spawning native/green tasks have been added.
8449
8450   * Tooling
8451     * All breaking changes to the language or libraries now have their
8452       commit message annotated with `[breaking-change]` to allow for easy
8453       discovery of breaking changes.
8454     * The compiler will now try to suggest how to annotate lifetimes if a
8455       lifetime-related error occurs.
8456     * Debug info continues to be improved greatly with general bug fixes and
8457       better support for situations like link time optimization (LTO).
8458     * Usage of syntax extensions when cross-compiling has been fixed.
8459     * Functionality equivalent to GCC & Clang's -ffunction-sections,
8460       -fdata-sections and --gc-sections has been enabled by default
8461     * The compiler is now stricter about where it will load module files
8462       from when a module is declared via `mod foo;`.
8463     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
8464       Syntax extensions are now discovered via a "plugin registrar" type
8465       which will be extended in the future to other various plugins.
8466     * Lints have been restructured to allow for dynamically loadable lints.
8467     * A number of rustdoc improvements:
8468       * The HTML output has been visually redesigned.
8469       * Markdown is now powered by hoedown instead of sundown.
8470       * Searching heuristics have been greatly improved.
8471       * The search index has been reduced in size by a great amount.
8472       * Cross-crate documentation via `pub use` has been greatly improved.
8473       * Primitive types are now hyperlinked and documented.
8474     * Documentation has been moved from static.rust-lang.org/doc to
8475       doc.rust-lang.org
8476     * A new sandbox, play.rust-lang.org, is available for running and
8477       sharing rust code examples on-line.
8478     * Unused attributes are now more robustly warned about.
8479     * The dead_code lint now warns about unused struct fields.
8480     * Cross-compiling to iOS is now supported.
8481     * Cross-compiling to mipsel is now supported.
8482     * Stability attributes are now inherited by default and no longer apply
8483       to intra-crate usage, only inter-crate usage.
8484     * Error message related to non-exhaustive match expressions have been
8485       greatly improved.
8486
8487
8488 Version 0.10 (2014-04-03)
8489 =========================
8490
8491   * ~1500 changes, numerous bugfixes
8492
8493   * Language
8494     * A new RFC process is now in place for modifying the language.
8495     * Patterns with `@`-pointers have been removed from the language.
8496     * Patterns with unique vectors (`~[T]`) have been removed from the
8497       language.
8498     * Patterns with unique strings (`~str`) have been removed from the
8499       language.
8500     * `@str` has been removed from the language.
8501     * `@[T]` has been removed from the language.
8502     * `@self` has been removed from the language.
8503     * `@Trait` has been removed from the language.
8504     * Headers on `~` allocations which contain `@` boxes inside the type for
8505       reference counting have been removed.
8506     * The semantics around the lifetimes of temporary expressions have changed,
8507       see #3511 and #11585 for more information.
8508     * Cross-crate syntax extensions are now possible, but feature gated. See
8509       #11151 for more information. This includes both `macro_rules!` macros as
8510       well as syntax extensions such as `format!`.
8511     * New lint modes have been added, and older ones have been turned on to be
8512       warn-by-default.
8513       * Unnecessary parentheses
8514       * Uppercase statics
8515       * Camel Case types
8516       * Uppercase variables
8517       * Publicly visible private types
8518       * `#[deriving]` with raw pointers
8519     * Unsafe functions can no longer be coerced to closures.
8520     * Various obscure macros such as `log_syntax!` are now behind feature gates.
8521     * The `#[simd]` attribute is now behind a feature gate.
8522     * Visibility is no longer allowed on `extern crate` statements, and
8523       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
8524     * Trailing commas are now allowed in argument lists and tuple patterns.
8525     * The `do` keyword has been removed, it is now a reserved keyword.
8526     * Default type parameters have been implemented, but are feature gated.
8527     * Borrowed variables through captures in closures are now considered soundly.
8528     * `extern mod` is now `extern crate`
8529     * The `Freeze` trait has been removed.
8530     * The `Share` trait has been added for types that can be shared among
8531       threads.
8532     * Labels in macros are now hygienic.
8533     * Expression/statement macro invocations can be delimited with `{}` now.
8534     * Treatment of types allowed in `static mut` locations has been tweaked.
8535     * The `*` and `.` operators are now overloadable through the `Deref` and
8536       `DerefMut` traits.
8537     * `~Trait` and `proc` no longer have `Send` bounds by default.
8538     * Partial type hints are now supported with the `_` type marker.
8539     * An `Unsafe` type was introduced for interior mutability. It is now
8540       considered undefined to transmute from `&T` to `&mut T` without using the
8541       `Unsafe` type.
8542     * The #[linkage] attribute was implemented for extern statics/functions.
8543     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
8544     * `Pod` was renamed to `Copy`.
8545
8546   * Libraries
8547     * The `libextra` library has been removed. It has now been decomposed into
8548       component libraries with smaller and more focused nuggets of
8549       functionality. The full list of libraries can be found on the
8550       documentation index page.
8551     * std: `std::condition` has been removed. All I/O errors are now propagated
8552       through the `Result` type. In order to assist with error handling, a
8553       `try!` macro for unwrapping errors with an early return and a lint for
8554       unused results has been added. See #12039 for more information.
8555     * std: The `vec` module has been renamed to `slice`.
8556     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
8557       This will become the only growable vector in the future.
8558     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
8559       are now found at `std::io::BufferedReader` instead of
8560       `std::io::buffered::BufferedReader`.
8561     * std: `print` and `println` are no longer in the prelude, the `print!` and
8562       `println!` macros are intended to be used instead.
8563     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
8564       attempts to statically prevent cycles.
8565     * std: The standard distribution is adopting the policy of pushing failure
8566       to the user rather than failing in libraries. Many functions (such as
8567       `slice::last()`) now return `Option<T>` instead of `T` + failing.
8568     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
8569       deriving mode: `#[deriving(Show)]`.
8570     * std: `ToStr` is now implemented for all types implementing `Show`.
8571     * std: The formatting trait methods now take `&self` instead of `&T`
8572     * std: The `invert()` method on iterators has been renamed to `rev()`
8573     * std: `std::num` has seen a reduction in the genericity of its traits,
8574       consolidating functionality into a few core traits.
8575     * std: Backtraces are now printed on task failure if the environment
8576       variable `RUST_BACKTRACE` is present.
8577     * std: Naming conventions for iterators have been standardized. More details
8578       can be found on the wiki's style guide.
8579     * std: `eof()` has been removed from the `Reader` trait. Specific types may
8580       still implement the function.
8581     * std: Networking types are now cloneable to allow simultaneous reads/writes.
8582     * std: `assert_approx_eq!` has been removed
8583     * std: The `e` and `E` formatting specifiers for floats have been added to
8584       print them in exponential notation.
8585     * std: The `Times` trait has been removed
8586     * std: Indications of variance and opting out of builtin bounds is done
8587       through marker types in `std::kinds::marker` now
8588     * std: `hash` has been rewritten, `IterBytes` has been removed, and
8589       `#[deriving(Hash)]` is now possible.
8590     * std: `SharedChan` has been removed, `Sender` is now cloneable.
8591     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
8592     * std: `Chan::new` is now `channel()`.
8593     * std: A new synchronous channel type has been implemented.
8594     * std: A `select!` macro is now provided for selecting over `Receiver`s.
8595     * std: `hashmap` and `trie` have been moved to `libcollections`
8596     * std: `run` has been rolled into `io::process`
8597     * std: `assert_eq!` now uses `{}` instead of `{:?}`
8598     * std: The equality and comparison traits have seen some reorganization.
8599     * std: `rand` has moved to `librand`.
8600     * std: `to_{lower,upper}case` has been implemented for `char`.
8601     * std: Logging has been moved to `liblog`.
8602     * collections: `HashMap` has been rewritten for higher performance and less
8603       memory usage.
8604     * native: The default runtime is now `libnative`. If `libgreen` is desired,
8605       it can be booted manually. The runtime guide has more information and
8606       examples.
8607     * native: All I/O functionality except signals has been implemented.
8608     * green: Task spawning with `libgreen` has been optimized with stack caching
8609       and various trimming of code.
8610     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
8611     * sync: The `extra::sync` module has been updated to modern rust (and moved
8612       to the `sync` library), tweaking and improving various interfaces while
8613       dropping redundant functionality.
8614     * sync: A new `Barrier` type has been added to the `sync` library.
8615     * sync: An efficient mutex for native and green tasks has been implemented.
8616     * serialize: The `base64` module has seen some improvement. It treats
8617       newlines better, has non-string error values, and has seen general
8618       cleanup.
8619     * fourcc: A `fourcc!` macro was introduced
8620     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
8621       hexadecimal literal.
8622
8623   * Tooling
8624     * `rustpkg` has been deprecated and removed from the main repository. Its
8625       replacement, `cargo`, is under development.
8626     * Nightly builds of rust are now available
8627     * The memory usage of rustc has been improved many times throughout this
8628       release cycle.
8629     * The build process supports disabling rpath support for the rustc binary
8630       itself.
8631     * Code generation has improved in some cases, giving more information to the
8632       LLVM optimization passes to enable more extensive optimizations.
8633     * Debuginfo compatibility with lldb on OSX has been restored.
8634     * The master branch is now gated on an android bot, making building for
8635       android much more reliable.
8636     * Output flags have been centralized into one `--emit` flag.
8637     * Crate type flags have been centralized into one `--crate-type` flag.
8638     * Codegen flags have been consolidated behind a `-C` flag.
8639     * Linking against outdated crates now has improved error messages.
8640     * Error messages with lifetimes will often suggest how to annotate the
8641       function to fix the error.
8642     * Many more types are documented in the standard library, and new guides
8643       were written.
8644     * Many `rustdoc` improvements:
8645       * code blocks are syntax highlighted.
8646       * render standalone markdown files.
8647       * the --test flag tests all code blocks by default.
8648       * exported macros are displayed.
8649       * re-exported types have their documentation inlined at the location of the
8650         first re-export.
8651       * search works across crates that have been rendered to the same output
8652         directory.
8653
8654
8655 Version 0.9 (2014-01-09)
8656 ==========================
8657
8658    * ~1800 changes, numerous bugfixes
8659
8660    * Language
8661       * The `float` type has been removed. Use `f32` or `f64` instead.
8662       * A new facility for enabling experimental features (feature gating) has
8663         been added, using the crate-level `#[feature(foo)]` attribute.
8664       * Managed boxes (@) are now behind a feature gate
8665         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
8666         standard library's `Gc` or `Rc` types instead.
8667       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
8668       * Jumping back to the top of a loop is now done with `continue` instead of
8669         `loop`.
8670       * Strings can no longer be mutated through index assignment.
8671       * Raw strings can be created via the basic `r"foo"` syntax or with matched
8672         hash delimiters, as in `r###"foo"###`.
8673       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
8674         called once.
8675       * The `&fn` type is now written `|args| -> ret` to match the literal form.
8676       * `@fn`s have been removed.
8677       * `do` only works with procs in order to make it obvious what the cost
8678         of `do` is.
8679       * Single-element tuple-like structs can no longer be dereferenced to
8680         obtain the inner value. A more comprehensive solution for overloading
8681         the dereference operator will be provided in the future.
8682       * The `#[link(...)]` attribute has been replaced with
8683         `#[crate_id = "name#vers"]`.
8684       * Empty `impl`s must be terminated with empty braces and may not be
8685         terminated with a semicolon.
8686       * Keywords are no longer allowed as lifetime names; the `self` lifetime
8687         no longer has any special meaning.
8688       * The old `fmt!` string formatting macro has been removed.
8689       * `printf!` and `printfln!` (old-style formatting) removed in favor of
8690         `print!` and `println!`.
8691       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
8692       * The `extern mod foo (name = "bar")` syntax has been removed. Use
8693         `extern mod foo = "bar"` instead.
8694       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
8695       * Macros can have attributes.
8696       * Macros can expand to items with attributes.
8697       * Macros can expand to multiple items.
8698       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
8699       * Comments may be nested.
8700       * Values automatically coerce to trait objects they implement, without
8701         an explicit `as`.
8702       * Enum discriminants are no longer an entire word but as small as needed to
8703         contain all the variants. The `repr` attribute can be used to override
8704         the discriminant size, as in `#[repr(int)]` for integer-sized, and
8705         `#[repr(C)]` to match C enums.
8706       * Non-string literals are not allowed in attributes (they never worked).
8707       * The FFI now supports variadic functions.
8708       * Octal numeric literals, as in `0o7777`.
8709       * The `concat!` syntax extension performs compile-time string concatenation.
8710       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
8711         removed as Rust no longer uses segmented stacks.
8712       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
8713       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
8714         not `*`; ignoring remaining fields of a struct is also done with `..`,
8715         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
8716       * `rustc` supports the "win64" calling convention via `extern "win64"`.
8717       * `rustc` supports the "system" calling convention, which defaults to the
8718         preferred convention for the target platform, "stdcall" on 32-bit Windows,
8719         "C" elsewhere.
8720       * The `type_overflow` lint (default: warn) checks literals for overflow.
8721       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
8722       * The `attribute_usage` lint (default: warn) warns about unknown
8723         attributes.
8724       * The `unknown_features` lint (default: warn) warns about unknown
8725         feature gates.
8726       * The `dead_code` lint (default: warn) checks for dead code.
8727       * Rust libraries can be linked statically to one another
8728       * `#[link_args]` is behind the `link_args` feature gate.
8729       * Native libraries are now linked with `#[link(name = "foo")]`
8730       * Native libraries can be statically linked to a rust crate
8731         (`#[link(name = "foo", kind = "static")]`).
8732       * Native OS X frameworks are now officially supported
8733         (`#[link(name = "foo", kind = "framework")]`).
8734       * The `#[thread_local]` attribute creates thread-local (not task-local)
8735         variables. Currently behind the `thread_local` feature gate.
8736       * The `return` keyword may be used in closures.
8737       * Types that can be copied via a memcpy implement the `Pod` kind.
8738       * The `cfg` attribute can now be used on struct fields and enum variants.
8739
8740    * Libraries
8741       * std: The `option` and `result` API's have been overhauled to make them
8742         simpler, more consistent, and more composable.
8743       * std: The entire `std::io` module has been replaced with one that is
8744         more comprehensive and that properly interfaces with the underlying
8745         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
8746         implemented.
8747       * std: `io::util` contains a number of useful implementations of
8748         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
8749         `ZeroReader`, `TeeReader`.
8750       * std: The reference counted pointer type `extra::rc` moved into std.
8751       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
8752         just a wrapper around it).
8753       * std: The `Either` type has been removed.
8754       * std: `fmt::Default` can be implemented for any type to provide default
8755         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
8756       * std: The `rand` API continues to be tweaked.
8757       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
8758         on failure in gdb, is now named `rust_fail`.
8759       * std: The `each_key` and `each_value` methods on `HashMap` have been
8760         replaced by the `keys` and `values` iterators.
8761       * std: Functions dealing with type size and alignment have moved from the
8762         `sys` module to the `mem` module.
8763       * std: The `path` module was written and API changed.
8764       * std: `str::from_utf8` has been changed to cast instead of allocate.
8765       * std: `starts_with` and `ends_with` methods added to vectors via the
8766         `ImmutableEqVector` trait, which is in the prelude.
8767       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
8768         if the index is out of bounds.
8769       * std: Task failure no longer propagates between tasks, as the model was
8770         complex, expensive, and incompatible with thread-based tasks.
8771       * std: The `Any` type can be used for dynamic typing.
8772       * std: `~Any` can be passed to the `fail!` macro and retrieved via
8773         `task::try`.
8774       * std: Methods that produce iterators generally do not have an `_iter`
8775         suffix now.
8776       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
8777         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
8778       * std: `util::ignore` renamed to `prelude::drop`.
8779       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
8780         trait.
8781       * std: `vec::raw` has seen a lot of cleanup and API changes.
8782       * std: The standard library no longer includes any C++ code, and very
8783         minimal C, eliminating the dependency on libstdc++.
8784       * std: Runtime scheduling and I/O functionality has been factored out into
8785         extensible interfaces and is now implemented by two different crates:
8786         libnative, for native threading and I/O; and libgreen, for green threading
8787         and I/O. This paves the way for using the standard library in more limited
8788         embedded environments.
8789       * std: The `comm` module has been rewritten to be much faster, have a
8790         simpler, more consistent API, and to work for both native and green
8791         threading.
8792       * std: All libuv dependencies have been moved into the rustuv crate.
8793       * native: New implementations of runtime scheduling on top of OS threads.
8794       * native: New native implementations of TCP, UDP, file I/O, process spawning,
8795         and other I/O.
8796       * green: The green thread scheduler and message passing types are almost
8797         entirely lock-free.
8798       * extra: The `flatpipes` module had bitrotted and was removed.
8799       * extra: All crypto functions have been removed and Rust now has a policy of
8800         not reimplementing crypto in the standard library. In the future crypto
8801         will be provided by external crates with bindings to established libraries.
8802       * extra: `c_vec` has been modernized.
8803       * extra: The `sort` module has been removed. Use the `sort` method on
8804         mutable slices.
8805
8806    * Tooling
8807       * The `rust` and `rusti` commands have been removed, due to lack of
8808         maintenance.
8809       * `rustdoc` was completely rewritten.
8810       * `rustdoc` can test code examples in documentation.
8811       * `rustpkg` can test packages with the argument, 'test'.
8812       * `rustpkg` supports arbitrary dependencies, including C libraries.
8813       * `rustc`'s support for generating debug info is improved again.
8814       * `rustc` has better error reporting for unbalanced delimiters.
8815       * `rustc`'s JIT support was removed due to bitrot.
8816       * Executables and static libraries can be built with LTO (-Z lto)
8817       * `rustc` adds a `--dep-info` flag for communicating dependencies to
8818         build tools.
8819
8820
8821 Version 0.8 (2013-09-26)
8822 ============================
8823
8824    * ~2200 changes, numerous bugfixes
8825
8826    * Language
8827       * The `for` loop syntax has changed to work with the `Iterator` trait.
8828       * At long last, unwinding works on Windows.
8829       * Default methods are ready for use.
8830       * Many trait inheritance bugs fixed.
8831       * Owned and borrowed trait objects work more reliably.
8832       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
8833       * rustc can omit emission of code for the `debug!` macro if it is passed
8834         `--cfg ndebug`
8835       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
8836         for foo.rs, then foo/mod.rs, and will generate an error when both are
8837         present.
8838       * Strings no longer contain trailing nulls. The new `std::c_str` module
8839         provides new mechanisms for converting to C strings.
8840       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
8841       * The FFI has been overhauled such that foreign functions are called directly,
8842         instead of through a stack-switching wrapper.
8843       * Calling a foreign function must be done through a Rust function with the
8844         `#[fixed_stack_segment]` attribute.
8845       * The `externfn!` macro can be used to declare both a foreign function and
8846         a `#[fixed_stack_segment]` wrapper at once.
8847       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
8848       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
8849       * `priv` is disallowed everywhere except for struct fields and enum variants.
8850       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
8851       * `ref` bindings in irrefutable patterns work correctly now.
8852       * `char` is now prevented from containing invalid code points.
8853       * Casting to `bool` is no longer allowed.
8854       * `\0` is now accepted as an escape in chars and strings.
8855       * `yield` is a reserved keyword.
8856       * `typeof` is a reserved keyword.
8857       * Crates may be imported by URL with `extern mod foo = "url";`.
8858       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
8859       * Static vectors can be initialized with repeating elements,
8860         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
8861       * Static structs can be initialized with functional record update,
8862         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
8863       * `cfg!` can be used to conditionally execute code based on the crate
8864         configuration, similarly to `#[cfg(...)]`.
8865       * The `unnecessary_qualification` lint detects unneeded module
8866         prefixes (default: allow).
8867       * Arithmetic operations have been implemented on the SIMD types in
8868         `std::unstable::simd`.
8869       * Exchange allocation headers were removed, reducing memory usage.
8870       * `format!` implements a completely new, extensible, and higher-performance
8871         string formatting system. It will replace `fmt!`.
8872       * `print!` and `println!` write formatted strings (using the `format!`
8873         extension) to stdout.
8874       * `write!` and `writeln!` write formatted strings (using the `format!`
8875         extension) to the new Writers in `std::rt::io`.
8876       * The library section in which a function or static is placed may
8877         be specified with `#[link_section = "..."]`.
8878       * The `proto!` syntax extension for defining bounded message protocols
8879         was removed.
8880       * `macro_rules!` is hygienic for `let` declarations.
8881       * The `#[export_name]` attribute specifies the name of a symbol.
8882       * `unreachable!` can be used to indicate unreachable code, and fails
8883         if executed.
8884
8885    * Libraries
8886       * std: Transitioned to the new runtime, written in Rust.
8887       * std: Added an experimental I/O library, `rt::io`, based on the new
8888         runtime.
8889       * std: A new generic `range` function was added to the prelude, replacing
8890         `uint::range` and friends.
8891       * std: `range_rev` no longer exists. Since range is an iterator it can be
8892         reversed with `range(lo, hi).invert()`.
8893       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
8894         renamed to `unwrap_or`.
8895       * std: The `iterator` module was renamed to `iter`.
8896       * std: Integral types now support the `checked_add`, `checked_sub`, and
8897         `checked_mul` operations for detecting overflow.
8898       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
8899         consistency.
8900       * std: Methods are standardizing on conventions for casting methods:
8901         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
8902         and cheap casts.
8903       * std: The `CString` type in `c_str` provides new ways to convert to and
8904         from C strings.
8905       * std: `DoubleEndedIterator` can yield elements in two directions.
8906       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
8907         two splices.
8908       * std: `str::from_bytes` renamed to `str::from_utf8`.
8909       * std: `pop_opt` and `shift_opt` methods added to vectors.
8910       * std: The task-local data interface no longer uses @, and keys are
8911         no longer function pointers.
8912       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
8913       * std: Added `SharedPort` to `comm`.
8914       * std: `Eq` has a default method for `ne`; only `eq` is required
8915         in implementations.
8916       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
8917         is required in implementations.
8918       * std: `is_utf8` performance is improved, impacting many string functions.
8919       * std: `os::MemoryMap` provides cross-platform mmap.
8920       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
8921         are not 'in-bounds' are considered undefined.
8922       * std: Many freestanding functions in `vec` removed in favor of methods.
8923       * std: Many freestanding functions on scalar types removed in favor of
8924         methods.
8925       * std: Many options to task builders were removed since they don't make
8926         sense in the new scheduler design.
8927       * std: More containers implement `FromIterator` so can be created by the
8928         `collect` method.
8929       * std: More complete atomic types in `unstable::atomics`.
8930       * std: `comm::PortSet` removed.
8931       * std: Mutating methods in the `Set` and `Map` traits have been moved into
8932         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
8933         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
8934         default implementations.
8935       * std: Various `from_str` functions were removed in favor of a generic
8936         `from_str` which is available in the prelude.
8937       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
8938       * extra: `dlist`, the doubly-linked list was modernized.
8939       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
8940       * extra: Added `glob` module, replacing `std::os::glob`.
8941       * extra: `rope` was removed.
8942       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
8943       * extra: `net`, and `timer` were removed. The experimental replacements
8944         are `std::rt::io::net` and `std::rt::io::timer`.
8945       * extra: Iterators implemented for `SmallIntMap`.
8946       * extra: Iterators implemented for `Bitv` and `BitvSet`.
8947       * extra: `SmallIntSet` removed. Use `BitvSet`.
8948       * extra: Performance of JSON parsing greatly improved.
8949       * extra: `semver` updated to SemVer 2.0.0.
8950       * extra: `term` handles more terminals correctly.
8951       * extra: `dbg` module removed.
8952       * extra: `par` module removed.
8953       * extra: `future` was cleaned up, with some method renames.
8954       * extra: Most free functions in `getopts` were converted to methods.
8955
8956    * Other
8957       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
8958       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
8959         similarly to gcc's `--march` flag.
8960       * rustc's performance compiling small crates is much better.
8961       * rustpkg has received many improvements.
8962       * rustpkg supports git tags as package IDs.
8963       * rustpkg builds into target-specific directories so it can be used for
8964         cross-compiling.
8965       * The number of concurrent test tasks is controlled by the environment
8966         variable RUST_TEST_TASKS.
8967       * The test harness can now report metrics for benchmarks.
8968       * All tools have man pages.
8969       * Programs compiled with `--test` now support the `-h` and `--help` flags.
8970       * The runtime uses jemalloc for allocations.
8971       * Segmented stacks are temporarily disabled as part of the transition to
8972         the new runtime. Stack overflows are possible!
8973       * A new documentation backend, rustdoc_ng, is available for use. It is
8974         still invoked through the normal `rustdoc` command.
8975
8976
8977 Version 0.7 (2013-07-03)
8978 =======================
8979
8980    * ~2000 changes, numerous bugfixes
8981
8982    * Language
8983       * `impl`s no longer accept a visibility qualifier. Put them on methods
8984         instead.
8985       * The borrow checker has been rewritten with flow-sensitivity, fixing
8986         many bugs and inconveniences.
8987       * The `self` parameter no longer implicitly means `&'self self`,
8988         and can be explicitly marked with a lifetime.
8989       * Overloadable compound operators (`+=`, etc.) have been temporarily
8990         removed due to bugs.
8991       * The `for` loop protocol now requires `for`-iterators to return `bool`
8992         so they compose better.
8993       * The `Durable` trait is replaced with the `'static` bounds.
8994       * Trait default methods work more often.
8995       * Structs with the `#[packed]` attribute have byte alignment and
8996         no padding between fields.
8997       * Type parameters bound by `Copy` must now be copied explicitly with
8998         the `copy` keyword.
8999       * It is now illegal to move out of a dereferenced unsafe pointer.
9000       * `Option<~T>` is now represented as a nullable pointer.
9001       * `@mut` does dynamic borrow checks correctly.
9002       * The `main` function is only detected at the topmost level of the crate.
9003         The `#[main]` attribute is still valid anywhere.
9004       * Struct fields may no longer be mutable. Use inherited mutability.
9005       * The `#[no_send]` attribute makes a type that would otherwise be
9006         `Send`, not.
9007       * The `#[no_freeze]` attribute makes a type that would otherwise be
9008         `Freeze`, not.
9009       * Unbounded recursion will abort the process after reaching the limit
9010         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
9011       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
9012         are never implicitly copyable.
9013       * `#[static_assert]` makes compile-time assertions about static bools.
9014       * At long last, 'argument modes' no longer exist.
9015       * The rarely used `use mod` statement no longer exists.
9016
9017    * Syntax extensions
9018       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
9019         argument list.
9020       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
9021         `Rand`, `Zero` and `ToStr` can all be automatically derived with
9022         `#[deriving(...)]`.
9023       * The `bytes!` macro returns a vector of bytes for string, u8, char,
9024         and unsuffixed integer literals.
9025
9026    * Libraries
9027       * The `core` crate was renamed to `std`.
9028       * The `std` crate was renamed to `extra`.
9029       * More and improved documentation.
9030       * std: `iterator` module for external iterator objects.
9031       * Many old-style (internal, higher-order function) iterators replaced by
9032         implementations of `Iterator`.
9033       * std: Many old internal vector and string iterators,
9034         incl. `any`, `all`. removed.
9035       * std: The `finalize` method of `Drop` renamed to `drop`.
9036       * std: The `drop` method now takes `&mut self` instead of `&self`.
9037       * std: The prelude no longer re-exports any modules, only types and traits.
9038       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
9039         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
9040       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
9041         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
9042       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
9043         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
9044       * std: Many types implement `Clone`.
9045       * std: `path` type renamed to `Path`.
9046       * std: `mut` module and `Mut` type removed.
9047       * std: Many standalone functions removed in favor of methods and iterators
9048         in `vec`, `str`. In the future methods will also work as functions.
9049       * std: `reinterpret_cast` removed. Use `transmute`.
9050       * std: ascii string handling in `std::ascii`.
9051       * std: `Rand` is implemented for ~/@.
9052       * std: `run` module for spawning processes overhauled.
9053       * std: Various atomic types added to `unstable::atomic`.
9054       * std: Various types implement `Zero`.
9055       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
9056       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
9057       * std: Added `os::mkdir_recursive`.
9058       * std: Added `os::glob` function performs filesystems globs.
9059       * std: `FuzzyEq` renamed to `ApproxEq`.
9060       * std: `Map` now defines `pop` and `swap` methods.
9061       * std: `Cell` constructors converted to static methods.
9062       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
9063       * extra: `flate` module moved from `std` to `extra`.
9064       * extra: `fileinput` module for iterating over a series of files.
9065       * extra: `Complex` number type and `complex` module.
9066       * extra: `Rational` number type and `rational` module.
9067       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
9068       * extra: `term` uses terminfo now, is more correct.
9069       * extra: `arc` functions converted to methods.
9070       * extra: Implementation of fixed output size variations of SHA-2.
9071
9072    * Tooling
9073       * `unused_variables` lint mode for unused variables (default: warn).
9074       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
9075         (default: warn).
9076       * `unused_mut` lint mode for identifying unused `mut` qualifiers
9077         (default: warn).
9078       * `dead_assignment` lint mode for unread variables (default: warn).
9079       * `unnecessary_allocation` lint mode detects some heap allocations that are
9080         immediately borrowed so could be written without allocating (default: warn).
9081       * `missing_doc` lint mode (default: allow).
9082       * `unreachable_code` lint mode (default: warn).
9083       * The `rusti` command has been rewritten and a number of bugs addressed.
9084       * rustc outputs in color on more terminals.
9085       * rustc accepts a `--link-args` flag to pass arguments to the linker.
9086       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
9087       * Compiling with `-g` will make the binary record information about
9088         dynamic borrowcheck failures for debugging.
9089       * rustdoc has a nicer stylesheet.
9090       * Various improvements to rustdoc.
9091       * Improvements to rustpkg (see the detailed release notes).
9092
9093
9094 Version 0.6 (2013-04-03)
9095 ========================
9096
9097    * ~2100 changes, numerous bugfixes
9098
9099    * Syntax changes
9100       * The self type parameter in traits is now spelled `Self`
9101       * The `self` parameter in trait and impl methods must now be explicitly
9102         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
9103       * Static methods no longer require the `static` keyword and instead
9104         are distinguished by the lack of a `self` parameter
9105       * Replaced the `Durable` trait with the `'static` lifetime
9106       * The old closure type syntax with the trailing sigil has been
9107         removed in favor of the more consistent leading sigil
9108       * `super` is a keyword, and may be prefixed to paths
9109       * Trait bounds are separated with `+` instead of whitespace
9110       * Traits are implemented with `impl Trait for Type`
9111         instead of `impl Type: Trait`
9112       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
9113       * The `export` keyword has finally been removed
9114       * The `move` keyword has been removed (see "Semantic changes")
9115       * The interior mutability qualifier on vectors, `[mut T]`, has been
9116         removed. Use `&mut [T]`, etc.
9117       * `mut` is no longer valid in `~mut T`. Use inherited mutability
9118       * `fail` is no longer a keyword. Use `fail!()`
9119       * `assert` is no longer a keyword. Use `assert!()`
9120       * `log` is no longer a keyword. use `debug!`, etc.
9121       * 1-tuples may be represented as `(T,)`
9122       * Struct fields may no longer be `mut`. Use inherited mutability,
9123         `@mut T`, `core::mut` or `core::cell`
9124       * `extern mod { ... }` is no longer valid syntax for foreign
9125         function modules. Use extern blocks: `extern { ... }`
9126       * Newtype enums removed. Use tuple-structs.
9127       * Trait implementations no longer support visibility modifiers
9128       * Pattern matching over vectors improved and expanded
9129       * `const` renamed to `static` to correspond to lifetime name,
9130         and make room for future `static mut` unsafe mutable globals.
9131       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
9132       * `Clone` implementations can be automatically generated with
9133         `#[deriving(Clone)]`
9134       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
9135         instead of `foo as Bar`.
9136       * Fixed length vector types are now written as `[int, .. 3]`
9137         instead of `[int * 3]`.
9138       * Fixed length vector types can express the length as a constant
9139         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
9140
9141    * Semantic changes
9142       * Types with owned pointers or custom destructors move by default,
9143         eliminating the `move` keyword
9144       * All foreign functions are considered unsafe
9145       * &mut is now unaliasable
9146       * Writes to borrowed @mut pointers are prevented dynamically
9147       * () has size 0
9148       * The name of the main function can be customized using #[main]
9149       * The default type of an inferred closure is &fn instead of @fn
9150       * `use` statements may no longer be "chained" - they cannot import
9151         identifiers imported by previous `use` statements
9152       * `use` statements are crate relative, importing from the "top"
9153         of the crate by default. Paths may be prefixed with `super::`
9154         or `self::` to change the search behavior.
9155       * Method visibility is inherited from the implementation declaration
9156       * Structural records have been removed
9157       * Many more types can be used in static items, including enums
9158         'static-lifetime pointers and vectors
9159       * Pattern matching over vectors improved and expanded
9160       * Typechecking of closure types has been overhauled to
9161         improve inference and eliminate unsoundness
9162       * Macros leave scope at the end of modules, unless that module is
9163         tagged with #[macro_escape]
9164
9165    * Libraries
9166       * Added big integers to `std::bigint`
9167       * Removed `core::oldcomm` module
9168       * Added pipe-based `core::comm` module
9169       * Numeric traits have been reorganized under `core::num`
9170       * `vec::slice` finally returns a slice
9171       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
9172       * Containers reorganized around traits in `core::container`
9173       * `core::dvec` removed, `~[T]` is a drop-in replacement
9174       * `core::send_map` renamed to `core::hashmap`
9175       * `std::map` removed; replaced with `core::hashmap`
9176       * `std::treemap` reimplemented as an owned balanced tree
9177       * `std::deque` and `std::smallintmap` reimplemented as owned containers
9178       * `core::trie` added as a fast ordered map for integer keys
9179       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
9180       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
9181         overload the comparison operators, whereas `TotalOrd` is used
9182         by certain container types
9183
9184    * Other
9185       * Replaced the 'cargo' package manager with 'rustpkg'
9186       * Added all-purpose 'rust' tool
9187       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
9188       * rustc now *attempts* to offer spelling suggestions
9189       * Improved support for ARM and Android
9190       * Preliminary MIPS backend
9191       * Improved foreign function ABI implementation for x86, x86_64
9192       * Various memory usage improvements
9193       * Rust code may be embedded in foreign code under limited circumstances
9194       * Inline assembler supported by new asm!() syntax extension.
9195
9196
9197 Version 0.5 (2012-12-21)
9198 ===========================
9199
9200    * ~900 changes, numerous bugfixes
9201
9202    * Syntax changes
9203       * Removed `<-` move operator
9204       * Completed the transition from the `#fmt` extension syntax to `fmt!`
9205       * Removed old fixed length vector syntax - `[T]/N`
9206       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
9207       * Macros may now expand to items and statements
9208       * `a.b()` is always parsed as a method call, never as a field projection
9209       * `Eq` and `IterBytes` implementations can be automatically generated
9210         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
9211       * Removed the special crate language for `.rc` files
9212       * Function arguments may consist of any irrefutable pattern
9213
9214    * Semantic changes
9215       * `&` and `~` pointers may point to objects
9216       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
9217       * Enum variants may be structs
9218       * Destructors can be added to all nominal types with the Drop trait
9219       * Structs and nullary enum variants may be constants
9220       * Values that cannot be implicitly copied are now automatically moved
9221         without writing `move` explicitly
9222       * `&T` may now be coerced to `*T`
9223       * Coercions happen in `let` statements as well as function calls
9224       * `use` statements now take crate-relative paths
9225       * The module and type namespaces have been merged so that static
9226         method names can be resolved under the trait in which they are
9227         declared
9228
9229    * Improved support for language features
9230       * Trait inheritance works in many scenarios
9231       * More support for explicit self arguments in methods - `self`, `&self`
9232         `@self`, and `~self` all generally work as expected
9233       * Static methods work in more situations
9234       * Experimental: Traits may declare default methods for the implementations
9235         to use
9236
9237    * Libraries
9238       * New condition handling system in `core::condition`
9239       * Timsort added to `std::sort`
9240       * New priority queue, `std::priority_queue`
9241       * Pipes for serializable types, `std::flatpipes'
9242       * Serialization overhauled to be trait-based
9243       * Expanded `getopts` definitions
9244       * Moved futures to `std`
9245       * More functions are pure now
9246       * `core::comm` renamed to `oldcomm`. Still deprecated
9247       * `rustdoc` and `cargo` are libraries now
9248
9249    * Misc
9250       * Added a preliminary REPL, `rusti`
9251       * License changed from MIT to dual MIT/APL2
9252
9253
9254 Version 0.4 (2012-10-15)
9255 ==========================
9256
9257    * ~2000 changes, numerous bugfixes
9258
9259    * Syntax
9260       * All keywords are now strict and may not be used as identifiers anywhere
9261       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
9262         'of', 'with', 'to', 'class'.
9263       * Classes are replaced with simpler structs
9264       * Explicit method self types
9265       * `ret` became `return` and `alt` became `match`
9266       * `import` is now `use`; `use is now `extern mod`
9267       * `extern mod { ... }` is now `extern { ... }`
9268       * `use mod` is the recommended way to import modules
9269       * `pub` and `priv` replace deprecated export lists
9270       * The syntax of `match` pattern arms now uses fat arrow (=>)
9271       * `main` no longer accepts an args vector; use `os::args` instead
9272
9273    * Semantics
9274       * Trait implementations are now coherent, ala Haskell typeclasses
9275       * Trait methods may be static
9276       * Argument modes are deprecated
9277       * Borrowed pointers are much more mature and recommended for use
9278       * Strings and vectors in the static region are stored in constant memory
9279       * Typestate was removed
9280       * Resolution rewritten to be more reliable
9281       * Support for 'dual-mode' data structures (freezing and thawing)
9282
9283    * Libraries
9284       * Most binary operators can now be overloaded via the traits in
9285         `core::ops'
9286       * `std::net::url` for representing URLs
9287       * Sendable hash maps in `core::send_map`
9288       * `core::task' gained a (currently unsafe) task-local storage API
9289
9290    * Concurrency
9291       * An efficient new intertask communication primitive called the pipe,
9292         along with a number of higher-level channel types, in `core::pipes`
9293       * `std::arc`, an atomically reference counted, immutable, shared memory
9294         type
9295       * `std::sync`, various exotic synchronization tools based on arcs and pipes
9296       * Futures are now based on pipes and sendable
9297       * More robust linked task failure
9298       * Improved task builder API
9299
9300    * Other
9301       * Improved error reporting
9302       * Preliminary JIT support
9303       * Preliminary work on precise GC
9304       * Extensive architectural improvements to rustc
9305       * Begun a transition away from buggy C++-based reflection (shape) code to
9306         Rust-based (visitor) code
9307       * All hash functions and tables converted to secure, randomized SipHash
9308
9309
9310 Version 0.3  (2012-07-12)
9311 ========================
9312
9313    * ~1900 changes, numerous bugfixes
9314
9315    * New coding conveniences
9316       * Integer-literal suffix inference
9317       * Per-item control over warnings, errors
9318       * #[cfg(windows)] and #[cfg(unix)] attributes
9319       * Documentation comments
9320       * More compact closure syntax
9321       * 'do' expressions for treating higher-order functions as
9322         control structures
9323       * *-patterns (wildcard extended to all constructor fields)
9324
9325    * Semantic cleanup
9326       * Name resolution pass and exhaustiveness checker rewritten
9327       * Region pointers and borrow checking supersede alias
9328         analysis
9329       * Init-ness checking is now provided by a region-based liveness
9330         pass instead of the typestate pass; same for last-use analysis
9331       * Extensive work on region pointers
9332
9333    * Experimental new language features
9334       * Slices and fixed-size, interior-allocated vectors
9335       * #!-comments for lang versioning, shell execution
9336       * Destructors and iface implementation for classes;
9337         type-parameterized classes and class methods
9338       * 'const' type kind for types that can be used to implement
9339         shared-memory concurrency patterns
9340
9341    * Type reflection
9342
9343    * Removal of various obsolete features
9344       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
9345                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
9346
9347       * Constructs: do-while loops ('do' repurposed), fn binding,
9348                     resources (replaced by destructors)
9349
9350    * Compiler reorganization
9351       * Syntax-layer of compiler split into separate crate
9352       * Clang (from LLVM project) integrated into build
9353       * Typechecker split into sub-modules
9354
9355    * New library code
9356       * New time functions
9357       * Extension methods for many built-in types
9358       * Arc: atomic-refcount read-only / exclusive-use shared cells
9359       * Par: parallel map and search routines
9360       * Extensive work on libuv interface
9361       * Much vector code moved to libraries
9362       * Syntax extensions: #line, #col, #file, #mod, #stringify,
9363         #include, #include_str, #include_bin
9364
9365    * Tool improvements
9366       * Cargo automatically resolves dependencies
9367
9368
9369 Version 0.2  (2012-03-29)
9370 =========================
9371
9372    * >1500 changes, numerous bugfixes
9373
9374    * New docs and doc tooling
9375
9376    * New port: FreeBSD x86_64
9377
9378    * Compilation model enhancements
9379       * Generics now specialized, multiply instantiated
9380       * Functions now inlined across separate crates
9381
9382    * Scheduling, stack and threading fixes
9383       * Noticeably improved message-passing performance
9384       * Explicit schedulers
9385       * Callbacks from C
9386       * Helgrind clean
9387
9388    * Experimental new language features
9389       * Operator overloading
9390       * Region pointers
9391       * Classes
9392
9393    * Various language extensions
9394       * C-callback function types: 'crust fn ...'
9395       * Infinite-loop construct: 'loop { ... }'
9396       * Shorten 'mutable' to 'mut'
9397       * Required mutable-local qualifier: 'let mut ...'
9398       * Basic glob-exporting: 'export foo::*;'
9399       * Alt now exhaustive, 'alt check' for runtime-checked
9400       * Block-function form of 'for' loop, with 'break' and 'ret'.
9401
9402    * New library code
9403       * AST quasi-quote syntax extension
9404       * Revived libuv interface
9405       * New modules: core::{future, iter}, std::arena
9406       * Merged per-platform std::{os*, fs*} to core::{libc, os}
9407       * Extensive cleanup, regularization in libstd, libcore
9408
9409
9410 Version 0.1  (2012-01-20)
9411 ===============================
9412
9413    * Most language features work, including:
9414       * Unique pointers, unique closures, move semantics
9415       * Interface-constrained generics
9416       * Static interface dispatch
9417       * Stack growth
9418       * Multithread task scheduling
9419       * Typestate predicates
9420       * Failure unwinding, destructors
9421       * Pattern matching and destructuring assignment
9422       * Lightweight block-lambda syntax
9423       * Preliminary macro-by-example
9424
9425    * Compiler works with the following configurations:
9426       * Linux: x86 and x86_64 hosts and targets
9427       * macOS: x86 and x86_64 hosts and targets
9428       * Windows: x86 hosts and targets
9429
9430    * Cross compilation / multi-target configuration supported.
9431
9432    * Preliminary API-documentation and package-management tools included.
9433
9434 Known issues:
9435
9436    * Documentation is incomplete.
9437
9438    * Performance is below intended target.
9439
9440    * Standard library APIs are subject to extensive change, reorganization.
9441
9442    * Language-level versioning is not yet operational - future code will
9443      break unexpectedly.