RELEASES.md

   1 Version 1.55.0 (2021-09-09)
   2 ============================
   3
   4 Language
   5 --------
   6 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
   7   will end at the maximum value of the integer.][83918]
   8 - [You can now explicitly import the prelude of different editions
   9   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
  10
  11 Compiler
  12 --------
  13 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
  14
  15 \* Refer to Rust's [platform support page][platform-support-doc] for more
  16    information on Rust's tiered platform support.
  17
  18 Libraries
  19 ---------
  20
  21 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
  22   These improvements should in general provide faster string parsing of floats,
  23   no longer reject certain valid floating point values, and reduce
  24   the produced code size for non-stripped artifacts.
  25 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
  26
  27 Stabilised APIs
  28 ---------------
  29
  30 - [`Bound::cloned`]
  31 - [`Drain::as_str`]
  32 - [`IntoInnerError::into_error`]
  33 - [`IntoInnerError::into_parts`]
  34 - [`MaybeUninit::assume_init_mut`]
  35 - [`MaybeUninit::assume_init_ref`]
  36 - [`MaybeUninit::write`]
  37 - [`array::map`]
  38 - [`ops::ControlFlow`]
  39 - [`x86::_bittest`]
  40 - [`x86::_bittestandcomplement`]
  41 - [`x86::_bittestandreset`]
  42 - [`x86::_bittestandset`]
  43 - [`x86_64::_bittest64`]
  44 - [`x86_64::_bittestandcomplement64`]
  45 - [`x86_64::_bittestandreset64`]
  46 - [`x86_64::_bittestandset64`]
  47
  48 The following previously stable functions are now `const`.
  49
  50 - [`str::from_utf8_unchecked`]
  51
  52
  53 Cargo
  54 -----
  55 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
  56   rustc in parallel such as when using `cargo test`.][cargo/9675]
  57 - [The package definition in `cargo metadata` now includes the `"default_run"`
  58   field from the manifest.][cargo/9550]
  59 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
  60 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
  61   of packages.][cargo/9663]
  62
  63 Rustdoc
  64 -------
  65 - [Added "Go to item on exact match" search option.][85876]
  66 - [The "Implementors" section on traits no longer shows redundant
  67   method definitions.][85970]
  68 - [Trait implementations are toggled open by default.][86260] This should make the
  69   implementations more searchable by tools like `CTRL+F` in your browser.
  70 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
  71   through type aliases.][86334]
  72 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
  73   "Trait Implementations" section.][86513]
  74
  75
  76 Compatibility Notes
  77 -------------------
  78 - [std functions that return an `io::Error` will no longer use the
  79   `ErrorKind::Other` variant.][85746] This is to better reflect that these
  80   kinds of errors could be categorised [into newer more specific `ErrorKind`
  81   variants][79965], and that they do not represent a user error.
  82 - [Using environment variable names with `process::Command` on Windows now
  83   behaves as expected.][85270] Previously using envionment variables with
  84   `Command` would cause them to be ASCII-uppercased.
  85 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
  86   with `rustdoc::`][86849]
  87
  88 [86849]: https://github.com/rust-lang/rust/pull/86849
  89 [86513]: https://github.com/rust-lang/rust/pull/86513
  90 [86334]: https://github.com/rust-lang/rust/pull/86334
  91 [86260]: https://github.com/rust-lang/rust/pull/86260
  92 [85970]: https://github.com/rust-lang/rust/pull/85970
  93 [85876]: https://github.com/rust-lang/rust/pull/85876
  94 [83572]: https://github.com/rust-lang/rust/pull/83572
  95 [86294]: https://github.com/rust-lang/rust/pull/86294
  96 [86858]: https://github.com/rust-lang/rust/pull/86858
  97 [86761]: https://github.com/rust-lang/rust/pull/86761
  98 [85769]: https://github.com/rust-lang/rust/pull/85769
  99 [85746]: https://github.com/rust-lang/rust/pull/85746
 100 [85305]: https://github.com/rust-lang/rust/pull/85305
 101 [85270]: https://github.com/rust-lang/rust/pull/85270
 102 [84111]: https://github.com/rust-lang/rust/pull/84111
 103 [83918]: https://github.com/rust-lang/rust/pull/83918
 104 [79965]: https://github.com/rust-lang/rust/pull/79965
 105 [87370]: https://github.com/rust-lang/rust/pull/87370
 106 [87298]: https://github.com/rust-lang/rust/pull/87298
 107 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
 108 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
 109 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
 110 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
 111 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
 112 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
 113 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
 114 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
 115 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
 116 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
 117 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
 118 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
 119 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
 120 [`Seek::rewind`]: https://doc.rust-lang.org/stable/std/io/trait.Seek.html#method.rewind
 121 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
 122 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
 123 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
 124 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
 125 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
 126 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
 127 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
 128 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
 129 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
 130 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
 131
 132
 133 Version 1.54.0 (2021-07-29)
 134 ============================
 135
 136 Language
 137 -----------------------
 138
 139 - [You can now use macros for values in some built-in attributes.][83366]
 140   This primarily allows you to call macros within the `#[doc]` attribute. For
 141   example, to include external documentation in your crate, you can now write
 142   the following:
 143   ```rust
 144   #![doc = include_str!("README.md")]
 145   ```
 146
 147 - [You can now cast between unsized slice types (and types which contain
 148   unsized slices) in `const fn`.][85078]
 149 - [You can now use multiple generic lifetimes with `impl Trait` where the
 150    lifetimes don't explicitly outlive another.][84701] In code this means
 151    that you can now have `impl Trait<'a, 'b>` where as before you could
 152    only have `impl Trait<'a, 'b> where 'b: 'a`.
 153
 154 Compiler
 155 -----------------------
 156
 157 - [Rustc will now search for custom JSON targets in
 158   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
 159   directory.][83800] You can find your sysroot directory by running
 160   `rustc --print sysroot`.
 161 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
 162 - [You can now use `#[target_feature]` on safe functions when targeting
 163   WebAssembly platforms.][84988]
 164 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
 165 - [Added tier 3\* support for `bpfel-unknown-none`
 166    and `bpfeb-unknown-none`.][79608]
 167 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
 168
 169 \* Refer to Rust's [platform support page][platform-support-doc] for more
 170    information on Rust's tiered platform support.
 171
 172 Libraries
 173 -----------------------
 174
 175 - [`panic::panic_any` will now `#[track_caller]`.][85745]
 176 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
 177 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
 178 - [The implementations of vendor intrinsics in core::arch have been
 179    significantly refactored.][83278] The main user-visible changes are
 180    a 50% reduction in the size of libcore.rlib and stricter validation
 181    of constant operands passed to intrinsics. The latter is technically
 182    a breaking change, but allows Rust to more closely match the C vendor
 183    intrinsics API.
 184
 185 Stabilized APIs
 186 ---------------
 187
 188 - [`BTreeMap::into_keys`]
 189 - [`BTreeMap::into_values`]
 190 - [`HashMap::into_keys`]
 191 - [`HashMap::into_values`]
 192 - [`arch::wasm32`]
 193 - [`VecDeque::binary_search`]
 194 - [`VecDeque::binary_search_by`]
 195 - [`VecDeque::binary_search_by_key`]
 196 - [`VecDeque::partition_point`]
 197
 198 Cargo
 199 -----
 200
 201 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
 202   the dependency graph.][cargo/9520]
 203 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
 204   in the tree ][cargo/9499]
 205 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
 206   macro dependencies.][cargo/9488]
 207 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
 208   This variable points to a directory that integration tests and benches
 209   can use as a "scratchpad" for testing filesystem operations.
 210
 211 Compatibility Notes
 212 -------------------
 213 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
 214 - [Previously unsound code is no longer permitted where different constructors in branches
 215   could require different lifetimes.][85574]
 216 - As previously mentioned the [`std::arch` instrinsics now uses stricter const checking][83278]
 217   than before and may reject some previously accepted code.
 218 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
 219    when compiled with `codegen-units = 1`.][86063]
 220
 221 [85574]: https://github.com/rust-lang/rust/issues/85574
 222 [86831]: https://github.com/rust-lang/rust/issues/86831
 223 [86063]: https://github.com/rust-lang/rust/issues/86063
 224 [86831]: https://github.com/rust-lang/rust/issues/86831
 225 [79608]: https://github.com/rust-lang/rust/pull/79608
 226 [84988]: https://github.com/rust-lang/rust/pull/84988
 227 [84701]: https://github.com/rust-lang/rust/pull/84701
 228 [84072]: https://github.com/rust-lang/rust/pull/84072
 229 [85745]: https://github.com/rust-lang/rust/pull/85745
 230 [84744]: https://github.com/rust-lang/rust/pull/84744
 231 [85078]: https://github.com/rust-lang/rust/pull/85078
 232 [84717]: https://github.com/rust-lang/rust/pull/84717
 233 [83800]: https://github.com/rust-lang/rust/pull/83800
 234 [83366]: https://github.com/rust-lang/rust/pull/83366
 235 [83278]: https://github.com/rust-lang/rust/pull/83278
 236 [85292]: https://github.com/rust-lang/rust/pull/85292
 237 [82834]: https://github.com/rust-lang/rust/pull/82834
 238 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
 239 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
 240 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
 241 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
 242 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
 243 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
 244 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
 245 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
 246 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
 247 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
 248 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
 249
 250 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
 251
 252 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
 253
 254 Version 1.53.0 (2021-06-17)
 255 ============================
 256
 257 Language
 258 -----------------------
 259 - [You can now use unicode for identifiers.][83799] This allows multilingual
 260   identifiers but still doesn't allow glyphs that are not considered characters
 261   such as `◆` or `🦀`. More specifically you can now use any identifier that
 262   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
 263   is the same standard as languages like Python, however Rust uses NFC
 264   normalization which may be different from other languages.
 265 - [You can now specify "or patterns" inside pattern matches.][79278]
 266   Previously you could only use `|` (OR) on complete patterns. E.g.
 267   ```rust
 268   let x = Some(2u8);
 269   // Before
 270   matches!(x, Some(1) | Some(2));
 271   // Now
 272   matches!(x, Some(1 | 2));
 273   ```
 274 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
 275   has the same semantics as the `:pat` matcher. This is to allow `:pat`
 276   to change semantics to being a pattern fragment in a future edition.
 277
 278 Compiler
 279 -----------------------
 280 - [Updated the minimum external LLVM version to LLVM 10.][83387]
 281 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
 282 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
 283
 284 \* Refer to Rust's [platform support page][platform-support-doc] for more
 285 information on Rust's tiered platform support.
 286
 287 Libraries
 288 -----------------------
 289 - [Abort messages will now forward to `android_set_abort_message` on
 290   Android platforms when available.][81469]
 291 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
 292 - [Arrays of any length now implement `IntoIterator`.][84147]
 293   Currently calling `.into_iter()` as a method on an array will
 294   return `impl Iterator<Item=&T>`, but this may change in a
 295   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
 296   directly on arrays will provide `impl Iterator<Item=T>` as expected.
 297 - [`leading_zeros`, and `trailing_zeros` are now available on all
 298   `NonZero` integer types.][84082]
 299 - [`{f32, f64}::from_str` now parse and print special values
 300   (`NaN`, `-0`) according to IEEE 754.][78618]
 301 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
 302 - [Add the `BITS` associated constant to all numeric types.][82565]
 303
 304 Stabilised APIs
 305 ---------------
 306 - [`AtomicBool::fetch_update`]
 307 - [`AtomicPtr::fetch_update`]
 308 - [`BTreeMap::retain`]
 309 - [`BTreeSet::retain`]
 310 - [`BufReader::seek_relative`]
 311 - [`DebugStruct::non_exhaustive`]
 312 - [`Duration::MAX`]
 313 - [`Duration::ZERO`]
 314 - [`Duration::is_zero`]
 315 - [`Duration::saturating_add`]
 316 - [`Duration::saturating_mul`]
 317 - [`Duration::saturating_sub`]
 318 - [`ErrorKind::Unsupported`]
 319 - [`Option::insert`]
 320 - [`Ordering::is_eq`]
 321 - [`Ordering::is_ge`]
 322 - [`Ordering::is_gt`]
 323 - [`Ordering::is_le`]
 324 - [`Ordering::is_lt`]
 325 - [`Ordering::is_ne`]
 326 - [`OsStr::is_ascii`]
 327 - [`OsStr::make_ascii_lowercase`]
 328 - [`OsStr::make_ascii_uppercase`]
 329 - [`OsStr::to_ascii_lowercase`]
 330 - [`OsStr::to_ascii_uppercase`]
 331 - [`Peekable::peek_mut`]
 332 - [`Rc::decrement_strong_count`]
 333 - [`Rc::increment_strong_count`]
 334 - [`Vec::extend_from_within`]
 335 - [`array::from_mut`]
 336 - [`array::from_ref`]
 337 - [`cmp::max_by_key`]
 338 - [`cmp::max_by`]
 339 - [`cmp::min_by_key`]
 340 - [`cmp::min_by`]
 341 - [`f32::is_subnormal`]
 342 - [`f64::is_subnormal`]
 343
 344 Cargo
 345 -----------------------
 346 - [Cargo now supports git repositories where the default `HEAD` branch is not
 347   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
 348   which can handle default branches correctly.
 349 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
 350 - [The `authors` field is no longer included in `Cargo.toml` for new
 351   projects.][cargo/9282]
 352
 353 Rustdoc
 354 -----------------------
 355 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
 356   without hyperlinks.][81764]
 357
 358 Compatibility Notes
 359 -------------------
 360 - [Implement token-based handling of attributes during expansion][82608]
 361 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
 362   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
 363   to confusion and potential security vulnerabilities and [is no
 364   longer recommended][ietf6943].
 365 - [The added `BITS` constant may conflict with external definitions.][85667]
 366   In particular, this was known to be a problem in the `lexical-core` crate,
 367   but they have published fixes for semantic versions 0.4 through 0.7. To
 368   update this dependency alone, use `cargo update -p lexical-core`.
 369 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
 370
 371 Internal Only
 372 -------------
 373 These changes provide no direct user facing benefits, but represent significant
 374 improvements to the internals and overall performance of rustc and
 375 related tools.
 376
 377 - [Rework the `std::sys::windows::alloc` implementation.][83065]
 378 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
 379 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
 380 - [Rework rustdoc const type][82873]
 381
 382 [85667]: https://github.com/rust-lang/rust/pull/85667
 383 [83386]: https://github.com/rust-lang/rust/pull/83386
 384 [82771]: https://github.com/rust-lang/rust/pull/82771
 385 [84147]: https://github.com/rust-lang/rust/pull/84147
 386 [84082]: https://github.com/rust-lang/rust/pull/84082
 387 [83799]: https://github.com/rust-lang/rust/pull/83799
 388 [83681]: https://github.com/rust-lang/rust/pull/83681
 389 [83652]: https://github.com/rust-lang/rust/pull/83652
 390 [83387]: https://github.com/rust-lang/rust/pull/83387
 391 [82873]: https://github.com/rust-lang/rust/pull/82873
 392 [82864]: https://github.com/rust-lang/rust/pull/82864
 393 [82608]: https://github.com/rust-lang/rust/pull/82608
 394 [82565]: https://github.com/rust-lang/rust/pull/82565
 395 [80525]: https://github.com/rust-lang/rust/pull/80525
 396 [79278]: https://github.com/rust-lang/rust/pull/79278
 397 [78618]: https://github.com/rust-lang/rust/pull/78618
 398 [77704]: https://github.com/rust-lang/rust/pull/77704
 399 [83941]: https://github.com/rust-lang/rust/pull/83941
 400 [83065]: https://github.com/rust-lang/rust/pull/83065
 401 [81764]: https://github.com/rust-lang/rust/pull/81764
 402 [81469]: https://github.com/rust-lang/rust/pull/81469
 403 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
 404 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
 405 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
 406 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
 407 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
 408 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
 409 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
 410 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
 411 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
 412 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
 413 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
 414 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
 415 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
 416 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
 417 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
 418 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
 419 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
 420 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
 421 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
 422 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
 423 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
 424 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
 425 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
 426 [`OsStr::eq_ignore_ascii_case`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.eq_ignore_ascii_case
 427 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
 428 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
 429 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
 430 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
 431 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
 432 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
 433 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 434 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 435 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
 436 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
 437 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
 438 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
 439 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
 440 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
 441 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
 442 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 443 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 444 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
 445
 446
 447 Version 1.52.1 (2021-05-10)
 448 ============================
 449
 450 This release disables incremental compilation, unless the user has explicitly
 451 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
 452
 453 This is due to the widespread, and frequently occuring, breakage encountered by
 454 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
 455 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
 456 newly added incremental verification are still present in past stable versions,
 457 and are not yet fixed on any channel. These bugs can lead to miscompilation of
 458 Rust binaries.
 459
 460 These problems only affect incremental builds, so release builds with Cargo
 461 should not be affected unless the user has explicitly opted into incremental.
 462 Debug and check builds are affected.
 463
 464 See [84970] for more details.
 465
 466 [84970]: https://github.com/rust-lang/rust/issues/84970
 467
 468 Version 1.52.0 (2021-05-06)
 469 ============================
 470
 471 Language
 472 --------
 473 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
 474   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
 475   is allowed by default, and may become a warning or hard error in a
 476   future edition.
 477 - [You can now cast mutable references to arrays to a pointer of the same type as
 478   the element.][81479]
 479
 480 Compiler
 481 --------
 482 - [Upgraded the default LLVM to LLVM 12.][81451]
 483
 484 Added tier 3\* support for the following targets.
 485
 486 - [`s390x-unknown-linux-musl`][82166]
 487 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
 488 - [`powerpc-unknown-openbsd`][82733]
 489
 490 \* Refer to Rust's [platform support page][platform-support-doc] for more
 491 information on Rust's tiered platform support.
 492
 493 Libraries
 494 ---------
 495 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
 496 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
 497 - [`Arc<impl Error>` now implements `error::Error`.][80553]
 498 - [All integer division and remainder operations are now `const`.][80962]
 499
 500 Stabilised APIs
 501 -------------
 502 - [`Arguments::as_str`]
 503 - [`char::MAX`]
 504 - [`char::REPLACEMENT_CHARACTER`]
 505 - [`char::UNICODE_VERSION`]
 506 - [`char::decode_utf16`]
 507 - [`char::from_digit`]
 508 - [`char::from_u32_unchecked`]
 509 - [`char::from_u32`]
 510 - [`slice::partition_point`]
 511 - [`str::rsplit_once`]
 512 - [`str::split_once`]
 513
 514 The following previously stable APIs are now `const`.
 515
 516 - [`char::len_utf8`]
 517 - [`char::len_utf16`]
 518 - [`char::to_ascii_uppercase`]
 519 - [`char::to_ascii_lowercase`]
 520 - [`char::eq_ignore_ascii_case`]
 521 - [`u8::to_ascii_uppercase`]
 522 - [`u8::to_ascii_lowercase`]
 523 - [`u8::eq_ignore_ascii_case`]
 524
 525 Rustdoc
 526 -------
 527 - [Rustdoc lints are now treated as a tool lint, meaning that
 528   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
 529   Using the old style is still allowed, and will become a warning in
 530   a future release.
 531 - [Rustdoc now supports argument files.][82261]
 532 - [Rustdoc now generates smart punctuation for documentation.][79423]
 533 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
 534   ```markdown
 535   - [x] Complete
 536   - [ ] Todo
 537   ```
 538
 539 Misc
 540 ----
 541 - [You can now pass multiple filters to tests.][81356] E.g.
 542   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
 543 - [Rustup now distributes PDB symbols for the `std` library on Windows,
 544   allowing you to see `std` symbols when debugging.][82218]
 545
 546 Internal Only
 547 -------------
 548 These changes provide no direct user facing benefits, but represent significant
 549 improvements to the internals and overall performance of rustc and
 550 related tools.
 551
 552 - [Check the result cache before the DepGraph when ensuring queries][81855]
 553 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
 554 - [Only store a LocalDefId in some HIR nodes][81611]
 555 - [Store HIR attributes in a side table][79519]
 556
 557 Compatibility Notes
 558 -------------------
 559 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
 560 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
 561 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
 562 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
 563   languages in code blocks.][78429]
 564 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
 565 - [Changes in how proc macros handle whitespace may lead to panics when used
 566   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
 567 - [Turn `#[derive]` into a regular macro attribute][79078]
 568
 569 [84136]: https://github.com/rust-lang/rust/issues/84136
 570 [80763]: https://github.com/rust-lang/rust/pull/80763
 571 [82166]: https://github.com/rust-lang/rust/pull/82166
 572 [82121]: https://github.com/rust-lang/rust/pull/82121
 573 [81879]: https://github.com/rust-lang/rust/pull/81879
 574 [82261]: https://github.com/rust-lang/rust/pull/82261
 575 [82218]: https://github.com/rust-lang/rust/pull/82218
 576 [82216]: https://github.com/rust-lang/rust/pull/82216
 577 [82202]: https://github.com/rust-lang/rust/pull/82202
 578 [81855]: https://github.com/rust-lang/rust/pull/81855
 579 [81766]: https://github.com/rust-lang/rust/pull/81766
 580 [81744]: https://github.com/rust-lang/rust/pull/81744
 581 [81611]: https://github.com/rust-lang/rust/pull/81611
 582 [81479]: https://github.com/rust-lang/rust/pull/81479
 583 [81451]: https://github.com/rust-lang/rust/pull/81451
 584 [81356]: https://github.com/rust-lang/rust/pull/81356
 585 [80962]: https://github.com/rust-lang/rust/pull/80962
 586 [80553]: https://github.com/rust-lang/rust/pull/80553
 587 [80527]: https://github.com/rust-lang/rust/pull/80527
 588 [79519]: https://github.com/rust-lang/rust/pull/79519
 589 [79423]: https://github.com/rust-lang/rust/pull/79423
 590 [79208]: https://github.com/rust-lang/rust/pull/79208
 591 [78429]: https://github.com/rust-lang/rust/pull/78429
 592 [82733]: https://github.com/rust-lang/rust/pull/82733
 593 [82594]: https://github.com/rust-lang/rust/pull/82594
 594 [79078]: https://github.com/rust-lang/rust/pull/79078
 595 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
 596 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
 597 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
 598 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
 599 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
 600 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
 601 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
 602 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
 603 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
 604 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
 605 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
 606 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
 607 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
 608 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
 609 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
 610 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
 611 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
 612 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
 613 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
 614 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
 615 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
 616 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
 617
 618 Version 1.51.0 (2021-03-25)
 619 ============================
 620
 621 Language
 622 --------
 623 - [You can now parameterize items such as functions, traits, and `struct`s by constant
 624   values in addition to by types and lifetimes.][79135] Also known as "const generics"
 625   E.g. you can now write the following. Note: Only values of primitive integers,
 626   `bool`, or `char` types are currently permitted.
 627   ```rust
 628   struct GenericArray<T, const LENGTH: usize> {
 629       inner: [T; LENGTH]
 630   }
 631
 632   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
 633       const fn last(&self) -> Option<&T> {
 634           if LENGTH == 0 {
 635               None
 636           } else {
 637               Some(&self.inner[LENGTH - 1])
 638           }
 639       }
 640   }
 641   ```
 642
 643
 644 Compiler
 645 --------
 646
 647 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
 648   This option controls whether debug information is split across multiple files
 649   or packed into a single file. **Note** This option is unstable on other platforms.
 650 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
 651   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
 652 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
 653 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
 654
 655 \* Refer to Rust's [platform support page][platform-support-doc] for more
 656 information on Rust's tiered platform support.
 657
 658 Libraries
 659 ---------
 660
 661 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
 662 - [`str` now implements `AsMut<str>`.][80279]
 663 - [`u64` and `u128` now implement `From<char>`.][79502]
 664 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
 665 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
 666 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
 667 - [`io::Empty` now implements `io::Seek`.][78044]
 668 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
 669   `T: ?Sized` types.][80764]
 670 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
 671
 672
 673 Stabilized APIs
 674 ---------------
 675
 676 - [`Arc::decrement_strong_count`]
 677 - [`Arc::increment_strong_count`]
 678 - [`Once::call_once_force`]
 679 - [`Peekable::next_if_eq`]
 680 - [`Peekable::next_if`]
 681 - [`Seek::stream_position`]
 682 - [`array::IntoIter`]
 683 - [`panic::panic_any`]
 684 - [`ptr::addr_of!`]
 685 - [`ptr::addr_of_mut!`]
 686 - [`slice::fill_with`]
 687 - [`slice::split_inclusive_mut`]
 688 - [`slice::split_inclusive`]
 689 - [`slice::strip_prefix`]
 690 - [`slice::strip_suffix`]
 691 - [`str::split_inclusive`]
 692 - [`sync::OnceState`]
 693 - [`task::Wake`]
 694 - [`VecDeque::range`]
 695 - [`VecDeque::range_mut`]
 696
 697 Cargo
 698 -----
 699 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
 700   codegen option.][cargo/9112]
 701 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
 702   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
 703   to avoid unifying features of dependencies where that unification could be unwanted.
 704   Such as using the same dependency with a `std` feature in a build scripts and
 705   proc-macros, while using the `no-std` feature in the final binary. See the
 706   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
 707
 708 Rustdoc
 709 -------
 710
 711 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
 712 - [You can now provide a `--default-theme` flag which sets the default theme to use for
 713   documentation.][79642]
 714
 715 Various improvements to intra-doc links:
 716
 717 - [You can link to non-path primitives such as `slice`.][80181]
 718 - [You can link to associated items.][74489]
 719 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
 720
 721 Misc
 722 ----
 723 - [You can now pass `--include-ignored` to tests (e.g. with
 724   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
 725
 726 Compatibility Notes
 727 -------------------
 728
 729 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
 730 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
 731   could fail.][80579]
 732 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
 733   for the distributed artifacts.][81521]
 734     - `armv5te-unknown-linux-gnueabi`
 735     - `sparc64-unknown-linux-gnu`
 736     - `thumbv7neon-unknown-linux-gnueabihf`
 737     - `armv7-unknown-linux-gnueabi`
 738     - `x86_64-unknown-linux-gnux32`
 739 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
 740
 741 Internal Only
 742 -------------
 743
 744 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
 745
 746 [79135]: https://github.com/rust-lang/rust/pull/79135
 747 [74489]: https://github.com/rust-lang/rust/pull/74489
 748 [76934]: https://github.com/rust-lang/rust/pull/76934
 749 [79570]: https://github.com/rust-lang/rust/pull/79570
 750 [80181]: https://github.com/rust-lang/rust/pull/80181
 751 [79642]: https://github.com/rust-lang/rust/pull/79642
 752 [80945]: https://github.com/rust-lang/rust/pull/80945
 753 [80279]: https://github.com/rust-lang/rust/pull/80279
 754 [80053]: https://github.com/rust-lang/rust/pull/80053
 755 [79502]: https://github.com/rust-lang/rust/pull/79502
 756 [75180]: https://github.com/rust-lang/rust/pull/75180
 757 [79135]: https://github.com/rust-lang/rust/pull/79135
 758 [81521]: https://github.com/rust-lang/rust/pull/81521
 759 [80968]: https://github.com/rust-lang/rust/pull/80968
 760 [80959]: https://github.com/rust-lang/rust/pull/80959
 761 [80718]: https://github.com/rust-lang/rust/pull/80718
 762 [80653]: https://github.com/rust-lang/rust/pull/80653
 763 [80579]: https://github.com/rust-lang/rust/pull/80579
 764 [79998]: https://github.com/rust-lang/rust/pull/79998
 765 [78044]: https://github.com/rust-lang/rust/pull/78044
 766 [81455]: https://github.com/rust-lang/rust/pull/81455
 767 [80764]: https://github.com/rust-lang/rust/pull/80764
 768 [80749]: https://github.com/rust-lang/rust/pull/80749
 769 [80662]: https://github.com/rust-lang/rust/pull/80662
 770 [79134]: https://github.com/rust-lang/rust/pull/79134
 771 [80966]: https://github.com/rust-lang/rust/pull/80966
 772 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
 773 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
 774 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
 775 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
 776 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
 777 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
 778 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
 779 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
 780 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
 781 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
 782 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
 783 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
 784 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
 785 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
 786 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
 787 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
 788 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
 789 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
 790 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
 791 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
 792 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
 793 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
 794 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
 795
 796 Version 1.50.0 (2021-02-11)
 797 ============================
 798
 799 Language
 800 -----------------------
 801 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
 802   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
 803 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
 804
 805 Compiler
 806 -----------------------
 807 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
 808 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
 809 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
 810 - [Dropped support for all cloudabi targets.][78439]
 811
 812 \* Refer to Rust's [platform support page][platform-support-doc] for more
 813 information on Rust's tiered platform support.
 814
 815 Libraries
 816 -----------------------
 817
 818 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
 819 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
 820 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
 821   This value cannot be a valid file descriptor, and now means `Option<File>` takes
 822   up the same amount of space as `File`.
 823
 824 Stabilized APIs
 825 ---------------
 826
 827 - [`bool::then`]
 828 - [`btree_map::Entry::or_insert_with_key`]
 829 - [`f32::clamp`]
 830 - [`f64::clamp`]
 831 - [`hash_map::Entry::or_insert_with_key`]
 832 - [`Ord::clamp`]
 833 - [`RefCell::take`]
 834 - [`slice::fill`]
 835 - [`UnsafeCell::get_mut`]
 836
 837 The following previously stable methods are now `const`.
 838
 839 - [`IpAddr::is_ipv4`]
 840 - [`IpAddr::is_ipv6`]
 841 - [`IpAddr::is_unspecified`]
 842 - [`IpAddr::is_loopback`]
 843 - [`IpAddr::is_multicast`]
 844 - [`Ipv4Addr::octets`]
 845 - [`Ipv4Addr::is_loopback`]
 846 - [`Ipv4Addr::is_private`]
 847 - [`Ipv4Addr::is_link_local`]
 848 - [`Ipv4Addr::is_multicast`]
 849 - [`Ipv4Addr::is_broadcast`]
 850 - [`Ipv4Addr::is_documentation`]
 851 - [`Ipv4Addr::to_ipv6_compatible`]
 852 - [`Ipv4Addr::to_ipv6_mapped`]
 853 - [`Ipv6Addr::segments`]
 854 - [`Ipv6Addr::is_unspecified`]
 855 - [`Ipv6Addr::is_loopback`]
 856 - [`Ipv6Addr::is_multicast`]
 857 - [`Ipv6Addr::to_ipv4`]
 858 - [`Layout::size`]
 859 - [`Layout::align`]
 860 - [`Layout::from_size_align`]
 861 - `pow` for all integer types.
 862 - `checked_pow` for all integer types.
 863 - `saturating_pow` for all integer types.
 864 - `wrapping_pow` for all integer types.
 865 - `next_power_of_two` for all unsigned integer types.
 866 - `checked_next_power_of_two` for all unsigned integer types.
 867
 868 Cargo
 869 -----------------------
 870
 871 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
 872   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
 873 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
 874   contents of that directory for changes.][cargo/8973]
 875 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
 876
 877 Misc
 878 ----
 879
 880 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
 881 - [Running tests will now print the total time taken to execute.][75752]
 882
 883 Compatibility Notes
 884 -------------------
 885
 886 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
 887   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
 888 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
 889   unhygenic `macro_rules!` macros.][79472]
 890 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
 891   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
 892 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
 893 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
 894   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
 895 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
 896
 897 [74989]: https://github.com/rust-lang/rust/pull/74989
 898 [79261]: https://github.com/rust-lang/rust/pull/79261
 899 [79896]: https://github.com/rust-lang/rust/pull/79896
 900 [79484]: https://github.com/rust-lang/rust/pull/79484
 901 [79472]: https://github.com/rust-lang/rust/pull/79472
 902 [79270]: https://github.com/rust-lang/rust/pull/79270
 903 [79003]: https://github.com/rust-lang/rust/pull/79003
 904 [78864]: https://github.com/rust-lang/rust/pull/78864
 905 [78636]: https://github.com/rust-lang/rust/pull/78636
 906 [78439]: https://github.com/rust-lang/rust/pull/78439
 907 [78343]: https://github.com/rust-lang/rust/pull/78343
 908 [78296]: https://github.com/rust-lang/rust/pull/78296
 909 [78068]: https://github.com/rust-lang/rust/pull/78068
 910 [75752]: https://github.com/rust-lang/rust/pull/75752
 911 [74699]: https://github.com/rust-lang/rust/pull/74699
 912 [78142]: https://github.com/rust-lang/rust/pull/78142
 913 [77484]: https://github.com/rust-lang/rust/pull/77484
 914 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
 915 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
 916 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
 917 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
 918 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
 919 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
 920 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
 921 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
 922 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
 923 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
 924 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
 925 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
 926 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
 927 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
 928 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
 929 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
 930 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
 931 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
 932 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
 933 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
 934 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
 935 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
 936 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
 937 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
 938 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
 939 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
 940 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
 941 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
 942 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
 943 [`btree_map::Entry::or_insert_with_key`]: https://doc.rust-lang.org/stable/std/collections/btree_map/enum.Entry.html#method.or_insert_with_key
 944 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
 945 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
 946 [`hash_map::Entry::or_insert_with_key`]: https://doc.rust-lang.org/stable/std/collections/hash_map/enum.Entry.html#method.or_insert_with_key
 947 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
 948
 949
 950 Version 1.49.0 (2020-12-31)
 951 ============================
 952
 953 Language
 954 -----------------------
 955
 956 - [Unions can now implement `Drop`, and you can now have a field in a union
 957   with `ManuallyDrop<T>`.][77547]
 958 - [You can now cast uninhabited enums to integers.][76199]
 959 - [You can now bind by reference and by move in patterns.][76119] This
 960   allows you to selectively borrow individual components of a type. E.g.
 961   ```rust
 962   #[derive(Debug)]
 963   struct Person {
 964       name: String,
 965       age: u8,
 966   }
 967
 968   let person = Person {
 969       name: String::from("Alice"),
 970       age: 20,
 971   };
 972
 973   // `name` is moved out of person, but `age` is referenced.
 974   let Person { name, ref age } = person;
 975   println!("{} {}", name, age);
 976   ```
 977
 978 Compiler
 979 -----------------------
 980
 981 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
 982 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
 983 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
 984 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
 985 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
 986 - [Output from threads spawned in tests is now captured.][78227]
 987 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
 988
 989 \* Refer to Rust's [platform support page][platform-support-doc] for more
 990 information on Rust's tiered platform support.
 991
 992 Libraries
 993 -----------------------
 994
 995 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
 996 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
 997
 998 Stabilized APIs
 999 ---------------
1000
1001 - [`slice::select_nth_unstable`]
1002 - [`slice::select_nth_unstable_by`]
1003 - [`slice::select_nth_unstable_by_key`]
1004
1005 The following previously stable methods are now `const`.
1006
1007 - [`Poll::is_ready`]
1008 - [`Poll::is_pending`]
1009
1010 Cargo
1011 -----------------------
1012 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
1013 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
1014 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
1015   variable will be set if the crate being built is one the user selected to build, either
1016   with `-p` or through defaults.
1017 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
1018
1019
1020 Compatibility Notes
1021 -------------------
1022
1023 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
1024 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
1025 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
1026   Previously such invalid or unused attributes could be ignored.
1027 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
1028   read [this post about the changes][rustdoc-ws-post] for more details.
1029 - [Trait bounds are no longer inferred for associated types.][79904]
1030
1031 Internal Only
1032 -------------
1033 These changes provide no direct user facing benefits, but represent significant
1034 improvements to the internals and overall performance of rustc and
1035 related tools.
1036
1037 - [rustc's internal crates are now compiled using the `initial-exec` Thread
1038   Local Storage model.][78201]
1039 - [Calculate visibilities once in resolve.][78077]
1040 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
1041 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
1042
1043
1044 [75991]: https://github.com/rust-lang/rust/pull/75991
1045 [78951]: https://github.com/rust-lang/rust/pull/78951
1046 [78848]: https://github.com/rust-lang/rust/pull/78848
1047 [78746]: https://github.com/rust-lang/rust/pull/78746
1048 [78376]: https://github.com/rust-lang/rust/pull/78376
1049 [78228]: https://github.com/rust-lang/rust/pull/78228
1050 [78227]: https://github.com/rust-lang/rust/pull/78227
1051 [78201]: https://github.com/rust-lang/rust/pull/78201
1052 [78109]: https://github.com/rust-lang/rust/pull/78109
1053 [78077]: https://github.com/rust-lang/rust/pull/78077
1054 [77997]: https://github.com/rust-lang/rust/pull/77997
1055 [77703]: https://github.com/rust-lang/rust/pull/77703
1056 [77547]: https://github.com/rust-lang/rust/pull/77547
1057 [77015]: https://github.com/rust-lang/rust/pull/77015
1058 [76199]: https://github.com/rust-lang/rust/pull/76199
1059 [76119]: https://github.com/rust-lang/rust/pull/76119
1060 [75914]: https://github.com/rust-lang/rust/pull/75914
1061 [79004]: https://github.com/rust-lang/rust/pull/79004
1062 [78676]: https://github.com/rust-lang/rust/pull/78676
1063 [79904]: https://github.com/rust-lang/rust/issues/79904
1064 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
1065 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
1066 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
1067 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
1068 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
1069 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
1070 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
1071 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
1072 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
1073 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
1074 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
1075
1076 Version 1.48.0 (2020-11-19)
1077 ==========================
1078
1079 Language
1080 --------
1081
1082 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
1083   is still rejected *semantically*, but can now be parsed by procedural macros.
1084
1085 Compiler
1086 --------
1087 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
1088   `rustc` whether to link its own C runtime and libraries or to rely on a external
1089   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
1090 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
1091   Note: If you're using cargo you must explicitly pass the `--target` flag.
1092 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
1093
1094 \* Refer to Rust's [platform support page][platform-support-doc] for more
1095 information on Rust's tiered platform support.
1096
1097 Libraries
1098 ---------
1099 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
1100   and `&Stderr`.][76275]
1101 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
1102 - [The `matches!` macro now supports having a trailing comma.][74880]
1103 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
1104 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
1105
1106 Stabilized APIs
1107 ---------------
1108 - [`slice::as_ptr_range`]
1109 - [`slice::as_mut_ptr_range`]
1110 - [`VecDeque::make_contiguous`]
1111 - [`future::pending`]
1112 - [`future::ready`]
1113
1114 The following previously stable methods are now `const fn`'s:
1115
1116 - [`Option::is_some`]
1117 - [`Option::is_none`]
1118 - [`Option::as_ref`]
1119 - [`Result::is_ok`]
1120 - [`Result::is_err`]
1121 - [`Result::as_ref`]
1122 - [`Ordering::reverse`]
1123 - [`Ordering::then`]
1124
1125 Cargo
1126 -----
1127
1128 Rustdoc
1129 -------
1130 - [You can now link to items in `rustdoc` using the intra-doc link
1131   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1132   a link to `std::future`'s documentation. See ["Linking to items by
1133   name"][intradoc-links] for more information.
1134 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1135   when searching through `rustdoc`'s UI.][75740]
1136
1137 Compatibility Notes
1138 -------------------
1139 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1140   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1141   promoted to `'static` lifetime any more inside `const fn`s.
1142 - [Associated type bindings on trait objects are now verified to meet the bounds
1143   declared on the trait when checking that they implement the trait.][27675]
1144 - [When trait bounds on associated types or opaque types are ambiguous, the
1145   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1146 - [Fixed recursive nonterminals not being expanded in macros during
1147   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1148   correctly handling recursive nonterminal tokens.
1149 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1150 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1151   in places where they have no effect.][73461]
1152 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1153   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1154 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1155   disallow zero-initialization.][71274]
1156 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1157 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1158   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1159   see the [`catch_unwind`] documentation for further information.
1160
1161
1162
1163 Internal Only
1164 -------------
1165 These changes provide no direct user facing benefits, but represent significant
1166 improvements to the internals and overall performance of rustc and
1167 related tools.
1168
1169 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1170   You can continue building with `make` by setting `ninja=false` in
1171   your `config.toml`.
1172 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1173 - [Made `ensure_sufficient_stack()` non-generic][76680]
1174
1175 [78143]: https://github.com/rust-lang/rust/issues/78143
1176 [76680]: https://github.com/rust-lang/rust/pull/76680/
1177 [76030]: https://github.com/rust-lang/rust/pull/76030/
1178 [70212]: https://github.com/rust-lang/rust/pull/70212/
1179 [27675]: https://github.com/rust-lang/rust/issues/27675/
1180 [54121]: https://github.com/rust-lang/rust/issues/54121/
1181 [71274]: https://github.com/rust-lang/rust/pull/71274/
1182 [77386]: https://github.com/rust-lang/rust/pull/77386/
1183 [77153]: https://github.com/rust-lang/rust/pull/77153/
1184 [77055]: https://github.com/rust-lang/rust/pull/77055/
1185 [76275]: https://github.com/rust-lang/rust/pull/76275/
1186 [76310]: https://github.com/rust-lang/rust/pull/76310/
1187 [76420]: https://github.com/rust-lang/rust/pull/76420/
1188 [76158]: https://github.com/rust-lang/rust/pull/76158/
1189 [75857]: https://github.com/rust-lang/rust/pull/75857/
1190 [75585]: https://github.com/rust-lang/rust/pull/75585/
1191 [75740]: https://github.com/rust-lang/rust/pull/75740/
1192 [75502]: https://github.com/rust-lang/rust/pull/75502/
1193 [74880]: https://github.com/rust-lang/rust/pull/74880/
1194 [74922]: https://github.com/rust-lang/rust/pull/74922/
1195 [74430]: https://github.com/rust-lang/rust/pull/74430/
1196 [74194]: https://github.com/rust-lang/rust/pull/74194/
1197 [73461]: https://github.com/rust-lang/rust/pull/73461/
1198 [73166]: https://github.com/rust-lang/rust/pull/73166/
1199 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1200 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1201 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1202 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1203 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1204 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1205 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1206 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1207 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1208 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1209 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1210 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1211 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1212 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1213 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1214
1215
1216 Version 1.47.0 (2020-10-08)
1217 ==========================
1218
1219 Language
1220 --------
1221 - [Closures will now warn when not used.][74869]
1222
1223 Compiler
1224 --------
1225 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1226   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1227   platforms.
1228 - [Upgraded to LLVM 11.][73526]
1229 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1230 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1231 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1232
1233 \* Refer to Rust's [platform support page][platform-support-doc] for more
1234 information on Rust's tiered platform support.
1235
1236 Libraries
1237 ---------
1238 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1239 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1240   those of length less than 33.][74060]
1241 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1242 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1243   `PartialEq`, and `PartialOrd`.][73583]
1244
1245 Stabilized APIs
1246 ---------------
1247 - [`Ident::new_raw`]
1248 - [`Range::is_empty`]
1249 - [`RangeInclusive::is_empty`]
1250 - [`Result::as_deref`]
1251 - [`Result::as_deref_mut`]
1252 - [`Vec::leak`]
1253 - [`pointer::offset_from`]
1254 - [`f32::TAU`]
1255 - [`f64::TAU`]
1256
1257 The following previously stable APIs have now been made const.
1258
1259 - [The `new` method for all `NonZero` integers.][73858]
1260 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1261   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1262   methods for all integers.][73858]
1263 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1264   signed integers.][73858]
1265 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1266   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1267   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1268   `is_ascii_control` methods for `char` and `u8`.][73858]
1269
1270 Cargo
1271 -----
1272 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1273   You can override this by setting the following in your `Cargo.toml`.
1274   ```toml
1275   [profile.release.build-override]
1276   opt-level = 3
1277   ```
1278 - [`cargo-help` will now display man pages for commands rather just the
1279   `--help` text.][cargo/8456]
1280 - [`cargo-metadata` now emits a `test` field indicating if a target has
1281   tests enabled.][cargo/8478]
1282 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1283 - [`cargo-publish` will now use an alternative registry by default if it's the
1284   only registry specified in `package.publish`.][cargo/8571]
1285
1286 Misc
1287 ----
1288 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1289   type based search.][75366]
1290 - [Added the Ayu theme to rustdoc.][71237]
1291
1292 Compatibility Notes
1293 -------------------
1294 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1295 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1296 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1297   help to preserve more span information.][73084] These changes may cause
1298   compiliation errors if your macro was unhygenic or didn't correctly handle
1299   `Delimiter::None`.
1300 - [Moved support for the CloudABI target to tier 3.][75568]
1301 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1302 - [Added the `rustc-docs` component.][75560] This allows you to install
1303   and read the documentation for the compiler internal APIs. (Currently only
1304   available for `x86_64-unknown-linux-gnu`.)
1305
1306 Internal Only
1307 --------
1308
1309 - [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.
1310
1311 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1312 [75048]: https://github.com/rust-lang/rust/pull/75048/
1313 [74163]: https://github.com/rust-lang/rust/pull/74163/
1314 [71237]: https://github.com/rust-lang/rust/pull/71237/
1315 [74869]: https://github.com/rust-lang/rust/pull/74869/
1316 [73858]: https://github.com/rust-lang/rust/pull/73858/
1317 [75716]: https://github.com/rust-lang/rust/pull/75716/
1318 [75908]: https://github.com/rust-lang/rust/pull/75908/
1319 [75516]: https://github.com/rust-lang/rust/pull/75516/
1320 [75560]: https://github.com/rust-lang/rust/pull/75560/
1321 [75568]: https://github.com/rust-lang/rust/pull/75568/
1322 [75366]: https://github.com/rust-lang/rust/pull/75366/
1323 [75204]: https://github.com/rust-lang/rust/pull/75204/
1324 [74650]: https://github.com/rust-lang/rust/pull/74650/
1325 [74419]: https://github.com/rust-lang/rust/pull/74419/
1326 [73964]: https://github.com/rust-lang/rust/pull/73964/
1327 [74021]: https://github.com/rust-lang/rust/pull/74021/
1328 [74060]: https://github.com/rust-lang/rust/pull/74060/
1329 [73893]: https://github.com/rust-lang/rust/pull/73893/
1330 [73526]: https://github.com/rust-lang/rust/pull/73526/
1331 [73583]: https://github.com/rust-lang/rust/pull/73583/
1332 [73084]: https://github.com/rust-lang/rust/pull/73084/
1333 [73197]: https://github.com/rust-lang/rust/pull/73197/
1334 [72488]: https://github.com/rust-lang/rust/pull/72488/
1335 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1336 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1337 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1338 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1339 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1340 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1341 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1342 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1343 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1344 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1345 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
1346 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1347 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1348 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1349 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1350
1351
1352 Version 1.46.0 (2020-08-27)
1353 ==========================
1354
1355 Language
1356 --------
1357 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1358 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1359   const functions.][73862]
1360 - [The `#[track_caller]` attribute can now be added to functions to use the
1361   function's caller's location information for panic messages.][72445]
1362 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1363   `x.0.0` over `(x.0).0`.
1364 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1365   You currently can't use `mem::transmute` in constant functions.
1366
1367 Compiler
1368 --------
1369 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1370 - [Enabled static "Position Independent Executables" by default
1371   for `x86_64-unknown-linux-musl`.][70740]
1372
1373 Libraries
1374 ---------
1375 - [`mem::forget` is now a `const fn`.][73887]
1376 - [`String` now implements `From<char>`.][73466]
1377 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1378   integer types.][73032]
1379 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1380 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1381   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1382 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1383 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1384 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1385
1386 Stabilized APIs
1387 ---------------
1388 - [`Option::zip`]
1389 - [`vec::Drain::as_slice`]
1390
1391 Cargo
1392 -----
1393 Added a number of new environment variables that are now available when
1394 compiling your crate.
1395
1396 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1397   the specific binary being compiled and the name of the crate.
1398 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1399 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1400
1401 Compatibility Notes
1402 -------------------
1403 - [The target configuration option `abi_blacklist` has been renamed
1404   to `unsupported_abis`.][74150] The old name will still continue to work.
1405 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1406   This was previously accepted but will become a hard error in a future release.
1407 - [Rustc will fail to compile if you have a struct with
1408   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1409   allowed on `enum`s.
1410 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1411   ensure that spans have the correct information, and may cause breakage if you
1412   were relying on receiving spans with dummy information.
1413 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1414   a legacy installer that was replaced by a MSI installer a few years ago but
1415   was still being built.
1416 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1417 - [Rustc will no longer accept overlapping trait implementations that only
1418   differ in how the lifetime was bound.][72493]
1419 - [Rustc now correctly relates the lifetime of an existential associated
1420   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1421   you to pass a shorter lifetime than expected.
1422 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1423   The library will need to be installed for `rustc` to work, even though we
1424   expect it to be already available on most systems.
1425 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1426   under QEMU.][74820]
1427 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1428   exact output returned by rustc's pretty printing is an unstable
1429   implementation detail: we recommend any macro relying on it to switch to a
1430   more robust parsing system.
1431
1432 [75453]: https://github.com/rust-lang/rust/issues/75453/
1433 [74820]: https://github.com/rust-lang/rust/issues/74820/
1434 [74420]: https://github.com/rust-lang/rust/issues/74420/
1435 [74109]: https://github.com/rust-lang/rust/pull/74109/
1436 [74150]: https://github.com/rust-lang/rust/pull/74150/
1437 [73862]: https://github.com/rust-lang/rust/pull/73862/
1438 [73887]: https://github.com/rust-lang/rust/pull/73887/
1439 [73466]: https://github.com/rust-lang/rust/pull/73466/
1440 [73516]: https://github.com/rust-lang/rust/pull/73516/
1441 [73293]: https://github.com/rust-lang/rust/pull/73293/
1442 [73007]: https://github.com/rust-lang/rust/pull/73007/
1443 [73032]: https://github.com/rust-lang/rust/pull/73032/
1444 [72920]: https://github.com/rust-lang/rust/pull/72920/
1445 [72569]: https://github.com/rust-lang/rust/pull/72569/
1446 [72583]: https://github.com/rust-lang/rust/pull/72583/
1447 [72584]: https://github.com/rust-lang/rust/pull/72584/
1448 [72717]: https://github.com/rust-lang/rust/pull/72717/
1449 [72437]: https://github.com/rust-lang/rust/pull/72437/
1450 [72445]: https://github.com/rust-lang/rust/pull/72445/
1451 [72486]: https://github.com/rust-lang/rust/pull/72486/
1452 [72493]: https://github.com/rust-lang/rust/pull/72493/
1453 [72331]: https://github.com/rust-lang/rust/pull/72331/
1454 [71896]: https://github.com/rust-lang/rust/pull/71896/
1455 [71660]: https://github.com/rust-lang/rust/pull/71660/
1456 [71322]: https://github.com/rust-lang/rust/pull/71322/
1457 [70740]: https://github.com/rust-lang/rust/pull/70740/
1458 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1459 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1460 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1461 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1462 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1463
1464
1465 Version 1.45.2 (2020-08-03)
1466 ==========================
1467
1468 * [Fix bindings in tuple struct patterns][74954]
1469 * [Fix track_caller integration with trait objects][74784]
1470
1471 [74954]: https://github.com/rust-lang/rust/issues/74954
1472 [74784]: https://github.com/rust-lang/rust/issues/74784
1473
1474
1475 Version 1.45.1 (2020-07-30)
1476 ==========================
1477
1478 * [Fix const propagation with references.][73613]
1479 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1480 * [Avoid spurious implicit region bound.][74509]
1481 * [Install clippy on x.py install][74457]
1482
1483 [73613]: https://github.com/rust-lang/rust/pull/73613
1484 [73078]: https://github.com/rust-lang/rust/issues/73078
1485 [74509]: https://github.com/rust-lang/rust/pull/74509
1486 [74457]: https://github.com/rust-lang/rust/pull/74457
1487
1488
1489 Version 1.45.0 (2020-07-16)
1490 ==========================
1491
1492 Language
1493 --------
1494 - [Out of range float to int conversions using `as` has been defined as a saturating
1495   conversion.][71269] This was previously undefined behaviour, but you can use the
1496    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1497    may be desirable in rare performance sensitive situations.
1498 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1499   using `u64`.][70705]
1500 - [Function like procedural macros can now be used in expression, pattern, and  statement
1501   positions.][68717] This means you can now use a function-like procedural macro
1502   anywhere you can use a declarative (`macro_rules!`) macro.
1503
1504 Compiler
1505 --------
1506 - [You can now override individual target features through the `target-feature`
1507   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1508   equivalent to `-C target-feature=+avx2,+fma`.
1509 - [Added the `force-unwind-tables` flag.][69984] This option allows
1510   rustc to always generate unwind tables regardless of panic strategy.
1511 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1512   to include LLVM bitcode into generated `rlib`s (this is on by default).
1513 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1514 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1515 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1516 - [Upgraded to LLVM 10.][67759]
1517
1518 \* Refer to Rust's [platform support page][platform-support-doc] for more
1519 information on Rust's tiered platform support.
1520
1521
1522 Libraries
1523 ---------
1524 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1525   and `Ord`.][72239]
1526 - [`proc_macro::TokenStream` now implements `Default`.][72234]
1527 - [You can now use `char` with
1528   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1529   a range of codepoints.][72413] E.g.
1530   you can now write the following;
1531   ```rust
1532   for ch in 'a'..='z' {
1533       print!("{}", ch);
1534   }
1535   println!();
1536   // Prints "abcdefghijklmnopqrstuvwxyz"
1537   ```
1538 - [`OsString` now implements `FromStr`.][71662]
1539 - [The `saturating_neg` method has been added to all signed integer primitive
1540   types, and the `saturating_abs` method has been added for all integer
1541   primitive types.][71886]
1542 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
1543   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
1544   or `Path`.][71447]
1545 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
1546 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
1547   integer types.][69813]
1548 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
1549   integer types.][72324]
1550 - [The `fetch_update` method has been added to all atomic integer types.][71843]
1551
1552 Stabilized APIs
1553 ---------------
1554 - [`Arc::as_ptr`]
1555 - [`BTreeMap::remove_entry`]
1556 - [`Rc::as_ptr`]
1557 - [`rc::Weak::as_ptr`]
1558 - [`rc::Weak::from_raw`]
1559 - [`rc::Weak::into_raw`]
1560 - [`str::strip_prefix`]
1561 - [`str::strip_suffix`]
1562 - [`sync::Weak::as_ptr`]
1563 - [`sync::Weak::from_raw`]
1564 - [`sync::Weak::into_raw`]
1565 - [`char::UNICODE_VERSION`]
1566 - [`Span::resolved_at`]
1567 - [`Span::located_at`]
1568 - [`Span::mixed_site`]
1569 - [`unix::process::CommandExt::arg0`]
1570
1571 Cargo
1572 -----
1573
1574 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
1575   time.][cargo/8066]
1576
1577 Misc
1578 ----
1579 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
1580   `~~outdated information~~` becomes "~~outdated information~~".
1581 - [Added an emoji to Rustdoc's deprecated API message.][72014]
1582
1583 Compatibility Notes
1584 -------------------
1585 - [Trying to self initialize a static value (that is creating a value using
1586   itself) is unsound and now causes a compile error.][71140]
1587 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
1588   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
1589 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
1590   previously undocumented and not intended for public use. Rustdoc still provides
1591   a non-zero exit code on errors.
1592 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
1593   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
1594   flags while cargo is adding `embed-bitcode` itself. The recommended way to
1595   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
1596   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
1597
1598 Internals Only
1599 --------------
1600 - [Make clippy a git subtree instead of a git submodule][70655]
1601 - [Unify the undo log of all snapshot types][69464]
1602
1603 [71848]: https://github.com/rust-lang/rust/issues/71848/
1604 [73420]: https://github.com/rust-lang/rust/issues/73420/
1605 [72324]: https://github.com/rust-lang/rust/pull/72324/
1606 [71843]: https://github.com/rust-lang/rust/pull/71843/
1607 [71886]: https://github.com/rust-lang/rust/pull/71886/
1608 [72234]: https://github.com/rust-lang/rust/pull/72234/
1609 [72239]: https://github.com/rust-lang/rust/pull/72239/
1610 [72397]: https://github.com/rust-lang/rust/pull/72397/
1611 [72413]: https://github.com/rust-lang/rust/pull/72413/
1612 [72014]: https://github.com/rust-lang/rust/pull/72014/
1613 [72062]: https://github.com/rust-lang/rust/pull/72062/
1614 [72094]: https://github.com/rust-lang/rust/pull/72094/
1615 [72133]: https://github.com/rust-lang/rust/pull/72133/
1616 [67759]: https://github.com/rust-lang/rust/pull/67759/
1617 [71900]: https://github.com/rust-lang/rust/pull/71900/
1618 [71928]: https://github.com/rust-lang/rust/pull/71928/
1619 [71662]: https://github.com/rust-lang/rust/pull/71662/
1620 [71716]: https://github.com/rust-lang/rust/pull/71716/
1621 [71447]: https://github.com/rust-lang/rust/pull/71447/
1622 [71269]: https://github.com/rust-lang/rust/pull/71269/
1623 [71095]: https://github.com/rust-lang/rust/pull/71095/
1624 [71140]: https://github.com/rust-lang/rust/pull/71140/
1625 [70655]: https://github.com/rust-lang/rust/pull/70655/
1626 [70705]: https://github.com/rust-lang/rust/pull/70705/
1627 [69984]: https://github.com/rust-lang/rust/pull/69984/
1628 [69813]: https://github.com/rust-lang/rust/pull/69813/
1629 [69464]: https://github.com/rust-lang/rust/pull/69464/
1630 [68717]: https://github.com/rust-lang/rust/pull/68717/
1631 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
1632 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
1633 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
1634 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
1635 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
1636 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
1637 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
1638 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
1639 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
1640 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
1641 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
1642 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
1643 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
1644 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
1645 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
1646 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
1647 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
1648
1649
1650 Version 1.44.1 (2020-06-18)
1651 ===========================
1652
1653 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1654 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
1655 * [Fix crashes when finding backtrace on macOS.][71397]
1656 * [Clippy applies lint levels into different files.][clippy/5356]
1657
1658 [71397]: https://github.com/rust-lang/rust/issues/71397
1659 [73078]: https://github.com/rust-lang/rust/issues/73078
1660 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
1661 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
1662
1663
1664 Version 1.44.0 (2020-06-04)
1665 ==========================
1666
1667 Language
1668 --------
1669 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
1670 - [Added the `unused_braces` lint.][70081]
1671
1672 **Syntax-only changes**
1673
1674 - [Expansion-driven outline module parsing][69838]
1675 ```rust
1676 #[cfg(FALSE)]
1677 mod foo {
1678     mod bar {
1679         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
1680     }
1681 }
1682 ```
1683
1684 These are still rejected semantically, so you will likely receive an error but
1685 these changes can be seen and parsed by macros and conditional compilation.
1686
1687 Compiler
1688 --------
1689 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
1690   Additionally when in incremental mode rustc defaults to 256 codegen units.
1691 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
1692   a panic is thrown.][67502]
1693 - [Added tier 3\* support for the `aarch64-unknown-none` and
1694   `aarch64-unknown-none-softfloat` targets.][68334]
1695 - [Added tier 3 support for `arm64-apple-tvos` and
1696   `x86_64-apple-tvos` targets.][68191]
1697
1698
1699 Libraries
1700 ---------
1701 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
1702   `vec![]` to be able to be used in `const` contexts.
1703 - [`convert::Infallible` now implements `Hash`.][70281]
1704 - [`OsString` now implements `DerefMut` and `IndexMut` returning
1705   a `&mut OsStr`.][70048]
1706 - [Unicode 13 is now supported.][69929]
1707 - [`String` now implements `From<&mut str>`.][69661]
1708 - [`IoSlice` now implements `Copy`.][69403]
1709 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
1710 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
1711 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
1712   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
1713   integer types.][69373]
1714
1715 Stabilized APIs
1716 ---------------
1717 - [`PathBuf::with_capacity`]
1718 - [`PathBuf::capacity`]
1719 - [`PathBuf::clear`]
1720 - [`PathBuf::reserve`]
1721 - [`PathBuf::reserve_exact`]
1722 - [`PathBuf::shrink_to_fit`]
1723 - [`f32::to_int_unchecked`]
1724 - [`f64::to_int_unchecked`]
1725 - [`Layout::align_to`]
1726 - [`Layout::pad_to_align`]
1727 - [`Layout::array`]
1728 - [`Layout::extend`]
1729
1730 Cargo
1731 -----
1732 - [Added the `cargo tree` command which will print a tree graph of
1733   your dependencies.][cargo/8062] E.g.
1734   ```
1735     mdbook v0.3.2 (/Users/src/rust/mdbook)
1736   ├── ammonia v3.0.0
1737   │   ├── html5ever v0.24.0
1738   │   │   ├── log v0.4.8
1739   │   │   │   └── cfg-if v0.1.9
1740   │   │   ├── mac v0.1.1
1741   │   │   └── markup5ever v0.9.0
1742   │   │       ├── log v0.4.8 (*)
1743   │   │       ├── phf v0.7.24
1744   │   │       │   └── phf_shared v0.7.24
1745   │   │       │       ├── siphasher v0.2.3
1746   │   │       │       └── unicase v1.4.2
1747   │   │       │           [build-dependencies]
1748   │   │       │           └── version_check v0.1.5
1749   ...
1750   ```
1751   You can also display dependencies on multiple versions of the same crate with
1752   `cargo tree -d` (short for `cargo tree --duplicates`).
1753
1754 Misc
1755 ----
1756 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
1757   the version in the sidebar.][69494]
1758
1759 Compatibility Notes
1760 -------------------
1761 - [Rustc now correctly generates static libraries on Windows GNU targets with
1762   the `.a` extension, rather than the previous `.lib`.][70937]
1763 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
1764 - [The `file_name` property in JSON output of macro errors now points the actual
1765   source file rather than the previous format of `<NAME macros>`.][70969]
1766   **Note:** this may not point to a file that actually exists on the user's system.
1767 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
1768 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
1769   not allow zero initialization such as `NonZeroU8`.][66059] This was
1770   previously a warning.
1771 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
1772   operator has been defined as a saturating operation.][71269] This was previously
1773   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
1774   continue using the current behaviour, which may be desirable in rare performance
1775   sensitive situations.
1776
1777 Internal Only
1778 -------------
1779 These changes provide no direct user facing benefits, but represent significant
1780 improvements to the internals and overall performance of rustc and
1781 related tools.
1782
1783 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
1784 - [Replace big JS dict with JSON parsing.][71250]
1785
1786 [69373]: https://github.com/rust-lang/rust/pull/69373/
1787 [66059]: https://github.com/rust-lang/rust/pull/66059/
1788 [68191]: https://github.com/rust-lang/rust/pull/68191/
1789 [68899]: https://github.com/rust-lang/rust/pull/68899/
1790 [71147]: https://github.com/rust-lang/rust/pull/71147/
1791 [71250]: https://github.com/rust-lang/rust/pull/71250/
1792 [70937]: https://github.com/rust-lang/rust/pull/70937/
1793 [70969]: https://github.com/rust-lang/rust/pull/70969/
1794 [70632]: https://github.com/rust-lang/rust/pull/70632/
1795 [70281]: https://github.com/rust-lang/rust/pull/70281/
1796 [70345]: https://github.com/rust-lang/rust/pull/70345/
1797 [70048]: https://github.com/rust-lang/rust/pull/70048/
1798 [70081]: https://github.com/rust-lang/rust/pull/70081/
1799 [70156]: https://github.com/rust-lang/rust/pull/70156/
1800 [71269]: https://github.com/rust-lang/rust/pull/71269/
1801 [69838]: https://github.com/rust-lang/rust/pull/69838/
1802 [69929]: https://github.com/rust-lang/rust/pull/69929/
1803 [69661]: https://github.com/rust-lang/rust/pull/69661/
1804 [69778]: https://github.com/rust-lang/rust/pull/69778/
1805 [69494]: https://github.com/rust-lang/rust/pull/69494/
1806 [69403]: https://github.com/rust-lang/rust/pull/69403/
1807 [69033]: https://github.com/rust-lang/rust/pull/69033/
1808 [68692]: https://github.com/rust-lang/rust/pull/68692/
1809 [68334]: https://github.com/rust-lang/rust/pull/68334/
1810 [67502]: https://github.com/rust-lang/rust/pull/67502/
1811 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
1812 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
1813 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
1814 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
1815 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
1816 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
1817 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
1818 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
1819 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
1820 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
1821 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
1822 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
1823 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
1824
1825
1826 Version 1.43.1 (2020-05-07)
1827 ===========================
1828
1829 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
1830 * [Fixed the stabilization of AVX-512 features.][71473]
1831 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
1832
1833 [71430]: https://github.com/rust-lang/rust/pull/71430
1834 [71473]: https://github.com/rust-lang/rust/issues/71473
1835 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
1836
1837
1838 Version 1.43.0 (2020-04-23)
1839 ==========================
1840
1841 Language
1842 --------
1843 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
1844   the type inferred correctly.][68129]
1845 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
1846
1847 **Syntax only changes**
1848 - [Allow `type Foo: Ord` syntactically.][69361]
1849 - [Fuse associated and extern items up to defaultness.][69194]
1850 - [Syntactically allow `self` in all `fn` contexts.][68764]
1851 - [Merge `fn` syntax + cleanup item parsing.][68728]
1852 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
1853   For example, you may now write:
1854   ```rust
1855   macro_rules! mac_trait {
1856       ($i:item) => {
1857           trait T { $i }
1858       }
1859   }
1860   mac_trait! {
1861       fn foo() {}
1862   }
1863   ```
1864
1865 These are still rejected *semantically*, so you will likely receive an error but
1866 these changes can be seen and parsed by macros and
1867 conditional compilation.
1868
1869
1870 Compiler
1871 --------
1872 - [You can now pass multiple lint flags to rustc to override the previous
1873   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
1874   everything in the `unused` lint group except `unused-variables` which
1875   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
1876   everything in the `unused` lint group **including** `unused-variables` since
1877   the allow flag is specified before the deny flag (and therefore overridden).
1878 - [rustc will now prefer your system MinGW libraries over its bundled libraries
1879   if they are available on `windows-gnu`.][67429]
1880 - [rustc now buffers errors/warnings printed in JSON.][69227]
1881
1882 Libraries
1883 ---------
1884 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
1885   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
1886   respectively.][69538] **Note** These conversions are only available when `N`
1887   is `0..=32`.
1888 - [You can now use associated constants on floats and integers directly, rather
1889   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
1890   `f32::NAN` with no imports.
1891 - [`u8::is_ascii` is now `const`.][68984]
1892 - [`String` now implements `AsMut<str>`.][68742]
1893 - [Added the `primitive` module to `std` and `core`.][67637] This module
1894   reexports Rust's primitive types. This is mainly useful in macros
1895   where you want avoid these types being shadowed.
1896 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
1897 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
1898
1899 Stabilized APIs
1900 ---------------
1901 - [`Once::is_completed`]
1902 - [`f32::LOG10_2`]
1903 - [`f32::LOG2_10`]
1904 - [`f64::LOG10_2`]
1905 - [`f64::LOG2_10`]
1906 - [`iter::once_with`]
1907
1908 Cargo
1909 -----
1910 - [You can now set config `[profile]`s in your `.cargo/config`, or through
1911   your environment.][cargo/7823]
1912 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
1913   executable path when running integration tests or benchmarks.][cargo/7697]
1914   `<name>` is the name of your binary as-is e.g. If you wanted the executable
1915   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
1916
1917 Misc
1918 ----
1919 - [Certain checks in the `const_err` lint were deemed unrelated to const
1920   evaluation][69185], and have been moved to the `unconditional_panic` and
1921   `arithmetic_overflow` lints.
1922
1923 Compatibility Notes
1924 -------------------
1925
1926 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
1927   has been a warning since 1.36.0.
1928 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
1929   led to some instances being accepted, and now correctly emits a hard error.
1930
1931 [69340]: https://github.com/rust-lang/rust/pull/69340
1932
1933 Internal Only
1934 -------------
1935 These changes provide no direct user facing benefits, but represent significant
1936 improvements to the internals and overall performance of `rustc` and
1937 related tools.
1938
1939 - [All components are now built with `opt-level=3` instead of `2`.][67878]
1940 - [Improved how rustc generates drop code.][67332]
1941 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
1942 - [traits: preallocate 2 Vecs of known initial size][69022]
1943 - [Avoid exponential behaviour when relating types][68772]
1944 - [Skip `Drop` terminators for enum variants without drop glue][68943]
1945 - [Improve performance of coherence checks][68966]
1946 - [Deduplicate types in the generator witness][68672]
1947 - [Invert control in struct_lint_level.][68725]
1948
1949 [67332]: https://github.com/rust-lang/rust/pull/67332/
1950 [67429]: https://github.com/rust-lang/rust/pull/67429/
1951 [67637]: https://github.com/rust-lang/rust/pull/67637/
1952 [67642]: https://github.com/rust-lang/rust/pull/67642/
1953 [67878]: https://github.com/rust-lang/rust/pull/67878/
1954 [67885]: https://github.com/rust-lang/rust/pull/67885/
1955 [68129]: https://github.com/rust-lang/rust/pull/68129/
1956 [68672]: https://github.com/rust-lang/rust/pull/68672/
1957 [68725]: https://github.com/rust-lang/rust/pull/68725/
1958 [68728]: https://github.com/rust-lang/rust/pull/68728/
1959 [68738]: https://github.com/rust-lang/rust/pull/68738/
1960 [68742]: https://github.com/rust-lang/rust/pull/68742/
1961 [68764]: https://github.com/rust-lang/rust/pull/68764/
1962 [68772]: https://github.com/rust-lang/rust/pull/68772/
1963 [68943]: https://github.com/rust-lang/rust/pull/68943/
1964 [68952]: https://github.com/rust-lang/rust/pull/68952/
1965 [68966]: https://github.com/rust-lang/rust/pull/68966/
1966 [68984]: https://github.com/rust-lang/rust/pull/68984/
1967 [69022]: https://github.com/rust-lang/rust/pull/69022/
1968 [69185]: https://github.com/rust-lang/rust/pull/69185/
1969 [69194]: https://github.com/rust-lang/rust/pull/69194/
1970 [69201]: https://github.com/rust-lang/rust/pull/69201/
1971 [69227]: https://github.com/rust-lang/rust/pull/69227/
1972 [69548]: https://github.com/rust-lang/rust/pull/69548/
1973 [69256]: https://github.com/rust-lang/rust/pull/69256/
1974 [69361]: https://github.com/rust-lang/rust/pull/69361/
1975 [69366]: https://github.com/rust-lang/rust/pull/69366/
1976 [69538]: https://github.com/rust-lang/rust/pull/69538/
1977 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
1978 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
1979 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
1980 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
1981 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
1982 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
1983 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
1984 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
1985
1986
1987 Version 1.42.0 (2020-03-12)
1988 ==========================
1989
1990 Language
1991 --------
1992 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
1993   ```rust
1994   fn foo(words: &[&str]) {
1995       match words {
1996           ["Hello", "World", "!", ..] => println!("Hello World!"),
1997           ["Foo", "Bar", ..] => println!("Baz"),
1998           rest => println!("{:?}", rest),
1999       }
2000   }
2001   ```
2002 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
2003   that you can create an enum that has the exact layout and ABI of the type
2004   it contains.
2005 - [You can now use outer attribute procedural macros on inline modules.][64273]
2006 - [There are some *syntax-only* changes:][67131]
2007    - `default` is syntactically allowed before items in `trait` definitions.
2008    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
2009      leave out their bodies in favor of `;`.
2010    - Bounds on associated types in `impl`s are now syntactically allowed
2011      (e.g. `type Foo: Ord;`).
2012    - `...` (the C-variadic type) may occur syntactically directly as the type of
2013       any function parameter.
2014
2015   These are still rejected *semantically*, so you will likely receive an error
2016   but these changes can be seen and parsed by procedural macros and
2017   conditional compilation.
2018
2019 Compiler
2020 --------
2021 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
2022 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
2023 - [`Option::{expect,unwrap}` and
2024    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
2025    pointing to the location where they were called, rather than
2026    `core`'s internals. ][67887]
2027
2028 \* Refer to Rust's [platform support page][platform-support-doc] for more
2029 information on Rust's tiered platform support.
2030
2031 Libraries
2032 ---------
2033 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
2034 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
2035    to implement `Sized`.][67935]
2036 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
2037 - [`Layout::new` is now `const`.][66254]
2038 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
2039
2040
2041 Stabilized APIs
2042 ---------------
2043 - [`CondVar::wait_while`]
2044 - [`CondVar::wait_timeout_while`]
2045 - [`DebugMap::key`]
2046 - [`DebugMap::value`]
2047 - [`ManuallyDrop::take`]
2048 - [`matches!`]
2049 - [`ptr::slice_from_raw_parts_mut`]
2050 - [`ptr::slice_from_raw_parts`]
2051
2052 Cargo
2053 -----
2054 - [You no longer need to include `extern crate proc_macro;` to be able to
2055   `use proc_macro;` in the `2018` edition.][cargo/7700]
2056
2057 Compatibility Notes
2058 -------------------
2059 - [`Error::description` has been deprecated, and its use will now produce a
2060   warning.][66919] It's recommended to use `Display`/`to_string` instead.
2061
2062 [68253]: https://github.com/rust-lang/rust/pull/68253/
2063 [68348]: https://github.com/rust-lang/rust/pull/68348/
2064 [67935]: https://github.com/rust-lang/rust/pull/67935/
2065 [68339]: https://github.com/rust-lang/rust/pull/68339/
2066 [68122]: https://github.com/rust-lang/rust/pull/68122/
2067 [64273]: https://github.com/rust-lang/rust/pull/64273/
2068 [67712]: https://github.com/rust-lang/rust/pull/67712/
2069 [67887]: https://github.com/rust-lang/rust/pull/67887/
2070 [67131]: https://github.com/rust-lang/rust/pull/67131/
2071 [67233]: https://github.com/rust-lang/rust/pull/67233/
2072 [66899]: https://github.com/rust-lang/rust/pull/66899/
2073 [66919]: https://github.com/rust-lang/rust/pull/66919/
2074 [66254]: https://github.com/rust-lang/rust/pull/66254/
2075 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
2076 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
2077 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
2078 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
2079 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
2080 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
2081 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
2082 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
2083 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
2084
2085
2086 Version 1.41.1 (2020-02-27)
2087 ===========================
2088
2089 * [Always check types of static items][69145]
2090 * [Always check lifetime bounds of `Copy` impls][69145]
2091 * [Fix miscompilation in callers of `Layout::repeat`][69225]
2092
2093 [69225]: https://github.com/rust-lang/rust/issues/69225
2094 [69145]: https://github.com/rust-lang/rust/pull/69145
2095
2096
2097 Version 1.41.0 (2020-01-30)
2098 ===========================
2099
2100 Language
2101 --------
2102
2103 - [You can now pass type parameters to foreign items when implementing
2104   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
2105 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
2106   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
2107   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
2108 - [You can now use any valid identifier in a `format_args` macro.][66847]
2109   Previously identifiers starting with an underscore were not allowed.
2110 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
2111   enum variants.][66183] These are still rejected semantically, but
2112   can be seen and parsed by procedural macros and conditional compilation.
2113
2114 Compiler
2115 --------
2116
2117 - [Rustc will now warn if you have unused loop `'label`s.][66325]
2118 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
2119 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
2120 - [You can now pass an arguments file passing the `@path` syntax
2121   to rustc.][66172] Note that the format differs somewhat from what is
2122   found in other tooling; please see [the documentation][argfile-docs] for
2123   more information.
2124 - [You can now provide `--extern` flag without a path, indicating that it is
2125   available from the search path or specified with an `-L` flag.][64882]
2126
2127 \* Refer to Rust's [platform support page][platform-support-doc] for more
2128 information on Rust's tiered platform support.
2129
2130 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2131
2132 Libraries
2133 ---------
2134
2135 - [The `core::panic` module is now stable.][66771] It was already stable
2136   through `std`.
2137 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2138   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2139 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2140
2141 Stabilized APIs
2142 ---------------
2143
2144 - [`Result::map_or`]
2145 - [`Result::map_or_else`]
2146 - [`std::rc::Weak::weak_count`]
2147 - [`std::rc::Weak::strong_count`]
2148 - [`std::sync::Weak::weak_count`]
2149 - [`std::sync::Weak::strong_count`]
2150
2151 Cargo
2152 -----
2153
2154 - [Cargo will now document all the private items for binary crates
2155   by default.][cargo/7593]
2156 - [`cargo-install` will now reinstall the package if it detects that it is out
2157   of date.][cargo/7560]
2158 - [Cargo.lock now uses a more git friendly format that should help to reduce
2159   merge conflicts.][cargo/7579]
2160 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2161   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2162   optimisation level to `2` for debug builds. You can also use
2163   `[profile.<profile>.build-override]` to override build scripts and
2164   their dependencies.
2165
2166 Misc
2167 ----
2168
2169 - [You can now specify `edition` in documentation code blocks to compile the block
2170   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2171   should be compiled the 2018 edition of Rust.
2172 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2173   current theme with `--check-theme`.][54733]
2174 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2175
2176 Compatibility Notes
2177 -------------------
2178
2179 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2180   Apple targets.][apple-32bit-drop] This means that the source code is still
2181   available to build, but the targets are no longer being tested and release
2182   binaries for those platforms will no longer be distributed by the Rust project.
2183   Please refer to the linked blog post for more information.
2184
2185 [54733]: https://github.com/rust-lang/rust/pull/54733/
2186 [61351]: https://github.com/rust-lang/rust/pull/61351/
2187 [67255]: https://github.com/rust-lang/rust/pull/67255/
2188 [66661]: https://github.com/rust-lang/rust/pull/66661/
2189 [66771]: https://github.com/rust-lang/rust/pull/66771/
2190 [66847]: https://github.com/rust-lang/rust/pull/66847/
2191 [66238]: https://github.com/rust-lang/rust/pull/66238/
2192 [66277]: https://github.com/rust-lang/rust/pull/66277/
2193 [66325]: https://github.com/rust-lang/rust/pull/66325/
2194 [66172]: https://github.com/rust-lang/rust/pull/66172/
2195 [66183]: https://github.com/rust-lang/rust/pull/66183/
2196 [65879]: https://github.com/rust-lang/rust/pull/65879/
2197 [65013]: https://github.com/rust-lang/rust/pull/65013/
2198 [64882]: https://github.com/rust-lang/rust/pull/64882/
2199 [64325]: https://github.com/rust-lang/rust/pull/64325/
2200 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2201 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2202 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2203 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2204 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2205 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2206 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2207 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2208 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2209 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2210 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2211
2212 Version 1.40.0 (2019-12-19)
2213 ===========================
2214
2215 Language
2216 --------
2217 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2218   `const` contexts.][65188] e.g.
2219
2220   ```rust
2221   pub struct Point(i32, i32);
2222
2223   const ORIGIN: Point = {
2224       let constructor = Point;
2225
2226       constructor(0, 0)
2227   };
2228   ```
2229
2230 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2231   indicate that there may be variants or fields added in the future.][64639]
2232   For example this requires adding a wild-card branch (`_ => {}`) to any match
2233   statements on a non-exhaustive `enum`. [(RFC 2008)]
2234 - [You can now use function-like procedural macros in `extern` blocks and in
2235   type positions.][63931] e.g. `type Generated = macro!();`
2236 - [Function-like and attribute procedural macros can now emit
2237   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2238 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2239   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2240   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2241
2242 Compiler
2243 --------
2244 - [Added tier 3 support\* for the
2245   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2246 - [Added tier 3 support for the
2247   `aarch64-unknown-none-softfloat` target.][64589]
2248 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2249   `mips64el-unknown-linux-muslabi64` targets.][65843]
2250
2251 \* Refer to Rust's [platform support page][platform-support-doc] for more
2252   information on Rust's tiered platform support.
2253
2254 Libraries
2255 ---------
2256 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2257
2258 Stabilized APIs
2259 ---------------
2260 - [`BTreeMap::get_key_value`]
2261 - [`HashMap::get_key_value`]
2262 - [`Option::as_deref_mut`]
2263 - [`Option::as_deref`]
2264 - [`Option::flatten`]
2265 - [`UdpSocket::peer_addr`]
2266 - [`f32::to_be_bytes`]
2267 - [`f32::to_le_bytes`]
2268 - [`f32::to_ne_bytes`]
2269 - [`f64::to_be_bytes`]
2270 - [`f64::to_le_bytes`]
2271 - [`f64::to_ne_bytes`]
2272 - [`f32::from_be_bytes`]
2273 - [`f32::from_le_bytes`]
2274 - [`f32::from_ne_bytes`]
2275 - [`f64::from_be_bytes`]
2276 - [`f64::from_le_bytes`]
2277 - [`f64::from_ne_bytes`]
2278 - [`mem::take`]
2279 - [`slice::repeat`]
2280 - [`todo!`]
2281
2282 Cargo
2283 -----
2284 - [Cargo will now always display warnings, rather than only on
2285   fresh builds.][cargo/7450]
2286 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2287   now produce an error.][cargo/7507] Previously these flags were ignored.
2288 - [You can now publish `dev-dependencies` without including
2289   a `version`.][cargo/7333]
2290
2291 Misc
2292 ----
2293 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2294   when running documentation tests with `rustdoc`.][63803]
2295
2296 Compatibility Notes
2297 -------------------
2298 - [As previously announced, any previous NLL warnings in the 2015 edition are
2299   now hard errors.][64221]
2300 - [The `include!` macro will now warn if it failed to include the
2301   entire file.][64284] The `include!` macro unintentionally only includes the
2302   first _expression_ in a file, and this can be unintuitive. This will become
2303   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2304 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2305   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2306   or `extern` blocks now correctly emits a hard error.
2307
2308 [65294]: https://github.com/rust-lang/rust/pull/65294/
2309 [66103]: https://github.com/rust-lang/rust/pull/66103/
2310 [65843]: https://github.com/rust-lang/rust/pull/65843/
2311 [65188]: https://github.com/rust-lang/rust/pull/65188/
2312 [65092]: https://github.com/rust-lang/rust/pull/65092/
2313 [64589]: https://github.com/rust-lang/rust/pull/64589/
2314 [64639]: https://github.com/rust-lang/rust/pull/64639/
2315 [64221]: https://github.com/rust-lang/rust/pull/64221/
2316 [64284]: https://github.com/rust-lang/rust/pull/64284/
2317 [63931]: https://github.com/rust-lang/rust/pull/63931/
2318 [64035]: https://github.com/rust-lang/rust/pull/64035/
2319 [63674]: https://github.com/rust-lang/rust/pull/63674/
2320 [63803]: https://github.com/rust-lang/rust/pull/63803/
2321 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2322 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2323 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
2324 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2325 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2326 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2327 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2328 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2329 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2330 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2331 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2332 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2333 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2334 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2335 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2336 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2337 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2338 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2339 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2340 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2341 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2342 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2343 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2344 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2345 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2346 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2347
2348
2349 Version 1.39.0 (2019-11-07)
2350 ===========================
2351
2352 Language
2353 --------
2354 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2355   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2356 - [You can now use certain attributes on function, closure, and function pointer
2357   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2358   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2359   attributes applied to items. e.g.
2360   ```rust
2361   fn len(
2362       #[cfg(windows)] slice: &[u16],
2363       #[cfg(not(windows))] slice: &[u8],
2364   ) -> usize {
2365       slice.len()
2366   }
2367   ```
2368 - [You can now take shared references to bind-by-move patterns in the `if` guards
2369   of `match` arms.][63118] e.g.
2370   ```rust
2371   fn main() {
2372       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2373
2374       match array {
2375           nums
2376   //      ---- `nums` is bound by move.
2377               if nums.iter().sum::<u8>() == 10
2378   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2379           => {
2380               drop(nums);
2381   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2382           }
2383           _ => unreachable!(),
2384       }
2385   }
2386   ```
2387
2388
2389
2390 Compiler
2391 --------
2392 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2393 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2394 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2395   **Note** Cargo currently doesn't use this feature. Refer to
2396   [cargo#7315][cargo/7315] to track this feature's progress.
2397 - [You can now pass `--show-output` argument to test binaries to print the
2398   output of successful tests.][62600]
2399
2400
2401 \* Refer to Rust's [platform support page][platform-support-doc] for more
2402 information on Rust's tiered platform support.
2403
2404 Libraries
2405 ---------
2406 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2407 - [`LinkedList::new` is now a `const` function.][63684]
2408 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2409 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2410   now `const`.][63786]
2411
2412 Stabilized APIs
2413 ---------------
2414 - [`Pin::into_inner`]
2415 - [`Instant::checked_duration_since`]
2416 - [`Instant::saturating_duration_since`]
2417
2418 Cargo
2419 -----
2420 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2421 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2422   `--all` is now deprecated.
2423
2424 Misc
2425 ----
2426 - [You can now pass `-Clinker` to rustdoc to control the linker used
2427   for compiling doctests.][63834]
2428
2429 Compatibility Notes
2430 -------------------
2431 - [Code that was previously accepted by the old borrow checker, but rejected by
2432   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2433   previously a warning, and will also become a hard error in the Rust 2015
2434   edition in the 1.40.0 release.
2435 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2436   run tests.][63827] This should improve performance when running a large
2437   amount of doctests.
2438 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2439   recommended to use the `?` operator instead.
2440 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2441   returned `0.0`.
2442
2443 [62600]: https://github.com/rust-lang/rust/pull/62600/
2444 [62672]: https://github.com/rust-lang/rust/pull/62672/
2445 [63118]: https://github.com/rust-lang/rust/pull/63118/
2446 [63209]: https://github.com/rust-lang/rust/pull/63209/
2447 [63402]: https://github.com/rust-lang/rust/pull/63402/
2448 [63565]: https://github.com/rust-lang/rust/pull/63565/
2449 [63595]: https://github.com/rust-lang/rust/pull/63595/
2450 [63684]: https://github.com/rust-lang/rust/pull/63684/
2451 [63698]: https://github.com/rust-lang/rust/pull/63698/
2452 [63770]: https://github.com/rust-lang/rust/pull/63770/
2453 [63786]: https://github.com/rust-lang/rust/pull/63786/
2454 [63827]: https://github.com/rust-lang/rust/pull/63827/
2455 [63834]: https://github.com/rust-lang/rust/pull/63834/
2456 [63927]: https://github.com/rust-lang/rust/pull/63927/
2457 [63933]: https://github.com/rust-lang/rust/pull/63933/
2458 [63934]: https://github.com/rust-lang/rust/pull/63934/
2459 [63938]: https://github.com/rust-lang/rust/pull/63938/
2460 [63940]: https://github.com/rust-lang/rust/pull/63940/
2461 [63941]: https://github.com/rust-lang/rust/pull/63941/
2462 [63945]: https://github.com/rust-lang/rust/pull/63945/
2463 [64010]: https://github.com/rust-lang/rust/pull/64010/
2464 [64028]: https://github.com/rust-lang/rust/pull/64028/
2465 [64334]: https://github.com/rust-lang/rust/pull/64334/
2466 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2467 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2468 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2469 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2470 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2471 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2472
2473 Version 1.38.0 (2019-09-26)
2474 ==========================
2475
2476 Language
2477 --------
2478 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2479 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2480
2481 Compiler
2482 --------
2483 - [Added pipelined compilation support to `rustc`.][62766] This will
2484   improve compilation times in some cases. For further information please refer
2485   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2486 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2487   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2488   `x86_64-uwp-windows-msvc` targets.][60260]
2489 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2490   `armv7-unknown-linux-musleabi` targets.][63107]
2491 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2492 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2493 - [Upgraded to LLVM 9.][62592]
2494
2495 \* Refer to Rust's [platform support page][platform-support-doc] for more
2496 information on Rust's tiered platform support.
2497
2498 Libraries
2499 ---------
2500 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2501 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2502   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2503   is available at `std::clone::Clone`). This also makes all built-in macros
2504   available in `std`/`core` root. e.g. `std::include_bytes!`.
2505 - [`str::Chars` now implements `Debug`.][63000]
2506 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2507 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2508 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2509 - [Added euclidean remainder and division operations (`div_euclid`,
2510   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2511   `overflowing`, and `wrapping` versions are available for all
2512   integer primitives.
2513 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2514   `PartialEq`.][61491]
2515 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2516
2517 Stabilized APIs
2518 ---------------
2519 - [`<*const T>::cast`]
2520 - [`<*mut T>::cast`]
2521 - [`Duration::as_secs_f32`]
2522 - [`Duration::as_secs_f64`]
2523 - [`Duration::div_f32`]
2524 - [`Duration::div_f64`]
2525 - [`Duration::from_secs_f32`]
2526 - [`Duration::from_secs_f64`]
2527 - [`Duration::mul_f32`]
2528 - [`Duration::mul_f64`]
2529 - [`any::type_name`]
2530
2531 Cargo
2532 -----
2533 - [Added pipelined compilation support to `cargo`.][cargo/7143]
2534 - [You can now pass the `--features` option multiple times to enable
2535   multiple features.][cargo/7084]
2536
2537 Rustdoc
2538 -------
2539
2540 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
2541
2542 Misc
2543 ----
2544 - [`rustc` will now warn about some incorrect uses of
2545   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
2546
2547 Compatibility Notes
2548 -------------------
2549 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
2550   1.38.0.
2551 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
2552   issues][62896] with certain crates such as libc.
2553
2554 [60260]: https://github.com/rust-lang/rust/pull/60260/
2555 [61457]: https://github.com/rust-lang/rust/pull/61457/
2556 [61491]: https://github.com/rust-lang/rust/pull/61491/
2557 [61884]: https://github.com/rust-lang/rust/pull/61884/
2558 [61953]: https://github.com/rust-lang/rust/pull/61953/
2559 [62042]: https://github.com/rust-lang/rust/pull/62042/
2560 [62528]: https://github.com/rust-lang/rust/pull/62528/
2561 [62583]: https://github.com/rust-lang/rust/pull/62583/
2562 [62735]: https://github.com/rust-lang/rust/pull/62735/
2563 [62766]: https://github.com/rust-lang/rust/pull/62766/
2564 [62784]: https://github.com/rust-lang/rust/pull/62784/
2565 [62592]: https://github.com/rust-lang/rust/pull/62592/
2566 [62785]: https://github.com/rust-lang/rust/issues/62785/
2567 [62814]: https://github.com/rust-lang/rust/pull/62814/
2568 [62896]: https://github.com/rust-lang/rust/issues/62896/
2569 [63000]: https://github.com/rust-lang/rust/pull/63000/
2570 [63056]: https://github.com/rust-lang/rust/pull/63056/
2571 [63107]: https://github.com/rust-lang/rust/pull/63107/
2572 [63346]: https://github.com/rust-lang/rust/pull/63346/
2573 [63421]: https://github.com/rust-lang/rust/pull/63421/
2574 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
2575 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
2576 [63048]: https://github.com/rust-lang/rust/pull/63048
2577 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2578 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2579 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
2580 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
2581 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
2582 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
2583 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
2584 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
2585 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
2586 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
2587 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
2588 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
2589 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
2590
2591 Version 1.37.0 (2019-08-15)
2592 ==========================
2593
2594 Language
2595 --------
2596 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
2597   [`Box`][62228], or an [array][62235] and unused.
2598 - [You can now use the `cfg` and `cfg_attr` attributes on
2599   generic parameters.][61547]
2600 - [You can now use enum variants through type alias.][61682] e.g. You can
2601   write the following:
2602   ```rust
2603   type MyOption = Option<u8>;
2604
2605   fn increment_or_zero(x: MyOption) -> u8 {
2606       match x {
2607           MyOption::Some(y) => y + 1,
2608           MyOption::None => 0,
2609       }
2610   }
2611   ```
2612 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
2613   `const _: u32 = 5;`.
2614 - [You can now use `#[repr(align(X)]` on enums.][61229]
2615 - [The  `?` Kleene macro operator is now available in the
2616   2015 edition.][60932]
2617
2618 Compiler
2619 --------
2620 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
2621   and `-C profile-use` flags.][61268] For more information on how to use profile
2622   guided optimization, please refer to the [rustc book][rustc-book-pgo].
2623 - [The `rust-lldb` wrapper script should now work again.][61827]
2624
2625 Libraries
2626 ---------
2627 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
2628
2629 Stabilized APIs
2630 ---------------
2631 - [`BufReader::buffer`]
2632 - [`BufWriter::buffer`]
2633 - [`Cell::from_mut`]
2634 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
2635 - [`DoubleEndedIterator::nth_back`]
2636 - [`Option::xor`]
2637 - [`Wrapping::reverse_bits`]
2638 - [`i128::reverse_bits`]
2639 - [`i16::reverse_bits`]
2640 - [`i32::reverse_bits`]
2641 - [`i64::reverse_bits`]
2642 - [`i8::reverse_bits`]
2643 - [`isize::reverse_bits`]
2644 - [`slice::copy_within`]
2645 - [`u128::reverse_bits`]
2646 - [`u16::reverse_bits`]
2647 - [`u32::reverse_bits`]
2648 - [`u64::reverse_bits`]
2649 - [`u8::reverse_bits`]
2650 - [`usize::reverse_bits`]
2651
2652 Cargo
2653 -----
2654 - [`Cargo.lock` files are now included by default when publishing executable crates
2655   with executables.][cargo/7026]
2656 - [You can now specify `default-run="foo"` in `[package]` to specify the
2657   default executable to use for `cargo run`.][cargo/7056]
2658
2659 Misc
2660 ----
2661
2662 Compatibility Notes
2663 -------------------
2664 - [Using `...` for inclusive range patterns will now warn by default.][61342]
2665   Please transition your code to using the `..=` syntax for inclusive
2666   ranges instead.
2667 - [Using a trait object without the `dyn` will now warn by default.][61203]
2668   Please transition your code to use `dyn Trait` for trait objects instead.
2669
2670 [62228]: https://github.com/rust-lang/rust/pull/62228/
2671 [62235]: https://github.com/rust-lang/rust/pull/62235/
2672 [61802]: https://github.com/rust-lang/rust/pull/61802/
2673 [61827]: https://github.com/rust-lang/rust/pull/61827/
2674 [61547]: https://github.com/rust-lang/rust/pull/61547/
2675 [61682]: https://github.com/rust-lang/rust/pull/61682/
2676 [61268]: https://github.com/rust-lang/rust/pull/61268/
2677 [61342]: https://github.com/rust-lang/rust/pull/61342/
2678 [61347]: https://github.com/rust-lang/rust/pull/61347/
2679 [61100]: https://github.com/rust-lang/rust/pull/61100/
2680 [61203]: https://github.com/rust-lang/rust/pull/61203/
2681 [61229]: https://github.com/rust-lang/rust/pull/61229/
2682 [60932]: https://github.com/rust-lang/rust/pull/60932/
2683 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
2684 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
2685 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
2686 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
2687 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
2688 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
2689 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
2690 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
2691 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
2692 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
2693 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
2694 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
2695 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
2696 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
2697 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
2698 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
2699 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
2700 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
2701 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
2702 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
2703 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
2704 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
2705 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
2706 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
2707
2708
2709 Version 1.36.0 (2019-07-04)
2710 ==========================
2711
2712 Language
2713 --------
2714 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
2715 - [The order of traits in trait objects no longer affects the semantics of that
2716   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
2717   `dyn fmt::Debug + Send`, where this was previously not the case.
2718
2719 Libraries
2720 ---------
2721 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
2722 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
2723 - [`mem::needs_drop` is now available as a const fn.][60364]
2724 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
2725 - [`String` now implements `BorrowMut<str>`.][60404]
2726 - [`io::Cursor` now implements `Default`.][60234]
2727 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
2728 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
2729   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
2730   environment has access to heap memory allocation.
2731 - [`String` now implements `From<&String>`.][59825]
2732 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
2733   return a tuple of each argument when there is multiple arguments.
2734 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
2735   not used.][59648]
2736
2737 Stabilized APIs
2738 ---------------
2739 - [`VecDeque::rotate_left`]
2740 - [`VecDeque::rotate_right`]
2741 - [`Iterator::copied`]
2742 - [`io::IoSlice`]
2743 - [`io::IoSliceMut`]
2744 - [`Read::read_vectored`]
2745 - [`Write::write_vectored`]
2746 - [`str::as_mut_ptr`]
2747 - [`mem::MaybeUninit`]
2748 - [`pointer::align_offset`]
2749 - [`future::Future`]
2750 - [`task::Context`]
2751 - [`task::RawWaker`]
2752 - [`task::RawWakerVTable`]
2753 - [`task::Waker`]
2754 - [`task::Poll`]
2755
2756 Cargo
2757 -----
2758 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
2759 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
2760
2761 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
2762
2763 Clippy
2764 ------
2765 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
2766
2767 Misc
2768 ----
2769
2770 Compatibility Notes
2771 -------------------
2772 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
2773   longer recommended, and will be deprecated in 1.39.0.
2774
2775 [60318]: https://github.com/rust-lang/rust/pull/60318/
2776 [60364]: https://github.com/rust-lang/rust/pull/60364/
2777 [60370]: https://github.com/rust-lang/rust/pull/60370/
2778 [60404]: https://github.com/rust-lang/rust/pull/60404/
2779 [60234]: https://github.com/rust-lang/rust/pull/60234/
2780 [60244]: https://github.com/rust-lang/rust/pull/60244/
2781 [58623]: https://github.com/rust-lang/rust/pull/58623/
2782 [59648]: https://github.com/rust-lang/rust/pull/59648/
2783 [59675]: https://github.com/rust-lang/rust/pull/59675/
2784 [59825]: https://github.com/rust-lang/rust/pull/59825/
2785 [59826]: https://github.com/rust-lang/rust/pull/59826/
2786 [59445]: https://github.com/rust-lang/rust/pull/59445/
2787 [59114]: https://github.com/rust-lang/rust/pull/59114/
2788 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
2789 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
2790 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
2791 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
2792 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
2793 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
2794 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
2795 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
2796 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
2797 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
2798 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
2799 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
2800 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
2801 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
2802 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
2803 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
2804 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
2805 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
2806 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
2807 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
2808
2809
2810 Version 1.35.0 (2019-05-23)
2811 ==========================
2812
2813 Language
2814 --------
2815 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
2816   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
2817 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
2818   ```rust
2819   unsafe fn call_unsafe(func: unsafe fn()) {
2820       func()
2821   }
2822
2823   pub fn main() {
2824       unsafe { call_unsafe(|| {}); }
2825   }
2826   ```
2827
2828
2829 Compiler
2830 --------
2831 - [Added the `armv6-unknown-freebsd-gnueabihf` and
2832   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
2833 - [Added the `wasm32-unknown-wasi` target.][59464]
2834
2835
2836 Libraries
2837 ---------
2838 - [`Thread` will now show its ID in `Debug` output.][59460]
2839 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
2840 - [`alloc::System` now implements `Default`.][59451]
2841 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
2842   last field.][59076]
2843 - [`char::{ToLowercase, ToUppercase}` now
2844   implement `ExactSizeIterator`.][58778]
2845 - [All `NonZero` numeric types now implement `FromStr`.][58717]
2846 - [Removed the `Read` trait bounds
2847   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
2848 - [You can now call the `dbg!` macro without any parameters to print the file
2849   and line where it is called.][57847]
2850 - [In place ASCII case conversions are now up to 4× faster.][59283]
2851   e.g. `str::make_ascii_lowercase`
2852 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
2853   and `Send`.][58369]
2854
2855 Stabilized APIs
2856 ---------------
2857 - [`f32::copysign`]
2858 - [`f64::copysign`]
2859 - [`RefCell::replace_with`]
2860 - [`RefCell::map_split`]
2861 - [`ptr::hash`]
2862 - [`Range::contains`]
2863 - [`RangeFrom::contains`]
2864 - [`RangeTo::contains`]
2865 - [`RangeInclusive::contains`]
2866 - [`RangeToInclusive::contains`]
2867 - [`Option::copied`]
2868
2869 Cargo
2870 -----
2871 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
2872   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
2873   platform specific.
2874
2875 Misc
2876 ----
2877 - [The Rust toolchain is now available natively for musl based distros.][58575]
2878
2879 [59460]: https://github.com/rust-lang/rust/pull/59460/
2880 [59464]: https://github.com/rust-lang/rust/pull/59464/
2881 [59500]: https://github.com/rust-lang/rust/pull/59500/
2882 [59512]: https://github.com/rust-lang/rust/pull/59512/
2883 [59580]: https://github.com/rust-lang/rust/pull/59580/
2884 [59283]: https://github.com/rust-lang/rust/pull/59283/
2885 [59451]: https://github.com/rust-lang/rust/pull/59451/
2886 [59076]: https://github.com/rust-lang/rust/pull/59076/
2887 [58778]: https://github.com/rust-lang/rust/pull/58778/
2888 [58717]: https://github.com/rust-lang/rust/pull/58717/
2889 [58369]: https://github.com/rust-lang/rust/pull/58369/
2890 [58423]: https://github.com/rust-lang/rust/pull/58423/
2891 [58080]: https://github.com/rust-lang/rust/pull/58080/
2892 [57847]: https://github.com/rust-lang/rust/pull/57847/
2893 [58575]: https://github.com/rust-lang/rust/pull/58575
2894 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
2895 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
2896 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
2897 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
2898 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
2899 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
2900 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
2901 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
2902 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
2903 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
2904 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
2905 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
2906
2907 Version 1.34.2 (2019-05-14)
2908 ===========================
2909
2910 * [Destabilize the `Error::type_id` function due to a security
2911    vulnerability][60785] ([CVE-2019-12083])
2912
2913 [60785]: https://github.com/rust-lang/rust/pull/60785
2914 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
2915
2916 Version 1.34.1 (2019-04-25)
2917 ===========================
2918
2919 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
2920 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
2921 * [Fix Clippy panic when checking some macros][clippy/3805]
2922
2923 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
2924 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
2925 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
2926
2927 Version 1.34.0 (2019-04-11)
2928 ==========================
2929
2930 Language
2931 --------
2932 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
2933   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
2934   but had no effect.
2935 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
2936   `#[attr{}]` procedural macros.][57367]
2937 - [You can now write `extern crate self as foo;`][57407] to import your
2938   crate's root into the extern prelude.
2939
2940
2941 Compiler
2942 --------
2943 - [You can now target `riscv64imac-unknown-none-elf` and
2944   `riscv64gc-unknown-none-elf`.][58406]
2945 - [You can now enable linker plugin LTO optimisations with
2946   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
2947   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
2948   boundaries.
2949 - [You can now target `powerpc64-unknown-freebsd`.][57809]
2950
2951
2952 Libraries
2953 ---------
2954 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
2955   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
2956   the `Hash` trait to create an iterator.
2957 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
2958   methods.][58421] Most notably you no longer require the `Ord` trait to create
2959   an iterator.
2960 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
2961   for all numeric types.][58044]
2962 - [Indexing a `str` is now generic over all types that
2963   implement `SliceIndex<str>`.][57604]
2964 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
2965   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
2966   produce a warning if their returning type is unused.
2967 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
2968   `overflowing_pow` are now available for all numeric types.][57873] These are
2969   equivalent to methods such as `wrapping_add` for the `pow` operation.
2970
2971
2972 Stabilized APIs
2973 ---------------
2974
2975 #### std & core
2976 * [`Any::type_id`]
2977 * [`Error::type_id`]
2978 * [`atomic::AtomicI16`]
2979 * [`atomic::AtomicI32`]
2980 * [`atomic::AtomicI64`]
2981 * [`atomic::AtomicI8`]
2982 * [`atomic::AtomicU16`]
2983 * [`atomic::AtomicU32`]
2984 * [`atomic::AtomicU64`]
2985 * [`atomic::AtomicU8`]
2986 * [`convert::Infallible`]
2987 * [`convert::TryFrom`]
2988 * [`convert::TryInto`]
2989 * [`iter::from_fn`]
2990 * [`iter::successors`]
2991 * [`num::NonZeroI128`]
2992 * [`num::NonZeroI16`]
2993 * [`num::NonZeroI32`]
2994 * [`num::NonZeroI64`]
2995 * [`num::NonZeroI8`]
2996 * [`num::NonZeroIsize`]
2997 * [`slice::sort_by_cached_key`]
2998 * [`str::escape_debug`]
2999 * [`str::escape_default`]
3000 * [`str::escape_unicode`]
3001 * [`str::split_ascii_whitespace`]
3002
3003 #### std
3004 * [`Instant::checked_add`]
3005 * [`Instant::checked_sub`]
3006 * [`SystemTime::checked_add`]
3007 * [`SystemTime::checked_sub`]
3008
3009 Cargo
3010 -----
3011 - [You can now use alternative registries to crates.io.][cargo/6654]
3012
3013 Misc
3014 ----
3015 - [You can now use the `?` operator in your documentation tests without manually
3016   adding `fn main() -> Result<(), _> {}`.][56470]
3017
3018 Compatibility Notes
3019 -------------------
3020 - [`Command::before_exec` is being replaced by the unsafe method
3021   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
3022 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
3023   can now use `const` functions in `static` variables.
3024
3025 [58370]: https://github.com/rust-lang/rust/pull/58370/
3026 [58406]: https://github.com/rust-lang/rust/pull/58406/
3027 [58421]: https://github.com/rust-lang/rust/pull/58421/
3028 [58166]: https://github.com/rust-lang/rust/pull/58166/
3029 [58044]: https://github.com/rust-lang/rust/pull/58044/
3030 [58057]: https://github.com/rust-lang/rust/pull/58057/
3031 [58059]: https://github.com/rust-lang/rust/pull/58059/
3032 [57809]: https://github.com/rust-lang/rust/pull/57809/
3033 [57873]: https://github.com/rust-lang/rust/pull/57873/
3034 [57604]: https://github.com/rust-lang/rust/pull/57604/
3035 [57367]: https://github.com/rust-lang/rust/pull/57367/
3036 [57407]: https://github.com/rust-lang/rust/pull/57407/
3037 [57425]: https://github.com/rust-lang/rust/pull/57425/
3038 [57106]: https://github.com/rust-lang/rust/pull/57106/
3039 [56470]: https://github.com/rust-lang/rust/pull/56470/
3040 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
3041 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
3042 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
3043 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
3044 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
3045 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
3046 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
3047 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
3048 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
3049 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
3050 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
3051 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
3052 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
3053 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
3054 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
3055 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
3056 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
3057 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
3058 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
3059 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
3060 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
3061 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
3062 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
3063 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
3064 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
3065 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
3066 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
3067 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
3068 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
3069 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
3070 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
3071
3072
3073 Version 1.33.0 (2019-02-28)
3074 ==========================
3075
3076 Language
3077 --------
3078 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
3079   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
3080 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
3081   E.g. You can have match statement on a `u8` that covers `0..=255` and
3082   you would no longer be required to have a `_ => unreachable!()` case.
3083 - [You can now have multiple patterns in `if let` and `while let`
3084   expressions.][57532] You can do this with the same syntax as a `match`
3085   expression. E.g.
3086   ```rust
3087   enum Creature {
3088       Crab(String),
3089       Lobster(String),
3090       Person(String),
3091   }
3092
3093   fn main() {
3094       let state = Creature::Crab("Ferris");
3095
3096       if let Creature::Crab(name) | Creature::Person(name) = state {
3097           println!("This creature's name is: {}", name);
3098       }
3099   }
3100   ```
3101 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
3102   this feature will by default produce a warning as this behaviour can be
3103   unintuitive. E.g. `if let _ = 5 {}`
3104 - [You can now use `let` bindings, assignments, expression statements,
3105   and irrefutable pattern destructuring in const functions.][57175]
3106 - [You can now call unsafe const functions.][57067] E.g.
3107   ```rust
3108   const unsafe fn foo() -> i32 { 5 }
3109   const fn bar() -> i32 {
3110       unsafe { foo() }
3111   }
3112   ```
3113 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
3114   E.g. `#[cfg_attr(all(), must_use, optimize)]`
3115 - [You can now specify a specific alignment with the `#[repr(packed)]`
3116   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
3117   with an alignment of 2 bytes and a size of 6 bytes.
3118 - [You can now import an item from a module as an `_`.][56303] This allows you to
3119   import a trait's impls, and not have the name in the namespace. E.g.
3120   ```rust
3121   use std::io::Read as _;
3122
3123   // Allowed as there is only one `Read` in the module.
3124   pub trait Read {}
3125   ```
3126 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3127
3128 Compiler
3129 --------
3130 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3131   command line argument.][56351]
3132 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3133 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3134 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3135   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3136   information on Rust's platform support.
3137 - [Added support for the `thumbv7neon-linux-androideabi` and
3138   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3139 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3140
3141 Libraries
3142 ---------
3143 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3144   functions for all numeric types.][57566]
3145 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3146   are now `const` functions for all numeric types.][57105]
3147 - [The methods `is_positive` and `is_negative` are now `const` functions for
3148   all signed numeric types.][57105]
3149 - [The `get` method for all `NonZero` types is now `const`.][57167]
3150 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3151   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3152   numeric types.][57234]
3153 - [`Ipv4Addr::new` is now a `const` function][57234]
3154
3155 Stabilized APIs
3156 ---------------
3157 - [`unix::FileExt::read_exact_at`]
3158 - [`unix::FileExt::write_all_at`]
3159 - [`Option::transpose`]
3160 - [`Result::transpose`]
3161 - [`convert::identity`]
3162 - [`pin::Pin`]
3163 - [`marker::Unpin`]
3164 - [`marker::PhantomPinned`]
3165 - [`Vec::resize_with`]
3166 - [`VecDeque::resize_with`]
3167 - [`Duration::as_millis`]
3168 - [`Duration::as_micros`]
3169 - [`Duration::as_nanos`]
3170
3171
3172 Cargo
3173 -----
3174 - [You can now publish crates that require a feature flag to compile with
3175   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3176 - [Cargo should now rebuild a crate if a file was modified during the initial
3177   build.][cargo/6484]
3178
3179 Compatibility Notes
3180 -------------------
3181 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3182   are now deprecated in the standard library, and their usage will now produce a warning.
3183   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3184   methods instead.
3185 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3186   downcasting.
3187 - [Libtest no longer creates a new thread for each test when
3188   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3189
3190 [55982]: https://github.com/rust-lang/rust/pull/55982/
3191 [56243]: https://github.com/rust-lang/rust/pull/56243
3192 [56303]: https://github.com/rust-lang/rust/pull/56303/
3193 [56351]: https://github.com/rust-lang/rust/pull/56351/
3194 [56362]: https://github.com/rust-lang/rust/pull/56362
3195 [56642]: https://github.com/rust-lang/rust/pull/56642/
3196 [56769]: https://github.com/rust-lang/rust/pull/56769/
3197 [56805]: https://github.com/rust-lang/rust/pull/56805
3198 [56947]: https://github.com/rust-lang/rust/pull/56947/
3199 [57049]: https://github.com/rust-lang/rust/pull/57049/
3200 [57067]: https://github.com/rust-lang/rust/pull/57067/
3201 [57105]: https://github.com/rust-lang/rust/pull/57105
3202 [57130]: https://github.com/rust-lang/rust/pull/57130/
3203 [57167]: https://github.com/rust-lang/rust/pull/57167/
3204 [57175]: https://github.com/rust-lang/rust/pull/57175/
3205 [57234]: https://github.com/rust-lang/rust/pull/57234/
3206 [57332]: https://github.com/rust-lang/rust/pull/57332/
3207 [57465]: https://github.com/rust-lang/rust/pull/57465/
3208 [57532]: https://github.com/rust-lang/rust/pull/57532/
3209 [57535]: https://github.com/rust-lang/rust/pull/57535/
3210 [57566]: https://github.com/rust-lang/rust/pull/57566/
3211 [57615]: https://github.com/rust-lang/rust/pull/57615/
3212 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3213 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3214 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3215 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3216 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3217 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3218 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3219 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3220 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3221 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3222 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3223 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3224 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3225 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3226 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3227 [platform-support]: https://forge.rust-lang.org/platform-support.html
3228
3229 Version 1.32.0 (2019-01-17)
3230 ==========================
3231
3232 Language
3233 --------
3234 #### 2018 edition
3235 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3236   operator allows you to specify zero or one repetitions similar to the `*` and
3237   `+` operators.
3238 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3239   now always resolve to the item (`enum`, `struct`, etc.) available in the
3240   module if present, before resolving to a external crate or an item the prelude.][56759]
3241   E.g.
3242   ```rust
3243   enum Color { Red, Green, Blue }
3244
3245   use Color::*;
3246   ```
3247
3248 #### All editions
3249 - [You can now match against `PhantomData<T>` types.][55837]
3250 - [You can now match against literals in macros with the `literal`
3251   specifier.][56072] This will match against a literal of any type.
3252   E.g. `1`, `'A'`, `"Hello World"`
3253 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3254   ```rust
3255   struct Point(i32, i32);
3256
3257   impl Point {
3258       pub fn new(x: i32, y: i32) -> Self {
3259           Self(x, y)
3260       }
3261
3262       pub fn is_origin(&self) -> bool {
3263           match self {
3264               Self(0, 0) => true,
3265               _ => false,
3266           }
3267       }
3268   }
3269   ```
3270 - [Self can also now be used in type definitions.][56366] E.g.
3271   ```rust
3272   enum List<T>
3273   where
3274       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3275   {
3276       Nil,
3277       Cons(T, Box<Self>) // likewise here
3278   }
3279   ```
3280 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3281   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3282
3283 Compiler
3284 --------
3285 - [The default allocator has changed from jemalloc to the default allocator on
3286   your system.][55238] The compiler itself on Linux & macOS will still use
3287   jemalloc, but programs compiled with it will use the system allocator.
3288 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3289
3290 Libraries
3291 ---------
3292 - [`PathBuf` now implements `FromStr`.][55148]
3293 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3294 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3295   easily debug expressions in your rust program. E.g.
3296   ```rust
3297   let a = 2;
3298   let b = dbg!(a * 2) + 1;
3299   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3300   assert_eq!(b, 5);
3301   ```
3302
3303 The following APIs are now `const` functions and can be used in a
3304 `const` context.
3305
3306 - [`Cell::as_ptr`]
3307 - [`UnsafeCell::get`]
3308 - [`char::is_ascii`]
3309 - [`iter::empty`]
3310 - [`ManuallyDrop::new`]
3311 - [`ManuallyDrop::into_inner`]
3312 - [`RangeInclusive::start`]
3313 - [`RangeInclusive::end`]
3314 - [`NonNull::as_ptr`]
3315 - [`slice::as_ptr`]
3316 - [`str::as_ptr`]
3317 - [`Duration::as_secs`]
3318 - [`Duration::subsec_millis`]
3319 - [`Duration::subsec_micros`]
3320 - [`Duration::subsec_nanos`]
3321 - [`CStr::as_ptr`]
3322 - [`Ipv4Addr::is_unspecified`]
3323 - [`Ipv6Addr::new`]
3324 - [`Ipv6Addr::octets`]
3325
3326 Stabilized APIs
3327 ---------------
3328 - [`i8::to_be_bytes`]
3329 - [`i8::to_le_bytes`]
3330 - [`i8::to_ne_bytes`]
3331 - [`i8::from_be_bytes`]
3332 - [`i8::from_le_bytes`]
3333 - [`i8::from_ne_bytes`]
3334 - [`i16::to_be_bytes`]
3335 - [`i16::to_le_bytes`]
3336 - [`i16::to_ne_bytes`]
3337 - [`i16::from_be_bytes`]
3338 - [`i16::from_le_bytes`]
3339 - [`i16::from_ne_bytes`]
3340 - [`i32::to_be_bytes`]
3341 - [`i32::to_le_bytes`]
3342 - [`i32::to_ne_bytes`]
3343 - [`i32::from_be_bytes`]
3344 - [`i32::from_le_bytes`]
3345 - [`i32::from_ne_bytes`]
3346 - [`i64::to_be_bytes`]
3347 - [`i64::to_le_bytes`]
3348 - [`i64::to_ne_bytes`]
3349 - [`i64::from_be_bytes`]
3350 - [`i64::from_le_bytes`]
3351 - [`i64::from_ne_bytes`]
3352 - [`i128::to_be_bytes`]
3353 - [`i128::to_le_bytes`]
3354 - [`i128::to_ne_bytes`]
3355 - [`i128::from_be_bytes`]
3356 - [`i128::from_le_bytes`]
3357 - [`i128::from_ne_bytes`]
3358 - [`isize::to_be_bytes`]
3359 - [`isize::to_le_bytes`]
3360 - [`isize::to_ne_bytes`]
3361 - [`isize::from_be_bytes`]
3362 - [`isize::from_le_bytes`]
3363 - [`isize::from_ne_bytes`]
3364 - [`u8::to_be_bytes`]
3365 - [`u8::to_le_bytes`]
3366 - [`u8::to_ne_bytes`]
3367 - [`u8::from_be_bytes`]
3368 - [`u8::from_le_bytes`]
3369 - [`u8::from_ne_bytes`]
3370 - [`u16::to_be_bytes`]
3371 - [`u16::to_le_bytes`]
3372 - [`u16::to_ne_bytes`]
3373 - [`u16::from_be_bytes`]
3374 - [`u16::from_le_bytes`]
3375 - [`u16::from_ne_bytes`]
3376 - [`u32::to_be_bytes`]
3377 - [`u32::to_le_bytes`]
3378 - [`u32::to_ne_bytes`]
3379 - [`u32::from_be_bytes`]
3380 - [`u32::from_le_bytes`]
3381 - [`u32::from_ne_bytes`]
3382 - [`u64::to_be_bytes`]
3383 - [`u64::to_le_bytes`]
3384 - [`u64::to_ne_bytes`]
3385 - [`u64::from_be_bytes`]
3386 - [`u64::from_le_bytes`]
3387 - [`u64::from_ne_bytes`]
3388 - [`u128::to_be_bytes`]
3389 - [`u128::to_le_bytes`]
3390 - [`u128::to_ne_bytes`]
3391 - [`u128::from_be_bytes`]
3392 - [`u128::from_le_bytes`]
3393 - [`u128::from_ne_bytes`]
3394 - [`usize::to_be_bytes`]
3395 - [`usize::to_le_bytes`]
3396 - [`usize::to_ne_bytes`]
3397 - [`usize::from_be_bytes`]
3398 - [`usize::from_le_bytes`]
3399 - [`usize::from_ne_bytes`]
3400
3401 Cargo
3402 -----
3403 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3404 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3405
3406 Misc
3407 ----
3408 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3409
3410 Compatibility Notes
3411 -------------------
3412 - [The argument types for AVX's
3413   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3414   been changed from `*const` to `*mut` as the previous implementation
3415   was unsound.
3416
3417
3418 [55148]: https://github.com/rust-lang/rust/pull/55148/
3419 [55238]: https://github.com/rust-lang/rust/pull/55238/
3420 [55280]: https://github.com/rust-lang/rust/pull/55280/
3421 [55610]: https://github.com/rust-lang/rust/pull/55610/
3422 [55663]: https://github.com/rust-lang/rust/pull/55663/
3423 [55702]: https://github.com/rust-lang/rust/pull/55702/
3424 [55837]: https://github.com/rust-lang/rust/pull/55837/
3425 [55843]: https://github.com/rust-lang/rust/pull/55843/
3426 [56072]: https://github.com/rust-lang/rust/pull/56072/
3427 [56245]: https://github.com/rust-lang/rust/pull/56245/
3428 [56365]: https://github.com/rust-lang/rust/pull/56365/
3429 [56366]: https://github.com/rust-lang/rust/pull/56366/
3430 [56395]: https://github.com/rust-lang/rust/pull/56395/
3431 [56759]: https://github.com/rust-lang/rust/pull/56759/
3432 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3433 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3434 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3435 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3436 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3437 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3438 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3439 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3440 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3441 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3442 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3443 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3444 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3445 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3446 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3447 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3448 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3449 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3450 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3451 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3452 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3453 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3454 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3455 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3456 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3457 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3458 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3459 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3460 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3461 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3462 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3463 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3464 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3465 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3466 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3467 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3468 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3469 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3470 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3471 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3472 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3473 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3474 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3475 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3476 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3477 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3478 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3479 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3480 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3481 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3482 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3483 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3484 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3485 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3486 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3487 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3488 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3489 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3490 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3491 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3492 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3493 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3494 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3495 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3496 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3497 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3498 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3499 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3500 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3501 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3502 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3503 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3504 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3505 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3506 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3507 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3508 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3509 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3510 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3511 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3512 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3513 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3514 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3515 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3516 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3517 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3518 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3519 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3520 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3521 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3522 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3523 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3524 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3525
3526
3527 Version 1.31.1 (2018-12-20)
3528 ===========================
3529
3530 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
3531 - [Fix broken go-to-definition in RLS][rls/1171]
3532 - [Fix infinite loop on hover in RLS][rls/1170]
3533
3534 [56562]: https://github.com/rust-lang/rust/pull/56562
3535 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
3536 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
3537
3538 Version 1.31.0 (2018-12-06)
3539 ==========================
3540
3541 Language
3542 --------
3543 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
3544 - [New lifetime elision rules now allow for eliding lifetimes in functions and
3545   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
3546   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
3547   in structs.
3548 - [You can now define and use `const` functions.][54835] These are currently
3549   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
3550   [language reference][const-reference] for what exactly is available.
3551 - [You can now use tool lints, which allow you to scope lints from external
3552   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
3553 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
3554   a crate, not just in exported functions.][54451]
3555 - [You can now use parentheses in pattern matches.][54497]
3556
3557 Compiler
3558 --------
3559 - [Updated musl to 1.1.20][54430]
3560
3561 Libraries
3562 ---------
3563 - [You can now convert `num::NonZero*` types to their raw equivalents using the
3564   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
3565 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
3566   into `Option<&mut T>` using the `From` trait.][53218]
3567 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
3568
3569
3570 Stabilized APIs
3571 ---------------
3572 - [`slice::align_to`]
3573 - [`slice::align_to_mut`]
3574 - [`slice::chunks_exact`]
3575 - [`slice::chunks_exact_mut`]
3576 - [`slice::rchunks`]
3577 - [`slice::rchunks_mut`]
3578 - [`slice::rchunks_exact`]
3579 - [`slice::rchunks_exact_mut`]
3580 - [`Option::replace`]
3581
3582 Cargo
3583 -----
3584 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
3585 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
3586   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
3587
3588 [52813]: https://github.com/rust-lang/rust/pull/52813/
3589 [53218]: https://github.com/rust-lang/rust/pull/53218/
3590 [53555]: https://github.com/rust-lang/rust/issues/53555/
3591 [54057]: https://github.com/rust-lang/rust/pull/54057/
3592 [54240]: https://github.com/rust-lang/rust/pull/54240/
3593 [54430]: https://github.com/rust-lang/rust/pull/54430/
3594 [54451]: https://github.com/rust-lang/rust/pull/54451/
3595 [54497]: https://github.com/rust-lang/rust/pull/54497/
3596 [54778]: https://github.com/rust-lang/rust/pull/54778/
3597 [54835]: https://github.com/rust-lang/rust/pull/54835/
3598 [54870]: https://github.com/rust-lang/rust/pull/54870/
3599 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
3600 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
3601 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
3602 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
3603 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
3604 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
3605 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3606 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
3607 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3608 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
3609 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
3610 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
3611 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
3612 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
3613
3614 Version 1.30.1 (2018-11-08)
3615 ===========================
3616
3617 - [Fixed overflow ICE in rustdoc][54199]
3618 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
3619
3620 [54199]: https://github.com/rust-lang/rust/pull/54199
3621 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
3622
3623 Version 1.30.0 (2018-10-25)
3624 ==========================
3625
3626 Language
3627 --------
3628 - [Procedural macros are now available.][52081] These kinds of macros allow for
3629   more powerful code generation. There is a [new chapter available][proc-macros]
3630   in the Rust Programming Language book that goes further in depth.
3631 - [You can now use keywords as identifiers using the raw identifiers
3632   syntax (`r#`),][53236] e.g. `let r#for = true;`
3633 - [Using anonymous parameters in traits is now deprecated with a warning and
3634   will be a hard error in the 2018 edition.][53272]
3635 - [You can now use `crate` in paths.][54404] This allows you to refer to the
3636   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
3637 - [Using a external crate no longer requires being prefixed with `::`.][54404]
3638   Previously, using a external crate in a module without a use statement
3639   required `let json = ::serde_json::from_str(foo);` but can now be written
3640   as `let json = serde_json::from_str(foo);`.
3641 - [You can now apply the `#[used]` attribute to static items to prevent the
3642   compiler from optimising them away, even if they appear to be unused,][51363]
3643   e.g. `#[used] static FOO: u32 = 1;`
3644 - [You can now import and reexport macros from other crates with the `use`
3645   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
3646   the root module of the crate. If your macro relies on calling other local
3647   macros, it is recommended to export with the
3648   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
3649   those macros.
3650 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
3651   using the `vis` specifier.][53370]
3652 - [Non-macro attributes now allow all forms of literals, not just
3653   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
3654   write `#[attr(true)]`.
3655 - [You can now specify a function to handle a panic in the Rust runtime with the
3656   `#[panic_handler]` attribute.][51366]
3657
3658 Compiler
3659 --------
3660 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
3661 - [Added the `aarch64-unknown-netbsd` target][53165]
3662 - [Upgraded to LLVM 8.][53611]
3663
3664 Libraries
3665 ---------
3666 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
3667
3668 Stabilized APIs
3669 ---------------
3670 - [`Ipv4Addr::BROADCAST`]
3671 - [`Ipv4Addr::LOCALHOST`]
3672 - [`Ipv4Addr::UNSPECIFIED`]
3673 - [`Ipv6Addr::LOCALHOST`]
3674 - [`Ipv6Addr::UNSPECIFIED`]
3675 - [`Iterator::find_map`]
3676
3677   The following methods are replacement methods for `trim_left`, `trim_right`,
3678   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
3679   in 1.33.0:
3680 - [`str::trim_end_matches`]
3681 - [`str::trim_end`]
3682 - [`str::trim_start_matches`]
3683 - [`str::trim_start`]
3684
3685 Cargo
3686 ----
3687 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
3688 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
3689   equivalent to calling `rustdoc --error-format=json`.
3690 - [Cargo will now provide a progress bar for builds.][cargo/5995]
3691
3692 Misc
3693 ----
3694 - [`rustdoc` allows you to specify what edition to treat your code as with the
3695   `--edition` option.][54057]
3696 - [`rustdoc` now has the `--color` (specify whether to output color) and
3697   `--error-format` (specify error format, e.g. `json`) options.][53003]
3698 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
3699   debug symbols.][53774]
3700 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
3701   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
3702
3703 [50911]: https://github.com/rust-lang/rust/pull/50911/
3704 [51363]: https://github.com/rust-lang/rust/pull/51363/
3705 [51366]: https://github.com/rust-lang/rust/pull/51366/
3706 [52081]: https://github.com/rust-lang/rust/pull/52081/
3707 [53003]: https://github.com/rust-lang/rust/pull/53003/
3708 [53033]: https://github.com/rust-lang/rust/pull/53033/
3709 [53044]: https://github.com/rust-lang/rust/pull/53044/
3710 [53165]: https://github.com/rust-lang/rust/pull/53165/
3711 [53611]: https://github.com/rust-lang/rust/pull/53611/
3712 [53213]: https://github.com/rust-lang/rust/pull/53213/
3713 [53236]: https://github.com/rust-lang/rust/pull/53236/
3714 [53272]: https://github.com/rust-lang/rust/pull/53272/
3715 [53370]: https://github.com/rust-lang/rust/pull/53370/
3716 [53459]: https://github.com/rust-lang/rust/pull/53459/
3717 [53774]: https://github.com/rust-lang/rust/pull/53774/
3718 [53822]: https://github.com/rust-lang/rust/pull/53822/
3719 [54057]: https://github.com/rust-lang/rust/pull/54057/
3720 [54146]: https://github.com/rust-lang/rust/pull/54146/
3721 [54404]: https://github.com/rust-lang/rust/pull/54404/
3722 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
3723 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
3724 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
3725 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
3726
3727 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
3728 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
3729 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
3730 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
3731 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
3732 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
3733 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
3734 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
3735 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
3736 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
3737
3738
3739 Version 1.29.2 (2018-10-11)
3740 ===========================
3741
3742 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
3743 - The `rls-preview` component on the windows-gnu targets has been restored.
3744
3745 [54639]: https://github.com/rust-lang/rust/pull/54639
3746
3747
3748 Version 1.29.1 (2018-09-25)
3749 ===========================
3750
3751 Security Notes
3752 --------------
3753
3754 - The standard library's `str::repeat` function contained an out of bounds write
3755   caused by an integer overflow. This has been fixed by deterministically
3756   panicking when an overflow happens.
3757
3758   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
3759   us.
3760
3761
3762 Version 1.29.0 (2018-09-13)
3763 ==========================
3764
3765 Compiler
3766 --------
3767 - [Bumped minimum LLVM version to 5.0.][51899]
3768 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
3769 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
3770 - [Upgraded to LLVM 7.][51966]
3771
3772 Libraries
3773 ---------
3774 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
3775 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
3776 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
3777 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
3778   for `&str`.][51178]
3779 - [`Cell<T>` now allows `T` to be unsized.][50494]
3780 - [`SocketAddr` is now stable on Redox.][52656]
3781
3782 Stabilized APIs
3783 ---------------
3784 - [`Arc::downcast`]
3785 - [`Iterator::flatten`]
3786 - [`Rc::downcast`]
3787
3788 Cargo
3789 -----
3790 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
3791   `--locked` to disable this behavior.
3792 - [`cargo-install` will now allow you to cross compile an install
3793   using `--target`.][cargo/5614]
3794 - [Added the `cargo-fix` subcommand to automatically move project code from
3795   2015 edition to 2018.][cargo/5723]
3796 - [`cargo doc` can now optionally document private types using the
3797   `--document-private-items` flag.][cargo/5543]
3798
3799 Misc
3800 ----
3801 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
3802   the specified level to that level.][52354] For example `--cap-lints warn`
3803   will demote `deny` and `forbid` lints to `warn`.
3804 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
3805   fails and `101` if there is a panic.][52197]
3806 - [A preview of clippy has been made available through rustup.][51122]
3807   You can install the preview with `rustup component add clippy-preview`.
3808
3809 Compatibility Notes
3810 -------------------
3811 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
3812   Use `str::get_unchecked(begin..end)` instead.
3813 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
3814   Consider using the `home_dir` function from
3815   https://crates.io/crates/dirs instead.
3816 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
3817 - [`cfg` attributes and `--cfg` command line flags are now more
3818   strictly validated.][53893]
3819
3820 [53893]: https://github.com/rust-lang/rust/pull/53893/
3821 [52861]: https://github.com/rust-lang/rust/pull/52861/
3822 [51966]: https://github.com/rust-lang/rust/pull/51966/
3823 [52656]: https://github.com/rust-lang/rust/pull/52656/
3824 [52239]: https://github.com/rust-lang/rust/pull/52239/
3825 [52330]: https://github.com/rust-lang/rust/pull/52330/
3826 [52354]: https://github.com/rust-lang/rust/pull/52354/
3827 [52402]: https://github.com/rust-lang/rust/pull/52402/
3828 [52103]: https://github.com/rust-lang/rust/pull/52103/
3829 [52197]: https://github.com/rust-lang/rust/pull/52197/
3830 [51807]: https://github.com/rust-lang/rust/pull/51807/
3831 [51899]: https://github.com/rust-lang/rust/pull/51899/
3832 [51912]: https://github.com/rust-lang/rust/pull/51912/
3833 [51511]: https://github.com/rust-lang/rust/pull/51511/
3834 [51619]: https://github.com/rust-lang/rust/pull/51619/
3835 [51656]: https://github.com/rust-lang/rust/pull/51656/
3836 [51178]: https://github.com/rust-lang/rust/pull/51178/
3837 [51122]: https://github.com/rust-lang/rust/pull/51122
3838 [50494]: https://github.com/rust-lang/rust/pull/50494/
3839 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
3840 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
3841 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
3842 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
3843 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
3844 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
3845 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
3846
3847
3848 Version 1.28.0 (2018-08-02)
3849 ===========================
3850
3851 Language
3852 --------
3853 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
3854   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
3855   the inner type across Foreign Function Interface (FFI) boundaries.
3856 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
3857   and can now be used as identifiers.][51196]
3858 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
3859   stable.][51241] This will allow users to specify a global allocator for
3860   their program.
3861 - [Unit test functions marked with the `#[test]` attribute can now return
3862   `Result<(), E: Debug>` in addition to `()`.][51298]
3863 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
3864   allows macros to easily target lifetimes.
3865
3866 Compiler
3867 --------
3868 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
3869   prioritise making smaller binary sizes. `z` is the same as `s` with the
3870   exception that it does not vectorise loops, which typically results in an even
3871   smaller binary.
3872 - [The short error format is now stable.][49546] Specified with
3873   `--error-format=short` this option will provide a more compressed output of
3874   rust error messages.
3875 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
3876 - [Reduced the number of allocations in the macro parser.][50855] This can
3877   improve compile times of macro heavy crates on average by 5%.
3878
3879 Libraries
3880 ---------
3881 - [Implemented `Default` for `&mut str`.][51306]
3882 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
3883 - [Implemented `Extend` for `()`.][50234]
3884 - [The `Debug` implementation of `time::Duration` should now be more easily
3885   human readable.][50364] Previously a `Duration` of one second would printed as
3886   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
3887 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
3888   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
3889   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
3890   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
3891   for `PathBuf`.][50170]
3892 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
3893   and `Wrapping<i128>`.][50465]
3894 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
3895   possible.][51050] This can provide up to a 40% speed increase.
3896 - [Improved error messages when using `format!`.][50610]
3897
3898 Stabilized APIs
3899 ---------------
3900 - [`Iterator::step_by`]
3901 - [`Path::ancestors`]
3902 - [`SystemTime::UNIX_EPOCH`]
3903 - [`alloc::GlobalAlloc`]
3904 - [`alloc::Layout`]
3905 - [`alloc::LayoutErr`]
3906 - [`alloc::System`]
3907 - [`alloc::alloc`]
3908 - [`alloc::alloc_zeroed`]
3909 - [`alloc::dealloc`]
3910 - [`alloc::realloc`]
3911 - [`alloc::handle_alloc_error`]
3912 - [`btree_map::Entry::or_default`]
3913 - [`fmt::Alignment`]
3914 - [`hash_map::Entry::or_default`]
3915 - [`iter::repeat_with`]
3916 - [`num::NonZeroUsize`]
3917 - [`num::NonZeroU128`]
3918 - [`num::NonZeroU16`]
3919 - [`num::NonZeroU32`]
3920 - [`num::NonZeroU64`]
3921 - [`num::NonZeroU8`]
3922 - [`ops::RangeBounds`]
3923 - [`slice::SliceIndex`]
3924 - [`slice::from_mut`]
3925 - [`slice::from_ref`]
3926 - [`{Any + Send + Sync}::downcast_mut`]
3927 - [`{Any + Send + Sync}::downcast_ref`]
3928 - [`{Any + Send + Sync}::is`]
3929
3930 Cargo
3931 -----
3932 - [Cargo will now no longer allow you to publish crates with build scripts that
3933   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
3934   considered to be immutable.
3935
3936 Misc
3937 ----
3938 - [The `suggestion_applicability` field in `rustc`'s json output is now
3939   stable.][50486] This will allow dev tools to check whether a code suggestion
3940   would apply to them.
3941
3942 Compatibility Notes
3943 -------------------
3944 - [Rust will consider trait objects with duplicated constraints to be the same
3945   type as without the duplicated constraint.][51276] For example the below code will
3946   now fail to compile.
3947   ```rust
3948   trait Trait {}
3949
3950   impl Trait + Send {
3951       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
3952   }
3953
3954   impl Trait + Send + Send {
3955       fn test(&self) { println!("two"); }
3956   }
3957   ```
3958
3959 [49546]: https://github.com/rust-lang/rust/pull/49546/
3960 [50143]: https://github.com/rust-lang/rust/pull/50143/
3961 [50170]: https://github.com/rust-lang/rust/pull/50170/
3962 [50234]: https://github.com/rust-lang/rust/pull/50234/
3963 [50265]: https://github.com/rust-lang/rust/pull/50265/
3964 [50364]: https://github.com/rust-lang/rust/pull/50364/
3965 [50385]: https://github.com/rust-lang/rust/pull/50385/
3966 [50465]: https://github.com/rust-lang/rust/pull/50465/
3967 [50486]: https://github.com/rust-lang/rust/pull/50486/
3968 [50554]: https://github.com/rust-lang/rust/pull/50554/
3969 [50610]: https://github.com/rust-lang/rust/pull/50610/
3970 [50855]: https://github.com/rust-lang/rust/pull/50855/
3971 [51050]: https://github.com/rust-lang/rust/pull/51050/
3972 [51196]: https://github.com/rust-lang/rust/pull/51196/
3973 [51200]: https://github.com/rust-lang/rust/pull/51200/
3974 [51241]: https://github.com/rust-lang/rust/pull/51241/
3975 [51276]: https://github.com/rust-lang/rust/pull/51276/
3976 [51298]: https://github.com/rust-lang/rust/pull/51298/
3977 [51306]: https://github.com/rust-lang/rust/pull/51306/
3978 [51562]: https://github.com/rust-lang/rust/pull/51562/
3979 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
3980 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
3981 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
3982 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
3983 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
3984 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
3985 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
3986 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
3987 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
3988 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
3989 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
3990 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
3991 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
3992 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
3993 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
3994 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
3995 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
3996 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
3997 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
3998 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
3999 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4000 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4001 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
4002 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
4003 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
4004 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
4005 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
4006 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
4007 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
4008 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
4009
4010 Version 1.27.2 (2018-07-20)
4011 ===========================
4012
4013 Compatibility Notes
4014 -------------------
4015
4016 - The borrow checker was fixed to avoid potential unsoundness when using
4017   match ergonomics: [#52213][52213].
4018
4019 [52213]: https://github.com/rust-lang/rust/issues/52213
4020
4021 Version 1.27.1 (2018-07-10)
4022 ===========================
4023
4024 Security Notes
4025 --------------
4026
4027 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
4028   when running, which enabled executing code as some other user on a
4029   given machine. This release fixes that vulnerability; you can read
4030   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
4031
4032   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
4033
4034 Compatibility Notes
4035 -------------------
4036
4037 - The borrow checker was fixed to avoid an additional potential unsoundness when using
4038   match ergonomics: [#51415][51415], [#49534][49534].
4039
4040 [51415]: https://github.com/rust-lang/rust/issues/51415
4041 [49534]: https://github.com/rust-lang/rust/issues/49534
4042 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
4043 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
4044
4045 Version 1.27.0 (2018-06-21)
4046 ==========================
4047
4048 Language
4049 --------
4050 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
4051   be used as an identifier.
4052 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
4053   bare `Trait` syntax, and should make it clearer when being used in tandem with
4054   `impl Trait` because it is equivalent to the following syntax:
4055   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
4056   `Box<Trait> == Box<dyn Trait>`.
4057 - [Attributes on generic parameters such as types and lifetimes are
4058   now stable.][48851] e.g.
4059   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
4060 - [The `#[must_use]` attribute can now also be used on functions as well as
4061   types.][48925] It provides a lint that by default warns users when the
4062   value returned by a function has not been used.
4063
4064 Compiler
4065 --------
4066 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
4067
4068 Libraries
4069 ---------
4070 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
4071   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
4072   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
4073   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
4074   the `cfg` attribute.
4075 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
4076   std are now available in core.][49896]
4077 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
4078   to `Self`.][49630]
4079 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
4080   that the operation isn't done in place.
4081 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
4082   the `#[must_use]` attribute][49533] to warn about unused potentially
4083   expensive allocations.
4084
4085 Stabilized APIs
4086 ---------------
4087 - [`DoubleEndedIterator::rfind`]
4088 - [`DoubleEndedIterator::rfold`]
4089 - [`DoubleEndedIterator::try_rfold`]
4090 - [`Duration::from_micros`]
4091 - [`Duration::from_nanos`]
4092 - [`Duration::subsec_micros`]
4093 - [`Duration::subsec_millis`]
4094 - [`HashMap::remove_entry`]
4095 - [`Iterator::try_fold`]
4096 - [`Iterator::try_for_each`]
4097 - [`NonNull::cast`]
4098 - [`Option::filter`]
4099 - [`String::replace_range`]
4100 - [`Take::set_limit`]
4101 - [`hint::unreachable_unchecked`]
4102 - [`os::unix::process::parent_id`]
4103 - [`ptr::swap_nonoverlapping`]
4104 - [`slice::rsplit_mut`]
4105 - [`slice::rsplit`]
4106 - [`slice::swap_with_slice`]
4107
4108 Cargo
4109 -----
4110 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
4111   `readme`, and `repository` fields.][cargo/5386]
4112 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
4113 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
4114   a different directory than `target` for placing compilation artifacts.
4115 - [Cargo will be adding automatic target inference for binaries, benchmarks,
4116   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4117   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
4118   where cargo would infer a binary, Cargo will produce a warning. You can
4119   disable this feature ahead of time by setting any of the following to false:
4120   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4121 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4122   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4123
4124 Misc
4125 ----
4126 - [Added “The Rustc book” into the official documentation.][49707]
4127   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4128 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4129
4130 Compatibility Notes
4131 -------------------
4132 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4133   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4134   compile, `"".is_empty()` will still compile.
4135 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4136   will only print the inner type.][48553] E.g.
4137   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4138   not `AtomicBool(true)`.
4139 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4140   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4141   alignment should cover all use cases.
4142 - The `.description()` method on the `std::error::Error` trait
4143   [has been soft-deprecated][50163]. It is no longer required to implement it.
4144
4145 [48553]: https://github.com/rust-lang/rust/pull/48553/
4146 [48851]: https://github.com/rust-lang/rust/pull/48851/
4147 [48925]: https://github.com/rust-lang/rust/pull/48925/
4148 [49533]: https://github.com/rust-lang/rust/pull/49533/
4149 [49623]: https://github.com/rust-lang/rust/pull/49623/
4150 [49630]: https://github.com/rust-lang/rust/pull/49630/
4151 [49664]: https://github.com/rust-lang/rust/pull/49664/
4152 [49699]: https://github.com/rust-lang/rust/pull/49699/
4153 [49707]: https://github.com/rust-lang/rust/pull/49707/
4154 [49719]: https://github.com/rust-lang/rust/pull/49719/
4155 [49896]: https://github.com/rust-lang/rust/pull/49896/
4156 [49968]: https://github.com/rust-lang/rust/pull/49968/
4157 [50163]: https://github.com/rust-lang/rust/pull/50163
4158 [50177]: https://github.com/rust-lang/rust/pull/50177/
4159 [50378]: https://github.com/rust-lang/rust/pull/50378/
4160 [50398]: https://github.com/rust-lang/rust/pull/50398/
4161 [50423]: https://github.com/rust-lang/rust/pull/50423/
4162 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
4163 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4164 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4165 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4166 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4167 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4168 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4169 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4170 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4171 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4172 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4173 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4174 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4175 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4176 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4177 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4178 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4179 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4180 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4181 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4182 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4183 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4184 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4185 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4186 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4187 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4188 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4189 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4190 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4191 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4192
4193
4194 Version 1.26.2 (2018-06-05)
4195 ==========================
4196
4197 Compatibility Notes
4198 -------------------
4199
4200 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4201
4202 [51117]: https://github.com/rust-lang/rust/issues/51117
4203
4204
4205 Version 1.26.1 (2018-05-29)
4206 ==========================
4207
4208 Tools
4209 -----
4210
4211 - [RLS now works on Windows.][50646]
4212 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4213
4214
4215 Compatibility Notes
4216 --------
4217
4218 - [`fn main() -> impl Trait` no longer works for non-Termination
4219   trait.][50656]
4220   This reverts an accidental stabilization.
4221 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4222 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4223
4224 [50646]: https://github.com/rust-lang/rust/issues/50646
4225 [50656]: https://github.com/rust-lang/rust/pull/50656
4226 [50812]: https://github.com/rust-lang/rust/pull/50812
4227 [50950]: https://github.com/rust-lang/rust/issues/50950
4228 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4229
4230 Version 1.26.0 (2018-05-10)
4231 ==========================
4232
4233 Language
4234 --------
4235 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4236   implement either or both traits.][49299]
4237 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4238 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4239   lifetime can be elided.][49458]
4240 - [`impl Trait` is now stable allowing you to have abstract types in returns
4241    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4242   `fn open(path: impl AsRef<Path>)`.
4243 - [Pattern matching will now automatically apply dereferences.][49394]
4244 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4245 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4246 - [A lot of operations are now available in a const context.][46882] E.g. You
4247   can now index into constant arrays, reference and dereference into constants,
4248   and use tuple struct constructors.
4249 - [Fixed entry slice patterns are now stable.][48516] E.g.
4250   ```rust
4251   let points = [1, 2, 3, 4];
4252   match points {
4253       [1, 2, 3, 4] => println!("All points were sequential."),
4254       _ => println!("Not all points were sequential."),
4255   }
4256   ```
4257
4258
4259 Compiler
4260 --------
4261 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4262 - [Fixed exponential projection complexity on nested types.][48296]
4263   This can provide up to a ~12% reduction in compile times for certain crates.
4264 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4265   to remap path prefixes outputted by the compiler.
4266 - [Added `powerpc-unknown-netbsd` target.][48281]
4267
4268 Libraries
4269 ---------
4270 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4271 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4272   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4273 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4274 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4275 - [`ascii::escape_default` is now available in libcore.][48735]
4276 - [Trailing commas are now supported in std and core macros.][48056]
4277 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4278 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4279
4280 Stabilized APIs
4281 ---------------
4282 - [`*const T::add`]
4283 - [`*const T::copy_to_nonoverlapping`]
4284 - [`*const T::copy_to`]
4285 - [`*const T::read_unaligned`]
4286 - [`*const T::read_volatile`]
4287 - [`*const T::read`]
4288 - [`*const T::sub`]
4289 - [`*const T::wrapping_add`]
4290 - [`*const T::wrapping_sub`]
4291 - [`*mut T::add`]
4292 - [`*mut T::copy_to_nonoverlapping`]
4293 - [`*mut T::copy_to`]
4294 - [`*mut T::read_unaligned`]
4295 - [`*mut T::read_volatile`]
4296 - [`*mut T::read`]
4297 - [`*mut T::replace`]
4298 - [`*mut T::sub`]
4299 - [`*mut T::swap`]
4300 - [`*mut T::wrapping_add`]
4301 - [`*mut T::wrapping_sub`]
4302 - [`*mut T::write_bytes`]
4303 - [`*mut T::write_unaligned`]
4304 - [`*mut T::write_volatile`]
4305 - [`*mut T::write`]
4306 - [`Box::leak`]
4307 - [`FromUtf8Error::as_bytes`]
4308 - [`LocalKey::try_with`]
4309 - [`Option::cloned`]
4310 - [`btree_map::Entry::and_modify`]
4311 - [`fs::read_to_string`]
4312 - [`fs::read`]
4313 - [`fs::write`]
4314 - [`hash_map::Entry::and_modify`]
4315 - [`iter::FusedIterator`]
4316 - [`ops::RangeInclusive`]
4317 - [`ops::RangeToInclusive`]
4318 - [`process::id`]
4319 - [`slice::rotate_left`]
4320 - [`slice::rotate_right`]
4321 - [`String::retain`]
4322
4323
4324 Cargo
4325 -----
4326 - [Cargo will now output path to custom commands when `-v` is
4327   passed with `--list`][cargo/5041]
4328 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4329
4330 Misc
4331 ----
4332 - [The second edition of "The Rust Programming Language" book is now recommended
4333   over the first.][48404]
4334
4335 Compatibility Notes
4336 -------------------
4337
4338 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4339   syntax is now invalid.
4340   ```
4341   use std::ops::Fn as dyn;
4342   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4343   ```
4344 - [The result of dereferences are no longer promoted to `'static`.][47408]
4345   e.g.
4346   ```rust
4347   fn main() {
4348       const PAIR: &(i32, i32) = &(0, 1);
4349       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4350   }
4351   ```
4352 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4353 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4354   an error.][48235]
4355 - [Removed hoedown from rustdoc.][48274]
4356 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4357
4358 [46882]: https://github.com/rust-lang/rust/pull/46882
4359 [47379]: https://github.com/rust-lang/rust/pull/47379
4360 [47408]: https://github.com/rust-lang/rust/pull/47408
4361 [47813]: https://github.com/rust-lang/rust/pull/47813
4362 [48056]: https://github.com/rust-lang/rust/pull/48056
4363 [48125]: https://github.com/rust-lang/rust/pull/48125
4364 [48166]: https://github.com/rust-lang/rust/pull/48166
4365 [48235]: https://github.com/rust-lang/rust/pull/48235
4366 [48274]: https://github.com/rust-lang/rust/pull/48274
4367 [48281]: https://github.com/rust-lang/rust/pull/48281
4368 [48296]: https://github.com/rust-lang/rust/pull/48296
4369 [48326]: https://github.com/rust-lang/rust/pull/48326
4370 [48359]: https://github.com/rust-lang/rust/pull/48359
4371 [48404]: https://github.com/rust-lang/rust/pull/48404
4372 [48481]: https://github.com/rust-lang/rust/pull/48481
4373 [48516]: https://github.com/rust-lang/rust/pull/48516
4374 [48628]: https://github.com/rust-lang/rust/pull/48628
4375 [48629]: https://github.com/rust-lang/rust/pull/48629
4376 [48657]: https://github.com/rust-lang/rust/pull/48657
4377 [48735]: https://github.com/rust-lang/rust/pull/48735
4378 [48978]: https://github.com/rust-lang/rust/pull/48978
4379 [49101]: https://github.com/rust-lang/rust/pull/49101
4380 [49109]: https://github.com/rust-lang/rust/pull/49109
4381 [49121]: https://github.com/rust-lang/rust/pull/49121
4382 [49162]: https://github.com/rust-lang/rust/pull/49162
4383 [49184]: https://github.com/rust-lang/rust/pull/49184
4384 [49234]: https://github.com/rust-lang/rust/pull/49234
4385 [49255]: https://github.com/rust-lang/rust/pull/49255
4386 [49299]: https://github.com/rust-lang/rust/pull/49299
4387 [49305]: https://github.com/rust-lang/rust/pull/49305
4388 [49394]: https://github.com/rust-lang/rust/pull/49394
4389 [49458]: https://github.com/rust-lang/rust/pull/49458
4390 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4391 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4392 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4393 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4394 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4395 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4396 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4397 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4398 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4399 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4400 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4401 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4402 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4403 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4404 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4405 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4406 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4407 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4408 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4409 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4410 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4411 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4412 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4413 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4414 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4415 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4416 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4417 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4418 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4419 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4420 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4421 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4422 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4423 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4424 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4425 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4426 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4427 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4428 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4429 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4430 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4431 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4432
4433
4434 Version 1.25.0 (2018-03-29)
4435 ==========================
4436
4437 Language
4438 --------
4439 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4440 - [You can now use nested groups of imports.][47948]
4441   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4442 - [You can now have `|` at the start of a match arm.][47947] e.g.
4443 ```rust
4444 enum Foo { A, B, C }
4445
4446 fn main() {
4447     let x = Foo::A;
4448     match x {
4449         | Foo::A
4450         | Foo::B => println!("AB"),
4451         | Foo::C => println!("C"),
4452     }
4453 }
4454 ```
4455
4456 Compiler
4457 --------
4458 - [Upgraded to LLVM 6.][47828]
4459 - [Added `-C lto=val` option.][47521]
4460 - [Added `i586-unknown-linux-musl` target][47282]
4461
4462 Libraries
4463 ---------
4464 - [Impl Send for `process::Command` on Unix.][47760]
4465 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4466 - [`UnsafeCell::into_inner` is now safe.][47204]
4467 - [Implement libstd for CloudABI.][47268]
4468 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4469 - [Implement `AsRef<Path>` for Component][46985]
4470 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4471 - [Moved `Duration` to libcore.][46666]
4472
4473 Stabilized APIs
4474 ---------------
4475 - [`Location::column`]
4476 - [`ptr::NonNull`]
4477
4478 The following functions can now be used in a constant expression.
4479 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4480 - [`Duration::new`][47300]
4481 - [`Duration::from_secs`][47300]
4482 - [`Duration::from_millis`][47300]
4483
4484 Cargo
4485 -----
4486 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4487 - [`cargo new` now defaults to creating a binary crate, instead of a
4488   library crate.][cargo/5029]
4489
4490 Misc
4491 ----
4492 - [Rust by example is now shipped with new releases][46196]
4493
4494 Compatibility Notes
4495 -------------------
4496 - [Deprecated `net::lookup_host`.][47510]
4497 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4498 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4499   around indexing operations (see [#47349][47349]). This has been fixed (which also
4500   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4501 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4502
4503 [33903]: https://github.com/rust-lang/rust/pull/33903
4504 [47947]: https://github.com/rust-lang/rust/pull/47947
4505 [47948]: https://github.com/rust-lang/rust/pull/47948
4506 [47760]: https://github.com/rust-lang/rust/pull/47760
4507 [47790]: https://github.com/rust-lang/rust/pull/47790
4508 [47828]: https://github.com/rust-lang/rust/pull/47828
4509 [47398]: https://github.com/rust-lang/rust/pull/47398
4510 [47510]: https://github.com/rust-lang/rust/pull/47510
4511 [47521]: https://github.com/rust-lang/rust/pull/47521
4512 [47204]: https://github.com/rust-lang/rust/pull/47204
4513 [47251]: https://github.com/rust-lang/rust/pull/47251
4514 [47268]: https://github.com/rust-lang/rust/pull/47268
4515 [47282]: https://github.com/rust-lang/rust/pull/47282
4516 [47300]: https://github.com/rust-lang/rust/pull/47300
4517 [47349]: https://github.com/rust-lang/rust/pull/47349
4518 [46931]: https://github.com/rust-lang/rust/pull/46931
4519 [46985]: https://github.com/rust-lang/rust/pull/46985
4520 [47006]: https://github.com/rust-lang/rust/pull/47006
4521 [46830]: https://github.com/rust-lang/rust/pull/46830
4522 [46095]: https://github.com/rust-lang/rust/pull/46095
4523 [46666]: https://github.com/rust-lang/rust/pull/46666
4524 [46196]: https://github.com/rust-lang/rust/pull/46196
4525 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
4526 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
4527 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
4528 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
4529 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
4530
4531
4532 Version 1.24.1 (2018-03-01)
4533 ==========================
4534
4535  - [Do not abort when unwinding through FFI][48251]
4536  - [Emit UTF-16 files for linker arguments on Windows][48318]
4537  - [Make the error index generator work again][48308]
4538  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
4539
4540 [48251]: https://github.com/rust-lang/rust/issues/48251
4541 [48308]: https://github.com/rust-lang/rust/issues/48308
4542 [48318]: https://github.com/rust-lang/rust/issues/48318
4543 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
4544
4545
4546 Version 1.24.0 (2018-02-15)
4547 ==========================
4548
4549 Language
4550 --------
4551 - [External `sysv64` ffi is now available.][46528]
4552   eg. `extern "sysv64" fn foo () {}`
4553
4554 Compiler
4555 --------
4556 - [rustc now uses 16 codegen units by default for release builds.][46910]
4557   For the fastest builds, utilize `codegen-units=1`.
4558 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
4559 - [Add `aarch64-unknown-openbsd` support][46760]
4560
4561 Libraries
4562 ---------
4563 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
4564   improvement in performance in the majority of cases.
4565 - [`OsStr`'s `Debug` implementation is now lossless and consistent
4566   with Windows.][46798]
4567 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
4568 - [impl `From<bool>` for `AtomicBool`][46293]
4569 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
4570 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
4571 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
4572 - [float::from_bits now just uses transmute.][46012] This provides
4573   some optimisations from LLVM.
4574 - [Copied `AsciiExt` methods onto `char`][46077]
4575 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
4576 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
4577 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
4578 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
4579
4580 Stabilized APIs
4581 ---------------
4582 - [`RefCell::replace`]
4583 - [`RefCell::swap`]
4584 - [`atomic::spin_loop_hint`]
4585
4586 The following functions can now be used in a constant expression.
4587 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
4588
4589 - [`AtomicBool::new`][46287]
4590 - [`AtomicUsize::new`][46287]
4591 - [`AtomicIsize::new`][46287]
4592 - [`AtomicPtr::new`][46287]
4593 - [`Cell::new`][46287]
4594 - [`{integer}::min_value`][46287]
4595 - [`{integer}::max_value`][46287]
4596 - [`mem::size_of`][46287]
4597 - [`mem::align_of`][46287]
4598 - [`ptr::null`][46287]
4599 - [`ptr::null_mut`][46287]
4600 - [`RefCell::new`][46287]
4601 - [`UnsafeCell::new`][46287]
4602
4603 Cargo
4604 -----
4605 - [Added a `workspace.default-members` config that
4606   overrides implied `--all` in virtual workspaces.][cargo/4743]
4607 - [Enable incremental by default on development builds.][cargo/4817] Also added
4608   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
4609   per-project or global basis respectively.
4610
4611 Misc
4612 ----
4613
4614 Compatibility Notes
4615 -------------------
4616 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
4617 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
4618   in accordance with IETF RFC 4291 §2.2.
4619 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
4620 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
4621   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
4622 - [Leading zeros in tuple struct members is now an error][47084]
4623 - [`column!()` macro is one-based instead of zero-based][46977]
4624 - [`fmt::Arguments` can no longer be shared across threads][45198]
4625 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
4626 - [Cargo sets a different working directory for the compiler][cargo/4788]
4627
4628 [44884]: https://github.com/rust-lang/rust/pull/44884
4629 [45198]: https://github.com/rust-lang/rust/pull/45198
4630 [45506]: https://github.com/rust-lang/rust/pull/45506
4631 [45904]: https://github.com/rust-lang/rust/pull/45904
4632 [45990]: https://github.com/rust-lang/rust/pull/45990
4633 [46012]: https://github.com/rust-lang/rust/pull/46012
4634 [46077]: https://github.com/rust-lang/rust/pull/46077
4635 [46094]: https://github.com/rust-lang/rust/pull/46094
4636 [46284]: https://github.com/rust-lang/rust/pull/46284
4637 [46287]: https://github.com/rust-lang/rust/pull/46287
4638 [46293]: https://github.com/rust-lang/rust/pull/46293
4639 [46528]: https://github.com/rust-lang/rust/pull/46528
4640 [46671]: https://github.com/rust-lang/rust/pull/46671
4641 [46713]: https://github.com/rust-lang/rust/pull/46713
4642 [46735]: https://github.com/rust-lang/rust/pull/46735
4643 [46749]: https://github.com/rust-lang/rust/pull/46749
4644 [46760]: https://github.com/rust-lang/rust/pull/46760
4645 [46798]: https://github.com/rust-lang/rust/pull/46798
4646 [46828]: https://github.com/rust-lang/rust/pull/46828
4647 [46831]: https://github.com/rust-lang/rust/pull/46831
4648 [46833]: https://github.com/rust-lang/rust/pull/46833
4649 [46910]: https://github.com/rust-lang/rust/pull/46910
4650 [46977]: https://github.com/rust-lang/rust/pull/46977
4651 [47018]: https://github.com/rust-lang/rust/pull/47018
4652 [47080]: https://github.com/rust-lang/rust/pull/47080
4653 [47084]: https://github.com/rust-lang/rust/pull/47084
4654 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
4655 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
4656 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
4657 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
4658 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
4659 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
4660
4661
4662 Version 1.23.0 (2018-01-04)
4663 ==========================
4664
4665 Language
4666 --------
4667 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
4668 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
4669   Which should fix some confusing errors in some operations.
4670
4671 Compiler
4672 --------
4673 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
4674   undefined behavior.][45920]
4675 - [rustc now suggests renaming import if names clash.][45660]
4676 - [Display errors/warnings correctly when there are zero-width or
4677   wide characters.][45711]
4678 - [rustc now avoids unnecessary copies of arguments that are
4679   simple bindings][45380] This should improve memory usage on average by 5-10%.
4680 - [Updated musl used to build musl rustc to 1.1.17][45393]
4681
4682 Libraries
4683 ---------
4684 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
4685 - [Implement Hash for raw pointers to unsized types][45483]
4686 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
4687 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
4688 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
4689 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
4690   and `<*mut T>::as_mut`][44932]
4691 - [Optimized `Thread::{park, unpark}` implementation][45524]
4692 - [Improved `SliceExt::binary_search` performance.][45333]
4693 - [impl `FromIterator<()>` for `()`][45379]
4694 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
4695   is now deprecated.
4696
4697 Stabilized APIs
4698 ---------------
4699
4700 Cargo
4701 -----
4702 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
4703   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
4704 - [Added unit test checking to `cargo check`][cargo/4592]
4705 - [Cargo now lets you install a specific version
4706   using `cargo install --version`][cargo/4637]
4707
4708 Misc
4709 ----
4710 - [Releases now ship with the Cargo book documentation.][45692]
4711 - [rustdoc now prints rendering warnings on every run.][45324]
4712
4713 Compatibility Notes
4714 -------------------
4715 - [Changes have been made to type equality to make it more correct,
4716   in rare cases this could break some code.][45853] [Tracking issue for
4717   further information][45852]
4718 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
4719 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
4720   Android 9, the minimum supported version is Android 14.
4721 - [Bumped the minimum LLVM to 3.9][45326]
4722
4723 [44042]: https://github.com/rust-lang/rust/pull/44042
4724 [44932]: https://github.com/rust-lang/rust/pull/44932
4725 [45267]: https://github.com/rust-lang/rust/pull/45267
4726 [45324]: https://github.com/rust-lang/rust/pull/45324
4727 [45326]: https://github.com/rust-lang/rust/pull/45326
4728 [45333]: https://github.com/rust-lang/rust/pull/45333
4729 [45379]: https://github.com/rust-lang/rust/pull/45379
4730 [45380]: https://github.com/rust-lang/rust/pull/45380
4731 [45393]: https://github.com/rust-lang/rust/pull/45393
4732 [45435]: https://github.com/rust-lang/rust/pull/45435
4733 [45483]: https://github.com/rust-lang/rust/pull/45483
4734 [45524]: https://github.com/rust-lang/rust/pull/45524
4735 [45571]: https://github.com/rust-lang/rust/pull/45571
4736 [45580]: https://github.com/rust-lang/rust/pull/45580
4737 [45610]: https://github.com/rust-lang/rust/pull/45610
4738 [45660]: https://github.com/rust-lang/rust/pull/45660
4739 [45692]: https://github.com/rust-lang/rust/pull/45692
4740 [45711]: https://github.com/rust-lang/rust/pull/45711
4741 [45772]: https://github.com/rust-lang/rust/pull/45772
4742 [45852]: https://github.com/rust-lang/rust/issues/45852
4743 [45853]: https://github.com/rust-lang/rust/pull/45853
4744 [45887]: https://github.com/rust-lang/rust/pull/45887
4745 [45920]: https://github.com/rust-lang/rust/pull/45920
4746 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
4747 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
4748 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
4749
4750
4751 Version 1.22.1 (2017-11-22)
4752 ==========================
4753
4754 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
4755
4756 [46183]: https://github.com/rust-lang/rust/pull/46183
4757
4758 Version 1.22.0 (2017-11-22)
4759 ==========================
4760
4761 Language
4762 --------
4763 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
4764 - [Now accepts underscores in unicode escapes][43716]
4765 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
4766 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
4767
4768 Compiler
4769 --------
4770 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
4771 - [rustc will no longer inline in codegen units when compiling for debug][45075]
4772   This should decrease compile times for debug builds.
4773 - [strict memory alignment now enabled on ARMv6][45094]
4774 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
4775
4776 Libraries
4777 ---------
4778 - [Allow atomic operations up to 32 bits
4779   on `armv5te_unknown_linux_gnueabi`][44978]
4780 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
4781 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
4782 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
4783 - [Properly detect overflow in `Instant += Duration`.][44220]
4784 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
4785 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
4786 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
4787
4788 Stabilized APIs
4789 ---------------
4790
4791 Cargo
4792 -----
4793 - [Cargo will now build multi file examples in subdirectories of the `examples`
4794   folder that have a `main.rs` file.][cargo/4496]
4795 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
4796   the old format will continue to work and can be updated with `cargo update`.
4797 - [Now supports vendoring git repositories][cargo/3992]
4798
4799 Misc
4800 ----
4801 - [`libbacktrace` is now available on Apple platforms.][44251]
4802 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
4803   This now lets you specify that a given code example will fail to compile.
4804
4805 Compatibility Notes
4806 -------------------
4807 - [The minimum Android version that rustc can build for has been bumped
4808   to `4.0` from `2.3`][45656]
4809 - [Allowing `T op= &T` for numeric types has broken some type
4810   inference cases][45480]
4811
4812
4813 [42526]: https://github.com/rust-lang/rust/pull/42526
4814 [43017]: https://github.com/rust-lang/rust/pull/43017
4815 [43716]: https://github.com/rust-lang/rust/pull/43716
4816 [43949]: https://github.com/rust-lang/rust/pull/43949
4817 [44015]: https://github.com/rust-lang/rust/pull/44015
4818 [44220]: https://github.com/rust-lang/rust/pull/44220
4819 [44251]: https://github.com/rust-lang/rust/pull/44251
4820 [44287]: https://github.com/rust-lang/rust/pull/44287
4821 [44303]: https://github.com/rust-lang/rust/pull/44303
4822 [44456]: https://github.com/rust-lang/rust/pull/44456
4823 [44466]: https://github.com/rust-lang/rust/pull/44466
4824 [44895]: https://github.com/rust-lang/rust/pull/44895
4825 [44966]: https://github.com/rust-lang/rust/pull/44966
4826 [44978]: https://github.com/rust-lang/rust/pull/44978
4827 [45041]: https://github.com/rust-lang/rust/pull/45041
4828 [45064]: https://github.com/rust-lang/rust/pull/45064
4829 [45075]: https://github.com/rust-lang/rust/pull/45075
4830 [45094]: https://github.com/rust-lang/rust/pull/45094
4831 [45095]: https://github.com/rust-lang/rust/pull/45095
4832 [45480]: https://github.com/rust-lang/rust/issues/45480
4833 [45656]: https://github.com/rust-lang/rust/pull/45656
4834 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
4835 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
4836 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
4837
4838
4839
4840
4841
4842
4843 Version 1.21.0 (2017-10-12)
4844 ==========================
4845
4846 Language
4847 --------
4848 - [You can now use static references for literals.][43838]
4849   Example:
4850   ```rust
4851   fn main() {
4852       let x: &'static u32 = &0;
4853   }
4854   ```
4855 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
4856   Example:
4857   ```rust
4858   my_macro!(Vec<i32>::new); // Always worked
4859   my_macro!(Vec::<i32>::new); // Now works
4860   ```
4861
4862 Compiler
4863 --------
4864 - [Upgraded jemalloc to 4.5.0][43911]
4865 - [Enabled unwinding panics on Redox][43917]
4866 - [Now runs LLVM in parallel during translation phase.][43506]
4867   This should reduce peak memory usage.
4868
4869 Libraries
4870 ---------
4871 - [Generate builtin impls for `Clone` for all arrays and tuples that
4872   are `T: Clone`][43690]
4873 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
4874 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
4875   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
4876
4877 Stabilized APIs
4878 ---------------
4879
4880 [`std::mem::discriminant`]
4881
4882 Cargo
4883 -----
4884 - [You can now call `cargo install` with multiple package names][cargo/4216]
4885 - [Cargo commands inside a virtual workspace will now implicitly
4886   pass `--all`][cargo/4335]
4887 - [Added a `[patch]` section to `Cargo.toml` to handle
4888   prepublication dependencies][cargo/4123] [RFC 1969]
4889 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
4890   like patterns][cargo/4270]
4891 - [Added the `--all-targets` option][cargo/4400]
4892 - [Using required dependencies as a feature is now deprecated and emits
4893   a warning][cargo/4364]
4894
4895
4896 Misc
4897 ----
4898 - [Cargo docs are moving][43916]
4899   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
4900 - [The rustdoc book is now available][43863]
4901   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
4902 - [Added a preview of RLS has been made available through rustup][44204]
4903   Install with `rustup component add rls-preview`
4904 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
4905   Previously only showed `std::os::unix`.
4906
4907 Compatibility Notes
4908 -------------------
4909 - [Changes in method matching against higher-ranked types][43880] This may cause
4910   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
4911 - [rustc's JSON error output's byte position start at top of file.][42973]
4912   Was previously relative to the rustc's internal `CodeMap` struct which
4913   required the unstable library `libsyntax` to correctly use.
4914 - [`unused_results` lint no longer ignores booleans][43728]
4915
4916 [42565]: https://github.com/rust-lang/rust/pull/42565
4917 [42973]: https://github.com/rust-lang/rust/pull/42973
4918 [43348]: https://github.com/rust-lang/rust/pull/43348
4919 [43459]: https://github.com/rust-lang/rust/pull/43459
4920 [43506]: https://github.com/rust-lang/rust/pull/43506
4921 [43540]: https://github.com/rust-lang/rust/pull/43540
4922 [43690]: https://github.com/rust-lang/rust/pull/43690
4923 [43728]: https://github.com/rust-lang/rust/pull/43728
4924 [43838]: https://github.com/rust-lang/rust/pull/43838
4925 [43863]: https://github.com/rust-lang/rust/pull/43863
4926 [43880]: https://github.com/rust-lang/rust/pull/43880
4927 [43911]: https://github.com/rust-lang/rust/pull/43911
4928 [43916]: https://github.com/rust-lang/rust/pull/43916
4929 [43917]: https://github.com/rust-lang/rust/pull/43917
4930 [44204]: https://github.com/rust-lang/rust/pull/44204
4931 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
4932 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
4933 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4934 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
4935 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
4936 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
4937 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
4938 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
4939 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
4940
4941 Version 1.20.0 (2017-08-31)
4942 ===========================
4943
4944 Language
4945 --------
4946 - [Associated constants are now stabilised.][42809]
4947 - [A lot of macro bugs are now fixed.][42913]
4948
4949 Compiler
4950 --------
4951
4952 - [Struct fields are now properly coerced to the expected field type.][42807]
4953 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
4954   `wasm32-experimental-emscripten` target.
4955 - [Changed some of the error messages to be more helpful.][42033]
4956 - [Add support for RELRO(RELocation Read-Only) for platforms that support
4957   it.][43170]
4958 - [rustc now reports the total number of errors on compilation failure][43015]
4959   previously this was only the number of errors in the pass that failed.
4960 - [Expansion in rustc has been sped up 29x.][42533]
4961 - [added `msp430-none-elf` target.][43099]
4962 - [rustc will now suggest one-argument enum variant to fix type mismatch when
4963   applicable][43178]
4964 - [Fixes backtraces on Redox][43228]
4965 - [rustc now identifies different versions of same crate when absolute paths of
4966   different types match in an error message.][42826]
4967
4968 Libraries
4969 ---------
4970
4971
4972 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
4973 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
4974   tuples.][43011]
4975 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
4976   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
4977 - [Impl `Clone` for `DefaultHasher`.][42799]
4978 - [Impl `Sync` for `SyncSender`.][42397]
4979 - [Impl `FromStr` for `char`][42271]
4980 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
4981   NaN.][42431]
4982 - [allow messages in the `unimplemented!()` macro.][42155]
4983   ie. `unimplemented!("Waiting for 1.21 to be stable")`
4984 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
4985 - [Upgrade to Unicode 10.0.0][42999]
4986 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
4987 - [Skip the main thread's manual stack guard on Linux][43072]
4988 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
4989 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
4990   previously 2^15.
4991 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
4992
4993 Stabilized APIs
4994 ---------------
4995
4996 - [`CStr::into_c_string`]
4997 - [`CString::as_c_str`]
4998 - [`CString::into_boxed_c_str`]
4999 - [`Chain::get_mut`]
5000 - [`Chain::get_ref`]
5001 - [`Chain::into_inner`]
5002 - [`Option::get_or_insert_with`]
5003 - [`Option::get_or_insert`]
5004 - [`OsStr::into_os_string`]
5005 - [`OsString::into_boxed_os_str`]
5006 - [`Take::get_mut`]
5007 - [`Take::get_ref`]
5008 - [`Utf8Error::error_len`]
5009 - [`char::EscapeDebug`]
5010 - [`char::escape_debug`]
5011 - [`compile_error!`]
5012 - [`f32::from_bits`]
5013 - [`f32::to_bits`]
5014 - [`f64::from_bits`]
5015 - [`f64::to_bits`]
5016 - [`mem::ManuallyDrop`]
5017 - [`slice::sort_unstable_by_key`]
5018 - [`slice::sort_unstable_by`]
5019 - [`slice::sort_unstable`]
5020 - [`str::from_boxed_utf8_unchecked`]
5021 - [`str::as_bytes_mut`]
5022 - [`str::as_bytes_mut`]
5023 - [`str::from_utf8_mut`]
5024 - [`str::from_utf8_unchecked_mut`]
5025 - [`str::get_mut`]
5026 - [`str::get_unchecked_mut`]
5027 - [`str::get_unchecked`]
5028 - [`str::get`]
5029 - [`str::into_boxed_bytes`]
5030
5031
5032 Cargo
5033 -----
5034 - [Cargo API token location moved from `~/.cargo/config` to
5035   `~/.cargo/credentials`.][cargo/3978]
5036 - [Cargo will now build `main.rs` binaries that are in sub-directories of
5037   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
5038   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
5039 - [You can now specify version of a binary when installed through
5040   `cargo install` using `--vers`.][cargo/4229]
5041 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
5042   failure.][cargo/4248]
5043 - [Changed the convention around which file is the crate root.][cargo/4259]
5044 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
5045   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
5046
5047 Compatibility Notes
5048 -------------------
5049
5050 - [Functions with `'static` in their return types will now not be as usable as
5051   if they were using lifetime parameters instead.][42417]
5052 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
5053   takes the sign of NaN into account where previously didn't.][42430]
5054
5055 [42033]: https://github.com/rust-lang/rust/pull/42033
5056 [42155]: https://github.com/rust-lang/rust/pull/42155
5057 [42271]: https://github.com/rust-lang/rust/pull/42271
5058 [42397]: https://github.com/rust-lang/rust/pull/42397
5059 [42417]: https://github.com/rust-lang/rust/pull/42417
5060 [42430]: https://github.com/rust-lang/rust/pull/42430
5061 [42431]: https://github.com/rust-lang/rust/pull/42431
5062 [42533]: https://github.com/rust-lang/rust/pull/42533
5063 [42571]: https://github.com/rust-lang/rust/pull/42571
5064 [42613]: https://github.com/rust-lang/rust/pull/42613
5065 [42799]: https://github.com/rust-lang/rust/pull/42799
5066 [42807]: https://github.com/rust-lang/rust/pull/42807
5067 [42809]: https://github.com/rust-lang/rust/pull/42809
5068 [42822]: https://github.com/rust-lang/rust/pull/42822
5069 [42826]: https://github.com/rust-lang/rust/pull/42826
5070 [42854]: https://github.com/rust-lang/rust/pull/42854
5071 [42913]: https://github.com/rust-lang/rust/pull/42913
5072 [42999]: https://github.com/rust-lang/rust/pull/42999
5073 [43011]: https://github.com/rust-lang/rust/pull/43011
5074 [43015]: https://github.com/rust-lang/rust/pull/43015
5075 [43072]: https://github.com/rust-lang/rust/pull/43072
5076 [43077]: https://github.com/rust-lang/rust/pull/43077
5077 [43097]: https://github.com/rust-lang/rust/pull/43097
5078 [43099]: https://github.com/rust-lang/rust/pull/43099
5079 [43170]: https://github.com/rust-lang/rust/pull/43170
5080 [43178]: https://github.com/rust-lang/rust/pull/43178
5081 [43185]: https://github.com/rust-lang/rust/pull/43185
5082 [43228]: https://github.com/rust-lang/rust/pull/43228
5083 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
5084 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
5085 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
5086 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
5087 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
5088 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5089 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
5090 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
5091 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
5092 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
5093 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
5094 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
5095 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
5096 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
5097 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
5098 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
5099 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
5100 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
5101 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
5102 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
5103 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
5104 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
5105 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
5106 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
5107 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
5108 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
5109 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
5110 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
5111 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
5112 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
5113 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
5114 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
5115 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
5116 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
5117 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
5118 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
5119 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
5120 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5121 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5122
5123
5124 Version 1.19.0 (2017-07-20)
5125 ===========================
5126
5127 Language
5128 --------
5129
5130 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5131   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5132 - [Macro recursion limit increased to 1024 from 64.][41676]
5133 - [Added lint for detecting unused macros.][41907]
5134 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5135   For example: `let x = loop { break 7; };`
5136 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5137   contain `Copy` types and cannot have a `Drop` implementation.
5138   Example: `union Foo { bar: u8, baz: usize }`
5139 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5140   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5141
5142 Compiler
5143 --------
5144
5145 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5146 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5147   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5148   you should use `--target armv7-linux-androideabi`.
5149 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5150 - [Minor optimisation of string operations.][42037]
5151 - [Compiler error message is now `aborting due to previous error(s)` instead of
5152   `aborting due to N previous errors`][42150] This was previously inaccurate and
5153   would only count certain kinds of errors.
5154 - [The compiler now supports Visual Studio 2017][42225]
5155 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5156 - [Added a lot][42264] of [new error codes][42302]
5157 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5158   libraries with C Run-time Libraries(CRT) to be statically linked.
5159 - [Fixed various ARM codegen bugs][42740]
5160
5161 Libraries
5162 ---------
5163
5164 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5165   `Extend<Cow<'a, str>>`][41449]
5166 - [`Vec` now implements `From<&mut [T]>`][41530]
5167 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5168 - [`SplitWhitespace` now implements `Clone`][41659]
5169 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5170   1.5x faster][41764]
5171 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5172   macros, but for printing to stderr.
5173
5174 Stabilized APIs
5175 ---------------
5176
5177 - [`OsString::shrink_to_fit`]
5178 - [`cmp::Reverse`]
5179 - [`Command::envs`]
5180 - [`thread::ThreadId`]
5181
5182 Cargo
5183 -----
5184
5185 - [Build scripts can now add environment variables to the environment
5186   the crate is being compiled in.
5187   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5188 - [Subcommands now replace the current process rather than spawning a new
5189   child process][cargo/3970]
5190 - [Workspace members can now accept glob file patterns][cargo/3979]
5191 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5192   the members in a given workspace.][cargo/3988]
5193 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5194 - [Target directory path is now in the cargo metadata][cargo/4022]
5195 - [Cargo no longer checks out a local working directory for the
5196   crates.io index][cargo/4026] This should provide smaller file size for the
5197   registry, and improve cloning times, especially on Windows machines.
5198 - [Added an `--exclude` option for excluding certain packages when using the
5199   `--all` option][cargo/4031]
5200 - [Cargo will now automatically retry when receiving a 5xx error
5201   from crates.io][cargo/4032]
5202 - [The `--features` option now accepts multiple comma or space
5203   delimited values.][cargo/4084]
5204 - [Added support for custom target specific runners][cargo/3954]
5205
5206 Misc
5207 ----
5208
5209 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5210   Windows Debugger.
5211 - [Rust will now release XZ compressed packages][rust-installer/57]
5212 - [rustup will now prefer to download rust packages with
5213   XZ compression][rustup/1100] over GZip packages.
5214 - [Added the ability to escape `#` in rust documentation][41785] By adding
5215   additional `#`'s ie. `##` is now `#`
5216
5217 Compatibility Notes
5218 -------------------
5219
5220 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5221 - [`-Z` flags are now no longer allowed to be used on the stable
5222   compiler.][41751] This has been a warning for a year previous to this.
5223 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5224   longer works][42844]. Users should migrate to the built-in `check`
5225   command, which has been available since 1.16.
5226 - [Ending a float literal with `._` is now a hard error.
5227   Example: `42._` .][41946]
5228 - [Any use of a private `extern crate` outside of its module is now a
5229   hard error.][36886] This was previously a warning.
5230 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5231   relative while the `::` prefix makes a path absolute, but was ignored and the
5232   path was relative regardless.
5233 - [Floating point constants in match patterns is now a hard error][36890]
5234   This was previously a warning.
5235 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5236   match patterns is now a hard error][36891] This was previously a warning.
5237 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5238   a warning.
5239 - [From the pound escape, lines consisting of multiple `#`s are
5240   now visible][41785]
5241 - [It is an error to re-export private enum variants][42460]. This is
5242   known to break a number of crates that depend on an older version of
5243   mustache.
5244 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5245   to use it to find the linker, and the build will fail where it did
5246   not previously][42607]
5247
5248 [36886]: https://github.com/rust-lang/rust/issues/36886
5249 [36888]: https://github.com/rust-lang/rust/issues/36888
5250 [36890]: https://github.com/rust-lang/rust/issues/36890
5251 [36891]: https://github.com/rust-lang/rust/issues/36891
5252 [36892]: https://github.com/rust-lang/rust/issues/36892
5253 [37406]: https://github.com/rust-lang/rust/issues/37406
5254 [39983]: https://github.com/rust-lang/rust/pull/39983
5255 [41145]: https://github.com/rust-lang/rust/pull/41145
5256 [41192]: https://github.com/rust-lang/rust/pull/41192
5257 [41258]: https://github.com/rust-lang/rust/pull/41258
5258 [41370]: https://github.com/rust-lang/rust/pull/41370
5259 [41449]: https://github.com/rust-lang/rust/pull/41449
5260 [41530]: https://github.com/rust-lang/rust/pull/41530
5261 [41624]: https://github.com/rust-lang/rust/pull/41624
5262 [41656]: https://github.com/rust-lang/rust/pull/41656
5263 [41659]: https://github.com/rust-lang/rust/pull/41659
5264 [41676]: https://github.com/rust-lang/rust/pull/41676
5265 [41751]: https://github.com/rust-lang/rust/pull/41751
5266 [41764]: https://github.com/rust-lang/rust/pull/41764
5267 [41785]: https://github.com/rust-lang/rust/pull/41785
5268 [41873]: https://github.com/rust-lang/rust/pull/41873
5269 [41907]: https://github.com/rust-lang/rust/pull/41907
5270 [41946]: https://github.com/rust-lang/rust/pull/41946
5271 [42016]: https://github.com/rust-lang/rust/pull/42016
5272 [42037]: https://github.com/rust-lang/rust/pull/42037
5273 [42068]: https://github.com/rust-lang/rust/pull/42068
5274 [42150]: https://github.com/rust-lang/rust/pull/42150
5275 [42162]: https://github.com/rust-lang/rust/pull/42162
5276 [42225]: https://github.com/rust-lang/rust/pull/42225
5277 [42264]: https://github.com/rust-lang/rust/pull/42264
5278 [42302]: https://github.com/rust-lang/rust/pull/42302
5279 [42460]: https://github.com/rust-lang/rust/issues/42460
5280 [42607]: https://github.com/rust-lang/rust/issues/42607
5281 [42740]: https://github.com/rust-lang/rust/pull/42740
5282 [42844]: https://github.com/rust-lang/rust/issues/42844
5283 [42948]: https://github.com/rust-lang/rust/pull/42948
5284 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5285 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5286 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5287 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5288 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5289 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5290 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5291 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5292 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5293 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5294 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5295 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5296 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5297 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5298 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5299 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5300 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5301 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5302 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5303 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5304 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5305 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5306
5307
5308 Version 1.18.0 (2017-06-08)
5309 ===========================
5310
5311 Language
5312 --------
5313
5314 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5315   make the item visible to just that module tree. Also accepts the keyword
5316   `crate` to make something public to the whole crate but not users of the
5317   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5318 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5319   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5320 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5321   types like `Write + Send`, trailing `+` are now supported in trait objects,
5322   and better error reporting for trait objects starting with `?Sized`.
5323 - [0e+10 is now a valid floating point literal][40589]
5324 - [Now warns if you bind a lifetime parameter to 'static][40734]
5325 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5326   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5327   representation in some cases.][40377]
5328
5329 Compiler
5330 --------
5331
5332 - [rustc can now emit mir with `--emit mir`][39891]
5333 - [Improved LLVM IR for trivial functions][40367]
5334 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5335 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5336   opportunities found through profiling
5337 - [Improved backtrace formatting when panicking][38165]
5338
5339 Libraries
5340 ---------
5341
5342 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5343   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5344   iteration or reallocation.
5345 - [Simplified HashMap Bucket interface][40561] provides performance
5346   improvements for iterating and cloning.
5347 - [Specialize Vec::from_elem to use calloc][40409]
5348 - [Fixed Race condition in fs::create_dir_all][39799]
5349 - [No longer caching stdio on Windows][40516]
5350 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5351   2.50%~ faster and in one case now 12.50% faster.
5352 - [Optimized `AtomicBool::fetch_nand`][41143]
5353
5354 Stabilized APIs
5355 ---------------
5356
5357 - [`Child::try_wait`]
5358 - [`HashMap::retain`]
5359 - [`HashSet::retain`]
5360 - [`PeekMut::pop`]
5361 - [`TcpStream::peek`]
5362 - [`UdpSocket::peek`]
5363 - [`UdpSocket::peek_from`]
5364
5365 Cargo
5366 -----
5367
5368 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5369   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5370 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5371 - [Added Android build support][cargo/3885]
5372 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5373   of a certain type, for example `cargo build --bins` will build all
5374   binaries.
5375 - [Added support for haiku][cargo/3952]
5376
5377 Misc
5378 ----
5379
5380 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5381 - [Added rust-windbg script for better debugging on Windows][39983]
5382 - [Rust now uses the official cross compiler for NetBSD][40612]
5383 - [rustdoc now accepts `#` at the start of files][40828]
5384 - [Fixed jemalloc support for musl][41168]
5385
5386 Compatibility Notes
5387 -------------------
5388
5389 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5390   always placed after the sign if it exists and before the digits. With the `#`
5391   flag the zeroes are placed after the prefix and before the digits.
5392 - [Due to the struct field optimisation][40377], using `transmute` on structs
5393   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5394   always been undefined behavior, but is now more likely to break in practice.
5395 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5396   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5397   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5398 - [Overlapping inherent `impl`s are now a hard error][40728]
5399 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5400 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5401   `out.asm` and `out.ll` instead of only one of the filetypes.
5402 - [ calling a function that returns `Self` will no longer work][41805] when
5403   the size of `Self` cannot be statically determined.
5404 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5405   this has caused a few regressions namely:
5406
5407   - Changed the link order of local static/dynamic libraries (respecting the
5408     order on given rather than having the compiler reorder).
5409   - Changed how MinGW is linked, native code linked to dynamic libraries
5410     may require manually linking to the gcc support library (for the native
5411     code itself)
5412
5413 [38165]: https://github.com/rust-lang/rust/pull/38165
5414 [39799]: https://github.com/rust-lang/rust/pull/39799
5415 [39891]: https://github.com/rust-lang/rust/pull/39891
5416 [39983]: https://github.com/rust-lang/rust/pull/39983
5417 [40043]: https://github.com/rust-lang/rust/pull/40043
5418 [40241]: https://github.com/rust-lang/rust/pull/40241
5419 [40338]: https://github.com/rust-lang/rust/pull/40338
5420 [40367]: https://github.com/rust-lang/rust/pull/40367
5421 [40377]: https://github.com/rust-lang/rust/pull/40377
5422 [40409]: https://github.com/rust-lang/rust/pull/40409
5423 [40516]: https://github.com/rust-lang/rust/pull/40516
5424 [40556]: https://github.com/rust-lang/rust/pull/40556
5425 [40561]: https://github.com/rust-lang/rust/pull/40561
5426 [40589]: https://github.com/rust-lang/rust/pull/40589
5427 [40612]: https://github.com/rust-lang/rust/pull/40612
5428 [40723]: https://github.com/rust-lang/rust/pull/40723
5429 [40728]: https://github.com/rust-lang/rust/pull/40728
5430 [40731]: https://github.com/rust-lang/rust/pull/40731
5431 [40734]: https://github.com/rust-lang/rust/pull/40734
5432 [40805]: https://github.com/rust-lang/rust/pull/40805
5433 [40807]: https://github.com/rust-lang/rust/pull/40807
5434 [40828]: https://github.com/rust-lang/rust/pull/40828
5435 [40870]: https://github.com/rust-lang/rust/pull/40870
5436 [41085]: https://github.com/rust-lang/rust/pull/41085
5437 [41143]: https://github.com/rust-lang/rust/pull/41143
5438 [41168]: https://github.com/rust-lang/rust/pull/41168
5439 [41270]: https://github.com/rust-lang/rust/issues/41270
5440 [41469]: https://github.com/rust-lang/rust/pull/41469
5441 [41805]: https://github.com/rust-lang/rust/issues/41805
5442 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5443 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5444 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5445 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5446 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5447 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5448 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5449 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5450 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5451 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5452 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5453 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5454 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5455 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5456
5457
5458 Version 1.17.0 (2017-04-27)
5459 ===========================
5460
5461 Language
5462 --------
5463
5464 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5465 * [Fields of structs may be initialized without duplicating the field/variable
5466   names][39761]. [RFC 1682]
5467 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5468 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5469   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5470   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5471   `'b`. Soundness fix.
5472 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5473 * [Static variables may contain references to other statics][40027]
5474
5475 Compiler
5476 --------
5477
5478 * [Exit quickly on only `--emit dep-info`][40336]
5479 * [Make `-C relocation-model` more correctly determine whether the linker
5480   creates a position-independent executable][40245]
5481 * [Add `-C overflow-checks` to directly control whether integer overflow
5482   panics][40037]
5483 * [The rustc type checker now checks items on demand instead of in a single
5484   in-order pass][40008]. This is mostly an internal refactoring in support of
5485   future work, including incremental type checking, but also resolves [RFC
5486   1647], allowing `Self` to appear in `impl` `where` clauses.
5487 * [Optimize vtable loads][39995]
5488 * [Turn off vectorization for Emscripten targets][39990]
5489 * [Provide suggestions for unknown macros imported with `use`][39953]
5490 * [Fix ICEs in path resolution][39939]
5491 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5492 * [Add clearer error message using `&str + &str`][39116]
5493
5494 Stabilized APIs
5495 ---------------
5496
5497 * [`Arc::into_raw`]
5498 * [`Arc::from_raw`]
5499 * [`Arc::ptr_eq`]
5500 * [`Rc::into_raw`]
5501 * [`Rc::from_raw`]
5502 * [`Rc::ptr_eq`]
5503 * [`Ordering::then`]
5504 * [`Ordering::then_with`]
5505 * [`BTreeMap::range`]
5506 * [`BTreeMap::range_mut`]
5507 * [`collections::Bound`]
5508 * [`process::abort`]
5509 * [`ptr::read_unaligned`]
5510 * [`ptr::write_unaligned`]
5511 * [`Result::expect_err`]
5512 * [`Cell::swap`]
5513 * [`Cell::replace`]
5514 * [`Cell::into_inner`]
5515 * [`Cell::take`]
5516
5517 Libraries
5518 ---------
5519
5520 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5521 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5522 * [`String` implements `FromIterator<&char>`][40028]
5523 * `Box` [implements][40009] a number of new conversions:
5524   `From<Box<str>> for String`,
5525   `From<Box<[T]>> for Vec<T>`,
5526   `From<Box<CStr>> for CString`,
5527   `From<Box<OsStr>> for OsString`,
5528   `From<Box<Path>> for PathBuf`,
5529   `Into<Box<str>> for String`,
5530   `Into<Box<[T]>> for Vec<T>`,
5531   `Into<Box<CStr>> for CString`,
5532   `Into<Box<OsStr>> for OsString`,
5533   `Into<Box<Path>> for PathBuf`,
5534   `Default for Box<str>`,
5535   `Default for Box<CStr>`,
5536   `Default for Box<OsStr>`,
5537   `From<&CStr> for Box<CStr>`,
5538   `From<&OsStr> for Box<OsStr>`,
5539   `From<&Path> for Box<Path>`
5540 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
5541 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
5542 * [Slightly optimize `slice::sort`][39538]
5543 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
5544 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
5545   `Box<str>` implements `From<&str>`][39438]
5546 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
5547   `From<(I, u16)> where I: Into<IpAddr>`][39372]
5548 * [`format!` estimates the needed capacity before writing a string][39356]
5549 * [Support unprivileged symlink creation in Windows][38921]
5550 * [`PathBuf` implements `Default`][38764]
5551 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
5552 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
5553   and poor hash functions.
5554
5555 Cargo
5556 -----
5557
5558 * [Add `cargo check --all`][cargo/3731]
5559 * [Add an option to ignore SSL revocation checking][cargo/3699]
5560 * [Add `cargo run --package`][cargo/3691]
5561 * [Add `required_features`][cargo/3667]
5562 * [Assume `build.rs` is a build script][cargo/3664]
5563 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
5564
5565 Misc
5566 ----
5567
5568 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
5569   `rustbook`][39633]
5570 * [The "Unstable Book" documents nightly-only features][ubook]
5571 * [Improve the style of the sidebar in rustdoc output][40265]
5572 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
5573 * [Fix MSP430 breakage due to `i128`][40257]
5574 * [Preliminary Solaris/SPARCv9 support][39903]
5575 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
5576   run without installing the MSVC runtime.
5577 * [`rustdoc --test` includes file names in test names][39788]
5578 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
5579   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
5580 * [Initial support for `aarch64-unknown-freebsd`][39491]
5581 * [Initial support for `i686-unknown-netbsd`][39426]
5582 * [This release no longer includes the old makefile build system][39431]. Rust
5583   is built with a custom build system, written in Rust, and with Cargo.
5584 * [Add Debug implementations for libcollection structs][39002]
5585 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
5586 * [`--test-threads=0` produces an error][38945]
5587 * [`rustup` installs documentation by default][40526]
5588 * [The Rust source includes NatVis visualizations][39843]. These can be used by
5589   WinDbg and Visual Studio to improve the debugging experience.
5590
5591 Compatibility Notes
5592 -------------------
5593
5594 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
5595   workaround, either use MSVC 2015 or run vcvars.bat.
5596 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5597   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
5598   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
5599   fix.
5600 * [`format!` and `Display::to_string` panic if an underlying formatting
5601   implementation returns an error][40117]. Previously the error was silently
5602   ignored. It is incorrect for `write_fmt` to return an error when writing
5603   to a string.
5604 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
5605   crates were marked stable and could be accessed from the stable toolchain.
5606 * [Rust git source no longer includes vendored crates][39728]. Those that need
5607   to build with vendored crates should build from release tarballs.
5608 * [Fix inert attributes from `proc_macro_derives`][39572]
5609 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
5610   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
5611   build system.
5612 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
5613   existing code generally ignores the type of dead-code unless a type-hint is
5614   provided; this can cause surprising inference interactions particularly around
5615   defaulting. The new code uniformly ignores the result type of dead-code.
5616 * [Tuple-struct constructors with private fields are no longer visible][38932]
5617 * [Lifetime parameters that do not appear in the arguments are now considered
5618   early-bound][38897], resolving a soundness bug (#[32330]). The
5619   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
5620   April of 2016.
5621 * [rustdoc: fix doctests with non-feature crate attributes][38161]
5622 * [Make transmuting from fn item types to pointer-sized types a hard
5623   error][34198]
5624
5625 [27787]: https://github.com/rust-lang/rust/issues/27787
5626 [32330]: https://github.com/rust-lang/rust/issues/32330
5627 [34198]: https://github.com/rust-lang/rust/pull/34198
5628 [38161]: https://github.com/rust-lang/rust/pull/38161
5629 [38368]: https://github.com/rust-lang/rust/pull/38368
5630 [38584]: https://github.com/rust-lang/rust/issues/38584
5631 [38661]: https://github.com/rust-lang/rust/pull/38661
5632 [38764]: https://github.com/rust-lang/rust/pull/38764
5633 [38864]: https://github.com/rust-lang/rust/issues/38864
5634 [38897]: https://github.com/rust-lang/rust/pull/38897
5635 [38921]: https://github.com/rust-lang/rust/pull/38921
5636 [38932]: https://github.com/rust-lang/rust/pull/38932
5637 [38945]: https://github.com/rust-lang/rust/pull/38945
5638 [38981]: https://github.com/rust-lang/rust/pull/38981
5639 [39002]: https://github.com/rust-lang/rust/pull/39002
5640 [39116]: https://github.com/rust-lang/rust/pull/39116
5641 [39193]: https://github.com/rust-lang/rust/pull/39193
5642 [39265]: https://github.com/rust-lang/rust/pull/39265
5643 [39356]: https://github.com/rust-lang/rust/pull/39356
5644 [39372]: https://github.com/rust-lang/rust/pull/39372
5645 [39426]: https://github.com/rust-lang/rust/pull/39426
5646 [39431]: https://github.com/rust-lang/rust/pull/39431
5647 [39438]: https://github.com/rust-lang/rust/pull/39438
5648 [39440]: https://github.com/rust-lang/rust/pull/39440
5649 [39485]: https://github.com/rust-lang/rust/pull/39485
5650 [39491]: https://github.com/rust-lang/rust/pull/39491
5651 [39518]: https://github.com/rust-lang/rust/pull/39518
5652 [39538]: https://github.com/rust-lang/rust/pull/39538
5653 [39572]: https://github.com/rust-lang/rust/pull/39572
5654 [39633]: https://github.com/rust-lang/rust/pull/39633
5655 [39642]: https://github.com/rust-lang/rust/pull/39642
5656 [39728]: https://github.com/rust-lang/rust/pull/39728
5657 [39761]: https://github.com/rust-lang/rust/pull/39761
5658 [39788]: https://github.com/rust-lang/rust/pull/39788
5659 [39793]: https://github.com/rust-lang/rust/pull/39793
5660 [39837]: https://github.com/rust-lang/rust/pull/39837
5661 [39843]: https://github.com/rust-lang/rust/pull/39843
5662 [39851]: https://github.com/rust-lang/rust/pull/39851
5663 [39903]: https://github.com/rust-lang/rust/pull/39903
5664 [39939]: https://github.com/rust-lang/rust/pull/39939
5665 [39953]: https://github.com/rust-lang/rust/pull/39953
5666 [39960]: https://github.com/rust-lang/rust/pull/39960
5667 [39990]: https://github.com/rust-lang/rust/pull/39990
5668 [39995]: https://github.com/rust-lang/rust/pull/39995
5669 [40008]: https://github.com/rust-lang/rust/pull/40008
5670 [40009]: https://github.com/rust-lang/rust/pull/40009
5671 [40027]: https://github.com/rust-lang/rust/pull/40027
5672 [40028]: https://github.com/rust-lang/rust/pull/40028
5673 [40037]: https://github.com/rust-lang/rust/pull/40037
5674 [40117]: https://github.com/rust-lang/rust/pull/40117
5675 [40166]: https://github.com/rust-lang/rust/pull/40166
5676 [40245]: https://github.com/rust-lang/rust/pull/40245
5677 [40257]: https://github.com/rust-lang/rust/pull/40257
5678 [40261]: https://github.com/rust-lang/rust/pull/40261
5679 [40265]: https://github.com/rust-lang/rust/pull/40265
5680 [40319]: https://github.com/rust-lang/rust/pull/40319
5681 [40336]: https://github.com/rust-lang/rust/pull/40336
5682 [40526]: https://github.com/rust-lang/rust/pull/40526
5683 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5684 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
5685 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
5686 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
5687 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
5688 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
5689 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
5690 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
5691 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
5692 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
5693 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
5694 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
5695 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
5696 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
5697 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
5698 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
5699 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
5700 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
5701 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
5702 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
5703 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
5704 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
5705 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
5706 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
5707 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
5708 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
5709 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
5710 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
5711 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
5712 [mdbook]: https://crates.io/crates/mdbook
5713 [ubook]: https://doc.rust-lang.org/unstable-book/
5714
5715
5716 Version 1.16.0 (2017-03-16)
5717 ===========================
5718
5719 Language
5720 --------
5721
5722 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5723 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5724   match patterns][38069]
5725 * [Clean up semantics of `self` in an import list][38313]
5726 * [`Self` may appear in `impl` headers][38920]
5727 * [`Self` may appear in struct expressions][39282]
5728
5729 Compiler
5730 --------
5731
5732 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
5733   a `.rmeta` file containing only crate metadata][38571]. This can be
5734   used by tools like the Rust Language Service to perform
5735   metadata-only builds.
5736 * [Levenshtein based typo suggestions now work in most places, while
5737   previously they worked only for fields and sometimes for local
5738   variables][38927]. Together with the overhaul of "no
5739   resolution"/"unexpected resolution" errors (#[38154]) they result in
5740   large and systematic improvement in resolution diagnostics.
5741 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
5742   `U`][38670]
5743 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
5744 * [`rustc` no longer attempts to provide "consider using an explicit
5745   lifetime" suggestions][37057]. They were inaccurate.
5746
5747 Stabilized APIs
5748 ---------------
5749
5750 * [`VecDeque::truncate`]
5751 * [`VecDeque::resize`]
5752 * [`String::insert_str`]
5753 * [`Duration::checked_add`]
5754 * [`Duration::checked_sub`]
5755 * [`Duration::checked_div`]
5756 * [`Duration::checked_mul`]
5757 * [`str::replacen`]
5758 * [`str::repeat`]
5759 * [`SocketAddr::is_ipv4`]
5760 * [`SocketAddr::is_ipv6`]
5761 * [`IpAddr::is_ipv4`]
5762 * [`IpAddr::is_ipv6`]
5763 * [`Vec::dedup_by`]
5764 * [`Vec::dedup_by_key`]
5765 * [`Result::unwrap_or_default`]
5766 * [`<*const T>::wrapping_offset`]
5767 * [`<*mut T>::wrapping_offset`]
5768 * `CommandExt::creation_flags`
5769 * [`File::set_permissions`]
5770 * [`String::split_off`]
5771
5772 Libraries
5773 ---------
5774
5775 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
5776   their argument by `Borrow` parameter][37761]
5777 * [All public types in std implement `Debug`][38006]
5778 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
5779 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
5780 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5781   Windows][38274]
5782 * [std: Fix partial writes in `LineWriter`][38062]
5783 * [std: Clamp max read/write sizes on Unix][38062]
5784 * [Use more specific panic message for `&str` slicing errors][38066]
5785 * [`TcpListener::set_only_v6` is deprecated][38304]. This
5786   functionality cannot be achieved in std currently.
5787 * [`writeln!`, like `println!`, now accepts a form with no string
5788   or formatting arguments, to just print a newline][38469]
5789 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
5790 * [Reduce the size of static data in `std_unicode::tables`][38781]
5791 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
5792   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
5793   `Display`][38909]
5794 * [`Duration` implements `Sum`][38712]
5795 * [`String` implements `ToSocketAddrs`][39048]
5796
5797 Cargo
5798 -----
5799
5800 * [The `cargo check` command does a type check of a project without
5801   building it][cargo/3296]
5802 * [crates.io will display CI badges from Travis and AppVeyor, if
5803   specified in Cargo.toml][cargo/3546]
5804 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
5805 * [Compilation profiles accept integer values for `debug`, in addition
5806   to `true` and `false`. These are passed to `rustc` as the value to
5807   `-C debuginfo`][cargo/3534]
5808 * [Implement `cargo --version --verbose`][cargo/3604]
5809 * [All builds now output 'dep-info' build dependencies compatible with
5810   make and ninja][cargo/3557]
5811 * [Build all workspace members with `build --all`][cargo/3511]
5812 * [Document all workspace members with `doc --all`][cargo/3515]
5813 * [Path deps outside workspace are not members][cargo/3443]
5814
5815 Misc
5816 ----
5817
5818 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
5819   the path to the Rust implementation][38589]
5820 * [The `armv7-linux-androideabi` target no longer enables NEON
5821   extensions, per Google's ABI guide][38413]
5822 * [The stock standard library can be compiled for Redox OS][38401]
5823 * [Rust has initial SPARC support][38726]. Tier 3. No builds
5824   available.
5825 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
5826   builds available.
5827 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
5828
5829 Compatibility Notes
5830 -------------------
5831
5832 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5833   match patterns][38069]
5834 * In this release, references to uninhabited types can not be
5835   pattern-matched. This was accidentally allowed in 1.15.
5836 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5837 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5838   Windows][38274]
5839 * [Clean up semantics of `self` in an import list][38313]
5840 * Reimplemented lifetime elision. This change was almost entirely compatible
5841   with existing code, but it did close a number of small bugs and loopholes,
5842   as well as being more accepting in some other [cases][41105].
5843
5844 [37057]: https://github.com/rust-lang/rust/pull/37057
5845 [37761]: https://github.com/rust-lang/rust/pull/37761
5846 [38006]: https://github.com/rust-lang/rust/pull/38006
5847 [38051]: https://github.com/rust-lang/rust/pull/38051
5848 [38062]: https://github.com/rust-lang/rust/pull/38062
5849 [38062]: https://github.com/rust-lang/rust/pull/38622
5850 [38066]: https://github.com/rust-lang/rust/pull/38066
5851 [38069]: https://github.com/rust-lang/rust/pull/38069
5852 [38131]: https://github.com/rust-lang/rust/pull/38131
5853 [38154]: https://github.com/rust-lang/rust/pull/38154
5854 [38274]: https://github.com/rust-lang/rust/pull/38274
5855 [38304]: https://github.com/rust-lang/rust/pull/38304
5856 [38313]: https://github.com/rust-lang/rust/pull/38313
5857 [38314]: https://github.com/rust-lang/rust/pull/38314
5858 [38327]: https://github.com/rust-lang/rust/pull/38327
5859 [38401]: https://github.com/rust-lang/rust/pull/38401
5860 [38413]: https://github.com/rust-lang/rust/pull/38413
5861 [38469]: https://github.com/rust-lang/rust/pull/38469
5862 [38559]: https://github.com/rust-lang/rust/pull/38559
5863 [38571]: https://github.com/rust-lang/rust/pull/38571
5864 [38580]: https://github.com/rust-lang/rust/pull/38580
5865 [38589]: https://github.com/rust-lang/rust/pull/38589
5866 [38670]: https://github.com/rust-lang/rust/pull/38670
5867 [38712]: https://github.com/rust-lang/rust/pull/38712
5868 [38726]: https://github.com/rust-lang/rust/pull/38726
5869 [38781]: https://github.com/rust-lang/rust/pull/38781
5870 [38798]: https://github.com/rust-lang/rust/pull/38798
5871 [38909]: https://github.com/rust-lang/rust/pull/38909
5872 [38920]: https://github.com/rust-lang/rust/pull/38920
5873 [38927]: https://github.com/rust-lang/rust/pull/38927
5874 [39048]: https://github.com/rust-lang/rust/pull/39048
5875 [39282]: https://github.com/rust-lang/rust/pull/39282
5876 [39379]: https://github.com/rust-lang/rust/pull/39379
5877 [41105]: https://github.com/rust-lang/rust/issues/41105
5878 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5879 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5880 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
5881 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
5882 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
5883 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
5884 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
5885 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
5886 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
5887 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
5888 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
5889 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
5890 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
5891 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
5892 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
5893 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
5894 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
5895 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
5896 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
5897 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
5898 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
5899 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
5900 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
5901 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
5902 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
5903 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
5904 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
5905 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
5906 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
5907 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5908
5909
5910 Version 1.15.1 (2017-02-09)
5911 ===========================
5912
5913 * [Fix IntoIter::as_mut_slice's signature][39466]
5914 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
5915
5916 [39466]: https://github.com/rust-lang/rust/pull/39466
5917 [39523]: https://github.com/rust-lang/rust/pull/39523
5918
5919
5920 Version 1.15.0 (2017-02-02)
5921 ===========================
5922
5923 Language
5924 --------
5925
5926 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
5927   stable. This allows popular code-generating crates like Serde and Diesel to
5928   work ergonomically. [RFC 1681].
5929 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
5930   with curly braces][36868]. Part of [RFC 1506].
5931 * [A number of minor changes to name resolution have been activated][37127].
5932   They add up to more consistent semantics, allowing for future evolution of
5933   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5934   details of what is different. The breaking changes here have been transitioned
5935   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5936 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
5937   bounds][38279]
5938 * [`?Sized` can be used in `where` clauses][37791]
5939 * [There is now a limit on the size of monomorphized types and it can be
5940   modified with the `#![type_size_limit]` crate attribute, similarly to
5941   the `#![recursion_limit]` attribute][37789]
5942
5943 Compiler
5944 --------
5945
5946 * [On Windows, the compiler will apply dllimport attributes when linking to
5947   extern functions][37973]. Additional attributes and flags can control which
5948   library kind is linked and its name. [RFC 1717].
5949 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5950 * [The `--test` flag works with procedural macro crates][38107]
5951 * [Fix `extern "aapcs" fn` ABI][37814]
5952 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
5953 * [The `format!` expander recognizes incorrect `printf` and shell-style
5954   formatting directives and suggests the correct format][37613].
5955 * [Only report one error for all unused imports in an import list][37456]
5956
5957 Compiler Performance
5958 --------------------
5959
5960 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
5961 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
5962 * [Don't clone in `UnificationTable::probe`][37848]
5963 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
5964 * [Use small vectors in type walker][37760]
5965 * [Macro expansion performance was improved][37701]
5966 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
5967 * [Replace FNV with a faster hash function][37229]
5968
5969 Stabilized APIs
5970 ---------------
5971
5972 * [`std::iter::Iterator::min_by`]
5973 * [`std::iter::Iterator::max_by`]
5974 * [`std::os::*::fs::FileExt`]
5975 * [`std::sync::atomic::Atomic*::get_mut`]
5976 * [`std::sync::atomic::Atomic*::into_inner`]
5977 * [`std::vec::IntoIter::as_slice`]
5978 * [`std::vec::IntoIter::as_mut_slice`]
5979 * [`std::sync::mpsc::Receiver::try_iter`]
5980 * [`std::os::unix::process::CommandExt::before_exec`]
5981 * [`std::rc::Rc::strong_count`]
5982 * [`std::rc::Rc::weak_count`]
5983 * [`std::sync::Arc::strong_count`]
5984 * [`std::sync::Arc::weak_count`]
5985 * [`std::char::encode_utf8`]
5986 * [`std::char::encode_utf16`]
5987 * [`std::cell::Ref::clone`]
5988 * [`std::io::Take::into_inner`]
5989
5990 Libraries
5991 ---------
5992
5993 * [The standard sorting algorithm has been rewritten for dramatic performance
5994   improvements][38192]. It is a hybrid merge sort, drawing influences from
5995   Timsort. Previously it was a naive merge sort.
5996 * [`Iterator::nth` no longer has a `Sized` bound][38134]
5997 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
5998   performance.
5999 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6000   and `char_indices().last()`][37882]
6001 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6002 * [Chinese characters display correctly in `fmt::Debug`][37855]
6003 * [Derive `Default` for `Duration`][37699]
6004 * [Support creation of anonymous pipes on WinXP/2k][37677]
6005 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6006 * [Don't pass overlapped handles to processes][38835]
6007
6008 Cargo
6009 -----
6010
6011 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6012   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6013   should instead check the variable at runtime with `std::env`. That the value
6014   was set at build time was a bug, and incorrect when cross-compiling. This
6015   change is known to cause breakage.
6016 * [Add `--all` flag to `cargo test`][cargo/3221]
6017 * [Compile statically against the MSVC CRT][cargo/3363]
6018 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6019 * [Link OpenSSL statically on OSX][cargo/3311]
6020 * [Apply new fingerprinting to build dir outputs][cargo/3310]
6021 * [Test for bad path overrides with summaries][cargo/3336]
6022 * [Require `cargo install --vers` to take a semver version][cargo/3338]
6023 * [Fix retrying crate downloads for network errors][cargo/3348]
6024 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
6025 * [Emit more info on --message-format=json][cargo/3319]
6026 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
6027 * [Don't ignore errors in workspace manifest][cargo/3409]
6028 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
6029
6030 Tooling
6031 -------
6032
6033 * [Test runners (binaries built with `--test`) now support a `--list` argument
6034   that lists the tests it contains][38185]
6035 * [Test runners now support a `--exact` argument that makes the test filter
6036   match exactly, instead of matching only a substring of the test name][38181]
6037 * [rustdoc supports a `--playground-url` flag][37763]
6038 * [rustdoc provides more details about `#[should_panic]` errors][37749]
6039
6040 Misc
6041 ----
6042
6043 * [The Rust build system is now written in Rust][37817]. The Makefiles may
6044   continue to be used in this release by passing `--disable-rustbuild` to the
6045   configure script, but they will be deleted soon. Note that the new build
6046   system uses a different on-disk layout that will likely affect any scripts
6047   building Rust.
6048 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
6049   releases.
6050 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
6051 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
6052   releases.
6053
6054 Compatibility Notes
6055 -------------------
6056
6057 * [A number of minor changes to name resolution have been activated][37127].
6058   They add up to more consistent semantics, allowing for future evolution of
6059   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6060   details of what is different. The breaking changes here have been transitioned
6061   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6062 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6063   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6064   should instead check the variable at runtime with `std::env`. That the value
6065   was set at build time was a bug, and incorrect when cross-compiling. This
6066   change is known to cause breakage.
6067 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
6068   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
6069   1.10 and is now an error by default. It will become a hard error in the near
6070   future.
6071 * [The semantics relating modules to file system directories are changing in
6072   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
6073   lint, which is a warning in this release, and will become a hard error in the
6074   future.
6075 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6076 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
6077   the underlying iterator][37834]
6078
6079 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
6080 [33685]: https://github.com/rust-lang/rust/issues/33685
6081 [36868]: https://github.com/rust-lang/rust/pull/36868
6082 [37127]: https://github.com/rust-lang/rust/pull/37127
6083 [37229]: https://github.com/rust-lang/rust/pull/37229
6084 [37456]: https://github.com/rust-lang/rust/pull/37456
6085 [37527]: https://github.com/rust-lang/rust/pull/37527
6086 [37602]: https://github.com/rust-lang/rust/pull/37602
6087 [37613]: https://github.com/rust-lang/rust/pull/37613
6088 [37615]: https://github.com/rust-lang/rust/pull/37615
6089 [37636]: https://github.com/rust-lang/rust/pull/37636
6090 [37627]: https://github.com/rust-lang/rust/pull/37627
6091 [37642]: https://github.com/rust-lang/rust/pull/37642
6092 [37677]: https://github.com/rust-lang/rust/pull/37677
6093 [37699]: https://github.com/rust-lang/rust/pull/37699
6094 [37701]: https://github.com/rust-lang/rust/pull/37701
6095 [37705]: https://github.com/rust-lang/rust/pull/37705
6096 [37749]: https://github.com/rust-lang/rust/pull/37749
6097 [37760]: https://github.com/rust-lang/rust/pull/37760
6098 [37763]: https://github.com/rust-lang/rust/pull/37763
6099 [37764]: https://github.com/rust-lang/rust/pull/37764
6100 [37789]: https://github.com/rust-lang/rust/pull/37789
6101 [37791]: https://github.com/rust-lang/rust/pull/37791
6102 [37814]: https://github.com/rust-lang/rust/pull/37814
6103 [37817]: https://github.com/rust-lang/rust/pull/37817
6104 [37834]: https://github.com/rust-lang/rust/pull/37834
6105 [37848]: https://github.com/rust-lang/rust/pull/37848
6106 [37855]: https://github.com/rust-lang/rust/pull/37855
6107 [37882]: https://github.com/rust-lang/rust/pull/37882
6108 [37888]: https://github.com/rust-lang/rust/pull/37888
6109 [37973]: https://github.com/rust-lang/rust/pull/37973
6110 [37979]: https://github.com/rust-lang/rust/pull/37979
6111 [38086]: https://github.com/rust-lang/rust/pull/38086
6112 [38107]: https://github.com/rust-lang/rust/pull/38107
6113 [38117]: https://github.com/rust-lang/rust/pull/38117
6114 [38134]: https://github.com/rust-lang/rust/pull/38134
6115 [38146]: https://github.com/rust-lang/rust/pull/38146
6116 [38181]: https://github.com/rust-lang/rust/pull/38181
6117 [38182]: https://github.com/rust-lang/rust/pull/38182
6118 [38185]: https://github.com/rust-lang/rust/pull/38185
6119 [38192]: https://github.com/rust-lang/rust/pull/38192
6120 [38279]: https://github.com/rust-lang/rust/pull/38279
6121 [38835]: https://github.com/rust-lang/rust/pull/38835
6122 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6123 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6124 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6125 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6126 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6127 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6128 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6129 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6130 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6131 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6132 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6133 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6134 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6135 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6136 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6137 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6138 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6139 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6140 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6141 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6142 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6143 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6144 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6145 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6146 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6147 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6148 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6149 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6150 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6151 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6152 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6153 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6154 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6155 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6156 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6157 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6158 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6159 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6160
6161
6162 Version 1.14.0 (2016-12-22)
6163 ===========================
6164
6165 Language
6166 --------
6167
6168 * [`..` matches multiple tuple fields in enum variants, structs
6169   and tuples][36843]. [RFC 1492].
6170 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6171 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6172 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6173   dereferencing][36822]
6174
6175 Compiler
6176 --------
6177
6178 * [Mark enums with non-zero discriminant as non-zero][37224]
6179 * [Lower-case `static mut` names are linted like other
6180   statics and consts][37162]
6181 * [Fix ICE on some macros in const integer positions
6182    (e.g. `[u8; m!()]`)][36819]
6183 * [Improve error message and snippet for "did you mean `x`"][36798]
6184 * [Add a panic-strategy field to the target specification][36794]
6185 * [Include LLVM version in `--version --verbose`][37200]
6186
6187 Compile-time Optimizations
6188 --------------------------
6189
6190 * [Improve macro expansion performance][37569]
6191 * [Shrink `Expr_::ExprInlineAsm`][37445]
6192 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6193 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6194 * [Avoid more allocations when compiling html5ever][37373]
6195 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6196 * [Avoid some allocations in the macro parser][37318]
6197 * [Use a faster deflate setting][37298]
6198 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6199   during interning of slices][37270]
6200 * [Optimize `write_metadata`][37267]
6201 * [Don't process obligation forest cycles when stalled][37231]
6202 * [Avoid many `CrateConfig` clones][37161]
6203 * [Optimize `Substs::super_fold_with`][37108]
6204 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6205 * [Speed up `plug_leaks`][36917]
6206
6207 Libraries
6208 ---------
6209
6210 * [`println!()`, with no arguments, prints newline][36825].
6211   Previously, an empty string was required to achieve the same.
6212 * [`Wrapping` impls standard binary and unary operators, as well as
6213    the `Sum` and `Product` iterators][37356]
6214 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6215   Vec<T>`][37326]
6216 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6217   `VecDeque` iterators][37315]
6218 * [Improve `SipHasher` performance on small values][37312]
6219 * [Add Iterator trait TrustedLen to enable better FromIterator /
6220   Extend][37306]
6221 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6222 * [`ReadDir` implements `Debug`][37221]
6223 * [Implement `RefUnwindSafe` for atomic types][37178]
6224 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6225 * [Avoid allocations in `Decoder::read_str`][37064]
6226 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6227 * [Impl `Debug` for raw pointers to unsized data][36880]
6228 * [Don't reuse `HashMap` random seeds][37470]
6229 * [The internal memory layout of `HashMap` is more cache-friendly, for
6230   significant improvements in some operations][36692]
6231 * [`HashMap` uses less memory on 32-bit architectures][36595]
6232 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6233
6234 Cargo
6235 -----
6236
6237 * [Expose rustc cfg values to build scripts][cargo/3243]
6238 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6239 * [Fix passing --features when testing multiple packages][cargo/3280]
6240 * [Use a single profile set per workspace][cargo/3249]
6241 * [Load `replace` sections from lock files][cargo/3220]
6242 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6243
6244 Tooling
6245 -------
6246
6247 * [rustup is the recommended Rust installation method][1.14rustup]
6248 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6249   S390x. These are [tier 2] platforms and may have major defects. Follow the
6250   instructions on the website to install, or add the targets to an existing
6251   installation with `rustup target add`. The new target triples are:
6252   - `mips-unknown-linux-gnu`
6253   - `mipsel-unknown-linux-gnu`
6254   - `mips64-unknown-linux-gnuabi64`
6255   - `mips64el-unknown-linux-gnuabi64 `
6256   - `powerpc-unknown-linux-gnu`
6257   - `powerpc64-unknown-linux-gnu`
6258   - `powerpc64le-unknown-linux-gnu`
6259   - `s390x-unknown-linux-gnu `
6260 * This release includes target (std) builds for ARM Linux running MUSL
6261   libc. These are [tier 2] platforms and may have major defects. Add the
6262   following triples to an existing rustup installation with `rustup target add`:
6263   - `arm-unknown-linux-musleabi`
6264   - `arm-unknown-linux-musleabihf`
6265   - `armv7-unknown-linux-musleabihf`
6266 * This release includes [experimental support for WebAssembly][1.14wasm], via
6267   the `wasm32-unknown-emscripten` target. This target is known to have major
6268   defects. Please test, report, and fix.
6269 * rustup no longer installs documentation by default. Run `rustup
6270   component add rust-docs` to install.
6271 * [Fix line stepping in debugger][37310]
6272 * [Enable line number debuginfo in releases][37280]
6273
6274 Misc
6275 ----
6276
6277 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6278 * [Add support for Fuchsia OS][37313]
6279 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6280
6281 Compatibility Notes
6282 -------------------
6283
6284 * [A number of forward-compatibility lints used by the compiler
6285   to gradually introduce language changes have been converted
6286   to deny by default][36894]:
6287   - ["use of inaccessible extern crate erroneously allowed"][36886]
6288   - ["type parameter default erroneously allowed in invalid location"][36887]
6289   - ["detects super or self keywords at the beginning of global path"][36888]
6290   - ["two overlapping inherent impls define an item with the same name
6291     were erroneously allowed"][36889]
6292   - ["floating-point constants cannot be used in patterns"][36890]
6293   - ["constants of struct or enum type can only be used in a pattern if
6294      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6295   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6296 * [Prohibit patterns in trait methods without bodies][37378]
6297 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6298 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6299 * [The `$crate` macro variable is accepted in fewer locations][37213]
6300 * [Impls specifying extra region requirements beyond the trait
6301   they implement are rejected][37167]
6302 * [Enums may not be unsized][37111]. Unsized enums are intended to
6303   work but never have. For now they are forbidden.
6304 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6305
6306 [tier 2]: https://forge.rust-lang.org/platform-support.html
6307 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6308 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6309 [36430]: https://github.com/rust-lang/rust/pull/36430
6310 [36595]: https://github.com/rust-lang/rust/pull/36595
6311 [36595]: https://github.com/rust-lang/rust/pull/36595
6312 [36692]: https://github.com/rust-lang/rust/pull/36692
6313 [36767]: https://github.com/rust-lang/rust/pull/36767
6314 [36794]: https://github.com/rust-lang/rust/pull/36794
6315 [36798]: https://github.com/rust-lang/rust/pull/36798
6316 [36819]: https://github.com/rust-lang/rust/pull/36819
6317 [36822]: https://github.com/rust-lang/rust/pull/36822
6318 [36825]: https://github.com/rust-lang/rust/pull/36825
6319 [36843]: https://github.com/rust-lang/rust/pull/36843
6320 [36880]: https://github.com/rust-lang/rust/pull/36880
6321 [36886]: https://github.com/rust-lang/rust/issues/36886
6322 [36887]: https://github.com/rust-lang/rust/issues/36887
6323 [36888]: https://github.com/rust-lang/rust/issues/36888
6324 [36889]: https://github.com/rust-lang/rust/issues/36889
6325 [36890]: https://github.com/rust-lang/rust/issues/36890
6326 [36891]: https://github.com/rust-lang/rust/issues/36891
6327 [36892]: https://github.com/rust-lang/rust/issues/36892
6328 [36894]: https://github.com/rust-lang/rust/pull/36894
6329 [36917]: https://github.com/rust-lang/rust/pull/36917
6330 [36993]: https://github.com/rust-lang/rust/pull/36993
6331 [37037]: https://github.com/rust-lang/rust/pull/37037
6332 [37064]: https://github.com/rust-lang/rust/pull/37064
6333 [37094]: https://github.com/rust-lang/rust/pull/37094
6334 [37108]: https://github.com/rust-lang/rust/pull/37108
6335 [37111]: https://github.com/rust-lang/rust/pull/37111
6336 [37161]: https://github.com/rust-lang/rust/pull/37161
6337 [37162]: https://github.com/rust-lang/rust/pull/37162
6338 [37167]: https://github.com/rust-lang/rust/pull/37167
6339 [37178]: https://github.com/rust-lang/rust/pull/37178
6340 [37200]: https://github.com/rust-lang/rust/pull/37200
6341 [37213]: https://github.com/rust-lang/rust/pull/37213
6342 [37221]: https://github.com/rust-lang/rust/pull/37221
6343 [37224]: https://github.com/rust-lang/rust/pull/37224
6344 [37230]: https://github.com/rust-lang/rust/pull/37230
6345 [37231]: https://github.com/rust-lang/rust/pull/37231
6346 [37247]: https://github.com/rust-lang/rust/pull/37247
6347 [37267]: https://github.com/rust-lang/rust/pull/37267
6348 [37270]: https://github.com/rust-lang/rust/pull/37270
6349 [37273]: https://github.com/rust-lang/rust/pull/37273
6350 [37280]: https://github.com/rust-lang/rust/pull/37280
6351 [37298]: https://github.com/rust-lang/rust/pull/37298
6352 [37306]: https://github.com/rust-lang/rust/pull/37306
6353 [37310]: https://github.com/rust-lang/rust/pull/37310
6354 [37312]: https://github.com/rust-lang/rust/pull/37312
6355 [37313]: https://github.com/rust-lang/rust/pull/37313
6356 [37315]: https://github.com/rust-lang/rust/pull/37315
6357 [37318]: https://github.com/rust-lang/rust/pull/37318
6358 [37322]: https://github.com/rust-lang/rust/pull/37322
6359 [37326]: https://github.com/rust-lang/rust/pull/37326
6360 [37351]: https://github.com/rust-lang/rust/pull/37351
6361 [37356]: https://github.com/rust-lang/rust/pull/37356
6362 [37367]: https://github.com/rust-lang/rust/pull/37367
6363 [37373]: https://github.com/rust-lang/rust/pull/37373
6364 [37378]: https://github.com/rust-lang/rust/pull/37378
6365 [37389]: https://github.com/rust-lang/rust/pull/37389
6366 [37392]: https://github.com/rust-lang/rust/pull/37392
6367 [37427]: https://github.com/rust-lang/rust/pull/37427
6368 [37439]: https://github.com/rust-lang/rust/pull/37439
6369 [37445]: https://github.com/rust-lang/rust/pull/37445
6370 [37470]: https://github.com/rust-lang/rust/pull/37470
6371 [37569]: https://github.com/rust-lang/rust/pull/37569
6372 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6373 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6374 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6375 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6376 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6377 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6378 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6379
6380
6381 Version 1.13.0 (2016-11-10)
6382 ===========================
6383
6384 Language
6385 --------
6386
6387 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6388   errors, like the `try!` macro, described in [RFC 0243].
6389 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6390 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6391 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6392 * [Fix lifetime rules for 'if' conditions][36029]
6393 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6394
6395 Compiler
6396 --------
6397
6398 * [Add the `-C link-arg` argument][36574]
6399 * [Remove the old AST-based backend from rustc_trans][35764]
6400 * [Don't enable NEON by default on armv7 Linux][35814]
6401 * [Fix debug line number info for macro expansions][35238]
6402 * [Do not emit "class method" debuginfo for types that are not
6403   DICompositeType][36008]
6404 * [Warn about multiple conflicting #[repr] hints][34623]
6405 * [When sizing DST, don't double-count nested struct prefixes][36351]
6406 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6407 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6408 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6409 * [Expand macros without recursing to avoid stack overflows][36214]
6410
6411 Diagnostics
6412 -----------
6413
6414 * [Replace macro backtraces with labeled local uses][35702]
6415 * [Improve error message for misplaced doc comments][33922]
6416 * [Buffer unix and lock windows to prevent message interleaving][35975]
6417 * [Update lifetime errors to specifically note temporaries][36171]
6418 * [Special case a few colors for Windows][36178]
6419 * [Suggest `use self` when such an import resolves][36289]
6420 * [Be more specific when type parameter shadows primitive type][36338]
6421 * Many minor improvements
6422
6423 Compile-time Optimizations
6424 --------------------------
6425
6426 * [Compute and cache HIR hashes at beginning][35854]
6427 * [Don't hash types in loan paths][36004]
6428 * [Cache projections in trans][35761]
6429 * [Optimize the parser's last token handling][36527]
6430 * [Only instantiate #[inline] functions in codegen units referencing
6431   them][36524]. This leads to big improvements in cases where crates export
6432   define many inline functions without using them directly.
6433 * [Lazily allocate TypedArena's first chunk][36592]
6434 * [Don't allocate during default HashSet creation][36734]
6435
6436 Stabilized APIs
6437 ---------------
6438
6439 * [`checked_abs`]
6440 * [`wrapping_abs`]
6441 * [`overflowing_abs`]
6442 * [`RefCell::try_borrow`]
6443 * [`RefCell::try_borrow_mut`]
6444
6445 Libraries
6446 ---------
6447
6448 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6449 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6450   covariant][35354]
6451 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6452 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6453 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6454 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6455 * [Use arc4rand on FreeBSD][35884]
6456 * [memrchr: Correct aligned offset computation][35969]
6457 * [Improve Demangling of Rust Symbols][36059]
6458 * [Use monotonic time in condition variables][35048]
6459 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6460 * [Implement conversion traits for `char`][35755]
6461 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6462 * [Zero first byte of CString on drop][36264]
6463 * [Inherit overflow checks for sum and product][36372]
6464 * [Add missing Eq implementations][36423]
6465 * [Implement `Debug` for `DirEntry`][36631]
6466 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6467   `errno`][36754]
6468 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6469 * [Implement more traits for `std::io::ErrorKind`][35911]
6470 * [Optimize BinaryHeap bounds checking][36072]
6471 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6472   `extend_with_element`][36355]
6473 * [Fix overflow checking in unsigned pow()][34942]
6474
6475 Cargo
6476 -----
6477
6478 * This release includes security fixes to both curl and OpenSSL.
6479 * [Fix transitive doctests when panic=abort][cargo/3021]
6480 * [Add --all-features flag to cargo][cargo/3038]
6481 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6482 * [Don't parse the home directory more than once][cargo/3078]
6483 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6484 * [Update OpenSSL to 1.0.2j][cargo/3121]
6485 * [Add license and license_file to cargo metadata output][cargo/3110]
6486 * [Make crates-io registry URL optional in config; ignore all changes to
6487   source.crates-io][cargo/3089]
6488 * [Don't download dependencies from other platforms][cargo/3123]
6489 * [Build transitive dev-dependencies when needed][cargo/3125]
6490 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6491 * [Avoid updating registry when adding existing deps][cargo/3144]
6492 * [Warn about path overrides that won't work][cargo/3136]
6493 * [Use workspaces during `cargo install`][cargo/3146]
6494 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6495 * [Add --message-format flag][cargo/3000]
6496 * [Pass target environment for rustdoc][cargo/3205]
6497 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6498 * [Update curl and curl-sys][cargo/3241]
6499 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6500
6501 Tooling
6502 -------
6503
6504 * [rustdoc: Add the `--sysroot` argument][36586]
6505 * [rustdoc: Fix a couple of issues with the search results][35655]
6506 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6507 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6508 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6509
6510 Misc
6511 ----
6512
6513 * [Remove unmaintained style guide][35124]
6514 * [Add s390x support][36369]
6515 * [Initial work at Haiku OS support][36727]
6516 * [Add mips-uclibc targets][35734]
6517 * [Crate-ify compiler-rt into compiler-builtins][35021]
6518 * [Add rustc version info (git hash + date) to dist tarball][36213]
6519 * Many documentation improvements
6520
6521 Compatibility Notes
6522 -------------------
6523
6524 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6525 * [Deny (by default) transmuting from fn item types to pointer-sized
6526   types][34923]. Continuing the long transition to zero-sized fn items,
6527   per [RFC 401].
6528 * [Fix `#[derive]` for empty tuple structs/variants][35728].
6529   Part of [RFC 1506].
6530 * [Issue deprecation warnings for safe accesses to extern statics][36173]
6531 * [Fix lifetime rules for 'if' conditions][36029].
6532 * [Inherit overflow checks for sum and product][36372].
6533 * [Forbid user-defined macros named "macro_rules"][36730].
6534
6535 [33922]: https://github.com/rust-lang/rust/pull/33922
6536 [34623]: https://github.com/rust-lang/rust/pull/34623
6537 [34923]: https://github.com/rust-lang/rust/pull/34923
6538 [34942]: https://github.com/rust-lang/rust/pull/34942
6539 [34982]: https://github.com/rust-lang/rust/pull/34982
6540 [35021]: https://github.com/rust-lang/rust/pull/35021
6541 [35048]: https://github.com/rust-lang/rust/pull/35048
6542 [35074]: https://github.com/rust-lang/rust/pull/35074
6543 [35124]: https://github.com/rust-lang/rust/pull/35124
6544 [35234]: https://github.com/rust-lang/rust/pull/35234
6545 [35238]: https://github.com/rust-lang/rust/pull/35238
6546 [35354]: https://github.com/rust-lang/rust/pull/35354
6547 [35559]: https://github.com/rust-lang/rust/pull/35559
6548 [35585]: https://github.com/rust-lang/rust/pull/35585
6549 [35627]: https://github.com/rust-lang/rust/pull/35627
6550 [35655]: https://github.com/rust-lang/rust/pull/35655
6551 [35702]: https://github.com/rust-lang/rust/pull/35702
6552 [35707]: https://github.com/rust-lang/rust/pull/35707
6553 [35728]: https://github.com/rust-lang/rust/pull/35728
6554 [35734]: https://github.com/rust-lang/rust/pull/35734
6555 [35755]: https://github.com/rust-lang/rust/pull/35755
6556 [35761]: https://github.com/rust-lang/rust/pull/35761
6557 [35764]: https://github.com/rust-lang/rust/pull/35764
6558 [35814]: https://github.com/rust-lang/rust/pull/35814
6559 [35854]: https://github.com/rust-lang/rust/pull/35854
6560 [35871]: https://github.com/rust-lang/rust/pull/35871
6561 [35884]: https://github.com/rust-lang/rust/pull/35884
6562 [35911]: https://github.com/rust-lang/rust/pull/35911
6563 [35969]: https://github.com/rust-lang/rust/pull/35969
6564 [35975]: https://github.com/rust-lang/rust/pull/35975
6565 [36004]: https://github.com/rust-lang/rust/pull/36004
6566 [36008]: https://github.com/rust-lang/rust/pull/36008
6567 [36014]: https://github.com/rust-lang/rust/pull/36014
6568 [36029]: https://github.com/rust-lang/rust/pull/36029
6569 [36059]: https://github.com/rust-lang/rust/pull/36059
6570 [36072]: https://github.com/rust-lang/rust/pull/36072
6571 [36101]: https://github.com/rust-lang/rust/pull/36101
6572 [36104]: https://github.com/rust-lang/rust/pull/36104
6573 [36171]: https://github.com/rust-lang/rust/pull/36171
6574 [36173]: https://github.com/rust-lang/rust/pull/36173
6575 [36178]: https://github.com/rust-lang/rust/pull/36178
6576 [36213]: https://github.com/rust-lang/rust/pull/36213
6577 [36214]: https://github.com/rust-lang/rust/pull/36214
6578 [36264]: https://github.com/rust-lang/rust/pull/36264
6579 [36266]: https://github.com/rust-lang/rust/pull/36266
6580 [36289]: https://github.com/rust-lang/rust/pull/36289
6581 [36338]: https://github.com/rust-lang/rust/pull/36338
6582 [36351]: https://github.com/rust-lang/rust/pull/36351
6583 [36355]: https://github.com/rust-lang/rust/pull/36355
6584 [36369]: https://github.com/rust-lang/rust/pull/36369
6585 [36372]: https://github.com/rust-lang/rust/pull/36372
6586 [36423]: https://github.com/rust-lang/rust/pull/36423
6587 [36482]: https://github.com/rust-lang/rust/pull/36482
6588 [36505]: https://github.com/rust-lang/rust/pull/36505
6589 [36524]: https://github.com/rust-lang/rust/pull/36524
6590 [36527]: https://github.com/rust-lang/rust/pull/36527
6591 [36551]: https://github.com/rust-lang/rust/pull/36551
6592 [36574]: https://github.com/rust-lang/rust/pull/36574
6593 [36586]: https://github.com/rust-lang/rust/pull/36586
6594 [36592]: https://github.com/rust-lang/rust/pull/36592
6595 [36631]: https://github.com/rust-lang/rust/pull/36631
6596 [36639]: https://github.com/rust-lang/rust/pull/36639
6597 [36721]: https://github.com/rust-lang/rust/pull/36721
6598 [36727]: https://github.com/rust-lang/rust/pull/36727
6599 [36730]: https://github.com/rust-lang/rust/pull/36730
6600 [36734]: https://github.com/rust-lang/rust/pull/36734
6601 [36754]: https://github.com/rust-lang/rust/pull/36754
6602 [36995]: https://github.com/rust-lang/rust/pull/36995
6603 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
6604 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
6605 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6606 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
6607 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
6608 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
6609 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
6610 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
6611 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
6612 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
6613 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
6614 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
6615 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
6616 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
6617 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
6618 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
6619 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
6620 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
6621 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
6622 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
6623 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
6624 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
6625 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
6626 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
6627 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
6628 [rustup]: https://www.rustup.rs
6629 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
6630 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
6631 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
6632 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
6633 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
6634 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
6635 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
6636
6637
6638 Version 1.12.1 (2016-10-20)
6639 ===========================
6640
6641 Regression Fixes
6642 ----------------
6643
6644 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
6645 * [Confusion with double negation and booleans][36856]
6646 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
6647 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
6648 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
6649 * [Corrupted memory after updated to 1.12][36936]
6650 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
6651 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
6652 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
6653
6654 [36381]: https://github.com/rust-lang/rust/issues/36381
6655 [36856]: https://github.com/rust-lang/rust/issues/36856
6656 [36875]: https://github.com/rust-lang/rust/issues/36875
6657 [36924]: https://github.com/rust-lang/rust/issues/36924
6658 [36926]: https://github.com/rust-lang/rust/issues/36926
6659 [36936]: https://github.com/rust-lang/rust/issues/36936
6660 [37026]: https://github.com/rust-lang/rust/issues/37026
6661 [37112]: https://github.com/rust-lang/rust/issues/37112
6662 [37153]: https://github.com/rust-lang/rust/issues/37153
6663
6664
6665 Version 1.12.0 (2016-09-29)
6666 ===========================
6667
6668 Highlights
6669 ----------
6670
6671 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6672   This translation pass is far simpler than the previous AST->LLVM pass, and
6673   creates opportunities to perform new optimizations directly on the MIR. It
6674   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6675 * [`rustc` presents a new, more readable error format, along with
6676   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6677   Most common editors supporting Rust have been updated to work with it. It was
6678   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6679
6680 Compiler
6681 --------
6682
6683 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6684   This translation pass is far simpler than the previous AST->LLVM pass, and
6685   creates opportunities to perform new optimizations directly on the MIR. It
6686   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6687 * [Print the Rust target name, not the LLVM target name, with
6688   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
6689 * [The computation of `TypeId` is correct in some cases where it was previously
6690   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
6691 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
6692 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
6693   `--print relocation-models`, and `--print code-models` print the available
6694   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
6695   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
6696 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
6697   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
6698   These targets produce statically-linked binaries. There are no binary release
6699   builds yet though.
6700
6701 Diagnostics
6702 -----------
6703
6704 * [`rustc` presents a new, more readable error format, along with
6705   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6706   Most common editors supporting Rust have been updated to work with it. It was
6707   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6708 * [In error descriptions, references are now described in plain English,
6709   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
6710 * [In error type descriptions, unknown numeric types are named `{integer}` or
6711   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
6712 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
6713
6714 Language
6715 --------
6716
6717 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
6718 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
6719 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
6720   useful](https://github.com/rust-lang/rust/pull/34908)
6721 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
6722   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
6723 * [Semicolons are properly required as statement delimiters inside
6724   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
6725 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
6726
6727 Stabilized APIs
6728 ---------------
6729
6730 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
6731 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
6732 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
6733 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
6734 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
6735 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
6736 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
6737 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
6738 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
6739 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
6740   Both on Unix and Windows.
6741 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
6742 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
6743 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
6744 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
6745 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
6746 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
6747 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
6748 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
6749
6750 Libraries
6751 ---------
6752
6753 * [The `format!` macro and friends now allow a single argument to be formatted
6754   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
6755 * [The lifetime bounds on `[T]::binary_search_by` and
6756   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
6757 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
6758 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
6759 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
6760 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
6761 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
6762 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
6763 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
6764 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
6765   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
6766 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
6767   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
6768 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
6769 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
6770   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
6771 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
6772 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
6773 * [`mpsc::sync_channel` `Receiver`s return any available message before
6774   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
6775 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
6776 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
6777
6778 Cargo
6779 -----
6780
6781 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
6782 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
6783 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
6784 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
6785 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
6786 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
6787 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
6788 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
6789 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
6790 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
6791 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
6792 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
6793 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
6794 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
6795 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
6796 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
6797
6798 Performance
6799 -----------
6800
6801 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
6802 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
6803
6804 Tooling
6805 -------
6806
6807 * [Test binaries now support a `--test-threads` argument to specify the number
6808   of threads used to run tests, and which acts the same as the
6809   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
6810 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
6811 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
6812 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6813 * [Rust releases now come with source packages that can be installed by rustup
6814   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
6815   The resulting source code can be used by tools and IDES, located in the
6816   sysroot under `lib/rustlib/src`.
6817
6818 Misc
6819 ----
6820
6821 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
6822 * Many minor improvements to the documentation.
6823 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
6824
6825 Compatibility Notes
6826 -------------------
6827
6828 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
6829   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
6830 * [When formatting strings, if "precision" is specified, the "fill",
6831   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
6832 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
6833
6834
6835 Version 1.11.0 (2016-08-18)
6836 ===========================
6837
6838 Language
6839 --------
6840
6841 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
6842 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
6843 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
6844 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
6845
6846 Stabilized APIs
6847 ---------------
6848
6849 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
6850 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
6851 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
6852 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
6853 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
6854 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
6855   (in libcore - previously stabilized in libstd)
6856 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
6857   (in libcore - previously stabilized in libstd)
6858 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
6859   (in libcore - previously stabilized in libstd)
6860 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
6861   (in libcore - previously stabilized in libstd)
6862 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6863 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6864 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
6865 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
6866
6867 Libraries
6868 ---------
6869
6870 * [The `thread_local!` macro supports multiple definitions in a single
6871    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
6872 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
6873 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
6874   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
6875 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
6876 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
6877 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
6878 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
6879
6880 Cargo
6881 -----
6882
6883 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
6884 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
6885 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
6886 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
6887 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
6888   and `-vv` prints warnings for all crates.
6889 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
6890 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
6891   This provides room for expansion by arbitrary tools.
6892 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
6893 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
6894 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
6895 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
6896 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
6897 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
6898 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
6899
6900 Performance
6901 -----------
6902
6903 * [Caching projections speeds up type check dramatically for some
6904   workloads](https://github.com/rust-lang/rust/pull/33816)
6905 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
6906   This hasher is faster, but is believed to provide sufficient
6907   protection from collision attacks.
6908 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
6909
6910 Rustdoc
6911 -------
6912
6913 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
6914 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
6915 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
6916 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
6917 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
6918
6919 Tooling
6920 -------
6921
6922 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
6923 * [When emitting debug info, rustc emits frame pointers for closures,
6924   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
6925 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6926 * Many more errors have been given error codes and extended
6927   explanations
6928 * API documentation continues to be improved, with many new examples
6929
6930 Misc
6931 ----
6932
6933 * [rustc no longer hangs when dependencies recursively re-export
6934   submodules](https://github.com/rust-lang/rust/pull/34542)
6935 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
6936 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
6937   rewritten](https://github.com/rust-lang/rust/pull/33895)
6938 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
6939   No targets use this yet, but it works toward AVR support.
6940
6941 Compatibility Notes
6942 -------------------
6943
6944 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
6945 * [The new follow-set rules that place restrictions on `macro_rules!`
6946   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
6947   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
6948   and has been a warning since 1.10.
6949 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
6950   This causes breakage in some corner cases.
6951
6952
6953 Version 1.10.0 (2016-07-07)
6954 ===========================
6955
6956 Language
6957 --------
6958
6959 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
6960   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
6961 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
6962 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
6963 * [`panic!` can be converted to a runtime abort with the
6964   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
6965   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6966 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
6967   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
6968   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
6969   Note that Cargo does not yet directly support cdylibs.
6970
6971 Stabilized APIs
6972 ---------------
6973
6974 * `os::windows::fs::OpenOptionsExt::access_mode`
6975 * `os::windows::fs::OpenOptionsExt::share_mode`
6976 * `os::windows::fs::OpenOptionsExt::custom_flags`
6977 * `os::windows::fs::OpenOptionsExt::attributes`
6978 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
6979 * `os::unix::fs::OpenOptionsExt::custom_flags`
6980 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
6981 * `Default for sync::Weak`
6982 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
6983 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
6984 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
6985 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
6986 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
6987 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
6988 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
6989 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
6990 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
6991 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
6992 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
6993 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
6994 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
6995 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
6996 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
6997 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
6998 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
6999 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7000 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7001 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7002 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7003 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7004 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7005 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7006 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7007 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7008 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7009 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7010 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7011 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7012 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7013 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7014 * Read/Write/RawFd impls for `UnixStream`
7015 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7016 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7017 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7018 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7019 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7020 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7021 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7022 * RawFd impls for `UnixListener`
7023 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7024 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
7025 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
7026 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
7027 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
7028 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
7029 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
7030 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
7031 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
7032 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
7033 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
7034 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
7035 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
7036 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
7037 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
7038 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
7039 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
7040 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
7041 * RawFd impls for `UnixDatagram`
7042 * `{BTree,Hash}Map::values_mut`
7043 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
7044
7045 Libraries
7046 ---------
7047
7048 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
7049   The semantics of this minor method are subtle and probably not what
7050   most people want.
7051 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
7052 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
7053   will fall back to `/dev/urandom` temporarily to avoid blocking
7054   during early boot](https://github.com/rust-lang/rust/pull/33086).
7055 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
7056 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
7057 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
7058 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
7059 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
7060 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7061   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
7062
7063 Cargo
7064 -----
7065 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
7066   This controls the runtime behavior of the `panic!` macro
7067   and can be either "unwind" (the default), or "abort".
7068   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7069 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
7070 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
7071 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7072   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
7073 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
7074 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
7075 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
7076   By default they are retried twice, which can be customized with the
7077   `net.retry` value in `.cargo/config`.
7078 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
7079 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
7080 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
7081 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
7082   Makes it possible to install multiple crates in parallel.
7083 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
7084 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
7085 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
7086 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
7087 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
7088 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
7089
7090 Performance
7091 -----------
7092
7093 * [rustc memory usage was reduced by refactoring the context used for
7094   type checking](https://github.com/rust-lang/rust/pull/33425).
7095 * [Speed up creation of `HashMap`s by caching the random keys used
7096   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
7097 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
7098 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
7099 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
7100   10x faster than the previous lookup tables.
7101 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
7102
7103 Usability
7104 ---------
7105
7106 * Many incremental improvements to documentation and rustdoc.
7107 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
7108 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
7109 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
7110 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
7111 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
7112 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
7113 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
7114
7115 Misc
7116 ----
7117
7118 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
7119 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
7120 * [`std` no longer prints backtraces on platforms where the running
7121   module must be loaded with `env::current_exe`, which can't be relied
7122   on](https://github.com/rust-lang/rust/pull/33554).
7123 * This release includes std binaries for the i586-unknown-linux-gnu,
7124   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7125   i586 target is for old x86 hardware without SSE2, and the armv7
7126   target is for Android running on modern ARM architectures.
7127 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7128   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7129 * [On Unix the runtime aborts by calling `libc::abort` instead of
7130   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7131 * [Rust is now bootstrapped from the previous release of Rust,
7132   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7133
7134 Compatibility Notes
7135 -------------------
7136
7137 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7138 * [`target_env` for Linux ARM targets is just `gnu`, not
7139   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7140 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7141 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7142 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7143   Affects how macros are parsed.
7144 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7145 * [Feature-gated attributes on macro-generated macro invocations are
7146   now rejected](https://github.com/rust-lang/rust/pull/32791).
7147 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7148   This caused some minor changes to type inference.
7149
7150
7151 Version 1.9.0 (2016-05-26)
7152 ==========================
7153
7154 Language
7155 --------
7156
7157 * The `#[deprecated]` attribute when applied to an API will generate
7158   warnings when used. The warnings may be suppressed with
7159   `#[allow(deprecated)]`. [RFC 1270].
7160 * [`fn` item types are zero sized, and each `fn` names a unique
7161   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7162   `transmute` on a `fn` type will generate a warning for a few cycles,
7163   then will be converted to an error.
7164 * [Field and method resolution understand visibility, so private
7165   fields and methods cannot prevent the proper use of public fields
7166   and methods][1.9fv].
7167 * [The parser considers unicode codepoints in the
7168   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7169
7170 Stabilized APIs
7171 ---------------
7172
7173 * [`std::panic`]
7174 * [`std::panic::catch_unwind`] (renamed from `recover`)
7175 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7176 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7177 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7178 * [`str::is_char_boundary`]
7179 * [`<*const T>::as_ref`]
7180 * [`<*mut T>::as_ref`]
7181 * [`<*mut T>::as_mut`]
7182 * [`AsciiExt::make_ascii_uppercase`]
7183 * [`AsciiExt::make_ascii_lowercase`]
7184 * [`char::decode_utf16`]
7185 * [`char::DecodeUtf16`]
7186 * [`char::DecodeUtf16Error`]
7187 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7188 * [`BTreeSet::take`]
7189 * [`BTreeSet::replace`]
7190 * [`BTreeSet::get`]
7191 * [`HashSet::take`]
7192 * [`HashSet::replace`]
7193 * [`HashSet::get`]
7194 * [`OsString::with_capacity`]
7195 * [`OsString::clear`]
7196 * [`OsString::capacity`]
7197 * [`OsString::reserve`]
7198 * [`OsString::reserve_exact`]
7199 * [`OsStr::is_empty`]
7200 * [`OsStr::len`]
7201 * [`std::os::unix::thread`]
7202 * [`RawPthread`]
7203 * [`JoinHandleExt`]
7204 * [`JoinHandleExt::as_pthread_t`]
7205 * [`JoinHandleExt::into_pthread_t`]
7206 * [`HashSet::hasher`]
7207 * [`HashMap::hasher`]
7208 * [`CommandExt::exec`]
7209 * [`File::try_clone`]
7210 * [`SocketAddr::set_ip`]
7211 * [`SocketAddr::set_port`]
7212 * [`SocketAddrV4::set_ip`]
7213 * [`SocketAddrV4::set_port`]
7214 * [`SocketAddrV6::set_ip`]
7215 * [`SocketAddrV6::set_port`]
7216 * [`SocketAddrV6::set_flowinfo`]
7217 * [`SocketAddrV6::set_scope_id`]
7218 * [`slice::copy_from_slice`]
7219 * [`ptr::read_volatile`]
7220 * [`ptr::write_volatile`]
7221 * [`OpenOptions::create_new`]
7222 * [`TcpStream::set_nodelay`]
7223 * [`TcpStream::nodelay`]
7224 * [`TcpStream::set_ttl`]
7225 * [`TcpStream::ttl`]
7226 * [`TcpStream::set_only_v6`]
7227 * [`TcpStream::only_v6`]
7228 * [`TcpStream::take_error`]
7229 * [`TcpStream::set_nonblocking`]
7230 * [`TcpListener::set_ttl`]
7231 * [`TcpListener::ttl`]
7232 * [`TcpListener::set_only_v6`]
7233 * [`TcpListener::only_v6`]
7234 * [`TcpListener::take_error`]
7235 * [`TcpListener::set_nonblocking`]
7236 * [`UdpSocket::set_broadcast`]
7237 * [`UdpSocket::broadcast`]
7238 * [`UdpSocket::set_multicast_loop_v4`]
7239 * [`UdpSocket::multicast_loop_v4`]
7240 * [`UdpSocket::set_multicast_ttl_v4`]
7241 * [`UdpSocket::multicast_ttl_v4`]
7242 * [`UdpSocket::set_multicast_loop_v6`]
7243 * [`UdpSocket::multicast_loop_v6`]
7244 * [`UdpSocket::set_multicast_ttl_v6`]
7245 * [`UdpSocket::multicast_ttl_v6`]
7246 * [`UdpSocket::set_ttl`]
7247 * [`UdpSocket::ttl`]
7248 * [`UdpSocket::set_only_v6`]
7249 * [`UdpSocket::only_v6`]
7250 * [`UdpSocket::join_multicast_v4`]
7251 * [`UdpSocket::join_multicast_v6`]
7252 * [`UdpSocket::leave_multicast_v4`]
7253 * [`UdpSocket::leave_multicast_v6`]
7254 * [`UdpSocket::take_error`]
7255 * [`UdpSocket::connect`]
7256 * [`UdpSocket::send`]
7257 * [`UdpSocket::recv`]
7258 * [`UdpSocket::set_nonblocking`]
7259
7260 Libraries
7261 ---------
7262
7263 * [`std::sync::Once` is poisoned if its initialization function
7264   fails][1.9o].
7265 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7266 * [Most types implement `fmt::Debug`][1.9db].
7267 * [The default buffer size used by `BufReader` and `BufWriter` was
7268   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7269   used by other languages.
7270 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7271   `Duration` additionally implements `*=` and `/=`][1.9ta].
7272 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7273 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7274 * [`Chain` implements `BufRead`][1.9ch].
7275 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7276
7277 Cargo
7278 -----
7279
7280 * [Cargo can now run concurrently][1.9cc].
7281 * [Top-level overrides allow specific revisions of crates to be
7282   overridden through the entire crate graph][1.9ct].  This is intended
7283   to make upgrades easier for large projects, by allowing crates to be
7284   forked temporarily until they've been upgraded and republished.
7285 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7286 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7287   on the commandline][1.9cf]. `rustc` arguments can also be specified
7288   in the `build.rustflags` configuration key.
7289
7290 Performance
7291 -----------
7292
7293 * [The time complexity of comparing variables for equivalence during type
7294   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7295   to major compilation time improvement in some scenarios.
7296 * [`ToString` is specialized for `str`, giving it the same performance
7297   as `to_owned`][1.9ts].
7298 * [Spawning processes with `Command::output` no longer creates extra
7299   threads][1.9sp].
7300 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7301   for C-like enums][1.9cl].
7302
7303 Misc
7304 ----
7305
7306 * [Passing the `--quiet` flag to a test runner will produce
7307   much-abbreviated output][1.9q].
7308 * The Rust Project now publishes std binaries for the
7309   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7310   `i586-pc-windows-msvc` targets.
7311
7312 Compatibility Notes
7313 -------------------
7314
7315 * [`std::sync::Once` is poisoned if its initialization function
7316   fails][1.9o].
7317 * [It is illegal to define methods with the same name in overlapping
7318   inherent `impl` blocks][1.9sn].
7319 * [`fn` item types are zero sized, and each `fn` names a unique
7320   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7321   `transmute` on a `fn` type will generate a warning for a few cycles,
7322   then will be converted to an error.
7323 * [Improvements to const evaluation may trigger new errors when integer
7324   literals are out of range][1.9ce].
7325
7326
7327 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7328 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7329 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7330 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7331 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7332 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7333 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7334 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7335 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7336 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7337 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7338 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7339 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7340 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7341 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7342 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7343 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7344 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7345 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7346 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7347 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7348 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7349 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7350 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7351 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7352 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7353 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7354 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7355 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7356 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7357 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7358 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7359 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7360 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7361 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7362 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7363 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7364 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7365 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7366 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7367 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7368 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7369 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7370 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7371 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7372 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7373 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7374 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7375 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7376 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7377 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7378 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7379 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7380 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7381 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7382 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7383 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7384 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7385 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7386 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7387 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7388 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7389 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7390 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7391 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7392 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7393 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7394 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7395 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7396 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7397 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7398 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7399 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7400 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7401 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7402 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7403 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7404 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7405 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7406 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7407 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7408 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7409 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7410 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7411 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7412 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7413 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7414 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7415 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7416 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7417 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7418 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7419 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7420 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7421 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7422 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7423 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7424 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7425 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7426 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7427 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7428 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7429 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7430 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7431 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7432 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7433 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7434 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7435 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7436 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7437
7438
7439 Version 1.8.0 (2016-04-14)
7440 ==========================
7441
7442 Language
7443 --------
7444
7445 * Rust supports overloading of compound assignment statements like
7446   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7447   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7448   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7449   traits. [RFC 953].
7450 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7451   addition to the non-braced form, `struct Foo;`. [RFC 218].
7452
7453 Libraries
7454 ---------
7455
7456 * Stabilized APIs:
7457   * [`str::encode_utf16`] (renamed from `utf16_units`)
7458   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7459   * [`Ref::map`]
7460   * [`RefMut::map`]
7461   * [`ptr::drop_in_place`]
7462   * [`time::Instant`]
7463   * [`time::SystemTime`]
7464   * [`Instant::now`]
7465   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7466   * [`Instant::elapsed`]
7467   * [`SystemTime::now`]
7468   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7469   * [`SystemTime::elapsed`]
7470   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7471   * [`SystemTimeError`]
7472   * [`SystemTimeError::duration`]
7473   * Various impls for `SystemTimeError`
7474   * [`UNIX_EPOCH`]
7475   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7476     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7477     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7478 * [The `write!` and `writeln!` macros correctly emit errors if any of
7479   their arguments can't be formatted][1.8w].
7480 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7481 * [The Unix-specific `raw` modules, which contain a number of
7482   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7483   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7484   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7485   across platforms was making it difficult to implement `std`
7486   correctly. Those that need these definitions should use the `libc`
7487   crate. [RFC 1415].
7488 * The Unix-specific `MetadataExt` traits, including
7489   `os::unix::fs::MetadataExt`, which expose values such as inode
7490   numbers [no longer return platform-specific types][1.8r], but
7491   instead return widened integers. [RFC 1415].
7492 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7493 * [Atomic loads and stores are not volatile][1.8a].
7494 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7495
7496 Performance
7497 -----------
7498
7499 * [Inlining hash functions lead to a 3% compile-time improvement in
7500   some workloads][1.8h].
7501 * When using jemalloc, its symbols are [unprefixed so that it
7502   overrides the libc malloc implementation][1.8h]. This means that for
7503   rustc, LLVM is now using jemalloc, which results in a 6%
7504   compile-time improvement on a specific workload.
7505 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7506
7507 Misc
7508 ----
7509
7510 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7511   i686-pc-windows-msvc is now considered a tier-1 platform.
7512 * [The `--print targets` flag prints a list of supported targets][1.8t].
7513 * [The `--print cfg` flag prints the `cfg`s defined for the current
7514   target][1.8cf].
7515 * [`rustc` can be built with an new Cargo-based build system, written
7516   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7517   build system. To enable it configure with `configure --rustbuild`.
7518 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7519   variants while also indicating the total number of missing variants
7520   if more than 3][1.8m].
7521 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7522 * The Rust Project now publishes binary releases of the standard
7523   library for a number of tier-2 targets:
7524   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7525   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
7526   `x86_64-rumprun-netbsd`. These can be installed with
7527   tools such as [multirust][1.8mr].
7528
7529 Cargo
7530 -----
7531
7532 * [`cargo init` creates a new Cargo project in the current
7533   directory][1.8ci].  It is otherwise like `cargo new`.
7534 * [Cargo has configuration keys for `-v` and
7535   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
7536   `[term]` section of `.cargo/config`.
7537 * [Configuration keys that evaluate to strings or integers can be set
7538   via environment variables][1.8ce]. For example the `build.jobs` key
7539   can be set via `CARGO_BUILD_JOBS`. Environment variables take
7540   precedence over config files.
7541 * [Target-specific dependencies support Rust `cfg` syntax for
7542   describing targets][1.8cfg] so that dependencies for multiple
7543   targets can be specified together. [RFC 1361].
7544 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
7545   `RUSTDOC` take precedence over the `build.target-dir`,
7546   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
7547 * [The child process tree is killed on Windows when Cargo is
7548   killed][1.8ck].
7549 * [The `build.target` configuration value sets the target platform,
7550   like `--target`][1.8ct].
7551
7552 Compatibility Notes
7553 -------------------
7554
7555 * [Unstable compiler flags have been further restricted][1.8u]. Since
7556   1.0 `-Z` flags have been considered unstable, and other flags that
7557   were considered unstable additionally required passing `-Z
7558   unstable-options` to access. Unlike unstable language and library
7559   features though, these options have been accessible on the stable
7560   release channel. Going forward, *new unstable flags will not be
7561   available on the stable release channel*, and old unstable flags
7562   will warn about their usage. In the future, all unstable flags will
7563   be unavailable on the stable release channel.
7564 * [It is no longer possible to `match` on empty enum variants using
7565   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
7566 * The Unix-specific `MetadataExt` traits, including
7567   `os::unix::fs::MetadataExt`, which expose values such as inode
7568   numbers [no longer return platform-specific types][1.8r], but
7569   instead return widened integers. [RFC 1415].
7570 * [Modules sourced from the filesystem cannot appear within arbitrary
7571   blocks, but only within other modules][1.8mf].
7572 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
7573 * On Unix, [stack overflow triggers a runtime abort instead of a
7574   SIGSEGV][1.8so].
7575 * [`Command::spawn` and its equivalents return an error if any of
7576   its command-line arguments contain interior `NUL`s][1.8n].
7577 * [Tuple and unit enum variants from other crates are in the type
7578   namespace][1.8tn].
7579 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
7580   type instead of `.a` files][1.8st]. Additionally, for the MSVC
7581   toolchain, `rustc` emits import libraries named `foo.dll.lib`
7582   instead of `foo.lib`.
7583
7584
7585 [1.8a]: https://github.com/rust-lang/rust/pull/30962
7586 [1.8b]: https://github.com/rust-lang/rust/pull/31123
7587 [1.8c]: https://github.com/rust-lang/rust/pull/31530
7588 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
7589 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
7590 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
7591 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
7592 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
7593 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
7594 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
7595 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
7596 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
7597 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
7598 [1.8h]: https://github.com/rust-lang/rust/pull/31460
7599 [1.8l]: https://github.com/rust-lang/rust/pull/31668
7600 [1.8m]: https://github.com/rust-lang/rust/pull/31020
7601 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
7602 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
7603 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
7604 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
7605 [1.8n]: https://github.com/rust-lang/rust/pull/31056
7606 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
7607 [1.8r]: https://github.com/rust-lang/rust/pull/31551
7608 [1.8so]: https://github.com/rust-lang/rust/pull/31333
7609 [1.8st]: https://github.com/rust-lang/rust/pull/29520
7610 [1.8t]: https://github.com/rust-lang/rust/pull/31358
7611 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
7612 [1.8u]: https://github.com/rust-lang/rust/pull/31793
7613 [1.8v]: https://github.com/rust-lang/rust/pull/31757
7614 [1.8w]: https://github.com/rust-lang/rust/pull/31904
7615 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
7616 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
7617 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
7618 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
7619 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
7620 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
7621 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
7622 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
7623 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
7624 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
7625 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
7626 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
7627 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
7628 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
7629 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
7630 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
7631 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
7632 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
7633 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
7634 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
7635 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
7636 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
7637 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
7638 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
7639 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
7640 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
7641 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
7642 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
7643 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
7644 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
7645
7646
7647 Version 1.7.0 (2016-03-03)
7648 ==========================
7649
7650 Libraries
7651 ---------
7652
7653 * Stabilized APIs
7654   * `Path`
7655     * [`Path::strip_prefix`] (renamed from relative_from)
7656     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
7657   * `Ipv4Addr`
7658     * [`Ipv4Addr::is_loopback`]
7659     * [`Ipv4Addr::is_private`]
7660     * [`Ipv4Addr::is_link_local`]
7661     * [`Ipv4Addr::is_multicast`]
7662     * [`Ipv4Addr::is_broadcast`]
7663     * [`Ipv4Addr::is_documentation`]
7664   * `Ipv6Addr`
7665     * [`Ipv6Addr::is_unspecified`]
7666     * [`Ipv6Addr::is_loopback`]
7667     * [`Ipv6Addr::is_multicast`]
7668   * `Vec`
7669     * [`Vec::as_slice`]
7670     * [`Vec::as_mut_slice`]
7671   * `String`
7672     * [`String::as_str`]
7673     * [`String::as_mut_str`]
7674   * Slices
7675     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
7676     be the same length
7677     * `<[T]>::`[`sort_by_key`]
7678   * checked, saturated, and overflowing operations
7679     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
7680     * [`i32::saturating_mul`]
7681     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
7682     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
7683     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
7684     * [`u32::saturating_mul`]
7685     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
7686     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
7687     * and checked, saturated, and overflowing operations for other primitive types
7688   * FFI
7689     * [`ffi::IntoStringError`]
7690     * [`CString::into_string`]
7691     * [`CString::into_bytes`]
7692     * [`CString::into_bytes_with_nul`]
7693     * `From<CString> for Vec<u8>`
7694   * `IntoStringError`
7695     * [`IntoStringError::into_cstring`]
7696     * [`IntoStringError::utf8_error`]
7697     * `Error for IntoStringError`
7698   * Hashing
7699     * [`std::hash::BuildHasher`]
7700     * [`BuildHasher::Hasher`]
7701     * [`BuildHasher::build_hasher`]
7702     * [`std::hash::BuildHasherDefault`]
7703     * [`HashMap::with_hasher`]
7704     * [`HashMap::with_capacity_and_hasher`]
7705     * [`HashSet::with_hasher`]
7706     * [`HashSet::with_capacity_and_hasher`]
7707     * [`std::collections::hash_map::RandomState`]
7708     * [`RandomState::new`]
7709 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
7710   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
7711   from bytes is faster.
7712 * [The performance of `LineWriter` (and thus `io::stdout`) was
7713   improved by using `memchr` to search for newlines][1.7m].
7714 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
7715   `f64` variants were stabilized previously.
7716 * [`BTreeMap` was rewritten to use less memory and improve the performance
7717   of insertion and iteration, the latter by as much as 5x][1.7bm].
7718 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
7719   covariant over their contained type][1.7bt].
7720 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
7721   over their contained type][1.7ll].
7722 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
7723   searching methods.
7724 * [`Any` is implemented for unsized types][1.7a].
7725 * [`Hash` is implemented for `Duration`][1.7h].
7726
7727 Misc
7728 ----
7729
7730 * [When running tests with `--test`, rustdoc will pass `--cfg`
7731   arguments to the compiler][1.7dt].
7732 * [The compiler is built with RPATH information by default][1.7rpa].
7733   This means that it will be possible to run `rustc` when installed in
7734   unusual configurations without configuring the dynamic linker search
7735   path explicitly.
7736 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
7737   any RPATH entries (emitted with `-C rpath`) *not* take precedence
7738   over `LD_LIBRARY_PATH`.
7739
7740 Cargo
7741 -----
7742
7743 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
7744   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
7745 * [The `rerun-if-changed` build script directive no longer causes the
7746   build script to incorrectly run twice in certain scenarios][1.7rr].
7747
7748 Compatibility Notes
7749 -------------------
7750
7751 * Soundness fixes to the interactions between associated types and
7752   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
7753   code that violates the new rules. This is a significant change that
7754   is known to break existing code, so it has emitted warnings for the
7755   new error cases since 1.4 to give crate authors time to adapt. The
7756   details of what is changing are subtle; read the RFC for more.
7757 * [Several bugs in the compiler's visibility calculations were
7758   fixed][1.7v]. Since this was found to break significant amounts of
7759   code, the new errors will be emitted as warnings for several release
7760   cycles, under the `private_in_public` lint.
7761 * Defaulted type parameters were accidentally accepted in positions
7762   that were not intended. In this release, [defaulted type parameters
7763   appearing outside of type definitions will generate a
7764   warning][1.7d], which will become an error in future releases.
7765 * [Parsing "." as a float results in an error instead of 0][1.7p].
7766   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
7767 * [Borrows of closure parameters may not outlive the closure][1.7bc].
7768
7769 [1.7a]: https://github.com/rust-lang/rust/pull/30928
7770 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
7771 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
7772 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
7773 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
7774 [1.7d]: https://github.com/rust-lang/rust/pull/30724
7775 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
7776 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
7777 [1.7f]: https://github.com/rust-lang/rust/pull/30672
7778 [1.7h]: https://github.com/rust-lang/rust/pull/30818
7779 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
7780 [1.7m]: https://github.com/rust-lang/rust/pull/30381
7781 [1.7p]: https://github.com/rust-lang/rust/pull/30681
7782 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
7783 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
7784 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
7785 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
7786 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
7787 [1.7v]: https://github.com/rust-lang/rust/pull/29973
7788 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7789 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7790 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
7791 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
7792 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
7793 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
7794 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
7795 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
7796 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
7797 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
7798 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
7799 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
7800 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
7801 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
7802 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
7803 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
7804 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
7805 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
7806 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
7807 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
7808 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
7809 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
7810 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
7811 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
7812 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
7813 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
7814 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
7815 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
7816 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
7817 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
7818 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
7819 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
7820 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
7821 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
7822 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
7823 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
7824 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
7825 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
7826 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
7827 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
7828 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
7829 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
7830 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
7831 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
7832 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
7833 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
7834 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
7835 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7836 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
7837 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7838 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
7839 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
7840 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
7841 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
7842 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
7843 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
7844 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
7845 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
7846 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
7847 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
7848
7849
7850 Version 1.6.0 (2016-01-21)
7851 ==========================
7852
7853 Language
7854 --------
7855
7856 * The `#![no_std]` attribute causes a crate to not be linked to the
7857   standard library, but only the [core library][1.6co], as described
7858   in [RFC 1184]. The core library defines common types and traits but
7859   has no platform dependencies whatsoever, and is the basis for Rust
7860   software in environments that cannot support a full port of the
7861   standard library, such as operating systems. Most of the core
7862   library is now stable.
7863
7864 Libraries
7865 ---------
7866
7867 * Stabilized APIs:
7868   [`Read::read_exact`],
7869   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
7870   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
7871   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
7872   [`os::unix::fs::DirBuilderExt`],
7873   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
7874   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
7875   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
7876   [`collections::hash_map::Drain`],
7877   [`collections::hash_map::HashMap::drain`],
7878   [`collections::hash_set::Drain`],
7879   [`collections::hash_set::HashSet::drain`],
7880   [`collections::binary_heap::Drain`],
7881   [`collections::binary_heap::BinaryHeap::drain`],
7882   [`Vec::extend_from_slice`] (renamed from `push_all`),
7883   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
7884   [`RwLock::into_inner`],
7885   [`Iterator::min_by_key`] (renamed from `min_by`),
7886   [`Iterator::max_by_key`] (renamed from `max_by`).
7887 * The [core library][1.6co] is stable, as are most of its APIs.
7888 * [The `assert_eq!` macro supports arguments that don't implement
7889   `Sized`][1.6ae], such as arrays. In this way it behaves more like
7890   `assert!`.
7891 * Several timer functions that take duration in milliseconds [are
7892   deprecated in favor of those that take `Duration`][1.6ms]. These
7893   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
7894   `thread::park_timeout_ms`.
7895 * The algorithm by which `Vec` reserves additional elements was
7896   [tweaked to not allocate excessive space][1.6a] while still growing
7897   exponentially.
7898 * `From` conversions are [implemented from integers to floats][1.6f]
7899   in cases where the conversion is lossless. Thus they are not
7900   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
7901   or `f64`. They are also not implemented for `isize` and `usize`
7902   because the implementations would be platform-specific. `From` is
7903   also implemented from `f32` to `f64`.
7904 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
7905 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
7906 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
7907 * [`BinaryHeap` was refactored][1.6bh] for modest performance
7908   improvements.
7909 * Sorting slices that are already sorted [is 50% faster in some
7910   cases][1.6s].
7911
7912 Cargo
7913 -----
7914
7915 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
7916 * Cargo build scripts can specify their dependencies by emitting the
7917   [`rerun-if-changed`][1.6rr] key.
7918 * crates.io will reject publication of crates with dependencies that
7919   have a wildcard version constraint. Crates with wildcard
7920   dependencies were seen to cause a variety of problems, as described
7921   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
7922   warning.
7923 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
7924   release folder.  A variety of artifacts that Cargo failed to clean
7925   are now correctly deleted.
7926
7927 Misc
7928 ----
7929
7930 * The `unreachable_code` lint [warns when a function call's argument
7931   diverges][1.6dv].
7932 * The parser indicates [failures that may be caused by
7933   confusingly-similar Unicode characters][1.6uc]
7934 * Certain macro errors [are reported at definition time][1.6m], not
7935   expansion.
7936
7937 Compatibility Notes
7938 -------------------
7939
7940 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
7941   environment variable when locating crates. This was a pre-cargo
7942   feature for integrating with the package manager that was
7943   accidentally never removed.
7944 * [A number of bugs were fixed in the privacy checker][1.6p] that
7945   could cause previously-accepted code to break.
7946 * [Modules and unit/tuple structs may not share the same name][1.6ts].
7947 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
7948   struct pattern syntax (`Foo(..)`) can no longer be used to match
7949   unit structs. This is a warning now, but will become an error in
7950   future releases. Patterns that share the same name as a const are
7951   now an error.
7952 * A bug was fixed that causes [rustc not to apply default type
7953   parameters][1.6xc] when resolving certain method implementations of
7954   traits defined in other crates.
7955
7956 [1.6a]: https://github.com/rust-lang/rust/pull/29454
7957 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
7958 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
7959 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
7960 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
7961 [1.6co]: http://doc.rust-lang.org/core/index.html
7962 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
7963 [1.6f]: https://github.com/rust-lang/rust/pull/29129
7964 [1.6m]: https://github.com/rust-lang/rust/pull/29828
7965 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
7966 [1.6p]: https://github.com/rust-lang/rust/pull/29726
7967 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
7968 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
7969 [1.6s]: https://github.com/rust-lang/rust/pull/29675
7970 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
7971 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
7972 [1.6us]: https://github.com/rust-lang/rust/pull/29383
7973 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
7974 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
7975 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7976 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
7977 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
7978 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
7979 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
7980 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
7981 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
7982 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
7983 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
7984 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
7985 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
7986 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
7987 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
7988 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
7989 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
7990 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
7991 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
7992 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
7993 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
7994 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
7995 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
7996 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
7997 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
7998 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
7999 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8000 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8001 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8002 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8003
8004
8005 Version 1.5.0 (2015-12-10)
8006 ==========================
8007
8008 * ~700 changes, numerous bugfixes
8009
8010 Highlights
8011 ----------
8012
8013 * Stabilized APIs:
8014   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8015   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8016   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8017   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8018   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8019   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8020   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8021   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8022   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8023   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8024   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
8025   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
8026   [`Path::read_link`], [`Path::symlink_metadata`],
8027   [`Utf8Error::valid_up_to`], [`Vec::resize`],
8028   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
8029   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
8030   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
8031   [`slice::split_first_mut`], [`slice::split_first`],
8032   [`slice::split_last_mut`], [`slice::split_last`],
8033   [`char::from_u32_unchecked`], [`fs::canonicalize`],
8034   [`str::MatchIndices`], [`str::RMatchIndices`],
8035   [`str::match_indices`], [`str::rmatch_indices`],
8036   [`str::slice_mut_unchecked`], [`string::ParseError`].
8037 * Rust applications hosted on crates.io can be installed locally to
8038   `~/.cargo/bin` with the [`cargo install`] command. Among other
8039   things this makes it easier to augment Cargo with new subcommands:
8040   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
8041   invoked as `cargo foo`.
8042 * Crates with wildcard (`*`) dependencies will [emit warnings when
8043   published][1.5w]. In 1.6 it will no longer be possible to publish
8044   crates with wildcard dependencies.
8045
8046 Breaking Changes
8047 ----------------
8048
8049 * The rules determining when a particular lifetime must outlive
8050   a particular value (known as '[dropck]') have been [modified
8051   to not rely on parametricity][1.5p].
8052 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
8053   and `Arc`][1.5a]. Because these smart pointer types implement
8054   `Deref`, this causes breakage in cases where the interior type
8055   contains methods of the same name.
8056 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
8057   that they could drop their content. Soundness fix.
8058 * All method invocations are [properly checked][1.5wf1] for
8059   [well-formedness][1.5wf2]. Soundness fix.
8060 * Traits whose supertraits contain `Self` are [not object
8061   safe][1.5o]. Soundness fix.
8062 * Target specifications support a [`no_default_libraries`][1.5nd]
8063   setting that controls whether `-nodefaultlibs` is passed to the
8064   linker, and in turn the `is_like_windows` setting no longer affects
8065   the `-nodefaultlibs` flag.
8066 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
8067 * The `#[inline]` and `#[repr]` attributes [can only appear
8068   in valid locations][1.5at].
8069 * Native libraries linked from the local crate are [passed to
8070   the linker before native libraries from upstream crates][1.5nl].
8071 * Two rarely-used attributes, `#[no_debug]` and
8072   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
8073 * Negation of unsigned integers, which has been a warning for
8074   several releases, [is now behind a feature gate and will
8075   generate errors][1.5nu].
8076 * The parser accidentally accepted visibility modifiers on
8077   enum variants, a bug [which has been fixed][1.5ev].
8078 * [A bug was fixed that allowed `use` statements to import unstable
8079   features][1.5use].
8080
8081 Language
8082 --------
8083
8084 * When evaluating expressions at compile-time that are not
8085   compile-time constants (const-evaluating expressions in non-const
8086   contexts), incorrect code such as overlong bitshifts and arithmetic
8087   overflow will [generate a warning instead of an error][1.5ce],
8088   delaying the error until runtime. This will allow the
8089   const-evaluator to be expanded in the future backwards-compatibly.
8090 * The `improper_ctypes` lint [no longer warns about using `isize` and
8091   `usize` in FFI][1.5ict].
8092
8093 Libraries
8094 ---------
8095
8096 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
8097   invariant][1.5c].
8098 * `Default` is [implemented for mutable slices][1.5d].
8099 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
8100 * There are now `From` conversions [between floating point
8101   types][1.5f] where the conversions are lossless.
8102 * There are now `From` conversions [between integer types][1.5i] where
8103   the conversions are lossless.
8104 * [`fs::Metadata` implements `Clone`][1.5fs].
8105 * The `parse` method [accepts a leading "+" when parsing
8106   integers][1.5pi].
8107 * [`AsMut` is implemented for `Vec`][1.5am].
8108 * The `clone_from` implementations for `String` and `BinaryHeap` [have
8109   been optimized][1.5cf] and no longer rely on the default impl.
8110 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
8111   `unsafe extern "C"` function types now [implement `Clone`,
8112   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
8113   `fmt::Debug` for up to 12 arguments][1.5fp].
8114 * [Dropping `Vec`s is much faster in unoptimized builds when the
8115   element types don't implement `Drop`][1.5dv].
8116 * A bug that caused in incorrect behavior when [combining `VecDeque`
8117   with zero-sized types][1.5vdz] was resolved.
8118 * [`PartialOrd` for slices is faster][1.5po].
8119
8120 Miscellaneous
8121 -------------
8122
8123 * [Crate metadata size was reduced by 20%][1.5md].
8124 * [Improvements to code generation reduced the size of libcore by 3.3
8125   MB and rustc's memory usage by 18MB][1.5m].
8126 * [Improvements to deref translation increased performance in
8127   unoptimized builds][1.5dr].
8128 * Various errors in trait resolution [are deduplicated to only be
8129   reported once][1.5te].
8130 * Rust has preliminary [support for rumprun kernels][1.5rr].
8131 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8132
8133 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8134 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8135 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8136 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8137 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8138 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8139 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8140 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8141 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8142 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8143 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8144 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8145 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8146 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8147 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8148 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8149 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8150 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8151 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8152 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8153 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8154 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8155 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8156 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8157 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8158 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8159 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8160 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8161 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8162 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8163 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8164 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8165 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8166 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8167 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8168 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8169 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8170 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8171 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8172 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8173 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8174 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8175 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8176 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8177 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8178 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8179 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8180 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8181 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8182 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8183 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8184 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8185 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8186 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8187 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8188 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8189 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8190 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8191 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8192 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8193 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8194 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8195 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8196 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8197 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8198 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8199 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8200 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8201 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8202 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8203 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8204 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8205 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8206 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8207 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8208 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8209 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8210 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8211 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8212 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8213 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8214 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8215 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8216 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8217 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8218 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8219 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8220 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8221 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8222
8223 Version 1.4.0 (2015-10-29)
8224 ==========================
8225
8226 * ~1200 changes, numerous bugfixes
8227
8228 Highlights
8229 ----------
8230
8231 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8232   GNU) are now supported and recommended for use.
8233
8234 Breaking Changes
8235 ----------------
8236
8237 * [Several changes have been made to fix type soundness and improve
8238   the behavior of associated types][sound]. See [RFC 1214]. Although
8239   we have mostly introduced these changes as warnings this release, to
8240   become errors next release, there are still some scenarios that will
8241   see immediate breakage.
8242 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8243   line breaks in addition to `\n`][crlf].
8244 * [Loans of `'static` lifetime extend to the end of a function][stat].
8245 * [`str::parse` no longer introduces avoidable rounding error when
8246   parsing floating point numbers. Together with earlier changes to
8247   float formatting/output, "round trips" like f.to_string().parse()
8248   now preserve the value of f exactly. Additionally, leading plus
8249   signs are now accepted][fp3].
8250
8251
8252 Language
8253 --------
8254
8255 * `use` statements that import multiple items [can now rename
8256   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8257 * [Binops work correctly on fat pointers][binfat].
8258 * `pub extern crate`, which does not behave as expected, [issues a
8259   warning][pec] until a better solution is found.
8260
8261 Libraries
8262 ---------
8263
8264 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8265   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8266   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8267   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8268   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8269   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8270   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8271   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8272   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8273   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8274   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8275   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8276   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8277   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8278   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8279   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8280   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8281   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8282   [`thread::sleep`].
8283 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8284   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8285   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8286   `f64::from_str_radix`.
8287 * [Reverse-searching strings is faster with the 'two-way'
8288   algorithm][s].
8289 * [`std::io::copy` allows `?Sized` arguments][cc].
8290 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8291   [override `count`, `nth` and `last` with an O(1)
8292   implementation][it].
8293 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8294 * [`IntoRawFd` has been added to the Unix-specific prelude,
8295   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8296   prelude][pr].
8297 * [`Extend<String>` and `FromIterator<String` are both implemented for
8298   `String`][es].
8299 * [`IntoIterator` is implemented for references to `Option` and
8300   `Result`][into2].
8301 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8302   Copy`][ext] as part of [RFC 839]. This will cause type inference
8303   breakage in rare situations.
8304 * [`BinaryHeap` implements `Debug`][bh2].
8305 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8306   arrays][bm].
8307 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8308   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8309 * [String comparison is faster][faststr].
8310 * `&mut T` where `T: std::fmt::Write` [also implements
8311   `std::fmt::Write`][mutw].
8312 * [A stable regression in `VecDeque::push_back` and other
8313   capacity-altering methods that caused panics for zero-sized types
8314   was fixed][vd].
8315 * [Function pointers implement traits for up to 12 parameters][fp2].
8316
8317 Miscellaneous
8318 -------------
8319
8320 * The compiler [no longer uses the 'morestack' feature to prevent
8321   stack overflow][mm]. Instead it uses guard pages and stack
8322   probes (though stack probes are not yet implemented on any platform
8323   but Windows).
8324 * [The compiler matches traits faster when projections are involved][p].
8325 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8326   `usize`][ffi].
8327 * [Cargo now displays useful information about what its doing during
8328   `cargo update`][cu].
8329
8330 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8331 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8332 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8333 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8334 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8335 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8336 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8337 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8338 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8339 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8340 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8341 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8342 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8343 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8344 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8345 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8346 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8347 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8348 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8349 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8350 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8351 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8352 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8353 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8354 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8355 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8356 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8357 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8358 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8359 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8360 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8361 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8362 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8363 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8364 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8365 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8366 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8367 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8368 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8369 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8370 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8371 [bh2]: https://github.com/rust-lang/rust/pull/28156
8372 [binfat]: https://github.com/rust-lang/rust/pull/28270
8373 [bm]: https://github.com/rust-lang/rust/pull/28197
8374 [cc]: https://github.com/rust-lang/rust/pull/27531
8375 [crlf]: https://github.com/rust-lang/rust/pull/28034
8376 [cu]: https://github.com/rust-lang/cargo/pull/1931
8377 [d]: https://github.com/rust-lang/rust/pull/27825
8378 [dep]: https://github.com/rust-lang/rust/pull/28339
8379 [es]: https://github.com/rust-lang/rust/pull/27956
8380 [ext]: https://github.com/rust-lang/rust/pull/28094
8381 [faststr]: https://github.com/rust-lang/rust/pull/28338
8382 [ffi]: https://github.com/rust-lang/rust/pull/28779
8383 [fp]: https://github.com/rust-lang/rust/pull/28268
8384 [fp2]: https://github.com/rust-lang/rust/pull/28560
8385 [fp3]: https://github.com/rust-lang/rust/pull/27307
8386 [i]: https://github.com/rust-lang/rust/pull/27451
8387 [into2]: https://github.com/rust-lang/rust/pull/28039
8388 [it]: https://github.com/rust-lang/rust/pull/27652
8389 [mm]: https://github.com/rust-lang/rust/pull/27338
8390 [mutw]: https://github.com/rust-lang/rust/pull/28368
8391 [sound]: https://github.com/rust-lang/rust/pull/27641
8392 [p]: https://github.com/rust-lang/rust/pull/27866
8393 [pec]: https://github.com/rust-lang/rust/pull/28486
8394 [pr]: https://github.com/rust-lang/rust/pull/27896
8395 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8396 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8397 [s]: https://github.com/rust-lang/rust/pull/27474
8398 [stab]: https://github.com/rust-lang/rust/pull/28339
8399 [stat]: https://github.com/rust-lang/rust/pull/28321
8400 [vd]: https://github.com/rust-lang/rust/pull/28494
8401
8402 Version 1.3.0 (2015-09-17)
8403 ==============================
8404
8405 * ~900 changes, numerous bugfixes
8406
8407 Highlights
8408 ----------
8409
8410 * The [new object lifetime defaults][nold] have been [turned
8411   on][nold2] after a cycle of warnings about the change. Now types
8412   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8413   being interpreted as `&'a Box<Trait+'a>` to `&'a
8414   Box<Trait+'static>`.
8415 * [The Rustonomicon][nom] is a new book in the official documentation
8416   that dives into writing unsafe Rust.
8417 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8418   timekeeping is employed by other std APIs, as well as out-of-tree
8419   time crates.
8420
8421 Breaking Changes
8422 ----------------
8423
8424 * The [new object lifetime defaults][nold] have been [turned
8425   on][nold2] after a cycle of warnings about the change.
8426 * There is a known [regression][lr] in how object lifetime elision is
8427   interpreted, the proper solution for which is undetermined.
8428 * The `#[prelude_import]` attribute, an internal implementation
8429   detail, was accidentally stabilized previously. [It has been put
8430   behind the `prelude_import` feature gate][pi]. This change is
8431   believed to break no existing code.
8432 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8433   [more sane for dynamically sized types][dst3]. Code that relied on
8434   the previous behavior is thought to be broken.
8435 * The `dropck` rules, which checks that destructors can't access
8436   destroyed values, [have been updated][dropck] to match the
8437   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8438   cause some previously-compiling code to no longer build.
8439
8440 Language
8441 --------
8442
8443 * The [new object lifetime defaults][nold] have been [turned
8444   on][nold2] after a cycle of warnings about the change.
8445 * Semicolons may [now follow types and paths in
8446   macros](https://github.com/rust-lang/rust/pull/27000).
8447 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8448   [more sane for dynamically sized types][dst3]. Code that relied on
8449   the previous behavior is not known to exist, and suspected to be
8450   broken.
8451 * `'static` variables [may now be recursive][st].
8452 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8453   implementations correctly.
8454 * The `dropck` rules, which checks that destructors can't access
8455   destroyed values, [have been updated][dropck] to match the
8456   [RFC][dropckrfc].
8457
8458 Libraries
8459 ---------
8460
8461 * The [`Duration`] API, [has been stabilized][ds], as well as the
8462   `std::time` module, which presently contains only `Duration`.
8463 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8464 * The owned C string, [`CString`], implements [`Borrow`] and the
8465   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8466   these allow C strings to be borrowed and cloned in generic code.
8467 * [`CStr`] implements [`Debug`].
8468 * [`AtomicPtr`] implements [`Debug`].
8469 * [`Error`] trait objects [can be downcast to their concrete types][e]
8470   in many common configurations, using the [`is`], [`downcast`],
8471   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8472   [`Any`] trait.
8473 * Searching for substrings now [employs the two-way algorithm][search]
8474   instead of doing a naive search. This gives major speedups to a
8475   number of methods, including [`contains`][sc], [`find`][sf],
8476   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8477   [`ends_with`][sew] are also faster.
8478 * The performance of `PartialEq` for slices is [much faster][ps].
8479 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8480   is overridden and optimized by the implementations for scalars.
8481 * The [`Hasher`] trait now has a number of specialized `write_*`
8482   methods for primitive types, for efficiency.
8483 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8484   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8485   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8486   of [`std::error::Error::cause`][iec] also delegates to the inner
8487   error.
8488 * [`process::Child`][pc] gained the [`id`] method, which returns a
8489   `u32` representing the platform-specific process identifier.
8490 * The [`connect`] method on slices is deprecated, replaced by the new
8491   [`join`] method (note that both of these are on the *unstable*
8492   [`SliceConcatExt`] trait, but through the magic of the prelude are
8493   available to stable code anyway).
8494 * The [`Div`] operator is implemented for [`Wrapping`] types.
8495 * [`DerefMut` is implemented for `String`][dms].
8496 * Performance of SipHash (the default hasher for `HashMap`) is
8497   [better for long data][sh].
8498 * [`AtomicPtr`] implements [`Send`].
8499 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8500   are now [specialized to use uninitialized buffers for increased
8501   performance][rte].
8502 * Lifetime parameters of foreign functions [are now resolved
8503   properly][f].
8504
8505 Misc
8506 ----
8507
8508 * Rust can now, with some coercion, [produce programs that run on
8509   Windows XP][xp], though XP is not considered a supported platform.
8510 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8511   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8512   recommended for use in 1.3, though should be fully-functional
8513   in the [64-bit 1.4 beta][b14].
8514 * On Fedora-based systems installation will [properly configure the
8515   dynamic linker][fl].
8516 * The compiler gained many new extended error descriptions, which can
8517   be accessed with the `--explain` flag.
8518 * The `dropck` pass, which checks that destructors can't access
8519   destroyed values, [has been rewritten][dropck]. This fixes some
8520   soundness holes, and as such will cause some previously-compiling
8521   code to no longer build.
8522 * `rustc` now uses [LLVM to write archive files where possible][ar].
8523   Eventually this will eliminate the compiler's dependency on the ar
8524   utility.
8525 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
8526   supported FreeBSD on x86_64).
8527 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
8528   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
8529   more strict.
8530 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
8531   will kill the process instead of leaking][nlp].
8532
8533 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
8534 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
8535 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
8536 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
8537 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
8538 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8539 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8540 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
8541 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
8542 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
8543 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
8544 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
8545 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
8546 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8547 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
8548 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
8549 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
8550 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
8551 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8552 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
8553 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
8554 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
8555 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
8556 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8557 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
8558 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
8559 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
8560 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
8561 [ar]: https://github.com/rust-lang/rust/pull/26926
8562 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
8563 [dms]: https://github.com/rust-lang/rust/pull/26241
8564 [dropck]: https://github.com/rust-lang/rust/pull/27261
8565 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8566 [ds]: https://github.com/rust-lang/rust/pull/26818
8567 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
8568 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
8569 [dst3]: https://github.com/rust-lang/rust/pull/27351
8570 [e]: https://github.com/rust-lang/rust/pull/24793
8571 [f]: https://github.com/rust-lang/rust/pull/26588
8572 [fb]: https://github.com/rust-lang/rust/pull/26959
8573 [fl]: https://github.com/rust-lang/rust-installer/pull/41
8574 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8575 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
8576 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
8577 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
8578 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
8579 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
8580 [lic]: https://github.com/rust-lang/rust/pull/26583
8581 [lnu]: https://github.com/rust-lang/rust/pull/27026
8582 [lr]: https://github.com/rust-lang/rust/issues/27248
8583 [lum]: https://github.com/rust-lang/rust/pull/26378
8584 [lur]: https://github.com/rust-lang/rust/pull/26783
8585 [nlp]: https://github.com/rust-lang/rust/pull/27176
8586 [nold2]: https://github.com/rust-lang/rust/pull/27045
8587 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
8588 [nom]: http://doc.rust-lang.org/nightly/nomicon/
8589 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
8590 [pi]: https://github.com/rust-lang/rust/pull/26699
8591 [ps]: https://github.com/rust-lang/rust/pull/26884
8592 [rte]: https://github.com/rust-lang/rust/pull/26950
8593 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
8594 [search]: https://github.com/rust-lang/rust/pull/26327
8595 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
8596 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
8597 [sh]: https://github.com/rust-lang/rust/pull/27280
8598 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
8599 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
8600 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
8601 [st]: https://github.com/rust-lang/rust/pull/26630
8602 [win1]: https://github.com/rust-lang/rust/pull/26569
8603 [win2]: https://github.com/rust-lang/rust/pull/26741
8604 [win3]: https://github.com/rust-lang/rust/pull/26741
8605 [win4]: https://github.com/rust-lang/rust/pull/27210
8606 [xp]: https://github.com/rust-lang/rust/pull/26569
8607
8608 Version 1.2.0 (2015-08-07)
8609 ==========================
8610
8611 * ~1200 changes, numerous bugfixes
8612
8613 Highlights
8614 ----------
8615
8616 * [Dynamically-sized-type coercions][dst] allow smart pointer types
8617   like `Rc` to contain types without a fixed size, arrays and trait
8618   objects, finally enabling use of `Rc<[T]>` and completing the
8619   implementation of DST.
8620 * [Parallel codegen][parcodegen] is now working again, which can
8621   substantially speed up large builds in debug mode; It also gets
8622   another ~33% speedup when bootstrapping on a 4 core machine (using 8
8623   jobs). It's not enabled by default, but will be "in the near
8624   future". It can be activated with the `-C codegen-units=N` flag to
8625   `rustc`.
8626 * This is the first release with [experimental support for linking
8627   with the MSVC linker and lib C on Windows (instead of using the GNU
8628   variants via MinGW)][win]. It is yet recommended only for the most
8629   intrepid Rustaceans.
8630 * Benchmark compilations are showing a 30% improvement in
8631   bootstrapping over 1.1.
8632
8633 Breaking Changes
8634 ----------------
8635
8636 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
8637   unicode case mapping, which is a previously-planned change in
8638   behavior and considered a bugfix.
8639 * [`mem::align_of`] now specifies [the *minimum alignment* for
8640   T][align], which is usually the alignment programs are interested
8641   in, and the same value reported by clang's
8642   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
8643   break real code.
8644 * [The `#[packed]` attribute is no longer silently accepted by the
8645   compiler][packed]. This attribute did nothing and code that
8646   mentioned it likely did not work as intended.
8647 * Associated type defaults are [now behind the
8648   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
8649   defaults *did not work*, but could be mentioned syntactically. As
8650   such this breakage has minimal impact.
8651
8652 Language
8653 --------
8654
8655 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
8656   matching against dereferenceable values.
8657
8658 Libraries
8659 ---------
8660
8661 * The [`Extend`] trait, which grows a collection from an iterator, is
8662   implemented over iterators of references, for `String`, `Vec`,
8663   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
8664   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
8665 * The [`iter::once`] function returns an iterator that yields a single
8666   element, and [`iter::empty`] returns an iterator that yields no
8667   elements.
8668 * The [`matches`] and [`rmatches`] methods on `str` return iterators
8669   over substring matches.
8670 * [`Cell`] and [`RefCell`] both implement `Eq`.
8671 * A number of methods for wrapping arithmetic are added to the
8672   integral types, [`wrapping_div`], [`wrapping_rem`],
8673   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
8674   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
8675   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
8676   type.. It is illegal for the default arithmetic operations in Rust
8677   to overflow; the desire to wrap must be explicit.
8678 * The `{:#?}` formatting specifier [displays the alternate,
8679   pretty-printed][debugfmt] form of the `Debug` formatter. This
8680   feature was actually introduced prior to 1.0 with little
8681   fanfare.
8682 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
8683   for writing data to formatted strings, similar to [`io::Write`].
8684 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
8685   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
8686   are used by code generators to emit implementations of [`Debug`].
8687 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
8688   methods that convert case, following Unicode case mapping.
8689 * It is now easier to handle poisoned locks. The [`PoisonError`]
8690   type, returned by failing lock operations, exposes `into_inner`,
8691   `get_ref`, and `get_mut`, which all give access to the inner lock
8692   guard, and allow the poisoned lock to continue to operate. The
8693   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
8694   poisoned lock without attempting to take the lock.
8695 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
8696   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
8697   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
8698   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
8699   `ChildStderr`.
8700 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
8701   malformed input.
8702
8703 Misc
8704 ----
8705
8706 * `rustc` employs smarter heuristics for guessing at [typos].
8707 * `rustc` emits more efficient code for [no-op conversions between
8708   unsafe pointers][nop].
8709 * Fat pointers are now [passed in pairs of immediate arguments][fat],
8710   resulting in faster compile times and smaller code.
8711
8712 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
8713 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8714 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
8715 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
8716 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
8717 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
8718 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
8719 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
8720 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
8721 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
8722 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
8723 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
8724 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
8725 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
8726 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
8727 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
8728 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8729 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
8730 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
8731 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
8732 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
8733 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
8734 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
8735 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
8736 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
8737 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8738 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
8739 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
8740 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
8741 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
8742 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
8743 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
8744 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
8745 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8746 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8747 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
8748 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
8749 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
8750 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
8751 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
8752 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
8753 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8754 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
8755 [align]: https://github.com/rust-lang/rust/pull/25646
8756 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
8757 [typos]: https://github.com/rust-lang/rust/pull/26087
8758 [nop]: https://github.com/rust-lang/rust/pull/26336
8759 [fat]: https://github.com/rust-lang/rust/pull/26411
8760 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
8761 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
8762 [packed]: https://github.com/rust-lang/rust/pull/25541
8763 [ad]: https://github.com/rust-lang/rust/pull/27382
8764 [win]: https://github.com/rust-lang/rust/pull/25350
8765
8766 Version 1.1.0 (2015-06-25)
8767 =========================
8768
8769 * ~850 changes, numerous bugfixes
8770
8771 Highlights
8772 ----------
8773
8774 * The [`std::fs` module has been expanded][fs] to expand the set of
8775   functionality exposed:
8776   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
8777     don't incur a syscall on some platforms.
8778   * A `symlink_metadata` function has been added.
8779   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
8780     access to all underlying information.
8781 * The compiler now contains extended explanations of many errors. When an error
8782   with an explanation occurs the compiler suggests using the `--explain` flag
8783   to read the explanation. Error explanations are also [available online][err-index].
8784 * Thanks to multiple [improvements][sk] to [type checking][pre], as
8785   well as other work, the time to bootstrap the compiler decreased by
8786   32%.
8787
8788 Libraries
8789 ---------
8790
8791 * The [`str::split_whitespace`] method splits a string on unicode
8792   whitespace boundaries.
8793 * On both Windows and Unix, new extension traits provide conversion of
8794   I/O types to and from the underlying system handles. On Unix, these
8795   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
8796   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
8797   `TcpListener`, and `UpdSocket`. Further implementations for
8798   `std::process` will be stabilized later.
8799 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
8800   Windows, symlinks can be created with
8801   `std::os::windows::symlink_dir` and
8802   `std::os::windows::symlink_file`.
8803 * The `mpsc::Receiver` type can now be converted into an iterator with
8804   `into_iter` on the [`IntoIterator`] trait.
8805 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
8806   implementation of the [`From`] trait.
8807 * The `Debug` implementation for `RangeFull` [creates output that is
8808   more consistent with other implementations][rf].
8809 * [`Debug` is implemented for `File`][file].
8810 * The `Default` implementation for `Arc` [no longer requires `Sync +
8811   Send`][arc].
8812 * [The `Iterator` methods `count`, `nth`, and `last` have been
8813   overridden for slices to have O(1) performance instead of O(n)][si].
8814 * Incorrect handling of paths on Windows has been improved in both the
8815   compiler and the standard library.
8816 * [`AtomicPtr` gained a `Default` implementation][ap].
8817 * In accordance with Rust's policy on arithmetic overflow `abs` now
8818   [panics on overflow when debug assertions are enabled][abs].
8819 * The [`Cloned`] iterator, which was accidentally left unstable for
8820   1.0 [has been stabilized][c].
8821 * The [`Incoming`] iterator, which iterates over incoming TCP
8822   connections, and which was accidentally unnamable in 1.0, [is now
8823   properly exported][inc].
8824 * [`BinaryHeap`] no longer corrupts itself [when functions called by
8825   `sift_up` or `sift_down` panic][bh].
8826 * The [`split_off`] method of `LinkedList` [no longer corrupts
8827   the list in certain scenarios][ll].
8828
8829 Misc
8830 ----
8831
8832 * Type checking performance [has improved notably][sk] with
8833   [multiple improvements][pre].
8834 * The compiler [suggests code changes][ch] for more errors.
8835 * rustc and it's build system have experimental support for [building
8836   toolchains against MUSL][m] instead of glibc on Linux.
8837 * The compiler defines the `target_env` cfg value, which is used for
8838   distinguishing toolchains that are otherwise for the same
8839   platform. Presently this is set to `gnu` for common GNU Linux
8840   targets and for MinGW targets, and `musl` for MUSL Linux targets.
8841 * The [`cargo rustc`][crc] command invokes a build with custom flags
8842   to rustc.
8843 * [Android executables are always position independent][pie].
8844 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
8845   with `Drop`][drop].
8846
8847 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
8848 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8849 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8850 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
8851 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
8852 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
8853 [rf]: https://github.com/rust-lang/rust/pull/24491
8854 [err-index]: https://doc.rust-lang.org/error-index.html
8855 [sk]: https://github.com/rust-lang/rust/pull/24615
8856 [pre]: https://github.com/rust-lang/rust/pull/25323
8857 [file]: https://github.com/rust-lang/rust/pull/24598
8858 [ch]: https://github.com/rust-lang/rust/pull/24683
8859 [arc]: https://github.com/rust-lang/rust/pull/24695
8860 [si]: https://github.com/rust-lang/rust/pull/24701
8861 [ap]: https://github.com/rust-lang/rust/pull/24834
8862 [m]: https://github.com/rust-lang/rust/pull/24777
8863 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
8864 [crc]: https://github.com/rust-lang/cargo/pull/1568
8865 [pie]: https://github.com/rust-lang/rust/pull/24953
8866 [abs]: https://github.com/rust-lang/rust/pull/25441
8867 [c]: https://github.com/rust-lang/rust/pull/25496
8868 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
8869 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
8870 [inc]: https://github.com/rust-lang/rust/pull/25522
8871 [bh]: https://github.com/rust-lang/rust/pull/25856
8872 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
8873 [ll]: https://github.com/rust-lang/rust/pull/26022
8874 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
8875 [drop]: https://github.com/rust-lang/rust/pull/24935
8876
8877 Version 1.0.0 (2015-05-15)
8878 ========================
8879
8880 * ~1500 changes, numerous bugfixes
8881
8882 Highlights
8883 ----------
8884
8885 * The vast majority of the standard library is now `#[stable]`. It is
8886   no longer possible to use unstable features with a stable build of
8887   the compiler.
8888 * Many popular crates on [crates.io] now work on the stable release
8889   channel.
8890 * Arithmetic on basic integer types now [checks for overflow in debug
8891   builds][overflow].
8892
8893 Language
8894 --------
8895
8896 * Several [restrictions have been added to trait coherence][coh] in
8897   order to make it easier for upstream authors to change traits
8898   without breaking downstream code.
8899 * Digits of binary and octal literals are [lexed more eagerly][lex] to
8900   improve error messages and macro behavior. For example, `0b1234` is
8901   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
8902 * Trait bounds [are always invariant][inv], eliminating the need for
8903   the `PhantomFn` and `MarkerTrait` lang items, which have been
8904   removed.
8905 * ["-" is no longer a valid character in crate names][cr], the `extern crate
8906   "foo" as bar` syntax has been replaced with `extern crate foo as
8907   bar`, and Cargo now automatically translates "-" in *package* names
8908   to underscore for the crate name.
8909 * [Lifetime shadowing is an error][lt].
8910 * [`Send` no longer implies `'static`][send-rfc].
8911 * [UFCS now supports trait-less associated paths][moar-ufcs] like
8912   `MyType::default()`.
8913 * Primitive types [now have inherent methods][prim-inherent],
8914   obviating the need for extension traits like `SliceExt`.
8915 * Methods with `Self: Sized` in their `where` clause are [considered
8916   object-safe][self-sized], allowing many extension traits like
8917   `IteratorExt` to be merged into the traits they extended.
8918 * You can now [refer to associated types][assoc-where] whose
8919   corresponding trait bounds appear only in a `where` clause.
8920 * The final bits of [OIBIT landed][oibit-final], meaning that traits
8921   like `Send` and `Sync` are now library-defined.
8922 * A [Reflect trait][reflect] was introduced, which means that
8923   downcasting via the `Any` trait is effectively limited to concrete
8924   types. This helps retain the potentially-important "parametricity"
8925   property: generic code cannot behave differently for different type
8926   arguments except in minor ways.
8927 * The `unsafe_destructor` feature is now deprecated in favor of the
8928   [new `dropck`][dropck]. This change is a major reduction in unsafe
8929   code.
8930
8931 Libraries
8932 ---------
8933
8934 * The `thread_local` module [has been renamed to `std::thread`][th].
8935 * The methods of `IteratorExt` [have been moved to the `Iterator`
8936   trait itself][ie].
8937 * Several traits that implement Rust's conventions for type
8938   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
8939   [centralized in the `std::convert` module][con].
8940 * The `FromError` trait [was removed in favor of `From`][fe].
8941 * The basic sleep function [has moved to
8942   `std::thread::sleep_ms`][slp].
8943 * The `splitn` function now takes an `n` parameter that represents the
8944   number of items yielded by the returned iterator [instead of the
8945   number of 'splits'][spl].
8946 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
8947 * [Derived implementations of `PartialOrd` now order enums according
8948   to their explicitly-assigned discriminants][po].
8949 * [Methods for searching strings are generic over `Pattern`s][pat],
8950   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
8951   some others.
8952 * [In method resolution, object methods are resolved before inherent
8953   methods][meth].
8954 * [`String::from_str` has been deprecated in favor of the `From` impl,
8955   `String::from`][sf].
8956 * [`io::Error` implements `Sync`][ios].
8957 * [The `words` method on `&str` has been replaced with
8958   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
8959   a word?'
8960 * The new path and IO modules are complete and `#[stable]`. This
8961   was the major library focus for this cycle.
8962 * The path API was [revised][path-normalize] to normalize `.`,
8963   adjusting the tradeoffs in favor of the most common usage.
8964 * A large number of remaining APIs in `std` were also stabilized
8965   during this cycle; about 75% of the non-deprecated API surface
8966   is now stable.
8967 * The new [string pattern API][string-pattern] landed, which makes
8968   the string slice API much more internally consistent and flexible.
8969 * A new set of [generic conversion traits][conversion] replaced
8970   many existing ad hoc traits.
8971 * Generic numeric traits were [completely removed][num-traits]. This
8972   was made possible thanks to inherent methods for primitive types,
8973   and the removal gives maximal flexibility for designing a numeric
8974   hierarchy in the future.
8975 * The `Fn` traits are now related via [inheritance][fn-inherit]
8976   and provide ergonomic [blanket implementations][fn-blanket].
8977 * The `Index` and `IndexMut` traits were changed to
8978   [take the index by value][index-value], enabling code like
8979   `hash_map["string"]` to work.
8980 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
8981   `Copy` data is known to be `Clone` as well.
8982
8983 Misc
8984 ----
8985
8986 * Many errors now have extended explanations that can be accessed with
8987   the `--explain` flag to `rustc`.
8988 * Many new examples have been added to the standard library
8989   documentation.
8990 * rustdoc has received a number of improvements focused on completion
8991   and polish.
8992 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
8993 * Much headway was made on ecosystem-wide CI, making it possible
8994   to [compare builds for breakage][ci-compare].
8995
8996
8997 [crates.io]: http://crates.io
8998 [clo]: https://github.com/rust-lang/rust/pull/24034
8999 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9000 [con]: https://github.com/rust-lang/rust/pull/23875
9001 [cr]: https://github.com/rust-lang/rust/pull/23419
9002 [fe]: https://github.com/rust-lang/rust/pull/23879
9003 [ie]: https://github.com/rust-lang/rust/pull/23300
9004 [inv]: https://github.com/rust-lang/rust/pull/23938
9005 [ios]: https://github.com/rust-lang/rust/pull/24133
9006 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9007 [lt]: https://github.com/rust-lang/rust/pull/24057
9008 [meth]: https://github.com/rust-lang/rust/pull/24056
9009 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9010 [po]: https://github.com/rust-lang/rust/pull/24270
9011 [sf]: https://github.com/rust-lang/rust/pull/24517
9012 [slp]: https://github.com/rust-lang/rust/pull/23949
9013 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9014 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9015 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9016 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9017 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9018 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9019 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9020 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9021 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9022 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9023 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9024 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9025 [reflect]: https://github.com/rust-lang/rust/pull/23712
9026 [conversion]: https://github.com/rust-lang/rfcs/pull/529
9027 [num-traits]: https://github.com/rust-lang/rust/pull/23549
9028 [index-value]: https://github.com/rust-lang/rust/pull/23601
9029 [dropck]: https://github.com/rust-lang/rfcs/pull/769
9030 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
9031 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
9032 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
9033 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
9034 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
9035
9036
9037 Version 1.0.0-alpha.2 (2015-02-20)
9038 =====================================
9039
9040 * ~1300 changes, numerous bugfixes
9041
9042 * Highlights
9043
9044     * The various I/O modules were [overhauled][io-rfc] to reduce
9045       unnecessary abstractions and provide better interoperation with
9046       the underlying platform. The old `io` module remains temporarily
9047       at `std::old_io`.
9048     * The standard library now [participates in feature gating][feat],
9049       so use of unstable libraries now requires a `#![feature(...)]`
9050       attribute. The impact of this change is [described on the
9051       forum][feat-forum]. [RFC][feat-rfc].
9052
9053 * Language
9054
9055     * `for` loops [now operate on the `IntoIterator` trait][into],
9056       which eliminates the need to call `.iter()`, etc. to iterate
9057       over collections. There are some new subtleties to remember
9058       though regarding what sort of iterators various types yield, in
9059       particular that `for foo in bar { }` yields values from a move
9060       iterator, destroying the original collection. [RFC][into-rfc].
9061     * Objects now have [default lifetime bounds][obj], so you don't
9062       have to write `Box<Trait+'static>` when you don't care about
9063       storing references. [RFC][obj-rfc].
9064     * In types that implement `Drop`, [lifetimes must outlive the
9065       value][drop]. This will soon make it possible to safely
9066       implement `Drop` for types where `#[unsafe_destructor]` is now
9067       required. Read the [gorgeous RFC][drop-rfc] for details.
9068     * The fully qualified <T as Trait>::X syntax lets you set the Self
9069       type for a trait method or associated type. [RFC][ufcs-rfc].
9070     * References to types that implement `Deref<U>` now [automatically
9071       coerce to references][deref] to the dereferenced type `U`,
9072       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
9073       should eliminate many unsightly uses of `&*`, as when converting
9074       from references to vectors into references to
9075       slices. [RFC][deref-rfc].
9076     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
9077       `|:|`) is obsolete and closure kind is inferred from context.
9078     * [`Self` is a keyword][Self].
9079
9080 * Libraries
9081
9082     * The `Show` and `String` formatting traits [have been
9083       renamed][fmt] to `Debug` and `Display` to more clearly reflect
9084       their related purposes. Automatically getting a string
9085       conversion to use with `format!("{:?}", something_to_debug)` is
9086       now written `#[derive(Debug)]`.
9087     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
9088       OsStr}`, provide strings in platform-specific encodings for easier
9089       interop with system APIs. [RFC][osstr-rfc].
9090     * The `boxed::into_raw` and `Box::from_raw` functions [convert
9091       between `Box<T>` and `*mut T`][boxraw], a common pattern for
9092       creating raw pointers.
9093
9094 * Tooling
9095
9096     * Certain long error messages of the form 'expected foo found bar'
9097       are now [split neatly across multiple
9098       lines][multiline]. Examples in the PR.
9099     * On Unix Rust can be [uninstalled][un] by running
9100       `/usr/local/lib/rustlib/uninstall.sh`.
9101     * The `#[rustc_on_unimplemented]` attribute, requiring the
9102       'on_unimplemented' feature, lets rustc [display custom error
9103       messages when a trait is expected to be implemented for a type
9104       but is not][onun].
9105
9106 * Misc
9107
9108     * Rust is tested against a [LALR grammar][lalr], which parses
9109       almost all the Rust files that rustc does.
9110
9111 [boxraw]: https://github.com/rust-lang/rust/pull/21318
9112 [close]: https://github.com/rust-lang/rust/pull/21843
9113 [deref]: https://github.com/rust-lang/rust/pull/21351
9114 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
9115 [drop]: https://github.com/rust-lang/rust/pull/21972
9116 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9117 [feat]: https://github.com/rust-lang/rust/pull/21248
9118 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
9119 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
9120 [fmt]: https://github.com/rust-lang/rust/pull/21457
9121 [into]: https://github.com/rust-lang/rust/pull/20790
9122 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9123 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9124 [lalr]: https://github.com/rust-lang/rust/pull/21452
9125 [multiline]: https://github.com/rust-lang/rust/pull/19870
9126 [obj]: https://github.com/rust-lang/rust/pull/22230
9127 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9128 [onun]: https://github.com/rust-lang/rust/pull/20889
9129 [osstr]: https://github.com/rust-lang/rust/pull/21488
9130 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9131 [Self]: https://github.com/rust-lang/rust/pull/22158
9132 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9133 [un]: https://github.com/rust-lang/rust/pull/22256
9134
9135
9136 Version 1.0.0-alpha (2015-01-09)
9137 ==================================
9138
9139   * ~2400 changes, numerous bugfixes
9140
9141   * Highlights
9142
9143     * The language itself is considered feature complete for 1.0,
9144       though there will be many usability improvements and bugfixes
9145       before the final release.
9146     * Nearly 50% of the public API surface of the standard library has
9147       been declared 'stable'. Those interfaces are unlikely to change
9148       before 1.0.
9149     * The long-running debate over integer types has been
9150       [settled][ints]: Rust will ship with types named `isize` and
9151       `usize`, rather than `int` and `uint`, for pointer-sized
9152       integers. Guidelines will be rolled out during the alpha cycle.
9153     * Most crates that are not `std` have been moved out of the Rust
9154       distribution into the Cargo ecosystem so they can evolve
9155       separately and don't need to be stabilized as quickly, including
9156       'time', 'getopts', 'num', 'regex', and 'term'.
9157     * Documentation continues to be expanded with more API coverage, more
9158       examples, and more in-depth explanations. The guides have been
9159       consolidated into [The Rust Programming Language][trpl].
9160     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9161     * All official Rust binary installers now come with [Cargo], the
9162       Rust package manager.
9163
9164 * Language
9165
9166     * Closures have been [completely redesigned][unboxed] to be
9167       implemented in terms of traits, can now be used as generic type
9168       bounds and thus monomorphized and inlined, or via an opaque
9169       pointer (boxed) as in the old system. The new system is often
9170       referred to as 'unboxed' closures.
9171     * Traits now support [associated types][assoc], allowing families
9172       of related types to be defined together and used generically in
9173       powerful ways.
9174     * Enum variants are [namespaced by their type names][enum].
9175     * [`where` clauses][where] provide a more versatile and attractive
9176       syntax for specifying generic bounds, though the previous syntax
9177       remains valid.
9178     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9179       numeric types.
9180     * Rust [no longer has a runtime][rt] of any description, and only
9181       supports OS threads, not green threads.
9182     * At long last, Rust has been overhauled for 'dynamically-sized
9183       types' ([DST]), which integrates 'fat pointers' (object types,
9184       arrays, and `str`) more deeply into the type system, making it
9185       more consistent.
9186     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9187       `..j` that produce range types and which, when combined with the
9188       `Index` operator and multidispatch, leads to a convenient slice
9189       notation, `[i..j]`.
9190     * The new range syntax revealed an ambiguity in the fixed-length
9191       array syntax, so now fixed length arrays [are written `[T;
9192       N]`][arrays].
9193     * The `Copy` trait is no longer implemented automatically. Unsafe
9194       pointers no longer implement `Sync` and `Send` so types
9195       containing them don't automatically either. `Sync` and `Send`
9196       are now 'unsafe traits' so one can "forcibly" implement them via
9197       `unsafe impl` if a type confirms to the requirements for them
9198       even though the internals do not (e.g. structs containing unsafe
9199       pointers like `Arc`). These changes are intended to prevent some
9200       footguns and are collectively known as [opt-in built-in
9201       traits][oibit] (though `Sync` and `Send` will soon become pure
9202       library types unknown to the compiler).
9203     * Operator traits now take their operands [by value][ops], and
9204       comparison traits can use multidispatch to compare one type
9205       against multiple other types, allowing e.g. `String` to be
9206       compared with `&str`.
9207     * `if let` and `while let` are no longer feature-gated.
9208     * Rust has adopted a more [uniform syntax for escaping unicode
9209       characters][unicode].
9210     * `macro_rules!` [has been declared stable][mac]. Though it is a
9211       flawed system it is sufficiently popular that it must be usable
9212       for 1.0. Effort has gone into [future-proofing][mac-future] it
9213       in ways that will allow other macro systems to be developed in
9214       parallel, and won't otherwise impact the evolution of the
9215       language.
9216     * The prelude has been [pared back significantly][prelude] such
9217       that it is the minimum necessary to support the most pervasive
9218       code patterns, and through [generalized where clauses][where]
9219       many of the prelude extension traits have been consolidated.
9220     * Rust's rudimentary reflection [has been removed][refl], as it
9221       incurred too much code generation for little benefit.
9222     * [Struct variants][structvars] are no longer feature-gated.
9223     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9224       known as 'higher-ranked trait bounds', this crucially allows
9225       unboxed closures to work.
9226     * Macros invocations surrounded by parens or square brackets and
9227       not terminated by a semicolon are [parsed as
9228       expressions][macros], which makes expressions like `vec![1i32,
9229       2, 3].len()` work as expected.
9230     * Trait objects now implement their traits automatically, and
9231       traits that can be coerced to objects now must be [object
9232       safe][objsafe].
9233     * Automatically deriving traits is now done with `#[derive(...)]`
9234       not `#[deriving(...)]` for [consistency with other naming
9235       conventions][derive].
9236     * Importing the containing module or enum at the same time as
9237       items or variants they contain is [now done with `self` instead
9238       of `mod`][self], as in use `foo::{self, bar}`
9239     * Glob imports are no longer feature-gated.
9240     * The `box` operator and `box` patterns have been feature-gated
9241       pending a redesign. For now unique boxes should be allocated
9242       like other containers, with `Box::new`.
9243
9244 * Libraries
9245
9246     * A [series][coll1] of [efforts][coll2] to establish
9247       [conventions][coll3] for collections types has resulted in API
9248       improvements throughout the standard library.
9249     * New [APIs for error handling][err] provide ergonomic interop
9250       between error types, and [new conventions][err-conv] describe
9251       more clearly the recommended error handling strategies in Rust.
9252     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9253       it is easier to discuss failure in the context of error handling
9254       without making clarifications as to whether you are referring to
9255       the 'fail' macro or failure more generally.
9256     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9257       syscall when available.
9258     * The 'serialize' crate has been renamed 'rustc-serialize' and
9259       moved out of the distribution to Cargo. Although it is widely
9260       used now, it is expected to be superseded in the near future.
9261     * The `Show` formatter, typically implemented with
9262       `#[derive(Show)]` is [now requested with the `{:?}`
9263       specifier][show] and is intended for use by all types, for uses
9264       such as `println!` debugging. The new `String` formatter must be
9265       implemented by hand, uses the `{}` specifier, and is intended
9266       for full-fidelity conversions of things that can logically be
9267       represented as strings.
9268
9269 * Tooling
9270
9271     * [Flexible target specification][flex] allows rustc's code
9272       generation to be configured to support otherwise-unsupported
9273       platforms.
9274     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9275       respective debuggers with Rust-appropriate pretty-printing.
9276     * The Windows installation of Rust is distributed with the
9277       MinGW components currently required to link binaries on that
9278       platform.
9279
9280 * Misc
9281
9282     * Nullable enum optimizations have been extended to more types so
9283       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9284       space than the inner types themselves.
9285     * Work has begun on supporting AArch64.
9286
9287 [Cargo]: https://crates.io
9288 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9289 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9290 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9291 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9292 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9293 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9294 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9295 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9296 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9297 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9298 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9299 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9300 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9301 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9302 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9303 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9304 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9305 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9306 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9307 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9308 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9309 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9310 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9311 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9312 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9313 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9314 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9315 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9316 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9317 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9318 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9319 [trpl]: https://doc.rust-lang.org/book/index.html
9320 [rbe]: http://rustbyexample.com/
9321
9322
9323 Version 0.12.0 (2014-10-09)
9324 =============================
9325
9326   * ~1900 changes, numerous bugfixes
9327
9328   * Highlights
9329
9330     * The introductory documentation (now called The Rust Guide) has
9331       been completely rewritten, as have a number of supplementary
9332       guides.
9333     * Rust's package manager, Cargo, continues to improve and is
9334       sometimes considered to be quite awesome.
9335     * Many API's in `std` have been reviewed and updated for
9336       consistency with the in-development Rust coding
9337       guidelines. The standard library documentation tracks
9338       stabilization progress.
9339     * Minor libraries have been moved out-of-tree to the rust-lang org
9340       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9341       be installed with Cargo.
9342     * Lifetime elision allows lifetime annotations to be left off of
9343       function declarations in many common scenarios.
9344     * Rust now works on 64-bit Windows.
9345
9346   * Language
9347     * Indexing can be overloaded with the `Index` and `IndexMut`
9348       traits.
9349     * The `if let` construct takes a branch only if the `let` pattern
9350       matches, currently behind the 'if_let' feature gate.
9351     * 'where clauses', a more flexible syntax for specifying trait
9352       bounds that is more aesthetic, have been added for traits and
9353       free functions. Where clauses will in the future make it
9354       possible to constrain associated types, which would be
9355       impossible with the existing syntax.
9356     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9357       the 'slicing_syntax' feature gate, and can be overloaded with
9358       the `Slice` or `SliceMut` traits.
9359     * The syntax for matching of sub-slices has been changed to use a
9360       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9361       consistency with other uses of `..` and to future-proof
9362       potential additional uses of the syntax.
9363     * The syntax for matching inclusive ranges in patterns has changed
9364       from `0..3` to `0...4` to be consistent with the exclusive range
9365       syntax for slicing.
9366     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9367       c]`) has been put behind the 'advanced_slice_patterns' feature
9368       gate and may be removed in the future.
9369     * Components of tuples and tuple structs can be extracted using
9370       the `value.0` syntax, currently behind the `tuple_indexing`
9371       feature gate.
9372     * The `#[crate_id]` attribute is no longer supported; versioning
9373       is handled by the package manager.
9374     * Renaming crate imports are now written `extern crate foo as bar`
9375       instead of `extern crate bar = foo`.
9376     * Renaming use statements are now written `use foo as bar` instead
9377       of `use bar = foo`.
9378     * `let` and `match` bindings and argument names in macros are now
9379       hygienic.
9380     * The new, more efficient, closure types ('unboxed closures') have
9381       been added under a feature gate, 'unboxed_closures'. These will
9382       soon replace the existing closure types, once higher-ranked
9383       trait lifetimes are added to the language.
9384     * `move` has been added as a keyword, for indicating closures
9385       that capture by value.
9386     * Mutation and assignment is no longer allowed in pattern guards.
9387     * Generic structs and enums can now have trait bounds.
9388     * The `Share` trait is now called `Sync` to free up the term
9389       'shared' to refer to 'shared reference' (the default reference
9390       type.
9391     * Dynamically-sized types have been mostly implemented,
9392       unifying the behavior of fat-pointer types with the rest of the
9393       type system.
9394     * As part of dynamically-sized types, the `Sized` trait has been
9395       introduced, which qualifying types implement by default, and
9396       which type parameters expect by default. To specify that a type
9397       parameter does not need to be sized, write `<Sized? T>`. Most
9398       types are `Sized`, notable exceptions being unsized arrays
9399       (`[T]`) and trait types.
9400     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9401     * Lifetime bounds can now be applied to type parameters and object
9402       types.
9403     * The old, reference counted GC type, `Gc<T>` which was once
9404       denoted by the `@` sigil, has finally been removed. GC will be
9405       revisited in the future.
9406
9407   * Libraries
9408     * Library documentation has been improved for a number of modules.
9409     * Bit-vectors, collections::bitv has been modernized.
9410     * The url crate is deprecated in favor of
9411       http://github.com/servo/rust-url, which can be installed with
9412       Cargo.
9413     * Most I/O stream types can be cloned and subsequently closed from
9414       a different thread.
9415     * A `std::time::Duration` type has been added for use in I/O
9416       methods that rely on timers, as well as in the 'time' crate's
9417       `Timespec` arithmetic.
9418     * The runtime I/O abstraction layer that enabled the green thread
9419       scheduler to do non-thread-blocking I/O has been removed, along
9420       with the libuv-based implementation employed by the green thread
9421       scheduler. This will greatly simplify the future I/O work.
9422     * `collections::btree` has been rewritten to have a more
9423       idiomatic and efficient design.
9424
9425   * Tooling
9426     * rustdoc output now indicates the stability levels of API's.
9427     * The `--crate-name` flag can specify the name of the crate
9428       being compiled, like `#[crate_name]`.
9429     * The `-C metadata` specifies additional metadata to hash into
9430       symbol names, and `-C extra-filename` specifies additional
9431       information to put into the output filename, for use by the
9432       package manager for versioning.
9433     * debug info generation has continued to improve and should be
9434       more reliable under both gdb and lldb.
9435     * rustc has experimental support for compiling in parallel
9436       using the `-C codegen-units` flag.
9437     * rustc no longer encodes rpath information into binaries by
9438       default.
9439
9440   * Misc
9441     * Stack usage has been optimized with LLVM lifetime annotations.
9442     * Official Rust binaries on Linux are more compatible with older
9443       kernels and distributions, built on CentOS 5.10.
9444
9445
9446 Version 0.11.0 (2014-07-02)
9447 ==========================
9448
9449   * ~1700 changes, numerous bugfixes
9450
9451   * Language
9452     * ~[T] has been removed from the language. This type is superseded by
9453       the Vec<T> type.
9454     * ~str has been removed from the language. This type is superseded by
9455       the String type.
9456     * ~T has been removed from the language. This type is superseded by the
9457       Box<T> type.
9458     * @T has been removed from the language. This type is superseded by the
9459       standard library's std::gc::Gc<T> type.
9460     * Struct fields are now all private by default.
9461     * Vector indices and shift amounts are both required to be a `uint`
9462       instead of any integral type.
9463     * Byte character, byte string, and raw byte string literals are now all
9464       supported by prefixing the normal literal with a `b`.
9465     * Multiple ABIs are no longer allowed in an ABI string
9466     * The syntax for lifetimes on closures/procedures has been tweaked
9467       slightly: `<'a>|A, B|: 'b + K -> T`
9468     * Floating point modulus has been removed from the language; however it
9469       is still provided by a library implementation.
9470     * Private enum variants are now disallowed.
9471     * The `priv` keyword has been removed from the language.
9472     * A closure can no longer be invoked through a &-pointer.
9473     * The `use foo, bar, baz;` syntax has been removed from the language.
9474     * The transmute intrinsic no longer works on type parameters.
9475     * Statics now allow blocks/items in their definition.
9476     * Trait bounds are separated from objects with + instead of : now.
9477     * Objects can no longer be read while they are mutably borrowed.
9478     * The address of a static is now marked as insignificant unless the
9479       #[inline(never)] attribute is placed it.
9480     * The #[unsafe_destructor] attribute is now behind a feature gate.
9481     * Struct literals are no longer allowed in ambiguous positions such as
9482       if, while, match, and for..in.
9483     * Declaration of lang items and intrinsics are now feature-gated by
9484       default.
9485     * Integral literals no longer default to `int`, and floating point
9486       literals no longer default to `f64`. Literals must be suffixed with an
9487       appropriate type if inference cannot determine the type of the
9488       literal.
9489     * The Box<T> type is no longer implicitly borrowed to &mut T.
9490     * Procedures are now required to not capture borrowed references.
9491
9492   * Libraries
9493     * The standard library is now a "facade" over a number of underlying
9494       libraries. This means that development on the standard library should
9495       be speedier due to smaller crates, as well as a clearer line between
9496       all dependencies.
9497     * A new library, libcore, lives under the standard library's facade
9498       which is Rust's "0-assumption" library, suitable for embedded and
9499       kernel development for example.
9500     * A regex crate has been added to the standard distribution. This crate
9501       includes statically compiled regular expressions.
9502     * The unwrap/unwrap_err methods on Result require a Show bound for
9503       better error messages.
9504     * The return types of the std::comm primitives have been centralized
9505       around the Result type.
9506     * A number of I/O primitives have gained the ability to time out their
9507       operations.
9508     * A number of I/O primitives have gained the ability to close their
9509       reading/writing halves to cancel pending operations.
9510     * Reverse iterator methods have been removed in favor of `rev()` on
9511       their forward-iteration counterparts.
9512     * A bitflags! macro has been added to enable easy interop with C and
9513       management of bit flags.
9514     * A debug_assert! macro is now provided which is disabled when
9515       `--cfg ndebug` is passed to the compiler.
9516     * A graphviz crate has been added for creating .dot files.
9517     * The std::cast module has been migrated into std::mem.
9518     * The std::local_data api has been migrated from freestanding functions
9519       to being based on methods.
9520     * The Pod trait has been renamed to Copy.
9521     * jemalloc has been added as the default allocator for types.
9522     * The API for allocating memory has been changed to use proper alignment
9523       and sized deallocation
9524     * Connecting a TcpStream or binding a TcpListener is now based on a
9525       string address and a u16 port. This allows connecting to a hostname as
9526       opposed to an IP.
9527     * The Reader trait now contains a core method, read_at_least(), which
9528       correctly handles many repeated 0-length reads.
9529     * The process-spawning API is now centered around a builder-style
9530       Command struct.
9531     * The :? printing qualifier has been moved from the standard library to
9532       an external libdebug crate.
9533     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
9534       have been renamed to Eq/Ord.
9535     * The select/plural methods have been removed from format!. The escapes
9536       for { and } have also changed from \{ and \} to {{ and }},
9537       respectively.
9538     * The TaskBuilder API has been re-worked to be a true builder, and
9539       extension traits for spawning native/green tasks have been added.
9540
9541   * Tooling
9542     * All breaking changes to the language or libraries now have their
9543       commit message annotated with `[breaking-change]` to allow for easy
9544       discovery of breaking changes.
9545     * The compiler will now try to suggest how to annotate lifetimes if a
9546       lifetime-related error occurs.
9547     * Debug info continues to be improved greatly with general bug fixes and
9548       better support for situations like link time optimization (LTO).
9549     * Usage of syntax extensions when cross-compiling has been fixed.
9550     * Functionality equivalent to GCC & Clang's -ffunction-sections,
9551       -fdata-sections and --gc-sections has been enabled by default
9552     * The compiler is now stricter about where it will load module files
9553       from when a module is declared via `mod foo;`.
9554     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
9555       Syntax extensions are now discovered via a "plugin registrar" type
9556       which will be extended in the future to other various plugins.
9557     * Lints have been restructured to allow for dynamically loadable lints.
9558     * A number of rustdoc improvements:
9559       * The HTML output has been visually redesigned.
9560       * Markdown is now powered by hoedown instead of sundown.
9561       * Searching heuristics have been greatly improved.
9562       * The search index has been reduced in size by a great amount.
9563       * Cross-crate documentation via `pub use` has been greatly improved.
9564       * Primitive types are now hyperlinked and documented.
9565     * Documentation has been moved from static.rust-lang.org/doc to
9566       doc.rust-lang.org
9567     * A new sandbox, play.rust-lang.org, is available for running and
9568       sharing rust code examples on-line.
9569     * Unused attributes are now more robustly warned about.
9570     * The dead_code lint now warns about unused struct fields.
9571     * Cross-compiling to iOS is now supported.
9572     * Cross-compiling to mipsel is now supported.
9573     * Stability attributes are now inherited by default and no longer apply
9574       to intra-crate usage, only inter-crate usage.
9575     * Error message related to non-exhaustive match expressions have been
9576       greatly improved.
9577
9578
9579 Version 0.10 (2014-04-03)
9580 =========================
9581
9582   * ~1500 changes, numerous bugfixes
9583
9584   * Language
9585     * A new RFC process is now in place for modifying the language.
9586     * Patterns with `@`-pointers have been removed from the language.
9587     * Patterns with unique vectors (`~[T]`) have been removed from the
9588       language.
9589     * Patterns with unique strings (`~str`) have been removed from the
9590       language.
9591     * `@str` has been removed from the language.
9592     * `@[T]` has been removed from the language.
9593     * `@self` has been removed from the language.
9594     * `@Trait` has been removed from the language.
9595     * Headers on `~` allocations which contain `@` boxes inside the type for
9596       reference counting have been removed.
9597     * The semantics around the lifetimes of temporary expressions have changed,
9598       see #3511 and #11585 for more information.
9599     * Cross-crate syntax extensions are now possible, but feature gated. See
9600       #11151 for more information. This includes both `macro_rules!` macros as
9601       well as syntax extensions such as `format!`.
9602     * New lint modes have been added, and older ones have been turned on to be
9603       warn-by-default.
9604       * Unnecessary parentheses
9605       * Uppercase statics
9606       * Camel Case types
9607       * Uppercase variables
9608       * Publicly visible private types
9609       * `#[deriving]` with raw pointers
9610     * Unsafe functions can no longer be coerced to closures.
9611     * Various obscure macros such as `log_syntax!` are now behind feature gates.
9612     * The `#[simd]` attribute is now behind a feature gate.
9613     * Visibility is no longer allowed on `extern crate` statements, and
9614       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
9615     * Trailing commas are now allowed in argument lists and tuple patterns.
9616     * The `do` keyword has been removed, it is now a reserved keyword.
9617     * Default type parameters have been implemented, but are feature gated.
9618     * Borrowed variables through captures in closures are now considered soundly.
9619     * `extern mod` is now `extern crate`
9620     * The `Freeze` trait has been removed.
9621     * The `Share` trait has been added for types that can be shared among
9622       threads.
9623     * Labels in macros are now hygienic.
9624     * Expression/statement macro invocations can be delimited with `{}` now.
9625     * Treatment of types allowed in `static mut` locations has been tweaked.
9626     * The `*` and `.` operators are now overloadable through the `Deref` and
9627       `DerefMut` traits.
9628     * `~Trait` and `proc` no longer have `Send` bounds by default.
9629     * Partial type hints are now supported with the `_` type marker.
9630     * An `Unsafe` type was introduced for interior mutability. It is now
9631       considered undefined to transmute from `&T` to `&mut T` without using the
9632       `Unsafe` type.
9633     * The #[linkage] attribute was implemented for extern statics/functions.
9634     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
9635     * `Pod` was renamed to `Copy`.
9636
9637   * Libraries
9638     * The `libextra` library has been removed. It has now been decomposed into
9639       component libraries with smaller and more focused nuggets of
9640       functionality. The full list of libraries can be found on the
9641       documentation index page.
9642     * std: `std::condition` has been removed. All I/O errors are now propagated
9643       through the `Result` type. In order to assist with error handling, a
9644       `try!` macro for unwrapping errors with an early return and a lint for
9645       unused results has been added. See #12039 for more information.
9646     * std: The `vec` module has been renamed to `slice`.
9647     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
9648       This will become the only growable vector in the future.
9649     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
9650       are now found at `std::io::BufferedReader` instead of
9651       `std::io::buffered::BufferedReader`.
9652     * std: `print` and `println` are no longer in the prelude, the `print!` and
9653       `println!` macros are intended to be used instead.
9654     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
9655       attempts to statically prevent cycles.
9656     * std: The standard distribution is adopting the policy of pushing failure
9657       to the user rather than failing in libraries. Many functions (such as
9658       `slice::last()`) now return `Option<T>` instead of `T` + failing.
9659     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
9660       deriving mode: `#[deriving(Show)]`.
9661     * std: `ToStr` is now implemented for all types implementing `Show`.
9662     * std: The formatting trait methods now take `&self` instead of `&T`
9663     * std: The `invert()` method on iterators has been renamed to `rev()`
9664     * std: `std::num` has seen a reduction in the genericity of its traits,
9665       consolidating functionality into a few core traits.
9666     * std: Backtraces are now printed on task failure if the environment
9667       variable `RUST_BACKTRACE` is present.
9668     * std: Naming conventions for iterators have been standardized. More details
9669       can be found on the wiki's style guide.
9670     * std: `eof()` has been removed from the `Reader` trait. Specific types may
9671       still implement the function.
9672     * std: Networking types are now cloneable to allow simultaneous reads/writes.
9673     * std: `assert_approx_eq!` has been removed
9674     * std: The `e` and `E` formatting specifiers for floats have been added to
9675       print them in exponential notation.
9676     * std: The `Times` trait has been removed
9677     * std: Indications of variance and opting out of builtin bounds is done
9678       through marker types in `std::kinds::marker` now
9679     * std: `hash` has been rewritten, `IterBytes` has been removed, and
9680       `#[deriving(Hash)]` is now possible.
9681     * std: `SharedChan` has been removed, `Sender` is now cloneable.
9682     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
9683     * std: `Chan::new` is now `channel()`.
9684     * std: A new synchronous channel type has been implemented.
9685     * std: A `select!` macro is now provided for selecting over `Receiver`s.
9686     * std: `hashmap` and `trie` have been moved to `libcollections`
9687     * std: `run` has been rolled into `io::process`
9688     * std: `assert_eq!` now uses `{}` instead of `{:?}`
9689     * std: The equality and comparison traits have seen some reorganization.
9690     * std: `rand` has moved to `librand`.
9691     * std: `to_{lower,upper}case` has been implemented for `char`.
9692     * std: Logging has been moved to `liblog`.
9693     * collections: `HashMap` has been rewritten for higher performance and less
9694       memory usage.
9695     * native: The default runtime is now `libnative`. If `libgreen` is desired,
9696       it can be booted manually. The runtime guide has more information and
9697       examples.
9698     * native: All I/O functionality except signals has been implemented.
9699     * green: Task spawning with `libgreen` has been optimized with stack caching
9700       and various trimming of code.
9701     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
9702     * sync: The `extra::sync` module has been updated to modern rust (and moved
9703       to the `sync` library), tweaking and improving various interfaces while
9704       dropping redundant functionality.
9705     * sync: A new `Barrier` type has been added to the `sync` library.
9706     * sync: An efficient mutex for native and green tasks has been implemented.
9707     * serialize: The `base64` module has seen some improvement. It treats
9708       newlines better, has non-string error values, and has seen general
9709       cleanup.
9710     * fourcc: A `fourcc!` macro was introduced
9711     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
9712       hexadecimal literal.
9713
9714   * Tooling
9715     * `rustpkg` has been deprecated and removed from the main repository. Its
9716       replacement, `cargo`, is under development.
9717     * Nightly builds of rust are now available
9718     * The memory usage of rustc has been improved many times throughout this
9719       release cycle.
9720     * The build process supports disabling rpath support for the rustc binary
9721       itself.
9722     * Code generation has improved in some cases, giving more information to the
9723       LLVM optimization passes to enable more extensive optimizations.
9724     * Debuginfo compatibility with lldb on OSX has been restored.
9725     * The master branch is now gated on an android bot, making building for
9726       android much more reliable.
9727     * Output flags have been centralized into one `--emit` flag.
9728     * Crate type flags have been centralized into one `--crate-type` flag.
9729     * Codegen flags have been consolidated behind a `-C` flag.
9730     * Linking against outdated crates now has improved error messages.
9731     * Error messages with lifetimes will often suggest how to annotate the
9732       function to fix the error.
9733     * Many more types are documented in the standard library, and new guides
9734       were written.
9735     * Many `rustdoc` improvements:
9736       * code blocks are syntax highlighted.
9737       * render standalone markdown files.
9738       * the --test flag tests all code blocks by default.
9739       * exported macros are displayed.
9740       * re-exported types have their documentation inlined at the location of the
9741         first re-export.
9742       * search works across crates that have been rendered to the same output
9743         directory.
9744
9745
9746 Version 0.9 (2014-01-09)
9747 ==========================
9748
9749    * ~1800 changes, numerous bugfixes
9750
9751    * Language
9752       * The `float` type has been removed. Use `f32` or `f64` instead.
9753       * A new facility for enabling experimental features (feature gating) has
9754         been added, using the crate-level `#[feature(foo)]` attribute.
9755       * Managed boxes (@) are now behind a feature gate
9756         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
9757         standard library's `Gc` or `Rc` types instead.
9758       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
9759       * Jumping back to the top of a loop is now done with `continue` instead of
9760         `loop`.
9761       * Strings can no longer be mutated through index assignment.
9762       * Raw strings can be created via the basic `r"foo"` syntax or with matched
9763         hash delimiters, as in `r###"foo"###`.
9764       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
9765         called once.
9766       * The `&fn` type is now written `|args| -> ret` to match the literal form.
9767       * `@fn`s have been removed.
9768       * `do` only works with procs in order to make it obvious what the cost
9769         of `do` is.
9770       * Single-element tuple-like structs can no longer be dereferenced to
9771         obtain the inner value. A more comprehensive solution for overloading
9772         the dereference operator will be provided in the future.
9773       * The `#[link(...)]` attribute has been replaced with
9774         `#[crate_id = "name#vers"]`.
9775       * Empty `impl`s must be terminated with empty braces and may not be
9776         terminated with a semicolon.
9777       * Keywords are no longer allowed as lifetime names; the `self` lifetime
9778         no longer has any special meaning.
9779       * The old `fmt!` string formatting macro has been removed.
9780       * `printf!` and `printfln!` (old-style formatting) removed in favor of
9781         `print!` and `println!`.
9782       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
9783       * The `extern mod foo (name = "bar")` syntax has been removed. Use
9784         `extern mod foo = "bar"` instead.
9785       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
9786       * Macros can have attributes.
9787       * Macros can expand to items with attributes.
9788       * Macros can expand to multiple items.
9789       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
9790       * Comments may be nested.
9791       * Values automatically coerce to trait objects they implement, without
9792         an explicit `as`.
9793       * Enum discriminants are no longer an entire word but as small as needed to
9794         contain all the variants. The `repr` attribute can be used to override
9795         the discriminant size, as in `#[repr(int)]` for integer-sized, and
9796         `#[repr(C)]` to match C enums.
9797       * Non-string literals are not allowed in attributes (they never worked).
9798       * The FFI now supports variadic functions.
9799       * Octal numeric literals, as in `0o7777`.
9800       * The `concat!` syntax extension performs compile-time string concatenation.
9801       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
9802         removed as Rust no longer uses segmented stacks.
9803       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
9804       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
9805         not `*`; ignoring remaining fields of a struct is also done with `..`,
9806         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
9807       * `rustc` supports the "win64" calling convention via `extern "win64"`.
9808       * `rustc` supports the "system" calling convention, which defaults to the
9809         preferred convention for the target platform, "stdcall" on 32-bit Windows,
9810         "C" elsewhere.
9811       * The `type_overflow` lint (default: warn) checks literals for overflow.
9812       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
9813       * The `attribute_usage` lint (default: warn) warns about unknown
9814         attributes.
9815       * The `unknown_features` lint (default: warn) warns about unknown
9816         feature gates.
9817       * The `dead_code` lint (default: warn) checks for dead code.
9818       * Rust libraries can be linked statically to one another
9819       * `#[link_args]` is behind the `link_args` feature gate.
9820       * Native libraries are now linked with `#[link(name = "foo")]`
9821       * Native libraries can be statically linked to a rust crate
9822         (`#[link(name = "foo", kind = "static")]`).
9823       * Native OS X frameworks are now officially supported
9824         (`#[link(name = "foo", kind = "framework")]`).
9825       * The `#[thread_local]` attribute creates thread-local (not task-local)
9826         variables. Currently behind the `thread_local` feature gate.
9827       * The `return` keyword may be used in closures.
9828       * Types that can be copied via a memcpy implement the `Pod` kind.
9829       * The `cfg` attribute can now be used on struct fields and enum variants.
9830
9831    * Libraries
9832       * std: The `option` and `result` API's have been overhauled to make them
9833         simpler, more consistent, and more composable.
9834       * std: The entire `std::io` module has been replaced with one that is
9835         more comprehensive and that properly interfaces with the underlying
9836         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
9837         implemented.
9838       * std: `io::util` contains a number of useful implementations of
9839         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
9840         `ZeroReader`, `TeeReader`.
9841       * std: The reference counted pointer type `extra::rc` moved into std.
9842       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
9843         just a wrapper around it).
9844       * std: The `Either` type has been removed.
9845       * std: `fmt::Default` can be implemented for any type to provide default
9846         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
9847       * std: The `rand` API continues to be tweaked.
9848       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
9849         on failure in gdb, is now named `rust_fail`.
9850       * std: The `each_key` and `each_value` methods on `HashMap` have been
9851         replaced by the `keys` and `values` iterators.
9852       * std: Functions dealing with type size and alignment have moved from the
9853         `sys` module to the `mem` module.
9854       * std: The `path` module was written and API changed.
9855       * std: `str::from_utf8` has been changed to cast instead of allocate.
9856       * std: `starts_with` and `ends_with` methods added to vectors via the
9857         `ImmutableEqVector` trait, which is in the prelude.
9858       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
9859         if the index is out of bounds.
9860       * std: Task failure no longer propagates between tasks, as the model was
9861         complex, expensive, and incompatible with thread-based tasks.
9862       * std: The `Any` type can be used for dynamic typing.
9863       * std: `~Any` can be passed to the `fail!` macro and retrieved via
9864         `task::try`.
9865       * std: Methods that produce iterators generally do not have an `_iter`
9866         suffix now.
9867       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
9868         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
9869       * std: `util::ignore` renamed to `prelude::drop`.
9870       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
9871         trait.
9872       * std: `vec::raw` has seen a lot of cleanup and API changes.
9873       * std: The standard library no longer includes any C++ code, and very
9874         minimal C, eliminating the dependency on libstdc++.
9875       * std: Runtime scheduling and I/O functionality has been factored out into
9876         extensible interfaces and is now implemented by two different crates:
9877         libnative, for native threading and I/O; and libgreen, for green threading
9878         and I/O. This paves the way for using the standard library in more limited
9879         embedded environments.
9880       * std: The `comm` module has been rewritten to be much faster, have a
9881         simpler, more consistent API, and to work for both native and green
9882         threading.
9883       * std: All libuv dependencies have been moved into the rustuv crate.
9884       * native: New implementations of runtime scheduling on top of OS threads.
9885       * native: New native implementations of TCP, UDP, file I/O, process spawning,
9886         and other I/O.
9887       * green: The green thread scheduler and message passing types are almost
9888         entirely lock-free.
9889       * extra: The `flatpipes` module had bitrotted and was removed.
9890       * extra: All crypto functions have been removed and Rust now has a policy of
9891         not reimplementing crypto in the standard library. In the future crypto
9892         will be provided by external crates with bindings to established libraries.
9893       * extra: `c_vec` has been modernized.
9894       * extra: The `sort` module has been removed. Use the `sort` method on
9895         mutable slices.
9896
9897    * Tooling
9898       * The `rust` and `rusti` commands have been removed, due to lack of
9899         maintenance.
9900       * `rustdoc` was completely rewritten.
9901       * `rustdoc` can test code examples in documentation.
9902       * `rustpkg` can test packages with the argument, 'test'.
9903       * `rustpkg` supports arbitrary dependencies, including C libraries.
9904       * `rustc`'s support for generating debug info is improved again.
9905       * `rustc` has better error reporting for unbalanced delimiters.
9906       * `rustc`'s JIT support was removed due to bitrot.
9907       * Executables and static libraries can be built with LTO (-Z lto)
9908       * `rustc` adds a `--dep-info` flag for communicating dependencies to
9909         build tools.
9910
9911
9912 Version 0.8 (2013-09-26)
9913 ============================
9914
9915    * ~2200 changes, numerous bugfixes
9916
9917    * Language
9918       * The `for` loop syntax has changed to work with the `Iterator` trait.
9919       * At long last, unwinding works on Windows.
9920       * Default methods are ready for use.
9921       * Many trait inheritance bugs fixed.
9922       * Owned and borrowed trait objects work more reliably.
9923       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
9924       * rustc can omit emission of code for the `debug!` macro if it is passed
9925         `--cfg ndebug`
9926       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
9927         for foo.rs, then foo/mod.rs, and will generate an error when both are
9928         present.
9929       * Strings no longer contain trailing nulls. The new `std::c_str` module
9930         provides new mechanisms for converting to C strings.
9931       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
9932       * The FFI has been overhauled such that foreign functions are called directly,
9933         instead of through a stack-switching wrapper.
9934       * Calling a foreign function must be done through a Rust function with the
9935         `#[fixed_stack_segment]` attribute.
9936       * The `externfn!` macro can be used to declare both a foreign function and
9937         a `#[fixed_stack_segment]` wrapper at once.
9938       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
9939       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
9940       * `priv` is disallowed everywhere except for struct fields and enum variants.
9941       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
9942       * `ref` bindings in irrefutable patterns work correctly now.
9943       * `char` is now prevented from containing invalid code points.
9944       * Casting to `bool` is no longer allowed.
9945       * `\0` is now accepted as an escape in chars and strings.
9946       * `yield` is a reserved keyword.
9947       * `typeof` is a reserved keyword.
9948       * Crates may be imported by URL with `extern mod foo = "url";`.
9949       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
9950       * Static vectors can be initialized with repeating elements,
9951         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
9952       * Static structs can be initialized with functional record update,
9953         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
9954       * `cfg!` can be used to conditionally execute code based on the crate
9955         configuration, similarly to `#[cfg(...)]`.
9956       * The `unnecessary_qualification` lint detects unneeded module
9957         prefixes (default: allow).
9958       * Arithmetic operations have been implemented on the SIMD types in
9959         `std::unstable::simd`.
9960       * Exchange allocation headers were removed, reducing memory usage.
9961       * `format!` implements a completely new, extensible, and higher-performance
9962         string formatting system. It will replace `fmt!`.
9963       * `print!` and `println!` write formatted strings (using the `format!`
9964         extension) to stdout.
9965       * `write!` and `writeln!` write formatted strings (using the `format!`
9966         extension) to the new Writers in `std::rt::io`.
9967       * The library section in which a function or static is placed may
9968         be specified with `#[link_section = "..."]`.
9969       * The `proto!` syntax extension for defining bounded message protocols
9970         was removed.
9971       * `macro_rules!` is hygienic for `let` declarations.
9972       * The `#[export_name]` attribute specifies the name of a symbol.
9973       * `unreachable!` can be used to indicate unreachable code, and fails
9974         if executed.
9975
9976    * Libraries
9977       * std: Transitioned to the new runtime, written in Rust.
9978       * std: Added an experimental I/O library, `rt::io`, based on the new
9979         runtime.
9980       * std: A new generic `range` function was added to the prelude, replacing
9981         `uint::range` and friends.
9982       * std: `range_rev` no longer exists. Since range is an iterator it can be
9983         reversed with `range(lo, hi).invert()`.
9984       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
9985         renamed to `unwrap_or`.
9986       * std: The `iterator` module was renamed to `iter`.
9987       * std: Integral types now support the `checked_add`, `checked_sub`, and
9988         `checked_mul` operations for detecting overflow.
9989       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
9990         consistency.
9991       * std: Methods are standardizing on conventions for casting methods:
9992         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
9993         and cheap casts.
9994       * std: The `CString` type in `c_str` provides new ways to convert to and
9995         from C strings.
9996       * std: `DoubleEndedIterator` can yield elements in two directions.
9997       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
9998         two splices.
9999       * std: `str::from_bytes` renamed to `str::from_utf8`.
10000       * std: `pop_opt` and `shift_opt` methods added to vectors.
10001       * std: The task-local data interface no longer uses @, and keys are
10002         no longer function pointers.
10003       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10004       * std: Added `SharedPort` to `comm`.
10005       * std: `Eq` has a default method for `ne`; only `eq` is required
10006         in implementations.
10007       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10008         is required in implementations.
10009       * std: `is_utf8` performance is improved, impacting many string functions.
10010       * std: `os::MemoryMap` provides cross-platform mmap.
10011       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10012         are not 'in-bounds' are considered undefined.
10013       * std: Many freestanding functions in `vec` removed in favor of methods.
10014       * std: Many freestanding functions on scalar types removed in favor of
10015         methods.
10016       * std: Many options to task builders were removed since they don't make
10017         sense in the new scheduler design.
10018       * std: More containers implement `FromIterator` so can be created by the
10019         `collect` method.
10020       * std: More complete atomic types in `unstable::atomics`.
10021       * std: `comm::PortSet` removed.
10022       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10023         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10024         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10025         default implementations.
10026       * std: Various `from_str` functions were removed in favor of a generic
10027         `from_str` which is available in the prelude.
10028       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
10029       * extra: `dlist`, the doubly-linked list was modernized.
10030       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
10031       * extra: Added `glob` module, replacing `std::os::glob`.
10032       * extra: `rope` was removed.
10033       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
10034       * extra: `net`, and `timer` were removed. The experimental replacements
10035         are `std::rt::io::net` and `std::rt::io::timer`.
10036       * extra: Iterators implemented for `SmallIntMap`.
10037       * extra: Iterators implemented for `Bitv` and `BitvSet`.
10038       * extra: `SmallIntSet` removed. Use `BitvSet`.
10039       * extra: Performance of JSON parsing greatly improved.
10040       * extra: `semver` updated to SemVer 2.0.0.
10041       * extra: `term` handles more terminals correctly.
10042       * extra: `dbg` module removed.
10043       * extra: `par` module removed.
10044       * extra: `future` was cleaned up, with some method renames.
10045       * extra: Most free functions in `getopts` were converted to methods.
10046
10047    * Other
10048       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
10049       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
10050         similarly to gcc's `--march` flag.
10051       * rustc's performance compiling small crates is much better.
10052       * rustpkg has received many improvements.
10053       * rustpkg supports git tags as package IDs.
10054       * rustpkg builds into target-specific directories so it can be used for
10055         cross-compiling.
10056       * The number of concurrent test tasks is controlled by the environment
10057         variable RUST_TEST_TASKS.
10058       * The test harness can now report metrics for benchmarks.
10059       * All tools have man pages.
10060       * Programs compiled with `--test` now support the `-h` and `--help` flags.
10061       * The runtime uses jemalloc for allocations.
10062       * Segmented stacks are temporarily disabled as part of the transition to
10063         the new runtime. Stack overflows are possible!
10064       * A new documentation backend, rustdoc_ng, is available for use. It is
10065         still invoked through the normal `rustdoc` command.
10066
10067
10068 Version 0.7 (2013-07-03)
10069 =======================
10070
10071    * ~2000 changes, numerous bugfixes
10072
10073    * Language
10074       * `impl`s no longer accept a visibility qualifier. Put them on methods
10075         instead.
10076       * The borrow checker has been rewritten with flow-sensitivity, fixing
10077         many bugs and inconveniences.
10078       * The `self` parameter no longer implicitly means `&'self self`,
10079         and can be explicitly marked with a lifetime.
10080       * Overloadable compound operators (`+=`, etc.) have been temporarily
10081         removed due to bugs.
10082       * The `for` loop protocol now requires `for`-iterators to return `bool`
10083         so they compose better.
10084       * The `Durable` trait is replaced with the `'static` bounds.
10085       * Trait default methods work more often.
10086       * Structs with the `#[packed]` attribute have byte alignment and
10087         no padding between fields.
10088       * Type parameters bound by `Copy` must now be copied explicitly with
10089         the `copy` keyword.
10090       * It is now illegal to move out of a dereferenced unsafe pointer.
10091       * `Option<~T>` is now represented as a nullable pointer.
10092       * `@mut` does dynamic borrow checks correctly.
10093       * The `main` function is only detected at the topmost level of the crate.
10094         The `#[main]` attribute is still valid anywhere.
10095       * Struct fields may no longer be mutable. Use inherited mutability.
10096       * The `#[no_send]` attribute makes a type that would otherwise be
10097         `Send`, not.
10098       * The `#[no_freeze]` attribute makes a type that would otherwise be
10099         `Freeze`, not.
10100       * Unbounded recursion will abort the process after reaching the limit
10101         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
10102       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
10103         are never implicitly copyable.
10104       * `#[static_assert]` makes compile-time assertions about static bools.
10105       * At long last, 'argument modes' no longer exist.
10106       * The rarely used `use mod` statement no longer exists.
10107
10108    * Syntax extensions
10109       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
10110         argument list.
10111       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
10112         `Rand`, `Zero` and `ToStr` can all be automatically derived with
10113         `#[deriving(...)]`.
10114       * The `bytes!` macro returns a vector of bytes for string, u8, char,
10115         and unsuffixed integer literals.
10116
10117    * Libraries
10118       * The `core` crate was renamed to `std`.
10119       * The `std` crate was renamed to `extra`.
10120       * More and improved documentation.
10121       * std: `iterator` module for external iterator objects.
10122       * Many old-style (internal, higher-order function) iterators replaced by
10123         implementations of `Iterator`.
10124       * std: Many old internal vector and string iterators,
10125         incl. `any`, `all`. removed.
10126       * std: The `finalize` method of `Drop` renamed to `drop`.
10127       * std: The `drop` method now takes `&mut self` instead of `&self`.
10128       * std: The prelude no longer re-exports any modules, only types and traits.
10129       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10130         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10131       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10132         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10133       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10134         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10135       * std: Many types implement `Clone`.
10136       * std: `path` type renamed to `Path`.
10137       * std: `mut` module and `Mut` type removed.
10138       * std: Many standalone functions removed in favor of methods and iterators
10139         in `vec`, `str`. In the future methods will also work as functions.
10140       * std: `reinterpret_cast` removed. Use `transmute`.
10141       * std: ascii string handling in `std::ascii`.
10142       * std: `Rand` is implemented for ~/@.
10143       * std: `run` module for spawning processes overhauled.
10144       * std: Various atomic types added to `unstable::atomic`.
10145       * std: Various types implement `Zero`.
10146       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10147       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10148       * std: Added `os::mkdir_recursive`.
10149       * std: Added `os::glob` function performs filesystems globs.
10150       * std: `FuzzyEq` renamed to `ApproxEq`.
10151       * std: `Map` now defines `pop` and `swap` methods.
10152       * std: `Cell` constructors converted to static methods.
10153       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10154       * extra: `flate` module moved from `std` to `extra`.
10155       * extra: `fileinput` module for iterating over a series of files.
10156       * extra: `Complex` number type and `complex` module.
10157       * extra: `Rational` number type and `rational` module.
10158       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10159       * extra: `term` uses terminfo now, is more correct.
10160       * extra: `arc` functions converted to methods.
10161       * extra: Implementation of fixed output size variations of SHA-2.
10162
10163    * Tooling
10164       * `unused_variables` lint mode for unused variables (default: warn).
10165       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10166         (default: warn).
10167       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10168         (default: warn).
10169       * `dead_assignment` lint mode for unread variables (default: warn).
10170       * `unnecessary_allocation` lint mode detects some heap allocations that are
10171         immediately borrowed so could be written without allocating (default: warn).
10172       * `missing_doc` lint mode (default: allow).
10173       * `unreachable_code` lint mode (default: warn).
10174       * The `rusti` command has been rewritten and a number of bugs addressed.
10175       * rustc outputs in color on more terminals.
10176       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10177       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10178       * Compiling with `-g` will make the binary record information about
10179         dynamic borrowcheck failures for debugging.
10180       * rustdoc has a nicer stylesheet.
10181       * Various improvements to rustdoc.
10182       * Improvements to rustpkg (see the detailed release notes).
10183
10184
10185 Version 0.6 (2013-04-03)
10186 ========================
10187
10188    * ~2100 changes, numerous bugfixes
10189
10190    * Syntax changes
10191       * The self type parameter in traits is now spelled `Self`
10192       * The `self` parameter in trait and impl methods must now be explicitly
10193         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10194       * Static methods no longer require the `static` keyword and instead
10195         are distinguished by the lack of a `self` parameter
10196       * Replaced the `Durable` trait with the `'static` lifetime
10197       * The old closure type syntax with the trailing sigil has been
10198         removed in favor of the more consistent leading sigil
10199       * `super` is a keyword, and may be prefixed to paths
10200       * Trait bounds are separated with `+` instead of whitespace
10201       * Traits are implemented with `impl Trait for Type`
10202         instead of `impl Type: Trait`
10203       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10204       * The `export` keyword has finally been removed
10205       * The `move` keyword has been removed (see "Semantic changes")
10206       * The interior mutability qualifier on vectors, `[mut T]`, has been
10207         removed. Use `&mut [T]`, etc.
10208       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10209       * `fail` is no longer a keyword. Use `fail!()`
10210       * `assert` is no longer a keyword. Use `assert!()`
10211       * `log` is no longer a keyword. use `debug!`, etc.
10212       * 1-tuples may be represented as `(T,)`
10213       * Struct fields may no longer be `mut`. Use inherited mutability,
10214         `@mut T`, `core::mut` or `core::cell`
10215       * `extern mod { ... }` is no longer valid syntax for foreign
10216         function modules. Use extern blocks: `extern { ... }`
10217       * Newtype enums removed. Use tuple-structs.
10218       * Trait implementations no longer support visibility modifiers
10219       * Pattern matching over vectors improved and expanded
10220       * `const` renamed to `static` to correspond to lifetime name,
10221         and make room for future `static mut` unsafe mutable globals.
10222       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10223       * `Clone` implementations can be automatically generated with
10224         `#[deriving(Clone)]`
10225       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10226         instead of `foo as Bar`.
10227       * Fixed length vector types are now written as `[int, .. 3]`
10228         instead of `[int * 3]`.
10229       * Fixed length vector types can express the length as a constant
10230         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10231
10232    * Semantic changes
10233       * Types with owned pointers or custom destructors move by default,
10234         eliminating the `move` keyword
10235       * All foreign functions are considered unsafe
10236       * &mut is now unaliasable
10237       * Writes to borrowed @mut pointers are prevented dynamically
10238       * () has size 0
10239       * The name of the main function can be customized using #[main]
10240       * The default type of an inferred closure is &fn instead of @fn
10241       * `use` statements may no longer be "chained" - they cannot import
10242         identifiers imported by previous `use` statements
10243       * `use` statements are crate relative, importing from the "top"
10244         of the crate by default. Paths may be prefixed with `super::`
10245         or `self::` to change the search behavior.
10246       * Method visibility is inherited from the implementation declaration
10247       * Structural records have been removed
10248       * Many more types can be used in static items, including enums
10249         'static-lifetime pointers and vectors
10250       * Pattern matching over vectors improved and expanded
10251       * Typechecking of closure types has been overhauled to
10252         improve inference and eliminate unsoundness
10253       * Macros leave scope at the end of modules, unless that module is
10254         tagged with #[macro_escape]
10255
10256    * Libraries
10257       * Added big integers to `std::bigint`
10258       * Removed `core::oldcomm` module
10259       * Added pipe-based `core::comm` module
10260       * Numeric traits have been reorganized under `core::num`
10261       * `vec::slice` finally returns a slice
10262       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10263       * Containers reorganized around traits in `core::container`
10264       * `core::dvec` removed, `~[T]` is a drop-in replacement
10265       * `core::send_map` renamed to `core::hashmap`
10266       * `std::map` removed; replaced with `core::hashmap`
10267       * `std::treemap` reimplemented as an owned balanced tree
10268       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10269       * `core::trie` added as a fast ordered map for integer keys
10270       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10271       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10272         overload the comparison operators, whereas `TotalOrd` is used
10273         by certain container types
10274
10275    * Other
10276       * Replaced the 'cargo' package manager with 'rustpkg'
10277       * Added all-purpose 'rust' tool
10278       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10279       * rustc now *attempts* to offer spelling suggestions
10280       * Improved support for ARM and Android
10281       * Preliminary MIPS backend
10282       * Improved foreign function ABI implementation for x86, x86_64
10283       * Various memory usage improvements
10284       * Rust code may be embedded in foreign code under limited circumstances
10285       * Inline assembler supported by new asm!() syntax extension.
10286
10287
10288 Version 0.5 (2012-12-21)
10289 ===========================
10290
10291    * ~900 changes, numerous bugfixes
10292
10293    * Syntax changes
10294       * Removed `<-` move operator
10295       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10296       * Removed old fixed length vector syntax - `[T]/N`
10297       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10298       * Macros may now expand to items and statements
10299       * `a.b()` is always parsed as a method call, never as a field projection
10300       * `Eq` and `IterBytes` implementations can be automatically generated
10301         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10302       * Removed the special crate language for `.rc` files
10303       * Function arguments may consist of any irrefutable pattern
10304
10305    * Semantic changes
10306       * `&` and `~` pointers may point to objects
10307       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10308       * Enum variants may be structs
10309       * Destructors can be added to all nominal types with the Drop trait
10310       * Structs and nullary enum variants may be constants
10311       * Values that cannot be implicitly copied are now automatically moved
10312         without writing `move` explicitly
10313       * `&T` may now be coerced to `*T`
10314       * Coercions happen in `let` statements as well as function calls
10315       * `use` statements now take crate-relative paths
10316       * The module and type namespaces have been merged so that static
10317         method names can be resolved under the trait in which they are
10318         declared
10319
10320    * Improved support for language features
10321       * Trait inheritance works in many scenarios
10322       * More support for explicit self arguments in methods - `self`, `&self`
10323         `@self`, and `~self` all generally work as expected
10324       * Static methods work in more situations
10325       * Experimental: Traits may declare default methods for the implementations
10326         to use
10327
10328    * Libraries
10329       * New condition handling system in `core::condition`
10330       * Timsort added to `std::sort`
10331       * New priority queue, `std::priority_queue`
10332       * Pipes for serializable types, `std::flatpipes'
10333       * Serialization overhauled to be trait-based
10334       * Expanded `getopts` definitions
10335       * Moved futures to `std`
10336       * More functions are pure now
10337       * `core::comm` renamed to `oldcomm`. Still deprecated
10338       * `rustdoc` and `cargo` are libraries now
10339
10340    * Misc
10341       * Added a preliminary REPL, `rusti`
10342       * License changed from MIT to dual MIT/APL2
10343
10344
10345 Version 0.4 (2012-10-15)
10346 ==========================
10347
10348    * ~2000 changes, numerous bugfixes
10349
10350    * Syntax
10351       * All keywords are now strict and may not be used as identifiers anywhere
10352       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10353         'of', 'with', 'to', 'class'.
10354       * Classes are replaced with simpler structs
10355       * Explicit method self types
10356       * `ret` became `return` and `alt` became `match`
10357       * `import` is now `use`; `use is now `extern mod`
10358       * `extern mod { ... }` is now `extern { ... }`
10359       * `use mod` is the recommended way to import modules
10360       * `pub` and `priv` replace deprecated export lists
10361       * The syntax of `match` pattern arms now uses fat arrow (=>)
10362       * `main` no longer accepts an args vector; use `os::args` instead
10363
10364    * Semantics
10365       * Trait implementations are now coherent, ala Haskell typeclasses
10366       * Trait methods may be static
10367       * Argument modes are deprecated
10368       * Borrowed pointers are much more mature and recommended for use
10369       * Strings and vectors in the static region are stored in constant memory
10370       * Typestate was removed
10371       * Resolution rewritten to be more reliable
10372       * Support for 'dual-mode' data structures (freezing and thawing)
10373
10374    * Libraries
10375       * Most binary operators can now be overloaded via the traits in
10376         `core::ops'
10377       * `std::net::url` for representing URLs
10378       * Sendable hash maps in `core::send_map`
10379       * `core::task' gained a (currently unsafe) task-local storage API
10380
10381    * Concurrency
10382       * An efficient new intertask communication primitive called the pipe,
10383         along with a number of higher-level channel types, in `core::pipes`
10384       * `std::arc`, an atomically reference counted, immutable, shared memory
10385         type
10386       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10387       * Futures are now based on pipes and sendable
10388       * More robust linked task failure
10389       * Improved task builder API
10390
10391    * Other
10392       * Improved error reporting
10393       * Preliminary JIT support
10394       * Preliminary work on precise GC
10395       * Extensive architectural improvements to rustc
10396       * Begun a transition away from buggy C++-based reflection (shape) code to
10397         Rust-based (visitor) code
10398       * All hash functions and tables converted to secure, randomized SipHash
10399
10400
10401 Version 0.3  (2012-07-12)
10402 ========================
10403
10404    * ~1900 changes, numerous bugfixes
10405
10406    * New coding conveniences
10407       * Integer-literal suffix inference
10408       * Per-item control over warnings, errors
10409       * #[cfg(windows)] and #[cfg(unix)] attributes
10410       * Documentation comments
10411       * More compact closure syntax
10412       * 'do' expressions for treating higher-order functions as
10413         control structures
10414       * *-patterns (wildcard extended to all constructor fields)
10415
10416    * Semantic cleanup
10417       * Name resolution pass and exhaustiveness checker rewritten
10418       * Region pointers and borrow checking supersede alias
10419         analysis
10420       * Init-ness checking is now provided by a region-based liveness
10421         pass instead of the typestate pass; same for last-use analysis
10422       * Extensive work on region pointers
10423
10424    * Experimental new language features
10425       * Slices and fixed-size, interior-allocated vectors
10426       * #!-comments for lang versioning, shell execution
10427       * Destructors and iface implementation for classes;
10428         type-parameterized classes and class methods
10429       * 'const' type kind for types that can be used to implement
10430         shared-memory concurrency patterns
10431
10432    * Type reflection
10433
10434    * Removal of various obsolete features
10435       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10436                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10437
10438       * Constructs: do-while loops ('do' repurposed), fn binding,
10439                     resources (replaced by destructors)
10440
10441    * Compiler reorganization
10442       * Syntax-layer of compiler split into separate crate
10443       * Clang (from LLVM project) integrated into build
10444       * Typechecker split into sub-modules
10445
10446    * New library code
10447       * New time functions
10448       * Extension methods for many built-in types
10449       * Arc: atomic-refcount read-only / exclusive-use shared cells
10450       * Par: parallel map and search routines
10451       * Extensive work on libuv interface
10452       * Much vector code moved to libraries
10453       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10454         #include, #include_str, #include_bin
10455
10456    * Tool improvements
10457       * Cargo automatically resolves dependencies
10458
10459
10460 Version 0.2  (2012-03-29)
10461 =========================
10462
10463    * >1500 changes, numerous bugfixes
10464
10465    * New docs and doc tooling
10466
10467    * New port: FreeBSD x86_64
10468
10469    * Compilation model enhancements
10470       * Generics now specialized, multiply instantiated
10471       * Functions now inlined across separate crates
10472
10473    * Scheduling, stack and threading fixes
10474       * Noticeably improved message-passing performance
10475       * Explicit schedulers
10476       * Callbacks from C
10477       * Helgrind clean
10478
10479    * Experimental new language features
10480       * Operator overloading
10481       * Region pointers
10482       * Classes
10483
10484    * Various language extensions
10485       * C-callback function types: 'crust fn ...'
10486       * Infinite-loop construct: 'loop { ... }'
10487       * Shorten 'mutable' to 'mut'
10488       * Required mutable-local qualifier: 'let mut ...'
10489       * Basic glob-exporting: 'export foo::*;'
10490       * Alt now exhaustive, 'alt check' for runtime-checked
10491       * Block-function form of 'for' loop, with 'break' and 'ret'.
10492
10493    * New library code
10494       * AST quasi-quote syntax extension
10495       * Revived libuv interface
10496       * New modules: core::{future, iter}, std::arena
10497       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10498       * Extensive cleanup, regularization in libstd, libcore
10499
10500
10501 Version 0.1  (2012-01-20)
10502 ===============================
10503
10504    * Most language features work, including:
10505       * Unique pointers, unique closures, move semantics
10506       * Interface-constrained generics
10507       * Static interface dispatch
10508       * Stack growth
10509       * Multithread task scheduling
10510       * Typestate predicates
10511       * Failure unwinding, destructors
10512       * Pattern matching and destructuring assignment
10513       * Lightweight block-lambda syntax
10514       * Preliminary macro-by-example
10515
10516    * Compiler works with the following configurations:
10517       * Linux: x86 and x86_64 hosts and targets
10518       * macOS: x86 and x86_64 hosts and targets
10519       * Windows: x86 hosts and targets
10520
10521    * Cross compilation / multi-target configuration supported.
10522
10523    * Preliminary API-documentation and package-management tools included.
10524
10525 Known issues:
10526
10527    * Documentation is incomplete.
10528
10529    * Performance is below intended target.
10530
10531    * Standard library APIs are subject to extensive change, reorganization.
10532
10533    * Language-level versioning is not yet operational - future code will
10534      break unexpectedly.